gdata 2.0.18 release.
This repository contains the contents of the unmodified gdata 2.0.18 tarball,
plus a README.chromium file explaining what is in here.
BUG=None
TEST=Run gather_builder_stats without gdata installed.
Change-Id: Ib77a11f15fa84bbd7820247d8a533b75ffef7d2b
Reviewed-on: https://chromium-review.googlesource.com/189996
Reviewed-by: Matt Tennant <mtennant@chromium.org>
Commit-Queue: David James <davidjames@chromium.org>
Tested-by: David James <davidjames@chromium.org>
diff --git a/INSTALL.txt b/INSTALL.txt
new file mode 100644
index 0000000..19f2327
--- /dev/null
+++ b/INSTALL.txt
@@ -0,0 +1,247 @@
+To get started using the library, you need to make sure that the library
+and dependencies can be imported. Short instructions:
+
+sudo python setup.py install
+
+or
+
+python setup.py install --home=~
+and set your PYTHONPATH to include your home directory.
+
+Long instructions copied from the following article from Aug. 2007:
+
+Getting Started with the Google Data Python Library
+http://code.google.com/support/bin/answer.py?answer=75582
+
+==Introduction==
+
+So you've decided to use the Google data Python client library to write an
+application using one of the many Google data services. Excellent choice!
+My aim with this short tutorial is to quickly get you started in using the
+client library to develop your application.
+
+You probably want to jump in and start creating your application right
+away. First though, you may need to configure your development environment
+and set up the tools you'll need to run the modules included in the client
+library. Follow the steps below and you'll be running code in no time.
+
+==Installing Python==
+
+If you're going to be developing with the Python client library, you'll
+need a working version of Python 2.2 or higher. Many operating systems
+come with a version of Python included, so you may be able to skip the
+installation step. To see which version of Python you have, run
+python -V in a command line terminal. (Note: the V is uppercase.) This
+should result in something like:
+
+Python 2.4.3
+
+If you see version 2.2 or higher, then you can start installing dependencies.
+Otherwise, look below to find installation/upgrade instructions for your
+operating system.
+
+--Installing Python on Windows--
+
+There are quite a few implementations of Python to choose from in Windows,
+but for purposes of this guide, I'll be using the .msi installer found on
+python.org.
+
+ 1. Begin by downloading the installer from the Python download page.
+ http://www.python.org/download/
+ 2. Run the installer ? you can accept all the default settings
+ 3. To see if your install is working as expected, open a command prompt and
+ run python -V.
+
+--Installing Python on Mac OS X--
+
+The list of downloads on python.org has .dmg installers for the Mac users out
+there. Here are the steps to install one of them:
+
+ 1. Navigate to http://www.python.org/download/mac/
+ 2. From this page, download the installer for the appropriate version of
+ Mac OS X. Note: The Python installation page for Mac OS X 10.3.8 and
+ below is different than newer versions of Mac OS X. To find your OS X
+ version, choose About This Mac from the Apple menu in the top-left
+ corner of your screen.
+ 3. After the download finishes, double-click the new disk image file
+ (ex. python-2.5-macosx.dmg) to mount it. If you're running Safari, this
+ has already been done for you.
+ 4. Open the mounted image and double-click the installer package inside.
+ 5. Follow the installation instructions and read the information and
+ license agreements as they're presented to you. Again, the default
+ settings will work fine here.
+ 6. Verify the installation by opening Terminal.app
+ (in /Applications/Utilities) and running python -V. The installation's
+ version should appear.
+
+--Installing Python on Linux--
+
+To install on Linux and other *nix style operating systems, I prefer to
+download the source code and compile it. However, you may be able to use your
+favorite package manager to install Python. (For example, on Ubuntu this can
+be as easy as running sudo apt-get install python on the command line.) To
+install from source, follow these steps:
+
+ 1. Download the source tarball from the Python download page.
+ http://python.org/download/
+ 2. Once you've downloaded the package, unpack it using the command line.
+ You can use the following
+
+ tar zxvf Python-2.<Your version>.tgz
+
+ 3. Next, you'll need to compile and install the source code for the Python
+ interpreter. In the decompressed directory, run ./configure to generate
+ a makefile.
+ 4. Then, run make. This will create a working Python executable file in
+ the local directory. If you don't have root permission or you just want
+ to use Python from your home directory, you can stop here. You'll be
+ able to run Python from this directory, so you might want to add it to
+ your PATH environment variable.
+ 5. I prefer to have Python installed in /usr/bin/ where most Python
+ scripts look for the interpreter. If you have root access, then run
+ make install as root. This will install Python in the default location
+ and it will be usable by everyone on your machine.
+ 6. Check to see if your install is working as expected by opening a
+ terminal and running python -V.
+
+==Installing Dependencies==
+
+Currently, the only external dependency is an XML library named ElementTree.
+If you are using Python version 2.5 or higher, you won't need to install
+ElementTree since it comes with the Python package.
+
+To see if ElementTree is already present on your system, do the following:
+
+ 1. Run the Python interpreter. I usually do this by executing python on
+ the command line.
+ 2. Try importing the ElementTree module. If you are using Python 2.5 or
+ higher, enter the following in the interpreter:
+
+ from xml.etree import ElementTree
+
+ For older versions, enter:
+
+ from elementtree import ElementTree
+
+ 3. If the import fails, then you will need to continue reading this
+ section. If it works, then you can skip to Installing the Google
+ data library.
+ 4. Download a version which is appropriate for your operating system.
+ For example, if you are using Windows, download
+ elementtree-1.2.6-20050316.win32.exe. For other operating systems,
+ I recommend downloading a compressed version.
+ 5. If you are using a .tar.gz or .zip version of the library, first
+ unpack, then install it by running ./setup.py install.
+
+Running ./setup.py install attempts to compile the library and place it in
+the system directory for your Python modules. If you do not have root access,
+you can install the modules in your home directory or an alternate location by
+running ./setup.py install --home=~. This will place the code in your home
+directory.
+
+There is another option which avoids installing altogether. Once you
+decompress the download, you will find a directory named elementtree. This
+directory contains the modules which you will need to import. When you call
+import from within Python, it looks for a module with the desired name in
+several places. The first place it looks is in the current directory, so
+if you are always running your code from one directory, you could just put
+the elementtree directory there. Python will also look at the directories
+listed in your PYTHONPATH environment variable. For instructions on
+editing your PYTHONPATH, see the Appendix at the end of this article.
+I recommend using ./setup.py install for elementtree.
+
+==Installing the Google Data Library==
+
+Download the Google data Python library if you haven't done so. Look for the
+latest version on the Python project's downloads page.
+
+After downloading the library, unpack it using unzip or tar zxvf depending
+on the type of download you chose.
+
+Now you are ready to install the library modules so that they can be imported
+into Python. There are several ways you can do this:
+
+ * If you have the ability to install packages for all users to access,
+ you can run ./setup.py install from the unpacked archive's main
+ directory.
+ * If you want to install these modules for use in your home directory,
+ you can run ./setup.py install --home=<your home directory>.
+
+In some cases, you want to avoid installing the modules altogether. To do
+that, modify your PYTHONPATH environment variable to include a directory
+which contains the gdata and atom directories for the Google data Python
+client library. For instructions on modifying your PYTHONPATH, see the
+Appendix at the end of this article.
+
+ * One final option that I'll mention, is copying the gdata and atom
+ directories from the src directory into whatever directory you are
+ in when you execute python. Python will look in the current directory
+ when you do an import, but I don't recommend this method unless you
+ are creating something quick and simple.
+
+Once you've installed the Google data library, you're ready to take the
+library for a test drive.
+
+==Running Tests and Samples==
+
+The Google data Python client library distributions include some test cases
+which are used in the development of the library. They can also serve as a
+quick check to make sure that your dependencies and library installation are
+working. From the top level directory where you've unpacked your copy of the
+library, try running:
+
+./tests/run_data_tests.py
+
+If this script runs correctly, you should see output on the command line
+like this:
+
+Running all tests in module gdata_test
+.......
+----------------------------------------------------------------------
+Ran 7 tests in 0.025s
+
+OK
+
+Running all tests in module atom_test
+..........................................
+----------------------------------------------------------------------
+Ran 42 tests in 0.016s
+
+OK
+
+...
+
+If you did not see any errors as the tests execute, then you have probably set
+up your environment correctly. Congratulations!
+
+For further information see the original article:
+http://code.google.com/support/bin/answer.py?answer=75582
+
+==Appendix: Modifying the PYTHONPATH==
+
+When you import a package or module in Python, the interpreter looks for the
+file in a series of locations including all of the directories listed in the
+PYTHONPATH environment variable. I often modify my PYTHONPATH to point to
+modules where I have copied the source code for a library I am using. This
+prevents the need to install a module each time it is modified because
+Python will load the module directly from directory which contains the
+modified source code.
+
+I recommend the PYTHONPATH approach if you are making changes to the client
+library code, or if you do not have admin rights on your system. By editing
+the PYTHONPATH, you can put the required modules anywhere you like.
+
+I modified my PYTHONPATH on a *nix and Mac OS X system by setting it in my
+.bashrc shell configuration file. If you are using the bash shell, you can
+set the variable by adding the following line to your ~/.bashrc file.
+
+export PYTHONPATH=$PYTHONPATH:/home/<my_username>/svn/gdata-python-client/src
+
+You can then apply these changes to your current shell session by executing
+
+source ~/.bashrc.
+
+For Windows XP, pull up the Environment Variables for your profile:
+Control Panel > System Properties > Advanced > Environment Variables. From
+there, you can either create or edit the PYTHONPATH variable and add the
+location of your local library copy.
diff --git a/MANIFEST b/MANIFEST
new file mode 100644
index 0000000..beafe4c
--- /dev/null
+++ b/MANIFEST
@@ -0,0 +1,841 @@
+# file GENERATED by distutils, do NOT edit
+INSTALL.txt
+MANIFEST
+README.txt
+RELEASE_NOTES.txt
+setup.py
+upload-diffs.py
+pydocs/atom.auth.html
+pydocs/atom.client.html
+pydocs/atom.core.html
+pydocs/atom.data.html
+pydocs/atom.html
+pydocs/atom.http.html
+pydocs/atom.http_core.html
+pydocs/atom.http_interface.html
+pydocs/atom.mock_http.html
+pydocs/atom.mock_http_core.html
+pydocs/atom.mock_service.html
+pydocs/atom.service.html
+pydocs/atom.token_store.html
+pydocs/atom.url.html
+pydocs/gdata.Crypto.Cipher.html
+pydocs/gdata.Crypto.Hash.HMAC.html
+pydocs/gdata.Crypto.Hash.MD5.html
+pydocs/gdata.Crypto.Hash.SHA.html
+pydocs/gdata.Crypto.Hash.html
+pydocs/gdata.Crypto.Protocol.AllOrNothing.html
+pydocs/gdata.Crypto.Protocol.Chaffing.html
+pydocs/gdata.Crypto.Protocol.html
+pydocs/gdata.Crypto.PublicKey.DSA.html
+pydocs/gdata.Crypto.PublicKey.ElGamal.html
+pydocs/gdata.Crypto.PublicKey.RSA.html
+pydocs/gdata.Crypto.PublicKey.html
+pydocs/gdata.Crypto.PublicKey.pubkey.html
+pydocs/gdata.Crypto.PublicKey.qNEW.html
+pydocs/gdata.Crypto.Util.RFC1751.html
+pydocs/gdata.Crypto.Util.html
+pydocs/gdata.Crypto.Util.number.html
+pydocs/gdata.Crypto.Util.randpool.html
+pydocs/gdata.Crypto.html
+pydocs/gdata.acl.data.html
+pydocs/gdata.acl.html
+pydocs/gdata.alt.app_engine.html
+pydocs/gdata.alt.appengine.html
+pydocs/gdata.alt.html
+pydocs/gdata.analytics.client.html
+pydocs/gdata.analytics.data.html
+pydocs/gdata.analytics.html
+pydocs/gdata.analytics.service.html
+pydocs/gdata.apps.adminsettings.html
+pydocs/gdata.apps.adminsettings.service.html
+pydocs/gdata.apps.apps_property_entry.html
+pydocs/gdata.apps.audit.html
+pydocs/gdata.apps.audit.service.html
+pydocs/gdata.apps.client.html
+pydocs/gdata.apps.data.html
+pydocs/gdata.apps.emailsettings.client.html
+pydocs/gdata.apps.emailsettings.data.html
+pydocs/gdata.apps.emailsettings.html
+pydocs/gdata.apps.emailsettings.service.html
+pydocs/gdata.apps.groups.client.html
+pydocs/gdata.apps.groups.data.html
+pydocs/gdata.apps.groups.html
+pydocs/gdata.apps.groups.service.html
+pydocs/gdata.apps.html
+pydocs/gdata.apps.migration.html
+pydocs/gdata.apps.migration.service.html
+pydocs/gdata.apps.multidomain.client.html
+pydocs/gdata.apps.multidomain.data.html
+pydocs/gdata.apps.multidomain.html
+pydocs/gdata.apps.organization.client.html
+pydocs/gdata.apps.organization.data.html
+pydocs/gdata.apps.organization.html
+pydocs/gdata.apps.organization.service.html
+pydocs/gdata.apps.service.html
+pydocs/gdata.apps_property.html
+pydocs/gdata.auth.html
+pydocs/gdata.blogger.client.html
+pydocs/gdata.blogger.data.html
+pydocs/gdata.blogger.html
+pydocs/gdata.blogger.service.html
+pydocs/gdata.books.data.html
+pydocs/gdata.books.html
+pydocs/gdata.books.service.html
+pydocs/gdata.calendar.client.html
+pydocs/gdata.calendar.data.html
+pydocs/gdata.calendar.html
+pydocs/gdata.calendar.service.html
+pydocs/gdata.calendar_resource.client.html
+pydocs/gdata.calendar_resource.data.html
+pydocs/gdata.calendar_resource.html
+pydocs/gdata.client.html
+pydocs/gdata.codesearch.html
+pydocs/gdata.codesearch.service.html
+pydocs/gdata.contacts.client.html
+pydocs/gdata.contacts.data.html
+pydocs/gdata.contacts.html
+pydocs/gdata.contacts.service.html
+pydocs/gdata.contentforshopping.client.html
+pydocs/gdata.contentforshopping.data.html
+pydocs/gdata.contentforshopping.html
+pydocs/gdata.core.html
+pydocs/gdata.data.html
+pydocs/gdata.docs.client.html
+pydocs/gdata.docs.data.html
+pydocs/gdata.docs.html
+pydocs/gdata.docs.service.html
+pydocs/gdata.dublincore.data.html
+pydocs/gdata.dublincore.html
+pydocs/gdata.exif.html
+pydocs/gdata.finance.data.html
+pydocs/gdata.finance.html
+pydocs/gdata.finance.service.html
+pydocs/gdata.gauth.html
+pydocs/gdata.geo.data.html
+pydocs/gdata.geo.html
+pydocs/gdata.health.html
+pydocs/gdata.health.service.html
+pydocs/gdata.html
+pydocs/gdata.maps.client.html
+pydocs/gdata.maps.html
+pydocs/gdata.marketplace.client.html
+pydocs/gdata.marketplace.data.html
+pydocs/gdata.marketplace.html
+pydocs/gdata.media.data.html
+pydocs/gdata.media.html
+pydocs/gdata.notebook.data.html
+pydocs/gdata.notebook.html
+pydocs/gdata.oauth.html
+pydocs/gdata.oauth.rsa.html
+pydocs/gdata.opensearch.data.html
+pydocs/gdata.opensearch.html
+pydocs/gdata.photos.html
+pydocs/gdata.photos.service.html
+pydocs/gdata.projecthosting.client.html
+pydocs/gdata.projecthosting.data.html
+pydocs/gdata.projecthosting.html
+pydocs/gdata.sample_util.html
+pydocs/gdata.service.html
+pydocs/gdata.sites.client.html
+pydocs/gdata.sites.data.html
+pydocs/gdata.sites.html
+pydocs/gdata.spreadsheet.html
+pydocs/gdata.spreadsheet.service.html
+pydocs/gdata.spreadsheet.text_db.html
+pydocs/gdata.spreadsheets.client.html
+pydocs/gdata.spreadsheets.data.html
+pydocs/gdata.spreadsheets.html
+pydocs/gdata.test_config.html
+pydocs/gdata.test_config_template.html
+pydocs/gdata.test_data.html
+pydocs/gdata.tlslite.BaseDB.html
+pydocs/gdata.tlslite.Checker.html
+pydocs/gdata.tlslite.FileObject.html
+pydocs/gdata.tlslite.HandshakeSettings.html
+pydocs/gdata.tlslite.Session.html
+pydocs/gdata.tlslite.SessionCache.html
+pydocs/gdata.tlslite.SharedKeyDB.html
+pydocs/gdata.tlslite.TLSConnection.html
+pydocs/gdata.tlslite.TLSRecordLayer.html
+pydocs/gdata.tlslite.VerifierDB.html
+pydocs/gdata.tlslite.X509.html
+pydocs/gdata.tlslite.X509CertChain.html
+pydocs/gdata.tlslite.api.html
+pydocs/gdata.tlslite.constants.html
+pydocs/gdata.tlslite.errors.html
+pydocs/gdata.tlslite.html
+pydocs/gdata.tlslite.integration.AsyncStateMachine.html
+pydocs/gdata.tlslite.integration.ClientHelper.html
+pydocs/gdata.tlslite.integration.HTTPTLSConnection.html
+pydocs/gdata.tlslite.integration.IMAP4_TLS.html
+pydocs/gdata.tlslite.integration.IntegrationHelper.html
+pydocs/gdata.tlslite.integration.POP3_TLS.html
+pydocs/gdata.tlslite.integration.SMTP_TLS.html
+pydocs/gdata.tlslite.integration.TLSAsyncDispatcherMixIn.html
+pydocs/gdata.tlslite.integration.TLSSocketServerMixIn.html
+pydocs/gdata.tlslite.integration.TLSTwistedProtocolWrapper.html
+pydocs/gdata.tlslite.integration.XMLRPCTransport.html
+pydocs/gdata.tlslite.integration.html
+pydocs/gdata.tlslite.mathtls.html
+pydocs/gdata.tlslite.messages.html
+pydocs/gdata.tlslite.utils.AES.html
+pydocs/gdata.tlslite.utils.ASN1Parser.html
+pydocs/gdata.tlslite.utils.Cryptlib_AES.html
+pydocs/gdata.tlslite.utils.Cryptlib_RC4.html
+pydocs/gdata.tlslite.utils.Cryptlib_TripleDES.html
+pydocs/gdata.tlslite.utils.OpenSSL_AES.html
+pydocs/gdata.tlslite.utils.OpenSSL_RC4.html
+pydocs/gdata.tlslite.utils.OpenSSL_RSAKey.html
+pydocs/gdata.tlslite.utils.OpenSSL_TripleDES.html
+pydocs/gdata.tlslite.utils.PyCrypto_AES.html
+pydocs/gdata.tlslite.utils.PyCrypto_RC4.html
+pydocs/gdata.tlslite.utils.PyCrypto_RSAKey.html
+pydocs/gdata.tlslite.utils.PyCrypto_TripleDES.html
+pydocs/gdata.tlslite.utils.Python_AES.html
+pydocs/gdata.tlslite.utils.Python_RC4.html
+pydocs/gdata.tlslite.utils.Python_RSAKey.html
+pydocs/gdata.tlslite.utils.RC4.html
+pydocs/gdata.tlslite.utils.RSAKey.html
+pydocs/gdata.tlslite.utils.TripleDES.html
+pydocs/gdata.tlslite.utils.cipherfactory.html
+pydocs/gdata.tlslite.utils.codec.html
+pydocs/gdata.tlslite.utils.compat.html
+pydocs/gdata.tlslite.utils.cryptomath.html
+pydocs/gdata.tlslite.utils.dateFuncs.html
+pydocs/gdata.tlslite.utils.hmac.html
+pydocs/gdata.tlslite.utils.html
+pydocs/gdata.tlslite.utils.jython_compat.html
+pydocs/gdata.tlslite.utils.keyfactory.html
+pydocs/gdata.tlslite.utils.rijndael.html
+pydocs/gdata.tlslite.utils.xmltools.html
+pydocs/gdata.urlfetch.html
+pydocs/gdata.webmastertools.data.html
+pydocs/gdata.webmastertools.html
+pydocs/gdata.webmastertools.service.html
+pydocs/gdata.youtube.client.html
+pydocs/gdata.youtube.data.html
+pydocs/gdata.youtube.html
+pydocs/gdata.youtube.service.html
+pydocs/generate_docs
+samples/analytics/account_feed_demo.py
+samples/analytics/data_feed_demo.py
+samples/analytics/mgmt_feed_demo.py
+samples/apps/adminsettings_example.py
+samples/apps/client_secrets.json
+samples/apps/create_update_group.py
+samples/apps/email_audit_email_monitoring.py
+samples/apps/email_settings_labels_filters.py
+samples/apps/emailsettings_example.py
+samples/apps/emailsettings_pop_settings.py
+samples/apps/groups_provisioning_quick_start_example.py
+samples/apps/list_group_members.py
+samples/apps/migration_example.py
+samples/apps/multidomain_quick_start_example.py
+samples/apps/org_unit_sites.py
+samples/apps/orgunit_quick_start_example.py
+samples/apps/provisioning_oauth2_example.py
+samples/apps/search_organize_users.py
+samples/apps/suspended_users_cleanup.py
+samples/apps/user_profile_contacts_2lo.py
+samples/apps/userprovisioning_quick_start_example.py
+samples/apps/marketplace_sample/app.yaml
+samples/apps/marketplace_sample/domain_mgmt_app.py
+samples/apps/marketplace_sample/appengine_utilities/__init__.py
+samples/apps/marketplace_sample/appengine_utilities/cache.py
+samples/apps/marketplace_sample/appengine_utilities/event.py
+samples/apps/marketplace_sample/appengine_utilities/flash.py
+samples/apps/marketplace_sample/appengine_utilities/rotmodel.py
+samples/apps/marketplace_sample/appengine_utilities/sessions.py
+samples/apps/marketplace_sample/appengine_utilities/settings_default.py
+samples/apps/marketplace_sample/appengine_utilities/django-middleware/__init__.py
+samples/apps/marketplace_sample/appengine_utilities/django-middleware/middleware.py
+samples/apps/marketplace_sample/appengine_utilities/interface/__init__.py
+samples/apps/marketplace_sample/appengine_utilities/interface/main.py
+samples/apps/marketplace_sample/appengine_utilities/interface/css/main.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-context-min.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-context.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-min.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-context-min.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-context.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-min.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-context-min.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-context.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-min.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-context-min.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-context.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-min.css
+samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset.css
+samples/apps/marketplace_sample/appengine_utilities/interface/templates/404.html
+samples/apps/marketplace_sample/appengine_utilities/interface/templates/base.html
+samples/apps/marketplace_sample/appengine_utilities/interface/templates/scheduler_form.html
+samples/apps/marketplace_sample/atom/__init__.py
+samples/apps/marketplace_sample/atom/auth.py
+samples/apps/marketplace_sample/atom/client.py
+samples/apps/marketplace_sample/atom/core.py
+samples/apps/marketplace_sample/atom/data.py
+samples/apps/marketplace_sample/atom/http.py
+samples/apps/marketplace_sample/atom/http_core.py
+samples/apps/marketplace_sample/atom/http_interface.py
+samples/apps/marketplace_sample/atom/mock_http.py
+samples/apps/marketplace_sample/atom/mock_http_core.py
+samples/apps/marketplace_sample/atom/mock_service.py
+samples/apps/marketplace_sample/atom/service.py
+samples/apps/marketplace_sample/atom/token_store.py
+samples/apps/marketplace_sample/atom/url.py
+samples/apps/marketplace_sample/css/style.css
+samples/apps/marketplace_sample/gdata/__init__.py
+samples/apps/marketplace_sample/gdata/apps_property.py
+samples/apps/marketplace_sample/gdata/auth.py
+samples/apps/marketplace_sample/gdata/client.py
+samples/apps/marketplace_sample/gdata/core.py
+samples/apps/marketplace_sample/gdata/data.py
+samples/apps/marketplace_sample/gdata/gauth.py
+samples/apps/marketplace_sample/gdata/sample_util.py
+samples/apps/marketplace_sample/gdata/service.py
+samples/apps/marketplace_sample/gdata/test_config.py
+samples/apps/marketplace_sample/gdata/test_data.py
+samples/apps/marketplace_sample/gdata/urlfetch.py
+samples/apps/marketplace_sample/gdata/apps/__init__.py
+samples/apps/marketplace_sample/gdata/apps/apps_property_entry.py
+samples/apps/marketplace_sample/gdata/apps/client.py
+samples/apps/marketplace_sample/gdata/apps/data.py
+samples/apps/marketplace_sample/gdata/apps/service.py
+samples/apps/marketplace_sample/gdata/apps/adminsettings/__init__.py
+samples/apps/marketplace_sample/gdata/apps/adminsettings/service.py
+samples/apps/marketplace_sample/gdata/apps/audit/__init__.py
+samples/apps/marketplace_sample/gdata/apps/audit/service.py
+samples/apps/marketplace_sample/gdata/apps/emailsettings/__init__.py
+samples/apps/marketplace_sample/gdata/apps/emailsettings/client.py
+samples/apps/marketplace_sample/gdata/apps/emailsettings/data.py
+samples/apps/marketplace_sample/gdata/apps/emailsettings/service.py
+samples/apps/marketplace_sample/gdata/apps/groups/__init__.py
+samples/apps/marketplace_sample/gdata/apps/groups/client.py
+samples/apps/marketplace_sample/gdata/apps/groups/data.py
+samples/apps/marketplace_sample/gdata/apps/groups/service.py
+samples/apps/marketplace_sample/gdata/apps/migration/__init__.py
+samples/apps/marketplace_sample/gdata/apps/migration/service.py
+samples/apps/marketplace_sample/gdata/apps/multidomain/__init__.py
+samples/apps/marketplace_sample/gdata/apps/multidomain/client.py
+samples/apps/marketplace_sample/gdata/apps/multidomain/data.py
+samples/apps/marketplace_sample/gdata/apps/organization/__init__.py
+samples/apps/marketplace_sample/gdata/apps/organization/client.py
+samples/apps/marketplace_sample/gdata/apps/organization/data.py
+samples/apps/marketplace_sample/gdata/apps/organization/service.py
+samples/apps/marketplace_sample/gdata/calendar/__init__.py
+samples/apps/marketplace_sample/gdata/calendar/client.py
+samples/apps/marketplace_sample/gdata/calendar/data.py
+samples/apps/marketplace_sample/gdata/calendar/service.py
+samples/apps/marketplace_sample/gdata/oauth/CHANGES.txt
+samples/apps/marketplace_sample/gdata/oauth/__init__.py
+samples/apps/marketplace_sample/gdata/oauth/rsa.py
+samples/apps/marketplace_sample/gdata/tlslite/BaseDB.py
+samples/apps/marketplace_sample/gdata/tlslite/Checker.py
+samples/apps/marketplace_sample/gdata/tlslite/FileObject.py
+samples/apps/marketplace_sample/gdata/tlslite/HandshakeSettings.py
+samples/apps/marketplace_sample/gdata/tlslite/Session.py
+samples/apps/marketplace_sample/gdata/tlslite/SessionCache.py
+samples/apps/marketplace_sample/gdata/tlslite/SharedKeyDB.py
+samples/apps/marketplace_sample/gdata/tlslite/TLSConnection.py
+samples/apps/marketplace_sample/gdata/tlslite/TLSRecordLayer.py
+samples/apps/marketplace_sample/gdata/tlslite/VerifierDB.py
+samples/apps/marketplace_sample/gdata/tlslite/X509.py
+samples/apps/marketplace_sample/gdata/tlslite/X509CertChain.py
+samples/apps/marketplace_sample/gdata/tlslite/__init__.py
+samples/apps/marketplace_sample/gdata/tlslite/api.py
+samples/apps/marketplace_sample/gdata/tlslite/constants.py
+samples/apps/marketplace_sample/gdata/tlslite/errors.py
+samples/apps/marketplace_sample/gdata/tlslite/mathtls.py
+samples/apps/marketplace_sample/gdata/tlslite/messages.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/AsyncStateMachine.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/ClientHelper.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/HTTPTLSConnection.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/IMAP4_TLS.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/IntegrationHelper.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/POP3_TLS.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/SMTP_TLS.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/TLSAsyncDispatcherMixIn.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/TLSSocketServerMixIn.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/TLSTwistedProtocolWrapper.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/XMLRPCTransport.py
+samples/apps/marketplace_sample/gdata/tlslite/integration/__init__.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/AES.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/ASN1Parser.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_AES.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_RC4.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_TripleDES.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_AES.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_RC4.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_RSAKey.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_TripleDES.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_AES.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_RC4.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_RSAKey.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_TripleDES.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/Python_AES.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/Python_RC4.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/Python_RSAKey.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/RC4.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/RSAKey.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/TripleDES.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/__init__.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/cipherfactory.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/codec.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/compat.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/cryptomath.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/dateFuncs.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/entropy.c
+samples/apps/marketplace_sample/gdata/tlslite/utils/hmac.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/jython_compat.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/keyfactory.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/rijndael.py
+samples/apps/marketplace_sample/gdata/tlslite/utils/win32prng.c
+samples/apps/marketplace_sample/gdata/tlslite/utils/xmltools.py
+samples/apps/marketplace_sample/images/google.png
+samples/apps/marketplace_sample/js/json2.js
+samples/apps/marketplace_sample/js/main.js
+samples/apps/marketplace_sample/templates/index.html
+samples/apps/provisioning_oauth_example/app.yaml
+samples/apps/provisioning_oauth_example/footer.html
+samples/apps/provisioning_oauth_example/header.html
+samples/apps/provisioning_oauth_example/index.html
+samples/apps/provisioning_oauth_example/login.html
+samples/apps/provisioning_oauth_example/main.py
+samples/apps/provisioning_oauth_example/css/index.css
+samples/apps/provisioning_oauth_example/images/google-small.png
+samples/apps/provisioning_oauth_example/js/index.js
+samples/authsub/secure_authsub.py
+samples/blogger/BloggerExample.py
+samples/blogger/BloggerExampleV1.py
+samples/blogger/app/app.yaml
+samples/blogger/app/auth_required.html
+samples/blogger/app/blogapp.py
+samples/blogger/app/list_blogs.html
+samples/blogger/app/post_editor.html
+samples/blogger/app/welcome.html
+samples/blogger/oauth-appengine/app.yaml
+samples/blogger/oauth-appengine/index.html
+samples/blogger/oauth-appengine/index.yaml
+samples/blogger/oauth-appengine/main.py
+samples/blogger/oauth-appengine/oauth.py
+samples/blogger/oauth-appengine/css/index.css
+samples/calendar/calendarExample.py
+samples/calendar_resource/calendar_resource_example.py
+samples/codesearch/CodesearchExample.py
+samples/contacts/contacts_example.py
+samples/contacts/profiles_example.py
+samples/contacts/unshare_profiles.py
+samples/contentforshopping/add_batch_products.py
+samples/contentforshopping/add_product.py
+samples/contentforshopping/ca_insert.py
+samples/contentforshopping/ca_list.py
+samples/contentforshopping/list_products.py
+samples/docs/docs_example.py
+samples/docs/docs_v3_example.py
+samples/docs/samplerunner.py
+samples/finance/test_finance.py
+samples/mashups/birthdaySample.py
+samples/oauth/2_legged_oauth.py
+samples/oauth/TwoLeggedOAuthExample.py
+samples/oauth/oauth_example.py
+samples/oauth/oauth_on_appengine/README.txt
+samples/oauth/oauth_on_appengine/app.yaml
+samples/oauth/oauth_on_appengine/index.html
+samples/oauth/oauth_on_appengine/index.yaml
+samples/oauth/oauth_on_appengine/main_hmac.py
+samples/oauth/oauth_on_appengine/main_rsa.py
+samples/oauth/oauth_on_appengine/appengine_utilities/__init__.py
+samples/oauth/oauth_on_appengine/appengine_utilities/cache.py
+samples/oauth/oauth_on_appengine/appengine_utilities/cron.py
+samples/oauth/oauth_on_appengine/appengine_utilities/event.py
+samples/oauth/oauth_on_appengine/appengine_utilities/flash.py
+samples/oauth/oauth_on_appengine/appengine_utilities/paginator.py
+samples/oauth/oauth_on_appengine/appengine_utilities/rotmodel.py
+samples/oauth/oauth_on_appengine/appengine_utilities/sessions.py
+samples/oauth/oauth_on_appengine/css/index.css
+samples/oauth/oauth_on_appengine/images/icon_document.gif
+samples/oauth/oauth_on_appengine/images/icon_folder.gif
+samples/oauth/oauth_on_appengine/images/icon_pdf.gif
+samples/oauth/oauth_on_appengine/images/icon_presentation.gif
+samples/oauth/oauth_on_appengine/images/icon_spreadsheet.gif
+samples/oauth/oauth_on_appengine/images/icon_starred.png
+samples/oauth/oauth_on_appengine/images/icon_trashed.png
+samples/oauth/oauth_on_appengine/js/jquery.corners.min.js
+samples/sites/sites_example.py
+samples/spreadsheets/spreadsheetExample.py
+samples/webmastertools/AddDeleteExampleDotCom.py
+samples/webmastertools/SitemapsFeedSummary.py
+samples/webmastertools/SitesFeedSummary.py
+src/atom/__init__.py
+src/atom/auth.py
+src/atom/client.py
+src/atom/core.py
+src/atom/data.py
+src/atom/http.py
+src/atom/http_core.py
+src/atom/http_interface.py
+src/atom/mock_http.py
+src/atom/mock_http_core.py
+src/atom/mock_service.py
+src/atom/service.py
+src/atom/token_store.py
+src/atom/url.py
+src/gdata/__init__.py
+src/gdata/apps_property.py
+src/gdata/auth.py
+src/gdata/client.py
+src/gdata/core.py
+src/gdata/data.py
+src/gdata/gauth.py
+src/gdata/sample_util.py
+src/gdata/service.py
+src/gdata/test_config.py
+src/gdata/test_data.py
+src/gdata/urlfetch.py
+src/gdata/Crypto/__init__.py
+src/gdata/Crypto/test.py
+src/gdata/Crypto/Cipher/AES.pyd
+src/gdata/Crypto/Cipher/ARC2.pyd
+src/gdata/Crypto/Cipher/ARC4.pyd
+src/gdata/Crypto/Cipher/Blowfish.pyd
+src/gdata/Crypto/Cipher/CAST.pyd
+src/gdata/Crypto/Cipher/DES.pyd
+src/gdata/Crypto/Cipher/DES3.pyd
+src/gdata/Crypto/Cipher/IDEA.pyd
+src/gdata/Crypto/Cipher/RC5.pyd
+src/gdata/Crypto/Cipher/XOR.pyd
+src/gdata/Crypto/Cipher/__init__.py
+src/gdata/Crypto/Hash/HMAC.py
+src/gdata/Crypto/Hash/MD2.pyd
+src/gdata/Crypto/Hash/MD4.pyd
+src/gdata/Crypto/Hash/MD5.py
+src/gdata/Crypto/Hash/RIPEMD.pyd
+src/gdata/Crypto/Hash/SHA.py
+src/gdata/Crypto/Hash/SHA256.pyd
+src/gdata/Crypto/Hash/__init__.py
+src/gdata/Crypto/Protocol/AllOrNothing.py
+src/gdata/Crypto/Protocol/Chaffing.py
+src/gdata/Crypto/Protocol/__init__.py
+src/gdata/Crypto/PublicKey/DSA.py
+src/gdata/Crypto/PublicKey/ElGamal.py
+src/gdata/Crypto/PublicKey/RSA.py
+src/gdata/Crypto/PublicKey/__init__.py
+src/gdata/Crypto/PublicKey/pubkey.py
+src/gdata/Crypto/PublicKey/qNEW.py
+src/gdata/Crypto/Util/RFC1751.py
+src/gdata/Crypto/Util/__init__.py
+src/gdata/Crypto/Util/number.py
+src/gdata/Crypto/Util/randpool.py
+src/gdata/Crypto/Util/test.py
+src/gdata/acl/__init__.py
+src/gdata/acl/data.py
+src/gdata/alt/__init__.py
+src/gdata/alt/app_engine.py
+src/gdata/alt/appengine.py
+src/gdata/analytics/__init__.py
+src/gdata/analytics/client.py
+src/gdata/analytics/data.py
+src/gdata/analytics/service.py
+src/gdata/apps/__init__.py
+src/gdata/apps/apps_property_entry.py
+src/gdata/apps/client.py
+src/gdata/apps/data.py
+src/gdata/apps/service.py
+src/gdata/apps/adminsettings/__init__.py
+src/gdata/apps/adminsettings/service.py
+src/gdata/apps/audit/__init__.py
+src/gdata/apps/audit/service.py
+src/gdata/apps/emailsettings/__init__.py
+src/gdata/apps/emailsettings/client.py
+src/gdata/apps/emailsettings/data.py
+src/gdata/apps/emailsettings/service.py
+src/gdata/apps/groups/__init__.py
+src/gdata/apps/groups/client.py
+src/gdata/apps/groups/data.py
+src/gdata/apps/groups/service.py
+src/gdata/apps/migration/__init__.py
+src/gdata/apps/migration/service.py
+src/gdata/apps/multidomain/__init__.py
+src/gdata/apps/multidomain/client.py
+src/gdata/apps/multidomain/data.py
+src/gdata/apps/organization/__init__.py
+src/gdata/apps/organization/client.py
+src/gdata/apps/organization/data.py
+src/gdata/apps/organization/service.py
+src/gdata/blogger/__init__.py
+src/gdata/blogger/client.py
+src/gdata/blogger/data.py
+src/gdata/blogger/service.py
+src/gdata/books/__init__.py
+src/gdata/books/data.py
+src/gdata/books/service.py
+src/gdata/calendar/__init__.py
+src/gdata/calendar/client.py
+src/gdata/calendar/data.py
+src/gdata/calendar/service.py
+src/gdata/calendar_resource/__init__.py
+src/gdata/calendar_resource/client.py
+src/gdata/calendar_resource/data.py
+src/gdata/codesearch/__init__.py
+src/gdata/codesearch/service.py
+src/gdata/contacts/__init__.py
+src/gdata/contacts/client.py
+src/gdata/contacts/data.py
+src/gdata/contacts/service.py
+src/gdata/contentforshopping/__init__.py
+src/gdata/contentforshopping/client.py
+src/gdata/contentforshopping/data.py
+src/gdata/docs/__init__.py
+src/gdata/docs/client.py
+src/gdata/docs/data.py
+src/gdata/docs/service.py
+src/gdata/dublincore/__init__.py
+src/gdata/dublincore/data.py
+src/gdata/exif/__init__.py
+src/gdata/finance/__init__.py
+src/gdata/finance/data.py
+src/gdata/finance/service.py
+src/gdata/geo/__init__.py
+src/gdata/geo/data.py
+src/gdata/health/__init__.py
+src/gdata/health/service.py
+src/gdata/marketplace/__init__.py
+src/gdata/marketplace/client.py
+src/gdata/marketplace/data.py
+src/gdata/media/__init__.py
+src/gdata/media/data.py
+src/gdata/notebook/__init__.py
+src/gdata/notebook/data.py
+src/gdata/oauth/CHANGES.txt
+src/gdata/oauth/__init__.py
+src/gdata/oauth/rsa.py
+src/gdata/opensearch/__init__.py
+src/gdata/opensearch/data.py
+src/gdata/photos/__init__.py
+src/gdata/photos/service.py
+src/gdata/projecthosting/__init__.py
+src/gdata/projecthosting/client.py
+src/gdata/projecthosting/data.py
+src/gdata/sites/__init__.py
+src/gdata/sites/client.py
+src/gdata/sites/data.py
+src/gdata/spreadsheet/__init__.py
+src/gdata/spreadsheet/service.py
+src/gdata/spreadsheet/text_db.py
+src/gdata/spreadsheets/__init__.py
+src/gdata/spreadsheets/client.py
+src/gdata/spreadsheets/data.py
+src/gdata/tlslite/BaseDB.py
+src/gdata/tlslite/Checker.py
+src/gdata/tlslite/FileObject.py
+src/gdata/tlslite/HandshakeSettings.py
+src/gdata/tlslite/Session.py
+src/gdata/tlslite/SessionCache.py
+src/gdata/tlslite/SharedKeyDB.py
+src/gdata/tlslite/TLSConnection.py
+src/gdata/tlslite/TLSRecordLayer.py
+src/gdata/tlslite/VerifierDB.py
+src/gdata/tlslite/X509.py
+src/gdata/tlslite/X509CertChain.py
+src/gdata/tlslite/__init__.py
+src/gdata/tlslite/api.py
+src/gdata/tlslite/constants.py
+src/gdata/tlslite/errors.py
+src/gdata/tlslite/mathtls.py
+src/gdata/tlslite/messages.py
+src/gdata/tlslite/integration/AsyncStateMachine.py
+src/gdata/tlslite/integration/ClientHelper.py
+src/gdata/tlslite/integration/HTTPTLSConnection.py
+src/gdata/tlslite/integration/IMAP4_TLS.py
+src/gdata/tlslite/integration/IntegrationHelper.py
+src/gdata/tlslite/integration/POP3_TLS.py
+src/gdata/tlslite/integration/SMTP_TLS.py
+src/gdata/tlslite/integration/TLSAsyncDispatcherMixIn.py
+src/gdata/tlslite/integration/TLSSocketServerMixIn.py
+src/gdata/tlslite/integration/TLSTwistedProtocolWrapper.py
+src/gdata/tlslite/integration/XMLRPCTransport.py
+src/gdata/tlslite/integration/__init__.py
+src/gdata/tlslite/utils/AES.py
+src/gdata/tlslite/utils/ASN1Parser.py
+src/gdata/tlslite/utils/Cryptlib_AES.py
+src/gdata/tlslite/utils/Cryptlib_RC4.py
+src/gdata/tlslite/utils/Cryptlib_TripleDES.py
+src/gdata/tlslite/utils/OpenSSL_AES.py
+src/gdata/tlslite/utils/OpenSSL_RC4.py
+src/gdata/tlslite/utils/OpenSSL_RSAKey.py
+src/gdata/tlslite/utils/OpenSSL_TripleDES.py
+src/gdata/tlslite/utils/PyCrypto_AES.py
+src/gdata/tlslite/utils/PyCrypto_RC4.py
+src/gdata/tlslite/utils/PyCrypto_RSAKey.py
+src/gdata/tlslite/utils/PyCrypto_TripleDES.py
+src/gdata/tlslite/utils/Python_AES.py
+src/gdata/tlslite/utils/Python_RC4.py
+src/gdata/tlslite/utils/Python_RSAKey.py
+src/gdata/tlslite/utils/RC4.py
+src/gdata/tlslite/utils/RSAKey.py
+src/gdata/tlslite/utils/TripleDES.py
+src/gdata/tlslite/utils/__init__.py
+src/gdata/tlslite/utils/cipherfactory.py
+src/gdata/tlslite/utils/codec.py
+src/gdata/tlslite/utils/compat.py
+src/gdata/tlslite/utils/cryptomath.py
+src/gdata/tlslite/utils/dateFuncs.py
+src/gdata/tlslite/utils/entropy.c
+src/gdata/tlslite/utils/hmac.py
+src/gdata/tlslite/utils/jython_compat.py
+src/gdata/tlslite/utils/keyfactory.py
+src/gdata/tlslite/utils/rijndael.py
+src/gdata/tlslite/utils/win32prng.c
+src/gdata/tlslite/utils/xmltools.py
+src/gdata/webmastertools/__init__.py
+src/gdata/webmastertools/data.py
+src/gdata/webmastertools/service.py
+src/gdata/youtube/__init__.py
+src/gdata/youtube/client.py
+src/gdata/youtube/data.py
+src/gdata/youtube/service.py
+tests/__init__.py
+tests/all_tests.py
+tests/all_tests_cached.py
+tests/all_tests_clear_cache.py
+tests/all_tests_coverage.py
+tests/all_tests_local.py
+tests/atom_test.py
+tests/coverage.py
+tests/gdata_test.py
+tests/module_test_runner.py
+tests/run_all_tests.py
+tests/run_data_tests.py
+tests/run_service_tests.py
+tests/testimage.jpg
+tests/atom_tests/__init__.py
+tests/atom_tests/auth_test.py
+tests/atom_tests/client_test.py
+tests/atom_tests/core_test.py
+tests/atom_tests/data_test.py
+tests/atom_tests/http_core_test.py
+tests/atom_tests/http_interface_test.py
+tests/atom_tests/mock_client_test.py
+tests/atom_tests/mock_http_core_test.py
+tests/atom_tests/mock_http_test.py
+tests/atom_tests/mock_server_test.py
+tests/atom_tests/service_test.py
+tests/atom_tests/token_store_test.py
+tests/atom_tests/url_test.py
+tests/files/testimage.jpg
+tests/gdata_tests/__init__.py
+tests/gdata_tests/apps_test.py
+tests/gdata_tests/auth_test.py
+tests/gdata_tests/blogger_test.py
+tests/gdata_tests/books_test.py
+tests/gdata_tests/calendar_test.py
+tests/gdata_tests/client_smoke_test.py
+tests/gdata_tests/client_test.py
+tests/gdata_tests/codesearch_test.py
+tests/gdata_tests/contacts_test.py
+tests/gdata_tests/contentforshopping_test.py
+tests/gdata_tests/core_test.py
+tests/gdata_tests/data_smoke_test.py
+tests/gdata_tests/data_test.py
+tests/gdata_tests/docs_test.py
+tests/gdata_tests/gauth_test.py
+tests/gdata_tests/health_test.py
+tests/gdata_tests/live_client_test.py
+tests/gdata_tests/photos_test.py
+tests/gdata_tests/resumable_upload_test.py
+tests/gdata_tests/sample_util_test.py
+tests/gdata_tests/service_test.py
+tests/gdata_tests/spreadsheet_test.py
+tests/gdata_tests/webmastertools_test.py
+tests/gdata_tests/youtube_test.py
+tests/gdata_tests/analytics/__init__.py
+tests/gdata_tests/analytics/data_test.py
+tests/gdata_tests/analytics/live_client_test.py
+tests/gdata_tests/analytics/query_test.py
+tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllEmailLists.pickle
+tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllNicknames.pickle
+tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllRecipients.pickle
+tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllUsers.pickle
+tests/gdata_tests/apps/TestDataForGeneratorTest.p
+tests/gdata_tests/apps/__init__.py
+tests/gdata_tests/apps/data_test.py
+tests/gdata_tests/apps/live_client_test.py
+tests/gdata_tests/apps/service_test.py
+tests/gdata_tests/apps/service_test_using_mock.py
+tests/gdata_tests/apps/emailsettings/__init__.py
+tests/gdata_tests/apps/emailsettings/data_test.py
+tests/gdata_tests/apps/emailsettings/live_client_test.py
+tests/gdata_tests/apps/emailsettings/service_test.py
+tests/gdata_tests/apps/groups/__init__.py
+tests/gdata_tests/apps/groups/data_test.py
+tests/gdata_tests/apps/groups/live_client_test.py
+tests/gdata_tests/apps/groups/service_test.py
+tests/gdata_tests/apps/migration/__init__.py
+tests/gdata_tests/apps/migration/service_test.py
+tests/gdata_tests/apps/multidomain/__init__.py
+tests/gdata_tests/apps/multidomain/data_test.py
+tests/gdata_tests/apps/multidomain/live_client_test.py
+tests/gdata_tests/apps/organization/__init__.py
+tests/gdata_tests/apps/organization/data_test.py
+tests/gdata_tests/apps/organization/live_client_test.py
+tests/gdata_tests/apps/organization/service_test.py
+tests/gdata_tests/blogger/__init__.py
+tests/gdata_tests/blogger/data_test.py
+tests/gdata_tests/blogger/live_client_test.py
+tests/gdata_tests/blogger/service_test.py
+tests/gdata_tests/books/__init__.py
+tests/gdata_tests/books/service_test.py
+tests/gdata_tests/calendar/__init__.py
+tests/gdata_tests/calendar/calendar_acl_test.py
+tests/gdata_tests/calendar/service_test.py
+tests/gdata_tests/calendar_resource/__init__.py
+tests/gdata_tests/calendar_resource/data_test.py
+tests/gdata_tests/calendar_resource/live_client_test.py
+tests/gdata_tests/contacts/__init__.py
+tests/gdata_tests/contacts/live_client_test.py
+tests/gdata_tests/contacts/service_test.py
+tests/gdata_tests/contacts/profiles/__init__.py
+tests/gdata_tests/contacts/profiles/live_client_test.py
+tests/gdata_tests/contacts/profiles/service_test.py
+tests/gdata_tests/docs/__init__.py
+tests/gdata_tests/docs/data_test.py
+tests/gdata_tests/docs/live_client_test.py
+tests/gdata_tests/docs/service_test.py
+tests/gdata_tests/docs/data/test.0.bin
+tests/gdata_tests/docs/data/test.0.csv
+tests/gdata_tests/docs/data/test.0.doc
+tests/gdata_tests/docs/data/test.0.pdf
+tests/gdata_tests/docs/data/test.0.ppt
+tests/gdata_tests/docs/data/test.0.wmf
+tests/gdata_tests/docs/data/test.1.bin
+tests/gdata_tests/docs/data/test.1.csv
+tests/gdata_tests/docs/data/test.1.doc
+tests/gdata_tests/docs/data/test.1.pdf
+tests/gdata_tests/docs/data/test.1.ppt
+tests/gdata_tests/docs/data/test.1.wmf
+tests/gdata_tests/health/__init__.py
+tests/gdata_tests/health/service_test.py
+tests/gdata_tests/marketplace/__init__.py
+tests/gdata_tests/marketplace/live_client_test.py
+tests/gdata_tests/oauth/__init__.py
+tests/gdata_tests/oauth/data_test.py
+tests/gdata_tests/photos/__init__.py
+tests/gdata_tests/photos/service_test.py
+tests/gdata_tests/projecthosting/__init__.py
+tests/gdata_tests/projecthosting/data_test.py
+tests/gdata_tests/projecthosting/live_client_test.py
+tests/gdata_tests/sites/__init__.py
+tests/gdata_tests/sites/data_test.py
+tests/gdata_tests/sites/live_client_test.py
+tests/gdata_tests/spreadsheet/__init__.py
+tests/gdata_tests/spreadsheet/service_test.py
+tests/gdata_tests/spreadsheet/text_db_test.py
+tests/gdata_tests/spreadsheets/__init__.py
+tests/gdata_tests/spreadsheets/data_test.py
+tests/gdata_tests/spreadsheets/live_client_test.py
+tests/gdata_tests/youtube/__init__.py
+tests/gdata_tests/youtube/live_client_test.py
+tests/gdata_tests/youtube/service_test.py
diff --git a/PKG-INFO b/PKG-INFO
new file mode 100644
index 0000000..0a6db90
--- /dev/null
+++ b/PKG-INFO
@@ -0,0 +1,39 @@
+Metadata-Version: 1.0
+Name: gdata
+Version: 2.0.18
+Summary: Python client library for Google data APIs
+Home-page: http://code.google.com/p/gdata-python-client/
+Author: Jeffrey Scudder
+Author-email: j.s@google.com
+License: Apache 2.0
+Description: The Google data Python client library makes it easy to interact with
+ Google services through the Google Data APIs. This library provides data
+ models and service modules for the the following Google data services:
+ - Google Calendar data API
+ - Google Contacts data API
+ - Google Spreadsheets data API
+ - Google Document List data APIs
+ - Google Base data API
+ - Google Apps Provisioning API
+ - Google Apps Email Migration API
+ - Google Apps Email Settings API
+ - Picasa Web Albums Data API
+ - Google Code Search Data API
+ - YouTube Data API
+ - Google Webmaster Tools Data API
+ - Blogger Data API
+ - Google Health API
+ - Google Book Search API
+ - Google Analytics API
+ - Google Finance API
+ - Google Sites Data API
+ - Google Content API For Shopping
+ - Google App Marketplace API
+ - Google Content API for Shopping
+ - core Google data API functionality
+ The core Google data code provides sufficient functionality to use this
+ library with any Google data API (even if a module hasn't been written for
+ it yet). For example, this client can be used with the Notebook API. This
+ library may also be used with any Atom Publishing Protocol service (AtomPub).
+
+Platform: UNKNOWN
diff --git a/README.chromium b/README.chromium
new file mode 100644
index 0000000..81c33e9
--- /dev/null
+++ b/README.chromium
@@ -0,0 +1,13 @@
+Name: gdata
+Short Name: gdata
+URL: https://code.google.com/p/gdata-python-client/
+Version: 2.0.18
+License: Apache License, Version 2.0
+License File: README.txt
+Security Critical: no
+
+Description:
+The Google Data APIs (Google Data) provide a simple protocol for reading and
+writing data on the web. Though it is possible to use these services with a
+simple HTTP client, this library provides helpful tools to streamline your code
+and keep up with server-side changes.
diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..9bb8460
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,28 @@
+ Copyright (C) 2006-2010 Google Inc.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+ For more information on the GData Python client library, please see the
+project on code.google.com's hosting service here:
+http://code.google.com/p/gdata-python-client/
+
+ Dependency Modules
+
+ ElementTree - For XML parsing, download here:
+http://effbot.org/zone/element-index.htm
+
+ httplib - Part of the core Python library since version 2.0, so it should
+already be present.
+
+ urllib - For URL creation and URL encoding, should already be present in
+current versions of Python.
diff --git a/RELEASE_NOTES.txt b/RELEASE_NOTES.txt
new file mode 100644
index 0000000..e01c416
--- /dev/null
+++ b/RELEASE_NOTES.txt
@@ -0,0 +1,1009 @@
+=== 2.0.18 ===
+1173[tip] 93c436da2d19 2013-06-14 07:21 -0700 afshar
+ Remove unused script.
+
+1172 e692050ec194 2013-06-14 07:20 -0700 afshar
+ Updated docs.
+
+1171 159874713088 2013-06-14 07:20 -0700 afshar
+ Bumped version.
+
+1170 7b4e3c22e83c 2013-06-07 15:52 +0200 burcud
+ Adding missing unit attributes for unit picing elements.
+
+1169 ad8ee900dda5 2013-06-06 19:01 +0200 burcud
+ Fixing identifier_exists attribute for product items.
+
+1168 d6ce8dc4970a 2013-06-06 17:53 +0200 burcud
+ Fixing multipack attribute.
+
+1167 b87779918c90 2013-06-06 15:10 +0200 burcud
+ Adding new product spec attributes.
+
+1166 624d33ad26f2 2013-02-11 12:47 -0800 rkubiak
+ Update Sites Python API to allow page creation from a template
+
+1165 ecb1d49b5fbe 2013-01-07 11:29 -0800 dhermes
+ Adding an OAuth2Token subclass which can interact with google-api-python-client.
+
+1164 f76c53eaf151 2012-11-20 16:09 +0100 burcud
+ Modifying Content API for Shopping client to use schema projection.
+
+1163 a8c25010b8b7 2012-08-27 13:50 -0700 dhermes
+ Adding in ability to change Content for Shopping base URI via a kwarg for client constructor. (Fixes 6479060).
+
+1162 c5d57eff0ef4 2012-08-15 08:31 -0700 dhermes
+ Adding paid clicks to Content API performance datapoint. (Issue 6443130)
+
+1161 71971b013563 2012-08-06 15:20 -0700 dhermes
+ Adding support for adwords_accounts settings element in managedaccounts feed of Content API. (6443092)
+
+1160 cf0208e89433 2012-07-30 09:53 -0700 dhermes
+ Changing OAuth2 Authorization Header lead in from OAuth to Bearer (per http://goo.gl/QDiLZ). (issue 6455060)
+
+1159 3b021605570f 2012-07-12 18:14 -0700 dhermes
+ Adding missing name XML attribute to gdata.contentforshopping.data.Group.
+
+1158 524fc2b2e821 2012-06-19 08:43 -0700 dhermes
+ Renaming classes for inventory feed of Content API. (Issue 6296085)
+
+1157 32c0cb313b2e 2012-06-14 15:36 -0700 dhermes
+ Updating offline URI for OAuth2 and explicity specifying approval_prompt as a kw arg. (Issue 6296072)
+
+1156 f7593ae5d035 2012-06-14 15:35 -0700 dhermes
+ Added individual get for ManagedAccounts, functionality for paging and changed to correct endpoint. (issue 6304076)
+
+1155 723e577ada7b 2012-06-14 13:53 -0700 dhermes
+ Adding support for Local Products feed in Content API. (Issue 6305091)
+
+1154 75ee2830ca74 2012-06-13 12:48 -0700 dhermes
+ Adding support for wrong open search version hack on other ContentAPI Feed classes. (Issue 6296071)
+
+1153 f783c64b953f 2012-06-13 10:07 -0700 dhermes
+ Adding support for Data Quality Feed of Content API for Shopping. (Issue 6295074)
+
+1152 4cc916619658 2012-06-13 09:07 -0700 dhermes
+ Adding back accidentally removed code from commit c92bc870e3a4363bed2732d50d782189407af7ac.
+
+1151 c92bc870e3a4 2012-06-13 09:01 -0700 dhermes
+ Adding support for Content API Users Feed. (Issue 6295071)
+
+1150 0dcb1f3aff81 2012-06-12 17:25 -0700 dhermes
+ Adding custom id parser for Content API errors. (issue 6306073)
+
+1149 8f11de681f03 2012-06-12 17:21 -0700 dhermes
+ Adding support for product status elements in app:control for content for shopping. (Fixes 6299076)
+
+=== 2.0.17 ===
+1143 3a0447b78b27 2012-04-20 13:25 -0400 jeffy
+ The gdata.youtube.service class now explicitly sets the GData-Version: 1 header, and is updated to use the correct ClientLogin URL.
+
+1142 1e302ccfd1db 2012-04-19 14:09 -0700 dhermes
+ Adding support for OAuth2 revoke endpoint.
+
+1141 7dbf78073e2c 2012-04-18 09:51 -0700 alainv
+ Make Resource and ResourceFeed "Batch" compatible.
+
+1140 cde9a812ff75 2012-04-02 22:25 -0700 dhermes
+ Forgot to add camelcase alias for batch in issue 5970062.
+
+1139 f3db7c388325 2012-04-02 20:37 -0700 dhermes
+ Adding support for performance data in Content API for Shopping (fixes Issue 5976061).
+
+1138 f5d8bd1a5d58 2012-04-02 20:30 -0700 dhermes
+ Added support for custom attributes in Content API for Shopping (fixes Issue 5970070).
+
+1137 df2263245009 2012-04-02 08:18 -0700 dhermes
+ Changed dest attrs in Content API to iterable, added validate_dest and fixed qname on app:control (fixes Issue 5976046).
+
+1136 6fa84c09df8e 2012-04-02 07:46 -0700 dhermes
+ Added camel case names to content API client public methods (fixes Issue 5970062).
+
+1135 f5d03167e6de 2012-04-02 07:38 -0700 dhermes
+ Added support for Content for API errors on single and batch requests (fixes Issue 5971061).
+
+1134 906bb1d9c899 2012-04-02 07:31 -0700 dhermes
+ Added support for start-token in Content API for Shopping (closes Issue 5980044).
+
+1133 f98fff494fb8 2012-03-30 11:36 -0700 alainv
+ Change gdata.docs.client.DocsClient.DeleteResource to use the entry instead of the link.
+
+1132 e3594e4ea683 2012-03-30 10:56 -0700 alainv
+ Allow for random kwargs in atom.client.AtomClient.request method.
+
+1131 57db9d630ee7 2012-03-29 15:44 -0700 dhermes
+ Changing Shipping to list element in Content API for Shopping.
+
+1130 ab61823f2562 2012-03-29 15:34 -0700 dhermes
+ Fixing behavior in atom.http_core.Uri._get_query_string for query parameters with no parameter value (closes Issue 5938047).
+
+1129 583a2f25c123 2012-03-27 15:21 -0700 dhermes
+ Fixed batch function issues in content api for shopping client.
+
+1128 900e9a0c3b3a 2012-03-03 18:08 -0800 ccherubino
+ Updated GetFeed methods in the Email Settings API to return typed feeds
+
+1127 c21438385488 2012-02-29 09:18 -0800 dhermes
+ Namespace for channel element (in contentforshopping) was promoted from scp to sc.
+
+1126 5e7914da3fc5 2012-02-13 10:29 -0500 afshar
+ Fixed release date year.
+
+1125 78f1044f8338 2012-02-09 16:48 -0800 ccherubino
+ Fixing bug in recent change to the Email Settings API client library (rev. 194d0fd21fdd) + some typos
+
+1123 194d0fd21fdd 2012-02-09 11:29 -0800 ccherubino
+ Updating the Email Settings API to return instances of the correct classes when retrieving settings
+
+1122:1120 5d90af058646 2012-02-09 17:14 +0530 shraddhag
+ Added a sample to create a group and update its settings using the Groups Provisioning and Groups Settings APIs.
+
+1121 632df99f18bb 2012-02-09 14:30 -0500 afshar
+ Added docs:description element to docs resources.
+
+1120 b916755be737 2012-02-02 09:49 -0500 afshar
+ Fixed error in docs sample.
+
+1119 19b1a2901d7e 2012-02-01 12:20 +0530 gunjansharma
+ Added scopes for all Admin APIs in apps tag
+
+1118 0e47dfadd4f6 2012-02-01 12:18 +0530 gunjansharma
+ Added a sample for Email Audit API demonstrating CRUD operations on email monitors
+
+1117 ce66eae4ca6f 2012-01-31 17:02 -0800 dhermes
+ Fixed small doc errors, made tax a list element
+
+1116 9676d3b1059b 2012-01-30 08:57 -0800 alainv
+ Fix issues 590/591: Contact's gender XML element was wrong.
+
+1115 32d0f6e650f5 2012-01-30 15:54 +0530 gunjansharma
+ Added a sample marketplace application
+
+1114 3a91fa3c66d1 2012-01-30 14:50 +0530 shraddhag
+ Sample to delete obsolete suspended users
+
+1113 1b7323bc42e7 2012-01-30 14:49 +0530 shraddhag
+ Sample to retrieve user's profile and contacts using 2LO
+
+1112 3265462309de 2012-01-25 22:42 -0500 vicfryzel
+ Fixing issue 587. Wrong URL used for batch ACL changes.
+
+1111 15e17565f0ed 2012-01-24 12:04 +0530 shraddhag
+ Added a sample to list all the members of a group
+
+1108:1106 d762873e72e8 2012-01-06 14:35 -0800 alainv
+ Adding access_type=offline to OAuth 2.0 authorize URL.
+
+1107 9941fe8ba765 2012-01-20 19:30 +0000 afshar
+ Check document list entries have a content before trying to download them.
+
+1106 090c7ee66c93 2012-01-05 20:43 +0000 afshar
+ Added tag 2.0.16 for changeset c67f3c6398ba
+
+1105[2.0.16] c67f3c6398ba 2012-01-05 20:39 +0000 afshar
+ Updated hgignore
+
+1104 e3c66713a107 2012-01-05 20:34 +0000 afshar
+ Updated MANIFEST.in
+
+1103 20c9ab58878a 2012-01-05 20:24 +0000 afshar
+ Use a generated MANIFEST from MANIFEST.in
+
+1102 b395b9e31ee9 2012-01-05 20:15 +0000 afshar
+ Updated release notes.
+
+1101 012305c4dac1 2012-01-05 19:43 +0000 afshar
+ Fixed recording test, sometimes outside the US, google.com tries to redirect.
+
+1100 e93eb1a3fe7c 2012-01-05 19:08 +0000 afshar
+ Updated pydocs
+
+1099 85cc6c57a719 2012-01-05 19:08 +0000 afshar
+ Bumped version string
+
+1098 afd40075d6bd 2012-01-05 18:42 +0000 afshar
+ Fixed doc generation script for my environment.
+
+1096 c6b6a36a98be 2012-01-16 22:21 +0530 shraddhag
+ Added a sample to search users with a given pattern and and move them to an organization
+
+=== 2.0.16 ===
+5 Jan 2012
+
+- Add sample for Docs List API to delete ACL.
+- Added support for label deletion in the Email Settings API client library
+- Added a sample for Email Settings create label and filters with exponential
+ back-off
+- Added sample for enabling pop settings using Email Settings API
+- Fixed typo in analytics sample.
+- Fixed ACL batching URI in Docs.
+- Updated RetrieveAllUsers and RetrieveAllAliases to return all pages instead
+ of one.
+- Removing force=True from some ACL requests in DocsClient
+- Added RetrieveGroups method and updated RetrieveAllGroups and
+ RetrieveAllMembers method
+- Added a quick start sample for user provisioning
+- Added a client for organization unit provisioning
+- Added client architecture for group provisioning
+- Added a new sample for multidonain provisioning. Demonstrates all the
+ functions available.
+- Added test for RetrieveAllUserAliases and changed OAuth scopes for Apps
+- Added client architecture for provisioning api and tests for client
+- Added support for batch requests to update spreadsheet cells.
+- Added GetAcl alias for get_acl in DocsClient
+- Added new ACL and get by ID methods to DocsClient.
+- Added some conditional imports for tlslite.
+- Updates to category handling for Documents list API
+- Added a function to retrieve all the aliases for a given user email.
+- Fixed #553
+
+
+=== 2.0.15 ===
+18 Oct 2011
+
+- New Documents List API client
+- Added support for MDM Provisioning API
+- Added Batch support for Documents List API ACL changes
+- Added category handling for Documents List API client
+- Added commenter role to Documents List API client
+- Added support for gContact:status
+- Added subdomain support for Email Settings API
+- Added support for Apparel attributes in Content API for Shopping client
+- Added Documents List sample
+- Added Sample for Provisioning API with OAuth2
+- Added Sample for Email Settings API with OAuth2
+- Added Sample for Provisioning API with Sites and Profiles API
+- Fixed Youtube client to use SSL
+- Fixed Sites API sample to use SSL
+- Removed Google Base Data API support
+- Issues closed:
+ #190, #206, #215, #230, #268, #270, #279, #281, #288, #296, #303, #312,
+ #346, #363, #399, #424, #435, #483, #492, #494, #498, #508, #512, #516,
+ #526, #532, #533, #534, #541, #547
+
+=== 2.0.14 ===
+7 Mar 2011
+
+ - Bug Fixes:
+ * 491. 302 redirect on some gsessionids
+ * 501. Remove support for deprecated Maps Data API.
+ * 462. Bug in samples/analytics/data_feed_demo.py (using segments)
+ * 482. String exception in service.py
+ * 414. http proxy url containing properly formatted user-name and password not accepted
+ - Turn on SSL for Codesearch, Photos, Project Hosting, Analytics,
+ Contacts, Marketplace Licensing, and Docs.
+ - Add batch default URL to the Contacts API and clean the sample code. (issue4000058)
+ - Added support for Content API for Shopping
+ - Added Calendar V2 API support
+ - Add Google Marketplace Licensing API to the Gdata Python Client
+ - Added patch from Alexandre Vivien that fixes calendar resource email support that somehow went missing in a previous release.
+
+
+=== 2.0.13 ===
+16 Nov 2010 (revision 902:73f3fbb5ea88)
+
+ - Bug Fixes:
+ * Issue 315: Correctly constructs queries based on categories for Blogger APIs.
+ * Issue 323: YouTubeUserQuery constructor passes incorrect overridden parameter to base class.
+ - Accept proxy username and password in http(s)_proxy environment variables.
+ - Adding support for specifying URI to v3 docs client.
+ - Adding tests for revisions for arbitrary file types in Documents List API.
+ - Google Base, added bucket node to attributes.
+ - Adding ContainsSampledData XML Element to Analytics Data Feed and updating samples
+
+
+=== 2.0.12 ===
+17 Sep 2010 (revision 892:e949a7cf9a31)
+
+ - Bug Fixes:
+ * Issue 437: PATCH request generates incorrect Content-Type
+ * Issue 428: get_blog_name() does not correctly handle blog URLs containing hyphens
+ * Issue 443: Packages should contain gdata.apps.audit in setup.py
+ * Issue 430: Lots of memory usage when uploading big video files
+ * Issue 423: gdata.contacts.client.ContactsClient.get_profiles_feed() broken
+ - Turn on SSL be default for the spreadsheet API
+ - Added support for new Analytics feeds
+ - All V3 code and development has been out of this project and into http://code.google.com/p/google-api-python-client/
+ - Added partial support for the YouTube API in v2
+
+
+=== 2.0.11 ===
+Jul 29, 2010 (revision fa49231cc8)
+
+ - Added the following new APIs:
+ * Apps Audit APIs from Jay Lee
+ * Apps Organization from Alexandre Vivien
+ * Added Email Settings API client library v2.0 from Claudio Cherubino
+ - Fixes to file permissions for samples.
+ - Fixing a broken calendar resource client from r983, removing a superfluous call to MakeResourceFeedUri(), adding regression tests for edit links.
+ - Abstracting out AppsProperty so that it's usable by other libs. Thanks to Claudio Cherubino <ccherubino@google.com> for this change.
+ - Added optional change_password parameter to AppsService.CreateUser
+ - Fixing minor bugs in analytics samples
+ - http://codereview.appspot.com/1677050 Switch default connection type back to non-SSL connections.
+ - Switch the repository from subversion to mercurial
+ - Added OAuth test cases thanks Samuel Cyprian
+ - Many APIs now use SSL, and some require it, so the following APIs now default to using HTTPS:
+ * Spreadsheets
+ * Sites
+ * Calendar Resource
+
+=== 2.0.10 ===
+May 12, 2010 (revision 980)
+
+ - Add check for liveness of proxy in live tests. Also add in upload-diffs.py to make using codereview.appspot.com easier.
+ - Patch from Alexandre Vivien adds the ResourceEmail attribute to CalendarResourceEntry
+ - Adding new single page methods to apps.groups.service. Thanks Jeremy Selier!
+ - Cleanup in service GetWithRetries. Thanks Will Charles!
+ - Adding much more test coverage for calendar_resource.client.
+ - Fixing Calendar Resource get_resource to use correct feed URI generator. Thanks to Alexandre Vivien for reporting.
+ - Adds support for Blogger Pages. Thanks Wiktor Gworek!
+
+=== 2.0.9 ===
+March 5, 2010 (revision 964)
+
+- Fixed URL related bug in gdata.calendar.service. You can now edit and delete
+ against https URLs.
+- Removed hard coded Python version from gdata.contacts. Resolves issue 347.
+
+=== 2.0.8 ===
+February 26, 2010 (revision 960)
+
+- Added support for resumable uploads with a sample that shows it's use
+ with Google Docs. Thanks Eric!
+- Added the publish element and copy() method to the DocsClient. Thanks Eric!
+- Added support for the JSON-C data format recently released for the YouTube
+ API.
+- Fixed import bug when using cryptomath with Python2.4 and lower.
+- Modified gdata.gauth to be usable under Python2.3.
+- Fixed errors which affect RetrieveAllEmailLists RetrieveEmailLists
+ RetrieveAllRecipients RetrieveAllNicknames RetrieveNicknames
+ RetrieveAllUsers in gdata.apps.service. Resolves issue 340 . Thanks
+ Aprotim!
+- Fixed issues with contacts client returning a raw get and not a ContactEntry
+ and a few auth_tokens are not being passed into the HTTP request. Resolves
+ issue 332 . Thanks vinces!
+- Fixed issue parsing worksheet feed, entry was the wrong type, corrected to
+ WorksheetEntry. Resolves issue 343. Thanks Igor!
+- Fixed typo in gdata.spreadsheets.client (auth_service). Resolves issue 342.
+ Thanks to Igor once again!
+- Fixed bug in Google Apps APIs UpdateSSOSettings.
+- The gdata.data.LinkFinder now looks in both the link and feed_link members
+ for an ACL link. Resolves issue 339.
+- Removed client side check on video type in YouTube service. Rely on the
+ server to provide an error if the format is not supported. Resolves
+ issue 338.
+- Improved documentation for SpreadsheetsService's UpdateRow method to explain
+ the use case it addresses and recomment alternatives.
+- Changed projecthosting to use the host member with relative URLs.
+- Added a get_headers function to be used in Python2.2 and 2.3 since
+ httplib.HTTPResponse does not have getheaders in those versions of Python.
+ Resolves issue 335.
+- Added a client smoke test to check version and auth related class members
+ which all gdata.x.client's should have.
+- Updated the docs service_test.py to run as part of run_all_tests.py.
+
+=== 2.0.7 ===
+January 26, 2010 (revision 937)
+
+- Added gdata.calendar_resource.client to support the management of calendar
+ resources (like conference rooms) for Google Apps domains. Thanks Vic!
+- Updated the sites API client to use version 1.1 of the sites API.
+- Added support for 2 Legged OAuth to the GDClient and included a sample
+ app. Thanks Eric!
+- Added a revoke_token method to GDClient to invalidate AuthSub or OAuth
+ tokens.
+- Added a get_record method to the Spreadsheets client to fetch a single
+ record entry.
+- Added includeSuspendedUsers parameter to the apps groups API. Thanks Will
+ Charles!
+- Fixed a client login bug present in the Maps API client. Thanks Roman!
+- The client_id property in the YouTube service object is now optional.
+- Added optional 'feed' parameter to YouTube service's Query classes.
+ Resolves issue 323.
+- Updated tlslite's use of sha1 to use hashlib if using python2.5 or higher.
+ Resolves issue 290 . Thanks Jay Lee!
+- Added a deadline parameter to gdata.alt.appengine to allow the urlfetch
+ timeout to be modified to as high as 10 seconds.
+- Added GetGeneratorFromLinkFinder to GDataService which simplifies pagination
+ across the entries in a feed. Resolves issue 325 . Thanks Aprotim!
+- Removed the default value for the test domain option.
+- Moved auth scopes to gdata.gauth from gdata.service.
+
+=== 2.0.6 ===
+December 17, 2009 (revision 914)
+
+- updated the Google Analytics Data Export API to v2. Thanks Nick!
+- added support for batch operations on contacts and profiles. Thanks Julian!
+- added a DocsQuery class for the Documents List v3 API.
+- removed now obsolete ACL classes from gdata.docs.data in favor of using
+ classes in gdata.acl.data. Thanks Eric!
+- fixed bug in querying group membership by email. Thanks Will Charles!
+- removed import which are not present in Python2.2 from gdata.service to
+ maintain support for Python2.2.
+- added additional debug information to MockHttpClient.
+
+=== 2.0.5 ===
+November 24, 2009 (revision 900)
+
+- added new gdata.contacts.client (and data) which uses version 3.0 of the
+ contacts API. Thanks Vince!
+- added new gdata.docs.client which uses version 3.0 of the Documents List
+ API. Thanks Eric!
+- added new v2 modules for the Analytics API (gdata.analytics.client).
+ Thanks Nick!
+- added conditional get using etags on get_entry. Thanks Eric!
+- fixed bug in how Calendar redirect headers are handled when using this
+ library in an App Engine app.
+- added new Calendar XML elements to the gdata.calendar module. Thanks
+ Michael Ballbach!
+- added v2 data model classes for finance, notebook, webmastertools, ACLs,
+ opensearch and youtube.
+- fixed issues with contacts.service when editing profiles. Thanks Julian!
+- fixed bug in GDClient's get_next method.
+- improved usability in Python2.3, though tests do not run the src modules
+ should be Python2.3 compatible.
+
+=== 2.0.4 ===
+October 15, 2009 (revision 864)
+
+- Added support for the project hosting issue tracker API. Thanks Joe LaPenna!
+- Added a get-with-retries method to the v1 service for use with the Google Apps
+ API to automatically retry. Thanks Takashi Matsuo!
+- Revised Google Sites client to use text input when creating a page. Thanks Eric!
+- Changed demo calendar in the Google Calendar API example. Thanks Trevor!
+
+=== 2.0.3 ===
+October 9, 2009 (revision 856)
+
+- Added support for Google Sites Data API. Thanks Eric!
+- Added support for Google Contacts profiles. Thanks Julian Toledo and Pedro
+ Morais!
+- Added support for the Spreadsheets v3 API Tables feed and Records feed.
+- Added support for the Google Apps Admin Settings API. Thanks Jay Lee!
+- New sample which illustrates use of the Blogger v1 API on App Engine using
+ OAuth. Thanks Wiktor Gworek!
+- Added a new MediaSource for use with v2 data model classes. Thanks Eric!
+- The v2 client classes can now force all requests to be made over SSL.
+ Thanks Eric!
+- Revised the test config system to allow test settings to be specified as
+ command line arguments or prompt the user to enter them interactively.
+- Fixed UTF encoding issue in unittest on big endian architectures.
+- Fixed XML parsing bug in Spreadsheets data class. Thanks ppr.vitaly!
+- Fixed bug in webmaster tools service verification method arguments. Thanks
+ eyepulp!
+- Fixed download URL recognition in Document List Data API.
+- Some progress made in re-adding support for Python2.3, not sure yet if
+ full Python2.3 support is completely feasible. Python 2.4-2.6 should work.
+
+=== 2.0.2 ===
+August 20, 2009 (revision 823)
+
+- Added support for the Google Maps Data API. Thanks Roman!
+- Added data model classes for the v3 Spreadsheets API. This API is not
+ yet fully supported by the library and the gdata.spreadsheets package
+ should be considered experimental until the next release. The v1
+ gdata.spreadsheet package is unchanged and should still work.
+- Auth token lookups when running in App Engine are now memcached which
+ should improve efficiency. Thanks Marc!
+- Fixed a bug with the v2 HTTP proxy client. If behind a proxy, the full
+ URL is now sent as the request selector. Thanks Dody!
+- Removed the gdata.client.GDataClient class which had been deprecated.
+
+=== 2.0.1 ===
+July 23, 2009 (revision 805)
+
+- Added support for Secure AuthSub, OAuth with HMAC and with RSA to the
+ v2 auth code.
+- Added v2 data model classes for all XML elements in the gd namespace.
+- Usability improvements in the gdata.docs.service module, thanks Eric!
+- Made the dependency on elementtree only required if you are using
+ Python 2.4 and lower. Thanks brosner!
+- Setting the ssl member in atom.service.AtomService will now override a URL
+ which starts with http:. Many thanks to Michael Ballbach for the patch.
+- Added a proxy HTTP client which will use proxy environment variables to
+ send all requests through the desired proxy server if present.
+- Added user agent string indicating that this is from the gdata python v2
+ library.
+- Removed unneeded title parameter from the Blogger client's add_comment
+ method.
+- Added an all_tests_local script which runs all tests except those which
+ would make HTTP requests to remote servers.
+- Added the birthday element to contacts entry, the reminder element to
+ calendar events, and the method attribute to calendar's reminder class.
+ All with great thanks to Marc!
+- The analytics GetData method no longer requires the dimensions argument.
+ Thanks Jim!
+
+=== 2.0.0 ===
+June 29, 2009 (revision 777)
+
+- Released support for version 2 of the Google Data APIs protocol. To use the
+ new version-aware code, use the gdata.client, atom.data, gdata.data
+ modules and classes that derive from them. For example, use
+ gdata.blogger.client.BloggerClient instead of
+ gdata.blogger.service.BloggerService. High level, service specific classes
+ are not available yet for other services, so feel free to migrate as they
+ become available. The v1 service classes are still included so your
+ existing code should be unaffected.
+- Included new Blogger samples to illustrate v2 support, a command line demo
+ and an app for App Engine.
+- Added OAuth sample app which uses App Engine.
+- Added the gCal:sequence element to CalendarEventEntry (thanks Anton).
+- Added two decorators to diaply warnings when deprecated methods are used.
+- Added a login utility for command line samples to share to standardize the
+ auth process on in a sample program.
+- Fixed a bug in v2 XML parsing which prevented multiversion XML classes from
+ correctly parsing and generating v2 code.
+- Fixed v1 HTTP Host header settings, not default ports should now be
+ included in the Host header.
+- Fixed pickle error when an OAuth-RSA token is saved to the App Engine
+ datastore.
+- Fixed missing data in the Document List API unit tests.
+- Improved backwards compatibility of v2 data model classes be adding aliases
+ to v1 functions.
+
+=== 1.3.3 ===
+June 5, 2009 (revision 724)
+
+- Added support for the Google Finance API. Thanks Swee Heng!
+- The Google Data Service classes now support version 1.0a of the OAuth
+ protocol (Thanks Eric!).
+- Fixed a naming bug in unit tests for atom.service which appeared when using
+ Python 2.6.x
+- Fixed URL parameter propogation when calling GDataService.Delete. The URL
+ parameters are now preserved.
+- Fixed incorrect return type for gdata.FeedLinkFromString.
+- Added data model classes for the Atom and AtomPub XML elements which support
+ version 2 of the Google Data APIs (by means of dynamic AtomPub namespace
+ switching). The version 2 XML classes are much more backwards compatible
+ with v1 classes than in previous releases.
+
+=== 1.3.2 ===
+May 22, 2009 (revision 711)
+
+- Added support for the Google Analytics API. Thanks Sal Uryasev!
+- Added support for the Google Book Search API. Thanks James Sams!
+- Improved support for 2 legged OAuth and added a sample app. Thanks Eric
+ Bidelman!
+- Simplified the way an XML response from the server is parsed into the
+ desired class for the version 2.0 API client (gdata.client.GDClient).
+
+=== 1.3.1 ===
+April 23, 2009 (revision 695)
+
+- Fixed issues with setting the developer key in the YouTubeService
+ constructor.
+- For the Document List API (thanks Eric!):
+ - Added writersCanInvite element
+ - Fixed a small errors in Document Entry
+ - Added category label when creating different types of docs
+ - Fixed DownLoad helpers which shouldn't write a file if server returns
+ error. Fixes issue 240.
+ - Added DocumentListEntryFromString converter and using DocumentListEntry
+ class instead of GDataEntry class to create entries.
+- URLs in HTTP requests can now be unicode strings. Resolves issue 233.
+- Improvements for the upcoming version 2.0.0 release:
+ - The v2 auth code now support AuthSub and has been tested on App Engine.
+ - Unit tests for the v2 client code will default to not use the local file
+ cache but will make live requests unless cached responses is set to
+ True in the test configuration module.
+ - Older v1 unit tests can now use the v2 testing framework, migrated
+ contacts API tests as a proof of concept. This will come in handy when
+ testing backwards compatibility for the 2.0 release.
+ - Improved support for unicode and other character encodings in the v2 XML
+ core module.
+
+=== 1.3.0 ===
+Mar 20, 2009 (revision 665)
+
+- Added support for the Google Health API. (Thanks Eric Bidelman!)
+- Added support for the groups management in the Google Apps Provisioning
+ API. (Thanks to Tony Chen and Oskar Casquero!)
+- Added the following new features for the Google Documents List API:
+ (Thanks again to Eric Bidelman for adding all of these!)
+ - Folder create, move docs/folders in and out of other folders. (Thanks
+ Nizam Sayeed!)
+ - Suppport for modifications to Access Control Lists for documents.
+ - Export functionality for documents, spreadsheets, and presentations.
+ - Updated the docs_example.py sample app.
+ - New new XML elements: resourceID, lastViewed, and lastModifiedBy.
+- Added ability to update web clip settings in the Google Apps email settigns
+ API. (Thanks Takashi Matsuo.)
+- Fixed a bug in calendarExample that would cause execution to fail when an
+ event attendee does not have any attendeeStatus data. (Thanks Trevor
+ Johns!)
+- Fixed AuthSub request URLs which should be https. (Yay Eric!)
+- Fixed logic when changing email settings when using the Google Apps API to
+ only send properties which have been specified. (Thanks Jay Lee!)
+- Includes a new and experimental client class (gdata.client.GDClient) which
+ can be used with version two of the Google Data API protocol. This class
+ may change in backwards incompatible ways before the 2.0.0 release, so
+ use at your own risk.
+
+=== 1.2.4 ===
+Jan 22, 2009 (revision 603)
+
+- Added a new AtomPubClient class (and supporting classes) which begins a
+ foundation on which support for version two of the Google Data protocol
+ will be built.
+- OAuth methods can now specify the desired OAuth server with the default
+ being the Google Accounts end point (thanks Dag Brattli!).
+- Improved support for unicode strings in XML element class attributes and
+ text nodes (thanks again to Dag).
+- Fixed constructors for Service classes which inherit from GDataService
+ to ensure that all parameters are passed up to the superclass
+ constructor (thanks Guillaume Ryder!).
+- Added a 'contact_list' property to ContactsService to simplify API usage
+ for shared contacts (thanks Guillaume once again).
+- For Google Contacts, added a GetFeedUri method to help users generating
+ feed URIs (Guillaume for a hat-trick).
+- New unit tests to ensure that the ordering of entry objects within a feed
+ is preserved when converting to and from XML.
+
+
+=== 1.2.3 ===
+Dec 3, 2008 (revision 585)
+
+- Added support for OAuth (thanks to Kunal Shah!). Your client can now obtain
+ an authorization token using the OAuth protocol.
+- Added support for Secure AuthSub (thanks Eric Bidelman!). Your client can
+ digitally sign requests using RSA allowing Google service to verify that
+ the request came from your application.
+- Added a new module for parsing XML which will be used in future versions to
+ support version of the Google Data APIs protocol. This new library handles
+ versioning of XML schemas.
+- The Google Contacts API sample now pages through results.
+- Added phone number rel types using in the Google Contacts API.
+- The YouTube service module will use cElementTree if it is available.
+ Improves XML parsing speed.
+- Fixed typo in gdata.geo, changed longtitude to longitude but kept an alias
+ for backwards compatibility.
+- Fixed Blogger's GetBlogId regular expressions to extract the ID from
+ multiple kinds of entries.
+- Fixed type check in atom.http to allow unicode URL strings.
+- Added webmastertools test to the packaged download which fixed failures
+ when running all data tests.
+- Improved compatibility of unit tests with Python2.3.
+- Added copies of tlslite and dependencies to support secure AuthSub and
+ OAuth.
+- Changed the default host for Google Apps API requests to
+ apps-apis.google.com.
+
+
+=== 1.2.2 ===
+Oct 15, 2008 (revision 556)
+
+- Added support for the following APIs:
+ Google Apps Email Migration API
+ Google Apps Email Settings API
+ Google Webmaster Tools Data API
+ Some modules for the above are not yet fully tested, so please file an
+ issue if you notice something is not working as expected.
+- Restored support for gdata.http_request_handler when using App Engine to
+ preserve backwards compatibility.
+- Simplified auth token management by adding a current_token member to
+ service classes. Also added settings to control when the token_store
+ is updated when using SetXToken() methods. The token_store will only be
+ queried if there is no current_token.
+- Fixed issue with requests to HTTPS URLs in which an AuthSub token was seen
+ as invalid because the request contained the default port number (443).
+ The library no longer includes the port in the Host header if it is using
+ the default.
+- Resolved issues with YouTube token scopes.
+- Fixed issue which appeared when the Calendar API issues a redirect to a
+ PUT request. The library now correctly retries with a PUT (instead of
+ a POST).
+- Added workaround for differences in how the App Engine SDK handles
+ redirects.
+- Fixed typo in gdata.EntryLink declaration.
+- Fixed invalid host errors seen when using some HTTP proxies.
+
+
+=== 1.2.1 ===
+Sep 15, 2008 (revision 529)
+
+- The gdata.alt.appengine module now replaces a Service object's token_store
+ with an AppEngineTokenStore which automatically associates auth tokens
+ with the current user and stores the auth tokens in the datastore.
+- Streamlined the gdata.auth module. There are now six recommended functions
+ for using Google auth mechanisms. GDataService now uses these six
+ functions.
+- Added an override_token in Service objects (AtomService, GDataService)
+ which bypasses the token_store. This member is helpful when using a
+ single use AuthSub token which is only valid for one request and so
+ would not be reused.
+- gdata.alt.appengin.run_on_appengine will now return the modified Service
+ object. This allows statements like:
+ client = gdata.alt.appengin.run_on_appengine(
+ gdata.blogger.service.BloggerService())
+- Fixed content length header issue in gdata.alt.appengine which caused
+ errors when running on App Engine when HTTP headers are set to
+ non-string values.
+- Fixed function naming issue in gdata.alt.appengine, a "private" function
+ was not accessible in some import styles.
+- Fixed issue in atom.http which surfaces when passing in a string for the
+ port number. Ports are now cast to ints.
+- Updated pydocs.
+
+
+=== 1.2.0 ===
+Sep 9, 2008 (revision 522)
+
+- Refactored HTTP request mechanisms and the way that Authorization headers
+ are created and applied to requests. These changes make it easier to
+ swap out the HTTP layer to allow the library to be used in different
+ environments (like Google App Engine). The changes in Auth token logic
+ should make it much easier to add support for secure AuthSub and OAuth.
+ For more details on this change, see the following wiki page:
+ http://code.google.com/p/gdata-python-client/wiki/HTTPRequestRefactoring
+- Fixed issues with token string modification which caused certain AuthSub
+ token values to become invalid.
+- Created a new module for parsing and constructing URLs (atom.url).
+- Created a module for token storage which will lookup the correct auth token
+ to be used for a particular URL.
+- Auth tokens are now represented as objects and contain information about the
+ scopes (URLs) for which they can be used. The token object is responsible
+ for adding the Authorization header to the request.
+- Added new functions to gdata.auth for extracting the raw token string from
+ a response to an AuthSub token upgrade request.
+- Added support for the location query parameter in YouTube queries.
+- Added groups functionality to the Contacts API library.
+- Batch request support added for Contacts API operations.
+- Added default behavior to text_db GetTables: when no worksheet name or ID
+ is specified, all tables are retrieved.
+- Fixed client login for YouTube.
+- Fixed issue in YouTube service when setting the developer key.
+- Fixed bug in YouTube service which raised an exception when inserting a
+ video using a file-like object.
+- Added a method to Feed and Entry classes to find the "previous" link.
+- A failure when attempting to upgrade a single use AuthSub token to a session
+ token will now raise an exception.
+- AppsForYourDomainException now uses Python2.5 style exception construction.
+- Moved the logic for using this library on Google App Engine into a new
+ module: gdata.alt.appengine.
+
+
+=== 1.1.1 ===
+June 13, 2008 (revision 421)
+
+- Added support for new feeds available in the Google Contacts API. Adding
+ contact groups, querying for contacts in a group, specifying extended
+ properties, and setting the contact's photo are now supported.
+- The ExtendedProperty class can now contain a blob of XML instead of just
+ an attribute value. This is used in the Google Contacts Data API.
+- The YouTube service now has methods for updating playlists and removing a
+ video from a playlist.
+- Added geo-location to the YouTube service class.
+- When using ClientLogin with Blogger, the default account type is now set
+ to 'GOOGLE'. This prevents the rare problem of a user having a Google
+ Apps account which conflicts with his or her Google Account used for
+ Blogger.
+- Added support for the in-reply-to element which appears in Blogger
+ comments.
+
+
+=== 1.1.0 ===
+June 6, 2008 (revision 403)
+
+- Added modules for YouTube.
+- Added modules for Blogger to simplify using the Blogger API.
+- Updated pydocs for all modules.
+- New member in service object to allow the ClientLogin server to be changed.
+ Required to be able to use ClientLogin with YouTube.
+- Iterating over Google Apps Feeds can now be accomplished using a generator.
+- New unit tests for the Google Apps Provisioning API.
+- Bug fixes to the mock_service module used in unit tests.
+- Fixed a bug in Query string generation when using category queries.
+- Improved ease of use for Calendar query construction, URL components are
+ now escaped automatically by default.
+- Bug fix, added timezone element to CalendarEventFeed.
+- Improved docstrings to describe token access methods (specifically
+ GetAuthSubToken).
+- Moved ExtendedProperty class into gdata module from gdata.calendar since
+ it is now also used in the Google Contacts Data API.
+
+
+=== 1.0.13 ===
+May 8, 2008 (revision 357)
+
+- Added sample code illustrating the use of the Contacts API modules.
+- Added a mock_service module which will allow for faster test execution
+ by simulating a server and replaying recordings instead of making
+ HTTP requests to a remote server.
+- Fixed a but in the gdata.auth module which could cause certain characters
+ at the start of the token to be removed incorrectly.
+- Fixed a bug in the gdata.apps.service module which caused an import to
+ fail when loading ElementTree in some cases.
+- Service unit tests should run correctly when using run_service_tests
+ and run_all_tests now that the subtests have been made into packages.
+
+
+=== 1.0.12.1 ===
+April 10, 2008 (revision 341)
+
+- Added new import statements so that xml.etree.ElementTree can be used.
+ Needed for the library to run on Google App Engine.
+
+
+=== 1.0.12 ===
+April 8, 2008 (revision 334)
+
+- Added support for the Google Contacts API.
+- Added a gdata.urlfetch module which allows this library to be used in
+ Google App Engine. This module uses urlfetch instead of httplib to
+ perform HTTP requests.
+- Refactored atom.service and gdata.service to make it easier to swap out the
+ HTTP communication layer.
+- Fixed a bug in the Push method of gdata.spreadsheet.text_db.
+- Sped up InsertRow method in gdata.spreadsheet.service.
+- Improved XML parsing efficiency in gdata.calendar.service.
+- Added new attribuges for the Google Apps login element.
+- Improved UpdatePhotoBlob in gdata.photo.service.
+- Added pydocs for Google Contacts API and updates in other modules.
+
+=== 1.0.11.1 ===
+March 13, 2008 (revision 314)
+
+- Added text_db module to gdata.spreadsheet which makes using the Spreadsheets
+ API feel more like using a simple database. This module streamlines use
+ of the list feed.
+- Compatibility fixes for geo and photos modules to run on Python 2.2 and 2.3.
+- Added the orderby parameter to gdata.service's Query class.
+- Changed the blogger sample to use orderby=updated so that queries on
+ updated min or max will work.
+- Fix to string encoding in the atom core when converting text members to XML.
+
+
+=== 1.0.11 ===
+February 11, 2008 (revision 290)
+
+- Modified the gdata.service.GDataService to include a handler member to
+ which all HTTP requests are delegated. This will allow the underlying
+ HTTP client to be swapped out and pave the way for use of a mock server
+ in unit tests.
+- Fixed character encoding problems when parsing non ASCII XML.
+- Added pydocs for gdata's geo, exif, and media packages.
+
+
+=== 1.0.10.1 ===
+December 20, 2007 (revision 265)
+
+- Photos packages for working with the Picasa Web Albums Data API.
+- New modules for handling media, geo, and exif XML elements.
+- Packages for the Google Code Seach API.
+- New PyDoc HTML pages generated from the source code.
+- Extracted authentication code into a seperate module which can be used in
+ other applications.
+- The core XML parser should now fully support UTF-8 strings, there are also
+ options to change the default encoding.
+- Bugfixes in Atom service's proxy support when authenticating with the proxy.
+- Spreadsheets UpdateCell can now take integers for the row and column
+ parameters.
+- Added INSTALL.txt to explain the installation process. The content was
+ copied from the getting started article here:
+ http://code.google.com/support/bin/answer.py?answer=75582
+- You can now create update and delete worksheets within a Google
+ Spreadsheet.
+- Added convenience methods to service object to ease the process of
+ iterating through a feed.
+- For Document List queries, added the ability to construct schema-qualified
+ named folder queries.
+
+
+=== 1.0.9 ===
+October 15, 2007 (revision 213)
+
+- Added support for batch requests for the Google Spreadsheets cells feed,
+ Google Calendar's events feed, and Google Base's items feed.
+- Authentication requests can now be sent to a different server by modifying
+ a module variable in gdata.service.
+- Fixed the birthdaySample mashup.
+- User Agent headers now fit the pattern used in other Google data client
+ libraries.
+- Made it easier to access custom elements for Google Base items.
+
+
+=== 1.0.8 ===
+August 31, 2007 (revision 192)
+
+- Major refactoring of the data model classes. Improved XML parsing
+ performance.
+- Created a script to run all of the tests, one to run the data model tests,
+ and one to run all service tests.
+- Changes to MediaSource to handle uploading files on Windows.
+- All of the sample code should now work in Python 2.2 and higher. I removed
+ 2.4 dependancies.
+- Minor change to the Blogger sample; it now uses entry.GetSelfLink().
+- Added fix to prevent socket.sslerror and redirect failures when using a
+ proxy.
+- Google Calendar event entries can now contain a reference to the original
+ event. The original event element is present when describing a recurrance
+ exception.
+- Added timezone parameter to Google Calendar queries. This allows the client
+ to request that event times be expressed in a specific timezone.
+
+
+=== 1.0.7 ===
+August 7, 2007
+
+- Added new test for the Documents List data API's service module.
+- Updated setup.py to include the docs package in the installation.
+
+
+=== 1.0.6 ===
+Aug 2, 2007
+
+- Support for Documents List API added along with sample code.
+
+=== 1.0.5 ===
+July 31, 2007
+
+- XML parsing can now use cElementTree if it is available, this should speed
+ up XML parsing.
+- Redirects now include all params in the original HTTP request.
+- Added support for WebContent and QuickAdd features of Google Calendar data
+ API.
+- Proxy support added.
+- Binary MIME uploads now work for Windows files when performing media uploads.
+- New calendar functionality for add/edit/delete calendar and add/edit/delete
+ subscriptions. Also, added new functionality for Calendar Gadgets.
+
+
+=== 1.0.4 ===
+June 23, 2007
+
+- Added data and service modules for Google Apps.
+- XML parsing can now be configured in gdata module service calls to avoid
+ multiparsing to convert to the desired type.
+- Fixed UTF-8 support in the Atom modules.
+- The spreadsheets example now works with UTF-8 column names.
+- Fixed a type in the Google Base dry-run sample.
+- Calendar's Who element no longer requires a name when converting to XML.
+
+
+=== 1.0.3 ===
+May 30, 2007
+
+- Added a mashup sample using the spreadsheets and calendar services.
+- Reduced the number of unnecessary namespace declarations in the XML produced
+ by objects.
+- Changed type of custom elements in a spreadsheets list entry.
+- Fixed bugs in spreadsheetsExample.py.
+- Spreadsheet entries now inherit from GDataEntry and have gdata specific
+ convenience methods.
+
+
+=== 1.0.2 ===
+May 4, 2007
+
+- Added support for media. Services can now upload images, the tests for this
+ service use the Picasa Web Albums data API.
+- Added example code illustrating Blogger operations.
+- Fixed host name processing for URLs which have -'s in the host name.
+- Added a debug setting for service classes.
+- Added user agent header.
+- Made finding links of a specific type easier when dealing with Atom elements.
+ Atom Entries now have GetXLink methods.
+- Simplified finding license links in Atom Entries.
+
+
+=== 1.0.1 ===
+April 20, 2007
+
+- Rearranged package structure, tests are in their own directory and Google
+ data API extension classes are nested under the gdata package.
+- Simplified accessing extension elements by adding FindExtesions.
+- Provided a setup.py file for distutils based installation.
+- Added support for the app:draft element.
+- Imports ElementTree from XML libraries in Python 2.5
+- Fixed _EntryLinkFromElementTree in the calendar data module.
+- Fixed various _TakeChildFromElementTree methods in calendar data module.
+- Fixed delete and update operations in the spreadsheetExample script.
+- Fixed setting sort order and order by in calendar's service module.
+- Added HTTP BasicAuth for AtomService.
+
+
+=== 1.0 ===
+March 26, 2007
+
+Initial release
diff --git a/pydocs/atom.auth.html b/pydocs/atom.auth.html
new file mode 100644
index 0000000..92efb8e
--- /dev/null
+++ b/pydocs/atom.auth.html
@@ -0,0 +1,106 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.auth</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.auth</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/auth.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/auth.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="base64.html">base64</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.auth.html#BasicAuth">BasicAuth</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.auth.html#NoAuth">NoAuth</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BasicAuth">class <strong>BasicAuth</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Sets the Authorization header as defined in <a href="http://www.rfc-editor.org/rfc/rfc1945.txt">RFC1945</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="BasicAuth-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#BasicAuth-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="BasicAuth-__init__"><strong>__init__</strong></a>(self, user_id, password)</dt></dl>
+
+<dl><dt><a name="BasicAuth-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NoAuth">class <strong>NoAuth</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="NoAuth-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.client.html b/pydocs/atom.client.html
new file mode 100644
index 0000000..d057378
--- /dev/null
+++ b/pydocs/atom.client.html
@@ -0,0 +1,310 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/client.py</a></font></td></tr></table>
+ <p><tt><a href="#AtomPubClient">AtomPubClient</a> provides CRUD ops. in line with the Atom Publishing Protocol.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.client.html#AtomPubClient">AtomPubClient</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.client.html#CustomHeaders">CustomHeaders</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.client.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.client.html#MissingHost">MissingHost</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AtomPubClient">class <strong>AtomPubClient</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="AtomPubClient-Delete"><strong>Delete</strong></a> = <a href="#AtomPubClient-delete">delete</a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AtomPubClient-Get"><strong>Get</strong></a> = <a href="#AtomPubClient-get">get</a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AtomPubClient-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#AtomPubClient-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="AtomPubClient-Post"><strong>Post</strong></a> = <a href="#AtomPubClient-post">post</a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AtomPubClient-Put"><strong>Put</strong></a> = <a href="#AtomPubClient-put">put</a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AtomPubClient-Request"><strong>Request</strong></a> = <a href="#AtomPubClient-request">request</a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AtomPubClient-__init__"><strong>__init__</strong></a>(self, http_client<font color="#909090">=None</font>, host<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, source<font color="#909090">=None</font>, xoauth_requestor_id<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new <a href="#AtomPubClient">AtomPubClient</a> instance.<br>
+ <br>
+Args:<br>
+ source: The name of your application.<br>
+ http_client: An <a href="__builtin__.html#object">object</a> capable of performing HTTP requests through a<br>
+ request method. This <a href="__builtin__.html#object">object</a> is used to perform the request<br>
+ when the <a href="#AtomPubClient">AtomPubClient</a>'s request method is called. Used to<br>
+ allow HTTP requests to be directed to a mock server, or use<br>
+ an alternate library instead of the default of httplib to<br>
+ make HTTP requests.<br>
+ host: str The default host name to use if a host is not specified in the<br>
+ requested URI.<br>
+ auth_token: An <a href="__builtin__.html#object">object</a> which sets the HTTP Authorization header when its<br>
+ modify_request method is called.</tt></dd></dl>
+
+<dl><dt><a name="AtomPubClient-delete"><strong>delete</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the DELETE method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="AtomPubClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="AtomPubClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Changes the HTTP request before sending it to the server.<br>
+ <br>
+Sets the User-Agent HTTP header and fills in the HTTP host portion<br>
+of the URL if one was not included in the request (for this it uses<br>
+the self.<strong>host</strong> member if one is set). This method is called in<br>
+self.<strong>request</strong>.<br>
+ <br>
+Args:<br>
+ http_request: An atom.http_core.HttpRequest() (optional) If one is<br>
+ not provided, a new HttpRequest is instantiated.<br>
+ <br>
+Returns:<br>
+ An atom.http_core.HttpRequest() with the User-Agent header set and<br>
+ if this client has a value in its host member, the host in the request<br>
+ URL is set.</tt></dd></dl>
+
+<dl><dt><a name="AtomPubClient-post"><strong>post</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the POST method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="AtomPubClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="AtomPubClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs an HTTP request to the server indicated.<br>
+ <br>
+Uses the http_client instance to make the request.<br>
+ <br>
+Args:<br>
+ method: The HTTP method as a string, usually one of 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: The URI desired as a string or atom.http_core.Uri.<br>
+ http_request:<br>
+ auth_token: An authorization token <a href="__builtin__.html#object">object</a> whose modify_request method<br>
+ sets the HTTP Authorization header.<br>
+ <br>
+Returns:<br>
+ The results of calling self.<strong>http_client</strong>.request. With the default<br>
+ http_client, this is an HTTP response <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CustomHeaders">class <strong>CustomHeaders</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Add custom headers to an http_request.<br>
+ <br>
+Usage:<br>
+ >>> custom_headers = atom.client.<a href="#CustomHeaders">CustomHeaders</a>(header1='value1',<br>
+ header2='value2')<br>
+ >>> client.get(uri, custom_headers=custom_headers)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="CustomHeaders-__init__"><strong>__init__</strong></a>(self, **kwargs)</dt><dd><tt>Creates a <a href="#CustomHeaders">CustomHeaders</a> instance.<br>
+ <br>
+Initialize the headers dictionary with the arguments list.</tt></dd></dl>
+
+<dl><dt><a name="CustomHeaders-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Changes the HTTP request before sending it to the server.<br>
+ <br>
+Adds the custom headers to the HTTP request.<br>
+ <br>
+Args:<br>
+ http_request: An atom.http_core.HttpRequest().<br>
+ <br>
+Returns:<br>
+ An atom.http_core.HttpRequest() with the added custom headers.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MissingHost">class <strong>MissingHost</strong></a>(<a href="atom.client.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.client.html#MissingHost">MissingHost</a></dd>
+<dd><a href="atom.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="atom.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="MissingHost-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingHost-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#MissingHost-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="MissingHost-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingHost-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="MissingHost-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingHost-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="MissingHost-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingHost-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="MissingHost-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingHost-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="MissingHost-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="MissingHost-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingHost-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="MissingHost-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingHost-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="MissingHost-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="MissingHost-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingHost-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="MissingHost-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.core.html b/pydocs/atom.core.html
new file mode 100644
index 0000000..f8e7f06
--- /dev/null
+++ b/pydocs/atom.core.html
@@ -0,0 +1,216 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.core</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.core</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/core.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/core.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2008 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="xml.etree.cElementTree.html">xml.etree.cElementTree</a><br>
+</td><td width="25%" valign=top><a href="inspect.html">inspect</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlAttribute">XmlAttribute</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">XmlElement</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="XmlAttribute">class <strong>XmlAttribute</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="XmlAttribute-__init__"><strong>__init__</strong></a>(self, qname, value)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="XmlElement">class <strong>XmlElement</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an element node in an XML document.<br>
+ <br>
+The text member is a UTF-8 encoded str or unicode.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="XmlElement-FindChildren"><strong>FindChildren</strong></a> = <a href="#XmlElement-get_elements">get_elements</a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt></dl>
+
+<dl><dt><a name="XmlElement-FindExtensions"><strong>FindExtensions</strong></a> = <a href="#XmlElement-get_elements">get_elements</a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt></dl>
+
+<dl><dt><a name="XmlElement-GetAttributes"><strong>GetAttributes</strong></a> = <a href="#XmlElement-get_attributes">get_attributes</a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt></dl>
+
+<dl><dt><a name="XmlElement-GetElements"><strong>GetElements</strong></a> = <a href="#XmlElement-get_elements">get_elements</a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt></dl>
+
+<dl><dt><a name="XmlElement-ToString"><strong>ToString</strong></a> = <a href="#XmlElement-to_string">to_string</a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="XmlElement-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="XmlElement-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="XmlElement-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of <a href="#XmlAttribute">XmlAttribute</a> objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="XmlElement-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="XmlElement-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-Parse"><strong>Parse</strong></a> = parse(xml_string, target_class<font color="#909090">=None</font>, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>)</dt><dd><tt>Parses the XML string according to the rules for the target_class.<br>
+ <br>
+Args:<br>
+ xml_string: str or unicode<br>
+ target_class: <a href="#XmlElement">XmlElement</a> or a subclass. If None is specified, the<br>
+ <a href="#XmlElement">XmlElement</a> class is used.<br>
+ version: int (optional) The version of the schema which should be used when<br>
+ converting the XML into an <a href="__builtin__.html#object">object</a>. The default is 1.<br>
+ encoding: str (optional) The character encoding of the bytes in the<br>
+ xml_string. Default is 'UTF-8'.</tt></dd></dl>
+ <dl><dt><a name="-XmlElementFromString"><strong>XmlElementFromString</strong></a> = parse(xml_string, target_class<font color="#909090">=None</font>, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>)</dt><dd><tt>Parses the XML string according to the rules for the target_class.<br>
+ <br>
+Args:<br>
+ xml_string: str or unicode<br>
+ target_class: <a href="#XmlElement">XmlElement</a> or a subclass. If None is specified, the<br>
+ <a href="#XmlElement">XmlElement</a> class is used.<br>
+ version: int (optional) The version of the schema which should be used when<br>
+ converting the XML into an <a href="__builtin__.html#object">object</a>. The default is 1.<br>
+ encoding: str (optional) The character encoding of the bytes in the<br>
+ xml_string. Default is 'UTF-8'.</tt></dd></dl>
+ <dl><dt><a name="-parse"><strong>parse</strong></a>(xml_string, target_class<font color="#909090">=None</font>, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>)</dt><dd><tt>Parses the XML string according to the rules for the target_class.<br>
+ <br>
+Args:<br>
+ xml_string: str or unicode<br>
+ target_class: <a href="#XmlElement">XmlElement</a> or a subclass. If None is specified, the<br>
+ <a href="#XmlElement">XmlElement</a> class is used.<br>
+ version: int (optional) The version of the schema which should be used when<br>
+ converting the XML into an <a href="__builtin__.html#object">object</a>. The default is 1.<br>
+ encoding: str (optional) The character encoding of the bytes in the<br>
+ xml_string. Default is 'UTF-8'.</tt></dd></dl>
+ <dl><dt><a name="-xml_element_from_string"><strong>xml_element_from_string</strong></a> = parse(xml_string, target_class<font color="#909090">=None</font>, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>)</dt><dd><tt>Parses the XML string according to the rules for the target_class.<br>
+ <br>
+Args:<br>
+ xml_string: str or unicode<br>
+ target_class: <a href="#XmlElement">XmlElement</a> or a subclass. If None is specified, the<br>
+ <a href="#XmlElement">XmlElement</a> class is used.<br>
+ version: int (optional) The version of the schema which should be used when<br>
+ converting the XML into an <a href="__builtin__.html#object">object</a>. The default is 1.<br>
+ encoding: str (optional) The character encoding of the bytes in the<br>
+ xml_string. Default is 'UTF-8'.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>STRING_ENCODING</strong> = 'utf-8'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.data.html b/pydocs/atom.data.html
new file mode 100644
index 0000000..cbf8340
--- /dev/null
+++ b/pydocs/atom.data.html
@@ -0,0 +1,4832 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/data.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.data.html#LinkFinder">LinkFinder</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.data.html#FeedEntryParent">FeedEntryParent</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>, <a href="atom.data.html#LinkFinder">LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Entry">Entry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Source">Source</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Feed">Feed</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Category">Category</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Control">Control</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Date">Date</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Published">Published</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Updated">Updated</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Draft">Draft</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Email">Email</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#ExtensionElement">ExtensionElement</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#FeedEntryParent">FeedEntryParent</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>, <a href="atom.data.html#LinkFinder">LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Entry">Entry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Source">Source</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Feed">Feed</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Generator">Generator</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Icon">Icon</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Id">Id</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Link">Link</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Logo">Logo</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Name">Name</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Person">Person</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Author">Author</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Contributor">Contributor</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Text">Text</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Content">Content</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Rights">Rights</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Subtitle">Subtitle</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Summary">Summary</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.data.html#Title">Title</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Uri">Uri</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Author">class <strong>Author</strong></a>(<a href="atom.data.html#Person">Person</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:author element.<br>
+ <br>
+An author is a required element in <a href="#Feed">Feed</a> unless each <a href="#Entry">Entry</a> contains an <a href="#Author">Author</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Author">Author</a></dd>
+<dd><a href="atom.data.html#Person">Person</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Person">Person</a>:<br>
+<dl><dt><strong>email</strong> = <class 'atom.data.Email'><dd><tt>The atom:email element.</tt></dl>
+
+<dl><dt><strong>name</strong> = <class 'atom.data.Name'><dd><tt>The atom:name element.</tt></dl>
+
+<dl><dt><strong>uri</strong> = <class 'atom.data.Uri'><dd><tt>The atom:uri element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Author-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Author-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Author-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Author-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Author-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Author-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Author-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Author-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Author-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Author-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Category">class <strong>Category</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:category element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Category">Category</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>scheme</strong> = 'scheme'</dl>
+
+<dl><dt><strong>term</strong> = 'term'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Category-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Category-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Category-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Category-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Category-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Category-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Category-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Category-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Category-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Category-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Content">class <strong>Content</strong></a>(<a href="atom.data.html#Text">Text</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:content element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Content">Content</a></dd>
+<dd><a href="atom.data.html#Text">Text</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>src</strong> = 'src'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Text">Text</a>:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Content-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Content-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Content-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Content-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Content-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Content-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Contributor">class <strong>Contributor</strong></a>(<a href="atom.data.html#Person">Person</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:contributor element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Contributor">Contributor</a></dd>
+<dd><a href="atom.data.html#Person">Person</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Person">Person</a>:<br>
+<dl><dt><strong>email</strong> = <class 'atom.data.Email'><dd><tt>The atom:email element.</tt></dl>
+
+<dl><dt><strong>name</strong> = <class 'atom.data.Name'><dd><tt>The atom:name element.</tt></dl>
+
+<dl><dt><strong>uri</strong> = <class 'atom.data.Uri'><dd><tt>The atom:uri element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Contributor-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Contributor-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Contributor-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Contributor-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Contributor-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Contributor-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Contributor-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Contributor-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Contributor-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Contributor-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Control">class <strong>Control</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Control">Control</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>draft</strong> = <class 'atom.data.Draft'><dd><tt>The app:draft element which indicates if this entry should be public.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Control-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Control-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Control-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Control-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Control-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Control-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Control-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Control-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Control-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Control-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Date">class <strong>Date</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A parent class for atom:updated, published, etc.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Date">Date</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Date-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Date-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Date-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Date-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Date-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Date-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Date-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Date-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Date-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Date-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Draft">class <strong>Draft</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The app:draft element which indicates if this entry should be public.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Draft">Draft</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Draft-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Draft-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Draft-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Draft-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Draft-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Draft-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Draft-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Draft-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Draft-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Draft-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Email">class <strong>Email</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:email element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Email">Email</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Email-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Email-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Email-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Email-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Email-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Email-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Email-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Email-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Email-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Email-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Entry">class <strong>Entry</strong></a>(<a href="atom.data.html#FeedEntryParent">FeedEntryParent</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:entry element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Entry">Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="atom.data.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">FeedEntryParent</a>:<br>
+<dl><dt><a name="Entry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Entry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Entry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Entry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Entry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Entry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Entry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Entry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Entry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="Entry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Entry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Entry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Entry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Entry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Entry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Entry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Entry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Entry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Entry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Entry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Entry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Entry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Entry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Entry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Entry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Entry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Entry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExtensionElement">class <strong>ExtensionElement</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Provided for backwards compatibility to the v1 atom.<a href="#ExtensionElement">ExtensionElement</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#ExtensionElement">ExtensionElement</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ExtensionElement-__init__"><strong>__init__</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, attributes<font color="#909090">=None</font>, children<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ExtensionElement-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExtensionElement-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExtensionElement-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExtensionElement-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExtensionElement-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ExtensionElement-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ExtensionElement-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExtensionElement-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExtensionElement-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Feed">class <strong>Feed</strong></a>(<a href="atom.data.html#Source">Source</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:feed element which contains entries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Feed">Feed</a></dd>
+<dd><a href="atom.data.html#Source">Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="atom.data.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'atom.data.Entry'>]</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">FeedEntryParent</a>:<br>
+<dl><dt><a name="Feed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Feed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Feed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Feed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Feed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="Feed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Feed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Feed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Feed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Feed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Feed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Feed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Feed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Feed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Feed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Feed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Feed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Feed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Feed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Feed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Feed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Feed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Feed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FeedEntryParent">class <strong>FeedEntryParent</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>, <a href="atom.data.html#LinkFinder">LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A super class for atom:feed and entry, contains shared attributes<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#FeedEntryParent">FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="atom.data.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="FeedEntryParent-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FeedEntryParent-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="FeedEntryParent-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Generator">class <strong>Generator</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:generator element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Generator">Generator</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>uri</strong> = 'uri'</dl>
+
+<dl><dt><strong>version</strong> = 'version'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Generator-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Generator-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Generator-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Generator-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Generator-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Generator-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Generator-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Generator-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Generator-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Generator-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Icon">class <strong>Icon</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:icon element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Icon">Icon</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Icon-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Icon-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Icon-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Icon-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Icon-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Icon-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Icon-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Icon-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Icon-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Icon-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Id">class <strong>Id</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:id element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Id">Id</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Id-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Id-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Id-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Id-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Id-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Id-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Id-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Id-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Id-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Id-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Link">class <strong>Link</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:link element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Link">Link</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<dl><dt><strong>hreflang</strong> = 'hreflang'</dl>
+
+<dl><dt><strong>length</strong> = 'length'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>title</strong> = 'title'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Link-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Link-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Link-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Link-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Link-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Link-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Link-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Link-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Link-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Link-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LinkFinder">class <strong>LinkFinder</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An "interface" providing methods to find link elements<br>
+ <br>
+<a href="#Entry">Entry</a> elements often contain multiple links which differ in the rel<br>
+attribute or content type. Often, developers are interested in a specific<br>
+type of link so this class provides methods to find specific classes of<br>
+links.<br>
+ <br>
+This class is used as a mixin in Atom entries and feeds.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="LinkFinder-FindAlternateLink"><strong>FindAlternateLink</strong></a> = <a href="#LinkFinder-find_alternate_link">find_alternate_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindEditLink"><strong>FindEditLink</strong></a> = <a href="#LinkFinder-find_edit_link">find_edit_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = <a href="#LinkFinder-find_edit_media_link">find_edit_media_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindLicenseLink"><strong>FindLicenseLink</strong></a> = <a href="#LinkFinder-find_license_link">find_license_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindNextLink"><strong>FindNextLink</strong></a> = <a href="#LinkFinder-find_next_link">find_next_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindSelfLink"><strong>FindSelfLink</strong></a> = <a href="#LinkFinder-find_self_link">find_self_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindUrl"><strong>FindUrl</strong></a> = <a href="#LinkFinder-find_url">find_url</a>(self, rel)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetAlternateLink"><strong>GetAlternateLink</strong></a> = <a href="#LinkFinder-get_alternate_link">get_alternate_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetEditLink"><strong>GetEditLink</strong></a> = <a href="#LinkFinder-get_edit_link">get_edit_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = <a href="#LinkFinder-get_edit_media_link">get_edit_media_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetLicenseLink"><strong>GetLicenseLink</strong></a> = <a href="#LinkFinder-get_license_link">get_license_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetLink"><strong>GetLink</strong></a> = <a href="#LinkFinder-get_link">get_link</a>(self, rel)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetNextLink"><strong>GetNextLink</strong></a> = <a href="#LinkFinder-get_next_link">get_next_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetSelfLink"><strong>GetSelfLink</strong></a> = <a href="#LinkFinder-get_self_link">get_self_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Logo">class <strong>Logo</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:logo element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Logo">Logo</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Logo-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Logo-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Logo-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Logo-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Logo-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Logo-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Logo-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Logo-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Logo-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Logo-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Name">class <strong>Name</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:name element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Name">Name</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Name-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Name-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Name-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Name-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Name-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Name-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Person">class <strong>Person</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A foundation class which atom:author and atom:contributor extend.<br>
+ <br>
+A person contains information like name, email address, and web page URI for<br>
+an author or contributor to an Atom feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Person">Person</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>email</strong> = <class 'atom.data.Email'><dd><tt>The atom:email element.</tt></dl>
+
+<dl><dt><strong>name</strong> = <class 'atom.data.Name'><dd><tt>The atom:name element.</tt></dl>
+
+<dl><dt><strong>uri</strong> = <class 'atom.data.Uri'><dd><tt>The atom:uri element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Person-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Person-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Person-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Person-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Person-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Person-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Person-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Person-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Person-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Person-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Published">class <strong>Published</strong></a>(<a href="atom.data.html#Date">Date</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:published element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Published">Published</a></dd>
+<dd><a href="atom.data.html#Date">Date</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Published-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Published-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Published-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Published-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Published-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Published-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Published-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Published-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Published-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Published-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Rights">class <strong>Rights</strong></a>(<a href="atom.data.html#Text">Text</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:rights element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Rights">Rights</a></dd>
+<dd><a href="atom.data.html#Text">Text</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Text">Text</a>:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Rights-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rights-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rights-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Rights-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rights-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Rights-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Rights-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Rights-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Rights-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rights-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Source">class <strong>Source</strong></a>(<a href="atom.data.html#FeedEntryParent">FeedEntryParent</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:source element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Source">Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="atom.data.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">FeedEntryParent</a>:<br>
+<dl><dt><a name="Source-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Source-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Source-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Source-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Source-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Source-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Source-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Source-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Source-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="Source-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Source-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Source-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Source-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Source-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Source-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Source-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Source-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Source-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Source-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Source-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Source-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Source-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Source-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Source-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Source-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Source-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Source-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Subtitle">class <strong>Subtitle</strong></a>(<a href="atom.data.html#Text">Text</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:subtitle element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Subtitle">Subtitle</a></dd>
+<dd><a href="atom.data.html#Text">Text</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Text">Text</a>:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Subtitle-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subtitle-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subtitle-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Subtitle-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subtitle-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Subtitle-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Subtitle-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Subtitle-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Subtitle-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subtitle-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Summary">class <strong>Summary</strong></a>(<a href="atom.data.html#Text">Text</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:summary element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Summary">Summary</a></dd>
+<dd><a href="atom.data.html#Text">Text</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Text">Text</a>:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Summary-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Summary-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Summary-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Summary-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Summary-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Summary-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Text">class <strong>Text</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A foundation class from which atom:title, summary, etc. extend.<br>
+ <br>
+This class should never be instantiated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Text">Text</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Text-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Text-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Text-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Text-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Text-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Text-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Text-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Text-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Text-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Text-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Title">class <strong>Title</strong></a>(<a href="atom.data.html#Text">Text</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:title element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Title">Title</a></dd>
+<dd><a href="atom.data.html#Text">Text</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Text">Text</a>:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Title-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Title-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Title-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Title-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Title-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Title-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Title-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Title-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Title-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Title-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Updated">class <strong>Updated</strong></a>(<a href="atom.data.html#Date">Date</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:updated element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Updated">Updated</a></dd>
+<dd><a href="atom.data.html#Date">Date</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Updated-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Updated-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Updated-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Updated-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Updated-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Updated-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Updated-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Updated-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Updated-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Updated-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Uri">class <strong>Uri</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:uri element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.data.html#Uri">Uri</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Uri-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Uri-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Uri-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Uri-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Uri-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Uri-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Uri-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Uri-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Uri-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Uri-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>APP_TEMPLATE_V1</strong> = '{http://purl.org/atom/app#}%s'<br>
+<strong>APP_TEMPLATE_V2</strong> = '{http://www.w3.org/2007/app}%s'<br>
+<strong>ATOM_TEMPLATE</strong> = '{http://www.w3.org/2005/Atom}%s'<br>
+<strong>XML_TEMPLATE</strong> = '{http://www.w3.org/XML/1998/namespace}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.html b/pydocs/atom.html
new file mode 100644
index 0000000..90e2969
--- /dev/null
+++ b/pydocs/atom.html
@@ -0,0 +1,1991 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package atom</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong>atom</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains classes representing Atom elements.<br>
+ <br>
+Module objective: provide data classes for Atom constructs. These classes hide<br>
+the XML-ness of Atom and provide a set of native Python classes to interact<br>
+with.<br>
+ <br>
+Conversions to and from XML should only be necessary when the Atom classes<br>
+"touch the wire" and are sent over HTTP. For this reason this module<br>
+provides methods and functions to convert Atom classes to and from strings.<br>
+ <br>
+For more information on the Atom data model, see <a href="http://www.rfc-editor.org/rfc/rfc4287.txt">RFC 4287</a><br>
+(<a href="http://www.ietf.org/rfc/rfc4287.txt">http://www.ietf.org/rfc/rfc4287.txt</a>)<br>
+ <br>
+<a href="#AtomBase">AtomBase</a>: A foundation class on which Atom classes are built. It<br>
+ handles the parsing of attributes and children which are common to all<br>
+ Atom classes. By default, the <a href="#AtomBase">AtomBase</a> class translates all XML child<br>
+ nodes into ExtensionElements.<br>
+ <br>
+<a href="#ExtensionElement">ExtensionElement</a>: Atom allows Atom objects to contain XML which is not part<br>
+ of the Atom specification, these are called extension elements. If a<br>
+ classes parser encounters an unexpected XML construct, it is translated<br>
+ into an <a href="#ExtensionElement">ExtensionElement</a> instance. <a href="#ExtensionElement">ExtensionElement</a> is designed to fully<br>
+ capture the information in the XML. Child nodes in an XML extension are<br>
+ turned into ExtensionElements as well.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.auth.html">auth</a><br>
+<a href="atom.client.html">client</a><br>
+<a href="atom.core.html">core</a><br>
+<a href="atom.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="atom.http.html">http</a><br>
+<a href="atom.http_core.html">http_core</a><br>
+<a href="atom.http_interface.html">http_interface</a><br>
+<a href="atom.mock_http.html">mock_http</a><br>
+</td><td width="25%" valign=top><a href="atom.mock_http_core.html">mock_http_core</a><br>
+<a href="atom.mock_service.html">mock_service</a><br>
+<a href="atom.service.html">service</a><br>
+<a href="atom.token_store.html">token_store</a><br>
+</td><td width="25%" valign=top><a href="atom.url.html">url</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.html#ExtensionContainer">ExtensionContainer</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">AtomBase</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.html#Category">Category</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Control">Control</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Date">Date</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.html#Published">Published</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Updated">Updated</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Draft">Draft</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Email">Email</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#FeedEntryParent">FeedEntryParent</a>(<a href="atom.html#AtomBase">AtomBase</a>, <a href="atom.html#LinkFinder">LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.html#Entry">Entry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Source">Source</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.html#Feed">Feed</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Generator">Generator</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Icon">Icon</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Id">Id</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Link">Link</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Logo">Logo</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Name">Name</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Person">Person</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.html#Author">Author</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Contributor">Contributor</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Text">Text</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.html#Content">Content</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Rights">Rights</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Subtitle">Subtitle</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Summary">Summary</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#Title">Title</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Uri">Uri</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#ExtensionElement">ExtensionElement</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.html#LinkFinder">LinkFinder</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AtomBase">class <strong>AtomBase</strong></a>(<a href="atom.html#ExtensionContainer">ExtensionContainer</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AtomBase-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="AtomBase-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="AtomBase-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="AtomBase-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Author">class <strong>Author</strong></a>(<a href="atom.html#Person">Person</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:author element<br>
+ <br>
+An author is a required element in <a href="#Feed">Feed</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Author">Author</a></dd>
+<dd><a href="atom.html#Person">Person</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Author-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, email<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Author">Author</a><br>
+ <br>
+Args:<br>
+ name: <a href="#Name">Name</a><br>
+ email: <a href="#Email">Email</a><br>
+ uri: <a href="#Uri">Uri</a><br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs<br>
+ text: str The text data in the this element</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Author-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Author-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Author-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Category">class <strong>Category</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:category element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Category">Category</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Category-__init__"><strong>__init__</strong></a>(self, term<font color="#909090">=None</font>, scheme<font color="#909090">=None</font>, label<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Category">Category</a><br>
+ <br>
+Args:<br>
+ term: str<br>
+ scheme: str<br>
+ label: str<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Category-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Category-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Category-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Content">class <strong>Content</strong></a>(<a href="atom.html#Text">Text</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:content element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Content">Content</a></dd>
+<dd><a href="atom.html#Text">Text</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Content-__init__"><strong>__init__</strong></a>(self, content_type<font color="#909090">=None</font>, src<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Content">Content</a><br>
+ <br>
+Args:<br>
+ content_type: string<br>
+ src: string<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Content-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Content-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Content-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Contributor">class <strong>Contributor</strong></a>(<a href="atom.html#Person">Person</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:contributor element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Contributor">Contributor</a></dd>
+<dd><a href="atom.html#Person">Person</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Contributor-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, email<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Contributor">Contributor</a><br>
+ <br>
+Args:<br>
+ name: <a href="#Name">Name</a><br>
+ email: <a href="#Email">Email</a><br>
+ uri: <a href="#Uri">Uri</a><br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs<br>
+ text: str The text data in the this element</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Contributor-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Contributor-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Contributor-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Control">class <strong>Control</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Control">Control</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Control-__init__"><strong>__init__</strong></a>(self, draft<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for app:control</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Control-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Control-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Control-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Date">class <strong>Date</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A parent class for atom:updated, published, etc.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Date">Date</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Date-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Date-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Date-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Date-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Draft">class <strong>Draft</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The app:draft element which indicates if this entry should be public.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Draft">Draft</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Draft-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for app:draft<br>
+ <br>
+Args:<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Draft-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Draft-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Draft-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Email">class <strong>Email</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:email element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Email">Email</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Email-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Email">Email</a><br>
+ <br>
+Args:<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs<br>
+ text: str The text data in the this element</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Email-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Email-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Email-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Entry">class <strong>Entry</strong></a>(<a href="atom.html#FeedEntryParent">FeedEntryParent</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:entry element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Entry">Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="atom.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Entry-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Entry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Entry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Entry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="Entry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExtensionContainer">class <strong>ExtensionContainer</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="ExtensionContainer-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<dl><dt><a name="ExtensionContainer-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExtensionElement">class <strong>ExtensionElement</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents extra XML elements contained in Atom classes.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="ExtensionElement-FindChildren"><strong>FindChildren</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches child nodes for objects with the desired tag/namespace.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all children in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<dl><dt><a name="ExtensionElement-ToString"><strong>ToString</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ExtensionElement-__init__"><strong>__init__</strong></a>(self, tag, namespace<font color="#909090">=None</font>, attributes<font color="#909090">=None</font>, children<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for EtensionElement<br>
+ <br>
+Args:<br>
+ namespace: string (optional) The XML namespace for this element.<br>
+ tag: string (optional) The tag (without the namespace qualifier) for<br>
+ this element. To reconstruct the full qualified name of the element,<br>
+ combine this tag with the namespace.<br>
+ attributes: dict (optinal) The attribute value string pairs for the XML<br>
+ attributes of this element.<br>
+ children: list (optional) A list of ExtensionElements which represent<br>
+ the XML child nodes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Feed">class <strong>Feed</strong></a>(<a href="atom.html#Source">Source</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:feed element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Feed">Feed</a></dd>
+<dd><a href="atom.html#Source">Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="atom.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Feed-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Feed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Feed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Feed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="Feed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FeedEntryParent">class <strong>FeedEntryParent</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>, <a href="atom.html#LinkFinder">LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A super class for atom:feed and entry, contains shared attributes<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#FeedEntryParent">FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="atom.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="FeedEntryParent-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="FeedEntryParent-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="FeedEntryParent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="FeedEntryParent-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="FeedEntryParent-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedEntryParent-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Generator">class <strong>Generator</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:generator element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Generator">Generator</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Generator-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, version<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Generator">Generator</a><br>
+ <br>
+Args:<br>
+ uri: string<br>
+ version: string<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Generator-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Generator-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Generator-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Icon">class <strong>Icon</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:icon element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Icon">Icon</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Icon-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Icon">Icon</a><br>
+ <br>
+Args:<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Icon-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Icon-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Icon-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Id">class <strong>Id</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:id element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Id">Id</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Id-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Id">Id</a><br>
+ <br>
+Args:<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Id-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Id-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Id-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Link">class <strong>Link</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:link element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Link">Link</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Link-__init__"><strong>__init__</strong></a>(self, href<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, link_type<font color="#909090">=None</font>, hreflang<font color="#909090">=None</font>, title<font color="#909090">=None</font>, length<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Link">Link</a><br>
+ <br>
+Args:<br>
+ href: string The href attribute of the link<br>
+ rel: string<br>
+ type: string<br>
+ hreflang: string The language for the href<br>
+ title: string<br>
+ length: string The length of the href's destination<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs<br>
+ text: str The text data in the this element</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Link-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Link-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Link-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LinkFinder">class <strong>LinkFinder</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An "interface" providing methods to find link elements<br>
+ <br>
+<a href="#Entry">Entry</a> elements often contain multiple links which differ in the rel<br>
+attribute or content type. Often, developers are interested in a specific<br>
+type of link so this class provides methods to find specific classes of<br>
+links.<br>
+ <br>
+This class is used as a mixin in Atom entries and feeds.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="LinkFinder-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Logo">class <strong>Logo</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:logo element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Logo">Logo</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Logo-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Logo">Logo</a><br>
+ <br>
+Args:<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Logo-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Logo-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Logo-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Name">class <strong>Name</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:name element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Name">Name</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Name-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Name">Name</a><br>
+ <br>
+Args:<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Name-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Name-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Name-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Person">class <strong>Person</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A foundation class from which atom:author and atom:contributor extend.<br>
+ <br>
+A person contains information like name, email address, and web page URI for<br>
+an author or contributor to an Atom feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Person">Person</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Person-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, email<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Foundation from which author and contributor are derived.<br>
+ <br>
+The constructor is provided for illustrative purposes, you should not<br>
+need to instantiate a <a href="#Person">Person</a>.<br>
+ <br>
+Args:<br>
+ name: <a href="#Name">Name</a> The person's name<br>
+ email: <a href="#Email">Email</a> The person's email address<br>
+ uri: <a href="#Uri">Uri</a> The URI of the person's webpage<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances which are<br>
+ children of this element.<br>
+ extension_attributes: dict A dictionary of strings which are the values<br>
+ for additional XML attributes of this element.<br>
+ text: String The text contents of the element. This is the contents<br>
+ of the <a href="#Entry">Entry</a>'s XML text node. (Example: <foo>This is the text</foo>)</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Person-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Person-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Person-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Published">class <strong>Published</strong></a>(<a href="atom.html#Date">Date</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:published element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Published">Published</a></dd>
+<dd><a href="atom.html#Date">Date</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Published-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Published">Published</a><br>
+ <br>
+Args:<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Published-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Published-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Published-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Rights">class <strong>Rights</strong></a>(<a href="atom.html#Text">Text</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:rights element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Rights">Rights</a></dd>
+<dd><a href="atom.html#Text">Text</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Rights-__init__"><strong>__init__</strong></a>(self, rights_type<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Rights">Rights</a><br>
+ <br>
+Args:<br>
+ rights_type: string<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Rights-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Rights-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Rights-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Source">class <strong>Source</strong></a>(<a href="atom.html#FeedEntryParent">FeedEntryParent</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:source element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Source">Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="atom.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Source-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Source">Source</a><br>
+ <br>
+Args:<br>
+ author: list (optional) A list of <a href="#Author">Author</a> instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of <a href="#Category">Category</a> instances<br>
+ contributor: list (optional) A list on <a href="#Contributor">Contributor</a> instances<br>
+ generator: <a href="#Generator">Generator</a> (optional)<br>
+ icon: <a href="#Icon">Icon</a> (optional)<br>
+ id: <a href="#Id">Id</a> (optional) The entry's <a href="#Id">Id</a> element<br>
+ link: list (optional) A list of <a href="#Link">Link</a> instances<br>
+ logo: <a href="#Logo">Logo</a> (optional)<br>
+ rights: <a href="#Rights">Rights</a> (optional) The entry's <a href="#Rights">Rights</a> element<br>
+ subtitle: <a href="#Subtitle">Subtitle</a> (optional) The entry's subtitle element<br>
+ title: <a href="#Title">Title</a> (optional) the entry's title element<br>
+ updated: <a href="#Updated">Updated</a> (optional) the entry's updated element<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the <a href="#Entry">Entry</a>'s XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Source-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Source-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Source-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="Source-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Source-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Subtitle">class <strong>Subtitle</strong></a>(<a href="atom.html#Text">Text</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:subtitle element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Subtitle">Subtitle</a></dd>
+<dd><a href="atom.html#Text">Text</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Subtitle-__init__"><strong>__init__</strong></a>(self, subtitle_type<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Subtitle">Subtitle</a><br>
+ <br>
+Args:<br>
+ subtitle_type: string<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Subtitle-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Subtitle-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Subtitle-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Summary">class <strong>Summary</strong></a>(<a href="atom.html#Text">Text</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:summary element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Summary">Summary</a></dd>
+<dd><a href="atom.html#Text">Text</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Summary-__init__"><strong>__init__</strong></a>(self, summary_type<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Summary">Summary</a><br>
+ <br>
+Args:<br>
+ summary_type: string<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Summary-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Summary-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Summary-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Text">class <strong>Text</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A foundation class from which atom:title, summary, etc. extend.<br>
+ <br>
+This class should never be instantiated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Text">Text</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Text-__init__"><strong>__init__</strong></a>(self, text_type<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Text">Text</a><br>
+ <br>
+Args:<br>
+ text_type: string<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Text-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Text-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Text-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Title">class <strong>Title</strong></a>(<a href="atom.html#Text">Text</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:title element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Title">Title</a></dd>
+<dd><a href="atom.html#Text">Text</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Title-__init__"><strong>__init__</strong></a>(self, title_type<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Title">Title</a><br>
+ <br>
+Args:<br>
+ title_type: string<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Title-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Title-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Title-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Updated">class <strong>Updated</strong></a>(<a href="atom.html#Date">Date</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:updated element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Updated">Updated</a></dd>
+<dd><a href="atom.html#Date">Date</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Updated-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Updated">Updated</a><br>
+ <br>
+Args:<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Updated-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Updated-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Updated-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Uri">class <strong>Uri</strong></a>(<a href="atom.html#AtomBase">AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The atom:uri element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.html#Uri">Uri</a></dd>
+<dd><a href="atom.html#AtomBase">AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Uri-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Uri">Uri</a><br>
+ <br>
+Args:<br>
+ extension_elements: list A list of <a href="#ExtensionElement">ExtensionElement</a> instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs<br>
+ text: str The text data in the this element</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">AtomBase</a>:<br>
+<dl><dt><a name="Uri-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Uri-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><a name="Uri-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-AuthorFromString"><strong>AuthorFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CategoryFromString"><strong>CategoryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ContentFromString"><strong>ContentFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ContributorFromString"><strong>ContributorFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ControlFromString"><strong>ControlFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CreateClassFromXMLString"><strong>CreateClassFromXMLString</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+ <dl><dt><a name="-DraftFromString"><strong>DraftFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-EmailFromString"><strong>EmailFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-EntryFromString"><strong>EntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ExtensionElementFromString"><strong>ExtensionElementFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-FeedFromString"><strong>FeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-GeneratorFromString"><strong>GeneratorFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-IconFromString"><strong>IconFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-IdFromString"><strong>IdFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-LinkFromString"><strong>LinkFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-LogoFromString"><strong>LogoFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-NameFromString"><strong>NameFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PublishedFromString"><strong>PublishedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-RightsFromString"><strong>RightsFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SourceFromString"><strong>SourceFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SubtitleFromString"><strong>SubtitleFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SummaryFromString"><strong>SummaryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TitleFromString"><strong>TitleFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-UpdatedFromString"><strong>UpdatedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-UriFromString"><strong>UriFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-deprecated"><strong>deprecated</strong></a>(warning<font color="#909090">=None</font>)</dt><dd><tt>Decorator to raise warning each time the function is called.<br>
+ <br>
+Args:<br>
+ warning: The warning message to be displayed as a string (optinoal).</tt></dd></dl>
+ <dl><dt><a name="-v1_deprecated"><strong>v1_deprecated</strong></a>(warning<font color="#909090">=None</font>)</dt><dd><tt>Shows a warning if ENABLE_V1_WARNINGS is True.<br>
+ <br>
+Function decorator used to mark methods used in v1 classes which<br>
+may be removed in future versions of the library.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>APP_NAMESPACE</strong> = 'http://purl.org/atom/app#'<br>
+<strong>APP_TEMPLATE</strong> = '{http://purl.org/atom/app#}%s'<br>
+<strong>ATOM_NAMESPACE</strong> = 'http://www.w3.org/2005/Atom'<br>
+<strong>ELEMENT_TEMPLATE</strong> = '{http://www.w3.org/2005/Atom}%s'<br>
+<strong>ENABLE_V1_WARNINGS</strong> = False<br>
+<strong>MEMBER_STRING_ENCODING</strong> = 'utf-8'<br>
+<strong>XML_STRING_ENCODING</strong> = 'utf-8'<br>
+<strong>__author__</strong> = 'api.jscudder (Jeffrey Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeffrey Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.http.html b/pydocs/atom.http.html
new file mode 100644
index 0000000..caa9f48
--- /dev/null
+++ b/pydocs/atom.http.html
@@ -0,0 +1,348 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.http</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.http</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/http.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/http.py</a></font></td></tr></table>
+ <p><tt>HttpClients in this module use httplib to make HTTP requests.<br>
+ <br>
+This module make HTTP requests based on httplib, but there are environments<br>
+in which an httplib based approach will not work (if running in Google App<br>
+Engine for example). In those cases, higher level classes (like AtomService<br>
+and GDataService) can swap out the <a href="#HttpClient">HttpClient</a> to transparently use a <br>
+different mechanism for making HTTP requests.<br>
+ <br>
+ <a href="#HttpClient">HttpClient</a>: Contains a request method which performs an HTTP call to the <br>
+ server.<br>
+ <br>
+ <a href="#ProxiedHttpClient">ProxiedHttpClient</a>: Contains a request method which connects to a proxy using<br>
+ settings stored in operating system environment variables then <br>
+ performs an HTTP call to the endpoint server.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+<a href="base64.html">base64</a><br>
+</td><td width="25%" valign=top><a href="httplib.html">httplib</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="socket.html">socket</a><br>
+<a href="ssl.html">ssl</a><br>
+</td><td width="25%" valign=top><a href="types.html">types</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.http_interface.html#Error">atom.http_interface.Error</a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.http.html#ProxyError">ProxyError</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.http.html#HttpClient">HttpClient</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.http.html#ProxiedHttpClient">ProxiedHttpClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.http.html#TestConfigurationError">TestConfigurationError</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HttpClient">class <strong>HttpClient</strong></a>(<a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.http.html#HttpClient">HttpClient</a></dd>
+<dd><a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="HttpClient-__init__"><strong>__init__</strong></a>(self, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="HttpClient-request"><strong>request</strong></a>(self, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Performs an HTTP call to the server, supports GET, POST, PUT, and <br>
+DELETE.<br>
+ <br>
+Usage example, perform and HTTP GET on <a href="http://www.google.com/">http://www.google.com/</a>:<br>
+ import atom.http<br>
+ client = atom.http.<a href="#HttpClient">HttpClient</a>()<br>
+ http_response = client.<a href="#HttpClient-request">request</a>('GET', '<a href="http://www.google.com/">http://www.google.com/</a>')<br>
+ <br>
+Args:<br>
+ operation: str The HTTP operation to be performed. This is usually one<br>
+ of 'GET', 'POST', 'PUT', or 'DELETE'<br>
+ data: filestream, list of parts, or other object which can be converted<br>
+ to a string. Should be set to None when performing a GET or DELETE.<br>
+ If data is a file-like object which can be read, this method will <br>
+ read a chunk of 100K bytes at a time and send them. <br>
+ If the data is a list of parts to be sent, each part will be <br>
+ evaluated and sent.<br>
+ url: The full URL to which the request should be sent. Can be a string<br>
+ or atom.url.Url.<br>
+ headers: dict of strings. HTTP headers which should be sent<br>
+ in the request.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>v2_http_client</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><a name="HttpClient-delete"><strong>delete</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="HttpClient-get"><strong>get</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="HttpClient-post"><strong>post</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="HttpClient-put"><strong>put</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><strong>debug</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProxiedHttpClient">class <strong>ProxiedHttpClient</strong></a>(<a href="atom.http.html#HttpClient">HttpClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Performs an HTTP request through a proxy.<br>
+ <br>
+The proxy settings are obtained from enviroment variables. The URL of the <br>
+proxy server is assumed to be stored in the environment variables <br>
+'https_proxy' and 'http_proxy' respectively. If the proxy server requires<br>
+a Basic Auth authorization header, the username and password are expected to <br>
+be in the 'proxy-username' or 'proxy_username' variable and the <br>
+'proxy-password' or 'proxy_password' variable, or in 'http_proxy' or<br>
+'https_proxy' as "protocol://[username:password@]host:port".<br>
+ <br>
+After connecting to the proxy server, the request is completed as in <br>
+<a href="#HttpClient">HttpClient</a>.request.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.http.html#ProxiedHttpClient">ProxiedHttpClient</a></dd>
+<dd><a href="atom.http.html#HttpClient">HttpClient</a></dd>
+<dd><a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.http.html#HttpClient">HttpClient</a>:<br>
+<dl><dt><a name="ProxiedHttpClient-__init__"><strong>__init__</strong></a>(self, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ProxiedHttpClient-request"><strong>request</strong></a>(self, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Performs an HTTP call to the server, supports GET, POST, PUT, and <br>
+DELETE.<br>
+ <br>
+Usage example, perform and HTTP GET on <a href="http://www.google.com/">http://www.google.com/</a>:<br>
+ import atom.http<br>
+ client = atom.http.<a href="#HttpClient">HttpClient</a>()<br>
+ http_response = client.<a href="#ProxiedHttpClient-request">request</a>('GET', '<a href="http://www.google.com/">http://www.google.com/</a>')<br>
+ <br>
+Args:<br>
+ operation: str The HTTP operation to be performed. This is usually one<br>
+ of 'GET', 'POST', 'PUT', or 'DELETE'<br>
+ data: filestream, list of parts, or other object which can be converted<br>
+ to a string. Should be set to None when performing a GET or DELETE.<br>
+ If data is a file-like object which can be read, this method will <br>
+ read a chunk of 100K bytes at a time and send them. <br>
+ If the data is a list of parts to be sent, each part will be <br>
+ evaluated and sent.<br>
+ url: The full URL to which the request should be sent. Can be a string<br>
+ or atom.url.Url.<br>
+ headers: dict of strings. HTTP headers which should be sent<br>
+ in the request.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.http.html#HttpClient">HttpClient</a>:<br>
+<dl><dt><strong>v2_http_client</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><a name="ProxiedHttpClient-delete"><strong>delete</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ProxiedHttpClient-get"><strong>get</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ProxiedHttpClient-post"><strong>post</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ProxiedHttpClient-put"><strong>put</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><strong>debug</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProxyError">class <strong>ProxyError</strong></a>(<a href="atom.http_interface.html#Error">atom.http_interface.Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.http.html#ProxyError">ProxyError</a></dd>
+<dd><a href="atom.http_interface.html#Error">atom.http_interface.Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#Error">atom.http_interface.Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="ProxyError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#ProxyError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="ProxyError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="ProxyError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="ProxyError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TestConfigurationError">class <strong>TestConfigurationError</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.http.html#TestConfigurationError">TestConfigurationError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TestConfigurationError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TestConfigurationError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TestConfigurationError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TestConfigurationError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TestConfigurationError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TestConfigurationError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TestConfigurationError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TestConfigurationError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TestConfigurationError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TestConfigurationError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TestConfigurationError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TestConfigurationError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TestConfigurationError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TestConfigurationError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TestConfigurationError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TestConfigurationError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TestConfigurationError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TestConfigurationError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TestConfigurationError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TestConfigurationError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DEFAULT_CONTENT_TYPE</strong> = 'application/atom+xml'<br>
+<strong>__author__</strong> = 'api.jscudder (Jeff Scudder)'<br>
+<strong>ssl_imported</strong> = True</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.http_core.html b/pydocs/atom.http_core.html
new file mode 100644
index 0000000..78e2825
--- /dev/null
+++ b/pydocs/atom.http_core.html
@@ -0,0 +1,491 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.http_core</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.http_core</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/http_core.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/http_core.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="StringIO.html">StringIO</a><br>
+<a href="httplib.html">httplib</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="ssl.html">ssl</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+<a href="urlparse.html">urlparse</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.http_core.html#HttpClient">HttpClient</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.http_core.html#ProxiedHttpClient">ProxiedHttpClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.http_core.html#HttpRequest">HttpRequest</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.http_core.html#HttpResponse">HttpResponse</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.http_core.html#Uri">Uri</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.http_core.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.http_core.html#ProxyError">ProxyError</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.http_core.html#UnknownSize">UnknownSize</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.http_core.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HttpClient">class <strong>HttpClient</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Performs HTTP requests using httplib.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="HttpClient-Request"><strong>Request</strong></a> = <a href="#HttpClient-request">request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="HttpClient-request"><strong>request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>debug</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HttpRequest">class <strong>HttpRequest</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Contains all of the parameters for an HTTP 1.1 request.<br>
+ <br>
+The HTTP headers are represented by a dictionary, and it is the<br>
+responsibility of the user to ensure that duplicate field names are combined<br>
+into one header value according to the rules in section 4.2 of <a href="http://www.rfc-editor.org/rfc/rfc2616.txt">RFC 2616</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="HttpRequest-AddBodyPart"><strong>AddBodyPart</strong></a> = <a href="#HttpRequest-add_body_part">add_body_part</a>(self, data, mime_type, size<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="HttpRequest-AddFormInputs"><strong>AddFormInputs</strong></a> = <a href="#HttpRequest-add_form_inputs">add_form_inputs</a>(self, form_data, mime_type<font color="#909090">='application/x-www-form-urlencoded'</font>)</dt></dl>
+
+<dl><dt><a name="HttpRequest-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, method<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Construct an HTTP request.<br>
+ <br>
+Args:<br>
+ uri: The full path or partial path as a <a href="#Uri">Uri</a> <a href="__builtin__.html#object">object</a> or a string.<br>
+ method: The HTTP method for the request, examples include 'GET', 'POST',<br>
+ etc.<br>
+ headers: dict of strings The HTTP headers to include in the request.</tt></dd></dl>
+
+<dl><dt><a name="HttpRequest-add_body_part"><strong>add_body_part</strong></a>(self, data, mime_type, size<font color="#909090">=None</font>)</dt><dd><tt>Adds data to the HTTP request body.<br>
+ <br>
+If more than one part is added, this is assumed to be a mime-multipart<br>
+request. This method is designed to create MIME 1.0 requests as specified<br>
+in <a href="http://www.rfc-editor.org/rfc/rfc1341.txt">RFC 1341</a>.<br>
+ <br>
+Args:<br>
+ data: str or a file-like <a href="__builtin__.html#object">object</a> containing a part of the request body.<br>
+ mime_type: str The MIME type describing the data<br>
+ size: int Required if the data is a file like <a href="__builtin__.html#object">object</a>. If the data is a<br>
+ string, the size is calculated so this parameter is ignored.</tt></dd></dl>
+
+<dl><dt><a name="HttpRequest-add_form_inputs"><strong>add_form_inputs</strong></a>(self, form_data, mime_type<font color="#909090">='application/x-www-form-urlencoded'</font>)</dt><dd><tt>Form-encodes and adds data to the request body.<br>
+ <br>
+Args:<br>
+ form_data: dict or sequnce or two member tuples which contains the<br>
+ form keys and values.<br>
+ mime_type: str The MIME type of the form data being sent. Defaults<br>
+ to 'application/x-www-form-urlencoded'.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>method</strong> = None</dl>
+
+<dl><dt><strong>uri</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HttpResponse">class <strong>HttpResponse</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="HttpResponse-__init__"><strong>__init__</strong></a>(self, status<font color="#909090">=None</font>, reason<font color="#909090">=None</font>, headers<font color="#909090">=None</font>, body<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="HttpResponse-getheader"><strong>getheader</strong></a>(self, name, default<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="HttpResponse-getheaders"><strong>getheaders</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="HttpResponse-read"><strong>read</strong></a>(self, amt<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>reason</strong> = None</dl>
+
+<dl><dt><strong>status</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProxiedHttpClient">class <strong>ProxiedHttpClient</strong></a>(<a href="atom.http_core.html#HttpClient">HttpClient</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.http_core.html#ProxiedHttpClient">ProxiedHttpClient</a></dd>
+<dd><a href="atom.http_core.html#HttpClient">HttpClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.http_core.html#HttpClient">HttpClient</a>:<br>
+<dl><dt><a name="ProxiedHttpClient-Request"><strong>Request</strong></a> = request(self, http_request)</dt></dl>
+
+<dl><dt><a name="ProxiedHttpClient-request"><strong>request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#HttpClient">HttpClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_core.html#HttpClient">HttpClient</a>:<br>
+<dl><dt><strong>debug</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProxyError">class <strong>ProxyError</strong></a>(<a href="atom.http_core.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.http_core.html#ProxyError">ProxyError</a></dd>
+<dd><a href="atom.http_core.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="ProxyError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#ProxyError-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="ProxyError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="ProxyError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="ProxyError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#ProxyError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="ProxyError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UnknownSize">class <strong>UnknownSize</strong></a>(<a href="atom.http_core.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.http_core.html#UnknownSize">UnknownSize</a></dd>
+<dd><a href="atom.http_core.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="UnknownSize-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#UnknownSize-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#UnknownSize-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="UnknownSize-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnknownSize-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="UnknownSize-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#UnknownSize-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="UnknownSize-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#UnknownSize-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="UnknownSize-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#UnknownSize-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="UnknownSize-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="UnknownSize-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnknownSize-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="UnknownSize-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnknownSize-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="UnknownSize-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="UnknownSize-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#UnknownSize-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="UnknownSize-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Uri">class <strong>Uri</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A URI as used in HTTP 1.1<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Uri-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#Uri-modify_request">modify_request</a>(self, http_request<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Uri-__init__"><strong>__init__</strong></a>(self, scheme<font color="#909090">=None</font>, host<font color="#909090">=None</font>, port<font color="#909090">=None</font>, path<font color="#909090">=None</font>, query<font color="#909090">=None</font>)</dt><dd><tt>Constructor for a URI.<br>
+ <br>
+Args:<br>
+ scheme: str This is usually 'http' or 'https'.<br>
+ host: str The host name or IP address of the desired server.<br>
+ post: int The server's port number.<br>
+ path: str The path of the resource following the host. This begins with<br>
+ a /, example: '/calendar/feeds/default/allcalendars/full'<br>
+ query: dict of strings The URL query parameters. The keys and values are<br>
+ both escaped so this dict should contain the unescaped values.<br>
+ For example {'my key': 'val', 'second': '!!!'} will become<br>
+ '?my+key=val&second=%21%21%21' which is appended to the path.</tt></dd></dl>
+
+<dl><dt><a name="Uri-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Uri-modify_request"><strong>modify_request</strong></a>(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<hr>
+Static methods defined here:<br>
+<dl><dt><a name="Uri-ParseUri"><strong>ParseUri</strong></a> = parse_uri(uri_string)</dt><dd><tt>Creates a <a href="#Uri">Uri</a> <a href="__builtin__.html#object">object</a> which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the <a href="#Uri">Uri</a> unset.</tt></dd></dl>
+
+<dl><dt><a name="Uri-parse_uri"><strong>parse_uri</strong></a>(uri_string)</dt><dd><tt>Creates a <a href="#Uri">Uri</a> <a href="__builtin__.html#object">object</a> which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the <a href="#Uri">Uri</a> unset.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>path</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = None</dl>
+
+<dl><dt><strong>scheme</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-ParseUri"><strong>ParseUri</strong></a> = parse_uri(uri_string)</dt><dd><tt>Creates a <a href="#Uri">Uri</a> <a href="__builtin__.html#object">object</a> which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the <a href="#Uri">Uri</a> unset.</tt></dd></dl>
+ <dl><dt><a name="-get_headers"><strong>get_headers</strong></a>(http_response)</dt><dd><tt>Retrieves all HTTP headers from an HTTP response from the server.<br>
+ <br>
+This method is provided for backwards compatibility for Python2.2 and 2.3.<br>
+The httplib.HTTPResponse <a href="__builtin__.html#object">object</a> in 2.2 and 2.3 does not have a getheaders<br>
+method so this function will use getheaders if available, but if not it<br>
+will retrieve a few using getheader.</tt></dd></dl>
+ <dl><dt><a name="-parse_uri"><strong>parse_uri</strong></a>(uri_string)</dt><dd><tt>Creates a <a href="#Uri">Uri</a> <a href="__builtin__.html#object">object</a> which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the <a href="#Uri">Uri</a> unset.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>MIME_BOUNDARY</strong> = 'END_OF_PART'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.http_interface.html b/pydocs/atom.http_interface.html
new file mode 100644
index 0000000..3217d7a
--- /dev/null
+++ b/pydocs/atom.http_interface.html
@@ -0,0 +1,359 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.http_interface</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.http_interface</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/http_interface.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/http_interface.py</a></font></td></tr></table>
+ <p><tt>This module provides a common interface for all HTTP requests.<br>
+ <br>
+<a href="#HttpResponse">HttpResponse</a>: Represents the server's response to an HTTP request. Provides<br>
+ an interface identical to httplib.HTTPResponse which is the response<br>
+ expected from higher level classes which use HttpClient.request.<br>
+ <br>
+<a href="#GenericHttpClient">GenericHttpClient</a>: Provides an interface (superclass) for an <a href="__builtin__.html#object">object</a> <br>
+ responsible for making HTTP requests. Subclasses of this <a href="__builtin__.html#object">object</a> are<br>
+ used in AtomService and GDataService to make requests to the server. By<br>
+ changing the http_client member <a href="__builtin__.html#object">object</a>, the AtomService is able to make<br>
+ HTTP requests using different logic (for example, when running on <br>
+ Google App Engine, the http_client makes requests using the App Engine<br>
+ urlfetch API).</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="StringIO.html">StringIO</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.http_interface.html#GenericHttpClient">GenericHttpClient</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.http_interface.html#GenericToken">GenericToken</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.http_interface.html#HttpResponse">HttpResponse</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.http_interface.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.http_interface.html#ContentLengthRequired">ContentLengthRequired</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.http_interface.html#UnparsableUrlObject">UnparsableUrlObject</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContentLengthRequired">class <strong>ContentLengthRequired</strong></a>(<a href="atom.http_interface.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.http_interface.html#ContentLengthRequired">ContentLengthRequired</a></dd>
+<dd><a href="atom.http_interface.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="ContentLengthRequired-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#ContentLengthRequired-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#ContentLengthRequired-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="ContentLengthRequired-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#ContentLengthRequired-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="ContentLengthRequired-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#ContentLengthRequired-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="ContentLengthRequired-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ContentLengthRequired-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="ContentLengthRequired-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#ContentLengthRequired-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="ContentLengthRequired-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="ContentLengthRequired-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#ContentLengthRequired-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="ContentLengthRequired-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#ContentLengthRequired-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="ContentLengthRequired-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="ContentLengthRequired-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#ContentLengthRequired-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="ContentLengthRequired-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.http_interface.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GenericHttpClient">class <strong>GenericHttpClient</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="GenericHttpClient-__init__"><strong>__init__</strong></a>(self, http_client, headers<font color="#909090">=None</font>)</dt><dd><tt>Args:<br>
+ http_client: An <a href="__builtin__.html#object">object</a> which provides a request method to make an HTTP <br>
+ request. The request method in <a href="#GenericHttpClient">GenericHttpClient</a> performs a <br>
+ call-through to the contained HTTP client <a href="__builtin__.html#object">object</a>.<br>
+ headers: A dictionary containing HTTP headers which should be included<br>
+ in every HTTP request. Common persistent headers include <br>
+ 'User-Agent'.</tt></dd></dl>
+
+<dl><dt><a name="GenericHttpClient-delete"><strong>delete</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GenericHttpClient-get"><strong>get</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GenericHttpClient-post"><strong>post</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GenericHttpClient-put"><strong>put</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GenericHttpClient-request"><strong>request</strong></a>(self, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>debug</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GenericToken">class <strong>GenericToken</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an Authorization token to be added to HTTP requests.<br>
+ <br>
+Some Authorization headers included calculated fields (digital<br>
+signatures for example) which are based on the parameters of the HTTP<br>
+request. Therefore the token is responsible for signing the request<br>
+and adding the Authorization header.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="GenericToken-perform_request"><strong>perform_request</strong></a>(self, http_client, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>For the <a href="#GenericToken">GenericToken</a>, no Authorization token is set.</tt></dd></dl>
+
+<dl><dt><a name="GenericToken-valid_for_scope"><strong>valid_for_scope</strong></a>(self, url)</dt><dd><tt>Tells the caller if the token authorizes access to the desired URL.<br>
+ <br>
+Since the generic token doesn't add an auth header, it is not valid for<br>
+any scope.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HttpResponse">class <strong>HttpResponse</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="HttpResponse-__init__"><strong>__init__</strong></a>(self, body<font color="#909090">=None</font>, status<font color="#909090">=None</font>, reason<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Constructor for an <a href="#HttpResponse">HttpResponse</a> <a href="__builtin__.html#object">object</a>. <br>
+ <br>
+<a href="#HttpResponse">HttpResponse</a> represents the server's response to an HTTP request from<br>
+the client. The HttpClient.request method returns a httplib.HTTPResponse<br>
+<a href="__builtin__.html#object">object</a> and this <a href="#HttpResponse">HttpResponse</a> class is designed to mirror the interface<br>
+exposed by httplib.HTTPResponse.<br>
+ <br>
+Args:<br>
+ body: A file like <a href="__builtin__.html#object">object</a>, with a <a href="#HttpResponse-read">read</a>() method. The body could also<br>
+ be a string, and the constructor will wrap it so that <br>
+ <a href="#HttpResponse">HttpResponse</a>.<a href="#HttpResponse-read">read</a>(self) will return the full string.<br>
+ status: The HTTP status code as an int. Example: 200, 201, 404.<br>
+ reason: The HTTP status message which follows the code. Example: <br>
+ OK, Created, Not Found<br>
+ headers: A dictionary containing the HTTP headers in the server's <br>
+ response. A common header in the response is Content-Length.</tt></dd></dl>
+
+<dl><dt><a name="HttpResponse-getheader"><strong>getheader</strong></a>(self, name, default<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="HttpResponse-read"><strong>read</strong></a>(self, amt<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UnparsableUrlObject">class <strong>UnparsableUrlObject</strong></a>(<a href="atom.http_interface.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.http_interface.html#UnparsableUrlObject">UnparsableUrlObject</a></dd>
+<dd><a href="atom.http_interface.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="UnparsableUrlObject-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#UnparsableUrlObject-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#UnparsableUrlObject-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="UnparsableUrlObject-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnparsableUrlObject-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="UnparsableUrlObject-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#UnparsableUrlObject-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="UnparsableUrlObject-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#UnparsableUrlObject-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="UnparsableUrlObject-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#UnparsableUrlObject-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="UnparsableUrlObject-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="UnparsableUrlObject-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnparsableUrlObject-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="UnparsableUrlObject-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnparsableUrlObject-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="UnparsableUrlObject-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="UnparsableUrlObject-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#UnparsableUrlObject-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="UnparsableUrlObject-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>USER_AGENT</strong> = '%s GData-Python/2.0.18'<br>
+<strong>__author__</strong> = 'api.jscudder (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.mock_http.html b/pydocs/atom.mock_http.html
new file mode 100644
index 0000000..5a0f63d
--- /dev/null
+++ b/pydocs/atom.mock_http.html
@@ -0,0 +1,331 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.mock_http</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.mock_http</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/mock_http.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/mock_http.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2008 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.mock_http.html#MockRequest">MockRequest</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.mock_http.html#MockHttpClient">MockHttpClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.http_interface.html#HttpResponse">atom.http_interface.HttpResponse</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.mock_http.html#MockResponse">MockResponse</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.mock_http.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.mock_http.html#NoRecordingFound">NoRecordingFound</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.mock_http.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MockHttpClient">class <strong>MockHttpClient</strong></a>(<a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.mock_http.html#MockHttpClient">MockHttpClient</a></dd>
+<dd><a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="MockHttpClient-__init__"><strong>__init__</strong></a>(self, headers<font color="#909090">=None</font>, recordings<font color="#909090">=None</font>, real_client<font color="#909090">=None</font>)</dt><dd><tt>An HttpClient which responds to request with stored data.<br>
+ <br>
+The request-response pairs are stored as tuples in a member list named<br>
+recordings.<br>
+ <br>
+The <a href="#MockHttpClient">MockHttpClient</a> can be switched from replay mode to record mode by<br>
+setting the real_client member to an instance of an HttpClient which will<br>
+make real HTTP requests and store the server's response in list of <br>
+recordings.<br>
+ <br>
+Args:<br>
+ headers: dict containing HTTP headers which should be included in all<br>
+ HTTP requests.<br>
+ recordings: The initial recordings to be used for responses. This list<br>
+ contains tuples in the form: (<a href="#MockRequest">MockRequest</a>, <a href="#MockResponse">MockResponse</a>)<br>
+ real_client: An HttpClient which will make a real HTTP request. The <br>
+ response will be converted into a <a href="#MockResponse">MockResponse</a> and stored in <br>
+ recordings.</tt></dd></dl>
+
+<dl><dt><a name="MockHttpClient-add_response"><strong>add_response</strong></a>(self, response, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Adds a request-response pair to the recordings list.<br>
+ <br>
+After the recording is added, future matching requests will receive the<br>
+response.<br>
+ <br>
+Args:<br>
+ response: <a href="#MockResponse">MockResponse</a><br>
+ operation: str<br>
+ url: str<br>
+ data: str, Currently the data is ignored when looking for matching<br>
+ requests.<br>
+ headers: dict of strings: Currently the headers are ignored when<br>
+ looking for matching requests.</tt></dd></dl>
+
+<dl><dt><a name="MockHttpClient-request"><strong>request</strong></a>(self, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a matching <a href="#MockResponse">MockResponse</a> from the recordings.<br>
+ <br>
+If the real_client is set, the request will be passed along and the <br>
+server's response will be added to the recordings and also returned. <br>
+ <br>
+If there is no match, a <a href="#NoRecordingFound">NoRecordingFound</a> error will be raised.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><a name="MockHttpClient-delete"><strong>delete</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MockHttpClient-get"><strong>get</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MockHttpClient-post"><strong>post</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MockHttpClient-put"><strong>put</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><strong>debug</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MockRequest">class <strong>MockRequest</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Holds parameters of an HTTP request for matching against future requests.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="MockRequest-__init__"><strong>__init__</strong></a>(self, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MockResponse">class <strong>MockResponse</strong></a>(<a href="atom.http_interface.html#HttpResponse">atom.http_interface.HttpResponse</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Simulates an httplib.HTTPResponse <a href="__builtin__.html#object">object</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.mock_http.html#MockResponse">MockResponse</a></dd>
+<dd><a href="atom.http_interface.html#HttpResponse">atom.http_interface.HttpResponse</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="MockResponse-__init__"><strong>__init__</strong></a>(self, body<font color="#909090">=None</font>, status<font color="#909090">=None</font>, reason<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MockResponse-read"><strong>read</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.http_interface.html#HttpResponse">atom.http_interface.HttpResponse</a>:<br>
+<dl><dt><a name="MockResponse-getheader"><strong>getheader</strong></a>(self, name, default<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#HttpResponse">atom.http_interface.HttpResponse</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NoRecordingFound">class <strong>NoRecordingFound</strong></a>(<a href="atom.mock_http.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.mock_http.html#NoRecordingFound">NoRecordingFound</a></dd>
+<dd><a href="atom.mock_http.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="atom.mock_http.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="NoRecordingFound-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#NoRecordingFound-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="NoRecordingFound-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NoRecordingFound-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NoRecordingFound-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'api.jscudder (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.mock_http_core.html b/pydocs/atom.mock_http_core.html
new file mode 100644
index 0000000..ca97d60
--- /dev/null
+++ b/pydocs/atom.mock_http_core.html
@@ -0,0 +1,375 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.mock_http_core</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.mock_http_core</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/mock_http_core.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/mock_http_core.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="StringIO.html">StringIO</a><br>
+<a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="pickle.html">pickle</a><br>
+</td><td width="25%" valign=top><a href="tempfile.html">tempfile</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.mock_http_core.html#EchoHttpClient">EchoHttpClient</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.mock_http_core.html#MockHttpClient">MockHttpClient</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.mock_http_core.html#SettableHttpClient">SettableHttpClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.http_core.html#HttpResponse">atom.http_core.HttpResponse</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.mock_http_core.html#MockHttpResponse">MockHttpResponse</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.mock_http_core.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.mock_http_core.html#NoRecordingFound">NoRecordingFound</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EchoHttpClient">class <strong>EchoHttpClient</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Sends the request data back in the response.<br>
+ <br>
+Used to check the formatting of the request as it was sent. Always responds<br>
+with a 200 OK, and some information from the HTTP request is returned in<br>
+special Echo-X headers in the response. The following headers are added<br>
+in the response:<br>
+'Echo-Host': The host name and port number to which the HTTP connection is<br>
+ made. If no port was passed in, the header will contain<br>
+ host:None.<br>
+'Echo-Uri': The path portion of the URL being requested. /example?x=1&y=2<br>
+'Echo-Scheme': The beginning of the URL, usually 'http' or 'https'<br>
+'Echo-Method': The HTTP method being used, 'GET', 'POST', 'PUT', etc.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="EchoHttpClient-request"><strong>request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.mock_http_core.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MockHttpClient">class <strong>MockHttpClient</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="MockHttpClient-AddResponse"><strong>AddResponse</strong></a> = <a href="#MockHttpClient-add_response">add_response</a>(self, http_request, status, reason, headers<font color="#909090">=None</font>, body<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MockHttpClient-Request"><strong>Request</strong></a> = <a href="#MockHttpClient-request">request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="MockHttpClient-__init__"><strong>__init__</strong></a>(self, recordings<font color="#909090">=None</font>, real_client<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MockHttpClient-add_response"><strong>add_response</strong></a>(self, http_request, status, reason, headers<font color="#909090">=None</font>, body<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MockHttpClient-close_session"><strong>close_session</strong></a>(self)</dt><dd><tt>Saves recordings in the temporary file named in use_cached_session.</tt></dd></dl>
+
+<dl><dt><a name="MockHttpClient-delete_session"><strong>delete_session</strong></a>(self, name<font color="#909090">=None</font>)</dt><dd><tt>Removes recordings from a previous live request.</tt></dd></dl>
+
+<dl><dt><a name="MockHttpClient-get_cache_file_name"><strong>get_cache_file_name</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MockHttpClient-request"><strong>request</strong></a>(self, http_request)</dt><dd><tt>Provide a recorded response, or record a response for replay.<br>
+ <br>
+If the real_client is set, the request will be made using the<br>
+real_client, and the response from the server will be recorded.<br>
+If the real_client is None (the default), this method will examine<br>
+the recordings and find the first which matches.</tt></dd></dl>
+
+<dl><dt><a name="MockHttpClient-use_cached_session"><strong>use_cached_session</strong></a>(self, name<font color="#909090">=None</font>, real_http_client<font color="#909090">=None</font>)</dt><dd><tt>Attempts to load recordings from a previous live request.<br>
+ <br>
+If a temp file with the recordings exists, then it is used to fulfill<br>
+requests. If the file does not exist, then a real client is used to<br>
+actually make the desired HTTP requests. Requests and responses are<br>
+recorded and will be written to the desired temprary cache file when<br>
+close_session is called.<br>
+ <br>
+Args:<br>
+ name: str (optional) The file name of session file to be used. The file<br>
+ is loaded from the temporary directory of this machine. If no name<br>
+ is passed in, a default name will be constructed using the<br>
+ cache_name_prefix, cache_case_name, and cache_test_name of this<br>
+ <a href="__builtin__.html#object">object</a>.<br>
+ real_http_client: atom.http_core.HttpClient the real client to be used<br>
+ if the cached recordings are not found. If the default<br>
+ value is used, this will be an<br>
+ atom.http_core.HttpClient.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>cache_case_name</strong> = ''</dl>
+
+<dl><dt><strong>cache_name_prefix</strong> = 'gdata_live_test'</dl>
+
+<dl><dt><strong>cache_test_name</strong> = ''</dl>
+
+<dl><dt><strong>debug</strong> = None</dl>
+
+<dl><dt><strong>last_request_was_live</strong> = False</dl>
+
+<dl><dt><strong>real_client</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MockHttpResponse">class <strong>MockHttpResponse</strong></a>(<a href="atom.http_core.html#HttpResponse">atom.http_core.HttpResponse</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.mock_http_core.html#MockHttpResponse">MockHttpResponse</a></dd>
+<dd><a href="atom.http_core.html#HttpResponse">atom.http_core.HttpResponse</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="MockHttpResponse-__init__"><strong>__init__</strong></a>(self, status<font color="#909090">=None</font>, reason<font color="#909090">=None</font>, headers<font color="#909090">=None</font>, body<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MockHttpResponse-read"><strong>read</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.http_core.html#HttpResponse">atom.http_core.HttpResponse</a>:<br>
+<dl><dt><a name="MockHttpResponse-getheader"><strong>getheader</strong></a>(self, name, default<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MockHttpResponse-getheaders"><strong>getheaders</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#HttpResponse">atom.http_core.HttpResponse</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_core.html#HttpResponse">atom.http_core.HttpResponse</a>:<br>
+<dl><dt><strong>reason</strong> = None</dl>
+
+<dl><dt><strong>status</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NoRecordingFound">class <strong>NoRecordingFound</strong></a>(<a href="atom.mock_http_core.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.mock_http_core.html#NoRecordingFound">NoRecordingFound</a></dd>
+<dd><a href="atom.mock_http_core.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="atom.mock_http_core.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="NoRecordingFound-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#NoRecordingFound-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="NoRecordingFound-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NoRecordingFound-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NoRecordingFound-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#NoRecordingFound-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="NoRecordingFound-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SettableHttpClient">class <strong>SettableHttpClient</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An HTTP Client which responds with the data given in set_response.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="SettableHttpClient-__init__"><strong>__init__</strong></a>(self, status, reason, body, headers)</dt><dd><tt>Configures the response for the server.<br>
+ <br>
+See set_response for details on the arguments to the constructor.</tt></dd></dl>
+
+<dl><dt><a name="SettableHttpClient-request"><strong>request</strong></a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="SettableHttpClient-set_response"><strong>set_response</strong></a>(self, status, reason, body, headers)</dt><dd><tt>Determines the response which will be sent for each request.<br>
+ <br>
+Args:<br>
+ status: An int for the HTTP status code, example: 200, 404, etc.<br>
+ reason: String for the HTTP reason, example: OK, NOT FOUND, etc.<br>
+ body: The body of the HTTP response as a string or a file-like<br>
+ <a href="__builtin__.html#object">object</a> (something with a read method).<br>
+ headers: dict of strings containing the HTTP headers in the response.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.mock_service.html b/pydocs/atom.mock_service.html
new file mode 100644
index 0000000..db58f6c
--- /dev/null
+++ b/pydocs/atom.mock_service.html
@@ -0,0 +1,200 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.mock_service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.mock_service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/mock_service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/mock_service.py</a></font></td></tr></table>
+ <p><tt>MockService provides CRUD ops. for mocking calls to AtomPub services.<br>
+ <br>
+MockService: Exposes the publicly used methods of AtomService to provide<br>
+ a mock interface which can be used in unit tests.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="pickle.html">pickle</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.mock_service.html#MockHttpResponse">MockHttpResponse</a>
+</font></dt><dt><font face="helvetica, arial"><a href="atom.mock_service.html#MockRequest">MockRequest</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MockHttpResponse">class <strong>MockHttpResponse</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Returned from MockService crud methods as the server's response.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="MockHttpResponse-__init__"><strong>__init__</strong></a>(self, body<font color="#909090">=None</font>, status<font color="#909090">=None</font>, reason<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Construct a mock HTTPResponse and set members.<br>
+ <br>
+Args:<br>
+ body: str (optional) The HTTP body of the server's response. <br>
+ status: int (optional) <br>
+ reason: str (optional)<br>
+ headers: dict (optional)</tt></dd></dl>
+
+<dl><dt><a name="MockHttpResponse-getheader"><strong>getheader</strong></a>(self, header_name)</dt></dl>
+
+<dl><dt><a name="MockHttpResponse-read"><strong>read</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MockRequest">class <strong>MockRequest</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a request made to an AtomPub server.<br>
+ <br>
+These objects are used to determine if a client request matches a recorded<br>
+HTTP request to determine what the mock server's response will be.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="MockRequest-ConcealSecrets"><strong>ConcealSecrets</strong></a>(self, conceal_func)</dt><dd><tt>Conceal secret data in this request.</tt></dd></dl>
+
+<dl><dt><a name="MockRequest-IsMatch"><strong>IsMatch</strong></a>(self, other_request)</dt><dd><tt>Check to see if the other_request is equivalent to this request.<br>
+ <br>
+Used to determine if a recording matches an incoming request so that a<br>
+recorded response should be sent to the client.<br>
+ <br>
+The matching is not exact, only the operation and URL are examined <br>
+currently.<br>
+ <br>
+Args:<br>
+ other_request: <a href="#MockRequest">MockRequest</a> The request which we want to check this<br>
+ (self) <a href="#MockRequest">MockRequest</a> against to see if they are equivalent.</tt></dd></dl>
+
+<dl><dt><a name="MockRequest-__init__"><strong>__init__</strong></a>(self, operation, uri, host<font color="#909090">=None</font>, ssl<font color="#909090">=False</font>, port<font color="#909090">=None</font>, data<font color="#909090">=None</font>, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, content_type<font color="#909090">='application/atom+xml'</font>)</dt><dd><tt>Constructor for a <a href="#MockRequest">MockRequest</a><br>
+ <br>
+Args:<br>
+ operation: str One of 'GET', 'POST', 'PUT', or 'DELETE' this is the<br>
+ HTTP operation requested on the resource.<br>
+ uri: str The URL describing the resource to be modified or feed to be<br>
+ retrieved. This should include the protocol (http/https) and the host<br>
+ (aka domain). For example, these are some valud full_uris:<br>
+ '<a href="http://example.com">http://example.com</a>', 'https://www.google.com/accounts/ClientLogin'<br>
+ host: str (optional) The server name which will be placed at the <br>
+ beginning of the URL if the uri parameter does not begin with 'http'.<br>
+ Examples include 'example.com', 'www.google.com', 'www.blogger.com'.<br>
+ ssl: boolean (optional) If true, the request URL will begin with https <br>
+ instead of http.<br>
+ data: ElementTree, filestream, list of parts, or other <a href="__builtin__.html#object">object</a> which can be<br>
+ converted to a string. (optional)<br>
+ Should be set to None when performing a GET or PUT.<br>
+ If data is a file-like <a href="__builtin__.html#object">object</a> which can be read, the constructor <br>
+ will read the entire file into memory. If the data is a list of <br>
+ parts to be sent, each part will be evaluated and stored.<br>
+ extra_headers: dict (optional) HTTP headers included in the request.<br>
+ url_params: dict (optional) Key value pairs which should be added to <br>
+ the URL as URL parameters in the request. For example uri='/', <br>
+ url_parameters={'foo':'1','bar':'2'} could become '/?foo=1&bar=2'.<br>
+ escape_params: boolean (optional) Perform URL escaping on the keys and <br>
+ values specified in url_params. Defaults to True.<br>
+ content_type: str (optional) Provides the MIME type of the data being <br>
+ sent.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-ConcealValueWithSha"><strong>ConcealValueWithSha</strong></a>(source)</dt></dl>
+ <dl><dt><a name="-DumpRecordings"><strong>DumpRecordings</strong></a>(conceal_func<font color="#909090">=<function ConcealValueWithSha></font>)</dt></dl>
+ <dl><dt><a name="-HttpRequest"><strong>HttpRequest</strong></a>(service, operation, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, content_type<font color="#909090">='application/atom+xml'</font>)</dt><dd><tt>Simulates an HTTP call to the server, makes an actual HTTP request if <br>
+real_request_handler is set.<br>
+ <br>
+This function operates in two different modes depending on if <br>
+real_request_handler is set or not. If real_request_handler is not set,<br>
+HttpRequest will look in this module's recordings list to find a response<br>
+which matches the parameters in the function call. If real_request_handler<br>
+is set, this function will call real_request_handler.HttpRequest, add the<br>
+response to the recordings list, and respond with the actual response.<br>
+ <br>
+Args:<br>
+ service: atom.AtomService <a href="__builtin__.html#object">object</a> which contains some of the parameters<br>
+ needed to make the request. The following members are used to<br>
+ construct the HTTP call: server (str), additional_headers (dict),<br>
+ port (int), and ssl (bool).<br>
+ operation: str The HTTP operation to be performed. This is usually one of<br>
+ 'GET', 'POST', 'PUT', or 'DELETE'<br>
+ data: ElementTree, filestream, list of parts, or other <a href="__builtin__.html#object">object</a> which can be<br>
+ converted to a string.<br>
+ Should be set to None when performing a GET or PUT.<br>
+ If data is a file-like <a href="__builtin__.html#object">object</a> which can be read, this method will read<br>
+ a chunk of 100K bytes at a time and send them.<br>
+ If the data is a list of parts to be sent, each part will be evaluated<br>
+ and sent.<br>
+ uri: The beginning of the URL to which the request should be sent.<br>
+ Examples: '/', '/base/feeds/snippets',<br>
+ '/m8/feeds/contacts/default/base'<br>
+ extra_headers: dict of strings. HTTP headers which should be sent<br>
+ in the request. These headers are in addition to those stored in<br>
+ service.additional_headers.<br>
+ url_params: dict of strings. Key value pairs to be added to the URL as<br>
+ URL parameters. For example {'foo':'bar', 'test':'param'} will<br>
+ become ?foo=bar&test=param.<br>
+ escape_params: bool default True. If true, the keys and values in<br>
+ url_params will be URL escaped when the form is constructed<br>
+ (Special characters converted to %XX form.)<br>
+ content_type: str The MIME type for the data being sent. Defaults to<br>
+ 'application/atom+xml', this is only used if data is set.</tt></dd></dl>
+ <dl><dt><a name="-LoadRecordings"><strong>LoadRecordings</strong></a>(recordings_file_or_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'api.jscudder (Jeffrey Scudder)'<br>
+<strong>real_request_handler</strong> = None<br>
+<strong>recordings</strong> = []</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeffrey Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.service.html b/pydocs/atom.service.html
new file mode 100644
index 0000000..5ef7b10
--- /dev/null
+++ b/pydocs/atom.service.html
@@ -0,0 +1,398 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/service.py</a></font></td></tr></table>
+ <p><tt><a href="#AtomService">AtomService</a> provides CRUD ops. in line with the Atom Publishing Protocol.<br>
+ <br>
+<a href="#AtomService">AtomService</a>: Encapsulates the ability to perform insert, update and delete<br>
+ operations with the Atom Publishing Protocol on which GData is<br>
+ based. An instance can perform query, insertion, deletion, and<br>
+ update.<br>
+ <br>
+HttpRequest: Function that performs a GET, POST, PUT, or DELETE HTTP request<br>
+ to the specified end point. An <a href="#AtomService">AtomService</a> <a href="__builtin__.html#object">object</a> or a subclass can be<br>
+ used to specify information about the request.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="xml.etree.cElementTree.html">xml.etree.cElementTree</a><br>
+<a href="atom.html">atom</a><br>
+<a href="base64.html">base64</a><br>
+</td><td width="25%" valign=top><a href="httplib.html">httplib</a><br>
+<a href="os.html">os</a><br>
+<a href="re.html">re</a><br>
+</td><td width="25%" valign=top><a href="socket.html">socket</a><br>
+<a href="urllib.html">urllib</a><br>
+<a href="warnings.html">warnings</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.service.html#AtomService">AtomService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.service.html#BasicAuthToken">BasicAuthToken</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AtomService">class <strong>AtomService</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Performs Atom Publishing Protocol CRUD operations.<br>
+ <br>
+The <a href="#AtomService">AtomService</a> contains methods to perform HTTP CRUD operations.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="AtomService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ httplib.HTTPResponse Server's response to the DELETE request.</tt></dd></dl>
+
+<dl><dt><a name="AtomService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Query the APP server with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(server example: 'www.google.com').<br>
+ <br>
+Example use:<br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dicty (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the query. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ httplib.HTTPResponse The server's response to the GET request.</tt></dd></dl>
+
+<dl><dt><a name="AtomService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, content_type<font color="#909090">='application/atom+xml'</font>)</dt><dd><tt>Insert data into an APP server at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or something with a __str__ method <br>
+ The XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ httplib.HTTPResponse Server's response to the POST request.</tt></dd></dl>
+
+<dl><dt><a name="AtomService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, content_type<font color="#909090">='application/atom+xml'</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ httplib.HTTPResponse Server's response to the PUT request.</tt></dd></dl>
+
+<dl><dt><a name="AtomService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="AtomService-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="AtomService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="AtomService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BasicAuthToken">class <strong>BasicAuthToken</strong></a>(<a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="atom.service.html#BasicAuthToken">BasicAuthToken</a></dd>
+<dd><a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BasicAuthToken-__init__"><strong>__init__</strong></a>(self, auth_header, scopes<font color="#909090">=None</font>)</dt><dd><tt>Creates a token used to add Basic Auth headers to HTTP requests.<br>
+ <br>
+Args:<br>
+ auth_header: str The value for the Authorization header.<br>
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs<br>
+ for which this token can be used. For example, if scopes contains<br>
+ '<a href="http://example.com/foo">http://example.com/foo</a>', then this token can be used for a request to<br>
+ '<a href="http://example.com/foo/bar">http://example.com/foo/bar</a>' but it cannot be used for a request to<br>
+ '<a href="http://example.com/baz">http://example.com/baz</a>'</tt></dd></dl>
+
+<dl><dt><a name="BasicAuthToken-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BasicAuthToken-perform_request"><strong>perform_request</strong></a>(self, http_client, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Sets the Authorization header to the basic auth string.</tt></dd></dl>
+
+<dl><dt><a name="BasicAuthToken-valid_for_scope"><strong>valid_for_scope</strong></a>(self, url)</dt><dd><tt>Tells the caller if the token authorizes access to the desired URL.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-BuildUri"><strong>BuildUri</strong></a>(uri, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Converts a uri string and a collection of parameters into a URI.<br>
+ <br>
+This function is deprcated, use atom.url.Url instead.<br>
+ <br>
+Args:<br>
+ uri: string<br>
+ url_params: dict (optional)<br>
+ escape_params: boolean (optional)<br>
+ uri: string The start of the desired URI. This string can alrady contain<br>
+ URL parameters. Examples: '/base/feeds/snippets', <br>
+ '/base/feeds/snippets?bq=digital+camera'<br>
+ url_parameters: dict (optional) Additional URL parameters to be included<br>
+ in the query. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ string The URI consisting of the escaped URL parameters appended to the<br>
+ initial uri string.</tt></dd></dl>
+ <dl><dt><a name="-CalculateDataLength"><strong>CalculateDataLength</strong></a>(data)</dt><dd><tt>Attempts to determine the length of the data to send. <br>
+ <br>
+This method will respond with a length only if the data is a string or<br>
+and ElementTree element.<br>
+ <br>
+Args:<br>
+ data: <a href="__builtin__.html#object">object</a> If this is not a string or ElementTree element this funtion<br>
+ will return None.</tt></dd></dl>
+ <dl><dt><a name="-DictionaryToParamList"><strong>DictionaryToParamList</strong></a>(url_parameters, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Convert a dictionary of URL arguments into a URL parameter string.<br>
+ <br>
+This function is deprcated, use atom.url.Url instead.<br>
+ <br>
+Args:<br>
+ url_parameters: The dictionaty of key-value pairs which will be converted<br>
+ into URL parameters. For example,<br>
+ {'dry-run': 'true', 'foo': 'bar'}<br>
+ will become ['dry-run=true', 'foo=bar'].<br>
+ <br>
+Returns:<br>
+ A list which contains a string for each key-value pair. The strings are<br>
+ ready to be incorporated into a URL by using '&'.join([] + parameter_list)</tt></dd></dl>
+ <dl><dt><a name="-HttpRequest"><strong>HttpRequest</strong></a>(service, operation, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, content_type<font color="#909090">='application/atom+xml'</font>)</dt><dd><tt>Performs an HTTP call to the server, supports GET, POST, PUT, and DELETE.<br>
+ <br>
+This method is deprecated, use atom.http.HttpClient.request instead.<br>
+ <br>
+Usage example, perform and HTTP GET on <a href="http://www.google.com/">http://www.google.com/</a>:<br>
+ import atom.service<br>
+ client = atom.service.<a href="#AtomService">AtomService</a>()<br>
+ http_response = client.Get('<a href="http://www.google.com/">http://www.google.com/</a>')<br>
+or you could set the client.server to 'www.google.com' and use the <br>
+following:<br>
+ client.server = 'www.google.com'<br>
+ http_response = client.Get('/')<br>
+ <br>
+Args:<br>
+ service: atom.<a href="#AtomService">AtomService</a> <a href="__builtin__.html#object">object</a> which contains some of the parameters <br>
+ needed to make the request. The following members are used to <br>
+ construct the HTTP call: server (str), additional_headers (dict), <br>
+ port (int), and ssl (bool).<br>
+ operation: str The HTTP operation to be performed. This is usually one of<br>
+ 'GET', 'POST', 'PUT', or 'DELETE'<br>
+ data: ElementTree, filestream, list of parts, or other <a href="__builtin__.html#object">object</a> which can be <br>
+ converted to a string. <br>
+ Should be set to None when performing a GET or PUT.<br>
+ If data is a file-like <a href="__builtin__.html#object">object</a> which can be read, this method will read<br>
+ a chunk of 100K bytes at a time and send them. <br>
+ If the data is a list of parts to be sent, each part will be evaluated<br>
+ and sent.<br>
+ uri: The beginning of the URL to which the request should be sent. <br>
+ Examples: '/', '/base/feeds/snippets', <br>
+ '/m8/feeds/contacts/default/base'<br>
+ extra_headers: dict of strings. HTTP headers which should be sent<br>
+ in the request. These headers are in addition to those stored in <br>
+ service.additional_headers.<br>
+ url_params: dict of strings. Key value pairs to be added to the URL as<br>
+ URL parameters. For example {'foo':'bar', 'test':'param'} will <br>
+ become ?foo=bar&test=param.<br>
+ escape_params: bool default True. If true, the keys and values in <br>
+ url_params will be URL escaped when the form is constructed <br>
+ (Special characters converted to %XX form.)<br>
+ content_type: str The MIME type for the data being sent. Defaults to<br>
+ 'application/atom+xml', this is only used if data is set.</tt></dd></dl>
+ <dl><dt><a name="-PrepareConnection"><strong>PrepareConnection</strong></a>(service, full_uri)</dt><dd><tt>Opens a connection to the server based on the full URI.<br>
+ <br>
+This method is deprecated, instead use atom.http.HttpClient.request.<br>
+ <br>
+Examines the target URI and the proxy settings, which are set as<br>
+environment variables, to open a connection with the server. This<br>
+connection is used to make an HTTP request.<br>
+ <br>
+Args:<br>
+ service: atom.<a href="#AtomService">AtomService</a> or a subclass. It must have a server string which<br>
+ represents the server host to which the request should be made. It may also<br>
+ have a dictionary of additional_headers to send in the HTTP request.<br>
+ full_uri: str Which is the target relative (lacks protocol and host) or<br>
+ absolute URL to be opened. Example:<br>
+ 'https://www.google.com/accounts/ClientLogin' or<br>
+ 'base/feeds/snippets' where the server is set to www.google.com.<br>
+ <br>
+Returns:<br>
+ A tuple containing the httplib.HTTPConnection and the full_uri for the<br>
+ request.</tt></dd></dl>
+ <dl><dt><a name="-ProcessUrl"><strong>ProcessUrl</strong></a>(service, url, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Processes a passed URL. If the URL does not begin with https?, then<br>
+the default value for server is used<br>
+ <br>
+This method is deprecated, use atom.url.parse_url instead.</tt></dd></dl>
+ <dl><dt><a name="-UseBasicAuth"><strong>UseBasicAuth</strong></a>(service, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use <a href="#AtomService">AtomService</a>.use_basic_auth insread.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext. The auth header is added to the <br>
+additional_headers dictionary in the service <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+Args:<br>
+ service: atom.<a href="#AtomService">AtomService</a> or a subclass which has an <br>
+ additional_headers dict as a member.<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+ <dl><dt><a name="-deprecation"><strong>deprecation</strong></a>(message)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'api.jscudder (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.token_store.html b/pydocs/atom.token_store.html
new file mode 100644
index 0000000..190bce7
--- /dev/null
+++ b/pydocs/atom.token_store.html
@@ -0,0 +1,119 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.token_store</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.token_store</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/token_store.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/token_store.py</a></font></td></tr></table>
+ <p><tt>This module provides a <a href="#TokenStore">TokenStore</a> class which is designed to manage<br>
+auth tokens required for different services.<br>
+ <br>
+Each token is valid for a set of scopes which is the start of a URL. An HTTP<br>
+client will use a token store to find a valid Authorization header to send<br>
+in requests to the specified URL. If the HTTP client determines that a token<br>
+has expired or been revoked, it can remove the token from the store so that<br>
+it will not be used in future requests.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.token_store.html#TokenStore">TokenStore</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TokenStore">class <strong>TokenStore</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Manages Authorization tokens which will be sent in HTTP headers.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="TokenStore-__init__"><strong>__init__</strong></a>(self, scoped_tokens<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="TokenStore-add_token"><strong>add_token</strong></a>(self, token)</dt><dd><tt>Adds a new token to the store (replaces tokens with the same scope).<br>
+ <br>
+Args:<br>
+ token: A subclass of http_interface.GenericToken. The token <a href="__builtin__.html#object">object</a> is <br>
+ responsible for adding the Authorization header to the HTTP request.<br>
+ The scopes defined in the token are used to determine if the token<br>
+ is valid for a requested scope when find_token is called.<br>
+ <br>
+Returns:<br>
+ True if the token was added, False if the token was not added becase<br>
+ no scopes were provided.</tt></dd></dl>
+
+<dl><dt><a name="TokenStore-find_token"><strong>find_token</strong></a>(self, url)</dt><dd><tt>Selects an Authorization header token which can be used for the URL.<br>
+ <br>
+Args:<br>
+ url: str or atom.url.Url or a list containing the same.<br>
+ The URL which is going to be requested. All<br>
+ tokens are examined to see if any scopes begin match the beginning<br>
+ of the URL. The first match found is returned.<br>
+ <br>
+Returns:<br>
+ The token <a href="__builtin__.html#object">object</a> which should execute the HTTP request. If there was<br>
+ no token for the url (the url did not begin with any of the token<br>
+ scopes available), then the atom.http_interface.GenericToken will be <br>
+ returned because the GenericToken calls through to the http client<br>
+ without adding an Authorization header.</tt></dd></dl>
+
+<dl><dt><a name="TokenStore-remove_all_tokens"><strong>remove_all_tokens</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TokenStore-remove_token"><strong>remove_token</strong></a>(self, token)</dt><dd><tt>Removes the token from the token_store.<br>
+ <br>
+This method is used when a token is determined to be invalid. If the<br>
+token was found by find_token, but resulted in a 401 or 403 error stating<br>
+that the token was invlid, then the token should be removed to prevent<br>
+future use.<br>
+ <br>
+Returns:<br>
+ True if a token was found and then removed from the token<br>
+ store. False if the token was not in the <a href="#TokenStore">TokenStore</a>.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>SCOPE_ALL</strong> = 'http'<br>
+<strong>__author__</strong> = 'api.jscudder (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/atom.url.html b/pydocs/atom.url.html
new file mode 100644
index 0000000..15242ac
--- /dev/null
+++ b/pydocs/atom.url.html
@@ -0,0 +1,112 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module atom.url</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="atom.html"><font color="#ffffff">atom</font></a>.url</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/url.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/atom/url.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2008 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top><a href="urlparse.html">urlparse</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="atom.url.html#Url">Url</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Url">class <strong>Url</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a URL and implements comparison logic.<br>
+ <br>
+URL strings which are not identical can still be equivalent, so this <a href="__builtin__.html#object">object</a><br>
+provides a better interface for comparing and manipulating URLs than <br>
+strings. URL parameters are represented as a dictionary of strings, and<br>
+defaults are used for the protocol (http) and port (80) if not provided.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Url-__cmp__"><strong>__cmp__</strong></a>(self, other)</dt></dl>
+
+<dl><dt><a name="Url-__init__"><strong>__init__</strong></a>(self, protocol<font color="#909090">=None</font>, host<font color="#909090">=None</font>, port<font color="#909090">=None</font>, path<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Url-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Url-get_param_string"><strong>get_param_string</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Url-get_request_uri"><strong>get_request_uri</strong></a>(self)</dt><dd><tt>Returns the path with the parameters escaped and appended.</tt></dd></dl>
+
+<dl><dt><a name="Url-to_string"><strong>to_string</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-parse_url"><strong>parse_url</strong></a>(url_string)</dt><dd><tt>Creates a <a href="#Url">Url</a> <a href="__builtin__.html#object">object</a> which corresponds to the URL string.<br>
+ <br>
+This method can accept partial URLs, but it will leave missing<br>
+members of the <a href="#Url">Url</a> unset.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DEFAULT_PORT</strong> = 80<br>
+<strong>DEFAULT_PROTOCOL</strong> = 'http'<br>
+<strong>__author__</strong> = 'api.jscudder (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Cipher.html b/pydocs/gdata.Crypto.Cipher.html
new file mode 100644
index 0000000..7639993
--- /dev/null
+++ b/pydocs/gdata.Crypto.Cipher.html
@@ -0,0 +1,51 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.Crypto.Cipher</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.Cipher</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Cipher/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Cipher/__init__.py</a></font></td></tr></table>
+ <p><tt>Secret-key encryption algorithms.<br>
+ <br>
+Secret-key encryption algorithms transform plaintext in some way that<br>
+is dependent on a key, producing ciphertext. This transformation can<br>
+easily be reversed, if (and, hopefully, only if) one knows the key.<br>
+ <br>
+The encryption modules here all support the interface described in PEP<br>
+272, "API for Block Encryption Algorithms".<br>
+ <br>
+If you don't know which algorithm to choose, use AES because it's<br>
+standard and has undergone a fair bit of examination.<br>
+ <br>
+Crypto.Cipher.AES Advanced Encryption Standard<br>
+Crypto.Cipher.ARC2 Alleged RC2<br>
+Crypto.Cipher.ARC4 Alleged RC4<br>
+Crypto.Cipher.Blowfish<br>
+Crypto.Cipher.CAST<br>
+Crypto.Cipher.DES The Data Encryption Standard. Very commonly used<br>
+ in the past, but today its 56-bit keys are too small.<br>
+Crypto.Cipher.DES3 Triple DES.<br>
+Crypto.Cipher.IDEA<br>
+Crypto.Cipher.RC5<br>
+Crypto.Cipher.XOR The simple XOR cipher.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__all__</strong> = ['AES', 'ARC2', 'ARC4', 'Blowfish', 'CAST', 'DES', 'DES3', 'IDEA', 'RC5', 'XOR']<br>
+<strong>__revision__</strong> = '$Id: __init__.py,v 1.7 2003/02/28 15:28:35 akuchling Exp $'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Hash.HMAC.html b/pydocs/gdata.Crypto.Hash.HMAC.html
new file mode 100644
index 0000000..6f3ffb6
--- /dev/null
+++ b/pydocs/gdata.Crypto.Hash.HMAC.html
@@ -0,0 +1,93 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.Hash.HMAC</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.Hash.html"><font color="#ffffff">Hash</font></a>.HMAC</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Hash/HMAC.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Hash/HMAC.py</a></font></td></tr></table>
+ <p><tt><a href="#HMAC">HMAC</a> (Keyed-Hashing for Message Authentication) Python module.<br>
+ <br>
+Implements the <a href="#HMAC">HMAC</a> algorithm as described by <a href="http://www.rfc-editor.org/rfc/rfc2104.txt">RFC 2104</a>.<br>
+ <br>
+This is just a copy of the Python 2.2 <a href="#HMAC">HMAC</a> module, modified to work when<br>
+used on versions of Python before 2.2.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="string.html">string</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.Hash.HMAC.html#HMAC">HMAC</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HMAC">class <strong>HMAC</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="http://www.rfc-editor.org/rfc/rfc2104.txt">RFC2104</a> <a href="#HMAC">HMAC</a> class.<br>
+ <br>
+This supports the API for Cryptographic Hash Functions (<a href="http://www.python.org/dev/peps/pep-0247/">PEP 247</a>).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="HMAC-__init__"><strong>__init__</strong></a>(self, key, msg<font color="#909090">=None</font>, digestmod<font color="#909090">=None</font>)</dt><dd><tt>Create a new <a href="#HMAC">HMAC</a> object.<br>
+ <br>
+key: key for the keyed hash object.<br>
+msg: Initial input for the hash, if provided.<br>
+digestmod: A module supporting <a href="http://www.python.org/dev/peps/pep-0247/">PEP 247</a>. Defaults to the md5 module.</tt></dd></dl>
+
+<dl><dt><a name="HMAC-copy"><strong>copy</strong></a>(self)</dt><dd><tt>Return a separate copy of this hashing object.<br>
+ <br>
+An update to this copy won't affect the original object.</tt></dd></dl>
+
+<dl><dt><a name="HMAC-digest"><strong>digest</strong></a>(self)</dt><dd><tt>Return the hash value of this hashing object.<br>
+ <br>
+This returns a string containing 8-bit data. The object is<br>
+not altered in any way by this function; you can continue<br>
+updating the object after calling this function.</tt></dd></dl>
+
+<dl><dt><a name="HMAC-hexdigest"><strong>hexdigest</strong></a>(self)</dt><dd><tt>Like <a href="#HMAC-digest">digest</a>(), but returns a string of hexadecimal digits instead.</tt></dd></dl>
+
+<dl><dt><a name="HMAC-update"><strong>update</strong></a>(self, msg)</dt><dd><tt>Update this hashing object with the string msg.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-new"><strong>new</strong></a>(key, msg<font color="#909090">=None</font>, digestmod<font color="#909090">=None</font>)</dt><dd><tt>Create a new hashing object and return it.<br>
+ <br>
+key: The starting key for the hash.<br>
+msg: if available, will immediately be hashed into the object's starting<br>
+state.<br>
+ <br>
+You can now feed arbitrary strings into the object using its update()<br>
+method, and can ask for the hash value at any time by calling its digest()<br>
+method.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__revision__</strong> = '$Id: HMAC.py,v 1.5 2002/07/25 17:19:02 z3p Exp $'<br>
+<strong>digest_size</strong> = None</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Hash.MD5.html b/pydocs/gdata.Crypto.Hash.MD5.html
new file mode 100644
index 0000000..326e328
--- /dev/null
+++ b/pydocs/gdata.Crypto.Hash.MD5.html
@@ -0,0 +1,40 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.Hash.MD5</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.Hash.html"><font color="#ffffff">Hash</font></a>.MD5</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Hash/MD5.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Hash/MD5.py</a></font></td></tr></table>
+ <p><tt># Just use the MD5 module from the Python standard library</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="warnings.html">warnings</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-new"><strong>new</strong></a> = openssl_md5(...)</dt><dd><tt>Returns a md5 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__revision__</strong> = '$Id: MD5.py,v 1.4 2002/07/11 14:31:19 akuchling Exp $'<br>
+<strong>__warningregistry__</strong> = {('the md5 module is deprecated; use hashlib instead', <type 'exceptions.DeprecationWarning'>, 6): True}<br>
+<strong>blocksize</strong> = 1<br>
+<strong>digest_size</strong> = 16</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Hash.SHA.html b/pydocs/gdata.Crypto.Hash.SHA.html
new file mode 100644
index 0000000..fb6a280
--- /dev/null
+++ b/pydocs/gdata.Crypto.Hash.SHA.html
@@ -0,0 +1,40 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.Hash.SHA</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.Hash.html"><font color="#ffffff">Hash</font></a>.SHA</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Hash/SHA.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Hash/SHA.py</a></font></td></tr></table>
+ <p><tt># Just use the SHA module from the Python standard library</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="warnings.html">warnings</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-new"><strong>new</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__revision__</strong> = '$Id: SHA.py,v 1.4 2002/07/11 14:31:19 akuchling Exp $'<br>
+<strong>__warningregistry__</strong> = {('the sha module is deprecated; use the hashlib module instead', <type 'exceptions.DeprecationWarning'>, 6): True}<br>
+<strong>blocksize</strong> = 1<br>
+<strong>digest_size</strong> = 20</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Hash.html b/pydocs/gdata.Crypto.Hash.html
new file mode 100644
index 0000000..3aa4b0b
--- /dev/null
+++ b/pydocs/gdata.Crypto.Hash.html
@@ -0,0 +1,50 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.Crypto.Hash</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.Hash</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Hash/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Hash/__init__.py</a></font></td></tr></table>
+ <p><tt>Hashing algorithms<br>
+ <br>
+Hash functions take arbitrary strings as input, and produce an output<br>
+of fixed size that is dependent on the input; it should never be<br>
+possible to derive the input data given only the hash function's<br>
+output. Hash functions can be used simply as a checksum, or, in<br>
+association with a public-key algorithm, can be used to implement<br>
+digital signatures.<br>
+ <br>
+The hashing modules here all support the interface described in PEP<br>
+247, "API for Cryptographic Hash Functions".<br>
+ <br>
+Submodules:<br>
+Crypto.Hash.HMAC <a href="http://www.rfc-editor.org/rfc/rfc2104.txt">RFC 2104</a>: Keyed-Hashing for Message Authentication<br>
+Crypto.Hash.MD2<br>
+Crypto.Hash.MD4<br>
+Crypto.Hash.MD5<br>
+Crypto.Hash.RIPEMD<br>
+Crypto.Hash.SHA</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.Crypto.Hash.HMAC.html">HMAC</a><br>
+</td><td width="25%" valign=top><a href="gdata.Crypto.Hash.MD5.html">MD5</a><br>
+</td><td width="25%" valign=top><a href="gdata.Crypto.Hash.SHA.html">SHA</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__all__</strong> = ['HMAC', 'MD2', 'MD4', 'MD5', 'RIPEMD', 'SHA', 'SHA256']<br>
+<strong>__revision__</strong> = '$Id: __init__.py,v 1.6 2003/12/19 14:24:25 akuchling Exp $'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Protocol.AllOrNothing.html b/pydocs/gdata.Crypto.Protocol.AllOrNothing.html
new file mode 100644
index 0000000..f7b9e9e
--- /dev/null
+++ b/pydocs/gdata.Crypto.Protocol.AllOrNothing.html
@@ -0,0 +1,98 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.Protocol.AllOrNothing</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.Protocol.html"><font color="#ffffff">Protocol</font></a>.AllOrNothing</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Protocol/AllOrNothing.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Protocol/AllOrNothing.py</a></font></td></tr></table>
+ <p><tt>This file implements all-or-nothing package transformations.<br>
+ <br>
+An all-or-nothing package transformation is one in which some text is<br>
+transformed into message blocks, such that all blocks must be obtained before<br>
+the reverse transformation can be applied. Thus, if any blocks are corrupted<br>
+or lost, the original message cannot be reproduced.<br>
+ <br>
+An all-or-nothing package transformation is not encryption, although a block<br>
+cipher algorithm is used. The encryption key is randomly generated and is<br>
+extractable from the message blocks.<br>
+ <br>
+This class implements the All-Or-Nothing package transformation algorithm<br>
+described in:<br>
+ <br>
+Ronald L. Rivest. "All-Or-Nothing Encryption and The Package Transform"<br>
+<a href="http://theory.lcs.mit.edu/~rivest/fusion.pdf">http://theory.lcs.mit.edu/~rivest/fusion.pdf</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="operator.html">operator</a><br>
+</td><td width="25%" valign=top><a href="string.html">string</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.Protocol.AllOrNothing.html#AllOrNothing">AllOrNothing</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AllOrNothing">class <strong>AllOrNothing</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Class implementing the All-or-Nothing package transform.<br>
+ <br>
+Methods for subclassing:<br>
+ <br>
+ _inventkey(key_size):<br>
+ Returns a randomly generated key. Subclasses can use this to<br>
+ implement better random key generating algorithms. The default<br>
+ algorithm is probably not very cryptographically secure.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="AllOrNothing-__init__"><strong>__init__</strong></a>(self, ciphermodule, mode<font color="#909090">=None</font>, IV<font color="#909090">=None</font>)</dt><dd><tt><a href="#AllOrNothing">AllOrNothing</a>(ciphermodule, mode=None, IV=None)<br>
+ <br>
+ciphermodule is a module implementing the cipher algorithm to<br>
+use. It must provide the <a href="http://www.python.org/dev/peps/pep-0272/">PEP272</a> interface.<br>
+ <br>
+Note that the encryption key is randomly generated<br>
+automatically when needed. Optional arguments mode and IV are<br>
+passed directly through to the ciphermodule.new() method; they<br>
+are the feedback mode and initialization vector to use. All<br>
+three arguments must be the same for the object used to create<br>
+the digest, and to undigest'ify the message blocks.</tt></dd></dl>
+
+<dl><dt><a name="AllOrNothing-digest"><strong>digest</strong></a>(self, text)</dt><dd><tt><a href="#AllOrNothing-digest">digest</a>(text:string) : [string]<br>
+ <br>
+Perform the All-or-Nothing package transform on the given<br>
+string. Output is a list of message blocks describing the<br>
+transformed text, where each block is a string of bit length equal<br>
+to the ciphermodule's block_size.</tt></dd></dl>
+
+<dl><dt><a name="AllOrNothing-undigest"><strong>undigest</strong></a>(self, blocks)</dt><dd><tt><a href="#AllOrNothing-undigest">undigest</a>(blocks : [string]) : string<br>
+ <br>
+Perform the reverse package transformation on a list of message<br>
+blocks. Note that the ciphermodule used for both transformations<br>
+must be the same. blocks is a list of strings of bit length<br>
+equal to the ciphermodule's block_size.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__revision__</strong> = '$Id: AllOrNothing.py,v 1.8 2003/02/28 15:23:20 akuchling Exp $'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Protocol.Chaffing.html b/pydocs/gdata.Crypto.Protocol.Chaffing.html
new file mode 100644
index 0000000..e7fb8ea
--- /dev/null
+++ b/pydocs/gdata.Crypto.Protocol.Chaffing.html
@@ -0,0 +1,125 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.Protocol.Chaffing</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.Protocol.html"><font color="#ffffff">Protocol</font></a>.Chaffing</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Protocol/Chaffing.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Protocol/Chaffing.py</a></font></td></tr></table>
+ <p><tt>This file implements the chaffing algorithm.<br>
+ <br>
+Winnowing and chaffing is a technique for enhancing privacy without requiring<br>
+strong encryption. In short, the technique takes a set of authenticated<br>
+message blocks (the wheat) and adds a number of chaff blocks which have<br>
+randomly chosen data and MAC fields. This means that to an adversary, the<br>
+chaff blocks look as valid as the wheat blocks, and so the authentication<br>
+would have to be performed on every block. By tailoring the number of chaff<br>
+blocks added to the message, the sender can make breaking the message<br>
+computationally infeasible. There are many other interesting properties of<br>
+the winnow/chaff technique.<br>
+ <br>
+For example, say Alice is sending a message to Bob. She packetizes the<br>
+message and performs an all-or-nothing transformation on the packets. Then<br>
+she authenticates each packet with a message authentication code (MAC). The<br>
+MAC is a hash of the data packet, and there is a secret key which she must<br>
+share with Bob (key distribution is an exercise left to the reader). She then<br>
+adds a serial number to each packet, and sends the packets to Bob.<br>
+ <br>
+Bob receives the packets, and using the shared secret authentication key,<br>
+authenticates the MACs for each packet. Those packets that have bad MACs are<br>
+simply discarded. The remainder are sorted by serial number, and passed<br>
+through the reverse all-or-nothing transform. The transform means that an<br>
+eavesdropper (say Eve) must acquire all the packets before any of the data can<br>
+be read. If even one packet is missing, the data is useless.<br>
+ <br>
+There's one twist: by adding chaff packets, Alice and Bob can make Eve's job<br>
+much harder, since Eve now has to break the shared secret key, or try every<br>
+combination of wheat and chaff packet to read any of the message. The cool<br>
+thing is that Bob doesn't need to add any additional code; the chaff packets<br>
+are already filtered out because their MACs don't match (in all likelihood --<br>
+since the data and MACs for the chaff packets are randomly chosen it is<br>
+possible, but very unlikely that a chaff MAC will match the chaff data). And<br>
+Alice need not even be the party adding the chaff! She could be completely<br>
+unaware that a third party, say Charles, is adding chaff packets to her<br>
+messages as they are transmitted.<br>
+ <br>
+For more information on winnowing and chaffing see this paper:<br>
+ <br>
+Ronald L. Rivest, "Chaffing and Winnowing: Confidentiality without Encryption"<br>
+<a href="http://theory.lcs.mit.edu/~rivest/chaffing.txt">http://theory.lcs.mit.edu/~rivest/chaffing.txt</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.Protocol.Chaffing.html#Chaff">Chaff</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Chaff">class <strong>Chaff</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Class implementing the chaff adding algorithm.<br>
+ <br>
+Methods for subclasses:<br>
+ <br>
+ _randnum(size):<br>
+ Returns a randomly generated number with a byte-length equal<br>
+ to size. Subclasses can use this to implement better random<br>
+ data and MAC generating algorithms. The default algorithm is<br>
+ probably not very cryptographically secure. It is most<br>
+ important that the chaff data does not contain any patterns<br>
+ that can be used to discern it from wheat data without running<br>
+ the MAC.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Chaff-__init__"><strong>__init__</strong></a>(self, factor<font color="#909090">=1.0</font>, blocksper<font color="#909090">=1</font>)</dt><dd><tt><a href="#Chaff">Chaff</a>(factor:float, blocksper:int)<br>
+ <br>
+factor is the number of message blocks to add chaff to,<br>
+expressed as a percentage between 0.0 and 1.0. blocksper is<br>
+the number of chaff blocks to include for each block being<br>
+chaffed. Thus the defaults add one chaff block to every<br>
+message block. By changing the defaults, you can adjust how<br>
+computationally difficult it could be for an adversary to<br>
+brute-force crack the message. The difficulty is expressed<br>
+as:<br>
+ <br>
+ pow(blocksper, int(factor * number-of-blocks))<br>
+ <br>
+For ease of implementation, when factor < 1.0, only the first<br>
+int(factor*number-of-blocks) message blocks are chaffed.</tt></dd></dl>
+
+<dl><dt><a name="Chaff-chaff"><strong>chaff</strong></a>(self, blocks)</dt><dd><tt><a href="#Chaff-chaff">chaff</a>( [(serial-number:int, data:string, MAC:string)] )<br>
+: [(int, string, string)]<br>
+ <br>
+Add chaff to message blocks. blocks is a list of 3-tuples of the<br>
+form (serial-number, data, MAC).<br>
+ <br>
+<a href="#Chaff">Chaff</a> is created by choosing a random number of the same<br>
+byte-length as data, and another random number of the same<br>
+byte-length as MAC. The message block's serial number is<br>
+placed on the chaff block and all the packet's chaff blocks<br>
+are randomly interspersed with the single wheat block. This<br>
+method then returns a list of 3-tuples of the same form.<br>
+Chaffed blocks will contain multiple instances of 3-tuples<br>
+with the same serial number, but the only way to figure out<br>
+which blocks are wheat and which are chaff is to perform the<br>
+MAC hash and compare values.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__revision__</strong> = '$Id: Chaffing.py,v 1.7 2003/02/28 15:23:21 akuchling Exp $'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Protocol.html b/pydocs/gdata.Crypto.Protocol.html
new file mode 100644
index 0000000..aa3952e
--- /dev/null
+++ b/pydocs/gdata.Crypto.Protocol.html
@@ -0,0 +1,42 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.Crypto.Protocol</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.Protocol</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Protocol/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Protocol/__init__.py</a></font></td></tr></table>
+ <p><tt>Cryptographic protocols<br>
+ <br>
+Implements various cryptographic protocols. (Don't expect to find<br>
+network protocols here.)<br>
+ <br>
+Crypto.Protocol.AllOrNothing Transforms a message into a set of message<br>
+ blocks, such that the blocks can be<br>
+ recombined to get the message back.<br>
+ <br>
+Crypto.Protocol.Chaffing Takes a set of authenticated message blocks<br>
+ (the wheat) and adds a number of<br>
+ randomly generated blocks (the chaff).</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.Crypto.Protocol.AllOrNothing.html">AllOrNothing</a><br>
+</td><td width="25%" valign=top><a href="gdata.Crypto.Protocol.Chaffing.html">Chaffing</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__all__</strong> = ['AllOrNothing', 'Chaffing']<br>
+<strong>__revision__</strong> = '$Id: __init__.py,v 1.4 2003/02/28 15:23:21 akuchling Exp $'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.PublicKey.DSA.html b/pydocs/gdata.Crypto.PublicKey.DSA.html
new file mode 100644
index 0000000..a62d6ba
--- /dev/null
+++ b/pydocs/gdata.Crypto.PublicKey.DSA.html
@@ -0,0 +1,355 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.PublicKey.DSA</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.PublicKey.html"><font color="#ffffff">PublicKey</font></a>.DSA</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/DSA.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/DSA.py</a></font></td></tr></table>
+ <p><tt># DSA.py : Digital Signature Algorithm<br>
+#<br>
+# Part of the Python Cryptography Toolkit<br>
+#<br>
+# Distribute and use freely; there are no restrictions on further<br>
+# dissemination and usage except those imposed by the laws of your<br>
+# country of residence. This software is provided "as is" without<br>
+# warranty of fitness for use or suitability for any purpose, express<br>
+# or implied. Use at your own risk or not at all.<br>
+#</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.Hash.SHA.html">Crypto.Hash.SHA</a><br>
+<a href="Crypto.PublicKey._fastmath.html">Crypto.PublicKey._fastmath</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="Crypto.Util.number.html">Crypto.Util.number</a><br>
+</td><td width="25%" valign=top><a href="struct.html">struct</a><br>
+<a href="sys.html">sys</a><br>
+</td><td width="25%" valign=top><a href="types.html">types</a><br>
+<a href="warnings.html">warnings</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.DSA.html#DSAobj">DSAobj</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.DSA.html#DSAobj">DSAobj</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.DSA.html#DSAobj_c">DSAobj_c</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial">_fastmath.error
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DSAobj">class <strong>DSAobj</strong></a>(<a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="DSAobj-can_encrypt"><strong>can_encrypt</strong></a>(self)</dt><dd><tt>Return a Boolean value recording whether this algorithm can encrypt data.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-can_sign"><strong>can_sign</strong></a>(self)</dt><dd><tt>Return a Boolean value recording whether this algorithm can generate signatures.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-has_private"><strong>has_private</strong></a>(self)</dt><dd><tt>Return a Boolean denoting whether the <a href="#object">object</a> contains<br>
+private components.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-publickey"><strong>publickey</strong></a>(self)</dt><dd><tt>Return a new key <a href="#object">object</a> containing only the public information.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-size"><strong>size</strong></a>(self)</dt><dd><tt>Return the maximum number of bits that can be handled by this key.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>keydata</strong> = ['y', 'g', 'p', 'q', 'x']</dl>
+
+<hr>
+Methods inherited from <a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>:<br>
+<dl><dt><a name="DSAobj-__eq__"><strong>__eq__</strong></a>(self, other)</dt><dd><tt><a href="#DSAobj-__eq__">__eq__</a>(other): 0, 1<br>
+Compare us to other for equality.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-__getstate__"><strong>__getstate__</strong></a>(self)</dt><dd><tt>To keep key objects platform-independent, the key data is<br>
+converted to standard Python long integers before being<br>
+written out. It will then be reconverted as necessary on<br>
+restoration.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DSAobj-__ne__"><strong>__ne__</strong></a>(self, other)</dt><dd><tt><a href="#DSAobj-__ne__">__ne__</a>(other): 0, 1<br>
+Compare us to other for inequality.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-__setstate__"><strong>__setstate__</strong></a>(self, d)</dt><dd><tt>On unpickling a key <a href="#object">object</a>, the key data is converted to the big<br>
+number representation being used, whether that is Python long<br>
+integers, MPZ objects, or whatever.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-blind"><strong>blind</strong></a>(self, M, B)</dt><dd><tt><a href="#DSAobj-blind">blind</a>(M : string|long, B : string|long) : string|long<br>
+Blind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-can_blind"><strong>can_blind</strong></a>(self)</dt><dd><tt><a href="#DSAobj-can_blind">can_blind</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+blind data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to blind a message.)</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt><a href="#DSAobj-decrypt">decrypt</a>(ciphertext:tuple|string|long): string<br>
+Decrypt 'ciphertext' using this key.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-encrypt"><strong>encrypt</strong></a>(self, plaintext, K)</dt><dd><tt><a href="#DSAobj-encrypt">encrypt</a>(plaintext:string|long, K:string|long) : tuple<br>
+Encrypt the string or integer plaintext. K is a random<br>
+parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-sign"><strong>sign</strong></a>(self, M, K)</dt><dd><tt><a href="#DSAobj-sign">sign</a>(M : string|long, K:string|long) : tuple<br>
+Return a tuple containing the signature for the message M.<br>
+K is a random parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-unblind"><strong>unblind</strong></a>(self, M, B)</dt><dd><tt><a href="#DSAobj-unblind">unblind</a>(M : string|long, B : string|long) : string|long<br>
+Unblind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-validate"><strong>validate</strong></a>(self, M, signature)</dt><dd><tt># alias to compensate for the old <a href="#DSAobj-validate">validate</a>() name</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-verify"><strong>verify</strong></a>(self, M, signature)</dt><dd><tt><a href="#DSAobj-verify">verify</a>(M:string|long, signature:tuple) : bool<br>
+Verify that the signature is valid for the message M;<br>
+returns true if the signature checks out.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DSAobj_c">class <strong>DSAobj_c</strong></a>(<a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="DSAobj_c-__getattr__"><strong>__getattr__</strong></a>(self, attr)</dt></dl>
+
+<dl><dt><a name="DSAobj_c-__getstate__"><strong>__getstate__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DSAobj_c-__init__"><strong>__init__</strong></a>(self, key)</dt></dl>
+
+<dl><dt><a name="DSAobj_c-__setstate__"><strong>__setstate__</strong></a>(self, state)</dt></dl>
+
+<dl><dt><a name="DSAobj_c-can_encrypt"><strong>can_encrypt</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DSAobj_c-can_sign"><strong>can_sign</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DSAobj_c-has_private"><strong>has_private</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DSAobj_c-publickey"><strong>publickey</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DSAobj_c-size"><strong>size</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>keydata</strong> = ['y', 'g', 'p', 'q', 'x']</dl>
+
+<hr>
+Methods inherited from <a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>:<br>
+<dl><dt><a name="DSAobj_c-__eq__"><strong>__eq__</strong></a>(self, other)</dt><dd><tt><a href="#DSAobj_c-__eq__">__eq__</a>(other): 0, 1<br>
+Compare us to other for equality.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj_c-__ne__"><strong>__ne__</strong></a>(self, other)</dt><dd><tt><a href="#DSAobj_c-__ne__">__ne__</a>(other): 0, 1<br>
+Compare us to other for inequality.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj_c-blind"><strong>blind</strong></a>(self, M, B)</dt><dd><tt><a href="#DSAobj_c-blind">blind</a>(M : string|long, B : string|long) : string|long<br>
+Blind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj_c-can_blind"><strong>can_blind</strong></a>(self)</dt><dd><tt><a href="#DSAobj_c-can_blind">can_blind</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+blind data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to blind a message.)</tt></dd></dl>
+
+<dl><dt><a name="DSAobj_c-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt><a href="#DSAobj_c-decrypt">decrypt</a>(ciphertext:tuple|string|long): string<br>
+Decrypt 'ciphertext' using this key.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj_c-encrypt"><strong>encrypt</strong></a>(self, plaintext, K)</dt><dd><tt><a href="#DSAobj_c-encrypt">encrypt</a>(plaintext:string|long, K:string|long) : tuple<br>
+Encrypt the string or integer plaintext. K is a random<br>
+parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj_c-sign"><strong>sign</strong></a>(self, M, K)</dt><dd><tt><a href="#DSAobj_c-sign">sign</a>(M : string|long, K:string|long) : tuple<br>
+Return a tuple containing the signature for the message M.<br>
+K is a random parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj_c-unblind"><strong>unblind</strong></a>(self, M, B)</dt><dd><tt><a href="#DSAobj_c-unblind">unblind</a>(M : string|long, B : string|long) : string|long<br>
+Unblind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj_c-validate"><strong>validate</strong></a>(self, M, signature)</dt><dd><tt># alias to compensate for the old <a href="#DSAobj_c-validate">validate</a>() name</tt></dd></dl>
+
+<dl><dt><a name="DSAobj_c-verify"><strong>verify</strong></a>(self, M, signature)</dt><dd><tt><a href="#DSAobj_c-verify">verify</a>(M:string|long, signature:tuple) : bool<br>
+Verify that the signature is valid for the message M;<br>
+returns true if the signature checks out.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="error">class <strong>error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd>error</dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#error-__new__">__new__</a>(S, ...) -> a new <a href="#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><strong>object</strong> = <a name="object">class DSAobj</a>(<a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="DSAobj-can_encrypt"><strong>can_encrypt</strong></a>(self)</dt><dd><tt>Return a Boolean value recording whether this algorithm can encrypt data.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-can_sign"><strong>can_sign</strong></a>(self)</dt><dd><tt>Return a Boolean value recording whether this algorithm can generate signatures.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-has_private"><strong>has_private</strong></a>(self)</dt><dd><tt>Return a Boolean denoting whether the <a href="#object">object</a> contains<br>
+private components.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-publickey"><strong>publickey</strong></a>(self)</dt><dd><tt>Return a new key <a href="#object">object</a> containing only the public information.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-size"><strong>size</strong></a>(self)</dt><dd><tt>Return the maximum number of bits that can be handled by this key.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>keydata</strong> = ['y', 'g', 'p', 'q', 'x']</dl>
+
+<hr>
+Methods inherited from <a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>:<br>
+<dl><dt><a name="DSAobj-__eq__"><strong>__eq__</strong></a>(self, other)</dt><dd><tt><a href="#object-__eq__">__eq__</a>(other): 0, 1<br>
+Compare us to other for equality.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-__getstate__"><strong>__getstate__</strong></a>(self)</dt><dd><tt>To keep key objects platform-independent, the key data is<br>
+converted to standard Python long integers before being<br>
+written out. It will then be reconverted as necessary on<br>
+restoration.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DSAobj-__ne__"><strong>__ne__</strong></a>(self, other)</dt><dd><tt><a href="#object-__ne__">__ne__</a>(other): 0, 1<br>
+Compare us to other for inequality.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-__setstate__"><strong>__setstate__</strong></a>(self, d)</dt><dd><tt>On unpickling a key <a href="#object">object</a>, the key data is converted to the big<br>
+number representation being used, whether that is Python long<br>
+integers, MPZ objects, or whatever.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-blind"><strong>blind</strong></a>(self, M, B)</dt><dd><tt><a href="#object-blind">blind</a>(M : string|long, B : string|long) : string|long<br>
+Blind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-can_blind"><strong>can_blind</strong></a>(self)</dt><dd><tt><a href="#object-can_blind">can_blind</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+blind data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to blind a message.)</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt><a href="#object-decrypt">decrypt</a>(ciphertext:tuple|string|long): string<br>
+Decrypt 'ciphertext' using this key.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-encrypt"><strong>encrypt</strong></a>(self, plaintext, K)</dt><dd><tt><a href="#object-encrypt">encrypt</a>(plaintext:string|long, K:string|long) : tuple<br>
+Encrypt the string or integer plaintext. K is a random<br>
+parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-sign"><strong>sign</strong></a>(self, M, K)</dt><dd><tt><a href="#object-sign">sign</a>(M : string|long, K:string|long) : tuple<br>
+Return a tuple containing the signature for the message M.<br>
+K is a random parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-unblind"><strong>unblind</strong></a>(self, M, B)</dt><dd><tt><a href="#object-unblind">unblind</a>(M : string|long, B : string|long) : string|long<br>
+Unblind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-validate"><strong>validate</strong></a>(self, M, signature)</dt><dd><tt># alias to compensate for the old <a href="#object-validate">validate</a>() name</tt></dd></dl>
+
+<dl><dt><a name="DSAobj-verify"><strong>verify</strong></a>(self, M, signature)</dt><dd><tt><a href="#object-verify">verify</a>(M:string|long, signature:tuple) : bool<br>
+Verify that the signature is valid for the message M;<br>
+returns true if the signature checks out.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-construct"><strong>construct</strong></a> = construct_c(tuple)</dt></dl>
+ <dl><dt><a name="-construct_c"><strong>construct_c</strong></a>(tuple)</dt></dl>
+ <dl><dt><a name="-construct_py"><strong>construct_py</strong></a> = construct(tuple)</dt><dd><tt><a href="#-construct">construct</a>(tuple:(long,long,long,long)|(long,long,long,long,long)):<a href="#DSAobj">DSAobj</a><br>
+Construct a DSA <a href="#object">object</a> from a 4- or 5-tuple of numbers.</tt></dd></dl>
+ <dl><dt><a name="-generate"><strong>generate</strong></a> = generate_c(bits, randfunc, progress_func<font color="#909090">=None</font>)</dt></dl>
+ <dl><dt><a name="-generateQ"><strong>generateQ</strong></a>(randfunc)</dt></dl>
+ <dl><dt><a name="-generate_c"><strong>generate_c</strong></a>(bits, randfunc, progress_func<font color="#909090">=None</font>)</dt></dl>
+ <dl><dt><a name="-generate_py"><strong>generate_py</strong></a> = generate(bits, randfunc, progress_func<font color="#909090">=None</font>)</dt><dd><tt><a href="#-generate">generate</a>(bits:int, randfunc:callable, progress_func:callable)<br>
+ <br>
+Generate a DSA key of length 'bits', using 'randfunc' to get<br>
+random data and 'progress_func', if present, to display<br>
+the progress of the key generation.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__revision__</strong> = '$Id: DSA.py,v 1.16 2004/05/06 12:52:54 akuchling Exp $'<br>
+<strong>sieve_base</strong> = (2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.PublicKey.ElGamal.html b/pydocs/gdata.Crypto.PublicKey.ElGamal.html
new file mode 100644
index 0000000..a656d82
--- /dev/null
+++ b/pydocs/gdata.Crypto.PublicKey.ElGamal.html
@@ -0,0 +1,297 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.PublicKey.ElGamal</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.PublicKey.html"><font color="#ffffff">PublicKey</font></a>.ElGamal</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/ElGamal.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/ElGamal.py</a></font></td></tr></table>
+ <p><tt># ElGamal.py : ElGamal encryption/decryption and signatures<br>
+#<br>
+# Part of the Python Cryptography Toolkit<br>
+#<br>
+# Distribute and use freely; there are no restrictions on further<br>
+# dissemination and usage except those imposed by the laws of your<br>
+# country of residence. This software is provided "as is" without<br>
+# warranty of fitness for use or suitability for any purpose, express<br>
+# or implied. Use at your own risk or not at all.<br>
+#</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="Crypto.Util.number.html">Crypto.Util.number</a><br>
+</td><td width="25%" valign=top><a href="struct.html">struct</a><br>
+<a href="sys.html">sys</a><br>
+</td><td width="25%" valign=top><a href="types.html">types</a><br>
+<a href="warnings.html">warnings</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.ElGamal.html#ElGamalobj">ElGamalobj</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.ElGamal.html#ElGamalobj">ElGamalobj</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.ElGamal.html#error">error</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ElGamalobj">class <strong>ElGamalobj</strong></a>(<a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="ElGamalobj-has_private"><strong>has_private</strong></a>(self)</dt><dd><tt>Return a Boolean denoting whether the <a href="#object">object</a> contains<br>
+private components.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-publickey"><strong>publickey</strong></a>(self)</dt><dd><tt>Return a new key <a href="#object">object</a> containing only the public information.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-size"><strong>size</strong></a>(self)</dt><dd><tt>Return the maximum number of bits that can be handled by this key.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>keydata</strong> = ['p', 'g', 'y', 'x']</dl>
+
+<hr>
+Methods inherited from <a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>:<br>
+<dl><dt><a name="ElGamalobj-__eq__"><strong>__eq__</strong></a>(self, other)</dt><dd><tt><a href="#ElGamalobj-__eq__">__eq__</a>(other): 0, 1<br>
+Compare us to other for equality.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-__getstate__"><strong>__getstate__</strong></a>(self)</dt><dd><tt>To keep key objects platform-independent, the key data is<br>
+converted to standard Python long integers before being<br>
+written out. It will then be reconverted as necessary on<br>
+restoration.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ElGamalobj-__ne__"><strong>__ne__</strong></a>(self, other)</dt><dd><tt><a href="#ElGamalobj-__ne__">__ne__</a>(other): 0, 1<br>
+Compare us to other for inequality.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-__setstate__"><strong>__setstate__</strong></a>(self, d)</dt><dd><tt>On unpickling a key <a href="#object">object</a>, the key data is converted to the big<br>
+number representation being used, whether that is Python long<br>
+integers, MPZ objects, or whatever.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-blind"><strong>blind</strong></a>(self, M, B)</dt><dd><tt><a href="#ElGamalobj-blind">blind</a>(M : string|long, B : string|long) : string|long<br>
+Blind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-can_blind"><strong>can_blind</strong></a>(self)</dt><dd><tt><a href="#ElGamalobj-can_blind">can_blind</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+blind data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to blind a message.)</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-can_encrypt"><strong>can_encrypt</strong></a>(self)</dt><dd><tt><a href="#ElGamalobj-can_encrypt">can_encrypt</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+encrypt data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to decrypt a message.)</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-can_sign"><strong>can_sign</strong></a>(self)</dt><dd><tt><a href="#ElGamalobj-can_sign">can_sign</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+generate signatures. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to generate a signature.)</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt><a href="#ElGamalobj-decrypt">decrypt</a>(ciphertext:tuple|string|long): string<br>
+Decrypt 'ciphertext' using this key.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-encrypt"><strong>encrypt</strong></a>(self, plaintext, K)</dt><dd><tt><a href="#ElGamalobj-encrypt">encrypt</a>(plaintext:string|long, K:string|long) : tuple<br>
+Encrypt the string or integer plaintext. K is a random<br>
+parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-sign"><strong>sign</strong></a>(self, M, K)</dt><dd><tt><a href="#ElGamalobj-sign">sign</a>(M : string|long, K:string|long) : tuple<br>
+Return a tuple containing the signature for the message M.<br>
+K is a random parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-unblind"><strong>unblind</strong></a>(self, M, B)</dt><dd><tt><a href="#ElGamalobj-unblind">unblind</a>(M : string|long, B : string|long) : string|long<br>
+Unblind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-validate"><strong>validate</strong></a>(self, M, signature)</dt><dd><tt># alias to compensate for the old <a href="#ElGamalobj-validate">validate</a>() name</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-verify"><strong>verify</strong></a>(self, M, signature)</dt><dd><tt><a href="#ElGamalobj-verify">verify</a>(M:string|long, signature:tuple) : bool<br>
+Verify that the signature is valid for the message M;<br>
+returns true if the signature checks out.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="error">class <strong>error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.Crypto.PublicKey.ElGamal.html#error">error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#error-__new__">__new__</a>(S, ...) -> a new <a href="#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><strong>object</strong> = <a name="object">class ElGamalobj</a>(<a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="ElGamalobj-has_private"><strong>has_private</strong></a>(self)</dt><dd><tt>Return a Boolean denoting whether the <a href="#object">object</a> contains<br>
+private components.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-publickey"><strong>publickey</strong></a>(self)</dt><dd><tt>Return a new key <a href="#object">object</a> containing only the public information.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-size"><strong>size</strong></a>(self)</dt><dd><tt>Return the maximum number of bits that can be handled by this key.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>keydata</strong> = ['p', 'g', 'y', 'x']</dl>
+
+<hr>
+Methods inherited from <a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>:<br>
+<dl><dt><a name="ElGamalobj-__eq__"><strong>__eq__</strong></a>(self, other)</dt><dd><tt><a href="#object-__eq__">__eq__</a>(other): 0, 1<br>
+Compare us to other for equality.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-__getstate__"><strong>__getstate__</strong></a>(self)</dt><dd><tt>To keep key objects platform-independent, the key data is<br>
+converted to standard Python long integers before being<br>
+written out. It will then be reconverted as necessary on<br>
+restoration.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ElGamalobj-__ne__"><strong>__ne__</strong></a>(self, other)</dt><dd><tt><a href="#object-__ne__">__ne__</a>(other): 0, 1<br>
+Compare us to other for inequality.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-__setstate__"><strong>__setstate__</strong></a>(self, d)</dt><dd><tt>On unpickling a key <a href="#object">object</a>, the key data is converted to the big<br>
+number representation being used, whether that is Python long<br>
+integers, MPZ objects, or whatever.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-blind"><strong>blind</strong></a>(self, M, B)</dt><dd><tt><a href="#object-blind">blind</a>(M : string|long, B : string|long) : string|long<br>
+Blind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-can_blind"><strong>can_blind</strong></a>(self)</dt><dd><tt><a href="#object-can_blind">can_blind</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+blind data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to blind a message.)</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-can_encrypt"><strong>can_encrypt</strong></a>(self)</dt><dd><tt><a href="#object-can_encrypt">can_encrypt</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+encrypt data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to decrypt a message.)</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-can_sign"><strong>can_sign</strong></a>(self)</dt><dd><tt><a href="#object-can_sign">can_sign</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+generate signatures. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to generate a signature.)</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt><a href="#object-decrypt">decrypt</a>(ciphertext:tuple|string|long): string<br>
+Decrypt 'ciphertext' using this key.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-encrypt"><strong>encrypt</strong></a>(self, plaintext, K)</dt><dd><tt><a href="#object-encrypt">encrypt</a>(plaintext:string|long, K:string|long) : tuple<br>
+Encrypt the string or integer plaintext. K is a random<br>
+parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-sign"><strong>sign</strong></a>(self, M, K)</dt><dd><tt><a href="#object-sign">sign</a>(M : string|long, K:string|long) : tuple<br>
+Return a tuple containing the signature for the message M.<br>
+K is a random parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-unblind"><strong>unblind</strong></a>(self, M, B)</dt><dd><tt><a href="#object-unblind">unblind</a>(M : string|long, B : string|long) : string|long<br>
+Unblind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-validate"><strong>validate</strong></a>(self, M, signature)</dt><dd><tt># alias to compensate for the old <a href="#object-validate">validate</a>() name</tt></dd></dl>
+
+<dl><dt><a name="ElGamalobj-verify"><strong>verify</strong></a>(self, M, signature)</dt><dd><tt><a href="#object-verify">verify</a>(M:string|long, signature:tuple) : bool<br>
+Verify that the signature is valid for the message M;<br>
+returns true if the signature checks out.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-construct"><strong>construct</strong></a>(tuple)</dt><dd><tt><a href="#-construct">construct</a>(tuple:(long,long,long,long)|(long,long,long,long,long)))<br>
+ : <a href="#ElGamalobj">ElGamalobj</a><br>
+Construct an ElGamal key from a 3- or 4-tuple of numbers.</tt></dd></dl>
+ <dl><dt><a name="-generate"><strong>generate</strong></a>(bits, randfunc, progress_func<font color="#909090">=None</font>)</dt><dd><tt><a href="#-generate">generate</a>(bits:int, randfunc:callable, progress_func:callable)<br>
+ <br>
+Generate an ElGamal key of length 'bits', using 'randfunc' to get<br>
+random data and 'progress_func', if present, to display<br>
+the progress of the key generation.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__revision__</strong> = '$Id: ElGamal.py,v 1.9 2003/04/04 19:44:26 akuchling Exp $'<br>
+<strong>sieve_base</strong> = (2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.PublicKey.RSA.html b/pydocs/gdata.Crypto.PublicKey.RSA.html
new file mode 100644
index 0000000..512b0b9
--- /dev/null
+++ b/pydocs/gdata.Crypto.PublicKey.RSA.html
@@ -0,0 +1,374 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.PublicKey.RSA</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.PublicKey.html"><font color="#ffffff">PublicKey</font></a>.RSA</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/RSA.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/RSA.py</a></font></td></tr></table>
+ <p><tt># RSA.py : RSA encryption/decryption<br>
+#<br>
+# Part of the Python Cryptography Toolkit<br>
+#<br>
+# Distribute and use freely; there are no restrictions on further<br>
+# dissemination and usage except those imposed by the laws of your<br>
+# country of residence. This software is provided "as is" without<br>
+# warranty of fitness for use or suitability for any purpose, express<br>
+# or implied. Use at your own risk or not at all.<br>
+#</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.PublicKey._fastmath.html">Crypto.PublicKey._fastmath</a><br>
+</td><td width="25%" valign=top><a href="Crypto.Util.number.html">Crypto.Util.number</a><br>
+</td><td width="25%" valign=top><a href="Crypto.PublicKey.pubkey.html">Crypto.PublicKey.pubkey</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.RSA.html#RSAobj">RSAobj</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.RSA.html#RSAobj">RSAobj</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.RSA.html#RSAobj_c">RSAobj_c</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial">_fastmath.error
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RSAobj">class <strong>RSAobj</strong></a>(<a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="RSAobj-can_blind"><strong>can_blind</strong></a>(self)</dt><dd><tt><a href="#RSAobj-can_blind">can_blind</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+blind data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to blind a message.)</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-has_private"><strong>has_private</strong></a>(self)</dt><dd><tt><a href="#RSAobj-has_private">has_private</a>() : bool<br>
+Return a Boolean denoting whether the <a href="#object">object</a> contains<br>
+private components.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-publickey"><strong>publickey</strong></a>(self)</dt><dd><tt><a href="#RSAobj-publickey">publickey</a>(): <a href="#RSAobj">RSAobj</a><br>
+Return a new key <a href="#object">object</a> containing only the public key information.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-size"><strong>size</strong></a>(self)</dt><dd><tt><a href="#RSAobj-size">size</a>() : int<br>
+Return the maximum number of bits that can be handled by this key.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>keydata</strong> = ['n', 'e', 'd', 'p', 'q', 'u']</dl>
+
+<hr>
+Methods inherited from <a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>:<br>
+<dl><dt><a name="RSAobj-__eq__"><strong>__eq__</strong></a>(self, other)</dt><dd><tt><a href="#RSAobj-__eq__">__eq__</a>(other): 0, 1<br>
+Compare us to other for equality.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-__getstate__"><strong>__getstate__</strong></a>(self)</dt><dd><tt>To keep key objects platform-independent, the key data is<br>
+converted to standard Python long integers before being<br>
+written out. It will then be reconverted as necessary on<br>
+restoration.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RSAobj-__ne__"><strong>__ne__</strong></a>(self, other)</dt><dd><tt><a href="#RSAobj-__ne__">__ne__</a>(other): 0, 1<br>
+Compare us to other for inequality.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-__setstate__"><strong>__setstate__</strong></a>(self, d)</dt><dd><tt>On unpickling a key <a href="#object">object</a>, the key data is converted to the big<br>
+number representation being used, whether that is Python long<br>
+integers, MPZ objects, or whatever.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-blind"><strong>blind</strong></a>(self, M, B)</dt><dd><tt><a href="#RSAobj-blind">blind</a>(M : string|long, B : string|long) : string|long<br>
+Blind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-can_encrypt"><strong>can_encrypt</strong></a>(self)</dt><dd><tt><a href="#RSAobj-can_encrypt">can_encrypt</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+encrypt data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to decrypt a message.)</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-can_sign"><strong>can_sign</strong></a>(self)</dt><dd><tt><a href="#RSAobj-can_sign">can_sign</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+generate signatures. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to generate a signature.)</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt><a href="#RSAobj-decrypt">decrypt</a>(ciphertext:tuple|string|long): string<br>
+Decrypt 'ciphertext' using this key.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-encrypt"><strong>encrypt</strong></a>(self, plaintext, K)</dt><dd><tt><a href="#RSAobj-encrypt">encrypt</a>(plaintext:string|long, K:string|long) : tuple<br>
+Encrypt the string or integer plaintext. K is a random<br>
+parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-sign"><strong>sign</strong></a>(self, M, K)</dt><dd><tt><a href="#RSAobj-sign">sign</a>(M : string|long, K:string|long) : tuple<br>
+Return a tuple containing the signature for the message M.<br>
+K is a random parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-unblind"><strong>unblind</strong></a>(self, M, B)</dt><dd><tt><a href="#RSAobj-unblind">unblind</a>(M : string|long, B : string|long) : string|long<br>
+Unblind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-validate"><strong>validate</strong></a>(self, M, signature)</dt><dd><tt># alias to compensate for the old <a href="#RSAobj-validate">validate</a>() name</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-verify"><strong>verify</strong></a>(self, M, signature)</dt><dd><tt><a href="#RSAobj-verify">verify</a>(M:string|long, signature:tuple) : bool<br>
+Verify that the signature is valid for the message M;<br>
+returns true if the signature checks out.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RSAobj_c">class <strong>RSAobj_c</strong></a>(<a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="RSAobj_c-__getattr__"><strong>__getattr__</strong></a>(self, attr)</dt></dl>
+
+<dl><dt><a name="RSAobj_c-__getstate__"><strong>__getstate__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RSAobj_c-__init__"><strong>__init__</strong></a>(self, key)</dt></dl>
+
+<dl><dt><a name="RSAobj_c-__setstate__"><strong>__setstate__</strong></a>(self, state)</dt></dl>
+
+<dl><dt><a name="RSAobj_c-can_blind"><strong>can_blind</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RSAobj_c-has_private"><strong>has_private</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RSAobj_c-publickey"><strong>publickey</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RSAobj_c-size"><strong>size</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>keydata</strong> = ['n', 'e', 'd', 'p', 'q', 'u']</dl>
+
+<hr>
+Methods inherited from <a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>:<br>
+<dl><dt><a name="RSAobj_c-__eq__"><strong>__eq__</strong></a>(self, other)</dt><dd><tt><a href="#RSAobj_c-__eq__">__eq__</a>(other): 0, 1<br>
+Compare us to other for equality.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj_c-__ne__"><strong>__ne__</strong></a>(self, other)</dt><dd><tt><a href="#RSAobj_c-__ne__">__ne__</a>(other): 0, 1<br>
+Compare us to other for inequality.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj_c-blind"><strong>blind</strong></a>(self, M, B)</dt><dd><tt><a href="#RSAobj_c-blind">blind</a>(M : string|long, B : string|long) : string|long<br>
+Blind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj_c-can_encrypt"><strong>can_encrypt</strong></a>(self)</dt><dd><tt><a href="#RSAobj_c-can_encrypt">can_encrypt</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+encrypt data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to decrypt a message.)</tt></dd></dl>
+
+<dl><dt><a name="RSAobj_c-can_sign"><strong>can_sign</strong></a>(self)</dt><dd><tt><a href="#RSAobj_c-can_sign">can_sign</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+generate signatures. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to generate a signature.)</tt></dd></dl>
+
+<dl><dt><a name="RSAobj_c-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt><a href="#RSAobj_c-decrypt">decrypt</a>(ciphertext:tuple|string|long): string<br>
+Decrypt 'ciphertext' using this key.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj_c-encrypt"><strong>encrypt</strong></a>(self, plaintext, K)</dt><dd><tt><a href="#RSAobj_c-encrypt">encrypt</a>(plaintext:string|long, K:string|long) : tuple<br>
+Encrypt the string or integer plaintext. K is a random<br>
+parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj_c-sign"><strong>sign</strong></a>(self, M, K)</dt><dd><tt><a href="#RSAobj_c-sign">sign</a>(M : string|long, K:string|long) : tuple<br>
+Return a tuple containing the signature for the message M.<br>
+K is a random parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj_c-unblind"><strong>unblind</strong></a>(self, M, B)</dt><dd><tt><a href="#RSAobj_c-unblind">unblind</a>(M : string|long, B : string|long) : string|long<br>
+Unblind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj_c-validate"><strong>validate</strong></a>(self, M, signature)</dt><dd><tt># alias to compensate for the old <a href="#RSAobj_c-validate">validate</a>() name</tt></dd></dl>
+
+<dl><dt><a name="RSAobj_c-verify"><strong>verify</strong></a>(self, M, signature)</dt><dd><tt><a href="#RSAobj_c-verify">verify</a>(M:string|long, signature:tuple) : bool<br>
+Verify that the signature is valid for the message M;<br>
+returns true if the signature checks out.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="error">class <strong>error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd>error</dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#error-__new__">__new__</a>(S, ...) -> a new <a href="#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><strong>object</strong> = <a name="object">class RSAobj</a>(<a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="RSAobj-can_blind"><strong>can_blind</strong></a>(self)</dt><dd><tt><a href="#object-can_blind">can_blind</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+blind data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to blind a message.)</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-has_private"><strong>has_private</strong></a>(self)</dt><dd><tt><a href="#object-has_private">has_private</a>() : bool<br>
+Return a Boolean denoting whether the <a href="#object">object</a> contains<br>
+private components.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-publickey"><strong>publickey</strong></a>(self)</dt><dd><tt><a href="#object-publickey">publickey</a>(): <a href="#RSAobj">RSAobj</a><br>
+Return a new key <a href="#object">object</a> containing only the public key information.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-size"><strong>size</strong></a>(self)</dt><dd><tt><a href="#object-size">size</a>() : int<br>
+Return the maximum number of bits that can be handled by this key.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>keydata</strong> = ['n', 'e', 'd', 'p', 'q', 'u']</dl>
+
+<hr>
+Methods inherited from <a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>:<br>
+<dl><dt><a name="RSAobj-__eq__"><strong>__eq__</strong></a>(self, other)</dt><dd><tt><a href="#object-__eq__">__eq__</a>(other): 0, 1<br>
+Compare us to other for equality.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-__getstate__"><strong>__getstate__</strong></a>(self)</dt><dd><tt>To keep key objects platform-independent, the key data is<br>
+converted to standard Python long integers before being<br>
+written out. It will then be reconverted as necessary on<br>
+restoration.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RSAobj-__ne__"><strong>__ne__</strong></a>(self, other)</dt><dd><tt><a href="#object-__ne__">__ne__</a>(other): 0, 1<br>
+Compare us to other for inequality.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-__setstate__"><strong>__setstate__</strong></a>(self, d)</dt><dd><tt>On unpickling a key <a href="#object">object</a>, the key data is converted to the big<br>
+number representation being used, whether that is Python long<br>
+integers, MPZ objects, or whatever.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-blind"><strong>blind</strong></a>(self, M, B)</dt><dd><tt><a href="#object-blind">blind</a>(M : string|long, B : string|long) : string|long<br>
+Blind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-can_encrypt"><strong>can_encrypt</strong></a>(self)</dt><dd><tt><a href="#object-can_encrypt">can_encrypt</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+encrypt data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to decrypt a message.)</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-can_sign"><strong>can_sign</strong></a>(self)</dt><dd><tt><a href="#object-can_sign">can_sign</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+generate signatures. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to generate a signature.)</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt><a href="#object-decrypt">decrypt</a>(ciphertext:tuple|string|long): string<br>
+Decrypt 'ciphertext' using this key.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-encrypt"><strong>encrypt</strong></a>(self, plaintext, K)</dt><dd><tt><a href="#object-encrypt">encrypt</a>(plaintext:string|long, K:string|long) : tuple<br>
+Encrypt the string or integer plaintext. K is a random<br>
+parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-sign"><strong>sign</strong></a>(self, M, K)</dt><dd><tt><a href="#object-sign">sign</a>(M : string|long, K:string|long) : tuple<br>
+Return a tuple containing the signature for the message M.<br>
+K is a random parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-unblind"><strong>unblind</strong></a>(self, M, B)</dt><dd><tt><a href="#object-unblind">unblind</a>(M : string|long, B : string|long) : string|long<br>
+Unblind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-validate"><strong>validate</strong></a>(self, M, signature)</dt><dd><tt># alias to compensate for the old <a href="#object-validate">validate</a>() name</tt></dd></dl>
+
+<dl><dt><a name="RSAobj-verify"><strong>verify</strong></a>(self, M, signature)</dt><dd><tt><a href="#object-verify">verify</a>(M:string|long, signature:tuple) : bool<br>
+Verify that the signature is valid for the message M;<br>
+returns true if the signature checks out.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-construct"><strong>construct</strong></a> = construct_c(tuple)</dt></dl>
+ <dl><dt><a name="-construct_c"><strong>construct_c</strong></a>(tuple)</dt></dl>
+ <dl><dt><a name="-construct_py"><strong>construct_py</strong></a> = construct(tuple)</dt><dd><tt><a href="#-construct">construct</a>(tuple:(long,) : <a href="#RSAobj">RSAobj</a><br>
+Construct an RSA <a href="#object">object</a> from a 2-, 3-, 5-, or 6-tuple of numbers.</tt></dd></dl>
+ <dl><dt><a name="-generate"><strong>generate</strong></a> = generate_c(bits, randfunc, progress_func<font color="#909090">=None</font>)</dt></dl>
+ <dl><dt><a name="-generate_c"><strong>generate_c</strong></a>(bits, randfunc, progress_func<font color="#909090">=None</font>)</dt></dl>
+ <dl><dt><a name="-generate_py"><strong>generate_py</strong></a> = generate(bits, randfunc, progress_func<font color="#909090">=None</font>)</dt><dd><tt><a href="#-generate">generate</a>(bits:int, randfunc:callable, progress_func:callable)<br>
+ <br>
+Generate an RSA key of length 'bits', using 'randfunc' to get<br>
+random data and 'progress_func', if present, to display<br>
+the progress of the key generation.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__revision__</strong> = '$Id: RSA.py,v 1.20 2004/05/06 12:52:54 akuchling Exp $'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.PublicKey.html b/pydocs/gdata.Crypto.PublicKey.html
new file mode 100644
index 0000000..5e8d13e
--- /dev/null
+++ b/pydocs/gdata.Crypto.PublicKey.html
@@ -0,0 +1,44 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.Crypto.PublicKey</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.PublicKey</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/__init__.py</a></font></td></tr></table>
+ <p><tt>Public-key encryption and signature algorithms.<br>
+ <br>
+Public-key encryption uses two different keys, one for encryption and<br>
+one for decryption. The encryption key can be made public, and the<br>
+decryption key is kept private. Many public-key algorithms can also<br>
+be used to sign messages, and some can *only* be used for signatures.<br>
+ <br>
+Crypto.PublicKey.DSA Digital Signature Algorithm. (Signature only)<br>
+Crypto.PublicKey.ElGamal (Signing and encryption)<br>
+Crypto.PublicKey.RSA (Signing, encryption, and blinding)<br>
+Crypto.PublicKey.qNEW (Signature only)</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.Crypto.PublicKey.DSA.html">DSA</a><br>
+<a href="gdata.Crypto.PublicKey.ElGamal.html">ElGamal</a><br>
+</td><td width="25%" valign=top><a href="gdata.Crypto.PublicKey.RSA.html">RSA</a><br>
+<a href="gdata.Crypto.PublicKey.pubkey.html">pubkey</a><br>
+</td><td width="25%" valign=top><a href="gdata.Crypto.PublicKey.qNEW.html">qNEW</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__all__</strong> = ['RSA', 'DSA', 'ElGamal', 'qNEW']<br>
+<strong>__revision__</strong> = '$Id: __init__.py,v 1.4 2003/04/03 20:27:13 akuchling Exp $'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.PublicKey.pubkey.html b/pydocs/gdata.Crypto.PublicKey.pubkey.html
new file mode 100644
index 0000000..d46db2b
--- /dev/null
+++ b/pydocs/gdata.Crypto.PublicKey.pubkey.html
@@ -0,0 +1,128 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.PublicKey.pubkey</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.PublicKey.html"><font color="#ffffff">PublicKey</font></a>.pubkey</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/pubkey.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/pubkey.py</a></font></td></tr></table>
+ <p><tt># <a href="#pubkey">pubkey</a>.py : Internal functions for public key operations<br>
+#<br>
+# Part of the Python Cryptography Toolkit<br>
+#<br>
+# Distribute and use freely; there are no restrictions on further<br>
+# dissemination and usage except those imposed by the laws of your<br>
+# country of residence. This software is provided "as is" without<br>
+# warranty of fitness for use or suitability for any purpose, express<br>
+# or implied. Use at your own risk or not at all.<br>
+#</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="struct.html">struct</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="types.html">types</a><br>
+</td><td width="25%" valign=top><a href="warnings.html">warnings</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.pubkey.html#pubkey">pubkey</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="pubkey">class <strong>pubkey</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt># Basic public key class<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="pubkey-__eq__"><strong>__eq__</strong></a>(self, other)</dt><dd><tt><a href="#pubkey-__eq__">__eq__</a>(other): 0, 1<br>
+Compare us to other for equality.</tt></dd></dl>
+
+<dl><dt><a name="pubkey-__getstate__"><strong>__getstate__</strong></a>(self)</dt><dd><tt>To keep key objects platform-independent, the key data is<br>
+converted to standard Python long integers before being<br>
+written out. It will then be reconverted as necessary on<br>
+restoration.</tt></dd></dl>
+
+<dl><dt><a name="pubkey-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="pubkey-__setstate__"><strong>__setstate__</strong></a>(self, d)</dt><dd><tt>On unpickling a key object, the key data is converted to the big<br>
+number representation being used, whether that is Python long<br>
+integers, MPZ objects, or whatever.</tt></dd></dl>
+
+<dl><dt><a name="pubkey-blind"><strong>blind</strong></a>(self, M, B)</dt><dd><tt><a href="#pubkey-blind">blind</a>(M : string|long, B : string|long) : string|long<br>
+Blind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="pubkey-can_blind"><strong>can_blind</strong></a>(self)</dt><dd><tt><a href="#pubkey-can_blind">can_blind</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+blind data. (This does not imply that this<br>
+particular key object has the private information required to<br>
+to blind a message.)</tt></dd></dl>
+
+<dl><dt><a name="pubkey-can_encrypt"><strong>can_encrypt</strong></a>(self)</dt><dd><tt><a href="#pubkey-can_encrypt">can_encrypt</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+encrypt data. (This does not imply that this<br>
+particular key object has the private information required to<br>
+to decrypt a message.)</tt></dd></dl>
+
+<dl><dt><a name="pubkey-can_sign"><strong>can_sign</strong></a>(self)</dt><dd><tt><a href="#pubkey-can_sign">can_sign</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+generate signatures. (This does not imply that this<br>
+particular key object has the private information required to<br>
+to generate a signature.)</tt></dd></dl>
+
+<dl><dt><a name="pubkey-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt><a href="#pubkey-decrypt">decrypt</a>(ciphertext:tuple|string|long): string<br>
+Decrypt 'ciphertext' using this key.</tt></dd></dl>
+
+<dl><dt><a name="pubkey-encrypt"><strong>encrypt</strong></a>(self, plaintext, K)</dt><dd><tt><a href="#pubkey-encrypt">encrypt</a>(plaintext:string|long, K:string|long) : tuple<br>
+Encrypt the string or integer plaintext. K is a random<br>
+parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="pubkey-has_private"><strong>has_private</strong></a>(self)</dt><dd><tt><a href="#pubkey-has_private">has_private</a>() : bool<br>
+Return a Boolean denoting whether the object contains<br>
+private components.</tt></dd></dl>
+
+<dl><dt><a name="pubkey-publickey"><strong>publickey</strong></a>(self)</dt><dd><tt><a href="#pubkey-publickey">publickey</a>(): object<br>
+Return a new key object containing only the public information.</tt></dd></dl>
+
+<dl><dt><a name="pubkey-sign"><strong>sign</strong></a>(self, M, K)</dt><dd><tt><a href="#pubkey-sign">sign</a>(M : string|long, K:string|long) : tuple<br>
+Return a tuple containing the signature for the message M.<br>
+K is a random parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="pubkey-size"><strong>size</strong></a>(self)</dt><dd><tt><a href="#pubkey-size">size</a>() : int<br>
+Return the maximum number of bits that can be handled by this key.</tt></dd></dl>
+
+<dl><dt><a name="pubkey-unblind"><strong>unblind</strong></a>(self, M, B)</dt><dd><tt><a href="#pubkey-unblind">unblind</a>(M : string|long, B : string|long) : string|long<br>
+Unblind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="pubkey-validate"><strong>validate</strong></a>(self, M, signature)</dt><dd><tt># alias to compensate for the old <a href="#pubkey-validate">validate</a>() name</tt></dd></dl>
+
+<dl><dt><a name="pubkey-verify"><strong>verify</strong></a>(self, M, signature)</dt><dd><tt><a href="#pubkey-verify">verify</a>(M:string|long, signature:tuple) : bool<br>
+Verify that the signature is valid for the message M;<br>
+returns true if the signature checks out.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__revision__</strong> = '$Id: pubkey.py,v 1.11 2003/04/03 20:36:14 akuchling Exp $'<br>
+<strong>sieve_base</strong> = (2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.PublicKey.qNEW.html b/pydocs/gdata.Crypto.PublicKey.qNEW.html
new file mode 100644
index 0000000..c7393a4
--- /dev/null
+++ b/pydocs/gdata.Crypto.PublicKey.qNEW.html
@@ -0,0 +1,281 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.PublicKey.qNEW</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.PublicKey.html"><font color="#ffffff">PublicKey</font></a>.qNEW</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/qNEW.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/PublicKey/qNEW.py</a></font></td></tr></table>
+ <p><tt># qNEW.py : The q-NEW signature algorithm.<br>
+#<br>
+# Part of the Python Cryptography Toolkit<br>
+#<br>
+# Distribute and use freely; there are no restrictions on further<br>
+# dissemination and usage except those imposed by the laws of your<br>
+# country of residence. This software is provided "as is" without<br>
+# warranty of fitness for use or suitability for any purpose, express<br>
+# or implied. Use at your own risk or not at all.<br>
+#</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.Hash.SHA.html">Crypto.Hash.SHA</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="Crypto.PublicKey.pubkey.html">Crypto.PublicKey.pubkey</a><br>
+<a href="struct.html">struct</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="warnings.html">warnings</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.qNEW.html#qNEWobj">qNEWobj</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.qNEW.html#qNEWobj">qNEWobj</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.PublicKey.qNEW.html#error">error</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="error">class <strong>error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.Crypto.PublicKey.qNEW.html#error">error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#error-__new__">__new__</a>(S, ...) -> a new <a href="#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><strong>object</strong> = <a name="object">class qNEWobj</a>(<a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="qNEWobj-can_encrypt"><strong>can_encrypt</strong></a>(self)</dt><dd><tt>Return a Boolean value recording whether this algorithm can encrypt data.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-can_sign"><strong>can_sign</strong></a>(self)</dt><dd><tt>Return a Boolean value recording whether this algorithm can generate signatures.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-has_private"><strong>has_private</strong></a>(self)</dt><dd><tt>Return a Boolean denoting whether the <a href="#object">object</a> contains<br>
+private components.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-publickey"><strong>publickey</strong></a>(self)</dt><dd><tt>Return a new key <a href="#object">object</a> containing only the public information.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-size"><strong>size</strong></a>(self)</dt><dd><tt>Return the maximum number of bits that can be handled by this key.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>keydata</strong> = ['p', 'q', 'g', 'y', 'x']</dl>
+
+<hr>
+Methods inherited from <a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>:<br>
+<dl><dt><a name="qNEWobj-__eq__"><strong>__eq__</strong></a>(self, other)</dt><dd><tt><a href="#object-__eq__">__eq__</a>(other): 0, 1<br>
+Compare us to other for equality.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-__getstate__"><strong>__getstate__</strong></a>(self)</dt><dd><tt>To keep key objects platform-independent, the key data is<br>
+converted to standard Python long integers before being<br>
+written out. It will then be reconverted as necessary on<br>
+restoration.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="qNEWobj-__ne__"><strong>__ne__</strong></a>(self, other)</dt><dd><tt><a href="#object-__ne__">__ne__</a>(other): 0, 1<br>
+Compare us to other for inequality.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-__setstate__"><strong>__setstate__</strong></a>(self, d)</dt><dd><tt>On unpickling a key <a href="#object">object</a>, the key data is converted to the big<br>
+number representation being used, whether that is Python long<br>
+integers, MPZ objects, or whatever.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-blind"><strong>blind</strong></a>(self, M, B)</dt><dd><tt><a href="#object-blind">blind</a>(M : string|long, B : string|long) : string|long<br>
+Blind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-can_blind"><strong>can_blind</strong></a>(self)</dt><dd><tt><a href="#object-can_blind">can_blind</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+blind data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to blind a message.)</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt><a href="#object-decrypt">decrypt</a>(ciphertext:tuple|string|long): string<br>
+Decrypt 'ciphertext' using this key.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-encrypt"><strong>encrypt</strong></a>(self, plaintext, K)</dt><dd><tt><a href="#object-encrypt">encrypt</a>(plaintext:string|long, K:string|long) : tuple<br>
+Encrypt the string or integer plaintext. K is a random<br>
+parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-sign"><strong>sign</strong></a>(self, M, K)</dt><dd><tt><a href="#object-sign">sign</a>(M : string|long, K:string|long) : tuple<br>
+Return a tuple containing the signature for the message M.<br>
+K is a random parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-unblind"><strong>unblind</strong></a>(self, M, B)</dt><dd><tt><a href="#object-unblind">unblind</a>(M : string|long, B : string|long) : string|long<br>
+Unblind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-validate"><strong>validate</strong></a>(self, M, signature)</dt><dd><tt># alias to compensate for the old <a href="#object-validate">validate</a>() name</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-verify"><strong>verify</strong></a>(self, M, signature)</dt><dd><tt><a href="#object-verify">verify</a>(M:string|long, signature:tuple) : bool<br>
+Verify that the signature is valid for the message M;<br>
+returns true if the signature checks out.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="qNEWobj">class <strong>qNEWobj</strong></a>(<a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="qNEWobj-can_encrypt"><strong>can_encrypt</strong></a>(self)</dt><dd><tt>Return a Boolean value recording whether this algorithm can encrypt data.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-can_sign"><strong>can_sign</strong></a>(self)</dt><dd><tt>Return a Boolean value recording whether this algorithm can generate signatures.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-has_private"><strong>has_private</strong></a>(self)</dt><dd><tt>Return a Boolean denoting whether the <a href="#object">object</a> contains<br>
+private components.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-publickey"><strong>publickey</strong></a>(self)</dt><dd><tt>Return a new key <a href="#object">object</a> containing only the public information.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-size"><strong>size</strong></a>(self)</dt><dd><tt>Return the maximum number of bits that can be handled by this key.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>keydata</strong> = ['p', 'q', 'g', 'y', 'x']</dl>
+
+<hr>
+Methods inherited from <a href="Crypto.PublicKey.pubkey.html#pubkey">Crypto.PublicKey.pubkey.pubkey</a>:<br>
+<dl><dt><a name="qNEWobj-__eq__"><strong>__eq__</strong></a>(self, other)</dt><dd><tt><a href="#qNEWobj-__eq__">__eq__</a>(other): 0, 1<br>
+Compare us to other for equality.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-__getstate__"><strong>__getstate__</strong></a>(self)</dt><dd><tt>To keep key objects platform-independent, the key data is<br>
+converted to standard Python long integers before being<br>
+written out. It will then be reconverted as necessary on<br>
+restoration.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="qNEWobj-__ne__"><strong>__ne__</strong></a>(self, other)</dt><dd><tt><a href="#qNEWobj-__ne__">__ne__</a>(other): 0, 1<br>
+Compare us to other for inequality.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-__setstate__"><strong>__setstate__</strong></a>(self, d)</dt><dd><tt>On unpickling a key <a href="#object">object</a>, the key data is converted to the big<br>
+number representation being used, whether that is Python long<br>
+integers, MPZ objects, or whatever.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-blind"><strong>blind</strong></a>(self, M, B)</dt><dd><tt><a href="#qNEWobj-blind">blind</a>(M : string|long, B : string|long) : string|long<br>
+Blind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-can_blind"><strong>can_blind</strong></a>(self)</dt><dd><tt><a href="#qNEWobj-can_blind">can_blind</a>() : bool<br>
+Return a Boolean value recording whether this algorithm can<br>
+blind data. (This does not imply that this<br>
+particular key <a href="#object">object</a> has the private information required to<br>
+to blind a message.)</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt><a href="#qNEWobj-decrypt">decrypt</a>(ciphertext:tuple|string|long): string<br>
+Decrypt 'ciphertext' using this key.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-encrypt"><strong>encrypt</strong></a>(self, plaintext, K)</dt><dd><tt><a href="#qNEWobj-encrypt">encrypt</a>(plaintext:string|long, K:string|long) : tuple<br>
+Encrypt the string or integer plaintext. K is a random<br>
+parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-sign"><strong>sign</strong></a>(self, M, K)</dt><dd><tt><a href="#qNEWobj-sign">sign</a>(M : string|long, K:string|long) : tuple<br>
+Return a tuple containing the signature for the message M.<br>
+K is a random parameter required by some algorithms.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-unblind"><strong>unblind</strong></a>(self, M, B)</dt><dd><tt><a href="#qNEWobj-unblind">unblind</a>(M : string|long, B : string|long) : string|long<br>
+Unblind message M using blinding factor B.</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-validate"><strong>validate</strong></a>(self, M, signature)</dt><dd><tt># alias to compensate for the old <a href="#qNEWobj-validate">validate</a>() name</tt></dd></dl>
+
+<dl><dt><a name="qNEWobj-verify"><strong>verify</strong></a>(self, M, signature)</dt><dd><tt><a href="#qNEWobj-verify">verify</a>(M:string|long, signature:tuple) : bool<br>
+Verify that the signature is valid for the message M;<br>
+returns true if the signature checks out.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-construct"><strong>construct</strong></a>(tuple)</dt><dd><tt><a href="#-construct">construct</a>(tuple:(long,long,long,long)|(long,long,long,long,long)<br>
+Construct a qNEW <a href="#object">object</a> from a 4- or 5-tuple of numbers.</tt></dd></dl>
+ <dl><dt><a name="-generate"><strong>generate</strong></a>(bits, randfunc, progress_func<font color="#909090">=None</font>)</dt><dd><tt><a href="#-generate">generate</a>(bits:int, randfunc:callable, progress_func:callable)<br>
+ <br>
+Generate a qNEW key of length 'bits', using 'randfunc' to get<br>
+random data and 'progress_func', if present, to display<br>
+the progress of the key generation.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>HASHBITS</strong> = 160<br>
+<strong>__revision__</strong> = '$Id: qNEW.py,v 1.8 2003/04/04 15:13:35 akuchling Exp $'<br>
+<strong>sieve_base</strong> = (2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Util.RFC1751.html b/pydocs/gdata.Crypto.Util.RFC1751.html
new file mode 100644
index 0000000..21fc02e
--- /dev/null
+++ b/pydocs/gdata.Crypto.Util.RFC1751.html
@@ -0,0 +1,48 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.Util.RFC1751</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.Util.html"><font color="#ffffff">Util</font></a>.RFC1751</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Util/RFC1751.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Util/RFC1751.py</a></font></td></tr></table>
+ <p><tt># rfc1751.py : Converts between 128-bit strings and a human-readable<br>
+# sequence of words, as defined in <a href="http://www.rfc-editor.org/rfc/rfc1751.txt">RFC1751</a>: "A Convention for<br>
+# Human-Readable 128-bit Keys", by Daniel L. McDonald.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="string.html">string</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-english_to_key"><strong>english_to_key</strong></a>(str)</dt><dd><tt><a href="#-english_to_key">english_to_key</a>(string):string<br>
+Transform a string into a corresponding key.<br>
+The string must contain words separated by whitespace; the number<br>
+of words must be a multiple of 6.</tt></dd></dl>
+ <dl><dt><a name="-key_to_english"><strong>key_to_english</strong></a>(key)</dt><dd><tt><a href="#-key_to_english">key_to_english</a>(key:string) : string<br>
+Transform an arbitrary key into a string containing English words.<br>
+The key length must be a multiple of 8.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__revision__</strong> = '$Id: RFC1751.py,v 1.6 2003/04/04 15:15:10 akuchling Exp $'<br>
+<strong>binary</strong> = {0: '0000', 1: '0001', 2: '0010', 3: '0011', 4: '0100', 5: '0101', 6: '0110', 7: '0111', 8: '1000', 9: '1001', ...}<br>
+<strong>wordlist</strong> = ['A', 'ABE', 'ACE', 'ACT', 'AD', 'ADA', 'ADD', 'AGO', 'AID', 'AIM', 'AIR', 'ALL', 'ALP', 'AM', 'AMY', 'AN', 'ANA', 'AND', 'ANN', 'ANT', ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Util.html b/pydocs/gdata.Crypto.Util.html
new file mode 100644
index 0000000..f27c80f
--- /dev/null
+++ b/pydocs/gdata.Crypto.Util.html
@@ -0,0 +1,41 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.Crypto.Util</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.Util</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Util/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Util/__init__.py</a></font></td></tr></table>
+ <p><tt>Miscellaneous modules<br>
+ <br>
+Contains useful modules that don't belong into any of the<br>
+other Crypto.* subpackages.<br>
+ <br>
+Crypto.Util.number Number-theoretic functions (primality testing, etc.)<br>
+Crypto.Util.randpool Random number generation<br>
+Crypto.Util.<a href="http://www.rfc-editor.org/rfc/rfc1751.txt">RFC1751</a> Converts between 128-bit keys and human-readable<br>
+ strings of words.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.Crypto.Util.RFC1751.html">RFC1751</a><br>
+</td><td width="25%" valign=top><a href="gdata.Crypto.Util.number.html">number</a><br>
+</td><td width="25%" valign=top><a href="gdata.Crypto.Util.randpool.html">randpool</a><br>
+</td><td width="25%" valign=top><a href="gdata.Crypto.Util.test.html">test</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__all__</strong> = ['randpool', 'RFC1751', 'number']<br>
+<strong>__revision__</strong> = '$Id: __init__.py,v 1.4 2003/02/28 15:26:00 akuchling Exp $'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Util.number.html b/pydocs/gdata.Crypto.Util.number.html
new file mode 100644
index 0000000..3a07185
--- /dev/null
+++ b/pydocs/gdata.Crypto.Util.number.html
@@ -0,0 +1,72 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.Util.number</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.Util.html"><font color="#ffffff">Util</font></a>.number</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Util/number.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Util/number.py</a></font></td></tr></table>
+ <p><tt># number.py : Number-theoretic functions<br>
+#<br>
+# Part of the Python Cryptography Toolkit<br>
+#<br>
+# Distribute and use freely; there are no restrictions on further<br>
+# dissemination and usage except those imposed by the laws of your<br>
+# country of residence. This software is provided "as is" without<br>
+# warranty of fitness for use or suitability for any purpose, express<br>
+# or implied. Use at your own risk or not at all.<br>
+#</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.PublicKey._fastmath.html">Crypto.PublicKey._fastmath</a><br>
+</td><td width="25%" valign=top><a href="struct.html">struct</a><br>
+</td><td width="25%" valign=top><a href="warnings.html">warnings</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-GCD"><strong>GCD</strong></a>(x, y)</dt><dd><tt><a href="#-GCD">GCD</a>(x:long, y:long): long<br>
+Return the GCD of x and y.</tt></dd></dl>
+ <dl><dt><a name="-bytes_to_long"><strong>bytes_to_long</strong></a>(s)</dt><dd><tt><a href="#-bytes_to_long">bytes_to_long</a>(string) : long<br>
+Convert a byte string to a long integer.<br>
+ <br>
+This is (essentially) the inverse of <a href="#-long_to_bytes">long_to_bytes</a>().</tt></dd></dl>
+ <dl><dt><a name="-getPrime"><strong>getPrime</strong></a>(N, randfunc)</dt><dd><tt><a href="#-getPrime">getPrime</a>(N:int, randfunc:callable):long<br>
+Return a random N-bit prime number.</tt></dd></dl>
+ <dl><dt><a name="-getRandomNumber"><strong>getRandomNumber</strong></a>(N, randfunc)</dt><dd><tt><a href="#-getRandomNumber">getRandomNumber</a>(N:int, randfunc:callable):long<br>
+Return an N-bit random number.</tt></dd></dl>
+ <dl><dt><a name="-inverse"><strong>inverse</strong></a>(u, v)</dt><dd><tt><a href="#-inverse">inverse</a>(u:long, u:long):long<br>
+Return the inverse of u mod v.</tt></dd></dl>
+ <dl><dt><a name="-isPrime"><strong>isPrime</strong></a>(N)</dt><dd><tt><a href="#-isPrime">isPrime</a>(N:long):bool<br>
+Return true if N is prime.</tt></dd></dl>
+ <dl><dt><a name="-long2str"><strong>long2str</strong></a>(n, blocksize<font color="#909090">=0</font>)</dt></dl>
+ <dl><dt><a name="-long_to_bytes"><strong>long_to_bytes</strong></a>(n, blocksize<font color="#909090">=0</font>)</dt><dd><tt><a href="#-long_to_bytes">long_to_bytes</a>(n:long, blocksize:int) : string<br>
+Convert a long integer to a byte string.<br>
+ <br>
+If optional blocksize is given and greater than zero, pad the front of the<br>
+byte string with binary zeros so that the length is a multiple of<br>
+blocksize.</tt></dd></dl>
+ <dl><dt><a name="-size"><strong>size</strong></a>(N)</dt><dd><tt><a href="#-size">size</a>(N:long) : int<br>
+Returns the size of the number N in bits.</tt></dd></dl>
+ <dl><dt><a name="-str2long"><strong>str2long</strong></a>(s)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__revision__</strong> = '$Id: number.py,v 1.13 2003/04/04 18:21:07 akuchling Exp $'<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.Util.randpool.html b/pydocs/gdata.Crypto.Util.randpool.html
new file mode 100644
index 0000000..06681a6
--- /dev/null
+++ b/pydocs/gdata.Crypto.Util.randpool.html
@@ -0,0 +1,230 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.Crypto.Util.randpool</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.Crypto.html"><font color="#ffffff">Crypto</font></a>.<a href="gdata.Crypto.Util.html"><font color="#ffffff">Util</font></a>.randpool</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Util/randpool.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/Util/randpool.py</a></font></td></tr></table>
+ <p><tt># randpool.py : Cryptographically strong random number generation<br>
+#<br>
+# Part of the Python Cryptography Toolkit<br>
+#<br>
+# Distribute and use freely; there are no restrictions on further<br>
+# dissemination and usage except those imposed by the laws of your<br>
+# country of residence. This software is provided "as is" without<br>
+# warranty of fitness for use or suitability for any purpose, express<br>
+# or implied. Use at your own risk or not at all.<br>
+#</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="array.html">array</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="termios.html">termios</a><br>
+<a href="time.html">time</a><br>
+</td><td width="25%" valign=top><a href="types.html">types</a><br>
+<a href="warnings.html">warnings</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.Util.randpool.html#KeyboardEntry">KeyboardEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.Crypto.Util.randpool.html#RandomPool">RandomPool</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.Util.randpool.html#PersistentRandomPool">PersistentRandomPool</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.Crypto.Util.randpool.html#KeyboardRandomPool">KeyboardRandomPool</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="KeyboardEntry">class <strong>KeyboardEntry</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="KeyboardEntry-__init__"><strong>__init__</strong></a>(self, fd<font color="#909090">=0</font>)</dt></dl>
+
+<dl><dt><a name="KeyboardEntry-close"><strong>close</strong></a>(self, delay<font color="#909090">=0</font>)</dt></dl>
+
+<dl><dt><a name="KeyboardEntry-getch"><strong>getch</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="KeyboardRandomPool">class <strong>KeyboardRandomPool</strong></a>(<a href="gdata.Crypto.Util.randpool.html#PersistentRandomPool">PersistentRandomPool</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.Crypto.Util.randpool.html#KeyboardRandomPool">KeyboardRandomPool</a></dd>
+<dd><a href="gdata.Crypto.Util.randpool.html#PersistentRandomPool">PersistentRandomPool</a></dd>
+<dd><a href="gdata.Crypto.Util.randpool.html#RandomPool">RandomPool</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="KeyboardRandomPool-__init__"><strong>__init__</strong></a>(self, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="KeyboardRandomPool-randomize"><strong>randomize</strong></a>(self, N<font color="#909090">=0</font>)</dt><dd><tt>Adds N bits of entropy to random pool. If N is 0, fill up pool.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.Crypto.Util.randpool.html#PersistentRandomPool">PersistentRandomPool</a>:<br>
+<dl><dt><a name="KeyboardRandomPool-save"><strong>save</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.Crypto.Util.randpool.html#RandomPool">RandomPool</a>:<br>
+<dl><dt><a name="KeyboardRandomPool-addEvent"><strong>addEvent</strong></a>(self, event, s<font color="#909090">=''</font>)</dt></dl>
+
+<dl><dt><a name="KeyboardRandomPool-add_event"><strong>add_event</strong></a>(self, s<font color="#909090">=''</font>)</dt><dd><tt><a href="#KeyboardRandomPool-add_event">add_event</a>(s:string)<br>
+Add an event to the random pool. The current time is stored<br>
+between calls and used to estimate the entropy. The optional<br>
+'s' parameter is a string that will also be XORed into the pool.<br>
+Returns the estimated number of additional bits of entropy gain.</tt></dd></dl>
+
+<dl><dt><a name="KeyboardRandomPool-getBytes"><strong>getBytes</strong></a>(self, N)</dt><dd><tt># Deprecated method names: remove in PCT 2.1 or later.</tt></dd></dl>
+
+<dl><dt><a name="KeyboardRandomPool-get_bytes"><strong>get_bytes</strong></a>(self, N)</dt><dd><tt><a href="#KeyboardRandomPool-get_bytes">get_bytes</a>(N:int) : string<br>
+Return N bytes of random data.</tt></dd></dl>
+
+<dl><dt><a name="KeyboardRandomPool-stir"><strong>stir</strong></a>(self, s<font color="#909090">=''</font>)</dt><dd><tt><a href="#KeyboardRandomPool-stir">stir</a>(s:string)<br>
+Mix up the randomness pool. This will call <a href="#KeyboardRandomPool-add_event">add_event</a>() twice,<br>
+but out of paranoia the entropy attribute will not be<br>
+increased. The optional 's' parameter is a string that will<br>
+be hashed with the randomness pool.</tt></dd></dl>
+
+<dl><dt><a name="KeyboardRandomPool-stir_n"><strong>stir_n</strong></a>(self, N<font color="#909090">=3</font>)</dt><dd><tt><a href="#KeyboardRandomPool-stir_n">stir_n</a>(N)<br>
+stirs the random pool N times</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PersistentRandomPool">class <strong>PersistentRandomPool</strong></a>(<a href="gdata.Crypto.Util.randpool.html#RandomPool">RandomPool</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="PersistentRandomPool-__init__"><strong>__init__</strong></a>(self, filename<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="PersistentRandomPool-save"><strong>save</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.Crypto.Util.randpool.html#RandomPool">RandomPool</a>:<br>
+<dl><dt><a name="PersistentRandomPool-addEvent"><strong>addEvent</strong></a>(self, event, s<font color="#909090">=''</font>)</dt></dl>
+
+<dl><dt><a name="PersistentRandomPool-add_event"><strong>add_event</strong></a>(self, s<font color="#909090">=''</font>)</dt><dd><tt><a href="#PersistentRandomPool-add_event">add_event</a>(s:string)<br>
+Add an event to the random pool. The current time is stored<br>
+between calls and used to estimate the entropy. The optional<br>
+'s' parameter is a string that will also be XORed into the pool.<br>
+Returns the estimated number of additional bits of entropy gain.</tt></dd></dl>
+
+<dl><dt><a name="PersistentRandomPool-getBytes"><strong>getBytes</strong></a>(self, N)</dt><dd><tt># Deprecated method names: remove in PCT 2.1 or later.</tt></dd></dl>
+
+<dl><dt><a name="PersistentRandomPool-get_bytes"><strong>get_bytes</strong></a>(self, N)</dt><dd><tt><a href="#PersistentRandomPool-get_bytes">get_bytes</a>(N:int) : string<br>
+Return N bytes of random data.</tt></dd></dl>
+
+<dl><dt><a name="PersistentRandomPool-randomize"><strong>randomize</strong></a>(self, N<font color="#909090">=0</font>)</dt><dd><tt><a href="#PersistentRandomPool-randomize">randomize</a>(N:int)<br>
+use the class entropy source to get some entropy data.<br>
+This is overridden by KeyboardRandomize().</tt></dd></dl>
+
+<dl><dt><a name="PersistentRandomPool-stir"><strong>stir</strong></a>(self, s<font color="#909090">=''</font>)</dt><dd><tt><a href="#PersistentRandomPool-stir">stir</a>(s:string)<br>
+Mix up the randomness pool. This will call <a href="#PersistentRandomPool-add_event">add_event</a>() twice,<br>
+but out of paranoia the entropy attribute will not be<br>
+increased. The optional 's' parameter is a string that will<br>
+be hashed with the randomness pool.</tt></dd></dl>
+
+<dl><dt><a name="PersistentRandomPool-stir_n"><strong>stir_n</strong></a>(self, N<font color="#909090">=3</font>)</dt><dd><tt><a href="#PersistentRandomPool-stir_n">stir_n</a>(N)<br>
+stirs the random pool N times</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RandomPool">class <strong>RandomPool</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>randpool.py : Cryptographically strong random number generation.<br>
+ <br>
+The implementation here is similar to the one in PGP. To be<br>
+cryptographically strong, it must be difficult to determine the RNG's<br>
+output, whether in the future or the past. This is done by using<br>
+a cryptographic hash function to "stir" the random data.<br>
+ <br>
+Entropy is gathered in the same fashion as PGP; the highest-resolution<br>
+clock around is read and the data is added to the random number pool.<br>
+A conservative estimate of the entropy is then kept.<br>
+ <br>
+If a cryptographically secure random source is available (/dev/urandom<br>
+on many Unixes, Windows CryptGenRandom on most Windows), then use<br>
+it.<br>
+ <br>
+Instance Attributes:<br>
+bits : int<br>
+ Maximum size of pool in bits<br>
+bytes : int<br>
+ Maximum size of pool in bytes<br>
+entropy : int<br>
+ Number of bits of entropy in this pool.<br>
+ <br>
+Methods:<br>
+<a href="#RandomPool-add_event">add_event</a>([s]) : add some entropy to the pool<br>
+<a href="#RandomPool-get_bytes">get_bytes</a>(int) : get N bytes of random data<br>
+<a href="#RandomPool-randomize">randomize</a>([N]) : get N bytes of randomness from external source<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="RandomPool-__init__"><strong>__init__</strong></a>(self, numbytes<font color="#909090">=160</font>, cipher<font color="#909090">=None</font>, hash<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="RandomPool-addEvent"><strong>addEvent</strong></a>(self, event, s<font color="#909090">=''</font>)</dt></dl>
+
+<dl><dt><a name="RandomPool-add_event"><strong>add_event</strong></a>(self, s<font color="#909090">=''</font>)</dt><dd><tt><a href="#RandomPool-add_event">add_event</a>(s:string)<br>
+Add an event to the random pool. The current time is stored<br>
+between calls and used to estimate the entropy. The optional<br>
+'s' parameter is a string that will also be XORed into the pool.<br>
+Returns the estimated number of additional bits of entropy gain.</tt></dd></dl>
+
+<dl><dt><a name="RandomPool-getBytes"><strong>getBytes</strong></a>(self, N)</dt><dd><tt># Deprecated method names: remove in PCT 2.1 or later.</tt></dd></dl>
+
+<dl><dt><a name="RandomPool-get_bytes"><strong>get_bytes</strong></a>(self, N)</dt><dd><tt><a href="#RandomPool-get_bytes">get_bytes</a>(N:int) : string<br>
+Return N bytes of random data.</tt></dd></dl>
+
+<dl><dt><a name="RandomPool-randomize"><strong>randomize</strong></a>(self, N<font color="#909090">=0</font>)</dt><dd><tt><a href="#RandomPool-randomize">randomize</a>(N:int)<br>
+use the class entropy source to get some entropy data.<br>
+This is overridden by KeyboardRandomize().</tt></dd></dl>
+
+<dl><dt><a name="RandomPool-stir"><strong>stir</strong></a>(self, s<font color="#909090">=''</font>)</dt><dd><tt><a href="#RandomPool-stir">stir</a>(s:string)<br>
+Mix up the randomness pool. This will call <a href="#RandomPool-add_event">add_event</a>() twice,<br>
+but out of paranoia the entropy attribute will not be<br>
+increased. The optional 's' parameter is a string that will<br>
+be hashed with the randomness pool.</tt></dd></dl>
+
+<dl><dt><a name="RandomPool-stir_n"><strong>stir_n</strong></a>(self, N<font color="#909090">=3</font>)</dt><dd><tt><a href="#RandomPool-stir_n">stir_n</a>(N)<br>
+stirs the random pool N times</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>STIRNUM</strong> = 3<br>
+<strong>__revision__</strong> = '$Id: randpool.py,v 1.14 2004/05/06 12:56:54 akuchling Exp $'<br>
+<strong>winrandom</strong> = None</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.Crypto.html b/pydocs/gdata.Crypto.html
new file mode 100644
index 0000000..2423f2b
--- /dev/null
+++ b/pydocs/gdata.Crypto.html
@@ -0,0 +1,51 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.Crypto</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.Crypto</strong></big></big> (version 2.0.1)</font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/Crypto/__init__.py</a></font></td></tr></table>
+ <p><tt>Python Cryptography Toolkit<br>
+ <br>
+A collection of cryptographic modules implementing various algorithms<br>
+and protocols.<br>
+ <br>
+Subpackages:<br>
+Crypto.Cipher Secret-key encryption algorithms (AES, DES, ARC4)<br>
+Crypto.Hash Hashing algorithms (MD5, SHA, HMAC)<br>
+Crypto.Protocol Cryptographic protocols (Chaffing, all-or-nothing<br>
+ transform). This package does not contain any<br>
+ network protocols.<br>
+Crypto.PublicKey Public-key encryption and signature algorithms<br>
+ (RSA, DSA)<br>
+Crypto.Util Various useful modules and functions (long-to-string<br>
+ conversion, random number generation, number<br>
+ theoretic functions)</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.Crypto.Cipher.html"><strong>Cipher</strong> (package)</a><br>
+<a href="gdata.Crypto.Hash.html"><strong>Hash</strong> (package)</a><br>
+</td><td width="25%" valign=top><a href="gdata.Crypto.Protocol.html"><strong>Protocol</strong> (package)</a><br>
+<a href="gdata.Crypto.PublicKey.html"><strong>PublicKey</strong> (package)</a><br>
+</td><td width="25%" valign=top><a href="gdata.Crypto.Util.html"><strong>Util</strong> (package)</a><br>
+<a href="gdata.Crypto.test.html">test</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__all__</strong> = ['Cipher', 'Hash', 'Protocol', 'PublicKey', 'Util']<br>
+<strong>__revision__</strong> = '$Id: __init__.py,v 1.12 2005/06/14 01:20:22 akuchling Exp $'<br>
+<strong>__version__</strong> = '2.0.1'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.acl.data.html b/pydocs/gdata.acl.data.html
new file mode 100644
index 0000000..9cb44e8
--- /dev/null
+++ b/pydocs/gdata.acl.data.html
@@ -0,0 +1,1342 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.acl.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.acl.html"><font color="#ffffff">acl</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/acl/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/acl/data.py</a></font></td></tr></table>
+ <p><tt>Contains the data classes of the Google Access Control List (ACL) Extension</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclAdditionalRole">AclAdditionalRole</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclRole">AclRole</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclScope">AclScope</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclWithKey">AclWithKey</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclEntry">AclEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclFeed">AclFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AclAdditionalRole">class <strong>AclAdditionalRole</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an additionalRole element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.acl.data.html#AclAdditionalRole">AclAdditionalRole</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AclAdditionalRole-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclAdditionalRole-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclAdditionalRole-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclAdditionalRole-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclAdditionalRole-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AclAdditionalRole-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AclAdditionalRole-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclAdditionalRole-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclAdditionalRole-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclAdditionalRole-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AclEntry">class <strong>AclEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an entry in a feed of an access control list (ACL).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.acl.data.html#AclEntry">AclEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>additional_role</strong> = <class 'gdata.acl.data.AclAdditionalRole'><dd><tt>Describes an additionalRole element.</tt></dl>
+
+<dl><dt><strong>role</strong> = <class 'gdata.acl.data.AclRole'><dd><tt>Describes the role of an entry in an access control list.</tt></dl>
+
+<dl><dt><strong>scope</strong> = <class 'gdata.acl.data.AclScope'><dd><tt>Describes the scope of an entry in an access control list.</tt></dl>
+
+<dl><dt><strong>with_key</strong> = <class 'gdata.acl.data.AclWithKey'><dd><tt>Describes a key that can be used to access a document.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="AclEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="AclEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AclEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AclFeed">class <strong>AclFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a feed of an access control list (ACL).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.acl.data.html#AclFeed">AclFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.acl.data.AclEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="AclFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="AclFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AclFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AclRole">class <strong>AclRole</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the role of an entry in an access control list.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.acl.data.html#AclRole">AclRole</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AclRole-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclRole-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclRole-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclRole-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclRole-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AclRole-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AclRole-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclRole-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclRole-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclRole-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AclScope">class <strong>AclScope</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the scope of an entry in an access control list.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.acl.data.html#AclScope">AclScope</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AclScope-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclScope-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclScope-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclScope-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclScope-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AclScope-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AclScope-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclScope-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclScope-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclScope-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AclWithKey">class <strong>AclWithKey</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a key that can be used to access a document.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.acl.data.html#AclWithKey">AclWithKey</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>additional_role</strong> = <class 'gdata.acl.data.AclAdditionalRole'><dd><tt>Describes an additionalRole element.</tt></dl>
+
+<dl><dt><strong>key</strong> = 'key'</dl>
+
+<dl><dt><strong>role</strong> = <class 'gdata.acl.data.AclRole'><dd><tt>Describes the role of an entry in an access control list.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AclWithKey-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclWithKey-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclWithKey-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclWithKey-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclWithKey-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AclWithKey-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AclWithKey-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclWithKey-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclWithKey-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclWithKey-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GACL_TEMPLATE</strong> = '{http://schemas.google.com/acl/2007}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.acl.html b/pydocs/gdata.acl.html
new file mode 100644
index 0000000..5dfccb7
--- /dev/null
+++ b/pydocs/gdata.acl.html
@@ -0,0 +1,34 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.acl</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.acl</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/acl/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/acl/__init__.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.acl.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.alt.app_engine.html b/pydocs/gdata.alt.app_engine.html
new file mode 100644
index 0000000..60df6fb
--- /dev/null
+++ b/pydocs/gdata.alt.app_engine.html
@@ -0,0 +1,405 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.alt.app_engine</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.alt.html"><font color="#ffffff">alt</font></a>.app_engine</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/alt/app_engine.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/alt/app_engine.py</a></font></td></tr></table>
+ <p><tt>Provides functions to persist serialized auth tokens in the datastore.<br>
+ <br>
+The get_token and set_token functions should be used in conjunction with<br>
+gdata.gauth's token_from_blob and token_to_blob to allow auth token objects<br>
+to be reused across requests. It is up to your own code to ensure that the<br>
+token key's are unique.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="google.appengine.ext.db.html">google.appengine.ext.db</a><br>
+</td><td width="25%" valign=top><a href="google.appengine.api.memcache.html">google.appengine.api.memcache</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.alt.app_engine.html#Token">Token</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Token">class <strong>Token</strong></a>(<a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Datastore <a href="google.appengine.ext.db.html#Model">Model</a> which stores a serialized auth token.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.alt.app_engine.html#Token">Token</a></dd>
+<dd><a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>t</strong></dt>
+<dd><tt>A byte string that can be longer than 500 bytes.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br>
+<dl><dt><a name="Token-__init__"><strong>__init__</strong></a>(self, parent<font color="#909090">=None</font>, key_name<font color="#909090">=None</font>, _app<font color="#909090">=None</font>, _from_entity<font color="#909090">=False</font>, **kwds)</dt><dd><tt>Creates a new instance of this model.<br>
+ <br>
+To create a new entity, you instantiate a model and then call <a href="#Token-put">put</a>(),<br>
+which saves the entity to the datastore:<br>
+ <br>
+ person = Person()<br>
+ person.name = 'Bret'<br>
+ person.<a href="#Token-put">put</a>()<br>
+ <br>
+You can initialize properties in the model in the constructor with keyword<br>
+arguments:<br>
+ <br>
+ person = Person(name='Bret')<br>
+ <br>
+We initialize all other properties to the default value (as defined by the<br>
+properties in the model definition) if they are not provided in the<br>
+constructor.<br>
+ <br>
+Args:<br>
+ parent: Parent instance for this instance or None, indicating a top-<br>
+ level instance.<br>
+ key_name: Name for new model instance.<br>
+ _from_entity: Intentionally undocumented.<br>
+ kwds: Keyword arguments mapping to properties of model. Also:<br>
+ key: Key instance for this instance, if provided makes parent and<br>
+ key_name redundant (they do not need to be set but if they are<br>
+ they must match the key).</tt></dd></dl>
+
+<dl><dt><a name="Token-delete"><strong>delete</strong></a>(self, **kwargs)</dt><dd><tt>Deletes this entity from the datastore.<br>
+ <br>
+Args:<br>
+ config: datastore_rpc.Configuration to use for this request.<br>
+ <br>
+Raises:<br>
+ TransactionFailedError if the data could not be committed.</tt></dd></dl>
+
+<dl><dt><a name="Token-dynamic_properties"><strong>dynamic_properties</strong></a>(self)</dt><dd><tt>Returns a list of all dynamic properties defined for instance.</tt></dd></dl>
+
+<dl><dt><a name="Token-has_key"><strong>has_key</strong></a>(self)</dt><dd><tt>Determine if this model instance has a complete key.<br>
+ <br>
+When not using a fully self-assigned Key, ids are not assigned until the<br>
+data is saved to the Datastore, but instances with a key name always have<br>
+a full key.<br>
+ <br>
+Returns:<br>
+ True if the object has been persisted to the datastore or has a key<br>
+ or has a key_name, otherwise False.</tt></dd></dl>
+
+<dl><dt><a name="Token-instance_properties"><strong>instance_properties</strong></a>(self)</dt><dd><tt>Alias for dyanmic_properties.</tt></dd></dl>
+
+<dl><dt><a name="Token-is_saved"><strong>is_saved</strong></a>(self)</dt><dd><tt>Determine if entity is persisted in the datastore.<br>
+ <br>
+New instances of <a href="google.appengine.ext.db.html#Model">Model</a> do not start out saved in the data. Objects which<br>
+are saved to or loaded from the Datastore will have a True saved state.<br>
+ <br>
+Returns:<br>
+ True if object has been persisted to the datastore, otherwise False.</tt></dd></dl>
+
+<dl><dt><a name="Token-key"><strong>key</strong></a>(self)</dt><dd><tt>Unique key for this entity.<br>
+ <br>
+This property is only available if this entity is already stored in the<br>
+datastore or if it has a full key, so it is available if this entity was<br>
+fetched returned from a query, or after <a href="#Token-put">put</a>() is called the first time<br>
+for new entities, or if a complete key was given when constructed.<br>
+ <br>
+Returns:<br>
+ Datastore key of persisted entity.<br>
+ <br>
+Raises:<br>
+ NotSavedError when entity is not persistent.</tt></dd></dl>
+
+<dl><dt><a name="Token-parent"><strong>parent</strong></a>(self)</dt><dd><tt>Get the parent of the model instance.<br>
+ <br>
+Returns:<br>
+ Parent of contained entity or parent provided in constructor, None if<br>
+ instance has no parent.</tt></dd></dl>
+
+<dl><dt><a name="Token-parent_key"><strong>parent_key</strong></a>(self)</dt><dd><tt>Get the parent's key.<br>
+ <br>
+This method is useful for avoiding a potential fetch from the datastore<br>
+but still get information about the instances parent.<br>
+ <br>
+Returns:<br>
+ Parent key of entity, None if there is no parent.</tt></dd></dl>
+
+<dl><dt><a name="Token-put"><strong>put</strong></a>(self, **kwargs)</dt><dd><tt>Writes this model instance to the datastore.<br>
+ <br>
+If this instance is new, we add an entity to the datastore.<br>
+Otherwise, we update this instance, and the key will remain the<br>
+same.<br>
+ <br>
+Args:<br>
+ config: datastore_rpc.Configuration to use for this request.<br>
+ <br>
+Returns:<br>
+ The key of the instance (either the existing key or a new key).<br>
+ <br>
+Raises:<br>
+ TransactionFailedError if the data could not be committed.</tt></dd></dl>
+
+<dl><dt><a name="Token-save"><strong>save</strong></a> = put(self, **kwargs)</dt><dd><tt>Writes this model instance to the datastore.<br>
+ <br>
+If this instance is new, we add an entity to the datastore.<br>
+Otherwise, we update this instance, and the key will remain the<br>
+same.<br>
+ <br>
+Args:<br>
+ config: datastore_rpc.Configuration to use for this request.<br>
+ <br>
+Returns:<br>
+ The key of the instance (either the existing key or a new key).<br>
+ <br>
+Raises:<br>
+ TransactionFailedError if the data could not be committed.</tt></dd></dl>
+
+<dl><dt><a name="Token-to_xml"><strong>to_xml</strong></a>(self, _entity_class<font color="#909090">=<class 'google.appengine.api.datastore.Entity'></font>)</dt><dd><tt>Generate an XML representation of this model instance.<br>
+ <br>
+atom and gd:namespace properties are converted to XML according to their<br>
+respective schemas. For more information, see:<br>
+ <br>
+ <a href="http://www.atomenabled.org/developers/syndication/">http://www.atomenabled.org/developers/syndication/</a><br>
+ <a href="http://code.google.com/apis/gdata/common-elements.html">http://code.google.com/apis/gdata/common-elements.html</a></tt></dd></dl>
+
+<hr>
+Class methods inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br>
+<dl><dt><a name="Token-all"><strong>all</strong></a>(cls, **kwds)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns a query over all instances of this model from the datastore.<br>
+ <br>
+Returns:<br>
+ Query that will retrieve all instances from entity collection.</tt></dd></dl>
+
+<dl><dt><a name="Token-entity_type"><strong>entity_type</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Soon to be removed alias for kind.</tt></dd></dl>
+
+<dl><dt><a name="Token-fields"><strong>fields</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Soon to be removed alias for properties.</tt></dd></dl>
+
+<dl><dt><a name="Token-from_entity"><strong>from_entity</strong></a>(cls, entity)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Converts the entity representation of this model to an instance.<br>
+ <br>
+Converts datastore.Entity instance to an instance of cls.<br>
+ <br>
+Args:<br>
+ entity: Entity loaded directly from datastore.<br>
+ <br>
+Raises:<br>
+ KindError when cls is incorrect model for entity.</tt></dd></dl>
+
+<dl><dt><a name="Token-get"><strong>get</strong></a>(cls, keys, **kwargs)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Fetch instance from the datastore of a specific <a href="google.appengine.ext.db.html#Model">Model</a> type using key.<br>
+ <br>
+We support Key objects and string keys (we convert them to Key objects<br>
+automatically).<br>
+ <br>
+Useful for ensuring that specific instance types are retrieved from the<br>
+datastore. It also helps that the source code clearly indicates what<br>
+kind of object is being retreived. Example:<br>
+ <br>
+ story = Story.<a href="#Token-get">get</a>(story_key)<br>
+ <br>
+Args:<br>
+ keys: Key within datastore entity collection to find; or string key;<br>
+ or list of Keys or string keys.<br>
+ config: datastore_rpc.Configuration to use for this request.<br>
+ <br>
+Returns:<br>
+ If a single key was given: a <a href="google.appengine.ext.db.html#Model">Model</a> instance associated with key<br>
+ for provided class if it exists in the datastore, otherwise<br>
+ None; if a list of keys was given: a list whose items are either<br>
+ a <a href="google.appengine.ext.db.html#Model">Model</a> instance or None.<br>
+ <br>
+Raises:<br>
+ KindError if any of the retreived objects are not instances of the<br>
+ type associated with call to 'get'.</tt></dd></dl>
+
+<dl><dt><a name="Token-get_by_id"><strong>get_by_id</strong></a>(cls, ids, parent<font color="#909090">=None</font>, **kwargs)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Get instance of <a href="google.appengine.ext.db.html#Model">Model</a> class by id.<br>
+ <br>
+Args:<br>
+ key_names: A single id or a list of ids.<br>
+ parent: Parent of instances to get. Can be a model or key.<br>
+ config: datastore_rpc.Configuration to use for this request.</tt></dd></dl>
+
+<dl><dt><a name="Token-get_by_key_name"><strong>get_by_key_name</strong></a>(cls, key_names, parent<font color="#909090">=None</font>, **kwargs)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Get instance of <a href="google.appengine.ext.db.html#Model">Model</a> class by its key's name.<br>
+ <br>
+Args:<br>
+ key_names: A single key-name or a list of key-names.<br>
+ parent: Parent of instances to get. Can be a model or key.<br>
+ config: datastore_rpc.Configuration to use for this request.</tt></dd></dl>
+
+<dl><dt><a name="Token-get_or_insert"><strong>get_or_insert</strong></a>(cls, key_name, **kwds)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Transactionally retrieve or create an instance of <a href="google.appengine.ext.db.html#Model">Model</a> class.<br>
+ <br>
+This acts much like the Python dictionary setdefault() method, where we<br>
+first try to retrieve a <a href="google.appengine.ext.db.html#Model">Model</a> instance with the given key name and parent.<br>
+If it's not present, then we create a new instance (using the *kwds<br>
+supplied) and insert that with the supplied key name.<br>
+ <br>
+Subsequent calls to this method with the same key_name and parent will<br>
+always yield the same entity (though not the same actual object instance),<br>
+regardless of the *kwds supplied. If the specified entity has somehow<br>
+been deleted separately, then the next call will create a new entity and<br>
+return it.<br>
+ <br>
+If the 'parent' keyword argument is supplied, it must be a <a href="google.appengine.ext.db.html#Model">Model</a> instance.<br>
+It will be used as the parent of the new instance of this <a href="google.appengine.ext.db.html#Model">Model</a> class if<br>
+one is created.<br>
+ <br>
+This method is especially useful for having just one unique entity for<br>
+a specific identifier. Insertion/retrieval is done transactionally, which<br>
+guarantees uniqueness.<br>
+ <br>
+Example usage:<br>
+ <br>
+ class WikiTopic(db.<a href="google.appengine.ext.db.html#Model">Model</a>):<br>
+ creation_date = db.DatetimeProperty(auto_now_add=True)<br>
+ body = db.TextProperty(required=True)<br>
+ <br>
+ # The first time through we'll create the new topic.<br>
+ wiki_word = 'CommonIdioms'<br>
+ topic = WikiTopic.<a href="#Token-get_or_insert">get_or_insert</a>(wiki_word,<br>
+ body='This topic is totally new!')<br>
+ assert topic.<a href="#Token-key">key</a>().name() == 'CommonIdioms'<br>
+ assert topic.body == 'This topic is totally new!'<br>
+ <br>
+ # The second time through will just retrieve the entity.<br>
+ overwrite_topic = WikiTopic.<a href="#Token-get_or_insert">get_or_insert</a>(wiki_word,<br>
+ body='A totally different message!')<br>
+ assert topic.<a href="#Token-key">key</a>().name() == 'CommonIdioms'<br>
+ assert topic.body == 'This topic is totally new!'<br>
+ <br>
+Args:<br>
+ key_name: Key name to retrieve or create.<br>
+ **kwds: Keyword arguments to pass to the constructor of the model class<br>
+ if an instance for the specified key name does not already exist. If<br>
+ an instance with the supplied key_name and parent already exists, the<br>
+ rest of these arguments will be discarded.<br>
+ <br>
+Returns:<br>
+ Existing instance of <a href="google.appengine.ext.db.html#Model">Model</a> class with the specified key_name and parent<br>
+ or a new one that has just been created.<br>
+ <br>
+Raises:<br>
+ TransactionFailedError if the specified <a href="google.appengine.ext.db.html#Model">Model</a> instance could not be<br>
+ retrieved or created transactionally (due to high contention, etc).</tt></dd></dl>
+
+<dl><dt><a name="Token-gql"><strong>gql</strong></a>(cls, query_string, *args, **kwds)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns a query using GQL query string.<br>
+ <br>
+See appengine/ext/gql for more information about GQL.<br>
+ <br>
+Args:<br>
+ query_string: properly formatted GQL query string with the<br>
+ 'SELECT * FROM <entity>' part omitted<br>
+ *args: rest of the positional arguments used to bind numeric references<br>
+ in the query.<br>
+ **kwds: dictionary-based arguments (for named parameters).</tt></dd></dl>
+
+<dl><dt><a name="Token-kind"><strong>kind</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns the datastore kind we use for this model.<br>
+ <br>
+We just use the name of the model for now, ignoring potential collisions.</tt></dd></dl>
+
+<dl><dt><a name="Token-properties"><strong>properties</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns a dictionary of all the properties defined for this model.</tt></dd></dl>
+
+<hr>
+Static methods inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br>
+<dl><dt><a name="Token-__new__"><strong>__new__</strong></a>(*args, **unused_kwds)</dt><dd><tt>Allow subclasses to call <a href="#Token-__new__">__new__</a>() with arguments.<br>
+ <br>
+Do NOT list 'cls' as the first argument, or in the case when<br>
+the 'unused_kwds' dictionary contains the key 'cls', the function<br>
+will complain about multiple argument values for 'cls'.<br>
+ <br>
+Raises:<br>
+ TypeError if there are no positional arguments.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br>
+<dl><dt><strong>__metaclass__</strong> = <class 'google.appengine.ext.db.PropertiedClass'><dd><tt>Meta-class for initializing <a href="google.appengine.ext.db.html#Model">Model</a> classes properties.<br>
+ <br>
+Used for initializing Properties defined in the context of a model.<br>
+By using a meta-class much of the configuration of a Property<br>
+descriptor becomes implicit. By using this meta-class, descriptors<br>
+that are of class <a href="google.appengine.ext.db.html#Model">Model</a> are notified about which class they<br>
+belong to and what attribute they are associated with and can<br>
+do appropriate initialization via __property_config__.<br>
+ <br>
+Duplicate properties are not permitted.</tt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-delete_token"><strong>delete_token</strong></a>(unique_key)</dt></dl>
+ <dl><dt><a name="-get_token"><strong>get_token</strong></a>(unique_key)</dt><dd><tt>Searches for a stored token with the desired key.<br>
+ <br>
+Checks memcache and then the datastore if required.<br>
+ <br>
+Args:<br>
+ unique_key: str which uniquely identifies the desired auth token.<br>
+ <br>
+Returns:<br>
+ A string encoding the auth token data. Use gdata.gauth.token_from_blob to<br>
+ convert back into a usable token object. None if the token was not found<br>
+ in memcache or the datastore.</tt></dd></dl>
+ <dl><dt><a name="-set_token"><strong>set_token</strong></a>(unique_key, token_str)</dt><dd><tt>Saves the serialized auth token in the datastore.<br>
+ <br>
+The token is also stored in memcache to speed up retrieval on a cache hit.<br>
+ <br>
+Args:<br>
+ unique_key: The unique name for this token as a string. It is up to your<br>
+ code to ensure that this token value is unique in your application.<br>
+ Previous values will be silently overwitten.<br>
+ token_str: A serialized auth token as a string. I expect that this string<br>
+ will be generated by gdata.gauth.token_to_blob.<br>
+ <br>
+Returns:<br>
+ True if the token was stored sucessfully, False if the token could not be<br>
+ safely cached (if an old value could not be cleared). If the token was<br>
+ set in memcache, but not in the datastore, this function will return None.<br>
+ However, in that situation an exception will likely be raised.<br>
+ <br>
+Raises:<br>
+ Datastore exceptions may be raised from the App Engine SDK in the event of<br>
+ failure.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.alt.appengine.html b/pydocs/gdata.alt.appengine.html
new file mode 100644
index 0000000..277bfe5
--- /dev/null
+++ b/pydocs/gdata.alt.appengine.html
@@ -0,0 +1,584 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.alt.appengine</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.alt.html"><font color="#ffffff">alt</font></a>.appengine</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/alt/appengine.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/alt/appengine.py</a></font></td></tr></table>
+ <p><tt>Provides HTTP functions for gdata.service to use on Google App Engine<br>
+ <br>
+<a href="#AppEngineHttpClient">AppEngineHttpClient</a>: Provides an HTTP request method which uses App Engine's<br>
+ urlfetch API. Set the http_client member of a GDataService <a href="__builtin__.html#object">object</a> to an<br>
+ instance of an <a href="#AppEngineHttpClient">AppEngineHttpClient</a> to allow the gdata library to run on<br>
+ Google App Engine.<br>
+ <br>
+run_on_appengine: Function which will modify an existing GDataService <a href="__builtin__.html#object">object</a><br>
+ to allow it to run on App Engine. It works by creating a new instance of<br>
+ the <a href="#AppEngineHttpClient">AppEngineHttpClient</a> and replacing the GDataService <a href="__builtin__.html#object">object</a>'s<br>
+ http_client.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="StringIO.html">StringIO</a><br>
+<a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="google.appengine.ext.db.html">google.appengine.ext.db</a><br>
+<a href="google.appengine.api.memcache.html">google.appengine.api.memcache</a><br>
+</td><td width="25%" valign=top><a href="pickle.html">pickle</a><br>
+<a href="google.appengine.api.urlfetch.html">google.appengine.api.urlfetch</a><br>
+</td><td width="25%" valign=top><a href="google.appengine.api.users.html">google.appengine.api.users</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.alt.appengine.html#HttpResponse">HttpResponse</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.alt.appengine.html#AppEngineHttpClient">AppEngineHttpClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.token_store.html#TokenStore">atom.token_store.TokenStore</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.alt.appengine.html#AppEngineTokenStore">AppEngineTokenStore</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.alt.appengine.html#TokenCollection">TokenCollection</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AppEngineHttpClient">class <strong>AppEngineHttpClient</strong></a>(<a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.alt.appengine.html#AppEngineHttpClient">AppEngineHttpClient</a></dd>
+<dd><a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AppEngineHttpClient-__init__"><strong>__init__</strong></a>(self, headers<font color="#909090">=None</font>, deadline<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AppEngineHttpClient-request"><strong>request</strong></a>(self, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Performs an HTTP call to the server, supports GET, POST, PUT, and<br>
+DELETE.<br>
+ <br>
+Usage example, perform and HTTP GET on <a href="http://www.google.com/">http://www.google.com/</a>:<br>
+ import atom.http<br>
+ client = atom.http.HttpClient()<br>
+ http_response = client.<a href="#AppEngineHttpClient-request">request</a>('GET', '<a href="http://www.google.com/">http://www.google.com/</a>')<br>
+ <br>
+Args:<br>
+ operation: str The HTTP operation to be performed. This is usually one<br>
+ of 'GET', 'POST', 'PUT', or 'DELETE'<br>
+ data: filestream, list of parts, or other <a href="__builtin__.html#object">object</a> which can be converted<br>
+ to a string. Should be set to None when performing a GET or DELETE.<br>
+ If data is a file-like <a href="__builtin__.html#object">object</a> which can be read, this method will<br>
+ read a chunk of 100K bytes at a time and send them.<br>
+ If the data is a list of parts to be sent, each part will be<br>
+ evaluated and sent.<br>
+ url: The full URL to which the request should be sent. Can be a string<br>
+ or atom.url.Url.<br>
+ headers: dict of strings. HTTP headers which should be sent<br>
+ in the request.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><a name="AppEngineHttpClient-delete"><strong>delete</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AppEngineHttpClient-get"><strong>get</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AppEngineHttpClient-post"><strong>post</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AppEngineHttpClient-put"><strong>put</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><strong>debug</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AppEngineTokenStore">class <strong>AppEngineTokenStore</strong></a>(<a href="atom.token_store.html#TokenStore">atom.token_store.TokenStore</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Stores the user's auth tokens in the App Engine datastore.<br>
+ <br>
+Tokens are only written to the datastore if a user is signed in (if <br>
+users.get_current_user() returns a user <a href="__builtin__.html#object">object</a>).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.alt.appengine.html#AppEngineTokenStore">AppEngineTokenStore</a></dd>
+<dd><a href="atom.token_store.html#TokenStore">atom.token_store.TokenStore</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AppEngineTokenStore-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppEngineTokenStore-add_token"><strong>add_token</strong></a>(self, token)</dt><dd><tt>Associates the token with the current user and stores it.<br>
+ <br>
+If there is no current user, the token will not be stored.<br>
+ <br>
+Returns:<br>
+ False if the token was not stored.</tt></dd></dl>
+
+<dl><dt><a name="AppEngineTokenStore-find_token"><strong>find_token</strong></a>(self, url)</dt><dd><tt>Searches the current user's collection of token for a token which can<br>
+be used for a request to the url.<br>
+ <br>
+Returns:<br>
+ The stored token which belongs to the current user and is valid for the<br>
+ desired URL. If there is no current user, or there is no valid user <br>
+ token in the datastore, a atom.http_interface.GenericToken is returned.</tt></dd></dl>
+
+<dl><dt><a name="AppEngineTokenStore-remove_all_tokens"><strong>remove_all_tokens</strong></a>(self)</dt><dd><tt>Removes all of the current user's tokens from the datastore.</tt></dd></dl>
+
+<dl><dt><a name="AppEngineTokenStore-remove_token"><strong>remove_token</strong></a>(self, token)</dt><dd><tt>Removes the token from the current user's collection in the datastore.<br>
+ <br>
+Returns:<br>
+ False if the token was not removed, this could be because the token was<br>
+ not in the datastore, or because there is no current user.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.token_store.html#TokenStore">atom.token_store.TokenStore</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HttpResponse">class <strong>HttpResponse</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Translates a urlfetch resoinse to look like an hhtplib resoinse.<br>
+ <br>
+Used to allow the resoinse from HttpRequest to be usable by gdata.service<br>
+methods.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="HttpResponse-__init__"><strong>__init__</strong></a>(self, urlfetch_response)</dt></dl>
+
+<dl><dt><a name="HttpResponse-getheader"><strong>getheader</strong></a>(self, name)</dt></dl>
+
+<dl><dt><a name="HttpResponse-read"><strong>read</strong></a>(self, length<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TokenCollection">class <strong>TokenCollection</strong></a>(<a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Datastore <a href="google.appengine.ext.db.html#Model">Model</a> which associates auth tokens with the current user.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.alt.appengine.html#TokenCollection">TokenCollection</a></dd>
+<dd><a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>pickled_tokens</strong></dt>
+<dd><tt>A byte string that can be longer than 500 bytes.</tt></dd>
+</dl>
+<dl><dt><strong>user</strong></dt>
+<dd><tt>A user property.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br>
+<dl><dt><a name="TokenCollection-__init__"><strong>__init__</strong></a>(self, parent<font color="#909090">=None</font>, key_name<font color="#909090">=None</font>, _app<font color="#909090">=None</font>, _from_entity<font color="#909090">=False</font>, **kwds)</dt><dd><tt>Creates a new instance of this model.<br>
+ <br>
+To create a new entity, you instantiate a model and then call <a href="#TokenCollection-put">put</a>(),<br>
+which saves the entity to the datastore:<br>
+ <br>
+ person = Person()<br>
+ person.name = 'Bret'<br>
+ person.<a href="#TokenCollection-put">put</a>()<br>
+ <br>
+You can initialize properties in the model in the constructor with keyword<br>
+arguments:<br>
+ <br>
+ person = Person(name='Bret')<br>
+ <br>
+We initialize all other properties to the default value (as defined by the<br>
+properties in the model definition) if they are not provided in the<br>
+constructor.<br>
+ <br>
+Args:<br>
+ parent: Parent instance for this instance or None, indicating a top-<br>
+ level instance.<br>
+ key_name: Name for new model instance.<br>
+ _from_entity: Intentionally undocumented.<br>
+ kwds: Keyword arguments mapping to properties of model. Also:<br>
+ key: Key instance for this instance, if provided makes parent and<br>
+ key_name redundant (they do not need to be set but if they are<br>
+ they must match the key).</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-delete"><strong>delete</strong></a>(self, **kwargs)</dt><dd><tt>Deletes this entity from the datastore.<br>
+ <br>
+Args:<br>
+ config: datastore_rpc.Configuration to use for this request.<br>
+ <br>
+Raises:<br>
+ TransactionFailedError if the data could not be committed.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-dynamic_properties"><strong>dynamic_properties</strong></a>(self)</dt><dd><tt>Returns a list of all dynamic properties defined for instance.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-has_key"><strong>has_key</strong></a>(self)</dt><dd><tt>Determine if this model instance has a complete key.<br>
+ <br>
+When not using a fully self-assigned Key, ids are not assigned until the<br>
+data is saved to the Datastore, but instances with a key name always have<br>
+a full key.<br>
+ <br>
+Returns:<br>
+ True if the <a href="__builtin__.html#object">object</a> has been persisted to the datastore or has a key<br>
+ or has a key_name, otherwise False.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-instance_properties"><strong>instance_properties</strong></a>(self)</dt><dd><tt>Alias for dyanmic_properties.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-is_saved"><strong>is_saved</strong></a>(self)</dt><dd><tt>Determine if entity is persisted in the datastore.<br>
+ <br>
+New instances of <a href="google.appengine.ext.db.html#Model">Model</a> do not start out saved in the data. Objects which<br>
+are saved to or loaded from the Datastore will have a True saved state.<br>
+ <br>
+Returns:<br>
+ True if <a href="__builtin__.html#object">object</a> has been persisted to the datastore, otherwise False.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-key"><strong>key</strong></a>(self)</dt><dd><tt>Unique key for this entity.<br>
+ <br>
+This property is only available if this entity is already stored in the<br>
+datastore or if it has a full key, so it is available if this entity was<br>
+fetched returned from a query, or after <a href="#TokenCollection-put">put</a>() is called the first time<br>
+for new entities, or if a complete key was given when constructed.<br>
+ <br>
+Returns:<br>
+ Datastore key of persisted entity.<br>
+ <br>
+Raises:<br>
+ NotSavedError when entity is not persistent.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-parent"><strong>parent</strong></a>(self)</dt><dd><tt>Get the parent of the model instance.<br>
+ <br>
+Returns:<br>
+ Parent of contained entity or parent provided in constructor, None if<br>
+ instance has no parent.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-parent_key"><strong>parent_key</strong></a>(self)</dt><dd><tt>Get the parent's key.<br>
+ <br>
+This method is useful for avoiding a potential fetch from the datastore<br>
+but still get information about the instances parent.<br>
+ <br>
+Returns:<br>
+ Parent key of entity, None if there is no parent.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-put"><strong>put</strong></a>(self, **kwargs)</dt><dd><tt>Writes this model instance to the datastore.<br>
+ <br>
+If this instance is new, we add an entity to the datastore.<br>
+Otherwise, we update this instance, and the key will remain the<br>
+same.<br>
+ <br>
+Args:<br>
+ config: datastore_rpc.Configuration to use for this request.<br>
+ <br>
+Returns:<br>
+ The key of the instance (either the existing key or a new key).<br>
+ <br>
+Raises:<br>
+ TransactionFailedError if the data could not be committed.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-save"><strong>save</strong></a> = put(self, **kwargs)</dt><dd><tt>Writes this model instance to the datastore.<br>
+ <br>
+If this instance is new, we add an entity to the datastore.<br>
+Otherwise, we update this instance, and the key will remain the<br>
+same.<br>
+ <br>
+Args:<br>
+ config: datastore_rpc.Configuration to use for this request.<br>
+ <br>
+Returns:<br>
+ The key of the instance (either the existing key or a new key).<br>
+ <br>
+Raises:<br>
+ TransactionFailedError if the data could not be committed.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-to_xml"><strong>to_xml</strong></a>(self, _entity_class<font color="#909090">=<class 'google.appengine.api.datastore.Entity'></font>)</dt><dd><tt>Generate an XML representation of this model instance.<br>
+ <br>
+atom and gd:namespace properties are converted to XML according to their<br>
+respective schemas. For more information, see:<br>
+ <br>
+ <a href="http://www.atomenabled.org/developers/syndication/">http://www.atomenabled.org/developers/syndication/</a><br>
+ <a href="http://code.google.com/apis/gdata/common-elements.html">http://code.google.com/apis/gdata/common-elements.html</a></tt></dd></dl>
+
+<hr>
+Class methods inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br>
+<dl><dt><a name="TokenCollection-all"><strong>all</strong></a>(cls, **kwds)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns a query over all instances of this model from the datastore.<br>
+ <br>
+Returns:<br>
+ Query that will retrieve all instances from entity collection.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-entity_type"><strong>entity_type</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Soon to be removed alias for kind.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-fields"><strong>fields</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Soon to be removed alias for properties.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-from_entity"><strong>from_entity</strong></a>(cls, entity)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Converts the entity representation of this model to an instance.<br>
+ <br>
+Converts datastore.Entity instance to an instance of cls.<br>
+ <br>
+Args:<br>
+ entity: Entity loaded directly from datastore.<br>
+ <br>
+Raises:<br>
+ KindError when cls is incorrect model for entity.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-get"><strong>get</strong></a>(cls, keys, **kwargs)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Fetch instance from the datastore of a specific <a href="google.appengine.ext.db.html#Model">Model</a> type using key.<br>
+ <br>
+We support Key objects and string keys (we convert them to Key objects<br>
+automatically).<br>
+ <br>
+Useful for ensuring that specific instance types are retrieved from the<br>
+datastore. It also helps that the source code clearly indicates what<br>
+kind of <a href="__builtin__.html#object">object</a> is being retreived. Example:<br>
+ <br>
+ story = Story.<a href="#TokenCollection-get">get</a>(story_key)<br>
+ <br>
+Args:<br>
+ keys: Key within datastore entity collection to find; or string key;<br>
+ or list of Keys or string keys.<br>
+ config: datastore_rpc.Configuration to use for this request.<br>
+ <br>
+Returns:<br>
+ If a single key was given: a <a href="google.appengine.ext.db.html#Model">Model</a> instance associated with key<br>
+ for provided class if it exists in the datastore, otherwise<br>
+ None; if a list of keys was given: a list whose items are either<br>
+ a <a href="google.appengine.ext.db.html#Model">Model</a> instance or None.<br>
+ <br>
+Raises:<br>
+ KindError if any of the retreived objects are not instances of the<br>
+ type associated with call to 'get'.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-get_by_id"><strong>get_by_id</strong></a>(cls, ids, parent<font color="#909090">=None</font>, **kwargs)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Get instance of <a href="google.appengine.ext.db.html#Model">Model</a> class by id.<br>
+ <br>
+Args:<br>
+ key_names: A single id or a list of ids.<br>
+ parent: Parent of instances to get. Can be a model or key.<br>
+ config: datastore_rpc.Configuration to use for this request.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-get_by_key_name"><strong>get_by_key_name</strong></a>(cls, key_names, parent<font color="#909090">=None</font>, **kwargs)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Get instance of <a href="google.appengine.ext.db.html#Model">Model</a> class by its key's name.<br>
+ <br>
+Args:<br>
+ key_names: A single key-name or a list of key-names.<br>
+ parent: Parent of instances to get. Can be a model or key.<br>
+ config: datastore_rpc.Configuration to use for this request.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-get_or_insert"><strong>get_or_insert</strong></a>(cls, key_name, **kwds)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Transactionally retrieve or create an instance of <a href="google.appengine.ext.db.html#Model">Model</a> class.<br>
+ <br>
+This acts much like the Python dictionary setdefault() method, where we<br>
+first try to retrieve a <a href="google.appengine.ext.db.html#Model">Model</a> instance with the given key name and parent.<br>
+If it's not present, then we create a new instance (using the *kwds<br>
+supplied) and insert that with the supplied key name.<br>
+ <br>
+Subsequent calls to this method with the same key_name and parent will<br>
+always yield the same entity (though not the same actual <a href="__builtin__.html#object">object</a> instance),<br>
+regardless of the *kwds supplied. If the specified entity has somehow<br>
+been deleted separately, then the next call will create a new entity and<br>
+return it.<br>
+ <br>
+If the 'parent' keyword argument is supplied, it must be a <a href="google.appengine.ext.db.html#Model">Model</a> instance.<br>
+It will be used as the parent of the new instance of this <a href="google.appengine.ext.db.html#Model">Model</a> class if<br>
+one is created.<br>
+ <br>
+This method is especially useful for having just one unique entity for<br>
+a specific identifier. Insertion/retrieval is done transactionally, which<br>
+guarantees uniqueness.<br>
+ <br>
+Example usage:<br>
+ <br>
+ class WikiTopic(db.<a href="google.appengine.ext.db.html#Model">Model</a>):<br>
+ creation_date = db.DatetimeProperty(auto_now_add=True)<br>
+ body = db.TextProperty(required=True)<br>
+ <br>
+ # The first time through we'll create the new topic.<br>
+ wiki_word = 'CommonIdioms'<br>
+ topic = WikiTopic.<a href="#TokenCollection-get_or_insert">get_or_insert</a>(wiki_word,<br>
+ body='This topic is totally new!')<br>
+ assert topic.<a href="#TokenCollection-key">key</a>().name() == 'CommonIdioms'<br>
+ assert topic.body == 'This topic is totally new!'<br>
+ <br>
+ # The second time through will just retrieve the entity.<br>
+ overwrite_topic = WikiTopic.<a href="#TokenCollection-get_or_insert">get_or_insert</a>(wiki_word,<br>
+ body='A totally different message!')<br>
+ assert topic.<a href="#TokenCollection-key">key</a>().name() == 'CommonIdioms'<br>
+ assert topic.body == 'This topic is totally new!'<br>
+ <br>
+Args:<br>
+ key_name: Key name to retrieve or create.<br>
+ **kwds: Keyword arguments to pass to the constructor of the model class<br>
+ if an instance for the specified key name does not already exist. If<br>
+ an instance with the supplied key_name and parent already exists, the<br>
+ rest of these arguments will be discarded.<br>
+ <br>
+Returns:<br>
+ Existing instance of <a href="google.appengine.ext.db.html#Model">Model</a> class with the specified key_name and parent<br>
+ or a new one that has just been created.<br>
+ <br>
+Raises:<br>
+ TransactionFailedError if the specified <a href="google.appengine.ext.db.html#Model">Model</a> instance could not be<br>
+ retrieved or created transactionally (due to high contention, etc).</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-gql"><strong>gql</strong></a>(cls, query_string, *args, **kwds)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns a query using GQL query string.<br>
+ <br>
+See appengine/ext/gql for more information about GQL.<br>
+ <br>
+Args:<br>
+ query_string: properly formatted GQL query string with the<br>
+ 'SELECT * FROM <entity>' part omitted<br>
+ *args: rest of the positional arguments used to bind numeric references<br>
+ in the query.<br>
+ **kwds: dictionary-based arguments (for named parameters).</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-kind"><strong>kind</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns the datastore kind we use for this model.<br>
+ <br>
+We just use the name of the model for now, ignoring potential collisions.</tt></dd></dl>
+
+<dl><dt><a name="TokenCollection-properties"><strong>properties</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="google.appengine.ext.db.html#PropertiedClass">google.appengine.ext.db.PropertiedClass</a></font></font></dt><dd><tt>Returns a dictionary of all the properties defined for this model.</tt></dd></dl>
+
+<hr>
+Static methods inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br>
+<dl><dt><a name="TokenCollection-__new__"><strong>__new__</strong></a>(*args, **unused_kwds)</dt><dd><tt>Allow subclasses to call <a href="#TokenCollection-__new__">__new__</a>() with arguments.<br>
+ <br>
+Do NOT list 'cls' as the first argument, or in the case when<br>
+the 'unused_kwds' dictionary contains the key 'cls', the function<br>
+will complain about multiple argument values for 'cls'.<br>
+ <br>
+Raises:<br>
+ TypeError if there are no positional arguments.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="google.appengine.ext.db.html#Model">google.appengine.ext.db.Model</a>:<br>
+<dl><dt><strong>__metaclass__</strong> = <class 'google.appengine.ext.db.PropertiedClass'><dd><tt>Meta-class for initializing <a href="google.appengine.ext.db.html#Model">Model</a> classes properties.<br>
+ <br>
+Used for initializing Properties defined in the context of a model.<br>
+By using a meta-class much of the configuration of a Property<br>
+descriptor becomes implicit. By using this meta-class, descriptors<br>
+that are of class <a href="google.appengine.ext.db.html#Model">Model</a> are notified about which class they<br>
+belong to and what attribute they are associated with and can<br>
+do appropriate initialization via __property_config__.<br>
+ <br>
+Duplicate properties are not permitted.</tt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-load_auth_tokens"><strong>load_auth_tokens</strong></a>(user<font color="#909090">=None</font>)</dt><dd><tt>Reads a dictionary of the current user's tokens from the datastore.<br>
+ <br>
+If there is no current user (a user is not signed in to the app) or the user<br>
+does not have any tokens, an empty dictionary is returned.</tt></dd></dl>
+ <dl><dt><a name="-run_on_appengine"><strong>run_on_appengine</strong></a>(gdata_service, store_tokens<font color="#909090">=True</font>, single_user_mode<font color="#909090">=False</font>, deadline<font color="#909090">=None</font>)</dt><dd><tt>Modifies a GDataService <a href="__builtin__.html#object">object</a> to allow it to run on App Engine.<br>
+ <br>
+Args:<br>
+ gdata_service: An instance of AtomService, GDataService, or any<br>
+ of their subclasses which has an http_client member and a <br>
+ token_store member.<br>
+ store_tokens: Boolean, defaults to True. If True, the gdata_service<br>
+ will attempt to add each token to it's token_store when<br>
+ SetClientLoginToken or SetAuthSubToken is called. If False<br>
+ the tokens will not automatically be added to the <br>
+ token_store.<br>
+ single_user_mode: Boolean, defaults to False. If True, the current_token<br>
+ member of gdata_service will be set when <br>
+ SetClientLoginToken or SetAuthTubToken is called. If set<br>
+ to True, the current_token is set in the gdata_service<br>
+ and anyone who accesses the <a href="__builtin__.html#object">object</a> will use the same <br>
+ token. <br>
+ <br>
+ Note: If store_tokens is set to False and <br>
+ single_user_mode is set to False, all tokens will be <br>
+ ignored, since the library assumes: the tokens should not<br>
+ be stored in the datastore and they should not be stored<br>
+ in the gdata_service <a href="__builtin__.html#object">object</a>. This will make it <br>
+ impossible to make requests which require authorization.<br>
+ deadline: int (optional) The number of seconds to wait for a response<br>
+ before timing out on the HTTP request. If no deadline is<br>
+ specified, the deafault deadline for HTTP requests from App<br>
+ Engine is used. The maximum is currently 10 (for 10 seconds).<br>
+ The default deadline for App Engine is 5 seconds.</tt></dd></dl>
+ <dl><dt><a name="-save_auth_tokens"><strong>save_auth_tokens</strong></a>(token_dict, user<font color="#909090">=None</font>)</dt><dd><tt>Associates the tokens with the current user and writes to the datastore.<br>
+ <br>
+If there us no current user, the tokens are not written and this function<br>
+returns None.<br>
+ <br>
+Returns:<br>
+ The key of the datastore entity containing the user's tokens, or None if<br>
+ there was no current user.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'api.jscudder (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.alt.html b/pydocs/gdata.alt.html
new file mode 100644
index 0000000..5d32836
--- /dev/null
+++ b/pydocs/gdata.alt.html
@@ -0,0 +1,26 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.alt</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.alt</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/alt/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/alt/__init__.py</a></font></td></tr></table>
+ <p><tt>This package's modules adapt the gdata library to run in other environments<br>
+ <br>
+The first example is the appengine module which contains functions and<br>
+classes which modify a GDataService object to run on Google App Engine.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.alt.app_engine.html">app_engine</a><br>
+</td><td width="25%" valign=top><a href="gdata.alt.appengine.html">appengine</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.analytics.client.html b/pydocs/gdata.analytics.client.html
new file mode 100644
index 0000000..1035c76
--- /dev/null
+++ b/pydocs/gdata.analytics.client.html
@@ -0,0 +1,1326 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.analytics.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.analytics.html"><font color="#ffffff">analytics</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/analytics/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/analytics/client.py</a></font></td></tr></table>
+ <p><tt>Streamlines requests to the Google Analytics APIs.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.client.html#AnalyticsClient">AnalyticsClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a>(<a href="atom.http_core.html#Uri">atom.http_core.Uri</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.client.html#AccountFeedQuery">AccountFeedQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.client.html#AccountQuery">AccountQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.client.html#AdvSegQuery">AdvSegQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.client.html#DataFeedQuery">DataFeedQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.client.html#GoalQuery">GoalQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.client.html#ProfileQuery">ProfileQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.client.html#WebPropertyQuery">WebPropertyQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AccountFeedQuery">class <strong>AccountFeedQuery</strong></a>(<a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Account Feed query class to simplify constructing Account Feed Urls.<br>
+ <br>
+To use this class, you can either pass a dict in the constructor that has<br>
+all the data feed query parameters as keys:<br>
+ queryUrl = <a href="#AccountFeedQuery">AccountFeedQuery</a>({'max-results': '10000'})<br>
+ <br>
+Alternatively you can add new parameters directly to the query object:<br>
+ queryUrl = <a href="#AccountFeedQuery">AccountFeedQuery</a>()<br>
+ queryUrl.query['max-results'] = '10000'<br>
+ <br>
+Args:<br>
+ query: dict (optional) Contains all the GA Data Feed query parameters<br>
+ as keys.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.client.html#AccountFeedQuery">AccountFeedQuery</a></dd>
+<dd><a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a></dd>
+<dd><a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a></dd>
+<dd><a href="atom.http_core.html#Uri">atom.http_core.Uri</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AccountFeedQuery-__init__"><strong>__init__</strong></a>(self, query<font color="#909090">={}</font>, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>path</strong> = '/analytics/feeds/accounts/default'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>:<br>
+<dl><dt><strong>host</strong> = 'www.google.com'</dl>
+
+<dl><dt><strong>scheme</strong> = 'https'</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a>:<br>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The q parameter for searching for an exact text match on content</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="AccountFeedQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeedQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeedQuery-modify_request"><strong>modify_request</strong></a>(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<hr>
+Static methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="AccountFeedQuery-ParseUri"><strong>ParseUri</strong></a> = parse_uri(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeedQuery-parse_uri"><strong>parse_uri</strong></a>(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>port</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AccountQuery">class <strong>AccountQuery</strong></a>(<a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Management API Account Feed query class.<br>
+ <br>
+Example Usage:<br>
+ queryUrl = <a href="#AccountQuery">AccountQuery</a>()<br>
+ queryUrl = <a href="#AccountQuery">AccountQuery</a>({'max-results': 100})<br>
+ <br>
+ queryUrl2 = <a href="#AccountQuery">AccountQuery</a>()<br>
+ queryUrl2.query['max-results'] = 100<br>
+ <br>
+Args:<br>
+ query: dict (optional) A dictionary of query parameters.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.client.html#AccountQuery">AccountQuery</a></dd>
+<dd><a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a></dd>
+<dd><a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a></dd>
+<dd><a href="atom.http_core.html#Uri">atom.http_core.Uri</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AccountQuery-__init__"><strong>__init__</strong></a>(self, query<font color="#909090">={}</font>, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>path</strong> = '/analytics/feeds/datasources/ga/accounts'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>:<br>
+<dl><dt><strong>host</strong> = 'www.google.com'</dl>
+
+<dl><dt><strong>scheme</strong> = 'https'</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a>:<br>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The q parameter for searching for an exact text match on content</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="AccountQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountQuery-modify_request"><strong>modify_request</strong></a>(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<hr>
+Static methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="AccountQuery-ParseUri"><strong>ParseUri</strong></a> = parse_uri(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-parse_uri"><strong>parse_uri</strong></a>(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>port</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AdvSegQuery">class <strong>AdvSegQuery</strong></a>(<a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Management API Goal Feed query class.<br>
+ <br>
+Example Usage:<br>
+ queryUrl = <a href="#AdvSegQuery">AdvSegQuery</a>()<br>
+ queryUrl = <a href="#AdvSegQuery">AdvSegQuery</a>({'max-results': 100})<br>
+ <br>
+ queryUrl1 = <a href="#AdvSegQuery">AdvSegQuery</a>()<br>
+ queryUrl1.query['max-results'] = 100<br>
+ <br>
+Args:<br>
+ query: dict (optional) A dictionary of query parameters.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.client.html#AdvSegQuery">AdvSegQuery</a></dd>
+<dd><a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a></dd>
+<dd><a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a></dd>
+<dd><a href="atom.http_core.html#Uri">atom.http_core.Uri</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AdvSegQuery-__init__"><strong>__init__</strong></a>(self, query<font color="#909090">={}</font>, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>path</strong> = '/analytics/feeds/datasources/ga/segments'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>:<br>
+<dl><dt><strong>host</strong> = 'www.google.com'</dl>
+
+<dl><dt><strong>scheme</strong> = 'https'</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a>:<br>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The q parameter for searching for an exact text match on content</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="AdvSegQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<dl><dt><a name="AdvSegQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AdvSegQuery-modify_request"><strong>modify_request</strong></a>(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<hr>
+Static methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="AdvSegQuery-ParseUri"><strong>ParseUri</strong></a> = parse_uri(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<dl><dt><a name="AdvSegQuery-parse_uri"><strong>parse_uri</strong></a>(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>port</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AnalyticsBaseQuery">class <strong>AnalyticsBaseQuery</strong></a>(<a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Abstracts common configuration across all query objects.<br>
+ <br>
+Attributes:<br>
+ scheme: string The default scheme. Should always be https.<br>
+ host: string The default host.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a></dd>
+<dd><a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a></dd>
+<dd><a href="atom.http_core.html#Uri">atom.http_core.Uri</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>host</strong> = 'www.google.com'</dl>
+
+<dl><dt><strong>scheme</strong> = 'https'</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a>:<br>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The q parameter for searching for an exact text match on content</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="AnalyticsBaseQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsBaseQuery-__init__"><strong>__init__</strong></a>(self, scheme<font color="#909090">=None</font>, host<font color="#909090">=None</font>, port<font color="#909090">=None</font>, path<font color="#909090">=None</font>, query<font color="#909090">=None</font>)</dt><dd><tt>Constructor for a URI.<br>
+ <br>
+Args:<br>
+ scheme: str This is usually 'http' or 'https'.<br>
+ host: str The host name or IP address of the desired server.<br>
+ post: int The server's port number.<br>
+ path: str The path of the resource following the host. This begins with<br>
+ a /, example: '/calendar/feeds/default/allcalendars/full'<br>
+ query: dict of strings The URL query parameters. The keys and values are<br>
+ both escaped so this dict should contain the unescaped values.<br>
+ For example {'my key': 'val', 'second': '!!!'} will become<br>
+ '?my+key=val&second=%21%21%21' which is appended to the path.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsBaseQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsBaseQuery-modify_request"><strong>modify_request</strong></a>(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<hr>
+Static methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="AnalyticsBaseQuery-ParseUri"><strong>ParseUri</strong></a> = parse_uri(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsBaseQuery-parse_uri"><strong>parse_uri</strong></a>(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>path</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AnalyticsClient">class <strong>AnalyticsClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Analytics API service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.client.html#AnalyticsClient">AnalyticsClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AnalyticsClient-GetAccountFeed"><strong>GetAccountFeed</strong></a> = <a href="#AnalyticsClient-get_account_feed">get_account_feed</a>(self, feed_uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-GetDataFeed"><strong>GetDataFeed</strong></a> = <a href="#AnalyticsClient-get_data_feed">get_data_feed</a>(self, feed_uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-GetManagementFeed"><strong>GetManagementFeed</strong></a> = <a href="#AnalyticsClient-get_management_feed">get_management_feed</a>(self, feed_uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-GetMgmtFeed"><strong>GetMgmtFeed</strong></a> = <a href="#AnalyticsClient-get_management_feed">get_management_feed</a>(self, feed_uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-__init__"><strong>__init__</strong></a>(self, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Initializes a new client for the Google Analytics Data Export API.<br>
+ <br>
+Args:<br>
+ auth_token: gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken (optional) Authorizes this client to edit the user's data.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a><br>
+ constructor.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-get_account_feed"><strong>get_account_feed</strong></a>(self, feed_uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Makes a request to the Analytics API Account Feed.<br>
+ <br>
+Args:<br>
+ feed_uri: str or gdata.analytics.<a href="#AccountFeedQuery">AccountFeedQuery</a> The Analytics Account<br>
+ Feed uri to define what data to retrieve from the API. Can also be<br>
+ used with a gdata.analytics.<a href="#AccountFeedQuery">AccountFeedQuery</a> object.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-get_data_feed"><strong>get_data_feed</strong></a>(self, feed_uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Makes a request to the Analytics API Data Feed.<br>
+ <br>
+Args:<br>
+ feed_uri: str or gdata.analytics.<a href="#AccountFeedQuery">AccountFeedQuery</a> The Analytics Data<br>
+ Feed uri to define what data to retrieve from the API. Can also be<br>
+ used with a gdata.analytics.<a href="#AccountFeedQuery">AccountFeedQuery</a> object.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-get_management_feed"><strong>get_management_feed</strong></a>(self, feed_uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Makes a request to the Google Analytics Management API.<br>
+ <br>
+The Management API provides read-only access to configuration data for<br>
+Google Analytics and supercedes the Data Export API Account Feed.<br>
+The Management API supports 5 feeds: account, web property, profile,<br>
+goal, advanced segment.<br>
+ <br>
+You can access each feed through the respective management query class<br>
+below. All requests return the same data object.<br>
+ <br>
+Args:<br>
+ feed_uri: str or <a href="#AccountQuery">AccountQuery</a>, <a href="#WebPropertyQuery">WebPropertyQuery</a>,<br>
+ <a href="#ProfileQuery">ProfileQuery</a>, <a href="#GoalQuery">GoalQuery</a>, MgmtAdvSegFeedQuery<br>
+ The Management API Feed uri to define which feed to retrieve.<br>
+ Either use a string or one of the wrapper classes.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>account_type</strong> = 'GOOGLE'</dl>
+
+<dl><dt><strong>api_version</strong> = '2'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://www.google.com/analytics/feeds/',)</dl>
+
+<dl><dt><strong>auth_service</strong> = 'analytics'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="AnalyticsClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AnalyticsClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="AnalyticsClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DataFeedQuery">class <strong>DataFeedQuery</strong></a>(<a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Data Feed query class to simplify constructing Data Feed Urls.<br>
+ <br>
+To use this class, you can either pass a dict in the constructor that has<br>
+all the data feed query parameters as keys:<br>
+ queryUrl = <a href="#DataFeedQuery">DataFeedQuery</a>({'start-date': '2008-10-01'})<br>
+ <br>
+Alternatively you can add new parameters directly to the query object:<br>
+ queryUrl = <a href="#DataFeedQuery">DataFeedQuery</a>()<br>
+ queryUrl.query['start-date'] = '2008-10-01'<br>
+ <br>
+Args:<br>
+ query: dict (optional) Contains all the GA Data Feed query parameters<br>
+ as keys.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.client.html#DataFeedQuery">DataFeedQuery</a></dd>
+<dd><a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a></dd>
+<dd><a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a></dd>
+<dd><a href="atom.http_core.html#Uri">atom.http_core.Uri</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="DataFeedQuery-__init__"><strong>__init__</strong></a>(self, query<font color="#909090">={}</font>, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>path</strong> = '/analytics/feeds/data'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>:<br>
+<dl><dt><strong>host</strong> = 'www.google.com'</dl>
+
+<dl><dt><strong>scheme</strong> = 'https'</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a>:<br>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The q parameter for searching for an exact text match on content</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="DataFeedQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<dl><dt><a name="DataFeedQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeedQuery-modify_request"><strong>modify_request</strong></a>(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<hr>
+Static methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="DataFeedQuery-ParseUri"><strong>ParseUri</strong></a> = parse_uri(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<dl><dt><a name="DataFeedQuery-parse_uri"><strong>parse_uri</strong></a>(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>port</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GoalQuery">class <strong>GoalQuery</strong></a>(<a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Management API Goal Feed query class.<br>
+ <br>
+Example Usage:<br>
+ queryUrl = <a href="#GoalQuery">GoalQuery</a>()<br>
+ queryUrl = <a href="#GoalQuery">GoalQuery</a>('123', 'UA-123-1', '555',<br>
+ {'max-results': 100})<br>
+ queryUrl = <a href="#GoalQuery">GoalQuery</a>(acct_id='123',<br>
+ web_prop_id='UA-123-1',<br>
+ profile_id='555',<br>
+ query={'max-results': 100})<br>
+ <br>
+ queryUrl2 = <a href="#GoalQuery">GoalQuery</a>()<br>
+ queryUrl2.acct_id = '123'<br>
+ queryUrl2.web_prop_id = 'UA-123-1'<br>
+ queryUrl2.query['max-results'] = 100<br>
+ <br>
+Args:<br>
+ acct_id: string (optional) The account ID to filter results.<br>
+ Default is ~all.<br>
+ web_prop_id: string (optional) The web property ID to filter results.<br>
+ Default is ~all.<br>
+ profile_id: string (optional) The profile ID to filter results.<br>
+ Default is ~all.<br>
+ query: dict (optional) A dictionary of query parameters.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.client.html#GoalQuery">GoalQuery</a></dd>
+<dd><a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a></dd>
+<dd><a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a></dd>
+<dd><a href="atom.http_core.html#Uri">atom.http_core.Uri</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GoalQuery-__init__"><strong>__init__</strong></a>(self, acct_id<font color="#909090">='~all'</font>, web_prop_id<font color="#909090">='~all'</font>, profile_id<font color="#909090">='~all'</font>, query<font color="#909090">={}</font>, **kwargs)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>path</strong></dt>
+<dd><tt>Wrapper for path attribute.</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>:<br>
+<dl><dt><strong>host</strong> = 'www.google.com'</dl>
+
+<dl><dt><strong>scheme</strong> = 'https'</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a>:<br>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The q parameter for searching for an exact text match on content</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="GoalQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<dl><dt><a name="GoalQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GoalQuery-modify_request"><strong>modify_request</strong></a>(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<hr>
+Static methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="GoalQuery-ParseUri"><strong>ParseUri</strong></a> = parse_uri(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<dl><dt><a name="GoalQuery-parse_uri"><strong>parse_uri</strong></a>(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>port</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProfileQuery">class <strong>ProfileQuery</strong></a>(<a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Management API Profile Feed query class.<br>
+ <br>
+Example Usage:<br>
+ queryUrl = <a href="#ProfileQuery">ProfileQuery</a>()<br>
+ queryUrl = <a href="#ProfileQuery">ProfileQuery</a>('123', 'UA-123-1', {'max-results': 100})<br>
+ queryUrl = <a href="#ProfileQuery">ProfileQuery</a>(acct_id='123',<br>
+ web_prop_id='UA-123-1',<br>
+ query={'max-results': 100})<br>
+ <br>
+ queryUrl2 = <a href="#ProfileQuery">ProfileQuery</a>()<br>
+ queryUrl2.acct_id = '123'<br>
+ queryUrl2.web_prop_id = 'UA-123-1'<br>
+ queryUrl2.query['max-results'] = 100<br>
+ <br>
+Args:<br>
+ acct_id: string (optional) The account ID to filter results.<br>
+ Default is ~all.<br>
+ web_prop_id: string (optional) The web property ID to filter results.<br>
+ Default is ~all.<br>
+ query: dict (optional) A dictionary of query parameters.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.client.html#ProfileQuery">ProfileQuery</a></dd>
+<dd><a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a></dd>
+<dd><a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a></dd>
+<dd><a href="atom.http_core.html#Uri">atom.http_core.Uri</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ProfileQuery-__init__"><strong>__init__</strong></a>(self, acct_id<font color="#909090">='~all'</font>, web_prop_id<font color="#909090">='~all'</font>, query<font color="#909090">={}</font>, **kwargs)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>path</strong></dt>
+<dd><tt>Wrapper for path attribute.</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>:<br>
+<dl><dt><strong>host</strong> = 'www.google.com'</dl>
+
+<dl><dt><strong>scheme</strong> = 'https'</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a>:<br>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The q parameter for searching for an exact text match on content</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="ProfileQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<dl><dt><a name="ProfileQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileQuery-modify_request"><strong>modify_request</strong></a>(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<hr>
+Static methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="ProfileQuery-ParseUri"><strong>ParseUri</strong></a> = parse_uri(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<dl><dt><a name="ProfileQuery-parse_uri"><strong>parse_uri</strong></a>(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>port</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WebPropertyQuery">class <strong>WebPropertyQuery</strong></a>(<a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Management API Web Property Feed query class.<br>
+ <br>
+Example Usage:<br>
+ queryUrl = <a href="#WebPropertyQuery">WebPropertyQuery</a>()<br>
+ queryUrl = <a href="#WebPropertyQuery">WebPropertyQuery</a>('123', {'max-results': 100})<br>
+ queryUrl = <a href="#WebPropertyQuery">WebPropertyQuery</a>(acct_id='123',<br>
+ query={'max-results': 100})<br>
+ <br>
+ queryUrl2 = <a href="#WebPropertyQuery">WebPropertyQuery</a>()<br>
+ queryUrl2.acct_id = '1234'<br>
+ queryUrl2.query['max-results'] = 100<br>
+ <br>
+Args:<br>
+ acct_id: string (optional) The account ID to filter results.<br>
+ Default is ~all.<br>
+ query: dict (optional) A dictionary of query parameters.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.client.html#WebPropertyQuery">WebPropertyQuery</a></dd>
+<dd><a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a></dd>
+<dd><a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a></dd>
+<dd><a href="atom.http_core.html#Uri">atom.http_core.Uri</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="WebPropertyQuery-__init__"><strong>__init__</strong></a>(self, acct_id<font color="#909090">='~all'</font>, query<font color="#909090">={}</font>, **kwargs)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>path</strong></dt>
+<dd><tt>Wrapper for path attribute.</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.analytics.client.html#AnalyticsBaseQuery">AnalyticsBaseQuery</a>:<br>
+<dl><dt><strong>host</strong> = 'www.google.com'</dl>
+
+<dl><dt><strong>scheme</strong> = 'https'</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#GDQuery">gdata.client.GDQuery</a>:<br>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The q parameter for searching for an exact text match on content</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="WebPropertyQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<dl><dt><a name="WebPropertyQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WebPropertyQuery-modify_request"><strong>modify_request</strong></a>(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<hr>
+Static methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="WebPropertyQuery-ParseUri"><strong>ParseUri</strong></a> = parse_uri(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<dl><dt><a name="WebPropertyQuery-parse_uri"><strong>parse_uri</strong></a>(uri_string)</dt><dd><tt>Creates a Uri object which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the Uri unset.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>port</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'api.nickm@google.com (Nick Mihailovski)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.nickm@google.com (Nick Mihailovski)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.analytics.data.html b/pydocs/gdata.analytics.data.html
new file mode 100644
index 0000000..8fcb6a2
--- /dev/null
+++ b/pydocs/gdata.analytics.data.html
@@ -0,0 +1,5178 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.analytics.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.analytics.html"><font color="#ffffff">analytics</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/analytics/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/analytics/data.py</a></font></td></tr></table>
+ <p><tt>Data model classes for parsing and generating XML for both the<br>
+Google Analytics Data Export and Management APIs. Although both APIs<br>
+operate on different parts of Google Analytics, they share common XML<br>
+elements and are released in the same module.<br>
+ <br>
+The Management API supports 5 feeds all using the same <a href="#ManagementFeed">ManagementFeed</a><br>
+data class.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#GaLinkFinder">GaLinkFinder</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#GetDimension">GetDimension</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#GetMetric">GetMetric</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#Aggregates">Aggregates</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>, <a href="gdata.analytics.data.html#GetMetric">GetMetric</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#DataEntry">DataEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>, <a href="gdata.analytics.data.html#GetMetric">GetMetric</a>, <a href="gdata.analytics.data.html#GetDimension">GetDimension</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#GetProperty">GetProperty</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#AccountEntry">AccountEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>, <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#DataSource">DataSource</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>, <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#ManagementEntry">ManagementEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>, <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>, <a href="gdata.analytics.data.html#GaLinkFinder">GaLinkFinder</a>)
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#Aggregates">Aggregates</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>, <a href="gdata.analytics.data.html#GetMetric">GetMetric</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#ContainsSampledData">ContainsSampledData</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#CustomVariable">CustomVariable</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#DataSource">DataSource</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>, <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#Definition">Definition</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#Destination">Destination</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#Dimension">Dimension</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#EndDate">EndDate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#Engagement">Engagement</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#Goal">Goal</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#Metric">Metric</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#Property">Property</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#Segment">Segment</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#StartDate">StartDate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#Step">Step</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#TableId">TableId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#TableName">TableName</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Link">atom.data.Link</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#AnalyticsLink">AnalyticsLink</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#AccountEntry">AccountEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>, <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#DataEntry">DataEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>, <a href="gdata.analytics.data.html#GetMetric">GetMetric</a>, <a href="gdata.analytics.data.html#GetDimension">GetDimension</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#ManagementEntry">ManagementEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>, <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>, <a href="gdata.analytics.data.html#GaLinkFinder">GaLinkFinder</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#AccountFeed">AccountFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#DataFeed">DataFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.data.html#ManagementFeed">ManagementFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AccountEntry">class <strong>AccountEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>, <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Account Feed <entry><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#AccountEntry">AccountEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="gdata.analytics.data.html#GetProperty">GetProperty</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>custom_variable</strong> = [<class 'gdata.analytics.data.CustomVariable'>]</dl>
+
+<dl><dt><strong>goal</strong> = [<class 'gdata.analytics.data.Goal'>]</dl>
+
+<dl><dt><strong>property</strong> = [<class 'gdata.analytics.data.Property'>]</dl>
+
+<dl><dt><strong>table_id</strong> = <class 'gdata.analytics.data.TableId'><dd><tt>Analytics Feed <dxp:tableId></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="AccountEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="AccountEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AccountEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="AccountEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="AccountEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>:<br>
+<dl><dt><a name="AccountEntry-GetProperty"><strong>GetProperty</strong></a> = get_property(self, name)</dt><dd><tt>Helper method to return a propery <a href="__builtin__.html#object">object</a> by its name attribute.<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:property> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:property> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+<dl><dt><a name="AccountEntry-get_property"><strong>get_property</strong></a>(self, name)</dt><dd><tt>Helper method to return a propery <a href="__builtin__.html#object">object</a> by its name attribute.<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:property> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:property> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AccountFeed">class <strong>AccountFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Account Feed <feed><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#AccountFeed">AccountFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.analytics.data.AccountEntry'>]</dl>
+
+<dl><dt><strong>segment</strong> = [<class 'gdata.analytics.data.Segment'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="AccountFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="AccountFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AccountFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="AccountFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="AccountFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AccountFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Aggregates">class <strong>Aggregates</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>, <a href="gdata.analytics.data.html#GetMetric">GetMetric</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Data Feed <dxp:aggregates><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#Aggregates">Aggregates</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.analytics.data.html#GetMetric">GetMetric</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>metric</strong> = [<class 'gdata.analytics.data.Metric'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Aggregates-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Aggregates-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Aggregates-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Aggregates-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Aggregates-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Aggregates-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Aggregates-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Aggregates-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Aggregates-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Aggregates-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.analytics.data.html#GetMetric">GetMetric</a>:<br>
+<dl><dt><a name="Aggregates-GetMetric"><strong>GetMetric</strong></a> = get_metric(self, name)</dt><dd><tt>Helper method to return a propery value by its name attribute<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:metric> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:metric> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+<dl><dt><a name="Aggregates-get_metric"><strong>get_metric</strong></a>(self, name)</dt><dd><tt>Helper method to return a propery value by its name attribute<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:metric> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:metric> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AnalyticsLink">class <strong>AnalyticsLink</strong></a>(<a href="atom.data.html#Link">atom.data.Link</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Subclass of link <link><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#AnalyticsLink">AnalyticsLink</a></dd>
+<dd><a href="atom.data.html#Link">atom.data.Link</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Class methods defined here:<br>
+<dl><dt><a name="AnalyticsLink-child"><strong>child</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Child target_kind</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsLink-parent"><strong>parent</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Parent target_kind</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>target_kind</strong> = '{http://schemas.google.com/g/2005}targetKind'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Link">atom.data.Link</a>:<br>
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<dl><dt><strong>hreflang</strong> = 'hreflang'</dl>
+
+<dl><dt><strong>length</strong> = 'length'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>title</strong> = 'title'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AnalyticsLink-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsLink-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsLink-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsLink-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsLink-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsLink-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnalyticsLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsLink-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsLink-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsLink-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContainsSampledData">class <strong>ContainsSampledData</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Data Feed <dxp:containsSampledData><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#ContainsSampledData">ContainsSampledData</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ContainsSampledData-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContainsSampledData-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContainsSampledData-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContainsSampledData-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContainsSampledData-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ContainsSampledData-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContainsSampledData-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContainsSampledData-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContainsSampledData-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContainsSampledData-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CustomVariable">class <strong>CustomVariable</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Data Feed <dxp:customVariable><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#CustomVariable">CustomVariable</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>index</strong> = 'index'</dl>
+
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>scope</strong> = 'scope'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CustomVariable-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomVariable-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomVariable-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CustomVariable-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomVariable-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="CustomVariable-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CustomVariable-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomVariable-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CustomVariable-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomVariable-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DataEntry">class <strong>DataEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>, <a href="gdata.analytics.data.html#GetMetric">GetMetric</a>, <a href="gdata.analytics.data.html#GetDimension">GetDimension</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Data Feed <entry><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#DataEntry">DataEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="gdata.analytics.data.html#GetMetric">GetMetric</a></dd>
+<dd><a href="gdata.analytics.data.html#GetDimension">GetDimension</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="DataEntry-GetObject"><strong>GetObject</strong></a> = <a href="#DataEntry-get_object">get_object</a>(self, name)</dt></dl>
+
+<dl><dt><a name="DataEntry-get_object"><strong>get_object</strong></a>(self, name)</dt><dd><tt>Returns either a <a href="#Dimension">Dimension</a> or <a href="#Metric">Metric</a> <a href="__builtin__.html#object">object</a> with the same name as the<br>
+name parameter.<br>
+ <br>
+Args:<br>
+ name: string The name of the <a href="__builtin__.html#object">object</a> to retrieve.<br>
+ <br>
+Returns:<br>
+ Either a <a href="#Dimension">Dimension</a> or Object that has the same as the name parameter.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>dimension</strong> = [<class 'gdata.analytics.data.Dimension'>]</dl>
+
+<dl><dt><strong>metric</strong> = [<class 'gdata.analytics.data.Metric'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="DataEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="DataEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="DataEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="DataEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="DataEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.analytics.data.html#GetMetric">GetMetric</a>:<br>
+<dl><dt><a name="DataEntry-GetMetric"><strong>GetMetric</strong></a> = get_metric(self, name)</dt><dd><tt>Helper method to return a propery value by its name attribute<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:metric> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:metric> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-get_metric"><strong>get_metric</strong></a>(self, name)</dt><dd><tt>Helper method to return a propery value by its name attribute<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:metric> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:metric> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.analytics.data.html#GetDimension">GetDimension</a>:<br>
+<dl><dt><a name="DataEntry-GetDimension"><strong>GetDimension</strong></a> = get_dimension(self, name)</dt><dd><tt>Helper method to return a dimention <a href="__builtin__.html#object">object</a> by its name attribute<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:dimension> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A dimension <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:dimension> element.<br>
+ if no dimension is found, None is returned.</tt></dd></dl>
+
+<dl><dt><a name="DataEntry-get_dimension"><strong>get_dimension</strong></a>(self, name)</dt><dd><tt>Helper method to return a dimention <a href="__builtin__.html#object">object</a> by its name attribute<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:dimension> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A dimension <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:dimension> element.<br>
+ if no dimension is found, None is returned.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DataFeed">class <strong>DataFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Data Feed <feed>.<br>
+ <br>
+Although there is only one datasource, it is stored in an array to replicate<br>
+the design of the Java client library and ensure backwards compatibility if<br>
+new data sources are added in the future.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#DataFeed">DataFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="DataFeed-HasSampledData"><strong>HasSampledData</strong></a> = <a href="#DataFeed-has_sampled_data">has_sampled_data</a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-has_sampled_data"><strong>has_sampled_data</strong></a>(self)</dt><dd><tt>Returns whether this feed has sampled data.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>aggregates</strong> = <class 'gdata.analytics.data.Aggregates'><dd><tt>Analytics Data Feed <dxp:aggregates></tt></dl>
+
+<dl><dt><strong>contains_sampled_data</strong> = <class 'gdata.analytics.data.ContainsSampledData'><dd><tt>Analytics Data Feed <dxp:containsSampledData></tt></dl>
+
+<dl><dt><strong>data_source</strong> = [<class 'gdata.analytics.data.DataSource'>]</dl>
+
+<dl><dt><strong>end_date</strong> = <class 'gdata.analytics.data.EndDate'><dd><tt>Analytics Feed <dxp:endDate></tt></dl>
+
+<dl><dt><strong>entry</strong> = [<class 'gdata.analytics.data.DataEntry'>]</dl>
+
+<dl><dt><strong>segment</strong> = <class 'gdata.analytics.data.Segment'><dd><tt>Analytics Feed <dxp:segment></tt></dl>
+
+<dl><dt><strong>start_date</strong> = <class 'gdata.analytics.data.StartDate'><dd><tt>Analytics Feed <dxp:startDate></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="DataFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="DataFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="DataFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="DataFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="DataFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DataFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DataSource">class <strong>DataSource</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>, <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Data Feed <dxp:dataSource><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#DataSource">DataSource</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.analytics.data.html#GetProperty">GetProperty</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.analytics.data.Property'>]</dl>
+
+<dl><dt><strong>table_id</strong> = <class 'gdata.analytics.data.TableId'><dd><tt>Analytics Feed <dxp:tableId></tt></dl>
+
+<dl><dt><strong>table_name</strong> = <class 'gdata.analytics.data.TableName'><dd><tt>Analytics Feed <dxp:tableName></tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="DataSource-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataSource-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataSource-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DataSource-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataSource-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="DataSource-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="DataSource-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataSource-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DataSource-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataSource-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>:<br>
+<dl><dt><a name="DataSource-GetProperty"><strong>GetProperty</strong></a> = get_property(self, name)</dt><dd><tt>Helper method to return a propery <a href="__builtin__.html#object">object</a> by its name attribute.<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:property> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:property> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+<dl><dt><a name="DataSource-get_property"><strong>get_property</strong></a>(self, name)</dt><dd><tt>Helper method to return a propery <a href="__builtin__.html#object">object</a> by its name attribute.<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:property> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:property> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Definition">class <strong>Definition</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:definition><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#Definition">Definition</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Definition-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Definition-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Definition-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Definition-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Definition-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Definition-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Definition-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Definition-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Definition-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Definition-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Destination">class <strong>Destination</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:destination><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#Destination">Destination</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>case_sensitive</strong> = 'caseSensitive'</dl>
+
+<dl><dt><strong>expression</strong> = 'expression'</dl>
+
+<dl><dt><strong>match_type</strong> = 'matchType'</dl>
+
+<dl><dt><strong>step</strong> = [<class 'gdata.analytics.data.Step'>]</dl>
+
+<dl><dt><strong>step1_required</strong> = 'step1Required'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Destination-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Destination-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Destination-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Destination-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Destination-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Destination-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Destination-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Destination-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Destination-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Destination-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Dimension">class <strong>Dimension</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:dimension><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#Dimension">Dimension</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Dimension-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Dimension-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Dimension-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Dimension-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Dimension-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Dimension-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Dimension-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Dimension-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Dimension-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Dimension-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EndDate">class <strong>EndDate</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:endDate><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#EndDate">EndDate</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EndDate-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EndDate-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EndDate-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EndDate-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EndDate-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="EndDate-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="EndDate-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EndDate-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EndDate-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EndDate-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Engagement">class <strong>Engagement</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:engagement><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#Engagement">Engagement</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>comparison</strong> = 'comparison'</dl>
+
+<dl><dt><strong>threshold_value</strong> = 'thresholdValue'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Engagement-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Engagement-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Engagement-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Engagement-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Engagement-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Engagement-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Engagement-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Engagement-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Engagement-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Engagement-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GaLinkFinder">class <strong>GaLinkFinder</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Utility class to return specific links in Google Analytics feeds.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="GaLinkFinder-GetChildLink"><strong>GetChildLink</strong></a> = <a href="#GaLinkFinder-get_child_link">get_child_link</a>(self, target_kind)</dt></dl>
+
+<dl><dt><a name="GaLinkFinder-GetChildLinks"><strong>GetChildLinks</strong></a> = <a href="#GaLinkFinder-get_child_links">get_child_links</a>(self)</dt></dl>
+
+<dl><dt><a name="GaLinkFinder-GetParentLinks"><strong>GetParentLinks</strong></a> = <a href="#GaLinkFinder-get_parent_links">get_parent_links</a>(self)</dt></dl>
+
+<dl><dt><a name="GaLinkFinder-get_child_link"><strong>get_child_link</strong></a>(self, target_kind)</dt><dd><tt>Utility method to return one child link.<br>
+ <br>
+Returns:<br>
+ A child link with the given target_kind. None if the target_kind was<br>
+ not found.</tt></dd></dl>
+
+<dl><dt><a name="GaLinkFinder-get_child_links"><strong>get_child_links</strong></a>(self)</dt><dd><tt>Returns a list of all the child links in an entry.</tt></dd></dl>
+
+<dl><dt><a name="GaLinkFinder-get_parent_links"><strong>get_parent_links</strong></a>(self)</dt><dd><tt>Returns a list of all the parent links in an entry.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GetDimension">class <strong>GetDimension</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Utility class to simplify retrieving <a href="#Dimension">Dimension</a> objects.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="GetDimension-GetDimension"><strong>GetDimension</strong></a> = <a href="#GetDimension-get_dimension">get_dimension</a>(self, name)</dt></dl>
+
+<dl><dt><a name="GetDimension-get_dimension"><strong>get_dimension</strong></a>(self, name)</dt><dd><tt>Helper method to return a dimention <a href="__builtin__.html#object">object</a> by its name attribute<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:dimension> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A dimension <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:dimension> element.<br>
+ if no dimension is found, None is returned.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GetMetric">class <strong>GetMetric</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Utility class to simplify retrieving <a href="#Metric">Metric</a> objects.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="GetMetric-GetMetric"><strong>GetMetric</strong></a> = <a href="#GetMetric-get_metric">get_metric</a>(self, name)</dt></dl>
+
+<dl><dt><a name="GetMetric-get_metric"><strong>get_metric</strong></a>(self, name)</dt><dd><tt>Helper method to return a propery value by its name attribute<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:metric> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:metric> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GetProperty">class <strong>GetProperty</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Utility class to simplify retrieving <a href="#Property">Property</a> objects.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="GetProperty-GetProperty"><strong>GetProperty</strong></a> = <a href="#GetProperty-get_property">get_property</a>(self, name)</dt></dl>
+
+<dl><dt><a name="GetProperty-get_property"><strong>get_property</strong></a>(self, name)</dt><dd><tt>Helper method to return a propery <a href="__builtin__.html#object">object</a> by its name attribute.<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:property> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:property> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Goal">class <strong>Goal</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:goal><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#Goal">Goal</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>active</strong> = 'active'</dl>
+
+<dl><dt><strong>destination</strong> = <class 'gdata.analytics.data.Destination'><dd><tt>Analytics Feed <dxp:destination></tt></dl>
+
+<dl><dt><strong>engagement</strong> = <class 'gdata.analytics.data.Engagement'><dd><tt>Analytics Feed <dxp:engagement></tt></dl>
+
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>number</strong> = 'number'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Goal-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Goal-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Goal-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Goal-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Goal-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Goal-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Goal-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Goal-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Goal-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Goal-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ManagementEntry">class <strong>ManagementEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>, <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>, <a href="gdata.analytics.data.html#GaLinkFinder">GaLinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Managememt Entry <entry>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#ManagementEntry">ManagementEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="gdata.analytics.data.html#GetProperty">GetProperty</a></dd>
+<dd><a href="gdata.analytics.data.html#GaLinkFinder">GaLinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>goal</strong> = <class 'gdata.analytics.data.Goal'><dd><tt>Analytics Feed <dxp:goal></tt></dl>
+
+<dl><dt><strong>kind</strong> = '{http://schemas.google.com/g/2005}kind'</dl>
+
+<dl><dt><strong>link</strong> = [<class 'gdata.analytics.data.AnalyticsLink'>]</dl>
+
+<dl><dt><strong>property</strong> = [<class 'gdata.analytics.data.Property'>]</dl>
+
+<dl><dt><strong>segment</strong> = <class 'gdata.analytics.data.Segment'><dd><tt>Analytics Feed <dxp:segment></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="ManagementEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ManagementEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ManagementEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ManagementEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ManagementEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.analytics.data.html#GetProperty">GetProperty</a>:<br>
+<dl><dt><a name="ManagementEntry-GetProperty"><strong>GetProperty</strong></a> = get_property(self, name)</dt><dd><tt>Helper method to return a propery <a href="__builtin__.html#object">object</a> by its name attribute.<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:property> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:property> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-get_property"><strong>get_property</strong></a>(self, name)</dt><dd><tt>Helper method to return a propery <a href="__builtin__.html#object">object</a> by its name attribute.<br>
+ <br>
+Args:<br>
+ name: string The name of the <dxp:property> element to retrieve.<br>
+ <br>
+Returns:<br>
+ A property <a href="__builtin__.html#object">object</a> corresponding to the matching <dxp:property> element.<br>
+ if no property is found, None is returned.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.analytics.data.html#GaLinkFinder">GaLinkFinder</a>:<br>
+<dl><dt><a name="ManagementEntry-GetChildLink"><strong>GetChildLink</strong></a> = get_child_link(self, target_kind)</dt><dd><tt>Utility method to return one child link.<br>
+ <br>
+Returns:<br>
+ A child link with the given target_kind. None if the target_kind was<br>
+ not found.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-GetChildLinks"><strong>GetChildLinks</strong></a> = get_child_links(self)</dt><dd><tt>Returns a list of all the child links in an entry.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-GetParentLinks"><strong>GetParentLinks</strong></a> = get_parent_links(self)</dt><dd><tt>Returns a list of all the parent links in an entry.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-get_child_link"><strong>get_child_link</strong></a>(self, target_kind)</dt><dd><tt>Utility method to return one child link.<br>
+ <br>
+Returns:<br>
+ A child link with the given target_kind. None if the target_kind was<br>
+ not found.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-get_child_links"><strong>get_child_links</strong></a>(self)</dt><dd><tt>Returns a list of all the child links in an entry.</tt></dd></dl>
+
+<dl><dt><a name="ManagementEntry-get_parent_links"><strong>get_parent_links</strong></a>(self)</dt><dd><tt>Returns a list of all the parent links in an entry.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ManagementFeed">class <strong>ManagementFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Management Feed <feed>.<br>
+ <br>
+This class holds the data for all 5 Management API feeds: Account,<br>
+Web <a href="#Property">Property</a>, Profile, <a href="#Goal">Goal</a>, and Advanced <a href="#Segment">Segment</a> Feeds.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#ManagementFeed">ManagementFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.analytics.data.ManagementEntry'>]</dl>
+
+<dl><dt><strong>kind</strong> = '{http://schemas.google.com/g/2005}kind'</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ManagementFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ManagementFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ManagementFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ManagementFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ManagementFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ManagementFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ManagementFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Metric">class <strong>Metric</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:metric><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#Metric">Metric</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>confidence_interval</strong> = 'confidenceInterval'</dl>
+
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Metric-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Metric-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Metric-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Metric-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Metric-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Metric-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Metric-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metric-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Metric-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Metric-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Property">class <strong>Property</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:property><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#Property">Property</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Property-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Property-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Property-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Property-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Property-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Property-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Property-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Property-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Property-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Property-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Segment">class <strong>Segment</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:segment><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#Segment">Segment</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>definition</strong> = <class 'gdata.analytics.data.Definition'><dd><tt>Analytics Feed <dxp:definition></tt></dl>
+
+<dl><dt><strong>id</strong> = 'id'</dl>
+
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Segment-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Segment-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Segment-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Segment-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Segment-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Segment-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Segment-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Segment-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Segment-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Segment-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="StartDate">class <strong>StartDate</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:startDate><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#StartDate">StartDate</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="StartDate-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartDate-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartDate-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="StartDate-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartDate-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="StartDate-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="StartDate-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="StartDate-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="StartDate-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartDate-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Step">class <strong>Step</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:step><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#Step">Step</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>number</strong> = 'number'</dl>
+
+<dl><dt><strong>path</strong> = 'path'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Step-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Step-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Step-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Step-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Step-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Step-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Step-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Step-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Step-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Step-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TableId">class <strong>TableId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:tableId><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#TableId">TableId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TableId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TableId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TableId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TableId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TableId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="TableId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TableId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TableId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TableId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TableId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TableName">class <strong>TableName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Analytics Feed <dxp:tableName><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.data.html#TableName">TableName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TableName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TableName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TableName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TableName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TableName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="TableName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TableName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TableName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TableName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TableName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DXP_NS</strong> = '{http://schemas.google.com/analytics/2009}%s'<br>
+<strong>GA_NS</strong> = '{http://schemas.google.com/ga/2009}%s'<br>
+<strong>GD_NS</strong> = '{http://schemas.google.com/g/2005}%s'<br>
+<strong>__author__</strong> = 'api.nickm@google.com (Nick Mihailovski)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.nickm@google.com (Nick Mihailovski)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.analytics.html b/pydocs/gdata.analytics.html
new file mode 100644
index 0000000..2b41f28
--- /dev/null
+++ b/pydocs/gdata.analytics.html
@@ -0,0 +1,978 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.analytics</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.analytics</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/analytics/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/analytics/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains extensions to Atom objects used with Google Analytics.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.analytics.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.analytics.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.analytics.service.html">service</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.html#AccountListEntry">AccountListEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.html#AnalyticsDataEntry">AnalyticsDataEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.html#Dimension">Dimension</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.html#Metric">Metric</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.html#Property">Property</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.html#TableId">TableId</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.html#AccountListFeed">AccountListFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.html#AnalyticsDataFeed">AnalyticsDataFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AccountListEntry">class <strong>AccountListEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Documents version of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.html#AccountListEntry">AccountListEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AccountListEntry-__init__"><strong>__init__</strong></a>(self, tableId<font color="#909090">=None</font>, property<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="AccountListEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AccountListEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="AccountListEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="AccountListEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="AccountListEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="AccountListEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="AccountListEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="AccountListEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AccountListEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="AccountListEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AccountListFeed">class <strong>AccountListFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing a list of Google Documents Items<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.html#AccountListFeed">AccountListFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="AccountListFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="AccountListFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="AccountListFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="AccountListFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="AccountListFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="AccountListFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="AccountListFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AccountListFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="AccountListFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountListFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AnalyticsDataEntry">class <strong>AnalyticsDataEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Analytics version of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.html#AnalyticsDataEntry">AnalyticsDataEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AnalyticsDataEntry-__init__"><strong>__init__</strong></a>(self, dimension<font color="#909090">=None</font>, metric<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="AnalyticsDataEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="AnalyticsDataEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="AnalyticsDataEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="AnalyticsDataEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="AnalyticsDataEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AnalyticsDataFeed">class <strong>AnalyticsDataFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing a list of Google Analytics Data Feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.html#AnalyticsDataFeed">AnalyticsDataFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="AnalyticsDataFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="AnalyticsDataFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="AnalyticsDataFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="AnalyticsDataFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="AnalyticsDataFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Dimension">class <strong>Dimension</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.html#Dimension">Dimension</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Dimension-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, value<font color="#909090">=None</font>, type<font color="#909090">=None</font>, confidence_interval<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Dimension-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Dimension-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="Dimension-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Dimension-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Dimension-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Dimension-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="Dimension-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Dimension-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Dimension-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="Dimension-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Dimension-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="Dimension-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Dimension-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Dimension-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Dimension-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="Dimension-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Dimension-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Metric">class <strong>Metric</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.html#Metric">Metric</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Metric-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, value<font color="#909090">=None</font>, type<font color="#909090">=None</font>, confidence_interval<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Metric-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metric-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="Metric-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Metric-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Metric-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Metric-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="Metric-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metric-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metric-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="Metric-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metric-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="Metric-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metric-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Metric-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metric-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="Metric-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metric-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Property">class <strong>Property</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.html#Property">Property</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Property-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, value<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Property-__repr__"><strong>__repr__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Property-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="Property-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Property-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Property-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Property-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="Property-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Property-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Property-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="Property-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Property-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="Property-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Property-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Property-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Property-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="Property-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Property-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TableId">class <strong>TableId</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>tableId element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.html#TableId">TableId</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="TableId-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="TableId-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Entry">atom.Entry</a>:<br>
+<dl><dt><a name="TableId-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="TableId-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="TableId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="TableId-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="TableId-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TableId-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TableId-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="TableId-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TableId-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="TableId-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TableId-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TableId-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TableId-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="TableId-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TableId-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-AccountListEntryFromString"><strong>AccountListEntryFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into an <a href="#AccountListEntry">AccountListEntry</a> object.<br>
+ <br>
+Args:<br>
+xml_string: string The XML describing a Document List feed entry.<br>
+ <br>
+Returns:<br>
+A <a href="#AccountListEntry">AccountListEntry</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-AccountListFeedFromString"><strong>AccountListFeedFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into an <a href="#AccountListFeed">AccountListFeed</a> object.<br>
+ <br>
+Args:<br>
+xml_string: string The XML describing an AccountList feed.<br>
+ <br>
+Returns:<br>
+An <a href="#AccountListFeed">AccountListFeed</a> object corresponding to the given XML.<br>
+All properties are also linked to with a direct reference<br>
+from each entry object for convenience. (e.g. entry.AccountName)</tt></dd></dl>
+ <dl><dt><a name="-AnalyticsDataFeedFromString"><strong>AnalyticsDataFeedFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into an <a href="#AccountListFeed">AccountListFeed</a> object.<br>
+ <br>
+Args:<br>
+xml_string: string The XML describing an AccountList feed.<br>
+ <br>
+Returns:<br>
+An <a href="#AccountListFeed">AccountListFeed</a> object corresponding to the given XML.<br>
+Each metric and dimension is also referenced directly from<br>
+the entry for easier access. (e.g. entry.keyword.value)</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GAN_NAMESPACE</strong> = 'http://schemas.google.com/analytics/2009'<br>
+<strong>__author__</strong> = 'api.suryasev (Sal Uryasev)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.suryasev (Sal Uryasev)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.analytics.service.html b/pydocs/gdata.analytics.service.html
new file mode 100644
index 0000000..7ea388f
--- /dev/null
+++ b/pydocs/gdata.analytics.service.html
@@ -0,0 +1,1673 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.analytics.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.analytics.html"><font color="#ffffff">analytics</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/analytics/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/analytics/service.py</a></font></td></tr></table>
+ <p><tt><a href="#AccountsService">AccountsService</a> extends the <a href="gdata.service.html#GDataService">GDataService</a> to streamline Google Analytics<br>
+ account information operations.<br>
+ <br>
+<a href="#AnalyticsDataService">AnalyticsDataService</a>: Provides methods to query google analytics data feeds.<br>
+ Extends <a href="gdata.service.html#GDataService">GDataService</a>.<br>
+ <br>
+<a href="#DataQuery">DataQuery</a>: Queries a Google Analytics Data list feed.<br>
+ <br>
+<a href="#AccountQuery">AccountQuery</a>: Queries a Google Analytics Account list feed.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.service.html#AccountsService">AccountsService</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.service.html#AnalyticsDataService">AnalyticsDataService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Query">gdata.service.Query</a>(<a href="__builtin__.html#dict">__builtin__.dict</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.analytics.service.html#AccountQuery">AccountQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.analytics.service.html#DataQuery">DataQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AccountQuery">class <strong>AccountQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Object used to construct a URI to query the Google Account List feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.service.html#AccountQuery">AccountQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AccountQuery-ToUri"><strong>ToUri</strong></a>(self)</dt><dd><tt>Generates a URI from the query parameters set in the object.<br>
+ <br>
+Returns:<br>
+ A string containing the URI used to retrieve entries from the Account<br>
+ List feed.</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">='/feeds/accounts'</font>, start_index<font color="#909090">=1</font>, max_results<font color="#909090">=1000</font>, username<font color="#909090">='default'</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Account List <a href="gdata.service.html#Query">Query</a><br>
+ <br>
+Args:<br>
+ feed: string (optional) The path for the feed. (e.g. '/feeds/documents')<br>
+ visibility: string (optional) The visibility chosen for the current <br>
+ feed.<br>
+ projection: string (optional) The projection chosen for the current <br>
+ feed.<br>
+ text_query: string (optional) The contents of the q query parameter. <br>
+ This string is URL escaped upon conversion to a URI.<br>
+ params: dict (optional) Parameter value string pairs which become URL<br>
+ params when translated to a URI. These parameters are added to<br>
+ the query's items.<br>
+ categories: list (optional) List of category strings which should be<br>
+ included as query categories. See gdata.service.<a href="gdata.service.html#Query">Query</a> for<br>
+ additional documentation.<br>
+ username: string (deprecated) This value should now always be passed as <br>
+ 'default'.<br>
+ <br>
+Yields:<br>
+ A DocumentQuery object used to construct a URI based on the Document<br>
+ List feed.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="AccountQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="AccountQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#AccountQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#AccountQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#AccountQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#AccountQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#AccountQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="AccountQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#AccountQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#AccountQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AccountsService">class <strong>AccountsService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Analytics Account List feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.service.html#AccountsService">AccountsService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AccountsService-GetAccountList"><strong>GetAccountList</strong></a>(self, max_results<font color="#909090">=1000</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Retrieves a feed containing all of a user's accounts and profiles.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-GetAccountListEntry"><strong>GetAccountListEntry</strong></a>(self, uri)</dt><dd><tt>Retrieves a particular AccountListEntry by its unique URI.<br>
+ <br>
+Args:<br>
+ uri: string The unique URI of an entry in an Account List feed.<br>
+ <br>
+Returns:<br>
+ An AccountLisFeed object representing the retrieved entry.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-QueryAccountListFeed"><strong>QueryAccountListFeed</strong></a>(self, uri)</dt><dd><tt>Retrieves an AccountListFeed by retrieving a URI based off the Document<br>
+ List feed, including any query parameters. An AccountListFeed object <br>
+ can be used to construct these parameters.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the feed being retrieved possibly with query<br>
+ parameters.<br>
+ <br>
+Returns:<br>
+ An AccountListFeed object representing the feed returned by the server.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=''</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='www.google.com/analytics'</font>, additional_headers<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a client for the Google Analytics service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="AccountsService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccountsService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#AccountsService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#AccountsService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#AccountsService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="AccountsService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="AccountsService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AnalyticsDataService">class <strong>AnalyticsDataService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Analytics service Data List feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.service.html#AnalyticsDataService">AnalyticsDataService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AnalyticsDataService-AnalyticsDataFeed"><strong>AnalyticsDataFeed</strong></a>(self, uri)</dt><dd><tt>Retrieves an AnalyticsListFeed by retrieving a URI based off the <br>
+ Document List feed, including any query parameters. An <br>
+ AnalyticsListFeed object can be used to construct these parameters.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the feed being retrieved possibly with query<br>
+ parameters.<br>
+ <br>
+Returns:<br>
+ An AnalyticsListFeed object representing the feed returned by the <br>
+ server.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetAccountList"><strong>GetAccountList</strong></a>(self, username<font color="#909090">='default'</font>, max_results<font color="#909090">=1000</font>, start_index<font color="#909090">=1</font>)</dt><dd><tt>Retrieves a feed containing all of a user's accounts and profiles.<br>
+The username parameter is soon to be deprecated, with 'default' <br>
+becoming the only allowed parameter.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetAccountListEntry"><strong>GetAccountListEntry</strong></a>(self, uri)</dt><dd><tt>Retrieves a particular AccountListEntry by its unique URI.<br>
+ <br>
+Args:<br>
+ uri: string The unique URI of an entry in an Account List feed.<br>
+ <br>
+Returns:<br>
+ An AccountListEntry object representing the retrieved entry.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetData"><strong>GetData</strong></a>(self, ids<font color="#909090">=''</font>, dimensions<font color="#909090">=''</font>, metrics<font color="#909090">=''</font>, sort<font color="#909090">=''</font>, filters<font color="#909090">=''</font>, start_date<font color="#909090">=''</font>, end_date<font color="#909090">=''</font>, start_index<font color="#909090">=''</font>, max_results<font color="#909090">=''</font>)</dt><dd><tt>Retrieves a feed containing a user's data<br>
+ <br>
+ids: comma-separated string of analytics accounts.<br>
+dimensions: comma-separated string of dimensions.<br>
+metrics: comma-separated string of metrics.<br>
+sort: comma-separated string of dimensions and metrics for sorting.<br>
+ This may be previxed with a minus to sort in reverse order. <br>
+ (e.g. '-ga:keyword')<br>
+ If ommited, the first dimension passed in will be used.<br>
+filters: comma-separated string of filter parameters.<br>
+ (e.g. 'ga:keyword==google')<br>
+start_date: start date for data pull.<br>
+end_date: end date for data pull.<br>
+start_index: used in combination with max_results to pull more than 1000 <br>
+ entries. This defaults to 1.<br>
+max_results: maximum results that the pull will return. This defaults<br>
+ to, and maxes out at 1000.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-QueryAccountListFeed"><strong>QueryAccountListFeed</strong></a>(self, uri)</dt><dd><tt>Retrieves an Account ListFeed by retrieving a URI based off the Account<br>
+ List feed, including any query parameters. A <a href="#AccountQuery">AccountQuery</a> object can<br>
+ be used to construct these parameters.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the feed being retrieved possibly with query<br>
+ parameters.<br>
+ <br>
+Returns:<br>
+ An AccountListFeed object representing the feed returned by the server.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='www.google.com/analytics'</font>, additional_headers<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a client for the Google Analytics service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'docs.google.com'.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="AnalyticsDataService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnalyticsDataService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#AnalyticsDataService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#AnalyticsDataService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#AnalyticsDataService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="AnalyticsDataService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="AnalyticsDataService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DataQuery">class <strong>DataQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Object used to construct a URI to a data feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.analytics.service.html#DataQuery">DataQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="DataQuery-ToUri"><strong>ToUri</strong></a>(self)</dt><dd><tt>Generates a URI from the query parameters set in the object.<br>
+ <br>
+Returns:<br>
+ A string containing the URI used to retrieve entries from the Analytics<br>
+ List feed.</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">='/feeds/data'</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>, ids<font color="#909090">=''</font>, dimensions<font color="#909090">=''</font>, metrics<font color="#909090">=''</font>, sort<font color="#909090">=''</font>, filters<font color="#909090">=''</font>, start_date<font color="#909090">=''</font>, end_date<font color="#909090">=''</font>, start_index<font color="#909090">=''</font>, max_results<font color="#909090">=''</font>)</dt><dd><tt>Constructor for Analytics List <a href="gdata.service.html#Query">Query</a><br>
+ <br>
+Args:<br>
+ feed: string (optional) The path for the feed. (e.g. '/feeds/data')<br>
+ <br>
+ text_query: string (optional) The contents of the q query parameter. <br>
+ This string is URL escaped upon conversion to a URI.<br>
+ params: dict (optional) Parameter value string pairs which become URL<br>
+ params when translated to a URI. These parameters are added to<br>
+ the query's items.<br>
+ categories: list (optional) List of category strings which should be<br>
+ included as query categories. See gdata.service.<a href="gdata.service.html#Query">Query</a> for<br>
+ additional documentation.<br>
+ ids: comma-separated string of analytics accounts.<br>
+ dimensions: comma-separated string of dimensions.<br>
+ metrics: comma-separated string of metrics.<br>
+ sort: comma-separated string of dimensions and metrics.<br>
+ This may be previxed with a minus to sort in reverse order <br>
+ (e.g. '-ga:keyword').<br>
+ If ommited, the first dimension passed in will be used.<br>
+ filters: comma-separated string of filter parameters <br>
+ (e.g. 'ga:keyword==google').<br>
+ start_date: start date for data pull.<br>
+ end_date: end date for data pull.<br>
+ start_index: used in combination with max_results to pull more than 1000 <br>
+ entries. This defaults to 1.<br>
+ max_results: maximum results that the pull will return. This defaults <br>
+ to, and maxes out at 1000.<br>
+ <br>
+Yields:<br>
+ A DocumentQuery object used to construct a URI based on the Document<br>
+ List feed.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="DataQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="DataQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DataQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#DataQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#DataQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#DataQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#DataQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="DataQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#DataQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#DataQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'api.suryasev (Sal Uryasev)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.suryasev (Sal Uryasev)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.adminsettings.html b/pydocs/gdata.apps.adminsettings.html
new file mode 100644
index 0000000..48b3a04
--- /dev/null
+++ b/pydocs/gdata.apps.adminsettings.html
@@ -0,0 +1,34 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.apps.adminsettings</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.adminsettings</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/adminsettings/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/adminsettings/__init__.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2008 Google<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.apps.adminsettings.service.html">service</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.adminsettings.service.html b/pydocs/gdata.apps.adminsettings.service.html
new file mode 100644
index 0000000..618669f
--- /dev/null
+++ b/pydocs/gdata.apps.adminsettings.service.html
@@ -0,0 +1,879 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.adminsettings.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.adminsettings.html"><font color="#ffffff">adminsettings</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/adminsettings/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/adminsettings/service.py</a></font></td></tr></table>
+ <p><tt>Allow Google Apps domain administrators to set domain admin settings.<br>
+ <br>
+<a href="#AdminSettingsService">AdminSettingsService</a>: Set admin settings.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.adminsettings.service.html#AdminSettingsService">AdminSettingsService</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AdminSettingsService">class <strong>AdminSettingsService</strong></a>(<a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Apps Admin Settings service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.adminsettings.service.html#AdminSettingsService">AdminSettingsService</a></dd>
+<dd><a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AdminSettingsService-AddEmailRoute"><strong>AddEmailRoute</strong></a>(self, routeDestination, routeRewriteTo, routeEnabled, bounceNotifications, accountHandling)</dt><dd><tt>Adds Domain Email Route<br>
+ <br>
+Args:<br>
+ routeDestination: string, destination ip address or hostname<br>
+ routeRewriteTo: boolean, rewrite smtp envelop To:<br>
+ routeEnabled: boolean, enable disable email routing<br>
+ bounceNotifications: boolean, send bound notificiations to sender<br>
+ accountHandling: string, which to route, "allAccounts", "provisionedAccounts", "unknownAccounts"<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetAdminSecondaryEmail"><strong>GetAdminSecondaryEmail</strong></a>(self)</dt><dd><tt>Gets Domain Admin Secondary Email Address<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: A string, the secondary email address for domain admin</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetCNAMEVerificationStatus"><strong>GetCNAMEVerificationStatus</strong></a>(self)</dt><dd><tt>Gets Domain CNAME Verification Status<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: A dict {recordName, verified, verifiedMethod}</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetCountryCode"><strong>GetCountryCode</strong></a>(self)</dt><dd><tt>Gets Domain Country Code<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: A string, the domain's country code. Possible values at:<br>
+ <a href="http://www.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm">http://www.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm</a></tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetCreationTime"><strong>GetCreationTime</strong></a>(self)</dt><dd><tt>Gets Domain Creation Time<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: A string, the domain's creation time</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetCurrentNumberOfUsers"><strong>GetCurrentNumberOfUsers</strong></a>(self)</dt><dd><tt>Gets Current Number of Users<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: An integer, the current number of users</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetCustomerPIN"><strong>GetCustomerPIN</strong></a>(self)</dt><dd><tt>Gets Customer PIN<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: A string, the customer PIN</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetDefaultLanguage"><strong>GetDefaultLanguage</strong></a>(self)</dt><dd><tt>Gets Domain Default Language<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns:<br>
+ Default Language as a string. All possible values are listed at:<br>
+ <a href="http://code.google.com/apis/apps/email_settings/developers_guide_protocol.html#GA_email_language_tags">http://code.google.com/apis/apps/email_settings/developers_guide_protocol.html#GA_email_language_tags</a></tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetDomainLogo"><strong>GetDomainLogo</strong></a>(self)</dt><dd><tt>Gets Domain Logo<br>
+ <br>
+This function does not make use of the Google Apps Admin Settings API,<br>
+it does an HTTP Get of a url specific to the Google Apps domain. It is<br>
+included for completeness sake.<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: binary image file</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetEdition"><strong>GetEdition</strong></a>(self)</dt><dd><tt>Gets Google Apps Domain Edition<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: A string, the domain's edition (premier, education, partner)</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetMXVerificationStatus"><strong>GetMXVerificationStatus</strong></a>(self)</dt><dd><tt>Gets Domain MX Verification Status<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: A dict {verified, verifiedMethod}</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetMaximumNumberOfUsers"><strong>GetMaximumNumberOfUsers</strong></a>(self)</dt><dd><tt>Gets Maximum Number of Users Allowed<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: An integer, the maximum number of users</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetOrganizationName"><strong>GetOrganizationName</strong></a>(self)</dt><dd><tt>Gets Domain Default Language<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns:<br>
+ Organization Name as a string.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetOutboundGatewaySettings"><strong>GetOutboundGatewaySettings</strong></a>(self)</dt><dd><tt>Get Outbound Gateway Settings<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns:<br>
+ A dict {smartHost, smtpMode}</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetSSOKey"><strong>GetSSOKey</strong></a>(self)</dt><dd><tt>Gets Domain Single Sign-On Signing Key<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: A dict {modulus, exponent, algorithm, format}</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetSSOSettings"><strong>GetSSOSettings</strong></a>(self)</dt><dd><tt>Gets Domain Single Sign-On Settings<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: A dict {samlSignonUri, samlLogoutUri, changePasswordUri, enableSSO, ssoWhitelist, useDomainSpecificIssuer}</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetSupportPIN"><strong>GetSupportPIN</strong></a>(self)</dt><dd><tt>Gets Support PIN<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: A string, the Support PIN</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-IsDomainVerified"><strong>IsDomainVerified</strong></a>(self)</dt><dd><tt>Is the domain verified<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns: Boolean, is domain verified</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-IsUserMigrationEnabled"><strong>IsUserMigrationEnabled</strong></a>(self)</dt><dd><tt>Is User Migration Enabled<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns:<br>
+ boolean, is user migration enabled</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpdateAdminSecondaryEmail"><strong>UpdateAdminSecondaryEmail</strong></a>(self, adminSecondaryEmail)</dt><dd><tt>Gets Domain Creation Time<br>
+ <br>
+Args:<br>
+ adminSecondaryEmail: string, secondary email address of admin<br>
+ <br>
+Returns: A dict containing the result of the put operation</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpdateCNAMEVerificationStatus"><strong>UpdateCNAMEVerificationStatus</strong></a>(self, verified)</dt><dd><tt>Updates CNAME Verification Status<br>
+ <br>
+Args:<br>
+ verified: boolean, True will retry verification process<br>
+ <br>
+Returns: A dict containing the result of the put operation</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpdateDefaultLanguage"><strong>UpdateDefaultLanguage</strong></a>(self, defaultLanguage)</dt><dd><tt>Updates Domain Default Language<br>
+ <br>
+Args:<br>
+ defaultLanguage: Domain Language to set<br>
+ possible values are at:<br>
+ <a href="http://code.google.com/apis/apps/email_settings/developers_guide_protocol.html#GA_email_language_tags">http://code.google.com/apis/apps/email_settings/developers_guide_protocol.html#GA_email_language_tags</a><br>
+ <br>
+Returns:<br>
+ A dict containing the result of the put operation</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpdateDomainLogo"><strong>UpdateDomainLogo</strong></a>(self, logoImage)</dt><dd><tt>Update Domain's Custom Logo<br>
+ <br>
+Args:<br>
+ logoImage: binary image data<br>
+ <br>
+Returns: A dict containing the result of the put operation</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpdateMXVerificationStatus"><strong>UpdateMXVerificationStatus</strong></a>(self, verified)</dt><dd><tt>Updates MX Verification Status<br>
+ <br>
+Args:<br>
+ verified: boolean, True will retry verification process<br>
+ <br>
+Returns: A dict containing the result of the put operation</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpdateOrganizationName"><strong>UpdateOrganizationName</strong></a>(self, organizationName)</dt><dd><tt>Updates Organization Name<br>
+ <br>
+Args:<br>
+ organizationName: Name of organization<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the put operation</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpdateOutboundGatewaySettings"><strong>UpdateOutboundGatewaySettings</strong></a>(self, smartHost<font color="#909090">=None</font>, smtpMode<font color="#909090">=None</font>)</dt><dd><tt>Update Outbound Gateway Settings<br>
+ <br>
+Args:<br>
+ smartHost: string, ip address or hostname of outbound gateway<br>
+ smtpMode: string, SMTP or SMTP_TLS<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpdateSSOKey"><strong>UpdateSSOKey</strong></a>(self, signingKey)</dt><dd><tt>Update SSO Settings.<br>
+ <br>
+Args:<br>
+ signingKey: string, public key to be uploaded<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpdateSSOSettings"><strong>UpdateSSOSettings</strong></a>(self, enableSSO<font color="#909090">=None</font>, samlSignonUri<font color="#909090">=None</font>, samlLogoutUri<font color="#909090">=None</font>, changePasswordUri<font color="#909090">=None</font>, ssoWhitelist<font color="#909090">=None</font>, useDomainSpecificIssuer<font color="#909090">=None</font>)</dt><dd><tt>Update SSO Settings.<br>
+ <br>
+Args:<br>
+ enableSSO: boolean, SSO Master on/off switch<br>
+ samlSignonUri: string, SSO Login Page<br>
+ samlLogoutUri: string, SSO Logout Page<br>
+ samlPasswordUri: string, SSO Password Change Page<br>
+ ssoWhitelist: string, Range of IP Addresses which will see SSO<br>
+ useDomainSpecificIssuer: boolean, Include Google Apps Domain in Issuer<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpdateUserMigrationStatus"><strong>UpdateUserMigrationStatus</strong></a>(self, enableUserMigration)</dt><dd><tt>Update User Migration Status<br>
+ <br>
+Args:<br>
+ enableUserMigration: boolean, user migration enable/disable<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-genericGet"><strong>genericGet</strong></a>(self, location)</dt><dd><tt>Generic HTTP Get Wrapper<br>
+ <br>
+Args:<br>
+ location: relative uri to Get<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the get operation.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>:<br>
+<dl><dt><a name="AdminSettingsService-AddAllElementsFromAllPages"><strong>AddAllElementsFromAllPages</strong></a>(self, link_finder, func)</dt><dd><tt>retrieve all pages and add all elements</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, domain<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='apps-apis.google.com'</font>, additional_headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="AdminSettingsService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt>Query the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AdminSettingsService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#AdminSettingsService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#AdminSettingsService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#AdminSettingsService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="AdminSettingsService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="AdminSettingsService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>API_VER</strong> = '2.0'<br>
+<strong>__author__</strong> = 'jlee@pbu.edu'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">jlee@pbu.edu</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.apps_property_entry.html b/pydocs/gdata.apps.apps_property_entry.html
new file mode 100644
index 0000000..06a3508
--- /dev/null
+++ b/pydocs/gdata.apps.apps_property_entry.html
@@ -0,0 +1,385 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.apps_property_entry</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.apps_property_entry</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/apps_property_entry.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/apps_property_entry.py</a></font></td></tr></table>
+ <p><tt>Generic class for Set/Get properties of GData Provisioning clients.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">AppsPropertyEntry</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AppsPropertyEntry">class <strong>AppsPropertyEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a generic entry in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">AppsPropertyEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="AppsPropertyEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="AppsPropertyEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AppsPropertyEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="AppsPropertyEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="AppsPropertyEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsPropertyEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'Gunjan Sharma <gunjansharma@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Gunjan Sharma <gunjansharma@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.audit.html b/pydocs/gdata.apps.audit.html
new file mode 100644
index 0000000..efa1c61
--- /dev/null
+++ b/pydocs/gdata.apps.audit.html
@@ -0,0 +1,22 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.apps.audit</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.audit</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/audit/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/audit/__init__.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.apps.audit.service.html">service</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.audit.service.html b/pydocs/gdata.apps.audit.service.html
new file mode 100644
index 0000000..3928b1c
--- /dev/null
+++ b/pydocs/gdata.apps.audit.service.html
@@ -0,0 +1,760 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.audit.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.audit.html"><font color="#ffffff">audit</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/audit/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/audit/service.py</a></font></td></tr></table>
+ <p><tt>Allow Google Apps domain administrators to audit user data.<br>
+ <br>
+<a href="#AuditService">AuditService</a>: Set auditing.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.audit.service.html#AuditService">AuditService</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AuditService">class <strong>AuditService</strong></a>(<a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Apps Audit service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.audit.service.html#AuditService">AuditService</a></dd>
+<dd><a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AuditService-createAccountInformationRequest"><strong>createAccountInformationRequest</strong></a>(self, user)</dt><dd><tt>Creates a request for account auditing details<br>
+ <br>
+Args:<br>
+ user: string, the user to request account information for<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the post operation.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-createEmailMonitor"><strong>createEmailMonitor</strong></a>(self, source_user, destination_user, end_date, begin_date<font color="#909090">=None</font>, incoming_headers_only<font color="#909090">=False</font>, outgoing_headers_only<font color="#909090">=False</font>, drafts<font color="#909090">=False</font>, drafts_headers_only<font color="#909090">=False</font>, chats<font color="#909090">=False</font>, chats_headers_only<font color="#909090">=False</font>)</dt><dd><tt>Creates a email monitor, forwarding the source_users emails/chats<br>
+ <br>
+Args:<br>
+ source_user: string, the user whose email will be audited<br>
+ destination_user: string, the user to receive the audited email<br>
+ end_date: string, the date the audit will end in<br>
+ "yyyy-MM-dd HH:mm" format, required<br>
+ begin_date: string, the date the audit will start in <br>
+ "yyyy-MM-dd HH:mm" format, leave blank to use current time<br>
+ incoming_headers_only: boolean, whether to audit only the headers of<br>
+ mail delivered to source user<br>
+ outgoing_headers_only: boolean, whether to audit only the headers of<br>
+ mail sent from the source user<br>
+ drafts: boolean, whether to audit draft messages of the source user<br>
+ drafts_headers_only: boolean, whether to audit only the headers of<br>
+ mail drafts saved by the user<br>
+ chats: boolean, whether to audit archived chats of the source user<br>
+ chats_headers_only: boolean, whether to audit only the headers of<br>
+ archived chats of the source user<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the POST operation.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-createMailboxExportRequest"><strong>createMailboxExportRequest</strong></a>(self, user, begin_date<font color="#909090">=None</font>, end_date<font color="#909090">=None</font>, include_deleted<font color="#909090">=False</font>, search_query<font color="#909090">=None</font>, headers_only<font color="#909090">=False</font>)</dt><dd><tt>Creates a mailbox export request<br>
+ <br>
+Args:<br>
+ user: string, the user whose mailbox export is being requested<br>
+ begin_date: string, date of earliest emails to export, optional, defaults to date of account creation<br>
+ format is 'yyyy-MM-dd HH:mm'<br>
+ end_date: string, date of latest emails to export, optional, defaults to current date<br>
+ format is 'yyyy-MM-dd HH:mm'<br>
+ include_deleted: boolean, whether to include deleted emails in export, mutually exclusive with search_query<br>
+ search_query: string, gmail style search query, matched emails will be exported, mutually exclusive with include_deleted<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the post operation.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-deleteAccountInformationRequest"><strong>deleteAccountInformationRequest</strong></a>(self, user, request_id)</dt><dd><tt>Deletes the request for account auditing information<br>
+ <br>
+Args:<br>
+ user: string, the user whose account auditing details were requested<br>
+ request_id: string, the request_id<br>
+ <br>
+Returns:<br>
+ Nothing</tt></dd></dl>
+
+<dl><dt><a name="AuditService-deleteEmailMonitor"><strong>deleteEmailMonitor</strong></a>(self, source_user, destination_user)</dt><dd><tt>Deletes the email monitor for the given user<br>
+ <br>
+Args:<br>
+ source_user: string, the user who is being monitored<br>
+ destination_user: string, theuser who recieves the monitored emails<br>
+ <br>
+Returns:<br>
+ Nothing</tt></dd></dl>
+
+<dl><dt><a name="AuditService-deleteMailboxExportRequest"><strong>deleteMailboxExportRequest</strong></a>(self, user, request_id)</dt><dd><tt>Deletes the request for mailbox export<br>
+ <br>
+Args:<br>
+ user: string, the user whose mailbox were requested<br>
+ request_id: string, the request_id<br>
+ <br>
+Returns:<br>
+ Nothing</tt></dd></dl>
+
+<dl><dt><a name="AuditService-getAccountInformationRequestStatus"><strong>getAccountInformationRequestStatus</strong></a>(self, user, request_id)</dt><dd><tt>Gets the status of an account auditing request<br>
+ <br>
+Args:<br>
+ user: string, the user whose account auditing details were requested<br>
+ request_id: string, the request_id<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the get operation.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-getAllAccountInformationRequestsStatus"><strong>getAllAccountInformationRequestsStatus</strong></a>(self)</dt><dd><tt>Gets the status of all account auditing requests for the domain<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns:<br>
+ list results of the POST operation</tt></dd></dl>
+
+<dl><dt><a name="AuditService-getAllMailboxExportRequestsStatus"><strong>getAllMailboxExportRequestsStatus</strong></a>(self)</dt><dd><tt>Gets the status of all mailbox export requests for the domain<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns:<br>
+ list results of the POST operation</tt></dd></dl>
+
+<dl><dt><a name="AuditService-getEmailMonitors"><strong>getEmailMonitors</strong></a>(self, user)</dt><dd><tt>"Gets the email monitors for the given user<br>
+ <br>
+Args:<br>
+ user: string, the user to retrieve email monitors for<br>
+ <br>
+Returns:<br>
+ list results of the POST operation</tt></dd></dl>
+
+<dl><dt><a name="AuditService-getMailboxExportRequestStatus"><strong>getMailboxExportRequestStatus</strong></a>(self, user, request_id)</dt><dd><tt>Gets the status of an mailbox export request<br>
+ <br>
+Args:<br>
+ user: string, the user whose mailbox were requested<br>
+ request_id: string, the request_id<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the get operation.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-updatePGPKey"><strong>updatePGPKey</strong></a>(self, pgpkey)</dt><dd><tt>Updates Public PGP Key Google uses to encrypt audit data<br>
+ <br>
+Args:<br>
+ pgpkey: string, ASCII text of PGP Public Key to be used<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the POST operation.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>:<br>
+<dl><dt><a name="AuditService-AddAllElementsFromAllPages"><strong>AddAllElementsFromAllPages</strong></a>(self, link_finder, func)</dt><dd><tt>retrieve all pages and add all elements</tt></dd></dl>
+
+<dl><dt><a name="AuditService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, domain<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='apps-apis.google.com'</font>, additional_headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="AuditService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="AuditService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="AuditService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt>Query the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="AuditService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AuditService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#AuditService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AuditService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AuditService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="AuditService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AuditService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="AuditService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#AuditService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#AuditService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="AuditService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="AuditService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="AuditService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'jlee@pbu.edu'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">jlee@pbu.edu</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.client.html b/pydocs/gdata.apps.client.html
new file mode 100644
index 0000000..6685bcd
--- /dev/null
+++ b/pydocs/gdata.apps.client.html
@@ -0,0 +1,691 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/client.py</a></font></td></tr></table>
+ <p><tt><a href="#AppsClient">AppsClient</a> adds Client Architecture to Provisioning API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.client.html#AppsClient">AppsClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AppsClient">class <strong>AppsClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Provisioning API service.<br>
+ <br>
+Attributes:<br>
+ host: string The hostname for the Provisioning API service.<br>
+ api_version: string The version of the Provisioning API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.client.html#AppsClient">AppsClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AppsClient-CreateNickname"><strong>CreateNickname</strong></a>(self, user_name, nickname)</dt><dd><tt>Create a nickname for a user.<br>
+ <br>
+Args:<br>
+ user_name: string user whose nickname is being created.<br>
+ nickname: string nickname.<br>
+ <br>
+Returns:<br>
+ gdata.apps.data.NicknameEntry</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-CreateUser"><strong>CreateUser</strong></a>(self, user_name, family_name, given_name, password, suspended<font color="#909090">=False</font>, admin<font color="#909090">=None</font>, quota_limit<font color="#909090">=None</font>, password_hash_function<font color="#909090">=None</font>, agreed_to_terms<font color="#909090">=None</font>, change_password<font color="#909090">=None</font>)</dt><dd><tt>Create a user account.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-DeleteNickname"><strong>DeleteNickname</strong></a>(self, nickname)</dt><dd><tt>Delete a nickname.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-DeleteUser"><strong>DeleteUser</strong></a>(self, user_name)</dt><dd><tt>Delete a user account.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-RetrieveAllPages"><strong>RetrieveAllPages</strong></a>(self, feed, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>)</dt><dd><tt>Retrieve all pages and add all elements.<br>
+ <br>
+Args:<br>
+ feed: gdata.data.GDFeed object with linked elements.<br>
+ desired_class: type of feed to be returned.<br>
+ <br>
+Returns:<br>
+ desired_class: subclass of gdata.data.GDFeed.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-RetrieveAllUsers"><strong>RetrieveAllUsers</strong></a>(self)</dt><dd><tt>Retrieve all users in this domain.<br>
+ <br>
+Returns:<br>
+ gdata.apps.data.UserFeed</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-RetrieveNickname"><strong>RetrieveNickname</strong></a>(self, nickname)</dt><dd><tt>Retrieve a nickname.<br>
+ <br>
+Args:<br>
+ nickname: string nickname to be retrieved.<br>
+ <br>
+Returns:<br>
+ gdata.apps.data.NicknameEntry</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-RetrieveNicknames"><strong>RetrieveNicknames</strong></a>(self, user_name)</dt><dd><tt>Retrieve nicknames of the user.<br>
+ <br>
+Args:<br>
+ user_name: string user whose nicknames are retrieved.<br>
+ <br>
+Returns:<br>
+ gdata.apps.data.NicknameFeed</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-RetrievePageOfUsers"><strong>RetrievePageOfUsers</strong></a>(self, start_username<font color="#909090">=None</font>)</dt><dd><tt>Retrieve one page of users in this domain.<br>
+ <br>
+Args:<br>
+ start_username: string user to start from for retrieving a page of users.<br>
+ <br>
+Returns:<br>
+ gdata.apps.data.UserFeed</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-RetrieveUser"><strong>RetrieveUser</strong></a>(self, user_name)</dt><dd><tt>Retrieve a user account.<br>
+ <br>
+Args:<br>
+ user_name: string user_name to be retrieved.<br>
+ <br>
+Returns:<br>
+ gdata.apps.data.UserEntry</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-UpdateUser"><strong>UpdateUser</strong></a>(self, user_name, user_entry)</dt><dd><tt>Update a user account.<br>
+ <br>
+Args:<br>
+ user_name: string user_name to be updated.<br>
+ user_entry: gdata.apps.data.UserEntry updated user entry.<br>
+ <br>
+Returns:<br>
+ gdata.apps.data.UserEntry</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-__init__"><strong>__init__</strong></a>(self, domain, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a new client for the Provisioning API.<br>
+ <br>
+Args:<br>
+ domain: string Google Apps domain name.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes client to make calls to Provisioning API.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '2.0'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://apps-apis.google.com/a/feeds/user/', 'https://apps-apis.google.com/a/feeds/policies/', 'https://apps-apis.google.com/a/feeds/alias/', 'https://apps-apis.google.com/a/feeds/groups/', 'https://apps-apis.google.com/a/feeds/compliance/audit/', 'https://apps-apis.google.com/a/feeds/migration/', 'https://apps-apis.google.com/a/feeds/emailsettings/2.0/')</dl>
+
+<dl><dt><strong>auth_service</strong> = 'apps'</dl>
+
+<dl><dt><strong>host</strong> = 'apps-apis.google.com'</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="AppsClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AppsClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AppsClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AppsClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AppsClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AppsClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AppsClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AppsClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AppsClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="AppsClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AppsClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="AppsClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="AppsClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = '<Shraddha Gupta shraddhag@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%"><Shraddha Gupta shraddhag@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.data.html b/pydocs/gdata.apps.data.html
new file mode 100644
index 0000000..ae1ef20
--- /dev/null
+++ b/pydocs/gdata.apps.data.html
@@ -0,0 +1,1999 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/data.py</a></font></td></tr></table>
+ <p><tt>Data model classes for the Provisioning API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.data.html#Login">Login</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.data.html#Name">Name</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.data.html#Nickname">Nickname</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.data.html#Quota">Quota</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.data.html#NicknameEntry">NicknameEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.data.html#UserEntry">UserEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.data.html#NicknameFeed">NicknameFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.data.html#UserFeed">UserFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Login">class <strong>Login</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.data.html#Login">Login</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>admin</strong> = 'admin'</dl>
+
+<dl><dt><strong>agreed_to_terms</strong> = 'agreedToTerms'</dl>
+
+<dl><dt><strong>change_password</strong> = 'changePasswordAtNextLogin'</dl>
+
+<dl><dt><strong>hash_function_name</strong> = 'hashFunctionName'</dl>
+
+<dl><dt><strong>ip_whitelisted</strong> = 'ipWhitelisted'</dl>
+
+<dl><dt><strong>password</strong> = 'password'</dl>
+
+<dl><dt><strong>suspended</strong> = 'suspended'</dl>
+
+<dl><dt><strong>user_name</strong> = 'userName'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Login-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Login-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Login-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Login-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Login-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Login-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Login-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Login-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Login-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Login-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Name">class <strong>Name</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.data.html#Name">Name</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>family_name</strong> = 'familyName'</dl>
+
+<dl><dt><strong>given_name</strong> = 'givenName'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Name-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Name-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Name-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Name-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Name-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Name-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Nickname">class <strong>Nickname</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.data.html#Nickname">Nickname</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Nickname-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Nickname-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Nickname-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Nickname-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Nickname-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Nickname-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Nickname-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Nickname-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Nickname-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Nickname-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NicknameEntry">class <strong>NicknameEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.data.html#NicknameEntry">NicknameEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>login</strong> = <class 'gdata.apps.data.Login'></dl>
+
+<dl><dt><strong>nickname</strong> = <class 'gdata.apps.data.Nickname'></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="NicknameEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="NicknameEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="NicknameEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="NicknameEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="NicknameEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NicknameFeed">class <strong>NicknameFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.data.html#NicknameFeed">NicknameFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.apps.data.NicknameEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="NicknameFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="NicknameFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="NicknameFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="NicknameFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="NicknameFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Quota">class <strong>Quota</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.data.html#Quota">Quota</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>limit</strong> = 'limit'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Quota-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Quota-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Quota-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Quota-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Quota-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Quota-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Quota-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Quota-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Quota-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Quota-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserEntry">class <strong>UserEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.data.html#UserEntry">UserEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>login</strong> = <class 'gdata.apps.data.Login'></dl>
+
+<dl><dt><strong>name</strong> = <class 'gdata.apps.data.Name'></dl>
+
+<dl><dt><strong>quota</strong> = <class 'gdata.apps.data.Quota'></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="UserEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="UserEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UserEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserFeed">class <strong>UserFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.data.html#UserFeed">UserFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.apps.data.UserEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="UserFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="UserFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UserFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'Shraddha Gupta shraddhag@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Shraddha Gupta shraddhag@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.emailsettings.client.html b/pydocs/gdata.apps.emailsettings.client.html
new file mode 100644
index 0000000..434cd36
--- /dev/null
+++ b/pydocs/gdata.apps.emailsettings.client.html
@@ -0,0 +1,962 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.emailsettings.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.emailsettings.html"><font color="#ffffff">emailsettings</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/emailsettings/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/emailsettings/client.py</a></font></td></tr></table>
+ <p><tt><a href="#EmailSettingsClient">EmailSettingsClient</a> simplifies Email Settings API calls.<br>
+ <br>
+<a href="#EmailSettingsClient">EmailSettingsClient</a> extends gdata.client.<a href="gdata.client.html#GDClient">GDClient</a> to ease interaction with<br>
+the Google Apps Email Settings API. These interactions include the ability<br>
+to create labels, filters, aliases, and update web-clip, forwarding, POP,<br>
+IMAP, vacation-responder, signature, language, and general settings, and<br>
+retrieve labels, send-as, forwarding, pop, imap, vacation and signature<br>
+settings.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.client.html#EmailSettingsClient">EmailSettingsClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsClient">class <strong>EmailSettingsClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Email Settings API service.<br>
+ <br>
+Attributes:<br>
+ host: string The hostname for the Email Settings API service.<br>
+ api_version: string The version of the Email Settings API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.client.html#EmailSettingsClient">EmailSettingsClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsClient-AddEmailDelegate"><strong>AddEmailDelegate</strong></a> = <a href="#EmailSettingsClient-add_email_delegate">add_email_delegate</a>(self, username, address, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-CreateFilter"><strong>CreateFilter</strong></a> = <a href="#EmailSettingsClient-create_filter">create_filter</a>(self, username, from_address<font color="#909090">=None</font>, to_address<font color="#909090">=None</font>, subject<font color="#909090">=None</font>, has_the_word<font color="#909090">=None</font>, does_not_have_the_word<font color="#909090">=None</font>, has_attachments<font color="#909090">=None</font>, label<font color="#909090">=None</font>, mark_as_read<font color="#909090">=None</font>, archive<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-CreateLabel"><strong>CreateLabel</strong></a> = <a href="#EmailSettingsClient-create_label">create_label</a>(self, username, name, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-CreateSendAs"><strong>CreateSendAs</strong></a> = <a href="#EmailSettingsClient-create_send_as">create_send_as</a>(self, username, name, address, reply_to<font color="#909090">=None</font>, make_default<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-DeleteEmailDelegate"><strong>DeleteEmailDelegate</strong></a> = <a href="#EmailSettingsClient-delete_email_delegate">delete_email_delegate</a>(self, username, address, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-DeleteLabel"><strong>DeleteLabel</strong></a> = <a href="#EmailSettingsClient-delete_label">delete_label</a>(self, username, label, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-MakeEmailSettingsUri"><strong>MakeEmailSettingsUri</strong></a> = <a href="#EmailSettingsClient-make_email_settings_uri">make_email_settings_uri</a>(self, username, setting_id)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-RetrieveEmailDelegates"><strong>RetrieveEmailDelegates</strong></a> = <a href="#EmailSettingsClient-retrieve_email_delegates">retrieve_email_delegates</a>(self, username, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-RetrieveForwarding"><strong>RetrieveForwarding</strong></a> = <a href="#EmailSettingsClient-retrieve_forwarding">retrieve_forwarding</a>(self, username, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-RetrieveImap"><strong>RetrieveImap</strong></a> = <a href="#EmailSettingsClient-retrieve_imap">retrieve_imap</a>(self, username, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-RetrieveLabels"><strong>RetrieveLabels</strong></a> = <a href="#EmailSettingsClient-retrieve_labels">retrieve_labels</a>(self, username, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-RetrievePop"><strong>RetrievePop</strong></a> = <a href="#EmailSettingsClient-retrieve_pop">retrieve_pop</a>(self, username, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-RetrieveSendAs"><strong>RetrieveSendAs</strong></a> = <a href="#EmailSettingsClient-retrieve_send_as">retrieve_send_as</a>(self, username, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-RetrieveSignature"><strong>RetrieveSignature</strong></a> = <a href="#EmailSettingsClient-retrieve_signature">retrieve_signature</a>(self, username, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-RetrieveVacation"><strong>RetrieveVacation</strong></a> = <a href="#EmailSettingsClient-retrieve_vacation">retrieve_vacation</a>(self, username, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-UpdateForwarding"><strong>UpdateForwarding</strong></a> = <a href="#EmailSettingsClient-update_forwarding">update_forwarding</a>(self, username, enable, forward_to<font color="#909090">=None</font>, action<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-UpdateGeneralSettings"><strong>UpdateGeneralSettings</strong></a> = <a href="#EmailSettingsClient-update_general_settings">update_general_settings</a>(self, username, page_size<font color="#909090">=None</font>, shortcuts<font color="#909090">=None</font>, arrows<font color="#909090">=None</font>, snippets<font color="#909090">=None</font>, use_unicode<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-UpdateImap"><strong>UpdateImap</strong></a> = <a href="#EmailSettingsClient-update_imap">update_imap</a>(self, username, enable, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-UpdateLanguage"><strong>UpdateLanguage</strong></a> = <a href="#EmailSettingsClient-update_language">update_language</a>(self, username, language, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-UpdatePop"><strong>UpdatePop</strong></a> = <a href="#EmailSettingsClient-update_pop">update_pop</a>(self, username, enable, enable_for<font color="#909090">=None</font>, action<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-UpdateSignature"><strong>UpdateSignature</strong></a> = <a href="#EmailSettingsClient-update_signature">update_signature</a>(self, username, signature, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-UpdateVacation"><strong>UpdateVacation</strong></a> = <a href="#EmailSettingsClient-update_vacation">update_vacation</a>(self, username, enable, subject<font color="#909090">=None</font>, message<font color="#909090">=None</font>, start_date<font color="#909090">=None</font>, end_date<font color="#909090">=None</font>, contacts_only<font color="#909090">=None</font>, domain_only<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-UpdateWebclip"><strong>UpdateWebclip</strong></a> = <a href="#EmailSettingsClient-update_webclip">update_webclip</a>(self, username, enable, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-__init__"><strong>__init__</strong></a>(self, domain, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a new client for the Email Settings API.<br>
+ <br>
+Args:<br>
+ domain: string The Google Apps domain with Email Settings.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the email settings.<br>
+ kwargs: The other parameters to pass to the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a><br>
+ constructor.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-add_email_delegate"><strong>add_email_delegate</strong></a>(self, username, address, **kwargs)</dt><dd><tt>Add an email delegate to the mail account<br>
+ <br>
+Args:<br>
+ username: string The name of the user<br>
+ address: string The email address of the delegated account</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-create_filter"><strong>create_filter</strong></a>(self, username, from_address<font color="#909090">=None</font>, to_address<font color="#909090">=None</font>, subject<font color="#909090">=None</font>, has_the_word<font color="#909090">=None</font>, does_not_have_the_word<font color="#909090">=None</font>, has_attachments<font color="#909090">=None</font>, label<font color="#909090">=None</font>, mark_as_read<font color="#909090">=None</font>, archive<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a filter with the given properties.<br>
+ <br>
+Args:<br>
+ username: string The name of the user.<br>
+ from_address: string The source email address for the filter.<br>
+ to_address: string (optional) The destination email address for<br>
+ the filter.<br>
+ subject: string (optional) The value the email must have in its<br>
+ subject to be filtered.<br>
+ has_the_word: string (optional) The value the email must have<br>
+ in its subject or body to be filtered.<br>
+ does_not_have_the_word: string (optional) The value the email<br>
+ cannot have in its subject or body to be filtered.<br>
+ has_attachments: string (optional) A boolean string representing<br>
+ whether the email must have an attachment to be filtered.<br>
+ label: string (optional) The name of the label to apply to<br>
+ messages matching the filter criteria.<br>
+ mark_as_read: Boolean (optional) Whether or not to mark<br>
+ messages matching the filter criteria as read.<br>
+ archive: Boolean (optional) Whether or not to move messages<br>
+ matching to Archived state.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#EmailSettingsClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.apps.emailsettings.data.EmailSettingsFilter of the new resource.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-create_label"><strong>create_label</strong></a>(self, username, name, **kwargs)</dt><dd><tt>Creates a label with the given properties.<br>
+ <br>
+Args:<br>
+ username: string The name of the user.<br>
+ name: string The name of the label.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#EmailSettingsClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.apps.emailsettings.data.EmailSettingsLabel of the new resource.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-create_send_as"><strong>create_send_as</strong></a>(self, username, name, address, reply_to<font color="#909090">=None</font>, make_default<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a send-as alias with the given properties.<br>
+ <br>
+Args:<br>
+ username: string The name of the user.<br>
+ name: string The name that will appear in the "From" field.<br>
+ address: string The email address that appears as the<br>
+ origination address for emails sent by this user.<br>
+ reply_to: string (optional) The address to be used as the reply-to<br>
+ address in email sent using the alias.<br>
+ make_default: Boolean (optional) Whether or not this alias should<br>
+ become the default alias for this user.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#EmailSettingsClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.apps.emailsettings.data.EmailSettingsSendAsAlias of the<br>
+ new resource.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-delete_email_delegate"><strong>delete_email_delegate</strong></a>(self, username, address, **kwargs)</dt><dd><tt>Delete an email delegate from the specified account<br>
+ <br>
+Args:<br>
+ username: string The name of the user<br>
+ address: string The email address of the delegated account</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-delete_label"><strong>delete_label</strong></a>(self, username, label, **kwargs)</dt><dd><tt>Delete a label from the specified account.<br>
+ <br>
+Args:<br>
+ username: string Name of the user<br>
+ label: string Name of the label to be deleted<br>
+ <br>
+Returns:<br>
+ An atom.http_core.HttpResponse() with the result of the request</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-make_email_settings_uri"><strong>make_email_settings_uri</strong></a>(self, username, setting_id)</dt><dd><tt>Creates the URI for the Email Settings API call.<br>
+ <br>
+Using this client's Google Apps domain, create the URI to setup<br>
+email settings for the given user in that domain. If params are provided,<br>
+append them as GET params.<br>
+ <br>
+Args:<br>
+ username: string The name of the user affected by this setting.<br>
+ setting_id: string The key of the setting to be configured.<br>
+ <br>
+Returns:<br>
+ A string giving the URI for Email Settings API calls for this client's<br>
+ Google Apps domain.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-retrieve_email_delegates"><strong>retrieve_email_delegates</strong></a>(self, username, **kwargs)</dt><dd><tt>Retrieve a feed of the email delegates for the specified username<br>
+ <br>
+Args:<br>
+ username: string The name of the user to get the email delegates for<br>
+ <br>
+Returns:<br>
+ A gdata.data.GDFeed of the user's email delegates</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-retrieve_forwarding"><strong>retrieve_forwarding</strong></a>(self, username, **kwargs)</dt><dd><tt>Retrieves forwarding settings for the specified username<br>
+ <br>
+Args:<br>
+ username: string The name of the user to get the forwarding settings for<br>
+ <br>
+Returns:<br>
+ A gdata.data.GDEntry of the user's email forwarding settings</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-retrieve_imap"><strong>retrieve_imap</strong></a>(self, username, **kwargs)</dt><dd><tt>Retrieves imap settings for the specified username<br>
+ <br>
+Args:<br>
+ username: string The name of the user to get the imap settings for<br>
+ <br>
+Returns:<br>
+ A gdata.data.GDEntry of the user's IMAP settings</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-retrieve_labels"><strong>retrieve_labels</strong></a>(self, username, **kwargs)</dt><dd><tt>Retrieves email labels for the specified username<br>
+ <br>
+Args:<br>
+ username: string The name of the user to get the labels for<br>
+ <br>
+Returns:<br>
+ A gdata.data.GDFeed of the user's email labels</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-retrieve_pop"><strong>retrieve_pop</strong></a>(self, username, **kwargs)</dt><dd><tt>Retrieves POP settings for the specified username<br>
+ <br>
+Args:<br>
+ username: string The name of the user to get the POP settings for<br>
+ <br>
+Returns:<br>
+ A gdata.data.GDEntry of the user's POP settings</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-retrieve_send_as"><strong>retrieve_send_as</strong></a>(self, username, **kwargs)</dt><dd><tt>Retrieves send-as aliases for the specified username<br>
+ <br>
+Args:<br>
+ username: string The name of the user to get the send-as for<br>
+ <br>
+Returns:<br>
+ A gdata.data.GDFeed of the user's send-as alias settings</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-retrieve_signature"><strong>retrieve_signature</strong></a>(self, username, **kwargs)</dt><dd><tt>Retrieves signature settings for the specified username<br>
+ <br>
+Args:<br>
+ username: string The name of the user to get the signature settings for<br>
+ <br>
+Returns:<br>
+ A gdata.data.GDEntry of the user's signature settings</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-retrieve_vacation"><strong>retrieve_vacation</strong></a>(self, username, **kwargs)</dt><dd><tt>Retrieves vacation settings for the specified username<br>
+ <br>
+Args:<br>
+ username: string The name of the user to get the vacation settings for<br>
+ <br>
+Returns:<br>
+ A gdata.data.GDEntry of the user's vacation auto-responder settings</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-update_forwarding"><strong>update_forwarding</strong></a>(self, username, enable, forward_to<font color="#909090">=None</font>, action<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Update Google Mail Forwarding settings.<br>
+ <br>
+Args:<br>
+ username: string The name of the user.<br>
+ enable: Boolean Whether to enable incoming email forwarding.<br>
+ forward_to: (optional) string The address email will be forwarded to.<br>
+ action: string (optional) The action to perform after forwarding<br>
+ an email (ACTION_KEEP, ACTION_ARCHIVE, ACTION_DELETE).<br>
+ kwargs: The other parameters to pass to the update method.<br>
+ <br>
+Returns:<br>
+ gdata.apps.emailsettings.data.EmailSettingsForwarding of the<br>
+ updated resource</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-update_general_settings"><strong>update_general_settings</strong></a>(self, username, page_size<font color="#909090">=None</font>, shortcuts<font color="#909090">=None</font>, arrows<font color="#909090">=None</font>, snippets<font color="#909090">=None</font>, use_unicode<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Update Google Mail general settings.<br>
+ <br>
+Args:<br>
+ username: string The name of the user.<br>
+ page_size: int (optional) The number of conversations to be shown per<br>
+ page.<br>
+ shortcuts: Boolean (optional) Whether to enable keyboard shortcuts.<br>
+ arrows: Boolean (optional) Whether to display arrow-shaped personal<br>
+ indicators next to email sent specifically to the user.<br>
+ snippets: Boolean (optional) Whether to display snippets of the messages<br>
+ in the inbox and when searching.<br>
+ use_unicode: Boolean (optional) Whether to use UTF-8 (unicode) encoding<br>
+ for all outgoing messages.<br>
+ kwargs: The other parameters to pass to the update method.<br>
+ <br>
+Returns:<br>
+ gdata.apps.emailsettings.data.EmailSettingsGeneral of the<br>
+ updated resource.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-update_imap"><strong>update_imap</strong></a>(self, username, enable, **kwargs)</dt><dd><tt>Update Google Mail IMAP settings.<br>
+ <br>
+Args:<br>
+ username: string The name of the user.<br>
+ enable: Boolean Whether to enable IMAP access.language<br>
+ kwargs: The other parameters to pass to the update method.<br>
+ <br>
+Returns:<br>
+ gdata.apps.emailsettings.data.EmailSettingsImap of the updated resource.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-update_language"><strong>update_language</strong></a>(self, username, language, **kwargs)</dt><dd><tt>Update Google Mail language settings.<br>
+ <br>
+Args:<br>
+ username: string The name of the user.<br>
+ language: string The language tag for Google Mail's display language.<br>
+ kwargs: The other parameters to pass to the update method.<br>
+ <br>
+Returns:<br>
+ gdata.apps.emailsettings.data.EmailSettingsLanguage of the<br>
+ updated resource.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-update_pop"><strong>update_pop</strong></a>(self, username, enable, enable_for<font color="#909090">=None</font>, action<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Update Google Mail POP settings.<br>
+ <br>
+Args:<br>
+ username: string The name of the user.<br>
+ enable: Boolean Whether to enable incoming POP3 access.<br>
+ enable_for: string (optional) Whether to enable POP3 for all mail<br>
+ (POP_ENABLE_FOR_ALL_MAIL), or mail from now on<br>
+ (POP_ENABLE_FOR_MAIL_FROM_NOW_ON).<br>
+ action: string (optional) What Google Mail should do with its copy<br>
+ of the email after it is retrieved using POP (ACTION_KEEP,<br>
+ ACTION_ARCHIVE, ACTION_DELETE).<br>
+ kwargs: The other parameters to pass to the update method.<br>
+ <br>
+Returns:<br>
+ gdata.apps.emailsettings.data.EmailSettingsPop of the updated resource.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-update_signature"><strong>update_signature</strong></a>(self, username, signature, **kwargs)</dt><dd><tt>Update Google Mail signature.<br>
+ <br>
+Args:<br>
+ username: string The name of the user.<br>
+ signature: string The signature to be appended to outgoing messages.<br>
+ kwargs: The other parameters to pass to the update method.<br>
+ <br>
+Returns:<br>
+ gdata.apps.emailsettings.data.EmailSettingsSignature of the<br>
+ updated resource.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-update_vacation"><strong>update_vacation</strong></a>(self, username, enable, subject<font color="#909090">=None</font>, message<font color="#909090">=None</font>, start_date<font color="#909090">=None</font>, end_date<font color="#909090">=None</font>, contacts_only<font color="#909090">=None</font>, domain_only<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Update Google Mail vacation-responder settings.<br>
+ <br>
+Args:<br>
+ username: string The name of the user.<br>
+ enable: Boolean Whether to enable the vacation responder.<br>
+ subject: string (optional) The subject line of the vacation responder<br>
+ autoresponse.<br>
+ message: string (optional) The message body of the vacation responder<br>
+ autoresponse.<br>
+ startDate: string (optional) The start date of the vacation responder<br>
+ autoresponse.<br>
+ endDate: string (optional) The end date of the vacation responder<br>
+ autoresponse.<br>
+ contacts_only: Boolean (optional) Whether to only send autoresponses<br>
+ to known contacts.<br>
+ domain_only: Boolean (optional) Whether to only send autoresponses<br>
+ to users in the primary domain.<br>
+ kwargs: The other parameters to pass to the update method.<br>
+ <br>
+Returns:<br>
+ gdata.apps.emailsettings.data.EmailSettingsVacationResponder of the<br>
+ updated resource.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-update_webclip"><strong>update_webclip</strong></a>(self, username, enable, **kwargs)</dt><dd><tt>Enable/Disable Google Mail web clip.<br>
+ <br>
+Args:<br>
+ username: string The name of the user.<br>
+ enable: Boolean Whether to enable showing Web clips.<br>
+ kwargs: The other parameters to pass to the update method.<br>
+ <br>
+Returns:<br>
+ gdata.apps.emailsettings.data.EmailSettingsWebClip of the<br>
+ updated resource.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '2.0'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://apps-apis.google.com/a/feeds/user/', 'https://apps-apis.google.com/a/feeds/policies/', 'https://apps-apis.google.com/a/feeds/alias/', 'https://apps-apis.google.com/a/feeds/groups/', 'https://apps-apis.google.com/a/feeds/compliance/audit/', 'https://apps-apis.google.com/a/feeds/migration/', 'https://apps-apis.google.com/a/feeds/emailsettings/2.0/')</dl>
+
+<dl><dt><strong>auth_service</strong> = 'apps'</dl>
+
+<dl><dt><strong>host</strong> = 'apps-apis.google.com'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="EmailSettingsClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="EmailSettingsClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="EmailSettingsClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ACTION_ARCHIVE</strong> = 'ARCHIVE'<br>
+<strong>ACTION_DELETE</strong> = 'DELETE'<br>
+<strong>ACTION_KEEP</strong> = 'KEEP'<br>
+<strong>EMAIL_SETTINGS_URI_TEMPLATE</strong> = '/a/feeds/emailsettings/%s/%s/%s/%s'<br>
+<strong>POP_ENABLE_FOR_ALL_MAIL</strong> = 'ALL_MAIL'<br>
+<strong>POP_ENABLE_FOR_MAIL_FROM_NOW_ON</strong> = 'MAIL_FROM_NOW_ON'<br>
+<strong>SETTING_ID_DELEGATION</strong> = 'delegation'<br>
+<strong>SETTING_ID_FILTER</strong> = 'filter'<br>
+<strong>SETTING_ID_FORWARDING</strong> = 'forwarding'<br>
+<strong>SETTING_ID_GENERAL</strong> = 'general'<br>
+<strong>SETTING_ID_IMAP</strong> = 'imap'<br>
+<strong>SETTING_ID_LABEL</strong> = 'label'<br>
+<strong>SETTING_ID_LANGUAGE</strong> = 'language'<br>
+<strong>SETTING_ID_POP</strong> = 'pop'<br>
+<strong>SETTING_ID_SENDAS</strong> = 'sendas'<br>
+<strong>SETTING_ID_SIGNATURE</strong> = 'signature'<br>
+<strong>SETTING_ID_VACATION_RESPONDER</strong> = 'vacation'<br>
+<strong>SETTING_ID_WEBCLIP</strong> = 'webclip'<br>
+<strong>__author__</strong> = 'Claudio Cherubino <ccherubino@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Claudio Cherubino <ccherubino@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.emailsettings.data.html b/pydocs/gdata.apps.emailsettings.data.html
new file mode 100644
index 0000000..fdf2d39
--- /dev/null
+++ b/pydocs/gdata.apps.emailsettings.data.html
@@ -0,0 +1,6229 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.emailsettings.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.emailsettings.html"><font color="#ffffff">emailsettings</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/emailsettings/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/emailsettings/data.py</a></font></td></tr></table>
+ <p><tt>Data model classes for the Email Settings API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsDelegation">EmailSettingsDelegation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsFilter">EmailSettingsFilter</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsForwarding">EmailSettingsForwarding</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsGeneral">EmailSettingsGeneral</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsImap">EmailSettingsImap</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsLabel">EmailSettingsLabel</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsLanguage">EmailSettingsLanguage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsPop">EmailSettingsPop</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsSendAsAlias">EmailSettingsSendAsAlias</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsSignature">EmailSettingsSignature</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsVacationResponder">EmailSettingsVacationResponder</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsWebClip">EmailSettingsWebClip</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsDelegationFeed">EmailSettingsDelegationFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsLabelFeed">EmailSettingsLabelFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.data.html#EmailSettingsSendAsAliasFeed">EmailSettingsSendAsAliasFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsDelegation">class <strong>EmailSettingsDelegation</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an Email Settings delegation entry in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsDelegation">EmailSettingsDelegation</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsDelegation-GetAddress"><strong>GetAddress</strong></a>(self)</dt><dd><tt>Get the email address of the delegated user.<br>
+ <br>
+Returns:<br>
+ The email address of the delegated user as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-SetAddress"><strong>SetAddress</strong></a>(self, value)</dt><dd><tt>Set the email address of the delegated user.<br>
+ <br>
+Args:<br>
+ value: string The email address of another user on the same domain</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, address<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#EmailSettingsDelegation">EmailSettingsDelegation</a> object with the given<br>
+ arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of this object for HTTP requests.<br>
+ address: string The email address of the delegated user.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>address</strong></dt>
+<dd><tt>Get the email address of the delegated user.<br>
+ <br>
+Returns:<br>
+ The email address of the delegated user as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsDelegation-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsDelegation-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsDelegation-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsDelegation-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsDelegation-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegation-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsDelegationFeed">class <strong>EmailSettingsDelegationFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Main feed containing a list of email delegation entries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsDelegationFeed">EmailSettingsDelegationFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.apps.emailsettings.data.EmailSettingsDelegation'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="EmailSettingsDelegationFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="EmailSettingsDelegationFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsDelegationFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsDelegationFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsDelegationFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsDelegationFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsEntry">class <strong>EmailSettingsEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an Email Settings entry in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="EmailSettingsEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsFilter">class <strong>EmailSettingsFilter</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an Email Settings Filter in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsFilter">EmailSettingsFilter</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsFilter-GetArchive"><strong>GetArchive</strong></a>(self)</dt><dd><tt>Get the Archive value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The Archive value of this Filter object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetDoesNotHaveTheWord"><strong>GetDoesNotHaveTheWord</strong></a>(self)</dt><dd><tt>Get the DoesNotHaveTheWord value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The DoesNotHaveTheWord value of this Filter object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetFrom"><strong>GetFrom</strong></a>(self)</dt><dd><tt>Get the From value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The From value of this Filter object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetHasAttachments"><strong>GetHasAttachments</strong></a>(self)</dt><dd><tt>Get the HasAttachments value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The HasAttachments value of this Filter object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetHasTheWord"><strong>GetHasTheWord</strong></a>(self)</dt><dd><tt>Get the HasTheWord value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The HasTheWord value of this Filter object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetLabel"><strong>GetLabel</strong></a>(self)</dt><dd><tt>Get the Label value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The Label value of this Filter object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetMarkAsRead"><strong>GetMarkAsRead</strong></a>(self)</dt><dd><tt>Get the MarkAsRead value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The MarkAsRead value of this Filter object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetSubject"><strong>GetSubject</strong></a>(self)</dt><dd><tt>Get the Subject value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The Subject value of this Filter object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetTo"><strong>GetTo</strong></a>(self)</dt><dd><tt>Get the To value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The To value of this Filter object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-SetArchive"><strong>SetArchive</strong></a>(self, value)</dt><dd><tt>Set the Archive value of this Filter object.<br>
+ <br>
+Args:<br>
+ value: string The new Archive value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-SetDoesNotHaveTheWord"><strong>SetDoesNotHaveTheWord</strong></a>(self, value)</dt><dd><tt>Set the DoesNotHaveTheWord value of this Filter object.<br>
+ <br>
+Args:<br>
+ value: string The new DoesNotHaveTheWord value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-SetFrom"><strong>SetFrom</strong></a>(self, value)</dt><dd><tt>Set the From value of this Filter object.<br>
+ <br>
+Args:<br>
+ value: string The new From value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-SetHasAttachments"><strong>SetHasAttachments</strong></a>(self, value)</dt><dd><tt>Set the HasAttachments value of this Filter object.<br>
+ <br>
+Args:<br>
+ value: string The new HasAttachments value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-SetHasTheWord"><strong>SetHasTheWord</strong></a>(self, value)</dt><dd><tt>Set the HasTheWord value of this Filter object.<br>
+ <br>
+Args:<br>
+ value: string The new HasTheWord value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-SetLabel"><strong>SetLabel</strong></a>(self, value)</dt><dd><tt>Set the Label value of this Filter object.<br>
+ <br>
+Args:<br>
+ value: string The new Label value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-SetMarkAsRead"><strong>SetMarkAsRead</strong></a>(self, value)</dt><dd><tt>Set the MarkAsRead value of this Filter object.<br>
+ <br>
+Args:<br>
+ value: string The new MarkAsRead value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-SetSubject"><strong>SetSubject</strong></a>(self, value)</dt><dd><tt>Set the Subject value of this Filter object.<br>
+ <br>
+Args:<br>
+ value: string The new Subject value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-SetTo"><strong>SetTo</strong></a>(self, value)</dt><dd><tt>Set the To value of this Filter object.<br>
+ <br>
+Args:<br>
+ value: string The new To value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, from_address<font color="#909090">=None</font>, to_address<font color="#909090">=None</font>, subject<font color="#909090">=None</font>, has_the_word<font color="#909090">=None</font>, does_not_have_the_word<font color="#909090">=None</font>, has_attachments<font color="#909090">=None</font>, label<font color="#909090">=None</font>, mark_as_read<font color="#909090">=None</font>, archive<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#EmailSettingsFilter">EmailSettingsFilter</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of this object for HTTP requests.<br>
+ from_address: string (optional) The source email address for the filter.<br>
+ to_address: string (optional) The destination email address for<br>
+ the filter.<br>
+ subject: string (optional) The value the email must have in its<br>
+ subject to be filtered.<br>
+ has_the_word: string (optional) The value the email must have in its<br>
+ subject or body to be filtered.<br>
+ does_not_have_the_word: string (optional) The value the email cannot<br>
+ have in its subject or body to be filtered.<br>
+ has_attachments: Boolean (optional) Whether or not the email must<br>
+ have an attachment to be filtered.<br>
+ label: string (optional) The name of the label to apply to<br>
+ messages matching the filter criteria.<br>
+ mark_as_read: Boolean (optional) Whether or not to mark messages<br>
+ matching the filter criteria as read.<br>
+ archive: Boolean (optional) Whether or not to move messages<br>
+ matching to Archived state.<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>archive</strong></dt>
+<dd><tt>Get the Archive value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The Archive value of this Filter object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>does_not_have_the_word</strong></dt>
+<dd><tt>Get the DoesNotHaveTheWord value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The DoesNotHaveTheWord value of this Filter object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>from_address</strong></dt>
+<dd><tt>Get the From value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The From value of this Filter object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>has_attachments</strong></dt>
+<dd><tt>Get the HasAttachments value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The HasAttachments value of this Filter object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>has_the_word</strong></dt>
+<dd><tt>Get the HasTheWord value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The HasTheWord value of this Filter object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>label</strong></dt>
+<dd><tt>Get the Label value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The Label value of this Filter object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>mark_as_read</strong></dt>
+<dd><tt>Get the MarkAsRead value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The MarkAsRead value of this Filter object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>subject</strong></dt>
+<dd><tt>Get the Subject value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The Subject value of this Filter object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>to_address</strong></dt>
+<dd><tt>Get the To value of the Filter object.<br>
+ <br>
+Returns:<br>
+ The To value of this Filter object as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsFilter-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsFilter-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsFilter-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsFilter-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsFilter-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsFilter-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsForwarding">class <strong>EmailSettingsForwarding</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents Forwarding settings in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsForwarding">EmailSettingsForwarding</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsForwarding-GetAction"><strong>GetAction</strong></a>(self)</dt><dd><tt>Get the Action value of the Forwarding object.<br>
+ <br>
+Returns:<br>
+ The Action value of this Forwarding object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetEnable"><strong>GetEnable</strong></a>(self)</dt><dd><tt>Get the Enable value of the Forwarding object.<br>
+ <br>
+Returns:<br>
+ The Enable value of this Forwarding object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetForwardTo"><strong>GetForwardTo</strong></a>(self)</dt><dd><tt>Get the ForwardTo value of the Forwarding object.<br>
+ <br>
+Returns:<br>
+ The ForwardTo value of this Forwarding object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-SetAction"><strong>SetAction</strong></a>(self, value)</dt><dd><tt>Set the Action value of this Forwarding object.<br>
+ <br>
+Args:<br>
+ value: string The new Action value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-SetEnable"><strong>SetEnable</strong></a>(self, value)</dt><dd><tt>Set the Enable value of this Forwarding object.<br>
+ <br>
+Args:<br>
+ value: string The new Enable value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-SetForwardTo"><strong>SetForwardTo</strong></a>(self, value)</dt><dd><tt>Set the ForwardTo value of this Forwarding object.<br>
+ <br>
+Args:<br>
+ value: string The new ForwardTo value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, enable<font color="#909090">=None</font>, forward_to<font color="#909090">=None</font>, action<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#EmailSettingsForwarding">EmailSettingsForwarding</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of this object for HTTP requests.<br>
+ enable: Boolean (optional) Whether to enable incoming email forwarding.<br>
+ forward_to: string (optional) The address email will be forwarded to.<br>
+ action: string (optional) The action to perform after forwarding an<br>
+ email ("KEEP", "ARCHIVE", "DELETE").<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>action</strong></dt>
+<dd><tt>Get the Action value of the Forwarding object.<br>
+ <br>
+Returns:<br>
+ The Action value of this Forwarding object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>enable</strong></dt>
+<dd><tt>Get the Enable value of the Forwarding object.<br>
+ <br>
+Returns:<br>
+ The Enable value of this Forwarding object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>forward_to</strong></dt>
+<dd><tt>Get the ForwardTo value of the Forwarding object.<br>
+ <br>
+Returns:<br>
+ The ForwardTo value of this Forwarding object as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsForwarding-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsForwarding-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsForwarding-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsForwarding-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsForwarding-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsForwarding-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsGeneral">class <strong>EmailSettingsGeneral</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents General Settings in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsGeneral">EmailSettingsGeneral</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsGeneral-GetArrows"><strong>GetArrows</strong></a>(self)</dt><dd><tt>Get the Arrows value of the General Settings object.<br>
+ <br>
+Returns:<br>
+ The Arrows value of this General Settings object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetPageSize"><strong>GetPageSize</strong></a>(self)</dt><dd><tt>Get the Page Size value of the General Settings object.<br>
+ <br>
+Returns:<br>
+ The Page Size value of this General Settings object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetShortcuts"><strong>GetShortcuts</strong></a>(self)</dt><dd><tt>Get the Shortcuts value of the General Settings object.<br>
+ <br>
+Returns:<br>
+ The Shortcuts value of this General Settings object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetSnippets"><strong>GetSnippets</strong></a>(self)</dt><dd><tt>Get the Snippets value of the General Settings object.<br>
+ <br>
+Returns:<br>
+ The Snippets value of this General Settings object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetUnicode"><strong>GetUnicode</strong></a>(self)</dt><dd><tt>Get the Unicode value of the General Settings object.<br>
+ <br>
+Returns:<br>
+ The Unicode value of this General Settings object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-SetArrows"><strong>SetArrows</strong></a>(self, value)</dt><dd><tt>Set the Arrows value of this General Settings object.<br>
+ <br>
+Args:<br>
+ value: string The new Arrows value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-SetPageSize"><strong>SetPageSize</strong></a>(self, value)</dt><dd><tt>Set the Page Size value of this General Settings object.<br>
+ <br>
+Args:<br>
+ value: string The new Page Size value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-SetShortcuts"><strong>SetShortcuts</strong></a>(self, value)</dt><dd><tt>Set the Shortcuts value of this General Settings object.<br>
+ <br>
+Args:<br>
+ value: string The new Shortcuts value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-SetSnippets"><strong>SetSnippets</strong></a>(self, value)</dt><dd><tt>Set the Snippets value of this General Settings object.<br>
+ <br>
+Args:<br>
+ value: string The new Snippets value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-SetUnicode"><strong>SetUnicode</strong></a>(self, value)</dt><dd><tt>Set the Unicode value of this General Settings object.<br>
+ <br>
+Args:<br>
+ value: string The new Unicode value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, page_size<font color="#909090">=None</font>, shortcuts<font color="#909090">=None</font>, arrows<font color="#909090">=None</font>, snippets<font color="#909090">=None</font>, use_unicode<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#EmailSettingsGeneral">EmailSettingsGeneral</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of this object for HTTP requests.<br>
+ page_size: int (optional) The number of conversations to be shown per page.<br>
+ shortcuts: Boolean (optional) Whether to enable keyboard shortcuts.<br>
+ arrows: Boolean (optional) Whether to display arrow-shaped personal<br>
+ indicators next to email sent specifically to the user.<br>
+ snippets: Boolean (optional) Whether to display snippets of the messages<br>
+ in the inbox and when searching.<br>
+ use_unicode: Boolean (optional) Whether to use UTF-8 (unicode) encoding<br>
+ for all outgoing messages.<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>arrows</strong></dt>
+<dd><tt>Get the Arrows value of the General Settings object.<br>
+ <br>
+Returns:<br>
+ The Arrows value of this General Settings object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>page_size</strong></dt>
+<dd><tt>Get the Page Size value of the General Settings object.<br>
+ <br>
+Returns:<br>
+ The Page Size value of this General Settings object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>shortcuts</strong></dt>
+<dd><tt>Get the Shortcuts value of the General Settings object.<br>
+ <br>
+Returns:<br>
+ The Shortcuts value of this General Settings object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>snippets</strong></dt>
+<dd><tt>Get the Snippets value of the General Settings object.<br>
+ <br>
+Returns:<br>
+ The Snippets value of this General Settings object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>use_unicode</strong></dt>
+<dd><tt>Get the Unicode value of the General Settings object.<br>
+ <br>
+Returns:<br>
+ The Unicode value of this General Settings object as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsGeneral-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsGeneral-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsGeneral-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsGeneral-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsGeneral-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsGeneral-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsImap">class <strong>EmailSettingsImap</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents IMAP settings in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsImap">EmailSettingsImap</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsImap-GetEnable"><strong>GetEnable</strong></a>(self)</dt><dd><tt>Get the Enable value of the IMAP object.<br>
+ <br>
+Returns:<br>
+ The Enable value of this IMAP object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-SetEnable"><strong>SetEnable</strong></a>(self, value)</dt><dd><tt>Set the Enable value of this IMAP object.<br>
+ <br>
+Args:<br>
+ value: string The new Enable value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, enable<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#EmailSettingsImap">EmailSettingsImap</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of this object for HTTP requests.<br>
+ enable: Boolean (optional) Whether to enable IMAP access.<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>enable</strong></dt>
+<dd><tt>Get the Enable value of the IMAP object.<br>
+ <br>
+Returns:<br>
+ The Enable value of this IMAP object as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsImap-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsImap-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsImap-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsImap-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsImap-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsImap-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsLabel">class <strong>EmailSettingsLabel</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a Label in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsLabel">EmailSettingsLabel</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsLabel-GetName"><strong>GetName</strong></a>(self)</dt><dd><tt>Get the name of the Label object.<br>
+ <br>
+Returns:<br>
+ The name of this Label object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-SetName"><strong>SetName</strong></a>(self, value)</dt><dd><tt>Set the name of this Label object.<br>
+ <br>
+Args:<br>
+ value: string The new label name to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, name<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#EmailSettingsLabel">EmailSettingsLabel</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of this object for HTTP requests.<br>
+ name: string (optional) The name to give this new object.<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>name</strong></dt>
+<dd><tt>Get the name of the Label object.<br>
+ <br>
+Returns:<br>
+ The name of this Label object as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsLabel-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsLabel-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsLabel-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsLabel-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsLabel-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabel-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsLabelFeed">class <strong>EmailSettingsLabelFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Main feed containing a list of labels.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsLabelFeed">EmailSettingsLabelFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.apps.emailsettings.data.EmailSettingsLabel'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="EmailSettingsLabelFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="EmailSettingsLabelFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsLabelFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsLabelFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsLabelFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLabelFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsLanguage">class <strong>EmailSettingsLanguage</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents Language Settings in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsLanguage">EmailSettingsLanguage</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsLanguage-GetLanguage"><strong>GetLanguage</strong></a>(self)</dt><dd><tt>Get the tag of the Language object.<br>
+ <br>
+Returns:<br>
+ The tag of this Language object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-SetLanguage"><strong>SetLanguage</strong></a>(self, value)</dt><dd><tt>Set the tag of this Language object.<br>
+ <br>
+Args:<br>
+ value: string The new tag value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, language<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#EmailSettingsLanguage">EmailSettingsLanguage</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of this object for HTTP requests.<br>
+ language: string (optional) The language tag for Google Mail's display<br>
+ language.<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>language_tag</strong></dt>
+<dd><tt>Get the tag of the Language object.<br>
+ <br>
+Returns:<br>
+ The tag of this Language object as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsLanguage-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsLanguage-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsLanguage-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsLanguage-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsLanguage-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsLanguage-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsPop">class <strong>EmailSettingsPop</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents POP settings in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsPop">EmailSettingsPop</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsPop-GetEnable"><strong>GetEnable</strong></a>(self)</dt><dd><tt>Get the Enable value of the POP object.<br>
+ <br>
+Returns:<br>
+ The Enable value of this POP object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetEnableFor"><strong>GetEnableFor</strong></a>(self)</dt><dd><tt>Get the EnableFor value of the POP object.<br>
+ <br>
+Returns:<br>
+ The EnableFor value of this POP object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetPopAction"><strong>GetPopAction</strong></a>(self)</dt><dd><tt>Get the Action value of the POP object.<br>
+ <br>
+Returns:<br>
+ The Action value of this POP object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-SetEnable"><strong>SetEnable</strong></a>(self, value)</dt><dd><tt>Set the Enable value of this POP object.<br>
+ <br>
+Args:<br>
+ value: string The new Enable value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-SetEnableFor"><strong>SetEnableFor</strong></a>(self, value)</dt><dd><tt>Set the EnableFor value of this POP object.<br>
+ <br>
+Args:<br>
+ value: string The new EnableFor value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-SetPopAction"><strong>SetPopAction</strong></a>(self, value)</dt><dd><tt>Set the Action value of this POP object.<br>
+ <br>
+Args:<br>
+ value: string The new Action value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, enable<font color="#909090">=None</font>, enable_for<font color="#909090">=None</font>, action<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new EmailSettingsPOP object with the given arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of this object for HTTP requests.<br>
+ enable: Boolean (optional) Whether to enable incoming POP3 access.<br>
+ enable_for: string (optional) Whether to enable POP3 for all mail<br>
+ ("ALL_MAIL"), or mail from now on ("MAIL_FROM_NOW_ON").<br>
+ action: string (optional) What Google Mail should do with its copy<br>
+ of the email after it is retrieved using POP<br>
+ ("KEEP", "ARCHIVE", or "DELETE").<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>action</strong></dt>
+<dd><tt>Get the Action value of the POP object.<br>
+ <br>
+Returns:<br>
+ The Action value of this POP object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>enable</strong></dt>
+<dd><tt>Get the Enable value of the POP object.<br>
+ <br>
+Returns:<br>
+ The Enable value of this POP object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>enable_for</strong></dt>
+<dd><tt>Get the EnableFor value of the POP object.<br>
+ <br>
+Returns:<br>
+ The EnableFor value of this POP object as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsPop-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsPop-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsPop-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsPop-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsPop-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsPop-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsSendAsAlias">class <strong>EmailSettingsSendAsAlias</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an Email Settings send-as Alias in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsSendAsAlias">EmailSettingsSendAsAlias</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsSendAsAlias-GetAddress"><strong>GetAddress</strong></a>(self)</dt><dd><tt>Get the Address of the send-as Alias object.<br>
+ <br>
+Returns:<br>
+ The Address of this send-as Alias object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetMakeDefault"><strong>GetMakeDefault</strong></a>(self)</dt><dd><tt>Get the MakeDefault value of the send-as Alias object.<br>
+ <br>
+Returns:<br>
+ The MakeDefault value of this send-as Alias object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetName"><strong>GetName</strong></a>(self)</dt><dd><tt>Get the Name of the send-as Alias object.<br>
+ <br>
+Returns:<br>
+ The Name of this send-as Alias object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetReplyTo"><strong>GetReplyTo</strong></a>(self)</dt><dd><tt>Get the ReplyTo address of the send-as Alias object.<br>
+ <br>
+Returns:<br>
+ The ReplyTo address of this send-as Alias object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-SetAddress"><strong>SetAddress</strong></a>(self, value)</dt><dd><tt>Set the Address of this send-as Alias object.<br>
+ <br>
+Args:<br>
+ value: string The new Address to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-SetMakeDefault"><strong>SetMakeDefault</strong></a>(self, value)</dt><dd><tt>Set the MakeDefault value of this send-as Alias object.<br>
+ <br>
+Args:<br>
+ value: string The new MakeDefault value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-SetName"><strong>SetName</strong></a>(self, value)</dt><dd><tt>Set the Name of this send-as Alias object.<br>
+ <br>
+Args:<br>
+ value: string The new Name to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-SetReplyTo"><strong>SetReplyTo</strong></a>(self, value)</dt><dd><tt>Set the ReplyTo address of this send-as Alias object.<br>
+ <br>
+Args:<br>
+ value: string The new ReplyTo address to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, name<font color="#909090">=None</font>, address<font color="#909090">=None</font>, reply_to<font color="#909090">=None</font>, make_default<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#EmailSettingsSendAsAlias">EmailSettingsSendAsAlias</a> object with the given<br>
+ arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri f this object for HTTP requests.<br>
+ name: string (optional) The name that will appear in the "From" field<br>
+ for this user.<br>
+ address: string (optional) The email address that appears as the<br>
+ origination address for emails sent by this user.<br>
+ reply_to: string (optional) The address to be used as the reply-to<br>
+ address in email sent using the alias.<br>
+ make_default: Boolean (optional) Whether or not this alias should<br>
+ become the default alias for this user.<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>address</strong></dt>
+<dd><tt>Get the Address of the send-as Alias object.<br>
+ <br>
+Returns:<br>
+ The Address of this send-as Alias object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>make_default</strong></dt>
+<dd><tt>Get the MakeDefault value of the send-as Alias object.<br>
+ <br>
+Returns:<br>
+ The MakeDefault value of this send-as Alias object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>name</strong></dt>
+<dd><tt>Get the Name of the send-as Alias object.<br>
+ <br>
+Returns:<br>
+ The Name of this send-as Alias object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>reply_to</strong></dt>
+<dd><tt>Get the ReplyTo address of the send-as Alias object.<br>
+ <br>
+Returns:<br>
+ The ReplyTo address of this send-as Alias object as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsSendAsAlias-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsSendAsAlias-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsSendAsAlias-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsSendAsAlias-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsSendAsAlias-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAlias-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsSendAsAliasFeed">class <strong>EmailSettingsSendAsAliasFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Main feed containing a list of send-as aliases.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsSendAsAliasFeed">EmailSettingsSendAsAliasFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.apps.emailsettings.data.EmailSettingsSendAsAlias'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSendAsAliasFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsSignature">class <strong>EmailSettingsSignature</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a Signature in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsSignature">EmailSettingsSignature</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsSignature-GetValue"><strong>GetValue</strong></a>(self)</dt><dd><tt>Get the value of the Signature object.<br>
+ <br>
+Returns:<br>
+ The value of this Signature object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-SetValue"><strong>SetValue</strong></a>(self, value)</dt><dd><tt>Set the name of this Signature object.<br>
+ <br>
+Args:<br>
+ value: string The new signature value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, signature<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#EmailSettingsSignature">EmailSettingsSignature</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of this object for HTTP requests.<br>
+ signature: string (optional) The signature to be appended to outgoing<br>
+ messages.<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>signature_value</strong></dt>
+<dd><tt>Get the value of the Signature object.<br>
+ <br>
+Returns:<br>
+ The value of this Signature object as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsSignature-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsSignature-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsSignature-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsSignature-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsSignature-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsSignature-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsVacationResponder">class <strong>EmailSettingsVacationResponder</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents Vacation Responder settings in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsVacationResponder">EmailSettingsVacationResponder</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsVacationResponder-GetContactsOnly"><strong>GetContactsOnly</strong></a>(self)</dt><dd><tt>Get the ContactsOnly value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The ContactsOnly value of this Vacation Responder object as a<br>
+ string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetDomainOnly"><strong>GetDomainOnly</strong></a>(self)</dt><dd><tt>Get the DomainOnly value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The DomainOnly value of this Vacation Responder object as a<br>
+ string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetEnable"><strong>GetEnable</strong></a>(self)</dt><dd><tt>Get the Enable value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The Enable value of this Vacation Responder object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetEndDate"><strong>GetEndDate</strong></a>(self)</dt><dd><tt>Get the EndDate value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The EndDate value of this Vacation Responder object as a<br>
+ string(YYYY-MM-DD) or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetMessage"><strong>GetMessage</strong></a>(self)</dt><dd><tt>Get the Message value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The Message value of this Vacation Responder object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetStartDate"><strong>GetStartDate</strong></a>(self)</dt><dd><tt>Get the StartDate value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The StartDate value of this Vacation Responder object as a<br>
+ string(YYYY-MM-DD) or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetSubject"><strong>GetSubject</strong></a>(self)</dt><dd><tt>Get the Subject value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The Subject value of this Vacation Responder object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-SetContactsOnly"><strong>SetContactsOnly</strong></a>(self, value)</dt><dd><tt>Set the ContactsOnly value of this Vacation Responder object.<br>
+ <br>
+Args:<br>
+ value: string The new ContactsOnly value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-SetDomainOnly"><strong>SetDomainOnly</strong></a>(self, value)</dt><dd><tt>Set the DomainOnly value of this Vacation Responder object.<br>
+ <br>
+Args:<br>
+ value: string The new DomainOnly value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-SetEnable"><strong>SetEnable</strong></a>(self, value)</dt><dd><tt>Set the Enable value of this Vacation Responder object.<br>
+ <br>
+Args:<br>
+ value: string The new Enable value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-SetEndDate"><strong>SetEndDate</strong></a>(self, value)</dt><dd><tt>Set the EndDate value of this Vacation Responder object.<br>
+ <br>
+Args:<br>
+ value: string The new EndDate value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-SetMessage"><strong>SetMessage</strong></a>(self, value)</dt><dd><tt>Set the Message value of this Vacation Responder object.<br>
+ <br>
+Args:<br>
+ value: string The new Message value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-SetStartDate"><strong>SetStartDate</strong></a>(self, value)</dt><dd><tt>Set the StartDate value of this Vacation Responder object.<br>
+ <br>
+Args:<br>
+ value: string The new StartDate value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-SetSubject"><strong>SetSubject</strong></a>(self, value)</dt><dd><tt>Set the Subject value of this Vacation Responder object.<br>
+ <br>
+Args:<br>
+ value: string The new Subject value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, enable<font color="#909090">=None</font>, subject<font color="#909090">=None</font>, message<font color="#909090">=None</font>, start_date<font color="#909090">=None</font>, end_date<font color="#909090">=None</font>, contacts_only<font color="#909090">=None</font>, domain_only<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#EmailSettingsVacationResponder">EmailSettingsVacationResponder</a> object with the<br>
+ given arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of this object for HTTP requests.<br>
+ enable: Boolean (optional) Whether to enable the vacation responder.<br>
+ subject: string (optional) The subject line of the vacation responder<br>
+ autoresponse.<br>
+ message: string (optional) The message body of the vacation responder<br>
+ autoresponse.<br>
+ start_date: string (optional) The start date of the vacation responder<br>
+ autoresponse<br>
+ end_date: string (optional) The end date of the vacation responder<br>
+ autoresponse<br>
+ contacts_only: Boolean (optional) Whether to only send autoresponses<br>
+ to known contacts.<br>
+ domain_only: Boolean (optional) Whether to only send autoresponses<br>
+ to users in the same primary domain .<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>contacts_only</strong></dt>
+<dd><tt>Get the ContactsOnly value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The ContactsOnly value of this Vacation Responder object as a<br>
+ string or None.</tt></dd>
+</dl>
+<dl><dt><strong>domain_only</strong></dt>
+<dd><tt>Get the DomainOnly value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The DomainOnly value of this Vacation Responder object as a<br>
+ string or None.</tt></dd>
+</dl>
+<dl><dt><strong>enable</strong></dt>
+<dd><tt>Get the Enable value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The Enable value of this Vacation Responder object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>end_date</strong></dt>
+<dd><tt>Get the EndDate value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The EndDate value of this Vacation Responder object as a<br>
+ string(YYYY-MM-DD) or None.</tt></dd>
+</dl>
+<dl><dt><strong>message</strong></dt>
+<dd><tt>Get the Message value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The Message value of this Vacation Responder object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>start_date</strong></dt>
+<dd><tt>Get the StartDate value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The StartDate value of this Vacation Responder object as a<br>
+ string(YYYY-MM-DD) or None.</tt></dd>
+</dl>
+<dl><dt><strong>subject</strong></dt>
+<dd><tt>Get the Subject value of the Vacation Responder object.<br>
+ <br>
+Returns:<br>
+ The Subject value of this Vacation Responder object as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsVacationResponder-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsVacationResponder-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsVacationResponder-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsVacationResponder-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsVacationResponder-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsVacationResponder-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsWebClip">class <strong>EmailSettingsWebClip</strong></a>(<a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a WebClip in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsWebClip">EmailSettingsWebClip</a></dd>
+<dd><a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsWebClip-GetEnable"><strong>GetEnable</strong></a>(self)</dt><dd><tt>Get the Enable value of the WebClip object.<br>
+ <br>
+Returns:<br>
+ The Enable value of this WebClip object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-SetEnable"><strong>SetEnable</strong></a>(self, value)</dt><dd><tt>Set the Enable value of this WebClip object.<br>
+ <br>
+Args:<br>
+ value: string The new Enable value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, enable<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#EmailSettingsWebClip">EmailSettingsWebClip</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of this object for HTTP requests.<br>
+ enable: Boolean (optional) Whether to enable showing Web clips.<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>enable</strong></dt>
+<dd><tt>Get the Enable value of the WebClip object.<br>
+ <br>
+Returns:<br>
+ The Enable value of this WebClip object as a string or None.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><a name="EmailSettingsWebClip-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.emailsettings.data.html#EmailSettingsEntry">EmailSettingsEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="EmailSettingsWebClip-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailSettingsWebClip-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsWebClip-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="EmailSettingsWebClip-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsWebClip-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DELEGATION_ADDRESS</strong> = 'address'<br>
+<strong>DELEGATION_DELEGATE</strong> = 'delegate'<br>
+<strong>DELEGATION_ID</strong> = 'delegationId'<br>
+<strong>DELEGATION_STATUS</strong> = 'status'<br>
+<strong>FILTER_ARCHIVE</strong> = 'shouldArchive'<br>
+<strong>FILTER_DOES_NOT_HAVE_THE_WORD_NAME</strong> = 'doesNotHaveTheWord'<br>
+<strong>FILTER_FROM_NAME</strong> = 'from'<br>
+<strong>FILTER_HAS_ATTACHMENTS_NAME</strong> = 'hasAttachment'<br>
+<strong>FILTER_HAS_THE_WORD_NAME</strong> = 'hasTheWord'<br>
+<strong>FILTER_LABEL</strong> = 'label'<br>
+<strong>FILTER_MARK_AS_READ</strong> = 'shouldMarkAsRead'<br>
+<strong>FILTER_SUBJECT_NAME</strong> = 'subject'<br>
+<strong>FILTER_TO_NAME</strong> = 'to'<br>
+<strong>FORWARDING_ACTION</strong> = 'action'<br>
+<strong>FORWARDING_ENABLE</strong> = 'enable'<br>
+<strong>FORWARDING_TO</strong> = 'forwardTo'<br>
+<strong>GENERAL_ARROWS</strong> = 'arrows'<br>
+<strong>GENERAL_PAGE_SIZE</strong> = 'pageSize'<br>
+<strong>GENERAL_SHORTCUTS</strong> = 'shortcuts'<br>
+<strong>GENERAL_SNIPPETS</strong> = 'snippets'<br>
+<strong>GENERAL_UNICODE</strong> = 'unicode'<br>
+<strong>IMAP_ENABLE</strong> = 'enable'<br>
+<strong>LABEL_NAME</strong> = 'label'<br>
+<strong>LANGUAGE_TAG</strong> = 'language'<br>
+<strong>POP_ACTION</strong> = 'action'<br>
+<strong>POP_ENABLE</strong> = 'enable'<br>
+<strong>POP_ENABLE_FOR</strong> = 'enableFor'<br>
+<strong>SENDAS_ALIAS_ADDRESS</strong> = 'address'<br>
+<strong>SENDAS_ALIAS_MAKE_DEFAULT</strong> = 'makeDefault'<br>
+<strong>SENDAS_ALIAS_NAME</strong> = 'name'<br>
+<strong>SENDAS_ALIAS_REPLY_TO</strong> = 'replyTo'<br>
+<strong>SIGNATURE_VALUE</strong> = 'signature'<br>
+<strong>VACATION_RESPONDER_CONTACTS_ONLY</strong> = 'contactsOnly'<br>
+<strong>VACATION_RESPONDER_DOMAIN_ONLY</strong> = 'domainOnly'<br>
+<strong>VACATION_RESPONDER_ENABLE</strong> = 'enable'<br>
+<strong>VACATION_RESPONDER_ENDDATE</strong> = 'endDate'<br>
+<strong>VACATION_RESPONDER_MESSAGE</strong> = 'message'<br>
+<strong>VACATION_RESPONDER_STARTDATE</strong> = 'startDate'<br>
+<strong>VACATION_RESPONDER_SUBJECT</strong> = 'subject'<br>
+<strong>WEBCLIP_ENABLE</strong> = 'enable'<br>
+<strong>__author__</strong> = 'Claudio Cherubino <ccherubino@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Claudio Cherubino <ccherubino@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.emailsettings.html b/pydocs/gdata.apps.emailsettings.html
new file mode 100644
index 0000000..99ea3a2
--- /dev/null
+++ b/pydocs/gdata.apps.emailsettings.html
@@ -0,0 +1,36 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.apps.emailsettings</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.emailsettings</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/emailsettings/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/emailsettings/__init__.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2008 Google<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.apps.emailsettings.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.apps.emailsettings.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.apps.emailsettings.service.html">service</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.emailsettings.service.html b/pydocs/gdata.apps.emailsettings.service.html
new file mode 100644
index 0000000..33a53b5
--- /dev/null
+++ b/pydocs/gdata.apps.emailsettings.service.html
@@ -0,0 +1,764 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.emailsettings.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.emailsettings.html"><font color="#ffffff">emailsettings</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/emailsettings/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/emailsettings/service.py</a></font></td></tr></table>
+ <p><tt>Allow Google Apps domain administrators to set users' email settings.<br>
+ <br>
+<a href="#EmailSettingsService">EmailSettingsService</a>: Set various email settings.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.emailsettings.service.html#EmailSettingsService">EmailSettingsService</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailSettingsService">class <strong>EmailSettingsService</strong></a>(<a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Apps Email Settings service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.emailsettings.service.html#EmailSettingsService">EmailSettingsService</a></dd>
+<dd><a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailSettingsService-CreateFilter"><strong>CreateFilter</strong></a>(self, username, from_<font color="#909090">=None</font>, to<font color="#909090">=None</font>, subject<font color="#909090">=None</font>, has_the_word<font color="#909090">=None</font>, does_not_have_the_word<font color="#909090">=None</font>, has_attachment<font color="#909090">=None</font>, label<font color="#909090">=None</font>, should_mark_as_read<font color="#909090">=None</font>, should_archive<font color="#909090">=None</font>)</dt><dd><tt>Create a filter.<br>
+ <br>
+Args:<br>
+ username: User to create filter for.<br>
+ from_: Filter from string.<br>
+ to: Filter to string.<br>
+ subject: Filter subject.<br>
+ has_the_word: Words to filter in.<br>
+ does_not_have_the_word: Words to filter out.<br>
+ has_attachment: Boolean for message having attachment.<br>
+ label: Label to apply.<br>
+ should_mark_as_read: Boolean for marking message as read.<br>
+ should_archive: Boolean for archiving message.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the create operation.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-CreateLabel"><strong>CreateLabel</strong></a>(self, username, label)</dt><dd><tt>Create a label.<br>
+ <br>
+Args:<br>
+ username: User to create label for.<br>
+ label: Label to create.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the create operation.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-CreateSendAsAlias"><strong>CreateSendAsAlias</strong></a>(self, username, name, address, reply_to<font color="#909090">=None</font>, make_default<font color="#909090">=None</font>)</dt><dd><tt>Create alias to send mail as.<br>
+ <br>
+Args:<br>
+ username: User to create alias for.<br>
+ name: Name of alias.<br>
+ address: Email address to send from.<br>
+ reply_to: Email address to reply to.<br>
+ make_default: Boolean for whether this is the new default sending alias.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the create operation.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-UpdateForwarding"><strong>UpdateForwarding</strong></a>(self, username, enable, forward_to<font color="#909090">=None</font>, action<font color="#909090">=None</font>)</dt><dd><tt>Update forwarding settings.<br>
+ <br>
+Args:<br>
+ username: User to update forwarding for.<br>
+ enable: Boolean whether to enable this forwarding rule.<br>
+ forward_to: Email address to forward to.<br>
+ action: Action to take after forwarding.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-UpdateGeneral"><strong>UpdateGeneral</strong></a>(self, username, page_size<font color="#909090">=None</font>, shortcuts<font color="#909090">=None</font>, arrows<font color="#909090">=None</font>, snippets<font color="#909090">=None</font>, unicode<font color="#909090">=None</font>)</dt><dd><tt>Update general settings.<br>
+ <br>
+Args:<br>
+ username: User to update general settings for.<br>
+ page_size: Number of messages to show.<br>
+ shortcuts: Boolean whether shortcuts are enabled.<br>
+ arrows: Boolean whether arrows are enabled.<br>
+ snippets: Boolean whether snippets are enabled.<br>
+ unicode: Wheter unicode is enabled.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-UpdateImap"><strong>UpdateImap</strong></a>(self, username, enable)</dt><dd><tt>Update IMAP settings.<br>
+ <br>
+Args:<br>
+ username: User to update IMAP settings for.<br>
+ enable: Boolean whether to enable IMAP.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-UpdateLanguage"><strong>UpdateLanguage</strong></a>(self, username, language)</dt><dd><tt>Update user interface language.<br>
+ <br>
+Args:<br>
+ username: User to update language for.<br>
+ language: Language code.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-UpdatePop"><strong>UpdatePop</strong></a>(self, username, enable, enable_for<font color="#909090">=None</font>, action<font color="#909090">=None</font>)</dt><dd><tt>Update POP3 settings.<br>
+ <br>
+Args:<br>
+ username: User to update POP3 settings for.<br>
+ enable: Boolean whether to enable POP3.<br>
+ enable_for: Which messages to make available via POP3.<br>
+ action: Action to take after user retrieves email via POP3.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-UpdateSignature"><strong>UpdateSignature</strong></a>(self, username, signature)</dt><dd><tt>Update signature.<br>
+ <br>
+Args:<br>
+ username: User to update signature for.<br>
+ signature: Signature string.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-UpdateVacation"><strong>UpdateVacation</strong></a>(self, username, enable, subject<font color="#909090">=None</font>, message<font color="#909090">=None</font>, contacts_only<font color="#909090">=None</font>)</dt><dd><tt>Update vacation settings.<br>
+ <br>
+Args:<br>
+ username: User to update vacation settings for.<br>
+ enable: Boolean whether to enable vacation responses.<br>
+ subject: Vacation message subject.<br>
+ message: Vacation message body.<br>
+ contacts_only: Boolean whether to send message only to contacts.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-UpdateWebClipSettings"><strong>UpdateWebClipSettings</strong></a>(self, username, enable)</dt><dd><tt>Update WebClip Settings<br>
+ <br>
+Args:<br>
+ username: User to update forwarding for.<br>
+ enable: Boolean whether to enable Web Clip.<br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>:<br>
+<dl><dt><a name="EmailSettingsService-AddAllElementsFromAllPages"><strong>AddAllElementsFromAllPages</strong></a>(self, link_finder, func)</dt><dd><tt>retrieve all pages and add all elements</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, domain<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='apps-apis.google.com'</font>, additional_headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="EmailSettingsService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt>Query the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailSettingsService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#EmailSettingsService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#EmailSettingsService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#EmailSettingsService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="EmailSettingsService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="EmailSettingsService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ALL_MAIL</strong> = 'ALL_MAIL'<br>
+<strong>API_VER</strong> = '2.0'<br>
+<strong>ARCHIVE</strong> = 'ARCHIVE'<br>
+<strong>DELETE</strong> = 'DELETE'<br>
+<strong>KEEP</strong> = 'KEEP'<br>
+<strong>MAIL_FROM_NOW_ON</strong> = 'MAIL_FROM_NOW_ON'<br>
+<strong>__author__</strong> = 'google-apps-apis@googlegroups.com'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">google-apps-apis@googlegroups.com</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.groups.client.html b/pydocs/gdata.apps.groups.client.html
new file mode 100644
index 0000000..e29fef5
--- /dev/null
+++ b/pydocs/gdata.apps.groups.client.html
@@ -0,0 +1,804 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.groups.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.groups.html"><font color="#ffffff">groups</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/groups/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/groups/client.py</a></font></td></tr></table>
+ <p><tt>GroupsClient simplifies Groups Provisioning API calls.<br>
+ <br>
+GroupsClient extends gdata.client.<a href="gdata.client.html#GDClient">GDClient</a> to ease interaction<br>
+with the Group Provisioning API. These interactions include the<br>
+ability to create, retrieve, update and delete groups.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.groups.client.html#GroupsProvisioningClient">GroupsProvisioningClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupsProvisioningClient">class <strong>GroupsProvisioningClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Group Provisioning API service.<br>
+ <br>
+Attributes:<br>
+ host: string The hostname for the Group Provisioning API service.<br>
+ api_version: string The version of the MultiDomain Provisioning API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.groups.client.html#GroupsProvisioningClient">GroupsProvisioningClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GroupsProvisioningClient-AddMemberToGroup"><strong>AddMemberToGroup</strong></a> = <a href="#GroupsProvisioningClient-add_member_to_group">add_member_to_group</a>(self, group_id, member_id, member_type<font color="#909090">=None</font>, direct_member<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-CreateGroup"><strong>CreateGroup</strong></a> = <a href="#GroupsProvisioningClient-create_group">create_group</a>(self, group_id, group_name, description<font color="#909090">=None</font>, email_permission<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-DeleteGroup"><strong>DeleteGroup</strong></a> = <a href="#GroupsProvisioningClient-delete_group">delete_group</a>(self, group_id, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-MakeGroupMembersUri"><strong>MakeGroupMembersUri</strong></a> = <a href="#GroupsProvisioningClient-make_group_member_uri">make_group_member_uri</a>(self, group_id, member_id<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-MakeGroupProvisioningUri"><strong>MakeGroupProvisioningUri</strong></a> = <a href="#GroupsProvisioningClient-make_group_provisioning_uri">make_group_provisioning_uri</a>(self, feed_type<font color="#909090">=None</font>, group_id<font color="#909090">=None</font>, member_id<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RemoveMemberFromGroup"><strong>RemoveMemberFromGroup</strong></a> = <a href="#GroupsProvisioningClient-remove_member_from_group">remove_member_from_group</a>(self, group_id, member_id, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RetrieveAllGroups"><strong>RetrieveAllGroups</strong></a> = <a href="#GroupsProvisioningClient-retrieve_all_groups">retrieve_all_groups</a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RetrieveAllMembers"><strong>RetrieveAllMembers</strong></a> = <a href="#GroupsProvisioningClient-retrieve_all_members">retrieve_all_members</a>(self, group_id, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RetrieveAllPages"><strong>RetrieveAllPages</strong></a>(self, feed, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>)</dt><dd><tt>Retrieve all pages and add all elements.<br>
+ <br>
+Args:<br>
+ feed: gdata.data.GDFeed object with linked elements.<br>
+ desired_class: type of Feed to be returned.<br>
+ <br>
+Returns:<br>
+ desired_class: subclass of gdata.data.GDFeed.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RetrieveGroup"><strong>RetrieveGroup</strong></a> = <a href="#GroupsProvisioningClient-retrieve_group">retrieve_group</a>(self, group_id, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RetrieveGroupMember"><strong>RetrieveGroupMember</strong></a> = <a href="#GroupsProvisioningClient-retrieve_group_member">retrieve_group_member</a>(self, group_id, member_id, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RetrieveGroups"><strong>RetrieveGroups</strong></a> = <a href="#GroupsProvisioningClient-retrieve_groups">retrieve_groups</a>(self, member_id, direct_only<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RetrievePageOfGroups"><strong>RetrievePageOfGroups</strong></a> = <a href="#GroupsProvisioningClient-retrieve_page_of_groups">retrieve_page_of_groups</a>(self, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RetrievePageOfMemberGroups"><strong>RetrievePageOfMemberGroups</strong></a> = <a href="#GroupsProvisioningClient-retrieve_page_of_member_groups">retrieve_page_of_member_groups</a>(self, member_id, direct_only<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RetrievePageOfMembers"><strong>RetrievePageOfMembers</strong></a> = <a href="#GroupsProvisioningClient-retrieve_page_of_members">retrieve_page_of_members</a>(self, group_id, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-UpdateGroup"><strong>UpdateGroup</strong></a> = <a href="#GroupsProvisioningClient-update_group">update_group</a>(self, group_id, group_entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-__init__"><strong>__init__</strong></a>(self, domain, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a new client for the Groups Provisioning API.<br>
+ <br>
+Args:<br>
+ domain: string The Google Apps domain with Group Provisioning.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the email settings.<br>
+ kwargs: The other parameters to pass to the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a><br>
+ constructor.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-add_member_to_group"><strong>add_member_to_group</strong></a>(self, group_id, member_id, member_type<font color="#909090">=None</font>, direct_member<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds a member with the given id to the group.<br>
+ <br>
+Args:<br>
+ group_id: string groupId of the group where member is added<br>
+ member_id: string memberId of the member added<br>
+ member_type: string (optional) type of member(user or group)<br>
+ direct_member: bool (optional) if member is a direct member<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#GroupsProvisioningClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ A gdata.apps.groups.data.GroupMemberEntry of the group member</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-create_group"><strong>create_group</strong></a>(self, group_id, group_name, description<font color="#909090">=None</font>, email_permission<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a group in the domain with the given properties.<br>
+ <br>
+Args:<br>
+ group_id: string identifier of the group.<br>
+ group_name: string name of the group.<br>
+ description: string (optional) description of the group.<br>
+ email_permission: string (optional) email permission level for the group.<br>
+ kwargs: other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#GroupsProvisioningClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ A gdata.apps.groups.data.GroupEntry of the new group</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-delete_group"><strong>delete_group</strong></a>(self, group_id, **kwargs)</dt><dd><tt>Deletes the group with the given groupId.<br>
+ <br>
+Args:<br>
+ group_id: string groupId of the group to delete.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#GroupsProvisioningClient-delete">delete</a>()</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-make_group_member_uri"><strong>make_group_member_uri</strong></a>(self, group_id, member_id<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt><dd><tt>Creates a resource feed URI for the Group Member Provisioning API.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-make_group_provisioning_uri"><strong>make_group_provisioning_uri</strong></a>(self, feed_type<font color="#909090">=None</font>, group_id<font color="#909090">=None</font>, member_id<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt><dd><tt>Creates a resource feed URI for the Groups Provisioning API.<br>
+ <br>
+Using this client's Google Apps domain, create a feed URI for group<br>
+provisioning in that domain. If an email address is provided, return a<br>
+URI for that specific resource. If params are provided, append them as GET<br>
+params.<br>
+ <br>
+Args:<br>
+ feed_type: string groupmember for groupmember feed else None<br>
+ group_id: string (optional) The identifier of group for which to<br>
+ make a feed URI.<br>
+ member_id: string (optional) The identifier of group member for which to<br>
+ make a feed URI.<br>
+ params: dict (optional) key -> value params to append as GET vars to the<br>
+ URI. Example: params={'start': 'my-resource-id'}<br>
+ <br>
+Returns:<br>
+ A string giving the URI for group provisioning for this client's<br>
+ Google Apps domain.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-remove_member_from_group"><strong>remove_member_from_group</strong></a>(self, group_id, member_id, **kwargs)</dt><dd><tt>Remove member from the given group.<br>
+ <br>
+Args:<br>
+ group_id: string groupId of the group<br>
+ member_id: string memberId of the member to be removed<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#GroupsProvisioningClient-delete">delete</a>()</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-retrieve_all_groups"><strong>retrieve_all_groups</strong></a>(self)</dt><dd><tt>Retrieve all groups in this domain.<br>
+ <br>
+Returns:<br>
+ gdata.apps.groups.data.GroupFeed of the groups</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-retrieve_all_members"><strong>retrieve_all_members</strong></a>(self, group_id, **kwargs)</dt><dd><tt>Retrieve all members of the group.<br>
+ <br>
+Returns:<br>
+ gdata.apps.groups.data.GroupMemberFeed</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-retrieve_group"><strong>retrieve_group</strong></a>(self, group_id, **kwargs)</dt><dd><tt>Retrieves a single group in the domain.<br>
+ <br>
+Args:<br>
+ group_id: string groupId of the group to be retrieved<br>
+ kwargs: other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#GroupsProvisioningClient-GetEntry">GetEntry</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.apps.groups.data.GroupEntry representing the group</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-retrieve_group_member"><strong>retrieve_group_member</strong></a>(self, group_id, member_id, **kwargs)</dt><dd><tt>Retrieves a group member with the given id from given group.<br>
+ <br>
+Args:<br>
+ group_id: string groupId of the group whose member is retrieved<br>
+ member_id: string memberId of the group member retrieved<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#GroupsProvisioningClient-GetEntry">GetEntry</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.apps.groups.data.GroupEntry representing the group member</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-retrieve_groups"><strong>retrieve_groups</strong></a>(self, member_id, direct_only<font color="#909090">=False</font>, **kwargs)</dt><dd><tt>Retrieve all groups that belong to the given member_id.<br>
+ <br>
+Args:<br>
+ member_id: The member's email address (e.g. member@example.com).<br>
+ direct_only: Boolean whether only return groups that this member<br>
+ directly belongs to.<br>
+ <br>
+Returns:<br>
+ gdata.apps.groups.data.GroupFeed of the groups</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-retrieve_page_of_groups"><strong>retrieve_page_of_groups</strong></a>(self, **kwargs)</dt><dd><tt>Retrieves first page of groups for the given domain.<br>
+ <br>
+Args:<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#GroupsProvisioningClient-GetFeed">GetFeed</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.apps.groups.data.GroupFeed of the groups</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-retrieve_page_of_member_groups"><strong>retrieve_page_of_member_groups</strong></a>(self, member_id, direct_only<font color="#909090">=False</font>, **kwargs)</dt><dd><tt>Retrieve one page of groups that belong to the given member_id.<br>
+ <br>
+Args:<br>
+ member_id: The member's email address (e.g. member@example.com).<br>
+ direct_only: Boolean whether only return groups that this member<br>
+ directly belongs to.<br>
+ <br>
+Returns:<br>
+gdata.apps.groups.data.GroupFeed of the groups.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-retrieve_page_of_members"><strong>retrieve_page_of_members</strong></a>(self, group_id, **kwargs)</dt><dd><tt>Retrieves first page of group members of the group.<br>
+ <br>
+Args:<br>
+ group_id: string groupId of the group whose members are retrieved<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#GroupsProvisioningClient-GetFeed">GetFeed</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.apps.groups.data.GroupMemberFeed of the GroupMember entries</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-update_group"><strong>update_group</strong></a>(self, group_id, group_entry, **kwargs)</dt><dd><tt>Updates the group with the given groupID.<br>
+ <br>
+Args:<br>
+ group_id: string identifier of the group.<br>
+ group_entry: GroupEntry The group entry with updated values.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#GroupsProvisioningClient-put">put</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.apps.groups.data.GroupEntry representing the group</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '2.0'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://apps-apis.google.com/a/feeds/user/', 'https://apps-apis.google.com/a/feeds/policies/', 'https://apps-apis.google.com/a/feeds/alias/', 'https://apps-apis.google.com/a/feeds/groups/', 'https://apps-apis.google.com/a/feeds/compliance/audit/', 'https://apps-apis.google.com/a/feeds/migration/', 'https://apps-apis.google.com/a/feeds/emailsettings/2.0/')</dl>
+
+<dl><dt><strong>auth_service</strong> = 'apps'</dl>
+
+<dl><dt><strong>host</strong> = 'apps-apis.google.com'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="GroupsProvisioningClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="GroupsProvisioningClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="GroupsProvisioningClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GROUP_MEMBER</strong> = 'member'<br>
+<strong>GROUP_URI_TEMPLATE</strong> = '/a/feeds/group/%s/%s'<br>
+<strong>__author__</strong> = 'Shraddha gupta <shraddhag@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Shraddha gupta <shraddhag@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.groups.data.html b/pydocs/gdata.apps.groups.data.html
new file mode 100644
index 0000000..63ad48a
--- /dev/null
+++ b/pydocs/gdata.apps.groups.data.html
@@ -0,0 +1,1522 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.groups.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.groups.html"><font color="#ffffff">groups</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/groups/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/groups/data.py</a></font></td></tr></table>
+ <p><tt>Data model classes for the Groups Provisioning API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.groups.data.html#GroupEntry">GroupEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.groups.data.html#GroupMemberEntry">GroupMemberEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.groups.data.html#GroupFeed">GroupFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.groups.data.html#GroupMemberFeed">GroupMemberFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupEntry">class <strong>GroupEntry</strong></a>(<a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a group entry in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.groups.data.html#GroupEntry">GroupEntry</a></dd>
+<dd><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GroupEntry-GetDescription"><strong>GetDescription</strong></a>(self)</dt><dd><tt>Get the description of the <a href="#GroupEntry">GroupEntry</a> object.<br>
+ <br>
+Returns:<br>
+ The description of this <a href="#GroupEntry">GroupEntry</a> object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetEmailPermission"><strong>GetEmailPermission</strong></a>(self)</dt><dd><tt>Get the emailPermission of the <a href="#GroupEntry">GroupEntry</a> object.<br>
+ <br>
+Returns:<br>
+ The emailPermission of this <a href="#GroupEntry">GroupEntry</a> object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetGroupId"><strong>GetGroupId</strong></a>(self)</dt><dd><tt>Get groupId of the <a href="#GroupEntry">GroupEntry</a> object.<br>
+ <br>
+Returns:<br>
+ The groupId this <a href="#GroupEntry">GroupEntry</a> object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetGroupName"><strong>GetGroupName</strong></a>(self)</dt><dd><tt>Get the groupName of the <a href="#GroupEntry">GroupEntry</a> object.<br>
+ <br>
+Returns:<br>
+ The groupName of this <a href="#GroupEntry">GroupEntry</a> object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-SetDescription"><strong>SetDescription</strong></a>(self, value)</dt><dd><tt>Set the description of this <a href="#GroupEntry">GroupEntry</a> object.<br>
+ <br>
+Args:<br>
+ value: string The new description to give this object.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-SetEmailPermission"><strong>SetEmailPermission</strong></a>(self, value)</dt><dd><tt>Set the emailPermission of this <a href="#GroupEntry">GroupEntry</a> object.<br>
+ <br>
+Args:<br>
+ value: string The new emailPermission to give this object.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-SetGroupId"><strong>SetGroupId</strong></a>(self, value)</dt><dd><tt>Set the groupId of this <a href="#GroupEntry">GroupEntry</a> object.<br>
+ <br>
+Args:<br>
+ value: string The new groupId to give this object.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-SetGroupName"><strong>SetGroupName</strong></a>(self, value)</dt><dd><tt>Set the groupName of this <a href="#GroupEntry">GroupEntry</a> object.<br>
+ <br>
+Args:<br>
+ value: string The new groupName to give this object.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-__init__"><strong>__init__</strong></a>(self, group_id<font color="#909090">=None</font>, group_name<font color="#909090">=None</font>, description<font color="#909090">=None</font>, email_permission<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#GroupEntry">GroupEntry</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ group_id: string identifier of the group.<br>
+ group_name: string name of the group.<br>
+ description: string (optional) the group description.<br>
+ email_permisison: string (optional) permission level of the group.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>description</strong></dt>
+<dd><tt>Get the description of the GroupEntry object.<br>
+ <br>
+Returns:<br>
+ The description of this GroupEntry object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>email_permission</strong></dt>
+<dd><tt>Get the emailPermission of the GroupEntry object.<br>
+ <br>
+Returns:<br>
+ The emailPermission of this GroupEntry object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>group_id</strong></dt>
+<dd><tt>Get groupId of the GroupEntry object.<br>
+ <br>
+Returns:<br>
+ The groupId this GroupEntry object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>group_name</strong></dt>
+<dd><tt>Get the groupName of the GroupEntry object.<br>
+ <br>
+Returns:<br>
+ The groupName of this GroupEntry object as a string or None.</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="GroupEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GroupEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupFeed">class <strong>GroupFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of <a href="#GroupEntry">GroupEntry</a> objects.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.groups.data.html#GroupFeed">GroupFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.apps.groups.data.GroupEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="GroupFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="GroupFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GroupFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupMemberEntry">class <strong>GroupMemberEntry</strong></a>(<a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a group member in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.groups.data.html#GroupMemberEntry">GroupMemberEntry</a></dd>
+<dd><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GroupMemberEntry-GetDirectMember"><strong>GetDirectMember</strong></a>(self)</dt><dd><tt>Get the directMember of the GroupMember object.<br>
+ <br>
+Returns:<br>
+ The directMember of this GroupMember object as a bool or None.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetMemberId"><strong>GetMemberId</strong></a>(self)</dt><dd><tt>Get the memberId of the GroupMember object.<br>
+ <br>
+Returns:<br>
+ The memberId of this GroupMember object as a string.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetMemberType"><strong>GetMemberType</strong></a>(self)</dt><dd><tt>Get the memberType(User, Group) of the GroupMember object.<br>
+ <br>
+Returns:<br>
+ The memberType of this GroupMember object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-SetDirectMember"><strong>SetDirectMember</strong></a>(self, value)</dt><dd><tt>Set the memberType of this GroupMember object.<br>
+ <br>
+Args:<br>
+ value: string The new memberType to give this object.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-SetMemberId"><strong>SetMemberId</strong></a>(self, value)</dt><dd><tt>Set the memberId of this GroupMember object.<br>
+ <br>
+Args:<br>
+ value: string The new memberId to give this object.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-SetMemberType"><strong>SetMemberType</strong></a>(self, value)</dt><dd><tt>Set the memberType of this GroupMember object.<br>
+ <br>
+Args:<br>
+ value: string The new memberType to give this object.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-__init__"><strong>__init__</strong></a>(self, member_id<font color="#909090">=None</font>, member_type<font color="#909090">=None</font>, direct_member<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#GroupMemberEntry">GroupMemberEntry</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ member_id: string identifier of group member object.<br>
+ member_type: string (optional) member type of group member object.<br>
+ direct_member: bool (optional) if group member object is direct member.<br>
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>direct_member</strong></dt>
+<dd><tt>Get the directMember of the GroupMember object.<br>
+ <br>
+Returns:<br>
+ The directMember of this GroupMember object as a bool or None.</tt></dd>
+</dl>
+<dl><dt><strong>member_id</strong></dt>
+<dd><tt>Get the memberId of the GroupMember object.<br>
+ <br>
+Returns:<br>
+ The memberId of this GroupMember object as a string.</tt></dd>
+</dl>
+<dl><dt><strong>member_type</strong></dt>
+<dd><tt>Get the memberType(User, Group) of the GroupMember object.<br>
+ <br>
+Returns:<br>
+ The memberType of this GroupMember object as a string or None.</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="GroupMemberEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GroupMemberEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupMemberEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupMemberEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupMemberFeed">class <strong>GroupMemberFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of <a href="#GroupMemberEntry">GroupMemberEntry</a> objects.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.groups.data.html#GroupMemberFeed">GroupMemberFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.apps.groups.data.GroupMemberEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="GroupMemberFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="GroupMemberFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GroupMemberFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupMemberFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupMemberFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMemberFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DESCRIPTION</strong> = 'description'<br>
+<strong>DIRECT_MEMBER</strong> = 'directMember'<br>
+<strong>EMAIL_PERMISSION</strong> = 'emailPermission'<br>
+<strong>GROUP_ID</strong> = 'groupId'<br>
+<strong>GROUP_NAME</strong> = 'groupName'<br>
+<strong>MEMBER_ID</strong> = 'memberId'<br>
+<strong>MEMBER_TYPE</strong> = 'memberType'<br>
+<strong>__author__</strong> = 'Shraddha gupta <shraddhag@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Shraddha gupta <shraddhag@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.groups.html b/pydocs/gdata.apps.groups.html
new file mode 100644
index 0000000..e32c3e2
--- /dev/null
+++ b/pydocs/gdata.apps.groups.html
@@ -0,0 +1,24 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.apps.groups</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.groups</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/groups/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/groups/__init__.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.apps.groups.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.apps.groups.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.apps.groups.service.html">service</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.groups.service.html b/pydocs/gdata.apps.groups.service.html
new file mode 100644
index 0000000..9784d97
--- /dev/null
+++ b/pydocs/gdata.apps.groups.service.html
@@ -0,0 +1,831 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.groups.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.groups.html"><font color="#ffffff">groups</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/groups/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/groups/service.py</a></font></td></tr></table>
+ <p><tt>Allow Google Apps domain administrators to manage groups, group members and group owners.<br>
+ <br>
+<a href="#GroupsService">GroupsService</a>: Provides methods to manage groups, members and owners.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.groups.service.html#GroupsService">GroupsService</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupsService">class <strong>GroupsService</strong></a>(<a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Apps Groups service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.groups.service.html#GroupsService">GroupsService</a></dd>
+<dd><a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GroupsService-AddMemberToGroup"><strong>AddMemberToGroup</strong></a>(self, member_id, group_id)</dt><dd><tt>Add a member to a group.<br>
+ <br>
+Args:<br>
+ member_id: The member's email address (e.g. member@example.com).<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the add operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-AddOwnerToGroup"><strong>AddOwnerToGroup</strong></a>(self, owner_email, group_id)</dt><dd><tt>Add an owner to a group.<br>
+ <br>
+Args:<br>
+ owner_email: The email address of a group owner.<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the add operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-CreateGroup"><strong>CreateGroup</strong></a>(self, group_id, group_name, description, email_permission)</dt><dd><tt>Create a group.<br>
+ <br>
+Args:<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ group_name: The name of the group.<br>
+ description: A description of the group<br>
+ email_permission: The subscription permission of the group.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the create operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-DeleteGroup"><strong>DeleteGroup</strong></a>(self, group_id)</dt><dd><tt>Delete a group based on its ID.<br>
+ <br>
+Args:<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the delete operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-IsMember"><strong>IsMember</strong></a>(self, member_id, group_id)</dt><dd><tt>Check whether the given member already exists in the given group.<br>
+ <br>
+Args:<br>
+ member_id: The member's email address (e.g. member@example.com).<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ <br>
+Returns:<br>
+ True if the member exists in the group. False otherwise.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-IsOwner"><strong>IsOwner</strong></a>(self, owner_email, group_id)</dt><dd><tt>Check whether the given member an owner of the given group.<br>
+ <br>
+Args:<br>
+ owner_email: The email address of a group owner.<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ <br>
+Returns:<br>
+ True if the member is an owner of the given group. False otherwise.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RemoveMemberFromGroup"><strong>RemoveMemberFromGroup</strong></a>(self, member_id, group_id)</dt><dd><tt>Remove the given member from the given group.<br>
+ <br>
+Args:<br>
+ member_id: The member's email address (e.g. member@example.com).<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the remove operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RemoveOwnerFromGroup"><strong>RemoveOwnerFromGroup</strong></a>(self, owner_email, group_id)</dt><dd><tt>Remove the given owner from the given group.<br>
+ <br>
+Args:<br>
+ owner_email: The email address of a group owner.<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the remove operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RetrieveAllGroups"><strong>RetrieveAllGroups</strong></a>(self)</dt><dd><tt>Retrieve all groups in the domain.<br>
+ <br>
+Args:<br>
+ None<br>
+ <br>
+Returns:<br>
+ A list containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RetrieveAllMembers"><strong>RetrieveAllMembers</strong></a>(self, group_id, suspended_users<font color="#909090">=False</font>)</dt><dd><tt>Retrieve all members in the given group.<br>
+ <br>
+Args:<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ suspended_users: A boolean; should we include any suspended users in<br>
+ the membership list returned?<br>
+ <br>
+Returns:<br>
+ A list containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RetrieveAllOwners"><strong>RetrieveAllOwners</strong></a>(self, group_id, suspended_users<font color="#909090">=False</font>)</dt><dd><tt>Retrieve all owners of the given group.<br>
+ <br>
+Args:<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ suspended_users: A boolean; should we include any suspended users in<br>
+ the ownership list returned?<br>
+ <br>
+Returns:<br>
+ A list containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RetrieveGroup"><strong>RetrieveGroup</strong></a>(self, group_id)</dt><dd><tt>Retrieve a group based on its ID.<br>
+ <br>
+Args:<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RetrieveGroups"><strong>RetrieveGroups</strong></a>(self, member_id, direct_only<font color="#909090">=False</font>)</dt><dd><tt>Retrieve all groups that belong to the given member_id.<br>
+ <br>
+Args:<br>
+ member_id: The member's email address (e.g. member@example.com).<br>
+ direct_only: Boolean whether only return groups that this member directly belongs to.<br>
+ <br>
+Returns:<br>
+ A list containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RetrieveMember"><strong>RetrieveMember</strong></a>(self, member_id, group_id)</dt><dd><tt>Retrieve the given member in the given group.<br>
+ <br>
+Args:<br>
+ member_id: The member's email address (e.g. member@example.com).<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RetrieveOwner"><strong>RetrieveOwner</strong></a>(self, owner_email, group_id)</dt><dd><tt>Retrieve the given owner in the given group.<br>
+ <br>
+Args:<br>
+ owner_email: The email address of a group owner.<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RetrievePageOfGroups"><strong>RetrievePageOfGroups</strong></a>(self, start_group<font color="#909090">=None</font>)</dt><dd><tt>Retrieve one page of groups in the domain.<br>
+ <br>
+Args:<br>
+ start_group: The key to continue for pagination through all groups.<br>
+ <br>
+Returns:<br>
+ A feed object containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RetrievePageOfMembers"><strong>RetrievePageOfMembers</strong></a>(self, group_id, suspended_users<font color="#909090">=False</font>, start<font color="#909090">=None</font>)</dt><dd><tt>Retrieve one page of members of a given group.<br>
+ <br>
+Args:<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ suspended_users: A boolean; should we include any suspended users in<br>
+ the membership list returned?<br>
+ start: The key to continue for pagination through all members.<br>
+ <br>
+Returns:<br>
+ A feed object containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RetrievePageOfOwners"><strong>RetrievePageOfOwners</strong></a>(self, group_id, suspended_users<font color="#909090">=False</font>, start<font color="#909090">=None</font>)</dt><dd><tt>Retrieve one page of owners of the given group.<br>
+ <br>
+Args:<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ suspended_users: A boolean; should we include any suspended users in<br>
+ the ownership list returned?<br>
+ start: The key to continue for pagination through all owners.<br>
+ <br>
+Returns:<br>
+ A feed object containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-UpdateGroup"><strong>UpdateGroup</strong></a>(self, group_id, group_name, description, email_permission)</dt><dd><tt>Update a group's name, description and/or permission.<br>
+ <br>
+Args:<br>
+ group_id: The ID of the group (e.g. us-sales).<br>
+ group_name: The name of the group.<br>
+ description: A description of the group<br>
+ email_permission: The subscription permission of the group.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>:<br>
+<dl><dt><a name="GroupsService-AddAllElementsFromAllPages"><strong>AddAllElementsFromAllPages</strong></a>(self, link_finder, func)</dt><dd><tt>retrieve all pages and add all elements</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, domain<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='apps-apis.google.com'</font>, additional_headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="GroupsService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt>Query the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#GroupsService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#GroupsService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#GroupsService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="GroupsService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="GroupsService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>API_VER</strong> = '2.0'<br>
+<strong>BASE_URL</strong> = '/a/feeds/group/2.0/%s'<br>
+<strong>GROUP_ID_URL</strong> = '/a/feeds/group/2.0/%s/%s'<br>
+<strong>GROUP_MEMBER_DIRECT_URL</strong> = '/a/feeds/group/2.0/%s?member=%s&directOnly=%s'<br>
+<strong>GROUP_MEMBER_URL</strong> = '/a/feeds/group/2.0/%s?member=%s'<br>
+<strong>MEMBER_ID_URL</strong> = '/a/feeds/group/2.0/%s/%s/member/%s'<br>
+<strong>MEMBER_URL</strong> = '/a/feeds/group/2.0/%s/%s/member'<br>
+<strong>MEMBER_WITH_SUSPENDED_URL</strong> = '/a/feeds/group/2.0/%s/%s/member?includeSuspendedUsers=%s'<br>
+<strong>OWNER_ID_URL</strong> = '/a/feeds/group/2.0/%s/%s/owner/%s'<br>
+<strong>OWNER_URL</strong> = '/a/feeds/group/2.0/%s/%s/owner'<br>
+<strong>OWNER_WITH_SUSPENDED_URL</strong> = '/a/feeds/group/2.0/%s/%s/owner?includeSuspendedUsers=%s'<br>
+<strong>PERMISSION_ANYONE</strong> = 'Anyone'<br>
+<strong>PERMISSION_DOMAIN</strong> = 'Domain'<br>
+<strong>PERMISSION_MEMBER</strong> = 'Member'<br>
+<strong>PERMISSION_OWNER</strong> = 'Owner'<br>
+<strong>__author__</strong> = 'google-apps-apis@googlegroups.com'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">google-apps-apis@googlegroups.com</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.html b/pydocs/gdata.apps.html
new file mode 100644
index 0000000..42c5e36
--- /dev/null
+++ b/pydocs/gdata.apps.html
@@ -0,0 +1,1510 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.apps</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.apps</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains objects used with Google Apps.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.apps.adminsettings.html"><strong>adminsettings</strong> (package)</a><br>
+<a href="gdata.apps.apps_property_entry.html">apps_property_entry</a><br>
+<a href="gdata.apps.audit.html"><strong>audit</strong> (package)</a><br>
+</td><td width="25%" valign=top><a href="gdata.apps.client.html">client</a><br>
+<a href="gdata.apps.data.html">data</a><br>
+<a href="gdata.apps.emailsettings.html"><strong>emailsettings</strong> (package)</a><br>
+</td><td width="25%" valign=top><a href="gdata.apps.groups.html"><strong>groups</strong> (package)</a><br>
+<a href="gdata.apps.migration.html"><strong>migration</strong> (package)</a><br>
+<a href="gdata.apps.multidomain.html"><strong>multidomain</strong> (package)</a><br>
+</td><td width="25%" valign=top><a href="gdata.apps.organization.html"><strong>organization</strong> (package)</a><br>
+<a href="gdata.apps.service.html">service</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.html#EmailList">EmailList</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#Login">Login</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#Name">Name</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#Nickname">Nickname</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#Property">Property</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#Quota">Quota</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#Who">Who</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.html#EmailListEntry">EmailListEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#EmailListRecipientEntry">EmailListRecipientEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#NicknameEntry">NicknameEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#PropertyEntry">PropertyEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#UserEntry">UserEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.html#EmailListFeed">EmailListFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#EmailListRecipientFeed">EmailListRecipientFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#NicknameFeed">NicknameFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#PropertyFeed">PropertyFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#UserFeed">UserFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#LinkFinder">gdata.LinkFinder</a>(<a href="atom.html#LinkFinder">atom.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.html#EmailListFeed">EmailListFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#EmailListRecipientFeed">EmailListRecipientFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#NicknameFeed">NicknameFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#PropertyFeed">PropertyFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.html#UserFeed">UserFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailList">class <strong>EmailList</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Apps <a href="#EmailList">EmailList</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#EmailList">EmailList</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailList-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="EmailList-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailList-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="EmailList-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailListEntry">class <strong>EmailListEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Apps <a href="#EmailList">EmailList</a> flavor of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#EmailListEntry">EmailListEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailListEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, email_list<font color="#909090">=None</font>, feed_link<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="EmailListEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailListEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="EmailListEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailListEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="EmailListEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="EmailListEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="EmailListEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="EmailListEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailListEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="EmailListEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailListFeed">class <strong>EmailListFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Apps <a href="#EmailList">EmailList</a> feed flavor of an Atom Feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#EmailListFeed">EmailListFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailListFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="EmailListFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailListFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="EmailListFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="EmailListFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="EmailListFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="EmailListFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailListFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="EmailListFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailListRecipientEntry">class <strong>EmailListRecipientEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Apps EmailListRecipient flavor of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#EmailListRecipientEntry">EmailListRecipientEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailListRecipientEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, who<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="EmailListRecipientEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="EmailListRecipientEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="EmailListRecipientEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailListRecipientEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="EmailListRecipientEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="EmailListRecipientEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="EmailListRecipientEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="EmailListRecipientEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailListRecipientEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="EmailListRecipientEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailListRecipientFeed">class <strong>EmailListRecipientFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Apps EmailListRecipient feed flavor of an Atom Feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#EmailListRecipientFeed">EmailListRecipientFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EmailListRecipientFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="EmailListRecipientFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailListRecipientFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="EmailListRecipientFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="EmailListRecipientFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="EmailListRecipientFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="EmailListRecipientFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="EmailListRecipientFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="EmailListRecipientFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailListRecipientFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Login">class <strong>Login</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Apps <a href="#Login">Login</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#Login">Login</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Login-__init__"><strong>__init__</strong></a>(self, user_name<font color="#909090">=None</font>, password<font color="#909090">=None</font>, suspended<font color="#909090">=None</font>, ip_whitelisted<font color="#909090">=None</font>, hash_function_name<font color="#909090">=None</font>, admin<font color="#909090">=None</font>, change_password<font color="#909090">=None</font>, agreed_to_terms<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Login-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Login-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Login-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Name">class <strong>Name</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Apps <a href="#Name">Name</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#Name">Name</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Name-__init__"><strong>__init__</strong></a>(self, family_name<font color="#909090">=None</font>, given_name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Name-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Name-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Name-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Nickname">class <strong>Nickname</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Apps <a href="#Nickname">Nickname</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#Nickname">Nickname</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Nickname-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Nickname-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Nickname-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Nickname-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NicknameEntry">class <strong>NicknameEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Apps flavor of an Atom Entry for <a href="#Nickname">Nickname</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#NicknameEntry">NicknameEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="NicknameEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, login<font color="#909090">=None</font>, nickname<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="NicknameEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="NicknameEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="NicknameEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="NicknameEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NicknameEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="NicknameEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NicknameFeed">class <strong>NicknameFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Apps <a href="#Nickname">Nickname</a> feed flavor of an Atom Feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#NicknameFeed">NicknameFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="NicknameFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="NicknameFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="NicknameFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="NicknameFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NicknameFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="NicknameFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NicknameFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Property">class <strong>Property</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Apps <a href="#Property">Property</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#Property">Property</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Property-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Property-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Property-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Property-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PropertyEntry">class <strong>PropertyEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Apps <a href="#Property">Property</a> flavor of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#PropertyEntry">PropertyEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PropertyEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, property<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="PropertyEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PropertyEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PropertyEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PropertyEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PropertyEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="PropertyEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="PropertyEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="PropertyEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PropertyEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="PropertyEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PropertyFeed">class <strong>PropertyFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Apps <a href="#Property">Property</a> feed flavor of an Atom Feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#PropertyFeed">PropertyFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PropertyFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PropertyFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PropertyFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PropertyFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="PropertyFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="PropertyFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="PropertyFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PropertyFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="PropertyFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Quota">class <strong>Quota</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Apps <a href="#Quota">Quota</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#Quota">Quota</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Quota-__init__"><strong>__init__</strong></a>(self, limit<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Quota-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Quota-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Quota-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserEntry">class <strong>UserEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Apps flavor of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#UserEntry">UserEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="UserEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, login<font color="#909090">=None</font>, name<font color="#909090">=None</font>, quota<font color="#909090">=None</font>, who<font color="#909090">=None</font>, feed_link<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="UserEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="UserEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="UserEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="UserEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="UserEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserFeed">class <strong>UserFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Apps User feed flavor of an Atom Feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#UserFeed">UserFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="UserFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="UserFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="UserFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="UserFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="UserFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Who">class <strong>Who</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Apps <a href="#Who">Who</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.html#Who">Who</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Who-__init__"><strong>__init__</strong></a>(self, rel<font color="#909090">=None</font>, email<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Who-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Who-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Who-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-EmailListEntryFromString"><strong>EmailListEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-EmailListFeedFromString"><strong>EmailListFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-EmailListFromString"><strong>EmailListFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-EmailListRecipientEntryFromString"><strong>EmailListRecipientEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-EmailListRecipientFeedFromString"><strong>EmailListRecipientFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-LoginFromString"><strong>LoginFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-NameFromString"><strong>NameFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-NicknameEntryFromString"><strong>NicknameEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-NicknameFeedFromString"><strong>NicknameFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-NicknameFromString"><strong>NicknameFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PropertyEntryFromString"><strong>PropertyEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PropertyFeedFromString"><strong>PropertyFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PropertyFromString"><strong>PropertyFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-QuotaFromString"><strong>QuotaFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-UserEntryFromString"><strong>UserEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-UserFeedFromString"><strong>UserFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-WhoFromString"><strong>WhoFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>APPS_NAMESPACE</strong> = 'http://schemas.google.com/apps/2006'<br>
+<strong>APPS_TEMPLATE</strong> = '{http://schemas.google.com/apps/2006}%s'<br>
+<strong>__author__</strong> = 'tmatsuo@sios.com (Takashi MATSUO)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">tmatsuo@sios.com (Takashi MATSUO)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.migration.html b/pydocs/gdata.apps.migration.html
new file mode 100644
index 0000000..fa33913
--- /dev/null
+++ b/pydocs/gdata.apps.migration.html
@@ -0,0 +1,684 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.apps.migration</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.migration</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/migration/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/migration/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains objects used with Google Apps.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.apps.migration.service.html">service</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.migration.html#MailEntryProperties">MailEntryProperties</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.migration.html#Label">Label</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.migration.html#MailItemProperty">MailItemProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.migration.html#Rfc822Msg">Rfc822Msg</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchEntry">gdata.BatchEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.migration.html#BatchMailEntry">BatchMailEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchFeed">gdata.BatchFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.migration.html#BatchMailEventFeed">BatchMailEventFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.migration.html#MailEntry">MailEntry</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchMailEntry">class <strong>BatchMailEntry</strong></a>(<a href="gdata.html#BatchEntry">gdata.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Migration flavor of an Atom Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.migration.html#BatchMailEntry">BatchMailEntry</a></dd>
+<dd><a href="gdata.html#BatchEntry">gdata.BatchEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BatchMailEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, rfc822_msg<font color="#909090">=None</font>, mail_item_property<font color="#909090">=None</font>, label<font color="#909090">=None</font>, batch_operation<font color="#909090">=None</font>, batch_id<font color="#909090">=None</font>, batch_status<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="BatchMailEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BatchMailEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BatchMailEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="BatchMailEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="BatchMailEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchMailEventFeed">class <strong>BatchMailEventFeed</strong></a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Migration event feed flavor of an Atom Feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.migration.html#BatchMailEventFeed">BatchMailEventFeed</a></dd>
+<dd><a href="gdata.html#BatchFeed">gdata.BatchFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BatchMailEventFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, interrupted<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#BatchFeed">gdata.BatchFeed</a>:<br>
+<dl><dt><a name="BatchMailEventFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+ <br>
+If the entry is not a <a href="gdata.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a>, atom.Entry, or another Entry flavor (optional) The<br>
+ entry which will be sent to the server as part of the batch request.<br>
+ The item must have a valid atom id so that the server knows which<br>
+ entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEventFeed-AddDelete"><strong>AddDelete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEventFeed-AddInsert"><strong>AddInsert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEventFeed-AddQuery"><strong>AddQuery</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEventFeed-AddUpdate"><strong>AddUpdate</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEventFeed-GetBatchLink"><strong>GetBatchLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BatchMailEventFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEventFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BatchMailEventFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="BatchMailEventFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEventFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEventFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEventFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEventFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEventFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEventFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BatchMailEventFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEventFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="BatchMailEventFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchMailEventFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Label">class <strong>Label</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Migration label element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.migration.html#Label">Label</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Label-__init__"><strong>__init__</strong></a>(self, label_name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Label-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Label-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Label-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MailEntry">class <strong>MailEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Migration flavor of an Atom Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.migration.html#MailEntry">MailEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="MailEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, rfc822_msg<font color="#909090">=None</font>, mail_item_property<font color="#909090">=None</font>, label<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="MailEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="MailEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="MailEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="MailEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="MailEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="MailEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MailEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MailEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="MailEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MailEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="MailEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MailEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="MailEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MailEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="MailEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MailEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MailEntryProperties">class <strong>MailEntryProperties</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a mail message and its attributes.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="MailEntryProperties-__init__"><strong>__init__</strong></a>(self, mail_message<font color="#909090">=None</font>, mail_item_properties<font color="#909090">=None</font>, mail_labels<font color="#909090">=None</font>, identifier<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MailItemProperty">class <strong>MailItemProperty</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Migration mailItemProperty element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.migration.html#MailItemProperty">MailItemProperty</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="MailItemProperty-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="MailItemProperty-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="MailItemProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="MailItemProperty-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Rfc822Msg">class <strong>Rfc822Msg</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Migration rfc822Msg element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.migration.html#Rfc822Msg">Rfc822Msg</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Rfc822Msg-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Rfc822Msg-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Rfc822Msg-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Rfc822Msg-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-BatchMailEntryFromString"><strong>BatchMailEntryFromString</strong></a>(xml_string)</dt><dd><tt>Parse in the <a href="#BatchMailEntry">BatchMailEntry</a> from the XML definition.</tt></dd></dl>
+ <dl><dt><a name="-BatchMailEventFeedFromString"><strong>BatchMailEventFeedFromString</strong></a>(xml_string)</dt><dd><tt>Parse in the <a href="#BatchMailEventFeed">BatchMailEventFeed</a> from the XML definition.</tt></dd></dl>
+ <dl><dt><a name="-LabelFromString"><strong>LabelFromString</strong></a>(xml_string)</dt><dd><tt>Parse in the mailItemProperty from the XML definition.</tt></dd></dl>
+ <dl><dt><a name="-MailEntryFromString"><strong>MailEntryFromString</strong></a>(xml_string)</dt><dd><tt>Parse in the <a href="#MailEntry">MailEntry</a> from the XML definition.</tt></dd></dl>
+ <dl><dt><a name="-MailItemPropertyFromString"><strong>MailItemPropertyFromString</strong></a>(xml_string)</dt><dd><tt>Parse in the MailItemProperiy from the XML definition.</tt></dd></dl>
+ <dl><dt><a name="-Rfc822MsgFromString"><strong>Rfc822MsgFromString</strong></a>(xml_string)</dt><dd><tt>Parse in the Rrc822 message from the XML definition.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>APPS_NAMESPACE</strong> = 'http://schemas.google.com/apps/2006'<br>
+<strong>APPS_TEMPLATE</strong> = '{http://schemas.google.com/apps/2006}%s'<br>
+<strong>__author__</strong> = 'google-apps-apis@googlegroups.com'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">google-apps-apis@googlegroups.com</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.migration.service.html b/pydocs/gdata.apps.migration.service.html
new file mode 100644
index 0000000..f9cde6b
--- /dev/null
+++ b/pydocs/gdata.apps.migration.service.html
@@ -0,0 +1,778 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.migration.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.migration.html"><font color="#ffffff">migration</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/migration/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/migration/service.py</a></font></td></tr></table>
+ <p><tt>Contains the methods to import mail via Google Apps Email Migration API.<br>
+ <br>
+<a href="#MigrationService">MigrationService</a>: Provides methods to import mail.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="gdata.apps.migration.html">gdata.apps.migration</a><br>
+<a href="threading.html">threading</a><br>
+</td><td width="25%" valign=top><a href="time.html">time</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.service.html#AppsService">gdata.apps.service.AppsService</a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.migration.service.html#MigrationService">MigrationService</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MigrationService">class <strong>MigrationService</strong></a>(<a href="gdata.apps.service.html#AppsService">gdata.apps.service.AppsService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the EMAPI migration service. Use either ImportMail to import<br>
+one message at a time, or AddMailEntry and ImportMultipleMails to import a<br>
+bunch of messages at a time.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.migration.service.html#MigrationService">MigrationService</a></dd>
+<dd><a href="gdata.apps.service.html#AppsService">gdata.apps.service.AppsService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="MigrationService-AddBatchEntry"><strong>AddBatchEntry</strong></a>(self, mail_message, mail_item_properties, mail_labels)</dt><dd><tt>Adds a message to the current batch that you later will submit.<br>
+ <br>
+Deprecated, use AddMailEntry instead<br>
+ <br>
+Args:<br>
+ mail_message: An <a href="http://www.rfc-editor.org/rfc/rfc822.txt">RFC822</a> format email message.<br>
+ mail_item_properties: A list of Gmail properties to apply to the message.<br>
+ mail_labels: A list of labels to apply to the message.<br>
+ <br>
+Returns:<br>
+ The length of the MailEntry representing the message.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-AddMailEntry"><strong>AddMailEntry</strong></a>(self, mail_message, mail_item_properties<font color="#909090">=None</font>, mail_labels<font color="#909090">=None</font>, identifier<font color="#909090">=None</font>)</dt><dd><tt>Prepares a list of mail messages to import using ImportMultipleMails.<br>
+ <br>
+Args:<br>
+ mail_message: An <a href="http://www.rfc-editor.org/rfc/rfc822.txt">RFC822</a> format email message as a string.<br>
+ mail_item_properties: List of Gmail properties to apply to the<br>
+ message.<br>
+ mail_labels: List of Gmail labels to apply to the message.<br>
+ identifier: The optional file identifier string<br>
+ <br>
+Returns:<br>
+ The number of email messages to be imported.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-ImportMail"><strong>ImportMail</strong></a>(self, user_name, mail_message, mail_item_properties, mail_labels)</dt><dd><tt>Imports a single mail message.<br>
+ <br>
+Args:<br>
+ user_name: The username to import messages to.<br>
+ mail_message: An <a href="http://www.rfc-editor.org/rfc/rfc822.txt">RFC822</a> format email message.<br>
+ mail_item_properties: A list of Gmail properties to apply to the message.<br>
+ mail_labels: A list of labels to apply to the message.<br>
+ <br>
+Returns:<br>
+ A MailEntry representing the successfully imported message.<br>
+ <br>
+Raises:<br>
+ AppsForYourDomainException: An error occurred importing the message.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-ImportMultipleMails"><strong>ImportMultipleMails</strong></a>(self, user_name, threads_per_batch<font color="#909090">=20</font>)</dt><dd><tt>Launches separate threads to import every message added by AddMailEntry.<br>
+ <br>
+Args:<br>
+ user_name: The user account name to import messages to.<br>
+ threads_per_batch: Number of messages to import at a time.<br>
+ <br>
+Returns:<br>
+ The number of email messages that were successfully migrated.<br>
+ <br>
+Raises:<br>
+ Exception: An error occurred while importing mails.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-SubmitBatch"><strong>SubmitBatch</strong></a>(self, user_name)</dt><dd><tt>Sends all the mail items you have added to the batch to the server.<br>
+ <br>
+Deprecated, use ImportMultipleMails instead<br>
+ <br>
+Args:<br>
+ user_name: The username to import messages to.<br>
+ <br>
+Returns:<br>
+ An HTTPResponse from the web service call.<br>
+ <br>
+Raises:<br>
+ AppsForYourDomainException: An error occurred importing the batch.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, domain<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='apps-apis.google.com'</font>, additional_headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.apps.service.html#AppsService">gdata.apps.service.AppsService</a>:<br>
+<dl><dt><a name="MigrationService-AddAllElementsFromAllPages"><strong>AddAllElementsFromAllPages</strong></a>(self, link_finder, func)</dt><dd><tt>retrieve all pages and add all elements</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-AddRecipientToEmailList"><strong>AddRecipientToEmailList</strong></a>(self, recipient, list_name)</dt><dd><tt>Add a recipient to a email list.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-CreateEmailList"><strong>CreateEmailList</strong></a>(self, list_name)</dt><dd><tt>Create a email list.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-CreateNickname"><strong>CreateNickname</strong></a>(self, user_name, nickname)</dt><dd><tt>Create a nickname</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-CreateUser"><strong>CreateUser</strong></a>(self, user_name, family_name, given_name, password, suspended<font color="#909090">='false'</font>, quota_limit<font color="#909090">=None</font>, password_hash_function<font color="#909090">=None</font>, change_password<font color="#909090">=None</font>)</dt><dd><tt>Create a user account.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-DeleteEmailList"><strong>DeleteEmailList</strong></a>(self, list_name)</dt><dd><tt>Delete a email list</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-DeleteNickname"><strong>DeleteNickname</strong></a>(self, nickname)</dt><dd><tt>Delete a nickname</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-DeleteUser"><strong>DeleteUser</strong></a>(self, user_name)</dt><dd><tt>Delete a user account</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetGeneratorForAllEmailLists"><strong>GetGeneratorForAllEmailLists</strong></a>(self, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve a generator for all emaillists in this domain.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetGeneratorForAllNicknames"><strong>GetGeneratorForAllNicknames</strong></a>(self, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve a generator for all nicknames in this domain.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetGeneratorForAllNicknamesOfAUser"><strong>GetGeneratorForAllNicknamesOfAUser</strong></a>(self, user_name, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve a generator for all nicknames of a particular user.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetGeneratorForAllRecipients"><strong>GetGeneratorForAllRecipients</strong></a>(self, list_name, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve a generator for all recipients of a particular emaillist.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetGeneratorForAllUsers"><strong>GetGeneratorForAllUsers</strong></a>(self, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve a generator for all users in this domain.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RemoveRecipientFromEmailList"><strong>RemoveRecipientFromEmailList</strong></a>(self, recipient, list_name)</dt><dd><tt>Remove recipient from email list.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RestoreUser"><strong>RestoreUser</strong></a>(self, user_name)</dt></dl>
+
+<dl><dt><a name="MigrationService-RetrieveAllEmailLists"><strong>RetrieveAllEmailLists</strong></a>(self)</dt><dd><tt>Retrieve all email list of a domain.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrieveAllNicknames"><strong>RetrieveAllNicknames</strong></a>(self)</dt><dd><tt>Retrieve all nicknames in the domain</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrieveAllRecipients"><strong>RetrieveAllRecipients</strong></a>(self, list_name)</dt><dd><tt>Retrieve all recipient of an email list.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrieveAllUsers"><strong>RetrieveAllUsers</strong></a>(self)</dt><dd><tt>Retrieve all users in this domain. OBSOLETE</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrieveEmailList"><strong>RetrieveEmailList</strong></a>(self, list_name)</dt><dd><tt>Retreive a single email list by the list's name.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrieveEmailLists"><strong>RetrieveEmailLists</strong></a>(self, recipient)</dt><dd><tt>Retrieve All Email List Subscriptions for an Email Address.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrieveNickname"><strong>RetrieveNickname</strong></a>(self, nickname)</dt><dd><tt>Retrieve a nickname.<br>
+ <br>
+Args:<br>
+ nickname: string The nickname to retrieve<br>
+ <br>
+Returns:<br>
+ gdata.apps.NicknameEntry</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrieveNicknames"><strong>RetrieveNicknames</strong></a>(self, user_name)</dt><dd><tt>Retrieve nicknames of the user</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrievePageOfEmailLists"><strong>RetrievePageOfEmailLists</strong></a>(self, start_email_list_name<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve one page of email list</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrievePageOfNicknames"><strong>RetrievePageOfNicknames</strong></a>(self, start_nickname<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve one page of nicknames in the domain</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrievePageOfRecipients"><strong>RetrievePageOfRecipients</strong></a>(self, list_name, start_recipient<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve one page of recipient of an email list.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrievePageOfUsers"><strong>RetrievePageOfUsers</strong></a>(self, start_username<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve one page of users in this domain.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RetrieveUser"><strong>RetrieveUser</strong></a>(self, user_name)</dt><dd><tt>Retrieve an user account.<br>
+ <br>
+Args:<br>
+ user_name: string The user name to retrieve<br>
+ <br>
+Returns:<br>
+ gdata.apps.UserEntry</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-SuspendUser"><strong>SuspendUser</strong></a>(self, user_name)</dt></dl>
+
+<dl><dt><a name="MigrationService-UpdateUser"><strong>UpdateUser</strong></a>(self, user_name, user_entry)</dt><dd><tt>Update a user account.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="MigrationService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt>Query the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MigrationService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#MigrationService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#MigrationService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#MigrationService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="MigrationService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="MigrationService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>API_VER</strong> = '2.0'<br>
+<strong>__author__</strong> = ('google-apps-apis@googlegroups.com', 'pti@google.com (Prashant Tiwari)')</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">('google-apps-apis@googlegroups.com', 'pti@google.com (Prashant Tiwari)')</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.multidomain.client.html b/pydocs/gdata.apps.multidomain.client.html
new file mode 100644
index 0000000..c22e257
--- /dev/null
+++ b/pydocs/gdata.apps.multidomain.client.html
@@ -0,0 +1,838 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.multidomain.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.multidomain.html"><font color="#ffffff">multidomain</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/multidomain/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/multidomain/client.py</a></font></td></tr></table>
+ <p><tt><a href="#MultiDomainProvisioningClient">MultiDomainProvisioningClient</a> simplifies Multidomain Provisioning API calls.<br>
+ <br>
+<a href="#MultiDomainProvisioningClient">MultiDomainProvisioningClient</a> extends gdata.client.<a href="gdata.client.html#GDClient">GDClient</a> to ease interaction<br>
+with the Google Multidomain Provisioning API. These interactions include the<br>
+ability to create, retrieve, update and delete users and aliases in multiple<br>
+domains.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.multidomain.client.html#MultiDomainProvisioningClient">MultiDomainProvisioningClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MultiDomainProvisioningClient">class <strong>MultiDomainProvisioningClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google MultiDomain Provisioning API service.<br>
+ <br>
+Attributes:<br>
+ host: string The hostname for the MultiDomain Provisioning API service.<br>
+ api_version: string The version of the MultiDomain Provisioning API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.multidomain.client.html#MultiDomainProvisioningClient">MultiDomainProvisioningClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="MultiDomainProvisioningClient-CreateAlias"><strong>CreateAlias</strong></a> = <a href="#MultiDomainProvisioningClient-create_alias">create_alias</a>(self, user_email, alias_email, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-CreateUser"><strong>CreateUser</strong></a> = <a href="#MultiDomainProvisioningClient-create_user">create_user</a>(self, email, first_name, last_name, password, is_admin, hash_function<font color="#909090">=None</font>, suspended<font color="#909090">=None</font>, change_password<font color="#909090">=None</font>, ip_whitelisted<font color="#909090">=None</font>, quota<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-DeleteAlias"><strong>DeleteAlias</strong></a> = <a href="#MultiDomainProvisioningClient-delete_alias">delete_alias</a>(self, email, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-DeleteUser"><strong>DeleteUser</strong></a> = <a href="#MultiDomainProvisioningClient-delete_user">delete_user</a>(self, email, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-MakeMultidomainAliasProvisioningUri"><strong>MakeMultidomainAliasProvisioningUri</strong></a> = <a href="#MultiDomainProvisioningClient-make_multidomain_alias_provisioning_uri">make_multidomain_alias_provisioning_uri</a>(self, email<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-MakeMultidomainProvisioningUri"><strong>MakeMultidomainProvisioningUri</strong></a> = <a href="#MultiDomainProvisioningClient-make_multidomain_provisioning_uri">make_multidomain_provisioning_uri</a>(self, feed_type, email<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-MakeMultidomainUserProvisioningUri"><strong>MakeMultidomainUserProvisioningUri</strong></a> = <a href="#MultiDomainProvisioningClient-make_multidomain_user_provisioning_uri">make_multidomain_user_provisioning_uri</a>(self, email<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-RenameUser"><strong>RenameUser</strong></a> = <a href="#MultiDomainProvisioningClient-rename_user">rename_user</a>(self, old_email, new_email, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-RetrieveAlias"><strong>RetrieveAlias</strong></a> = <a href="#MultiDomainProvisioningClient-retrieve_alias">retrieve_alias</a>(self, email, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-RetrieveAllAliases"><strong>RetrieveAllAliases</strong></a> = <a href="#MultiDomainProvisioningClient-retrieve_all_aliases">retrieve_all_aliases</a>(self, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-RetrieveAllPages"><strong>RetrieveAllPages</strong></a> = <a href="#MultiDomainProvisioningClient-retrieve_all_pages">retrieve_all_pages</a>(self, uri, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-RetrieveAllUserAliases"><strong>RetrieveAllUserAliases</strong></a> = <a href="#MultiDomainProvisioningClient-retrieve_all_user_aliases">retrieve_all_user_aliases</a>(self, user_email, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-RetrieveAllUsers"><strong>RetrieveAllUsers</strong></a> = <a href="#MultiDomainProvisioningClient-retrieve_all_users">retrieve_all_users</a>(self, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-RetrieveUser"><strong>RetrieveUser</strong></a> = <a href="#MultiDomainProvisioningClient-retrieve_user">retrieve_user</a>(self, email, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-UpdateUser"><strong>UpdateUser</strong></a> = <a href="#MultiDomainProvisioningClient-update_user">update_user</a>(self, email, user_entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-__init__"><strong>__init__</strong></a>(self, domain, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a new client for the MultiDomain Provisioning API.<br>
+ <br>
+Args:<br>
+ domain: string The Google Apps domain with MultiDomain Provisioning.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the email settings.<br>
+ kwargs: The other parameters to pass to the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a><br>
+ constructor.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-create_alias"><strong>create_alias</strong></a>(self, user_email, alias_email, **kwargs)</dt><dd><tt>Creates an alias in the domain with the given properties.<br>
+ <br>
+Args:<br>
+ user_email: string The email address of the user.<br>
+ alias_email: string The first name of the user.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ A gdata.apps.multidomain.data.AliasEntry of the new alias</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-create_user"><strong>create_user</strong></a>(self, email, first_name, last_name, password, is_admin, hash_function<font color="#909090">=None</font>, suspended<font color="#909090">=None</font>, change_password<font color="#909090">=None</font>, ip_whitelisted<font color="#909090">=None</font>, quota<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates an user in the domain with the given properties.<br>
+ <br>
+Args:<br>
+ email: string The email address of the user.<br>
+ first_name: string The first name of the user.<br>
+ last_name: string The last name of the user.<br>
+ password: string The password of the user.<br>
+ is_admin: Boolean Whether or not the user has administrator privileges.<br>
+ hash_function: string (optional) The name of the function used to hash the<br>
+ password.<br>
+ suspended: Boolean (optional) Whether or not the user is suspended.<br>
+ change_password: Boolean (optional) Whether or not the user must change<br>
+ password at first login.<br>
+ ip_whitelisted: Boolean (optional) Whether or not the user's ip is<br>
+ whitelisted.<br>
+ quota: string (optional) The value (in GB) of the user's quota.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ A gdata.apps.multidomain.data.UserEntry of the new user</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-delete_alias"><strong>delete_alias</strong></a>(self, email, **kwargs)</dt><dd><tt>Deletes the alias with the given email address.<br>
+ <br>
+Args:<br>
+ email: string The email address of the alias to delete.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-delete">delete</a>()<br>
+ <br>
+Returns:<br>
+ An HTTP response object. See gdata.client.<a href="#MultiDomainProvisioningClient-request">request</a>().</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-delete_user"><strong>delete_user</strong></a>(self, email, **kwargs)</dt><dd><tt>Deletes the user with the given email address.<br>
+ <br>
+Args:<br>
+ email: string The email address of the user to delete.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-delete">delete</a>()<br>
+ <br>
+Returns:<br>
+ An HTTP response object. See gdata.client.<a href="#MultiDomainProvisioningClient-request">request</a>().</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-make_multidomain_alias_provisioning_uri"><strong>make_multidomain_alias_provisioning_uri</strong></a>(self, email<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt><dd><tt>Creates a resource feed URI for the MultiDomain Alias Provisioning API.<br>
+ <br>
+Using this client's Google Apps domain, create a feed URI for multidomain<br>
+alias provisioning in that domain. If an email address is provided, return a<br>
+URI for that specific resource. If params are provided, append them as GET<br>
+params.<br>
+ <br>
+Args:<br>
+ email: string (optional) The email address of multidomain alias for which<br>
+ to make a feed URI.<br>
+ params: dict (optional) key -> value params to append as GET vars to the<br>
+ URI. Example: params={'start': 'my-resource-id'}<br>
+ <br>
+Returns:<br>
+ A string giving the URI for multidomain alias provisioning for this<br>
+ client's Google Apps domain.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-make_multidomain_provisioning_uri"><strong>make_multidomain_provisioning_uri</strong></a>(self, feed_type, email<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt><dd><tt>Creates a resource feed URI for the MultiDomain Provisioning API.<br>
+ <br>
+Using this client's Google Apps domain, create a feed URI for multidomain<br>
+provisioning in that domain. If an email address is provided, return a<br>
+URI for that specific resource. If params are provided, append them as GET<br>
+params.<br>
+ <br>
+Args:<br>
+ feed_type: string The type of feed (user/alias)<br>
+ email: string (optional) The email address of multidomain resource for<br>
+ which to make a feed URI.<br>
+ params: dict (optional) key -> value params to append as GET vars to the<br>
+ URI. Example: params={'start': 'my-resource-id'}<br>
+ <br>
+Returns:<br>
+ A string giving the URI for multidomain provisioning for this client's<br>
+ Google Apps domain.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-make_multidomain_user_provisioning_uri"><strong>make_multidomain_user_provisioning_uri</strong></a>(self, email<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt><dd><tt>Creates a resource feed URI for the MultiDomain User Provisioning API.<br>
+ <br>
+Using this client's Google Apps domain, create a feed URI for multidomain<br>
+user provisioning in that domain. If an email address is provided, return a<br>
+URI for that specific resource. If params are provided, append them as GET<br>
+params.<br>
+ <br>
+Args:<br>
+ email: string (optional) The email address of multidomain user for which<br>
+ to make a feed URI.<br>
+ params: dict (optional) key -> value params to append as GET vars to the<br>
+ URI. Example: params={'start': 'my-resource-id'}<br>
+ <br>
+Returns:<br>
+ A string giving the URI for multidomain user provisioning for thisis that<br>
+ client's Google Apps domain.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-rename_user"><strong>rename_user</strong></a>(self, old_email, new_email, **kwargs)</dt><dd><tt>Renames an user's account to a different domain.<br>
+ <br>
+Args:<br>
+ old_email: string The old email address of the user to rename.<br>
+ new_email: string The new email address for the user to be renamed.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-put">put</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.apps.multidomain.data.UserRenameRequest representing the request.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-retrieve_alias"><strong>retrieve_alias</strong></a>(self, email, **kwargs)</dt><dd><tt>Retrieves a single alias in the domain.<br>
+ <br>
+Args:<br>
+ email: string The email address of the alias to be retrieved<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-GetEntry">GetEntry</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.apps.multidomain.data.AliasEntry representing the alias</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-retrieve_all_aliases"><strong>retrieve_all_aliases</strong></a>(self, **kwargs)</dt><dd><tt>Retrieves all aliases in the domain.<br>
+ <br>
+Args:<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-GetFeed">GetFeed</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.data.GDFeed of the domain aliases</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-retrieve_all_pages"><strong>retrieve_all_pages</strong></a>(self, uri, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt><dd><tt>Retrieves all pages from uri.<br>
+ <br>
+Args:<br>
+ uri: The uri where the first page is.<br>
+ desired_class: Type of feed that is retrieved.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-GetFeed">GetFeed</a>()<br>
+ <br>
+Returns:<br>
+ A desired_class feed object.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-retrieve_all_user_aliases"><strong>retrieve_all_user_aliases</strong></a>(self, user_email, **kwargs)</dt><dd><tt>Retrieves all aliases for a given user in the domain.<br>
+ <br>
+Args:<br>
+ user_email: string Email address of the user whose aliases<br>
+ are to be retrieved<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-GetFeed">GetFeed</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.data.GDFeed of the user aliases</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-retrieve_all_users"><strong>retrieve_all_users</strong></a>(self, **kwargs)</dt><dd><tt>Retrieves all users in all domains.<br>
+ <br>
+Args:<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-GetFeed">GetFeed</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.data.GDFeed of the domain users</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-retrieve_user"><strong>retrieve_user</strong></a>(self, email, **kwargs)</dt><dd><tt>Retrieves a single user in the domain.<br>
+ <br>
+Args:<br>
+ email: string The email address of the user to be retrieved<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-GetEntry">GetEntry</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.apps.multidomain.data.UserEntry representing the user</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-update_user"><strong>update_user</strong></a>(self, email, user_entry, **kwargs)</dt><dd><tt>Deletes the user with the given email address.<br>
+ <br>
+Args:<br>
+ email: string The email address of the user to be updated.<br>
+ user_entry: UserEntry The user entry with updated values.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#MultiDomainProvisioningClient-put">put</a>()<br>
+ <br>
+Returns:<br>
+ A gdata.apps.multidomain.data.UserEntry representing the user</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '2.0'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://apps-apis.google.com/a/feeds/user/', 'https://apps-apis.google.com/a/feeds/policies/', 'https://apps-apis.google.com/a/feeds/alias/', 'https://apps-apis.google.com/a/feeds/groups/', 'https://apps-apis.google.com/a/feeds/compliance/audit/', 'https://apps-apis.google.com/a/feeds/migration/', 'https://apps-apis.google.com/a/feeds/emailsettings/2.0/')</dl>
+
+<dl><dt><strong>auth_service</strong> = 'apps'</dl>
+
+<dl><dt><strong>host</strong> = 'apps-apis.google.com'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="MultiDomainProvisioningClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="MultiDomainProvisioningClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="MultiDomainProvisioningClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>MULTIDOMAIN_ALIAS_FEED</strong> = 'alias'<br>
+<strong>MULTIDOMAIN_URI_TEMPLATE</strong> = '/a/feeds/%s/%s/%s'<br>
+<strong>MULTIDOMAIN_USER_FEED</strong> = 'user'<br>
+<strong>MULTIDOMAIN_USER_RENAME_URI_TEMPLATE</strong> = '/a/feeds/user/userEmail/%s/%s/%s'<br>
+<strong>__author__</strong> = 'Claudio Cherubino <ccherubino@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Claudio Cherubino <ccherubino@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.multidomain.data.html b/pydocs/gdata.apps.multidomain.data.html
new file mode 100644
index 0000000..4d811d8
--- /dev/null
+++ b/pydocs/gdata.apps.multidomain.data.html
@@ -0,0 +1,1994 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.multidomain.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.multidomain.html"><font color="#ffffff">multidomain</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/multidomain/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/multidomain/data.py</a></font></td></tr></table>
+ <p><tt>Data model classes for the Multidomain Provisioning API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.multidomain.data.html#AliasEntry">AliasEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.multidomain.data.html#UserEntry">UserEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.multidomain.data.html#UserRenameRequest">UserRenameRequest</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.multidomain.data.html#AliasFeed">AliasFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.multidomain.data.html#UserFeed">UserFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AliasEntry">class <strong>AliasEntry</strong></a>(<a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an Alias in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.multidomain.data.html#AliasEntry">AliasEntry</a></dd>
+<dd><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AliasEntry-GetAliasEmail"><strong>GetAliasEmail</strong></a>(self)</dt><dd><tt>Get the alias email address of the Alias object.<br>
+ <br>
+Returns:<br>
+ The alias email address of this Alias object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-GetUserEmail"><strong>GetUserEmail</strong></a>(self)</dt><dd><tt>Get the user email address of the Alias object.<br>
+ <br>
+Returns:<br>
+ The user email address of this Alias object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-SetAliasEmail"><strong>SetAliasEmail</strong></a>(self, value)</dt><dd><tt>Set the alias email address of this Alias object.<br>
+ <br>
+Args:<br>
+ value: string The new alias email address to give this object.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-SetUserEmail"><strong>SetUserEmail</strong></a>(self, value)</dt><dd><tt>Set the user email address of this Alias object.<br>
+ <br>
+Args:<br>
+ value: string The new user email address to give this object.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-__init__"><strong>__init__</strong></a>(self, user_email<font color="#909090">=None</font>, alias_email<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#AliasEntry">AliasEntry</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ user_email: string (optional) The user email address for the object.<br>
+ alias_email: string (optional) The alias email address for the object.<br>
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>alias_email</strong></dt>
+<dd><tt>Get the alias email address of the Alias object.<br>
+ <br>
+Returns:<br>
+ The alias email address of this Alias object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>user_email</strong></dt>
+<dd><tt>Get the user email address of the Alias object.<br>
+ <br>
+Returns:<br>
+ The user email address of this Alias object as a string or None.</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="AliasEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AliasEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="AliasEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="AliasEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AliasEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AliasFeed">class <strong>AliasFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of <a href="#AliasEntry">AliasEntry</a> objects.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.multidomain.data.html#AliasFeed">AliasFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.apps.multidomain.data.AliasEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="AliasFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="AliasFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AliasFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="AliasFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="AliasFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AliasFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AliasFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserEntry">class <strong>UserEntry</strong></a>(<a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an User in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.multidomain.data.html#UserEntry">UserEntry</a></dd>
+<dd><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="UserEntry-GetAgreedToTerms"><strong>GetAgreedToTerms</strong></a>(self)</dt><dd><tt>Get the agreed to terms flag of the User object.<br>
+ <br>
+Returns:<br>
+ The agreed to terms flag of this User object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetChangePasswordAtNextLogin"><strong>GetChangePasswordAtNextLogin</strong></a>(self)</dt><dd><tt>Get the change password at next login flag of the User object.<br>
+ <br>
+Returns:<br>
+ The change password at next login flag of this User object as a string or<br>
+ None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetEmail"><strong>GetEmail</strong></a>(self)</dt><dd><tt>Get the email address of the User object.<br>
+ <br>
+Returns:<br>
+ The email address of this User object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetFirstName"><strong>GetFirstName</strong></a>(self)</dt><dd><tt>Get the first name of the User object.<br>
+ <br>
+Returns:<br>
+ The first name of this User object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetHashFunction"><strong>GetHashFunction</strong></a>(self)</dt><dd><tt>Get the hash function of the User object.<br>
+ <br>
+Returns:<br>
+ The hash function of this User object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetIpWhitelisted"><strong>GetIpWhitelisted</strong></a>(self)</dt><dd><tt>Get the ipWhitelisted flag of the User object.<br>
+ <br>
+Returns:<br>
+ The ipWhitelisted flag of this User object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetIsAdmin"><strong>GetIsAdmin</strong></a>(self)</dt><dd><tt>Get the isAdmin flag of the User object.<br>
+ <br>
+Returns:<br>
+ The isAdmin flag of this User object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetLastName"><strong>GetLastName</strong></a>(self)</dt><dd><tt>Get the last name of the User object.<br>
+ <br>
+Returns:<br>
+ The last name of this User object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetPassword"><strong>GetPassword</strong></a>(self)</dt><dd><tt>Get the password of the User object.<br>
+ <br>
+Returns:<br>
+ The password of this User object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetQuota"><strong>GetQuota</strong></a>(self)</dt><dd><tt>Get the quota of the User object.<br>
+ <br>
+Returns:<br>
+ The quota of this User object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetSuspended"><strong>GetSuspended</strong></a>(self)</dt><dd><tt>Get the suspended flag of the User object.<br>
+ <br>
+Returns:<br>
+ The suspended flag of this User object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-SetChangePasswordAtNextLogin"><strong>SetChangePasswordAtNextLogin</strong></a>(self, value)</dt><dd><tt>Set the change password at next login flag of this User object.<br>
+ <br>
+Args:<br>
+ value: string The new change password at next login flag to give this<br>
+ object.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-SetEmail"><strong>SetEmail</strong></a>(self, value)</dt><dd><tt>Set the email address of this User object.<br>
+ <br>
+Args:<br>
+ value: string The new email address to give this object.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-SetFirstName"><strong>SetFirstName</strong></a>(self, value)</dt><dd><tt>Set the first name of this User object.<br>
+ <br>
+Args:<br>
+ value: string The new first name to give this object.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-SetHashFunction"><strong>SetHashFunction</strong></a>(self, value)</dt><dd><tt>Set the hash function of this User object.<br>
+ <br>
+Args:<br>
+ value: string The new hash function to give this object.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-SetIpWhitelisted"><strong>SetIpWhitelisted</strong></a>(self, value)</dt><dd><tt>Set the ipWhitelisted flag of this User object.<br>
+ <br>
+Args:<br>
+ value: string The new ipWhitelisted flag to give this object.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-SetIsAdmin"><strong>SetIsAdmin</strong></a>(self, value)</dt><dd><tt>Set the isAdmin flag of this User object.<br>
+ <br>
+Args:<br>
+ value: string The new isAdmin flag to give this object.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-SetLastName"><strong>SetLastName</strong></a>(self, value)</dt><dd><tt>Set the last name of this User object.<br>
+ <br>
+Args:<br>
+ value: string The new last name to give this object.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-SetPassword"><strong>SetPassword</strong></a>(self, value)</dt><dd><tt>Set the password of this User object.<br>
+ <br>
+Args:<br>
+ value: string The new password to give this object.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-SetQuota"><strong>SetQuota</strong></a>(self, value)</dt><dd><tt>Set the quota of this User object.<br>
+ <br>
+Args:<br>
+ value: string The new quota to give this object.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-SetSuspended"><strong>SetSuspended</strong></a>(self, value)</dt><dd><tt>Set the suspended flag of this User object.<br>
+ <br>
+Args:<br>
+ value: string The new suspended flag to give this object.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-__init__"><strong>__init__</strong></a>(self, uri<font color="#909090">=None</font>, email<font color="#909090">=None</font>, first_name<font color="#909090">=None</font>, last_name<font color="#909090">=None</font>, password<font color="#909090">=None</font>, hash_function<font color="#909090">=None</font>, change_password<font color="#909090">=None</font>, agreed_to_terms<font color="#909090">=None</font>, suspended<font color="#909090">=None</font>, is_admin<font color="#909090">=None</font>, ip_whitelisted<font color="#909090">=None</font>, quota<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#UserEntry">UserEntry</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ uri: string (optional) The uri of of this object for HTTP requests.<br>
+ email: string (optional) The email address of the user.<br>
+ first_name: string (optional) The first name of the user.<br>
+ last_name: string (optional) The last name of the user.<br>
+ password: string (optional) The password of the user.<br>
+ hash_function: string (optional) The name of the function used to hash the<br>
+ password.<br>
+ change_password: Boolean (optional) Whether or not the user must change<br>
+ password at first login.<br>
+ agreed_to_terms: Boolean (optional) Whether or not the user has agreed to<br>
+ the Terms of Service.<br>
+ suspended: Boolean (optional) Whether or not the user is suspended.<br>
+ is_admin: Boolean (optional) Whether or not the user has administrator<br>
+ privileges.<br>
+ ip_whitelisted: Boolean (optional) Whether or not the user's ip is<br>
+ whitelisted.<br>
+ quota: string (optional) The value (in GB) of the user's quota.<br>
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>agreed_to_terms</strong></dt>
+<dd><tt>Get the agreed to terms flag of the User object.<br>
+ <br>
+Returns:<br>
+ The agreed to terms flag of this User object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>change_password_at_next_login</strong></dt>
+<dd><tt>Get the change password at next login flag of the User object.<br>
+ <br>
+Returns:<br>
+ The change password at next login flag of this User object as a string or<br>
+ None.</tt></dd>
+</dl>
+<dl><dt><strong>email</strong></dt>
+<dd><tt>Get the email address of the User object.<br>
+ <br>
+Returns:<br>
+ The email address of this User object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>first_name</strong></dt>
+<dd><tt>Get the first name of the User object.<br>
+ <br>
+Returns:<br>
+ The first name of this User object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>hash_function</strong></dt>
+<dd><tt>Get the hash function of the User object.<br>
+ <br>
+Returns:<br>
+ The hash function of this User object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>ip_whitelisted</strong></dt>
+<dd><tt>Get the ipWhitelisted flag of the User object.<br>
+ <br>
+Returns:<br>
+ The ipWhitelisted flag of this User object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>is_admin</strong></dt>
+<dd><tt>Get the isAdmin flag of the User object.<br>
+ <br>
+Returns:<br>
+ The isAdmin flag of this User object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>last_name</strong></dt>
+<dd><tt>Get the last name of the User object.<br>
+ <br>
+Returns:<br>
+ The last name of this User object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>password</strong></dt>
+<dd><tt>Get the password of the User object.<br>
+ <br>
+Returns:<br>
+ The password of this User object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>quota</strong></dt>
+<dd><tt>Get the quota of the User object.<br>
+ <br>
+Returns:<br>
+ The quota of this User object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>suspended</strong></dt>
+<dd><tt>Get the suspended flag of the User object.<br>
+ <br>
+Returns:<br>
+ The suspended flag of this User object as a string or None.</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="UserEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UserEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserFeed">class <strong>UserFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of <a href="#UserEntry">UserEntry</a> objects.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.multidomain.data.html#UserFeed">UserFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.apps.multidomain.data.UserEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="UserFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="UserFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UserFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserRenameRequest">class <strong>UserRenameRequest</strong></a>(<a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an User rename request in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.multidomain.data.html#UserRenameRequest">UserRenameRequest</a></dd>
+<dd><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="UserRenameRequest-GetNewEmail"><strong>GetNewEmail</strong></a>(self)</dt><dd><tt>Get the new email address for the User object.<br>
+ <br>
+Returns:<br>
+ The new email address for the User object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-SetNewEmail"><strong>SetNewEmail</strong></a>(self, value)</dt><dd><tt>Set the new email address for the User object.<br>
+ <br>
+Args:<br>
+ value: string The new email address to give this object.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-__init__"><strong>__init__</strong></a>(self, new_email<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#UserRenameRequest">UserRenameRequest</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ new_email: string (optional) The new email address for the target user.<br>
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>new_email</strong></dt>
+<dd><tt>Get the new email address for the User object.<br>
+ <br>
+Returns:<br>
+ The new email address for the User object as a string or None.</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="UserRenameRequest-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UserRenameRequest-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserRenameRequest-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserRenameRequest-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserRenameRequest-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserRenameRequest-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ALIAS_EMAIL</strong> = 'aliasEmail'<br>
+<strong>USER_ADMIN</strong> = 'isAdmin'<br>
+<strong>USER_AGREED_TO_TERMS</strong> = 'agreedToTerms'<br>
+<strong>USER_CHANGE_PASSWORD</strong> = 'isChangePasswordAtNextLogin'<br>
+<strong>USER_EMAIL</strong> = 'userEmail'<br>
+<strong>USER_FIRST_NAME</strong> = 'firstName'<br>
+<strong>USER_HASH_FUNCTION</strong> = 'hashFunction'<br>
+<strong>USER_IP_WHITELISTED</strong> = 'ipWhitelisted'<br>
+<strong>USER_LAST_NAME</strong> = 'lastName'<br>
+<strong>USER_NEW_EMAIL</strong> = 'newEmail'<br>
+<strong>USER_PASSWORD</strong> = 'password'<br>
+<strong>USER_QUOTA</strong> = 'quotaInGb'<br>
+<strong>USER_SUSPENDED</strong> = 'isSuspended'<br>
+<strong>__author__</strong> = 'Claudio Cherubino <ccherubino@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Claudio Cherubino <ccherubino@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.multidomain.html b/pydocs/gdata.apps.multidomain.html
new file mode 100644
index 0000000..392b9ef
--- /dev/null
+++ b/pydocs/gdata.apps.multidomain.html
@@ -0,0 +1,23 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.apps.multidomain</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.multidomain</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/multidomain/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/multidomain/__init__.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.apps.multidomain.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.apps.multidomain.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.organization.client.html b/pydocs/gdata.apps.organization.client.html
new file mode 100644
index 0000000..d6657db
--- /dev/null
+++ b/pydocs/gdata.apps.organization.client.html
@@ -0,0 +1,916 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.organization.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.organization.html"><font color="#ffffff">organization</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/organization/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/organization/client.py</a></font></td></tr></table>
+ <p><tt><a href="#OrganizationUnitProvisioningClient">OrganizationUnitProvisioningClient</a> simplifies OrgUnit Provisioning API calls.<br>
+ <br>
+<a href="#OrganizationUnitProvisioningClient">OrganizationUnitProvisioningClient</a> extends gdata.client.<a href="gdata.client.html#GDClient">GDClient</a> to ease<br>
+interaction with the Google Organization Unit Provisioning API.<br>
+These interactions include the ability to create, retrieve, update and delete<br>
+organization units, move users within organization units, retrieve customerId<br>
+and update and retrieve users in organization units.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.organization.client.html#OrganizationUnitProvisioningClient">OrganizationUnitProvisioningClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrganizationUnitProvisioningClient">class <strong>OrganizationUnitProvisioningClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Org Unit Provisioning API service.<br>
+ <br>
+Attributes:<br>
+ host: string The hostname for the MultiDomain Provisioning API service.<br>
+ api_version: string The version of the MultiDomain Provisioning API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.organization.client.html#OrganizationUnitProvisioningClient">OrganizationUnitProvisioningClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OrganizationUnitProvisioningClient-CreateOrgUnit"><strong>CreateOrgUnit</strong></a> = <a href="#OrganizationUnitProvisioningClient-create_org_unit">create_org_unit</a>(self, customer_id, name, parent_org_unit_path<font color="#909090">='/'</font>, description<font color="#909090">=''</font>, block_inheritance<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-DeleteOrgUnit"><strong>DeleteOrgUnit</strong></a> = <a href="#OrganizationUnitProvisioningClient-delete_org_unit">delete_org_unit</a>(self, customer_id, org_unit_path, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-MakeCustomerIdFeedUri"><strong>MakeCustomerIdFeedUri</strong></a> = <a href="#OrganizationUnitProvisioningClient-make_customer_id_feed_uri">make_customer_id_feed_uri</a>(self)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-MakeOrganizationUnitOrgunitProvisioningUri"><strong>MakeOrganizationUnitOrgunitProvisioningUri</strong></a> = <a href="#OrganizationUnitProvisioningClient-make_organization_unit_orgunit_provisioning_uri">make_organization_unit_orgunit_provisioning_uri</a>(self, customer_id, org_unit_path<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-MakeOrganizationUnitOrguserProvisioningUri"><strong>MakeOrganizationUnitOrguserProvisioningUri</strong></a> = <a href="#OrganizationUnitProvisioningClient-make_organization_unit_orguser_provisioning_uri">make_organization_unit_orguser_provisioning_uri</a>(self, customer_id, org_user_email<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-MakeOrganizationUnitProvisioningUri"><strong>MakeOrganizationUnitProvisioningUri</strong></a> = <a href="#OrganizationUnitProvisioningClient-make_organization_unit_provisioning_uri">make_organization_unit_provisioning_uri</a>(self, feed_type, customer_id, org_unit_path_or_user_email<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-MoveUserToOrgUnit"><strong>MoveUserToOrgUnit</strong></a> = <a href="#OrganizationUnitProvisioningClient-move_users_to_org_unit">move_users_to_org_unit</a>(self, customer_id, org_unit_path, users_to_move, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrieveAllOrgUnits"><strong>RetrieveAllOrgUnits</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_all_org_units">retrieve_all_org_units</a>(self, customer_id, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrieveAllOrgUnitsFromUri"><strong>RetrieveAllOrgUnitsFromUri</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_all_org_units_from_uri">retrieve_all_org_units_from_uri</a>(self, uri, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrieveAllOrgUsers"><strong>RetrieveAllOrgUsers</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_all_org_users">retrieve_all_org_users</a>(self, customer_id, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrieveAllOrgUsersFromUri"><strong>RetrieveAllOrgUsersFromUri</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_all_org_users_from_uri">retrieve_all_org_users_from_uri</a>(self, uri, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrieveCustomerId"><strong>RetrieveCustomerId</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_customer_id">retrieve_customer_id</a>(self, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrieveFeedFromUri"><strong>RetrieveFeedFromUri</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_feed_from_uri">retrieve_feed_from_uri</a>(self, uri, desired_class, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrieveOrgUnit"><strong>RetrieveOrgUnit</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_org_unit">retrieve_org_unit</a>(self, customer_id, org_unit_path, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrieveOrgUnitUsers"><strong>RetrieveOrgUnitUsers</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_org_unit_users">retrieve_org_unit_users</a>(self, customer_id, org_unit_path, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrieveOrgUser"><strong>RetrieveOrgUser</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_org_user">retrieve_org_user</a>(self, customer_id, user_email, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrievePageOfOrgUnits"><strong>RetrievePageOfOrgUnits</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_page_of_org_units">retrieve_page_of_org_units</a>(self, customer_id, startKey<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrievePageOfOrgUsers"><strong>RetrievePageOfOrgUsers</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_page_of_org_users">retrieve_page_of_org_users</a>(self, customer_id, startKey<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RetrieveSubOrgUnits"><strong>RetrieveSubOrgUnits</strong></a> = <a href="#OrganizationUnitProvisioningClient-retrieve_sub_org_units">retrieve_sub_org_units</a>(self, customer_id, org_unit_path, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-UpdateOrgUnit"><strong>UpdateOrgUnit</strong></a> = <a href="#OrganizationUnitProvisioningClient-update_org_unit">update_org_unit</a>(self, customer_id, org_unit_path, org_unit_entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-UpdateOrgUser"><strong>UpdateOrgUser</strong></a> = <a href="#OrganizationUnitProvisioningClient-update_org_user">update_org_user</a>(self, customer_id, user_email, org_unit_path, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-__init__"><strong>__init__</strong></a>(self, domain, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a new client for the Organization Unit Provisioning API.<br>
+ <br>
+Args:<br>
+ domain: string The Google Apps domain with Organization Unit<br>
+ Provisioning.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the Organization<br>
+ Units.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-create_org_unit"><strong>create_org_unit</strong></a>(self, customer_id, name, parent_org_unit_path<font color="#909090">='/'</font>, description<font color="#909090">=''</font>, block_inheritance<font color="#909090">=False</font>, **kwargs)</dt><dd><tt>Create a Organization Unit.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ name: string The simple organization unit text name, not the full path<br>
+ name.<br>
+ parent_org_unit_path: string The full path of the parental tree to this<br>
+ organization unit (default: '/').<br>
+ [Note: Each element of the path MUST be URL encoded<br>
+ (example: finance%2Forganization/suborganization)]<br>
+ description: string The human readable text description of the<br>
+ organization unit (optional).<br>
+ block_inheritance: boolean This parameter blocks policy setting<br>
+ inheritance from organization units higher in<br>
+ the organization tree (default: False).<br>
+ <br>
+Returns:<br>
+ A gdata.apps.organization.data.OrgUnitEntry representing an organization<br>
+ unit.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-delete_org_unit"><strong>delete_org_unit</strong></a>(self, customer_id, org_unit_path, **kwargs)</dt><dd><tt>Delete a Orgunit based on its path.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ org_unit_path: string The organization's full path name.<br>
+ [Note: Each element of the path MUST be URL encoded<br>
+ (example: finance%2Forganization/suborganization)]<br>
+ <br>
+Returns:<br>
+ An HTTP response object. See gdata.client.<a href="#OrganizationUnitProvisioningClient-request">request</a>().</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-make_customer_id_feed_uri"><strong>make_customer_id_feed_uri</strong></a>(self)</dt><dd><tt>Creates a feed uri for retrieving customerId of the user.<br>
+ <br>
+Returns:<br>
+ A string giving the URI for retrieving customerId of the user.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-make_organization_unit_orgunit_provisioning_uri"><strong>make_organization_unit_orgunit_provisioning_uri</strong></a>(self, customer_id, org_unit_path<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt><dd><tt>Creates a resource feed URI for the orgunit's Provisioning API calls.<br>
+ <br>
+Using this client's Google Apps domain, create a feed URI for organization<br>
+unit orgunit's provisioning in that domain. If an org_unit_path is<br>
+provided, return a URI for that specific resource.<br>
+If params are provided, append them as GET params.<br>
+ <br>
+Args:<br>
+ customer_id: string The customerId of the user.<br>
+ org_unit_path: string (optional) The organization unit's path for which<br>
+ to make a feed URI.<br>
+ params: dict (optional) key -> value params to append as GET vars to the<br>
+ URI. Example: params={'start': 'my-resource-id'}<br>
+ <br>
+Returns:<br>
+ A string giving the URI for organization unit provisioning for<br>
+ given org_unit_path</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-make_organization_unit_orguser_provisioning_uri"><strong>make_organization_unit_orguser_provisioning_uri</strong></a>(self, customer_id, org_user_email<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt><dd><tt>Creates a resource feed URI for the orguser's Provisioning API calls.<br>
+ <br>
+Using this client's Google Apps domain, create a feed URI for organization<br>
+unit orguser's provisioning in that domain. If an org_user_email is<br>
+provided, return a URI for that specific resource.<br>
+If params are provided, append them as GET params.<br>
+ <br>
+Args:<br>
+ customer_id: string The customerId of the user.<br>
+ org_user_email: string (optional) The organization unit's path for which<br>
+ to make a feed URI.<br>
+ params: dict (optional) key -> value params to append as GET vars to the<br>
+ URI. Example: params={'start': 'my-resource-id'}<br>
+ <br>
+Returns:<br>
+ A string giving the URI for organization user provisioning for<br>
+ given org_user_email</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-make_organization_unit_provisioning_uri"><strong>make_organization_unit_provisioning_uri</strong></a>(self, feed_type, customer_id, org_unit_path_or_user_email<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt><dd><tt>Creates a resource feed URI for the Organization Unit Provisioning API.<br>
+ <br>
+Using this client's Google Apps domain, create a feed URI for organization<br>
+unit provisioning in that domain. If an org unit path or org user email<br>
+address is provided, return a URI for that specific resource.<br>
+If params are provided, append them as GET params.<br>
+ <br>
+Args:<br>
+ feed_type: string The type of feed (orgunit/orguser)<br>
+ customer_id: string The customerId of the user.<br>
+ org_unit_path_or_user_email: string (optional) The org unit path or<br>
+ org user email address for which to make a feed URI.<br>
+ params: dict (optional) key -> value params to append as GET vars to the<br>
+ URI. Example: params={'start': 'my-resource-id'}<br>
+ <br>
+Returns:<br>
+ A string giving the URI for organization unit provisioning for this<br>
+ client's Google Apps domain.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-move_users_to_org_unit"><strong>move_users_to_org_unit</strong></a>(self, customer_id, org_unit_path, users_to_move, **kwargs)</dt><dd><tt>Move a user to an Organization Unit.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ org_unit_path: string The organization's full path name.<br>
+ [Note: Each element of the path MUST be URL encoded<br>
+ (example: finance%2Forganization/suborganization)]<br>
+ users_to_move: list Email addresses of users to move in list format.<br>
+ [Note: You can move a maximum of 25 users at one time.]<br>
+ <br>
+Returns:<br>
+ A gdata.apps.organization.data.OrgUnitEntry representing<br>
+ an organization unit.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_all_org_units"><strong>retrieve_all_org_units</strong></a>(self, customer_id, **kwargs)</dt><dd><tt>Retrieve all OrgUnits in the customer's domain.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ <br>
+Returns:<br>
+ gdata.apps.organisation.data.OrgUnitFeed object</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_all_org_units_from_uri"><strong>retrieve_all_org_units_from_uri</strong></a>(self, uri, **kwargs)</dt><dd><tt>Retrieve all OrgUnits from given uri.<br>
+ <br>
+Args:<br>
+ uri: string The uri from where to get the orgunits.<br>
+ <br>
+Returns:<br>
+ gdata.apps.organisation.data.OrgUnitFeed object</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_all_org_users"><strong>retrieve_all_org_users</strong></a>(self, customer_id, **kwargs)</dt><dd><tt>Retrieve all OrgUsers in the customer's domain.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ <br>
+Returns:<br>
+ gdata.apps.organisation.data.OrgUserFeed object</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_all_org_users_from_uri"><strong>retrieve_all_org_users_from_uri</strong></a>(self, uri, **kwargs)</dt><dd><tt>Retrieve all OrgUsers from given uri.<br>
+ <br>
+Args:<br>
+ uri: string The uri from where to get the orgusers.<br>
+ <br>
+Returns:<br>
+ gdata.apps.organisation.data.OrgUserFeed object</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_customer_id"><strong>retrieve_customer_id</strong></a>(self, **kwargs)</dt><dd><tt>Retrieve the Customer ID for the customer domain.<br>
+ <br>
+Returns:<br>
+ A gdata.apps.organization.data.CustomerIdEntry.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_feed_from_uri"><strong>retrieve_feed_from_uri</strong></a>(self, uri, desired_class, **kwargs)</dt><dd><tt>Retrieve feed from given uri.<br>
+ <br>
+Args:<br>
+ uri: string The uri from where to get the feed.<br>
+ desired_class: Feed The type of feed that if to be retrieved.<br>
+ <br>
+Returns:<br>
+ Feed of type desired class.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_org_unit"><strong>retrieve_org_unit</strong></a>(self, customer_id, org_unit_path, **kwargs)</dt><dd><tt>Retrieve a Orgunit based on its path.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ org_unit_path: string The organization's full path name.<br>
+ [Note: Each element of the path MUST be URL encoded<br>
+ (example: finance%2Forganization/suborganization)]<br>
+ <br>
+Returns:<br>
+ A gdata.apps.organization.data.OrgUnitEntry representing<br>
+ an organization unit.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_org_unit_users"><strong>retrieve_org_unit_users</strong></a>(self, customer_id, org_unit_path, **kwargs)</dt><dd><tt>Retrieve all OrgUsers of the provided OrgUnit.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ org_unit_path: string The organization's full path name.<br>
+ [Note: Each element of the path MUST be URL encoded<br>
+ (example: finance%2Forganization/suborganization)]<br>
+ <br>
+Returns:<br>
+ gdata.apps.organisation.data.OrgUserFeed object</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_org_user"><strong>retrieve_org_user</strong></a>(self, customer_id, user_email, **kwargs)</dt><dd><tt>Retrieve an organization user.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ user_email: string The email address of the user.<br>
+ <br>
+Returns:<br>
+ A gdata.apps.organization.data.OrgUserEntry representing<br>
+ an organization user.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_page_of_org_units"><strong>retrieve_page_of_org_units</strong></a>(self, customer_id, startKey<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieve one page of OrgUnits in the customer's domain.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ startKey: string The key to continue for pagination through all OrgUnits.<br>
+ <br>
+Returns:<br>
+ gdata.apps.organisation.data.OrgUnitFeed object</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_page_of_org_users"><strong>retrieve_page_of_org_users</strong></a>(self, customer_id, startKey<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieve one page of OrgUsers in the customer's domain.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ startKey: The string key to continue for pagination through all OrgUnits.<br>
+ <br>
+Returns:<br>
+ gdata.apps.organisation.data.OrgUserFeed object</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-retrieve_sub_org_units"><strong>retrieve_sub_org_units</strong></a>(self, customer_id, org_unit_path, **kwargs)</dt><dd><tt>Retrieve all Sub-OrgUnits of the provided OrgUnit.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ org_unit_path: string The organization's full path name.<br>
+ [Note: Each element of the path MUST be URL encoded<br>
+ (example: finance%2Forganization/suborganization)]<br>
+ <br>
+Returns:<br>
+ gdata.apps.organisation.data.OrgUnitFeed object</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-update_org_unit"><strong>update_org_unit</strong></a>(self, customer_id, org_unit_path, org_unit_entry, **kwargs)</dt><dd><tt>Update a Organization Unit.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ org_unit_path: string The organization's full path name.<br>
+ [Note: Each element of the path MUST be URL encoded<br>
+ (example: finance%2Forganization/suborganization)]<br>
+ org_unit_entry: gdata.apps.organization.data.OrgUnitEntry<br>
+ The updated organization unit entry.<br>
+ <br>
+Returns:<br>
+ A gdata.apps.organization.data.OrgUnitEntry representing an organization<br>
+ unit.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-update_org_user"><strong>update_org_user</strong></a>(self, customer_id, user_email, org_unit_path, **kwargs)</dt><dd><tt>Update the OrgUnit of a OrgUser.<br>
+ <br>
+Args:<br>
+ customer_id: string The ID of the Google Apps customer.<br>
+ user_email: string The email address of the user.<br>
+ org_unit_path: string The new organization's full path name.<br>
+ [Note: Each element of the path MUST be URL encoded<br>
+ (example: finance%2Forganization/suborganization)]<br>
+ <br>
+Returns:<br>
+ A gdata.apps.organization.data.OrgUserEntry representing<br>
+ an organization user.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '2.0'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://apps-apis.google.com/a/feeds/user/', 'https://apps-apis.google.com/a/feeds/policies/', 'https://apps-apis.google.com/a/feeds/alias/', 'https://apps-apis.google.com/a/feeds/groups/', 'https://apps-apis.google.com/a/feeds/compliance/audit/', 'https://apps-apis.google.com/a/feeds/migration/', 'https://apps-apis.google.com/a/feeds/emailsettings/2.0/')</dl>
+
+<dl><dt><strong>auth_service</strong> = 'apps'</dl>
+
+<dl><dt><strong>host</strong> = 'apps-apis.google.com'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="OrganizationUnitProvisioningClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="OrganizationUnitProvisioningClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationUnitProvisioningClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>CUSTOMER_ID_URI_TEMPLATE</strong> = '/a/feeds/customer/%s/customerId'<br>
+<strong>ORGANIZATION_UNIT_FEED</strong> = 'orgunit'<br>
+<strong>ORGANIZATION_UNIT_URI_TEMPLATE</strong> = '/a/feeds/%s/%s/%s'<br>
+<strong>ORGANIZATION_USER_FEED</strong> = 'orguser'<br>
+<strong>__author__</strong> = 'Gunjan Sharma <gunjansharma@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Gunjan Sharma <gunjansharma@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.organization.data.html b/pydocs/gdata.apps.organization.data.html
new file mode 100644
index 0000000..fc2f78d
--- /dev/null
+++ b/pydocs/gdata.apps.organization.data.html
@@ -0,0 +1,1985 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.organization.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.organization.html"><font color="#ffffff">organization</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/organization/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/organization/data.py</a></font></td></tr></table>
+ <p><tt>Data model classes for the Organization Unit Provisioning API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.organization.data.html#CustomerIdEntry">CustomerIdEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.organization.data.html#OrgUnitEntry">OrgUnitEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.organization.data.html#OrgUserEntry">OrgUserEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.organization.data.html#OrgUnitFeed">OrgUnitFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.organization.data.html#OrgUserFeed">OrgUserFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CustomerIdEntry">class <strong>CustomerIdEntry</strong></a>(<a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a customerId entry in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.organization.data.html#CustomerIdEntry">CustomerIdEntry</a></dd>
+<dd><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CustomerIdEntry-GetCustomerId"><strong>GetCustomerId</strong></a>(self)</dt><dd><tt>Get the customer ID of the customerId object.<br>
+ <br>
+Returns:<br>
+ The customer ID of this customerId object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetCustomerOrgUnitDescription"><strong>GetCustomerOrgUnitDescription</strong></a>(self)</dt><dd><tt>Get the Customer Organization Unit Description of the customerId object.<br>
+ <br>
+Returns:<br>
+ The Customer Organization Unit Description of this customerId object<br>
+ as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetCustomerOrgUnitName"><strong>GetCustomerOrgUnitName</strong></a>(self)</dt><dd><tt>Get the Customer Organization Unit name of the customerId object.<br>
+ <br>
+Returns:<br>
+ The Customer Organization unit name of this customerId object as a string<br>
+ or None.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetOrgUnitDescription"><strong>GetOrgUnitDescription</strong></a>(self)</dt><dd><tt>Get the Organization Unit Description of the customerId object.<br>
+ <br>
+Returns:<br>
+ The Organization Unit Description of this customerId object as a string<br>
+ or None.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetOrgUnitName"><strong>GetOrgUnitName</strong></a>(self)</dt><dd><tt>Get the Organization Unit name of the customerId object.<br>
+ <br>
+Returns:<br>
+ The Organization unit name of this customerId object as a string or None.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>customer_id</strong></dt>
+<dd><tt>Get the customer ID of the customerId object.<br>
+ <br>
+Returns:<br>
+ The customer ID of this customerId object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>customer_org_unit_description</strong></dt>
+<dd><tt>Get the Customer Organization Unit Description of the customerId object.<br>
+ <br>
+Returns:<br>
+ The Customer Organization Unit Description of this customerId object<br>
+ as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>customer_org_unit_name</strong></dt>
+<dd><tt>Get the Customer Organization Unit name of the customerId object.<br>
+ <br>
+Returns:<br>
+ The Customer Organization unit name of this customerId object as a string<br>
+ or None.</tt></dd>
+</dl>
+<dl><dt><strong>org_unit_description</strong></dt>
+<dd><tt>Get the Organization Unit Description of the customerId object.<br>
+ <br>
+Returns:<br>
+ The Organization Unit Description of this customerId object as a string<br>
+ or None.</tt></dd>
+</dl>
+<dl><dt><strong>org_unit_name</strong></dt>
+<dd><tt>Get the Organization Unit name of the customerId object.<br>
+ <br>
+Returns:<br>
+ The Organization unit name of this customerId object as a string or None.</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CustomerIdEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CustomerIdEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CustomerIdEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CustomerIdEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CustomerIdEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerIdEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgUnitEntry">class <strong>OrgUnitEntry</strong></a>(<a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an OrganizationUnit in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.organization.data.html#OrgUnitEntry">OrgUnitEntry</a></dd>
+<dd><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OrgUnitEntry-GetMovedUsers"><strong>GetMovedUsers</strong></a>(self)</dt><dd><tt>Get the moved users of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The the moved users of this OrganizationUnit object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetOrgUnitBlockInheritance"><strong>GetOrgUnitBlockInheritance</strong></a>(self)</dt><dd><tt>Get the block_inheritance flag of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The the block_inheritance flag of this OrganizationUnit object<br>
+ as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetOrgUnitDescription"><strong>GetOrgUnitDescription</strong></a>(self)</dt><dd><tt>Get the Organization Unit Description of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The Organization Unit Description of this OrganizationUnit object<br>
+ as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetOrgUnitName"><strong>GetOrgUnitName</strong></a>(self)</dt><dd><tt>Get the Organization Unit name of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The Organization unit name of this OrganizationUnit object as a string<br>
+ or None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetOrgUnitPath"><strong>GetOrgUnitPath</strong></a>(self)</dt><dd><tt>Get the Organization Unit Path of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The Organization Unit Path of this OrganizationUnit object as a string<br>
+ or None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetParentOrgUnitPath"><strong>GetParentOrgUnitPath</strong></a>(self)</dt><dd><tt>Get the Parent Organization Unit Path of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The Parent Organization Unit Path of this OrganizationUnit object<br>
+ as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-SetOrgUnitBlockInheritance"><strong>SetOrgUnitBlockInheritance</strong></a>(self, value)</dt><dd><tt>Set the block_inheritance flag of the OrganizationUnit object.<br>
+ <br>
+Args:<br>
+ value: [string] The new block_inheritance flag to give this object.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-SetOrgUnitDescription"><strong>SetOrgUnitDescription</strong></a>(self, value)</dt><dd><tt>Set the Organization Unit Description of the OrganizationUnit object.<br>
+ <br>
+Args:<br>
+ value: [string] The new Organization Unit Description<br>
+ to give this object.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-SetOrgUnitName"><strong>SetOrgUnitName</strong></a>(self, value)</dt><dd><tt>Set the Organization Unit name of the OrganizationUnit object.<br>
+ <br>
+Args:<br>
+ value: [string] The new Organization Unit name to give this object.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-SetOrgUnitPath"><strong>SetOrgUnitPath</strong></a>(self, value)</dt><dd><tt>Set the Organization Unit path of the OrganizationUnit object.<br>
+ <br>
+Args:<br>
+ value: [string] The new Organization Unit path to give this object.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-SetParentOrgUnitPath"><strong>SetParentOrgUnitPath</strong></a>(self, value)</dt><dd><tt>Set the Parent Organization Unit path of the OrganizationUnit object.<br>
+ <br>
+Args:<br>
+ value: [string] The new Parent Organization Unit path<br>
+ to give this object.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-SetUsersToMove"><strong>SetUsersToMove</strong></a>(self, value)</dt><dd><tt>Set the Users to Move of the OrganizationUnit object.<br>
+ <br>
+Args:<br>
+ value: [string] The comma seperated list of users to move<br>
+ to give this object.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-__init__"><strong>__init__</strong></a>(self, org_unit_name<font color="#909090">=None</font>, org_unit_path<font color="#909090">=None</font>, parent_org_unit_path<font color="#909090">=None</font>, org_unit_description<font color="#909090">=None</font>, org_unit_block_inheritance<font color="#909090">=None</font>, move_users<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new OrganizationUnit object with the given arguments.<br>
+ <br>
+Args:<br>
+ org_unit_name: string (optional) The organization unit name<br>
+ for the object.<br>
+ org_unit_path: string (optional) The organization unit path<br>
+ for the object.<br>
+ parent_org_unit_path: string (optional) The parent organization unit path<br>
+ for the object.<br>
+ org_unit_description: string (optional) The organization unit description<br>
+ for the object.<br>
+ org_unit_block_inheritance: boolean (optional) weather or not inheritance<br>
+ from the organization unit is blocked.<br>
+ move_users: string (optional) comma seperated list of users to move.<br>
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>move_users</strong></dt>
+<dd><tt>Get the moved users of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The the moved users of this OrganizationUnit object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>org_unit_block_inheritance</strong></dt>
+<dd><tt>Get the block_inheritance flag of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The the block_inheritance flag of this OrganizationUnit object<br>
+ as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>org_unit_description</strong></dt>
+<dd><tt>Get the Organization Unit Description of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The Organization Unit Description of this OrganizationUnit object<br>
+ as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>org_unit_name</strong></dt>
+<dd><tt>Get the Organization Unit name of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The Organization unit name of this OrganizationUnit object as a string<br>
+ or None.</tt></dd>
+</dl>
+<dl><dt><strong>org_unit_path</strong></dt>
+<dd><tt>Get the Organization Unit Path of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The Organization Unit Path of this OrganizationUnit object as a string<br>
+ or None.</tt></dd>
+</dl>
+<dl><dt><strong>parent_org_unit_path</strong></dt>
+<dd><tt>Get the Parent Organization Unit Path of the OrganizationUnit object.<br>
+ <br>
+Returns:<br>
+ The Parent Organization Unit Path of this OrganizationUnit object<br>
+ as a string or None.</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="OrgUnitEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OrgUnitEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="OrgUnitEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="OrgUnitEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgUnitFeed">class <strong>OrgUnitFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of <a href="#OrgUnitEntry">OrgUnitEntry</a> objects.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.organization.data.html#OrgUnitFeed">OrgUnitFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.apps.organization.data.OrgUnitEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="OrgUnitFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="OrgUnitFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OrgUnitFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="OrgUnitFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="OrgUnitFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUnitFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgUserEntry">class <strong>OrgUserEntry</strong></a>(<a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an OrgUser in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.organization.data.html#OrgUserEntry">OrgUserEntry</a></dd>
+<dd><a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OrgUserEntry-GetOldOrgUnitPath"><strong>GetOldOrgUnitPath</strong></a>(self)</dt><dd><tt>Get the Old Organization Unit Path of the OrgUser object.<br>
+ <br>
+Returns:<br>
+ The Old Organization Unit Path of this OrgUser object as a string<br>
+ or None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-GetOrgUnitPath"><strong>GetOrgUnitPath</strong></a>(self)</dt><dd><tt>Get the Organization Unit Path of the OrgUser object.<br>
+ <br>
+Returns:<br>
+ The Organization Unit Path of this OrgUser object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-GetUserEmail"><strong>GetUserEmail</strong></a>(self)</dt><dd><tt>Get the user email address of the OrgUser object.<br>
+ <br>
+Returns:<br>
+ The user email address of this OrgUser object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-SetOldOrgUnitPath"><strong>SetOldOrgUnitPath</strong></a>(self, value)</dt><dd><tt>Set the Old Organization Unit path of the OrgUser object.<br>
+ <br>
+Args:<br>
+ value: [string] The new Old Organization Unit path to give this object.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-SetOrgUnitPath"><strong>SetOrgUnitPath</strong></a>(self, value)</dt><dd><tt>Set the Organization Unit path of the OrgUser object.<br>
+ <br>
+Args:<br>
+ value: [string] The new Organization Unit path to give this object.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-SetUserEmail"><strong>SetUserEmail</strong></a>(self, value)</dt><dd><tt>Set the user email address of this OrgUser object.<br>
+ <br>
+Args:<br>
+ value: string The new user email address to give this object.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-__init__"><strong>__init__</strong></a>(self, user_email<font color="#909090">=None</font>, org_unit_path<font color="#909090">=None</font>, old_org_unit_path<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new OrgUser object with the given arguments.<br>
+ <br>
+Args:<br>
+ user_email: string (optional) The user email address for the object.<br>
+ org_unit_path: string (optional) The organization unit path<br>
+ for the object.<br>
+ old_org_unit_path: string (optional) The old organization unit path<br>
+ for the object.<br>
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.<br>
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>old_org_unit_path</strong></dt>
+<dd><tt>Get the Old Organization Unit Path of the OrgUser object.<br>
+ <br>
+Returns:<br>
+ The Old Organization Unit Path of this OrgUser object as a string<br>
+ or None.</tt></dd>
+</dl>
+<dl><dt><strong>org_unit_path</strong></dt>
+<dd><tt>Get the Organization Unit Path of the OrgUser object.<br>
+ <br>
+Returns:<br>
+ The Organization Unit Path of this OrgUser object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>user_email</strong></dt>
+<dd><tt>Get the user email address of the OrgUser object.<br>
+ <br>
+Returns:<br>
+ The user email address of this OrgUser object as a string or None.</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.apps.apps_property_entry.html#AppsPropertyEntry">gdata.apps.apps_property_entry.AppsPropertyEntry</a>:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="OrgUserEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OrgUserEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="OrgUserEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="OrgUserEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgUserFeed">class <strong>OrgUserFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of <a href="#OrgUserEntry">OrgUserEntry</a> objects.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.organization.data.html#OrgUserFeed">OrgUserFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.apps.organization.data.OrgUserEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="OrgUserFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="OrgUserFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OrgUserFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="OrgUserFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="OrgUserFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="OrgUserFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgUserFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>CUSTOMER_ID</strong> = 'customerId'<br>
+<strong>CUSTOMER_ORG_UNIT_DESCRIPTION</strong> = 'customerOrgUnitDescription'<br>
+<strong>CUSTOMER_ORG_UNIT_NAME</strong> = 'customerOrgUnitName'<br>
+<strong>MOVED_USERS</strong> = 'usersMoved'<br>
+<strong>OLD_ORG_UNIT_PATH</strong> = 'oldOrgUnitPath'<br>
+<strong>ORG_UNIT_BLOCK_INHERITANCE</strong> = 'blockInheritance'<br>
+<strong>ORG_UNIT_DESCRIPTION</strong> = 'description'<br>
+<strong>ORG_UNIT_NAME</strong> = 'name'<br>
+<strong>ORG_UNIT_PATH</strong> = 'orgUnitPath'<br>
+<strong>PARENT_ORG_UNIT_PATH</strong> = 'parentOrgUnitPath'<br>
+<strong>USERS_TO_MOVE</strong> = 'usersToMove'<br>
+<strong>USER_EMAIL</strong> = 'orgUserEmail'<br>
+<strong>__author__</strong> = 'Gunjan Sharma <gunjansharma@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Gunjan Sharma <gunjansharma@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.organization.html b/pydocs/gdata.apps.organization.html
new file mode 100644
index 0000000..2581834
--- /dev/null
+++ b/pydocs/gdata.apps.organization.html
@@ -0,0 +1,24 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.apps.organization</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.organization</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/organization/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/organization/__init__.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.apps.organization.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.apps.organization.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.apps.organization.service.html">service</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.organization.service.html b/pydocs/gdata.apps.organization.service.html
new file mode 100644
index 0000000..6689294
--- /dev/null
+++ b/pydocs/gdata.apps.organization.service.html
@@ -0,0 +1,802 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.organization.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.<a href="gdata.apps.organization.html"><font color="#ffffff">organization</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/organization/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/organization/service.py</a></font></td></tr></table>
+ <p><tt>Allow Google Apps domain administrators to manage organization unit and organization user.<br>
+ <br>
+<a href="#OrganizationService">OrganizationService</a>: Provides methods to manage organization unit and organization user.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.organization.service.html#OrganizationService">OrganizationService</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrganizationService">class <strong>OrganizationService</strong></a>(<a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Apps Organizations service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.organization.service.html#OrganizationService">OrganizationService</a></dd>
+<dd><a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OrganizationService-CreateOrgUnit"><strong>CreateOrgUnit</strong></a>(self, customer_id, name, parent_org_unit_path<font color="#909090">='/'</font>, description<font color="#909090">=''</font>, block_inheritance<font color="#909090">=False</font>)</dt><dd><tt>Create a Organization Unit.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ name: The simple organization unit text name, not the full path name.<br>
+ parent_org_unit_path: The full path of the parental tree to this organization unit (default: '/').<br>
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)<br>
+ description: The human readable text description of the organization unit (optional).<br>
+ block_inheritance: This parameter blocks policy setting inheritance <br>
+ from organization units higher in the organization tree (default: False).<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the create operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-DeleteOrgUnit"><strong>DeleteOrgUnit</strong></a>(self, customer_id, org_unit_path)</dt><dd><tt>Delete a Orgunit based on its path.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ org_unit_path: The organization's full path name.<br>
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the delete operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-MoveUserToOrgUnit"><strong>MoveUserToOrgUnit</strong></a>(self, customer_id, org_unit_path, users_to_move)</dt><dd><tt>Move a user to an Organization Unit.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ org_unit_path: The organization's full path name.<br>
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)<br>
+ users_to_move: Email addresses list of users to move. Note: You can move a maximum of 25 users at one time.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RetrieveAllOrgUnits"><strong>RetrieveAllOrgUnits</strong></a>(self, customer_id)</dt><dd><tt>Retrieve all OrgUnits in the customer's domain.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ <br>
+Returns:<br>
+ A list containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RetrieveAllOrgUsers"><strong>RetrieveAllOrgUsers</strong></a>(self, customer_id)</dt><dd><tt>Retrieve all OrgUsers in the customer's domain.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ <br>
+Returns:<br>
+ A list containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RetrieveCustomerId"><strong>RetrieveCustomerId</strong></a>(self)</dt><dd><tt>Retrieve the Customer ID for the account of the authenticated administrator making this request.<br>
+ <br>
+Args:<br>
+ None.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RetrieveOrgUnit"><strong>RetrieveOrgUnit</strong></a>(self, customer_id, org_unit_path)</dt><dd><tt>Retrieve a Orgunit based on its path.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ org_unit_path: The organization's full path name.<br>
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RetrieveOrgUnitPageOfUsers"><strong>RetrieveOrgUnitPageOfUsers</strong></a>(self, customer_id, org_unit_path, startKey<font color="#909090">=None</font>)</dt><dd><tt>Retrieve one page of OrgUsers of the provided OrgUnit.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ org_unit_path: The organization's full path name.<br>
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)<br>
+ startKey: The key to continue for pagination through all OrgUsers.<br>
+ <br>
+Returns:<br>
+ A feed object containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RetrieveOrgUnitUsers"><strong>RetrieveOrgUnitUsers</strong></a>(self, customer_id, org_unit_path)</dt><dd><tt>Retrieve all OrgUsers of the provided OrgUnit.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ org_unit_path: The organization's full path name.<br>
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)<br>
+ <br>
+Returns:<br>
+ A list containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RetrieveOrgUser"><strong>RetrieveOrgUser</strong></a>(self, customer_id, user_email)</dt><dd><tt>Retrieve the OrgUnit of the user.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ user_email: The email address of the user.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RetrievePageOfOrgUnits"><strong>RetrievePageOfOrgUnits</strong></a>(self, customer_id, startKey<font color="#909090">=None</font>)</dt><dd><tt>Retrieve one page of OrgUnits in the customer's domain.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ startKey: The key to continue for pagination through all OrgUnits.<br>
+ <br>
+Returns:<br>
+ A feed object containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RetrievePageOfOrgUsers"><strong>RetrievePageOfOrgUsers</strong></a>(self, customer_id, startKey<font color="#909090">=None</font>)</dt><dd><tt>Retrieve one page of OrgUsers in the customer's domain.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ startKey: The key to continue for pagination through all OrgUnits.<br>
+ <br>
+Returns:<br>
+ A feed object containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RetrieveSubOrgUnits"><strong>RetrieveSubOrgUnits</strong></a>(self, customer_id, org_unit_path)</dt><dd><tt>Retrieve all Sub-OrgUnits of the provided OrgUnit.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ org_unit_path: The organization's full path name.<br>
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)<br>
+ <br>
+Returns:<br>
+ A list containing the result of the retrieve operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-UpdateOrgUnit"><strong>UpdateOrgUnit</strong></a>(self, customer_id, org_unit_path, name<font color="#909090">=None</font>, parent_org_unit_path<font color="#909090">=None</font>, description<font color="#909090">=None</font>, block_inheritance<font color="#909090">=None</font>)</dt><dd><tt>Update a Organization Unit.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ org_unit_path: The organization's full path name.<br>
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)<br>
+ name: The simple organization unit text name, not the full path name.<br>
+ parent_org_unit_path: The full path of the parental tree to this organization unit.<br>
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)<br>
+ description: The human readable text description of the organization unit.<br>
+ block_inheritance: This parameter blocks policy setting inheritance <br>
+ from organization units higher in the organization tree.<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-UpdateOrgUser"><strong>UpdateOrgUser</strong></a>(self, customer_id, user_email, org_unit_path)</dt><dd><tt>Update the OrgUnit of a OrgUser.<br>
+ <br>
+Args:<br>
+ customer_id: The ID of the Google Apps customer.<br>
+ user_email: The email address of the user.<br>
+ org_unit_path: The new organization's full path name.<br>
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)<br>
+ <br>
+Returns:<br>
+ A dict containing the result of the update operation.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.apps.service.html#PropertyService">gdata.apps.service.PropertyService</a>:<br>
+<dl><dt><a name="OrganizationService-AddAllElementsFromAllPages"><strong>AddAllElementsFromAllPages</strong></a>(self, link_finder, func)</dt><dd><tt>retrieve all pages and add all elements</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, domain<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='apps-apis.google.com'</font>, additional_headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="OrganizationService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt>Query the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrganizationService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#OrganizationService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#OrganizationService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#OrganizationService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="OrganizationService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="OrganizationService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>API_VER</strong> = '2.0'<br>
+<strong>BASE_UNIT_URL</strong> = '/a/feeds/orgunit/2.0/%s'<br>
+<strong>BASE_USER_URL</strong> = '/a/feeds/orguser/2.0/%s'<br>
+<strong>CUSTOMER_BASE_URL</strong> = '/a/feeds/customer/2.0/customerId'<br>
+<strong>UNIT_ALL_URL</strong> = '/a/feeds/orgunit/2.0/%s?get=all'<br>
+<strong>UNIT_CHILD_URL</strong> = '/a/feeds/orgunit/2.0/%s?get=children&orgUnitPath=%s'<br>
+<strong>UNIT_URL</strong> = '/a/feeds/orgunit/2.0/%s/%s'<br>
+<strong>USER_ALL_URL</strong> = '/a/feeds/orguser/2.0/%s?get=all'<br>
+<strong>USER_CHILD_URL</strong> = '/a/feeds/orguser/2.0/%s?get=children&orgUnitPath=%s'<br>
+<strong>USER_URL</strong> = '/a/feeds/orguser/2.0/%s/%s'<br>
+<strong>__author__</strong> = 'Alexandre Vivien (alex@simplecode.fr)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Alexandre Vivien (alex@simplecode.fr)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps.service.html b/pydocs/gdata.apps.service.html
new file mode 100644
index 0000000..27c5552
--- /dev/null
+++ b/pydocs/gdata.apps.service.html
@@ -0,0 +1,1463 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.apps.html"><font color="#ffffff">apps</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps/service.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2007 SIOS Technology, Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="xml.etree.cElementTree.html">xml.etree.cElementTree</a><br>
+</td><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.service.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.service.html#AppsForYourDomainException">AppsForYourDomainException</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps.service.html#AppsService">AppsService</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.apps.service.html#PropertyService">PropertyService</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AppsForYourDomainException">class <strong>AppsForYourDomainException</strong></a>(<a href="gdata.apps.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.service.html#AppsForYourDomainException">AppsForYourDomainException</a></dd>
+<dd><a href="gdata.apps.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AppsForYourDomainException-__init__"><strong>__init__</strong></a>(self, response)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.apps.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#AppsForYourDomainException-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="AppsForYourDomainException-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#AppsForYourDomainException-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="AppsForYourDomainException-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#AppsForYourDomainException-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="AppsForYourDomainException-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#AppsForYourDomainException-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="AppsForYourDomainException-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#AppsForYourDomainException-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="AppsForYourDomainException-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="AppsForYourDomainException-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#AppsForYourDomainException-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="AppsForYourDomainException-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#AppsForYourDomainException-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="AppsForYourDomainException-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="AppsForYourDomainException-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#AppsForYourDomainException-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="AppsForYourDomainException-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AppsService">class <strong>AppsService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Apps Provisioning service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.service.html#AppsService">AppsService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AppsService-AddAllElementsFromAllPages"><strong>AddAllElementsFromAllPages</strong></a>(self, link_finder, func)</dt><dd><tt>retrieve all pages and add all elements</tt></dd></dl>
+
+<dl><dt><a name="AppsService-AddRecipientToEmailList"><strong>AddRecipientToEmailList</strong></a>(self, recipient, list_name)</dt><dd><tt>Add a recipient to a email list.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-CreateEmailList"><strong>CreateEmailList</strong></a>(self, list_name)</dt><dd><tt>Create a email list.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-CreateNickname"><strong>CreateNickname</strong></a>(self, user_name, nickname)</dt><dd><tt>Create a nickname</tt></dd></dl>
+
+<dl><dt><a name="AppsService-CreateUser"><strong>CreateUser</strong></a>(self, user_name, family_name, given_name, password, suspended<font color="#909090">='false'</font>, quota_limit<font color="#909090">=None</font>, password_hash_function<font color="#909090">=None</font>, change_password<font color="#909090">=None</font>)</dt><dd><tt>Create a user account.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-DeleteEmailList"><strong>DeleteEmailList</strong></a>(self, list_name)</dt><dd><tt>Delete a email list</tt></dd></dl>
+
+<dl><dt><a name="AppsService-DeleteNickname"><strong>DeleteNickname</strong></a>(self, nickname)</dt><dd><tt>Delete a nickname</tt></dd></dl>
+
+<dl><dt><a name="AppsService-DeleteUser"><strong>DeleteUser</strong></a>(self, user_name)</dt><dd><tt>Delete a user account</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetGeneratorForAllEmailLists"><strong>GetGeneratorForAllEmailLists</strong></a>(self, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve a generator for all emaillists in this domain.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetGeneratorForAllNicknames"><strong>GetGeneratorForAllNicknames</strong></a>(self, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve a generator for all nicknames in this domain.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetGeneratorForAllNicknamesOfAUser"><strong>GetGeneratorForAllNicknamesOfAUser</strong></a>(self, user_name, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve a generator for all nicknames of a particular user.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetGeneratorForAllRecipients"><strong>GetGeneratorForAllRecipients</strong></a>(self, list_name, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve a generator for all recipients of a particular emaillist.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetGeneratorForAllUsers"><strong>GetGeneratorForAllUsers</strong></a>(self, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve a generator for all users in this domain.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RemoveRecipientFromEmailList"><strong>RemoveRecipientFromEmailList</strong></a>(self, recipient, list_name)</dt><dd><tt>Remove recipient from email list.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RestoreUser"><strong>RestoreUser</strong></a>(self, user_name)</dt></dl>
+
+<dl><dt><a name="AppsService-RetrieveAllEmailLists"><strong>RetrieveAllEmailLists</strong></a>(self)</dt><dd><tt>Retrieve all email list of a domain.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrieveAllNicknames"><strong>RetrieveAllNicknames</strong></a>(self)</dt><dd><tt>Retrieve all nicknames in the domain</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrieveAllRecipients"><strong>RetrieveAllRecipients</strong></a>(self, list_name)</dt><dd><tt>Retrieve all recipient of an email list.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrieveAllUsers"><strong>RetrieveAllUsers</strong></a>(self)</dt><dd><tt>Retrieve all users in this domain. OBSOLETE</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrieveEmailList"><strong>RetrieveEmailList</strong></a>(self, list_name)</dt><dd><tt>Retreive a single email list by the list's name.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrieveEmailLists"><strong>RetrieveEmailLists</strong></a>(self, recipient)</dt><dd><tt>Retrieve All Email List Subscriptions for an Email Address.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrieveNickname"><strong>RetrieveNickname</strong></a>(self, nickname)</dt><dd><tt>Retrieve a nickname.<br>
+ <br>
+Args:<br>
+ nickname: string The nickname to retrieve<br>
+ <br>
+Returns:<br>
+ gdata.apps.NicknameEntry</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrieveNicknames"><strong>RetrieveNicknames</strong></a>(self, user_name)</dt><dd><tt>Retrieve nicknames of the user</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrievePageOfEmailLists"><strong>RetrievePageOfEmailLists</strong></a>(self, start_email_list_name<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve one page of email list</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrievePageOfNicknames"><strong>RetrievePageOfNicknames</strong></a>(self, start_nickname<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve one page of nicknames in the domain</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrievePageOfRecipients"><strong>RetrievePageOfRecipients</strong></a>(self, list_name, start_recipient<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve one page of recipient of an email list.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrievePageOfUsers"><strong>RetrievePageOfUsers</strong></a>(self, start_username<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>Retrieve one page of users in this domain.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RetrieveUser"><strong>RetrieveUser</strong></a>(self, user_name)</dt><dd><tt>Retrieve an user account.<br>
+ <br>
+Args:<br>
+ user_name: string The user name to retrieve<br>
+ <br>
+Returns:<br>
+ gdata.apps.UserEntry</tt></dd></dl>
+
+<dl><dt><a name="AppsService-SuspendUser"><strong>SuspendUser</strong></a>(self, user_name)</dt></dl>
+
+<dl><dt><a name="AppsService-UpdateUser"><strong>UpdateUser</strong></a>(self, user_name, user_entry)</dt><dd><tt>Update a user account.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, domain<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='apps-apis.google.com'</font>, additional_headers<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a client for the Google Apps Provisioning service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ domain: string (optional) The Google Apps domain name.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'apps-apis.google.com'.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="AppsService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="AppsService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="AppsService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt>Query the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#AppsService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AppsService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AppsService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ <a href="#Error">Error</a> if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="AppsService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="AppsService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#AppsService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#AppsService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="AppsService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="AppsService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="AppsService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PropertyService">class <strong>PropertyService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Apps Property service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps.service.html#PropertyService">PropertyService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PropertyService-AddAllElementsFromAllPages"><strong>AddAllElementsFromAllPages</strong></a>(self, link_finder, func)</dt><dd><tt>retrieve all pages and add all elements</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, domain<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='apps-apis.google.com'</font>, additional_headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="PropertyService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt>Query the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PropertyService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#PropertyService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ <a href="#Error">Error</a> if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#PropertyService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#PropertyService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="PropertyService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="PropertyService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>API_VER</strong> = '2.0'<br>
+<strong>DEFAULT_QUOTA_LIMIT</strong> = '2048'<br>
+<strong>DOMAIN_ALIAS_LIMIT_EXCEEDED</strong> = 1201<br>
+<strong>DOMAIN_FEATURE_UNAVAILABLE</strong> = 1203<br>
+<strong>DOMAIN_SUSPENDED</strong> = 1202<br>
+<strong>DOMAIN_USER_LIMIT_EXCEEDED</strong> = 1200<br>
+<strong>ENTITY_DOES_NOT_EXIST</strong> = 1301<br>
+<strong>ENTITY_EXISTS</strong> = 1300<br>
+<strong>ENTITY_NAME_IS_RESERVED</strong> = 1302<br>
+<strong>ENTITY_NAME_NOT_VALID</strong> = 1303<br>
+<strong>HTTP_OK</strong> = 200<br>
+<strong>INVALID_EMAIL_ADDRESS</strong> = 1406<br>
+<strong>INVALID_FAMILY_NAME</strong> = 1401<br>
+<strong>INVALID_GIVEN_NAME</strong> = 1400<br>
+<strong>INVALID_HASH_DIGGEST_LENGTH</strong> = 1405<br>
+<strong>INVALID_HASH_FUNCTION_NAME</strong> = 1404<br>
+<strong>INVALID_PASSWORD</strong> = 1402<br>
+<strong>INVALID_QUERY_PARAMETER_VALUE</strong> = 1407<br>
+<strong>INVALID_USERNAME</strong> = 1403<br>
+<strong>TOO_MANY_RECIPIENTS_ON_EMAIL_LIST</strong> = 1500<br>
+<strong>UNKOWN_ERROR</strong> = 1000<br>
+<strong>USER_DELETED_RECENTLY</strong> = 1100<br>
+<strong>USER_SUSPENDED</strong> = 1101<br>
+<strong>__author__</strong> = 'tmatsuo@sios.com (Takashi MATSUO)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">tmatsuo@sios.com (Takashi MATSUO)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.apps_property.html b/pydocs/gdata.apps_property.html
new file mode 100644
index 0000000..8b42b64
--- /dev/null
+++ b/pydocs/gdata.apps_property.html
@@ -0,0 +1,207 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.apps_property</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.apps_property</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps_property.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/apps_property.py</a></font></td></tr></table>
+ <p><tt>Provides a base class to represent property elements in feeds.<br>
+ <br>
+This module is used for version 2 of the Google Data APIs. The primary class<br>
+in this module is <a href="#AppsProperty">AppsProperty</a>.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.apps_property.html#AppsProperty">AppsProperty</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AppsProperty">class <strong>AppsProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an <apps:property> element in a feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.apps_property.html#AppsProperty">AppsProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AppsProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AppsProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AppsProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AppsProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AppsProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AppsProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AppsProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AppsProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AppsProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AppsProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'Vic Fryzel <vicfryzel@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Vic Fryzel <vicfryzel@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.auth.html b/pydocs/gdata.auth.html
new file mode 100644
index 0000000..abe30d3
--- /dev/null
+++ b/pydocs/gdata.auth.html
@@ -0,0 +1,744 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.auth</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.auth</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/auth.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/auth.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2007 - 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+<a href="cgi.html">cgi</a><br>
+<a href="gdata.tlslite.utils.cryptomath.html">gdata.tlslite.utils.cryptomath</a><br>
+<a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.utils.keyfactory.html">gdata.tlslite.utils.keyfactory</a><br>
+<a href="math.html">math</a><br>
+<a href="gdata.oauth.html">gdata.oauth</a><br>
+<a href="gdata.oauth.rsa.html">gdata.oauth.rsa</a><br>
+</td><td width="25%" valign=top><a href="random.html">random</a><br>
+<a href="re.html">re</a><br>
+<a href="time.html">time</a><br>
+<a href="types.html">types</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.auth.html#OAuthInputParams">OAuthInputParams</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.auth.html#OAuthSignatureMethod">OAuthSignatureMethod</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.auth.html#ClientLoginToken">ClientLoginToken</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.auth.html#AuthSubToken">AuthSubToken</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.auth.html#SecureAuthSubToken">SecureAuthSubToken</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.auth.html#OAuthToken">OAuthToken</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AuthSubToken">class <strong>AuthSubToken</strong></a>(<a href="gdata.auth.html#ClientLoginToken">ClientLoginToken</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.auth.html#AuthSubToken">AuthSubToken</a></dd>
+<dd><a href="gdata.auth.html#ClientLoginToken">ClientLoginToken</a></dd>
+<dd><a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AuthSubToken-get_token_string"><strong>get_token_string</strong></a>(self)</dt><dd><tt>Removes AUTHSUB_AUTH_LABEL to give just the token value.</tt></dd></dl>
+
+<dl><dt><a name="AuthSubToken-set_token_string"><strong>set_token_string</strong></a>(self, token_string)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.auth.html#ClientLoginToken">ClientLoginToken</a>:<br>
+<dl><dt><a name="AuthSubToken-__init__"><strong>__init__</strong></a>(self, auth_header<font color="#909090">=None</font>, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AuthSubToken-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AuthSubToken-perform_request"><strong>perform_request</strong></a>(self, http_client, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Sets the Authorization header and makes the HTTP request.</tt></dd></dl>
+
+<dl><dt><a name="AuthSubToken-valid_for_scope"><strong>valid_for_scope</strong></a>(self, url)</dt><dd><tt>Tells the caller if the token authorizes access to the desired URL.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ClientLoginToken">class <strong>ClientLoginToken</strong></a>(<a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Stores the Authorization header in auth_header and adds to requests.<br>
+ <br>
+This token will add it's Authorization header to an HTTP request<br>
+as it is made. Ths token class is simple but<br>
+some Token classes must calculate portions of the Authorization header<br>
+based on the request being made, which is why the token is responsible<br>
+for making requests via an http_client parameter.<br>
+ <br>
+Args:<br>
+ auth_header: str The value for the Authorization header.<br>
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs<br>
+ for which this token can be used. For example, if scopes contains<br>
+ '<a href="http://example.com/foo">http://example.com/foo</a>', then this token can be used for a request to<br>
+ '<a href="http://example.com/foo/bar">http://example.com/foo/bar</a>' but it cannot be used for a request to<br>
+ '<a href="http://example.com/baz">http://example.com/baz</a>'<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.auth.html#ClientLoginToken">ClientLoginToken</a></dd>
+<dd><a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ClientLoginToken-__init__"><strong>__init__</strong></a>(self, auth_header<font color="#909090">=None</font>, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ClientLoginToken-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientLoginToken-get_token_string"><strong>get_token_string</strong></a>(self)</dt><dd><tt>Removes PROGRAMMATIC_AUTH_LABEL to give just the token value.</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginToken-perform_request"><strong>perform_request</strong></a>(self, http_client, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Sets the Authorization header and makes the HTTP request.</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginToken-set_token_string"><strong>set_token_string</strong></a>(self, token_string)</dt></dl>
+
+<dl><dt><a name="ClientLoginToken-valid_for_scope"><strong>valid_for_scope</strong></a>(self, url)</dt><dd><tt>Tells the caller if the token authorizes access to the desired URL.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthInputParams">class <strong>OAuthInputParams</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Stores OAuth input parameters.<br>
+ <br>
+This class is a store for OAuth input parameters viz. consumer key and secret,<br>
+signature method and RSA key.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="OAuthInputParams-GetConsumer"><strong>GetConsumer</strong></a>(self)</dt><dd><tt>Gets the OAuth consumer.<br>
+ <br>
+Returns:<br>
+ <a href="__builtin__.html#object">object</a> of type <oauth.oauth.Consumer></tt></dd></dl>
+
+<dl><dt><a name="OAuthInputParams-GetSignatureMethod"><strong>GetSignatureMethod</strong></a>(self)</dt><dd><tt>Gets the OAuth signature method.<br>
+ <br>
+Returns:<br>
+ <a href="__builtin__.html#object">object</a> of supertype <oauth.oauth.<a href="#OAuthSignatureMethod">OAuthSignatureMethod</a>></tt></dd></dl>
+
+<dl><dt><a name="OAuthInputParams-__init__"><strong>__init__</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Initializes <a href="__builtin__.html#object">object</a> with parameters required for using OAuth mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.<a href="#OAuthSignatureMethod">OAuthSignatureMethod</a>. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.<a href="#OAuthSignatureMethod">OAuthSignatureMethod</a>. Currently<br>
+ they are gdata.auth.<a href="#OAuthSignatureMethod">OAuthSignatureMethod</a>.RSA_SHA1 and<br>
+ gdata.auth.<a href="#OAuthSignatureMethod">OAuthSignatureMethod</a>.HMAC_SHA1. Instead of passing in<br>
+ the strategy class, you may pass in a string for 'RSA_SHA1' or <br>
+ 'HMAC_SHA1'. If you plan to use OAuth on App Engine (or another<br>
+ WSGI environment) I recommend specifying signature method using a<br>
+ string (the only options are 'RSA_SHA1' and 'HMAC_SHA1'). In these<br>
+ environments there are sometimes issues with pickling an <a href="__builtin__.html#object">object</a> in <br>
+ which a member references a class or function. Storing a string to<br>
+ refer to the signature method mitigates complications when<br>
+ pickling.<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when performing<br>
+ 2 legged OAuth requests.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthSignatureMethod">class <strong>OAuthSignatureMethod</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Holds valid OAuth signature methods.<br>
+ <br>
+RSA_SHA1: Class to build signature according to RSA-SHA1 algorithm.<br>
+HMAC_SHA1: Class to build signature according to HMAC-SHA1 algorithm.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>HMAC_SHA1</strong> = <class 'gdata.oauth.OAuthSignatureMethod_HMAC_SHA1'></dl>
+
+<dl><dt><strong>RSA_SHA1</strong> = <class 'gdata.auth.RSA_SHA1'><dd><tt>Provides implementation for abstract methods to return RSA certs.</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthToken">class <strong>OAuthToken</strong></a>(<a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Stores the token key, token secret and scopes for which token is valid.<br>
+ <br>
+This token adds the authorization header to each request made. It<br>
+re-calculates authorization header for every request since the OAuth<br>
+signature to be added to the authorization header is dependent on the<br>
+request parameters.<br>
+ <br>
+Attributes:<br>
+ key: str The value for the OAuth token i.e. token key.<br>
+ secret: str The value for the OAuth token secret.<br>
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs<br>
+ for which this token can be used. For example, if scopes contains<br>
+ '<a href="http://example.com/foo">http://example.com/foo</a>', then this token can be used for a request to<br>
+ '<a href="http://example.com/foo/bar">http://example.com/foo/bar</a>' but it cannot be used for a request to<br>
+ '<a href="http://example.com/baz">http://example.com/baz</a>'<br>
+ oauth_input_params: <a href="#OAuthInputParams">OAuthInputParams</a> OAuth input parameters.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.auth.html#OAuthToken">OAuthToken</a></dd>
+<dd><a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OAuthToken-GetAuthHeader"><strong>GetAuthHeader</strong></a>(self, http_method, http_url, realm<font color="#909090">=''</font>)</dt><dd><tt>Get the authentication header.<br>
+ <br>
+Args:<br>
+ http_method: string HTTP method i.e. operation e.g. GET, POST, PUT, etc.<br>
+ http_url: string or atom.url.Url HTTP URL to which request is made.<br>
+ realm: string (default='') realm parameter to be included in the<br>
+ authorization header.<br>
+ <br>
+Returns:<br>
+ dict Header to be sent with every subsequent request after<br>
+ authentication.</tt></dd></dl>
+
+<dl><dt><a name="OAuthToken-__init__"><strong>__init__</strong></a>(self, key<font color="#909090">=None</font>, secret<font color="#909090">=None</font>, scopes<font color="#909090">=None</font>, oauth_input_params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OAuthToken-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OAuthToken-get_token_string"><strong>get_token_string</strong></a>(self)</dt><dd><tt>Returns the token string.<br>
+ <br>
+The token string returned is of format<br>
+oauth_token=[0]&oauth_token_secret=[1], where [0] and [1] are some strings.<br>
+ <br>
+Returns:<br>
+ A token string of format oauth_token=[0]&oauth_token_secret=[1],<br>
+ where [0] and [1] are some strings. If self.<strong>secret</strong> is absent, it just<br>
+ returns oauth_token=[0]. If self.<strong>key</strong> is absent, it just returns<br>
+ oauth_token_secret=[1]. If both are absent, it returns None.</tt></dd></dl>
+
+<dl><dt><a name="OAuthToken-perform_request"><strong>perform_request</strong></a>(self, http_client, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Sets the Authorization header and makes the HTTP request.</tt></dd></dl>
+
+<dl><dt><a name="OAuthToken-set_token_string"><strong>set_token_string</strong></a>(self, token_string)</dt><dd><tt>Sets the token key and secret from the token string.<br>
+ <br>
+Args:<br>
+ token_string: str Token string of form<br>
+ oauth_token=[0]&oauth_token_secret=[1]. If oauth_token is not present,<br>
+ self.<strong>key</strong> will be None. If oauth_token_secret is not present,<br>
+ self.<strong>secret</strong> will be None.</tt></dd></dl>
+
+<dl><dt><a name="OAuthToken-valid_for_scope"><strong>valid_for_scope</strong></a>(self, url)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SecureAuthSubToken">class <strong>SecureAuthSubToken</strong></a>(<a href="gdata.auth.html#AuthSubToken">AuthSubToken</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Stores the rsa private key, token, and scopes for the secure AuthSub token.<br>
+ <br>
+This token adds the authorization header to each request made. It<br>
+re-calculates authorization header for every request since the secure AuthSub<br>
+signature to be added to the authorization header is dependent on the<br>
+request parameters.<br>
+ <br>
+Attributes:<br>
+ rsa_key: string The RSA private key in PEM format that the token will<br>
+ use to sign requests<br>
+ token_string: string (optional) The value for the AuthSub token.<br>
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs<br>
+ for which this token can be used. For example, if scopes contains<br>
+ '<a href="http://example.com/foo">http://example.com/foo</a>', then this token can be used for a request to<br>
+ '<a href="http://example.com/foo/bar">http://example.com/foo/bar</a>' but it cannot be used for a request to<br>
+ '<a href="http://example.com/baz">http://example.com/baz</a>'<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.auth.html#SecureAuthSubToken">SecureAuthSubToken</a></dd>
+<dd><a href="gdata.auth.html#AuthSubToken">AuthSubToken</a></dd>
+<dd><a href="gdata.auth.html#ClientLoginToken">ClientLoginToken</a></dd>
+<dd><a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SecureAuthSubToken-GetAuthHeader"><strong>GetAuthHeader</strong></a>(self, http_method, http_url)</dt><dd><tt>Generates the Authorization header.<br>
+ <br>
+The form of the secure AuthSub Authorization header is<br>
+Authorization: AuthSub token="token" sigalg="sigalg" data="data" sig="sig"<br>
+and data represents a string in the form<br>
+data = http_method http_url timestamp nonce<br>
+ <br>
+Args:<br>
+ http_method: string HTTP method i.e. operation e.g. GET, POST, PUT, etc.<br>
+ http_url: string or atom.url.Url HTTP URL to which request is made.<br>
+ <br>
+Returns:<br>
+ dict Header to be sent with every subsequent request after authentication.</tt></dd></dl>
+
+<dl><dt><a name="SecureAuthSubToken-__init__"><strong>__init__</strong></a>(self, rsa_key, token_string<font color="#909090">=None</font>, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="SecureAuthSubToken-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SecureAuthSubToken-get_token_string"><strong>get_token_string</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SecureAuthSubToken-perform_request"><strong>perform_request</strong></a>(self, http_client, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Sets the Authorization header and makes the HTTP request.</tt></dd></dl>
+
+<dl><dt><a name="SecureAuthSubToken-set_token_string"><strong>set_token_string</strong></a>(self, token_string)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.auth.html#ClientLoginToken">ClientLoginToken</a>:<br>
+<dl><dt><a name="SecureAuthSubToken-valid_for_scope"><strong>valid_for_scope</strong></a>(self, url)</dt><dd><tt>Tells the caller if the token authorizes access to the desired URL.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#GenericToken">atom.http_interface.GenericToken</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-AuthSubTokenFromHttpBody"><strong>AuthSubTokenFromHttpBody</strong></a>(http_body)</dt><dd><tt>Extracts the AuthSub token from an HTTP body string.<br>
+ <br>
+Used to find the new session token after making a request to upgrade a<br>
+single use AuthSub token.<br>
+ <br>
+Args:<br>
+ http_body: str The repsonse from the server which contains the AuthSub<br>
+ key. For example, this function would find the new session token<br>
+ from the server's response to an upgrade token request.<br>
+ <br>
+Returns:<br>
+ The header value to use for Authorization which contains the AuthSub<br>
+ token.</tt></dd></dl>
+ <dl><dt><a name="-AuthSubTokenFromUrl"><strong>AuthSubTokenFromUrl</strong></a>(url)</dt><dd><tt>Extracts the AuthSub token from the URL. <br>
+ <br>
+Used after the AuthSub redirect has sent the user to the 'next' page and<br>
+appended the token to the URL. This function returns the value to be used<br>
+in the Authorization header. <br>
+ <br>
+Args:<br>
+ url: str The URL of the current page which contains the AuthSub token as<br>
+ a URL parameter.</tt></dd></dl>
+ <dl><dt><a name="-GenerateAuthSubUrl"><strong>GenerateAuthSubUrl</strong></a>(next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRequest'</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a><br>
+ <br>
+Args:<br>
+ request_url: str The beginning of the request URL. This is normally<br>
+ '<a href="http://www.google.com/accounts/AuthSubRequest">http://www.google.com/accounts/AuthSubRequest</a>' or <br>
+ '/accounts/AuthSubRequest'<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string The URL of the service to be accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.<br>
+ domain: str (optional) The Google Apps domain for this account. If this<br>
+ is not a Google Apps account, use 'default' which is the default<br>
+ value.</tt></dd></dl>
+ <dl><dt><a name="-GenerateClientLoginAuthToken"><strong>GenerateClientLoginAuthToken</strong></a>(http_body)</dt><dd><tt>Returns the token value to use in Authorization headers.<br>
+ <br>
+Reads the token from the server's response to a Client Login request and<br>
+creates header value to use in requests.<br>
+ <br>
+Args:<br>
+ http_body: str The body of the server's HTTP response to a Client Login<br>
+ request<br>
+ <br>
+Returns:<br>
+ The value half of an Authorization header.</tt></dd></dl>
+ <dl><dt><a name="-GenerateClientLoginRequestBody"><strong>GenerateClientLoginRequestBody</strong></a> = generate_client_login_request_body(email, password, service, source, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Creates the body of the autentication request<br>
+ <br>
+See <a href="http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request">http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request</a><br>
+for more details.<br>
+ <br>
+Args:<br>
+ email: str<br>
+ password: str<br>
+ service: str<br>
+ source: str<br>
+ account_type: str (optional) Defaul is 'HOSTED_OR_GOOGLE', other valid<br>
+ values are 'GOOGLE' and 'HOSTED'<br>
+ captcha_token: str (optional)<br>
+ captcha_response: str (optional)<br>
+ <br>
+Returns:<br>
+ The HTTP body to send in a request for a client login token.</tt></dd></dl>
+ <dl><dt><a name="-GenerateOAuthAccessTokenUrl"><strong>GenerateOAuthAccessTokenUrl</strong></a>(authorized_request_token, oauth_input_params, access_token_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.<a href="#OAuthToken">OAuthToken</a> OAuth authorized request<br>
+ token.<br>
+ oauth_input_params: <a href="#OAuthInputParams">OAuthInputParams</a> OAuth input parameters. <br>
+ access_token_url: string The beginning of the authorization URL. This is<br>
+ normally 'https://www.google.com/accounts/OAuthGetAccessToken' or<br>
+ '/accounts/OAuthGetAccessToken'<br>
+ oauth_version: str (default='1.0') oauth_version parameter.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ atom.url.Url OAuth access token URL.</tt></dd></dl>
+ <dl><dt><a name="-GenerateOAuthAuthorizationUrl"><strong>GenerateOAuthAuthorizationUrl</strong></a>(request_token, authorization_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.<a href="#OAuthToken">OAuthToken</a> OAuth request token.<br>
+ authorization_url: string The beginning of the authorization URL. This is<br>
+ normally 'https://www.google.com/accounts/OAuthAuthorizeToken' or<br>
+ '/accounts/OAuthAuthorizeToken'<br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ <br>
+Returns:<br>
+ atom.url.Url OAuth authorization URL.</tt></dd></dl>
+ <dl><dt><a name="-GenerateOAuthRequestTokenUrl"><strong>GenerateOAuthRequestTokenUrl</strong></a>(oauth_input_params, scopes, request_token_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, extra_parameters<font color="#909090">=None</font>)</dt><dd><tt>Generate a URL at which a request for OAuth request token is to be sent.<br>
+ <br>
+Args:<br>
+ oauth_input_params: <a href="#OAuthInputParams">OAuthInputParams</a> OAuth input parameters.<br>
+ scopes: list of strings The URLs of the services to be accessed.<br>
+ request_token_url: string The beginning of the request token URL. This is<br>
+ normally 'https://www.google.com/accounts/OAuthGetRequestToken' or<br>
+ '/accounts/OAuthGetRequestToken'<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ <br>
+Returns:<br>
+ atom.url.Url OAuth request token URL.</tt></dd></dl>
+ <dl><dt><a name="-GetCaptchaChallenge"><strong>GetCaptchaChallenge</strong></a> = get_captcha_challenge(http_body, captcha_base_url<font color="#909090">='http://www.google.com/accounts/'</font>)</dt><dd><tt>Returns the URL and token for a CAPTCHA challenge issued by the server.<br>
+ <br>
+Args:<br>
+ http_body: str The body of the HTTP response from the server which <br>
+ contains the CAPTCHA challenge.<br>
+ captcha_base_url: str This function returns a full URL for viewing the <br>
+ challenge image which is built from the server's response. This<br>
+ base_url is used as the beginning of the URL because the server<br>
+ only provides the end of the URL. For example the server provides<br>
+ 'Captcha?ctoken=Hi...N' and the URL for the image is<br>
+ '<a href="http://www.google.com/accounts/Captcha?ctoken=Hi...N">http://www.google.com/accounts/Captcha?ctoken=Hi...N</a>'<br>
+ <br>
+Returns:<br>
+ A dictionary containing the information needed to repond to the CAPTCHA<br>
+ challenge, the image URL and the ID token of the challenge. The <br>
+ dictionary is in the form:<br>
+ {'token': string identifying the CAPTCHA image,<br>
+ 'url': string containing the URL of the image}<br>
+ Returns None if there was no CAPTCHA challenge in the response.</tt></dd></dl>
+ <dl><dt><a name="-OAuthTokenFromHttpBody"><strong>OAuthTokenFromHttpBody</strong></a>(http_body)</dt><dd><tt>Parses the HTTP response body and returns an OAuth token.<br>
+ <br>
+The returned OAuth token will just have key and secret parameters set.<br>
+It won't have any knowledge about the scopes or oauth_input_params. It is<br>
+your responsibility to make it aware of the remaining parameters.<br>
+ <br>
+Returns:<br>
+ <a href="#OAuthToken">OAuthToken</a> OAuth token.</tt></dd></dl>
+ <dl><dt><a name="-OAuthTokenFromUrl"><strong>OAuthTokenFromUrl</strong></a>(url, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>)</dt><dd><tt>Creates an <a href="#OAuthToken">OAuthToken</a> and sets token key and scopes (if present) from URL.<br>
+ <br>
+After the Google Accounts OAuth pages redirect the user's broswer back to <br>
+the web application (using the 'callback' URL from the request) the web app<br>
+can extract the token from the current page's URL. The token is same as the<br>
+request token, but it is either authorized (if user grants access) or<br>
+unauthorized (if user denies access). The token is provided as a <br>
+URL parameter named 'oauth_token' and if it was chosen to use<br>
+GenerateOAuthAuthorizationUrl with include_scopes_in_param=True, the token's<br>
+valid scopes are included in a URL parameter whose name is specified in<br>
+scopes_param_prefix.<br>
+ <br>
+Args:<br>
+ url: atom.url.Url or str representing the current URL. The token value<br>
+ and valid scopes should be included as URL parameters.<br>
+ scopes_param_prefix: str (optional) The URL parameter key which maps to<br>
+ the list of valid scopes for the token.<br>
+ <br>
+Returns:<br>
+ An <a href="#OAuthToken">OAuthToken</a> with the token key from the URL and set to be valid for<br>
+ the scopes passed in on the URL. If no scopes were included in the URL,<br>
+ the <a href="#OAuthToken">OAuthToken</a> defaults to being valid for no scopes. If there was no<br>
+ 'oauth_token' parameter in the URL, this function returns None.</tt></dd></dl>
+ <dl><dt><a name="-TokenFromHttpBody"><strong>TokenFromHttpBody</strong></a> = token_from_http_body(http_body)</dt><dd><tt>Extracts the AuthSub token from an HTTP body string.<br>
+ <br>
+Used to find the new session token after making a request to upgrade a <br>
+single use AuthSub token.<br>
+ <br>
+Args:<br>
+ http_body: str The repsonse from the server which contains the AuthSub <br>
+ key. For example, this function would find the new session token<br>
+ from the server's response to an upgrade token request.<br>
+ <br>
+Returns:<br>
+ The raw token value to use in an <a href="#AuthSubToken">AuthSubToken</a> <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+ <dl><dt><a name="-TokenFromUrl"><strong>TokenFromUrl</strong></a>(url)</dt><dd><tt>Extracts the AuthSub token from the URL.<br>
+ <br>
+Returns the raw token value.<br>
+ <br>
+Args:<br>
+ url: str The URL or the query portion of the URL string (after the ?) of<br>
+ the current page which contains the AuthSub token as a URL parameter.</tt></dd></dl>
+ <dl><dt><a name="-extract_auth_sub_token_from_url"><strong>extract_auth_sub_token_from_url</strong></a>(url, scopes_param_prefix<font color="#909090">='auth_sub_scopes'</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Creates an <a href="#AuthSubToken">AuthSubToken</a> and sets the token value and scopes from the URL.<br>
+ <br>
+After the Google Accounts AuthSub pages redirect the user's broswer back to <br>
+the web application (using the 'next' URL from the request) the web app must<br>
+extract the token from the current page's URL. The token is provided as a <br>
+URL parameter named 'token' and if generate_auth_sub_url was used to create<br>
+the request, the token's valid scopes are included in a URL parameter whose<br>
+name is specified in scopes_param_prefix.<br>
+ <br>
+Args:<br>
+ url: atom.url.Url or str representing the current URL. The token value<br>
+ and valid scopes should be included as URL parameters.<br>
+ scopes_param_prefix: str (optional) The URL parameter key which maps to<br>
+ the list of valid scopes for the token.<br>
+ <br>
+Returns:<br>
+ An <a href="#AuthSubToken">AuthSubToken</a> with the token value from the URL and set to be valid for<br>
+ the scopes passed in on the URL. If no scopes were included in the URL,<br>
+ the <a href="#AuthSubToken">AuthSubToken</a> defaults to being valid for no scopes. If there was no<br>
+ 'token' parameter in the URL, this function returns None.</tt></dd></dl>
+ <dl><dt><a name="-extract_client_login_token"><strong>extract_client_login_token</strong></a>(http_body, scopes)</dt><dd><tt>Parses the server's response and returns a <a href="#ClientLoginToken">ClientLoginToken</a>.<br>
+ <br>
+Args:<br>
+ http_body: str The body of the server's HTTP response to a Client Login<br>
+ request. It is assumed that the login request was successful.<br>
+ scopes: list containing atom.url.Urls or strs. The scopes list contains<br>
+ all of the partial URLs under which the client login token is<br>
+ valid. For example, if scopes contains ['<a href="http://example.com/foo">http://example.com/foo</a>']<br>
+ then the client login token would be valid for <br>
+ <a href="http://example.com/foo/bar/baz">http://example.com/foo/bar/baz</a><br>
+ <br>
+Returns:<br>
+ A <a href="#ClientLoginToken">ClientLoginToken</a> which is valid for the specified scopes.</tt></dd></dl>
+ <dl><dt><a name="-generate_auth_sub_url"><strong>generate_auth_sub_url</strong></a>(next, scopes, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRequest'</font>, domain<font color="#909090">='default'</font>, scopes_param_prefix<font color="#909090">='auth_sub_scopes'</font>)</dt><dd><tt>Constructs a URL string for requesting a multiscope AuthSub token.<br>
+ <br>
+The generated token will contain a URL parameter to pass along the <br>
+requested scopes to the next URL. When the Google Accounts page <br>
+redirects the broswser to the 'next' URL, it appends the single use<br>
+AuthSub token value to the URL as a URL parameter with the key 'token'.<br>
+However, the information about which scopes were requested is not<br>
+included by Google Accounts. This method adds the scopes to the next<br>
+URL before making the request so that the redirect will be sent to <br>
+a page, and both the token value and the list of scopes can be <br>
+extracted from the request URL. <br>
+ <br>
+Args:<br>
+ next: atom.url.URL or string The URL user will be sent to after<br>
+ authorizing this web application to access their data.<br>
+ scopes: list containint strings The URLs of the services to be accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.<br>
+ request_url: atom.url.Url or str The beginning of the request URL. This<br>
+ is normally '<a href="http://www.google.com/accounts/AuthSubRequest">http://www.google.com/accounts/AuthSubRequest</a>' or <br>
+ '/accounts/AuthSubRequest'<br>
+ domain: The domain which the account is part of. This is used for Google<br>
+ Apps accounts, the default value is 'default' which means that the<br>
+ requested account is a Google Account (@gmail.com for example)<br>
+ scopes_param_prefix: str (optional) The requested scopes are added as a <br>
+ URL parameter to the next URL so that the page at the 'next' URL can<br>
+ extract the token value and the valid scopes from the URL. The key<br>
+ for the URL parameter defaults to 'auth_sub_scopes'<br>
+ <br>
+Returns:<br>
+ An atom.url.Url which the user's browser should be directed to in order<br>
+ to authorize this application to access their information.</tt></dd></dl>
+ <dl><dt><a name="-generate_client_login_request_body"><strong>generate_client_login_request_body</strong></a>(email, password, service, source, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Creates the body of the autentication request<br>
+ <br>
+See <a href="http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request">http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request</a><br>
+for more details.<br>
+ <br>
+Args:<br>
+ email: str<br>
+ password: str<br>
+ service: str<br>
+ source: str<br>
+ account_type: str (optional) Defaul is 'HOSTED_OR_GOOGLE', other valid<br>
+ values are 'GOOGLE' and 'HOSTED'<br>
+ captcha_token: str (optional)<br>
+ captcha_response: str (optional)<br>
+ <br>
+Returns:<br>
+ The HTTP body to send in a request for a client login token.</tt></dd></dl>
+ <dl><dt><a name="-get_captcha_challenge"><strong>get_captcha_challenge</strong></a>(http_body, captcha_base_url<font color="#909090">='http://www.google.com/accounts/'</font>)</dt><dd><tt>Returns the URL and token for a CAPTCHA challenge issued by the server.<br>
+ <br>
+Args:<br>
+ http_body: str The body of the HTTP response from the server which <br>
+ contains the CAPTCHA challenge.<br>
+ captcha_base_url: str This function returns a full URL for viewing the <br>
+ challenge image which is built from the server's response. This<br>
+ base_url is used as the beginning of the URL because the server<br>
+ only provides the end of the URL. For example the server provides<br>
+ 'Captcha?ctoken=Hi...N' and the URL for the image is<br>
+ '<a href="http://www.google.com/accounts/Captcha?ctoken=Hi...N">http://www.google.com/accounts/Captcha?ctoken=Hi...N</a>'<br>
+ <br>
+Returns:<br>
+ A dictionary containing the information needed to repond to the CAPTCHA<br>
+ challenge, the image URL and the ID token of the challenge. The <br>
+ dictionary is in the form:<br>
+ {'token': string identifying the CAPTCHA image,<br>
+ 'url': string containing the URL of the image}<br>
+ Returns None if there was no CAPTCHA challenge in the response.</tt></dd></dl>
+ <dl><dt><a name="-get_client_login_token"><strong>get_client_login_token</strong></a>(http_body)</dt><dd><tt>Returns the token value for a <a href="#ClientLoginToken">ClientLoginToken</a>.<br>
+ <br>
+Reads the token from the server's response to a Client Login request and<br>
+creates the token value string to use in requests.<br>
+ <br>
+Args:<br>
+ http_body: str The body of the server's HTTP response to a Client Login<br>
+ request<br>
+ <br>
+Returns:<br>
+ The token value string for a <a href="#ClientLoginToken">ClientLoginToken</a>.</tt></dd></dl>
+ <dl><dt><a name="-token_from_http_body"><strong>token_from_http_body</strong></a>(http_body)</dt><dd><tt>Extracts the AuthSub token from an HTTP body string.<br>
+ <br>
+Used to find the new session token after making a request to upgrade a <br>
+single use AuthSub token.<br>
+ <br>
+Args:<br>
+ http_body: str The repsonse from the server which contains the AuthSub <br>
+ key. For example, this function would find the new session token<br>
+ from the server's response to an upgrade token request.<br>
+ <br>
+Returns:<br>
+ The raw token value to use in an <a href="#AuthSubToken">AuthSubToken</a> <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>AUTHSUB_AUTH_LABEL</strong> = 'AuthSub token='<br>
+<strong>PROGRAMMATIC_AUTH_LABEL</strong> = 'GoogleLogin auth='<br>
+<strong>__author__</strong> = 'api.jscudder (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.blogger.client.html b/pydocs/gdata.blogger.client.html
new file mode 100644
index 0000000..7c94517
--- /dev/null
+++ b/pydocs/gdata.blogger.client.html
@@ -0,0 +1,673 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.blogger.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.blogger.html"><font color="#ffffff">blogger</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/blogger/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/blogger/client.py</a></font></td></tr></table>
+ <p><tt>Contains a client to communicate with the Blogger servers.<br>
+ <br>
+For documentation on the Blogger API, see:<br>
+<a href="http://code.google.com/apis/blogger/">http://code.google.com/apis/blogger/</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.client.html#BloggerClient">BloggerClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#Query">gdata.client.Query</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.client.html#Query">Query</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BloggerClient">class <strong>BloggerClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.client.html#BloggerClient">BloggerClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BloggerClient-AddComment"><strong>AddComment</strong></a> = <a href="#BloggerClient-add_comment">add_comment</a>(self, blog_id, post_id, body, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, body_type<font color="#909090">='html'</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-AddPage"><strong>AddPage</strong></a> = <a href="#BloggerClient-add_page">add_page</a>(self, blog_id, title, body, draft<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, body_type<font color="#909090">='html'</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-AddPost"><strong>AddPost</strong></a> = <a href="#BloggerClient-add_post">add_post</a>(self, blog_id, title, body, labels<font color="#909090">=None</font>, draft<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, body_type<font color="#909090">='html'</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-Delete"><strong>Delete</strong></a> = <a href="#BloggerClient-delete">delete</a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-GetBlogArchive"><strong>GetBlogArchive</strong></a> = <a href="#BloggerClient-get_blog_archive">get_blog_archive</a>(self, blog_id, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-GetBlogComments"><strong>GetBlogComments</strong></a> = <a href="#BloggerClient-get_blog_comments">get_blog_comments</a>(self, blog_id, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.blogger.data.CommentFeed'></font>, query<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-GetBlogs"><strong>GetBlogs</strong></a> = <a href="#BloggerClient-get_blogs">get_blogs</a>(self, user_id<font color="#909090">='default'</font>, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.blogger.data.BlogFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-GetPages"><strong>GetPages</strong></a> = <a href="#BloggerClient-get_pages">get_pages</a>(self, blog_id, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.blogger.data.BlogPageFeed'></font>, query<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-GetPostComments"><strong>GetPostComments</strong></a> = <a href="#BloggerClient-get_post_comments">get_post_comments</a>(self, blog_id, post_id, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.blogger.data.CommentFeed'></font>, query<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-GetPosts"><strong>GetPosts</strong></a> = <a href="#BloggerClient-get_posts">get_posts</a>(self, blog_id, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.blogger.data.BlogPostFeed'></font>, query<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-Update"><strong>Update</strong></a> = <a href="#BloggerClient-update">update</a>(self, entry, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-add_comment"><strong>add_comment</strong></a>(self, blog_id, post_id, body, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, body_type<font color="#909090">='html'</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-add_page"><strong>add_page</strong></a>(self, blog_id, title, body, draft<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, body_type<font color="#909090">='html'</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-add_post"><strong>add_post</strong></a>(self, blog_id, title, body, labels<font color="#909090">=None</font>, draft<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, body_type<font color="#909090">='html'</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-get_blog_archive"><strong>get_blog_archive</strong></a>(self, blog_id, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-get_blog_comments"><strong>get_blog_comments</strong></a>(self, blog_id, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.blogger.data.CommentFeed'></font>, query<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-get_blogs"><strong>get_blogs</strong></a>(self, user_id<font color="#909090">='default'</font>, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.blogger.data.BlogFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-get_pages"><strong>get_pages</strong></a>(self, blog_id, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.blogger.data.BlogPageFeed'></font>, query<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-get_post_comments"><strong>get_post_comments</strong></a>(self, blog_id, post_id, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.blogger.data.CommentFeed'></font>, query<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-get_posts"><strong>get_posts</strong></a>(self, blog_id, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.blogger.data.BlogPostFeed'></font>, query<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '2'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('http://www.blogger.com/feeds/',)</dl>
+
+<dl><dt><strong>auth_service</strong> = 'blogger'</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="BloggerClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see <a href="#BloggerClient">BloggerClient</a>,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BloggerClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see <a href="#BloggerClient">BloggerClient</a>,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BloggerClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BloggerClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="BloggerClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-__init__"><strong>__init__</strong></a>(self, http_client<font color="#909090">=None</font>, host<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, source<font color="#909090">=None</font>, xoauth_requestor_id<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new AtomPubClient instance.<br>
+ <br>
+Args:<br>
+ source: The name of your application.<br>
+ http_client: An object capable of performing HTTP requests through a<br>
+ request method. This object is used to perform the request<br>
+ when the AtomPubClient's request method is called. Used to<br>
+ allow HTTP requests to be directed to a mock server, or use<br>
+ an alternate library instead of the default of httplib to<br>
+ make HTTP requests.<br>
+ host: str The default host name to use if a host is not specified in the<br>
+ requested URI.<br>
+ auth_token: An object which sets the HTTP Authorization header when its<br>
+ modify_request method is called.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="BloggerClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Query">class <strong>Query</strong></a>(<a href="gdata.client.html#Query">gdata.client.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.client.html#Query">Query</a></dd>
+<dd><a href="gdata.client.html#Query">gdata.client.Query</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Query-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#Query-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="Query-__init__"><strong>__init__</strong></a>(self, order_by<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="Query-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><a name="Query-AddCustomParameter"><strong>AddCustomParameter</strong></a> = add_custom_parameter(self, key, value)</dt></dl>
+
+<dl><dt><a name="Query-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>BLOGS_URL</strong> = 'http://www.blogger.com/feeds/%s/blogs'<br>
+<strong>BLOG_ARCHIVE_URL</strong> = 'http://www.blogger.com/feeds/%s/archive/full'<br>
+<strong>BLOG_COMMENTS_URL</strong> = 'http://www.blogger.com/feeds/%s/comments/default'<br>
+<strong>BLOG_PAGE_URL</strong> = 'http://www.blogger.com/feeds/%s/pages/default'<br>
+<strong>BLOG_POST_COMMENTS_URL</strong> = 'http://www.blogger.com/feeds/%s/%s/comments/default'<br>
+<strong>BLOG_POST_URL</strong> = 'http://www.blogger.com/feeds/%s/posts/default'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.blogger.data.html b/pydocs/gdata.blogger.data.html
new file mode 100644
index 0000000..5d60071
--- /dev/null
+++ b/pydocs/gdata.blogger.data.html
@@ -0,0 +1,3411 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.blogger.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.blogger.html"><font color="#ffffff">blogger</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/blogger/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/blogger/data.py</a></font></td></tr></table>
+ <p><tt>Data model classes for parsing and generating XML for the Blogger API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="re.html">re</a><br>
+</td><td width="25%" valign=top><a href="urlparse.html">urlparse</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.data.html#InReplyTo">InReplyTo</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.data.html#Blog">Blog</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.data.html#BlogPage">BlogPage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.data.html#BlogPost">BlogPost</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.data.html#Comment">Comment</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.data.html#BlogFeed">BlogFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.data.html#BlogPageFeed">BlogPageFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.data.html#BlogPostFeed">BlogPostFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.data.html#CommentFeed">CommentFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Blog">class <strong>Blog</strong></a>(<a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a blog which belongs to the user.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.data.html#Blog">Blog</a></dd>
+<dd><a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a>:<br>
+<dl><dt><a name="Blog-GetBlogId"><strong>GetBlogId</strong></a> = get_blog_id(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+ <br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="Blog-GetBlogName"><strong>GetBlogName</strong></a> = get_blog_name(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+ <br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<dl><dt><a name="Blog-get_blog_id"><strong>get_blog_id</strong></a>(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+ <br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="Blog-get_blog_name"><strong>get_blog_name</strong></a>(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+ <br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="Blog-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Blog-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="Blog-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="Blog-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Blog-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="Blog-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Blog-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Blog-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Blog-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Blog-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Blog-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Blog-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Blog-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Blog-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="Blog-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Blog-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Blog-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Blog-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Blog-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Blog-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Blog-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="Blog-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Blog-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Blog-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Blog-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Blog-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Blog-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Blog-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Blog-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Blog-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogFeed">class <strong>BlogFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.data.html#BlogFeed">BlogFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.blogger.data.Blog'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="BlogFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="BlogFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BlogFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="BlogFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="BlogFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogPage">class <strong>BlogPage</strong></a>(<a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a single page on a blog.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.data.html#BlogPage">BlogPage</a></dd>
+<dd><a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BlogPage-GetPageId"><strong>GetPageId</strong></a> = <a href="#BlogPage-get_page_id">get_page_id</a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-get_page_id"><strong>get_page_id</strong></a>(self)</dt><dd><tt>Extracts the pageID string from entry's Atom id.<br>
+ <br>
+Returns: A string of digits which identify this post within the blog.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a>:<br>
+<dl><dt><a name="BlogPage-GetBlogId"><strong>GetBlogId</strong></a> = get_blog_id(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+ <br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-GetBlogName"><strong>GetBlogName</strong></a> = get_blog_name(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+ <br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-get_blog_id"><strong>get_blog_id</strong></a>(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+ <br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-get_blog_name"><strong>get_blog_name</strong></a>(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+ <br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="BlogPage-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="BlogPage-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BlogPage-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPage-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPage-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BlogPage-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPage-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogPageFeed">class <strong>BlogPageFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.data.html#BlogPageFeed">BlogPageFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.blogger.data.BlogPage'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="BlogPageFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="BlogPageFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BlogPageFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPageFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPageFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BlogPageFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPageFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogPost">class <strong>BlogPost</strong></a>(<a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a single post on a blog.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.data.html#BlogPost">BlogPost</a></dd>
+<dd><a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BlogPost-AddLabel"><strong>AddLabel</strong></a> = <a href="#BlogPost-add_label">add_label</a>(self, label)</dt></dl>
+
+<dl><dt><a name="BlogPost-GetPostId"><strong>GetPostId</strong></a> = <a href="#BlogPost-get_post_id">get_post_id</a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-add_label"><strong>add_label</strong></a>(self, label)</dt><dd><tt>Adds a label to the blog post.<br>
+ <br>
+The label is represented by an Atom category element, so this method<br>
+is shorthand for appending a new atom.Category object.<br>
+ <br>
+Args:<br>
+ label: str</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-get_post_id"><strong>get_post_id</strong></a>(self)</dt><dd><tt>Extracts the postID string from the entry's Atom id.<br>
+ <br>
+Returns: A string of digits which identify this post within the blog.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a>:<br>
+<dl><dt><a name="BlogPost-GetBlogId"><strong>GetBlogId</strong></a> = get_blog_id(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+ <br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-GetBlogName"><strong>GetBlogName</strong></a> = get_blog_name(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+ <br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-get_blog_id"><strong>get_blog_id</strong></a>(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+ <br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-get_blog_name"><strong>get_blog_name</strong></a>(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+ <br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="BlogPost-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="BlogPost-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BlogPost-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPost-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPost-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BlogPost-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPost-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogPostFeed">class <strong>BlogPostFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.data.html#BlogPostFeed">BlogPostFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.blogger.data.BlogPost'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="BlogPostFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="BlogPostFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BlogPostFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPostFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPostFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BloggerEntry">class <strong>BloggerEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Adds convenience methods inherited by all Blogger entries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BloggerEntry-GetBlogId"><strong>GetBlogId</strong></a> = <a href="#BloggerEntry-get_blog_id">get_blog_id</a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetBlogName"><strong>GetBlogName</strong></a> = <a href="#BloggerEntry-get_blog_name">get_blog_name</a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-get_blog_id"><strong>get_blog_id</strong></a>(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+ <br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-get_blog_name"><strong>get_blog_name</strong></a>(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+ <br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="BloggerEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="BloggerEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BloggerEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="BloggerEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="BloggerEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Comment">class <strong>Comment</strong></a>(<a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Blog">Blog</a> post comment entry in a feed listing comments on a post or blog.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.data.html#Comment">Comment</a></dd>
+<dd><a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Comment-GetCommentId"><strong>GetCommentId</strong></a> = <a href="#Comment-get_comment_id">get_comment_id</a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-get_comment_id"><strong>get_comment_id</strong></a>(self)</dt><dd><tt>Extracts the commentID string from the entry's Atom id.<br>
+ <br>
+Returns: A string of digits which identify this post within the blog.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>in_reply_to</strong> = <class 'gdata.blogger.data.InReplyTo'></dl>
+
+<hr>
+Methods inherited from <a href="gdata.blogger.data.html#BloggerEntry">BloggerEntry</a>:<br>
+<dl><dt><a name="Comment-GetBlogId"><strong>GetBlogId</strong></a> = get_blog_id(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+ <br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="Comment-GetBlogName"><strong>GetBlogName</strong></a> = get_blog_name(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+ <br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<dl><dt><a name="Comment-get_blog_id"><strong>get_blog_id</strong></a>(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+ <br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="Comment-get_blog_name"><strong>get_blog_name</strong></a>(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+ <br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="Comment-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Comment-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="Comment-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="Comment-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Comment-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="Comment-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Comment-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Comment-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Comment-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Comment-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Comment-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Comment-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Comment-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Comment-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="Comment-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Comment-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Comment-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Comment-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Comment-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Comment-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Comment-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="Comment-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Comment-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Comment-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Comment-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Comment-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Comment-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Comment-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Comment-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comment-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentFeed">class <strong>CommentFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.data.html#CommentFeed">CommentFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.blogger.data.Comment'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CommentFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CommentFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CommentFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CommentFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CommentFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="InReplyTo">class <strong>InReplyTo</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.data.html#InReplyTo">InReplyTo</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<dl><dt><strong>ref</strong> = 'ref'</dl>
+
+<dl><dt><strong>source</strong> = 'source'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="InReplyTo-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="InReplyTo-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InReplyTo-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>BLOG_ID2_PATTERN</strong> = <_sre.SRE_Pattern object><br>
+<strong>BLOG_ID_PATTERN</strong> = <_sre.SRE_Pattern object><br>
+<strong>BLOG_NAME_PATTERN</strong> = <_sre.SRE_Pattern object><br>
+<strong>COMMENT_ID_PATTERN</strong> = <_sre.SRE_Pattern object><br>
+<strong>LABEL_SCHEME</strong> = 'http://www.blogger.com/atom/ns#'<br>
+<strong>PAGE_ID_PATTERN</strong> = <_sre.SRE_Pattern object><br>
+<strong>POST_ID_PATTERN</strong> = <_sre.SRE_Pattern object><br>
+<strong>THR_TEMPLATE</strong> = '{http://purl.org/syndication/thread/1.0}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.blogger.html b/pydocs/gdata.blogger.html
new file mode 100644
index 0000000..37e9853
--- /dev/null
+++ b/pydocs/gdata.blogger.html
@@ -0,0 +1,1068 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.blogger</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.blogger</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/blogger/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/blogger/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains extensions to Atom objects used with Blogger.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.blogger.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.blogger.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.blogger.service.html">service</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.html#InReplyTo">InReplyTo</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.html#BlogEntry">BlogEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.html#BlogPostEntry">BlogPostEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.html#CommentEntry">CommentEntry</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.html#BlogFeed">BlogFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.html#BlogPostFeed">BlogPostFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.html#CommentFeed">CommentFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogEntry">class <strong>BlogEntry</strong></a>(<a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a blog entry in the feed listing a user's blogs.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.html#BlogEntry">BlogEntry</a></dd>
+<dd><a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a>:<br>
+<dl><dt><a name="BlogEntry-GetBlogId"><strong>GetBlogId</strong></a>(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="BlogEntry-GetBlogName"><strong>GetBlogName</strong></a>(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a>:<br>
+<dl><dt><strong>blog_id2_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<dl><dt><strong>blog_id_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<dl><dt><strong>blog_name_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="BlogEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BlogEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Entry">atom.Entry</a>:<br>
+<dl><dt><a name="BlogEntry-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BlogEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BlogEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BlogEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="BlogEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="BlogEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="BlogEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="BlogEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogFeed">class <strong>BlogFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a feed of a user's blogs.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.html#BlogFeed">BlogFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="BlogFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BlogFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BlogFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="BlogFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="BlogFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogPostEntry">class <strong>BlogPostEntry</strong></a>(<a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a blog post entry in the feed of a blog's posts.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.html#BlogPostEntry">BlogPostEntry</a></dd>
+<dd><a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BlogPostEntry-AddLabel"><strong>AddLabel</strong></a>(self, label)</dt><dd><tt>Adds a label to the blog post.<br>
+ <br>
+The label is represented by an Atom category element, so this method<br>
+is shorthand for appending a new atom.Category object.<br>
+ <br>
+Args:<br>
+ label: str</tt></dd></dl>
+
+<dl><dt><a name="BlogPostEntry-GetPostId"><strong>GetPostId</strong></a>(self)</dt><dd><tt>Extracts the postID string from the entry's Atom id.<br>
+ <br>
+Returns: A string of digits which identify this post within the blog.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>post_id_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<hr>
+Methods inherited from <a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a>:<br>
+<dl><dt><a name="BlogPostEntry-GetBlogId"><strong>GetBlogId</strong></a>(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostEntry-GetBlogName"><strong>GetBlogName</strong></a>(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a>:<br>
+<dl><dt><strong>blog_id2_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<dl><dt><strong>blog_id_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<dl><dt><strong>blog_name_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="BlogPostEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Entry">atom.Entry</a>:<br>
+<dl><dt><a name="BlogPostEntry-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BlogPostEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BlogPostEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPostEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="BlogPostEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPostEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogPostFeed">class <strong>BlogPostFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a feed of a blog's posts.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.html#BlogPostFeed">BlogPostFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="BlogPostFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BlogPostFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BlogPostFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPostFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="BlogPostFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BloggerEntry">class <strong>BloggerEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Adds convenience methods inherited by all Blogger entries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BloggerEntry-GetBlogId"><strong>GetBlogId</strong></a>(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-GetBlogName"><strong>GetBlogName</strong></a>(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>blog_id2_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<dl><dt><strong>blog_id_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<dl><dt><strong>blog_name_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="BloggerEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Entry">atom.Entry</a>:<br>
+<dl><dt><a name="BloggerEntry-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BloggerEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BloggerEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="BloggerEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BloggerEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="BloggerEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentEntry">class <strong>CommentEntry</strong></a>(<a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a blog post comment entry in the feed of a blog post's<br>
+comments.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.html#CommentEntry">CommentEntry</a></dd>
+<dd><a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CommentEntry-GetCommentId"><strong>GetCommentId</strong></a>(self)</dt><dd><tt>Extracts the commentID string from the entry's Atom id.<br>
+ <br>
+Returns: A string of digits which identify this post within the blog.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, source<font color="#909090">=None</font>, summary<font color="#909090">=None</font>, control<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, in_reply_to<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>comment_id_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<hr>
+Methods inherited from <a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a>:<br>
+<dl><dt><a name="CommentEntry-GetBlogId"><strong>GetBlogId</strong></a>(self)</dt><dd><tt>Extracts the Blogger id of this blog.<br>
+This method is useful when contructing URLs by hand. The blog id is<br>
+often used in blogger operation URLs. This should not be confused with<br>
+the id member of a BloggerBlog. The id element is the Atom id XML element.<br>
+The blog id which this method returns is a part of the Atom id.<br>
+ <br>
+Returns:<br>
+ The blog's unique id as a string.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetBlogName"><strong>GetBlogName</strong></a>(self)</dt><dd><tt>Finds the name of this blog as used in the 'alternate' URL.<br>
+An alternate URL is in the form '<a href="http://blogName.blogspot.com/">http://blogName.blogspot.com/</a>'. For an<br>
+entry representing the above example, this method would return 'blogName'.<br>
+ <br>
+Returns:<br>
+ The blog's URL name component as a string.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.blogger.html#BloggerEntry">BloggerEntry</a>:<br>
+<dl><dt><strong>blog_id2_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<dl><dt><strong>blog_id_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<dl><dt><strong>blog_name_pattern</strong> = <_sre.SRE_Pattern object></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="CommentEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CommentEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CommentEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CommentEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CommentEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentFeed">class <strong>CommentFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a feed of a blog post's comments.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.html#CommentFeed">CommentFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="CommentFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CommentFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CommentFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CommentFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CommentFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="InReplyTo">class <strong>InReplyTo</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.html#InReplyTo">InReplyTo</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="InReplyTo-__init__"><strong>__init__</strong></a>(self, href<font color="#909090">=None</font>, ref<font color="#909090">=None</font>, source<font color="#909090">=None</font>, type<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="InReplyTo-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="InReplyTo-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-BlogEntryFromString"><strong>BlogEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-BlogFeedFromString"><strong>BlogFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-BlogPostEntryFromString"><strong>BlogPostEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-BlogPostFeedFromString"><strong>BlogPostFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CommentEntryFromString"><strong>CommentEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CommentFeedFromString"><strong>CommentFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-InReplyToFromString"><strong>InReplyToFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>LABEL_SCHEME</strong> = 'http://www.blogger.com/atom/ns#'<br>
+<strong>THR_NAMESPACE</strong> = 'http://purl.org/syndication/thread/1.0'<br>
+<strong>__author__</strong> = 'api.jscudder (Jeffrey Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeffrey Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.blogger.service.html b/pydocs/gdata.blogger.service.html
new file mode 100644
index 0000000..5c1f62b
--- /dev/null
+++ b/pydocs/gdata.blogger.service.html
@@ -0,0 +1,1102 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.blogger.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.blogger.html"><font color="#ffffff">blogger</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/blogger/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/blogger/service.py</a></font></td></tr></table>
+ <p><tt>Classes to interact with the Blogger server.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.service.html#BloggerService">BloggerService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Query">gdata.service.Query</a>(<a href="__builtin__.html#dict">__builtin__.dict</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.blogger.service.html#BlogCommentQuery">BlogCommentQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.service.html#BlogPostQuery">BlogPostQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.blogger.service.html#BlogQuery">BlogQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogCommentQuery">class <strong>BlogCommentQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.service.html#BlogCommentQuery">BlogCommentQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BlogCommentQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>, blog_id<font color="#909090">=None</font>, post_id<font color="#909090">=None</font>, comment_id<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="BlogCommentQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogCommentQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="BlogCommentQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogCommentQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#BlogCommentQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#BlogCommentQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#BlogCommentQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#BlogCommentQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="BlogCommentQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#BlogCommentQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#BlogCommentQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogPostQuery">class <strong>BlogPostQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.service.html#BlogPostQuery">BlogPostQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BlogPostQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>, blog_id<font color="#909090">=None</font>, post_id<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="BlogPostQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogPostQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="BlogPostQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogPostQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#BlogPostQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#BlogPostQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#BlogPostQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#BlogPostQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="BlogPostQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#BlogPostQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#BlogPostQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BlogQuery">class <strong>BlogQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.service.html#BlogQuery">BlogQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BlogQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>, blog_id<font color="#909090">=None</font>)</dt><dd><tt>Constructs a query object for the list of a user's Blogger blogs.<br>
+ <br>
+Args:<br>
+ feed: str (optional) The beginning of the URL to be queried. If the<br>
+ feed is not set, and there is no blog_id passed in, the default<br>
+ value is used ('/feeds/default/blogs').<br>
+ params: dict (optional)<br>
+ categories: list (optional)<br>
+ blog_id: str (optional)</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="BlogQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BlogQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="BlogQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BlogQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#BlogQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#BlogQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#BlogQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#BlogQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="BlogQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#BlogQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#BlogQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BloggerService">class <strong>BloggerService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.blogger.service.html#BloggerService">BloggerService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BloggerService-AddComment"><strong>AddComment</strong></a>(self, comment_entry, blog_id<font color="#909090">=None</font>, post_id<font color="#909090">=None</font>, uri<font color="#909090">=None</font>)</dt><dd><tt>Adds a new comment to the specified blog post.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-AddPost"><strong>AddPost</strong></a>(self, entry, blog_id<font color="#909090">=None</font>, uri<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BloggerService-DeleteComment"><strong>DeleteComment</strong></a>(self, entry<font color="#909090">=None</font>, uri<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BloggerService-DeletePost"><strong>DeletePost</strong></a>(self, entry<font color="#909090">=None</font>, uri<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BloggerService-GetBlogCommentFeed"><strong>GetBlogCommentFeed</strong></a>(self, blog_id<font color="#909090">=None</font>, uri<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a list of the comments for this blog.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GetBlogFeed"><strong>GetBlogFeed</strong></a>(self, uri<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a list of the blogs to which the current user may manage.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GetBlogPostFeed"><strong>GetBlogPostFeed</strong></a>(self, blog_id<font color="#909090">=None</font>, uri<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BloggerService-GetPostCommentFeed"><strong>GetPostCommentFeed</strong></a>(self, blog_id<font color="#909090">=None</font>, post_id<font color="#909090">=None</font>, uri<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a list of the comments for this particular blog post.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-UpdatePost"><strong>UpdatePost</strong></a>(self, entry, uri<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BloggerService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='www.blogger.com'</font>, **kwargs)</dt><dd><tt>Creates a client for the Blogger service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'www.blogger.com'.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="BloggerService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BloggerService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#BloggerService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#BloggerService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#BloggerService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="BloggerService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="BloggerService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'api.jscudder (Jeffrey Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeffrey Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.books.data.html b/pydocs/gdata.books.data.html
new file mode 100644
index 0000000..84ad18b
--- /dev/null
+++ b/pydocs/gdata.books.data.html
@@ -0,0 +1,2459 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.books.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.books.html"><font color="#ffffff">books</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/books/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/books/data.py</a></font></td></tr></table>
+ <p><tt>Contains the data classes of the Google Book Search Data API</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.books.data.html#Embeddability">Embeddability</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.data.html#OpenAccess">OpenAccess</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.data.html#Review">Review</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.data.html#Viewability">Viewability</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.books.data.html#CollectionFeed">CollectionFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.data.html#VolumeFeed">VolumeFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.books.data.html#CollectionEntry">CollectionEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.data.html#VolumeEntry">VolumeEntry</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CollectionEntry">class <strong>CollectionEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an entry in a feed of collections.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.data.html#CollectionEntry">CollectionEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CollectionEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CollectionEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CollectionEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CollectionEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CollectionEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CollectionEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CollectionFeed">class <strong>CollectionFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a Book Search collection feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.data.html#CollectionFeed">CollectionFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.books.data.CollectionEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="CollectionFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a BatchEntry and adding to the feed.<br>
+ <br>
+If the entry is not a BatchEntry, it is converted to a BatchEntry so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a BatchEntry is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ BatchEntry which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: BatchEntry (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a BatchEntry, and you may pass in the BatchEntry<br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: BatchEntry (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a BatchEntry and adding to the feed.<br>
+ <br>
+If the entry is not a BatchEntry, it is converted to a BatchEntry so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a BatchEntry is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ BatchEntry which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: BatchEntry (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a BatchEntry, and you may pass in the BatchEntry<br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: BatchEntry (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CollectionFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CollectionFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CollectionFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CollectionFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CollectionFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CollectionFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CollectionFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Embeddability">class <strong>Embeddability</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an embeddability.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.data.html#Embeddability">Embeddability</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Embeddability-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Embeddability-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Embeddability-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Embeddability-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Embeddability-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Embeddability-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Embeddability-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Embeddability-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Embeddability-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Embeddability-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OpenAccess">class <strong>OpenAccess</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an open access.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.data.html#OpenAccess">OpenAccess</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OpenAccess-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OpenAccess-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OpenAccess-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OpenAccess-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OpenAccess-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="OpenAccess-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="OpenAccess-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OpenAccess-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OpenAccess-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OpenAccess-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Review">class <strong>Review</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User-provided review.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.data.html#Review">Review</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>lang</strong> = 'lang'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Review-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Review-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Review-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Review-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Review-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Review-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Review-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Review-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Review-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Review-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Viewability">class <strong>Viewability</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a viewability.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.data.html#Viewability">Viewability</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Viewability-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Viewability-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Viewability-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Viewability-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Viewability-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Viewability-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Viewability-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Viewability-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Viewability-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Viewability-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VolumeEntry">class <strong>VolumeEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an entry in a feed of Book Search volumes.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.data.html#VolumeEntry">VolumeEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>comments</strong> = <class 'gdata.data.Comments'><dd><tt>The gd:comments element.<br>
+ <br>
+Contains a comments feed for the enclosing entry (such as a calendar event).</tt></dl>
+
+<dl><dt><strong>creator</strong> = [<class 'gdata.dublincore.data.Creator'>]</dl>
+
+<dl><dt><strong>date</strong> = [<class 'gdata.dublincore.data.Date'>]</dl>
+
+<dl><dt><strong>dc_title</strong> = [<class 'gdata.dublincore.data.Title'>]</dl>
+
+<dl><dt><strong>description</strong> = [<class 'gdata.dublincore.data.Description'>]</dl>
+
+<dl><dt><strong>embeddability</strong> = <class 'gdata.books.data.Embeddability'><dd><tt>Describes an embeddability.</tt></dl>
+
+<dl><dt><strong>format</strong> = [<class 'gdata.dublincore.data.Format'>]</dl>
+
+<dl><dt><strong>identifier</strong> = [<class 'gdata.dublincore.data.Identifier'>]</dl>
+
+<dl><dt><strong>language</strong> = [<class 'gdata.dublincore.data.Language'>]</dl>
+
+<dl><dt><strong>open_access</strong> = <class 'gdata.books.data.OpenAccess'><dd><tt>Describes an open access.</tt></dl>
+
+<dl><dt><strong>publisher</strong> = [<class 'gdata.dublincore.data.Publisher'>]</dl>
+
+<dl><dt><strong>rating</strong> = <class 'gdata.data.Rating'><dd><tt>The gd:rating element.<br>
+ <br>
+Represents a numeric rating of the enclosing entity, such as a<br>
+comment. Each rating supplies its own scale, although it may be<br>
+normalized by a service; for example, some services might convert all<br>
+ratings to a scale from 1 to 5.</tt></dl>
+
+<dl><dt><strong>review</strong> = <class 'gdata.books.data.Review'><dd><tt>User-provided review.</tt></dl>
+
+<dl><dt><strong>subject</strong> = [<class 'gdata.dublincore.data.Subject'>]</dl>
+
+<dl><dt><strong>viewability</strong> = <class 'gdata.books.data.Viewability'><dd><tt>Describes a viewability.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="VolumeEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="VolumeEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="VolumeEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="VolumeEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="VolumeEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VolumeEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VolumeFeed">class <strong>VolumeFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a Book Search volume feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.data.html#VolumeFeed">VolumeFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.books.data.VolumeEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="VolumeFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a BatchEntry and adding to the feed.<br>
+ <br>
+If the entry is not a BatchEntry, it is converted to a BatchEntry so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a BatchEntry is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ BatchEntry which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: BatchEntry (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a BatchEntry, and you may pass in the BatchEntry<br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: BatchEntry (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a BatchEntry and adding to the feed.<br>
+ <br>
+If the entry is not a BatchEntry, it is converted to a BatchEntry so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a BatchEntry is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ BatchEntry which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: BatchEntry (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a BatchEntry, and you may pass in the BatchEntry<br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: BatchEntry (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: BatchEntry The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="VolumeFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="VolumeFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="VolumeFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="VolumeFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="VolumeFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VolumeFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VolumeFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GBS_TEMPLATE</strong> = '{http://schemas.google.com/books/2008/}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.books.html b/pydocs/gdata.books.html
new file mode 100644
index 0000000..0678f8e
--- /dev/null
+++ b/pydocs/gdata.books.html
@@ -0,0 +1,1133 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.books</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.books</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/books/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/books/__init__.py</a></font></td></tr></table>
+ <p><tt>Data Models for books.service<br>
+ <br>
+All classes can be instantiated from an xml string using their FromString<br>
+class method.<br>
+ <br>
+Notes:<br>
+ * <a href="#Book">Book</a>.title displays the first dc:title because the returned XML<br>
+ repeats that datum as atom:title.<br>
+There is an undocumented gbs:openAccess element that is not parsed.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.books.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.books.service.html">service</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.books.html#Book">Book</a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>, <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.books.html#BookFeed">BookFeed</a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>, <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.books.html#_AtomFromString">_AtomFromString</a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.books.html#Book">Book</a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>, <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#BookFeed">BookFeed</a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>, <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Creator">Creator</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Date">Date</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Description">Description</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Embeddability">Embeddability</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Format">Format</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Identifier">Identifier</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Publisher">Publisher</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Rating">Rating</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Review">Review</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Subject">Subject</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Title">Title</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.books.html#Viewability">Viewability</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Book">class <strong>Book</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>, <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an <entry> from either a search, annotation, library, or single<br>
+item feed. Note that dc_title attribute is the proper title of the volume,<br>
+title is an atom element and may not represent the full title.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Book">Book</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Book-GetAnnotationLink"><strong>GetAnnotationLink</strong></a>(self)</dt><dd><tt>Returns the atom.Link object representing the Annotation URI.<br>
+Note that the use of www.books in the href of this link seems to make<br>
+this information useless. Using books.service.ANNOTATION_FEED and <br>
+BOOK_SERVER to construct your URI seems to work better.</tt></dd></dl>
+
+<dl><dt><a name="Book-GetInfoLink"><strong>GetInfoLink</strong></a>(self)</dt><dd><tt>Returns the atom.Link object representing the human-readable info URI.</tt></dd></dl>
+
+<dl><dt><a name="Book-GetPreviewLink"><strong>GetPreviewLink</strong></a>(self)</dt><dd><tt>Returns the atom.Link object representing the preview URI.</tt></dd></dl>
+
+<dl><dt><a name="Book-GetThumbnailLink"><strong>GetThumbnailLink</strong></a>(self)</dt><dd><tt>Returns the atom.Link object representing the thumbnail URI.</tt></dd></dl>
+
+<dl><dt><a name="Book-__init__"><strong>__init__</strong></a>(self, creator<font color="#909090">=None</font>, date<font color="#909090">=None</font>, description<font color="#909090">=None</font>, format<font color="#909090">=None</font>, author<font color="#909090">=None</font>, identifier<font color="#909090">=None</font>, publisher<font color="#909090">=None</font>, subject<font color="#909090">=None</font>, dc_title<font color="#909090">=None</font>, viewability<font color="#909090">=None</font>, embeddability<font color="#909090">=None</font>, review<font color="#909090">=None</font>, rating<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, source<font color="#909090">=None</font>, summary<font color="#909090">=None</font>, title<font color="#909090">=None</font>, control<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Book-clean_annotations"><strong>clean_annotations</strong></a>(self)</dt><dd><tt>Clear all annotations from an item. Useful for taking an item from<br>
+another user's library/annotation feed and adding it to the <br>
+authenticated user's library without adopting annotations.</tt></dd></dl>
+
+<dl><dt><a name="Book-get_google_id"><strong>get_google_id</strong></a>(self)</dt><dd><tt>Get Google's ID of the item.</tt></dd></dl>
+
+<dl><dt><a name="Book-get_label"><strong>get_label</strong></a>(self)</dt><dd><tt>Get users label for the item as a string</tt></dd></dl>
+
+<dl><dt><a name="Book-remove_label"><strong>remove_label</strong></a>(self)</dt><dd><tt>Clear the user's label for the item</tt></dd></dl>
+
+<dl><dt><a name="Book-set_label"><strong>set_label</strong></a>(self, term)</dt><dd><tt>Clear pre-existing label for the item and set term as the label.</tt></dd></dl>
+
+<dl><dt><a name="Book-set_rating"><strong>set_rating</strong></a>(self, value)</dt><dd><tt>Set user's rating. Must be an integral string between 1 nad 5</tt></dd></dl>
+
+<dl><dt><a name="Book-set_review"><strong>set_review</strong></a>(self, text, type<font color="#909090">='text'</font>, lang<font color="#909090">='en'</font>)</dt><dd><tt>Set user's review text</tt></dd></dl>
+
+<dl><dt><a name="Book-to_dict"><strong>to_dict</strong></a>(self)</dt><dd><tt>Returns a dictionary of the book's available metadata. If the data<br>
+cannot be discovered, it is not included as a key in the returned dict.<br>
+The possible keys are: authors, embeddability, date, description, <br>
+format, identifiers, publishers, rating, review, subjects, title, and<br>
+viewability.<br>
+ <br>
+Notes:<br>
+ * Plural keys will be lists<br>
+ * Singular keys will be strings<br>
+ * <a href="#Title">Title</a>, despite usually being a list, joins the title and subtitle<br>
+ with a space as a single string.<br>
+ * embeddability and viewability only return the portion of the URI <br>
+ after #<br>
+ * identifiers is a list of tuples, where the first item of each tuple<br>
+ is the type of identifier and the second item is the identifying<br>
+ string. Note that while doing dict() on this tuple may be possible,<br>
+ some items may have multiple of the same identifier and converting<br>
+ to a dict may resulted in collisions/dropped data.<br>
+ * <a href="#Rating">Rating</a> returns only the user's rating. See <a href="#Rating">Rating</a> class for precise<br>
+ definition.</tt></dd></dl>
+
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Book-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="Book-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Book-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Book-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Book-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Book-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="Book-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Book-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Book-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="Book-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Book-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="Book-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Book-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Book-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Book-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="Book-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Book-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BookFeed">class <strong>BookFeed</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>, <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of entries from a search.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#BookFeed">BookFeed</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="BookFeed-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="BookFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: <a href="#Title">Title</a> (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BookFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BookFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BookFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="BookFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BookFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BookFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="BookFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BookFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="BookFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BookFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BookFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BookFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="BookFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BookFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Creator">class <strong>Creator</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <dc:creator> element identifies an author-or more generally, an entity<br>
+responsible for creating the volume in question. Examples of a creator<br>
+include a person, an organization, or a service. In the case of <br>
+anthologies, proceedings, or other edited works, this field may be used to <br>
+indicate editors or other entities responsible for collecting the volume's <br>
+contents.<br>
+ <br>
+This element appears as a child of <entry>. If there are multiple authors or<br>
+contributors to the book, there may be multiple <dc:creator> elements in the<br>
+volume entry (one for each creator or contributor).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Creator">Creator</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Creator-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Creator-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Creator-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Creator-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Creator-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Date">class <strong>Date</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <dc:date> element indicates the publication date of the specific volume<br>
+in question. If the book is a reprint, this is the reprint date, not the <br>
+original publication date. The date is encoded according to the ISO-8601 <br>
+standard (and more specifically, the W3CDTF profile).<br>
+ <br>
+The <dc:date> element can appear only as a child of <entry>.<br>
+ <br>
+Usually only the year or the year and the month are given.<br>
+ <br>
+YYYY-MM-DDThh:mm:ssTZD TZD = -hh:mm or +hh:mm<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Date">Date</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Date-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Date-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Date-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Date-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Date-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Description">class <strong>Description</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <dc:description> element includes text that describes a book or book <br>
+result. In a search result feed, this may be a search result "snippet" that<br>
+contains the words around the user's search term. For a single volume feed,<br>
+this element may contain a synopsis of the book.<br>
+ <br>
+The <dc:description> element can appear only as a child of <entry><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Description">Description</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Description-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Description-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Description-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Description-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Description-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Embeddability">class <strong>Embeddability</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Many of the books found on Google <a href="#Book">Book</a> Search can be embedded on third-party<br>
+sites using the Embedded Viewer. The <gbs:embeddability> element indicates <br>
+whether a particular book result is available for embedding. By definition,<br>
+a book that cannot be previewed on <a href="#Book">Book</a> Search cannot be embedded on third-<br>
+party sites.<br>
+ <br>
+The <gbs:embeddability> element can appear only as a child of <entry>.<br>
+ <br>
+The value attribute will take on one of the following URIs:<br>
+embeddable: <a href="http://schemas.google.com/books/2008#embeddable">http://schemas.google.com/books/2008#embeddable</a><br>
+not embeddable: <a href="http://schemas.google.com/books/2008#not_embeddable">http://schemas.google.com/books/2008#not_embeddable</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Embeddability">Embeddability</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Embeddability-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Embeddability-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Embeddability-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Embeddability-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Embeddability-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Format">class <strong>Format</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <dc:format> element describes the physical properties of the volume. <br>
+Currently, it indicates the number of pages in the book, but more <br>
+information may be added to this field in the future.<br>
+ <br>
+This element can appear only as a child of <entry>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Format">Format</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Format-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Format-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Format-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Format-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Format-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Identifier">class <strong>Identifier</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <dc:identifier> element provides an unambiguous reference to a <br>
+particular book.<br>
+* Every <entry> contains at least one <dc:identifier> child.<br>
+* The first identifier is always the unique string <a href="#Book">Book</a> Search has assigned<br>
+ to the volume (such as s1gVAAAAYAAJ). This is the ID that appears in the <br>
+ book's URL in the <a href="#Book">Book</a> Search GUI, as well as in the URL of that book's <br>
+ single item feed.<br>
+* Many books contain additional <dc:identifier> elements. These provide <br>
+ alternate, external identifiers to the volume. Such identifiers may <br>
+ include the ISBNs, ISSNs, Library of Congress Control Numbers (LCCNs), <br>
+ and OCLC numbers; they are prepended with a corresponding namespace <br>
+ prefix (such as "ISBN:").<br>
+* Any <dc:identifier> can be passed to the Dynamic Links, used to <br>
+ instantiate an Embedded Viewer, or even used to construct static links to<br>
+ <a href="#Book">Book</a> Search.<br>
+The <dc:identifier> element can appear only as a child of <entry>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Identifier">Identifier</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Identifier-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Identifier-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Identifier-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Identifier-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Identifier-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Publisher">class <strong>Publisher</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <dc:publisher> element contains the name of the entity responsible for <br>
+producing and distributing the volume (usually the specific edition of this<br>
+book). Examples of a publisher include a person, an organization, or a <br>
+service.<br>
+ <br>
+This element can appear only as a child of <entry>. If there is more than <br>
+one publisher, multiple <dc:publisher> elements may appear.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Publisher">Publisher</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Publisher-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Publisher-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Publisher-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Rating">class <strong>Rating</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>All attributes must take an integral string between 1 and 5.<br>
+The min, max, and average attributes represent 'community' ratings. The<br>
+value attribute is the user's (of the feed from which the item is fetched,<br>
+not necessarily the authenticated user) rating of the book.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Rating">Rating</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Rating-__init__"><strong>__init__</strong></a>(self, min<font color="#909090">=None</font>, max<font color="#909090">=None</font>, average<font color="#909090">=None</font>, value<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Rating-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Rating-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Rating-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Rating-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Review">class <strong>Review</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>When present, the <gbs:review> element contains a user-generated review for<br>
+a given book. This element currently appears only in the user library and <br>
+user annotation feeds, as a child of <entry>.<br>
+ <br>
+type: text, html, xhtml<br>
+xml:lang: id of the language, a guess, (always two letters?)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Review">Review</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Review-__init__"><strong>__init__</strong></a>(self, type<font color="#909090">=None</font>, lang<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Review-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Review-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Review-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Review-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Subject">class <strong>Subject</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <dc:subject> element identifies the topic of the book. Usually this is <br>
+a Library of Congress <a href="#Subject">Subject</a> Heading (LCSH) or <a href="#Book">Book</a> Industry Standards <br>
+and Communications <a href="#Subject">Subject</a> Heading (BISAC).<br>
+ <br>
+The <dc:subject> element can appear only as a child of <entry>. There may <br>
+be multiple <dc:subject> elements per entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Subject">Subject</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Subject-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Subject-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Subject-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Subject-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Subject-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Title">class <strong>Title</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <dc:title> element contains the title of a book as it was published. If<br>
+a book has a subtitle, it appears as a second <dc:title> element in the book<br>
+result's <entry>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Title">Title</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Title-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Title-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Title-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Title-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Title-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Viewability">class <strong>Viewability</strong></a>(<a href="gdata.books.html#_AtomFromString">_AtomFromString</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google <a href="#Book">Book</a> Search respects the user's local copyright restrictions. As a <br>
+result, previews or full views of some books are not available in all <br>
+locations. The <gbs:viewability> element indicates whether a book is fully <br>
+viewable, can be previewed, or only has "about the book" information. These<br>
+three "viewability modes" are the same ones returned by the Dynamic Links <br>
+API.<br>
+ <br>
+The <gbs:viewability> element can appear only as a child of <entry>.<br>
+ <br>
+The value attribute will take the form of the following URIs to represent<br>
+the relevant viewing capability:<br>
+ <br>
+Full View: <a href="http://schemas.google.com/books/2008#view_all_pages">http://schemas.google.com/books/2008#view_all_pages</a><br>
+Limited Preview: <a href="http://schemas.google.com/books/2008#view_partial">http://schemas.google.com/books/2008#view_partial</a><br>
+Snippet View/No Preview: <a href="http://schemas.google.com/books/2008#view_no_pages">http://schemas.google.com/books/2008#view_no_pages</a><br>
+Unknown view: <a href="http://schemas.google.com/books/2008#view_unknown">http://schemas.google.com/books/2008#view_unknown</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.html#Viewability">Viewability</a></dd>
+<dd><a href="gdata.books.html#_AtomFromString">_AtomFromString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Viewability-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Class methods inherited from <a href="gdata.books.html#_AtomFromString">_AtomFromString</a>:<br>
+<dl><dt><a name="Viewability-FromString"><strong>FromString</strong></a>(cls, s)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>#@classmethod</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Viewability-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Viewability-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Viewability-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ANNOTATION_REL</strong> = 'http://schemas.google.com/books/2008/annotation'<br>
+<strong>BOOK_SEARCH_NAMESPACE</strong> = 'http://schemas.google.com/books/2008'<br>
+<strong>DC_NAMESPACE</strong> = 'http://purl.org/dc/terms'<br>
+<strong>EMBEDDABLE</strong> = 'http://schemas.google.com/books/2008#embeddable'<br>
+<strong>FULL_VIEW</strong> = 'http://schemas.google.com/books/2008#view_all_pages'<br>
+<strong>INFO_REL</strong> = 'http://schemas.google.com/books/2008/info'<br>
+<strong>LABEL_SCHEME</strong> = 'http://schemas.google.com/books/2008/labels'<br>
+<strong>NOT_EMBEDDABLE</strong> = 'http://schemas.google.com/books/2008#not_embeddable'<br>
+<strong>NO_VIEW</strong> = 'http://schemas.google.com/books/2008#view_no_pages'<br>
+<strong>PARTIAL_VIEW</strong> = 'http://schemas.google.com/books/2008#view_partial'<br>
+<strong>PREVIEW_REL</strong> = 'http://schemas.google.com/books/2008/preview'<br>
+<strong>THUMBNAIL_REL</strong> = 'http://schemas.google.com/books/2008/thumbnail'<br>
+<strong>UNKNOWN_VIEW</strong> = 'http://schemas.google.com/books/2008#view_unknown'<br>
+<strong>__author__</strong> = 'James Sams <sams.james@gmail.com>'<br>
+<strong>__copyright__</strong> = 'Apache License v2.0'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">James Sams <sams.james@gmail.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.books.service.html b/pydocs/gdata.books.service.html
new file mode 100644
index 0000000..e8ca571
--- /dev/null
+++ b/pydocs/gdata.books.service.html
@@ -0,0 +1,743 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.books.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.books.html"><font color="#ffffff">books</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/books/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/books/service.py</a></font></td></tr></table>
+ <p><tt>Extend gdata.service.<a href="gdata.service.html#GDataService">GDataService</a> to support authenticated CRUD ops on <br>
+Books API<br>
+ <br>
+<a href="http://code.google.com/apis/books/docs/getting-started.html">http://code.google.com/apis/books/docs/getting-started.html</a><br>
+<a href="http://code.google.com/apis/books/docs/gdata/developers_guide_protocol.html">http://code.google.com/apis/books/docs/gdata/developers_guide_protocol.html</a><br>
+ <br>
+TODO: (here and __init__)<br>
+ * search based on label, review, or other annotations (possible?)<br>
+ * edit (specifically, Put requests) seem to fail effect a change<br>
+ <br>
+Problems With API:<br>
+ * Adding a book with a review to the library adds a note, not a review.<br>
+ This does not get included in the returned item. You see this by<br>
+ looking at My Library through the website.<br>
+ * Editing a review never edits a review (unless it is freshly added, but <br>
+ see above). More generally,<br>
+ * a Put request with changed annotations (label/rating/review) does NOT<br>
+ change the data. Note: Put requests only work on the href from <br>
+ GetEditLink (as per the spec). Do not try to PUT to the annotate or <br>
+ library feeds, this will cause a 400 Invalid URI Bad Request response.<br>
+ Attempting to Post to one of the feeds with the updated annotations<br>
+ does not update them. See the following for (hopefully) a follow up:<br>
+ google.com/support/forum/p/booksearch-apis/thread?tid=27fd7f68de438fc8<br>
+ * Attempts to workaround the edit problem continue to fail. For example,<br>
+ removing the item, editing the data, readding the item, gives us only<br>
+ our originally added data (annotations). This occurs even if we<br>
+ completely shut python down, refetch the book from the public feed,<br>
+ and re-add it. There is some kind of persistence going on that I<br>
+ cannot change. This is likely due to the annotations being cached in<br>
+ the annotation feed and the inability to edit (see Put, above)<br>
+ * GetAnnotationLink has www.books.... as the server, but hitting www...<br>
+ results in a bad URI error.<br>
+ * Spec indicates there may be multiple labels, but there does not seem<br>
+ to be a way to get the server to accept multiple labels, nor does the<br>
+ web interface have an obvious way to have multiple labels. Multiple <br>
+ labels are never returned.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.books.html">gdata.books</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.books.service.html#BookService">BookService</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BookService">class <strong>BookService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.books.service.html#BookService">BookService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BookService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='books.google.com'</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, exception_handlers<font color="#909090">=()</font>, **kwargs)</dt><dd><tt>source should be of form 'ProgramCompany - ProgramName - Version'</tt></dd></dl>
+
+<dl><dt><a name="BookService-add_annotation"><strong>add_annotation</strong></a>(self, item)</dt><dd><tt>Add the item, either an XML string or books.Book instance, to the <br>
+user's annotation feed.</tt></dd></dl>
+
+<dl><dt><a name="BookService-add_item_to_library"><strong>add_item_to_library</strong></a>(self, item)</dt><dd><tt>Add the item, either an XML string or books.Book instance, to the <br>
+user's library feed</tt></dd></dl>
+
+<dl><dt><a name="BookService-edit_annotation"><strong>edit_annotation</strong></a>(self, item)</dt><dd><tt>Send an edited item, a books.Book instance, to the user's annotation <br>
+feed. Note that whereas extra annotations in add_annotations, minus <br>
+ratings which are immutable once set, are simply added to the item in <br>
+the annotation feed, if an annotation has been removed from the item, <br>
+sending an edit request will remove that annotation. This should not <br>
+happen with add_annotation.</tt></dd></dl>
+
+<dl><dt><a name="BookService-get_annotations"><strong>get_annotations</strong></a>(self, id<font color="#909090">='me'</font>, start_index<font color="#909090">='1'</font>, max_results<font color="#909090">='100'</font>, min_viewability<font color="#909090">='none'</font>, converter<font color="#909090">=<bound method type.FromString of <class 'gdata.books.BookFeed'>></font>)</dt><dd><tt>Like get_library, but for the annotation feed</tt></dd></dl>
+
+<dl><dt><a name="BookService-get_by_google_id"><strong>get_by_google_id</strong></a>(self, id)</dt></dl>
+
+<dl><dt><a name="BookService-get_library"><strong>get_library</strong></a>(self, id<font color="#909090">='me'</font>, feed<font color="#909090">='/books/feeds/users/%s/collections/library/volumes'</font>, start_index<font color="#909090">='1'</font>, max_results<font color="#909090">='100'</font>, min_viewability<font color="#909090">='none'</font>, converter<font color="#909090">=<bound method type.FromString of <class 'gdata.books.BookFeed'>></font>)</dt><dd><tt>Return a generator object that will return gbook.Book instances until<br>
+the search feed no longer returns an item from the GetNextLink method.<br>
+Thus max_results is not the maximum number of items that will be<br>
+returned, but rather the number of items per page of searches. This has<br>
+been set high to reduce the required number of network requests.</tt></dd></dl>
+
+<dl><dt><a name="BookService-remove_item_from_library"><strong>remove_item_from_library</strong></a>(self, item)</dt><dd><tt>Remove the item, a books.Book instance, from the authenticated user's <br>
+library feed. Using an item retrieved from a public search will fail.</tt></dd></dl>
+
+<dl><dt><a name="BookService-search"><strong>search</strong></a>(self, q, start_index<font color="#909090">='1'</font>, max_results<font color="#909090">='10'</font>, min_viewability<font color="#909090">='none'</font>, feed<font color="#909090">='/books/feeds/volumes'</font>, converter<font color="#909090">=<bound method type.FromString of <class 'gdata.books.BookFeed'>></font>)</dt><dd><tt>Query the Public search feed. q is either a search string or a<br>
+gdata.service.Query instance with a query set.<br>
+ <br>
+min_viewability must be "none", "partial", or "full".<br>
+ <br>
+If you change the feed to a single item feed, note that you will <br>
+probably need to change the converter to be Book.FromString</tt></dd></dl>
+
+<dl><dt><a name="BookService-search_annotations"><strong>search_annotations</strong></a>(self, q, id<font color="#909090">='me'</font>, **kwargs)</dt><dd><tt>Like search, but in an annotation feed. Default is the authenticated<br>
+user's feed. Change by setting id.</tt></dd></dl>
+
+<dl><dt><a name="BookService-search_annotations_by_keyword"><strong>search_annotations_by_keyword</strong></a>(self, id<font color="#909090">='me'</font>, **kwargs)</dt><dd><tt>Hybrid of search_by_keyword and search_annotations</tt></dd></dl>
+
+<dl><dt><a name="BookService-search_by_keyword"><strong>search_by_keyword</strong></a>(self, q<font color="#909090">=''</font>, feed<font color="#909090">='/books/feeds/volumes'</font>, start_index<font color="#909090">='1'</font>, max_results<font color="#909090">='10'</font>, min_viewability<font color="#909090">='none'</font>, **kwargs)</dt><dd><tt>Query the Public Search Feed by keyword. Non-keyword strings can be<br>
+set in q. This is quite fragile. Is there a function somewhere in<br>
+the Google library that will parse a query the same way that Google<br>
+does?<br>
+ <br>
+Legal Identifiers are listed below and correspond to their meaning<br>
+at <a href="http://books.google.com/advanced_book_search">http://books.google.com/advanced_book_search</a>:<br>
+ all_words <br>
+ exact_phrase <br>
+ at_least_one <br>
+ without_words <br>
+ title<br>
+ author<br>
+ publisher<br>
+ subject<br>
+ isbn<br>
+ lccn<br>
+ oclc<br>
+ seemingly unsupported:<br>
+ publication_date: a sequence of two, two tuples:<br>
+ ((min_month,min_year),(max_month,max_year))<br>
+ where month is one/two digit month, year is 4 digit, eg:<br>
+ (('1','2000'),('10','2003')). Lower bound is inclusive,<br>
+ upper bound is exclusive</tt></dd></dl>
+
+<dl><dt><a name="BookService-search_library"><strong>search_library</strong></a>(self, q, id<font color="#909090">='me'</font>, **kwargs)</dt><dd><tt>Like search, but in a library feed. Default is the authenticated<br>
+user's feed. Change by setting id.</tt></dd></dl>
+
+<dl><dt><a name="BookService-search_library_by_keyword"><strong>search_library_by_keyword</strong></a>(self, id<font color="#909090">='me'</font>, **kwargs)</dt><dd><tt>Hybrid of search_by_keyword and search_library</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="BookService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="BookService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="BookService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="BookService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="BookService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="BookService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="BookService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="BookService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="BookService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="BookService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="BookService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt>Query the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="BookService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="BookService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="BookService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="BookService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BookService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#BookService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="BookService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="BookService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="BookService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="BookService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="BookService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="BookService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="BookService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#BookService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="BookService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#BookService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="BookService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="BookService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="BookService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="BookService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="BookService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="BookService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="BookService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="BookService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ACCOUNT_TYPE</strong> = 'HOSTED_OR_GOOGLE'<br>
+<strong>ANNOTATION_FEED</strong> = '/books/feeds/users/%s/volumes'<br>
+<strong>BOOK_SERVER</strong> = 'books.google.com'<br>
+<strong>BOOK_SERVICE</strong> = 'print'<br>
+<strong>GENERAL_FEED</strong> = '/books/feeds/volumes'<br>
+<strong>ITEM_FEED</strong> = '/books/feeds/volumes/'<br>
+<strong>LIBRARY_FEED</strong> = '/books/feeds/users/%s/collections/library/volumes'<br>
+<strong>PARTNER_FEED</strong> = '/books/feeds/p/%s/volumes'<br>
+<strong>__author__</strong> = 'James Sams <sams.james@gmail.com>'<br>
+<strong>__copyright__</strong> = 'Apache License v2.0'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">James Sams <sams.james@gmail.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.calendar.client.html b/pydocs/gdata.calendar.client.html
new file mode 100644
index 0000000..e9325bd
--- /dev/null
+++ b/pydocs/gdata.calendar.client.html
@@ -0,0 +1,957 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.calendar.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.calendar.html"><font color="#ffffff">calendar</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar/client.py</a></font></td></tr></table>
+ <p><tt><a href="#CalendarClient">CalendarClient</a> extends the GDataService to streamline Google Calendar operations.<br>
+ <br>
+CalendarService: Provides methods to query feeds and manipulate items. Extends<br>
+ GDataService.<br>
+ <br>
+DictionaryToParamList: Function which converts a dictionary into a list of<br>
+ URL arguments (represented as strings). This is a<br>
+ utility function used in CRUD operations.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.client.html#CalendarClient">CalendarClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#Query">gdata.client.Query</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.client.html#CalendarEventQuery">CalendarEventQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarClient">class <strong>CalendarClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Calendar service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.client.html#CalendarClient">CalendarClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarClient-ExecuteBatch"><strong>ExecuteBatch</strong></a> = <a href="#CalendarClient-execute_batch">execute_batch</a>(self, batch_feed, url, desired_class<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetAllCalendarsFeed"><strong>GetAllCalendarsFeed</strong></a> = <a href="#CalendarClient-get_all_calendars_feed">get_all_calendars_feed</a>(self, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetCalendarAclEntry"><strong>GetCalendarAclEntry</strong></a> = <a href="#CalendarClient-get_calendar_acl_entry">get_calendar_acl_entry</a>(self, uri, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarAclEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetCalendarAclFeed"><strong>GetCalendarAclFeed</strong></a> = <a href="#CalendarClient-get_calendar_acl_feed">get_calendar_acl_feed</a>(self, uri<font color="#909090">='https://www.google.com/calendar/feeds/default/acl/full'</font>, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarAclFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetCalendarEntry"><strong>GetCalendarEntry</strong></a> = <a href="#CalendarClient-get_calendar_entry">get_calendar_entry</a>(self, uri, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetCalendarEventFeed"><strong>GetCalendarEventFeed</strong></a> = <a href="#CalendarClient-get_calendar_event_feed">get_calendar_event_feed</a>(self, uri<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarEventFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetCalendarEventFeedUri"><strong>GetCalendarEventFeedUri</strong></a> = <a href="#CalendarClient-get_calendar_event_feed_uri">get_calendar_event_feed_uri</a>(self, calendar<font color="#909090">='default'</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>, scheme<font color="#909090">='https'</font>)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetCalendarFeedUri"><strong>GetCalendarFeedUri</strong></a> = <a href="#CalendarClient-get_calendar_feed_uri">get_calendar_feed_uri</a>(self, feed<font color="#909090">=''</font>, projection<font color="#909090">='full'</font>, scheme<font color="#909090">='https'</font>)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetCalendarsFeed"><strong>GetCalendarsFeed</strong></a> = <a href="#CalendarClient-get_calendars_feed">get_calendars_feed</a>(self, uri, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetEventEntry"><strong>GetEventEntry</strong></a> = <a href="#CalendarClient-get_event_entry">get_event_entry</a>(self, uri, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarEventEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetOwnCalendarsFeed"><strong>GetOwnCalendarsFeed</strong></a> = <a href="#CalendarClient-get_own_calendars_feed">get_own_calendars_feed</a>(self, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-InsertAclEntry"><strong>InsertAclEntry</strong></a> = <a href="#CalendarClient-insert_acl_entry">insert_acl_entry</a>(self, new_acl_entry, insert_uri<font color="#909090">='https://www.google.com/calendar/feeds/default/acl/full'</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-InsertCalendar"><strong>InsertCalendar</strong></a> = <a href="#CalendarClient-insert_calendar">insert_calendar</a>(self, new_calendar, insert_uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-InsertCalendarSubscription"><strong>InsertCalendarSubscription</strong></a> = <a href="#CalendarClient-insert_calendar_subscription">insert_calendar_subscription</a>(self, calendar, insert_uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-InsertEvent"><strong>InsertEvent</strong></a> = <a href="#CalendarClient-insert_event">insert_event</a>(self, new_event, insert_uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-Update"><strong>Update</strong></a> = <a href="#CalendarClient-update">update</a>(self, entry, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-__init__"><strong>__init__</strong></a>(self, domain<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a new client for the Calendar API.<br>
+ <br>
+Args:<br>
+ domain: string The Google Apps domain (if any).<br>
+ kwargs: The other parameters to pass to the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a><br>
+ constructor.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-execute_batch"><strong>execute_batch</strong></a>(self, batch_feed, url, desired_class<font color="#909090">=None</font>)</dt><dd><tt>Sends a batch request feed to the server.<br>
+ <br>
+Args:<br>
+ batch_feed: gdata.contacts.CalendarEventFeed A feed containing batch<br>
+ request entries. Each entry contains the operation to be performed<br>
+ on the data contained in the entry. For example an entry with an<br>
+ operation type of insert will be used as if the individual entry<br>
+ had been inserted.<br>
+ url: str The batch URL to which these operations should be applied.<br>
+ converter: Function (optional) The function used to convert the server's<br>
+ response to an object.<br>
+ <br>
+Returns:<br>
+ The results of the batch request's execution on the server. If the<br>
+ default converter is used, this is stored in a ContactsFeed.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_all_calendars_feed"><strong>get_all_calendars_feed</strong></a>(self, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Obtains a feed containing all the ccalendars the current user has access to.<br>
+ <br>
+Args:<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (desired_class=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.calendar.data.CalendarFeed.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of SpreadsheetsClient.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_calendar_acl_entry"><strong>get_calendar_acl_entry</strong></a>(self, uri, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarAclEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Obtains a single Access Control List entry.<br>
+ <br>
+Args:<br>
+ uri: The uri of the desired Acl feed.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (desired_class=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.calendar.data.CalendarAclEntry.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of SpreadsheetsClient.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_calendar_acl_feed"><strong>get_calendar_acl_feed</strong></a>(self, uri<font color="#909090">='https://www.google.com/calendar/feeds/default/acl/full'</font>, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarAclFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Obtains an Access Control List feed.<br>
+ <br>
+Args:<br>
+ uri: The uri of the desired Acl feed.<br>
+ Defaults to https://www.google.com/calendar/feeds/default/acl/full.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (desired_class=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.calendar.data.CalendarAclFeed.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of SpreadsheetsClient.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_calendar_entry"><strong>get_calendar_entry</strong></a>(self, uri, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Obtains a single calendar entry.<br>
+ <br>
+Args:<br>
+ uri: The uri of the desired calendar entry.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (desired_class=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.calendar.data.CalendarEntry.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of SpreadsheetsClient.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_calendar_event_feed"><strong>get_calendar_event_feed</strong></a>(self, uri<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarEventFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Obtains a feed of events for the desired calendar.<br>
+ <br>
+Args:<br>
+ uri: The uri of the desired calendar entry.<br>
+ Defaults to https://www.google.com/calendar/feeds/default/private/full.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (desired_class=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.calendar.data.CalendarEventFeed.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of SpreadsheetsClient.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_calendar_event_feed_uri"><strong>get_calendar_event_feed_uri</strong></a>(self, calendar<font color="#909090">='default'</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>, scheme<font color="#909090">='https'</font>)</dt><dd><tt>Builds a feed URI.<br>
+ <br>
+Args:<br>
+ projection: The projection to apply to the feed contents, for example<br>
+ 'full', 'base', 'base/12345', 'full/batch'. Default value: 'full'.<br>
+ scheme: The URL scheme such as 'http' or 'https', None to return a<br>
+ relative URI without hostname.<br>
+ <br>
+Returns:<br>
+ A feed URI using the given scheme and projection.<br>
+ Example: '/calendar/feeds/default/private/full'.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_calendar_feed_uri"><strong>get_calendar_feed_uri</strong></a>(self, feed<font color="#909090">=''</font>, projection<font color="#909090">='full'</font>, scheme<font color="#909090">='https'</font>)</dt><dd><tt>Builds a feed URI.<br>
+ <br>
+Args:<br>
+ projection: The projection to apply to the feed contents, for example<br>
+ 'full', 'base', 'base/12345', 'full/batch'. Default value: 'full'.<br>
+ scheme: The URL scheme such as 'http' or 'https', None to return a<br>
+ relative URI without hostname.<br>
+ <br>
+Returns:<br>
+ A feed URI using the given scheme and projection.<br>
+ Example: '/calendar/feeds/default/owncalendars/full'.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_calendars_feed"><strong>get_calendars_feed</strong></a>(self, uri, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Obtains a calendar feed.<br>
+ <br>
+Args:<br>
+ uri: The uri of the calendar feed to request.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (desired_class=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.calendar.data.CalendarFeed.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of SpreadsheetsClient.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_event_entry"><strong>get_event_entry</strong></a>(self, uri, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarEventEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Obtains a single event entry.<br>
+ <br>
+Args:<br>
+ uri: The uri of the desired calendar event entry.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (desired_class=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.calendar.data.CalendarEventEntry.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of SpreadsheetsClient.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_own_calendars_feed"><strong>get_own_calendars_feed</strong></a>(self, desired_class<font color="#909090">=<class 'gdata.calendar.data.CalendarFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Obtains a feed containing the calendars owned by the current user.<br>
+ <br>
+Args:<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (desired_class=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.calendar.data.CalendarFeed.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of SpreadsheetsClient.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-insert_acl_entry"><strong>insert_acl_entry</strong></a>(self, new_acl_entry, insert_uri<font color="#909090">='https://www.google.com/calendar/feeds/default/acl/full'</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds an new Acl entry to Google Calendar.<br>
+ <br>
+Args:<br>
+ new_acl_event: atom.Entry or subclass A new acl which is to be added to<br>
+ Google Calendar.<br>
+ insert_uri: the URL to post new contacts to the feed<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the contact created<br>
+ On failure, a RequestError is raised of the form:<br>
+ {'status': HTTP status code from server,<br>
+ 'reason': HTTP reason from the server,<br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-insert_calendar"><strong>insert_calendar</strong></a>(self, new_calendar, insert_uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds an new calendar to Google Calendar.<br>
+ <br>
+Args:<br>
+ new_calendar: atom.Entry or subclass A new calendar which is to be added to<br>
+ Google Calendar.<br>
+ insert_uri: the URL to post new contacts to the feed<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the contact created<br>
+ On failure, a RequestError is raised of the form:<br>
+ {'status': HTTP status code from server,<br>
+ 'reason': HTTP reason from the server,<br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-insert_calendar_subscription"><strong>insert_calendar_subscription</strong></a>(self, calendar, insert_uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Subscribes the authenticated user to the provided calendar.<br>
+ <br>
+Args:<br>
+ calendar: The calendar to which the user should be subscribed.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the subscription created<br>
+ On failure, a RequestError is raised of the form:<br>
+ {'status': HTTP status code from server,<br>
+ 'reason': HTTP reason from the server,<br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-insert_event"><strong>insert_event</strong></a>(self, new_event, insert_uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds an new event to Google Calendar.<br>
+ <br>
+Args:<br>
+ new_event: atom.Entry or subclass A new event which is to be added to<br>
+ Google Calendar.<br>
+ insert_uri: the URL to post new contacts to the feed<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the contact created<br>
+ On failure, a RequestError is raised of the form:<br>
+ {'status': HTTP status code from server,<br>
+ 'reason': HTTP reason from the server,<br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '2'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://www.google.com/calendar/feeds/', 'http://www.google.com/calendar/feeds/')</dl>
+
+<dl><dt><strong>auth_service</strong> = 'cl'</dl>
+
+<dl><dt><strong>contact_list</strong> = 'default'</dl>
+
+<dl><dt><strong>server</strong> = 'www.google.com'</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="CalendarClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="CalendarClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="CalendarClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="CalendarClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="CalendarClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarEventQuery">class <strong>CalendarEventQuery</strong></a>(<a href="gdata.client.html#Query">gdata.client.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Create a custom Calendar <a href="gdata.client.html#Query">Query</a><br>
+ <br>
+Full specs can be found at: U{Calendar query parameters reference<br>
+<<a href="http://code.google.com/apis/calendar/data/2.0/reference.html#Parameters">http://code.google.com/apis/calendar/data/2.0/reference.html#Parameters</a>>}<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.client.html#CalendarEventQuery">CalendarEventQuery</a></dd>
+<dd><a href="gdata.client.html#Query">gdata.client.Query</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarEventQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#CalendarEventQuery-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="CalendarEventQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, ctz<font color="#909090">=None</font>, fields<font color="#909090">=None</font>, futureevents<font color="#909090">=None</font>, max_attendees<font color="#909090">=None</font>, orderby<font color="#909090">=None</font>, recurrence_expansion_start<font color="#909090">=None</font>, recurrence_expansion_end<font color="#909090">=None</font>, singleevents<font color="#909090">=None</font>, showdeleted<font color="#909090">=None</font>, showhidden<font color="#909090">=None</font>, sortorder<font color="#909090">=None</font>, start_min<font color="#909090">=None</font>, start_max<font color="#909090">=None</font>, updated_min<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>@param max_results: The maximum number of entries to return. If you want<br>
+ to receive all of the contacts, rather than only the default maximum, you<br>
+ can specify a very large number for max-results.<br>
+@param start-index: The 1-based index of the first result to be retrieved.<br>
+@param updated-min: The lower bound on entry update dates.<br>
+@param group: Constrains the results to only the contacts belonging to the<br>
+ group specified. Value of this parameter specifies group ID<br>
+@param orderby: Sorting criterion. The only supported value is<br>
+ lastmodified.<br>
+@param showdeleted: Include deleted contacts in the returned contacts feed<br>
+@pram sortorder: Sorting order direction. Can be either ascending or<br>
+ descending.<br>
+@param requirealldeleted: Only relevant if showdeleted and updated-min<br>
+ are also provided. It dictates the behavior of the server in case it<br>
+ detects that placeholders of some entries deleted since the point in<br>
+ time specified as updated-min may have been lost.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><a name="CalendarEventQuery-AddCustomParameter"><strong>AddCustomParameter</strong></a> = add_custom_parameter(self, key, value)</dt></dl>
+
+<dl><dt><a name="CalendarEventQuery-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DEFAULT_BATCH_URL</strong> = 'https://www.google.com/calendar/feeds/default/private/full/batch'<br>
+<strong>__author__</strong> = 'alainv (Alain Vongsouvanh)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">alainv (Alain Vongsouvanh)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.calendar.data.html b/pydocs/gdata.calendar.data.html
new file mode 100644
index 0000000..3236a48
--- /dev/null
+++ b/pydocs/gdata.calendar.data.html
@@ -0,0 +1,9236 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.calendar.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.calendar.html"><font color="#ffffff">calendar</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar/data.py</a></font></td></tr></table>
+ <p><tt>Contains the data classes of the Google Calendar Data API</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#AccessLevelProperty">AccessLevelProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#AllowGSync2Property">AllowGSync2Property</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#AllowGSyncProperty">AllowGSyncProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#AnyoneCanAddSelfProperty">AnyoneCanAddSelfProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#ColorProperty">ColorProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#GuestsCanInviteOthersProperty">GuestsCanInviteOthersProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#GuestsCanModifyProperty">GuestsCanModifyProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#GuestsCanSeeGuestsProperty">GuestsCanSeeGuestsProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#HiddenProperty">HiddenProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#IcalUIDProperty">IcalUIDProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#OverrideNameProperty">OverrideNameProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#PrivateCopyProperty">PrivateCopyProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#QuickAddProperty">QuickAddProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#ResourceProperty">ResourceProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#SelectedProperty">SelectedProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#SendAclNotificationsProperty">SendAclNotificationsProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#SendEventNotificationsProperty">SendEventNotificationsProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#SequenceNumberProperty">SequenceNumberProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#SettingsProperty">SettingsProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#SuppressReplyNotificationsProperty">SuppressReplyNotificationsProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#SyncEventProperty">SyncEventProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#TimeZoneProperty">TimeZoneProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#TimesCleanedProperty">TimesCleanedProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#WebContent">WebContent</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#WebContentGadgetPref">WebContentGadgetPref</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Link">atom.data.Link</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#WebContentLink">WebContentLink</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarAclEntry">CalendarAclEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclRole">gdata.acl.data.AclRole</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarAclRole">CalendarAclRole</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarEventEntry">CalendarEventEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarEventFeed">CalendarEventFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#Comments">gdata.data.Comments</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarComments">CalendarComments</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#ExtendedProperty">gdata.data.ExtendedProperty</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarExtendedProperty">CalendarExtendedProperty</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarCommentEntry">CalendarCommentEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarEntry">CalendarEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarRecurrenceExceptionEntry">CalendarRecurrenceExceptionEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#SettingsEntry">SettingsEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarAclFeed">CalendarAclFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarCommentFeed">CalendarCommentFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarFeed">CalendarFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarSettingsFeed">CalendarSettingsFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#RecurrenceException">gdata.data.RecurrenceException</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarRecurrenceException">CalendarRecurrenceException</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#When">gdata.data.When</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#When">When</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#Where">gdata.data.Where</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#CalendarWhere">CalendarWhere</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#Who">gdata.data.Who</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.data.html#EventWho">EventWho</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AccessLevelProperty">class <strong>AccessLevelProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes how much a given user may do with an event or calendar<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#AccessLevelProperty">AccessLevelProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AccessLevelProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccessLevelProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccessLevelProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AccessLevelProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccessLevelProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AccessLevelProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AccessLevelProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AccessLevelProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AccessLevelProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AccessLevelProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AllowGSync2Property">class <strong>AllowGSync2Property</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Whether the user is permitted to run Google Apps Sync<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#AllowGSync2Property">AllowGSync2Property</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AllowGSync2Property-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSync2Property-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSync2Property-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSync2Property-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSync2Property-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSync2Property-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AllowGSync2Property-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AllowGSync2Property-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSync2Property-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSync2Property-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AllowGSyncProperty">class <strong>AllowGSyncProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Whether the user is permitted to run Google Apps Sync<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#AllowGSyncProperty">AllowGSyncProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AllowGSyncProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSyncProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSyncProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSyncProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSyncProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSyncProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AllowGSyncProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AllowGSyncProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSyncProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AllowGSyncProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AnyoneCanAddSelfProperty">class <strong>AnyoneCanAddSelfProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Whether anyone can add self as attendee<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#AnyoneCanAddSelfProperty">AnyoneCanAddSelfProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AnyoneCanAddSelfProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AnyoneCanAddSelfProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AnyoneCanAddSelfProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AnyoneCanAddSelfProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AnyoneCanAddSelfProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AnyoneCanAddSelfProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AnyoneCanAddSelfProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AnyoneCanAddSelfProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AnyoneCanAddSelfProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AnyoneCanAddSelfProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarAclEntry">class <strong>CalendarAclEntry</strong></a>(<a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an entry in a feed of a Calendar access control list (ACL)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarAclEntry">CalendarAclEntry</a></dd>
+<dd><a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>send_acl_notifications</strong> = <class 'gdata.calendar.data.SendAclNotificationsProperty'><dd><tt>Describes whether to send ACL notifications to grantees</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a>:<br>
+<dl><dt><strong>additional_role</strong> = <class 'gdata.acl.data.AclAdditionalRole'><dd><tt>Describes an additionalRole element.</tt></dl>
+
+<dl><dt><strong>role</strong> = <class 'gdata.acl.data.AclRole'><dd><tt>Describes the role of an entry in an access control list.</tt></dl>
+
+<dl><dt><strong>scope</strong> = <class 'gdata.acl.data.AclScope'><dd><tt>Describes the scope of an entry in an access control list.</tt></dl>
+
+<dl><dt><strong>with_key</strong> = <class 'gdata.acl.data.AclWithKey'><dd><tt>Describes a key that can be used to access a document.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CalendarAclEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CalendarAclEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarAclEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarAclEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarAclEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarAclFeed">class <strong>CalendarAclFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a Calendar access contorl list (ACL) feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarAclFeed">CalendarAclFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.calendar.data.CalendarAclEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CalendarAclFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CalendarAclFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarAclFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarAclFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarAclFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarAclRole">class <strong>CalendarAclRole</strong></a>(<a href="gdata.acl.data.html#AclRole">gdata.acl.data.AclRole</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the Calendar roles of an entry in the Calendar access control list<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarAclRole">CalendarAclRole</a></dd>
+<dd><a href="gdata.acl.data.html#AclRole">gdata.acl.data.AclRole</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.acl.data.html#AclRole">gdata.acl.data.AclRole</a>:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarAclRole-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclRole-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclRole-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclRole-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclRole-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclRole-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarAclRole-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclRole-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclRole-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclRole-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarCommentEntry">class <strong>CalendarCommentEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an entry in a feed of a Calendar event's comments<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarCommentEntry">CalendarCommentEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CalendarCommentEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CalendarCommentEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarCommentEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarCommentEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarCommentEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarCommentFeed">class <strong>CalendarCommentFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes feed of a Calendar event's comments<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarCommentFeed">CalendarCommentFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.calendar.data.CalendarCommentEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CalendarCommentFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CalendarCommentFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarCommentFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarCommentFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarCommentFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarCommentFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarComments">class <strong>CalendarComments</strong></a>(<a href="gdata.data.html#Comments">gdata.data.Comments</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a container of a feed link for Calendar comment entries<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarComments">CalendarComments</a></dd>
+<dd><a href="gdata.data.html#Comments">gdata.data.Comments</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#Comments">gdata.data.Comments</a>:<br>
+<dl><dt><strong>feed_link</strong> = <class 'gdata.data.FeedLink'><dd><tt>The gd:feedLink element.<br>
+ <br>
+Represents a logically nested feed. For example, a calendar feed might<br>
+have a nested feed representing all comments on entries.</tt></dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarComments-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarComments-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarComments-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarComments-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarComments-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarComments-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarComments-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarComments-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarComments-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarComments-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarEntry">class <strong>CalendarEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a Calendar entry in the feed of a user's calendars<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarEntry">CalendarEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>accesslevel</strong> = <class 'gdata.calendar.data.AccessLevelProperty'><dd><tt>Describes how much a given user may do with an event or calendar</tt></dl>
+
+<dl><dt><strong>color</strong> = <class 'gdata.calendar.data.ColorProperty'><dd><tt>Describes the color of a calendar</tt></dl>
+
+<dl><dt><strong>hidden</strong> = <class 'gdata.calendar.data.HiddenProperty'><dd><tt>Describes whether a calendar is hidden</tt></dl>
+
+<dl><dt><strong>overridename</strong> = <class 'gdata.calendar.data.OverrideNameProperty'><dd><tt>Describes the override name property of a calendar</tt></dl>
+
+<dl><dt><strong>selected</strong> = <class 'gdata.calendar.data.SelectedProperty'><dd><tt>Describes whether a calendar is selected</tt></dl>
+
+<dl><dt><strong>times_cleaned</strong> = <class 'gdata.calendar.data.TimesCleanedProperty'><dd><tt>Describes how many times calendar was cleaned via Manage Calendars</tt></dl>
+
+<dl><dt><strong>timezone</strong> = <class 'gdata.calendar.data.TimeZoneProperty'><dd><tt>Describes the time zone of a calendar</tt></dl>
+
+<dl><dt><strong>where</strong> = [<class 'gdata.calendar.data.CalendarWhere'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CalendarEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CalendarEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarEventEntry">class <strong>CalendarEventEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a Calendar event entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarEventEntry">CalendarEventEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>anyone_can_add_self</strong> = <class 'gdata.calendar.data.AnyoneCanAddSelfProperty'><dd><tt>Whether anyone can add self as attendee</tt></dl>
+
+<dl><dt><strong>comments</strong> = <class 'gdata.data.Comments'><dd><tt>The gd:comments element.<br>
+ <br>
+Contains a comments feed for the enclosing entry (such as a calendar event).</tt></dl>
+
+<dl><dt><strong>event_status</strong> = <class 'gdata.data.EventStatus'><dd><tt>The gd:eventStatus element.</tt></dl>
+
+<dl><dt><strong>extended_property</strong> = [<class 'gdata.calendar.data.CalendarExtendedProperty'>]</dl>
+
+<dl><dt><strong>georss_where</strong> = <class 'gdata.geo.data.GeoRssWhere'><dd><tt>Describes a geographical location or region.</tt></dl>
+
+<dl><dt><strong>guests_can_invite_others</strong> = <class 'gdata.calendar.data.GuestsCanInviteOthersProperty'><dd><tt>Whether guests can invite others to the event</tt></dl>
+
+<dl><dt><strong>guests_can_modify</strong> = <class 'gdata.calendar.data.GuestsCanModifyProperty'><dd><tt>Whether guests can modify event</tt></dl>
+
+<dl><dt><strong>guests_can_see_guests</strong> = <class 'gdata.calendar.data.GuestsCanSeeGuestsProperty'><dd><tt>Whether guests can see other attendees</tt></dl>
+
+<dl><dt><strong>original_event</strong> = <class 'gdata.data.OriginalEvent'><dd><tt>The gd:originalEvent element.<br>
+ <br>
+Equivalent to the Recurrence ID property specified in section 4.8.4.4<br>
+of <a href="http://www.rfc-editor.org/rfc/rfc2445.txt">RFC 2445</a>. Appears in every instance of a recurring event, to identify<br>
+the original event.<br>
+ <br>
+Contains a <gd:when> element specifying the original start time of the<br>
+instance that has become an exception.</tt></dl>
+
+<dl><dt><strong>private_copy</strong> = <class 'gdata.calendar.data.PrivateCopyProperty'><dd><tt>Indicates whether this is a private copy of the event, changes to which should not be sent to other calendars</tt></dl>
+
+<dl><dt><strong>quick_add</strong> = <class 'gdata.calendar.data.QuickAddProperty'><dd><tt>Describes whether gd:content is for quick-add processing</tt></dl>
+
+<dl><dt><strong>recurrence</strong> = <class 'gdata.data.Recurrence'><dd><tt>The gd:recurrence element.<br>
+ <br>
+Represents the dates and times when a recurring event takes place.<br>
+ <br>
+The string that defines the recurrence consists of a set of properties,<br>
+each of which is defined in the iCalendar standard (<a href="http://www.rfc-editor.org/rfc/rfc2445.txt">RFC 2445</a>).<br>
+ <br>
+Specifically, the string usually begins with a DTSTART property that<br>
+indicates the starting time of the first instance of the event, and<br>
+often a DTEND property or a DURATION property to indicate when the<br>
+first instance ends. Next come RRULE, RDATE, EXRULE, and/or EXDATE<br>
+properties, which collectively define a recurring event and its<br>
+exceptions (but see below). (See section 4.8.5 of <a href="http://www.rfc-editor.org/rfc/rfc2445.txt">RFC 2445</a> for more<br>
+information about these recurrence component properties.) Last comes a<br>
+VTIMEZONE component, providing detailed timezone rules for any timezone<br>
+ID mentioned in the preceding properties.<br>
+ <br>
+Google services like Google Calendar don't generally generate EXRULE<br>
+and EXDATE properties to represent exceptions to recurring events;<br>
+instead, they generate <gd:recurrenceException> elements. However,<br>
+Google services may include EXRULE and/or EXDATE properties anyway;<br>
+for example, users can import events and exceptions into Calendar, and<br>
+if those imported events contain EXRULE or EXDATE properties, then<br>
+Calendar will provide those properties when it sends a <gd:recurrence><br>
+element.<br>
+ <br>
+Note the the use of <gd:recurrenceException> means that you can't be<br>
+sure just from examining a <gd:recurrence> element whether there are<br>
+any exceptions to the recurrence description. To ensure that you find<br>
+all exceptions, look for <gd:recurrenceException> elements in the feed,<br>
+and use their <gd:originalEvent> elements to match them up with<br>
+<gd:recurrence> elements.</tt></dl>
+
+<dl><dt><strong>recurrence_exception</strong> = [<class 'gdata.data.RecurrenceException'>]</dl>
+
+<dl><dt><strong>reminder</strong> = [<class 'gdata.data.Reminder'>]</dl>
+
+<dl><dt><strong>send_event_notifications</strong> = <class 'gdata.calendar.data.SendEventNotificationsProperty'><dd><tt>Describes whether to send event notifications to other participants of the event</tt></dl>
+
+<dl><dt><strong>sequence</strong> = <class 'gdata.calendar.data.SequenceNumberProperty'><dd><tt>Describes sequence number of an event</tt></dl>
+
+<dl><dt><strong>suppress_reply_notifications</strong> = <class 'gdata.calendar.data.SuppressReplyNotificationsProperty'><dd><tt>Lists notification methods to be suppressed for this reply</tt></dl>
+
+<dl><dt><strong>sync_event</strong> = <class 'gdata.calendar.data.SyncEventProperty'><dd><tt>Describes whether this is a sync scenario where the Ical UID and Sequence number are honored during inserts and updates</tt></dl>
+
+<dl><dt><strong>transparency</strong> = <class 'gdata.data.Transparency'><dd><tt>The gd:transparency element:<br>
+ <br>
+Extensible enum corresponding to the TRANSP property defined in <a href="http://www.rfc-editor.org/rfc/rfc244.txt">RFC 244</a>.</tt></dl>
+
+<dl><dt><strong>uid</strong> = <class 'gdata.calendar.data.IcalUIDProperty'><dd><tt>Describes the UID in the ical export of the event</tt></dl>
+
+<dl><dt><strong>visibility</strong> = <class 'gdata.data.Visibility'><dd><tt>The gd:visibility element.</tt></dl>
+
+<dl><dt><strong>when</strong> = [<class 'gdata.calendar.data.When'>]</dl>
+
+<dl><dt><strong>where</strong> = [<class 'gdata.data.Where'>]</dl>
+
+<dl><dt><strong>who</strong> = [<class 'gdata.data.Who'>]</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CalendarEventEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CalendarEventEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarEventEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarEventFeed">class <strong>CalendarEventFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a Calendar event feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarEventFeed">CalendarEventFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>allow_g_sync</strong> = <class 'gdata.calendar.data.AllowGSyncProperty'><dd><tt>Whether the user is permitted to run Google Apps Sync</tt></dl>
+
+<dl><dt><strong>allow_g_sync2</strong> = <class 'gdata.calendar.data.AllowGSync2Property'><dd><tt>Whether the user is permitted to run Google Apps Sync</tt></dl>
+
+<dl><dt><strong>entry</strong> = [<class 'gdata.calendar.data.CalendarEventEntry'>]</dl>
+
+<dl><dt><strong>times_cleaned</strong> = <class 'gdata.calendar.data.TimesCleanedProperty'><dd><tt>Describes how many times calendar was cleaned via Manage Calendars</tt></dl>
+
+<dl><dt><strong>timezone</strong> = <class 'gdata.calendar.data.TimeZoneProperty'><dd><tt>Describes the time zone of a calendar</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="CalendarEventFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CalendarEventFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CalendarEventFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarEventFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarExtendedProperty">class <strong>CalendarExtendedProperty</strong></a>(<a href="gdata.data.html#ExtendedProperty">gdata.data.ExtendedProperty</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Defines a value for the realm attribute that is used only in the calendar API<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarExtendedProperty">CalendarExtendedProperty</a></dd>
+<dd><a href="gdata.data.html#ExtendedProperty">gdata.data.ExtendedProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.data.html#ExtendedProperty">gdata.data.ExtendedProperty</a>:<br>
+<dl><dt><a name="CalendarExtendedProperty-GetXmlBlob"><strong>GetXmlBlob</strong></a> = get_xml_blob(self)</dt><dd><tt>Returns the XML blob as an atom.core.<a href="atom.core.html#XmlElement">XmlElement</a>.<br>
+ <br>
+Returns:<br>
+ An <a href="atom.core.html#XmlElement">XmlElement</a> representing the blob's XML, or None if no<br>
+ blob was set.</tt></dd></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-SetXmlBlob"><strong>SetXmlBlob</strong></a> = set_xml_blob(self, blob)</dt><dd><tt>Sets the contents of the extendedProperty to XML as a child node.<br>
+ <br>
+Since the extendedProperty is only allowed one child element as an XML<br>
+blob, setting the XML blob will erase any preexisting member elements<br>
+in this object.<br>
+ <br>
+Args:<br>
+ blob: str or atom.core.<a href="atom.core.html#XmlElement">XmlElement</a> representing the XML blob stored in<br>
+ the extendedProperty.</tt></dd></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-get_xml_blob"><strong>get_xml_blob</strong></a>(self)</dt><dd><tt>Returns the XML blob as an atom.core.<a href="atom.core.html#XmlElement">XmlElement</a>.<br>
+ <br>
+Returns:<br>
+ An <a href="atom.core.html#XmlElement">XmlElement</a> representing the blob's XML, or None if no<br>
+ blob was set.</tt></dd></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-set_xml_blob"><strong>set_xml_blob</strong></a>(self, blob)</dt><dd><tt>Sets the contents of the extendedProperty to XML as a child node.<br>
+ <br>
+Since the extendedProperty is only allowed one child element as an XML<br>
+blob, setting the XML blob will erase any preexisting member elements<br>
+in this object.<br>
+ <br>
+Args:<br>
+ blob: str or atom.core.<a href="atom.core.html#XmlElement">XmlElement</a> representing the XML blob stored in<br>
+ the extendedProperty.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#ExtendedProperty">gdata.data.ExtendedProperty</a>:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarExtendedProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarExtendedProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarFeed">class <strong>CalendarFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a feed of Calendars<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarFeed">CalendarFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.calendar.data.CalendarEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CalendarFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CalendarFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarRecurrenceException">class <strong>CalendarRecurrenceException</strong></a>(<a href="gdata.data.html#RecurrenceException">gdata.data.RecurrenceException</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an exception to a recurring Calendar event<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarRecurrenceException">CalendarRecurrenceException</a></dd>
+<dd><a href="gdata.data.html#RecurrenceException">gdata.data.RecurrenceException</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#RecurrenceException">gdata.data.RecurrenceException</a>:<br>
+<dl><dt><strong>entry_link</strong> = <class 'gdata.data.EntryLink'><dd><tt>The gd:entryLink element.<br>
+ <br>
+Represents a logically nested entry. For example, a <gd:who><br>
+representing a contact might have a nested entry from a contact feed.</tt></dl>
+
+<dl><dt><strong>original_event</strong> = <class 'gdata.data.OriginalEvent'><dd><tt>The gd:originalEvent element.<br>
+ <br>
+Equivalent to the Recurrence ID property specified in section 4.8.4.4<br>
+of <a href="http://www.rfc-editor.org/rfc/rfc2445.txt">RFC 2445</a>. Appears in every instance of a recurring event, to identify<br>
+the original event.<br>
+ <br>
+Contains a <gd:when> element specifying the original start time of the<br>
+instance that has become an exception.</tt></dl>
+
+<dl><dt><strong>specialized</strong> = 'specialized'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarRecurrenceException-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceException-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceException-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceException-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceException-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceException-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceException-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceException-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceException-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceException-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarRecurrenceExceptionEntry">class <strong>CalendarRecurrenceExceptionEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an entry used by a Calendar recurrence exception entry link<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarRecurrenceExceptionEntry">CalendarRecurrenceExceptionEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>sequence</strong> = <class 'gdata.calendar.data.SequenceNumberProperty'><dd><tt>Describes sequence number of an event</tt></dl>
+
+<dl><dt><strong>uid</strong> = <class 'gdata.calendar.data.IcalUIDProperty'><dd><tt>Describes the UID in the ical export of the event</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarRecurrenceExceptionEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarSettingsFeed">class <strong>CalendarSettingsFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Personal settings for Calendar application<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarSettingsFeed">CalendarSettingsFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.calendar.data.SettingsEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CalendarSettingsFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CalendarSettingsFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarSettingsFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarSettingsFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarSettingsFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarSettingsFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarWhere">class <strong>CalendarWhere</strong></a>(<a href="gdata.data.html#Where">gdata.data.Where</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Extends the base <a href="gdata.data.html#Where">Where</a> class with Calendar extensions<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#CalendarWhere">CalendarWhere</a></dd>
+<dd><a href="gdata.data.html#Where">gdata.data.Where</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#Where">gdata.data.Where</a>:<br>
+<dl><dt><strong>entry_link</strong> = <class 'gdata.data.EntryLink'><dd><tt>The gd:entryLink element.<br>
+ <br>
+Represents a logically nested entry. For example, a <gd:who><br>
+representing a contact might have a nested entry from a contact feed.</tt></dl>
+
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>value</strong> = 'valueString'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarWhere-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarWhere-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarWhere-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarWhere-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarWhere-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarWhere-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarWhere-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarWhere-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarWhere-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarWhere-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ColorProperty">class <strong>ColorProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the color of a calendar<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#ColorProperty">ColorProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ColorProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ColorProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ColorProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ColorProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ColorProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ColorProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ColorProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ColorProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ColorProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ColorProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EventWho">class <strong>EventWho</strong></a>(<a href="gdata.data.html#Who">gdata.data.Who</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Extends the base <a href="gdata.data.html#Who">Who</a> class with Calendar extensions<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#EventWho">EventWho</a></dd>
+<dd><a href="gdata.data.html#Who">gdata.data.Who</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>resource</strong> = <class 'gdata.calendar.data.ResourceProperty'><dd><tt>Describes whether gd:who is a resource such as a conference room</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#Who">gdata.data.Who</a>:<br>
+<dl><dt><strong>attendee_status</strong> = <class 'gdata.data.AttendeeStatus'><dd><tt>The gd:attendeeStatus element.</tt></dl>
+
+<dl><dt><strong>attendee_type</strong> = <class 'gdata.data.AttendeeType'><dd><tt>The gd:attendeeType element.</tt></dl>
+
+<dl><dt><strong>email</strong> = 'email'</dl>
+
+<dl><dt><strong>entry_link</strong> = <class 'gdata.data.EntryLink'><dd><tt>The gd:entryLink element.<br>
+ <br>
+Represents a logically nested entry. For example, a <gd:who><br>
+representing a contact might have a nested entry from a contact feed.</tt></dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>value</strong> = 'valueString'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EventWho-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EventWho-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EventWho-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EventWho-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EventWho-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EventWho-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="EventWho-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EventWho-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EventWho-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EventWho-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GuestsCanInviteOthersProperty">class <strong>GuestsCanInviteOthersProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Whether guests can invite others to the event<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#GuestsCanInviteOthersProperty">GuestsCanInviteOthersProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GuestsCanInviteOthersProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanInviteOthersProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanInviteOthersProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanInviteOthersProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanInviteOthersProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanInviteOthersProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GuestsCanInviteOthersProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GuestsCanInviteOthersProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanInviteOthersProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanInviteOthersProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GuestsCanModifyProperty">class <strong>GuestsCanModifyProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Whether guests can modify event<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#GuestsCanModifyProperty">GuestsCanModifyProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GuestsCanModifyProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanModifyProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanModifyProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanModifyProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanModifyProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanModifyProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GuestsCanModifyProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GuestsCanModifyProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanModifyProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanModifyProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GuestsCanSeeGuestsProperty">class <strong>GuestsCanSeeGuestsProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Whether guests can see other attendees<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#GuestsCanSeeGuestsProperty">GuestsCanSeeGuestsProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GuestsCanSeeGuestsProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanSeeGuestsProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanSeeGuestsProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanSeeGuestsProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanSeeGuestsProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanSeeGuestsProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GuestsCanSeeGuestsProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GuestsCanSeeGuestsProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanSeeGuestsProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanSeeGuestsProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HiddenProperty">class <strong>HiddenProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes whether a calendar is hidden<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#HiddenProperty">HiddenProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="HiddenProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HiddenProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HiddenProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="HiddenProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HiddenProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="HiddenProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="HiddenProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="HiddenProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="HiddenProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HiddenProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="IcalUIDProperty">class <strong>IcalUIDProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the UID in the ical export of the event<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#IcalUIDProperty">IcalUIDProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="IcalUIDProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IcalUIDProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IcalUIDProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IcalUIDProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IcalUIDProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="IcalUIDProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="IcalUIDProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IcalUIDProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IcalUIDProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IcalUIDProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OverrideNameProperty">class <strong>OverrideNameProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the override name property of a calendar<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#OverrideNameProperty">OverrideNameProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OverrideNameProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OverrideNameProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OverrideNameProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OverrideNameProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OverrideNameProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="OverrideNameProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="OverrideNameProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OverrideNameProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OverrideNameProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OverrideNameProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PrivateCopyProperty">class <strong>PrivateCopyProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Indicates whether this is a private copy of the event, changes to which should not be sent to other calendars<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#PrivateCopyProperty">PrivateCopyProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PrivateCopyProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PrivateCopyProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PrivateCopyProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PrivateCopyProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PrivateCopyProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PrivateCopyProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="PrivateCopyProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PrivateCopyProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PrivateCopyProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PrivateCopyProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="QuickAddProperty">class <strong>QuickAddProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes whether gd:content is for quick-add processing<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#QuickAddProperty">QuickAddProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="QuickAddProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuickAddProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuickAddProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="QuickAddProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuickAddProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="QuickAddProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="QuickAddProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="QuickAddProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="QuickAddProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuickAddProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ResourceProperty">class <strong>ResourceProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes whether gd:who is a resource such as a conference room<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#ResourceProperty">ResourceProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>id</strong> = 'id'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ResourceProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ResourceProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ResourceProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ResourceProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ResourceProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SelectedProperty">class <strong>SelectedProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes whether a calendar is selected<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#SelectedProperty">SelectedProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SelectedProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SelectedProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SelectedProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SelectedProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SelectedProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SelectedProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SelectedProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SelectedProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SelectedProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SelectedProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SendAclNotificationsProperty">class <strong>SendAclNotificationsProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes whether to send ACL notifications to grantees<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#SendAclNotificationsProperty">SendAclNotificationsProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SendAclNotificationsProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SendAclNotificationsProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SendAclNotificationsProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SendAclNotificationsProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SendAclNotificationsProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SendAclNotificationsProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SendAclNotificationsProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SendAclNotificationsProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SendAclNotificationsProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SendAclNotificationsProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SendEventNotificationsProperty">class <strong>SendEventNotificationsProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes whether to send event notifications to other participants of the event<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#SendEventNotificationsProperty">SendEventNotificationsProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SendEventNotificationsProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SendEventNotificationsProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SendEventNotificationsProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SendEventNotificationsProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SendEventNotificationsProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SendEventNotificationsProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SendEventNotificationsProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SendEventNotificationsProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SendEventNotificationsProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SendEventNotificationsProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SequenceNumberProperty">class <strong>SequenceNumberProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes sequence number of an event<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#SequenceNumberProperty">SequenceNumberProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SequenceNumberProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SequenceNumberProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SequenceNumberProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SequenceNumberProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SequenceNumberProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SequenceNumberProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SequenceNumberProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SequenceNumberProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SequenceNumberProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SequenceNumberProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SettingsEntry">class <strong>SettingsEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a Calendar Settings property entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#SettingsEntry">SettingsEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>settings_property</strong> = <class 'gdata.calendar.data.SettingsProperty'><dd><tt>User preference name-value pair</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="SettingsEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="SettingsEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SettingsEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="SettingsEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="SettingsEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SettingsEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SettingsProperty">class <strong>SettingsProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User preference name-value pair<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#SettingsProperty">SettingsProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SettingsProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SettingsProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SettingsProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SettingsProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SettingsProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SettingsProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SettingsProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SettingsProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SettingsProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SettingsProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SuppressReplyNotificationsProperty">class <strong>SuppressReplyNotificationsProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Lists notification methods to be suppressed for this reply<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#SuppressReplyNotificationsProperty">SuppressReplyNotificationsProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>methods</strong> = 'methods'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SuppressReplyNotificationsProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SuppressReplyNotificationsProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SuppressReplyNotificationsProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SuppressReplyNotificationsProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SuppressReplyNotificationsProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SuppressReplyNotificationsProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SuppressReplyNotificationsProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SuppressReplyNotificationsProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SuppressReplyNotificationsProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SuppressReplyNotificationsProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SyncEventProperty">class <strong>SyncEventProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes whether this is a sync scenario where the Ical UID and Sequence number are honored during inserts and updates<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#SyncEventProperty">SyncEventProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SyncEventProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SyncEventProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SyncEventProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SyncEventProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SyncEventProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SyncEventProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SyncEventProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SyncEventProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SyncEventProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SyncEventProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TimeZoneProperty">class <strong>TimeZoneProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the time zone of a calendar<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#TimeZoneProperty">TimeZoneProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TimeZoneProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TimeZoneProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TimeZoneProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TimeZoneProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TimeZoneProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TimeZoneProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TimeZoneProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TimeZoneProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TimeZoneProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TimeZoneProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TimesCleanedProperty">class <strong>TimesCleanedProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes how many times calendar was cleaned via Manage Calendars<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#TimesCleanedProperty">TimesCleanedProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TimesCleanedProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TimesCleanedProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TimesCleanedProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TimesCleanedProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TimesCleanedProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TimesCleanedProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TimesCleanedProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TimesCleanedProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TimesCleanedProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TimesCleanedProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WebContent">class <strong>WebContent</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a "web content" extension<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#WebContent">WebContent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>display</strong> = 'display'</dl>
+
+<dl><dt><strong>height</strong> = 'height'</dl>
+
+<dl><dt><strong>url</strong> = 'url'</dl>
+
+<dl><dt><strong>web_content_gadget_pref</strong> = [<class 'gdata.calendar.data.WebContentGadgetPref'>]</dl>
+
+<dl><dt><strong>width</strong> = 'width'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="WebContent-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContent-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContent-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WebContent-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContent-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="WebContent-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="WebContent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WebContent-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WebContent-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContent-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WebContentGadgetPref">class <strong>WebContentGadgetPref</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a single web content gadget preference<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#WebContentGadgetPref">WebContentGadgetPref</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="WebContentGadgetPref-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContentGadgetPref-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContentGadgetPref-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WebContentGadgetPref-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContentGadgetPref-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="WebContentGadgetPref-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="WebContentGadgetPref-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WebContentGadgetPref-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WebContentGadgetPref-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContentGadgetPref-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WebContentLink">class <strong>WebContentLink</strong></a>(<a href="atom.data.html#Link">atom.data.Link</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a "web content" link<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#WebContentLink">WebContentLink</a></dd>
+<dd><a href="atom.data.html#Link">atom.data.Link</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="WebContentLink-__init__"><strong>__init__</strong></a>(self, title<font color="#909090">=None</font>, href<font color="#909090">=None</font>, link_type<font color="#909090">=None</font>, web_content<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>web_content</strong> = <class 'gdata.calendar.data.WebContent'><dd><tt>Describes a "web content" extension</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Link">atom.data.Link</a>:<br>
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<dl><dt><strong>hreflang</strong> = 'hreflang'</dl>
+
+<dl><dt><strong>length</strong> = 'length'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>title</strong> = 'title'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="WebContentLink-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContentLink-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContentLink-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WebContentLink-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContentLink-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="WebContentLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WebContentLink-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WebContentLink-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WebContentLink-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="When">class <strong>When</strong></a>(<a href="gdata.data.html#When">gdata.data.When</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Extends the gd:when element to add reminders<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.data.html#When">When</a></dd>
+<dd><a href="gdata.data.html#When">gdata.data.When</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>reminder</strong> = [<class 'gdata.data.Reminder'>]</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#When">gdata.data.When</a>:<br>
+<dl><dt><strong>end</strong> = 'endTime'</dl>
+
+<dl><dt><strong>start</strong> = 'startTime'</dl>
+
+<dl><dt><strong>value</strong> = 'valueString'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="When-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="When-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="When-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="When-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="When-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="When-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="When-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="When-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="When-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="When-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GCAL_NAMESPACE</strong> = 'http://schemas.google.com/gCal/2005'<br>
+<strong>GCAL_TEMPLATE</strong> = '{http://schemas.google.com/gCal/2005}%s'<br>
+<strong>WEB_CONTENT_LINK_REL</strong> = 'http://schemas.google.com/gCal/2005/webContent'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.calendar.html b/pydocs/gdata.calendar.html
new file mode 100644
index 0000000..9eeca05
--- /dev/null
+++ b/pydocs/gdata.calendar.html
@@ -0,0 +1,3072 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.calendar</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.calendar</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains extensions to ElementWrapper objects used with Google Calendar.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.calendar.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.calendar.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.calendar.service.html">service</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#Comments">Comments</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#GuestsCanInviteOthers">GuestsCanInviteOthers</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#GuestsCanModify">GuestsCanModify</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#GuestsCanSeeGuests">GuestsCanSeeGuests</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#OriginalEvent">OriginalEvent</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#QuickAdd">QuickAdd</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Recurrence">Recurrence</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#RecurrenceException">RecurrenceException</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Reminder">Reminder</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Scope">Scope</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#SendEventNotifications">SendEventNotifications</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Sequence">Sequence</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#SyncEvent">SyncEvent</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#UID">UID</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#AttendeeStatus">AttendeeStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#AttendeeType">AttendeeType</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#EventStatus">EventStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Transparency">Transparency</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Visibility">Visibility</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Who">Who</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#AccessLevel">AccessLevel</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Color">Color</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Hidden">Hidden</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Role">Role</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Selected">Selected</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Timezone">Timezone</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#WebContent">WebContent</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#WebContentGadgetPref">WebContentGadgetPref</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#When">When</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#Where">Where</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Link">atom.Link</a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#WebContentLink">WebContentLink</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchEntry">gdata.BatchEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarEventEntry">CalendarEventEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchFeed">gdata.BatchFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarEventFeed">CalendarEventFeed</a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#EntryLink">gdata.EntryLink</a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarEventEntryLink">CalendarEventEntryLink</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#ExtendedProperty">gdata.ExtendedProperty</a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#ExtendedProperty">ExtendedProperty</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarAclEntry">CalendarAclEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarEventCommentEntry">CalendarEventCommentEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarListEntry">CalendarListEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarAclFeed">CalendarAclFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarEventCommentFeed">CalendarEventCommentFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarListFeed">CalendarListFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#LinkFinder">gdata.LinkFinder</a>(<a href="atom.html#LinkFinder">atom.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarAclEntry">CalendarAclEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarAclFeed">CalendarAclFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarEventCommentEntry">CalendarEventCommentEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarEventCommentFeed">CalendarEventCommentFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarEventFeed">CalendarEventFeed</a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarListEntry">CalendarListEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.html#CalendarListFeed">CalendarListFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AccessLevel">class <strong>AccessLevel</strong></a>(<a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar accesslevel element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#AccessLevel">AccessLevel</a></dd>
+<dd><a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>:<br>
+<dl><dt><a name="AccessLevel-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="AccessLevel-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="AccessLevel-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="AccessLevel-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AttendeeStatus">class <strong>AttendeeStatus</strong></a>(<a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar attendeeStatus element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#AttendeeStatus">AttendeeStatus</a></dd>
+<dd><a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AttendeeStatus-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>attendee_enum</strong> = {'http://schemas.google.com/g/2005#event.accepted': 'ACCEPTED', 'http://schemas.google.com/g/2005#event.declined': 'DECLINED', 'http://schemas.google.com/g/2005#event.invited': 'INVITED', 'http://schemas.google.com/g/2005#event.tentative': 'TENTATIVE'}</dl>
+
+<hr>
+Methods inherited from <a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>:<br>
+<dl><dt><a name="AttendeeStatus-findKey"><strong>findKey</strong></a>(self, value)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="AttendeeStatus-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="AttendeeStatus-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AttendeeType">class <strong>AttendeeType</strong></a>(<a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar attendeeType element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#AttendeeType">AttendeeType</a></dd>
+<dd><a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AttendeeType-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>attendee_type_enum</strong> = {'http://schemas.google.com/g/2005#event.optional': 'OPTIONAL', 'http://schemas.google.com/g/2005#event.required': 'REQUIRED'}</dl>
+
+<hr>
+Methods inherited from <a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>:<br>
+<dl><dt><a name="AttendeeType-findKey"><strong>findKey</strong></a>(self, value)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="AttendeeType-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeType-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="AttendeeType-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarAclEntry">class <strong>CalendarAclEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Calendar ACL Entry flavor of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#CalendarAclEntry">CalendarAclEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarAclEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, scope<font color="#909090">=None</font>, role<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="CalendarAclEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CalendarAclEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CalendarAclEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarAclEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarAclEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarAclFeed">class <strong>CalendarAclFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Calendar ACL feed flavor of an Atom Feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#CalendarAclFeed">CalendarAclFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="CalendarAclFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of <a href="atom.html#Link">Link</a> instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CalendarAclFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CalendarAclFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarAclFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarAclFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarAclFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarEventCommentEntry">class <strong>CalendarEventCommentEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Calendar event comments entry flavor of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#CalendarEventCommentEntry">CalendarEventCommentEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="CalendarEventCommentEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Entry">atom.Entry</a>:<br>
+<dl><dt><a name="CalendarEventCommentEntry-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CalendarEventCommentEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CalendarEventCommentEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventCommentEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventCommentEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarEventCommentFeed">class <strong>CalendarEventCommentFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Calendar event comments feed flavor of an Atom Feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#CalendarEventCommentFeed">CalendarEventCommentFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="CalendarEventCommentFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of <a href="atom.html#Link">Link</a> instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CalendarEventCommentFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CalendarEventCommentFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventCommentFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventCommentFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarEventEntry">class <strong>CalendarEventEntry</strong></a>(<a href="gdata.html#BatchEntry">gdata.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Calendar flavor of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#CalendarEventEntry">CalendarEventEntry</a></dd>
+<dd><a href="gdata.html#BatchEntry">gdata.BatchEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarEventEntry-GetWebContentLink"><strong>GetWebContentLink</strong></a>(self)</dt><dd><tt>Finds the first link with rel set to WEB_CONTENT_REL<br>
+ <br>
+Returns:<br>
+ A gdata.calendar.<a href="#WebContentLink">WebContentLink</a> or none if none of the links had rel<br>
+ equal to WEB_CONTENT_REL</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, transparency<font color="#909090">=None</font>, comments<font color="#909090">=None</font>, event_status<font color="#909090">=None</font>, send_event_notifications<font color="#909090">=None</font>, visibility<font color="#909090">=None</font>, recurrence<font color="#909090">=None</font>, recurrence_exception<font color="#909090">=None</font>, where<font color="#909090">=None</font>, when<font color="#909090">=None</font>, who<font color="#909090">=None</font>, quick_add<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, original_event<font color="#909090">=None</font>, batch_operation<font color="#909090">=None</font>, batch_id<font color="#909090">=None</font>, batch_status<font color="#909090">=None</font>, sequence<font color="#909090">=None</font>, reminder<font color="#909090">=None</font>, sync_event<font color="#909090">=None</font>, uid<font color="#909090">=None</font>, guests_can_invite_others<font color="#909090">=None</font>, guests_can_modify<font color="#909090">=None</font>, guests_can_see_guests<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="CalendarEventEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CalendarEventEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CalendarEventEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarEventEntryLink">class <strong>CalendarEventEntryLink</strong></a>(<a href="gdata.html#EntryLink">gdata.EntryLink</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An entryLink which contains a calendar event entry<br>
+ <br>
+Within an event's recurranceExceptions, an entry link<br>
+points to a calendar event entry. This class exists<br>
+to capture the calendar specific extensions in the entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#CalendarEventEntryLink">CalendarEventEntryLink</a></dd>
+<dd><a href="gdata.html#EntryLink">gdata.EntryLink</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#EntryLink">gdata.EntryLink</a>:<br>
+<dl><dt><a name="CalendarEventEntryLink-__init__"><strong>__init__</strong></a>(self, href<font color="#909090">=None</font>, read_only<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CalendarEventEntryLink-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventEntryLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CalendarEventEntryLink-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarEventFeed">class <strong>CalendarEventFeed</strong></a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Calendar event feed flavor of an Atom Feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#CalendarEventFeed">CalendarEventFeed</a></dd>
+<dd><a href="gdata.html#BatchFeed">gdata.BatchFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarEventFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, interrupted<font color="#909090">=None</font>, timezone<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#BatchFeed">gdata.BatchFeed</a>:<br>
+<dl><dt><a name="CalendarEventFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+ <br>
+If the entry is not a <a href="gdata.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a>, atom.Entry, or another Entry flavor (optional) The<br>
+ entry which will be sent to the server as part of the batch request.<br>
+ The item must have a valid atom id so that the server knows which<br>
+ entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-AddDelete"><strong>AddDelete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-AddInsert"><strong>AddInsert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-AddQuery"><strong>AddQuery</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-AddUpdate"><strong>AddUpdate</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetBatchLink"><strong>GetBatchLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CalendarEventFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CalendarEventFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarEventFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarListEntry">class <strong>CalendarListEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Calendar meta Entry flavor of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#CalendarListEntry">CalendarListEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarListEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, color<font color="#909090">=None</font>, access_level<font color="#909090">=None</font>, hidden<font color="#909090">=None</font>, timezone<font color="#909090">=None</font>, selected<font color="#909090">=None</font>, where<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="CalendarListEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarListEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CalendarListEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarListEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CalendarListEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarListEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CalendarListEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CalendarListEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarListEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarListEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarListFeed">class <strong>CalendarListFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Calendar meta feed flavor of an Atom Feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#CalendarListFeed">CalendarListFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="CalendarListFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of <a href="atom.html#Link">Link</a> instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CalendarListFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarListFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CalendarListFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarListFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CalendarListFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CalendarListFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarListFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.<a href="atom.html#Link">Link</a> or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarListFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Color">class <strong>Color</strong></a>(<a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar color element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Color">Color</a></dd>
+<dd><a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>:<br>
+<dl><dt><a name="Color-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Color-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Color-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Color-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Comments">class <strong>Comments</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar comments element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Comments">Comments</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Comments-__init__"><strong>__init__</strong></a>(self, rel<font color="#909090">=None</font>, feed_link<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Comments-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Comments-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Comments-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EventStatus">class <strong>EventStatus</strong></a>(<a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar eventStatus element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#EventStatus">EventStatus</a></dd>
+<dd><a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EventStatus-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>status_enum</strong> = {'http://schemas.google.com/g/2005#event.canceled': 'CANCELED', 'http://schemas.google.com/g/2005#event.confirmed': 'CONFIRMED', 'http://schemas.google.com/g/2005#event.tentative': 'TENTATIVE'}</dl>
+
+<hr>
+Methods inherited from <a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>:<br>
+<dl><dt><a name="EventStatus-findKey"><strong>findKey</strong></a>(self, value)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="EventStatus-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="EventStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="EventStatus-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExtendedProperty">class <strong>ExtendedProperty</strong></a>(<a href="gdata.html#ExtendedProperty">gdata.ExtendedProperty</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A transparent subclass of gdata.<a href="#ExtendedProperty">ExtendedProperty</a> added to this module<br>
+for backwards compatibility.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#ExtendedProperty">ExtendedProperty</a></dd>
+<dd><a href="gdata.html#ExtendedProperty">gdata.ExtendedProperty</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#ExtendedProperty">gdata.ExtendedProperty</a>:<br>
+<dl><dt><a name="ExtendedProperty-GetXmlBlobExtensionElement"><strong>GetXmlBlobExtensionElement</strong></a>(self)</dt><dd><tt>Returns the XML blob as an atom.ExtensionElement.<br>
+ <br>
+Returns:<br>
+ An atom.ExtensionElement representing the blob's XML, or None if no<br>
+ blob was set.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-GetXmlBlobString"><strong>GetXmlBlobString</strong></a>(self)</dt><dd><tt>Returns the XML blob as a string.<br>
+ <br>
+Returns:<br>
+ A string containing the blob's XML, or None if no blob was set.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-SetXmlBlob"><strong>SetXmlBlob</strong></a>(self, blob)</dt><dd><tt>Sets the contents of the extendedProperty to XML as a child node.<br>
+ <br>
+Since the extendedProperty is only allowed one child element as an XML<br>
+blob, setting the XML blob will erase any preexisting extension elements<br>
+in this object.<br>
+ <br>
+Args:<br>
+ blob: str, ElementTree Element or atom.ExtensionElement representing<br>
+ the XML blob stored in the extendedProperty.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ExtendedProperty-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ExtendedProperty-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GuestsCanInviteOthers">class <strong>GuestsCanInviteOthers</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Indicates whether event attendees may invite others to the event.<br>
+ <br>
+This element may only be changed by the organizer of the event. If not<br>
+included as part of the event entry, this element will default to true<br>
+during a POST request, and will inherit its previous value during a PUT<br>
+request.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#GuestsCanInviteOthers">GuestsCanInviteOthers</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GuestsCanInviteOthers-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">='true'</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GuestsCanInviteOthers-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanInviteOthers-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GuestsCanInviteOthers-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GuestsCanModify">class <strong>GuestsCanModify</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Indicates whether event attendees may modify the original event.<br>
+ <br>
+If yes, changes are visible to organizer and other attendees. Otherwise,<br>
+any changes made by attendees will be restricted to that attendee's<br>
+calendar.<br>
+ <br>
+This element may only be changed by the organizer of the event, and may<br>
+be set to 'true' only if both gCal:guestsCanInviteOthers and<br>
+gCal:guestsCanSeeGuests are set to true in the same PUT/POST request.<br>
+Otherwise, request fails with HTTP error code 400 (Bad Request).<br>
+ <br>
+If not included as part of the event entry, this element will default to<br>
+false during a POST request, and will inherit its previous value during a<br>
+PUT request.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#GuestsCanModify">GuestsCanModify</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GuestsCanModify-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">='false'</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GuestsCanModify-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanModify-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GuestsCanModify-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GuestsCanSeeGuests">class <strong>GuestsCanSeeGuests</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Indicates whether attendees can see other people invited to the event.<br>
+ <br>
+The organizer always sees all attendees. Guests always see themselves. This<br>
+property affects what attendees see in the event's guest list via both the<br>
+Calendar UI and API feeds.<br>
+ <br>
+This element may only be changed by the organizer of the event.<br>
+ <br>
+If not included as part of the event entry, this element will default to<br>
+true during a POST request, and will inherit its previous value during a<br>
+PUT request.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#GuestsCanSeeGuests">GuestsCanSeeGuests</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GuestsCanSeeGuests-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">='true'</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GuestsCanSeeGuests-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GuestsCanSeeGuests-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GuestsCanSeeGuests-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Hidden">class <strong>Hidden</strong></a>(<a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar hidden element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Hidden">Hidden</a></dd>
+<dd><a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>:<br>
+<dl><dt><a name="Hidden-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Hidden-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Hidden-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Hidden-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OriginalEvent">class <strong>OriginalEvent</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar <a href="#OriginalEvent">OriginalEvent</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#OriginalEvent">OriginalEvent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OriginalEvent-__init__"><strong>__init__</strong></a>(self, id<font color="#909090">=None</font>, href<font color="#909090">=None</font>, when<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="OriginalEvent-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="OriginalEvent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="OriginalEvent-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="QuickAdd">class <strong>QuickAdd</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar quickadd element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#QuickAdd">QuickAdd</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="QuickAdd-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, value<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="QuickAdd-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="QuickAdd-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="QuickAdd-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Recurrence">class <strong>Recurrence</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar <a href="#Recurrence">Recurrence</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Recurrence">Recurrence</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Recurrence-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Recurrence-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Recurrence-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Recurrence-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RecurrenceException">class <strong>RecurrenceException</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar <a href="#RecurrenceException">RecurrenceException</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#RecurrenceException">RecurrenceException</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="RecurrenceException-__init__"><strong>__init__</strong></a>(self, specialized<font color="#909090">=None</font>, entry_link<font color="#909090">=None</font>, original_event<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="RecurrenceException-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="RecurrenceException-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="RecurrenceException-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Reminder">class <strong>Reminder</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar reminder element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Reminder">Reminder</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Reminder-__init__"><strong>__init__</strong></a>(self, absolute_time<font color="#909090">=None</font>, days<font color="#909090">=None</font>, hours<font color="#909090">=None</font>, minutes<font color="#909090">=None</font>, method<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Reminder-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Reminder-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Reminder-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Role">class <strong>Role</strong></a>(<a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar timezone element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Role">Role</a></dd>
+<dd><a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>:<br>
+<dl><dt><a name="Role-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Role-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Role-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Role-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Scope">class <strong>Scope</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google ACL scope element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Scope">Scope</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Scope-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, value<font color="#909090">=None</font>, scope_type<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Scope-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Scope-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Scope-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Selected">class <strong>Selected</strong></a>(<a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar selected element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Selected">Selected</a></dd>
+<dd><a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>:<br>
+<dl><dt><a name="Selected-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Selected-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Selected-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Selected-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SendEventNotifications">class <strong>SendEventNotifications</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar sendEventNotifications element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#SendEventNotifications">SendEventNotifications</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SendEventNotifications-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, value<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SendEventNotifications-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SendEventNotifications-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SendEventNotifications-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Sequence">class <strong>Sequence</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Sequence">Sequence</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Sequence-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Sequence-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Sequence-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Sequence-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SyncEvent">class <strong>SyncEvent</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#SyncEvent">SyncEvent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SyncEvent-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">='false'</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SyncEvent-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SyncEvent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SyncEvent-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Timezone">class <strong>Timezone</strong></a>(<a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar timezone element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Timezone">Timezone</a></dd>
+<dd><a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a>:<br>
+<dl><dt><a name="Timezone-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Timezone-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Timezone-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Timezone-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Transparency">class <strong>Transparency</strong></a>(<a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar <a href="#Transparency">Transparency</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Transparency">Transparency</a></dd>
+<dd><a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Transparency-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>transparency_enum</strong> = {'http://schemas.google.com/g/2005#event.opaque': 'OPAQUE', 'http://schemas.google.com/g/2005#event.transparent': 'TRANSPARENT'}</dl>
+
+<hr>
+Methods inherited from <a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>:<br>
+<dl><dt><a name="Transparency-findKey"><strong>findKey</strong></a>(self, value)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Transparency-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Transparency-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Transparency-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UID">class <strong>UID</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#UID">UID</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="UID-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="UID-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="UID-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="UID-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UriEnumElement">class <strong>UriEnumElement</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="UriEnumElement-__init__"><strong>__init__</strong></a>(self, tag, enum_map, attrib_name<font color="#909090">='value'</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="UriEnumElement-findKey"><strong>findKey</strong></a>(self, value)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="UriEnumElement-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="UriEnumElement-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="UriEnumElement-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ValueAttributeContainer">class <strong>ValueAttributeContainer</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A parent class for all Calendar classes which have a value attribute.<br>
+ <br>
+Children include <a href="#Color">Color</a>, <a href="#AccessLevel">AccessLevel</a>, <a href="#Hidden">Hidden</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#ValueAttributeContainer">ValueAttributeContainer</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ValueAttributeContainer-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ValueAttributeContainer-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ValueAttributeContainer-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ValueAttributeContainer-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Visibility">class <strong>Visibility</strong></a>(<a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar <a href="#Visibility">Visibility</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Visibility">Visibility</a></dd>
+<dd><a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Visibility-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>visibility_enum</strong> = {'http://schemas.google.com/g/2005#event.confidential': 'CONFIDENTIAL', 'http://schemas.google.com/g/2005#event.default': 'DEFAULT', 'http://schemas.google.com/g/2005#event.private': 'PRIVATE', 'http://schemas.google.com/g/2005#event.public': 'PUBLIC'}</dl>
+
+<hr>
+Methods inherited from <a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>:<br>
+<dl><dt><a name="Visibility-findKey"><strong>findKey</strong></a>(self, value)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Visibility-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Visibility-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Visibility-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WebContent">class <strong>WebContent</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#WebContent">WebContent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="WebContent-__init__"><strong>__init__</strong></a>(self, url<font color="#909090">=None</font>, width<font color="#909090">=None</font>, height<font color="#909090">=None</font>, text<font color="#909090">=None</font>, gadget_pref<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="WebContent-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="WebContent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="WebContent-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WebContentGadgetPref">class <strong>WebContentGadgetPref</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#WebContentGadgetPref">WebContentGadgetPref</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="WebContentGadgetPref-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="WebContentGadgetPref-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="WebContentGadgetPref-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="WebContentGadgetPref-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WebContentLink">class <strong>WebContentLink</strong></a>(<a href="atom.html#Link">atom.Link</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#WebContentLink">WebContentLink</a></dd>
+<dd><a href="atom.html#Link">atom.Link</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="WebContentLink-__init__"><strong>__init__</strong></a>(self, title<font color="#909090">=None</font>, href<font color="#909090">=None</font>, link_type<font color="#909090">=None</font>, web_content<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="WebContentLink-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="WebContentLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="WebContentLink-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="When">class <strong>When</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar <a href="#When">When</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#When">When</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="When-__init__"><strong>__init__</strong></a>(self, start_time<font color="#909090">=None</font>, end_time<font color="#909090">=None</font>, reminder<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="When-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="When-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="When-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Where">class <strong>Where</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar <a href="#Where">Where</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Where">Where</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Where-__init__"><strong>__init__</strong></a>(self, value_string<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Where-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Where-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Where-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Who">class <strong>Who</strong></a>(<a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Calendar <a href="#Who">Who</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.html#Who">Who</a></dd>
+<dd><a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Who-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, email<font color="#909090">=None</font>, attendee_status<font color="#909090">=None</font>, attendee_type<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>relEnum</strong> = {'http://schemas.google.com/g/2005#event.attendee': 'ATTENDEE', 'http://schemas.google.com/g/2005#event.organizer': 'ORGANIZER', 'http://schemas.google.com/g/2005#event.performer': 'PERFORMER', 'http://schemas.google.com/g/2005#event.speaker': 'SPEAKER', 'http://schemas.google.com/g/2005#message.bcc': 'BCC', 'http://schemas.google.com/g/2005#message.cc': 'CC', 'http://schemas.google.com/g/2005#message.from': 'FROM', 'http://schemas.google.com/g/2005#message.reply-to': 'REPLY_TO', 'http://schemas.google.com/g/2005#message.to': 'TO'}</dl>
+
+<hr>
+Methods inherited from <a href="gdata.calendar.html#UriEnumElement">UriEnumElement</a>:<br>
+<dl><dt><a name="Who-findKey"><strong>findKey</strong></a>(self, value)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Who-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Who-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Who-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-CalendarAclEntryFromString"><strong>CalendarAclEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CalendarAclFeedFromString"><strong>CalendarAclFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CalendarEventCommentEntryFromString"><strong>CalendarEventCommentEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CalendarEventCommentFeedFromString"><strong>CalendarEventCommentFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CalendarEventEntryFromString"><strong>CalendarEventEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CalendarEventEntryLinkFromString"><strong>CalendarEventEntryLinkFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CalendarEventFeedFromString"><strong>CalendarEventFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CalendarListEntryFromString"><strong>CalendarListEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CalendarListFeedFromString"><strong>CalendarListFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-GetCalendarEventEntryClass"><strong>GetCalendarEventEntryClass</strong></a>()</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GACL_NAMESPACE</strong> = 'http://schemas.google.com/acl/2007'<br>
+<strong>GACL_TEMPLATE</strong> = '{http://schemas.google.com/acl/2007}%s'<br>
+<strong>GCAL_NAMESPACE</strong> = 'http://schemas.google.com/gCal/2005'<br>
+<strong>GCAL_TEMPLATE</strong> = '{http://schemas.google.com/gCal/2005}%s'<br>
+<strong>WEB_CONTENT_LINK_REL</strong> = 'http://schemas.google.com/gCal/2005/webContent'<br>
+<strong>__author__</strong> = 'api.vli (Vivian Li), api.rboyd (Ryan Boyd)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.vli (Vivian Li), api.rboyd (Ryan Boyd)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.calendar.service.html b/pydocs/gdata.calendar.service.html
new file mode 100644
index 0000000..9dc9180
--- /dev/null
+++ b/pydocs/gdata.calendar.service.html
@@ -0,0 +1,1498 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.calendar.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.calendar.html"><font color="#ffffff">calendar</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar/service.py</a></font></td></tr></table>
+ <p><tt><a href="#CalendarService">CalendarService</a> extends the <a href="gdata.service.html#GDataService">GDataService</a> to streamline Google Calendar operations.<br>
+ <br>
+<a href="#CalendarService">CalendarService</a>: Provides methods to query feeds and manipulate items. Extends <br>
+ <a href="gdata.service.html#GDataService">GDataService</a>.<br>
+ <br>
+DictionaryToParamList: Function which converts a dictionary into a list of <br>
+ URL arguments (represented as strings). This is a <br>
+ utility function used in CRUD operations.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.service.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.service.html#RequestError">RequestError</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.service.html#CalendarService">CalendarService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Query">gdata.service.Query</a>(<a href="__builtin__.html#dict">__builtin__.dict</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar.service.html#CalendarEventCommentQuery">CalendarEventCommentQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.service.html#CalendarEventQuery">CalendarEventQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.calendar.service.html#CalendarListQuery">CalendarListQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarEventCommentQuery">class <strong>CalendarEventCommentQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Queries the Google Calendar event comments feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.service.html#CalendarEventCommentQuery">CalendarEventCommentQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarEventCommentQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="CalendarEventCommentQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="CalendarEventCommentQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventCommentQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#CalendarEventCommentQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#CalendarEventCommentQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#CalendarEventCommentQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#CalendarEventCommentQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventCommentQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventCommentQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#CalendarEventCommentQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarEventQuery">class <strong>CalendarEventQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.service.html#CalendarEventQuery">CalendarEventQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarEventQuery-__init__"><strong>__init__</strong></a>(self, user<font color="#909090">='default'</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>ctz</strong></dt>
+<dd><tt>The ctz query parameter which sets report time on the server.</tt></dd>
+</dl>
+<dl><dt><strong>futureevents</strong></dt>
+<dd><tt>The futureevents query parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The orderby query parameter</tt></dd>
+</dl>
+<dl><dt><strong>recurrence_expansion_end</strong></dt>
+<dd><tt>The recurrence-expansion-end query parameter</tt></dd>
+</dl>
+<dl><dt><strong>recurrence_expansion_start</strong></dt>
+<dd><tt>The recurrence-expansion-start query parameter</tt></dd>
+</dl>
+<dl><dt><strong>singleevents</strong></dt>
+<dd><tt>The singleevents query parameter</tt></dd>
+</dl>
+<dl><dt><strong>sortorder</strong></dt>
+<dd><tt>The sortorder query parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_max</strong></dt>
+<dd><tt>The start-max query parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_min</strong></dt>
+<dd><tt>The start-min query parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="CalendarEventQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarEventQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="CalendarEventQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarEventQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#CalendarEventQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#CalendarEventQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#CalendarEventQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#CalendarEventQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="CalendarEventQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarEventQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#CalendarEventQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarListQuery">class <strong>CalendarListQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Queries the Google Calendar meta feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.service.html#CalendarListQuery">CalendarListQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarListQuery-__init__"><strong>__init__</strong></a>(self, userId<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="CalendarListQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarListQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="CalendarListQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CalendarListQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#CalendarListQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#CalendarListQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#CalendarListQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#CalendarListQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="CalendarListQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#CalendarListQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#CalendarListQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarService">class <strong>CalendarService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Calendar service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.service.html#CalendarService">CalendarService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarService-CalendarQuery"><strong>CalendarQuery</strong></a>(self, query)</dt></dl>
+
+<dl><dt><a name="CalendarService-DeleteAclEntry"><strong>DeleteAclEntry</strong></a>(self, edit_uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Removes an ACL entry at the given edit_uri from Google Calendar.<br>
+ <br>
+Args:<br>
+ edit_uri: string The edit URL of the entry to be deleted. Example:<br>
+ '<a href="http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/default">http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/default</a>'<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the deletion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful delete, a httplib.HTTPResponse containing the server's<br>
+ response to the DELETE request.<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-DeleteCalendarEntry"><strong>DeleteCalendarEntry</strong></a>(self, edit_uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Removes a calendar entry at the given edit_uri from Google Calendar.<br>
+ <br>
+Args:<br>
+ edit_uri: string The edit URL of the entry to be deleted. Example:<br>
+ '<a href="http://www.google.com/calendar/feeds/default/allcalendars/abcdef@group.calendar.google.com">http://www.google.com/calendar/feeds/default/allcalendars/abcdef@group.calendar.google.com</a>'<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the deletion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful delete, True is returned<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-DeleteEvent"><strong>DeleteEvent</strong></a>(self, edit_uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Removes an event with the specified ID from Google Calendar.<br>
+ <br>
+Args:<br>
+ edit_uri: string The edit URL of the entry to be deleted. Example:<br>
+ '<a href="http://www.google.com/calendar/feeds/default/private/full/abx">http://www.google.com/calendar/feeds/default/private/full/abx</a>'<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the deletion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful delete, a httplib.HTTPResponse containing the server's<br>
+ response to the DELETE request.<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-ExecuteBatch"><strong>ExecuteBatch</strong></a>(self, batch_feed, url, converter<font color="#909090">=<function CalendarEventFeedFromString></font>)</dt><dd><tt>Sends a batch request feed to the server.<br>
+ <br>
+The batch request needs to be sent to the batch URL for a particular <br>
+calendar. You can find the URL by calling GetBatchLink().href on the <br>
+CalendarEventFeed.<br>
+ <br>
+Args:<br>
+ batch_feed: gdata.calendar.CalendarEventFeed A feed containing batch<br>
+ request entries. Each entry contains the operation to be performed <br>
+ on the data contained in the entry. For example an entry with an <br>
+ operation type of insert will be used as if the individual entry <br>
+ had been inserted.<br>
+ url: str The batch URL for the Calendar to which these operations should<br>
+ be applied.<br>
+ converter: Function (optional) The function used to convert the server's<br>
+ response to an object. The default value is <br>
+ CalendarEventFeedFromString.<br>
+ <br>
+Returns:<br>
+ The results of the batch request's execution on the server. If the <br>
+ default converter is used, this is stored in a CalendarEventFeed.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-GetAllCalendarsFeed"><strong>GetAllCalendarsFeed</strong></a>(self, uri<font color="#909090">='/calendar/feeds/default/allcalendars/full'</font>)</dt></dl>
+
+<dl><dt><a name="CalendarService-GetCalendarAclEntry"><strong>GetCalendarAclEntry</strong></a>(self, uri)</dt></dl>
+
+<dl><dt><a name="CalendarService-GetCalendarAclFeed"><strong>GetCalendarAclFeed</strong></a>(self, uri<font color="#909090">='/calendar/feeds/default/acl/full'</font>)</dt></dl>
+
+<dl><dt><a name="CalendarService-GetCalendarEventCommentEntry"><strong>GetCalendarEventCommentEntry</strong></a>(self, uri)</dt></dl>
+
+<dl><dt><a name="CalendarService-GetCalendarEventCommentFeed"><strong>GetCalendarEventCommentFeed</strong></a>(self, uri)</dt></dl>
+
+<dl><dt><a name="CalendarService-GetCalendarEventEntry"><strong>GetCalendarEventEntry</strong></a>(self, uri)</dt></dl>
+
+<dl><dt><a name="CalendarService-GetCalendarEventFeed"><strong>GetCalendarEventFeed</strong></a>(self, uri<font color="#909090">='/calendar/feeds/default/private/full'</font>)</dt></dl>
+
+<dl><dt><a name="CalendarService-GetCalendarListEntry"><strong>GetCalendarListEntry</strong></a>(self, uri)</dt></dl>
+
+<dl><dt><a name="CalendarService-GetCalendarListFeed"><strong>GetCalendarListFeed</strong></a>(self, uri<font color="#909090">='/calendar/feeds/default/allcalendars/full'</font>)</dt></dl>
+
+<dl><dt><a name="CalendarService-GetOwnCalendarsFeed"><strong>GetOwnCalendarsFeed</strong></a>(self, uri<font color="#909090">='/calendar/feeds/default/owncalendars/full'</font>)</dt></dl>
+
+<dl><dt><a name="CalendarService-InsertAclEntry"><strong>InsertAclEntry</strong></a>(self, new_entry, insert_uri, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Adds an ACL entry (rule) to Google Calendar.<br>
+ <br>
+Args: <br>
+ new_entry: atom.Entry or subclass A new ACL entry which is to be added to <br>
+ Google Calendar.<br>
+ insert_uri: the URL to post new entries to the ACL feed<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the ACL entry created<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-InsertCalendar"><strong>InsertCalendar</strong></a>(self, new_calendar, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Creates a new calendar.<br>
+ <br>
+Args: <br>
+ new_calendar: The calendar to be created<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the calendar created<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-InsertCalendarSubscription"><strong>InsertCalendarSubscription</strong></a>(self, calendar, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Subscribes the authenticated user to the provided calendar.<br>
+ <br>
+Args: <br>
+ calendar: The calendar to which the user should be subscribed.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the subscription created<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-InsertEvent"><strong>InsertEvent</strong></a>(self, new_event, insert_uri, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Adds an event to Google Calendar.<br>
+ <br>
+Args: <br>
+ new_event: atom.Entry or subclass A new event which is to be added to <br>
+ Google Calendar.<br>
+ insert_uri: the URL to post new events to the feed<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the event created<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-InsertEventComment"><strong>InsertEventComment</strong></a>(self, new_entry, insert_uri, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Adds an entry to Google Calendar.<br>
+ <br>
+Args:<br>
+ new_entry: atom.Entry or subclass A new entry which is to be added to<br>
+ Google Calendar.<br>
+ insert_uri: the URL to post new entrys to the feed<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the comment created<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-Query"><strong>Query</strong></a>(self, uri, converter<font color="#909090">=None</font>)</dt><dd><tt>Performs a query and returns a resulting feed or entry.<br>
+ <br>
+Args:<br>
+ feed: string The feed which is to be queried<br>
+ <br>
+Returns:<br>
+ On success, a GDataFeed or Entry depending on which is sent from the <br>
+ server.<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-UpdateAclEntry"><strong>UpdateAclEntry</strong></a>(self, edit_uri, updated_rule, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Updates an existing ACL rule.<br>
+ <br>
+Args:<br>
+ edit_uri: string The edit link URI for the element being updated<br>
+ updated_rule: string, atom.Entry, or subclass containing<br>
+ the Atom Entry which will replace the event which is <br>
+ stored at the edit_url <br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the update request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful update, a httplib.HTTPResponse containing the server's<br>
+ response to the PUT request.<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-UpdateCalendar"><strong>UpdateCalendar</strong></a>(self, calendar, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Updates a calendar.<br>
+ <br>
+Args: <br>
+ calendar: The calendar which should be updated<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the calendar created<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-UpdateEvent"><strong>UpdateEvent</strong></a>(self, edit_uri, updated_event, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Updates an existing event.<br>
+ <br>
+Args:<br>
+ edit_uri: string The edit link URI for the element being updated<br>
+ updated_event: string, atom.Entry, or subclass containing<br>
+ the Atom Entry which will replace the event which is <br>
+ stored at the edit_url <br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the update request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful update, a httplib.HTTPResponse containing the server's<br>
+ response to the PUT request.<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server, <br>
+ 'reason': HTTP reason from the server, <br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='www.google.com'</font>, additional_headers<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a client for the Google Calendar service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'www.google.com'.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="CalendarService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#CalendarService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ <a href="#Error">Error</a> if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#CalendarService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#CalendarService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="CalendarService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="CalendarService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RequestError">class <strong>RequestError</strong></a>(<a href="gdata.calendar.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar.service.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.calendar.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.calendar.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="RequestError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RequestError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="RequestError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DEFAULT_BATCH_URL</strong> = 'http://www.google.com/calendar/feeds/default/private/full/batch'<br>
+<strong>__author__</strong> = 'api.vli (Vivian Li)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.vli (Vivian Li)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.calendar_resource.client.html b/pydocs/gdata.calendar_resource.client.html
new file mode 100644
index 0000000..553cf96
--- /dev/null
+++ b/pydocs/gdata.calendar_resource.client.html
@@ -0,0 +1,715 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.calendar_resource.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.calendar_resource.html"><font color="#ffffff">calendar_resource</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar_resource/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar_resource/client.py</a></font></td></tr></table>
+ <p><tt><a href="#CalendarResourceClient">CalendarResourceClient</a> simplifies Calendar Resources API calls.<br>
+ <br>
+<a href="#CalendarResourceClient">CalendarResourceClient</a> extends gdata.client.<a href="gdata.client.html#GDClient">GDClient</a> to ease interaction with<br>
+the Google Apps Calendar Resources API. These interactions include the ability<br>
+to create, retrieve, update, and delete calendar resources in a Google Apps<br>
+domain.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar_resource.client.html#CalendarResourceClient">CalendarResourceClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarResourceClient">class <strong>CalendarResourceClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Calendar Resource API service.<br>
+ <br>
+Attributes:<br>
+ host: string The hostname for the Calendar Resouce API service.<br>
+ api_version: string The version of the Calendar Resource API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar_resource.client.html#CalendarResourceClient">CalendarResourceClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarResourceClient-CreateResource"><strong>CreateResource</strong></a> = <a href="#CalendarResourceClient-create_resource">create_resource</a>(self, resource_id, resource_common_name<font color="#909090">=None</font>, resource_description<font color="#909090">=None</font>, resource_type<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-DeleteResource"><strong>DeleteResource</strong></a> = <a href="#CalendarResourceClient-delete_resource">delete_resource</a>(self, resource_id, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-GetResource"><strong>GetResource</strong></a> = <a href="#CalendarResourceClient-get_resource">get_resource</a>(self, uri<font color="#909090">=None</font>, resource_id<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-GetResourceFeed"><strong>GetResourceFeed</strong></a> = <a href="#CalendarResourceClient-get_resource_feed">get_resource_feed</a>(self, uri<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-MakeResourceFeedUri"><strong>MakeResourceFeedUri</strong></a> = <a href="#CalendarResourceClient-make_resource_feed_uri">make_resource_feed_uri</a>(self, resource_id<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-UpdateResource"><strong>UpdateResource</strong></a> = <a href="#CalendarResourceClient-update_resource">update_resource</a>(self, resource_id, resource_common_name<font color="#909090">=None</font>, resource_description<font color="#909090">=None</font>, resource_type<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-__init__"><strong>__init__</strong></a>(self, domain, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a new client for the Calendar Resource API.<br>
+ <br>
+Args:<br>
+ domain: string The Google Apps domain with Calendar Resources.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or <br>
+ OAuthToken which authorizes this client to edit the calendar resource<br>
+ data.<br>
+ kwargs: The other parameters to pass to the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a><br>
+ constructor.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-create_resource"><strong>create_resource</strong></a>(self, resource_id, resource_common_name<font color="#909090">=None</font>, resource_description<font color="#909090">=None</font>, resource_type<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a calendar resource with the given properties.<br>
+ <br>
+Args:<br>
+ resource_id: string The resource ID of the calendar resource.<br>
+ resource_common_name: string (optional) The common name of the resource.<br>
+ resource_description: string (optional) The description of the resource.<br>
+ resource_type: string (optional) The type of the resource.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#CalendarResourceClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.calendar_resource.data.CalendarResourceEntry of the new resource.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-delete_resource"><strong>delete_resource</strong></a>(self, resource_id, **kwargs)</dt><dd><tt>Deletes the calendar resource with the given resource ID.<br>
+ <br>
+Args:<br>
+ resource_id: string The resource ID of the calendar resource to delete.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#CalendarResourceClient-delete">delete</a>()<br>
+ <br>
+Returns:<br>
+ An HTTP response object. See gdata.client.<a href="#CalendarResourceClient-request">request</a>().</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-get_resource"><strong>get_resource</strong></a>(self, uri<font color="#909090">=None</font>, resource_id<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches a single calendar resource by resource ID.<br>
+ <br>
+Args:<br>
+ uri: string The base URI of the feed from which to fetch the resource.<br>
+ resource_id: string The string ID of the Resource to fetch.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#CalendarResourceClient-get_entry">get_entry</a>().<br>
+ <br>
+Returns:<br>
+ A Resource object representing the calendar resource with the given <br>
+ base URI and resource ID.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-get_resource_feed"><strong>get_resource_feed</strong></a>(self, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches a ResourceFeed of calendar resources at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the feed to pull.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#CalendarResourceClient-get_feed">get_feed</a>().<br>
+ <br>
+Returns:<br>
+ A ResourceFeed object representing the feed at the given URI.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-make_resource_feed_uri"><strong>make_resource_feed_uri</strong></a>(self, resource_id<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt><dd><tt>Creates a resource feed URI for the Calendar Resource API.<br>
+ <br>
+Using this client's Google Apps domain, create a feed URI for calendar<br>
+resources in that domain. If a resource_id is provided, return a URI<br>
+for that specific resource. If params are provided, append them as GET<br>
+params.<br>
+ <br>
+Args:<br>
+ resource_id: string (optional) The ID of the calendar resource for which<br>
+ to make a feed URI.<br>
+ params: dict (optional) key -> value params to append as GET vars to the<br>
+ URI. Example: params={'start': 'my-resource-id'}<br>
+Returns:<br>
+ A string giving the URI for calendar resources for this client's Google<br>
+ Apps domain.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-update_resource"><strong>update_resource</strong></a>(self, resource_id, resource_common_name<font color="#909090">=None</font>, resource_description<font color="#909090">=None</font>, resource_type<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Updates the calendar resource with the given resource ID.<br>
+ <br>
+Args:<br>
+ resource_id: string The resource ID of the calendar resource to update.<br>
+ resource_common_name: string (optional) The common name to give the<br>
+ resource.<br>
+ resource_description: string (optional) The description to give the<br>
+ resource.<br>
+ resource_type: string (optional) The type to give the resource.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#CalendarResourceClient-update">update</a>().<br>
+ <br>
+Returns:<br>
+ gdata.calendar_resource.data.CalendarResourceEntry of the updated<br>
+ resource.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '2.0'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://apps-apis.google.com/a/feeds/user/', 'https://apps-apis.google.com/a/feeds/policies/', 'https://apps-apis.google.com/a/feeds/alias/', 'https://apps-apis.google.com/a/feeds/groups/', 'https://apps-apis.google.com/a/feeds/compliance/audit/', 'https://apps-apis.google.com/a/feeds/migration/', 'https://apps-apis.google.com/a/feeds/emailsettings/2.0/')</dl>
+
+<dl><dt><strong>auth_service</strong> = 'apps'</dl>
+
+<dl><dt><strong>host</strong> = 'apps-apis.google.com'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="CalendarResourceClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="CalendarResourceClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="CalendarResourceClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>RESOURCE_FEED_TEMPLATE</strong> = '/a/feeds/calendar/resource/%s/%s/'<br>
+<strong>__author__</strong> = 'Vic Fryzel <vf@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Vic Fryzel <vf@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.calendar_resource.data.html b/pydocs/gdata.calendar_resource.data.html
new file mode 100644
index 0000000..f6d7154
--- /dev/null
+++ b/pydocs/gdata.calendar_resource.data.html
@@ -0,0 +1,812 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.calendar_resource.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.calendar_resource.html"><font color="#ffffff">calendar_resource</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar_resource/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar_resource/data.py</a></font></td></tr></table>
+ <p><tt>Data model for parsing and generating XML for the Calendar Resource API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar_resource.data.html#CalendarResourceEntry">CalendarResourceEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.calendar_resource.data.html#CalendarResourceFeed">CalendarResourceFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarResourceEntry">class <strong>CalendarResourceEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a Calendar Resource entry in object form.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar_resource.data.html#CalendarResourceEntry">CalendarResourceEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CalendarResourceEntry-GetResourceCommonName"><strong>GetResourceCommonName</strong></a>(self)</dt><dd><tt>Get the common name of this Calendar Resource object.<br>
+ <br>
+Returns:<br>
+ The common name of this Calendar Resource object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetResourceDescription"><strong>GetResourceDescription</strong></a>(self)</dt><dd><tt>Get the description of this Calendar Resource object.<br>
+ <br>
+Returns:<br>
+ The description of this Calendar Resource object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetResourceEmail"><strong>GetResourceEmail</strong></a>(self)</dt><dd><tt>Get the email of this Calendar Resource object.<br>
+ <br>
+Returns:<br>
+The email of this Calendar Resource object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetResourceId"><strong>GetResourceId</strong></a>(self)</dt><dd><tt>Get the resource ID of this Calendar Resource object.<br>
+ <br>
+Returns:<br>
+ The resource ID of this Calendar Resource object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetResourceType"><strong>GetResourceType</strong></a>(self)</dt><dd><tt>Get the type of this Calendar Resource object.<br>
+ <br>
+Returns:<br>
+ The type of this Calendar Resource object as a string or None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-SetResourceCommonName"><strong>SetResourceCommonName</strong></a>(self, value)</dt><dd><tt>Set the common name of this Calendar Resource object.<br>
+ <br>
+Args:<br>
+ value: string The new common name value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-SetResourceDescription"><strong>SetResourceDescription</strong></a>(self, value)</dt><dd><tt>Set the description of this Calendar Resource object.<br>
+ <br>
+Args:<br>
+ value: string The new description value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-SetResourceId"><strong>SetResourceId</strong></a>(self, value)</dt><dd><tt>Set the resource ID of this Calendar Resource object.<br>
+ <br>
+Args:<br>
+ value: string The new resource ID value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-SetResourceType"><strong>SetResourceType</strong></a>(self, value)</dt><dd><tt>Set the type value of this Calendar Resource object.<br>
+ <br>
+Args:<br>
+ value: string The new type value to give this object.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-__init__"><strong>__init__</strong></a>(self, resource_id<font color="#909090">=None</font>, resource_common_name<font color="#909090">=None</font>, resource_description<font color="#909090">=None</font>, resource_type<font color="#909090">=None</font>, *args, **kwargs)</dt><dd><tt>Constructs a new <a href="#CalendarResourceEntry">CalendarResourceEntry</a> object with the given arguments.<br>
+ <br>
+Args:<br>
+ resource_id: string (optional) The resource ID to give this new object.<br>
+ resource_common_name: string (optional) The common name to give this new<br>
+ object.<br>
+ resource_description: string (optional) The description to give this new<br>
+ object.<br>
+ resource_type: string (optional) The type to give this new object.<br>
+ args: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor. <br>
+ kwargs: The other parameters to pass to gdata.entry.<a href="gdata.data.html#GDEntry">GDEntry</a> constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>resource_common_name</strong></dt>
+<dd><tt>Get the common name of this Calendar Resource object.<br>
+ <br>
+Returns:<br>
+ The common name of this Calendar Resource object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>resource_description</strong></dt>
+<dd><tt>Get the description of this Calendar Resource object.<br>
+ <br>
+Returns:<br>
+ The description of this Calendar Resource object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>resource_email</strong></dt>
+<dd><tt>Get the email of this Calendar Resource object.<br>
+ <br>
+Returns:<br>
+The email of this Calendar Resource object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>resource_id</strong></dt>
+<dd><tt>Get the resource ID of this Calendar Resource object.<br>
+ <br>
+Returns:<br>
+ The resource ID of this Calendar Resource object as a string or None.</tt></dd>
+</dl>
+<dl><dt><strong>resource_type</strong></dt>
+<dd><tt>Get the type of this Calendar Resource object.<br>
+ <br>
+Returns:<br>
+ The type of this Calendar Resource object as a string or None.</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>property</strong> = [<class 'gdata.apps_property.AppsProperty'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CalendarResourceEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarResourceEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarResourceEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarResourceEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarResourceFeed">class <strong>CalendarResourceFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of <a href="#CalendarResourceEntry">CalendarResourceEntry</a> objects.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.calendar_resource.data.html#CalendarResourceFeed">CalendarResourceFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.calendar_resource.data.CalendarResourceEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CalendarResourceFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CalendarResourceFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarResourceFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarResourceFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CalendarResourceFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarResourceFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>RESOURCE_COMMON_NAME_NAME</strong> = 'resourceCommonName'<br>
+<strong>RESOURCE_DESCRIPTION_NAME</strong> = 'resourceDescription'<br>
+<strong>RESOURCE_EMAIL_NAME</strong> = 'resourceEmail'<br>
+<strong>RESOURCE_ID_NAME</strong> = 'resourceId'<br>
+<strong>RESOURCE_TYPE_NAME</strong> = 'resourceType'<br>
+<strong>__author__</strong> = 'Vic Fryzel <vf@google.com>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Vic Fryzel <vf@google.com></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.calendar_resource.html b/pydocs/gdata.calendar_resource.html
new file mode 100644
index 0000000..ae6cfa9
--- /dev/null
+++ b/pydocs/gdata.calendar_resource.html
@@ -0,0 +1,23 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.calendar_resource</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.calendar_resource</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar_resource/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/calendar_resource/__init__.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.calendar_resource.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.calendar_resource.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.client.html b/pydocs/gdata.client.html
new file mode 100644
index 0000000..ad20c2c
--- /dev/null
+++ b/pydocs/gdata.client.html
@@ -0,0 +1,1655 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/client.py</a></font></td></tr></table>
+ <p><tt>Provides a client to interact with Google Data API servers.<br>
+ <br>
+This module is used for version 2 of the Google Data APIs. The primary class<br>
+in this module is <a href="#GDClient">GDClient</a>.<br>
+ <br>
+ <a href="#GDClient">GDClient</a>: handles auth and CRUD operations when communicating with servers.<br>
+ GDataClient: deprecated client for version one services. Will be removed.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="re.html">re</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#Query">Query</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.client.html#ResumableUploader">ResumableUploader</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">GDClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.http_core.html#Uri">atom.http_core.Uri</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDQuery">GDQuery</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#ClientLoginTokenMissing">ClientLoginTokenMissing</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.client.html#MissingOAuthParameters">MissingOAuthParameters</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.client.html#RequestError">RequestError</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#BadAuthentication">BadAuthentication</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.client.html#CaptchaChallenge">CaptchaChallenge</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.client.html#ClientLoginFailed">ClientLoginFailed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.client.html#NotImplemented">NotImplemented</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.client.html#NotModified">NotModified</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.client.html#RedirectError">RedirectError</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#BadAuthenticationServiceURL">BadAuthenticationServiceURL</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#UnableToUpgradeToken">UnableToUpgradeToken</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#Unauthorized">Unauthorized</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BadAuthentication">class <strong>BadAuthentication</strong></a>(<a href="gdata.client.html#RequestError">RequestError</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#BadAuthentication">BadAuthentication</a></dd>
+<dd><a href="gdata.client.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#RequestError">RequestError</a>:<br>
+<dl><dt><strong>body</strong> = None</dl>
+
+<dl><dt><strong>headers</strong> = None</dl>
+
+<dl><dt><strong>reason</strong> = None</dl>
+
+<dl><dt><strong>status</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="BadAuthentication-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#BadAuthentication-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="BadAuthentication-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="BadAuthentication-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="BadAuthentication-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BadAuthenticationServiceURL">class <strong>BadAuthenticationServiceURL</strong></a>(<a href="gdata.client.html#RedirectError">RedirectError</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#BadAuthenticationServiceURL">BadAuthenticationServiceURL</a></dd>
+<dd><a href="gdata.client.html#RedirectError">RedirectError</a></dd>
+<dd><a href="gdata.client.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#RequestError">RequestError</a>:<br>
+<dl><dt><strong>body</strong> = None</dl>
+
+<dl><dt><strong>headers</strong> = None</dl>
+
+<dl><dt><strong>reason</strong> = None</dl>
+
+<dl><dt><strong>status</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="BadAuthenticationServiceURL-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#BadAuthenticationServiceURL-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="BadAuthenticationServiceURL-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CaptchaChallenge">class <strong>CaptchaChallenge</strong></a>(<a href="gdata.client.html#RequestError">RequestError</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#CaptchaChallenge">CaptchaChallenge</a></dd>
+<dd><a href="gdata.client.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>captcha_token</strong> = None</dl>
+
+<dl><dt><strong>captcha_url</strong> = None</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#RequestError">RequestError</a>:<br>
+<dl><dt><strong>body</strong> = None</dl>
+
+<dl><dt><strong>headers</strong> = None</dl>
+
+<dl><dt><strong>reason</strong> = None</dl>
+
+<dl><dt><strong>status</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="CaptchaChallenge-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaChallenge-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#CaptchaChallenge-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="CaptchaChallenge-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaChallenge-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="CaptchaChallenge-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaChallenge-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="CaptchaChallenge-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaChallenge-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="CaptchaChallenge-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaChallenge-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="CaptchaChallenge-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="CaptchaChallenge-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaChallenge-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="CaptchaChallenge-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaChallenge-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="CaptchaChallenge-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="CaptchaChallenge-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaChallenge-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="CaptchaChallenge-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ClientLoginFailed">class <strong>ClientLoginFailed</strong></a>(<a href="gdata.client.html#RequestError">RequestError</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#ClientLoginFailed">ClientLoginFailed</a></dd>
+<dd><a href="gdata.client.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#RequestError">RequestError</a>:<br>
+<dl><dt><strong>body</strong> = None</dl>
+
+<dl><dt><strong>headers</strong> = None</dl>
+
+<dl><dt><strong>reason</strong> = None</dl>
+
+<dl><dt><strong>status</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="ClientLoginFailed-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginFailed-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#ClientLoginFailed-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="ClientLoginFailed-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginFailed-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginFailed-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginFailed-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginFailed-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginFailed-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginFailed-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginFailed-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginFailed-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="ClientLoginFailed-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginFailed-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginFailed-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginFailed-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginFailed-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="ClientLoginFailed-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginFailed-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginFailed-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ClientLoginTokenMissing">class <strong>ClientLoginTokenMissing</strong></a>(<a href="gdata.client.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#ClientLoginTokenMissing">ClientLoginTokenMissing</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="ClientLoginTokenMissing-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginTokenMissing-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#ClientLoginTokenMissing-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="ClientLoginTokenMissing-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginTokenMissing-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginTokenMissing-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginTokenMissing-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginTokenMissing-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginTokenMissing-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginTokenMissing-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginTokenMissing-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginTokenMissing-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="ClientLoginTokenMissing-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginTokenMissing-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginTokenMissing-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginTokenMissing-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginTokenMissing-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="ClientLoginTokenMissing-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#ClientLoginTokenMissing-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="ClientLoginTokenMissing-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GDClient">class <strong>GDClient</strong></a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Communicates with Google Data servers to perform CRUD operations.<br>
+ <br>
+This class is currently experimental and may change in backwards<br>
+incompatible ways.<br>
+ <br>
+This class exists to simplify the following three areas involved in using<br>
+the Google Data APIs.<br>
+ <br>
+CRUD Operations:<br>
+ <br>
+The client provides a generic 'request' method for making HTTP requests.<br>
+There are a number of convenience methods which are built on top of<br>
+request, which include get_feed, get_entry, get_next, post, update, and<br>
+delete. These methods contact the Google Data servers.<br>
+ <br>
+Auth:<br>
+ <br>
+Reading user-specific private data requires authorization from the user as<br>
+do any changes to user data. An auth_token <a href="__builtin__.html#object">object</a> can be passed into any<br>
+of the HTTP requests to set the Authorization header in the request.<br>
+ <br>
+You may also want to set the auth_token member to a an <a href="__builtin__.html#object">object</a> which can<br>
+use modify_request to set the Authorization header in the HTTP request.<br>
+ <br>
+If you are authenticating using the email address and password, you can<br>
+use the client_login method to obtain an auth token and set the<br>
+auth_token member.<br>
+ <br>
+If you are using browser redirects, specifically AuthSub, you will want<br>
+to use gdata.gauth.AuthSubToken.from_url to obtain the token after the<br>
+redirect, and you will probably want to updgrade this since use token<br>
+to a multiple use (session) token using the upgrade_token method.<br>
+ <br>
+API Versions:<br>
+ <br>
+This client is multi-version capable and can be used with Google Data API<br>
+version 1 and version 2. The version should be specified by setting the<br>
+api_version member to a string, either '1' or '2'.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#GDClient">GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GDClient-Batch"><strong>Batch</strong></a> = <a href="#GDClient-batch">batch</a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-ClientLogin"><strong>ClientLogin</strong></a> = <a href="#GDClient-client_login">client_login</a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GDClient-Delete"><strong>Delete</strong></a> = <a href="#GDClient-delete">delete</a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-GetAccessToken"><strong>GetAccessToken</strong></a> = <a href="#GDClient-get_access_token">get_access_token</a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt></dl>
+
+<dl><dt><a name="GDClient-GetEntry"><strong>GetEntry</strong></a> = <a href="#GDClient-get_entry">get_entry</a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-GetFeed"><strong>GetFeed</strong></a> = <a href="#GDClient-get_feed">get_feed</a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-GetNext"><strong>GetNext</strong></a> = <a href="#GDClient-get_next">get_next</a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = <a href="#GDClient-get_oauth_token">get_oauth_token</a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt></dl>
+
+<dl><dt><a name="GDClient-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#GDClient-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="GDClient-Post"><strong>Post</strong></a> = <a href="#GDClient-post">post</a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-Request"><strong>Request</strong></a> = <a href="#GDClient-request">request</a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = <a href="#GDClient-request_client_login_token">request_client_login_token</a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GDClient-RevokeToken"><strong>RevokeToken</strong></a> = <a href="#GDClient-revoke_token">revoke_token</a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt></dl>
+
+<dl><dt><a name="GDClient-Update"><strong>Update</strong></a> = <a href="#GDClient-update">update</a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-UpgradeToken"><strong>UpgradeToken</strong></a> = <a href="#GDClient-upgrade_token">upgrade_token</a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt></dl>
+
+<dl><dt><a name="GDClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed <a href="__builtin__.html#object">object</a> will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An <a href="__builtin__.html#object">object</a> which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="GDClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+<a href="__builtin__.html#object">object</a> will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+ Raises:<br>
+ A <a href="#RequestError">RequestError</a> or one of its suclasses: <a href="#BadAuthentication">BadAuthentication</a>,<br>
+ <a href="#BadAuthenticationServiceURL">BadAuthenticationServiceURL</a>, <a href="#ClientLoginFailed">ClientLoginFailed</a>,<br>
+ <a href="#ClientLoginTokenMissing">ClientLoginTokenMissing</a>, or <a href="#CaptchaChallenge">CaptchaChallenge</a></tt></dd></dl>
+
+<dl><dt><a name="GDClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="GDClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed <a href="__builtin__.html#object">object</a> containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="GDClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.<a href="atom.http_core.html#Uri">Uri</a> objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.<a href="atom.http_core.html#Uri">Uri</a> <a href="__builtin__.html#object">object</a>, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="GDClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="GDClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="GDClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.<a href="atom.client.html#AtomPubClient">AtomPubClient</a>.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+<a href="#RedirectError">RedirectError</a> will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.<a href="atom.http_core.html#Uri">Uri</a>, str, or unicode The URL being requested.<br>
+ auth_token: An <a href="__builtin__.html#object">object</a> which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired <a href="__builtin__.html#object">object</a>.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse <a href="__builtin__.html#object">object</a> will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.<a href="atom.client.html#AtomPubClient">AtomPubClient</a>.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response <a href="__builtin__.html#object">object</a> (see atom.http_core.HttpResponse for a<br>
+ description of the <a href="__builtin__.html#object">object</a>'s interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="GDClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GDClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A <a href="#RequestError">RequestError</a> if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="GDClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry <a href="__builtin__.html#object">object</a> with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry <a href="__builtin__.html#object">object</a> of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="GDClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token <a href="__builtin__.html#object">object</a> will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.<a href="atom.http_core.html#Uri">Uri</a> (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<dl><dt><strong>api_version</strong> = None</dl>
+
+<dl><dt><strong>auth_scopes</strong> = None</dl>
+
+<dl><dt><strong>auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="GDClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="GDClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="GDClient-__init__"><strong>__init__</strong></a>(self, http_client<font color="#909090">=None</font>, host<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, source<font color="#909090">=None</font>, xoauth_requestor_id<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new <a href="atom.client.html#AtomPubClient">AtomPubClient</a> instance.<br>
+ <br>
+Args:<br>
+ source: The name of your application.<br>
+ http_client: An <a href="__builtin__.html#object">object</a> capable of performing HTTP requests through a<br>
+ request method. This <a href="__builtin__.html#object">object</a> is used to perform the request<br>
+ when the <a href="atom.client.html#AtomPubClient">AtomPubClient</a>'s request method is called. Used to<br>
+ allow HTTP requests to be directed to a mock server, or use<br>
+ an alternate library instead of the default of httplib to<br>
+ make HTTP requests.<br>
+ host: str The default host name to use if a host is not specified in the<br>
+ requested URI.<br>
+ auth_token: An <a href="__builtin__.html#object">object</a> which sets the HTTP Authorization header when its<br>
+ modify_request method is called.</tt></dd></dl>
+
+<dl><dt><a name="GDClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="GDClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GDQuery">class <strong>GDQuery</strong></a>(<a href="atom.http_core.html#Uri">atom.http_core.Uri</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#GDQuery">GDQuery</a></dd>
+<dd><a href="atom.http_core.html#Uri">atom.http_core.Uri</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The q parameter for searching for an exact text match on content</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="GDQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<dl><dt><a name="GDQuery-__init__"><strong>__init__</strong></a>(self, scheme<font color="#909090">=None</font>, host<font color="#909090">=None</font>, port<font color="#909090">=None</font>, path<font color="#909090">=None</font>, query<font color="#909090">=None</font>)</dt><dd><tt>Constructor for a URI.<br>
+ <br>
+Args:<br>
+ scheme: str This is usually 'http' or 'https'.<br>
+ host: str The host name or IP address of the desired server.<br>
+ post: int The server's port number.<br>
+ path: str The path of the resource following the host. This begins with<br>
+ a /, example: '/calendar/feeds/default/allcalendars/full'<br>
+ query: dict of strings The URL query parameters. The keys and values are<br>
+ both escaped so this dict should contain the unescaped values.<br>
+ For example {'my key': 'val', 'second': '!!!'} will become<br>
+ '?my+key=val&second=%21%21%21' which is appended to the path.</tt></dd></dl>
+
+<dl><dt><a name="GDQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDQuery-modify_request"><strong>modify_request</strong></a>(self, http_request<font color="#909090">=None</font>)</dt><dd><tt>Sets HTTP request components based on the URI.</tt></dd></dl>
+
+<hr>
+Static methods inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><a name="GDQuery-ParseUri"><strong>ParseUri</strong></a> = parse_uri(uri_string)</dt><dd><tt>Creates a <a href="atom.http_core.html#Uri">Uri</a> <a href="__builtin__.html#object">object</a> which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the <a href="atom.http_core.html#Uri">Uri</a> unset.</tt></dd></dl>
+
+<dl><dt><a name="GDQuery-parse_uri"><strong>parse_uri</strong></a>(uri_string)</dt><dd><tt>Creates a <a href="atom.http_core.html#Uri">Uri</a> <a href="__builtin__.html#object">object</a> which corresponds to the URI string.<br>
+ <br>
+This method can accept partial URIs, but it will leave missing<br>
+members of the <a href="atom.http_core.html#Uri">Uri</a> unset.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_core.html#Uri">atom.http_core.Uri</a>:<br>
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>path</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = None</dl>
+
+<dl><dt><strong>scheme</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MissingOAuthParameters">class <strong>MissingOAuthParameters</strong></a>(<a href="gdata.client.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#MissingOAuthParameters">MissingOAuthParameters</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="MissingOAuthParameters-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingOAuthParameters-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#MissingOAuthParameters-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="MissingOAuthParameters-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingOAuthParameters-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="MissingOAuthParameters-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingOAuthParameters-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="MissingOAuthParameters-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingOAuthParameters-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="MissingOAuthParameters-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingOAuthParameters-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="MissingOAuthParameters-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="MissingOAuthParameters-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingOAuthParameters-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="MissingOAuthParameters-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingOAuthParameters-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="MissingOAuthParameters-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="MissingOAuthParameters-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingOAuthParameters-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="MissingOAuthParameters-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NotImplemented">class <strong>NotImplemented</strong></a>(<a href="gdata.client.html#RequestError">RequestError</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#NotImplemented">NotImplemented</a></dd>
+<dd><a href="gdata.client.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#RequestError">RequestError</a>:<br>
+<dl><dt><strong>body</strong> = None</dl>
+
+<dl><dt><strong>headers</strong> = None</dl>
+
+<dl><dt><strong>reason</strong> = None</dl>
+
+<dl><dt><strong>status</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="NotImplemented-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#NotImplemented-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#NotImplemented-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="NotImplemented-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotImplemented-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="NotImplemented-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#NotImplemented-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="NotImplemented-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#NotImplemented-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="NotImplemented-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#NotImplemented-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="NotImplemented-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NotImplemented-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotImplemented-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="NotImplemented-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotImplemented-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="NotImplemented-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NotImplemented-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#NotImplemented-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="NotImplemented-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NotModified">class <strong>NotModified</strong></a>(<a href="gdata.client.html#RequestError">RequestError</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#NotModified">NotModified</a></dd>
+<dd><a href="gdata.client.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#RequestError">RequestError</a>:<br>
+<dl><dt><strong>body</strong> = None</dl>
+
+<dl><dt><strong>headers</strong> = None</dl>
+
+<dl><dt><strong>reason</strong> = None</dl>
+
+<dl><dt><strong>status</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="NotModified-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#NotModified-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#NotModified-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="NotModified-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotModified-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="NotModified-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#NotModified-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="NotModified-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#NotModified-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="NotModified-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#NotModified-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="NotModified-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NotModified-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotModified-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="NotModified-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotModified-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="NotModified-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NotModified-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#NotModified-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="NotModified-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Query">class <strong>Query</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Query-AddCustomParameter"><strong>AddCustomParameter</strong></a> = <a href="#Query-add_custom_parameter">add_custom_parameter</a>(self, key, value)</dt></dl>
+
+<dl><dt><a name="Query-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#Query-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="Query-__init__"><strong>__init__</strong></a>(self, text_query<font color="#909090">=None</font>, categories<font color="#909090">=None</font>, author<font color="#909090">=None</font>, alt<font color="#909090">=None</font>, updated_min<font color="#909090">=None</font>, updated_max<font color="#909090">=None</font>, pretty_print<font color="#909090">=False</font>, published_min<font color="#909090">=None</font>, published_max<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, max_results<font color="#909090">=None</font>, strict<font color="#909090">=False</font>, **custom_parameters)</dt><dd><tt>Constructs a Google Data <a href="#Query">Query</a> to filter feed contents serverside.<br>
+ <br>
+Args:<br>
+ text_query: Full text search str (optional)<br>
+ categories: list of strings (optional). Each string is a required<br>
+ category. To include an 'or' query, put a | in the string between<br>
+ terms. For example, to find everything in the Fitz category and<br>
+ the Laurie or Jane category (Fitz and (Laurie or Jane)) you would<br>
+ set categories to ['Fitz', 'Laurie|Jane'].<br>
+ author: str (optional) The service returns entries where the author<br>
+ name and/or email address match your query string.<br>
+ alt: str (optional) for the Alternative representation type you'd like<br>
+ the feed in. If you don't specify an alt parameter, the service<br>
+ returns an Atom feed. This is equivalent to alt='atom'.<br>
+ alt='rss' returns an RSS 2.0 result feed.<br>
+ alt='json' returns a JSON representation of the feed.<br>
+ alt='json-in-script' Requests a response that wraps JSON in a script<br>
+ tag.<br>
+ alt='atom-in-script' Requests an Atom response that wraps an XML<br>
+ string in a script tag.<br>
+ alt='rss-in-script' Requests an RSS response that wraps an XML<br>
+ string in a script tag.<br>
+ updated_min: str (optional), <a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC 3339</a> timestamp format, lower bounds.<br>
+ For example: 2005-08-09T10:57:00-08:00<br>
+ updated_max: str (optional) updated time must be earlier than timestamp.<br>
+ pretty_print: boolean (optional) If True the server's XML response will<br>
+ be indented to make it more human readable. Defaults to False.<br>
+ published_min: str (optional), Similar to updated_min but for published<br>
+ time.<br>
+ published_max: str (optional), Similar to updated_max but for published<br>
+ time.<br>
+ start_index: int or str (optional) 1-based index of the first result to<br>
+ be retrieved. Note that this isn't a general cursoring mechanism.<br>
+ If you first send a query with ?start-index=1&max-results=10 and<br>
+ then send another query with ?start-index=11&max-results=10, the<br>
+ service cannot guarantee that the results are equivalent to<br>
+ ?start-index=1&max-results=20, because insertions and deletions<br>
+ could have taken place in between the two queries.<br>
+ max_results: int or str (optional) Maximum number of results to be<br>
+ retrieved. Each service has a default max (usually 25) which can<br>
+ vary from service to service. There is also a service-specific<br>
+ limit to the max_results you can fetch in a request.<br>
+ strict: boolean (optional) If True, the server will return an error if<br>
+ the server does not recognize any of the parameters in the request<br>
+ URL. Defaults to False.<br>
+ custom_parameters: other query parameters that are not explicitly defined.</tt></dd></dl>
+
+<dl><dt><a name="Query-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<dl><dt><a name="Query-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RedirectError">class <strong>RedirectError</strong></a>(<a href="gdata.client.html#RequestError">RequestError</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#RedirectError">RedirectError</a></dd>
+<dd><a href="gdata.client.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#RequestError">RequestError</a>:<br>
+<dl><dt><strong>body</strong> = None</dl>
+
+<dl><dt><strong>headers</strong> = None</dl>
+
+<dl><dt><strong>reason</strong> = None</dl>
+
+<dl><dt><strong>status</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="RedirectError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RedirectError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RedirectError-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="RedirectError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RedirectError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="RedirectError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RedirectError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RedirectError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RedirectError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RedirectError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RedirectError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RedirectError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RedirectError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RedirectError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RedirectError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RedirectError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="RedirectError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RedirectError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RedirectError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="RedirectError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RequestError">class <strong>RequestError</strong></a>(<a href="gdata.client.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>body</strong> = None</dl>
+
+<dl><dt><strong>headers</strong> = None</dl>
+
+<dl><dt><strong>reason</strong> = None</dl>
+
+<dl><dt><strong>status</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="RequestError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RequestError-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="RequestError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ResumableUploader">class <strong>ResumableUploader</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Resumable upload helper for the Google Data protocol.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="ResumableUploader-QueryUploadStatus"><strong>QueryUploadStatus</strong></a> = <a href="#ResumableUploader-query_upload_status">query_upload_status</a>(self, uri<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ResumableUploader-UpdateFile"><strong>UpdateFile</strong></a> = <a href="#ResumableUploader-update_file">update_file</a>(self, entry_or_resumable_edit_link, headers<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, update_metadata<font color="#909090">=False</font>, uri_params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ResumableUploader-UploadChunk"><strong>UploadChunk</strong></a> = <a href="#ResumableUploader-upload_chunk">upload_chunk</a>(self, start_byte, content_bytes)</dt></dl>
+
+<dl><dt><a name="ResumableUploader-UploadFile"><strong>UploadFile</strong></a> = <a href="#ResumableUploader-upload_file">upload_file</a>(self, resumable_media_link, entry<font color="#909090">=None</font>, headers<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ResumableUploader-__init__"><strong>__init__</strong></a>(self, client, file_handle, content_type, total_file_size, chunk_size<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>)</dt><dd><tt>Starts a resumable upload to a service that supports the protocol.<br>
+ <br>
+Args:<br>
+ client: gdata.client.<a href="#GDClient">GDClient</a> A Google Data API service.<br>
+ file_handle: <a href="__builtin__.html#object">object</a> A file-like <a href="__builtin__.html#object">object</a> containing the file to upload.<br>
+ content_type: str The mimetype of the file to upload.<br>
+ total_file_size: int The file's total size in bytes.<br>
+ chunk_size: int The size of each upload chunk. If None, the<br>
+ DEFAULT_CHUNK_SIZE will be used.<br>
+ desired_class: <a href="__builtin__.html#object">object</a> (optional) The type of gdata.data.GDEntry to parse<br>
+ the completed entry as. This should be specific to the API.</tt></dd></dl>
+
+<dl><dt><a name="ResumableUploader-query_upload_status"><strong>query_upload_status</strong></a>(self, uri<font color="#909090">=None</font>)</dt><dd><tt>Queries the current status of a resumable upload request.<br>
+ <br>
+Args:<br>
+ uri: str (optional) A resumable upload uri to query and override the one<br>
+ that is set in this <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+Returns:<br>
+ An integer representing the file position (byte) to resume the upload from<br>
+ or True if the upload is complete.<br>
+ <br>
+Raises:<br>
+ <a href="#RequestError">RequestError</a> if anything other than a HTTP 308 is returned<br>
+ when the request raises an exception.</tt></dd></dl>
+
+<dl><dt><a name="ResumableUploader-update_file"><strong>update_file</strong></a>(self, entry_or_resumable_edit_link, headers<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, update_metadata<font color="#909090">=False</font>, uri_params<font color="#909090">=None</font>)</dt><dd><tt>Updates the contents of an existing file using the resumable protocol.<br>
+ <br>
+If you are interested in pausing an upload or controlling the chunking<br>
+yourself, use the <a href="#ResumableUploader-upload_chunk">upload_chunk</a>() method instead.<br>
+ <br>
+Args:<br>
+ entry_or_resumable_edit_link: <a href="__builtin__.html#object">object</a> or string A gdata.data.GDEntry for<br>
+ the entry/file to update or the full uri of the link with rel<br>
+ #resumable-edit-media.<br>
+ headers: dict Additional headers to send in the initial request to create<br>
+ the resumable upload request. These headers will override any default<br>
+ headers sent in the request. For example: headers={'Slug': 'MyTitle'}.<br>
+ force boolean (optional) True to force an update and set the If-Match<br>
+ header to '*'. If False and entry_or_resumable_edit_link is a<br>
+ gdata.data.GDEntry <a href="__builtin__.html#object">object</a>, its etag value is used. Otherwise this<br>
+ parameter should be set to True to force the update.<br>
+ auth_token: (optional) An <a href="__builtin__.html#object">object</a> which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ update_metadata: (optional) True to also update the entry's metadata<br>
+ with that in the given GDEntry <a href="__builtin__.html#object">object</a> in entry_or_resumable_edit_link.<br>
+ uri_params: (optional) Dict of additional parameters to attach to the URI.<br>
+ Some non-dict types are valid here, too, like list of tuple pairs.<br>
+ <br>
+Returns:<br>
+ The final Atom entry created on the server. The entry <a href="__builtin__.html#object">object</a>'s type will<br>
+ be the class specified in self.<strong>desired_class</strong>.<br>
+ <br>
+Raises:<br>
+ <a href="#RequestError">RequestError</a> if anything other than a HTTP 308 is returned when the<br>
+ request raises an exception.</tt></dd></dl>
+
+<dl><dt><a name="ResumableUploader-upload_chunk"><strong>upload_chunk</strong></a>(self, start_byte, content_bytes)</dt><dd><tt>Uploads a byte range (chunk) to the resumable upload server.<br>
+ <br>
+Args:<br>
+ start_byte: int The byte offset of the total file where the byte range<br>
+ passed in lives.<br>
+ content_bytes: str The file contents of this chunk.<br>
+ <br>
+Returns:<br>
+ The final Atom entry created on the server. The entry <a href="__builtin__.html#object">object</a>'s type will<br>
+ be the class specified in self.<strong>desired_class</strong>.<br>
+ <br>
+Raises:<br>
+ <a href="#RequestError">RequestError</a> if the unique upload uri is not set or the<br>
+ server returns something other than an HTTP 308 when the upload is<br>
+ incomplete.</tt></dd></dl>
+
+<dl><dt><a name="ResumableUploader-upload_file"><strong>upload_file</strong></a>(self, resumable_media_link, entry<font color="#909090">=None</font>, headers<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Uploads an entire file in chunks using the resumable upload protocol.<br>
+ <br>
+If you are interested in pausing an upload or controlling the chunking<br>
+yourself, use the <a href="#ResumableUploader-upload_chunk">upload_chunk</a>() method instead.<br>
+ <br>
+Args:<br>
+ resumable_media_link: str The full URL for the #resumable-create-media for<br>
+ starting a resumable upload request.<br>
+ entry: A (optional) gdata.data.GDEntry containging metadata to create the <br>
+ upload from.<br>
+ headers: dict Additional headers to send in the initial request to create<br>
+ the resumable upload request. These headers will override any default<br>
+ headers sent in the request. For example: headers={'Slug': 'MyTitle'}.<br>
+ auth_token: (optional) An <a href="__builtin__.html#object">object</a> which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ kwargs: (optional) Other args to pass to self.<strong>_init_session</strong>.<br>
+ <br>
+Returns:<br>
+ The final Atom entry created on the server. The entry <a href="__builtin__.html#object">object</a>'s type will<br>
+ be the class specified in self.<strong>desired_class</strong>.<br>
+ <br>
+Raises:<br>
+ <a href="#RequestError">RequestError</a> if anything other than a HTTP 308 is returned<br>
+ when the request raises an exception.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>DEFAULT_CHUNK_SIZE</strong> = 5242880</dl>
+
+<dl><dt><strong>MIN_CHUNK_SIZE</strong> = 262144</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UnableToUpgradeToken">class <strong>UnableToUpgradeToken</strong></a>(<a href="gdata.client.html#RequestError">RequestError</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#UnableToUpgradeToken">UnableToUpgradeToken</a></dd>
+<dd><a href="gdata.client.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#RequestError">RequestError</a>:<br>
+<dl><dt><strong>body</strong> = None</dl>
+
+<dl><dt><strong>headers</strong> = None</dl>
+
+<dl><dt><strong>reason</strong> = None</dl>
+
+<dl><dt><strong>status</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="UnableToUpgradeToken-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#UnableToUpgradeToken-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#UnableToUpgradeToken-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="UnableToUpgradeToken-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnableToUpgradeToken-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="UnableToUpgradeToken-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#UnableToUpgradeToken-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="UnableToUpgradeToken-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#UnableToUpgradeToken-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="UnableToUpgradeToken-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#UnableToUpgradeToken-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="UnableToUpgradeToken-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="UnableToUpgradeToken-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnableToUpgradeToken-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="UnableToUpgradeToken-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnableToUpgradeToken-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="UnableToUpgradeToken-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="UnableToUpgradeToken-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#UnableToUpgradeToken-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="UnableToUpgradeToken-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Unauthorized">class <strong>Unauthorized</strong></a>(<a href="gdata.client.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.client.html#Unauthorized">Unauthorized</a></dd>
+<dd><a href="gdata.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Unauthorized-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Unauthorized-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Unauthorized-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Unauthorized-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Unauthorized-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Unauthorized-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Unauthorized-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Unauthorized-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Unauthorized-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Unauthorized-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Unauthorized-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Unauthorized-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Unauthorized-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Unauthorized-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Unauthorized-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Unauthorized-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Unauthorized-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Unauthorized-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Unauthorized-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Unauthorized-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-error_from_response"><strong>error_from_response</strong></a>(message, http_response, error_class, response_body<font color="#909090">=None</font>)</dt><dd><tt>Creates a new exception and sets the HTTP information in the error.<br>
+ <br>
+Args:<br>
+ message: str human readable message to be displayed if the exception is<br>
+ not caught.<br>
+ http_response: The response from the server, contains error information.<br>
+ error_class: The exception to be instantiated and populated with<br>
+ information from the http_response<br>
+ response_body: str (optional) specify if the response has already been read<br>
+ from the http_response <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+ <dl><dt><a name="-get_xml_version"><strong>get_xml_version</strong></a>(version)</dt><dd><tt>Determines which XML schema to use based on the client API version.<br>
+ <br>
+Args:<br>
+ version: string which is converted to an int. The version string is in<br>
+ the form 'Major.Minor.x.y.z' and only the major version number<br>
+ is considered. If None is provided assume version 1.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.codesearch.html b/pydocs/gdata.codesearch.html
new file mode 100644
index 0000000..aa4c2c3
--- /dev/null
+++ b/pydocs/gdata.codesearch.html
@@ -0,0 +1,469 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.codesearch</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.codesearch</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/codesearch/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/codesearch/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains extensions to Atom objects used by Google Codesearch</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.codesearch.service.html">service</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.codesearch.html#File">File</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.codesearch.html#Match">Match</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.codesearch.html#Package">Package</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.codesearch.html#CodesearchEntry">CodesearchEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.codesearch.html#CodesearchFeed">CodesearchFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CodesearchEntry">class <strong>CodesearchEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google codesearch atom entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.codesearch.html#CodesearchEntry">CodesearchEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CodesearchEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, match<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="CodesearchEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CodesearchEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CodesearchEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CodesearchEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CodesearchEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CodesearchEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CodesearchFeed">class <strong>CodesearchFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>feed containing list of Google codesearch Items<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.codesearch.html#CodesearchFeed">CodesearchFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="CodesearchFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CodesearchFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CodesearchFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CodesearchFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CodesearchFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CodesearchFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="File">class <strong>File</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Codesearch file element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.codesearch.html#File">File</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="File-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="File-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="File-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="File-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Match">class <strong>Match</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Codesearch match element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.codesearch.html#Match">Match</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Match-__init__"><strong>__init__</strong></a>(self, line_number<font color="#909090">=None</font>, type<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Match-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Match-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Match-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Package">class <strong>Package</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Codesearch package element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.codesearch.html#Package">Package</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Package-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Package-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Package-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Package-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-CodesearchEntryFromString"><strong>CodesearchEntryFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#CodesearchEntry">CodesearchEntry</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a Codesearch feed entry.<br>
+ <br>
+Returns:<br>
+ A <a href="#CodesearchEntry">CodesearchEntry</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-CodesearchFeedFromString"><strong>CodesearchFeedFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#CodesearchFeed">CodesearchFeed</a> object.<br>
+Args:<br>
+xml_string: string The XML describing a Codesearch feed.<br>
+Returns:<br>
+A CodeseartchFeed object corresponding to the given XML.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>CODESEARCH_NAMESPACE</strong> = 'http://schemas.google.com/codesearch/2006'<br>
+<strong>CODESEARCH_TEMPLATE</strong> = '{http://shema.google.com/codesearch/2006}%s'<br>
+<strong>__author__</strong> = 'Benoit Chesneau'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Benoit Chesneau</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.codesearch.service.html b/pydocs/gdata.codesearch.service.html
new file mode 100644
index 0000000..d9bf1e8
--- /dev/null
+++ b/pydocs/gdata.codesearch.service.html
@@ -0,0 +1,835 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.codesearch.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.codesearch.html"><font color="#ffffff">codesearch</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/codesearch/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/codesearch/service.py</a></font></td></tr></table>
+ <p><tt><a href="#CodesearchService">CodesearchService</a> extends <a href="gdata.service.html#GDataService">GDataService</a> to streamline Google Codesearch <br>
+operations</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.codesearch.service.html#CodesearchService">CodesearchService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Query">gdata.service.Query</a>(<a href="__builtin__.html#dict">__builtin__.dict</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.codesearch.service.html#CodesearchQuery">CodesearchQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CodesearchQuery">class <strong>CodesearchQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Object used to construct the query to the Google Codesearch feed. here only as a shorcut<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.codesearch.service.html#CodesearchQuery">CodesearchQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CodesearchQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">='/codesearch/feeds/search'</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Codesearch <a href="gdata.service.html#Query">Query</a>.<br>
+ <br>
+Args:<br>
+ feed: string (optional) The path for the feed. (e.g. '/codesearch/feeds/search')<br>
+ text_query: string (optional) The contents of the q query parameter. This<br>
+ string is URL escaped upon conversion to a URI.<br>
+ params: dict (optional) Parameter value string pairs which become URL<br>
+ params when translated to a URI. These parameters are added to<br>
+ the query's items.<br>
+ categories: list (optional) List of category strings which should be<br>
+ included as query categories. See gdata.service.<a href="gdata.service.html#Query">Query</a> for<br>
+ additional documentation.<br>
+ <br>
+Yelds:<br>
+ A <a href="#CodesearchQuery">CodesearchQuery</a> object to construct a URI based on Codesearch feed</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="CodesearchQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="CodesearchQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CodesearchQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#CodesearchQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#CodesearchQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#CodesearchQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#CodesearchQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="CodesearchQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#CodesearchQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#CodesearchQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CodesearchService">class <strong>CodesearchService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for Google codesearch service<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.codesearch.service.html#CodesearchService">CodesearchService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CodesearchService-GetSnippetsFeed"><strong>GetSnippetsFeed</strong></a>(self, text_query<font color="#909090">=None</font>)</dt><dd><tt>Retrieve Codesearch feed for a keyword<br>
+ <br>
+Args:<br>
+ text_query : string (optional) The contents of the q query parameter. This<br>
+ string is URL escaped upon conversion to a URI.<br>
+Returns:<br>
+ A CodesearchFeed objects representing the feed returned by the server</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-Query"><strong>Query</strong></a>(self, uri, converter<font color="#909090">=<function CodesearchFeedFromString></font>)</dt><dd><tt>Queries the Codesearch feed and returns the resulting feed of<br>
+ entries.<br>
+ <br>
+Args:<br>
+uri: string The full URI to be queried. This can contain query<br>
+ parameters, a hostname, or simply the relative path to a Document<br>
+ List feed. The DocumentQuery object is useful when constructing<br>
+ query parameters.<br>
+converter: func (optional) A function which will be executed on the<br>
+ retrieved item, generally to render it into a Python object.<br>
+ By default the CodesearchFeedFromString function is used to<br>
+ return a CodesearchFeed object. This is because most feed<br>
+ queries will result in a feed and not a single entry.<br>
+ <br>
+Returns :<br>
+ A CodesearchFeed objects representing the feed returned by the server</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='www.google.com'</font>, additional_headers<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a client for the Google codesearch service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'www.google.com'.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="CodesearchService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CodesearchService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#CodesearchService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#CodesearchService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#CodesearchService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="CodesearchService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="CodesearchService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'Benoit Chesneau'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Benoit Chesneau</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.contacts.client.html b/pydocs/gdata.contacts.client.html
new file mode 100644
index 0000000..c0e4c70
--- /dev/null
+++ b/pydocs/gdata.contacts.client.html
@@ -0,0 +1,972 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.contacts.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.contacts.html"><font color="#ffffff">contacts</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contacts/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contacts/client.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.client.html#ContactsClient">ContactsClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#Query">gdata.client.Query</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.client.html#ContactsQuery">ContactsQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.client.html#ProfilesQuery">ProfilesQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContactsClient">class <strong>ContactsClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.client.html#ContactsClient">ContactsClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ContactsClient-AddContact"><strong>AddContact</strong></a> = <a href="#ContactsClient-add_contact">add_contact</a>(self, new_contact, insert_uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, billing_information<font color="#909090">=None</font>, birthday<font color="#909090">=None</font>, calendar_link<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-ChangePhoto"><strong>ChangePhoto</strong></a> = <a href="#ContactsClient-change_photo">change_photo</a>(self, media, contact_entry_or_url, content_type<font color="#909090">=None</font>, content_length<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-CreateContact"><strong>CreateContact</strong></a> = <a href="#ContactsClient-create_contact">create_contact</a>(self, new_contact, insert_uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-CreateGroup"><strong>CreateGroup</strong></a> = <a href="#ContactsClient-create_group">create_group</a>(self, new_group, insert_uri<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-DeleteGroup"><strong>DeleteGroup</strong></a> = <a href="#ContactsClient-delete_group">delete_group</a>(self, group_object, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kws)</dt></dl>
+
+<dl><dt><a name="ContactsClient-DeletePhoto"><strong>DeletePhoto</strong></a> = <a href="#ContactsClient-delete_photo">delete_photo</a>(self, contact_entry_or_url, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-ExecuteBatch"><strong>ExecuteBatch</strong></a> = <a href="#ContactsClient-execute_batch">execute_batch</a>(self, batch_feed, url<font color="#909090">='https://www.google.com/m8/feeds/contacts/default/full/batch'</font>, desired_class<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-ExecuteBatchProfiles"><strong>ExecuteBatchProfiles</strong></a> = <a href="#ContactsClient-execute_batch_profiles">execute_batch_profiles</a>(self, batch_feed, url<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.contacts.data.ProfilesFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-GetContact"><strong>GetContact</strong></a> = <a href="#ContactsClient-get_contact">get_contact</a>(self, uri, desired_class<font color="#909090">=<class 'gdata.contacts.data.ContactEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-GetContacts"><strong>GetContacts</strong></a> = <a href="#ContactsClient-get_contacts">get_contacts</a>(self, uri<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.contacts.data.ContactsFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-GetFeedUri"><strong>GetFeedUri</strong></a> = <a href="#ContactsClient-get_feed_uri">get_feed_uri</a>(self, kind<font color="#909090">='contacts'</font>, contact_list<font color="#909090">=None</font>, projection<font color="#909090">='full'</font>, scheme<font color="#909090">='https'</font>)</dt></dl>
+
+<dl><dt><a name="ContactsClient-GetGroup"><strong>GetGroup</strong></a> = <a href="#ContactsClient-get_group">get_group</a>(self, uri<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.contacts.data.GroupEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-GetGroups"><strong>GetGroups</strong></a> = <a href="#ContactsClient-get_groups">get_groups</a>(self, uri<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.contacts.data.GroupsFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-GetPhoto"><strong>GetPhoto</strong></a> = <a href="#ContactsClient-get_photo">get_photo</a>(self, contact_entry_or_url, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-GetProfile"><strong>GetProfile</strong></a> = <a href="#ContactsClient-get_profile">get_profile</a>(self, uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-GetProfilesFeed"><strong>GetProfilesFeed</strong></a> = <a href="#ContactsClient-get_profiles_feed">get_profiles_feed</a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-UpdateGroup"><strong>UpdateGroup</strong></a> = <a href="#ContactsClient-update_group">update_group</a>(self, edit_uri, updated_group, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, desired_class<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-UpdateProfile"><strong>UpdateProfile</strong></a> = <a href="#ContactsClient-update_profile">update_profile</a>(self, updated_profile, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-__init__"><strong>__init__</strong></a>(self, domain<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a new client for the Email Settings API.<br>
+ <br>
+Args:<br>
+ domain: string The Google Apps domain (if any).<br>
+ kwargs: The other parameters to pass to the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a><br>
+ constructor.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-add_contact"><strong>add_contact</strong></a>(self, new_contact, insert_uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, billing_information<font color="#909090">=None</font>, birthday<font color="#909090">=None</font>, calendar_link<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds an new contact to Google Contacts.<br>
+ <br>
+Args:<br>
+ new_contact: atom.Entry or subclass A new contact which is to be added to<br>
+ Google Contacts.<br>
+ insert_uri: the URL to post new contacts to the feed<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the contact created<br>
+ On failure, a RequestError is raised of the form:<br>
+ {'status': HTTP status code from server,<br>
+ 'reason': HTTP reason from the server,<br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-change_photo"><strong>change_photo</strong></a>(self, media, contact_entry_or_url, content_type<font color="#909090">=None</font>, content_length<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Change the photo for the contact by uploading a new photo.<br>
+ <br>
+Performs a PUT against the photo edit URL to send the binary data for the<br>
+photo.<br>
+ <br>
+Args:<br>
+ media: filename, file-like-object, or a gdata.data.MediaSource object to send.<br>
+ contact_entry_or_url: ContactEntry or str If it is a ContactEntry, this<br>
+ method will search for an edit photo link URL and<br>
+ perform a PUT to the URL.<br>
+ content_type: str (optional) the mime type for the photo data. This is<br>
+ necessary if media is a file or file name, but if media<br>
+ is a MediaSource object then the media object can contain<br>
+ the mime type. If media_type is set, it will override the<br>
+ mime type in the media object.<br>
+ content_length: int or str (optional) Specifying the content length is<br>
+ only required if media is a file-like object. If media<br>
+ is a filename, the length is determined using<br>
+ os.path.getsize. If media is a MediaSource object, it is<br>
+ assumed that it already contains the content length.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-create_contact"><strong>create_contact</strong></a>(self, new_contact, insert_uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds an new contact to Google Contacts.<br>
+ <br>
+Args:<br>
+ new_contact: atom.Entry or subclass A new contact which is to be added to<br>
+ Google Contacts.<br>
+ insert_uri: the URL to post new contacts to the feed<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the contact created<br>
+ On failure, a RequestError is raised of the form:<br>
+ {'status': HTTP status code from server,<br>
+ 'reason': HTTP reason from the server,<br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-create_group"><strong>create_group</strong></a>(self, new_group, insert_uri<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-delete_group"><strong>delete_group</strong></a>(self, group_object, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kws)</dt></dl>
+
+<dl><dt><a name="ContactsClient-delete_photo"><strong>delete_photo</strong></a>(self, contact_entry_or_url, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Delete the contact's profile photo.<br>
+ <br>
+Args:<br>
+ contact_entry_or_url: a gdata.contacts.ContactEntry object or a string<br>
+ containing the photo link's URL.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-execute_batch"><strong>execute_batch</strong></a>(self, batch_feed, url<font color="#909090">='https://www.google.com/m8/feeds/contacts/default/full/batch'</font>, desired_class<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request feed to the server.<br>
+ <br>
+Args:<br>
+ batch_feed: gdata.contacts.ContactFeed A feed containing batch<br>
+ request entries. Each entry contains the operation to be performed<br>
+ on the data contained in the entry. For example an entry with an<br>
+ operation type of insert will be used as if the individual entry<br>
+ had been inserted.<br>
+ url: str The batch URL to which these operations should be applied.<br>
+ converter: Function (optional) The function used to convert the server's<br>
+ response to an object.<br>
+ <br>
+Returns:<br>
+ The results of the batch request's execution on the server. If the<br>
+ default converter is used, this is stored in a ContactsFeed.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-execute_batch_profiles"><strong>execute_batch_profiles</strong></a>(self, batch_feed, url<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.contacts.data.ProfilesFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request feed to the server.<br>
+ <br>
+Args:<br>
+ batch_feed: gdata.profiles.ProfilesFeed A feed containing batch<br>
+ request entries. Each entry contains the operation to be performed<br>
+ on the data contained in the entry. For example an entry with an<br>
+ operation type of insert will be used as if the individual entry<br>
+ had been inserted.<br>
+ url: string The batch URL to which these operations should be applied.<br>
+ converter: Function (optional) The function used to convert the server's<br>
+ response to an object. The default value is<br>
+ gdata.profiles.ProfilesFeedFromString.<br>
+ <br>
+Returns:<br>
+ The results of the batch request's execution on the server. If the<br>
+ default converter is used, this is stored in a ProfilesFeed.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-get_contact"><strong>get_contact</strong></a>(self, uri, desired_class<font color="#909090">=<class 'gdata.contacts.data.ContactEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-get_contacts"><strong>get_contacts</strong></a>(self, uri<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.contacts.data.ContactsFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Obtains a feed with the contacts belonging to the current user.<br>
+ <br>
+Args:<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of SpreadsheetsClient.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (desired_class=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.spreadsheets.data.SpreadsheetsFeed.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-get_feed_uri"><strong>get_feed_uri</strong></a>(self, kind<font color="#909090">='contacts'</font>, contact_list<font color="#909090">=None</font>, projection<font color="#909090">='full'</font>, scheme<font color="#909090">='https'</font>)</dt><dd><tt>Builds a feed URI.<br>
+ <br>
+Args:<br>
+ kind: The type of feed to return, typically 'groups' or 'contacts'.<br>
+ Default value: 'contacts'.<br>
+ contact_list: The contact list to return a feed for.<br>
+ Default value: self.<strong>contact_list</strong>.<br>
+ projection: The projection to apply to the feed contents, for example<br>
+ 'full', 'base', 'base/12345', 'full/batch'. Default value: 'full'.<br>
+ scheme: The URL scheme such as 'http' or 'https', None to return a<br>
+ relative URI without hostname.<br>
+ <br>
+Returns:<br>
+ A feed URI using the given kind, contact list, and projection.<br>
+ Example: '/m8/feeds/contacts/default/full'.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-get_group"><strong>get_group</strong></a>(self, uri<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.contacts.data.GroupEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Get a single groups details<br>
+Args:<br>
+ uri: the group uri or id</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-get_groups"><strong>get_groups</strong></a>(self, uri<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.contacts.data.GroupsFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-get_photo"><strong>get_photo</strong></a>(self, contact_entry_or_url, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrives the binary data for the contact's profile photo as a string.<br>
+ <br>
+Args:<br>
+ contact_entry_or_url: a gdata.contacts.ContactEntry object or a string<br>
+ containing the photo link's URL. If the contact entry does not<br>
+ contain a photo link, the image will not be fetched and this method<br>
+ will return None.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-get_profile"><strong>get_profile</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves a domain's profile for the user.<br>
+ <br>
+Args:<br>
+ uri: string the URL to retrieve the profiles feed,<br>
+ for example /m8/feeds/profiles/default/full/username<br>
+ <br>
+Returns:<br>
+ On success, a ProfileEntry containing the profile for the user.<br>
+ On failure, raises a RequestError</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-get_profiles_feed"><strong>get_profiles_feed</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves a feed containing all domain's profiles.<br>
+ <br>
+Args:<br>
+ uri: string (optional) the URL to retrieve the profiles feed,<br>
+ for example /m8/feeds/profiles/default/full<br>
+ <br>
+Returns:<br>
+ On success, a ProfilesFeed containing the profiles.<br>
+ On failure, raises a RequestError.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-update_group"><strong>update_group</strong></a>(self, edit_uri, updated_group, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, desired_class<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-update_profile"><strong>update_profile</strong></a>(self, updated_profile, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt><dd><tt>Updates an existing profile.<br>
+ <br>
+Args:<br>
+ updated_profile: atom.Entry or subclass containing<br>
+ the Atom Entry which will replace the profile which is<br>
+ stored at the edit_url.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#ContactsClient">ContactsClient</a>.<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful update, a httplib.HTTPResponse containing the server's<br>
+ response to the PUT request.<br>
+ On failure, raises a RequestError.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '3'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://www.google.com/m8/feeds/', 'http://www.google.com/m8/feeds/')</dl>
+
+<dl><dt><strong>auth_service</strong> = 'cp'</dl>
+
+<dl><dt><strong>contact_list</strong> = 'default'</dl>
+
+<dl><dt><strong>server</strong> = 'www.google.com'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="ContactsClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContactsClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactsClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContactsClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="ContactsClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="ContactsClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContactsQuery">class <strong>ContactsQuery</strong></a>(<a href="gdata.client.html#Query">gdata.client.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Create a custom Contacts <a href="gdata.client.html#Query">Query</a><br>
+ <br>
+Full specs can be found at: U{Contacts query parameters reference<br>
+<<a href="http://code.google.com/apis/contacts/docs/3.0/reference.html#Parameters">http://code.google.com/apis/contacts/docs/3.0/reference.html#Parameters</a>>}<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.client.html#ContactsQuery">ContactsQuery</a></dd>
+<dd><a href="gdata.client.html#Query">gdata.client.Query</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ContactsQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#ContactsQuery-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="ContactsQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, group<font color="#909090">=None</font>, orderby<font color="#909090">=None</font>, showdeleted<font color="#909090">=None</font>, sortorder<font color="#909090">=None</font>, requirealldeleted<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>@param max_results: The maximum number of entries to return. If you want<br>
+ to receive all of the contacts, rather than only the default maximum, you<br>
+ can specify a very large number for max-results.<br>
+@param start-index: The 1-based index of the first result to be retrieved.<br>
+@param updated-min: The lower bound on entry update dates.<br>
+@param group: Constrains the results to only the contacts belonging to the<br>
+ group specified. Value of this parameter specifies group ID<br>
+@param orderby: Sorting criterion. The only supported value is<br>
+ lastmodified.<br>
+@param showdeleted: Include deleted contacts in the returned contacts feed<br>
+@pram sortorder: Sorting order direction. Can be either ascending or<br>
+ descending.<br>
+@param requirealldeleted: Only relevant if showdeleted and updated-min<br>
+ are also provided. It dictates the behavior of the server in case it<br>
+ detects that placeholders of some entries deleted since the point in<br>
+ time specified as updated-min may have been lost.</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><a name="ContactsQuery-AddCustomParameter"><strong>AddCustomParameter</strong></a> = add_custom_parameter(self, key, value)</dt></dl>
+
+<dl><dt><a name="ContactsQuery-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProfilesQuery">class <strong>ProfilesQuery</strong></a>(<a href="gdata.client.html#Query">gdata.client.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Create a custom Profiles <a href="gdata.client.html#Query">Query</a><br>
+ <br>
+Full specs can be found at: U{Profiless query parameters reference<br>
+<<a href="http://code.google.com/apis/apps/profiles/reference.html#Parameters">http://code.google.com/apis/apps/profiles/reference.html#Parameters</a>>}<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.client.html#ProfilesQuery">ProfilesQuery</a></dd>
+<dd><a href="gdata.client.html#Query">gdata.client.Query</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ProfilesQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#ProfilesQuery-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="ProfilesQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, start_key<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>@param start_key: Opaque key of the first element to retrieve. Present in<br>
+ the next link of an earlier request, if further pages of response are<br>
+ available.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><a name="ProfilesQuery-AddCustomParameter"><strong>AddCustomParameter</strong></a> = add_custom_parameter(self, key, value)</dt></dl>
+
+<dl><dt><a name="ProfilesQuery-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DEFAULT_BATCH_URL</strong> = 'https://www.google.com/m8/feeds/contacts/default/full/batch'<br>
+<strong>DEFAULT_PROFILES_BATCH_URL</strong> = 'https://www.google.com/m8/feeds/profiles/domain/%s/full/batch'<br>
+<strong>__author__</strong> = 'vinces1979@gmail.com (Vince Spicer)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">vinces1979@gmail.com (Vince Spicer)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.contacts.data.html b/pydocs/gdata.contacts.data.html
new file mode 100644
index 0000000..98c7372
--- /dev/null
+++ b/pydocs/gdata.contacts.data.html
@@ -0,0 +1,8555 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.contacts.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.contacts.html"><font color="#ffffff">contacts</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contacts/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contacts/data.py</a></font></td></tr></table>
+ <p><tt>Data model classes for parsing and generating XML for the Contacts API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#BillingInformation">BillingInformation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Birthday">Birthday</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#CalendarLink">CalendarLink</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#City">City</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Country">Country</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Deleted">Deleted</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#DirectoryServer">DirectoryServer</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Event">Event</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#ExternalId">ExternalId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Gender">Gender</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#GroupMembershipInfo">GroupMembershipInfo</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Hobby">Hobby</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#HouseName">HouseName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Initials">Initials</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Jot">Jot</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Language">Language</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#MaidenName">MaidenName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Mileage">Mileage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Neighborhood">Neighborhood</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#NickName">NickName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Occupation">Occupation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#POBox">POBox</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#PostalCode">PostalCode</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Priority">Priority</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Region">Region</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Relation">Relation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Sensitivity">Sensitivity</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Status">Status</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Street">Street</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#SubRegion">SubRegion</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#SystemGroup">SystemGroup</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#UserDefinedField">UserDefinedField</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#Website">Website</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Link">atom.data.Link</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#ContactLink">ContactLink</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#GroupEntry">GroupEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#PersonEntry">PersonEntry</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#ContactEntry">ContactEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#ProfileEntry">ProfileEntry</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#ContactsFeed">ContactsFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#GroupsFeed">GroupsFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.data.html#ProfilesFeed">ProfilesFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BillingInformation">class <strong>BillingInformation</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>gContact:billingInformation<br>
+Specifies billing information of the entity represented by the contact. The element cannot be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#BillingInformation">BillingInformation</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BillingInformation-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BillingInformation-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BillingInformation-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BillingInformation-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BillingInformation-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="BillingInformation-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="BillingInformation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BillingInformation-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BillingInformation-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BillingInformation-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Birthday">class <strong>Birthday</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Stores birthday date of the person represented by the contact. The element cannot be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Birthday">Birthday</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>when</strong> = 'when'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Birthday-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Birthday-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Birthday-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Birthday-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Birthday-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Birthday-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Birthday-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Birthday-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Birthday-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Birthday-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CalendarLink">class <strong>CalendarLink</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Storage for URL of the contact's calendar. The element can be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#CalendarLink">CalendarLink</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>primary</strong> = 'primary'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CalendarLink-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarLink-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarLink-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarLink-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarLink-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CalendarLink-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CalendarLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CalendarLink-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CalendarLink-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CalendarLink-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="City">class <strong>City</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Can be city, village, town, borough, etc. This is the postal town and not<br>
+necessarily the place of residence or place of business.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#City">City</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="City-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="City-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="City-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="City-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="City-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="City-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="City-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="City-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="City-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="City-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContactEntry">class <strong>ContactEntry</strong></a>(<a href="gdata.contacts.data.html#PersonEntry">PersonEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Contacts flavor of an Atom Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#ContactEntry">ContactEntry</a></dd>
+<dd><a href="gdata.contacts.data.html#PersonEntry">PersonEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ContactEntry-GetPhotoEditLink"><strong>GetPhotoEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetPhotoLink"><strong>GetPhotoLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>deleted</strong> = <class 'gdata.contacts.data.Deleted'><dd><tt>If present, indicates that this contact has been deleted.</tt></dl>
+
+<dl><dt><strong>group_membership_info</strong> = [<class 'gdata.contacts.data.GroupMembershipInfo'>]</dl>
+
+<dl><dt><strong>organization</strong> = <class 'gdata.data.Organization'><dd><tt>The gd:organization element.<br>
+ <br>
+An organization, typically associated with a contact.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.contacts.data.html#PersonEntry">PersonEntry</a>:<br>
+<dl><dt><strong>billing_information</strong> = <class 'gdata.contacts.data.BillingInformation'><dd><tt>gContact:billingInformation<br>
+Specifies billing information of the entity represented by the contact. The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>birthday</strong> = <class 'gdata.contacts.data.Birthday'><dd><tt>Stores birthday date of the person represented by the contact. The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>calendar_link</strong> = [<class 'gdata.contacts.data.CalendarLink'>]</dl>
+
+<dl><dt><strong>directory_server</strong> = <class 'gdata.contacts.data.DirectoryServer'><dd><tt>A directory server associated with this contact.<br>
+May not be repeated.</tt></dl>
+
+<dl><dt><strong>email</strong> = [<class 'gdata.data.Email'>]</dl>
+
+<dl><dt><strong>event</strong> = [<class 'gdata.contacts.data.Event'>]</dl>
+
+<dl><dt><strong>extended_property</strong> = [<class 'gdata.data.ExtendedProperty'>]</dl>
+
+<dl><dt><strong>external_id</strong> = [<class 'gdata.contacts.data.ExternalId'>]</dl>
+
+<dl><dt><strong>gender</strong> = <class 'gdata.contacts.data.Gender'><dd><tt>Specifies the gender of the person represented by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>hobby</strong> = [<class 'gdata.contacts.data.Hobby'>]</dl>
+
+<dl><dt><strong>im</strong> = [<class 'gdata.data.Im'>]</dl>
+
+<dl><dt><strong>initials</strong> = <class 'gdata.contacts.data.Initials'><dd><tt>Specifies the initials of the person represented by the contact. The<br>
+element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>jot</strong> = [<class 'gdata.contacts.data.Jot'>]</dl>
+
+<dl><dt><strong>language</strong> = [<class 'gdata.contacts.data.Language'>]</dl>
+
+<dl><dt><strong>link</strong> = [<class 'gdata.contacts.data.ContactLink'>]</dl>
+
+<dl><dt><strong>maiden_name</strong> = <class 'gdata.contacts.data.MaidenName'><dd><tt>Specifies maiden name of the person represented by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>mileage</strong> = <class 'gdata.contacts.data.Mileage'><dd><tt>Specifies the mileage for the entity represented by the contact.<br>
+Can be used for example to document distance needed for reimbursement<br>
+purposes. The value is not interpreted. The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>name</strong> = <class 'gdata.data.Name'><dd><tt>The gd:name element.<br>
+ <br>
+Allows storing person's name in a structured way. Consists of<br>
+given name, additional name, family name, prefix, suffix and full name.</tt></dl>
+
+<dl><dt><strong>nickname</strong> = <class 'gdata.contacts.data.NickName'><dd><tt>Specifies the nickname of the person represented by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>occupation</strong> = <class 'gdata.contacts.data.Occupation'><dd><tt>Specifies the occupation/profession of the person specified by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>phone_number</strong> = [<class 'gdata.data.PhoneNumber'>]</dl>
+
+<dl><dt><strong>postal_address</strong> = [<class 'gdata.data.PostalAddress'>]</dl>
+
+<dl><dt><strong>priority</strong> = <class 'gdata.contacts.data.Priority'><dd><tt>Classifies importance of the contact into 3 categories:<br>
+ * Low<br>
+ * Normal<br>
+ * High<br>
+ <br>
+The priority element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>relation</strong> = [<class 'gdata.contacts.data.Relation'>]</dl>
+
+<dl><dt><strong>sensitivity</strong> = <class 'gdata.contacts.data.Sensitivity'><dd><tt>Classifies sensitivity of the contact into the following categories:<br>
+ * Confidential<br>
+ * Normal<br>
+ * Personal<br>
+ * Private<br>
+ <br>
+The sensitivity element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>status</strong> = <class 'gdata.contacts.data.Status'><dd><tt>Person's status element.</tt></dl>
+
+<dl><dt><strong>structured_postal_address</strong> = [<class 'gdata.data.StructuredPostalAddress'>]</dl>
+
+<dl><dt><strong>user_defined_field</strong> = [<class 'gdata.contacts.data.UserDefinedField'>]</dl>
+
+<dl><dt><strong>website</strong> = [<class 'gdata.contacts.data.Website'>]</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="ContactEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ContactEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ContactEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ContactEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ContactEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContactLink">class <strong>ContactLink</strong></a>(<a href="atom.data.html#Link">atom.data.Link</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Extends atom.data.<a href="atom.data.html#Link">Link</a> to add gd:etag attribute for photo link.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#ContactLink">ContactLink</a></dd>
+<dd><a href="atom.data.html#Link">atom.data.Link</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Link">atom.data.Link</a>:<br>
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<dl><dt><strong>hreflang</strong> = 'hreflang'</dl>
+
+<dl><dt><strong>length</strong> = 'length'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>title</strong> = 'title'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ContactLink-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactLink-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactLink-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContactLink-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactLink-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ContactLink-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContactLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactLink-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContactLink-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactLink-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContactsFeed">class <strong>ContactsFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A collection of Contacts.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#ContactsFeed">ContactsFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.contacts.data.ContactEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="ContactsFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ContactsFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ContactsFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ContactsFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ContactsFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ContactsFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Country">class <strong>Country</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The name or code of the country.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Country">Country</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Country-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Country-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Country-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Country-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Country-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Country-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Country-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Country-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Country-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Country-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Deleted">class <strong>Deleted</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>If present, indicates that this contact has been deleted.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Deleted">Deleted</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Deleted-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Deleted-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Deleted-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DirectoryServer">class <strong>DirectoryServer</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A directory server associated with this contact.<br>
+May not be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#DirectoryServer">DirectoryServer</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="DirectoryServer-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DirectoryServer-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DirectoryServer-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DirectoryServer-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DirectoryServer-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="DirectoryServer-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="DirectoryServer-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DirectoryServer-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DirectoryServer-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DirectoryServer-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Event">class <strong>Event</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>These elements describe events associated with a contact.<br>
+They may be repeated<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Event">Event</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>when</strong> = <class 'gdata.data.When'><dd><tt>The gd:when element.<br>
+ <br>
+Represents a period of time or an instant.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Event-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Event-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Event-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Event-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Event-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Event-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Event-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Event-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Event-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Event-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExternalId">class <strong>ExternalId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt> Describes an ID of the contact in an external system of some kind.<br>
+This element may be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#ExternalId">ExternalId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ExternalId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExternalId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExternalId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExternalId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExternalId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ExternalId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ExternalId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ExternalId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExternalId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExternalId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Gender">class <strong>Gender</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Specifies the gender of the person represented by the contact.<br>
+The element cannot be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Gender">Gender</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Gender-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gender-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gender-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Gender-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gender-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Gender-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Gender-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Gender-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Gender-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gender-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupEntry">class <strong>GroupEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a contact group.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#GroupEntry">GroupEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>extended_property</strong> = [<class 'gdata.data.ExtendedProperty'>]</dl>
+
+<dl><dt><strong>system_group</strong> = <class 'gdata.contacts.data.SystemGroup'><dd><tt>The contacts systemGroup element.<br>
+ <br>
+When used within a contact group entry, indicates that the group in<br>
+question is one of the predefined system groups.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="GroupEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="GroupEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GroupEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupMembershipInfo">class <strong>GroupMembershipInfo</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Identifies the group to which the contact belongs or belonged.<br>
+The group is referenced by its id.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#GroupMembershipInfo">GroupMembershipInfo</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>deleted</strong> = 'deleted'</dl>
+
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GroupMembershipInfo-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMembershipInfo-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMembershipInfo-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupMembershipInfo-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMembershipInfo-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GroupMembershipInfo-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GroupMembershipInfo-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupMembershipInfo-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupMembershipInfo-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupMembershipInfo-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupsFeed">class <strong>GroupsFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google contact groups feed flavor of an Atom Feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#GroupsFeed">GroupsFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.contacts.data.GroupEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="GroupsFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="GroupsFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="GroupsFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GroupsFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupsFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="GroupsFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Hobby">class <strong>Hobby</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an ID of the contact in an external system of some kind.<br>
+This element may be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Hobby">Hobby</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Hobby-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Hobby-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Hobby-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Hobby-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Hobby-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Hobby-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Hobby-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Hobby-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Hobby-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Hobby-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HouseName">class <strong>HouseName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Used in places where houses or buildings have names (and<br>
+not necessarily numbers), eg. "The Pillars".<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#HouseName">HouseName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="HouseName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="HouseName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="HouseName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Initials">class <strong>Initials</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Specifies the initials of the person represented by the contact. The<br>
+element cannot be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Initials">Initials</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Initials-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Initials-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Initials-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Initials-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Initials-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Initials-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Initials-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Initials-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Initials-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Initials-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Jot">class <strong>Jot</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Storage for arbitrary pieces of information about the contact. Each jot<br>
+has a type specified by the rel attribute and a text value.<br>
+The element can be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Jot">Jot</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Jot-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Jot-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Jot-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Jot-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Jot-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Jot-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Jot-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Jot-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Jot-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Jot-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Language">class <strong>Language</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Specifies the preferred languages of the contact.<br>
+The element can be repeated.<br>
+ <br>
+ The language must be specified using one of two mutually exclusive methods:<br>
+ using the freeform @label attribute, or using the @code attribute, whose value<br>
+ must conform to the IETF BCP 47 specification.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Language">Language</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>code</strong> = 'code'</dl>
+
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Language-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Language-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Language-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Language-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Language-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Language-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Language-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Language-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Language-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Language-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MaidenName">class <strong>MaidenName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Specifies maiden name of the person represented by the contact.<br>
+The element cannot be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#MaidenName">MaidenName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MaidenName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MaidenName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MaidenName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MaidenName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MaidenName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MaidenName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MaidenName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MaidenName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MaidenName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MaidenName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Mileage">class <strong>Mileage</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Specifies the mileage for the entity represented by the contact.<br>
+Can be used for example to document distance needed for reimbursement<br>
+purposes. The value is not interpreted. The element cannot be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Mileage">Mileage</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Mileage-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Mileage-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Mileage-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Mileage-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Mileage-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Mileage-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Mileage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Mileage-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Mileage-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Mileage-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Neighborhood">class <strong>Neighborhood</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This is used to disambiguate a street address when a city contains more than<br>
+one street with the same name, or to specify a small place whose mail is<br>
+routed through a larger postal town. In China it could be a county or a<br>
+minor city.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Neighborhood">Neighborhood</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Neighborhood-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Neighborhood-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Neighborhood-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NickName">class <strong>NickName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Specifies the nickname of the person represented by the contact.<br>
+The element cannot be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#NickName">NickName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="NickName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NickName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NickName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NickName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NickName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="NickName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="NickName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NickName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NickName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NickName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Occupation">class <strong>Occupation</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Specifies the occupation/profession of the person specified by the contact.<br>
+The element cannot be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Occupation">Occupation</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Occupation-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Occupation-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Occupation-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Occupation-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Occupation-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Occupation-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Occupation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Occupation-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Occupation-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Occupation-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="POBox">class <strong>POBox</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Covers actual P.O. boxes, drawers, locked bags, etc. This is usually but not<br>
+always mutually exclusive with street<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#POBox">POBox</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="POBox-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="POBox-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="POBox-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="POBox-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="POBox-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="POBox-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="POBox-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="POBox-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="POBox-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="POBox-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PersonEntry">class <strong>PersonEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a google contact<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#PersonEntry">PersonEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>billing_information</strong> = <class 'gdata.contacts.data.BillingInformation'><dd><tt>gContact:billingInformation<br>
+Specifies billing information of the entity represented by the contact. The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>birthday</strong> = <class 'gdata.contacts.data.Birthday'><dd><tt>Stores birthday date of the person represented by the contact. The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>calendar_link</strong> = [<class 'gdata.contacts.data.CalendarLink'>]</dl>
+
+<dl><dt><strong>directory_server</strong> = <class 'gdata.contacts.data.DirectoryServer'><dd><tt>A directory server associated with this contact.<br>
+May not be repeated.</tt></dl>
+
+<dl><dt><strong>email</strong> = [<class 'gdata.data.Email'>]</dl>
+
+<dl><dt><strong>event</strong> = [<class 'gdata.contacts.data.Event'>]</dl>
+
+<dl><dt><strong>extended_property</strong> = [<class 'gdata.data.ExtendedProperty'>]</dl>
+
+<dl><dt><strong>external_id</strong> = [<class 'gdata.contacts.data.ExternalId'>]</dl>
+
+<dl><dt><strong>gender</strong> = <class 'gdata.contacts.data.Gender'><dd><tt>Specifies the gender of the person represented by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>hobby</strong> = [<class 'gdata.contacts.data.Hobby'>]</dl>
+
+<dl><dt><strong>im</strong> = [<class 'gdata.data.Im'>]</dl>
+
+<dl><dt><strong>initials</strong> = <class 'gdata.contacts.data.Initials'><dd><tt>Specifies the initials of the person represented by the contact. The<br>
+element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>jot</strong> = [<class 'gdata.contacts.data.Jot'>]</dl>
+
+<dl><dt><strong>language</strong> = [<class 'gdata.contacts.data.Language'>]</dl>
+
+<dl><dt><strong>link</strong> = [<class 'gdata.contacts.data.ContactLink'>]</dl>
+
+<dl><dt><strong>maiden_name</strong> = <class 'gdata.contacts.data.MaidenName'><dd><tt>Specifies maiden name of the person represented by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>mileage</strong> = <class 'gdata.contacts.data.Mileage'><dd><tt>Specifies the mileage for the entity represented by the contact.<br>
+Can be used for example to document distance needed for reimbursement<br>
+purposes. The value is not interpreted. The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>name</strong> = <class 'gdata.data.Name'><dd><tt>The gd:name element.<br>
+ <br>
+Allows storing person's name in a structured way. Consists of<br>
+given name, additional name, family name, prefix, suffix and full name.</tt></dl>
+
+<dl><dt><strong>nickname</strong> = <class 'gdata.contacts.data.NickName'><dd><tt>Specifies the nickname of the person represented by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>occupation</strong> = <class 'gdata.contacts.data.Occupation'><dd><tt>Specifies the occupation/profession of the person specified by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>organization</strong> = <class 'gdata.data.Organization'><dd><tt>The gd:organization element.<br>
+ <br>
+An organization, typically associated with a contact.</tt></dl>
+
+<dl><dt><strong>phone_number</strong> = [<class 'gdata.data.PhoneNumber'>]</dl>
+
+<dl><dt><strong>postal_address</strong> = [<class 'gdata.data.PostalAddress'>]</dl>
+
+<dl><dt><strong>priority</strong> = <class 'gdata.contacts.data.Priority'><dd><tt>Classifies importance of the contact into 3 categories:<br>
+ * Low<br>
+ * Normal<br>
+ * High<br>
+ <br>
+The priority element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>relation</strong> = [<class 'gdata.contacts.data.Relation'>]</dl>
+
+<dl><dt><strong>sensitivity</strong> = <class 'gdata.contacts.data.Sensitivity'><dd><tt>Classifies sensitivity of the contact into the following categories:<br>
+ * Confidential<br>
+ * Normal<br>
+ * Personal<br>
+ * Private<br>
+ <br>
+The sensitivity element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>status</strong> = <class 'gdata.contacts.data.Status'><dd><tt>Person's status element.</tt></dl>
+
+<dl><dt><strong>structured_postal_address</strong> = [<class 'gdata.data.StructuredPostalAddress'>]</dl>
+
+<dl><dt><strong>user_defined_field</strong> = [<class 'gdata.contacts.data.UserDefinedField'>]</dl>
+
+<dl><dt><strong>website</strong> = [<class 'gdata.contacts.data.Website'>]</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="PersonEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="PersonEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PersonEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="PersonEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="PersonEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PostalCode">class <strong>PostalCode</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Postal code. Usually country-wide, but sometimes specific to the<br>
+city (e.g. "2" in "Dublin 2, Ireland" addresses).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#PostalCode">PostalCode</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PostalCode-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PostalCode-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PostalCode-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PostalCode-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PostalCode-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PostalCode-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="PostalCode-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PostalCode-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PostalCode-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PostalCode-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Priority">class <strong>Priority</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Classifies importance of the contact into 3 categories:<br>
+ * Low<br>
+ * Normal<br>
+ * High<br>
+ <br>
+The priority element cannot be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Priority">Priority</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Priority-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Priority-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Priority-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Priority-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Priority-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Priority-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Priority-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Priority-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Priority-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Priority-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProfileEntry">class <strong>ProfileEntry</strong></a>(<a href="gdata.contacts.data.html#PersonEntry">PersonEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Profiles flavor of an Atom Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#ProfileEntry">ProfileEntry</a></dd>
+<dd><a href="gdata.contacts.data.html#PersonEntry">PersonEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.contacts.data.html#PersonEntry">PersonEntry</a>:<br>
+<dl><dt><strong>billing_information</strong> = <class 'gdata.contacts.data.BillingInformation'><dd><tt>gContact:billingInformation<br>
+Specifies billing information of the entity represented by the contact. The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>birthday</strong> = <class 'gdata.contacts.data.Birthday'><dd><tt>Stores birthday date of the person represented by the contact. The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>calendar_link</strong> = [<class 'gdata.contacts.data.CalendarLink'>]</dl>
+
+<dl><dt><strong>directory_server</strong> = <class 'gdata.contacts.data.DirectoryServer'><dd><tt>A directory server associated with this contact.<br>
+May not be repeated.</tt></dl>
+
+<dl><dt><strong>email</strong> = [<class 'gdata.data.Email'>]</dl>
+
+<dl><dt><strong>event</strong> = [<class 'gdata.contacts.data.Event'>]</dl>
+
+<dl><dt><strong>extended_property</strong> = [<class 'gdata.data.ExtendedProperty'>]</dl>
+
+<dl><dt><strong>external_id</strong> = [<class 'gdata.contacts.data.ExternalId'>]</dl>
+
+<dl><dt><strong>gender</strong> = <class 'gdata.contacts.data.Gender'><dd><tt>Specifies the gender of the person represented by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>hobby</strong> = [<class 'gdata.contacts.data.Hobby'>]</dl>
+
+<dl><dt><strong>im</strong> = [<class 'gdata.data.Im'>]</dl>
+
+<dl><dt><strong>initials</strong> = <class 'gdata.contacts.data.Initials'><dd><tt>Specifies the initials of the person represented by the contact. The<br>
+element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>jot</strong> = [<class 'gdata.contacts.data.Jot'>]</dl>
+
+<dl><dt><strong>language</strong> = [<class 'gdata.contacts.data.Language'>]</dl>
+
+<dl><dt><strong>link</strong> = [<class 'gdata.contacts.data.ContactLink'>]</dl>
+
+<dl><dt><strong>maiden_name</strong> = <class 'gdata.contacts.data.MaidenName'><dd><tt>Specifies maiden name of the person represented by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>mileage</strong> = <class 'gdata.contacts.data.Mileage'><dd><tt>Specifies the mileage for the entity represented by the contact.<br>
+Can be used for example to document distance needed for reimbursement<br>
+purposes. The value is not interpreted. The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>name</strong> = <class 'gdata.data.Name'><dd><tt>The gd:name element.<br>
+ <br>
+Allows storing person's name in a structured way. Consists of<br>
+given name, additional name, family name, prefix, suffix and full name.</tt></dl>
+
+<dl><dt><strong>nickname</strong> = <class 'gdata.contacts.data.NickName'><dd><tt>Specifies the nickname of the person represented by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>occupation</strong> = <class 'gdata.contacts.data.Occupation'><dd><tt>Specifies the occupation/profession of the person specified by the contact.<br>
+The element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>organization</strong> = <class 'gdata.data.Organization'><dd><tt>The gd:organization element.<br>
+ <br>
+An organization, typically associated with a contact.</tt></dl>
+
+<dl><dt><strong>phone_number</strong> = [<class 'gdata.data.PhoneNumber'>]</dl>
+
+<dl><dt><strong>postal_address</strong> = [<class 'gdata.data.PostalAddress'>]</dl>
+
+<dl><dt><strong>priority</strong> = <class 'gdata.contacts.data.Priority'><dd><tt>Classifies importance of the contact into 3 categories:<br>
+ * Low<br>
+ * Normal<br>
+ * High<br>
+ <br>
+The priority element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>relation</strong> = [<class 'gdata.contacts.data.Relation'>]</dl>
+
+<dl><dt><strong>sensitivity</strong> = <class 'gdata.contacts.data.Sensitivity'><dd><tt>Classifies sensitivity of the contact into the following categories:<br>
+ * Confidential<br>
+ * Normal<br>
+ * Personal<br>
+ * Private<br>
+ <br>
+The sensitivity element cannot be repeated.</tt></dl>
+
+<dl><dt><strong>status</strong> = <class 'gdata.contacts.data.Status'><dd><tt>Person's status element.</tt></dl>
+
+<dl><dt><strong>structured_postal_address</strong> = [<class 'gdata.data.StructuredPostalAddress'>]</dl>
+
+<dl><dt><strong>user_defined_field</strong> = [<class 'gdata.contacts.data.UserDefinedField'>]</dl>
+
+<dl><dt><strong>website</strong> = [<class 'gdata.contacts.data.Website'>]</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="ProfileEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ProfileEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ProfileEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProfilesFeed">class <strong>ProfilesFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Profiles feed flavor of an Atom Feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#ProfilesFeed">ProfilesFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.contacts.data.ProfileEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="ProfilesFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ProfilesFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ProfilesFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ProfilesFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ProfilesFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ProfilesFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Region">class <strong>Region</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A state, province, county (in Ireland), Land (in Germany),<br>
+departement (in France), etc.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Region">Region</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Region-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Region-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Region-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Region-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Region-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Region-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Region-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Region-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Region-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Region-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Relation">class <strong>Relation</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This element describe another entity (usually a person) that is in a<br>
+relation of some kind with the contact.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Relation">Relation</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Relation-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Relation-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Relation-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Relation-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Relation-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Relation-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Relation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Relation-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Relation-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Relation-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Sensitivity">class <strong>Sensitivity</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Classifies sensitivity of the contact into the following categories:<br>
+ * Confidential<br>
+ * Normal<br>
+ * Personal<br>
+ * Private<br>
+ <br>
+The sensitivity element cannot be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Sensitivity">Sensitivity</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Sensitivity-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Sensitivity-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Sensitivity-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Sensitivity-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Sensitivity-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Sensitivity-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Sensitivity-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Sensitivity-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Sensitivity-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Sensitivity-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Status">class <strong>Status</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Person's status element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Status">Status</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>indexed</strong> = 'indexed'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Status-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Status-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Status-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Status-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Status-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Status-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Street">class <strong>Street</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Can be street, avenue, road, etc. This element also includes the house<br>
+number and room/apartment/flat/floor number.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Street">Street</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Street-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Street-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Street-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Street-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Street-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Street-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Street-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Street-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Street-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Street-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SubRegion">class <strong>SubRegion</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Handles administrative districts such as U.S. or U.K. counties that are not<br>
+ used for mail addressing purposes. Subregion is not intended for<br>
+ delivery addresses.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#SubRegion">SubRegion</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SubRegion-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubRegion-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubRegion-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SubRegion-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubRegion-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SubRegion-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SubRegion-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubRegion-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SubRegion-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubRegion-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SystemGroup">class <strong>SystemGroup</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The contacts systemGroup element.<br>
+ <br>
+When used within a contact group entry, indicates that the group in<br>
+question is one of the predefined system groups.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#SystemGroup">SystemGroup</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>id</strong> = 'id'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SystemGroup-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SystemGroup-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SystemGroup-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SystemGroup-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SystemGroup-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SystemGroup-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SystemGroup-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SystemGroup-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SystemGroup-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SystemGroup-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserDefinedField">class <strong>UserDefinedField</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents an arbitrary key-value pair attached to the contact.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#UserDefinedField">UserDefinedField</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>key</strong> = 'key'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UserDefinedField-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserDefinedField-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserDefinedField-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserDefinedField-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserDefinedField-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UserDefinedField-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="UserDefinedField-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserDefinedField-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserDefinedField-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserDefinedField-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Website">class <strong>Website</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes websites associated with the contact, including links.<br>
+May be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.data.html#Website">Website</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>primary</strong> = 'primary'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Website-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Website-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Website-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Website-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Website-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Website-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Website-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Website-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Website-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Website-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-ExternalIdFromString"><strong>ExternalIdFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ProfileEntryFromString"><strong>ProfileEntryFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#ProfileEntry">ProfileEntry</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a Profile entry.<br>
+ <br>
+Returns:<br>
+ A <a href="#ProfileEntry">ProfileEntry</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-ProfilesFeedFromString"><strong>ProfilesFeedFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#ProfilesFeed">ProfilesFeed</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a Profiles feed.<br>
+ <br>
+Returns:<br>
+ A <a href="#ProfilesFeed">ProfilesFeed</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-UserDefinedFieldFromString"><strong>UserDefinedFieldFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-WebsiteFromString"><strong>WebsiteFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>CONTACTS_NAMESPACE</strong> = 'http://schemas.google.com/contact/2008'<br>
+<strong>CONTACTS_TEMPLATE</strong> = '{http://schemas.google.com/contact/2008}%s'<br>
+<strong>EXTERNAL_ID_ORGANIZATION</strong> = 'organization'<br>
+<strong>PHOTO_EDIT_LINK_REL</strong> = 'http://schemas.google.com/contacts/2008/rel#edit-photo'<br>
+<strong>PHOTO_LINK_REL</strong> = 'http://schemas.google.com/contacts/2008/rel#photo'<br>
+<strong>RELATION_MANAGER</strong> = 'manager'<br>
+<strong>__author__</strong> = 'vinces1979@gmail.com (Vince Spicer)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">vinces1979@gmail.com (Vince Spicer)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.contacts.html b/pydocs/gdata.contacts.html
new file mode 100644
index 0000000..83d0689
--- /dev/null
+++ b/pydocs/gdata.contacts.html
@@ -0,0 +1,2598 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.contacts</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.contacts</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contacts/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contacts/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains extensions to ElementWrapper objects used with Google Contacts.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.contacts.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.contacts.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.contacts.service.html">service</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.html#GDataBase">GDataBase</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.html#ContactsBase">ContactsBase</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.html#Birthday">Birthday</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#Event">Event</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#ExternalId">ExternalId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#Gender">Gender</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#GroupMembershipInfo">GroupMembershipInfo</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#Nickname">Nickname</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#Occupation">Occupation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#Relation">Relation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#UserDefinedField">UserDefinedField</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#Website">Website</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.html#Deleted">Deleted</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#Email">Email</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#FormattedAddress">FormattedAddress</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#IM">IM</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#OrgDepartment">OrgDepartment</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#OrgJobDescription">OrgJobDescription</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#OrgName">OrgName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#OrgTitle">OrgTitle</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#Organization">Organization</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#PhoneNumber">PhoneNumber</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#PostalAddress">PostalAddress</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#StructuredPostalAddress">StructuredPostalAddress</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#When">When</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#Where">Where</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchEntry">gdata.BatchEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.html#GroupEntry">GroupEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#PersonEntry">PersonEntry</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.html#ContactEntry">ContactEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#ProfileEntry">ProfileEntry</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchFeed">gdata.BatchFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.html#ContactsFeed">ContactsFeed</a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#GroupsFeed">GroupsFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#ProfilesFeed">ProfilesFeed</a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#LinkFinder">gdata.LinkFinder</a>(<a href="atom.html#LinkFinder">atom.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.html#ContactsFeed">ContactsFeed</a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.html#ProfilesFeed">ProfilesFeed</a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Birthday">class <strong>Birthday</strong></a>(<a href="gdata.contacts.html#ContactsBase">ContactsBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#Birthday">Birthday</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#Birthday">Birthday</a></dd>
+<dd><a href="gdata.contacts.html#ContactsBase">ContactsBase</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Birthday-__init__"><strong>__init__</strong></a>(self, when<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Birthday-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Birthday-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Birthday-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContactEntry">class <strong>ContactEntry</strong></a>(<a href="gdata.contacts.html#PersonEntry">PersonEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Contact flavor of an Atom Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#ContactEntry">ContactEntry</a></dd>
+<dd><a href="gdata.contacts.html#PersonEntry">PersonEntry</a></dd>
+<dd><a href="gdata.html#BatchEntry">gdata.BatchEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ContactEntry-GetPhotoEditLink"><strong>GetPhotoEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetPhotoLink"><strong>GetPhotoLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, organization<font color="#909090">=None</font>, phone_number<font color="#909090">=None</font>, nickname<font color="#909090">=None</font>, occupation<font color="#909090">=None</font>, gender<font color="#909090">=None</font>, birthday<font color="#909090">=None</font>, postal_address<font color="#909090">=None</font>, structured_postal_address<font color="#909090">=None</font>, email<font color="#909090">=None</font>, im<font color="#909090">=None</font>, relation<font color="#909090">=None</font>, user_defined_field<font color="#909090">=None</font>, website<font color="#909090">=None</font>, external_id<font color="#909090">=None</font>, event<font color="#909090">=None</font>, batch_operation<font color="#909090">=None</font>, batch_id<font color="#909090">=None</font>, batch_status<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, etag<font color="#909090">=None</font>, deleted<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, group_membership_info<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="ContactEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ContactEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ContactEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="ContactEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ContactEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="ContactEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContactsBase">class <strong>ContactsBase</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts intermediate class for Contacts namespace.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#ContactsBase">ContactsBase</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.contacts.html#GDataBase">GDataBase</a>:<br>
+<dl><dt><a name="ContactsBase-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ContactsBase-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ContactsBase-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ContactsBase-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContactsFeed">class <strong>ContactsFeed</strong></a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Contacts feed flavor of an Atom Feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#ContactsFeed">ContactsFeed</a></dd>
+<dd><a href="gdata.html#BatchFeed">gdata.BatchFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ContactsFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#BatchFeed">gdata.BatchFeed</a>:<br>
+<dl><dt><a name="ContactsFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+ <br>
+If the entry is not a <a href="gdata.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a>, atom.Entry, or another Entry flavor (optional) The<br>
+ entry which will be sent to the server as part of the batch request.<br>
+ The item must have a valid atom id so that the server knows which<br>
+ entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-AddDelete"><strong>AddDelete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-AddInsert"><strong>AddInsert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-AddQuery"><strong>AddQuery</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-AddUpdate"><strong>AddUpdate</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-GetBatchLink"><strong>GetBatchLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ContactsFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ContactsFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="ContactsFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ContactsFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="ContactsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Deleted">class <strong>Deleted</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#Deleted">Deleted</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#Deleted">Deleted</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.contacts.html#GDataBase">GDataBase</a>:<br>
+<dl><dt><a name="Deleted-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Deleted-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Deleted-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Email">class <strong>Email</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#Email">Email</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#Email">Email</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Email-__init__"><strong>__init__</strong></a>(self, label<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, address<font color="#909090">=None</font>, primary<font color="#909090">='false'</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Email-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Email-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Email-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Event">class <strong>Event</strong></a>(<a href="gdata.contacts.html#ContactsBase">ContactsBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#Event">Event</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#Event">Event</a></dd>
+<dd><a href="gdata.contacts.html#ContactsBase">ContactsBase</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Event-__init__"><strong>__init__</strong></a>(self, label<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, when<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Event-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Event-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Event-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExternalId">class <strong>ExternalId</strong></a>(<a href="gdata.contacts.html#ContactsBase">ContactsBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#ExternalId">ExternalId</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#ExternalId">ExternalId</a></dd>
+<dd><a href="gdata.contacts.html#ContactsBase">ContactsBase</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ExternalId-__init__"><strong>__init__</strong></a>(self, label<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, value<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ExternalId-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ExternalId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ExternalId-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FormattedAddress">class <strong>FormattedAddress</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#FormattedAddress">FormattedAddress</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#FormattedAddress">FormattedAddress</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.contacts.html#GDataBase">GDataBase</a>:<br>
+<dl><dt><a name="FormattedAddress-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="FormattedAddress-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="FormattedAddress-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="FormattedAddress-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GDataBase">class <strong>GDataBase</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts intermediate class from atom.<a href="atom.html#AtomBase">AtomBase</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GDataBase-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GDataBase-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GDataBase-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GDataBase-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Gender">class <strong>Gender</strong></a>(<a href="gdata.contacts.html#ContactsBase">ContactsBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#Gender">Gender</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#Gender">Gender</a></dd>
+<dd><a href="gdata.contacts.html#ContactsBase">ContactsBase</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Gender-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Gender-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Gender-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Gender-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupEntry">class <strong>GroupEntry</strong></a>(<a href="gdata.html#BatchEntry">gdata.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a contact group.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#GroupEntry">GroupEntry</a></dd>
+<dd><a href="gdata.html#BatchEntry">gdata.BatchEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GroupEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, source<font color="#909090">=None</font>, summary<font color="#909090">=None</font>, control<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, batch_operation<font color="#909090">=None</font>, batch_id<font color="#909090">=None</font>, batch_status<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="GroupEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GroupEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GroupEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="GroupEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="GroupEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupMembershipInfo">class <strong>GroupMembershipInfo</strong></a>(<a href="gdata.contacts.html#ContactsBase">ContactsBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#GroupMembershipInfo">GroupMembershipInfo</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#GroupMembershipInfo">GroupMembershipInfo</a></dd>
+<dd><a href="gdata.contacts.html#ContactsBase">ContactsBase</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GroupMembershipInfo-__init__"><strong>__init__</strong></a>(self, deleted<font color="#909090">=None</font>, href<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GroupMembershipInfo-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GroupMembershipInfo-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GroupMembershipInfo-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupsFeed">class <strong>GroupsFeed</strong></a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google contact groups feed flavor of an Atom Feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#GroupsFeed">GroupsFeed</a></dd>
+<dd><a href="gdata.html#BatchFeed">gdata.BatchFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#BatchFeed">gdata.BatchFeed</a>:<br>
+<dl><dt><a name="GroupsFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+ <br>
+If the entry is not a <a href="gdata.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a>, atom.Entry, or another Entry flavor (optional) The<br>
+ entry which will be sent to the server as part of the batch request.<br>
+ The item must have a valid atom id so that the server knows which<br>
+ entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-AddDelete"><strong>AddDelete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-AddInsert"><strong>AddInsert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-AddQuery"><strong>AddQuery</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-AddUpdate"><strong>AddUpdate</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-GetBatchLink"><strong>GetBatchLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, interrupted<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GroupsFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GroupsFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="GroupsFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GroupsFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="GroupsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="IM">class <strong>IM</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#IM">IM</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#IM">IM</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="IM-__init__"><strong>__init__</strong></a>(self, primary<font color="#909090">='false'</font>, rel<font color="#909090">=None</font>, address<font color="#909090">=None</font>, protocol<font color="#909090">=None</font>, label<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="IM-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="IM-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="IM-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Nickname">class <strong>Nickname</strong></a>(<a href="gdata.contacts.html#ContactsBase">ContactsBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#Nickname">Nickname</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#Nickname">Nickname</a></dd>
+<dd><a href="gdata.contacts.html#ContactsBase">ContactsBase</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.contacts.html#GDataBase">GDataBase</a>:<br>
+<dl><dt><a name="Nickname-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Nickname-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Nickname-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Nickname-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Occupation">class <strong>Occupation</strong></a>(<a href="gdata.contacts.html#ContactsBase">ContactsBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#Occupation">Occupation</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#Occupation">Occupation</a></dd>
+<dd><a href="gdata.contacts.html#ContactsBase">ContactsBase</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.contacts.html#GDataBase">GDataBase</a>:<br>
+<dl><dt><a name="Occupation-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Occupation-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Occupation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Occupation-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgDepartment">class <strong>OrgDepartment</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#OrgDepartment">OrgDepartment</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#OrgDepartment">OrgDepartment</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.contacts.html#GDataBase">GDataBase</a>:<br>
+<dl><dt><a name="OrgDepartment-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="OrgDepartment-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgDepartment-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="OrgDepartment-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgJobDescription">class <strong>OrgJobDescription</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#OrgJobDescription">OrgJobDescription</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#OrgJobDescription">OrgJobDescription</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.contacts.html#GDataBase">GDataBase</a>:<br>
+<dl><dt><a name="OrgJobDescription-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="OrgJobDescription-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgJobDescription-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="OrgJobDescription-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgName">class <strong>OrgName</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#OrgName">OrgName</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#OrgName">OrgName</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.contacts.html#GDataBase">GDataBase</a>:<br>
+<dl><dt><a name="OrgName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="OrgName-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="OrgName-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgTitle">class <strong>OrgTitle</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#OrgTitle">OrgTitle</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#OrgTitle">OrgTitle</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.contacts.html#GDataBase">GDataBase</a>:<br>
+<dl><dt><a name="OrgTitle-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="OrgTitle-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgTitle-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="OrgTitle-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Organization">class <strong>Organization</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#Organization">Organization</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#Organization">Organization</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Organization-__init__"><strong>__init__</strong></a>(self, label<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, primary<font color="#909090">='false'</font>, org_name<font color="#909090">=None</font>, org_title<font color="#909090">=None</font>, org_department<font color="#909090">=None</font>, org_job_description<font color="#909090">=None</font>, where<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Organization-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Organization-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Organization-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PersonEntry">class <strong>PersonEntry</strong></a>(<a href="gdata.html#BatchEntry">gdata.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Base class for <a href="#ContactEntry">ContactEntry</a> and <a href="#ProfileEntry">ProfileEntry</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#PersonEntry">PersonEntry</a></dd>
+<dd><a href="gdata.html#BatchEntry">gdata.BatchEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PersonEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, organization<font color="#909090">=None</font>, phone_number<font color="#909090">=None</font>, nickname<font color="#909090">=None</font>, occupation<font color="#909090">=None</font>, gender<font color="#909090">=None</font>, birthday<font color="#909090">=None</font>, postal_address<font color="#909090">=None</font>, structured_postal_address<font color="#909090">=None</font>, email<font color="#909090">=None</font>, im<font color="#909090">=None</font>, relation<font color="#909090">=None</font>, user_defined_field<font color="#909090">=None</font>, website<font color="#909090">=None</font>, external_id<font color="#909090">=None</font>, event<font color="#909090">=None</font>, batch_operation<font color="#909090">=None</font>, batch_id<font color="#909090">=None</font>, batch_status<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, etag<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="PersonEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PersonEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PersonEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="PersonEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PersonEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="PersonEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PersonEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PhoneNumber">class <strong>PhoneNumber</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#PhoneNumber">PhoneNumber</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#PhoneNumber">PhoneNumber</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PhoneNumber-__init__"><strong>__init__</strong></a>(self, label<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, primary<font color="#909090">='false'</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PhoneNumber-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PhoneNumber-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PhoneNumber-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PostalAddress">class <strong>PostalAddress</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#PostalAddress">PostalAddress</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#PostalAddress">PostalAddress</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PostalAddress-__init__"><strong>__init__</strong></a>(self, primary<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PostalAddress-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PostalAddress-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PostalAddress-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProfileEntry">class <strong>ProfileEntry</strong></a>(<a href="gdata.contacts.html#PersonEntry">PersonEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Profiles flavor of an Atom Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#ProfileEntry">ProfileEntry</a></dd>
+<dd><a href="gdata.contacts.html#PersonEntry">PersonEntry</a></dd>
+<dd><a href="gdata.html#BatchEntry">gdata.BatchEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.contacts.html#PersonEntry">PersonEntry</a>:<br>
+<dl><dt><a name="ProfileEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, organization<font color="#909090">=None</font>, phone_number<font color="#909090">=None</font>, nickname<font color="#909090">=None</font>, occupation<font color="#909090">=None</font>, gender<font color="#909090">=None</font>, birthday<font color="#909090">=None</font>, postal_address<font color="#909090">=None</font>, structured_postal_address<font color="#909090">=None</font>, email<font color="#909090">=None</font>, im<font color="#909090">=None</font>, relation<font color="#909090">=None</font>, user_defined_field<font color="#909090">=None</font>, website<font color="#909090">=None</font>, external_id<font color="#909090">=None</font>, event<font color="#909090">=None</font>, batch_operation<font color="#909090">=None</font>, batch_id<font color="#909090">=None</font>, batch_status<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, etag<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="ProfileEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ProfileEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ProfileEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProfilesFeed">class <strong>ProfilesFeed</strong></a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Profiles feed flavor of an Atom Feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#ProfilesFeed">ProfilesFeed</a></dd>
+<dd><a href="gdata.html#BatchFeed">gdata.BatchFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ProfilesFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#BatchFeed">gdata.BatchFeed</a>:<br>
+<dl><dt><a name="ProfilesFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+ <br>
+If the entry is not a <a href="gdata.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a>, atom.Entry, or another Entry flavor (optional) The<br>
+ entry which will be sent to the server as part of the batch request.<br>
+ The item must have a valid atom id so that the server knows which<br>
+ entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-AddDelete"><strong>AddDelete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-AddInsert"><strong>AddInsert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-AddQuery"><strong>AddQuery</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-AddUpdate"><strong>AddUpdate</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-GetBatchLink"><strong>GetBatchLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ProfilesFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ProfilesFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="ProfilesFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="ProfilesFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Relation">class <strong>Relation</strong></a>(<a href="gdata.contacts.html#ContactsBase">ContactsBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#Relation">Relation</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#Relation">Relation</a></dd>
+<dd><a href="gdata.contacts.html#ContactsBase">ContactsBase</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Relation-__init__"><strong>__init__</strong></a>(self, label<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Relation-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Relation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Relation-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="StructuredPostalAddress">class <strong>StructuredPostalAddress</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#StructuredPostalAddress">StructuredPostalAddress</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#StructuredPostalAddress">StructuredPostalAddress</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="StructuredPostalAddress-__init__"><strong>__init__</strong></a>(self, rel<font color="#909090">=None</font>, primary<font color="#909090">=None</font>, formatted_address<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="StructuredPostalAddress-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="StructuredPostalAddress-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="StructuredPostalAddress-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserDefinedField">class <strong>UserDefinedField</strong></a>(<a href="gdata.contacts.html#ContactsBase">ContactsBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#UserDefinedField">UserDefinedField</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#UserDefinedField">UserDefinedField</a></dd>
+<dd><a href="gdata.contacts.html#ContactsBase">ContactsBase</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="UserDefinedField-__init__"><strong>__init__</strong></a>(self, key<font color="#909090">=None</font>, value<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="UserDefinedField-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="UserDefinedField-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="UserDefinedField-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Website">class <strong>Website</strong></a>(<a href="gdata.contacts.html#ContactsBase">ContactsBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#Website">Website</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#Website">Website</a></dd>
+<dd><a href="gdata.contacts.html#ContactsBase">ContactsBase</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Website-__init__"><strong>__init__</strong></a>(self, href<font color="#909090">=None</font>, label<font color="#909090">=None</font>, primary<font color="#909090">='false'</font>, rel<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Website-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Website-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Website-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="When">class <strong>When</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#When">When</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#When">When</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="When-__init__"><strong>__init__</strong></a>(self, start_time<font color="#909090">=None</font>, end_time<font color="#909090">=None</font>, label<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="When-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="When-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="When-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Where">class <strong>Where</strong></a>(<a href="gdata.contacts.html#GDataBase">GDataBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Contacts <a href="#Where">Where</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.html#Where">Where</a></dd>
+<dd><a href="gdata.contacts.html#GDataBase">GDataBase</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Where-__init__"><strong>__init__</strong></a>(self, value_string<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, label<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Where-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Where-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Where-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-ContactEntryFromString"><strong>ContactEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ContactsFeedFromString"><strong>ContactsFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-EventFromString"><strong>EventFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ExternalIdFromString"><strong>ExternalIdFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-GroupEntryFromString"><strong>GroupEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-GroupsFeedFromString"><strong>GroupsFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ProfileEntryFromString"><strong>ProfileEntryFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#ProfileEntry">ProfileEntry</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a Profile entry.<br>
+ <br>
+Returns:<br>
+ A <a href="#ProfileEntry">ProfileEntry</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-ProfilesFeedFromString"><strong>ProfilesFeedFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#ProfilesFeed">ProfilesFeed</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a Profiles feed.<br>
+ <br>
+Returns:<br>
+ A <a href="#ProfilesFeed">ProfilesFeed</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-RelationFromString"><strong>RelationFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-UserDefinedFieldFromString"><strong>UserDefinedFieldFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-WebsiteFromString"><strong>WebsiteFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>CONTACTS_NAMESPACE</strong> = 'http://schemas.google.com/contact/2008'<br>
+<strong>EXTERNAL_ID_ORGANIZATION</strong> = 'organization'<br>
+<strong>IM_AIM</strong> = 'http://schemas.google.com/g/2005#AIM'<br>
+<strong>IM_GOOGLE_TALK</strong> = 'http://schemas.google.com/g/2005#GOOGLE_TALK'<br>
+<strong>IM_ICQ</strong> = 'http://schemas.google.com/g/2005#ICQ'<br>
+<strong>IM_JABBER</strong> = 'http://schemas.google.com/g/2005#JABBER'<br>
+<strong>IM_MSN</strong> = 'http://schemas.google.com/g/2005#MSN'<br>
+<strong>IM_NETMEETING</strong> = 'http://schemas.google.com/g/2005#netmeeting'<br>
+<strong>IM_QQ</strong> = 'http://schemas.google.com/g/2005#QQ'<br>
+<strong>IM_SKYPE</strong> = 'http://schemas.google.com/g/2005#SKYPE'<br>
+<strong>IM_YAHOO</strong> = 'http://schemas.google.com/g/2005#YAHOO'<br>
+<strong>PHONE_ASSISTANT</strong> = 'http://schemas.google.com/g/2005#assistant'<br>
+<strong>PHONE_CALLBACK</strong> = 'http://schemas.google.com/g/2005#callback'<br>
+<strong>PHONE_CAR</strong> = 'http://schemas.google.com/g/2005#car'<br>
+<strong>PHONE_COMPANY_MAIN</strong> = 'http://schemas.google.com/g/2005#company_main'<br>
+<strong>PHONE_FAX</strong> = 'http://schemas.google.com/g/2005#fax'<br>
+<strong>PHONE_GENERAL</strong> = 'http://schemas.google.com/g/2005#general'<br>
+<strong>PHONE_HOME</strong> = 'http://schemas.google.com/g/2005#home'<br>
+<strong>PHONE_HOME_FAX</strong> = 'http://schemas.google.com/g/2005#home_fax'<br>
+<strong>PHONE_INTERNAL</strong> = 'http://schemas.google.com/g/2005#internal-extension'<br>
+<strong>PHONE_ISDN</strong> = 'http://schemas.google.com/g/2005#isdn'<br>
+<strong>PHONE_MAIN</strong> = 'http://schemas.google.com/g/2005#main'<br>
+<strong>PHONE_MOBILE</strong> = 'http://schemas.google.com/g/2005#mobile'<br>
+<strong>PHONE_OTHER</strong> = 'http://schemas.google.com/g/2005#other'<br>
+<strong>PHONE_OTHER_FAX</strong> = 'http://schemas.google.com/g/2005#other_fax'<br>
+<strong>PHONE_PAGER</strong> = 'http://schemas.google.com/g/2005#pager'<br>
+<strong>PHONE_RADIO</strong> = 'http://schemas.google.com/g/2005#radio'<br>
+<strong>PHONE_SATELLITE</strong> = 'http://schemas.google.com/g/2005#satellite'<br>
+<strong>PHONE_TELEX</strong> = 'http://schemas.google.com/g/2005#telex'<br>
+<strong>PHONE_TTY_TDD</strong> = 'http://schemas.google.com/g/2005#tty_tdd'<br>
+<strong>PHONE_VOIP</strong> = 'http://schemas.google.com/g/2005#voip'<br>
+<strong>PHONE_WORK</strong> = 'http://schemas.google.com/g/2005#work'<br>
+<strong>PHONE_WORK_FAX</strong> = 'http://schemas.google.com/g/2005#work_fax'<br>
+<strong>PHONE_WORK_MOBILE</strong> = 'http://schemas.google.com/g/2005#work_mobile'<br>
+<strong>PHONE_WORK_PAGER</strong> = 'http://schemas.google.com/g/2005#work_pager'<br>
+<strong>PHOTO_EDIT_LINK_REL</strong> = 'http://schemas.google.com/contacts/2008/rel#edit-photo'<br>
+<strong>PHOTO_LINK_REL</strong> = 'http://schemas.google.com/contacts/2008/rel#photo'<br>
+<strong>RELATION_MANAGER</strong> = 'manager'<br>
+<strong>REL_HOME</strong> = 'http://schemas.google.com/g/2005#home'<br>
+<strong>REL_OTHER</strong> = 'http://schemas.google.com/g/2005#other'<br>
+<strong>REL_WORK</strong> = 'http://schemas.google.com/g/2005#work'<br>
+<strong>__author__</strong> = 'dbrattli (Dag Brattli)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">dbrattli (Dag Brattli)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.contacts.service.html b/pydocs/gdata.contacts.service.html
new file mode 100644
index 0000000..24eada2
--- /dev/null
+++ b/pydocs/gdata.contacts.service.html
@@ -0,0 +1,1411 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.contacts.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.contacts.html"><font color="#ffffff">contacts</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contacts/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contacts/service.py</a></font></td></tr></table>
+ <p><tt><a href="#ContactsService">ContactsService</a> extends the <a href="gdata.service.html#GDataService">GDataService</a> for Google Contacts operations.<br>
+ <br>
+<a href="#ContactsService">ContactsService</a>: Provides methods to query feeds and manipulate items.<br>
+ Extends <a href="gdata.service.html#GDataService">GDataService</a>.<br>
+ <br>
+DictionaryToParamList: Function which converts a dictionary into a list of<br>
+ URL arguments (represented as strings). This is a<br>
+ utility function used in CRUD operations.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.service.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.service.html#RequestError">RequestError</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.service.html#ContactsService">ContactsService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Query">gdata.service.Query</a>(<a href="__builtin__.html#dict">__builtin__.dict</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contacts.service.html#ContactsQuery">ContactsQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.service.html#GroupsQuery">GroupsQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contacts.service.html#ProfilesQuery">ProfilesQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContactsQuery">class <strong>ContactsQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.service.html#ContactsQuery">ContactsQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ContactsQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>, group<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>group</strong></dt>
+<dd><tt>The group query parameter to find only contacts in this group</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="ContactsQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="ContactsQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ContactsQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#ContactsQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#ContactsQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#ContactsQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#ContactsQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="ContactsQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#ContactsQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#ContactsQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContactsService">class <strong>ContactsService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Contacts service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.service.html#ContactsService">ContactsService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ContactsService-ChangePhoto"><strong>ChangePhoto</strong></a>(self, media, contact_entry_or_url, content_type<font color="#909090">=None</font>, content_length<font color="#909090">=None</font>)</dt><dd><tt>Change the photo for the contact by uploading a new photo.<br>
+ <br>
+Performs a PUT against the photo edit URL to send the binary data for the<br>
+photo.<br>
+ <br>
+Args:<br>
+ media: filename, file-like-object, or a gdata.MediaSource object to send.<br>
+ contact_entry_or_url: ContactEntry or str If it is a ContactEntry, this<br>
+ method will search for an edit photo link URL and<br>
+ perform a PUT to the URL.<br>
+ content_type: str (optional) the mime type for the photo data. This is<br>
+ necessary if media is a file or file name, but if media<br>
+ is a MediaSource object then the media object can contain<br>
+ the mime type. If media_type is set, it will override the<br>
+ mime type in the media object.<br>
+ content_length: int or str (optional) Specifying the content length is<br>
+ only required if media is a file-like object. If media<br>
+ is a filename, the length is determined using<br>
+ os.path.getsize. If media is a MediaSource object, it is<br>
+ assumed that it already contains the content length.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-CreateContact"><strong>CreateContact</strong></a>(self, new_contact, insert_uri<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Adds an new contact to Google Contacts.<br>
+ <br>
+Args:<br>
+ new_contact: atom.Entry or subclass A new contact which is to be added to<br>
+ Google Contacts.<br>
+ insert_uri: the URL to post new contacts to the feed<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful insert, an entry containing the contact created<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server,<br>
+ 'reason': HTTP reason from the server,<br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-CreateGroup"><strong>CreateGroup</strong></a>(self, new_group, insert_uri<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt></dl>
+
+<dl><dt><a name="ContactsService-DeleteContact"><strong>DeleteContact</strong></a>(self, edit_uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Removes an contact with the specified ID from Google Contacts.<br>
+ <br>
+Args:<br>
+ edit_uri: string The edit URL of the entry to be deleted. Example:<br>
+ '/m8/feeds/contacts/default/full/xxx/yyy'<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the deletion request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful delete, a httplib.HTTPResponse containing the server's<br>
+ response to the DELETE request.<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server,<br>
+ 'reason': HTTP reason from the server,<br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-DeleteGroup"><strong>DeleteGroup</strong></a>(self, edit_uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt></dl>
+
+<dl><dt><a name="ContactsService-DeletePhoto"><strong>DeletePhoto</strong></a>(self, contact_entry_or_url)</dt></dl>
+
+<dl><dt><a name="ContactsService-ExecuteBatch"><strong>ExecuteBatch</strong></a>(self, batch_feed, url, converter<font color="#909090">=<function ContactsFeedFromString></font>)</dt><dd><tt>Sends a batch request feed to the server.<br>
+ <br>
+Args:<br>
+ batch_feed: gdata.contacts.ContactFeed A feed containing batch<br>
+ request entries. Each entry contains the operation to be performed<br>
+ on the data contained in the entry. For example an entry with an<br>
+ operation type of insert will be used as if the individual entry<br>
+ had been inserted.<br>
+ url: str The batch URL to which these operations should be applied.<br>
+ converter: Function (optional) The function used to convert the server's<br>
+ response to an object. The default value is ContactsFeedFromString.<br>
+ <br>
+Returns:<br>
+ The results of the batch request's execution on the server. If the<br>
+ default converter is used, this is stored in a ContactsFeed.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-ExecuteBatchProfiles"><strong>ExecuteBatchProfiles</strong></a>(self, batch_feed, url, converter<font color="#909090">=<function ProfilesFeedFromString></font>)</dt><dd><tt>Sends a batch request feed to the server.<br>
+ <br>
+Args:<br>
+ batch_feed: gdata.profiles.ProfilesFeed A feed containing batch<br>
+ request entries. Each entry contains the operation to be performed<br>
+ on the data contained in the entry. For example an entry with an<br>
+ operation type of insert will be used as if the individual entry<br>
+ had been inserted.<br>
+ url: string The batch URL to which these operations should be applied.<br>
+ converter: Function (optional) The function used to convert the server's<br>
+ response to an object. The default value is<br>
+ gdata.profiles.ProfilesFeedFromString.<br>
+ <br>
+Returns:<br>
+ The results of the batch request's execution on the server. If the<br>
+ default converter is used, this is stored in a ProfilesFeed.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetContact"><strong>GetContact</strong></a>(self, uri)</dt></dl>
+
+<dl><dt><a name="ContactsService-GetContactsFeed"><strong>GetContactsFeed</strong></a>(self, uri<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContactsService-GetFeedUri"><strong>GetFeedUri</strong></a>(self, kind<font color="#909090">='contacts'</font>, contact_list<font color="#909090">=None</font>, projection<font color="#909090">='full'</font>, scheme<font color="#909090">=None</font>)</dt><dd><tt>Builds a feed URI.<br>
+ <br>
+Args:<br>
+ kind: The type of feed to return, typically 'groups' or 'contacts'.<br>
+ Default value: 'contacts'.<br>
+ contact_list: The contact list to return a feed for.<br>
+ Default value: self.<strong>contact_list</strong>.<br>
+ projection: The projection to apply to the feed contents, for example<br>
+ 'full', 'base', 'base/12345', 'full/batch'. Default value: 'full'.<br>
+ scheme: The URL scheme such as 'http' or 'https', None to return a<br>
+ relative URI without hostname.<br>
+ <br>
+Returns:<br>
+ A feed URI using the given kind, contact list, and projection.<br>
+ Example: '/m8/feeds/contacts/default/full'.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetGroupsFeed"><strong>GetGroupsFeed</strong></a>(self, uri<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContactsService-GetPhoto"><strong>GetPhoto</strong></a>(self, contact_entry_or_url)</dt><dd><tt>Retrives the binary data for the contact's profile photo as a string.<br>
+ <br>
+Args:<br>
+ contact_entry_or_url: a gdata.contacts.ContactEntry objecr or a string<br>
+ containing the photo link's URL. If the contact entry does not <br>
+ contain a photo link, the image will not be fetched and this method<br>
+ will return None.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetProfile"><strong>GetProfile</strong></a>(self, uri)</dt><dd><tt>Retrieves a domain's profile for the user.<br>
+ <br>
+Args:<br>
+ uri: string the URL to retrieve the profiles feed,<br>
+ for example /m8/feeds/profiles/default/full/username<br>
+ <br>
+Returns:<br>
+ On success, a ProfileEntry containing the profile for the user.<br>
+ On failure, raises a <a href="#RequestError">RequestError</a></tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetProfilesFeed"><strong>GetProfilesFeed</strong></a>(self, uri<font color="#909090">=None</font>)</dt><dd><tt>Retrieves a feed containing all domain's profiles.<br>
+ <br>
+Args:<br>
+ uri: string (optional) the URL to retrieve the profiles feed,<br>
+ for example /m8/feeds/profiles/default/full<br>
+ <br>
+Returns:<br>
+ On success, a ProfilesFeed containing the profiles.<br>
+ On failure, raises a <a href="#RequestError">RequestError</a>.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-UpdateContact"><strong>UpdateContact</strong></a>(self, edit_uri, updated_contact, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Updates an existing contact.<br>
+ <br>
+Args:<br>
+ edit_uri: string The edit link URI for the element being updated<br>
+ updated_contact: string, atom.Entry or subclass containing<br>
+ the Atom Entry which will replace the contact which is<br>
+ stored at the edit_url<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the update request.<br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful update, a httplib.HTTPResponse containing the server's<br>
+ response to the PUT request.<br>
+ On failure, a <a href="#RequestError">RequestError</a> is raised of the form:<br>
+ {'status': HTTP status code from server,<br>
+ 'reason': HTTP reason from the server,<br>
+ 'body': HTTP body of the server's response}</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-UpdateGroup"><strong>UpdateGroup</strong></a>(self, edit_uri, updated_group, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt></dl>
+
+<dl><dt><a name="ContactsService-UpdateProfile"><strong>UpdateProfile</strong></a>(self, edit_uri, updated_profile, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Updates an existing profile.<br>
+ <br>
+Args:<br>
+ edit_uri: string The edit link URI for the element being updated<br>
+ updated_profile: string atom.Entry or subclass containing<br>
+ the Atom Entry which will replace the profile which is<br>
+ stored at the edit_url.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the update request.<br>
+ escape_params: boolean (optional) If true, the url_params will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ On successful update, a httplib.HTTPResponse containing the server's<br>
+ response to the PUT request.<br>
+ On failure, raises a <a href="#RequestError">RequestError</a>.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='www.google.com'</font>, additional_headers<font color="#909090">=None</font>, contact_list<font color="#909090">='default'</font>, **kwargs)</dt><dd><tt>Creates a client for the Contacts service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'www.google.com'.<br>
+ contact_list: string (optional) The name of the default contact list to<br>
+ use when no URI is specified to the methods of the service.<br>
+ Default value: 'default' (the logged in user's contact list).<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="ContactsService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContactsService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#ContactsService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ <a href="#Error">Error</a> if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#ContactsService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#ContactsService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="ContactsService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="ContactsService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GroupsQuery">class <strong>GroupsQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.service.html#GroupsQuery">GroupsQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GroupsQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="GroupsQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GroupsQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="GroupsQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#GroupsQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#GroupsQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#GroupsQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#GroupsQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#GroupsQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="GroupsQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#GroupsQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#GroupsQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProfilesQuery">class <strong>ProfilesQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Constructs a query object for the profiles feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.service.html#ProfilesQuery">ProfilesQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ProfilesQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="ProfilesQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfilesQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="ProfilesQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ProfilesQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#ProfilesQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#ProfilesQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#ProfilesQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#ProfilesQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="ProfilesQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#ProfilesQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#ProfilesQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RequestError">class <strong>RequestError</strong></a>(<a href="gdata.contacts.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contacts.service.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.contacts.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.contacts.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="RequestError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RequestError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="RequestError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DEFAULT_BATCH_URL</strong> = 'http://www.google.com/m8/feeds/contacts/default/full/batch'<br>
+<strong>DEFAULT_PROFILES_BATCH_URL</strong> = 'http://www.google.com/m8/feeds/profiles/default/full/batch'<br>
+<strong>GDATA_VER_HEADER</strong> = 'GData-Version'<br>
+<strong>__author__</strong> = 'dbrattli (Dag Brattli)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">dbrattli (Dag Brattli)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.contentforshopping.client.html b/pydocs/gdata.contentforshopping.client.html
new file mode 100644
index 0000000..edc6e45
--- /dev/null
+++ b/pydocs/gdata.contentforshopping.client.html
@@ -0,0 +1,963 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.contentforshopping.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.contentforshopping.html"><font color="#ffffff">contentforshopping</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contentforshopping/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contentforshopping/client.py</a></font></td></tr></table>
+ <p><tt>Extend the gdata client for the Content API for Shopping.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contentforshopping.client.html#ContentForShoppingClient">ContentForShoppingClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContentForShoppingClient">class <strong>ContentForShoppingClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for Content for Shopping API.<br>
+ <br>
+:param account_id: Merchant account ID. This value will be used by default<br>
+ for all requests, but may be overridden on a<br>
+ request-by-request basis.<br>
+:param api_version: The version of the API to target. Default value: 'v1'.<br>
+:param **kwargs: Pass all addtional keywords to the <a href="gdata.client.html#GDClient">GDClient</a> constructor.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.client.html#ContentForShoppingClient">ContentForShoppingClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ContentForShoppingClient-AddLocalId"><strong>AddLocalId</strong></a> = <a href="#ContentForShoppingClient-add_local_id">add_local_id</a>(self, product, id, country, language, store_code, account_id<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-Batch"><strong>Batch</strong></a> = <a href="#ContentForShoppingClient-batch">batch</a>(self, feed, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-DeleteClientAccount"><strong>DeleteClientAccount</strong></a> = <a href="#ContentForShoppingClient-delete_client_account">delete_client_account</a>(self, client_account_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-DeleteDatafeed"><strong>DeleteDatafeed</strong></a> = <a href="#ContentForShoppingClient-delete_datafeed">delete_datafeed</a>(self, feed_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-DeleteProduct"><strong>DeleteProduct</strong></a> = <a href="#ContentForShoppingClient-delete_product">delete_product</a>(self, product, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-DeleteProducts"><strong>DeleteProducts</strong></a> = <a href="#ContentForShoppingClient-delete_products">delete_products</a>(self, products, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-DeleteUsersEntry"><strong>DeleteUsersEntry</strong></a> = <a href="#ContentForShoppingClient-delete_users_entry">delete_users_entry</a>(self, entry, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetClientAccount"><strong>GetClientAccount</strong></a> = <a href="#ContentForShoppingClient-get_client_account">get_client_account</a>(self, client_account_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetClientAccounts"><strong>GetClientAccounts</strong></a> = <a href="#ContentForShoppingClient-get_client_accounts">get_client_accounts</a>(self, max_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetDataQualityEntry"><strong>GetDataQualityEntry</strong></a> = <a href="#ContentForShoppingClient-get_data_quality_entry">get_data_quality_entry</a>(self, secondary_account_id<font color="#909090">=None</font>, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetDataQualityFeed"><strong>GetDataQualityFeed</strong></a> = <a href="#ContentForShoppingClient-get_data_quality_feed">get_data_quality_feed</a>(self, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, max_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetDatafeed"><strong>GetDatafeed</strong></a> = <a href="#ContentForShoppingClient-get_datafeed">get_datafeed</a>(self, feed_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetDatafeeds"><strong>GetDatafeeds</strong></a> = <a href="#ContentForShoppingClient-get_datafeeds">get_datafeeds</a>(self, account_id<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetProduct"><strong>GetProduct</strong></a> = <a href="#ContentForShoppingClient-get_product">get_product</a>(self, id, country, language, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetProducts"><strong>GetProducts</strong></a> = <a href="#ContentForShoppingClient-get_products">get_products</a>(self, max_results<font color="#909090">=None</font>, start_token<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, performance_start<font color="#909090">=None</font>, performance_end<font color="#909090">=None</font>, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetUsersEntry"><strong>GetUsersEntry</strong></a> = <a href="#ContentForShoppingClient-get_users_entry">get_users_entry</a>(self, user_email, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetUsersFeed"><strong>GetUsersFeed</strong></a> = <a href="#ContentForShoppingClient-get_users_feed">get_users_feed</a>(self, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-InsertClientAccount"><strong>InsertClientAccount</strong></a> = <a href="#ContentForShoppingClient-insert_client_account">insert_client_account</a>(self, entry, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-InsertDatafeed"><strong>InsertDatafeed</strong></a> = <a href="#ContentForShoppingClient-insert_datafeed">insert_datafeed</a>(self, entry, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-InsertProduct"><strong>InsertProduct</strong></a> = <a href="#ContentForShoppingClient-insert_product">insert_product</a>(self, product, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-InsertProducts"><strong>InsertProducts</strong></a> = <a href="#ContentForShoppingClient-insert_products">insert_products</a>(self, products, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-InsertUsersEntry"><strong>InsertUsersEntry</strong></a> = <a href="#ContentForShoppingClient-insert_users_entry">insert_users_entry</a>(self, entry, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-UpdateClientAccount"><strong>UpdateClientAccount</strong></a> = <a href="#ContentForShoppingClient-update_client_account">update_client_account</a>(self, entry, client_account_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-UpdateDatafeed"><strong>UpdateDatafeed</strong></a> = <a href="#ContentForShoppingClient-update_datafeed">update_datafeed</a>(self, entry, feed_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-UpdateInventoryEntry"><strong>UpdateInventoryEntry</strong></a> = <a href="#ContentForShoppingClient-update_inventory_entry">update_inventory_entry</a>(self, product, id, country, language, store_code, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-UpdateInventoryFeed"><strong>UpdateInventoryFeed</strong></a> = <a href="#ContentForShoppingClient-update_inventory_feed">update_inventory_feed</a>(self, products, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-UpdateProduct"><strong>UpdateProduct</strong></a> = <a href="#ContentForShoppingClient-update_product">update_product</a>(self, product, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-UpdateProducts"><strong>UpdateProducts</strong></a> = <a href="#ContentForShoppingClient-update_products">update_products</a>(self, products, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-UpdateUsersEntry"><strong>UpdateUsersEntry</strong></a> = <a href="#ContentForShoppingClient-update_users_entry">update_users_entry</a>(self, entry, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-__init__"><strong>__init__</strong></a>(self, account_id<font color="#909090">=None</font>, api_version<font color="#909090">='v1'</font>, cfs_uri<font color="#909090">='https://content.googleapis.com/content'</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-add_local_id"><strong>add_local_id</strong></a>(self, product, id, country, language, store_code, account_id<font color="#909090">=None</font>)</dt><dd><tt>Add an atom id to a local product with a local store specific URI.<br>
+ <br>
+:param product: A :class:`gdata.contentforshopping.data.InventoryEntry`<br>
+ with the required product data.<br>
+:param id: The product ID<br>
+:param country: The country (target_country)<br>
+:param language: The language (content_language)<br>
+:param store_code: The code for the store where this local product will<br>
+ be updated.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-batch"><strong>batch</strong></a>(self, feed, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Send a batch request.<br>
+ <br>
+:param feed: The feed of batch entries to send.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False by default.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-delete_client_account"><strong>delete_client_account</strong></a>(self, client_account_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Delete a client account<br>
+ <br>
+:param client_account_id: The client account ID<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False by default.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-delete_datafeed"><strong>delete_datafeed</strong></a>(self, feed_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Delete a single datafeed.<br>
+ <br>
+:param feed_id: The ID of the desired datafeed.<br>
+:param account_id: The Sub-Account ID. If ommitted the default<br>
+ Account ID will be used for this client.<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-delete_product"><strong>delete_product</strong></a>(self, product, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Delete a product<br>
+ <br>
+:param product: A :class:`gdata.contentforshopping.data.ProductEntry` with<br>
+ the required product data.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False by default.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-delete_products"><strong>delete_products</strong></a>(self, products, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Delete the products using a batch request.<br>
+ <br>
+:param products: A list of product entries<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False by default.<br>
+ <br>
+.. note:: Entries must have the atom:id element set.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-delete_users_entry"><strong>delete_users_entry</strong></a>(self, entry, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Delete a users feed entry for an account.<br>
+ <br>
+:param entry: A :class:`gdata.contentforshopping.data.UsersEntry` with<br>
+ the required user data.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_client_account"><strong>get_client_account</strong></a>(self, client_account_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Get a managed account.<br>
+ <br>
+:param client_account_id: The Account ID of the subaccount being retrieved.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_client_accounts"><strong>get_client_accounts</strong></a>(self, max_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Get the feed of managed accounts<br>
+ <br>
+:param max_results: The maximum number of results to return (default 25,<br>
+ maximum 250).<br>
+:param start_index: The starting index of the feed to return (default 1,<br>
+ maximum 10000)<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_data_quality_entry"><strong>get_data_quality_entry</strong></a>(self, secondary_account_id<font color="#909090">=None</font>, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Get the data quality feed entry for an account.<br>
+ <br>
+:param secondary_account_id: The Account ID of the secondary account. If<br>
+ ommitted the value of account_id is used.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_data_quality_feed"><strong>get_data_quality_feed</strong></a>(self, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, max_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>)</dt><dd><tt>Get the data quality feed for an account.<br>
+ <br>
+:param max_results: The maximum number of results to return (default 25,<br>
+ max 100).<br>
+:param start_index: The starting index of the feed to return.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_datafeed"><strong>get_datafeed</strong></a>(self, feed_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Get the feed of a single datafeed.<br>
+ <br>
+:param feed_id: The ID of the desired datafeed.<br>
+:param account_id: The Sub-Account ID. If ommitted the default<br>
+ Account ID will be used for this client.<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_datafeeds"><strong>get_datafeeds</strong></a>(self, account_id<font color="#909090">=None</font>)</dt><dd><tt>Get the feed of datafeeds.<br>
+ <br>
+:param account_id: The Sub-Account ID. If ommitted the default<br>
+ Account ID will be used for this client.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_product"><strong>get_product</strong></a>(self, id, country, language, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Get a product by id, country and language.<br>
+ <br>
+:param id: The product ID<br>
+:param country: The country (target_country)<br>
+:param language: The language (content_language)<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_products"><strong>get_products</strong></a>(self, max_results<font color="#909090">=None</font>, start_token<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, performance_start<font color="#909090">=None</font>, performance_end<font color="#909090">=None</font>, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Get a feed of products for the account.<br>
+ <br>
+:param max_results: The maximum number of results to return (default 25,<br>
+ maximum 250).<br>
+:param start_token: The start token of the feed provided by the API.<br>
+:param start_index: The starting index of the feed to return (default 1,<br>
+ maximum 10000)<br>
+:param performance_start: The start date (inclusive) of click data returned.<br>
+ Should be represented as YYYY-MM-DD; not appended<br>
+ if left as None.<br>
+:param performance_end: The end date (inclusive) of click data returned.<br>
+ Should be represented as YYYY-MM-DD; not appended<br>
+ if left as None.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_users_entry"><strong>get_users_entry</strong></a>(self, user_email, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Get a users feed entry for an account.<br>
+ <br>
+:param user_email: Email of the user entry to be retrieved.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_users_feed"><strong>get_users_feed</strong></a>(self, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Get the users feed for an account.<br>
+ <br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-insert_client_account"><strong>insert_client_account</strong></a>(self, entry, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Insert a client account entry<br>
+ <br>
+:param entry: An entry of type ClientAccount<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False by default.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-insert_datafeed"><strong>insert_datafeed</strong></a>(self, entry, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Insert a datafeed.<br>
+ <br>
+:param entry: XML Content of post request required for registering a<br>
+ datafeed.<br>
+:param account_id: The Sub-Account ID. If ommitted the default<br>
+ Account ID will be used for this client.<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False by default.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-insert_product"><strong>insert_product</strong></a>(self, product, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Create a new product, by posting the product entry feed.<br>
+ <br>
+:param product: A :class:`gdata.contentforshopping.data.ProductEntry` with<br>
+ the required product data.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False by default.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-insert_products"><strong>insert_products</strong></a>(self, products, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Insert the products using a batch request<br>
+ <br>
+:param products: A list of product entries<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False by default.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-insert_users_entry"><strong>insert_users_entry</strong></a>(self, entry, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Insert a users feed entry for an account.<br>
+ <br>
+:param entry: A :class:`gdata.contentforshopping.data.UsersEntry` with<br>
+ the required user data.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-update_client_account"><strong>update_client_account</strong></a>(self, entry, client_account_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Update a client account<br>
+ <br>
+:param entry: An entry of type ClientAccount to update to<br>
+:param client_account_id: The client account ID<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False by default.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-update_datafeed"><strong>update_datafeed</strong></a>(self, entry, feed_id, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Update the feed of a single datafeed.<br>
+ <br>
+:param entry: XML Content of put request required for updating a<br>
+ datafeed.<br>
+:param feed_id: The ID of the desired datafeed.<br>
+:param account_id: The Sub-Account ID. If ommitted the default<br>
+ Account ID will be used for this client.<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False by default.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-update_inventory_entry"><strong>update_inventory_entry</strong></a>(self, product, id, country, language, store_code, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Make a local product update, by putting the inventory entry.<br>
+ <br>
+:param product: A :class:`gdata.contentforshopping.data.InventoryEntry`<br>
+ with the required product data.<br>
+:param id: The product ID<br>
+:param country: The country (target_country)<br>
+:param language: The language (content_language)<br>
+:param store_code: The code for the store where this local product will<br>
+ be updated.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-update_inventory_feed"><strong>update_inventory_feed</strong></a>(self, products, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Update a batch of local products, by putting the product entry feed.<br>
+ <br>
+:param products: A list containing entries of<br>
+ :class:`gdata.contentforshopping.data.InventoryEntry`<br>
+ with the required product data<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+ <br>
+.. note:: Entries must have the atom:id element set. You can use<br>
+ add_local_id to set this attribute using the store_code, product<br>
+ id, country and language.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-update_product"><strong>update_product</strong></a>(self, product, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Update a product, by putting the product entry feed.<br>
+ <br>
+:param product: A :class:`gdata.contentforshopping.data.ProductEntry` with<br>
+ the required product data.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False<br>
+ by default.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-update_products"><strong>update_products</strong></a>(self, products, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, dry_run<font color="#909090">=False</font>, warnings<font color="#909090">=False</font>)</dt><dd><tt>Update the products using a batch request<br>
+ <br>
+:param products: A list of product entries<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.<br>
+:param dry_run: Flag to run all requests that modify persistent data in<br>
+ dry-run mode. False by default.<br>
+:param warnings: Flag to include warnings in response. False by default.<br>
+ <br>
+.. note:: Entries must have the atom:id element set.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-update_users_entry"><strong>update_users_entry</strong></a>(self, entry, account_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>)</dt><dd><tt>Update a users feed entry for an account.<br>
+ <br>
+:param entry: A :class:`gdata.contentforshopping.data.UsersEntry` with<br>
+ the required user data.<br>
+:param account_id: The Merchant Center Account ID. If ommitted the default<br>
+ Account ID will be used for this client<br>
+:param auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '1.0'</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="ContentForShoppingClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<dl><dt><strong>auth_scopes</strong> = None</dl>
+
+<dl><dt><strong>auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="ContentForShoppingClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>CFS_HOST</strong> = 'content.googleapis.com'<br>
+<strong>CFS_PROJECTION</strong> = 'schema'<br>
+<strong>CFS_URI</strong> = 'https://content.googleapis.com/content'<br>
+<strong>CFS_VERSION</strong> = 'v1'<br>
+<strong>__author__</strong> = 'afshar (Ali Afshar), dhermes (Daniel Hermes)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">afshar (Ali Afshar), dhermes (Daniel Hermes)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.contentforshopping.data.html b/pydocs/gdata.contentforshopping.data.html
new file mode 100644
index 0000000..6304d97
--- /dev/null
+++ b/pydocs/gdata.contentforshopping.data.html
@@ -0,0 +1,19716 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.contentforshopping.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.contentforshopping.html"><font color="#ffffff">contentforshopping</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contentforshopping/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contentforshopping/data.py</a></font></td></tr></table>
+ <p><tt>GData definitions for Content API for Shopping</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#AdditionalImageLink">AdditionalImageLink</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Admin">Admin</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Adult">Adult</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#AdultContent">AdultContent</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#AdwordsAccount">AdwordsAccount</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#AdwordsAccounts">AdwordsAccounts</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Attribute">Attribute</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#AttributeLanguage">AttributeLanguage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Author">Author</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Availability">Availability</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Brand">Brand</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Channel">Channel</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Code">Code</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Color">Color</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Condition">Condition</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ContentForShoppingError">ContentForShoppingError</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ContentForShoppingErrors">ContentForShoppingErrors</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ContentLanguage">ContentLanguage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Datapoint">Datapoint</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Domain">Domain</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Edited">Edited</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Edition">Edition</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#EnergyEfficiencyClass">EnergyEfficiencyClass</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ErrorCode">ErrorCode</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ErrorDomain">ErrorDomain</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ErrorLocation">ErrorLocation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ExampleItem">ExampleItem</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ExampleItemLink">ExampleItemLink</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ExampleItemTitle">ExampleItemTitle</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ExcludedDestination">ExcludedDestination</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ExpirationDate">ExpirationDate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Feature">Feature</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#FeaturedProduct">FeaturedProduct</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#FeedFileName">FeedFileName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#FeedType">FeedType</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#FileFormat">FileFormat</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Gender">Gender</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Genre">Genre</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#GoogleProductCategory">GoogleProductCategory</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Group">Group</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Gtin">Gtin</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#IdentifierExists">IdentifierExists</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ImageLink">ImageLink</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#InternalId">InternalId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#InternalReason">InternalReason</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Issue">Issue</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#IssueGroup">IssueGroup</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#IssueGroups">IssueGroups</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ItemGroupID">ItemGroupID</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ItemId">ItemId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Location">Location</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Manufacturer">Manufacturer</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Material">Material</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Message">Message</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Mpn">Mpn</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Multipack">Multipack</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Pattern">Pattern</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Performance">Performance</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Permission">Permission</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Price">Price</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ProcessingStatus">ProcessingStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ProductId">ProductId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ProductType">ProductType</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Quantity">Quantity</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#RequiredDestination">RequiredDestination</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ReviewsUrl">ReviewsUrl</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#SalePrice">SalePrice</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#SalePriceEffectiveDate">SalePriceEffectiveDate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Shipping">Shipping</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ShippingCountry">ShippingCountry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ShippingPrice">ShippingPrice</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ShippingRegion">ShippingRegion</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ShippingService">ShippingService</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ShippingWeight">ShippingWeight</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Size">Size</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Status">Status</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#SubmittedValue">SubmittedValue</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#TargetCountry">TargetCountry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Tax">Tax</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#TaxCountry">TaxCountry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#TaxRate">TaxRate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#TaxRegion">TaxRegion</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#TaxShip">TaxShip</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#UnitPricingBaseMeasure">UnitPricingBaseMeasure</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#UnitPricingMeasure">UnitPricingMeasure</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#UseQuotedFields">UseQuotedFields</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ValidateDestination">ValidateDestination</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ValueOnLandingPage">ValueOnLandingPage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#WarningElement">WarningElement</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Warnings">Warnings</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#Year">Year</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Control">atom.data.Control</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ProductControl">ProductControl</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#InventoryEntry">InventoryEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ProductEntry">ProductEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#InventoryFeed">InventoryFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ProductFeed">ProductFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ClientAccount">ClientAccount</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#DataQualityEntry">DataQualityEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#DatafeedEntry">DatafeedEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#UsersEntry">UsersEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ClientAccountFeed">ClientAccountFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#DataQualityFeed">DataQualityFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#DatafeedFeed">DatafeedFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#UsersFeed">UsersFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#ItemsPerPage">gdata.data.ItemsPerPage</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#ItemsPerPage">ItemsPerPage</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#StartIndex">gdata.data.StartIndex</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#StartIndex">StartIndex</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#TotalResults">gdata.data.TotalResults</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.contentforshopping.data.html#TotalResults">TotalResults</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AdditionalImageLink">class <strong>AdditionalImageLink</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:additional_image_link element<br>
+ <br>
+The URLs of any additional images for the product. This tag may be repeated.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#AdditionalImageLink">AdditionalImageLink</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AdditionalImageLink-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalImageLink-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalImageLink-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalImageLink-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalImageLink-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalImageLink-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AdditionalImageLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AdditionalImageLink-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalImageLink-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalImageLink-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Admin">class <strong>Admin</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:admin element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Admin">Admin</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Admin-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Admin-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Admin-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Admin-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Admin-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Admin-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Admin-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Admin-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Admin-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Admin-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Adult">class <strong>Adult</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:adult element<br>
+ <br>
+Indicates whether the content is targeted towards adults, with possible<br>
+values of "true" or "false". Defaults to "false".<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Adult">Adult</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Adult-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Adult-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Adult-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Adult-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Adult-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Adult-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Adult-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Adult-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Adult-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Adult-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AdultContent">class <strong>AdultContent</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:adult_content element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#AdultContent">AdultContent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AdultContent-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdultContent-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdultContent-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdultContent-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdultContent-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AdultContent-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AdultContent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AdultContent-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdultContent-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdultContent-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AdwordsAccount">class <strong>AdwordsAccount</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:adwords_account element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#AdwordsAccount">AdwordsAccount</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>status</strong> = 'status'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AdwordsAccount-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccount-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccount-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccount-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccount-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccount-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AdwordsAccount-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AdwordsAccount-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccount-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccount-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AdwordsAccounts">class <strong>AdwordsAccounts</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:adwords_accounts element<br>
+ <br>
+Container element for adwords accounts settings.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#AdwordsAccounts">AdwordsAccounts</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>adwords_account</strong> = [<class 'gdata.contentforshopping.data.AdwordsAccount'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AdwordsAccounts-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccounts-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccounts-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccounts-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccounts-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccounts-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AdwordsAccounts-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AdwordsAccounts-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccounts-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdwordsAccounts-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Attribute">class <strong>Attribute</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:attribute element<br>
+ <br>
+Generic attribute used for generic projection and to define<br>
+custom elements.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Attribute">Attribute</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<dl><dt><strong>unit</strong> = 'unit'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Attribute-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Attribute-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Attribute-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Attribute-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Attribute-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Attribute-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Attribute-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Attribute-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Attribute-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Attribute-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AttributeLanguage">class <strong>AttributeLanguage</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:attribute_language element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#AttributeLanguage">AttributeLanguage</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AttributeLanguage-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttributeLanguage-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttributeLanguage-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AttributeLanguage-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttributeLanguage-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AttributeLanguage-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AttributeLanguage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AttributeLanguage-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AttributeLanguage-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttributeLanguage-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Author">class <strong>Author</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:author element<br>
+ <br>
+Defines the author of the information, recommended for books.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Author">Author</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Author-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Author-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Author-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Author-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Author-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Author-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Author-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Author-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Author-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Author-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Availability">class <strong>Availability</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:availability element<br>
+ <br>
+The retailer's suggested label for product availability. Supported values<br>
+include: 'in stock', 'out of stock', 'limited availability',<br>
+ 'available for order', and 'preorder'.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Availability">Availability</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Availability-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Availability-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Availability-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Availability-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Availability-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Availability-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Availability-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Availability-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Availability-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Availability-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Brand">class <strong>Brand</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:brand element<br>
+ <br>
+The brand of the product<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Brand">Brand</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Brand-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Brand-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Brand-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Brand-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Brand-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Brand-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Brand-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Brand-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Brand-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Brand-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Channel">class <strong>Channel</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:channel element<br>
+ <br>
+The channel for the product. Supported values are: 'online', 'local'<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Channel">Channel</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Channel-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Channel-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Channel-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Channel-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Channel-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Channel-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Channel-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Channel-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Channel-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Channel-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ClientAccount">class <strong>ClientAccount</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A multiclient account entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ClientAccount">ClientAccount</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>adult_content</strong> = <class 'gdata.contentforshopping.data.AdultContent'><dd><tt>sc:adult_content element</tt></dl>
+
+<dl><dt><strong>adwords_accounts</strong> = <class 'gdata.contentforshopping.data.AdwordsAccounts'><dd><tt>sc:adwords_accounts element<br>
+ <br>
+Container element for adwords accounts settings.</tt></dl>
+
+<dl><dt><strong>internal_id</strong> = <class 'gdata.contentforshopping.data.InternalId'><dd><tt>sc:internal_id element</tt></dl>
+
+<dl><dt><strong>reviews_url</strong> = <class 'gdata.contentforshopping.data.ReviewsUrl'><dd><tt>sc:reviews_url element</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="ClientAccount-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ClientAccount-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ClientAccount-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ClientAccount-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ClientAccount-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccount-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccount-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ClientAccountFeed">class <strong>ClientAccountFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A multiclient account feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ClientAccountFeed">ClientAccountFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.contentforshopping.data.ClientAccount'>]</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.contentforshopping.data.ItemsPerPage'></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.contentforshopping.data.StartIndex'></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.contentforshopping.data.TotalResults'></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ClientAccountFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ClientAccountFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ClientAccountFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ClientAccountFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ClientAccountFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ClientAccountFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Code">class <strong>Code</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:code element<br>
+ <br>
+The warning code. Currently validation/missing_recommended is the<br>
+only code used.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Code">Code</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Code-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Code-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Code-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Code-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Code-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Code-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Code-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Code-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Code-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Code-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Color">class <strong>Color</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:color element<br>
+ <br>
+The color of the product.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Color">Color</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Color-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Color-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Color-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Color-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Color-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Color-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Color-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Color-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Color-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Color-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Condition">class <strong>Condition</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:condition element<br>
+ <br>
+The condition of the product, one of "new", "used", "refurbished"<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Condition">Condition</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Condition-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Condition-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Condition-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Condition-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Condition-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Condition-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Condition-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Condition-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Condition-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Condition-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContentForShoppingError">class <strong>ContentForShoppingError</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>gd:error element<br>
+ <br>
+This element should be placed inside the gd:errors (<a href="#ContentForShoppingErrors">ContentForShoppingErrors</a>)<br>
+element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ContentForShoppingError">ContentForShoppingError</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>id</strong></dt>
+<dd><tt>Id for error element.<br>
+ <br>
+The namespace for the id element is different in batch requests than in<br>
+individual requests, so we need to consider either case.</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>code</strong> = <class 'gdata.contentforshopping.data.ErrorCode'><dd><tt>gd:code element<br>
+ <br>
+A code to categorize the errors.<br>
+ <br>
+This element should be placed inside the gd:error (<a href="#ContentForShoppingError">ContentForShoppingError</a>)<br>
+element.</tt></dl>
+
+<dl><dt><strong>domain</strong> = <class 'gdata.contentforshopping.data.ErrorDomain'><dd><tt>gd:domain element<br>
+ <br>
+The scope of the error. If the error is global (e.g. missing title) then sc<br>
+value is returned. Otherwise a comma-separated list of destinations is<br>
+returned.<br>
+ <br>
+This element should be placed inside the gd:error (<a href="#ContentForShoppingError">ContentForShoppingError</a>)<br>
+element.</tt></dl>
+
+<dl><dt><strong>internal_reason</strong> = <class 'gdata.contentforshopping.data.InternalReason'><dd><tt>gd:internalReason element<br>
+ <br>
+A more detailed message to explain the cause of the error.<br>
+ <br>
+This element should be placed inside the gd:error (<a href="#ContentForShoppingError">ContentForShoppingError</a>)<br>
+element.</tt></dl>
+
+<dl><dt><strong>location</strong> = <class 'gdata.contentforshopping.data.ErrorLocation'><dd><tt>gd:location element<br>
+ <br>
+The name of the attribute that failed validation.<br>
+ <br>
+This element should be placed inside the gd:error (<a href="#ContentForShoppingError">ContentForShoppingError</a>)<br>
+element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ContentForShoppingError-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingError-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingError-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingError-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingError-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingError-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingError-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingError-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingError-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingError-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContentForShoppingErrors">class <strong>ContentForShoppingErrors</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:errors element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ContentForShoppingErrors">ContentForShoppingErrors</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>errors</strong> = [<class 'gdata.contentforshopping.data.ContentForShoppingError'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ContentForShoppingErrors-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingErrors-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingErrors-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingErrors-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingErrors-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingErrors-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingErrors-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentForShoppingErrors-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingErrors-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentForShoppingErrors-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContentLanguage">class <strong>ContentLanguage</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:content_language element<br>
+ <br>
+Language used in the item content for the product<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ContentLanguage">ContentLanguage</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ContentLanguage-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentLanguage-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentLanguage-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContentLanguage-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentLanguage-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ContentLanguage-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentLanguage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentLanguage-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContentLanguage-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentLanguage-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DataQualityEntry">class <strong>DataQualityEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Data Quality Feed entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#DataQualityEntry">DataQualityEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>issue_groups</strong> = <class 'gdata.contentforshopping.data.IssueGroups'><dd><tt>sc:issue_groups element</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="DataQualityEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="DataQualityEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="DataQualityEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="DataQualityEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="DataQualityEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DataQualityFeed">class <strong>DataQualityFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Data Quality Feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#DataQualityFeed">DataQualityFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.contentforshopping.data.DataQualityEntry'>]</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.contentforshopping.data.ItemsPerPage'></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.contentforshopping.data.StartIndex'></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.contentforshopping.data.TotalResults'></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="DataQualityFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="DataQualityFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="DataQualityFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="DataQualityFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="DataQualityFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DataQualityFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DataQualityFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DatafeedEntry">class <strong>DatafeedEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An entry for a Datafeed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#DatafeedEntry">DatafeedEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>attribute_language</strong> = <class 'gdata.contentforshopping.data.AttributeLanguage'><dd><tt>sc:attribute_language element</tt></dl>
+
+<dl><dt><strong>content_language</strong> = <class 'gdata.contentforshopping.data.ContentLanguage'><dd><tt>sc:content_language element<br>
+ <br>
+Language used in the item content for the product</tt></dl>
+
+<dl><dt><strong>edited</strong> = <class 'gdata.contentforshopping.data.Edited'><dd><tt>sc:edited element</tt></dl>
+
+<dl><dt><strong>feed_file_name</strong> = <class 'gdata.contentforshopping.data.FeedFileName'><dd><tt>sc:feed_file_name element</tt></dl>
+
+<dl><dt><strong>feed_type</strong> = <class 'gdata.contentforshopping.data.FeedType'><dd><tt>sc:feed_type element</tt></dl>
+
+<dl><dt><strong>file_format</strong> = <class 'gdata.contentforshopping.data.FileFormat'><dd><tt>sc:file_format element</tt></dl>
+
+<dl><dt><strong>processing_status</strong> = <class 'gdata.contentforshopping.data.ProcessingStatus'><dd><tt>sc:processing_status element</tt></dl>
+
+<dl><dt><strong>target_country</strong> = <class 'gdata.contentforshopping.data.TargetCountry'><dd><tt>sc:target_country element<br>
+ <br>
+The target country of the product</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="DatafeedEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="DatafeedEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="DatafeedEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="DatafeedEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="DatafeedEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DatafeedFeed">class <strong>DatafeedFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A datafeed feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#DatafeedFeed">DatafeedFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.contentforshopping.data.DatafeedEntry'>]</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.contentforshopping.data.ItemsPerPage'></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.contentforshopping.data.StartIndex'></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.contentforshopping.data.TotalResults'></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="DatafeedFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="DatafeedFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="DatafeedFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="DatafeedFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="DatafeedFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="DatafeedFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DatafeedFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Datapoint">class <strong>Datapoint</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:datapoint element<br>
+ <br>
+<a href="#Datapoint">Datapoint</a> representing click data for an item on<br>
+a given day.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Datapoint">Datapoint</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>clicks</strong> = 'clicks'</dl>
+
+<dl><dt><strong>date</strong> = 'date'</dl>
+
+<dl><dt><strong>paid_clicks</strong> = 'paid_clicks'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Datapoint-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Datapoint-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Datapoint-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Datapoint-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Datapoint-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Datapoint-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Datapoint-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Datapoint-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Datapoint-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Datapoint-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Domain">class <strong>Domain</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:domain element<br>
+ <br>
+The scope of the warning. A comma-separated list of destinations,<br>
+for example: ProductSearch.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Domain">Domain</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Domain-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Domain-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Domain-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Domain-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Domain-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Domain-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Domain-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Domain-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Domain-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Domain-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Edited">class <strong>Edited</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:edited element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Edited">Edited</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Edited-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Edited-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Edited-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Edited-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Edited-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Edited-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Edited-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Edited-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Edited-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Edited-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Edition">class <strong>Edition</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:edition element<br>
+ <br>
+The edition of the product. Recommended for products with multiple editions<br>
+such as collectors' editions etc, such as books.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Edition">Edition</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Edition-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Edition-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Edition-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Edition-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Edition-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Edition-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Edition-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Edition-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Edition-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Edition-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EnergyEfficiencyClass">class <strong>EnergyEfficiencyClass</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:energy_efficiency_class element<br>
+ <br>
+The item's energy efficiency class.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#EnergyEfficiencyClass">EnergyEfficiencyClass</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EnergyEfficiencyClass-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EnergyEfficiencyClass-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EnergyEfficiencyClass-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EnergyEfficiencyClass-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EnergyEfficiencyClass-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="EnergyEfficiencyClass-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="EnergyEfficiencyClass-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EnergyEfficiencyClass-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EnergyEfficiencyClass-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EnergyEfficiencyClass-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ErrorCode">class <strong>ErrorCode</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>gd:code element<br>
+ <br>
+A code to categorize the errors.<br>
+ <br>
+This element should be placed inside the gd:error (<a href="#ContentForShoppingError">ContentForShoppingError</a>)<br>
+element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ErrorCode">ErrorCode</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ErrorCode-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorCode-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorCode-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ErrorCode-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorCode-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ErrorCode-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ErrorCode-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ErrorCode-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ErrorCode-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorCode-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ErrorDomain">class <strong>ErrorDomain</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>gd:domain element<br>
+ <br>
+The scope of the error. If the error is global (e.g. missing title) then sc<br>
+value is returned. Otherwise a comma-separated list of destinations is<br>
+returned.<br>
+ <br>
+This element should be placed inside the gd:error (<a href="#ContentForShoppingError">ContentForShoppingError</a>)<br>
+element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ErrorDomain">ErrorDomain</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ErrorDomain-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorDomain-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorDomain-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ErrorDomain-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorDomain-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ErrorDomain-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ErrorDomain-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ErrorDomain-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ErrorDomain-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorDomain-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ErrorLocation">class <strong>ErrorLocation</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>gd:location element<br>
+ <br>
+The name of the attribute that failed validation.<br>
+ <br>
+This element should be placed inside the gd:error (<a href="#ContentForShoppingError">ContentForShoppingError</a>)<br>
+element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ErrorLocation">ErrorLocation</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ErrorLocation-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorLocation-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorLocation-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ErrorLocation-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorLocation-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ErrorLocation-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ErrorLocation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ErrorLocation-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ErrorLocation-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ErrorLocation-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExampleItem">class <strong>ExampleItem</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:example_item element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ExampleItem">ExampleItem</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>item_id</strong> = <class 'gdata.contentforshopping.data.ItemId'><dd><tt>sc:item_id element</tt></dl>
+
+<dl><dt><strong>link</strong> = <class 'gdata.contentforshopping.data.ExampleItemLink'><dd><tt>sc:link element</tt></dl>
+
+<dl><dt><strong>submitted_value</strong> = <class 'gdata.contentforshopping.data.SubmittedValue'><dd><tt>sc:submitted_value element</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'gdata.contentforshopping.data.ExampleItemTitle'><dd><tt>sc:title element</tt></dl>
+
+<dl><dt><strong>value_on_landing_page</strong> = <class 'gdata.contentforshopping.data.ValueOnLandingPage'><dd><tt>sc:value_on_landing_page element</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ExampleItem-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItem-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItem-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItem-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItem-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItem-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ExampleItem-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ExampleItem-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItem-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItem-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExampleItemLink">class <strong>ExampleItemLink</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:link element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ExampleItemLink">ExampleItemLink</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ExampleItemLink-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemLink-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemLink-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemLink-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemLink-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemLink-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ExampleItemLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ExampleItemLink-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemLink-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemLink-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExampleItemTitle">class <strong>ExampleItemTitle</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:title element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ExampleItemTitle">ExampleItemTitle</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ExampleItemTitle-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemTitle-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemTitle-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemTitle-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemTitle-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemTitle-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ExampleItemTitle-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ExampleItemTitle-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemTitle-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExampleItemTitle-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExcludedDestination">class <strong>ExcludedDestination</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:excluded_destination element<br>
+ <br>
+This element defines the required destination for a product, namely<br>
+"ProductSearch", "ProductAds" or "CommerceSearch". It should be added to the<br>
+app:control element (<a href="#ProductEntry">ProductEntry</a>'s "control" attribute) to specify where the<br>
+product should not appear in search APIs.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ExcludedDestination">ExcludedDestination</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>dest</strong> = 'dest'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ExcludedDestination-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExcludedDestination-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExcludedDestination-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExcludedDestination-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExcludedDestination-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ExcludedDestination-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ExcludedDestination-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ExcludedDestination-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExcludedDestination-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExcludedDestination-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExpirationDate">class <strong>ExpirationDate</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:expiration_date<br>
+ <br>
+This is the date when the product listing will expire. If omitted, this will<br>
+default to 30 days after the product was created.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ExpirationDate">ExpirationDate</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ExpirationDate-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExpirationDate-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExpirationDate-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExpirationDate-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExpirationDate-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ExpirationDate-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ExpirationDate-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ExpirationDate-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExpirationDate-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExpirationDate-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Feature">class <strong>Feature</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:feature element<br>
+ <br>
+A product feature. A product may have multiple features, each being text, for<br>
+example a smartphone may have features: "wifi", "gps" etc.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Feature">Feature</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Feature-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feature-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feature-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Feature-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feature-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Feature-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Feature-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feature-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Feature-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feature-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FeaturedProduct">class <strong>FeaturedProduct</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:featured_product element<br>
+ <br>
+Used to indicate that this item is a special, featured product; Supported<br>
+values are: "true", "false".<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#FeaturedProduct">FeaturedProduct</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FeaturedProduct-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeaturedProduct-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeaturedProduct-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeaturedProduct-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeaturedProduct-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="FeaturedProduct-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="FeaturedProduct-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeaturedProduct-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeaturedProduct-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeaturedProduct-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FeedFileName">class <strong>FeedFileName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:feed_file_name element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#FeedFileName">FeedFileName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FeedFileName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedFileName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedFileName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeedFileName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedFileName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="FeedFileName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="FeedFileName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedFileName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeedFileName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedFileName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FeedType">class <strong>FeedType</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:feed_type element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#FeedType">FeedType</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FeedType-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedType-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedType-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeedType-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedType-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="FeedType-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="FeedType-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedType-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeedType-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedType-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FileFormat">class <strong>FileFormat</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:file_format element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#FileFormat">FileFormat</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>format</strong> = 'format'</dl>
+
+<dl><dt><strong>use_quoted_fields</strong> = <class 'gdata.contentforshopping.data.UseQuotedFields'><dd><tt>sc:use_quoted_fields element</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FileFormat-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FileFormat-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FileFormat-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FileFormat-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FileFormat-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="FileFormat-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="FileFormat-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FileFormat-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FileFormat-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FileFormat-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Gender">class <strong>Gender</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:gender element<br>
+ <br>
+The gender for the item. Supported values are: 'unisex', 'female', 'male'<br>
+ <br>
+Note: This tag is required if the google product type is part of<br>
+ Apparel & Accessories.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Gender">Gender</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Gender-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gender-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gender-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Gender-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gender-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Gender-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Gender-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Gender-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Gender-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gender-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Genre">class <strong>Genre</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:genre element<br>
+ <br>
+Describes the genre of a product, eg "comedy". Strongly recommended for media.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Genre">Genre</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Genre-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Genre-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Genre-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Genre-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Genre-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Genre-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Genre-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Genre-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Genre-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Genre-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GoogleProductCategory">class <strong>GoogleProductCategory</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:google_product_category element<br>
+ <br>
+The product's google category. The value must be one of the categories listed<br>
+in the Product type taxonomy, which can be found at<br>
+<a href="http://www.google.com/support/merchants/bin/answer.py?answer=160081">http://www.google.com/support/merchants/bin/answer.py?answer=160081</a>.<br>
+ <br>
+Note that & and > characters must be encoded as &amp; and &gt;<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#GoogleProductCategory">GoogleProductCategory</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GoogleProductCategory-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GoogleProductCategory-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GoogleProductCategory-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GoogleProductCategory-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GoogleProductCategory-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GoogleProductCategory-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GoogleProductCategory-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GoogleProductCategory-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GoogleProductCategory-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GoogleProductCategory-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Group">class <strong>Group</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:group element<br>
+ <br>
+Generic group used for generic projection and to define<br>
+custom elements groups.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Group">Group</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>attribute</strong> = [<class 'gdata.contentforshopping.data.Attribute'>]</dl>
+
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Group-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Group-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Group-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Group-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Group-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Group-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Group-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Group-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Group-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Group-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Gtin">class <strong>Gtin</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:gtin element<br>
+ <br>
+GTIN of the product (isbn/upc/ean)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Gtin">Gtin</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Gtin-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gtin-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gtin-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Gtin-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gtin-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Gtin-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Gtin-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Gtin-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Gtin-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gtin-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="IdentifierExists">class <strong>IdentifierExists</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:identifier_exists element<br>
+ <br>
+Specify as true if the item has no manufacturer part number or<br>
+any other industry standard product identifier.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#IdentifierExists">IdentifierExists</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="IdentifierExists-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IdentifierExists-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IdentifierExists-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IdentifierExists-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IdentifierExists-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="IdentifierExists-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="IdentifierExists-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IdentifierExists-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IdentifierExists-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IdentifierExists-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ImageLink">class <strong>ImageLink</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:image_link element<br>
+ <br>
+This is the URL of an associated image for a product. Please use full size<br>
+images (400x400 pixels or larger), not thumbnails.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ImageLink">ImageLink</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ImageLink-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ImageLink-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ImageLink-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ImageLink-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ImageLink-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ImageLink-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ImageLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ImageLink-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ImageLink-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ImageLink-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="InternalId">class <strong>InternalId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:internal_id element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#InternalId">InternalId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="InternalId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InternalId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InternalId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InternalId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InternalId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="InternalId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="InternalId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InternalId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InternalId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InternalId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="InternalReason">class <strong>InternalReason</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>gd:internalReason element<br>
+ <br>
+A more detailed message to explain the cause of the error.<br>
+ <br>
+This element should be placed inside the gd:error (<a href="#ContentForShoppingError">ContentForShoppingError</a>)<br>
+element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#InternalReason">InternalReason</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="InternalReason-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InternalReason-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InternalReason-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InternalReason-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InternalReason-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="InternalReason-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="InternalReason-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InternalReason-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InternalReason-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InternalReason-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="InventoryEntry">class <strong>InventoryEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Product entry containing local product information.<br>
+ <br>
+The elements of this entry that are used are made up of five different<br>
+namespaces. They are:<br>
+ <br>
+atom: - Atom<br>
+app: - Atom Publishing Protocol<br>
+gd: - Google Data API<br>
+sc: - Content API for Shopping, general attributes<br>
+scp: - Content API for Shopping, product attributes<br>
+ <br>
+Only the sc and scp namespace elements are defined here, but additional useful<br>
+elements are defined in superclasses.<br>
+ <br>
+To remove the value of an attribute of a local product, set the value of the<br>
+attribute to the empty string. For example:<br>
+ <br>
+ entry.availability = <a href="#Availability">Availability</a>('')<br>
+ <br>
+The following attributes are encoded as XML elements in the Atom (atom:)<br>
+namespace: title, link, entry, id, category, content, author, created<br>
+updated. Among these, the title, content and link tags are part of the<br>
+required Content for Shopping API so we document them here.<br>
+ <br>
+.. attribute:: availability<br>
+ <br>
+ The avilability of a local product.<br>
+ <br>
+ This should be an :class:`<a href="#Availability">Availability</a>` instance, for example::<br>
+ <br>
+ entry = <a href="#InventoryEntry">InventoryEntry</a>()<br>
+ entry.availability = <a href="#Availability">Availability</a>('in stock')<br>
+ <br>
+.. attribute:: price<br>
+ <br>
+ The price for this local product.<br>
+ <br>
+ This should be a :class:`<a href="#Price">Price</a>` element, including a unit argument to<br>
+ indicate the currency, for example::<br>
+ <br>
+ entry = <a href="#InventoryEntry">InventoryEntry</a>()<br>
+ entry.price = <a href="#Price">Price</a>('20.00', unit='USD')<br>
+ <br>
+.. attribute:: quantity<br>
+ <br>
+ The quantity of local product available in stock.<br>
+ <br>
+ This should be a :class:`<a href="#Quantity">Quantity</a>` element, for example::<br>
+ <br>
+ entry = <a href="#InventoryEntry">InventoryEntry</a>()<br>
+ entry.quantity = <a href="#Quantity">Quantity</a>('100')<br>
+ <br>
+.. attribute:: sale_price<br>
+ <br>
+ The sale price for this local product.<br>
+ <br>
+ This should be a :class:`<a href="#SalePrice">SalePrice</a>` element, including a unit argument to<br>
+ indicate the currency, for example::<br>
+ <br>
+ entry = <a href="#InventoryEntry">InventoryEntry</a>()<br>
+ entry.sale_price = <a href="#SalePrice">SalePrice</a>('20.00', unit='USD')<br>
+ <br>
+.. attribute:: sale_price_effective_date<br>
+ <br>
+ The effective data of the sale price for this local product.<br>
+ <br>
+ This should be a :class:`<a href="#SalePriceEffectiveDate">SalePriceEffectiveDate</a>` element, for example::<br>
+ <br>
+ entry = <a href="#InventoryEntry">InventoryEntry</a>()<br>
+ entry.sale_price_effective_date = <a href="#SalePriceEffectiveDate">SalePriceEffectiveDate</a>(<br>
+ '2012-01-09 2012-01-13')<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#InventoryEntry">InventoryEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>availability</strong> = <class 'gdata.contentforshopping.data.Availability'><dd><tt>scp:availability element<br>
+ <br>
+The retailer's suggested label for product availability. Supported values<br>
+include: 'in stock', 'out of stock', 'limited availability',<br>
+ 'available for order', and 'preorder'.</tt></dl>
+
+<dl><dt><strong>price</strong> = <class 'gdata.contentforshopping.data.Price'><dd><tt>scp:price element<br>
+ <br>
+The price of the product. The unit attribute must be set, and should represent<br>
+the currency.<br>
+ <br>
+Note: Required Element</tt></dl>
+
+<dl><dt><strong>quantity</strong> = <class 'gdata.contentforshopping.data.Quantity'><dd><tt>scp:quantity element<br>
+ <br>
+The number of items available. A value of 0 indicates items that are<br>
+currently out of stock.</tt></dl>
+
+<dl><dt><strong>sale_price</strong> = <class 'gdata.contentforshopping.data.SalePrice'><dd><tt>scp:sale_price element<br>
+ <br>
+The sale price of the product. The unit attribute must be set, and should<br>
+represent the currency.</tt></dl>
+
+<dl><dt><strong>sale_price_effective_date</strong> = <class 'gdata.contentforshopping.data.SalePriceEffectiveDate'><dd><tt>scp:sale_price_effective_date element<br>
+ <br>
+The effective date of the sale price of the product.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="InventoryEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="InventoryEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="InventoryEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="InventoryEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="InventoryEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="InventoryEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="InventoryFeed">class <strong>InventoryFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of a merchant's local products.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#InventoryFeed">InventoryFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.contentforshopping.data.InventoryEntry'>]</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.contentforshopping.data.ItemsPerPage'></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.contentforshopping.data.StartIndex'></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.contentforshopping.data.TotalResults'></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="InventoryFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="InventoryFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="InventoryFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="InventoryFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="InventoryFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="InventoryFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="InventoryFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InventoryFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Issue">class <strong>Issue</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:issue element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Issue">Issue</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>example_item</strong> = [<class 'gdata.contentforshopping.data.ExampleItem'>]</dl>
+
+<dl><dt><strong>id</strong> = 'id'</dl>
+
+<dl><dt><strong>last_checked</strong> = 'last_checked'</dl>
+
+<dl><dt><strong>num_items</strong> = 'num_items'</dl>
+
+<dl><dt><strong>offending_term</strong> = 'offending_term'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Issue-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Issue-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Issue-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Issue-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Issue-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Issue-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Issue-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Issue-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Issue-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Issue-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="IssueGroup">class <strong>IssueGroup</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:issue_group element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#IssueGroup">IssueGroup</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>country</strong> = 'country'</dl>
+
+<dl><dt><strong>id</strong> = 'id'</dl>
+
+<dl><dt><strong>issue</strong> = [<class 'gdata.contentforshopping.data.Issue'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="IssueGroup-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroup-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroup-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroup-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroup-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroup-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="IssueGroup-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueGroup-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroup-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroup-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="IssueGroups">class <strong>IssueGroups</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:issue_groups element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#IssueGroups">IssueGroups</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>issue_group</strong> = [<class 'gdata.contentforshopping.data.IssueGroup'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="IssueGroups-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroups-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroups-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroups-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroups-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroups-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="IssueGroups-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueGroups-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroups-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueGroups-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ItemGroupID">class <strong>ItemGroupID</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:item_group_id element<br>
+ <br>
+The identifier for products with variants. This id is used to link items which<br>
+have different values for the fields:<br>
+ <br>
+ 'color', 'material', 'pattern', 'size'<br>
+ <br>
+but are the same item, for example a shirt with different sizes.<br>
+ <br>
+Note: This tag is required for all product variants.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ItemGroupID">ItemGroupID</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ItemGroupID-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemGroupID-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemGroupID-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ItemGroupID-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemGroupID-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ItemGroupID-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ItemGroupID-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ItemGroupID-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ItemGroupID-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemGroupID-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ItemId">class <strong>ItemId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:item_id element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ItemId">ItemId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ItemId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ItemId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ItemId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ItemId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ItemId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ItemId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ItemsPerPage">class <strong>ItemsPerPage</strong></a>(<a href="gdata.data.html#ItemsPerPage">gdata.data.ItemsPerPage</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ItemsPerPage">ItemsPerPage</a></dd>
+<dd><a href="gdata.data.html#ItemsPerPage">gdata.data.ItemsPerPage</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ItemsPerPage-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ItemsPerPage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ItemsPerPage-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Location">class <strong>Location</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:location element<br>
+ <br>
+The name of the product element that has raised the warning. This may be<br>
+any valid product element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Location">Location</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Location-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Location-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Location-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Location-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Location-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Location-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Location-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Location-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Location-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Location-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Manufacturer">class <strong>Manufacturer</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:manufacturer element<br>
+ <br>
+<a href="#Manufacturer">Manufacturer</a> of the product.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Manufacturer">Manufacturer</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Manufacturer-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Manufacturer-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Manufacturer-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Manufacturer-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Manufacturer-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Manufacturer-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Manufacturer-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Manufacturer-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Manufacturer-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Manufacturer-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Material">class <strong>Material</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:material element<br>
+ <br>
+The material the product is made of.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Material">Material</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Material-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Material-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Material-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Material-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Material-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Material-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Material-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Material-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Material-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Material-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Message">class <strong>Message</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:message element<br>
+ <br>
+A plain text description of the warning.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Message">Message</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Message-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Message-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Message-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Message-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Message-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Message-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Message-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Message-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Message-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Message-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Mpn">class <strong>Mpn</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:mpn element<br>
+ <br>
+<a href="#Manufacturer">Manufacturer</a>'s Part Number. A unique code determined by the manufacturer for<br>
+the product.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Mpn">Mpn</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Mpn-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Mpn-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Mpn-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Mpn-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Mpn-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Mpn-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Mpn-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Mpn-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Mpn-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Mpn-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Multipack">class <strong>Multipack</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:ultipack element<br>
+ <br>
+The number of products in a merchant-defined custom multipack<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Multipack">Multipack</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Multipack-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Multipack-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Multipack-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Multipack-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Multipack-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Multipack-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Multipack-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Multipack-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Multipack-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Multipack-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Pattern">class <strong>Pattern</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:pattern element<br>
+ <br>
+The pattern of the product. (e.g. polka dots)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Pattern">Pattern</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Pattern-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Pattern-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Pattern-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Pattern-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Pattern-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Pattern-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Pattern-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Pattern-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Pattern-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Pattern-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Performance">class <strong>Performance</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:performance element<br>
+ <br>
+Container element for daily click data.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Performance">Performance</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>datapoint</strong> = [<class 'gdata.contentforshopping.data.Datapoint'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Performance-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Performance-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Performance-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Performance-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Performance-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Performance-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Performance-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Performance-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Performance-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Performance-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Permission">class <strong>Permission</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:permission element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Permission">Permission</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>scope</strong> = 'scope'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Permission-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Permission-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Permission-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Permission-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Permission-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Permission-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Permission-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Permission-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Permission-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Permission-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Price">class <strong>Price</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:price element<br>
+ <br>
+The price of the product. The unit attribute must be set, and should represent<br>
+the currency.<br>
+ <br>
+Note: Required Element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Price">Price</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>unit</strong> = 'unit'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Price-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Price-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Price-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Price-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Price-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Price-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Price-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Price-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Price-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Price-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProcessingStatus">class <strong>ProcessingStatus</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:processing_status element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ProcessingStatus">ProcessingStatus</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ProcessingStatus-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProcessingStatus-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProcessingStatus-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProcessingStatus-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProcessingStatus-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ProcessingStatus-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProcessingStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProcessingStatus-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProcessingStatus-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProcessingStatus-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProductControl">class <strong>ProductControl</strong></a>(<a href="atom.data.html#Control">atom.data.Control</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>app:control element<br>
+ <br>
+overridden to provide additional elements in the sc namespace.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ProductControl">ProductControl</a></dd>
+<dd><a href="atom.data.html#Control">atom.data.Control</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>excluded_destination</strong> = [<class 'gdata.contentforshopping.data.ExcludedDestination'>]</dl>
+
+<dl><dt><strong>required_destination</strong> = [<class 'gdata.contentforshopping.data.RequiredDestination'>]</dl>
+
+<dl><dt><strong>status</strong> = [<class 'gdata.contentforshopping.data.Status'>]</dl>
+
+<dl><dt><strong>validate_destination</strong> = [<class 'gdata.contentforshopping.data.ValidateDestination'>]</dl>
+
+<dl><dt><strong>warnings</strong> = <class 'gdata.contentforshopping.data.Warnings'><dd><tt>sc:warnings element<br>
+ <br>
+Container element for the list of warnings.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Control">atom.data.Control</a>:<br>
+<dl><dt><strong>draft</strong> = <class 'atom.data.Draft'><dd><tt>The app:draft element which indicates if this entry should be public.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ProductControl-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductControl-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductControl-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductControl-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductControl-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ProductControl-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProductControl-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductControl-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductControl-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductControl-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProductEntry">class <strong>ProductEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Product entry containing product information<br>
+ <br>
+The elements of this entry that are used are made up of five different<br>
+namespaces. They are:<br>
+ <br>
+atom: - Atom<br>
+app: - Atom Publishing Protocol<br>
+gd: - Google Data API<br>
+sc: - Content API for Shopping, general attributes<br>
+scp: - Content API for Shopping, product attributes<br>
+ <br>
+Only the sc and scp namespace elements are defined here, but additional useful<br>
+elements are defined in superclasses.<br>
+ <br>
+The following attributes are encoded as XML elements in the Atomn (atom:)<br>
+namespace: title, link, entry, id, category, content, author, created<br>
+updated. Among these, the title, content and link tags are part of the<br>
+required Content for Shopping API so we document them here.<br>
+ <br>
+.. attribute:: title<br>
+ <br>
+ The title of the product.<br>
+ <br>
+ This should be a :class:`atom.data.Title` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.title = atom.data.Title(u'32GB MP3 Player')<br>
+ <br>
+.. attribute:: content<br>
+ <br>
+ The description of the item.<br>
+ <br>
+ This should be a :class:`atom.data.Content` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.content = atom.data.Content('My item description')<br>
+ <br>
+.. attribute:: link<br>
+ <br>
+ A link to a page where the item can be purchased.<br>
+ <br>
+ This should be a :class:`atom.data.Link` element, for example::<br>
+ <br>
+ link = atom.data.Link(rel='alternate', type='text/html',<br>
+ href='<a href="http://www.somehost.com/123456jsh9">http://www.somehost.com/123456jsh9</a>')<br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.link.append(link)<br>
+ <br>
+.. attribute:: additional_image_link<br>
+ <br>
+ A list of additional links to images of the product. Each link should be an<br>
+ :class:`<a href="#AdditionalImageLink">AdditionalImageLink</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.additional_image_link.append(<br>
+ <a href="#AdditionalImageLink">AdditionalImageLink</a>('<a href="http://myshop/cdplayer.jpg">http://myshop/cdplayer.jpg</a>'))<br>
+ <br>
+.. attribute:: author<br>
+ <br>
+ The author of the product.<br>
+ <br>
+ This should be a :class:`<a href="#Author">Author</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.author = atom.data.<a href="#Author">Author</a>(u'Isaac Asimov')<br>
+ <br>
+.. attribute:: attribute<br>
+ <br>
+ List of generic attributes.<br>
+ <br>
+ This should be a list of :class:`<a href="#Attribute">Attribute</a>` elements, for example::<br>
+ <br>
+ attribute = <a href="#Attribute">Attribute</a>('foo')<br>
+ attribute.name = 'bar'<br>
+ attribute.type = 'baz'<br>
+ attribute.unit = 'kg'<br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.attributes.append(attribute)<br>
+ <br>
+.. attribute:: availability<br>
+ <br>
+ The avilability of a product.<br>
+ <br>
+ This should be an :class:`<a href="#Availability">Availability</a>` instance, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.availability = <a href="#Availability">Availability</a>('in stock')<br>
+ <br>
+.. attribute:: brand<br>
+ <br>
+ The brand of a product.<br>
+ <br>
+ This should be a :class:`<a href="#Brand">Brand</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.brand = <a href="#Brand">Brand</a>(u'Sony')<br>
+ <br>
+.. attribute:: channel<br>
+ <br>
+ The channel for the product. Supported values are: 'online', 'local'<br>
+ <br>
+ This should be a :class:`<a href="#Channel">Channel</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.channel = <a href="#Channel">Channel</a>('online')<br>
+ <br>
+.. attribute:: color<br>
+ <br>
+ The color of a product.<br>
+ <br>
+ This should be a :class:`<a href="#Color">Color</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.color = <a href="#Color">Color</a>(u'purple')<br>
+ <br>
+.. attribute:: condition<br>
+ <br>
+ The condition of a product.<br>
+ <br>
+ This should be a :class:`<a href="#Condition">Condition</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.condition = <a href="#Condition">Condition</a>(u'new')<br>
+ <br>
+.. attribute:: content_language<br>
+ <br>
+ The language for the product.<br>
+ <br>
+ This should be a :class:`<a href="#ContentLanguage">ContentLanguage</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.content_language = <a href="#ContentLanguage">ContentLanguage</a>('EN')<br>
+ <br>
+.. attribute:: control<br>
+ <br>
+ Overrides :class:`atom.data.<a href="atom.data.html#Control">Control</a>` to provide additional elements<br>
+ required_destination and excluded_destination in the sc namespace<br>
+ <br>
+ This should be a :class:`<a href="#ProductControl">ProductControl</a>` element.<br>
+ <br>
+.. attribute:: edition<br>
+ <br>
+ The edition of the product.<br>
+ <br>
+ This should be a :class:`<a href="#Edition">Edition</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.edition = <a href="#Edition">Edition</a>('1')<br>
+ <br>
+.. attribute:: expiration_date<br>
+ <br>
+ The expiration date of this product listing.<br>
+ <br>
+ This should be a :class:`<a href="#ExpirationDate">ExpirationDate</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.expiration_date = <a href="#ExpirationDate">ExpirationDate</a>('2011-22-03')<br>
+ <br>
+.. attribute:: feature<br>
+ <br>
+ A list of features for this product.<br>
+ <br>
+ Each feature should be a :class:`<a href="#Feature">Feature</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.feature.append(<a href="#Feature">Feature</a>(u'wifi'))<br>
+ entry.feature.append(<a href="#Feature">Feature</a>(u'gps'))<br>
+ <br>
+.. attribute:: featured_product<br>
+ <br>
+ Whether the product is featured.<br>
+ <br>
+ This should be a :class:`<a href="#FeaturedProduct">FeaturedProduct</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.featured_product = <a href="#FeaturedProduct">FeaturedProduct</a>('true')<br>
+ <br>
+.. attribute:: gender<br>
+ <br>
+ The gender for the item. Supported values are: 'unisex', 'female', 'male'<br>
+ <br>
+ This should be a :class:`<a href="#Gender">Gender</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.gender = <a href="#Gender">Gender</a>('female')<br>
+ <br>
+.. attribute:: genre<br>
+ <br>
+ The genre of the product.<br>
+ <br>
+ This should be a :class:`<a href="#Genre">Genre</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.genre = <a href="#Genre">Genre</a>(u'comedy')<br>
+ <br>
+.. attribute:: google_product_category<br>
+ <br>
+ The product's google category. Value must come from taxonomy listed at<br>
+ <br>
+ <a href="http://www.google.com/support/merchants/bin/answer.py?answer=160081">http://www.google.com/support/merchants/bin/answer.py?answer=160081</a><br>
+ <br>
+ This should be a :class:`<a href="#GoogleProductCategory">GoogleProductCategory</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.google_product_category = <a href="#GoogleProductCategory">GoogleProductCategory</a>(<br>
+ 'Animals &gt; Live Animals')<br>
+ <br>
+.. attribute:: gtin<br>
+ <br>
+ The gtin for this product.<br>
+ <br>
+ This should be a :class:`<a href="#Gtin">Gtin</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.gtin = <a href="#Gtin">Gtin</a>('A888998877997')<br>
+ <br>
+.. attribute:: image_link<br>
+ <br>
+ A link to the product image. This link should be an<br>
+ :class:`<a href="#ImageLink">ImageLink</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.image_link = <a href="#ImageLink">ImageLink</a>('<a href="http://myshop/cdplayer.jpg">http://myshop/cdplayer.jpg</a>')<br>
+ <br>
+.. attribute:: item_group_id<br>
+ <br>
+ The identifier for products with variants. This id is used to link items<br>
+ which have different values for the fields:<br>
+ <br>
+ 'color', 'material', 'pattern', 'size'<br>
+ <br>
+ but are the same item, for example a shirt with different sizes.<br>
+ <br>
+ This should be a :class:`<a href="#ItemGroupID">ItemGroupID</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.item_group_id = <a href="#ItemGroupID">ItemGroupID</a>('R1726122')<br>
+ <br>
+.. attribute:: manufacturer<br>
+ <br>
+ The manufacturer of the product.<br>
+ <br>
+ This should be a :class:`<a href="#Manufacturer">Manufacturer</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.manufacturer = <a href="#Manufacturer">Manufacturer</a>('Sony')<br>
+ <br>
+.. attribute:: material<br>
+ <br>
+ The material the product is made of.<br>
+ <br>
+ This should be a :class:`<a href="#Material">Material</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.material = <a href="#Material">Material</a>('cotton')<br>
+ <br>
+.. attribute:: mpn<br>
+ <br>
+ The manufacturer's part number for this product.<br>
+ <br>
+ This should be a :class:`<a href="#Mpn">Mpn</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.mpn = <a href="#Mpn">Mpn</a>('cd700199US')<br>
+ <br>
+.. attribute:: pattern<br>
+ <br>
+ The pattern of the product.<br>
+ <br>
+ This should be a :class:`<a href="#Pattern">Pattern</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.pattern = <a href="#Pattern">Pattern</a>('polka dots')<br>
+ <br>
+.. attribute:: performance<br>
+ <br>
+ The performance of the product.<br>
+ <br>
+ This should be a :class:`<a href="#Performance">Performance</a>` element.<br>
+ <br>
+.. attribute:: price<br>
+ <br>
+ The price for this product.<br>
+ <br>
+ This should be a :class:`<a href="#Price">Price</a>` element, including a unit argument to<br>
+ indicate the currency, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.price = <a href="#Price">Price</a>('20.00', unit='USD')<br>
+ <br>
+.. attribute:: product_id<br>
+ <br>
+ A link to the product image. This link should be an<br>
+ :class:`<a href="#ProductId">ProductId</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.product_id = <a href="#ProductId">ProductId</a>('ABC1234')<br>
+ <br>
+.. attribute:: product_type<br>
+ <br>
+ The type of product.<br>
+ <br>
+ This should be a :class:`<a href="#ProductType">ProductType</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.product_type = <a href="#ProductType">ProductType</a>("Electronics > Video > Projectors")<br>
+ <br>
+.. attribute:: quantity<br>
+ <br>
+ The quantity of product available in stock.<br>
+ <br>
+ This should be a :class:`<a href="#Quantity">Quantity</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.quantity = <a href="#Quantity">Quantity</a>('100')<br>
+ <br>
+.. attribute:: shipping<br>
+ <br>
+ The shipping rules for the product.<br>
+ <br>
+ This should be a :class:`<a href="#Shipping">Shipping</a>` with the necessary rules embedded as<br>
+ elements, for example::<br>
+ <br>
+ shipping = <a href="#Shipping">Shipping</a>()<br>
+ shipping.shipping_price = <a href="#ShippingPrice">ShippingPrice</a>('10.00', unit='USD')<br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.shipping.append(shipping)<br>
+ <br>
+.. attribute:: shipping_weight<br>
+ <br>
+ The shipping weight for this product.<br>
+ <br>
+ This should be a :class:`<a href="#ShippingWeight">ShippingWeight</a>` element, including a unit parameter<br>
+ for the unit of weight, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.shipping_weight = <a href="#ShippingWeight">ShippingWeight</a>('10.45', unit='kg')<br>
+ <br>
+.. attribute:: size<br>
+ <br>
+ A list of the available sizes for this product.<br>
+ <br>
+ Each item in this list should be a :class:`<a href="#Size">Size</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.size.append(<a href="#Size">Size</a>('Small'))<br>
+ entry.size.append(<a href="#Size">Size</a>('Medium'))<br>
+ entry.size.append(<a href="#Size">Size</a>('Large'))<br>
+ <br>
+.. attribute:: target_country<br>
+ <br>
+ The target country for the product.<br>
+ <br>
+ This should be a :class:`<a href="#TargetCountry">TargetCountry</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.target_country = <a href="#TargetCountry">TargetCountry</a>('US')<br>
+ <br>
+.. attribute:: tax<br>
+ <br>
+ The tax rules for this product.<br>
+ <br>
+ This should be a :class:`<a href="#Tax">Tax</a>` element, with the tax rule elements embedded<br>
+ within, for example::<br>
+ <br>
+ tax = <a href="#Tax">Tax</a>()<br>
+ tax.tax_rate = <a href="#TaxRate">TaxRate</a>('17.5')<br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.tax.append(tax)<br>
+ <br>
+.. attribute:: year<br>
+ <br>
+ The year the product was created.<br>
+ <br>
+ This should be a :class:`<a href="#Year">Year</a>` element, for example::<br>
+ <br>
+ entry = <a href="#ProductEntry">ProductEntry</a>()<br>
+ entry.year = <a href="#Year">Year</a>('2001')<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ProductEntry">ProductEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ProductEntry-GetBatchErrors"><strong>GetBatchErrors</strong></a> = <a href="#ProductEntry-get_batch_errors">get_batch_errors</a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-get_batch_errors"><strong>get_batch_errors</strong></a>(self)</dt><dd><tt>Attempts to parse errors from atom:content element.<br>
+ <br>
+If the atom:content element is type application/vnd.google.gdata.error+xml,<br>
+then it will contain a gd:errors block.<br>
+ <br>
+Returns:<br>
+ If the type of the content element is not<br>
+ 'application/vnd.google.gdata.error+xml', or 0 or more than 1<br>
+ gd:errors elements are found within the <content type='app...'> block,<br>
+ then None is returned. Other wise, the gd:errors element parsed<br>
+ as a <a href="#ContentForShoppingErrors">ContentForShoppingErrors</a> object is returned.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>additional_image_link</strong> = [<class 'gdata.contentforshopping.data.AdditionalImageLink'>]</dl>
+
+<dl><dt><strong>attribute</strong> = [<class 'gdata.contentforshopping.data.Attribute'>]</dl>
+
+<dl><dt><strong>author</strong> = <class 'gdata.contentforshopping.data.Author'><dd><tt>scp:author element<br>
+ <br>
+Defines the author of the information, recommended for books.</tt></dl>
+
+<dl><dt><strong>availability</strong> = <class 'gdata.contentforshopping.data.Availability'><dd><tt>scp:availability element<br>
+ <br>
+The retailer's suggested label for product availability. Supported values<br>
+include: 'in stock', 'out of stock', 'limited availability',<br>
+ 'available for order', and 'preorder'.</tt></dl>
+
+<dl><dt><strong>brand</strong> = <class 'gdata.contentforshopping.data.Brand'><dd><tt>scp:brand element<br>
+ <br>
+The brand of the product</tt></dl>
+
+<dl><dt><strong>channel</strong> = <class 'gdata.contentforshopping.data.Channel'><dd><tt>sc:channel element<br>
+ <br>
+The channel for the product. Supported values are: 'online', 'local'</tt></dl>
+
+<dl><dt><strong>color</strong> = <class 'gdata.contentforshopping.data.Color'><dd><tt>scp:color element<br>
+ <br>
+The color of the product.</tt></dl>
+
+<dl><dt><strong>condition</strong> = <class 'gdata.contentforshopping.data.Condition'><dd><tt>scp:condition element<br>
+ <br>
+The condition of the product, one of "new", "used", "refurbished"</tt></dl>
+
+<dl><dt><strong>content_language</strong> = <class 'gdata.contentforshopping.data.ContentLanguage'><dd><tt>sc:content_language element<br>
+ <br>
+Language used in the item content for the product</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'gdata.contentforshopping.data.ProductControl'><dd><tt>app:control element<br>
+ <br>
+overridden to provide additional elements in the sc namespace.</tt></dl>
+
+<dl><dt><strong>edition</strong> = <class 'gdata.contentforshopping.data.Edition'><dd><tt>scp:edition element<br>
+ <br>
+The edition of the product. Recommended for products with multiple editions<br>
+such as collectors' editions etc, such as books.</tt></dl>
+
+<dl><dt><strong>energy_efficiency_class</strong> = <class 'gdata.contentforshopping.data.EnergyEfficiencyClass'><dd><tt>scp:energy_efficiency_class element<br>
+ <br>
+The item's energy efficiency class.</tt></dl>
+
+<dl><dt><strong>expiration_date</strong> = <class 'gdata.contentforshopping.data.ExpirationDate'><dd><tt>sc:expiration_date<br>
+ <br>
+This is the date when the product listing will expire. If omitted, this will<br>
+default to 30 days after the product was created.</tt></dl>
+
+<dl><dt><strong>feature</strong> = [<class 'gdata.contentforshopping.data.Feature'>]</dl>
+
+<dl><dt><strong>featured_product</strong> = <class 'gdata.contentforshopping.data.FeaturedProduct'><dd><tt>scp:featured_product element<br>
+ <br>
+Used to indicate that this item is a special, featured product; Supported<br>
+values are: "true", "false".</tt></dl>
+
+<dl><dt><strong>gender</strong> = <class 'gdata.contentforshopping.data.Gender'><dd><tt>scp:gender element<br>
+ <br>
+The gender for the item. Supported values are: 'unisex', 'female', 'male'<br>
+ <br>
+Note: This tag is required if the google product type is part of<br>
+ Apparel & Accessories.</tt></dl>
+
+<dl><dt><strong>genre</strong> = <class 'gdata.contentforshopping.data.Genre'><dd><tt>scp:genre element<br>
+ <br>
+Describes the genre of a product, eg "comedy". Strongly recommended for media.</tt></dl>
+
+<dl><dt><strong>google_product_category</strong> = <class 'gdata.contentforshopping.data.GoogleProductCategory'><dd><tt>scp:google_product_category element<br>
+ <br>
+The product's google category. The value must be one of the categories listed<br>
+in the Product type taxonomy, which can be found at<br>
+<a href="http://www.google.com/support/merchants/bin/answer.py?answer=160081">http://www.google.com/support/merchants/bin/answer.py?answer=160081</a>.<br>
+ <br>
+Note that & and > characters must be encoded as &amp; and &gt;</tt></dl>
+
+<dl><dt><strong>group</strong> = [<class 'gdata.contentforshopping.data.Group'>]</dl>
+
+<dl><dt><strong>gtin</strong> = <class 'gdata.contentforshopping.data.Gtin'><dd><tt>scp:gtin element<br>
+ <br>
+GTIN of the product (isbn/upc/ean)</tt></dl>
+
+<dl><dt><strong>identifier_exists</strong> = <class 'gdata.contentforshopping.data.IdentifierExists'><dd><tt>scp:identifier_exists element<br>
+ <br>
+Specify as true if the item has no manufacturer part number or<br>
+any other industry standard product identifier.</tt></dl>
+
+<dl><dt><strong>image_link</strong> = <class 'gdata.contentforshopping.data.ImageLink'><dd><tt>sc:image_link element<br>
+ <br>
+This is the URL of an associated image for a product. Please use full size<br>
+images (400x400 pixels or larger), not thumbnails.</tt></dl>
+
+<dl><dt><strong>item_group_id</strong> = <class 'gdata.contentforshopping.data.ItemGroupID'><dd><tt>scp:item_group_id element<br>
+ <br>
+The identifier for products with variants. This id is used to link items which<br>
+have different values for the fields:<br>
+ <br>
+ 'color', 'material', 'pattern', 'size'<br>
+ <br>
+but are the same item, for example a shirt with different sizes.<br>
+ <br>
+Note: This tag is required for all product variants.</tt></dl>
+
+<dl><dt><strong>manufacturer</strong> = <class 'gdata.contentforshopping.data.Manufacturer'><dd><tt>scp:manufacturer element<br>
+ <br>
+<a href="#Manufacturer">Manufacturer</a> of the product.</tt></dl>
+
+<dl><dt><strong>material</strong> = <class 'gdata.contentforshopping.data.Material'><dd><tt>scp:material element<br>
+ <br>
+The material the product is made of.</tt></dl>
+
+<dl><dt><strong>mpn</strong> = <class 'gdata.contentforshopping.data.Mpn'><dd><tt>scp:mpn element<br>
+ <br>
+<a href="#Manufacturer">Manufacturer</a>'s Part Number. A unique code determined by the manufacturer for<br>
+the product.</tt></dl>
+
+<dl><dt><strong>multipack</strong> = <class 'gdata.contentforshopping.data.Multipack'><dd><tt>scp:ultipack element<br>
+ <br>
+The number of products in a merchant-defined custom multipack</tt></dl>
+
+<dl><dt><strong>pattern</strong> = <class 'gdata.contentforshopping.data.Pattern'><dd><tt>scp:pattern element<br>
+ <br>
+The pattern of the product. (e.g. polka dots)</tt></dl>
+
+<dl><dt><strong>performance</strong> = <class 'gdata.contentforshopping.data.Performance'><dd><tt>sc:performance element<br>
+ <br>
+Container element for daily click data.</tt></dl>
+
+<dl><dt><strong>price</strong> = <class 'gdata.contentforshopping.data.Price'><dd><tt>scp:price element<br>
+ <br>
+The price of the product. The unit attribute must be set, and should represent<br>
+the currency.<br>
+ <br>
+Note: Required Element</tt></dl>
+
+<dl><dt><strong>product_id</strong> = <class 'gdata.contentforshopping.data.ProductId'><dd><tt>sc:id element<br>
+ <br>
+It is required that all inserted products are provided with a unique<br>
+alphanumeric ID, in this element.</tt></dl>
+
+<dl><dt><strong>product_type</strong> = <class 'gdata.contentforshopping.data.ProductType'><dd><tt>scp:product_type element<br>
+ <br>
+Describes the type of product. A taxonomy of available product types is<br>
+listed at <a href="http://www.google.com/basepages/producttype/taxonomy.txt">http://www.google.com/basepages/producttype/taxonomy.txt</a> and the<br>
+entire line in the taxonomy should be included, for example "Electronics ><br>
+Video > Projectors".</tt></dl>
+
+<dl><dt><strong>quantity</strong> = <class 'gdata.contentforshopping.data.Quantity'><dd><tt>scp:quantity element<br>
+ <br>
+The number of items available. A value of 0 indicates items that are<br>
+currently out of stock.</tt></dl>
+
+<dl><dt><strong>shipping</strong> = [<class 'gdata.contentforshopping.data.Shipping'>]</dl>
+
+<dl><dt><strong>shipping_weight</strong> = <class 'gdata.contentforshopping.data.ShippingWeight'><dd><tt>scp:shipping_weight element<br>
+ <br>
+The shipping weight of a product. Requires a value and a unit using the unit<br>
+attribute. Valid units include lb, pound, oz, ounce, g, gram, kg, kilogram.</tt></dl>
+
+<dl><dt><strong>size</strong> = [<class 'gdata.contentforshopping.data.Size'>]</dl>
+
+<dl><dt><strong>target_country</strong> = <class 'gdata.contentforshopping.data.TargetCountry'><dd><tt>sc:target_country element<br>
+ <br>
+The target country of the product</tt></dl>
+
+<dl><dt><strong>tax</strong> = [<class 'gdata.contentforshopping.data.Tax'>]</dl>
+
+<dl><dt><strong>unit_pricing_base_measure</strong> = <class 'gdata.contentforshopping.data.UnitPricingBaseMeasure'><dd><tt>scp:unit_pricing_base_measure element<br>
+ <br>
+Your preference of the denominator of the unit price.</tt></dl>
+
+<dl><dt><strong>unit_pricing_measure</strong> = <class 'gdata.contentforshopping.data.UnitPricingMeasure'><dd><tt>scp:unit_pricing_measure element<br>
+ <br>
+The dimension by which the item is sold.</tt></dl>
+
+<dl><dt><strong>year</strong> = <class 'gdata.contentforshopping.data.Year'><dd><tt>scp:year element<br>
+ <br>
+The year the product was produced. Expects four digits</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="ProductEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ProductEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ProductEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ProductEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ProductEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ProductEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProductFeed">class <strong>ProductFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of a merchant's products.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ProductFeed">ProductFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ProductFeed-GetStartToken"><strong>GetStartToken</strong></a> = <a href="#ProductFeed-get_start_token">get_start_token</a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_start_token"><strong>get_start_token</strong></a>(self)</dt><dd><tt>Attempts to parse start-token from rel="next" link.<br>
+ <br>
+A products feed may contain a rel="next" atom:link and the<br>
+href contained in the link may have a start-token query parameter.<br>
+ <br>
+Returns:<br>
+ If there is no rel="next" link or the rel="next" link doesn't contain<br>
+ the start-token query parameter, None is returned. Otherwise, the<br>
+ string value of the start-token query parameter is returned.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.contentforshopping.data.ProductEntry'>]</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.contentforshopping.data.ItemsPerPage'></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.contentforshopping.data.StartIndex'></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.contentforshopping.data.TotalResults'></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="ProductFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ProductFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ProductFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ProductFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ProductFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ProductFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ProductFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProductId">class <strong>ProductId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:id element<br>
+ <br>
+It is required that all inserted products are provided with a unique<br>
+alphanumeric ID, in this element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ProductId">ProductId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ProductId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ProductId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProductId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProductType">class <strong>ProductType</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:product_type element<br>
+ <br>
+Describes the type of product. A taxonomy of available product types is<br>
+listed at <a href="http://www.google.com/basepages/producttype/taxonomy.txt">http://www.google.com/basepages/producttype/taxonomy.txt</a> and the<br>
+entire line in the taxonomy should be included, for example "Electronics ><br>
+Video > Projectors".<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ProductType">ProductType</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ProductType-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductType-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductType-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductType-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductType-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ProductType-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProductType-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductType-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductType-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductType-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Quantity">class <strong>Quantity</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:quantity element<br>
+ <br>
+The number of items available. A value of 0 indicates items that are<br>
+currently out of stock.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Quantity">Quantity</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Quantity-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Quantity-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Quantity-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Quantity-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Quantity-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Quantity-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Quantity-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Quantity-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Quantity-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Quantity-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RequiredDestination">class <strong>RequiredDestination</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:required_destination element<br>
+ <br>
+This element defines the required destination for a product, namely<br>
+"ProductSearch", "ProductAds" or "CommerceSearch". It should be added to the<br>
+app:control element (<a href="#ProductEntry">ProductEntry</a>'s "control" attribute) to specify where the<br>
+product should appear in search APIs.<br>
+ <br>
+By default, when omitted, the api attempts to upload to as many destinations<br>
+as possible.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#RequiredDestination">RequiredDestination</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>dest</strong> = 'dest'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="RequiredDestination-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RequiredDestination-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RequiredDestination-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RequiredDestination-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RequiredDestination-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="RequiredDestination-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="RequiredDestination-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RequiredDestination-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RequiredDestination-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RequiredDestination-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ReviewsUrl">class <strong>ReviewsUrl</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:reviews_url element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ReviewsUrl">ReviewsUrl</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ReviewsUrl-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ReviewsUrl-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ReviewsUrl-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ReviewsUrl-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ReviewsUrl-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ReviewsUrl-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ReviewsUrl-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ReviewsUrl-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ReviewsUrl-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ReviewsUrl-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SalePrice">class <strong>SalePrice</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:sale_price element<br>
+ <br>
+The sale price of the product. The unit attribute must be set, and should<br>
+represent the currency.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#SalePrice">SalePrice</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>unit</strong> = 'unit'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SalePrice-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SalePrice-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SalePrice-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SalePrice-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SalePrice-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SalePrice-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SalePrice-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SalePrice-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SalePrice-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SalePrice-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SalePriceEffectiveDate">class <strong>SalePriceEffectiveDate</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:sale_price_effective_date element<br>
+ <br>
+The effective date of the sale price of the product.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#SalePriceEffectiveDate">SalePriceEffectiveDate</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SalePriceEffectiveDate-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SalePriceEffectiveDate-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SalePriceEffectiveDate-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SalePriceEffectiveDate-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SalePriceEffectiveDate-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SalePriceEffectiveDate-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SalePriceEffectiveDate-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SalePriceEffectiveDate-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SalePriceEffectiveDate-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SalePriceEffectiveDate-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Shipping">class <strong>Shipping</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:shipping element<br>
+ <br>
+Container for the shipping rules as provided by the shipping_country,<br>
+shipping_price, shipping_region and shipping_service tags.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Shipping">Shipping</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>shipping_country</strong> = <class 'gdata.contentforshopping.data.ShippingCountry'><dd><tt>scp:shipping_country element<br>
+ <br>
+The two-letter ISO 3166 country code for the country to which an item will<br>
+ship.<br>
+ <br>
+This element should be placed inside the scp:shipping element.</tt></dl>
+
+<dl><dt><strong>shipping_price</strong> = <class 'gdata.contentforshopping.data.ShippingPrice'><dd><tt>scp:shipping_price element<br>
+ <br>
+Fixed shipping price, represented as a number. Specify the currency as the<br>
+"unit" attribute".<br>
+ <br>
+This element should be placed inside the scp:shipping element.</tt></dl>
+
+<dl><dt><strong>shipping_region</strong> = <class 'gdata.contentforshopping.data.ShippingRegion'><dd><tt>scp:shipping_region element<br>
+ <br>
+The geographic region to which a shipping rate applies, e.g., in the US, the<br>
+two-letter state abbreviation, ZIP code, or ZIP code range using * wildcard.<br>
+ <br>
+This element should be placed inside the scp:shipping element.</tt></dl>
+
+<dl><dt><strong>shipping_service</strong> = <class 'gdata.contentforshopping.data.ShippingService'><dd><tt>scp:shipping_service element<br>
+ <br>
+A free-form description of the service class or delivery speed.<br>
+ <br>
+This element should be placed inside the scp:shipping element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Shipping-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Shipping-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Shipping-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Shipping-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Shipping-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Shipping-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Shipping-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Shipping-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Shipping-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Shipping-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ShippingCountry">class <strong>ShippingCountry</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:shipping_country element<br>
+ <br>
+The two-letter ISO 3166 country code for the country to which an item will<br>
+ship.<br>
+ <br>
+This element should be placed inside the scp:shipping element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ShippingCountry">ShippingCountry</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ShippingCountry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingCountry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingCountry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ShippingCountry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingCountry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ShippingCountry-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ShippingCountry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ShippingCountry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ShippingCountry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingCountry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ShippingPrice">class <strong>ShippingPrice</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:shipping_price element<br>
+ <br>
+Fixed shipping price, represented as a number. Specify the currency as the<br>
+"unit" attribute".<br>
+ <br>
+This element should be placed inside the scp:shipping element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ShippingPrice">ShippingPrice</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>unit</strong> = 'unit'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ShippingPrice-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingPrice-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingPrice-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ShippingPrice-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingPrice-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ShippingPrice-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ShippingPrice-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ShippingPrice-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ShippingPrice-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingPrice-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ShippingRegion">class <strong>ShippingRegion</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:shipping_region element<br>
+ <br>
+The geographic region to which a shipping rate applies, e.g., in the US, the<br>
+two-letter state abbreviation, ZIP code, or ZIP code range using * wildcard.<br>
+ <br>
+This element should be placed inside the scp:shipping element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ShippingRegion">ShippingRegion</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ShippingRegion-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingRegion-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingRegion-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ShippingRegion-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingRegion-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ShippingRegion-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ShippingRegion-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ShippingRegion-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ShippingRegion-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingRegion-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ShippingService">class <strong>ShippingService</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:shipping_service element<br>
+ <br>
+A free-form description of the service class or delivery speed.<br>
+ <br>
+This element should be placed inside the scp:shipping element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ShippingService">ShippingService</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ShippingService-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingService-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingService-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ShippingService-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingService-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ShippingService-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ShippingService-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ShippingService-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ShippingService-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingService-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ShippingWeight">class <strong>ShippingWeight</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:shipping_weight element<br>
+ <br>
+The shipping weight of a product. Requires a value and a unit using the unit<br>
+attribute. Valid units include lb, pound, oz, ounce, g, gram, kg, kilogram.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ShippingWeight">ShippingWeight</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>unit</strong> = 'unit'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ShippingWeight-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingWeight-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingWeight-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ShippingWeight-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingWeight-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ShippingWeight-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ShippingWeight-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ShippingWeight-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ShippingWeight-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ShippingWeight-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Size">class <strong>Size</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:size element<br>
+ <br>
+Available sizes of an item. Appropriate values include: "small", "medium",<br>
+"large", etc. The product enttry may contain multiple sizes, to indicate the<br>
+available sizes.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Size">Size</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Size-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Size-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Size-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Size-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Size-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Size-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Size-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Size-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Size-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Size-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="StartIndex">class <strong>StartIndex</strong></a>(<a href="gdata.data.html#StartIndex">gdata.data.StartIndex</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#StartIndex">StartIndex</a></dd>
+<dd><a href="gdata.data.html#StartIndex">gdata.data.StartIndex</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="StartIndex-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="StartIndex-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="StartIndex-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Status">class <strong>Status</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:status element<br>
+ <br>
+This element defines the status of an element in a particular destination. It<br>
+has a destination and an actual status such as enlisted, review, or<br>
+disapproved.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Status">Status</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>dest</strong> = 'dest'</dl>
+
+<dl><dt><strong>status</strong> = 'status'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Status-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Status-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Status-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Status-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Status-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Status-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SubmittedValue">class <strong>SubmittedValue</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:submitted_value element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#SubmittedValue">SubmittedValue</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SubmittedValue-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubmittedValue-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubmittedValue-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SubmittedValue-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubmittedValue-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SubmittedValue-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SubmittedValue-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubmittedValue-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SubmittedValue-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubmittedValue-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TargetCountry">class <strong>TargetCountry</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:target_country element<br>
+ <br>
+The target country of the product<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#TargetCountry">TargetCountry</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TargetCountry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TargetCountry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TargetCountry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TargetCountry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TargetCountry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TargetCountry-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TargetCountry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TargetCountry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TargetCountry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TargetCountry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Tax">class <strong>Tax</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:tax element<br>
+ <br>
+Container for the tax rules for this product. Containing the tax_rate,<br>
+tax_country, tax_region, and tax_ship elements<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Tax">Tax</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>tax_country</strong> = <class 'gdata.contentforshopping.data.TaxCountry'><dd><tt>scp:tax_country element<br>
+ <br>
+The country an item is taxed in (as a two-letter ISO 3166 country code).<br>
+ <br>
+This element should be placed inside the scp:tax (<a href="#Tax">Tax</a> class) element.</tt></dl>
+
+<dl><dt><strong>tax_rate</strong> = <class 'gdata.contentforshopping.data.TaxRate'><dd><tt>scp:tax_rate element<br>
+ <br>
+The tax rate as a percent of the item price, i.e., number, as a percentage.<br>
+ <br>
+This element should be placed inside the scp:tax (<a href="#Tax">Tax</a> class) element.</tt></dl>
+
+<dl><dt><strong>tax_region</strong> = <class 'gdata.contentforshopping.data.TaxRegion'><dd><tt>scp:tax_region element<br>
+ <br>
+The geographic region that a tax rate applies to, e.g., in the US, the<br>
+two-letter state abbreviation, ZIP code, or ZIP code range using * wildcard.<br>
+ <br>
+This element should be placed inside the scp:tax (<a href="#Tax">Tax</a> class) element.</tt></dl>
+
+<dl><dt><strong>tax_ship</strong> = <class 'gdata.contentforshopping.data.TaxShip'><dd><tt>scp:tax_ship element<br>
+ <br>
+Whether tax is charged on shipping for this product. The default value is<br>
+"false".<br>
+ <br>
+This element should be placed inside the scp:tax (<a href="#Tax">Tax</a> class) element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Tax-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Tax-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Tax-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Tax-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Tax-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Tax-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Tax-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Tax-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Tax-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Tax-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TaxCountry">class <strong>TaxCountry</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:tax_country element<br>
+ <br>
+The country an item is taxed in (as a two-letter ISO 3166 country code).<br>
+ <br>
+This element should be placed inside the scp:tax (<a href="#Tax">Tax</a> class) element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#TaxCountry">TaxCountry</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TaxCountry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxCountry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxCountry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TaxCountry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxCountry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TaxCountry-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TaxCountry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TaxCountry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TaxCountry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxCountry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TaxRate">class <strong>TaxRate</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:tax_rate element<br>
+ <br>
+The tax rate as a percent of the item price, i.e., number, as a percentage.<br>
+ <br>
+This element should be placed inside the scp:tax (<a href="#Tax">Tax</a> class) element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#TaxRate">TaxRate</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TaxRate-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxRate-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxRate-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TaxRate-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxRate-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TaxRate-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TaxRate-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TaxRate-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TaxRate-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxRate-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TaxRegion">class <strong>TaxRegion</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:tax_region element<br>
+ <br>
+The geographic region that a tax rate applies to, e.g., in the US, the<br>
+two-letter state abbreviation, ZIP code, or ZIP code range using * wildcard.<br>
+ <br>
+This element should be placed inside the scp:tax (<a href="#Tax">Tax</a> class) element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#TaxRegion">TaxRegion</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TaxRegion-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxRegion-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxRegion-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TaxRegion-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxRegion-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TaxRegion-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TaxRegion-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TaxRegion-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TaxRegion-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxRegion-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TaxShip">class <strong>TaxShip</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:tax_ship element<br>
+ <br>
+Whether tax is charged on shipping for this product. The default value is<br>
+"false".<br>
+ <br>
+This element should be placed inside the scp:tax (<a href="#Tax">Tax</a> class) element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#TaxShip">TaxShip</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TaxShip-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxShip-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxShip-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TaxShip-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxShip-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TaxShip-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TaxShip-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TaxShip-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TaxShip-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TaxShip-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TotalResults">class <strong>TotalResults</strong></a>(<a href="gdata.data.html#TotalResults">gdata.data.TotalResults</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt># opensearch needs overriding for wrong version<br>
+# see <a href="http://code.google.com/p/gdata-python-client/issues/detail?id=483">http://code.google.com/p/gdata-python-client/issues/detail?id=483</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#TotalResults">TotalResults</a></dd>
+<dd><a href="gdata.data.html#TotalResults">gdata.data.TotalResults</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TotalResults-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TotalResults-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TotalResults-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UnitPricingBaseMeasure">class <strong>UnitPricingBaseMeasure</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:unit_pricing_base_measure element<br>
+ <br>
+Your preference of the denominator of the unit price.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#UnitPricingBaseMeasure">UnitPricingBaseMeasure</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>unit</strong> = 'unit'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UnitPricingBaseMeasure-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingBaseMeasure-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingBaseMeasure-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingBaseMeasure-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingBaseMeasure-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingBaseMeasure-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="UnitPricingBaseMeasure-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UnitPricingBaseMeasure-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingBaseMeasure-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingBaseMeasure-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UnitPricingMeasure">class <strong>UnitPricingMeasure</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:unit_pricing_measure element<br>
+ <br>
+The dimension by which the item is sold.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#UnitPricingMeasure">UnitPricingMeasure</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>unit</strong> = 'unit'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UnitPricingMeasure-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingMeasure-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingMeasure-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingMeasure-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingMeasure-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingMeasure-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="UnitPricingMeasure-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UnitPricingMeasure-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingMeasure-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UnitPricingMeasure-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UseQuotedFields">class <strong>UseQuotedFields</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:use_quoted_fields element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#UseQuotedFields">UseQuotedFields</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UseQuotedFields-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UseQuotedFields-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UseQuotedFields-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UseQuotedFields-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UseQuotedFields-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UseQuotedFields-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="UseQuotedFields-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UseQuotedFields-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UseQuotedFields-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UseQuotedFields-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UsersEntry">class <strong>UsersEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A User Management Feed entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#UsersEntry">UsersEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>admin</strong> = <class 'gdata.contentforshopping.data.Admin'><dd><tt>sc:admin element</tt></dl>
+
+<dl><dt><strong>permission</strong> = [<class 'gdata.contentforshopping.data.Permission'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="UsersEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="UsersEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UsersEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="UsersEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="UsersEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UsersEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UsersFeed">class <strong>UsersFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A User Management Feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#UsersFeed">UsersFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.contentforshopping.data.UsersEntry'>]</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.contentforshopping.data.ItemsPerPage'></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.contentforshopping.data.StartIndex'></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.contentforshopping.data.TotalResults'></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="UsersFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="UsersFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UsersFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="UsersFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="UsersFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UsersFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UsersFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ValidateDestination">class <strong>ValidateDestination</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:validate_destination element<br>
+ <br>
+This element defines the validate destination for a product, namely<br>
+"ProductSearch", "ProductAds" or "CommerceSearch". It should be added to the<br>
+app:control element (<a href="#ProductEntry">ProductEntry</a>'s "control" attribute) to specify which the<br>
+destinations you would like error info for.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ValidateDestination">ValidateDestination</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>dest</strong> = 'dest'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ValidateDestination-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ValidateDestination-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ValidateDestination-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ValidateDestination-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ValidateDestination-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ValidateDestination-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ValidateDestination-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ValidateDestination-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ValidateDestination-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ValidateDestination-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ValueOnLandingPage">class <strong>ValueOnLandingPage</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:value_on_landing_page element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#ValueOnLandingPage">ValueOnLandingPage</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ValueOnLandingPage-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ValueOnLandingPage-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ValueOnLandingPage-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ValueOnLandingPage-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ValueOnLandingPage-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ValueOnLandingPage-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ValueOnLandingPage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ValueOnLandingPage-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ValueOnLandingPage-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ValueOnLandingPage-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WarningElement">class <strong>WarningElement</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:warning element<br>
+ <br>
+Container element for an individual warning.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#WarningElement">WarningElement</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>code</strong> = <class 'gdata.contentforshopping.data.Code'><dd><tt>sc:code element<br>
+ <br>
+The warning code. Currently validation/missing_recommended is the<br>
+only code used.</tt></dl>
+
+<dl><dt><strong>domain</strong> = <class 'gdata.contentforshopping.data.Domain'><dd><tt>sc:domain element<br>
+ <br>
+The scope of the warning. A comma-separated list of destinations,<br>
+for example: ProductSearch.</tt></dl>
+
+<dl><dt><strong>location</strong> = <class 'gdata.contentforshopping.data.Location'><dd><tt>sc:location element<br>
+ <br>
+The name of the product element that has raised the warning. This may be<br>
+any valid product element.</tt></dl>
+
+<dl><dt><strong>message</strong> = <class 'gdata.contentforshopping.data.Message'><dd><tt>sc:message element<br>
+ <br>
+A plain text description of the warning.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="WarningElement-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WarningElement-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WarningElement-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WarningElement-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WarningElement-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="WarningElement-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="WarningElement-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WarningElement-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WarningElement-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WarningElement-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Warnings">class <strong>Warnings</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>sc:warnings element<br>
+ <br>
+Container element for the list of warnings.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Warnings">Warnings</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>warnings</strong> = [<class 'gdata.contentforshopping.data.WarningElement'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Warnings-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Warnings-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Warnings-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Warnings-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Warnings-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Warnings-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Warnings-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Warnings-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Warnings-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Warnings-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Year">class <strong>Year</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>scp:year element<br>
+ <br>
+The year the product was produced. Expects four digits<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.contentforshopping.data.html#Year">Year</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Year-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Year-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Year-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Year-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Year-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Year-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Year-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Year-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Year-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Year-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ATOM_NAMESPACE</strong> = 'http://www.w3.org/2005/Atom'<br>
+<strong>GD_NAMESPACE</strong> = 'http://schemas.google.com/g/2005'<br>
+<strong>GD_NAMESPACE_TEMPLATE</strong> = '{http://schemas.google.com/g/2005}%s'<br>
+<strong>SCP_NAMESPACE_TEMPLATE</strong> = '{http://schemas.google.com/structuredcontent/2009/products}%s'<br>
+<strong>SC_NAMESPACE_TEMPLATE</strong> = '{http://schemas.google.com/structuredcontent/2009}%s'<br>
+<strong>__author__</strong> = 'afshar (Ali Afshar), dhermes (Daniel Hermes)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">afshar (Ali Afshar), dhermes (Daniel Hermes)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.contentforshopping.html b/pydocs/gdata.contentforshopping.html
new file mode 100644
index 0000000..2200a20
--- /dev/null
+++ b/pydocs/gdata.contentforshopping.html
@@ -0,0 +1,25 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.contentforshopping</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.contentforshopping</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contentforshopping/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/contentforshopping/__init__.py</a></font></td></tr></table>
+ <p><tt>Support for the Content API for Shopping<br>
+ <br>
+See: <a href="http://code.google.com/apis/shopping/content/index.html">http://code.google.com/apis/shopping/content/index.html</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.contentforshopping.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.contentforshopping.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.core.html b/pydocs/gdata.core.html
new file mode 100644
index 0000000..495b1f1
--- /dev/null
+++ b/pydocs/gdata.core.html
@@ -0,0 +1,184 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.core</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.core</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/core.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/core.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2010 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="simplejson.html">simplejson</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.core.html#Jsonc">Jsonc</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Jsonc">class <strong>Jsonc</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents JSON-C data in an easy to access <a href="__builtin__.html#object">object</a> format.<br>
+ <br>
+To access the members of a JSON structure which looks like this:<br>
+{<br>
+ "data": {<br>
+ "totalItems": 800,<br>
+ "items": [<br>
+ {<br>
+ "content": {<br>
+ "1": "rtsp://v5.cache3.c.youtube.com/CiILENy.../0/0/0/video.3gp"<br>
+ },<br>
+ "viewCount": 220101,<br>
+ "commentCount": 22,<br>
+ "favoriteCount": 201<br>
+ }<br>
+ ]<br>
+ },<br>
+ "apiVersion": "2.0"<br>
+}<br>
+ <br>
+You would do the following:<br>
+x = gdata.core.<a href="#-parse_json">parse_json</a>(the_above_string)<br>
+# Gives you 800<br>
+x.data.total_items<br>
+# Should be 22<br>
+x.data.items[0].comment_count<br>
+# The apiVersion is '2.0'<br>
+x.api_version<br>
+ <br>
+To create a <a href="#Jsonc">Jsonc</a> <a href="__builtin__.html#object">object</a> which would produce the above JSON, you would do:<br>
+gdata.core.<a href="#Jsonc">Jsonc</a>(<br>
+ api_version='2.0',<br>
+ data=gdata.core.<a href="#Jsonc">Jsonc</a>(<br>
+ total_items=800,<br>
+ items=[<br>
+ gdata.core.<a href="#Jsonc">Jsonc</a>(<br>
+ view_count=220101,<br>
+ comment_count=22,<br>
+ favorite_count=201,<br>
+ content={<br>
+ '1': ('rtsp://v5.cache3.c.youtube.com'<br>
+ '/CiILENy.../0/0/0/video.3gp')})]))<br>
+or<br>
+x = gdata.core.<a href="#Jsonc">Jsonc</a>()<br>
+x.api_version = '2.0'<br>
+x.data = gdata.core.<a href="#Jsonc">Jsonc</a>()<br>
+x.data.total_items = 800<br>
+x.data.items = []<br>
+# etc.<br>
+ <br>
+How it works:<br>
+The JSON-C data is stored in an internal dictionary (._dict) and the<br>
+getattr, setattr, and delattr methods rewrite the name which you provide<br>
+to mirror the expected format in JSON-C. (For more details on name<br>
+conversion see _to_jsonc_name.) You may also access members using<br>
+getitem, setitem, delitem as you would for a dictionary. For example<br>
+x.data.total_items is equivalent to x['data']['totalItems']<br>
+(Not all dict methods are supported so if you need something other than<br>
+the item operations, then you will want to use the ._dict member).<br>
+ <br>
+You may need to use getitem or the _dict member to access certain<br>
+properties in cases where the JSON-C syntax does not map neatly to Python<br>
+objects. For example the YouTube Video feed has some JSON like this:<br>
+"content": {"1": "rtsp://v5.cache3.c.youtube.com..."...}<br>
+You cannot do x.content.1 in Python, so you would use the getitem as<br>
+follows:<br>
+x.content['1']<br>
+or you could use the _dict member as follows:<br>
+x.content._dict['1']<br>
+ <br>
+If you need to create a new <a href="__builtin__.html#object">object</a> with such a mapping you could use.<br>
+ <br>
+x.content = gdata.core.<a href="#Jsonc">Jsonc</a>(_dict={'1': 'rtsp://cache3.c.youtube.com...'})<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Jsonc-__delattr__"><strong>__delattr__</strong></a>(self, name)</dt></dl>
+
+<dl><dt><a name="Jsonc-__delitem__"><strong>__delitem__</strong></a>(self, key)</dt></dl>
+
+<dl><dt><a name="Jsonc-__getattr__"><strong>__getattr__</strong></a>(self, name)</dt></dl>
+
+<dl><dt><a name="Jsonc-__getitem__"><strong>__getitem__</strong></a>(self, key)</dt><dd><tt># For container methods pass-through to the underlying dict.</tt></dd></dl>
+
+<dl><dt><a name="Jsonc-__init__"><strong>__init__</strong></a>(self, _dict<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="Jsonc-__setattr__"><strong>__setattr__</strong></a>(self, name, value)</dt></dl>
+
+<dl><dt><a name="Jsonc-__setitem__"><strong>__setitem__</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-jsonc_to_string"><strong>jsonc_to_string</strong></a>(jsonc_obj)</dt><dd><tt>Converts a <a href="#Jsonc">Jsonc</a> <a href="__builtin__.html#object">object</a> into a string of JSON-C.</tt></dd></dl>
+ <dl><dt><a name="-parse_json"><strong>parse_json</strong></a>(json_string)</dt><dd><tt>Converts a JSON-C string into a <a href="#Jsonc">Jsonc</a> <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+Args:<br>
+ json_string: str or unicode The JSON to be parsed.<br>
+ <br>
+Returns:<br>
+ A new <a href="#Jsonc">Jsonc</a> <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+ <dl><dt><a name="-parse_json_file"><strong>parse_json_file</strong></a>(json_file)</dt></dl>
+ <dl><dt><a name="-prettify_jsonc"><strong>prettify_jsonc</strong></a>(jsonc_obj, indentation<font color="#909090">=2</font>)</dt><dd><tt>Converts a <a href="#Jsonc">Jsonc</a> <a href="__builtin__.html#object">object</a> to a pretified (intented) JSON string.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.data.html b/pydocs/gdata.data.html
new file mode 100644
index 0000000..9ffee2c
--- /dev/null
+++ b/pydocs/gdata.data.html
@@ -0,0 +1,10839 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/data.py</a></font></td></tr></table>
+ <p><tt>Provides classes and constants for the XML in the Google Data namespace.<br>
+ <br>
+Documentation for the raw XML which these classes represent can be found here:<br>
+<a href="http://code.google.com/apis/gdata/docs/2.0/elements.html">http://code.google.com/apis/gdata/docs/2.0/elements.html</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#MediaSource">MediaSource</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#AdditionalName">AdditionalName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Agent">Agent</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#AttendeeStatus">AttendeeStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#AttendeeType">AttendeeType</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#BatchId">BatchId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#BatchInterrupted">BatchInterrupted</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#BatchOperation">BatchOperation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#BatchStatus">BatchStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#City">City</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Comments">Comments</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Country">Country</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Deleted">Deleted</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#EmailImParent">EmailImParent</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#Email">Email</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Im">Im</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#EntryLink">EntryLink</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#EventStatus">EventStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#ExtendedProperty">ExtendedProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#FamilyName">FamilyName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#FeedLink">FeedLink</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#FormattedAddress">FormattedAddress</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#FullName">FullName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#GivenName">GivenName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#HouseName">HouseName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#ItemsPerPage">ItemsPerPage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Money">Money</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Name">Name</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#NamePrefix">NamePrefix</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#NameSuffix">NameSuffix</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Neighborhood">Neighborhood</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#OrgDepartment">OrgDepartment</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#OrgJobDescription">OrgJobDescription</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#OrgName">OrgName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#OrgSymbol">OrgSymbol</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#OrgTitle">OrgTitle</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Organization">Organization</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#OriginalEvent">OriginalEvent</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#PhoneNumber">PhoneNumber</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#PoBox">PoBox</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#PostalAddress">PostalAddress</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Postcode">Postcode</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Rating">Rating</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Recurrence">Recurrence</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#RecurrenceException">RecurrenceException</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Region">Region</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Reminder">Reminder</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#StartIndex">StartIndex</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Street">Street</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#StructuredPostalAddress">StructuredPostalAddress</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Subregion">Subregion</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#TotalResults">TotalResults</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Transparency">Transparency</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Visibility">Visibility</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#When">When</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Where">Where</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.data.html#Who">Who</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Entry">atom.data.Entry</a>(<a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchEntry">BatchEntry</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Feed">atom.data.Feed</a>(<a href="atom.data.html#Source">atom.data.Source</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchFeed">BatchFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#LinkFinder">LinkFinder</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchEntry">BatchEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchFeed">BatchFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#MissingRequiredParameters">MissingRequiredParameters</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AdditionalName">class <strong>AdditionalName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:additionalName element.<br>
+ <br>
+Specifies additional (eg. middle) name of the person.<br>
+Contains an attribute for the phonetic representaton of the name.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#AdditionalName">AdditionalName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>yomi</strong> = 'yomi'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AdditionalName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AdditionalName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AdditionalName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Agent">class <strong>Agent</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:agent element.<br>
+ <br>
+The agent who actually receives the mail. Used in work addresses.<br>
+Also for 'in care of' or 'c/o'.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Agent">Agent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Agent-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Agent-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Agent-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Agent-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Agent-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Agent-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Agent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Agent-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Agent-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Agent-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AttendeeStatus">class <strong>AttendeeStatus</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:attendeeStatus element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#AttendeeStatus">AttendeeStatus</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AttendeeStatus-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeStatus-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeStatus-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeStatus-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeStatus-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeStatus-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AttendeeStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AttendeeStatus-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeStatus-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeStatus-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AttendeeType">class <strong>AttendeeType</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:attendeeType element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#AttendeeType">AttendeeType</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AttendeeType-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeType-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeType-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeType-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeType-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeType-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AttendeeType-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AttendeeType-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeType-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AttendeeType-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchEntry">class <strong>BatchEntry</strong></a>(<a href="gdata.data.html#GDEntry">GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An atom:entry for use in batch requests.<br>
+ <br>
+The <a href="#BatchEntry">BatchEntry</a> contains additional members to specify the operation to be<br>
+performed on this entry and a batch ID so that the server can reference<br>
+individual operations in the response feed. For more information, see:<br>
+<a href="http://code.google.com/apis/gdata/batch.html">http://code.google.com/apis/gdata/batch.html</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#BatchEntry">BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+<a href="atom.data.html#Entry">Entry</a> operation has a corresponding <a href="atom.data.html#Entry">Entry</a> in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">GDEntry</a>:<br>
+<dl><dt><a name="BatchEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="BatchEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BatchEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="BatchEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="BatchEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchFeed">class <strong>BatchFeed</strong></a>(<a href="gdata.data.html#GDFeed">GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing a list of batch request entries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#BatchFeed">BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BatchFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = <a href="#BatchFeed-add_batch_entry">add_batch_entry</a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BatchFeed-AddDelete"><strong>AddDelete</strong></a> = <a href="#BatchFeed-add_delete">add_delete</a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BatchFeed-AddInsert"><strong>AddInsert</strong></a> = <a href="#BatchFeed-add_insert">add_insert</a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BatchFeed-AddQuery"><strong>AddQuery</strong></a> = <a href="#BatchFeed-add_query">add_query</a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BatchFeed-AddUpdate"><strong>AddUpdate</strong></a> = <a href="#BatchFeed-add_update">add_update</a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BatchFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = <a href="#BatchFeed-find_batch_link">find_batch_link</a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="#BatchEntry">BatchEntry</a>, it is converted to a <a href="#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="#BatchEntry">BatchEntry</a>, atom.data.<a href="atom.data.html#Entry">Entry</a>, or another <a href="atom.data.html#Entry">Entry</a> flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ <a href="#MissingRequiredParameters">MissingRequiredParameters</a>: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ <a href="#MissingRequiredParameters">MissingRequiredParameters</a>: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="#BatchEntry">BatchEntry</a>, and you may pass in the <a href="#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ <a href="#MissingRequiredParameters">MissingRequiredParameters</a></tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.data.BatchEntry'>]</dl>
+
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">GDFeed</a>:<br>
+<dl><dt><a name="BatchFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:<a href="#TotalResults">TotalResults</a> for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="BatchFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BatchFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="BatchFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="BatchFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchId">class <strong>BatchId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Identifies a single operation in a batch request.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#BatchId">BatchId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BatchId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="BatchId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchInterrupted">class <strong>BatchInterrupted</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#BatchInterrupted">BatchInterrupted</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>failures</strong> = 'failures'</dl>
+
+<dl><dt><strong>parsed</strong> = 'parsed'</dl>
+
+<dl><dt><strong>reason</strong> = 'reason'</dl>
+
+<dl><dt><strong>success</strong> = 'success'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BatchInterrupted-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchInterrupted-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchInterrupted-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchInterrupted-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchInterrupted-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchInterrupted-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="BatchInterrupted-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchInterrupted-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchInterrupted-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchInterrupted-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchOperation">class <strong>BatchOperation</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The CRUD operation which this batch entry represents.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#BatchOperation">BatchOperation</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BatchOperation-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchOperation-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchOperation-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchOperation-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchOperation-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchOperation-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="BatchOperation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchOperation-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchOperation-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchOperation-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchStatus">class <strong>BatchStatus</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+<a href="atom.data.html#Entry">Entry</a> operation has a corresponding <a href="atom.data.html#Entry">Entry</a> in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#BatchStatus">BatchStatus</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>code</strong> = 'code'</dl>
+
+<dl><dt><strong>content_type</strong> = 'content-type'</dl>
+
+<dl><dt><strong>reason</strong> = 'reason'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BatchStatus-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchStatus-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchStatus-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchStatus-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchStatus-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchStatus-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="BatchStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchStatus-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BatchStatus-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BatchStatus-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="City">class <strong>City</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:city element.<br>
+ <br>
+Can be city, village, town, borough, etc. This is the postal town and<br>
+not necessarily the place of residence or place of business.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#City">City</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="City-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="City-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="City-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="City-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="City-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="City-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="City-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="City-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="City-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="City-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Comments">class <strong>Comments</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:comments element.<br>
+ <br>
+Contains a comments feed for the enclosing entry (such as a calendar event).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Comments">Comments</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>feed_link</strong> = <class 'gdata.data.FeedLink'><dd><tt>The gd:feedLink element.<br>
+ <br>
+Represents a logically nested feed. For example, a calendar feed might<br>
+have a nested feed representing all comments on entries.</tt></dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Comments-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Comments-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Comments-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Comments-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Comments-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Comments-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Comments-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Comments-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Comments-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Comments-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Country">class <strong>Country</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:country element.<br>
+ <br>
+The name or code of the country.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Country">Country</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Country-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Country-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Country-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Country-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Country-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Country-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Country-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Country-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Country-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Country-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Deleted">class <strong>Deleted</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>gd:deleted when present, indicates the containing entry is deleted.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Deleted">Deleted</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Deleted-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Deleted-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Deleted-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Email">class <strong>Email</strong></a>(<a href="gdata.data.html#EmailImParent">EmailImParent</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:email element.<br>
+ <br>
+An email address associated with the containing entity (which is<br>
+usually an entity representing a person or a location).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Email">Email</a></dd>
+<dd><a href="gdata.data.html#EmailImParent">EmailImParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>display_name</strong> = 'displayName'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#EmailImParent">EmailImParent</a>:<br>
+<dl><dt><strong>address</strong> = 'address'</dl>
+
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>primary</strong> = 'primary'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Email-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Email-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Email-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Email-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Email-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Email-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Email-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Email-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Email-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Email-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EmailImParent">class <strong>EmailImParent</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#EmailImParent">EmailImParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>address</strong> = 'address'</dl>
+
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>primary</strong> = 'primary'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EmailImParent-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailImParent-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailImParent-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailImParent-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailImParent-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="EmailImParent-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="EmailImParent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EmailImParent-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EmailImParent-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EmailImParent-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EntryLink">class <strong>EntryLink</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:entryLink element.<br>
+ <br>
+Represents a logically nested entry. For example, a <gd:who><br>
+representing a contact might have a nested entry from a contact feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#EntryLink">EntryLink</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = <class 'gdata.data.GDEntry'><dd><tt>Extends Atom <a href="atom.data.html#Entry">Entry</a> to provide data processing</tt></dl>
+
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<dl><dt><strong>read_only</strong> = 'readOnly'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EntryLink-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EntryLink-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EntryLink-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EntryLink-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EntryLink-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="EntryLink-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="EntryLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EntryLink-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EntryLink-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EntryLink-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EventStatus">class <strong>EventStatus</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:eventStatus element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#EventStatus">EventStatus</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="EventStatus-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EventStatus-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EventStatus-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EventStatus-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EventStatus-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="EventStatus-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="EventStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="EventStatus-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="EventStatus-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="EventStatus-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExtendedProperty">class <strong>ExtendedProperty</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Data extendedProperty element.<br>
+ <br>
+Used to store arbitrary key-value information specific to your<br>
+application. The value can either be a text string stored as an XML<br>
+attribute (.value), or an XML node (XmlBlob) as a child element.<br>
+ <br>
+This element is used in the Google Calendar data API and the Google<br>
+Contacts data API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#ExtendedProperty">ExtendedProperty</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ExtendedProperty-GetXmlBlob"><strong>GetXmlBlob</strong></a> = <a href="#ExtendedProperty-get_xml_blob">get_xml_blob</a>(self)</dt></dl>
+
+<dl><dt><a name="ExtendedProperty-SetXmlBlob"><strong>SetXmlBlob</strong></a> = <a href="#ExtendedProperty-set_xml_blob">set_xml_blob</a>(self, blob)</dt></dl>
+
+<dl><dt><a name="ExtendedProperty-get_xml_blob"><strong>get_xml_blob</strong></a>(self)</dt><dd><tt>Returns the XML blob as an atom.core.<a href="atom.core.html#XmlElement">XmlElement</a>.<br>
+ <br>
+Returns:<br>
+ An <a href="atom.core.html#XmlElement">XmlElement</a> representing the blob's XML, or None if no<br>
+ blob was set.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-set_xml_blob"><strong>set_xml_blob</strong></a>(self, blob)</dt><dd><tt>Sets the contents of the extendedProperty to XML as a child node.<br>
+ <br>
+Since the extendedProperty is only allowed one child element as an XML<br>
+blob, setting the XML blob will erase any preexisting member elements<br>
+in this <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+Args:<br>
+ blob: str or atom.core.<a href="atom.core.html#XmlElement">XmlElement</a> representing the XML blob stored in<br>
+ the extendedProperty.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ExtendedProperty-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ExtendedProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ExtendedProperty-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FamilyName">class <strong>FamilyName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:familyName element.<br>
+ <br>
+Specifies family name of the person, eg. "Smith".<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#FamilyName">FamilyName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>yomi</strong> = 'yomi'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FamilyName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FamilyName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FamilyName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FamilyName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FamilyName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="FamilyName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="FamilyName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FamilyName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FamilyName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FamilyName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FeedLink">class <strong>FeedLink</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:feedLink element.<br>
+ <br>
+Represents a logically nested feed. For example, a calendar feed might<br>
+have a nested feed representing all comments on entries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#FeedLink">FeedLink</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>count_hint</strong> = 'countHint'</dl>
+
+<dl><dt><strong>feed</strong> = <class 'gdata.data.GDFeed'><dd><tt>A <a href="atom.data.html#Feed">Feed</a> from a GData service.</tt></dl>
+
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<dl><dt><strong>read_only</strong> = 'readOnly'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FeedLink-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedLink-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedLink-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeedLink-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedLink-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="FeedLink-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="FeedLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeedLink-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeedLink-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeedLink-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FormattedAddress">class <strong>FormattedAddress</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:formattedAddress element.<br>
+ <br>
+The full, unstructured postal address.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#FormattedAddress">FormattedAddress</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FormattedAddress-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FormattedAddress-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FormattedAddress-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FormattedAddress-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FormattedAddress-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="FormattedAddress-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="FormattedAddress-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FormattedAddress-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FormattedAddress-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FormattedAddress-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FullName">class <strong>FullName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:fullName element.<br>
+ <br>
+Unstructured representation of the name.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#FullName">FullName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FullName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FullName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FullName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FullName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FullName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="FullName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="FullName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FullName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FullName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FullName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GDEntry">class <strong>GDEntry</strong></a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Extends Atom <a href="atom.data.html#Entry">Entry</a> to provide data processing<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#GDEntry">GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GDEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = <a href="#GDEntry-find_media_link">find_media_link</a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-GetId"><strong>GetId</strong></a> = <a href="#GDEntry-get_id">get_id</a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-IsMedia"><strong>IsMedia</strong></a> = <a href="#GDEntry-is_media">is_media</a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="GDEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GDEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="GDEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="GDEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GDEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GDFeed">class <strong>GDFeed</strong></a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A <a href="atom.data.html#Feed">Feed</a> from a GData service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#GDFeed">GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GDFeed-GetId"><strong>GetId</strong></a> = <a href="#GDFeed-get_id">get_id</a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.data.GDEntry'>]</dl>
+
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:<a href="#TotalResults">TotalResults</a> for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="GDFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GDFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="GDFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="GDFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="GDFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GivenName">class <strong>GivenName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:givenName element.<br>
+ <br>
+Specifies given name of the person, eg. "John".<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#GivenName">GivenName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>yomi</strong> = 'yomi'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GivenName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GivenName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GivenName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GivenName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GivenName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="GivenName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GivenName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GivenName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GivenName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GivenName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HouseName">class <strong>HouseName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:housename element.<br>
+ <br>
+Used in places where houses or buildings have names (and not<br>
+necessarily numbers), eg. "The Pillars".<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#HouseName">HouseName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="HouseName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="HouseName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="HouseName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="HouseName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Im">class <strong>Im</strong></a>(<a href="gdata.data.html#EmailImParent">EmailImParent</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:im element.<br>
+ <br>
+An instant messaging address associated with the containing entity.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Im">Im</a></dd>
+<dd><a href="gdata.data.html#EmailImParent">EmailImParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>protocol</strong> = 'protocol'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#EmailImParent">EmailImParent</a>:<br>
+<dl><dt><strong>address</strong> = 'address'</dl>
+
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>primary</strong> = 'primary'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Im-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Im-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Im-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Im-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Im-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Im-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Im-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Im-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Im-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Im-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ItemsPerPage">class <strong>ItemsPerPage</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The opensearch:itemsPerPage element in GData feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#ItemsPerPage">ItemsPerPage</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ItemsPerPage-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ItemsPerPage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ItemsPerPage-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LinkFinder">class <strong>LinkFinder</strong></a>(<a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Mixin used in <a href="atom.data.html#Feed">Feed</a> and <a href="atom.data.html#Entry">Entry</a> classes to simplify link lookups by type.<br>
+ <br>
+Provides lookup methods for edit, edit-media, post, ACL and other special<br>
+links which are common across Google Data APIs.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="LinkFinder-FindAclLink"><strong>FindAclLink</strong></a> = <a href="#LinkFinder-find_acl_link">find_acl_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindFeedLink"><strong>FindFeedLink</strong></a> = <a href="#LinkFinder-find_feed_link">find_feed_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindHtmlLink"><strong>FindHtmlLink</strong></a> = <a href="#LinkFinder-find_html_link">find_html_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindPostLink"><strong>FindPostLink</strong></a> = <a href="#LinkFinder-find_post_link">find_post_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindPreviousLink"><strong>FindPreviousLink</strong></a> = <a href="#LinkFinder-find_previous_link">find_previous_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetAclLink"><strong>GetAclLink</strong></a> = <a href="#LinkFinder-get_acl_link">get_acl_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetFeedLink"><strong>GetFeedLink</strong></a> = <a href="#LinkFinder-get_feed_link">get_feed_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetHtmlLink"><strong>GetHtmlLink</strong></a> = <a href="#LinkFinder-get_html_link">get_html_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetPostLink"><strong>GetPostLink</strong></a> = <a href="#LinkFinder-get_post_link">get_post_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetPreviousLink"><strong>GetPreviousLink</strong></a> = <a href="#LinkFinder-get_previous_link">get_previous_link</a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="LinkFinder-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaSource">class <strong>MediaSource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>GData Entries can refer to media sources, so this class provides a<br>
+place to store references to these objects along with some metadata.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="MediaSource-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#MediaSource-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="MediaSource-SetFileHandle"><strong>SetFileHandle</strong></a> = <a href="#MediaSource-set_file_handle">set_file_handle</a>(self, file_name, content_type)</dt></dl>
+
+<dl><dt><a name="MediaSource-__init__"><strong>__init__</strong></a>(self, file_handle<font color="#909090">=None</font>, content_type<font color="#909090">=None</font>, content_length<font color="#909090">=None</font>, file_path<font color="#909090">=None</font>, file_name<font color="#909090">=None</font>)</dt><dd><tt>Creates an <a href="__builtin__.html#object">object</a> of type <a href="#MediaSource">MediaSource</a>.<br>
+ <br>
+Args:<br>
+ file_handle: A file handle pointing to the file to be encapsulated in the<br>
+ <a href="#MediaSource">MediaSource</a>.<br>
+ content_type: string The MIME type of the file. Required if a file_handle<br>
+ is given.<br>
+ content_length: int The size of the file. Required if a file_handle is<br>
+ given.<br>
+ file_path: string (optional) A full path name to the file. Used in<br>
+ place of a file_handle.<br>
+ file_name: string The name of the file without any path information.<br>
+ Required if a file_handle is given.</tt></dd></dl>
+
+<dl><dt><a name="MediaSource-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="MediaSource-set_file_handle"><strong>set_file_handle</strong></a>(self, file_name, content_type)</dt><dd><tt>A helper function which can create a file handle from a given filename<br>
+and set the content type and length all at once.<br>
+ <br>
+Args:<br>
+ file_name: string The path and file name to the file containing the media<br>
+ content_type: string A MIME type representing the type of the media</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MissingRequiredParameters">class <strong>MissingRequiredParameters</strong></a>(<a href="gdata.data.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#MissingRequiredParameters">MissingRequiredParameters</a></dd>
+<dd><a href="gdata.data.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.data.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="MissingRequiredParameters-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#MissingRequiredParameters-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="MissingRequiredParameters-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Money">class <strong>Money</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes money<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Money">Money</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>amount</strong> = 'amount'</dl>
+
+<dl><dt><strong>currency_code</strong> = 'currencyCode'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Money-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Money-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Money-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Money-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Money-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Money-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Money-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Money-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Money-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Money-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Name">class <strong>Name</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:name element.<br>
+ <br>
+Allows storing person's name in a structured way. Consists of<br>
+given name, additional name, family name, prefix, suffix and full name.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Name">Name</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>additional_name</strong> = <class 'gdata.data.AdditionalName'><dd><tt>The gd:additionalName element.<br>
+ <br>
+Specifies additional (eg. middle) name of the person.<br>
+Contains an attribute for the phonetic representaton of the name.</tt></dl>
+
+<dl><dt><strong>family_name</strong> = <class 'gdata.data.FamilyName'><dd><tt>The gd:familyName element.<br>
+ <br>
+Specifies family name of the person, eg. "Smith".</tt></dl>
+
+<dl><dt><strong>full_name</strong> = <class 'gdata.data.FullName'><dd><tt>The gd:fullName element.<br>
+ <br>
+Unstructured representation of the name.</tt></dl>
+
+<dl><dt><strong>given_name</strong> = <class 'gdata.data.GivenName'><dd><tt>The gd:givenName element.<br>
+ <br>
+Specifies given name of the person, eg. "John".</tt></dl>
+
+<dl><dt><strong>name_prefix</strong> = <class 'gdata.data.NamePrefix'><dd><tt>The gd:namePrefix element.<br>
+ <br>
+Honorific prefix, eg. 'Mr' or 'Mrs'.</tt></dl>
+
+<dl><dt><strong>name_suffix</strong> = <class 'gdata.data.NameSuffix'><dd><tt>The gd:nameSuffix element.<br>
+ <br>
+Honorific suffix, eg. 'san' or 'III'.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Name-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Name-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Name-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Name-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Name-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Name-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Name-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NamePrefix">class <strong>NamePrefix</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:namePrefix element.<br>
+ <br>
+Honorific prefix, eg. 'Mr' or 'Mrs'.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#NamePrefix">NamePrefix</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="NamePrefix-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NamePrefix-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NamePrefix-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NamePrefix-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NamePrefix-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="NamePrefix-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="NamePrefix-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NamePrefix-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NamePrefix-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NamePrefix-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NameSuffix">class <strong>NameSuffix</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:nameSuffix element.<br>
+ <br>
+Honorific suffix, eg. 'san' or 'III'.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#NameSuffix">NameSuffix</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="NameSuffix-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NameSuffix-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NameSuffix-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NameSuffix-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NameSuffix-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="NameSuffix-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="NameSuffix-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NameSuffix-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NameSuffix-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NameSuffix-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Neighborhood">class <strong>Neighborhood</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:neighborhood element.<br>
+ <br>
+This is used to disambiguate a street address when a city contains more<br>
+than one street with the same name, or to specify a small place whose<br>
+mail is routed through a larger postal town. In China it could be a<br>
+county or a minor city.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Neighborhood">Neighborhood</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Neighborhood-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Neighborhood-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Neighborhood-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Neighborhood-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgDepartment">class <strong>OrgDepartment</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:orgDepartment element.<br>
+ <br>
+Describes a department within an organization. Must appear within a<br>
+gd:organization element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#OrgDepartment">OrgDepartment</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OrgDepartment-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgDepartment-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgDepartment-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgDepartment-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgDepartment-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgDepartment-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrgDepartment-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgDepartment-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgDepartment-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgDepartment-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgJobDescription">class <strong>OrgJobDescription</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:orgJobDescription element.<br>
+ <br>
+Describes a job within an organization. Must appear within a<br>
+gd:organization element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#OrgJobDescription">OrgJobDescription</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OrgJobDescription-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgJobDescription-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgJobDescription-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgJobDescription-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgJobDescription-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgJobDescription-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrgJobDescription-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgJobDescription-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgJobDescription-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgJobDescription-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgName">class <strong>OrgName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:orgName element.<br>
+ <br>
+The name of the organization. Must appear within a gd:organization<br>
+element.<br>
+ <br>
+Contains a Yomigana attribute (Japanese reading aid) for the<br>
+organization name.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#OrgName">OrgName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>yomi</strong> = 'yomi'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OrgName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrgName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgSymbol">class <strong>OrgSymbol</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:orgSymbol element.<br>
+ <br>
+Provides a symbol of an organization. Must appear within a<br>
+gd:organization element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#OrgSymbol">OrgSymbol</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OrgSymbol-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgSymbol-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgSymbol-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgSymbol-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgSymbol-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgSymbol-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrgSymbol-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgSymbol-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgSymbol-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgSymbol-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OrgTitle">class <strong>OrgTitle</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:orgTitle element.<br>
+ <br>
+The title of a person within an organization. Must appear within a<br>
+gd:organization element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#OrgTitle">OrgTitle</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OrgTitle-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgTitle-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgTitle-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgTitle-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgTitle-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="OrgTitle-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="OrgTitle-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OrgTitle-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OrgTitle-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OrgTitle-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Organization">class <strong>Organization</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:organization element.<br>
+ <br>
+An organization, typically associated with a contact.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Organization">Organization</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>department</strong> = <class 'gdata.data.OrgDepartment'><dd><tt>The gd:orgDepartment element.<br>
+ <br>
+Describes a department within an organization. Must appear within a<br>
+gd:organization element.</tt></dl>
+
+<dl><dt><strong>job_description</strong> = <class 'gdata.data.OrgJobDescription'><dd><tt>The gd:orgJobDescription element.<br>
+ <br>
+Describes a job within an organization. Must appear within a<br>
+gd:organization element.</tt></dl>
+
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>name</strong> = <class 'gdata.data.OrgName'><dd><tt>The gd:orgName element.<br>
+ <br>
+The name of the organization. Must appear within a gd:organization<br>
+element.<br>
+ <br>
+Contains a Yomigana attribute (Japanese reading aid) for the<br>
+organization name.</tt></dl>
+
+<dl><dt><strong>primary</strong> = 'primary'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>symbol</strong> = <class 'gdata.data.OrgSymbol'><dd><tt>The gd:orgSymbol element.<br>
+ <br>
+Provides a symbol of an organization. Must appear within a<br>
+gd:organization element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'gdata.data.OrgTitle'><dd><tt>The gd:orgTitle element.<br>
+ <br>
+The title of a person within an organization. Must appear within a<br>
+gd:organization element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Organization-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Organization-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Organization-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Organization-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Organization-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Organization-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Organization-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Organization-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Organization-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Organization-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OriginalEvent">class <strong>OriginalEvent</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:originalEvent element.<br>
+ <br>
+Equivalent to the <a href="#Recurrence">Recurrence</a> ID property specified in section 4.8.4.4<br>
+of <a href="http://www.rfc-editor.org/rfc/rfc2445.txt">RFC 2445</a>. Appears in every instance of a recurring event, to identify<br>
+the original event.<br>
+ <br>
+Contains a <gd:when> element specifying the original start time of the<br>
+instance that has become an exception.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#OriginalEvent">OriginalEvent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<dl><dt><strong>id</strong> = 'id'</dl>
+
+<dl><dt><strong>when</strong> = <class 'gdata.data.When'><dd><tt>The gd:when element.<br>
+ <br>
+Represents a period of time or an instant.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OriginalEvent-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OriginalEvent-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OriginalEvent-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OriginalEvent-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OriginalEvent-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="OriginalEvent-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="OriginalEvent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OriginalEvent-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OriginalEvent-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OriginalEvent-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PhoneNumber">class <strong>PhoneNumber</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:phoneNumber element.<br>
+ <br>
+A phone number associated with the containing entity (which is usually<br>
+an entity representing a person or a location).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#PhoneNumber">PhoneNumber</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>primary</strong> = 'primary'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>uri</strong> = 'uri'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PhoneNumber-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PhoneNumber-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PhoneNumber-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PhoneNumber-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PhoneNumber-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="PhoneNumber-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="PhoneNumber-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhoneNumber-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PhoneNumber-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PhoneNumber-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PoBox">class <strong>PoBox</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:pobox element.<br>
+ <br>
+Covers actual P.O. boxes, drawers, locked bags, etc. This is usually<br>
+but not always mutually exclusive with street.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#PoBox">PoBox</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PoBox-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PoBox-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PoBox-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PoBox-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PoBox-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="PoBox-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="PoBox-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PoBox-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PoBox-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PoBox-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PostalAddress">class <strong>PostalAddress</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:postalAddress element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#PostalAddress">PostalAddress</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>primary</strong> = 'primary'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>uri</strong> = 'uri'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PostalAddress-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PostalAddress-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PostalAddress-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PostalAddress-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PostalAddress-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="PostalAddress-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="PostalAddress-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PostalAddress-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PostalAddress-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PostalAddress-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Postcode">class <strong>Postcode</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:postcode element.<br>
+ <br>
+Postal code. Usually country-wide, but sometimes specific to the<br>
+city (e.g. "2" in "Dublin 2, Ireland" addresses).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Postcode">Postcode</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Postcode-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Postcode-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Postcode-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Postcode-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Postcode-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Postcode-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Postcode-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Postcode-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Postcode-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Postcode-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Rating">class <strong>Rating</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:rating element.<br>
+ <br>
+Represents a numeric rating of the enclosing entity, such as a<br>
+comment. Each rating supplies its own scale, although it may be<br>
+normalized by a service; for example, some services might convert all<br>
+ratings to a scale from 1 to 5.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Rating">Rating</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>average</strong> = 'average'</dl>
+
+<dl><dt><strong>max</strong> = 'max'</dl>
+
+<dl><dt><strong>min</strong> = 'min'</dl>
+
+<dl><dt><strong>num_raters</strong> = 'numRaters'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Rating-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rating-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rating-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Rating-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rating-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Rating-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Rating-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Rating-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Rating-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rating-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Recurrence">class <strong>Recurrence</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:recurrence element.<br>
+ <br>
+Represents the dates and times when a recurring event takes place.<br>
+ <br>
+The string that defines the recurrence consists of a set of properties,<br>
+each of which is defined in the iCalendar standard (<a href="http://www.rfc-editor.org/rfc/rfc2445.txt">RFC 2445</a>).<br>
+ <br>
+Specifically, the string usually begins with a DTSTART property that<br>
+indicates the starting time of the first instance of the event, and<br>
+often a DTEND property or a DURATION property to indicate when the<br>
+first instance ends. Next come RRULE, RDATE, EXRULE, and/or EXDATE<br>
+properties, which collectively define a recurring event and its<br>
+exceptions (but see below). (See section 4.8.5 of <a href="http://www.rfc-editor.org/rfc/rfc2445.txt">RFC 2445</a> for more<br>
+information about these recurrence component properties.) Last comes a<br>
+VTIMEZONE component, providing detailed timezone rules for any timezone<br>
+ID mentioned in the preceding properties.<br>
+ <br>
+Google services like Google Calendar don't generally generate EXRULE<br>
+and EXDATE properties to represent exceptions to recurring events;<br>
+instead, they generate <gd:recurrenceException> elements. However,<br>
+Google services may include EXRULE and/or EXDATE properties anyway;<br>
+for example, users can import events and exceptions into Calendar, and<br>
+if those imported events contain EXRULE or EXDATE properties, then<br>
+Calendar will provide those properties when it sends a <gd:recurrence><br>
+element.<br>
+ <br>
+Note the the use of <gd:recurrenceException> means that you can't be<br>
+sure just from examining a <gd:recurrence> element whether there are<br>
+any exceptions to the recurrence description. To ensure that you find<br>
+all exceptions, look for <gd:recurrenceException> elements in the feed,<br>
+and use their <gd:originalEvent> elements to match them up with<br>
+<gd:recurrence> elements.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Recurrence">Recurrence</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Recurrence-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Recurrence-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Recurrence-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Recurrence-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Recurrence-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Recurrence-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Recurrence-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Recurrence-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Recurrence-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Recurrence-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RecurrenceException">class <strong>RecurrenceException</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:recurrenceException element.<br>
+ <br>
+Represents an event that's an exception to a recurring event-that is,<br>
+an instance of a recurring event in which one or more aspects of the<br>
+recurring event (such as attendance list, time, or location) have been<br>
+changed.<br>
+ <br>
+Contains a <gd:originalEvent> element that specifies the original<br>
+recurring event that this event is an exception to.<br>
+ <br>
+<a href="#When">When</a> you change an instance of a recurring event, that instance becomes<br>
+an exception. Depending on what change you made to it, the exception<br>
+behaves in either of two different ways when the original recurring<br>
+event is changed:<br>
+ <br>
+- If you add, change, or remove comments, attendees, or attendee<br>
+ responses, then the exception remains tied to the original event, and<br>
+ changes to the original event also change the exception.<br>
+- If you make any other changes to the exception (such as changing the<br>
+ time or location) then the instance becomes "specialized," which means<br>
+ that it's no longer as tightly tied to the original event. If you<br>
+ change the original event, specialized exceptions don't change. But<br>
+ see below.<br>
+ <br>
+For example, say you have a meeting every Tuesday and Thursday at<br>
+2:00 p.m. If you change the attendance list for this Thursday's meeting<br>
+(but not for the regularly scheduled meeting), then it becomes an<br>
+exception. If you change the time for this Thursday's meeting (but not<br>
+for the regularly scheduled meeting), then it becomes specialized.<br>
+ <br>
+Regardless of whether an exception is specialized or not, if you do<br>
+something that deletes the instance that the exception was derived from,<br>
+then the exception is deleted. Note that changing the day or time of a<br>
+recurring event deletes all instances, and creates new ones.<br>
+ <br>
+For example, after you've specialized this Thursday's meeting, say you<br>
+change the recurring meeting to happen on Monday, Wednesday, and Friday.<br>
+That change deletes all of the recurring instances of the<br>
+Tuesday/Thursday meeting, including the specialized one.<br>
+ <br>
+If a particular instance of a recurring event is deleted, then that<br>
+instance appears as a <gd:recurrenceException> containing a<br>
+<gd:entryLink> that has its <gd:eventStatus> set to<br>
+"<a href="http://schemas.google.com/g/2005#event.canceled">http://schemas.google.com/g/2005#event.canceled</a>". (For more<br>
+information about canceled events, see <a href="http://www.rfc-editor.org/rfc/rfc2445.txt">RFC 2445</a>.)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#RecurrenceException">RecurrenceException</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry_link</strong> = <class 'gdata.data.EntryLink'><dd><tt>The gd:entryLink element.<br>
+ <br>
+Represents a logically nested entry. For example, a <gd:who><br>
+representing a contact might have a nested entry from a contact feed.</tt></dl>
+
+<dl><dt><strong>original_event</strong> = <class 'gdata.data.OriginalEvent'><dd><tt>The gd:originalEvent element.<br>
+ <br>
+Equivalent to the <a href="#Recurrence">Recurrence</a> ID property specified in section 4.8.4.4<br>
+of <a href="http://www.rfc-editor.org/rfc/rfc2445.txt">RFC 2445</a>. Appears in every instance of a recurring event, to identify<br>
+the original event.<br>
+ <br>
+Contains a <gd:when> element specifying the original start time of the<br>
+instance that has become an exception.</tt></dl>
+
+<dl><dt><strong>specialized</strong> = 'specialized'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="RecurrenceException-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RecurrenceException-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RecurrenceException-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RecurrenceException-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RecurrenceException-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="RecurrenceException-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="RecurrenceException-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecurrenceException-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RecurrenceException-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RecurrenceException-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Region">class <strong>Region</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:region element.<br>
+ <br>
+A state, province, county (in Ireland), Land (in Germany),<br>
+departement (in France), etc.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Region">Region</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Region-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Region-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Region-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Region-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Region-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Region-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Region-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Region-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Region-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Region-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Reminder">class <strong>Reminder</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:reminder element.<br>
+ <br>
+A time interval, indicating how long before the containing entity's start<br>
+time or due time attribute a reminder should be issued. Alternatively,<br>
+may specify an absolute time at which a reminder should be issued. Also<br>
+specifies a notification method, indicating what medium the system<br>
+should use to remind the user.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Reminder">Reminder</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>absolute_time</strong> = 'absoluteTime'</dl>
+
+<dl><dt><strong>days</strong> = 'days'</dl>
+
+<dl><dt><strong>hours</strong> = 'hours'</dl>
+
+<dl><dt><strong>method</strong> = 'method'</dl>
+
+<dl><dt><strong>minutes</strong> = 'minutes'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Reminder-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Reminder-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Reminder-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Reminder-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Reminder-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Reminder-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Reminder-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Reminder-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Reminder-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Reminder-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="StartIndex">class <strong>StartIndex</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The opensearch:startIndex element in GData feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#StartIndex">StartIndex</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="StartIndex-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="StartIndex-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="StartIndex-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Street">class <strong>Street</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:street element.<br>
+ <br>
+Can be street, avenue, road, etc. This element also includes the<br>
+house number and room/apartment/flat/floor number.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Street">Street</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Street-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Street-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Street-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Street-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Street-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Street-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Street-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Street-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Street-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Street-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="StructuredPostalAddress">class <strong>StructuredPostalAddress</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:structuredPostalAddress element.<br>
+ <br>
+Postal address split into components. It allows to store the address<br>
+in locale independent format. The fields can be interpreted and used<br>
+to generate formatted, locale dependent address. The following elements<br>
+reperesent parts of the address: agent, house name, street, P.O. box,<br>
+neighborhood, city, subregion, region, postal code, country. The<br>
+subregion element is not used for postal addresses, it is provided for<br>
+extended uses of addresses only. In order to store postal address in an<br>
+unstructured form formatted address field is provided.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#StructuredPostalAddress">StructuredPostalAddress</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>agent</strong> = <class 'gdata.data.Agent'><dd><tt>The gd:agent element.<br>
+ <br>
+The agent who actually receives the mail. Used in work addresses.<br>
+Also for 'in care of' or 'c/o'.</tt></dl>
+
+<dl><dt><strong>city</strong> = <class 'gdata.data.City'><dd><tt>The gd:city element.<br>
+ <br>
+Can be city, village, town, borough, etc. This is the postal town and<br>
+not necessarily the place of residence or place of business.</tt></dl>
+
+<dl><dt><strong>country</strong> = <class 'gdata.data.Country'><dd><tt>The gd:country element.<br>
+ <br>
+The name or code of the country.</tt></dl>
+
+<dl><dt><strong>formatted_address</strong> = <class 'gdata.data.FormattedAddress'><dd><tt>The gd:formattedAddress element.<br>
+ <br>
+The full, unstructured postal address.</tt></dl>
+
+<dl><dt><strong>house_name</strong> = <class 'gdata.data.HouseName'><dd><tt>The gd:housename element.<br>
+ <br>
+Used in places where houses or buildings have names (and not<br>
+necessarily numbers), eg. "The Pillars".</tt></dl>
+
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>mail_class</strong> = 'mailClass'</dl>
+
+<dl><dt><strong>neighborhood</strong> = <class 'gdata.data.Neighborhood'><dd><tt>The gd:neighborhood element.<br>
+ <br>
+This is used to disambiguate a street address when a city contains more<br>
+than one street with the same name, or to specify a small place whose<br>
+mail is routed through a larger postal town. In China it could be a<br>
+county or a minor city.</tt></dl>
+
+<dl><dt><strong>po_box</strong> = <class 'gdata.data.PoBox'><dd><tt>The gd:pobox element.<br>
+ <br>
+Covers actual P.O. boxes, drawers, locked bags, etc. This is usually<br>
+but not always mutually exclusive with street.</tt></dl>
+
+<dl><dt><strong>postcode</strong> = <class 'gdata.data.Postcode'><dd><tt>The gd:postcode element.<br>
+ <br>
+Postal code. Usually country-wide, but sometimes specific to the<br>
+city (e.g. "2" in "Dublin 2, Ireland" addresses).</tt></dl>
+
+<dl><dt><strong>primary</strong> = 'primary'</dl>
+
+<dl><dt><strong>region</strong> = <class 'gdata.data.Region'><dd><tt>The gd:region element.<br>
+ <br>
+A state, province, county (in Ireland), Land (in Germany),<br>
+departement (in France), etc.</tt></dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>street</strong> = <class 'gdata.data.Street'><dd><tt>The gd:street element.<br>
+ <br>
+Can be street, avenue, road, etc. This element also includes the<br>
+house number and room/apartment/flat/floor number.</tt></dl>
+
+<dl><dt><strong>subregion</strong> = <class 'gdata.data.Subregion'><dd><tt>The gd:subregion element.<br>
+ <br>
+Handles administrative districts such as U.S. or U.K. counties that are<br>
+not used for mail addressing purposes. <a href="#Subregion">Subregion</a> is not intended for<br>
+delivery addresses.</tt></dl>
+
+<dl><dt><strong>usage</strong> = 'usage'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="StructuredPostalAddress-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StructuredPostalAddress-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StructuredPostalAddress-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="StructuredPostalAddress-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StructuredPostalAddress-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="StructuredPostalAddress-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="StructuredPostalAddress-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="StructuredPostalAddress-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="StructuredPostalAddress-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StructuredPostalAddress-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Subregion">class <strong>Subregion</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:subregion element.<br>
+ <br>
+Handles administrative districts such as U.S. or U.K. counties that are<br>
+not used for mail addressing purposes. <a href="#Subregion">Subregion</a> is not intended for<br>
+delivery addresses.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Subregion">Subregion</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Subregion-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subregion-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subregion-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Subregion-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subregion-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Subregion-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Subregion-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Subregion-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Subregion-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subregion-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TotalResults">class <strong>TotalResults</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>opensearch:<a href="#TotalResults">TotalResults</a> for a GData feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#TotalResults">TotalResults</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TotalResults-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TotalResults-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TotalResults-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Transparency">class <strong>Transparency</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:transparency element:<br>
+ <br>
+Extensible enum corresponding to the TRANSP property defined in <a href="http://www.rfc-editor.org/rfc/rfc244.txt">RFC 244</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Transparency">Transparency</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Transparency-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Transparency-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Transparency-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Transparency-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Transparency-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Transparency-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Transparency-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Transparency-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Transparency-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Transparency-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Visibility">class <strong>Visibility</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:visibility element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Visibility">Visibility</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Visibility-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Visibility-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Visibility-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Visibility-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Visibility-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Visibility-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Visibility-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Visibility-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Visibility-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Visibility-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="When">class <strong>When</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:when element.<br>
+ <br>
+Represents a period of time or an instant.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#When">When</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>end</strong> = 'endTime'</dl>
+
+<dl><dt><strong>start</strong> = 'startTime'</dl>
+
+<dl><dt><strong>value</strong> = 'valueString'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="When-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="When-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="When-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="When-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="When-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="When-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="When-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="When-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="When-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="When-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Where">class <strong>Where</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:where element.<br>
+ <br>
+A place (such as an event location) associated with the containing<br>
+entity. The type of the association is determined by the rel attribute;<br>
+the details of the location are contained in an embedded or linked-to<br>
+Contact entry.<br>
+ <br>
+A <gd:where> element is more general than a <gd:geoPt> element. The<br>
+former identifies a place using a text description and/or a Contact<br>
+entry, while the latter identifies a place using a specific geographic<br>
+location.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Where">Where</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry_link</strong> = <class 'gdata.data.EntryLink'><dd><tt>The gd:entryLink element.<br>
+ <br>
+Represents a logically nested entry. For example, a <gd:who><br>
+representing a contact might have a nested entry from a contact feed.</tt></dl>
+
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>value</strong> = 'valueString'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Where-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Where-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Where-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Where-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Where-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Where-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Where-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Where-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Where-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Where-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Who">class <strong>Who</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:who element.<br>
+ <br>
+A person associated with the containing entity. The type of the<br>
+association is determined by the rel attribute; the details about the<br>
+person are contained in an embedded or linked-to Contact entry.<br>
+ <br>
+The <gd:who> element can be used to specify email senders and<br>
+recipients, calendar event organizers, and so on.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.data.html#Who">Who</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>attendee_status</strong> = <class 'gdata.data.AttendeeStatus'><dd><tt>The gd:attendeeStatus element.</tt></dl>
+
+<dl><dt><strong>attendee_type</strong> = <class 'gdata.data.AttendeeType'><dd><tt>The gd:attendeeType element.</tt></dl>
+
+<dl><dt><strong>email</strong> = 'email'</dl>
+
+<dl><dt><strong>entry_link</strong> = <class 'gdata.data.EntryLink'><dd><tt>The gd:entryLink element.<br>
+ <br>
+Represents a logically nested entry. For example, a <gd:who><br>
+representing a contact might have a nested entry from a contact feed.</tt></dl>
+
+<dl><dt><strong>rel</strong> = 'rel'</dl>
+
+<dl><dt><strong>value</strong> = 'valueString'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Who-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Who-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Who-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Who-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Who-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Who-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Who-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Who-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Who-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Who-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ACL_REL</strong> = 'http://schemas.google.com/acl/2007#accessControlList'<br>
+<strong>AIM_PROTOCOL</strong> = 'http://schemas.google.com/g/2005#AIM'<br>
+<strong>ALTERNATE_LOCATION</strong> = 'http://schemas.google.com/g/2005#event.alternate'<br>
+<strong>ASSISTANT_REL</strong> = 'http://schemas.google.com/g/2005#assistant'<br>
+<strong>ATTENDEE_ACCEPTED</strong> = 'http://schemas.google.com/g/2005#event.accepted'<br>
+<strong>ATTENDEE_DECLINED</strong> = 'http://schemas.google.com/g/2005#event.declined'<br>
+<strong>ATTENDEE_INVITED</strong> = 'http://schemas.google.com/g/2005#event.invited'<br>
+<strong>ATTENDEE_TENTATIVE</strong> = 'http://schemas.google.com/g/2005#event.tentative'<br>
+<strong>BASIC_PROJECTION</strong> = 'basic'<br>
+<strong>BATCH_DELETE</strong> = 'delete'<br>
+<strong>BATCH_INSERT</strong> = 'insert'<br>
+<strong>BATCH_QUERY</strong> = 'query'<br>
+<strong>BATCH_TEMPLATE</strong> = '{http://schemas.google.com/gdata/batch}%s'<br>
+<strong>BATCH_UPDATE</strong> = 'update'<br>
+<strong>BCC_RECIPIENT</strong> = 'http://schemas.google.com/g/2005#message.bcc'<br>
+<strong>CALLBACK_REL</strong> = 'http://schemas.google.com/g/2005#callback'<br>
+<strong>CANCELED_EVENT</strong> = 'http://schemas.google.com/g/2005#event.canceled'<br>
+<strong>CANCELED_EVENT_STATUS</strong> = 'http://schemas.google.com/g/2005#event.canceled'<br>
+<strong>CAR_REL</strong> = 'http://schemas.google.com/g/2005#car'<br>
+<strong>CC_RECIPIENT</strong> = 'http://schemas.google.com/g/2005#message.cc'<br>
+<strong>CHAT_MESSAGE</strong> = 'http://schemas.google.com/g/2005#message.chat'<br>
+<strong>COMPANY_MAIN_REL</strong> = 'http://schemas.google.com/g/2005#company_main'<br>
+<strong>CONFIDENTIAL_EVENT</strong> = 'http://schemas.google.com/g/2005#event.confidential'<br>
+<strong>CONFIDENTIAL_EVENT_VISIBILITY</strong> = 'http://schemas.google.com/g/2005#event.confidential'<br>
+<strong>CONFIRMED_EVENT</strong> = 'http://schemas.google.com/g/2005#event.confirmed'<br>
+<strong>CONFIRMED_EVENT_STATUS</strong> = 'http://schemas.google.com/g/2005#event.confirmed'<br>
+<strong>DEFAULT_EVENT</strong> = 'http://schemas.google.com/g/2005#event.default'<br>
+<strong>DEFAULT_EVENT_VISIBILITY</strong> = 'http://schemas.google.com/g/2005#event.default'<br>
+<strong>EVENT_ALTERNATE_REL</strong> = 'http://schemas.google.com/g/2005#event.alternate'<br>
+<strong>EVENT_LOCATION</strong> = 'http://schemas.google.com/g/2005#event'<br>
+<strong>EVENT_PARKING_REL</strong> = 'http://schemas.google.com/g/2005#event.parking'<br>
+<strong>EVENT_REL</strong> = 'http://schemas.google.com/g/2005#event'<br>
+<strong>FAX_REL</strong> = 'http://schemas.google.com/g/2005#fax'<br>
+<strong>FULL_PROJECTION</strong> = 'full'<br>
+<strong>GDATA_TEMPLATE</strong> = '{http://schemas.google.com/g/2005}%s'<br>
+<strong>GD_TEMPLATE</strong> = '{http://schemas.google.com/g/2005}%s'<br>
+<strong>GENERAL_ADDRESS</strong> = 'http://schemas.google.com/g/2005#general'<br>
+<strong>GOOGLE_TALK_PROTOCOL</strong> = 'http://schemas.google.com/g/2005#GOOGLE_TALK'<br>
+<strong>HOME_FAX_REL</strong> = 'http://schemas.google.com/g/2005#home_fax'<br>
+<strong>HOME_REL</strong> = 'http://schemas.google.com/g/2005#home'<br>
+<strong>ICQ_PROTOCOL</strong> = 'http://schemas.google.com/g/2005#ICQ'<br>
+<strong>INBOX_MESSAGE</strong> = 'http://schemas.google.com/g/2005#message.inbox'<br>
+<strong>ISDN_REL</strong> = 'http://schemas.google.com/g/2005#isdn'<br>
+<strong>JABBER_PROTOCOL</strong> = 'http://schemas.google.com/g/2005#JABBER'<br>
+<strong>LOCAL_ADDRESS</strong> = 'http://schemas.google.com/g/2005#local'<br>
+<strong>MAIL_BOTH</strong> = 'http://schemas.google.com/g/2005#both'<br>
+<strong>MAIL_LETTERS</strong> = 'http://schemas.google.com/g/2005#letters'<br>
+<strong>MAIL_NEITHER</strong> = 'http://schemas.google.com/g/2005#neither'<br>
+<strong>MAIL_PARCELS</strong> = 'http://schemas.google.com/g/2005#parcels'<br>
+<strong>MAIN_REL</strong> = 'http://schemas.google.com/g/2005#main'<br>
+<strong>MOBILE_REL</strong> = 'http://schemas.google.com/g/2005#mobile'<br>
+<strong>MSN_PROTOCOL</strong> = 'http://schemas.google.com/g/2005#MSN'<br>
+<strong>NETMEETING_REL</strong> = 'http://schemas.google.com/g/2005#netmeeting'<br>
+<strong>OPAQUE_EVENT</strong> = 'http://schemas.google.com/g/2005#event.opaque'<br>
+<strong>OPAQUE_TRANSPARENCY</strong> = 'http://schemas.google.com/g/2005#event.opaque'<br>
+<strong>OPENSEARCH_TEMPLATE_V1</strong> = '{http://a9.com/-/spec/opensearchrss/1.0/}%s'<br>
+<strong>OPENSEARCH_TEMPLATE_V2</strong> = '{http://a9.com/-/spec/opensearch/1.1/}%s'<br>
+<strong>OPTIONAL_ATENDEE</strong> = 'http://schemas.google.com/g/2005#event.optional'<br>
+<strong>OTHER_FAX_REL</strong> = 'http://schemas.google.com/g/2005#other_fax'<br>
+<strong>OTHER_REL</strong> = 'http://schemas.google.com/g/2005#other'<br>
+<strong>OVERALL_REL</strong> = 'http://schemas.google.com/g/2005#overall'<br>
+<strong>PAGER_REL</strong> = 'http://schemas.google.com/g/2005#pager'<br>
+<strong>PARKING_LOCATION</strong> = 'http://schemas.google.com/g/2005#event.parking'<br>
+<strong>PRICE_REL</strong> = 'http://schemas.google.com/g/2005#price'<br>
+<strong>PRIVATE_EVENT</strong> = 'http://schemas.google.com/g/2005#event.private'<br>
+<strong>PRIVATE_EVENT_VISIBILITY</strong> = 'http://schemas.google.com/g/2005#event.private'<br>
+<strong>PRIVATE_VISIBILITY</strong> = 'private'<br>
+<strong>PUBLIC_EVENT</strong> = 'http://schemas.google.com/g/2005#event.public'<br>
+<strong>PUBLIC_EVENT_VISIBILITY</strong> = 'http://schemas.google.com/g/2005#event.public'<br>
+<strong>PUBLIC_VISIBILITY</strong> = 'public'<br>
+<strong>QQ_PROTOCOL</strong> = 'http://schemas.google.com/g/2005#QQ'<br>
+<strong>QUALITY_REL</strong> = 'http://schemas.google.com/g/2005#quality'<br>
+<strong>RADIO_REL</strong> = 'http://schemas.google.com/g/2005#radio'<br>
+<strong>REGULAR_COMMENTS</strong> = 'http://schemas.google.com/g/2005#regular'<br>
+<strong>REPLY_TO</strong> = 'http://schemas.google.com/g/2005#message.reply-to'<br>
+<strong>REQUIRED_ATENDEE</strong> = 'http://schemas.google.com/g/2005#event.required'<br>
+<strong>REVIEW_COMMENTS</strong> = 'http://schemas.google.com/g/2005#reviews'<br>
+<strong>SENDER</strong> = 'http://schemas.google.com/g/2005#message.from'<br>
+<strong>SENT_MESSAGE</strong> = 'http://schemas.google.com/g/2005#message.sent'<br>
+<strong>SKYPE_PROTOCOL</strong> = 'http://schemas.google.com/g/2005#SKYPE'<br>
+<strong>SPAM_MESSAGE</strong> = 'http://schemas.google.com/g/2005#message.spam'<br>
+<strong>STARRED_MESSAGE</strong> = 'http://schemas.google.com/g/2005#message.starred'<br>
+<strong>TELEX_REL</strong> = 'http://schemas.google.com/g/2005#telex'<br>
+<strong>TENTATIVE_EVENT</strong> = 'http://schemas.google.com/g/2005#event.tentative'<br>
+<strong>TENTATIVE_EVENT_STATUS</strong> = 'http://schemas.google.com/g/2005#event.tentative'<br>
+<strong>TO_RECIPIENT</strong> = 'http://schemas.google.com/g/2005#message.to'<br>
+<strong>TRANSPARENT_EVENT</strong> = 'http://schemas.google.com/g/2005#event.transparent'<br>
+<strong>TRANSPARENT_TRANSPARENCY</strong> = 'http://schemas.google.com/g/2005#event.transparent'<br>
+<strong>TTL_TDD_REL</strong> = 'http://schemas.google.com/g/2005#tty_tdd'<br>
+<strong>UNREAD_MESSAGE</strong> = 'http://schemas.google.com/g/2005#message.unread'<br>
+<strong>VALUES_PROJECTION</strong> = 'values'<br>
+<strong>WORK_FAX_REL</strong> = 'http://schemas.google.com/g/2005#work_fax'<br>
+<strong>WORK_MOBILE_REL</strong> = 'http://schemas.google.com/g/2005#work_mobile'<br>
+<strong>WORK_PAGER_REL</strong> = 'http://schemas.google.com/g/2005#work_pager'<br>
+<strong>WORK_REL</strong> = 'http://schemas.google.com/g/2005#work'<br>
+<strong>YAHOO_MESSENGER_PROTOCOL</strong> = 'http://schemas.google.com/g/2005#YAHOO'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.docs.client.html b/pydocs/gdata.docs.client.html
new file mode 100644
index 0000000..bda8bc6
--- /dev/null
+++ b/pydocs/gdata.docs.client.html
@@ -0,0 +1,1149 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.docs.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.docs.html"><font color="#ffffff">docs</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/docs/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/docs/client.py</a></font></td></tr></table>
+ <p><tt><a href="#DocsClient">DocsClient</a> simplifies interactions with the Documents List API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+<a href="copy.html">copy</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+<a href="mimetypes.html">mimetypes</a><br>
+</td><td width="25%" valign=top><a href="re.html">re</a><br>
+<a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.client.html#DocsClient">DocsClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#Query">gdata.client.Query</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.client.html#DocsQuery">DocsQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DocsClient">class <strong>DocsClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for all features of the Google Documents List API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.client.html#DocsClient">DocsClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="DocsClient-AddAclEntry"><strong>AddAclEntry</strong></a> = <a href="#DocsClient-add_acl_entry">add_acl_entry</a>(self, resource, acl_entry, send_notifications<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-BatchProcessAclEntries"><strong>BatchProcessAclEntries</strong></a> = <a href="#DocsClient-batch_process_acl_entries">batch_process_acl_entries</a>(self, resource, entries, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-CopyResource"><strong>CopyResource</strong></a> = <a href="#DocsClient-copy_resource">copy_resource</a>(self, entry, title, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-CreateArchive"><strong>CreateArchive</strong></a> = <a href="#DocsClient-create_archive">create_archive</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-CreateResource"><strong>CreateResource</strong></a> = <a href="#DocsClient-create_resource">create_resource</a>(self, entry, media<font color="#909090">=None</font>, collection<font color="#909090">=None</font>, create_uri<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-DeleteAclEntry"><strong>DeleteAclEntry</strong></a> = <a href="#DocsClient-delete_acl_entry">delete_acl_entry</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-DeleteArchive"><strong>DeleteArchive</strong></a> = <a href="#DocsClient-delete_archive">delete_archive</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-DeleteResource"><strong>DeleteResource</strong></a> = <a href="#DocsClient-delete_resource">delete_resource</a>(self, entry, permanent<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-DeleteRevision"><strong>DeleteRevision</strong></a> = <a href="#DocsClient-delete_revision">delete_revision</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-DownloadArchive"><strong>DownloadArchive</strong></a> = <a href="#DocsClient-download_resource">download_resource</a>(self, entry, file_path, extra_params<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-DownloadArchiveToMemory"><strong>DownloadArchiveToMemory</strong></a> = <a href="#DocsClient-download_resource_to_memory">download_resource_to_memory</a>(self, entry, extra_params<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-DownloadResource"><strong>DownloadResource</strong></a> = <a href="#DocsClient-download_resource">download_resource</a>(self, entry, file_path, extra_params<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-DownloadResourceToMemory"><strong>DownloadResourceToMemory</strong></a> = <a href="#DocsClient-download_resource_to_memory">download_resource_to_memory</a>(self, entry, extra_params<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-DownloadRevision"><strong>DownloadRevision</strong></a> = <a href="#DocsClient-download_revision">download_revision</a>(self, entry, file_path, extra_params<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-DownloadRevisionToMemory"><strong>DownloadRevisionToMemory</strong></a> = <a href="#DocsClient-download_revision_to_memory">download_revision_to_memory</a>(self, entry, extra_params<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetAcl"><strong>GetAcl</strong></a> = <a href="#DocsClient-get_acl">get_acl</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetAclEntry"><strong>GetAclEntry</strong></a> = <a href="#DocsClient-get_acl_entry">get_acl_entry</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetAclEntryBySelfLink"><strong>GetAclEntryBySelfLink</strong></a> = <a href="#DocsClient-get_acl_entry_by_self_link">get_acl_entry_by_self_link</a>(self, self_link, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetAllResources"><strong>GetAllResources</strong></a> = <a href="#DocsClient-get_all_resources">get_all_resources</a>(self, uri<font color="#909090">=None</font>, show_root<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetArchive"><strong>GetArchive</strong></a> = <a href="#DocsClient-get_archive">get_archive</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetArchiveBySelfLink"><strong>GetArchiveBySelfLink</strong></a> = <a href="#DocsClient-get_archive_by_self_link">get_archive_by_self_link</a>(self, self_link, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetChanges"><strong>GetChanges</strong></a> = <a href="#DocsClient-get_changes">get_changes</a>(self, changestamp<font color="#909090">=None</font>, max_results<font color="#909090">=None</font>, show_root<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetMetadata"><strong>GetMetadata</strong></a> = <a href="#DocsClient-get_metadata">get_metadata</a>(self, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetResource"><strong>GetResource</strong></a> = <a href="#DocsClient-get_resource">get_resource</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetResourceAcl"><strong>GetResourceAcl</strong></a> = <a href="#DocsClient-get_resource_acl">get_resource_acl</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetResourceById"><strong>GetResourceById</strong></a> = <a href="#DocsClient-get_resource_by_id">get_resource_by_id</a>(self, resource_id, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetResourceBySelfLink"><strong>GetResourceBySelfLink</strong></a> = <a href="#DocsClient-get_resource_by_self_link">get_resource_by_self_link</a>(self, uri, etag<font color="#909090">=None</font>, show_root<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetResources"><strong>GetResources</strong></a> = <a href="#DocsClient-get_resources">get_resources</a>(self, uri<font color="#909090">=None</font>, limit<font color="#909090">=None</font>, show_root<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetRevision"><strong>GetRevision</strong></a> = <a href="#DocsClient-get_revision">get_revision</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetRevisionBySelfLink"><strong>GetRevisionBySelfLink</strong></a> = <a href="#DocsClient-get_revision_by_self_link">get_revision_by_self_link</a>(self, self_link, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetRevisions"><strong>GetRevisions</strong></a> = <a href="#DocsClient-get_revisions">get_revisions</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-MoveResource"><strong>MoveResource</strong></a> = <a href="#DocsClient-move_resource">move_resource</a>(self, entry, collection<font color="#909090">=None</font>, keep_in_collections<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-PublishRevision"><strong>PublishRevision</strong></a> = <a href="#DocsClient-publish_revision">publish_revision</a>(self, entry, publish_auto<font color="#909090">=None</font>, publish_outside_domain<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-Request"><strong>Request</strong></a> = <a href="#DocsClient-request">request</a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-UnpublishRevision"><strong>UnpublishRevision</strong></a> = <a href="#DocsClient-unpublish_revision">unpublish_revision</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-UpdateAclEntry"><strong>UpdateAclEntry</strong></a> = <a href="#DocsClient-update_acl_entry">update_acl_entry</a>(self, entry, send_notifications<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-UpdateArchive"><strong>UpdateArchive</strong></a> = <a href="#DocsClient-update_archive">update_archive</a>(self, entry, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-UpdateResource"><strong>UpdateResource</strong></a> = <a href="#DocsClient-update_resource">update_resource</a>(self, entry, media<font color="#909090">=None</font>, update_metadata<font color="#909090">=True</font>, new_revision<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-add_acl_entry"><strong>add_acl_entry</strong></a>(self, resource, acl_entry, send_notifications<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds the given AclEntry to the given Resource.<br>
+ <br>
+Args:<br>
+ resource: gdata.docs.data.Resource to which to add AclEntry.<br>
+ acl_entry: gdata.docs.data.AclEntry representing ACL entry to add.<br>
+ send_notifications: True if users should be notified by email when<br>
+ this AclEntry is added.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.AclEntry containing information about new entry.<br>
+Raises:<br>
+ ValueError: If given resource has no ACL link.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-batch_process_acl_entries"><strong>batch_process_acl_entries</strong></a>(self, resource, entries, **kwargs)</dt><dd><tt>Applies the specified operation of each entry in a single request.<br>
+ <br>
+To use this, simply set acl_entry.batch_operation to one of<br>
+['query', 'insert', 'update', 'delete'], and optionally set<br>
+acl_entry.batch_id to a string of your choice.<br>
+ <br>
+Then, put all of your modified AclEntry objects into a list and pass<br>
+that list as the entries parameter.<br>
+ <br>
+Args:<br>
+ resource: gdata.docs.data.Resource to which the given entries belong.<br>
+ entries: [gdata.docs.data.AclEntry] to modify in some way.<br>
+ kwargs: Other args to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#DocsClient-post">post</a>()<br>
+ <br>
+Returns:<br>
+ Resulting gdata.docs.data.AclFeed of changes.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-copy_resource"><strong>copy_resource</strong></a>(self, entry, title, **kwargs)</dt><dd><tt>Copies the given entry to a new entry with the given title.<br>
+ <br>
+Note: Files do not support this feature.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Resource to copy.<br>
+ title: String title for the new entry.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Resource representing duplicated resource.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-create_archive"><strong>create_archive</strong></a>(self, entry, **kwargs)</dt><dd><tt>Creates a new archive of resources.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Archive representing metadata of archive to<br>
+ create.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Archive containing information about new archive.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-create_resource"><strong>create_resource</strong></a>(self, entry, media<font color="#909090">=None</font>, collection<font color="#909090">=None</font>, create_uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates new entries in Google Docs, and uploads their contents.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Resource representing initial version<br>
+ of entry being created. If media is also provided, the entry will<br>
+ first be created with the given metadata and content.<br>
+ media: (optional) gdata.data.MediaSource containing the file to be<br>
+ uploaded.<br>
+ collection: (optional) gdata.docs.data.Resource representing a collection<br>
+ in which this new entry should be created. If provided along<br>
+ with create_uri, create_uri will win (e.g. entry will be created at<br>
+ create_uri, not necessarily in given collection).<br>
+ create_uri: (optional) String URI at which to create the given entry. If<br>
+ collection, media and create_uri are None, use<br>
+ gdata.docs.client.RESOURCE_FEED_URI. If collection and create_uri are<br>
+ None, use gdata.docs.client.RESOURCE_UPLOAD_URI. If collection and<br>
+ media are not None,<br>
+ collection.GetResumableCreateMediaLink() is used,<br>
+ with the collection's resource ID substituted in.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-post">post</a>() and <a href="#DocsClient-update">update</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Resource containing information about new entry.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-delete_acl_entry"><strong>delete_acl_entry</strong></a>(self, entry, **kwargs)</dt><dd><tt>Deletes the given AclEntry.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.AclEntry to delete.<br>
+ kwargs: Other args to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#DocsClient-Delete">Delete</a>()<br>
+ <br>
+Returns:<br>
+ Result of delete request.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-delete_archive"><strong>delete_archive</strong></a>(self, entry, **kwargs)</dt><dd><tt>Aborts the given Archive operation, or deletes the Archive.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Archive to delete.<br>
+ kwargs: Other args to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#DocsClient-Delete">Delete</a>()<br>
+ <br>
+Returns:<br>
+ Result of delete request.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-delete_resource"><strong>delete_resource</strong></a>(self, entry, permanent<font color="#909090">=False</font>, **kwargs)</dt><dd><tt>Trashes or deletes the given entry.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Resource to trash or delete.<br>
+ permanent: True to skip the trash and delete the entry forever.<br>
+ kwargs: Other args to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#DocsClient-Delete">Delete</a>()<br>
+ <br>
+Returns:<br>
+ Result of delete request.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-delete_revision"><strong>delete_revision</strong></a>(self, entry, **kwargs)</dt><dd><tt>Deletes the given Revision.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Revision to delete.<br>
+ kwargs: Other args to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#DocsClient-Delete">Delete</a>()<br>
+ <br>
+Returns:<br>
+ Result of delete request.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-download_archive"><strong>download_archive</strong></a> = <a href="#DocsClient-download_resource">download_resource</a>(self, entry, file_path, extra_params<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-download_archive_to_memory"><strong>download_archive_to_memory</strong></a> = <a href="#DocsClient-download_resource_to_memory">download_resource_to_memory</a>(self, entry, extra_params<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-download_resource"><strong>download_resource</strong></a>(self, entry, file_path, extra_params<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Downloads the contents of the given entry to disk.<br>
+ <br>
+Note: to download a file in memory, use the <a href="#DocsClient-DownloadResourceToMemory">DownloadResourceToMemory</a>()<br>
+method.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Resource whose contents to fetch.<br>
+ file_path: str Full path to which to save file.<br>
+ extra_params: dict (optional) A map of any further parameters to control<br>
+ how the document is downloaded/exported. For example, exporting a<br>
+ spreadsheet as a .csv: extra_params={'gid': 0, 'exportFormat': 'csv'}<br>
+ kwargs: Other parameters to pass to _download_file().<br>
+ <br>
+Raises:<br>
+ gdata.client.RequestError if the download URL is malformed or the server's<br>
+ response was not successful.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-download_resource_to_memory"><strong>download_resource_to_memory</strong></a>(self, entry, extra_params<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Returns the contents of the given entry.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Resource whose contents to fetch.<br>
+ extra_params: dict (optional) A map of any further parameters to control<br>
+ how the document is downloaded/exported. For example, exporting a<br>
+ spreadsheet as a .csv: extra_params={'gid': 0, 'exportFormat': 'csv'}<br>
+ kwargs: Other parameters to pass to _get_content().<br>
+ <br>
+Returns:<br>
+ Content of given resource after being downloaded.<br>
+ <br>
+Raises:<br>
+ gdata.client.RequestError if the download URL is malformed or the server's<br>
+ response was not successful.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-download_revision"><strong>download_revision</strong></a>(self, entry, file_path, extra_params<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Downloads the contents of the given revision to disk.<br>
+ <br>
+Note: to download a revision in memory, use the <a href="#DocsClient-DownloadRevisionToMemory">DownloadRevisionToMemory</a>()<br>
+method.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Revision whose contents to fetch.<br>
+ file_path: str Full path to which to save file.<br>
+ extra_params: dict (optional) A map of any further parameters to control<br>
+ how the document is downloaded.<br>
+ kwargs: Other parameters to pass to _download_file().<br>
+ <br>
+Raises:<br>
+ gdata.client.RequestError if the download URL is malformed or the server's<br>
+ response was not successful.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-download_revision_to_memory"><strong>download_revision_to_memory</strong></a>(self, entry, extra_params<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Returns the contents of the given revision.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Revision whose contents to fetch.<br>
+ extra_params: dict (optional) A map of any further parameters to control<br>
+ how the document is downloaded/exported.<br>
+ kwargs: Other parameters to pass to _get_content().<br>
+ <br>
+Returns:<br>
+ Content of given revision after being downloaded.<br>
+ <br>
+Raises:<br>
+ gdata.client.RequestError if the download URL is malformed or the server's<br>
+ response was not successful.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_acl"><strong>get_acl</strong></a>(self, entry, **kwargs)</dt><dd><tt>Retrieves an AclFeed for the given resource.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Resource to fetch AclFeed for.<br>
+ kwargs: Other args to pass to <a href="#DocsClient-GetFeed">GetFeed</a>().<br>
+Returns:<br>
+ gdata.docs.data.AclFeed representing retrieved entries.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_acl_entry"><strong>get_acl_entry</strong></a>(self, entry, **kwargs)</dt><dd><tt>Retrieves an AclEntry again.<br>
+ <br>
+This is useful if you need to poll for an ACL changing.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.AclEntry to fetch and return.<br>
+ kwargs: Other args to pass to <a href="#DocsClient-GetAclEntryBySelfLink">GetAclEntryBySelfLink</a>().<br>
+Returns:<br>
+ gdata.docs.data.AclEntry representing retrieved entry.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_acl_entry_by_self_link"><strong>get_acl_entry_by_self_link</strong></a>(self, self_link, **kwargs)</dt><dd><tt>Retrieves a particular AclEntry by its self link.<br>
+ <br>
+Args:<br>
+ self_link: URI at which to query for given ACL entry. This can be found<br>
+ using entry.GetSelfLink().<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-get_entry">get_entry</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.AclEntry representing the retrieved entry.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_all_resources"><strong>get_all_resources</strong></a>(self, uri<font color="#909090">=None</font>, show_root<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves all of a user's non-collections or everything at the given URI.<br>
+ <br>
+Folders are not included in this by default. Pass in a custom URI to<br>
+include collections in your query. The <a href="#DocsQuery">DocsQuery</a> class is an easy way to<br>
+generate such a URI.<br>
+ <br>
+This method makes multiple HTTP requests (by following the feed's next<br>
+links) in order to fetch the user's entire document list.<br>
+ <br>
+Args:<br>
+ uri: (optional) URI to query the doclist feed with. If None, then use<br>
+ <a href="#DocsClient">DocsClient</a>.RESOURCE_FEED_URI, which will retrieve all<br>
+ non-collections.<br>
+ show_root: (optional) True to include indications if a resource is in<br>
+ the root collection.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-GetResources">GetResources</a>().<br>
+ <br>
+Returns:<br>
+ List of gdata.docs.data.Resource objects representing the retrieved<br>
+ entries.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_archive"><strong>get_archive</strong></a>(self, entry, **kwargs)</dt><dd><tt>Retrieves an archive again given its entry.<br>
+ <br>
+This is useful if you need to poll for an archive completing.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Archive to fetch and return.<br>
+ kwargs: Other args to pass to <a href="#DocsClient-GetArchiveBySelfLink">GetArchiveBySelfLink</a>().<br>
+Returns:<br>
+ gdata.docs.data.Archive representing retrieved archive.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_archive_by_self_link"><strong>get_archive_by_self_link</strong></a>(self, self_link, **kwargs)</dt><dd><tt>Retrieves a particular archive by its self link.<br>
+ <br>
+Args:<br>
+ self_link: URI at which to query for given archive. This can be found<br>
+ using entry.GetSelfLink().<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-get_entry">get_entry</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Archive representing the retrieved archive.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_changes"><strong>get_changes</strong></a>(self, changestamp<font color="#909090">=None</font>, max_results<font color="#909090">=None</font>, show_root<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves changes to a user's documents list.<br>
+ <br>
+Args:<br>
+ changestamp: (optional) String changestamp value to query since.<br>
+ If provided, returned changes will have a changestamp larger than<br>
+ the given one.<br>
+ max_results: (optional) Number of results to fetch. API will limit<br>
+ this number to 100 at most.<br>
+ show_root: (optional) True to include indications if a resource is in<br>
+ the root collection.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-get_feed">get_feed</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.ChangeFeed.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_metadata"><strong>get_metadata</strong></a>(self, **kwargs)</dt><dd><tt>Retrieves the metadata of a user account.<br>
+ <br>
+Args:<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-get_entry">get_entry</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Metadata representing metadata of user's account.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_resource"><strong>get_resource</strong></a>(self, entry, **kwargs)</dt><dd><tt>Retrieves a resource again given its entry.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Resource to fetch and return.<br>
+ kwargs: Other args to pass to <a href="#DocsClient-GetResourceBySelfLink">GetResourceBySelfLink</a>().<br>
+Returns:<br>
+ gdata.docs.data.Resource representing retrieved resource.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_resource_acl"><strong>get_resource_acl</strong></a>(self, entry, **kwargs)</dt><dd><tt>Retrieves the ACL sharing permissions for the given entry.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Resource for which to get ACL.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-get_feed">get_feed</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.AclFeed representing the resource's ACL.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_resource_by_id"><strong>get_resource_by_id</strong></a>(self, resource_id, **kwargs)</dt><dd><tt>Retrieves a resource again given its resource ID.<br>
+ <br>
+Args:<br>
+ resource_id: Typed or untyped resource ID of a resource.<br>
+ kwargs: Other args to pass to <a href="#DocsClient-GetResourceBySelfLink">GetResourceBySelfLink</a>().<br>
+Returns:<br>
+ gdata.docs.data.Resource representing retrieved resource.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_resource_by_self_link"><strong>get_resource_by_self_link</strong></a>(self, uri, etag<font color="#909090">=None</font>, show_root<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves a particular resource by its self link.<br>
+ <br>
+Args:<br>
+ uri: str URI at which to query for given resource. This can be found<br>
+ using entry.GetSelfLink().<br>
+ etag: str (optional) The document/item's etag value to be used in a<br>
+ conditional GET. See <a href="http://code.google.com/apis/documents/docs/3.0/">http://code.google.com/apis/documents/docs/3.0/</a><br>
+ developers_guide_protocol.html#RetrievingCached.<br>
+ show_root: (optional) True to include indications if a resource is in<br>
+ the root collection.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-get_entry">get_entry</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Resource representing the retrieved resource.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_resources"><strong>get_resources</strong></a>(self, uri<font color="#909090">=None</font>, limit<font color="#909090">=None</font>, show_root<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves the resources in a user's docslist, or the given URI.<br>
+ <br>
+Args:<br>
+ uri: (optional) URI to query for resources. If None, then<br>
+ gdata.docs.client.<a href="#DocsClient">DocsClient</a>.RESOURCE_FEED_URI is used, which will<br>
+ query for all non-collections.<br>
+ limit: int (optional) A maximum cap for the number of results to<br>
+ return in the feed. By default, the API returns a maximum of 100<br>
+ per page. Thus, if you set limit=5000, you will get <= 5000<br>
+ documents (guarenteed no more than 5000), and will need to follow the<br>
+ feed's next links (feed.GetNextLink()) to the rest. See<br>
+ get_everything(). Similarly, if you set limit=50, only <= 50<br>
+ documents are returned. Note: if the max-results parameter is set in<br>
+ the uri parameter, it is chosen over a value set for limit.<br>
+ show_root: (optional) True to include indications if a resource is in<br>
+ the root collection.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-get_feed">get_feed</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.ResourceFeed feed.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_revision"><strong>get_revision</strong></a>(self, entry, **kwargs)</dt><dd><tt>Retrieves a revision again given its entry.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Revision to fetch and return.<br>
+ kwargs: Other args to pass to <a href="#DocsClient-GetRevisionBySelfLink">GetRevisionBySelfLink</a>().<br>
+Returns:<br>
+ gdata.docs.data.Revision representing retrieved revision.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_revision_by_self_link"><strong>get_revision_by_self_link</strong></a>(self, self_link, **kwargs)</dt><dd><tt>Retrieves a particular reivision by its self link.<br>
+ <br>
+Args:<br>
+ self_link: URI at which to query for given revision. This can be found<br>
+ using entry.GetSelfLink().<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-get_entry">get_entry</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Revision representing the retrieved revision.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_revisions"><strong>get_revisions</strong></a>(self, entry, **kwargs)</dt><dd><tt>Retrieves the revision history for a resource.<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Resource for which to get revisions.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-get_feed">get_feed</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.RevisionFeed representing the resource's revisions.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-move_resource"><strong>move_resource</strong></a>(self, entry, collection<font color="#909090">=None</font>, keep_in_collections<font color="#909090">=False</font>, **kwargs)</dt><dd><tt>Moves an item into a different collection (or out of all collections).<br>
+ <br>
+Args:<br>
+ entry: gdata.docs.data.Resource to move.<br>
+ collection: gdata.docs.data.Resource (optional) An object representing<br>
+ the destination collection. If None, set keep_in_collections to<br>
+ False to remove the item from all collections.<br>
+ keep_in_collections: boolean (optional) If True, the given entry<br>
+ is not removed from any existing collections it is already in.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Resource of the moved entry.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-publish_revision"><strong>publish_revision</strong></a>(self, entry, publish_auto<font color="#909090">=None</font>, publish_outside_domain<font color="#909090">=False</font>, **kwargs)</dt><dd><tt>Publishes the given revision.<br>
+ <br>
+This method can only be used for document revisions.<br>
+ <br>
+Args:<br>
+ entry: Revision to update.<br>
+ publish_auto: True to automatically publish future revisions of the<br>
+ document. False to not automatically publish future revisions.<br>
+ None to take no action and use the default value.<br>
+ publish_outside_domain: True to make the published revision available<br>
+ outside of a Google Apps domain. False to not publish outside<br>
+ the domain. None to use the default value.<br>
+ kwargs: Other parameters to pass to super(<a href="#DocsClient">DocsClient</a>, self).<a href="#DocsClient-update">update</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Revision representing the updated revision.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Add support for imitating other users via 2-Legged OAuth.<br>
+ <br>
+Args:<br>
+ uri: (optional) URI of the request in which to replace default with<br>
+ self.<strong>xoauth_requestor_id</strong>.<br>
+Returns:<br>
+ Result of super(<a href="#DocsClient">DocsClient</a>, self).<a href="#DocsClient-request">request</a>().</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-unpublish_revision"><strong>unpublish_revision</strong></a>(self, entry, **kwargs)</dt><dd><tt>Unpublishes the given revision.<br>
+ <br>
+This method can only be used for document revisions.<br>
+ <br>
+Args:<br>
+ entry: Revision to update.<br>
+ kwargs: Other parameters to pass to super(<a href="#DocsClient">DocsClient</a>, self).<a href="#DocsClient-update">update</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Revision representing the updated revision.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-update_acl_entry"><strong>update_acl_entry</strong></a>(self, entry, send_notifications<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Updates the given AclEntry with new metadata.<br>
+ <br>
+Args:<br>
+ entry: AclEntry to update. Make any metadata changes to this entry.<br>
+ send_notifications: True if users should be notified by email when<br>
+ this AclEntry is updated.<br>
+ kwargs: Other parameters to pass to super(<a href="#DocsClient">DocsClient</a>, self).<a href="#DocsClient-update">update</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.AclEntry representing the updated ACL entry.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-update_archive"><strong>update_archive</strong></a>(self, entry, **kwargs)</dt><dd><tt>Updates the given Archive with new metadata.<br>
+ <br>
+This method is really only useful for updating the notification email<br>
+address of an archive that is being processed.<br>
+ <br>
+Args:<br>
+ entry: Archive to update. Make any metadata changes to this entry.<br>
+ kwargs: Other parameters to pass to super(<a href="#DocsClient">DocsClient</a>, self).<a href="#DocsClient-update">update</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Archive representing the updated archive.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-update_resource"><strong>update_resource</strong></a>(self, entry, media<font color="#909090">=None</font>, update_metadata<font color="#909090">=True</font>, new_revision<font color="#909090">=False</font>, **kwargs)</dt><dd><tt>Updates an entry in Google Docs with new metadata and/or new data.<br>
+ <br>
+Args:<br>
+ entry: Entry to update. Make any metadata changes to this entry.<br>
+ media: (optional) gdata.data.MediaSource object containing the file with<br>
+ which to replace the entry's data.<br>
+ update_metadata: (optional) True to update the metadata from the entry<br>
+ itself. You might set this to False to only update an entry's<br>
+ file content, and not its metadata.<br>
+ new_revision: (optional) True to create a new revision with this update,<br>
+ False otherwise.<br>
+ kwargs: Other parameters to pass to <a href="#DocsClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.docs.data.Resource representing the updated entry.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>alt_auth_service</strong> = 'wise'</dl>
+
+<dl><dt><strong>alt_auth_token</strong> = None</dl>
+
+<dl><dt><strong>api_version</strong> = '3.0'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://docs.google.com/feeds/', 'https://spreadsheets.google.com/feeds/', 'https://docs.googleusercontent.com/')</dl>
+
+<dl><dt><strong>auth_service</strong> = 'writely'</dl>
+
+<dl><dt><strong>host</strong> = 'docs.google.com'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="DocsClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="DocsClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DocsClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="DocsClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="DocsClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-__init__"><strong>__init__</strong></a>(self, http_client<font color="#909090">=None</font>, host<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, source<font color="#909090">=None</font>, xoauth_requestor_id<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new AtomPubClient instance.<br>
+ <br>
+Args:<br>
+ source: The name of your application.<br>
+ http_client: An object capable of performing HTTP requests through a<br>
+ request method. This object is used to perform the request<br>
+ when the AtomPubClient's request method is called. Used to<br>
+ allow HTTP requests to be directed to a mock server, or use<br>
+ an alternate library instead of the default of httplib to<br>
+ make HTTP requests.<br>
+ host: str The default host name to use if a host is not specified in the<br>
+ requested URI.<br>
+ auth_token: An object which sets the HTTP Authorization header when its<br>
+ modify_request method is called.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="DocsClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DocsQuery">class <strong>DocsQuery</strong></a>(<a href="gdata.client.html#Query">gdata.client.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.client.html#DocsQuery">DocsQuery</a></dd>
+<dd><a href="gdata.client.html#Query">gdata.client.Query</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="DocsQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#DocsQuery-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="DocsQuery-__init__"><strong>__init__</strong></a>(self, title<font color="#909090">=None</font>, title_exact<font color="#909090">=None</font>, opened_min<font color="#909090">=None</font>, opened_max<font color="#909090">=None</font>, edited_min<font color="#909090">=None</font>, edited_max<font color="#909090">=None</font>, owner<font color="#909090">=None</font>, writer<font color="#909090">=None</font>, reader<font color="#909090">=None</font>, show_collections<font color="#909090">=None</font>, show_root<font color="#909090">=None</font>, show_deleted<font color="#909090">=None</font>, ocr<font color="#909090">=None</font>, target_language<font color="#909090">=None</font>, source_language<font color="#909090">=None</font>, convert<font color="#909090">=None</font>, query<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a query URL for the Google Documents List API.<br>
+ <br>
+Args:<br>
+ title: str (optional) Specifies the search terms for the title of a<br>
+ document. This parameter used without title_exact will only<br>
+ submit partial queries, not exact queries.<br>
+ title_exact: str (optional) Meaningless without title. Possible values<br>
+ are 'true' and 'false'. Note: Matches are case-insensitive.<br>
+ opened_min: str (optional) Lower bound on the last time a document was<br>
+ opened by the current user. Use the <a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC 3339</a> timestamp<br>
+ format. For example: opened_min='2005-08-09T09:57:00-08:00'.<br>
+ opened_max: str (optional) Upper bound on the last time a document was<br>
+ opened by the current user. (See also opened_min.)<br>
+ edited_min: str (optional) Lower bound on the last time a document was<br>
+ edited by the current user. This value corresponds to the edited.text<br>
+ value in the doc's entry object, which represents changes to the<br>
+ document's content or metadata. Use the <a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC 3339</a> timestamp format.<br>
+ For example: edited_min='2005-08-09T09:57:00-08:00'<br>
+ edited_max: str (optional) Upper bound on the last time a document was<br>
+ edited by the user. (See also edited_min.)<br>
+ owner: str (optional) Searches for documents with a specific owner. Use<br>
+ the email address of the owner. For example: owner='user@gmail.com'<br>
+ writer: str (optional) Searches for documents which can be written to<br>
+ by specific users. Use a single email address or a comma separated list<br>
+ of email addresses. For example: writer='user1@gmail.com,user@example.com'<br>
+ reader: str (optional) Searches for documents which can be read by<br>
+ specific users. (See also writer.)<br>
+ show_collections: str (optional) Specifies whether the query should return<br>
+ collections as well as documents and files. Possible values are 'true'<br>
+ and 'false'. Default is 'false'.<br>
+ show_root: (optional) 'true' to specify when an item is in the root<br>
+ collection. Default is 'false'<br>
+ show_deleted: str (optional) Specifies whether the query should return<br>
+ documents which are in the trash as well as other documents.<br>
+ Possible values are 'true' and 'false'. Default is false.<br>
+ ocr: str (optional) Specifies whether to attempt OCR on a .jpg, .png, or<br>
+ .gif upload. Possible values are 'true' and 'false'. Default is<br>
+ false. See OCR in the Protocol Guide:<br>
+ <a href="http://code.google.com/apis/documents/docs/3.0/developers_guide_protocol.html#OCR">http://code.google.com/apis/documents/docs/3.0/developers_guide_protocol.html#OCR</a><br>
+ target_language: str (optional) Specifies the language to translate a<br>
+ document into. See Document Translation in the Protocol Guide for a<br>
+ table of possible values:<br>
+ <a href="http://code.google.com/apis/documents/docs/3.0/developers_guide_protocol.html#DocumentTranslation">http://code.google.com/apis/documents/docs/3.0/developers_guide_protocol.html#DocumentTranslation</a><br>
+ source_language: str (optional) Specifies the source language of the<br>
+ original document. Optional when using the translation service.<br>
+ If not provided, Google will attempt to auto-detect the source<br>
+ language. See Document Translation in the Protocol Guide for a table of<br>
+ possible values (link in target_language).<br>
+ convert: str (optional) Used when uploading files specify if document uploads<br>
+ should convert to a native Google Docs format.<br>
+ Possible values are 'true' and 'false'. The default is 'true'.<br>
+ query: str (optional) Full-text query to use. See the 'q' parameter in<br>
+ the documentation.</tt></dd></dl>
+
+<dl><dt><a name="DocsQuery-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><a name="DocsQuery-AddCustomParameter"><strong>AddCustomParameter</strong></a> = add_custom_parameter(self, key, value)</dt></dl>
+
+<dl><dt><a name="DocsQuery-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ARCHIVE_FEED_URI</strong> = '/feeds/default/private/archive'<br>
+<strong>CHANGE_FEED_URI</strong> = '/feeds/default/private/changes'<br>
+<strong>METADATA_URI</strong> = '/feeds/metadata/default'<br>
+<strong>RESOURCE_FEED_URI</strong> = '/feeds/default/private/full'<br>
+<strong>RESOURCE_SELF_LINK_TEMPLATE</strong> = '/feeds/default/private/full/%s'<br>
+<strong>RESOURCE_UPLOAD_URI</strong> = '/feeds/upload/create-session/default/private/full'<br>
+<strong>__author__</strong> = 'vicfryzel@google.com (Vic Fryzel)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">vicfryzel@google.com (Vic Fryzel)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.docs.data.html b/pydocs/gdata.docs.data.html
new file mode 100644
index 0000000..f3573c8
--- /dev/null
+++ b/pydocs/gdata.docs.data.html
@@ -0,0 +1,9664 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.docs.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.docs.html"><font color="#ffffff">docs</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/docs/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/docs/data.py</a></font></td></tr></table>
+ <p><tt>Data model classes for representing elements of the Documents List API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#CategoryFinder">CategoryFinder</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Resource">Resource</a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>, <a href="gdata.docs.data.html#CategoryFinder">CategoryFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Change">Change</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#AdditionalRoleInfo">AdditionalRoleInfo</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#AdditionalRoleSet">AdditionalRoleSet</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ArchiveComplete">ArchiveComplete</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ArchiveConversion">ArchiveConversion</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ArchiveFailure">ArchiveFailure</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ArchiveNotify">ArchiveNotify</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ArchiveNotifyStatus">ArchiveNotifyStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ArchiveResourceId">ArchiveResourceId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ArchiveStatus">ArchiveStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ArchiveTotal">ArchiveTotal</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ArchiveTotalComplete">ArchiveTotalComplete</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ArchiveTotalFailure">ArchiveTotalFailure</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Changestamp">Changestamp</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Deleted">Deleted</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Description">Description</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ExportFormat">ExportFormat</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Feature">Feature</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#FeatureName">FeatureName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#FeatureRate">FeatureRate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Filename">Filename</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ImportFormat">ImportFormat</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#MaxUploadSize">MaxUploadSize</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Publish">Publish</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#PublishAuto">PublishAuto</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#PublishOutsideDomain">PublishOutsideDomain</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#QuotaBytesTotal">QuotaBytesTotal</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#QuotaBytesUsed">QuotaBytesUsed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#QuotaBytesUsedInTrash">QuotaBytesUsedInTrash</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Removed">Removed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ResourceId">ResourceId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#SuggestedFilename">SuggestedFilename</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#WritersCanInvite">WritersCanInvite</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Person">atom.data.Person</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#LastModifiedBy">LastModifiedBy</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#LastViewed">LastViewed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#AclEntry">AclEntry</a>(<a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a>, <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclFeed">gdata.acl.data.AclFeed</a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#AclFeed">AclFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#AclEntry">AclEntry</a>(<a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a>, <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Resource">Resource</a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>, <a href="gdata.docs.data.html#CategoryFinder">CategoryFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Change">Change</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ResourceFeed">ResourceFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Archive">Archive</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Metadata">Metadata</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#Revision">Revision</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.data.html#ChangeFeed">ChangeFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.data.html#RevisionFeed">RevisionFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AclEntry">class <strong>AclEntry</strong></a>(<a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a>, <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Resource">Resource</a> ACL entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#AclEntry">AclEntry</a></dd>
+<dd><a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Static methods defined here:<br>
+<dl><dt><a name="AclEntry-GetInstance"><strong>GetInstance</strong></a> = get_instance(role<font color="#909090">=None</font>, scope_type<font color="#909090">=None</font>, scope_value<font color="#909090">=None</font>, key<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_instance"><strong>get_instance</strong></a>(role<font color="#909090">=None</font>, scope_type<font color="#909090">=None</font>, scope_value<font color="#909090">=None</font>, key<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a>:<br>
+<dl><dt><strong>additional_role</strong> = <class 'gdata.acl.data.AclAdditionalRole'><dd><tt>Describes an additionalRole element.</tt></dl>
+
+<dl><dt><strong>role</strong> = <class 'gdata.acl.data.AclRole'><dd><tt>Describes the role of an entry in an access control list.</tt></dl>
+
+<dl><dt><strong>scope</strong> = <class 'gdata.acl.data.AclScope'><dd><tt>Describes the scope of an entry in an access control list.</tt></dl>
+
+<dl><dt><strong>with_key</strong> = <class 'gdata.acl.data.AclWithKey'><dd><tt>Describes a key that can be used to access a document.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="AclEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="AclEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AclEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AclFeed">class <strong>AclFeed</strong></a>(<a href="gdata.acl.data.html#AclFeed">gdata.acl.data.AclFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Resource">Resource</a> ACL feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#AclFeed">AclFeed</a></dd>
+<dd><a href="gdata.acl.data.html#AclFeed">gdata.acl.data.AclFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.docs.data.AclEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="AclFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="AclFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AclFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AdditionalRoleInfo">class <strong>AdditionalRoleInfo</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:additionalRoleInfo element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#AdditionalRoleInfo">AdditionalRoleInfo</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>additional_role_set</strong> = [<class 'gdata.docs.data.AdditionalRoleSet'>]</dl>
+
+<dl><dt><strong>kind</strong> = 'kind'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AdditionalRoleInfo-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleInfo-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleInfo-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleInfo-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleInfo-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleInfo-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AdditionalRoleInfo-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AdditionalRoleInfo-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleInfo-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleInfo-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AdditionalRoleSet">class <strong>AdditionalRoleSet</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:additionalRoleSet element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#AdditionalRoleSet">AdditionalRoleSet</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>additional_role</strong> = [<class 'gdata.acl.data.AclAdditionalRole'>]</dl>
+
+<dl><dt><strong>primaryRole</strong> = 'primaryRole'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AdditionalRoleSet-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleSet-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleSet-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleSet-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleSet-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleSet-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="AdditionalRoleSet-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AdditionalRoleSet-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleSet-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AdditionalRoleSet-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Archive">class <strong>Archive</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Archive">Archive</a> entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Archive">Archive</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Static methods defined here:<br>
+<dl><dt><a name="Archive-FromResourceList"><strong>FromResourceList</strong></a> = from_resource_list(resources)</dt></dl>
+
+<dl><dt><a name="Archive-from_resource_list"><strong>from_resource_list</strong></a>(resources)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>archive_resource_ids</strong> = [<class 'gdata.docs.data.ArchiveResourceId'>]</dl>
+
+<dl><dt><strong>conversions</strong> = [<class 'gdata.docs.data.ArchiveConversion'>]</dl>
+
+<dl><dt><strong>date_completed</strong> = <class 'gdata.docs.data.ArchiveComplete'><dd><tt>The DocList docs:archiveComplete element.</tt></dl>
+
+<dl><dt><strong>failed_resource_ids</strong> = [<class 'gdata.docs.data.ArchiveFailure'>]</dl>
+
+<dl><dt><strong>notification_email</strong> = <class 'gdata.docs.data.ArchiveNotify'><dd><tt>The DocList docs:archiveNotify element.</tt></dl>
+
+<dl><dt><strong>notify_status</strong> = <class 'gdata.docs.data.ArchiveNotifyStatus'><dd><tt>The DocList docs:archiveNotifyStatus element.</tt></dl>
+
+<dl><dt><strong>num_complete_resources</strong> = <class 'gdata.docs.data.ArchiveTotalComplete'><dd><tt>The DocList docs:archiveTotalComplete element.</tt></dl>
+
+<dl><dt><strong>num_failed_resources</strong> = <class 'gdata.docs.data.ArchiveTotalFailure'><dd><tt>The DocList docs:archiveTotalFailure element.</tt></dl>
+
+<dl><dt><strong>num_resources</strong> = <class 'gdata.docs.data.ArchiveTotal'><dd><tt>The DocList docs:archiveTotal element.</tt></dl>
+
+<dl><dt><strong>size</strong> = <class 'gdata.docs.data.QuotaBytesUsed'><dd><tt>The DocList gd:quotaBytesUsed element.</tt></dl>
+
+<dl><dt><strong>status</strong> = <class 'gdata.docs.data.ArchiveStatus'><dd><tt>The DocList docs:archiveStatus element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="Archive-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Archive-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="Archive-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="Archive-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Archive-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="Archive-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Archive-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Archive-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Archive-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Archive-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Archive-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Archive-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Archive-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Archive-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="Archive-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Archive-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Archive-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Archive-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Archive-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Archive-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Archive-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="Archive-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Archive-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Archive-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Archive-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Archive-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Archive-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Archive-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Archive-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Archive-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ArchiveComplete">class <strong>ArchiveComplete</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:archiveComplete element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ArchiveComplete">ArchiveComplete</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ArchiveComplete-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveComplete-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveComplete-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveComplete-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveComplete-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveComplete-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ArchiveComplete-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ArchiveComplete-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveComplete-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveComplete-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ArchiveConversion">class <strong>ArchiveConversion</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:removed element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ArchiveConversion">ArchiveConversion</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>source</strong> = 'source'</dl>
+
+<dl><dt><strong>target</strong> = 'target'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ArchiveConversion-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveConversion-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveConversion-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveConversion-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveConversion-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveConversion-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ArchiveConversion-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ArchiveConversion-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveConversion-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveConversion-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ArchiveFailure">class <strong>ArchiveFailure</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:archiveFailure element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ArchiveFailure">ArchiveFailure</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ArchiveFailure-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveFailure-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveFailure-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveFailure-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveFailure-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveFailure-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ArchiveFailure-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ArchiveFailure-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveFailure-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveFailure-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ArchiveNotify">class <strong>ArchiveNotify</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:archiveNotify element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ArchiveNotify">ArchiveNotify</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ArchiveNotify-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotify-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotify-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotify-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotify-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotify-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ArchiveNotify-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ArchiveNotify-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotify-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotify-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ArchiveNotifyStatus">class <strong>ArchiveNotifyStatus</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:archiveNotifyStatus element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ArchiveNotifyStatus">ArchiveNotifyStatus</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ArchiveNotifyStatus-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotifyStatus-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotifyStatus-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotifyStatus-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotifyStatus-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotifyStatus-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ArchiveNotifyStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ArchiveNotifyStatus-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotifyStatus-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveNotifyStatus-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ArchiveResourceId">class <strong>ArchiveResourceId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:removed element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ArchiveResourceId">ArchiveResourceId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ArchiveResourceId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveResourceId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveResourceId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveResourceId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveResourceId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveResourceId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ArchiveResourceId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ArchiveResourceId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveResourceId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveResourceId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ArchiveStatus">class <strong>ArchiveStatus</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:archiveStatus element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ArchiveStatus">ArchiveStatus</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ArchiveStatus-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveStatus-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveStatus-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveStatus-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveStatus-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveStatus-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ArchiveStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ArchiveStatus-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveStatus-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveStatus-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ArchiveTotal">class <strong>ArchiveTotal</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:archiveTotal element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ArchiveTotal">ArchiveTotal</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ArchiveTotal-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotal-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotal-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotal-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotal-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotal-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ArchiveTotal-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ArchiveTotal-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotal-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotal-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ArchiveTotalComplete">class <strong>ArchiveTotalComplete</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:archiveTotalComplete element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ArchiveTotalComplete">ArchiveTotalComplete</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ArchiveTotalComplete-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalComplete-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalComplete-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalComplete-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalComplete-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalComplete-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ArchiveTotalComplete-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ArchiveTotalComplete-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalComplete-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalComplete-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ArchiveTotalFailure">class <strong>ArchiveTotalFailure</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:archiveTotalFailure element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ArchiveTotalFailure">ArchiveTotalFailure</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ArchiveTotalFailure-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalFailure-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalFailure-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalFailure-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalFailure-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalFailure-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ArchiveTotalFailure-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ArchiveTotalFailure-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalFailure-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ArchiveTotalFailure-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CategoryFinder">class <strong>CategoryFinder</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Mixin to provide category finding functionality.<br>
+ <br>
+Analogous to atom.data.LinkFinder, but a simpler API, specialized for<br>
+DocList categories.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="CategoryFinder-AddCategory"><strong>AddCategory</strong></a> = <a href="#CategoryFinder-add_category">add_category</a>(self, scheme, term, label)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-AddLabel"><strong>AddLabel</strong></a> = <a href="#CategoryFinder-add_label">add_label</a>(self, label)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-GetCategories"><strong>GetCategories</strong></a> = <a href="#CategoryFinder-get_categories">get_categories</a>(self, scheme)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-GetFirstCategory"><strong>GetFirstCategory</strong></a> = <a href="#CategoryFinder-get_first_category">get_first_category</a>(self, scheme)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-GetLabels"><strong>GetLabels</strong></a> = <a href="#CategoryFinder-get_labels">get_labels</a>(self)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-GetResourceType"><strong>GetResourceType</strong></a> = <a href="#CategoryFinder-get_resource_type">get_resource_type</a>(self)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-HasLabel"><strong>HasLabel</strong></a> = <a href="#CategoryFinder-has_label">has_label</a>(self, label)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-IsHidden"><strong>IsHidden</strong></a> = <a href="#CategoryFinder-is_hidden">is_hidden</a>(self)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-IsMine"><strong>IsMine</strong></a> = <a href="#CategoryFinder-is_mine">is_mine</a>(self)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-IsPrivate"><strong>IsPrivate</strong></a> = <a href="#CategoryFinder-is_private">is_private</a>(self)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-IsRestrictedDownload"><strong>IsRestrictedDownload</strong></a> = <a href="#CategoryFinder-is_restricted_download">is_restricted_download</a>(self)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-IsSharedWithDomain"><strong>IsSharedWithDomain</strong></a> = <a href="#CategoryFinder-is_shared_with_domain">is_shared_with_domain</a>(self)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-IsStarred"><strong>IsStarred</strong></a> = <a href="#CategoryFinder-is_starred">is_starred</a>(self)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-IsTrashed"><strong>IsTrashed</strong></a> = <a href="#CategoryFinder-is_trashed">is_trashed</a>(self)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-IsViewed"><strong>IsViewed</strong></a> = <a href="#CategoryFinder-is_viewed">is_viewed</a>(self)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-RemoveCategories"><strong>RemoveCategories</strong></a> = <a href="#CategoryFinder-remove_categories">remove_categories</a>(self, scheme)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-RemoveLabel"><strong>RemoveLabel</strong></a> = <a href="#CategoryFinder-remove_label">remove_label</a>(self, label)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-SetResourceType"><strong>SetResourceType</strong></a> = <a href="#CategoryFinder-set_resource_type">set_resource_type</a>(self, label)</dt></dl>
+
+<dl><dt><a name="CategoryFinder-add_category"><strong>add_category</strong></a>(self, scheme, term, label)</dt><dd><tt>Add a category for a scheme, term and label.<br>
+ <br>
+Args:<br>
+ scheme: The scheme for the category.<br>
+ term: The term for the category.<br>
+ label: The label for the category<br>
+ <br>
+Returns:<br>
+ The newly created atom.data.Category.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-add_label"><strong>add_label</strong></a>(self, label)</dt><dd><tt>Add a label, if it is not present.<br>
+ <br>
+Args:<br>
+ label: The str label to set</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-get_categories"><strong>get_categories</strong></a>(self, scheme)</dt><dd><tt>Fetch the category elements for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme to fetch the elements for.<br>
+ <br>
+Returns:<br>
+ Generator of atom.data.Category elements.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-get_first_category"><strong>get_first_category</strong></a>(self, scheme)</dt><dd><tt>Fetch the first category element for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme of category to return.<br>
+ <br>
+Returns:<br>
+ atom.data.Category if found or None.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-get_labels"><strong>get_labels</strong></a>(self)</dt><dd><tt>Extracts the labels for this <a href="#Resource">Resource</a>.<br>
+ <br>
+This method returns the labels as a set, for example: 'hidden', 'starred',<br>
+'viewed'.<br>
+ <br>
+Returns:<br>
+ Set of string labels.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-get_resource_type"><strong>get_resource_type</strong></a>(self)</dt><dd><tt>Extracts the type of document this <a href="#Resource">Resource</a> is.<br>
+ <br>
+This method returns the type of document the <a href="#Resource">Resource</a> represents. Possible<br>
+values are document, presentation, drawing, spreadsheet, file, folder,<br>
+form, item, or pdf.<br>
+ <br>
+'folder' is a possible return value of this method because, for legacy<br>
+support, we have not yet renamed the folder keyword to collection in<br>
+the API itself.<br>
+ <br>
+Returns:<br>
+ String representing the type of document.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-has_label"><strong>has_label</strong></a>(self, label)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> has a label.<br>
+ <br>
+Args:<br>
+ label: The str label to test for<br>
+ <br>
+Returns:<br>
+ Boolean value indicating presence of label.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-is_hidden"><strong>is_hidden</strong></a>(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is hidden.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is hidden.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-is_mine"><strong>is_mine</strong></a>(self)</dt><dd><tt>Whether this resource is marked as mine.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is marked as mine.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-is_private"><strong>is_private</strong></a>(self)</dt><dd><tt>Whether this resource is private.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is private.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-is_restricted_download"><strong>is_restricted_download</strong></a>(self)</dt><dd><tt>Whether this resource is restricted download.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating whether the resource is restricted download.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-is_shared_with_domain"><strong>is_shared_with_domain</strong></a>(self)</dt><dd><tt>Whether this resource is shared with the domain.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is shared with the domain.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-is_starred"><strong>is_starred</strong></a>(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is starred.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is starred.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-is_trashed"><strong>is_trashed</strong></a>(self)</dt><dd><tt>Whether this resource is trashed.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is trashed.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-is_viewed"><strong>is_viewed</strong></a>(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is viewed.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is viewed.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-remove_categories"><strong>remove_categories</strong></a>(self, scheme)</dt><dd><tt>Remove category elements for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme of category to remove.</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-remove_label"><strong>remove_label</strong></a>(self, label)</dt><dd><tt>Remove a label, if it is present.<br>
+ <br>
+Args:<br>
+ label: The str label to remove</tt></dd></dl>
+
+<dl><dt><a name="CategoryFinder-set_resource_type"><strong>set_resource_type</strong></a>(self, label)</dt><dd><tt>Set the document type for an entry, by building the appropriate<br>
+atom.data.Category<br>
+ <br>
+Args:<br>
+ label: str The value for the category entry. If None is passed the<br>
+ category is removed and not set.<br>
+ <br>
+Returns:<br>
+ An atom.data.Category or None if label is None.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Change">class <strong>Change</strong></a>(<a href="gdata.docs.data.html#Resource">Resource</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Change">Change</a> feed entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Change">Change</a></dd>
+<dd><a href="gdata.docs.data.html#Resource">Resource</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="gdata.docs.data.html#CategoryFinder">CategoryFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>changestamp</strong> = <class 'gdata.docs.data.Changestamp'><dd><tt>The DocList docs:changestamp element.</tt></dl>
+
+<dl><dt><strong>removed</strong> = <class 'gdata.docs.data.Removed'><dd><tt>The DocList docs:removed element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.docs.data.html#Resource">Resource</a>:<br>
+<dl><dt><a name="Change-GetAclFeedLink"><strong>GetAclFeedLink</strong></a> = get_acl_feed_link(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s ACL feed <gd:feedLink>.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetResumableCreateMediaLink"><strong>GetResumableCreateMediaLink</strong></a> = get_resumable_create_media_link(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s resumable create link.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetResumableEditMediaLink"><strong>GetResumableEditMediaLink</strong></a> = get_resumable_edit_media_link(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s resumable update link.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetRevisionsFeedLink"><strong>GetRevisionsFeedLink</strong></a> = get_revisions_feed_link(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s revisions feed <gd:feedLink>.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Change-InCollections"><strong>InCollections</strong></a> = in_collections(self)</dt><dd><tt>Returns the parents <a href="#Change-link">link</a>(s) (collections) of this entry.</tt></dd></dl>
+
+<dl><dt><a name="Change-__init__"><strong>__init__</strong></a>(self, type<font color="#909090">=None</font>, title<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="Change-get_acl_feed_link"><strong>get_acl_feed_link</strong></a>(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s ACL feed <gd:feedLink>.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Change-get_resumable_create_media_link"><strong>get_resumable_create_media_link</strong></a>(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s resumable create link.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Change-get_resumable_edit_media_link"><strong>get_resumable_edit_media_link</strong></a>(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s resumable update link.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Change-get_revisions_feed_link"><strong>get_revisions_feed_link</strong></a>(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s revisions feed <gd:feedLink>.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Change-in_collections"><strong>in_collections</strong></a>(self)</dt><dd><tt>Returns the parents <a href="#Change-link">link</a>(s) (collections) of this entry.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.docs.data.html#Resource">Resource</a>:<br>
+<dl><dt><strong>acl_feed</strong> = <class 'gdata.docs.data.AclFeed'><dd><tt><a href="#Resource">Resource</a> ACL feed.</tt></dl>
+
+<dl><dt><strong>deleted</strong> = <class 'gdata.docs.data.Deleted'><dd><tt>The DocList gd:deleted element.</tt></dl>
+
+<dl><dt><strong>description</strong> = <class 'gdata.docs.data.Description'><dd><tt>The DocList docs:description element.</tt></dl>
+
+<dl><dt><strong>feed_link</strong> = [<class 'gdata.data.FeedLink'>]</dl>
+
+<dl><dt><strong>filename</strong> = <class 'gdata.docs.data.Filename'><dd><tt>The DocList docs:filename element.</tt></dl>
+
+<dl><dt><strong>last_modified_by</strong> = <class 'gdata.docs.data.LastModifiedBy'><dd><tt>The DocList gd:lastModifiedBy element.</tt></dl>
+
+<dl><dt><strong>last_viewed</strong> = <class 'gdata.docs.data.LastViewed'><dd><tt>The DocList gd:lastViewed element.</tt></dl>
+
+<dl><dt><strong>quota_bytes_used</strong> = <class 'gdata.docs.data.QuotaBytesUsed'><dd><tt>The DocList gd:quotaBytesUsed element.</tt></dl>
+
+<dl><dt><strong>resource_id</strong> = <class 'gdata.docs.data.ResourceId'><dd><tt>The DocList gd:resourceId element.</tt></dl>
+
+<dl><dt><strong>suggested_filename</strong> = <class 'gdata.docs.data.SuggestedFilename'><dd><tt>The DocList docs:suggestedFilename element.</tt></dl>
+
+<dl><dt><strong>writers_can_invite</strong> = <class 'gdata.docs.data.WritersCanInvite'><dd><tt>The DocList docs:writersCanInvite element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="Change-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="Change-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="Change-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Change-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Change-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Change-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Change-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Change-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Change-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Change-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="Change-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="Change-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Change-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Change-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Change-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Change-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Change-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="Change-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="Change-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Change-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Change-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Change-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Change-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="Change-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Change-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Change-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Change-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Change-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Change-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Change-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Change-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Change-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Change-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Change-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Change-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Change-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Change-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Change-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Change-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Change-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.docs.data.html#CategoryFinder">CategoryFinder</a>:<br>
+<dl><dt><a name="Change-AddCategory"><strong>AddCategory</strong></a> = add_category(self, scheme, term, label)</dt><dd><tt>Add a category for a scheme, term and label.<br>
+ <br>
+Args:<br>
+ scheme: The scheme for the category.<br>
+ term: The term for the category.<br>
+ label: The label for the category<br>
+ <br>
+Returns:<br>
+ The newly created atom.data.Category.</tt></dd></dl>
+
+<dl><dt><a name="Change-AddLabel"><strong>AddLabel</strong></a> = add_label(self, label)</dt><dd><tt>Add a label, if it is not present.<br>
+ <br>
+Args:<br>
+ label: The str label to set</tt></dd></dl>
+
+<dl><dt><a name="Change-GetCategories"><strong>GetCategories</strong></a> = get_categories(self, scheme)</dt><dd><tt>Fetch the category elements for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme to fetch the elements for.<br>
+ <br>
+Returns:<br>
+ Generator of atom.data.Category elements.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetFirstCategory"><strong>GetFirstCategory</strong></a> = get_first_category(self, scheme)</dt><dd><tt>Fetch the first category element for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme of category to return.<br>
+ <br>
+Returns:<br>
+ atom.data.Category if found or None.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetLabels"><strong>GetLabels</strong></a> = get_labels(self)</dt><dd><tt>Extracts the labels for this <a href="#Resource">Resource</a>.<br>
+ <br>
+This method returns the labels as a set, for example: 'hidden', 'starred',<br>
+'viewed'.<br>
+ <br>
+Returns:<br>
+ Set of string labels.</tt></dd></dl>
+
+<dl><dt><a name="Change-GetResourceType"><strong>GetResourceType</strong></a> = get_resource_type(self)</dt><dd><tt>Extracts the type of document this <a href="#Resource">Resource</a> is.<br>
+ <br>
+This method returns the type of document the <a href="#Resource">Resource</a> represents. Possible<br>
+values are document, presentation, drawing, spreadsheet, file, folder,<br>
+form, item, or pdf.<br>
+ <br>
+'folder' is a possible return value of this method because, for legacy<br>
+support, we have not yet renamed the folder keyword to collection in<br>
+the API itself.<br>
+ <br>
+Returns:<br>
+ String representing the type of document.</tt></dd></dl>
+
+<dl><dt><a name="Change-HasLabel"><strong>HasLabel</strong></a> = has_label(self, label)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> has a label.<br>
+ <br>
+Args:<br>
+ label: The str label to test for<br>
+ <br>
+Returns:<br>
+ Boolean value indicating presence of label.</tt></dd></dl>
+
+<dl><dt><a name="Change-IsHidden"><strong>IsHidden</strong></a> = is_hidden(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is hidden.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is hidden.</tt></dd></dl>
+
+<dl><dt><a name="Change-IsMine"><strong>IsMine</strong></a> = is_mine(self)</dt><dd><tt>Whether this resource is marked as mine.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is marked as mine.</tt></dd></dl>
+
+<dl><dt><a name="Change-IsPrivate"><strong>IsPrivate</strong></a> = is_private(self)</dt><dd><tt>Whether this resource is private.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is private.</tt></dd></dl>
+
+<dl><dt><a name="Change-IsRestrictedDownload"><strong>IsRestrictedDownload</strong></a> = is_restricted_download(self)</dt><dd><tt>Whether this resource is restricted download.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating whether the resource is restricted download.</tt></dd></dl>
+
+<dl><dt><a name="Change-IsSharedWithDomain"><strong>IsSharedWithDomain</strong></a> = is_shared_with_domain(self)</dt><dd><tt>Whether this resource is shared with the domain.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is shared with the domain.</tt></dd></dl>
+
+<dl><dt><a name="Change-IsStarred"><strong>IsStarred</strong></a> = is_starred(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is starred.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is starred.</tt></dd></dl>
+
+<dl><dt><a name="Change-IsTrashed"><strong>IsTrashed</strong></a> = is_trashed(self)</dt><dd><tt>Whether this resource is trashed.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is trashed.</tt></dd></dl>
+
+<dl><dt><a name="Change-IsViewed"><strong>IsViewed</strong></a> = is_viewed(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is viewed.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is viewed.</tt></dd></dl>
+
+<dl><dt><a name="Change-RemoveCategories"><strong>RemoveCategories</strong></a> = remove_categories(self, scheme)</dt><dd><tt>Remove category elements for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme of category to remove.</tt></dd></dl>
+
+<dl><dt><a name="Change-RemoveLabel"><strong>RemoveLabel</strong></a> = remove_label(self, label)</dt><dd><tt>Remove a label, if it is present.<br>
+ <br>
+Args:<br>
+ label: The str label to remove</tt></dd></dl>
+
+<dl><dt><a name="Change-SetResourceType"><strong>SetResourceType</strong></a> = set_resource_type(self, label)</dt><dd><tt>Set the document type for an entry, by building the appropriate<br>
+atom.data.Category<br>
+ <br>
+Args:<br>
+ label: str The value for the category entry. If None is passed the<br>
+ category is removed and not set.<br>
+ <br>
+Returns:<br>
+ An atom.data.Category or None if label is None.</tt></dd></dl>
+
+<dl><dt><a name="Change-add_category"><strong>add_category</strong></a>(self, scheme, term, label)</dt><dd><tt>Add a category for a scheme, term and label.<br>
+ <br>
+Args:<br>
+ scheme: The scheme for the category.<br>
+ term: The term for the category.<br>
+ label: The label for the category<br>
+ <br>
+Returns:<br>
+ The newly created atom.data.Category.</tt></dd></dl>
+
+<dl><dt><a name="Change-add_label"><strong>add_label</strong></a>(self, label)</dt><dd><tt>Add a label, if it is not present.<br>
+ <br>
+Args:<br>
+ label: The str label to set</tt></dd></dl>
+
+<dl><dt><a name="Change-get_categories"><strong>get_categories</strong></a>(self, scheme)</dt><dd><tt>Fetch the category elements for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme to fetch the elements for.<br>
+ <br>
+Returns:<br>
+ Generator of atom.data.Category elements.</tt></dd></dl>
+
+<dl><dt><a name="Change-get_first_category"><strong>get_first_category</strong></a>(self, scheme)</dt><dd><tt>Fetch the first category element for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme of category to return.<br>
+ <br>
+Returns:<br>
+ atom.data.Category if found or None.</tt></dd></dl>
+
+<dl><dt><a name="Change-get_labels"><strong>get_labels</strong></a>(self)</dt><dd><tt>Extracts the labels for this <a href="#Resource">Resource</a>.<br>
+ <br>
+This method returns the labels as a set, for example: 'hidden', 'starred',<br>
+'viewed'.<br>
+ <br>
+Returns:<br>
+ Set of string labels.</tt></dd></dl>
+
+<dl><dt><a name="Change-get_resource_type"><strong>get_resource_type</strong></a>(self)</dt><dd><tt>Extracts the type of document this <a href="#Resource">Resource</a> is.<br>
+ <br>
+This method returns the type of document the <a href="#Resource">Resource</a> represents. Possible<br>
+values are document, presentation, drawing, spreadsheet, file, folder,<br>
+form, item, or pdf.<br>
+ <br>
+'folder' is a possible return value of this method because, for legacy<br>
+support, we have not yet renamed the folder keyword to collection in<br>
+the API itself.<br>
+ <br>
+Returns:<br>
+ String representing the type of document.</tt></dd></dl>
+
+<dl><dt><a name="Change-has_label"><strong>has_label</strong></a>(self, label)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> has a label.<br>
+ <br>
+Args:<br>
+ label: The str label to test for<br>
+ <br>
+Returns:<br>
+ Boolean value indicating presence of label.</tt></dd></dl>
+
+<dl><dt><a name="Change-is_hidden"><strong>is_hidden</strong></a>(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is hidden.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is hidden.</tt></dd></dl>
+
+<dl><dt><a name="Change-is_mine"><strong>is_mine</strong></a>(self)</dt><dd><tt>Whether this resource is marked as mine.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is marked as mine.</tt></dd></dl>
+
+<dl><dt><a name="Change-is_private"><strong>is_private</strong></a>(self)</dt><dd><tt>Whether this resource is private.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is private.</tt></dd></dl>
+
+<dl><dt><a name="Change-is_restricted_download"><strong>is_restricted_download</strong></a>(self)</dt><dd><tt>Whether this resource is restricted download.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating whether the resource is restricted download.</tt></dd></dl>
+
+<dl><dt><a name="Change-is_shared_with_domain"><strong>is_shared_with_domain</strong></a>(self)</dt><dd><tt>Whether this resource is shared with the domain.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is shared with the domain.</tt></dd></dl>
+
+<dl><dt><a name="Change-is_starred"><strong>is_starred</strong></a>(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is starred.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is starred.</tt></dd></dl>
+
+<dl><dt><a name="Change-is_trashed"><strong>is_trashed</strong></a>(self)</dt><dd><tt>Whether this resource is trashed.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is trashed.</tt></dd></dl>
+
+<dl><dt><a name="Change-is_viewed"><strong>is_viewed</strong></a>(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is viewed.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is viewed.</tt></dd></dl>
+
+<dl><dt><a name="Change-remove_categories"><strong>remove_categories</strong></a>(self, scheme)</dt><dd><tt>Remove category elements for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme of category to remove.</tt></dd></dl>
+
+<dl><dt><a name="Change-remove_label"><strong>remove_label</strong></a>(self, label)</dt><dd><tt>Remove a label, if it is present.<br>
+ <br>
+Args:<br>
+ label: The str label to remove</tt></dd></dl>
+
+<dl><dt><a name="Change-set_resource_type"><strong>set_resource_type</strong></a>(self, label)</dt><dd><tt>Set the document type for an entry, by building the appropriate<br>
+atom.data.Category<br>
+ <br>
+Args:<br>
+ label: str The value for the category entry. If None is passed the<br>
+ category is removed and not set.<br>
+ <br>
+Returns:<br>
+ An atom.data.Category or None if label is None.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ChangeFeed">class <strong>ChangeFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>DocList Changes feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ChangeFeed">ChangeFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.docs.data.Change'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ChangeFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ChangeFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ChangeFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ChangeFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ChangeFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ChangeFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Changestamp">class <strong>Changestamp</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:changestamp element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Changestamp">Changestamp</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Changestamp-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Changestamp-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Changestamp-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Changestamp-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Changestamp-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Changestamp-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Changestamp-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Changestamp-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Changestamp-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Changestamp-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Deleted">class <strong>Deleted</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList gd:deleted element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Deleted">Deleted</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Deleted-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Deleted-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Deleted-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Description">class <strong>Description</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:description element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Description">Description</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Description-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Description-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Description-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Description-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Description-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Description-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Description-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Description-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Description-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Description-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExportFormat">class <strong>ExportFormat</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:exportFormat element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ExportFormat">ExportFormat</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>source</strong> = 'source'</dl>
+
+<dl><dt><strong>target</strong> = 'target'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ExportFormat-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExportFormat-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExportFormat-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExportFormat-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExportFormat-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ExportFormat-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ExportFormat-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ExportFormat-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ExportFormat-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ExportFormat-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Feature">class <strong>Feature</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:feature element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Feature">Feature</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = <class 'gdata.docs.data.FeatureName'><dd><tt>The DocList docs:featureName element.</tt></dl>
+
+<dl><dt><strong>rate</strong> = <class 'gdata.docs.data.FeatureRate'><dd><tt>The DocList docs:featureRate element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Feature-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feature-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feature-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Feature-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feature-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Feature-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Feature-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Feature-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Feature-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Feature-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FeatureName">class <strong>FeatureName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:featureName element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#FeatureName">FeatureName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FeatureName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeatureName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeatureName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeatureName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeatureName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="FeatureName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="FeatureName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeatureName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeatureName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeatureName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FeatureRate">class <strong>FeatureRate</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:featureRate element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#FeatureRate">FeatureRate</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FeatureRate-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeatureRate-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeatureRate-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeatureRate-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeatureRate-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="FeatureRate-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="FeatureRate-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FeatureRate-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FeatureRate-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FeatureRate-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Filename">class <strong>Filename</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:filename element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Filename">Filename</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Filename-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Filename-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Filename-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Filename-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Filename-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Filename-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Filename-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Filename-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Filename-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Filename-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ImportFormat">class <strong>ImportFormat</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:importFormat element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ImportFormat">ImportFormat</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>source</strong> = 'source'</dl>
+
+<dl><dt><strong>target</strong> = 'target'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ImportFormat-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ImportFormat-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ImportFormat-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ImportFormat-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ImportFormat-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ImportFormat-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ImportFormat-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ImportFormat-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ImportFormat-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ImportFormat-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LastModifiedBy">class <strong>LastModifiedBy</strong></a>(<a href="atom.data.html#Person">atom.data.Person</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList gd:lastModifiedBy element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#LastModifiedBy">LastModifiedBy</a></dd>
+<dd><a href="atom.data.html#Person">atom.data.Person</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Person">atom.data.Person</a>:<br>
+<dl><dt><strong>email</strong> = <class 'atom.data.Email'><dd><tt>The atom:email element.</tt></dl>
+
+<dl><dt><strong>name</strong> = <class 'atom.data.Name'><dd><tt>The atom:name element.</tt></dl>
+
+<dl><dt><strong>uri</strong> = <class 'atom.data.Uri'><dd><tt>The atom:uri element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="LastModifiedBy-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastModifiedBy-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastModifiedBy-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LastModifiedBy-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastModifiedBy-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="LastModifiedBy-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="LastModifiedBy-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LastModifiedBy-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LastModifiedBy-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastModifiedBy-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LastViewed">class <strong>LastViewed</strong></a>(<a href="atom.data.html#Person">atom.data.Person</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList gd:lastViewed element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#LastViewed">LastViewed</a></dd>
+<dd><a href="atom.data.html#Person">atom.data.Person</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Person">atom.data.Person</a>:<br>
+<dl><dt><strong>email</strong> = <class 'atom.data.Email'><dd><tt>The atom:email element.</tt></dl>
+
+<dl><dt><strong>name</strong> = <class 'atom.data.Name'><dd><tt>The atom:name element.</tt></dl>
+
+<dl><dt><strong>uri</strong> = <class 'atom.data.Uri'><dd><tt>The atom:uri element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="LastViewed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastViewed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastViewed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LastViewed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastViewed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="LastViewed-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="LastViewed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LastViewed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LastViewed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastViewed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MaxUploadSize">class <strong>MaxUploadSize</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:maxUploadSize element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#MaxUploadSize">MaxUploadSize</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>kind</strong> = 'kind'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MaxUploadSize-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MaxUploadSize-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MaxUploadSize-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MaxUploadSize-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MaxUploadSize-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="MaxUploadSize-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MaxUploadSize-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MaxUploadSize-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MaxUploadSize-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MaxUploadSize-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Metadata">class <strong>Metadata</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Metadata">Metadata</a> entry for a user.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Metadata">Metadata</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>additional_role_info</strong> = [<class 'gdata.docs.data.AdditionalRoleInfo'>]</dl>
+
+<dl><dt><strong>export_formats</strong> = [<class 'gdata.docs.data.ExportFormat'>]</dl>
+
+<dl><dt><strong>features</strong> = [<class 'gdata.docs.data.Feature'>]</dl>
+
+<dl><dt><strong>import_formats</strong> = [<class 'gdata.docs.data.ImportFormat'>]</dl>
+
+<dl><dt><strong>max_upload_sizes</strong> = [<class 'gdata.docs.data.MaxUploadSize'>]</dl>
+
+<dl><dt><strong>quota_bytes_total</strong> = <class 'gdata.docs.data.QuotaBytesTotal'><dd><tt>The DocList gd:quotaBytesTotal element.</tt></dl>
+
+<dl><dt><strong>quota_bytes_used</strong> = <class 'gdata.docs.data.QuotaBytesUsed'><dd><tt>The DocList gd:quotaBytesUsed element.</tt></dl>
+
+<dl><dt><strong>quota_bytes_used_in_trash</strong> = <class 'gdata.docs.data.QuotaBytesUsedInTrash'><dd><tt>The DocList docs:quotaBytesUsedInTrash element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="Metadata-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="Metadata-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="Metadata-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="Metadata-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Metadata-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="Metadata-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="Metadata-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Metadata-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Metadata-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Metadata-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Metadata-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Metadata-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Publish">class <strong>Publish</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:publish element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Publish">Publish</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Publish-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publish-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publish-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Publish-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publish-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Publish-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Publish-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Publish-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Publish-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publish-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PublishAuto">class <strong>PublishAuto</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:publishAuto element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#PublishAuto">PublishAuto</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PublishAuto-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PublishAuto-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PublishAuto-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PublishAuto-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PublishAuto-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="PublishAuto-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="PublishAuto-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PublishAuto-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PublishAuto-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PublishAuto-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PublishOutsideDomain">class <strong>PublishOutsideDomain</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:publishOutsideDomain element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#PublishOutsideDomain">PublishOutsideDomain</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PublishOutsideDomain-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PublishOutsideDomain-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PublishOutsideDomain-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PublishOutsideDomain-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PublishOutsideDomain-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="PublishOutsideDomain-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="PublishOutsideDomain-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PublishOutsideDomain-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PublishOutsideDomain-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PublishOutsideDomain-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="QuotaBytesTotal">class <strong>QuotaBytesTotal</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList gd:quotaBytesTotal element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#QuotaBytesTotal">QuotaBytesTotal</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="QuotaBytesTotal-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesTotal-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesTotal-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesTotal-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesTotal-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesTotal-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="QuotaBytesTotal-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="QuotaBytesTotal-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesTotal-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesTotal-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="QuotaBytesUsed">class <strong>QuotaBytesUsed</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList gd:quotaBytesUsed element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#QuotaBytesUsed">QuotaBytesUsed</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="QuotaBytesUsed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsed-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="QuotaBytesUsed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="QuotaBytesUsed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="QuotaBytesUsedInTrash">class <strong>QuotaBytesUsedInTrash</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:quotaBytesUsedInTrash element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#QuotaBytesUsedInTrash">QuotaBytesUsedInTrash</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="QuotaBytesUsedInTrash-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsedInTrash-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsedInTrash-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsedInTrash-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsedInTrash-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsedInTrash-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="QuotaBytesUsedInTrash-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="QuotaBytesUsedInTrash-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsedInTrash-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="QuotaBytesUsedInTrash-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Removed">class <strong>Removed</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:removed element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Removed">Removed</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Removed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Removed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Removed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Removed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Removed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Removed-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Removed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Removed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Removed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Removed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Resource">class <strong>Resource</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>, <a href="gdata.docs.data.html#CategoryFinder">CategoryFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>DocList version of an Atom Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Resource">Resource</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="gdata.docs.data.html#CategoryFinder">CategoryFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Resource-GetAclFeedLink"><strong>GetAclFeedLink</strong></a> = <a href="#Resource-get_acl_feed_link">get_acl_feed_link</a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetResumableCreateMediaLink"><strong>GetResumableCreateMediaLink</strong></a> = <a href="#Resource-get_resumable_create_media_link">get_resumable_create_media_link</a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetResumableEditMediaLink"><strong>GetResumableEditMediaLink</strong></a> = <a href="#Resource-get_resumable_edit_media_link">get_resumable_edit_media_link</a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetRevisionsFeedLink"><strong>GetRevisionsFeedLink</strong></a> = <a href="#Resource-get_revisions_feed_link">get_revisions_feed_link</a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-InCollections"><strong>InCollections</strong></a> = <a href="#Resource-in_collections">in_collections</a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self, type<font color="#909090">=None</font>, title<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="Resource-get_acl_feed_link"><strong>get_acl_feed_link</strong></a>(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s ACL feed <gd:feedLink>.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_resumable_create_media_link"><strong>get_resumable_create_media_link</strong></a>(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s resumable create link.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_resumable_edit_media_link"><strong>get_resumable_edit_media_link</strong></a>(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s resumable update link.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_revisions_feed_link"><strong>get_revisions_feed_link</strong></a>(self)</dt><dd><tt>Extracts the <a href="#Resource">Resource</a>'s revisions feed <gd:feedLink>.<br>
+ <br>
+Returns:<br>
+ A gdata.data.FeedLink <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="Resource-in_collections"><strong>in_collections</strong></a>(self)</dt><dd><tt>Returns the parents <a href="#Resource-link">link</a>(s) (collections) of this entry.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>acl_feed</strong> = <class 'gdata.docs.data.AclFeed'><dd><tt><a href="#Resource">Resource</a> ACL feed.</tt></dl>
+
+<dl><dt><strong>deleted</strong> = <class 'gdata.docs.data.Deleted'><dd><tt>The DocList gd:deleted element.</tt></dl>
+
+<dl><dt><strong>description</strong> = <class 'gdata.docs.data.Description'><dd><tt>The DocList docs:description element.</tt></dl>
+
+<dl><dt><strong>feed_link</strong> = [<class 'gdata.data.FeedLink'>]</dl>
+
+<dl><dt><strong>filename</strong> = <class 'gdata.docs.data.Filename'><dd><tt>The DocList docs:filename element.</tt></dl>
+
+<dl><dt><strong>last_modified_by</strong> = <class 'gdata.docs.data.LastModifiedBy'><dd><tt>The DocList gd:lastModifiedBy element.</tt></dl>
+
+<dl><dt><strong>last_viewed</strong> = <class 'gdata.docs.data.LastViewed'><dd><tt>The DocList gd:lastViewed element.</tt></dl>
+
+<dl><dt><strong>quota_bytes_used</strong> = <class 'gdata.docs.data.QuotaBytesUsed'><dd><tt>The DocList gd:quotaBytesUsed element.</tt></dl>
+
+<dl><dt><strong>resource_id</strong> = <class 'gdata.docs.data.ResourceId'><dd><tt>The DocList gd:resourceId element.</tt></dl>
+
+<dl><dt><strong>suggested_filename</strong> = <class 'gdata.docs.data.SuggestedFilename'><dd><tt>The DocList docs:suggestedFilename element.</tt></dl>
+
+<dl><dt><strong>writers_can_invite</strong> = <class 'gdata.docs.data.WritersCanInvite'><dd><tt>The DocList docs:writersCanInvite element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="Resource-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Resource-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="Resource-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="Resource-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Resource-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Resource-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Resource-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Resource-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Resource-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Resource-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Resource-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="Resource-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Resource-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Resource-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Resource-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Resource-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Resource-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="Resource-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Resource-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Resource-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Resource-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Resource-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Resource-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Resource-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.docs.data.html#CategoryFinder">CategoryFinder</a>:<br>
+<dl><dt><a name="Resource-AddCategory"><strong>AddCategory</strong></a> = add_category(self, scheme, term, label)</dt><dd><tt>Add a category for a scheme, term and label.<br>
+ <br>
+Args:<br>
+ scheme: The scheme for the category.<br>
+ term: The term for the category.<br>
+ label: The label for the category<br>
+ <br>
+Returns:<br>
+ The newly created atom.data.Category.</tt></dd></dl>
+
+<dl><dt><a name="Resource-AddLabel"><strong>AddLabel</strong></a> = add_label(self, label)</dt><dd><tt>Add a label, if it is not present.<br>
+ <br>
+Args:<br>
+ label: The str label to set</tt></dd></dl>
+
+<dl><dt><a name="Resource-GetCategories"><strong>GetCategories</strong></a> = get_categories(self, scheme)</dt><dd><tt>Fetch the category elements for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme to fetch the elements for.<br>
+ <br>
+Returns:<br>
+ Generator of atom.data.Category elements.</tt></dd></dl>
+
+<dl><dt><a name="Resource-GetFirstCategory"><strong>GetFirstCategory</strong></a> = get_first_category(self, scheme)</dt><dd><tt>Fetch the first category element for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme of category to return.<br>
+ <br>
+Returns:<br>
+ atom.data.Category if found or None.</tt></dd></dl>
+
+<dl><dt><a name="Resource-GetLabels"><strong>GetLabels</strong></a> = get_labels(self)</dt><dd><tt>Extracts the labels for this <a href="#Resource">Resource</a>.<br>
+ <br>
+This method returns the labels as a set, for example: 'hidden', 'starred',<br>
+'viewed'.<br>
+ <br>
+Returns:<br>
+ Set of string labels.</tt></dd></dl>
+
+<dl><dt><a name="Resource-GetResourceType"><strong>GetResourceType</strong></a> = get_resource_type(self)</dt><dd><tt>Extracts the type of document this <a href="#Resource">Resource</a> is.<br>
+ <br>
+This method returns the type of document the <a href="#Resource">Resource</a> represents. Possible<br>
+values are document, presentation, drawing, spreadsheet, file, folder,<br>
+form, item, or pdf.<br>
+ <br>
+'folder' is a possible return value of this method because, for legacy<br>
+support, we have not yet renamed the folder keyword to collection in<br>
+the API itself.<br>
+ <br>
+Returns:<br>
+ String representing the type of document.</tt></dd></dl>
+
+<dl><dt><a name="Resource-HasLabel"><strong>HasLabel</strong></a> = has_label(self, label)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> has a label.<br>
+ <br>
+Args:<br>
+ label: The str label to test for<br>
+ <br>
+Returns:<br>
+ Boolean value indicating presence of label.</tt></dd></dl>
+
+<dl><dt><a name="Resource-IsHidden"><strong>IsHidden</strong></a> = is_hidden(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is hidden.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is hidden.</tt></dd></dl>
+
+<dl><dt><a name="Resource-IsMine"><strong>IsMine</strong></a> = is_mine(self)</dt><dd><tt>Whether this resource is marked as mine.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is marked as mine.</tt></dd></dl>
+
+<dl><dt><a name="Resource-IsPrivate"><strong>IsPrivate</strong></a> = is_private(self)</dt><dd><tt>Whether this resource is private.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is private.</tt></dd></dl>
+
+<dl><dt><a name="Resource-IsRestrictedDownload"><strong>IsRestrictedDownload</strong></a> = is_restricted_download(self)</dt><dd><tt>Whether this resource is restricted download.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating whether the resource is restricted download.</tt></dd></dl>
+
+<dl><dt><a name="Resource-IsSharedWithDomain"><strong>IsSharedWithDomain</strong></a> = is_shared_with_domain(self)</dt><dd><tt>Whether this resource is shared with the domain.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is shared with the domain.</tt></dd></dl>
+
+<dl><dt><a name="Resource-IsStarred"><strong>IsStarred</strong></a> = is_starred(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is starred.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is starred.</tt></dd></dl>
+
+<dl><dt><a name="Resource-IsTrashed"><strong>IsTrashed</strong></a> = is_trashed(self)</dt><dd><tt>Whether this resource is trashed.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is trashed.</tt></dd></dl>
+
+<dl><dt><a name="Resource-IsViewed"><strong>IsViewed</strong></a> = is_viewed(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is viewed.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is viewed.</tt></dd></dl>
+
+<dl><dt><a name="Resource-RemoveCategories"><strong>RemoveCategories</strong></a> = remove_categories(self, scheme)</dt><dd><tt>Remove category elements for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme of category to remove.</tt></dd></dl>
+
+<dl><dt><a name="Resource-RemoveLabel"><strong>RemoveLabel</strong></a> = remove_label(self, label)</dt><dd><tt>Remove a label, if it is present.<br>
+ <br>
+Args:<br>
+ label: The str label to remove</tt></dd></dl>
+
+<dl><dt><a name="Resource-SetResourceType"><strong>SetResourceType</strong></a> = set_resource_type(self, label)</dt><dd><tt>Set the document type for an entry, by building the appropriate<br>
+atom.data.Category<br>
+ <br>
+Args:<br>
+ label: str The value for the category entry. If None is passed the<br>
+ category is removed and not set.<br>
+ <br>
+Returns:<br>
+ An atom.data.Category or None if label is None.</tt></dd></dl>
+
+<dl><dt><a name="Resource-add_category"><strong>add_category</strong></a>(self, scheme, term, label)</dt><dd><tt>Add a category for a scheme, term and label.<br>
+ <br>
+Args:<br>
+ scheme: The scheme for the category.<br>
+ term: The term for the category.<br>
+ label: The label for the category<br>
+ <br>
+Returns:<br>
+ The newly created atom.data.Category.</tt></dd></dl>
+
+<dl><dt><a name="Resource-add_label"><strong>add_label</strong></a>(self, label)</dt><dd><tt>Add a label, if it is not present.<br>
+ <br>
+Args:<br>
+ label: The str label to set</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_categories"><strong>get_categories</strong></a>(self, scheme)</dt><dd><tt>Fetch the category elements for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme to fetch the elements for.<br>
+ <br>
+Returns:<br>
+ Generator of atom.data.Category elements.</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_first_category"><strong>get_first_category</strong></a>(self, scheme)</dt><dd><tt>Fetch the first category element for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme of category to return.<br>
+ <br>
+Returns:<br>
+ atom.data.Category if found or None.</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_labels"><strong>get_labels</strong></a>(self)</dt><dd><tt>Extracts the labels for this <a href="#Resource">Resource</a>.<br>
+ <br>
+This method returns the labels as a set, for example: 'hidden', 'starred',<br>
+'viewed'.<br>
+ <br>
+Returns:<br>
+ Set of string labels.</tt></dd></dl>
+
+<dl><dt><a name="Resource-get_resource_type"><strong>get_resource_type</strong></a>(self)</dt><dd><tt>Extracts the type of document this <a href="#Resource">Resource</a> is.<br>
+ <br>
+This method returns the type of document the <a href="#Resource">Resource</a> represents. Possible<br>
+values are document, presentation, drawing, spreadsheet, file, folder,<br>
+form, item, or pdf.<br>
+ <br>
+'folder' is a possible return value of this method because, for legacy<br>
+support, we have not yet renamed the folder keyword to collection in<br>
+the API itself.<br>
+ <br>
+Returns:<br>
+ String representing the type of document.</tt></dd></dl>
+
+<dl><dt><a name="Resource-has_label"><strong>has_label</strong></a>(self, label)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> has a label.<br>
+ <br>
+Args:<br>
+ label: The str label to test for<br>
+ <br>
+Returns:<br>
+ Boolean value indicating presence of label.</tt></dd></dl>
+
+<dl><dt><a name="Resource-is_hidden"><strong>is_hidden</strong></a>(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is hidden.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is hidden.</tt></dd></dl>
+
+<dl><dt><a name="Resource-is_mine"><strong>is_mine</strong></a>(self)</dt><dd><tt>Whether this resource is marked as mine.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is marked as mine.</tt></dd></dl>
+
+<dl><dt><a name="Resource-is_private"><strong>is_private</strong></a>(self)</dt><dd><tt>Whether this resource is private.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is private.</tt></dd></dl>
+
+<dl><dt><a name="Resource-is_restricted_download"><strong>is_restricted_download</strong></a>(self)</dt><dd><tt>Whether this resource is restricted download.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating whether the resource is restricted download.</tt></dd></dl>
+
+<dl><dt><a name="Resource-is_shared_with_domain"><strong>is_shared_with_domain</strong></a>(self)</dt><dd><tt>Whether this resource is shared with the domain.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is shared with the domain.</tt></dd></dl>
+
+<dl><dt><a name="Resource-is_starred"><strong>is_starred</strong></a>(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is starred.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is starred.</tt></dd></dl>
+
+<dl><dt><a name="Resource-is_trashed"><strong>is_trashed</strong></a>(self)</dt><dd><tt>Whether this resource is trashed.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is trashed.</tt></dd></dl>
+
+<dl><dt><a name="Resource-is_viewed"><strong>is_viewed</strong></a>(self)</dt><dd><tt>Whether this <a href="#Resource">Resource</a> is viewed.<br>
+ <br>
+Returns:<br>
+ Boolean value indicating that the resource is viewed.</tt></dd></dl>
+
+<dl><dt><a name="Resource-remove_categories"><strong>remove_categories</strong></a>(self, scheme)</dt><dd><tt>Remove category elements for a scheme.<br>
+ <br>
+Args:<br>
+ scheme: The scheme of category to remove.</tt></dd></dl>
+
+<dl><dt><a name="Resource-remove_label"><strong>remove_label</strong></a>(self, label)</dt><dd><tt>Remove a label, if it is present.<br>
+ <br>
+Args:<br>
+ label: The str label to remove</tt></dd></dl>
+
+<dl><dt><a name="Resource-set_resource_type"><strong>set_resource_type</strong></a>(self, label)</dt><dd><tt>Set the document type for an entry, by building the appropriate<br>
+atom.data.Category<br>
+ <br>
+Args:<br>
+ label: str The value for the category entry. If None is passed the<br>
+ category is removed and not set.<br>
+ <br>
+Returns:<br>
+ An atom.data.Category or None if label is None.</tt></dd></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ResourceFeed">class <strong>ResourceFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Main feed containing a list of resources.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ResourceFeed">ResourceFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.docs.data.Resource'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="ResourceFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ResourceFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ResourceFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ResourceFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ResourceFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ResourceFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ResourceFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ResourceId">class <strong>ResourceId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList gd:resourceId element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#ResourceId">ResourceId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ResourceId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ResourceId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="ResourceId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ResourceId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ResourceId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ResourceId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ResourceId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Revision">class <strong>Revision</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Resource">Resource</a> <a href="#Revision">Revision</a> entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#Revision">Revision</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Revision-FindPublishLink"><strong>FindPublishLink</strong></a> = <a href="#Revision-find_publish_link">find_publish_link</a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-GetPublishLink"><strong>GetPublishLink</strong></a> = <a href="#Revision-get_publish_link">get_publish_link</a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-find_publish_link"><strong>find_publish_link</strong></a>(self)</dt><dd><tt>Get the link that points to the published resource on the web.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel ending in #publish.</tt></dd></dl>
+
+<dl><dt><a name="Revision-get_publish_link"><strong>get_publish_link</strong></a>(self)</dt><dd><tt>Get the link that points to the published resource on the web.<br>
+ <br>
+Returns:<br>
+ A gdata.data.Link for the link with a rel ending in #publish.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>publish</strong> = <class 'gdata.docs.data.Publish'><dd><tt>The DocList docs:publish element.</tt></dl>
+
+<dl><dt><strong>publish_auto</strong> = <class 'gdata.docs.data.PublishAuto'><dd><tt>The DocList docs:publishAuto element.</tt></dl>
+
+<dl><dt><strong>publish_outside_domain</strong> = <class 'gdata.docs.data.PublishOutsideDomain'><dd><tt>The DocList docs:publishOutsideDomain element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="Revision-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Revision-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="Revision-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="Revision-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Revision-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="Revision-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Revision-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Revision-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Revision-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Revision-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Revision-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="Revision-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Revision-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Revision-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="Revision-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Revision-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Revision-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Revision-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Revision-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Revision-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Revision-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="Revision-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Revision-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Revision-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Revision-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Revision-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Revision-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Revision-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Revision-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RevisionFeed">class <strong>RevisionFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A DocList <a href="#Revision">Revision</a> feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#RevisionFeed">RevisionFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.docs.data.Revision'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="RevisionFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="RevisionFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="RevisionFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="RevisionFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="RevisionFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link <a href="__builtin__.html#object">object</a> which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link <a href="__builtin__.html#object">object</a>,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SuggestedFilename">class <strong>SuggestedFilename</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:suggestedFilename element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#SuggestedFilename">SuggestedFilename</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SuggestedFilename-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SuggestedFilename-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SuggestedFilename-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SuggestedFilename-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SuggestedFilename-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="SuggestedFilename-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SuggestedFilename-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SuggestedFilename-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SuggestedFilename-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SuggestedFilename-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WritersCanInvite">class <strong>WritersCanInvite</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:writersCanInvite element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.data.html#WritersCanInvite">WritersCanInvite</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>value</strong> = 'value'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="WritersCanInvite-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WritersCanInvite-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WritersCanInvite-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WritersCanInvite-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WritersCanInvite-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<dl><dt><a name="WritersCanInvite-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="WritersCanInvite-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WritersCanInvite-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this <a href="__builtin__.html#object">object</a>, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the <a href="__builtin__.html#object">object</a>'s members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WritersCanInvite-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this <a href="__builtin__.html#object">object</a>, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the <a href="__builtin__.html#object">object</a>'s members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WritersCanInvite-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this <a href="__builtin__.html#object">object</a> to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ACL_FEEDLINK_REL</strong> = 'http://schemas.google.com/acl/2007#accessControlList'<br>
+<strong>COLLECTION_LABEL</strong> = 'folder'<br>
+<strong>DATA_KIND_SCHEME</strong> = 'http://schemas.google.com/g/2005#kind'<br>
+<strong>DOCUMENTS_NS</strong> = 'http://schemas.google.com/docs/2007'<br>
+<strong>DOCUMENTS_TEMPLATE</strong> = '{http://schemas.google.com/docs/2007}%s'<br>
+<strong>DOCUMENT_LABEL</strong> = 'document'<br>
+<strong>DRAWING_LABEL</strong> = 'drawing'<br>
+<strong>FILE_LABEL</strong> = 'file'<br>
+<strong>FORM_LABEL</strong> = 'form'<br>
+<strong>HIDDEN_LABEL</strong> = 'hidden'<br>
+<strong>ITEM_LABEL</strong> = 'item'<br>
+<strong>LABELS_NS</strong> = 'http://schemas.google.com/g/2005/labels'<br>
+<strong>LABELS_SCHEME</strong> = 'http://schemas.google.com/g/2005/labels'<br>
+<strong>MINE_LABEL</strong> = 'mine'<br>
+<strong>PARENT_LINK_REL</strong> = 'http://schemas.google.com/docs/2007#parent'<br>
+<strong>PDF_LABEL</strong> = 'pdf'<br>
+<strong>PRESENTATION_LABEL</strong> = 'presentation'<br>
+<strong>PRIVATE_LABEL</strong> = 'private'<br>
+<strong>PUBLISH_LINK_REL</strong> = 'http://schemas.google.com/docs/2007#publish'<br>
+<strong>RESTRICTEDDOWNLOAD_LABEL</strong> = 'restricted-download'<br>
+<strong>RESUMABLE_CREATE_MEDIA_LINK_REL</strong> = 'http://schemas.google.com/g/2005#resumable-create-media'<br>
+<strong>RESUMABLE_EDIT_MEDIA_LINK_REL</strong> = 'http://schemas.google.com/g/2005#resumable-edit-media'<br>
+<strong>REVISION_FEEDLINK_REL</strong> = 'http://schemas.google.com/docs/2007/revisions'<br>
+<strong>SHAREDWITHDOMAIN_LABEL</strong> = 'shared-with-domain'<br>
+<strong>SPREADSHEET_LABEL</strong> = 'spreadsheet'<br>
+<strong>STARRED_LABEL</strong> = 'starred'<br>
+<strong>TRASHED_LABEL</strong> = 'trashed'<br>
+<strong>VIEWED_LABEL</strong> = 'viewed'<br>
+<strong>__author__</strong> = 'vicfryzel@google.com (Vic Fryzel)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">vicfryzel@google.com (Vic Fryzel)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.docs.html b/pydocs/gdata.docs.html
new file mode 100644
index 0000000..518f26a
--- /dev/null
+++ b/pydocs/gdata.docs.html
@@ -0,0 +1,971 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.docs</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.docs</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/docs/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/docs/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains extensions to Atom objects used with Google Documents.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.docs.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.docs.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.docs.service.html">service</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.html#FeedLink">FeedLink</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.html#ResourceId">ResourceId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.html#Role">Role</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.html#Scope">Scope</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.html#WritersCanInvite">WritersCanInvite</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Person">atom.Person</a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.html#LastModifiedBy">LastModifiedBy</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.html#LastViewed">LastViewed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.html#DocumentListAclEntry">DocumentListAclEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.html#DocumentListEntry">DocumentListEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.html#DocumentListAclFeed">DocumentListAclFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.html#DocumentListFeed">DocumentListFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DocumentListAclEntry">class <strong>DocumentListAclEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A DocList ACL Entry flavor of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.html#DocumentListAclEntry">DocumentListAclEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="DocumentListAclEntry-__init__"><strong>__init__</strong></a>(self, category<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, scope<font color="#909090">=None</font>, role<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="DocumentListAclEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListAclEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="DocumentListAclEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListAclEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="DocumentListAclEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="DocumentListAclEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListAclEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="DocumentListAclEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListAclEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="DocumentListAclEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DocumentListAclFeed">class <strong>DocumentListAclFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A DocList ACL feed flavor of a Atom feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.html#DocumentListAclFeed">DocumentListAclFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="DocumentListAclFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="DocumentListAclFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListAclFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="DocumentListAclFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="DocumentListAclFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListAclFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="DocumentListAclFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListAclFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="DocumentListAclFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListAclFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DocumentListEntry">class <strong>DocumentListEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Documents version of an Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.html#DocumentListEntry">DocumentListEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="DocumentListEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt><dd><tt>Extracts the DocListEntry's <gd:feedLink>.<br>
+ <br>
+Returns:<br>
+ A <a href="#FeedLink">FeedLink</a> object.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListEntry-GetDocumentType"><strong>GetDocumentType</strong></a>(self)</dt><dd><tt>Extracts the type of document from the DocListEntry.<br>
+ <br>
+This method returns the type of document the DocListEntry<br>
+represents. Possible values are document, presentation,<br>
+spreadsheet, folder, or pdf.<br>
+ <br>
+Returns:<br>
+ A string representing the type of document.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListEntry-__init__"><strong>__init__</strong></a>(self, resourceId<font color="#909090">=None</font>, feedLink<font color="#909090">=None</font>, lastViewed<font color="#909090">=None</font>, lastModifiedBy<font color="#909090">=None</font>, writersCanInvite<font color="#909090">=None</font>, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="DocumentListEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="DocumentListEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="DocumentListEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="DocumentListEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="DocumentListEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="DocumentListEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DocumentListFeed">class <strong>DocumentListFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing a list of Google Documents Items<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.html#DocumentListFeed">DocumentListFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="DocumentListFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="DocumentListFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="DocumentListFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="DocumentListFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="DocumentListFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="DocumentListFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="DocumentListFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentListFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FeedLink">class <strong>FeedLink</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList gd:feedLink element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.html#FeedLink">FeedLink</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="FeedLink-__init__"><strong>__init__</strong></a>(self, href<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="FeedLink-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="FeedLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="FeedLink-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LastModifiedBy">class <strong>LastModifiedBy</strong></a>(<a href="atom.html#Person">atom.Person</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList gd:lastModifiedBy element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.html#LastModifiedBy">LastModifiedBy</a></dd>
+<dd><a href="atom.html#Person">atom.Person</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Person">atom.Person</a>:<br>
+<dl><dt><a name="LastModifiedBy-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, email<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Foundation from which author and contributor are derived.<br>
+ <br>
+The constructor is provided for illustrative purposes, you should not<br>
+need to instantiate a <a href="atom.html#Person">Person</a>.<br>
+ <br>
+Args:<br>
+ name: Name The person's name<br>
+ email: Email The person's email address<br>
+ uri: Uri The URI of the person's webpage<br>
+ extension_elements: list A list of ExtensionElement instances which are<br>
+ children of this element.<br>
+ extension_attributes: dict A dictionary of strings which are the values<br>
+ for additional XML attributes of this element.<br>
+ text: String The text contents of the element. This is the contents<br>
+ of the Entry's XML text node. (Example: <foo>This is the text</foo>)</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="LastModifiedBy-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="LastModifiedBy-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="LastModifiedBy-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LastViewed">class <strong>LastViewed</strong></a>(<a href="atom.html#Person">atom.Person</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList gd:lastViewed element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.html#LastViewed">LastViewed</a></dd>
+<dd><a href="atom.html#Person">atom.Person</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Person">atom.Person</a>:<br>
+<dl><dt><a name="LastViewed-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, email<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Foundation from which author and contributor are derived.<br>
+ <br>
+The constructor is provided for illustrative purposes, you should not<br>
+need to instantiate a <a href="atom.html#Person">Person</a>.<br>
+ <br>
+Args:<br>
+ name: Name The person's name<br>
+ email: Email The person's email address<br>
+ uri: Uri The URI of the person's webpage<br>
+ extension_elements: list A list of ExtensionElement instances which are<br>
+ children of this element.<br>
+ extension_attributes: dict A dictionary of strings which are the values<br>
+ for additional XML attributes of this element.<br>
+ text: String The text contents of the element. This is the contents<br>
+ of the Entry's XML text node. (Example: <foo>This is the text</foo>)</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="LastViewed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="LastViewed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="LastViewed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ResourceId">class <strong>ResourceId</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList gd:resourceId element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.html#ResourceId">ResourceId</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ResourceId-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ResourceId-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ResourceId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ResourceId-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Role">class <strong>Role</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList ACL role element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.html#Role">Role</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Role-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Role-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Role-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Role-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Scope">class <strong>Scope</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList ACL scope element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.html#Scope">Scope</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Scope-__init__"><strong>__init__</strong></a>(self, value<font color="#909090">=None</font>, type<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Scope-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Scope-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Scope-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WritersCanInvite">class <strong>WritersCanInvite</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The DocList docs:writersCanInvite element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.html#WritersCanInvite">WritersCanInvite</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="WritersCanInvite-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="WritersCanInvite-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="WritersCanInvite-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="WritersCanInvite-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-DocumentListAclEntryFromString"><strong>DocumentListAclEntryFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#DocumentListAclEntry">DocumentListAclEntry</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a Document List ACL feed entry.<br>
+ <br>
+Returns:<br>
+ A <a href="#DocumentListAclEntry">DocumentListAclEntry</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-DocumentListAclFeedFromString"><strong>DocumentListAclFeedFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#DocumentListAclFeed">DocumentListAclFeed</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a DocumentList feed.<br>
+ <br>
+Returns:<br>
+ A <a href="#DocumentListFeed">DocumentListFeed</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-DocumentListEntryFromString"><strong>DocumentListEntryFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#DocumentListEntry">DocumentListEntry</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a Document List feed entry.<br>
+ <br>
+Returns:<br>
+ A <a href="#DocumentListEntry">DocumentListEntry</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-DocumentListFeedFromString"><strong>DocumentListFeedFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#DocumentListFeed">DocumentListFeed</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a DocumentList feed.<br>
+ <br>
+Returns:<br>
+ A <a href="#DocumentListFeed">DocumentListFeed</a> object corresponding to the given XML.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DOCUMENTS_NAMESPACE</strong> = 'http://schemas.google.com/docs/2007'<br>
+<strong>__author__</strong> = 'api.jfisher (Jeff Fisher), api.eric@google.com (Eric Bidelman)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jfisher (Jeff Fisher), api.eric@google.com (Eric Bidelman)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.docs.service.html b/pydocs/gdata.docs.service.html
new file mode 100644
index 0000000..fbf1eaf
--- /dev/null
+++ b/pydocs/gdata.docs.service.html
@@ -0,0 +1,1176 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.docs.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.docs.html"><font color="#ffffff">docs</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/docs/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/docs/service.py</a></font></td></tr></table>
+ <p><tt><a href="#DocsService">DocsService</a> extends the <a href="gdata.service.html#GDataService">GDataService</a> to streamline Google Documents<br>
+operations.<br>
+ <br>
+<a href="#DocsService">DocsService</a>: Provides methods to query feeds and manipulate items.<br>
+ Extends <a href="gdata.service.html#GDataService">GDataService</a>.<br>
+ <br>
+<a href="#DocumentQuery">DocumentQuery</a>: Queries a Google Document list feed.<br>
+ <br>
+<a href="#DocumentAclQuery">DocumentAclQuery</a>: Queries a Google Document Acl feed.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="re.html">re</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.service.html#DocsService">DocsService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Query">gdata.service.Query</a>(<a href="__builtin__.html#dict">__builtin__.dict</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.docs.service.html#DocumentAclQuery">DocumentAclQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.docs.service.html#DocumentQuery">DocumentQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DocsService">class <strong>DocsService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Documents service Document List feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.service.html#DocsService">DocsService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="DocsService-CreateFolder"><strong>CreateFolder</strong></a>(self, title, folder_or_uri<font color="#909090">=None</font>)</dt><dd><tt>Creates a folder in the Document List feed.<br>
+ <br>
+Args:<br>
+ title: string The title of the folder on the server after being created.<br>
+ folder_or_uri: DocumentListEntry or string (optional) An object with a<br>
+ link to a folder or a uri to a folder to upload to.<br>
+ Note: A valid uri for a folder is of the form:<br>
+ /feeds/folders/private/full/folder%3Afolder_id<br>
+ <br>
+Returns:<br>
+ A DocumentListEntry containing information about the folder created on<br>
+ the Google Documents service.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-Download"><strong>Download</strong></a>(self, entry_or_id_or_url, file_path, export_format<font color="#909090">=None</font>, gid<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>)</dt><dd><tt>Downloads a document from the Document List.<br>
+ <br>
+Args:<br>
+ entry_or_id_or_url: a DocumentListEntry, or the resource id of an entry,<br>
+ or a url to download from (such as the content src).<br>
+ file_path: string The full path to save the file to.<br>
+ export_format: the format to convert to, if conversion is required.<br>
+ gid: grid id, for downloading a single grid of a spreadsheet<br>
+ extra_params: a map of any further parameters to control how the document<br>
+ is downloaded<br>
+ <br>
+Raises:<br>
+ RequestError if the service does not respond with success</tt></dd></dl>
+
+<dl><dt><a name="DocsService-DownloadDocument"><strong>DownloadDocument</strong></a> = Export(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-DownloadPresentation"><strong>DownloadPresentation</strong></a> = Export(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-DownloadSpreadsheet"><strong>DownloadSpreadsheet</strong></a> = Export(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-Export"><strong>Export</strong></a>(self, entry_or_id_or_url, file_path, gid<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>)</dt><dd><tt>Downloads a document from the Document List in a different format.<br>
+ <br>
+Args:<br>
+ entry_or_id_or_url: a DocumentListEntry, or the resource id of an entry,<br>
+ or a url to download from (such as the content src).<br>
+ file_path: string The full path to save the file to. The export<br>
+ format is inferred from the the file extension.<br>
+ gid: grid id, for downloading a single grid of a spreadsheet<br>
+ extra_params: a map of any further parameters to control how the document<br>
+ is downloaded<br>
+ <br>
+Raises:<br>
+ RequestError if the service does not respond with success</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetDocumentListAclEntry"><strong>GetDocumentListAclEntry</strong></a>(self, uri)</dt><dd><tt>Retrieves a particular DocumentListAclEntry by its unique URI.<br>
+ <br>
+Args:<br>
+ uri: string The unique URI of an entry in a Document List feed.<br>
+ <br>
+Returns:<br>
+ A DocumentListAclEntry object representing the retrieved entry.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetDocumentListAclFeed"><strong>GetDocumentListAclFeed</strong></a>(self, uri)</dt><dd><tt>Retrieves a feed containing all of a user's documents.<br>
+ <br>
+Args:<br>
+ uri: string The URI of a document's Acl feed to retrieve.<br>
+ <br>
+Returns:<br>
+ A DocumentListAclFeed object representing the ACL feed<br>
+ returned by the server.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetDocumentListEntry"><strong>GetDocumentListEntry</strong></a>(self, uri)</dt><dd><tt>Retrieves a particular DocumentListEntry by its unique URI.<br>
+ <br>
+Args:<br>
+ uri: string The unique URI of an entry in a Document List feed.<br>
+ <br>
+Returns:<br>
+ A DocumentListEntry object representing the retrieved entry.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetDocumentListFeed"><strong>GetDocumentListFeed</strong></a>(self, uri<font color="#909090">=None</font>)</dt><dd><tt>Retrieves a feed containing all of a user's documents.<br>
+ <br>
+Args:<br>
+ uri: string A full URI to query the Document List feed.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-MoveDocumentIntoFolder"><strong>MoveDocumentIntoFolder</strong></a> = MoveIntoFolder(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-MoveFolderIntoFolder"><strong>MoveFolderIntoFolder</strong></a> = MoveIntoFolder(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-MoveIntoFolder"><strong>MoveIntoFolder</strong></a>(self, source_entry, folder_entry)</dt><dd><tt>Moves a document into a folder in the Document List Feed.<br>
+ <br>
+Args:<br>
+ source_entry: DocumentListEntry An object representing the source<br>
+ document/folder.<br>
+ folder_entry: DocumentListEntry An object with a link to the destination<br>
+ folder.<br>
+ <br>
+Returns:<br>
+ A DocumentListEntry containing information about the document created on<br>
+ the Google Documents service.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-MoveOutOfFolder"><strong>MoveOutOfFolder</strong></a>(self, source_entry)</dt><dd><tt>Moves a document into a folder in the Document List Feed.<br>
+ <br>
+Args:<br>
+ source_entry: DocumentListEntry An object representing the source<br>
+ document/folder.<br>
+ <br>
+Returns:<br>
+ True if the entry was moved out.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-MovePresentationIntoFolder"><strong>MovePresentationIntoFolder</strong></a> = MoveIntoFolder(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-MoveSpreadsheetIntoFolder"><strong>MoveSpreadsheetIntoFolder</strong></a> = MoveIntoFolder(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-Query"><strong>Query</strong></a>(self, uri, converter<font color="#909090">=<function DocumentListFeedFromString></font>)</dt><dd><tt>Queries the Document List feed and returns the resulting feed of<br>
+ entries.<br>
+ <br>
+Args:<br>
+ uri: string The full URI to be queried. This can contain query<br>
+ parameters, a hostname, or simply the relative path to a Document<br>
+ List feed. The <a href="#DocumentQuery">DocumentQuery</a> object is useful when constructing<br>
+ query parameters.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ retrieved item, generally to render it into a Python object.<br>
+ By default the DocumentListFeedFromString function is used to<br>
+ return a DocumentListFeed object. This is because most feed<br>
+ queries will result in a feed and not a single entry.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-QueryDocumentListFeed"><strong>QueryDocumentListFeed</strong></a>(self, uri)</dt><dd><tt>Retrieves a DocumentListFeed by retrieving a URI based off the Document<br>
+ List feed, including any query parameters. A <a href="#DocumentQuery">DocumentQuery</a> object can<br>
+ be used to construct these parameters.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the feed being retrieved possibly with query<br>
+ parameters.<br>
+ <br>
+Returns:<br>
+ A DocumentListFeed object representing the feed returned by the server.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-Upload"><strong>Upload</strong></a>(self, media_source, title, folder_or_uri<font color="#909090">=None</font>, label<font color="#909090">=None</font>)</dt><dd><tt>Uploads a document inside of a MediaSource object to the Document List<br>
+ feed with the given title.<br>
+ <br>
+Args:<br>
+ media_source: MediaSource The gdata.MediaSource object containing a<br>
+ document file to be uploaded.<br>
+ title: string The title of the document on the server after being<br>
+ uploaded.<br>
+ folder_or_uri: DocumentListEntry or string (optional) An object with a<br>
+ link to a folder or a uri to a folder to upload to.<br>
+ Note: A valid uri for a folder is of the form:<br>
+ /feeds/folders/private/full/folder%3Afolder_id<br>
+ label: optional label describing the type of the document to be created.<br>
+ <br>
+Returns:<br>
+ A DocumentListEntry containing information about the document created<br>
+ on the Google Documents service.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-UploadDocument"><strong>UploadDocument</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-UploadPresentation"><strong>UploadPresentation</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-UploadSpreadsheet"><strong>UploadSpreadsheet</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='docs.google.com'</font>, additional_headers<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a client for the Google Documents service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'docs.google.com'.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="DocsService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="DocsService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="DocsService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocsService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#DocsService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="DocsService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="DocsService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="DocsService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="DocsService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="DocsService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#DocsService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#DocsService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="DocsService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="DocsService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="DocsService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DocumentAclQuery">class <strong>DocumentAclQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Object used to construct a URI to query a Document's ACL feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.service.html#DocumentAclQuery">DocumentAclQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="DocumentAclQuery-ToUri"><strong>ToUri</strong></a>(self)</dt><dd><tt>Generates a URI from the query parameters set in the object.<br>
+ <br>
+Returns:<br>
+ A string containing the URI used to retrieve entries from the Document<br>
+ ACL feed.</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__init__"><strong>__init__</strong></a>(self, resource_id, feed<font color="#909090">='/feeds/acl/private/full'</font>)</dt><dd><tt>Constructor for Document ACL <a href="gdata.service.html#Query">Query</a><br>
+ <br>
+Args:<br>
+ resource_id: string The resource id. (e.g. 'document%3Adocument_id',<br>
+ 'spreadsheet%3Aspreadsheet_id', etc.)<br>
+ feed: string (optional) The path for the feed.<br>
+ (e.g. '/feeds/acl/private/full')<br>
+ <br>
+Yields:<br>
+ A <a href="#DocumentAclQuery">DocumentAclQuery</a> object used to construct a URI based on the Document<br>
+ ACL feed.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="DocumentAclQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="DocumentAclQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentAclQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#DocumentAclQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#DocumentAclQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#DocumentAclQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#DocumentAclQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="DocumentAclQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentAclQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#DocumentAclQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DocumentQuery">class <strong>DocumentQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Object used to construct a URI to query the Google Document List feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.docs.service.html#DocumentQuery">DocumentQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="DocumentQuery-AddNamedFolder"><strong>AddNamedFolder</strong></a>(self, email, folder_name)</dt><dd><tt>Adds a named folder category, qualified by a schema.<br>
+ <br>
+This function lets you query for documents that are contained inside a<br>
+named folder without fear of collision with other categories.<br>
+ <br>
+Args:<br>
+ email: string The email of the user who owns the folder.<br>
+ folder_name: string The name of the folder.<br>
+ <br>
+ Returns:<br>
+ The string of the category that was added to the object.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-RemoveNamedFolder"><strong>RemoveNamedFolder</strong></a>(self, email, folder_name)</dt><dd><tt>Removes a named folder category, qualified by a schema.<br>
+ <br>
+Args:<br>
+ email: string The email of the user who owns the folder.<br>
+ folder_name: string The name of the folder.<br>
+ <br>
+ Returns:<br>
+ The string of the category that was removed to the object.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-ToUri"><strong>ToUri</strong></a>(self)</dt><dd><tt>Generates a URI from the query parameters set in the object.<br>
+ <br>
+Returns:<br>
+ A string containing the URI used to retrieve entries from the Document<br>
+ List feed.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">='/feeds/documents'</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Document List <a href="gdata.service.html#Query">Query</a><br>
+ <br>
+Args:<br>
+ feed: string (optional) The path for the feed. (e.g. '/feeds/documents')<br>
+ visibility: string (optional) The visibility chosen for the current feed.<br>
+ projection: string (optional) The projection chosen for the current feed.<br>
+ text_query: string (optional) The contents of the q query parameter. This<br>
+ string is URL escaped upon conversion to a URI.<br>
+ params: dict (optional) Parameter value string pairs which become URL<br>
+ params when translated to a URI. These parameters are added to<br>
+ the query's items.<br>
+ categories: list (optional) List of category strings which should be<br>
+ included as query categories. See gdata.service.<a href="gdata.service.html#Query">Query</a> for<br>
+ additional documentation.<br>
+ <br>
+Yields:<br>
+ A <a href="#DocumentQuery">DocumentQuery</a> object used to construct a URI based on the Document<br>
+ List feed.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="DocumentQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="DocumentQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#DocumentQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#DocumentQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#DocumentQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#DocumentQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#DocumentQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DATA_KIND_SCHEME</strong> = 'http://schemas.google.com/g/2005#kind'<br>
+<strong>DOCUMENT_LABEL</strong> = 'document'<br>
+<strong>FOLDERS_SCHEME_PREFIX</strong> = 'http://schemas.google.com/docs/2007/folders/'<br>
+<strong>FOLDER_LABEL</strong> = 'folder'<br>
+<strong>HIDDEN_LABEL_TERM</strong> = 'http://schemas.google.com/g/2005/labels#hidden'<br>
+<strong>LABEL_SCHEME</strong> = 'http://schemas.google.com/g/2005/labels'<br>
+<strong>MINE_LABEL_TERM</strong> = 'http://schemas.google.com/g/2005/labels#mine'<br>
+<strong>PDF_LABEL</strong> = 'pdf'<br>
+<strong>PRESENTATION_LABEL</strong> = 'presentation'<br>
+<strong>PRIVATE_LABEL_TERM</strong> = 'http://schemas.google.com/g/2005/labels#private'<br>
+<strong>SHARED_WITH_DOMAIN_LABEL_TERM</strong> = 'http://schemas.google.com/g/2005/labels#shared-with-domain'<br>
+<strong>SPREADSHEET_LABEL</strong> = 'spreadsheet'<br>
+<strong>STARRED_LABEL_TERM</strong> = 'http://schemas.google.com/g/2005/labels#starred'<br>
+<strong>SUPPORTED_FILETYPES</strong> = {'CSV': 'text/csv', 'DOC': 'application/msword', 'DOCX': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'HTM': 'text/html', 'HTML': 'text/html', 'ODS': 'application/x-vnd.oasis.opendocument.spreadsheet', 'ODT': 'application/vnd.oasis.opendocument.text', 'PDF': 'application/pdf', 'PNG': 'image/png', 'PPS': 'application/vnd.ms-powerpoint', ...}<br>
+<strong>TRASHED_LABEL_TERM</strong> = 'http://schemas.google.com/g/2005/labels#trashed'<br>
+<strong>VIEWED_LABEL_TERM</strong> = 'http://schemas.google.com/g/2005/labels#viewed'<br>
+<strong>__author__</strong> = 'api.jfisher (Jeff Fisher), e.bidelman (Eric Bidelman)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jfisher (Jeff Fisher), e.bidelman (Eric Bidelman)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.dublincore.data.html b/pydocs/gdata.dublincore.data.html
new file mode 100644
index 0000000..35bbad6
--- /dev/null
+++ b/pydocs/gdata.dublincore.data.html
@@ -0,0 +1,1521 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.dublincore.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.dublincore.html"><font color="#ffffff">dublincore</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/dublincore/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/dublincore/data.py</a></font></td></tr></table>
+ <p><tt>Contains the data classes of the Dublin Core Metadata Initiative (DCMI) Extension</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.dublincore.data.html#Creator">Creator</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.dublincore.data.html#Date">Date</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.dublincore.data.html#Description">Description</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.dublincore.data.html#Format">Format</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.dublincore.data.html#Identifier">Identifier</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.dublincore.data.html#Language">Language</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.dublincore.data.html#Publisher">Publisher</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.dublincore.data.html#Rights">Rights</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.dublincore.data.html#Subject">Subject</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.dublincore.data.html#Title">Title</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Creator">class <strong>Creator</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Entity primarily responsible for making the resource.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.dublincore.data.html#Creator">Creator</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Creator-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Creator-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Creator-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Creator-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Creator-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Creator-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Creator-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Creator-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Creator-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Creator-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Date">class <strong>Date</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Point or period of time associated with an event in the lifecycle of the resource.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.dublincore.data.html#Date">Date</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Date-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Date-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Date-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Date-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Date-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Date-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Date-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Date-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Date-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Date-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Description">class <strong>Description</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Account of the resource.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.dublincore.data.html#Description">Description</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Description-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Description-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Description-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Description-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Description-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Description-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Description-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Description-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Description-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Description-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Format">class <strong>Format</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>File format, physical medium, or dimensions of the resource.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.dublincore.data.html#Format">Format</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Format-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Format-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Format-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Format-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Format-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Format-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Format-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Format-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Format-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Format-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Identifier">class <strong>Identifier</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An unambiguous reference to the resource within a given context.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.dublincore.data.html#Identifier">Identifier</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Identifier-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Identifier-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Identifier-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Identifier-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Identifier-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Identifier-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Identifier-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Identifier-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Identifier-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Identifier-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Language">class <strong>Language</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Language">Language</a> of the resource.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.dublincore.data.html#Language">Language</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Language-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Language-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Language-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Language-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Language-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Language-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Language-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Language-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Language-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Language-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Publisher">class <strong>Publisher</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Entity responsible for making the resource available.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.dublincore.data.html#Publisher">Publisher</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Publisher-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Publisher-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Publisher-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Rights">class <strong>Rights</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Information about rights held in and over the resource.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.dublincore.data.html#Rights">Rights</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Rights-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rights-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rights-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Rights-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rights-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Rights-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Rights-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Rights-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Rights-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Rights-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Subject">class <strong>Subject</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Topic of the resource.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.dublincore.data.html#Subject">Subject</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Subject-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subject-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subject-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Subject-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subject-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Subject-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Subject-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Subject-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Subject-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Subject-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Title">class <strong>Title</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Name given to the resource.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.dublincore.data.html#Title">Title</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Title-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Title-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Title-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Title-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Title-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Title-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Title-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Title-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Title-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Title-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>DC_TEMPLATE</strong> = '{http://purl.org/dc/terms/}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.dublincore.html b/pydocs/gdata.dublincore.html
new file mode 100644
index 0000000..f69baac
--- /dev/null
+++ b/pydocs/gdata.dublincore.html
@@ -0,0 +1,34 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.dublincore</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.dublincore</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/dublincore/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/dublincore/__init__.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.dublincore.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.exif.html b/pydocs/gdata.exif.html
new file mode 100644
index 0000000..fb0c4fb
--- /dev/null
+++ b/pydocs/gdata.exif.html
@@ -0,0 +1,759 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.exif</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.exif</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/exif/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/exif/__init__.py</a></font></td></tr></table>
+ <p><tt>This module maps elements from the {EXIF} namespace[1] to GData objects. <br>
+These elements describe image data, using exif attributes[2].<br>
+ <br>
+Picasa Web Albums uses the exif namespace to represent Exif data encoded <br>
+in a photo [3].<br>
+ <br>
+Picasa Web Albums uses the following exif elements:<br>
+exif:distance<br>
+exif:exposure<br>
+exif:flash<br>
+exif:focallength<br>
+exif:fstop<br>
+exif:imageUniqueID<br>
+exif:iso<br>
+exif:make<br>
+exif:model<br>
+exif:tags<br>
+exif:time<br>
+ <br>
+[1]: <a href="http://schemas.google.com/photos/exif/2007">http://schemas.google.com/photos/exif/2007</a>. <br>
+[2]: <a href="http://en.wikipedia.org/wiki/Exif">http://en.wikipedia.org/wiki/Exif</a><br>
+[3]: <a href="http://code.google.com/apis/picasaweb/reference.html#exif_reference">http://code.google.com/apis/picasaweb/reference.html#exif_reference</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.exif.html#Distance">Distance</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.exif.html#Exposure">Exposure</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.exif.html#Flash">Flash</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.exif.html#Focallength">Focallength</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.exif.html#Fstop">Fstop</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.exif.html#ImageUniqueID">ImageUniqueID</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.exif.html#Iso">Iso</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.exif.html#Make">Make</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.exif.html#Model">Model</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.exif.html#Tags">Tags</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.exif.html#Time">Time</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Distance">class <strong>Distance</strong></a>(<a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(float) The distance to the subject, e.g. 0.0<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#Distance">Distance</a></dd>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>:<br>
+<dl><dt><a name="Distance-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Distance-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Distance-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Distance-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExifBaseElement">class <strong>ExifBaseElement</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ExifBaseElement-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ExifBaseElement-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ExifBaseElement-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ExifBaseElement-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Exposure">class <strong>Exposure</strong></a>(<a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(float) The exposure time used, e.g. 0.025 or 8.0E4<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#Exposure">Exposure</a></dd>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>:<br>
+<dl><dt><a name="Exposure-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Exposure-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Exposure-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Exposure-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Flash">class <strong>Flash</strong></a>(<a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(string) Boolean value indicating whether the flash was used.<br>
+The .text attribute will either be `true' or `false'<br>
+ <br>
+As a convenience, this object's .bool method will return what you want,<br>
+so you can say:<br>
+ <br>
+flash_used = bool(<a href="#Flash">Flash</a>)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#Flash">Flash</a></dd>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Flash-__bool__"><strong>__bool__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>:<br>
+<dl><dt><a name="Flash-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Flash-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Flash-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Flash-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Focallength">class <strong>Focallength</strong></a>(<a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(float) The focal length used, e.g. 23.7<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#Focallength">Focallength</a></dd>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>:<br>
+<dl><dt><a name="Focallength-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Focallength-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Focallength-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Focallength-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Fstop">class <strong>Fstop</strong></a>(<a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(float) The fstop value used, e.g. 5.0<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#Fstop">Fstop</a></dd>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>:<br>
+<dl><dt><a name="Fstop-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Fstop-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Fstop-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Fstop-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ImageUniqueID">class <strong>ImageUniqueID</strong></a>(<a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(string) The unique image ID for the photo. Generated by Google Photo servers<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#ImageUniqueID">ImageUniqueID</a></dd>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>:<br>
+<dl><dt><a name="ImageUniqueID-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ImageUniqueID-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ImageUniqueID-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ImageUniqueID-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Iso">class <strong>Iso</strong></a>(<a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(int) The iso equivalent value used, e.g. 200<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#Iso">Iso</a></dd>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>:<br>
+<dl><dt><a name="Iso-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Iso-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Iso-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Iso-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Make">class <strong>Make</strong></a>(<a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(string) The make of the camera used, e.g. Fictitious Camera Company<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#Make">Make</a></dd>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>:<br>
+<dl><dt><a name="Make-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Make-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Make-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Make-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Model">class <strong>Model</strong></a>(<a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(string) The model of the camera used,e.g AMAZING-100D<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#Model">Model</a></dd>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>:<br>
+<dl><dt><a name="Model-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Model-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Model-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Model-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Tags">class <strong>Tags</strong></a>(<a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The container for all exif elements.<br>
+The <exif:tags> element can appear as a child of a photo entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#Tags">Tags</a></dd>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Tags-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Tags-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Tags-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Tags-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Time">class <strong>Time</strong></a>(<a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(int) The date/time the photo was taken, e.g. 1180294337000.<br>
+Represented as the number of milliseconds since January 1st, 1970.<br>
+ <br>
+The value of this element will always be identical to the value<br>
+of the <gphoto:timestamp>.<br>
+ <br>
+Look at this object's .<a href="#Time-isoformat">isoformat</a>() for a human friendly datetime string:<br>
+ <br>
+photo_epoch = <a href="#Time">Time</a>.text # 1180294337000<br>
+photo_isostring = <a href="#Time">Time</a>.<a href="#Time-isoformat">isoformat</a>() # '2007-05-27T19:32:17.000Z'<br>
+ <br>
+Alternatively: <br>
+photo_datetime = <a href="#Time">Time</a>.<a href="#Time-datetime">datetime</a>() # (requires python >= 2.3)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.exif.html#Time">Time</a></dd>
+<dd><a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Time-datetime"><strong>datetime</strong></a>(self)</dt><dd><tt>(datetime.datetime) Return the timestamp as a datetime.datetime object<br>
+ <br>
+Requires python 2.3</tt></dd></dl>
+
+<dl><dt><a name="Time-isoformat"><strong>isoformat</strong></a>(self)</dt><dd><tt>(string) Return the timestamp as a ISO 8601 formatted string,<br>
+e.g. '2007-05-27T19:32:17.000Z'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.exif.html#ExifBaseElement">ExifBaseElement</a>:<br>
+<dl><dt><a name="Time-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Time-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Time-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Time-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-DistanceFromString"><strong>DistanceFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ExposureFromString"><strong>ExposureFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-FlashFromString"><strong>FlashFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-FocallengthFromString"><strong>FocallengthFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-FstopFromString"><strong>FstopFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ImageUniqueIDFromString"><strong>ImageUniqueIDFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-IsoFromString"><strong>IsoFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-MakeFromString"><strong>MakeFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ModelFromString"><strong>ModelFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TagsFromString"><strong>TagsFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TimeFromString"><strong>TimeFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>EXIF_NAMESPACE</strong> = 'http://schemas.google.com/photos/exif/2007'<br>
+<strong>__author__</strong> = u'havard@gulldahl.no'<br>
+<strong>__license__</strong> = 'Apache License v2'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">havard@gulldahl.no</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.finance.data.html b/pydocs/gdata.finance.data.html
new file mode 100644
index 0000000..bafc199
--- /dev/null
+++ b/pydocs/gdata.finance.data.html
@@ -0,0 +1,3632 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.finance.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.finance.html"><font color="#ffffff">finance</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/finance/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/finance/data.py</a></font></td></tr></table>
+ <p><tt>Contains the data classes of the Google Finance Portfolio Data API</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.finance.data.html#Commission">Commission</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#CostBasis">CostBasis</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#DaysGain">DaysGain</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#Gain">Gain</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#MarketValue">MarketValue</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#PortfolioData">PortfolioData</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#PositionData">PositionData</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#Price">Price</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#Symbol">Symbol</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#TransactionData">TransactionData</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.finance.data.html#PortfolioEntry">PortfolioEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#PositionEntry">PositionEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#TransactionEntry">TransactionEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.finance.data.html#PortfolioFeed">PortfolioFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#PositionFeed">PositionFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.data.html#TransactionFeed">TransactionFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Commission">class <strong>Commission</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Commission">Commission</a> for the transaction<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#Commission">Commission</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>money</strong> = [<class 'gdata.data.Money'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Commission-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Commission-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Commission-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Commission-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Commission-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Commission-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Commission-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Commission-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Commission-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Commission-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CostBasis">class <strong>CostBasis</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Cost basis for the portfolio or position<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#CostBasis">CostBasis</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>money</strong> = [<class 'gdata.data.Money'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CostBasis-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CostBasis-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CostBasis-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CostBasis-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CostBasis-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CostBasis-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CostBasis-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CostBasis-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CostBasis-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CostBasis-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DaysGain">class <strong>DaysGain</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Today's gain for the portfolio or position<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#DaysGain">DaysGain</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>money</strong> = [<class 'gdata.data.Money'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="DaysGain-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DaysGain-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DaysGain-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DaysGain-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DaysGain-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="DaysGain-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="DaysGain-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DaysGain-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DaysGain-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DaysGain-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Gain">class <strong>Gain</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Total gain for the portfolio or position<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#Gain">Gain</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>money</strong> = [<class 'gdata.data.Money'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Gain-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gain-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gain-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Gain-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gain-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Gain-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Gain-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Gain-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Gain-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Gain-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MarketValue">class <strong>MarketValue</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Market value for the portfolio or position<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#MarketValue">MarketValue</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>money</strong> = [<class 'gdata.data.Money'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MarketValue-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MarketValue-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MarketValue-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MarketValue-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MarketValue-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MarketValue-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MarketValue-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MarketValue-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MarketValue-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MarketValue-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PortfolioData">class <strong>PortfolioData</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Data for the portfolio<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#PortfolioData">PortfolioData</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>cost_basis</strong> = <class 'gdata.finance.data.CostBasis'><dd><tt>Cost basis for the portfolio or position</tt></dl>
+
+<dl><dt><strong>currency_code</strong> = 'currencyCode'</dl>
+
+<dl><dt><strong>days_gain</strong> = <class 'gdata.finance.data.DaysGain'><dd><tt>Today's gain for the portfolio or position</tt></dl>
+
+<dl><dt><strong>gain</strong> = <class 'gdata.finance.data.Gain'><dd><tt>Total gain for the portfolio or position</tt></dl>
+
+<dl><dt><strong>gain_percentage</strong> = 'gainPercentage'</dl>
+
+<dl><dt><strong>market_value</strong> = <class 'gdata.finance.data.MarketValue'><dd><tt>Market value for the portfolio or position</tt></dl>
+
+<dl><dt><strong>return1w</strong> = 'return1w'</dl>
+
+<dl><dt><strong>return1y</strong> = 'return1y'</dl>
+
+<dl><dt><strong>return3m</strong> = 'return3m'</dl>
+
+<dl><dt><strong>return3y</strong> = 'return3y'</dl>
+
+<dl><dt><strong>return4w</strong> = 'return4w'</dl>
+
+<dl><dt><strong>return5y</strong> = 'return5y'</dl>
+
+<dl><dt><strong>return_overall</strong> = 'returnOverall'</dl>
+
+<dl><dt><strong>return_y_t_d</strong> = 'returnYTD'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PortfolioData-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioData-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioData-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioData-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioData-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioData-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="PortfolioData-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioData-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioData-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioData-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PortfolioEntry">class <strong>PortfolioEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an entry in a feed of Finance portfolios<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#PortfolioEntry">PortfolioEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>portfolio_data</strong> = <class 'gdata.finance.data.PortfolioData'><dd><tt>Data for the portfolio</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="PortfolioEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="PortfolioEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PortfolioEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="PortfolioEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="PortfolioEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PortfolioFeed">class <strong>PortfolioFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a Finance portfolio feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#PortfolioFeed">PortfolioFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.finance.data.PortfolioEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="PortfolioFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="PortfolioFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PortfolioFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="PortfolioFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="PortfolioFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PositionData">class <strong>PositionData</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Data for the position<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#PositionData">PositionData</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>cost_basis</strong> = <class 'gdata.finance.data.CostBasis'><dd><tt>Cost basis for the portfolio or position</tt></dl>
+
+<dl><dt><strong>days_gain</strong> = <class 'gdata.finance.data.DaysGain'><dd><tt>Today's gain for the portfolio or position</tt></dl>
+
+<dl><dt><strong>gain</strong> = <class 'gdata.finance.data.Gain'><dd><tt>Total gain for the portfolio or position</tt></dl>
+
+<dl><dt><strong>gain_percentage</strong> = 'gainPercentage'</dl>
+
+<dl><dt><strong>market_value</strong> = <class 'gdata.finance.data.MarketValue'><dd><tt>Market value for the portfolio or position</tt></dl>
+
+<dl><dt><strong>return1w</strong> = 'return1w'</dl>
+
+<dl><dt><strong>return1y</strong> = 'return1y'</dl>
+
+<dl><dt><strong>return3m</strong> = 'return3m'</dl>
+
+<dl><dt><strong>return3y</strong> = 'return3y'</dl>
+
+<dl><dt><strong>return4w</strong> = 'return4w'</dl>
+
+<dl><dt><strong>return5y</strong> = 'return5y'</dl>
+
+<dl><dt><strong>return_overall</strong> = 'returnOverall'</dl>
+
+<dl><dt><strong>return_y_t_d</strong> = 'returnYTD'</dl>
+
+<dl><dt><strong>shares</strong> = 'shares'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PositionData-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionData-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionData-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PositionData-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionData-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PositionData-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="PositionData-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionData-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PositionData-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionData-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PositionEntry">class <strong>PositionEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an entry in a feed of Finance positions<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#PositionEntry">PositionEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>position_data</strong> = <class 'gdata.finance.data.PositionData'><dd><tt>Data for the position</tt></dl>
+
+<dl><dt><strong>symbol</strong> = <class 'gdata.finance.data.Symbol'><dd><tt>Stock symbol for the company</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="PositionEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="PositionEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PositionEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="PositionEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="PositionEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PositionFeed">class <strong>PositionFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a Finance position feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#PositionFeed">PositionFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.finance.data.PositionEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="PositionFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="PositionFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PositionFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="PositionFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="PositionFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Price">class <strong>Price</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Price">Price</a> of the transaction<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#Price">Price</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>money</strong> = [<class 'gdata.data.Money'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Price-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Price-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Price-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Price-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Price-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Price-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Price-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Price-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Price-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Price-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Symbol">class <strong>Symbol</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Stock symbol for the company<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#Symbol">Symbol</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>exchange</strong> = 'exchange'</dl>
+
+<dl><dt><strong>full_name</strong> = 'fullName'</dl>
+
+<dl><dt><strong>symbol</strong> = 'symbol'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Symbol-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Symbol-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Symbol-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Symbol-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Symbol-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Symbol-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Symbol-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Symbol-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Symbol-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Symbol-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TransactionData">class <strong>TransactionData</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Data for the transction<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#TransactionData">TransactionData</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>commission</strong> = <class 'gdata.finance.data.Commission'><dd><tt><a href="#Commission">Commission</a> for the transaction</tt></dl>
+
+<dl><dt><strong>date</strong> = 'date'</dl>
+
+<dl><dt><strong>notes</strong> = 'notes'</dl>
+
+<dl><dt><strong>price</strong> = <class 'gdata.finance.data.Price'><dd><tt><a href="#Price">Price</a> of the transaction</tt></dl>
+
+<dl><dt><strong>shares</strong> = 'shares'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TransactionData-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionData-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionData-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TransactionData-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionData-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TransactionData-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TransactionData-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionData-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TransactionData-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionData-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TransactionEntry">class <strong>TransactionEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an entry in a feed of Finance transactions<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#TransactionEntry">TransactionEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>transaction_data</strong> = <class 'gdata.finance.data.TransactionData'><dd><tt>Data for the transction</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="TransactionEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="TransactionEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TransactionEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="TransactionEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="TransactionEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TransactionFeed">class <strong>TransactionFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a Finance transaction feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.data.html#TransactionFeed">TransactionFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.finance.data.TransactionEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="TransactionFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="TransactionFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TransactionFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="TransactionFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="TransactionFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GF_TEMPLATE</strong> = '{http://schemas.google.com/finance/2007/}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.finance.html b/pydocs/gdata.finance.html
new file mode 100644
index 0000000..780da52
--- /dev/null
+++ b/pydocs/gdata.finance.html
@@ -0,0 +1,1535 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.finance</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.finance</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/finance/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/finance/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains extensions to Atom objects used with Google Finance.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.finance.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.finance.service.html">service</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.finance.html#Money">Money</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#PortfolioData">PortfolioData</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#PositionData">PositionData</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#PositionFeedLink">PositionFeedLink</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#Symbol">Symbol</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#TransactionData">TransactionData</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#TransactionFeedLink">TransactionFeedLink</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.finance.html#PortfolioEntry">PortfolioEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#PositionEntry">PositionEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#TransactionEntry">TransactionEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.finance.html#PortfolioFeed">PortfolioFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#PositionFeed">PositionFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#TransactionFeed">TransactionFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.finance.html#_Monies">_Monies</a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.finance.html#Commission">Commission</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#CostBasis">CostBasis</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#DaysGain">DaysGain</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#Gain">Gain</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#MarketValue">MarketValue</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.html#Price">Price</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Commission">class <strong>Commission</strong></a>(<a href="gdata.finance.html#_Monies">_Monies</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <gf:commission> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#Commission">Commission</a></dd>
+<dd><a href="gdata.finance.html#_Monies">_Monies</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.finance.html#_Monies">_Monies</a>:<br>
+<dl><dt><a name="Commission-__init__"><strong>__init__</strong></a>(self, money<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="Commission-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Commission-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Commission-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CostBasis">class <strong>CostBasis</strong></a>(<a href="gdata.finance.html#_Monies">_Monies</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <gf:costBasis> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#CostBasis">CostBasis</a></dd>
+<dd><a href="gdata.finance.html#_Monies">_Monies</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.finance.html#_Monies">_Monies</a>:<br>
+<dl><dt><a name="CostBasis-__init__"><strong>__init__</strong></a>(self, money<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="CostBasis-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CostBasis-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CostBasis-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DaysGain">class <strong>DaysGain</strong></a>(<a href="gdata.finance.html#_Monies">_Monies</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <gf:daysGain> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#DaysGain">DaysGain</a></dd>
+<dd><a href="gdata.finance.html#_Monies">_Monies</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.finance.html#_Monies">_Monies</a>:<br>
+<dl><dt><a name="DaysGain-__init__"><strong>__init__</strong></a>(self, money<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="DaysGain-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="DaysGain-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="DaysGain-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Gain">class <strong>Gain</strong></a>(<a href="gdata.finance.html#_Monies">_Monies</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <gf:gain> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#Gain">Gain</a></dd>
+<dd><a href="gdata.finance.html#_Monies">_Monies</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.finance.html#_Monies">_Monies</a>:<br>
+<dl><dt><a name="Gain-__init__"><strong>__init__</strong></a>(self, money<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="Gain-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Gain-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Gain-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MarketValue">class <strong>MarketValue</strong></a>(<a href="gdata.finance.html#_Monies">_Monies</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <gf:marketValue> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#MarketValue">MarketValue</a></dd>
+<dd><a href="gdata.finance.html#_Monies">_Monies</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.finance.html#_Monies">_Monies</a>:<br>
+<dl><dt><a name="MarketValue-__init__"><strong>__init__</strong></a>(self, money<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MarketValue-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="MarketValue-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="MarketValue-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Money">class <strong>Money</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <gd:money> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#Money">Money</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Money-__init__"><strong>__init__</strong></a>(self, amount<font color="#909090">=None</font>, currency_code<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="Money-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Money-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Money-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PortfolioData">class <strong>PortfolioData</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <gf:portfolioData> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#PortfolioData">PortfolioData</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PortfolioData-__init__"><strong>__init__</strong></a>(self, currency_code<font color="#909090">=None</font>, gain_percentage<font color="#909090">=None</font>, return1w<font color="#909090">=None</font>, return4w<font color="#909090">=None</font>, return3m<font color="#909090">=None</font>, returnYTD<font color="#909090">=None</font>, return1y<font color="#909090">=None</font>, return3y<font color="#909090">=None</font>, return5y<font color="#909090">=None</font>, return_overall<font color="#909090">=None</font>, cost_basis<font color="#909090">=None</font>, days_gain<font color="#909090">=None</font>, gain<font color="#909090">=None</font>, market_value<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PortfolioData-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioData-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PortfolioData-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PortfolioEntry">class <strong>PortfolioEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An entry of the <a href="#PortfolioFeed">PortfolioFeed</a>.<br>
+ <br>
+A <a href="#PortfolioEntry">PortfolioEntry</a> contains the portfolio's title along with <a href="#PortfolioData">PortfolioData</a><br>
+such as currency, total market value, and overall performance statistics.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#PortfolioEntry">PortfolioEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PortfolioEntry-__init__"><strong>__init__</strong></a>(self, portfolio_data<font color="#909090">=None</font>, feed_link<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-set_portfolio_title"><strong>set_portfolio_title</strong></a>(self, portfolio_title)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>portfolio_id</strong></dt>
+<dd><tt>The portfolio ID. Do not confuse with portfolio.id.</tt></dd>
+</dl>
+<dl><dt><strong>portfolio_title</strong></dt>
+<dd><tt>The portfolio title as a string (i.e. portfolio.title.text).</tt></dd>
+</dl>
+<dl><dt><strong>positions</strong></dt>
+<dd><tt>Inlined PositionEntries are returned if PortfolioFeed was queried<br>
+with positions='true'.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="PortfolioEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PortfolioEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PortfolioEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="PortfolioEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="PortfolioEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PortfolioFeed">class <strong>PortfolioFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed that lists all of the user's portfolios.<br>
+ <br>
+A portfolio is a collection of positions that the user holds in various<br>
+securities, plus metadata. The <a href="#PortfolioFeed">PortfolioFeed</a> lists all of the user's<br>
+portfolios as a list of PortfolioEntries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#PortfolioFeed">PortfolioFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="PortfolioFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PortfolioFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PortfolioFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="PortfolioFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="PortfolioFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PositionData">class <strong>PositionData</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <gf:positionData> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#PositionData">PositionData</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PositionData-__init__"><strong>__init__</strong></a>(self, gain_percentage<font color="#909090">=None</font>, return1w<font color="#909090">=None</font>, return4w<font color="#909090">=None</font>, return3m<font color="#909090">=None</font>, returnYTD<font color="#909090">=None</font>, return1y<font color="#909090">=None</font>, return3y<font color="#909090">=None</font>, return5y<font color="#909090">=None</font>, return_overall<font color="#909090">=None</font>, shares<font color="#909090">=None</font>, cost_basis<font color="#909090">=None</font>, days_gain<font color="#909090">=None</font>, gain<font color="#909090">=None</font>, market_value<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PositionData-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PositionData-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PositionData-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PositionEntry">class <strong>PositionEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An entry of the position feed.<br>
+ <br>
+A <a href="#PositionEntry">PositionEntry</a> contains the ticker exchange and <a href="#Symbol">Symbol</a> for a stock,<br>
+mutual fund, or other security, along with <a href="#PositionData">PositionData</a> such as the<br>
+number of units of that security that the user holds, and performance<br>
+statistics.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#PositionEntry">PositionEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PositionEntry-__init__"><strong>__init__</strong></a>(self, position_data<font color="#909090">=None</font>, symbol<font color="#909090">=None</font>, feed_link<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>position_title</strong></dt>
+<dd><tt>The position title as a string (i.e. position.title.text).</tt></dd>
+</dl>
+<dl><dt><strong>ticker_id</strong></dt>
+<dd><tt>The position TICKER ID.</tt></dd>
+</dl>
+<dl><dt><strong>transactions</strong></dt>
+<dd><tt>Inlined TransactionEntries are returned if PositionFeed is queried<br>
+with transactions='true'.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="PositionEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PositionEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PositionEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="PositionEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PositionEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="PositionEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PositionFeed">class <strong>PositionFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed that lists all of the positions in a particular portfolio.<br>
+ <br>
+A position is a collection of information about a security that the<br>
+user holds. The <a href="#PositionFeed">PositionFeed</a> lists all of the positions in a particular<br>
+portfolio as a list of PositionEntries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#PositionFeed">PositionFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="PositionFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PositionFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PositionFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="PositionFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="PositionFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PositionFeedLink">class <strong>PositionFeedLink</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Link to <a href="#PositionFeed">PositionFeed</a> embedded in <a href="#PortfolioEntry">PortfolioEntry</a>.<br>
+ <br>
+If a <a href="#PortfolioFeed">PortfolioFeed</a> is queried with positions='true', the PositionFeeds<br>
+are inlined in the returned PortfolioEntries. These PositionFeeds are<br>
+accessible via <a href="#PositionFeedLink">PositionFeedLink</a>'s feed attribute.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#PositionFeedLink">PositionFeedLink</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PositionFeedLink-__init__"><strong>__init__</strong></a>(self, href<font color="#909090">=None</font>, feed<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PositionFeedLink-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PositionFeedLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PositionFeedLink-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Price">class <strong>Price</strong></a>(<a href="gdata.finance.html#_Monies">_Monies</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <gf:price> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#Price">Price</a></dd>
+<dd><a href="gdata.finance.html#_Monies">_Monies</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.finance.html#_Monies">_Monies</a>:<br>
+<dl><dt><a name="Price-__init__"><strong>__init__</strong></a>(self, money<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="Price-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Price-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Price-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Symbol">class <strong>Symbol</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <gf:symbol> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#Symbol">Symbol</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Symbol-__init__"><strong>__init__</strong></a>(self, full_name<font color="#909090">=None</font>, exchange<font color="#909090">=None</font>, symbol<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="Symbol-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Symbol-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Symbol-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TransactionData">class <strong>TransactionData</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The <gf:transactionData> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#TransactionData">TransactionData</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="TransactionData-__init__"><strong>__init__</strong></a>(self, type<font color="#909090">=None</font>, date<font color="#909090">=None</font>, shares<font color="#909090">=None</font>, notes<font color="#909090">=None</font>, commission<font color="#909090">=None</font>, price<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="TransactionData-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="TransactionData-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="TransactionData-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TransactionEntry">class <strong>TransactionEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An entry of the transaction feed.<br>
+ <br>
+A <a href="#TransactionEntry">TransactionEntry</a> contains <a href="#TransactionData">TransactionData</a> such as the transaction<br>
+type (Buy, Sell, Sell Short, or Buy to Cover), the number of units,<br>
+the date, the price, any commission, and any notes.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#TransactionEntry">TransactionEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="TransactionEntry-__init__"><strong>__init__</strong></a>(self, transaction_data<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>transaction_id</strong></dt>
+<dd><tt>The transaction ID.</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="TransactionEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="TransactionEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="TransactionEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="TransactionEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TransactionEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="TransactionEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TransactionFeed">class <strong>TransactionFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed that lists all of the transactions that have been recorded for<br>
+a particular position.<br>
+ <br>
+A transaction is a collection of information about an instance of<br>
+buying or selling a particular security. The <a href="#TransactionFeed">TransactionFeed</a> lists all<br>
+of the transactions that have been recorded for a particular position<br>
+as a list of TransactionEntries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#TransactionFeed">TransactionFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="TransactionFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="TransactionFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="TransactionFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="TransactionFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="TransactionFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TransactionFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TransactionFeedLink">class <strong>TransactionFeedLink</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Link to <a href="#TransactionFeed">TransactionFeed</a> embedded in <a href="#PositionEntry">PositionEntry</a>.<br>
+ <br>
+If a <a href="#PositionFeed">PositionFeed</a> is queried with transactions='true', TransactionFeeds<br>
+are inlined in the returned PositionEntries. These TransactionFeeds are<br>
+accessible via <a href="#TransactionFeedLink">TransactionFeedLink</a>'s feed attribute.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.html#TransactionFeedLink">TransactionFeedLink</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="TransactionFeedLink-__init__"><strong>__init__</strong></a>(self, href<font color="#909090">=None</font>, feed<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="TransactionFeedLink-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="TransactionFeedLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="TransactionFeedLink-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-CommissionFromString"><strong>CommissionFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CostBasisFromString"><strong>CostBasisFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-DaysGainFromString"><strong>DaysGainFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-GainFromString"><strong>GainFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-MarketValueFromString"><strong>MarketValueFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-MoneyFromString"><strong>MoneyFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PortfolioDataFromString"><strong>PortfolioDataFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PortfolioEntryFromString"><strong>PortfolioEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PortfolioFeedFromString"><strong>PortfolioFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PositionDataFromString"><strong>PositionDataFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PositionEntryFromString"><strong>PositionEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PositionFeedFromString"><strong>PositionFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PriceFromString"><strong>PriceFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SymbolFromString"><strong>SymbolFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TransactionDataFromString"><strong>TransactionDataFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TransactionEntryFromString"><strong>TransactionEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TransactionFeedFromString"><strong>TransactionFeedFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GD_NAMESPACE</strong> = 'http://schemas.google.com/g/2005'<br>
+<strong>GF_NAMESPACE</strong> = 'http://schemas.google.com/finance/2007'<br>
+<strong>__author__</strong> = 'thesweeheng@gmail.com'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">thesweeheng@gmail.com</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.finance.service.html b/pydocs/gdata.finance.service.html
new file mode 100644
index 0000000..88f235f
--- /dev/null
+++ b/pydocs/gdata.finance.service.html
@@ -0,0 +1,1060 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.finance.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.finance.html"><font color="#ffffff">finance</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/finance/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/finance/service.py</a></font></td></tr></table>
+ <p><tt>Classes to interact with the Google Finance server.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.finance.service.html#FinanceService">FinanceService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Query">gdata.service.Query</a>(<a href="__builtin__.html#dict">__builtin__.dict</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.finance.service.html#PortfolioQuery">PortfolioQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.finance.service.html#PositionQuery">PositionQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FinanceService">class <strong>FinanceService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.service.html#FinanceService">FinanceService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="FinanceService-AddPortfolio"><strong>AddPortfolio</strong></a>(self, portfolio_entry<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="FinanceService-AddTransaction"><strong>AddTransaction</strong></a>(self, transaction_entry<font color="#909090">=None</font>, transaction_feed<font color="#909090">=None</font>, position_entry<font color="#909090">=None</font>, portfolio_id<font color="#909090">=None</font>, ticker_id<font color="#909090">=None</font>)</dt><dd><tt>Args:<br>
+ transaction_entry: TransactionEntry (required)<br>
+ transaction_feed: TransactionFeed (optional; see Notes)<br>
+ position_entry: PositionEntry (optional; see Notes)<br>
+ portfolio_id: string (optional; see Notes) This may be obtained<br>
+ from a PortfolioEntry's portfolio_id attribute.<br>
+ ticker_id: string (optional; see Notes) This may be obtained from<br>
+ a PositionEntry's ticker_id attribute. Alternatively it can<br>
+ be constructed using the security's exchange and symbol,<br>
+ e.g. 'NASDAQ:GOOG'<br>
+ <br>
+Notes:<br>
+ Either a TransactionFeed OR a PositionEntry OR (a portfolio ID AND<br>
+ ticker ID) must be provided.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-DeletePortfolio"><strong>DeletePortfolio</strong></a>(self, portfolio_entry<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="FinanceService-DeletePosition"><strong>DeletePosition</strong></a>(self, position_entry<font color="#909090">=None</font>, portfolio_id<font color="#909090">=None</font>, ticker_id<font color="#909090">=None</font>, transaction_feed<font color="#909090">=None</font>)</dt><dd><tt>A position is deleted by deleting all its transactions.<br>
+ <br>
+Args:<br>
+ position_entry: PositionEntry (optional; see Notes)<br>
+ portfolio_id: string (optional; see Notes) This may be obtained<br>
+ from a PortfolioEntry's portfolio_id attribute.<br>
+ ticker_id: string (optional; see Notes) This may be obtained from<br>
+ a PositionEntry's ticker_id attribute. Alternatively it can<br>
+ be constructed using the security's exchange and symbol,<br>
+ e.g. 'NASDAQ:GOOG'<br>
+ transaction_feed: TransactionFeed (optional; see Notes)<br>
+ <br>
+Notes:<br>
+ Either a PositionEntry OR (a portfolio ID AND ticker ID) OR<br>
+ a TransactionFeed must be provided.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-DeleteTransaction"><strong>DeleteTransaction</strong></a>(self, transaction_entry<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="FinanceService-GetPortfolio"><strong>GetPortfolio</strong></a>(self, portfolio_id<font color="#909090">=None</font>, query<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="FinanceService-GetPortfolioFeed"><strong>GetPortfolioFeed</strong></a>(self, query<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="FinanceService-GetPosition"><strong>GetPosition</strong></a>(self, portfolio_id<font color="#909090">=None</font>, ticker_id<font color="#909090">=None</font>, query<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="FinanceService-GetPositionFeed"><strong>GetPositionFeed</strong></a>(self, portfolio_entry<font color="#909090">=None</font>, portfolio_id<font color="#909090">=None</font>, query<font color="#909090">=None</font>)</dt><dd><tt>Args:<br>
+ portfolio_entry: PortfolioEntry (optional; see Notes)<br>
+ portfolio_id: string (optional; see Notes) This may be obtained<br>
+ from a PortfolioEntry's portfolio_id attribute.<br>
+ query: <a href="#PortfolioQuery">PortfolioQuery</a> (optional)<br>
+ <br>
+Notes:<br>
+ Either a PortfolioEntry OR a portfolio ID must be provided.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-GetTransaction"><strong>GetTransaction</strong></a>(self, portfolio_id<font color="#909090">=None</font>, ticker_id<font color="#909090">=None</font>, transaction_id<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="FinanceService-GetTransactionFeed"><strong>GetTransactionFeed</strong></a>(self, position_entry<font color="#909090">=None</font>, portfolio_id<font color="#909090">=None</font>, ticker_id<font color="#909090">=None</font>)</dt><dd><tt>Args:<br>
+ position_entry: PositionEntry (optional; see Notes)<br>
+ portfolio_id: string (optional; see Notes) This may be obtained<br>
+ from a PortfolioEntry's portfolio_id attribute.<br>
+ ticker_id: string (optional; see Notes) This may be obtained from<br>
+ a PositionEntry's ticker_id attribute. Alternatively it can<br>
+ be constructed using the security's exchange and symbol,<br>
+ e.g. 'NASDAQ:GOOG'<br>
+ <br>
+Notes:<br>
+ Either a PositionEntry OR (a portfolio ID AND ticker ID) must<br>
+ be provided.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-UpdatePortfolio"><strong>UpdatePortfolio</strong></a>(self, portfolio_entry<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="FinanceService-UpdateTransaction"><strong>UpdateTransaction</strong></a>(self, transaction_entry<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="FinanceService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='finance.google.com'</font>, **kwargs)</dt><dd><tt>Creates a client for the Finance service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'finance.google.com'.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="FinanceService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FinanceService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#FinanceService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#FinanceService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#FinanceService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="FinanceService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="FinanceService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PortfolioQuery">class <strong>PortfolioQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A query object for the list of a user's portfolios.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.service.html#PortfolioQuery">PortfolioQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PortfolioQuery-set_positions"><strong>set_positions</strong></a>(self, value)</dt></dl>
+
+<dl><dt><a name="PortfolioQuery-set_returns"><strong>set_returns</strong></a>(self, value)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>positions</strong></dt>
+<dd><tt>The positions query parameter</tt></dd>
+</dl>
+<dl><dt><strong>returns</strong></dt>
+<dd><tt>The returns query parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="PortfolioQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PortfolioQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="gdata.service.html#Query">Query</a><br>
+ <br>
+Args:<br>
+ feed: str (optional) The path for the feed (Examples: <br>
+ '/base/feeds/snippets' or 'calendar/feeds/jo@gmail.com/private/full'<br>
+ text_query: str (optional) The contents of the q query parameter. The<br>
+ contents of the text_query are URL escaped upon conversion to a URI.<br>
+ params: dict (optional) Parameter value string pairs which become URL<br>
+ params when translated to a URI. These parameters are added to the<br>
+ query's items (key-value pairs).<br>
+ categories: list (optional) List of category strings which should be<br>
+ included as query categories. See <br>
+ <a href="http://code.google.com/apis/gdata/reference.html#Queries">http://code.google.com/apis/gdata/reference.html#Queries</a> for <br>
+ details. If you want to get results from category A or B (both <br>
+ categories), specify a single list item 'A|B'.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="PortfolioQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#PortfolioQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#PortfolioQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#PortfolioQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#PortfolioQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#PortfolioQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="PortfolioQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#PortfolioQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#PortfolioQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PositionQuery">class <strong>PositionQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A query object for the list of a user's positions in a portfolio.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.finance.service.html#PositionQuery">PositionQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PositionQuery-set_returns"><strong>set_returns</strong></a>(self, value)</dt></dl>
+
+<dl><dt><a name="PositionQuery-set_transactions"><strong>set_transactions</strong></a>(self, value)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>returns</strong></dt>
+<dd><tt>The returns query parameter</tt></dd>
+</dl>
+<dl><dt><strong>transactions</strong></dt>
+<dd><tt>The transactions query parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="PositionQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PositionQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="gdata.service.html#Query">Query</a><br>
+ <br>
+Args:<br>
+ feed: str (optional) The path for the feed (Examples: <br>
+ '/base/feeds/snippets' or 'calendar/feeds/jo@gmail.com/private/full'<br>
+ text_query: str (optional) The contents of the q query parameter. The<br>
+ contents of the text_query are URL escaped upon conversion to a URI.<br>
+ params: dict (optional) Parameter value string pairs which become URL<br>
+ params when translated to a URI. These parameters are added to the<br>
+ query's items (key-value pairs).<br>
+ categories: list (optional) List of category strings which should be<br>
+ included as query categories. See <br>
+ <a href="http://code.google.com/apis/gdata/reference.html#Queries">http://code.google.com/apis/gdata/reference.html#Queries</a> for <br>
+ details. If you want to get results from category A or B (both <br>
+ categories), specify a single list item 'A|B'.</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="PositionQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#PositionQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#PositionQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#PositionQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#PositionQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#PositionQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="PositionQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#PositionQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#PositionQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'thesweeheng@gmail.com'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">thesweeheng@gmail.com</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.gauth.html b/pydocs/gdata.gauth.html
new file mode 100644
index 0000000..999023d
--- /dev/null
+++ b/pydocs/gdata.gauth.html
@@ -0,0 +1,1566 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.gauth</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.gauth</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/gauth.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/gauth.py</a></font></td></tr></table>
+ <p><tt>Provides auth related token classes and functions for Google Data APIs.<br>
+ <br>
+Token classes represent a user's authorization of this app to access their<br>
+data. Usually these are not created directly but by a GDClient <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+<a href="#ClientLoginToken">ClientLoginToken</a><br>
+<a href="#AuthSubToken">AuthSubToken</a><br>
+<a href="#SecureAuthSubToken">SecureAuthSubToken</a><br>
+<a href="#OAuthHmacToken">OAuthHmacToken</a><br>
+<a href="#OAuthRsaToken">OAuthRsaToken</a><br>
+<a href="#TwoLeggedOAuthHmacToken">TwoLeggedOAuthHmacToken</a><br>
+<a href="#TwoLeggedOAuthRsaToken">TwoLeggedOAuthRsaToken</a><br>
+ <br>
+Functions which are often used in application code (as opposed to just within<br>
+the gdata-python-client library) are the following:<br>
+ <br>
+generate_auth_sub_url<br>
+authorize_request_token<br>
+ <br>
+The following are helper functions which are used to save and load auth token<br>
+objects in the App Engine datastore. These should only be used if you are using<br>
+this library within App Engine:<br>
+ <br>
+ae_load<br>
+ae_save</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+<a href="datetime.html">datetime</a><br>
+</td><td width="25%" valign=top><a href="random.html">random</a><br>
+<a href="simplejson.html">simplejson</a><br>
+</td><td width="25%" valign=top><a href="time.html">time</a><br>
+<a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top><a href="urlparse.html">urlparse</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.gauth.html#AuthSubToken">AuthSubToken</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.gauth.html#SecureAuthSubToken">SecureAuthSubToken</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.gauth.html#ClientLoginToken">ClientLoginToken</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.gauth.html#OAuth2Token">OAuth2Token</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.gauth.html#OAuth2TokenFromCredentials">OAuth2TokenFromCredentials</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.gauth.html#OAuthRsaToken">OAuthRsaToken</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.gauth.html#TwoLeggedOAuthRsaToken">TwoLeggedOAuthRsaToken</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.gauth.html#TwoLeggedOAuthHmacToken">TwoLeggedOAuthHmacToken</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.gauth.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.gauth.html#OAuth2AccessTokenError">OAuth2AccessTokenError</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.gauth.html#OAuth2RevokeError">OAuth2RevokeError</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.gauth.html#UnsupportedTokenType">UnsupportedTokenType</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AuthSubToken">class <strong>AuthSubToken</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="AuthSubToken-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#AuthSubToken-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="AuthSubToken-__init__"><strong>__init__</strong></a>(self, token_string, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AuthSubToken-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Sets Authorization header, allows app to act on the user's behalf.</tt></dd></dl>
+
+<hr>
+Static methods defined here:<br>
+<dl><dt><a name="AuthSubToken-FromUrl"><strong>FromUrl</strong></a> = from_url(str_or_uri)</dt><dd><tt>Creates a new <a href="#AuthSubToken">AuthSubToken</a> using information in the URL.<br>
+ <br>
+Uses auth_sub_string_from_url.<br>
+ <br>
+Args:<br>
+ str_or_uri: The current page's URL (as a str or atom.http_core.Uri)<br>
+ which should contain a token query parameter since the<br>
+ Google auth server redirected the user's browser to this<br>
+ URL.</tt></dd></dl>
+
+<dl><dt><a name="AuthSubToken-from_url"><strong>from_url</strong></a>(str_or_uri)</dt><dd><tt>Creates a new <a href="#AuthSubToken">AuthSubToken</a> using information in the URL.<br>
+ <br>
+Uses auth_sub_string_from_url.<br>
+ <br>
+Args:<br>
+ str_or_uri: The current page's URL (as a str or atom.http_core.Uri)<br>
+ which should contain a token query parameter since the<br>
+ Google auth server redirected the user's browser to this<br>
+ URL.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ClientLoginToken">class <strong>ClientLoginToken</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="ClientLoginToken-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#ClientLoginToken-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="ClientLoginToken-__init__"><strong>__init__</strong></a>(self, token_string)</dt></dl>
+
+<dl><dt><a name="ClientLoginToken-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.gauth.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuth2AccessTokenError">class <strong>OAuth2AccessTokenError</strong></a>(<a href="gdata.gauth.html#Error">Error</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Raised when an OAuth2 error occurs.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.gauth.html#OAuth2AccessTokenError">OAuth2AccessTokenError</a></dd>
+<dd><a href="gdata.gauth.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OAuth2AccessTokenError-__init__"><strong>__init__</strong></a>(self, error_message)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.gauth.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#OAuth2AccessTokenError-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="OAuth2AccessTokenError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2AccessTokenError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="OAuth2AccessTokenError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2AccessTokenError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="OAuth2AccessTokenError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2AccessTokenError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="OAuth2AccessTokenError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2AccessTokenError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="OAuth2AccessTokenError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="OAuth2AccessTokenError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2AccessTokenError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="OAuth2AccessTokenError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2AccessTokenError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="OAuth2AccessTokenError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="OAuth2AccessTokenError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2AccessTokenError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="OAuth2AccessTokenError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuth2RevokeError">class <strong>OAuth2RevokeError</strong></a>(<a href="gdata.gauth.html#Error">Error</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Raised when an OAuth2 token revocation was unsuccessful.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.gauth.html#OAuth2RevokeError">OAuth2RevokeError</a></dd>
+<dd><a href="gdata.gauth.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OAuth2RevokeError-__init__"><strong>__init__</strong></a>(self, http_response, response_body<font color="#909090">=None</font>)</dt><dd><tt>Sets the HTTP information in the error.<br>
+ <br>
+Args:<br>
+ http_response: The response from the server, contains error information.<br>
+ response_body: string (optional) specified if the response has already<br>
+ been read from the http_response <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+
+<dl><dt><a name="OAuth2RevokeError-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.gauth.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#OAuth2RevokeError-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="OAuth2RevokeError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2RevokeError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="OAuth2RevokeError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2RevokeError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="OAuth2RevokeError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2RevokeError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="OAuth2RevokeError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2RevokeError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="OAuth2RevokeError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="OAuth2RevokeError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2RevokeError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="OAuth2RevokeError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuth2RevokeError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="OAuth2RevokeError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="OAuth2RevokeError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuth2Token">class <strong>OAuth2Token</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Token <a href="__builtin__.html#object">object</a> for OAuth 2.0 as described on<br>
+<<a href="http://code.google.com/apis/accounts/docs/OAuth2.html">http://code.google.com/apis/accounts/docs/OAuth2.html</a>>.<br>
+ <br>
+Token can be applied to a gdata.client.GDClient <a href="__builtin__.html#object">object</a> using the <a href="#OAuth2Token-authorize">authorize</a>()<br>
+method, which then signs each request from that <a href="__builtin__.html#object">object</a> with the OAuth 2.0<br>
+access token.<br>
+This class supports 3 flows of OAuth 2.0:<br>
+ Client-side web flow: call generate_authorize_url with `response_type='token''<br>
+ and the registered `redirect_uri'.<br>
+ Server-side web flow: call generate_authorize_url with the registered<br>
+ `redirect_url'.<br>
+ Native applications flow: call generate_authorize_url as it is. You will have<br>
+ to ask the user to go to the generated url and pass in the authorization<br>
+ code to your application.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="OAuth2Token-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#OAuth2Token-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="OAuth2Token-__init__"><strong>__init__</strong></a>(self, client_id, client_secret, scope, user_agent, auth_uri<font color="#909090">='https://accounts.google.com/o/oauth2/auth'</font>, token_uri<font color="#909090">='https://accounts.google.com/o/oauth2/token'</font>, access_token<font color="#909090">=None</font>, refresh_token<font color="#909090">=None</font>, revoke_uri<font color="#909090">='https://accounts.google.com/o/oauth2/revoke'</font>)</dt><dd><tt>Create an instance of <a href="#OAuth2Token">OAuth2Token</a><br>
+ <br>
+Args:<br>
+ client_id: string, client identifier.<br>
+ client_secret: string client secret.<br>
+ scope: string, scope of the credentials being requested.<br>
+ user_agent: string, HTTP User-Agent to provide for this application.<br>
+ auth_uri: string, URI for authorization endpoint. For convenience<br>
+ defaults to Google's endpoints but any OAuth 2.0 provider can be used.<br>
+ token_uri: string, URI for token endpoint. For convenience<br>
+ defaults to Google's endpoints but any OAuth 2.0 provider can be used.<br>
+ revoke_uri: string, URI for revoke endpoint. For convenience<br>
+ defaults to Google's endpoints but any OAuth 2.0 provider can be used.<br>
+ access_token: string, access token.<br>
+ refresh_token: string, refresh token.</tt></dd></dl>
+
+<dl><dt><a name="OAuth2Token-authorize"><strong>authorize</strong></a>(self, client)</dt><dd><tt>Authorize a gdata.client.GDClient instance with these credentials.<br>
+ <br>
+Args:<br>
+ client: An instance of gdata.client.GDClient<br>
+ or something that acts like it.<br>
+ <br>
+Returns:<br>
+ A modified instance of client that was passed in.<br>
+ <br>
+Example:<br>
+ >>> c = gdata.client.GDClient(source='user-agent')<br>
+ >>> c = token.<a href="#OAuth2Token-authorize">authorize</a>(c)</tt></dd></dl>
+
+<dl><dt><a name="OAuth2Token-generate_authorize_url"><strong>generate_authorize_url</strong></a>(self, redirect_uri<font color="#909090">='urn:ietf:wg:oauth:2.0:oob'</font>, response_type<font color="#909090">='code'</font>, access_type<font color="#909090">='offline'</font>, approval_prompt<font color="#909090">='auto'</font>, **kwargs)</dt><dd><tt>Returns a URI to redirect to the provider.<br>
+ <br>
+Args:<br>
+ redirect_uri: Either the string 'urn:ietf:wg:oauth:2.0:oob' for a<br>
+ non-web-based application, or a URI that handles the<br>
+ callback from the authorization server.<br>
+ response_type: Either the string 'code' for server-side or native<br>
+ application, or the string 'token' for client-side<br>
+ application.<br>
+ access_type: Either the string 'offline' to request a refresh token or<br>
+ 'online'.<br>
+ approval_prompt: Either the string 'auto' to let the OAuth mechanism<br>
+ determine if the approval page is needed or 'force'<br>
+ if the approval prompt is desired in all cases.<br>
+ <br>
+If redirect_uri is 'urn:ietf:wg:oauth:2.0:oob' then pass in the<br>
+generated verification code to get_access_token,<br>
+otherwise pass in the query parameters received<br>
+at the callback uri to get_access_token.<br>
+If the response_type is 'token', no need to call<br>
+get_access_token as the API will return it within<br>
+the query parameters received at the callback:<br>
+ oauth2_token.access_token = YOUR_ACCESS_TOKEN</tt></dd></dl>
+
+<dl><dt><a name="OAuth2Token-get_access_token"><strong>get_access_token</strong></a>(self, code)</dt><dd><tt>Exhanges a code for an access token.<br>
+ <br>
+Args:<br>
+ code: string or dict, either the code as a string, or a dictionary<br>
+ of the query parameters to the redirect_uri, which contains<br>
+ the code.</tt></dd></dl>
+
+<dl><dt><a name="OAuth2Token-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Sets the Authorization header in the HTTP request using the token.<br>
+ <br>
+Returns:<br>
+ The same HTTP request <a href="__builtin__.html#object">object</a> which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="OAuth2Token-revoke"><strong>revoke</strong></a>(self, revoke_uri<font color="#909090">=None</font>, refresh_token<font color="#909090">=None</font>)</dt><dd><tt>Revokes access via a refresh token.<br>
+ <br>
+Args:<br>
+ revoke_uri: string, URI for revoke endpoint. If not provided, or if<br>
+ None is provided, the revoke_uri attribute on the <a href="__builtin__.html#object">object</a> is used.<br>
+ refresh_token: string, refresh token. If not provided, or if None is<br>
+ provided, the refresh_token attribute on the <a href="__builtin__.html#object">object</a> is used.<br>
+ <br>
+Raises:<br>
+ <a href="#UnsupportedTokenType">UnsupportedTokenType</a> if the token is not one of the supported token<br>
+ classes listed above.<br>
+ <br>
+Example:<br>
+ >>> token.<a href="#OAuth2Token-revoke">revoke</a>()</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>invalid</strong></dt>
+<dd><tt>True if the credentials are invalid, such as being revoked.</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuth2TokenFromCredentials">class <strong>OAuth2TokenFromCredentials</strong></a>(<a href="gdata.gauth.html#OAuth2Token">OAuth2Token</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Special subclass to be used in conjunction with google-api-python-client.<br>
+ <br>
+These libraries are built for different purposes. This one is used for APIs<br>
+that use the GData Protocol:<br>
+https://developers.google.com/gdata/docs/2.0/reference<br>
+while google-api-python-client is for APIs which are discovery-based:<br>
+https://developers.google.com/discovery/v1/getting_started#background<br>
+ <br>
+Developers using Google APIs may want to use both simultaneously, and this<br>
+class provides a way for them to use OAuth 2.0 credentials obtained for use<br>
+with google-api-python-client as credentials in gdata-python-client and to<br>
+ensure all token/credential refresh impacts both this <a href="__builtin__.html#object">object</a> and the<br>
+google-api-python-client credentials <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+In addition, any manual patching of this <a href="__builtin__.html#object">object</a> or the credentials <a href="__builtin__.html#object">object</a> will<br>
+be immediately reflected since attributes such as `client_id`, `access_token`,<br>
+etc. are directly proxied between instances of this class and the credentials<br>
+objects that they own.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.gauth.html#OAuth2TokenFromCredentials">OAuth2TokenFromCredentials</a></dd>
+<dd><a href="gdata.gauth.html#OAuth2Token">OAuth2Token</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OAuth2TokenFromCredentials-__init__"><strong>__init__</strong></a>(self, credentials)</dt><dd><tt>Constructor for <a href="#OAuth2TokenFromCredentials">OAuth2TokenFromCredentials</a> <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+The constructor for the superclass is not called because the actual values<br>
+are retrieved from the credentials <a href="__builtin__.html#object">object</a> directly via `property` instances<br>
+which act as proxies.<br>
+ <br>
+Args:<br>
+ credentials: An instance of oauth2client.client.Credentials or some<br>
+ subclass.</tt></dd></dl>
+
+<dl><dt><a name="OAuth2TokenFromCredentials-generate_authorize_url"><strong>generate_authorize_url</strong></a>(self, *args, **kwargs)</dt><dd><tt># Disable methods not supported by Credentials.</tt></dd></dl>
+
+<dl><dt><a name="OAuth2TokenFromCredentials-get_access_token"><strong>get_access_token</strong></a>(self, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="OAuth2TokenFromCredentials-revoke"><strong>revoke</strong></a>(self, *args, **kwargs)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>access_token</strong></dt>
+</dl>
+<dl><dt><strong>client_id</strong></dt>
+</dl>
+<dl><dt><strong>client_secret</strong></dt>
+</dl>
+<dl><dt><strong>refresh_token</strong></dt>
+</dl>
+<dl><dt><strong>token_expiry</strong></dt>
+</dl>
+<dl><dt><strong>token_uri</strong></dt>
+</dl>
+<dl><dt><strong>user_agent</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.gauth.html#OAuth2Token">OAuth2Token</a>:<br>
+<dl><dt><a name="OAuth2TokenFromCredentials-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Sets the Authorization header in the HTTP request using the token.<br>
+ <br>
+Returns:<br>
+ The same HTTP request <a href="__builtin__.html#object">object</a> which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="OAuth2TokenFromCredentials-authorize"><strong>authorize</strong></a>(self, client)</dt><dd><tt>Authorize a gdata.client.GDClient instance with these credentials.<br>
+ <br>
+Args:<br>
+ client: An instance of gdata.client.GDClient<br>
+ or something that acts like it.<br>
+ <br>
+Returns:<br>
+ A modified instance of client that was passed in.<br>
+ <br>
+Example:<br>
+ >>> c = gdata.client.GDClient(source='user-agent')<br>
+ >>> c = token.<a href="#OAuth2TokenFromCredentials-authorize">authorize</a>(c)</tt></dd></dl>
+
+<dl><dt><a name="OAuth2TokenFromCredentials-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Sets the Authorization header in the HTTP request using the token.<br>
+ <br>
+Returns:<br>
+ The same HTTP request <a href="__builtin__.html#object">object</a> which was passed in.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.gauth.html#OAuth2Token">OAuth2Token</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>invalid</strong></dt>
+<dd><tt>True if the credentials are invalid, such as being revoked.</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthHmacToken">class <strong>OAuthHmacToken</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="OAuthHmacToken-GenerateAuthorizationUrl"><strong>GenerateAuthorizationUrl</strong></a> = <a href="#OAuthHmacToken-generate_authorization_url">generate_authorization_url</a>(self, google_apps_domain<font color="#909090">='default'</font>, language<font color="#909090">=None</font>, btmpl<font color="#909090">=None</font>, auth_server<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt></dl>
+
+<dl><dt><a name="OAuthHmacToken-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#OAuthHmacToken-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="OAuthHmacToken-__init__"><strong>__init__</strong></a>(self, consumer_key, consumer_secret, token, token_secret, auth_state, next<font color="#909090">=None</font>, verifier<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OAuthHmacToken-generate_authorization_url"><strong>generate_authorization_url</strong></a>(self, google_apps_domain<font color="#909090">='default'</font>, language<font color="#909090">=None</font>, btmpl<font color="#909090">=None</font>, auth_server<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Creates the URL at which the user can authorize this app to access.<br>
+ <br>
+Args:<br>
+ google_apps_domain: str (optional) If the user should be signing in<br>
+ using an account under a known Google Apps domain, provide the<br>
+ domain name ('example.com') here. If not provided, 'default'<br>
+ will be used, and the user will be prompted to select an account<br>
+ if they are signed in with a Google Account and Google Apps<br>
+ accounts.<br>
+ language: str (optional) An ISO 639 country code identifying what<br>
+ language the approval page should be translated in (for example,<br>
+ 'en' for English). The default is the user's selected language.<br>
+ btmpl: str (optional) Forces a mobile version of the approval page. The<br>
+ only accepted value is 'mobile'.<br>
+ auth_server: str (optional) The start of the token authorization web<br>
+ page. Defaults to<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'</tt></dd></dl>
+
+<dl><dt><a name="OAuthHmacToken-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Sets the Authorization header in the HTTP request using the token.<br>
+ <br>
+Calculates an HMAC signature using the information in the token to<br>
+indicate that the request came from this application and that this<br>
+application has permission to access a particular user's data.<br>
+ <br>
+Returns:<br>
+ The same HTTP request <a href="__builtin__.html#object">object</a> which was passed in.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>SIGNATURE_METHOD</strong> = 'HMAC-SHA1'</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthRsaToken">class <strong>OAuthRsaToken</strong></a>(<a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.gauth.html#OAuthRsaToken">OAuthRsaToken</a></dd>
+<dd><a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OAuthRsaToken-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#OAuthRsaToken-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="OAuthRsaToken-__init__"><strong>__init__</strong></a>(self, consumer_key, rsa_private_key, token, token_secret, auth_state, next<font color="#909090">=None</font>, verifier<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OAuthRsaToken-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Sets the Authorization header in the HTTP request using the token.<br>
+ <br>
+Calculates an RSA signature using the information in the token to<br>
+indicate that the request came from this application and that this<br>
+application has permission to access a particular user's data.<br>
+ <br>
+Returns:<br>
+ The same HTTP request <a href="__builtin__.html#object">object</a> which was passed in.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>SIGNATURE_METHOD</strong> = 'RSA-SHA1'</dl>
+
+<hr>
+Methods inherited from <a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a>:<br>
+<dl><dt><a name="OAuthRsaToken-GenerateAuthorizationUrl"><strong>GenerateAuthorizationUrl</strong></a> = generate_authorization_url(self, google_apps_domain<font color="#909090">='default'</font>, language<font color="#909090">=None</font>, btmpl<font color="#909090">=None</font>, auth_server<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Creates the URL at which the user can authorize this app to access.<br>
+ <br>
+Args:<br>
+ google_apps_domain: str (optional) If the user should be signing in<br>
+ using an account under a known Google Apps domain, provide the<br>
+ domain name ('example.com') here. If not provided, 'default'<br>
+ will be used, and the user will be prompted to select an account<br>
+ if they are signed in with a Google Account and Google Apps<br>
+ accounts.<br>
+ language: str (optional) An ISO 639 country code identifying what<br>
+ language the approval page should be translated in (for example,<br>
+ 'en' for English). The default is the user's selected language.<br>
+ btmpl: str (optional) Forces a mobile version of the approval page. The<br>
+ only accepted value is 'mobile'.<br>
+ auth_server: str (optional) The start of the token authorization web<br>
+ page. Defaults to<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'</tt></dd></dl>
+
+<dl><dt><a name="OAuthRsaToken-generate_authorization_url"><strong>generate_authorization_url</strong></a>(self, google_apps_domain<font color="#909090">='default'</font>, language<font color="#909090">=None</font>, btmpl<font color="#909090">=None</font>, auth_server<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Creates the URL at which the user can authorize this app to access.<br>
+ <br>
+Args:<br>
+ google_apps_domain: str (optional) If the user should be signing in<br>
+ using an account under a known Google Apps domain, provide the<br>
+ domain name ('example.com') here. If not provided, 'default'<br>
+ will be used, and the user will be prompted to select an account<br>
+ if they are signed in with a Google Account and Google Apps<br>
+ accounts.<br>
+ language: str (optional) An ISO 639 country code identifying what<br>
+ language the approval page should be translated in (for example,<br>
+ 'en' for English). The default is the user's selected language.<br>
+ btmpl: str (optional) Forces a mobile version of the approval page. The<br>
+ only accepted value is 'mobile'.<br>
+ auth_server: str (optional) The start of the token authorization web<br>
+ page. Defaults to<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SecureAuthSubToken">class <strong>SecureAuthSubToken</strong></a>(<a href="gdata.gauth.html#AuthSubToken">AuthSubToken</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.gauth.html#SecureAuthSubToken">SecureAuthSubToken</a></dd>
+<dd><a href="gdata.gauth.html#AuthSubToken">AuthSubToken</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SecureAuthSubToken-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#SecureAuthSubToken-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="SecureAuthSubToken-__init__"><strong>__init__</strong></a>(self, token_string, rsa_private_key, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="SecureAuthSubToken-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Sets the Authorization header and includes a digital signature.<br>
+ <br>
+Calculates a digital signature using the private RSA key, a timestamp<br>
+(uses now at the time this method is called) and a random nonce.<br>
+ <br>
+Args:<br>
+ http_request: The atom.http_core.HttpRequest which contains all of the<br>
+ information needed to send a request to the remote server. The<br>
+ URL and the method of the request must be already set and cannot be<br>
+ changed after this token signs the request, or the signature will<br>
+ not be valid.</tt></dd></dl>
+
+<hr>
+Static methods defined here:<br>
+<dl><dt><a name="SecureAuthSubToken-FromUrl"><strong>FromUrl</strong></a> = from_url(str_or_uri, rsa_private_key)</dt><dd><tt>Creates a new <a href="#SecureAuthSubToken">SecureAuthSubToken</a> using information in the URL.<br>
+ <br>
+Uses auth_sub_string_from_url.<br>
+ <br>
+Args:<br>
+ str_or_uri: The current page's URL (as a str or atom.http_core.Uri)<br>
+ which should contain a token query parameter since the Google auth<br>
+ server redirected the user's browser to this URL.<br>
+ rsa_private_key: str the private RSA key cert used to sign all requests<br>
+ made with this token.</tt></dd></dl>
+
+<dl><dt><a name="SecureAuthSubToken-from_url"><strong>from_url</strong></a>(str_or_uri, rsa_private_key)</dt><dd><tt>Creates a new <a href="#SecureAuthSubToken">SecureAuthSubToken</a> using information in the URL.<br>
+ <br>
+Uses auth_sub_string_from_url.<br>
+ <br>
+Args:<br>
+ str_or_uri: The current page's URL (as a str or atom.http_core.Uri)<br>
+ which should contain a token query parameter since the Google auth<br>
+ server redirected the user's browser to this URL.<br>
+ rsa_private_key: str the private RSA key cert used to sign all requests<br>
+ made with this token.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.gauth.html#AuthSubToken">AuthSubToken</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TwoLeggedOAuthHmacToken">class <strong>TwoLeggedOAuthHmacToken</strong></a>(<a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.gauth.html#TwoLeggedOAuthHmacToken">TwoLeggedOAuthHmacToken</a></dd>
+<dd><a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="TwoLeggedOAuthHmacToken-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#TwoLeggedOAuthHmacToken-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="TwoLeggedOAuthHmacToken-__init__"><strong>__init__</strong></a>(self, consumer_key, consumer_secret, requestor_id)</dt></dl>
+
+<dl><dt><a name="TwoLeggedOAuthHmacToken-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Sets the Authorization header in the HTTP request using the token.<br>
+ <br>
+Calculates an HMAC signature using the information in the token to<br>
+indicate that the request came from this application and that this<br>
+application has permission to access a particular user's data using 2LO.<br>
+ <br>
+Returns:<br>
+ The same HTTP request <a href="__builtin__.html#object">object</a> which was passed in.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a>:<br>
+<dl><dt><a name="TwoLeggedOAuthHmacToken-GenerateAuthorizationUrl"><strong>GenerateAuthorizationUrl</strong></a> = generate_authorization_url(self, google_apps_domain<font color="#909090">='default'</font>, language<font color="#909090">=None</font>, btmpl<font color="#909090">=None</font>, auth_server<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Creates the URL at which the user can authorize this app to access.<br>
+ <br>
+Args:<br>
+ google_apps_domain: str (optional) If the user should be signing in<br>
+ using an account under a known Google Apps domain, provide the<br>
+ domain name ('example.com') here. If not provided, 'default'<br>
+ will be used, and the user will be prompted to select an account<br>
+ if they are signed in with a Google Account and Google Apps<br>
+ accounts.<br>
+ language: str (optional) An ISO 639 country code identifying what<br>
+ language the approval page should be translated in (for example,<br>
+ 'en' for English). The default is the user's selected language.<br>
+ btmpl: str (optional) Forces a mobile version of the approval page. The<br>
+ only accepted value is 'mobile'.<br>
+ auth_server: str (optional) The start of the token authorization web<br>
+ page. Defaults to<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'</tt></dd></dl>
+
+<dl><dt><a name="TwoLeggedOAuthHmacToken-generate_authorization_url"><strong>generate_authorization_url</strong></a>(self, google_apps_domain<font color="#909090">='default'</font>, language<font color="#909090">=None</font>, btmpl<font color="#909090">=None</font>, auth_server<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Creates the URL at which the user can authorize this app to access.<br>
+ <br>
+Args:<br>
+ google_apps_domain: str (optional) If the user should be signing in<br>
+ using an account under a known Google Apps domain, provide the<br>
+ domain name ('example.com') here. If not provided, 'default'<br>
+ will be used, and the user will be prompted to select an account<br>
+ if they are signed in with a Google Account and Google Apps<br>
+ accounts.<br>
+ language: str (optional) An ISO 639 country code identifying what<br>
+ language the approval page should be translated in (for example,<br>
+ 'en' for English). The default is the user's selected language.<br>
+ btmpl: str (optional) Forces a mobile version of the approval page. The<br>
+ only accepted value is 'mobile'.<br>
+ auth_server: str (optional) The start of the token authorization web<br>
+ page. Defaults to<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a>:<br>
+<dl><dt><strong>SIGNATURE_METHOD</strong> = 'HMAC-SHA1'</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TwoLeggedOAuthRsaToken">class <strong>TwoLeggedOAuthRsaToken</strong></a>(<a href="gdata.gauth.html#OAuthRsaToken">OAuthRsaToken</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.gauth.html#TwoLeggedOAuthRsaToken">TwoLeggedOAuthRsaToken</a></dd>
+<dd><a href="gdata.gauth.html#OAuthRsaToken">OAuthRsaToken</a></dd>
+<dd><a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="TwoLeggedOAuthRsaToken-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#TwoLeggedOAuthRsaToken-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="TwoLeggedOAuthRsaToken-__init__"><strong>__init__</strong></a>(self, consumer_key, rsa_private_key, requestor_id)</dt></dl>
+
+<dl><dt><a name="TwoLeggedOAuthRsaToken-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Sets the Authorization header in the HTTP request using the token.<br>
+ <br>
+Calculates an RSA signature using the information in the token to<br>
+indicate that the request came from this application and that this<br>
+application has permission to access a particular user's data using 2LO.<br>
+ <br>
+Returns:<br>
+ The same HTTP request <a href="__builtin__.html#object">object</a> which was passed in.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.gauth.html#OAuthRsaToken">OAuthRsaToken</a>:<br>
+<dl><dt><strong>SIGNATURE_METHOD</strong> = 'RSA-SHA1'</dl>
+
+<hr>
+Methods inherited from <a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a>:<br>
+<dl><dt><a name="TwoLeggedOAuthRsaToken-GenerateAuthorizationUrl"><strong>GenerateAuthorizationUrl</strong></a> = generate_authorization_url(self, google_apps_domain<font color="#909090">='default'</font>, language<font color="#909090">=None</font>, btmpl<font color="#909090">=None</font>, auth_server<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Creates the URL at which the user can authorize this app to access.<br>
+ <br>
+Args:<br>
+ google_apps_domain: str (optional) If the user should be signing in<br>
+ using an account under a known Google Apps domain, provide the<br>
+ domain name ('example.com') here. If not provided, 'default'<br>
+ will be used, and the user will be prompted to select an account<br>
+ if they are signed in with a Google Account and Google Apps<br>
+ accounts.<br>
+ language: str (optional) An ISO 639 country code identifying what<br>
+ language the approval page should be translated in (for example,<br>
+ 'en' for English). The default is the user's selected language.<br>
+ btmpl: str (optional) Forces a mobile version of the approval page. The<br>
+ only accepted value is 'mobile'.<br>
+ auth_server: str (optional) The start of the token authorization web<br>
+ page. Defaults to<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'</tt></dd></dl>
+
+<dl><dt><a name="TwoLeggedOAuthRsaToken-generate_authorization_url"><strong>generate_authorization_url</strong></a>(self, google_apps_domain<font color="#909090">='default'</font>, language<font color="#909090">=None</font>, btmpl<font color="#909090">=None</font>, auth_server<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Creates the URL at which the user can authorize this app to access.<br>
+ <br>
+Args:<br>
+ google_apps_domain: str (optional) If the user should be signing in<br>
+ using an account under a known Google Apps domain, provide the<br>
+ domain name ('example.com') here. If not provided, 'default'<br>
+ will be used, and the user will be prompted to select an account<br>
+ if they are signed in with a Google Account and Google Apps<br>
+ accounts.<br>
+ language: str (optional) An ISO 639 country code identifying what<br>
+ language the approval page should be translated in (for example,<br>
+ 'en' for English). The default is the user's selected language.<br>
+ btmpl: str (optional) Forces a mobile version of the approval page. The<br>
+ only accepted value is 'mobile'.<br>
+ auth_server: str (optional) The start of the token authorization web<br>
+ page. Defaults to<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.gauth.html#OAuthHmacToken">OAuthHmacToken</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UnsupportedTokenType">class <strong>UnsupportedTokenType</strong></a>(<a href="gdata.gauth.html#Error">Error</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Raised when token to or from blob is unable to convert the token.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.gauth.html#UnsupportedTokenType">UnsupportedTokenType</a></dd>
+<dd><a href="gdata.gauth.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.gauth.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="UnsupportedTokenType-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#UnsupportedTokenType-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#UnsupportedTokenType-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="UnsupportedTokenType-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnsupportedTokenType-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="UnsupportedTokenType-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#UnsupportedTokenType-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="UnsupportedTokenType-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#UnsupportedTokenType-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="UnsupportedTokenType-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#UnsupportedTokenType-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="UnsupportedTokenType-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="UnsupportedTokenType-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnsupportedTokenType-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="UnsupportedTokenType-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnsupportedTokenType-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="UnsupportedTokenType-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="UnsupportedTokenType-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#UnsupportedTokenType-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="UnsupportedTokenType-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-AeDelete"><strong>AeDelete</strong></a> = ae_delete(token_key)</dt><dd><tt>Removes the token <a href="__builtin__.html#object">object</a> from the App Engine datastore.</tt></dd></dl>
+ <dl><dt><a name="-AeLoad"><strong>AeLoad</strong></a> = ae_load(token_key)</dt><dd><tt>Retrieves a token <a href="__builtin__.html#object">object</a> from the App Engine datastore.<br>
+ <br>
+This is a convenience method for using the library with App Engine.<br>
+See also ae_save.<br>
+ <br>
+Args:<br>
+ token_key: str The unique key associated with the desired token when it<br>
+ was saved using ae_save.<br>
+ <br>
+Returns:<br>
+ A token <a href="__builtin__.html#object">object</a> if there was a token associated with the token_key or None<br>
+ if the key could not be found.</tt></dd></dl>
+ <dl><dt><a name="-AeSave"><strong>AeSave</strong></a> = ae_save(token, token_key)</dt><dd><tt>Stores an auth token in the App Engine datastore.<br>
+ <br>
+This is a convenience method for using the library with App Engine.<br>
+Recommended usage is to associate the auth token with the current_user.<br>
+If a user is signed in to the app using the App Engine users API, you<br>
+can use<br>
+gdata.gauth.<a href="#-ae_save">ae_save</a>(some_token, users.get_current_user().user_id())<br>
+If you are not using the Users API you are free to choose whatever<br>
+string you would like for a token_string.<br>
+ <br>
+Args:<br>
+ token: an auth token <a href="__builtin__.html#object">object</a>. Must be one of <a href="#ClientLoginToken">ClientLoginToken</a>,<br>
+ <a href="#AuthSubToken">AuthSubToken</a>, <a href="#SecureAuthSubToken">SecureAuthSubToken</a>, <a href="#OAuthRsaToken">OAuthRsaToken</a>, or <a href="#OAuthHmacToken">OAuthHmacToken</a><br>
+ (see token_to_blob).<br>
+ token_key: str A unique identified to be used when you want to retrieve<br>
+ the token. If the user is signed in to App Engine using the<br>
+ users API, I recommend using the user ID for the token_key:<br>
+ users.get_current_user().user_id()</tt></dd></dl>
+ <dl><dt><a name="-AuthSubStringFromUrl"><strong>AuthSubStringFromUrl</strong></a> = auth_sub_string_from_url(url, scopes_param_prefix<font color="#909090">='auth_sub_scopes'</font>)</dt><dd><tt>Finds the token string (and scopes) after the browser is redirected.<br>
+ <br>
+After the Google Accounts AuthSub pages redirect the user's broswer back to<br>
+the web application (using the 'next' URL from the request) the web app must<br>
+extract the token from the current page's URL. The token is provided as a<br>
+URL parameter named 'token' and if generate_auth_sub_url was used to create<br>
+the request, the token's valid scopes are included in a URL parameter whose<br>
+name is specified in scopes_param_prefix.<br>
+ <br>
+Args:<br>
+ url: atom.url.Url or str representing the current URL. The token value<br>
+ and valid scopes should be included as URL parameters.<br>
+ scopes_param_prefix: str (optional) The URL parameter key which maps to<br>
+ the list of valid scopes for the token.<br>
+ <br>
+Returns:<br>
+ A tuple containing the token value as a string, and a tuple of scopes<br>
+ (as atom.http_core.Uri objects) which are URL prefixes under which this<br>
+ token grants permission to read and write user data.<br>
+ (token_string, (scope_uri, scope_uri, scope_uri, ...))<br>
+ If no scopes were included in the URL, the second value in the tuple is<br>
+ None. If there was no token param in the url, the tuple returned is<br>
+ (None, None)</tt></dd></dl>
+ <dl><dt><a name="-AuthorizeRequestToken"><strong>AuthorizeRequestToken</strong></a> = authorize_request_token(request_token, url)</dt><dd><tt>Adds information to request token to allow it to become an access token.<br>
+ <br>
+Modifies the request_token <a href="__builtin__.html#object">object</a> passed in by setting and unsetting the<br>
+necessary fields to allow this token to form a valid upgrade request.<br>
+ <br>
+Args:<br>
+ request_token: The OAuth request token which has been authorized by the<br>
+ user. In order for this token to be upgraded to an access token,<br>
+ certain fields must be extracted from the URL and added to the token<br>
+ so that they can be passed in an upgrade-token request.<br>
+ url: The URL of the current page which the user's browser was redirected<br>
+ to after they authorized access for the app. This function extracts<br>
+ information from the URL which is needed to upgraded the token from<br>
+ a request token to an access token.<br>
+ <br>
+Returns:<br>
+ The same token <a href="__builtin__.html#object">object</a> which was passed in.</tt></dd></dl>
+ <dl><dt><a name="-FindScopesForServices"><strong>FindScopesForServices</strong></a> = find_scopes_for_services(service_names<font color="#909090">=None</font>)</dt><dd><tt>Creates a combined list of scope URLs for the desired services.<br>
+ <br>
+This method searches the AUTH_SCOPES dictionary.<br>
+ <br>
+Args:<br>
+ service_names: list of strings (optional) Each name must be a key in the<br>
+ AUTH_SCOPES dictionary. If no list is provided (None) then<br>
+ the resulting list will contain all scope URLs in the<br>
+ AUTH_SCOPES dict.<br>
+ <br>
+Returns:<br>
+ A list of URL strings which are the scopes needed to access these services<br>
+ when requesting a token using AuthSub or OAuth.</tt></dd></dl>
+ <dl><dt><a name="-GenerateClientLoginRequestBody"><strong>GenerateClientLoginRequestBody</strong></a> = generate_client_login_request_body(email, password, service, source, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Creates the body of the autentication request<br>
+ <br>
+See <a href="http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request">http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request</a><br>
+for more details.<br>
+ <br>
+Args:<br>
+ email: str<br>
+ password: str<br>
+ service: str<br>
+ source: str<br>
+ account_type: str (optional) Defaul is 'HOSTED_OR_GOOGLE', other valid<br>
+ values are 'GOOGLE' and 'HOSTED'<br>
+ captcha_token: str (optional)<br>
+ captcha_response: str (optional)<br>
+ <br>
+Returns:<br>
+ The HTTP body to send in a request for a client login token.</tt></dd></dl>
+ <dl><dt><a name="-GetCaptchaChallenge"><strong>GetCaptchaChallenge</strong></a> = get_captcha_challenge(http_body, captcha_base_url<font color="#909090">='http://www.google.com/accounts/'</font>)</dt><dd><tt>Returns the URL and token for a CAPTCHA challenge issued by the server.<br>
+ <br>
+Args:<br>
+ http_body: str The body of the HTTP response from the server which<br>
+ contains the CAPTCHA challenge.<br>
+ captcha_base_url: str This function returns a full URL for viewing the<br>
+ challenge image which is built from the server's response. This<br>
+ base_url is used as the beginning of the URL because the server<br>
+ only provides the end of the URL. For example the server provides<br>
+ 'Captcha?ctoken=Hi...N' and the URL for the image is<br>
+ '<a href="http://www.google.com/accounts/Captcha?ctoken=Hi...N">http://www.google.com/accounts/Captcha?ctoken=Hi...N</a>'<br>
+ <br>
+Returns:<br>
+ A dictionary containing the information needed to repond to the CAPTCHA<br>
+ challenge, the image URL and the ID token of the challenge. The<br>
+ dictionary is in the form:<br>
+ {'token': string identifying the CAPTCHA image,<br>
+ 'url': string containing the URL of the image}<br>
+ Returns None if there was no CAPTCHA challenge in the response.</tt></dd></dl>
+ <dl><dt><a name="-GetClientLoginTokenString"><strong>GetClientLoginTokenString</strong></a> = get_client_login_token_string(http_body)</dt><dd><tt>Returns the token value for a <a href="#ClientLoginToken">ClientLoginToken</a>.<br>
+ <br>
+Reads the token from the server's response to a Client Login request and<br>
+creates the token value string to use in requests.<br>
+ <br>
+Args:<br>
+ http_body: str The body of the server's HTTP response to a Client Login<br>
+ request<br>
+ <br>
+Returns:<br>
+ The token value string for a <a href="#ClientLoginToken">ClientLoginToken</a>.</tt></dd></dl>
+ <dl><dt><a name="-TokenFromBlob"><strong>TokenFromBlob</strong></a> = token_from_blob(blob)</dt><dd><tt>Deserializes a token string from the datastore back into a token <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+Supported token classes: <a href="#ClientLoginToken">ClientLoginToken</a>, <a href="#AuthSubToken">AuthSubToken</a>, <a href="#SecureAuthSubToken">SecureAuthSubToken</a>,<br>
+<a href="#OAuthRsaToken">OAuthRsaToken</a>, and <a href="#OAuthHmacToken">OAuthHmacToken</a>, <a href="#TwoLeggedOAuthRsaToken">TwoLeggedOAuthRsaToken</a>,<br>
+<a href="#TwoLeggedOAuthHmacToken">TwoLeggedOAuthHmacToken</a> and <a href="#OAuth2Token">OAuth2Token</a>.<br>
+ <br>
+Args:<br>
+ blob: string created by token_to_blob.<br>
+ <br>
+Raises:<br>
+ <a href="#UnsupportedTokenType">UnsupportedTokenType</a> if the token is not one of the supported token<br>
+ classes listed above.<br>
+ <br>
+Returns:<br>
+ A new token <a href="__builtin__.html#object">object</a> with members set to the values serialized in the<br>
+ blob string. Note that any members which were set to '' in the original<br>
+ token will now be None.</tt></dd></dl>
+ <dl><dt><a name="-TokenToBlob"><strong>TokenToBlob</strong></a> = token_to_blob(token)</dt><dd><tt>Serializes the token data as a string for storage in a datastore.<br>
+ <br>
+Supported token classes: <a href="#ClientLoginToken">ClientLoginToken</a>, <a href="#AuthSubToken">AuthSubToken</a>, <a href="#SecureAuthSubToken">SecureAuthSubToken</a>,<br>
+<a href="#OAuthRsaToken">OAuthRsaToken</a>, and <a href="#OAuthHmacToken">OAuthHmacToken</a>, <a href="#TwoLeggedOAuthRsaToken">TwoLeggedOAuthRsaToken</a>,<br>
+<a href="#TwoLeggedOAuthHmacToken">TwoLeggedOAuthHmacToken</a> and <a href="#OAuth2Token">OAuth2Token</a>.<br>
+ <br>
+Args:<br>
+ token: A token <a href="__builtin__.html#object">object</a> which must be of one of the supported token classes.<br>
+ <br>
+Raises:<br>
+ <a href="#UnsupportedTokenType">UnsupportedTokenType</a> if the token is not one of the supported token<br>
+ classes listed above.<br>
+ <br>
+Returns:<br>
+ A string represenging this token. The string can be converted back into<br>
+ an equivalent token <a href="__builtin__.html#object">object</a> using token_from_blob. Note that any members<br>
+ which are set to '' will be set to None when the token is deserialized<br>
+ by token_from_blob.</tt></dd></dl>
+ <dl><dt><a name="-UpgradeToAccessToken"><strong>UpgradeToAccessToken</strong></a> = upgrade_to_access_token(request_token, server_response_body)</dt><dd><tt>Extracts access token information from response to an upgrade request.<br>
+ <br>
+Once the server has responded with the new token info for the OAuth<br>
+access token, this method modifies the request_token to set and unset<br>
+necessary fields to create valid OAuth authorization headers for requests.<br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which this function modifies to allow it<br>
+ to be used as an access token.<br>
+ server_response_body: str The server's response to an OAuthAuthorizeToken<br>
+ request. This should contain the new token and token_secret which<br>
+ are used to generate the signature and parameters of the Authorization<br>
+ header in subsequent requests to Google Data APIs.<br>
+ <br>
+Returns:<br>
+ The same token <a href="__builtin__.html#object">object</a> which was passed in.</tt></dd></dl>
+ <dl><dt><a name="-ae_delete"><strong>ae_delete</strong></a>(token_key)</dt><dd><tt>Removes the token <a href="__builtin__.html#object">object</a> from the App Engine datastore.</tt></dd></dl>
+ <dl><dt><a name="-ae_load"><strong>ae_load</strong></a>(token_key)</dt><dd><tt>Retrieves a token <a href="__builtin__.html#object">object</a> from the App Engine datastore.<br>
+ <br>
+This is a convenience method for using the library with App Engine.<br>
+See also ae_save.<br>
+ <br>
+Args:<br>
+ token_key: str The unique key associated with the desired token when it<br>
+ was saved using ae_save.<br>
+ <br>
+Returns:<br>
+ A token <a href="__builtin__.html#object">object</a> if there was a token associated with the token_key or None<br>
+ if the key could not be found.</tt></dd></dl>
+ <dl><dt><a name="-ae_save"><strong>ae_save</strong></a>(token, token_key)</dt><dd><tt>Stores an auth token in the App Engine datastore.<br>
+ <br>
+This is a convenience method for using the library with App Engine.<br>
+Recommended usage is to associate the auth token with the current_user.<br>
+If a user is signed in to the app using the App Engine users API, you<br>
+can use<br>
+gdata.gauth.<a href="#-ae_save">ae_save</a>(some_token, users.get_current_user().user_id())<br>
+If you are not using the Users API you are free to choose whatever<br>
+string you would like for a token_string.<br>
+ <br>
+Args:<br>
+ token: an auth token <a href="__builtin__.html#object">object</a>. Must be one of <a href="#ClientLoginToken">ClientLoginToken</a>,<br>
+ <a href="#AuthSubToken">AuthSubToken</a>, <a href="#SecureAuthSubToken">SecureAuthSubToken</a>, <a href="#OAuthRsaToken">OAuthRsaToken</a>, or <a href="#OAuthHmacToken">OAuthHmacToken</a><br>
+ (see token_to_blob).<br>
+ token_key: str A unique identified to be used when you want to retrieve<br>
+ the token. If the user is signed in to App Engine using the<br>
+ users API, I recommend using the user ID for the token_key:<br>
+ users.get_current_user().user_id()</tt></dd></dl>
+ <dl><dt><a name="-auth_sub_string_from_body"><strong>auth_sub_string_from_body</strong></a>(http_body)</dt><dd><tt>Extracts the AuthSub token from an HTTP body string.<br>
+ <br>
+Used to find the new session token after making a request to upgrade a<br>
+single use AuthSub token.<br>
+ <br>
+Args:<br>
+ http_body: str The repsonse from the server which contains the AuthSub<br>
+ key. For example, this function would find the new session token<br>
+ from the server's response to an upgrade token request.<br>
+ <br>
+Returns:<br>
+ The raw token value string to use in an <a href="#AuthSubToken">AuthSubToken</a> <a href="__builtin__.html#object">object</a>.</tt></dd></dl>
+ <dl><dt><a name="-auth_sub_string_from_url"><strong>auth_sub_string_from_url</strong></a>(url, scopes_param_prefix<font color="#909090">='auth_sub_scopes'</font>)</dt><dd><tt>Finds the token string (and scopes) after the browser is redirected.<br>
+ <br>
+After the Google Accounts AuthSub pages redirect the user's broswer back to<br>
+the web application (using the 'next' URL from the request) the web app must<br>
+extract the token from the current page's URL. The token is provided as a<br>
+URL parameter named 'token' and if generate_auth_sub_url was used to create<br>
+the request, the token's valid scopes are included in a URL parameter whose<br>
+name is specified in scopes_param_prefix.<br>
+ <br>
+Args:<br>
+ url: atom.url.Url or str representing the current URL. The token value<br>
+ and valid scopes should be included as URL parameters.<br>
+ scopes_param_prefix: str (optional) The URL parameter key which maps to<br>
+ the list of valid scopes for the token.<br>
+ <br>
+Returns:<br>
+ A tuple containing the token value as a string, and a tuple of scopes<br>
+ (as atom.http_core.Uri objects) which are URL prefixes under which this<br>
+ token grants permission to read and write user data.<br>
+ (token_string, (scope_uri, scope_uri, scope_uri, ...))<br>
+ If no scopes were included in the URL, the second value in the tuple is<br>
+ None. If there was no token param in the url, the tuple returned is<br>
+ (None, None)</tt></dd></dl>
+ <dl><dt><a name="-authorize_request_token"><strong>authorize_request_token</strong></a>(request_token, url)</dt><dd><tt>Adds information to request token to allow it to become an access token.<br>
+ <br>
+Modifies the request_token <a href="__builtin__.html#object">object</a> passed in by setting and unsetting the<br>
+necessary fields to allow this token to form a valid upgrade request.<br>
+ <br>
+Args:<br>
+ request_token: The OAuth request token which has been authorized by the<br>
+ user. In order for this token to be upgraded to an access token,<br>
+ certain fields must be extracted from the URL and added to the token<br>
+ so that they can be passed in an upgrade-token request.<br>
+ url: The URL of the current page which the user's browser was redirected<br>
+ to after they authorized access for the app. This function extracts<br>
+ information from the URL which is needed to upgraded the token from<br>
+ a request token to an access token.<br>
+ <br>
+Returns:<br>
+ The same token <a href="__builtin__.html#object">object</a> which was passed in.</tt></dd></dl>
+ <dl><dt><a name="-build_auth_sub_data"><strong>build_auth_sub_data</strong></a>(http_request, timestamp, nonce)</dt><dd><tt>Creates the data string which must be RSA-signed in secure requests.<br>
+ <br>
+For more details see the documenation on secure AuthSub requests:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html#signingrequests">http://code.google.com/apis/accounts/docs/AuthSub.html#signingrequests</a><br>
+ <br>
+Args:<br>
+ http_request: The request being made to the server. The Request's URL<br>
+ must be complete before this signature is calculated as any changes<br>
+ to the URL will invalidate the signature.<br>
+ nonce: str Random 64-bit, unsigned number encoded as an ASCII string in<br>
+ decimal format. The nonce/timestamp pair should always be unique to<br>
+ prevent replay attacks.<br>
+ timestamp: Integer representing the time the request is sent. The<br>
+ timestamp should be expressed in number of seconds after January 1,<br>
+ 1970 00:00:00 GMT.</tt></dd></dl>
+ <dl><dt><a name="-build_oauth_base_string"><strong>build_oauth_base_string</strong></a>(http_request, consumer_key, nonce, signaure_type, timestamp, version, next<font color="#909090">='oob'</font>, token<font color="#909090">=None</font>, verifier<font color="#909090">=None</font>)</dt><dd><tt>Generates the base string to be signed in the OAuth request.<br>
+ <br>
+Args:<br>
+ http_request: The request being made to the server. The Request's URL<br>
+ must be complete before this signature is calculated as any changes<br>
+ to the URL will invalidate the signature.<br>
+ consumer_key: Domain identifying the third-party web application. This is<br>
+ the domain used when registering the application with Google. It<br>
+ identifies who is making the request on behalf of the user.<br>
+ nonce: Random 64-bit, unsigned number encoded as an ASCII string in decimal<br>
+ format. The nonce/timestamp pair should always be unique to prevent<br>
+ replay attacks.<br>
+ signaure_type: either RSA_SHA1 or HMAC_SHA1<br>
+ timestamp: Integer representing the time the request is sent. The<br>
+ timestamp should be expressed in number of seconds after January 1,<br>
+ 1970 00:00:00 GMT.<br>
+ version: The OAuth version used by the requesting web application. This<br>
+ value must be '1.0' or '1.0a'. If not provided, Google assumes version<br>
+ 1.0 is in use.<br>
+ next: The URL the user should be redirected to after granting access<br>
+ to a Google service(s). It can include url-encoded query parameters.<br>
+ The default value is 'oob'. (This is the oauth_callback.)<br>
+ token: The string for the OAuth request token or OAuth access token.<br>
+ verifier: str Sent as the oauth_verifier and required when upgrading a<br>
+ request token to an access token.</tt></dd></dl>
+ <dl><dt><a name="-dump_tokens"><strong>dump_tokens</strong></a>(tokens)</dt></dl>
+ <dl><dt><a name="-find_scopes_for_services"><strong>find_scopes_for_services</strong></a>(service_names<font color="#909090">=None</font>)</dt><dd><tt>Creates a combined list of scope URLs for the desired services.<br>
+ <br>
+This method searches the AUTH_SCOPES dictionary.<br>
+ <br>
+Args:<br>
+ service_names: list of strings (optional) Each name must be a key in the<br>
+ AUTH_SCOPES dictionary. If no list is provided (None) then<br>
+ the resulting list will contain all scope URLs in the<br>
+ AUTH_SCOPES dict.<br>
+ <br>
+Returns:<br>
+ A list of URL strings which are the scopes needed to access these services<br>
+ when requesting a token using AuthSub or OAuth.</tt></dd></dl>
+ <dl><dt><a name="-generate_auth_header"><strong>generate_auth_header</strong></a>(consumer_key, timestamp, nonce, signature_type, signature, version<font color="#909090">='1.0'</font>, next<font color="#909090">=None</font>, token<font color="#909090">=None</font>, verifier<font color="#909090">=None</font>)</dt><dd><tt>Builds the Authorization header to be sent in the request.<br>
+ <br>
+Args:<br>
+ consumer_key: Identifies the application making the request (str).<br>
+ timestamp:<br>
+ nonce:<br>
+ signature_type: One of either HMAC_SHA1 or RSA_SHA1<br>
+ signature: The HMAC or RSA signature for the request as a base64<br>
+ encoded string.<br>
+ version: The version of the OAuth protocol that this request is using.<br>
+ Default is '1.0'<br>
+ next: The URL of the page that the user's browser should be sent to<br>
+ after they authorize the token. (Optional)<br>
+ token: str The OAuth token value to be used in the oauth_token parameter<br>
+ of the header.<br>
+ verifier: str The OAuth verifier which must be included when you are<br>
+ upgrading a request token to an access token.</tt></dd></dl>
+ <dl><dt><a name="-generate_auth_sub_url"><strong>generate_auth_sub_url</strong></a>(next, scopes, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, request_url<font color="#909090">=<atom.http_core.Uri object></font>, domain<font color="#909090">='default'</font>, scopes_param_prefix<font color="#909090">='auth_sub_scopes'</font>)</dt><dd><tt>Constructs a URI for requesting a multiscope AuthSub token.<br>
+ <br>
+The generated token will contain a URL parameter to pass along the<br>
+requested scopes to the next URL. When the Google Accounts page<br>
+redirects the broswser to the 'next' URL, it appends the single use<br>
+AuthSub token value to the URL as a URL parameter with the key 'token'.<br>
+However, the information about which scopes were requested is not<br>
+included by Google Accounts. This method adds the scopes to the next<br>
+URL before making the request so that the redirect will be sent to<br>
+a page, and both the token value and the list of scopes for which the token<br>
+was requested.<br>
+ <br>
+Args:<br>
+ next: atom.http_core.Uri or string The URL user will be sent to after<br>
+ authorizing this web application to access their data.<br>
+ scopes: list containint strings or atom.http_core.Uri objects. The URLs<br>
+ of the services to be accessed. Could also be a single string<br>
+ or single atom.http_core.Uri for requesting just one scope.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.<br>
+ request_url: atom.http_core.Uri or str The beginning of the request URL.<br>
+ This is normally<br>
+ '<a href="http://www.google.com/accounts/AuthSubRequest">http://www.google.com/accounts/AuthSubRequest</a>' or<br>
+ '/accounts/AuthSubRequest'<br>
+ domain: The domain which the account is part of. This is used for Google<br>
+ Apps accounts, the default value is 'default' which means that<br>
+ the requested account is a Google Account (@gmail.com for<br>
+ example)<br>
+ scopes_param_prefix: str (optional) The requested scopes are added as a<br>
+ URL parameter to the next URL so that the page at<br>
+ the 'next' URL can extract the token value and the<br>
+ valid scopes from the URL. The key for the URL<br>
+ parameter defaults to 'auth_sub_scopes'<br>
+ <br>
+Returns:<br>
+ An atom.http_core.Uri which the user's browser should be directed to in<br>
+ order to authorize this application to access their information.</tt></dd></dl>
+ <dl><dt><a name="-generate_client_login_request_body"><strong>generate_client_login_request_body</strong></a>(email, password, service, source, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Creates the body of the autentication request<br>
+ <br>
+See <a href="http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request">http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request</a><br>
+for more details.<br>
+ <br>
+Args:<br>
+ email: str<br>
+ password: str<br>
+ service: str<br>
+ source: str<br>
+ account_type: str (optional) Defaul is 'HOSTED_OR_GOOGLE', other valid<br>
+ values are 'GOOGLE' and 'HOSTED'<br>
+ captcha_token: str (optional)<br>
+ captcha_response: str (optional)<br>
+ <br>
+Returns:<br>
+ The HTTP body to send in a request for a client login token.</tt></dd></dl>
+ <dl><dt><a name="-generate_hmac_signature"><strong>generate_hmac_signature</strong></a>(http_request, consumer_key, consumer_secret, timestamp, nonce, version, next<font color="#909090">='oob'</font>, token<font color="#909090">=None</font>, token_secret<font color="#909090">=None</font>, verifier<font color="#909090">=None</font>)</dt></dl>
+ <dl><dt><a name="-generate_oauth_authorization_url"><strong>generate_oauth_authorization_url</strong></a>(token, next<font color="#909090">=None</font>, hd<font color="#909090">='default'</font>, hl<font color="#909090">=None</font>, btmpl<font color="#909090">=None</font>, auth_server<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Creates a URL for the page where the request token can be authorized.<br>
+ <br>
+Args:<br>
+ token: str The request token from the OAuth server.<br>
+ next: str (optional) URL the user should be redirected to after granting<br>
+ access to a Google service(s). It can include url-encoded query<br>
+ parameters.<br>
+ hd: str (optional) Identifies a particular hosted domain account to be<br>
+ accessed (for example, 'mycollege.edu'). Uses 'default' to specify a<br>
+ regular Google account ('username@gmail.com').<br>
+ hl: str (optional) An ISO 639 country code identifying what language the<br>
+ approval page should be translated in (for example, 'hl=en' for<br>
+ English). The default is the user's selected language.<br>
+ btmpl: str (optional) Forces a mobile version of the approval page. The<br>
+ only accepted value is 'mobile'.<br>
+ auth_server: str (optional) The start of the token authorization web<br>
+ page. Defaults to<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'<br>
+ <br>
+Returns:<br>
+ An atom.http_core.Uri pointing to the token authorization page where the<br>
+ user may allow or deny this app to access their Google data.</tt></dd></dl>
+ <dl><dt><a name="-generate_request_for_access_token"><strong>generate_request_for_access_token</strong></a>(request_token, auth_server_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Creates a request to ask the OAuth server for an access token.<br>
+ <br>
+Requires a request token which the user has authorized. See the<br>
+documentation on OAuth with Google Data for more details:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An <a href="#OAuthHmacToken">OAuthHmacToken</a> or <a href="#OAuthRsaToken">OAuthRsaToken</a> which the user has<br>
+ approved using their browser.<br>
+ auth_server_url: (optional) The URL at which the OAuth access token is<br>
+ requested. Defaults to<br>
+ https://www.google.com/accounts/OAuthGetAccessToken<br>
+ <br>
+Returns:<br>
+ A new HttpRequest <a href="__builtin__.html#object">object</a> which can be sent to the OAuth server to<br>
+ request an OAuth Access Token.</tt></dd></dl>
+ <dl><dt><a name="-generate_request_for_request_token"><strong>generate_request_for_request_token</strong></a>(consumer_key, signature_type, scopes, rsa_key<font color="#909090">=None</font>, consumer_secret<font color="#909090">=None</font>, auth_server_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, next<font color="#909090">='oob'</font>, version<font color="#909090">='1.0'</font>)</dt><dd><tt>Creates request to be sent to auth server to get an OAuth request token.<br>
+ <br>
+Args:<br>
+ consumer_key:<br>
+ signature_type: either RSA_SHA1 or HMAC_SHA1. The rsa_key must be<br>
+ provided if the signature type is RSA but if the signature method<br>
+ is HMAC, the consumer_secret must be used.<br>
+ scopes: List of URL prefixes for the data which we want to access. For<br>
+ example, to request access to the user's Blogger and Google Calendar<br>
+ data, we would request<br>
+ ['<a href="http://www.blogger.com/feeds/">http://www.blogger.com/feeds/</a>',<br>
+ 'https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ rsa_key: Only used if the signature method is RSA_SHA1.<br>
+ consumer_secret: Only used if the signature method is HMAC_SHA1.<br>
+ auth_server_url: The URL to which the token request should be directed.<br>
+ Defaults to 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ next: The URL of the page that the user's browser should be sent to<br>
+ after they authorize the token. (Optional)<br>
+ version: The OAuth version used by the requesting web application.<br>
+ Defaults to '1.0a'<br>
+ <br>
+Returns:<br>
+ An atom.http_core.HttpRequest <a href="__builtin__.html#object">object</a> with the URL, Authorization header<br>
+ and body filled in.</tt></dd></dl>
+ <dl><dt><a name="-generate_rsa_signature"><strong>generate_rsa_signature</strong></a>(http_request, consumer_key, rsa_key, timestamp, nonce, version, next<font color="#909090">='oob'</font>, token<font color="#909090">=None</font>, token_secret<font color="#909090">=None</font>, verifier<font color="#909090">=None</font>)</dt></dl>
+ <dl><dt><a name="-generate_signature"><strong>generate_signature</strong></a>(data, rsa_key)</dt><dd><tt>Signs the data string for a secure AuthSub request.</tt></dd></dl>
+ <dl><dt><a name="-get_captcha_challenge"><strong>get_captcha_challenge</strong></a>(http_body, captcha_base_url<font color="#909090">='http://www.google.com/accounts/'</font>)</dt><dd><tt>Returns the URL and token for a CAPTCHA challenge issued by the server.<br>
+ <br>
+Args:<br>
+ http_body: str The body of the HTTP response from the server which<br>
+ contains the CAPTCHA challenge.<br>
+ captcha_base_url: str This function returns a full URL for viewing the<br>
+ challenge image which is built from the server's response. This<br>
+ base_url is used as the beginning of the URL because the server<br>
+ only provides the end of the URL. For example the server provides<br>
+ 'Captcha?ctoken=Hi...N' and the URL for the image is<br>
+ '<a href="http://www.google.com/accounts/Captcha?ctoken=Hi...N">http://www.google.com/accounts/Captcha?ctoken=Hi...N</a>'<br>
+ <br>
+Returns:<br>
+ A dictionary containing the information needed to repond to the CAPTCHA<br>
+ challenge, the image URL and the ID token of the challenge. The<br>
+ dictionary is in the form:<br>
+ {'token': string identifying the CAPTCHA image,<br>
+ 'url': string containing the URL of the image}<br>
+ Returns None if there was no CAPTCHA challenge in the response.</tt></dd></dl>
+ <dl><dt><a name="-get_client_login_token_string"><strong>get_client_login_token_string</strong></a>(http_body)</dt><dd><tt>Returns the token value for a <a href="#ClientLoginToken">ClientLoginToken</a>.<br>
+ <br>
+Reads the token from the server's response to a Client Login request and<br>
+creates the token value string to use in requests.<br>
+ <br>
+Args:<br>
+ http_body: str The body of the server's HTTP response to a Client Login<br>
+ request<br>
+ <br>
+Returns:<br>
+ The token value string for a <a href="#ClientLoginToken">ClientLoginToken</a>.</tt></dd></dl>
+ <dl><dt><a name="-hmac_token_from_body"><strong>hmac_token_from_body</strong></a>(http_body, consumer_key, consumer_secret, auth_state)</dt></dl>
+ <dl><dt><a name="-load_tokens"><strong>load_tokens</strong></a>(blob)</dt></dl>
+ <dl><dt><a name="-oauth_token_info_from_body"><strong>oauth_token_info_from_body</strong></a>(http_body)</dt><dd><tt>Exracts an OAuth request token from the server's response.<br>
+ <br>
+Returns:<br>
+ A tuple of strings containing the OAuth token and token secret. If<br>
+ neither of these are present in the body, returns (None, None)</tt></dd></dl>
+ <dl><dt><a name="-oauth_token_info_from_url"><strong>oauth_token_info_from_url</strong></a>(url)</dt><dd><tt>Exracts an OAuth access token from the redirected page's URL.<br>
+ <br>
+Returns:<br>
+ A tuple of strings containing the OAuth token and the OAuth verifier which<br>
+ need to sent when upgrading a request token to an access token.</tt></dd></dl>
+ <dl><dt><a name="-rsa_token_from_body"><strong>rsa_token_from_body</strong></a>(http_body, consumer_key, rsa_private_key, auth_state)</dt></dl>
+ <dl><dt><a name="-token_from_blob"><strong>token_from_blob</strong></a>(blob)</dt><dd><tt>Deserializes a token string from the datastore back into a token <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+Supported token classes: <a href="#ClientLoginToken">ClientLoginToken</a>, <a href="#AuthSubToken">AuthSubToken</a>, <a href="#SecureAuthSubToken">SecureAuthSubToken</a>,<br>
+<a href="#OAuthRsaToken">OAuthRsaToken</a>, and <a href="#OAuthHmacToken">OAuthHmacToken</a>, <a href="#TwoLeggedOAuthRsaToken">TwoLeggedOAuthRsaToken</a>,<br>
+<a href="#TwoLeggedOAuthHmacToken">TwoLeggedOAuthHmacToken</a> and <a href="#OAuth2Token">OAuth2Token</a>.<br>
+ <br>
+Args:<br>
+ blob: string created by token_to_blob.<br>
+ <br>
+Raises:<br>
+ <a href="#UnsupportedTokenType">UnsupportedTokenType</a> if the token is not one of the supported token<br>
+ classes listed above.<br>
+ <br>
+Returns:<br>
+ A new token <a href="__builtin__.html#object">object</a> with members set to the values serialized in the<br>
+ blob string. Note that any members which were set to '' in the original<br>
+ token will now be None.</tt></dd></dl>
+ <dl><dt><a name="-token_to_blob"><strong>token_to_blob</strong></a>(token)</dt><dd><tt>Serializes the token data as a string for storage in a datastore.<br>
+ <br>
+Supported token classes: <a href="#ClientLoginToken">ClientLoginToken</a>, <a href="#AuthSubToken">AuthSubToken</a>, <a href="#SecureAuthSubToken">SecureAuthSubToken</a>,<br>
+<a href="#OAuthRsaToken">OAuthRsaToken</a>, and <a href="#OAuthHmacToken">OAuthHmacToken</a>, <a href="#TwoLeggedOAuthRsaToken">TwoLeggedOAuthRsaToken</a>,<br>
+<a href="#TwoLeggedOAuthHmacToken">TwoLeggedOAuthHmacToken</a> and <a href="#OAuth2Token">OAuth2Token</a>.<br>
+ <br>
+Args:<br>
+ token: A token <a href="__builtin__.html#object">object</a> which must be of one of the supported token classes.<br>
+ <br>
+Raises:<br>
+ <a href="#UnsupportedTokenType">UnsupportedTokenType</a> if the token is not one of the supported token<br>
+ classes listed above.<br>
+ <br>
+Returns:<br>
+ A string represenging this token. The string can be converted back into<br>
+ an equivalent token <a href="__builtin__.html#object">object</a> using token_from_blob. Note that any members<br>
+ which are set to '' will be set to None when the token is deserialized<br>
+ by token_from_blob.</tt></dd></dl>
+ <dl><dt><a name="-upgrade_to_access_token"><strong>upgrade_to_access_token</strong></a>(request_token, server_response_body)</dt><dd><tt>Extracts access token information from response to an upgrade request.<br>
+ <br>
+Once the server has responded with the new token info for the OAuth<br>
+access token, this method modifies the request_token to set and unset<br>
+necessary fields to create valid OAuth authorization headers for requests.<br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which this function modifies to allow it<br>
+ to be used as an access token.<br>
+ server_response_body: str The server's response to an OAuthAuthorizeToken<br>
+ request. This should contain the new token and token_secret which<br>
+ are used to generate the signature and parameters of the Authorization<br>
+ header in subsequent requests to Google Data APIs.<br>
+ <br>
+Returns:<br>
+ The same token <a href="__builtin__.html#object">object</a> which was passed in.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ACCESS_TOKEN</strong> = 3<br>
+<strong>ACCESS_TOKEN_URL</strong> = 'https://www.google.com/accounts/OAuthGetAccessToken'<br>
+<strong>AUTHORIZED_REQUEST_TOKEN</strong> = 2<br>
+<strong>AUTHSUB_AUTH_LABEL</strong> = 'AuthSub token='<br>
+<strong>AUTH_SCOPES</strong> = {'analytics': ('https://www.google.com/analytics/feeds/',), 'apps': ('https://apps-apis.google.com/a/feeds/user/', 'https://apps-apis.google.com/a/feeds/policies/', 'https://apps-apis.google.com/a/feeds/alias/', 'https://apps-apis.google.com/a/feeds/groups/', 'https://apps-apis.google.com/a/feeds/compliance/audit/', 'https://apps-apis.google.com/a/feeds/migration/', 'https://apps-apis.google.com/a/feeds/emailsettings/2.0/'), 'blogger': ('http://www.blogger.com/feeds/',), 'books': ('http://www.google.com/books/feeds/',), 'cl': ('https://www.google.com/calendar/feeds/', 'http://www.google.com/calendar/feeds/'), 'code': ('http://code.google.com/feeds/issues',), 'codesearch': ('http://www.google.com/codesearch/feeds/',), 'cp': ('https://www.google.com/m8/feeds/', 'http://www.google.com/m8/feeds/'), 'finance': ('http://finance.google.com/finance/feeds/',), 'gbase': ('http://base.google.com/base/feeds/', 'http://www.google.com/base/feeds/'), ...}<br>
+<strong>DEFAULT_DOMAIN</strong> = 'default'<br>
+<strong>HMAC_SHA1</strong> = 'HMAC-SHA1'<br>
+<strong>OAUTH2_AUTH_LABEL</strong> = 'Bearer '<br>
+<strong>OAUTH_AUTHORIZE_URL</strong> = 'https://www.google.com/accounts/OAuthAuthorizeToken'<br>
+<strong>PROGRAMMATIC_AUTH_LABEL</strong> = 'GoogleLogin auth='<br>
+<strong>REQUEST_TOKEN</strong> = 1<br>
+<strong>REQUEST_TOKEN_URL</strong> = 'https://www.google.com/accounts/OAuthGetRequestToken'<br>
+<strong>RSA_SHA1</strong> = 'RSA-SHA1'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.geo.data.html b/pydocs/gdata.geo.data.html
new file mode 100644
index 0000000..c9db753
--- /dev/null
+++ b/pydocs/gdata.geo.data.html
@@ -0,0 +1,1692 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.geo.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.geo.html"><font color="#ffffff">geo</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/geo/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/geo/data.py</a></font></td></tr></table>
+ <p><tt>Contains the data classes of the Geography Extension</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.geo.data.html#GeoLat">GeoLat</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.data.html#GeoLong">GeoLong</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.data.html#GeoRssBox">GeoRssBox</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.data.html#GeoRssPoint">GeoRssPoint</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.data.html#GeoRssWhere">GeoRssWhere</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.data.html#GmlEnvelope">GmlEnvelope</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.data.html#GmlLowerCorner">GmlLowerCorner</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.data.html#GmlPoint">GmlPoint</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.data.html#GmlPos">GmlPos</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.data.html#GmlUpperCorner">GmlUpperCorner</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.data.html#W3CPoint">W3CPoint</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GeoLat">class <strong>GeoLat</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a W3C latitude.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.data.html#GeoLat">GeoLat</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GeoLat-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoLat-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoLat-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GeoLat-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoLat-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GeoLat-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GeoLat-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GeoLat-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GeoLat-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoLat-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GeoLong">class <strong>GeoLong</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a W3C longitude.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.data.html#GeoLong">GeoLong</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GeoLong-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoLong-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoLong-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GeoLong-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoLong-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GeoLong-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GeoLong-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GeoLong-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GeoLong-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoLong-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GeoRssBox">class <strong>GeoRssBox</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a geographical region.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.data.html#GeoRssBox">GeoRssBox</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GeoRssBox-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssBox-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssBox-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssBox-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssBox-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssBox-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GeoRssBox-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GeoRssBox-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssBox-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssBox-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GeoRssPoint">class <strong>GeoRssPoint</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a geographical location.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.data.html#GeoRssPoint">GeoRssPoint</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GeoRssPoint-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssPoint-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssPoint-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssPoint-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssPoint-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssPoint-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GeoRssPoint-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GeoRssPoint-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssPoint-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssPoint-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GeoRssWhere">class <strong>GeoRssWhere</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a geographical location or region.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.data.html#GeoRssWhere">GeoRssWhere</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>Envelope</strong> = <class 'gdata.geo.data.GmlEnvelope'><dd><tt>Describes a Gml geographical region.</tt></dl>
+
+<dl><dt><strong>Point</strong> = <class 'gdata.geo.data.GmlPoint'><dd><tt>Describes a particular geographical point.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GeoRssWhere-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssWhere-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssWhere-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssWhere-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssWhere-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssWhere-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GeoRssWhere-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GeoRssWhere-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssWhere-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GeoRssWhere-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GmlEnvelope">class <strong>GmlEnvelope</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a Gml geographical region.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.data.html#GmlEnvelope">GmlEnvelope</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>lower_corner</strong> = <class 'gdata.geo.data.GmlLowerCorner'><dd><tt>Describes a lower corner of a region.</tt></dl>
+
+<dl><dt><strong>upper_corner</strong> = <class 'gdata.geo.data.GmlUpperCorner'><dd><tt>Describes an upper corner of a region.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GmlEnvelope-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlEnvelope-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlEnvelope-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GmlEnvelope-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlEnvelope-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GmlEnvelope-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GmlEnvelope-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GmlEnvelope-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GmlEnvelope-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlEnvelope-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GmlLowerCorner">class <strong>GmlLowerCorner</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a lower corner of a region.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.data.html#GmlLowerCorner">GmlLowerCorner</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GmlLowerCorner-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlLowerCorner-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlLowerCorner-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GmlLowerCorner-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlLowerCorner-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GmlLowerCorner-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GmlLowerCorner-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GmlLowerCorner-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GmlLowerCorner-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlLowerCorner-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GmlPoint">class <strong>GmlPoint</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a particular geographical point.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.data.html#GmlPoint">GmlPoint</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>pos</strong> = <class 'gdata.geo.data.GmlPos'><dd><tt>Describes a latitude and longitude.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GmlPoint-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlPoint-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlPoint-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GmlPoint-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlPoint-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GmlPoint-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GmlPoint-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GmlPoint-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GmlPoint-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlPoint-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GmlPos">class <strong>GmlPos</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a latitude and longitude.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.data.html#GmlPos">GmlPos</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GmlPos-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlPos-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlPos-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GmlPos-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlPos-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GmlPos-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GmlPos-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GmlPos-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GmlPos-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlPos-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GmlUpperCorner">class <strong>GmlUpperCorner</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an upper corner of a region.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.data.html#GmlUpperCorner">GmlUpperCorner</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="GmlUpperCorner-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlUpperCorner-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlUpperCorner-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GmlUpperCorner-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlUpperCorner-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="GmlUpperCorner-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="GmlUpperCorner-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GmlUpperCorner-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="GmlUpperCorner-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="GmlUpperCorner-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="W3CPoint">class <strong>W3CPoint</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a W3C geographical location.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.data.html#W3CPoint">W3CPoint</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>lat</strong> = <class 'gdata.geo.data.GeoLat'><dd><tt>Describes a W3C latitude.</tt></dl>
+
+<dl><dt><strong>long</strong> = <class 'gdata.geo.data.GeoLong'><dd><tt>Describes a W3C longitude.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="W3CPoint-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="W3CPoint-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="W3CPoint-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="W3CPoint-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="W3CPoint-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="W3CPoint-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="W3CPoint-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="W3CPoint-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="W3CPoint-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="W3CPoint-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GEORSS_TEMPLATE</strong> = '{http://www.georss.org/georss/}%s'<br>
+<strong>GEO_TEMPLATE</strong> = '{http://www.w3.org/2003/01/geo/wgs84_pos#/}%s'<br>
+<strong>GML_TEMPLATE</strong> = '{http://www.opengis.net/gml/}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.geo.html b/pydocs/gdata.geo.html
new file mode 100644
index 0000000..cd893a2
--- /dev/null
+++ b/pydocs/gdata.geo.html
@@ -0,0 +1,340 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.geo</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.geo</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/geo/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/geo/__init__.py</a></font></td></tr></table>
+ <p><tt>Picasa Web Albums uses the georss and gml namespaces for <br>
+elements defined in the GeoRSS and Geography Markup Language specifications.<br>
+ <br>
+Specifically, Picasa Web Albums uses the following elements:<br>
+ <br>
+georss:where<br>
+gml:<a href="#Point">Point</a><br>
+gml:pos<br>
+ <br>
+<a href="http://code.google.com/apis/picasaweb/reference.html#georss_reference">http://code.google.com/apis/picasaweb/reference.html#georss_reference</a><br>
+ <br>
+ <br>
+Picasa Web Albums also accepts geographic-location data in two other formats:<br>
+W3C format and plain-GeoRSS (without GML) format.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.geo.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.geo.html#GeoBaseElement">GeoBaseElement</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.geo.html#Point">Point</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.html#Pos">Pos</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.geo.html#Where">Where</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GeoBaseElement">class <strong>GeoBaseElement</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Base class for elements.<br>
+ <br>
+To add new elements, you only need to add the element tag name to self.<strong>_tag</strong><br>
+and the namespace to self.<strong>_namespace</strong><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.html#GeoBaseElement">GeoBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GeoBaseElement-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GeoBaseElement-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GeoBaseElement-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GeoBaseElement-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Point">class <strong>Point</strong></a>(<a href="gdata.geo.html#GeoBaseElement">GeoBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(container) Specifies a particular geographical point, by means of<br>
+a <gml:pos> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.html#Point">Point</a></dd>
+<dd><a href="gdata.geo.html#GeoBaseElement">GeoBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Point-__init__"><strong>__init__</strong></a>(self, pos<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Point-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Point-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Point-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Pos">class <strong>Pos</strong></a>(<a href="gdata.geo.html#GeoBaseElement">GeoBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(string) Specifies a latitude and longitude, separated by a space,<br>
+e.g. `35.669998 139.770004'<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.html#Pos">Pos</a></dd>
+<dd><a href="gdata.geo.html#GeoBaseElement">GeoBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.geo.html#GeoBaseElement">GeoBaseElement</a>:<br>
+<dl><dt><a name="Pos-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Pos-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Pos-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Pos-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Where">class <strong>Where</strong></a>(<a href="gdata.geo.html#GeoBaseElement">GeoBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(container) Specifies a geographical location or region.<br>
+A container element, containing a single <gml:<a href="#Point">Point</a>> element.<br>
+(Not to be confused with <gd:where>.) <br>
+ <br>
+Note that the (only) child attribute, .<a href="#Point">Point</a>, is title-cased.<br>
+This reflects the names of elements in the xml stream<br>
+(principle of least surprise).<br>
+ <br>
+As a convenience, you can get a tuple of (lat, lon) with <a href="#Where">Where</a>.<a href="#Where-location">location</a>(),<br>
+and set the same data with <a href="#Where">Where</a>.setLocation( (lat, lon) ).<br>
+ <br>
+Similarly, there are methods to set and get only latitude and longitude.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.geo.html#Where">Where</a></dd>
+<dd><a href="gdata.geo.html#GeoBaseElement">GeoBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Where-__init__"><strong>__init__</strong></a>(self, point<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Where-latitude"><strong>latitude</strong></a>(self)</dt><dd><tt>(float) Get the latitude value of the geo-tag. See also .<a href="#Where-location">location</a>()</tt></dd></dl>
+
+<dl><dt><a name="Where-location"><strong>location</strong></a>(self)</dt><dd><tt>(float, float) Return <a href="#Where">Where</a>.<a href="#Point">Point</a>.pos.text as a (lat,lon) tuple</tt></dd></dl>
+
+<dl><dt><a name="Where-longitude"><strong>longitude</strong></a>(self)</dt><dd><tt>(float) Get the longtitude value of the geo-tag. See also .<a href="#Where-location">location</a>()</tt></dd></dl>
+
+<dl><dt><a name="Where-longtitude"><strong>longtitude</strong></a> = <a href="#Where-longitude">longitude</a>(self)</dt></dl>
+
+<dl><dt><a name="Where-set_latitude"><strong>set_latitude</strong></a>(self, lat)</dt><dd><tt>(bool) Set the latitude value of the geo-tag.<br>
+ <br>
+Args:<br>
+lat (float): The new latitude value<br>
+ <br>
+See also .<a href="#Where-set_location">set_location</a>()</tt></dd></dl>
+
+<dl><dt><a name="Where-set_location"><strong>set_location</strong></a>(self, latlon)</dt><dd><tt>(bool) Set <a href="#Where">Where</a>.<a href="#Point">Point</a>.pos.text from a (lat,lon) tuple.<br>
+ <br>
+Arguments:<br>
+lat (float): The latitude in degrees, from -90.0 to 90.0<br>
+lon (float): The longitude in degrees, from -180.0 to 180.0<br>
+ <br>
+Returns True on success.</tt></dd></dl>
+
+<dl><dt><a name="Where-set_longitude"><strong>set_longitude</strong></a>(self, lon)</dt><dd><tt>(bool) Set the longtitude value of the geo-tag.<br>
+ <br>
+Args:<br>
+lat (float): The new latitude value<br>
+ <br>
+See also .<a href="#Where-set_location">set_location</a>()</tt></dd></dl>
+
+<dl><dt><a name="Where-set_longtitude"><strong>set_longtitude</strong></a> = <a href="#Where-set_longitude">set_longitude</a>(self, lon)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Where-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Where-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Where-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-PointFromString"><strong>PointFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PosFromString"><strong>PosFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-WhereFromString"><strong>WhereFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GEORSS_NAMESPACE</strong> = 'http://www.georss.org/georss'<br>
+<strong>GEO_NAMESPACE</strong> = 'http://www.w3.org/2003/01/geo/wgs84_pos#'<br>
+<strong>GML_NAMESPACE</strong> = 'http://www.opengis.net/gml'<br>
+<strong>__author__</strong> = u'havard@gulldahl.no'<br>
+<strong>__license__</strong> = 'Apache License v2'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">havard@gulldahl.no</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.health.html b/pydocs/gdata.health.html
new file mode 100644
index 0000000..2c28788
--- /dev/null
+++ b/pydocs/gdata.health.html
@@ -0,0 +1,659 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.health</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.health</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/health/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/health/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains extensions to Atom objects used with Google Health.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.health.service.html">service</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.health.html#Ccr">Ccr</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.health.html#ProfileEntry">ProfileEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.health.html#ProfileListEntry">ProfileListEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.health.html#ProfileFeed">ProfileFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.health.html#ProfileListFeed">ProfileListFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Ccr">class <strong>Ccr</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a Google Health <ContinuityOfCareRecord>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.health.html#Ccr">Ccr</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Ccr-GetAlerts"><strong>GetAlerts</strong></a>(self)</dt><dd><tt>Helper for extracting Alert/Allergy data from the CCR.<br>
+ <br>
+Returns:<br>
+ A list of ExtensionElements (one for each allergy found) or None if<br>
+ no allergies where found in this CCR.</tt></dd></dl>
+
+<dl><dt><a name="Ccr-GetAllergies"><strong>GetAllergies</strong></a>(self)</dt><dd><tt>Alias for <a href="#Ccr-GetAlerts">GetAlerts</a>().</tt></dd></dl>
+
+<dl><dt><a name="Ccr-GetConditions"><strong>GetConditions</strong></a>(self)</dt><dd><tt>Alias for <a href="#Ccr-GetProblems">GetProblems</a>().</tt></dd></dl>
+
+<dl><dt><a name="Ccr-GetImmunizations"><strong>GetImmunizations</strong></a>(self)</dt><dd><tt>Helper for extracting Immunization data from the CCR.<br>
+ <br>
+Returns:<br>
+ A list of ExtensionElements (one for each immunization found) or None if<br>
+ no immunizations where found in this CCR.</tt></dd></dl>
+
+<dl><dt><a name="Ccr-GetMedications"><strong>GetMedications</strong></a>(self)</dt><dd><tt>Helper for extracting Medication data from the CCR.<br>
+ <br>
+Returns:<br>
+ A list of ExtensionElements (one for each medication found) or None if<br>
+ no medications where found in this CCR.</tt></dd></dl>
+
+<dl><dt><a name="Ccr-GetProblems"><strong>GetProblems</strong></a>(self)</dt><dd><tt>Helper for extracting Problem/Condition data from the CCR.<br>
+ <br>
+Returns:<br>
+ A list of ExtensionElements (one for each problem found) or None if<br>
+ no problems where found in this CCR.</tt></dd></dl>
+
+<dl><dt><a name="Ccr-GetProcedures"><strong>GetProcedures</strong></a>(self)</dt><dd><tt>Helper for extracting Procedure data from the CCR.<br>
+ <br>
+Returns:<br>
+ A list of ExtensionElements (one for each procedure found) or None if<br>
+ no procedures where found in this CCR.</tt></dd></dl>
+
+<dl><dt><a name="Ccr-GetResults"><strong>GetResults</strong></a>(self)</dt><dd><tt>Helper for extracting Results/Labresults data from the CCR.<br>
+ <br>
+Returns:<br>
+ A list of ExtensionElements (one for each result found) or None if<br>
+ no results where found in this CCR.</tt></dd></dl>
+
+<dl><dt><a name="Ccr-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Ccr-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Ccr-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Ccr-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProfileEntry">class <strong>ProfileEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Health version of an Atom Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.health.html#ProfileEntry">ProfileEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ProfileEntry-__init__"><strong>__init__</strong></a>(self, ccr<font color="#909090">=None</font>, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="ProfileEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ProfileEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ProfileEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProfileEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProfileFeed">class <strong>ProfileFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing a list of Google Health profile entries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.health.html#ProfileFeed">ProfileFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="ProfileFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ProfileFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ProfileFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ProfileFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="ProfileFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="ProfileFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProfileFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProfileListEntry">class <strong>ProfileListEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Atom Entry in the Google Health profile list feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.health.html#ProfileListEntry">ProfileListEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ProfileListEntry-GetProfileId"><strong>GetProfileId</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListEntry-GetProfileName"><strong>GetProfileName</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="ProfileListEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ProfileListEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Entry">atom.Entry</a>:<br>
+<dl><dt><a name="ProfileListEntry-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ProfileListEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ProfileListEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ProfileListEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileListEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="ProfileListEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="ProfileListEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProfileListEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileListEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProfileListFeed">class <strong>ProfileListFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing a list of Google Health profile list entries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.health.html#ProfileListFeed">ProfileListFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="ProfileListFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ProfileListFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ProfileListFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ProfileListFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileListFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="ProfileListFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="ProfileListFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ProfileListFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="ProfileListFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProfileListFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-ProfileEntryFromString"><strong>ProfileEntryFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#ProfileEntry">ProfileEntry</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a Health profile feed entry.<br>
+ <br>
+Returns:<br>
+ A <a href="#ProfileEntry">ProfileEntry</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-ProfileFeedFromString"><strong>ProfileFeedFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#ProfileFeed">ProfileFeed</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a <a href="#ProfileFeed">ProfileFeed</a> feed.<br>
+ <br>
+Returns:<br>
+ A <a href="#ProfileFeed">ProfileFeed</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-ProfileListEntryFromString"><strong>ProfileListEntryFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#ProfileListEntry">ProfileListEntry</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a Health profile list feed entry.<br>
+ <br>
+Returns:<br>
+ A <a href="#ProfileListEntry">ProfileListEntry</a> object corresponding to the given XML.</tt></dd></dl>
+ <dl><dt><a name="-ProfileListFeedFromString"><strong>ProfileListFeedFromString</strong></a>(xml_string)</dt><dd><tt>Converts an XML string into a <a href="#ProfileListFeed">ProfileListFeed</a> object.<br>
+ <br>
+Args:<br>
+ xml_string: string The XML describing a <a href="#ProfileListFeed">ProfileListFeed</a> feed.<br>
+ <br>
+Returns:<br>
+ A <a href="#ProfileListFeed">ProfileListFeed</a> object corresponding to the given XML.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>CCR_NAMESPACE</strong> = 'urn:astm-org:CCR'<br>
+<strong>METADATA_NAMESPACE</strong> = 'http://schemas.google.com/health/metadata'<br>
+<strong>__author__</strong> = 'api.eric@google.com (Eric Bidelman)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.eric@google.com (Eric Bidelman)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.health.service.html b/pydocs/gdata.health.service.html
new file mode 100644
index 0000000..4af47a1
--- /dev/null
+++ b/pydocs/gdata.health.service.html
@@ -0,0 +1,1181 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.health.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.health.html"><font color="#ffffff">health</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/health/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/health/service.py</a></font></td></tr></table>
+ <p><tt><a href="#HealthService">HealthService</a> extends <a href="gdata.service.html#GDataService">GDataService</a> to streamline Google Health API access.<br>
+ <br>
+<a href="#HealthService">HealthService</a>: Provides methods to interact with the profile, profile list,<br>
+ and register/notices feeds. Extends <a href="gdata.service.html#GDataService">GDataService</a>.<br>
+ <br>
+<a href="#HealthProfileQuery">HealthProfileQuery</a>: Queries the Google Health Profile feed.<br>
+ <br>
+<a href="#HealthProfileListQuery">HealthProfileListQuery</a>: Queries the Google Health Profile list feed.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.health.service.html#HealthService">HealthService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Query">gdata.service.Query</a>(<a href="__builtin__.html#dict">__builtin__.dict</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.health.service.html#HealthProfileListQuery">HealthProfileListQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.health.service.html#HealthProfileQuery">HealthProfileQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.health.service.html#HealthRegisterQuery">HealthRegisterQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HealthProfileListQuery">class <strong>HealthProfileListQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Object used to construct a URI to query a Health profile list feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.health.service.html#HealthProfileListQuery">HealthProfileListQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="HealthProfileListQuery-ToUri"><strong>ToUri</strong></a>(self)</dt><dd><tt>Generates a URI from the query parameters set in the object.<br>
+ <br>
+Returns:<br>
+ A string containing the URI used to retrieve entries from the<br>
+ profile list feed.</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__init__"><strong>__init__</strong></a>(self, service<font color="#909090">='health'</font>, feed<font color="#909090">='feeds/profile/list'</font>)</dt><dd><tt>Constructor for Health profile list feed query.<br>
+ <br>
+Args:<br>
+ service: string (optional) The service to query. Either 'health' or 'h9'.<br>
+ feed: string (optional) The path for the feed. The default value is<br>
+ 'feeds/profile/list'.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="HealthProfileListQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="HealthProfileListQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileListQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#HealthProfileListQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#HealthProfileListQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#HealthProfileListQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#HealthProfileListQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileListQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileListQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#HealthProfileListQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HealthProfileQuery">class <strong>HealthProfileQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Object used to construct a URI to query the Google Health profile feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.health.service.html#HealthProfileQuery">HealthProfileQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="HealthProfileQuery-ToUri"><strong>ToUri</strong></a>(self)</dt><dd><tt>Generates a URI from the query parameters set in the object.<br>
+ <br>
+Returns:<br>
+ A string containing the URI used to retrieve entries from the Health<br>
+ profile feed.</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__init__"><strong>__init__</strong></a>(self, service<font color="#909090">='health'</font>, feed<font color="#909090">='feeds/profile'</font>, projection<font color="#909090">='default'</font>, profile_id<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Health profile feed query.<br>
+ <br>
+Args:<br>
+ service: string (optional) The service to query. Either 'health' or 'h9'.<br>
+ feed: string (optional) The path for the feed. The default value is<br>
+ 'feeds/profile'.<br>
+ projection: string (optional) The visibility of the data. Possible values<br>
+ are 'default' for AuthSub and 'ui' for ClientLogin. If this value<br>
+ is set to 'ui', the profile_id parameter should also be set.<br>
+ profile_id: string (optional) The profile id to query. This should only<br>
+ be used when using ClientLogin.<br>
+ text_query: str (optional) The contents of the q query parameter. The<br>
+ contents of the text_query are URL escaped upon conversion to a URI.<br>
+ Note: this parameter can only be used on the register feed using<br>
+ ClientLogin.<br>
+ params: dict (optional) Parameter value string pairs which become URL<br>
+ params when translated to a URI. These parameters are added to<br>
+ the query's items.<br>
+ categories: list (optional) List of category strings which should be<br>
+ included as query categories. See gdata.service.<a href="gdata.service.html#Query">Query</a> for<br>
+ additional documentation.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="HealthProfileQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="HealthProfileQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthProfileQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#HealthProfileQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#HealthProfileQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#HealthProfileQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#HealthProfileQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="HealthProfileQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#HealthProfileQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#HealthProfileQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HealthRegisterQuery">class <strong>HealthRegisterQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Object used to construct a URI to query a Health register/notice feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.health.service.html#HealthRegisterQuery">HealthRegisterQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="HealthRegisterQuery-ToUri"><strong>ToUri</strong></a>(self)</dt><dd><tt>Generates a URI from the query parameters set in the object.<br>
+ <br>
+Returns:<br>
+ A string containing the URI needed to interact with the register feed.</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__init__"><strong>__init__</strong></a>(self, service<font color="#909090">='health'</font>, feed<font color="#909090">='feeds/register'</font>, projection<font color="#909090">='default'</font>, profile_id<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Health profile list feed query.<br>
+ <br>
+Args:<br>
+ service: string (optional) The service to query. Either 'health' or 'h9'.<br>
+ feed: string (optional) The path for the feed. The default value is<br>
+ 'feeds/register'.<br>
+ projection: string (optional) The visibility of the data. Possible values<br>
+ are 'default' for AuthSub and 'ui' for ClientLogin. If this value<br>
+ is set to 'ui', the profile_id parameter should also be set.<br>
+ profile_id: string (optional) The profile id to query. This should only<br>
+ be used when using ClientLogin.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="HealthRegisterQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="HealthRegisterQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#HealthRegisterQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#HealthRegisterQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#HealthRegisterQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#HealthRegisterQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#HealthRegisterQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="HealthRegisterQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#HealthRegisterQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#HealthRegisterQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HealthService">class <strong>HealthService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Health service Document List feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.health.service.html#HealthService">HealthService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="HealthService-GetProfileFeed"><strong>GetProfileFeed</strong></a>(self, query<font color="#909090">=None</font>, profile_id<font color="#909090">=None</font>)</dt><dd><tt>Fetches the users Google Health profile feed.<br>
+ <br>
+Args:<br>
+ query: <a href="#HealthProfileQuery">HealthProfileQuery</a> or string (optional) A query to use on the<br>
+ profile feed. If None, a <a href="#HealthProfileQuery">HealthProfileQuery</a> is constructed.<br>
+ profile_id: string (optional) The profile id to query the profile feed<br>
+ with when using ClientLogin. Note: this parameter is ignored if<br>
+ query is set.<br>
+ <br>
+Returns:<br>
+ A gdata.health.ProfileFeed object containing the user's Health profile.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-GetProfileListFeed"><strong>GetProfileListFeed</strong></a>(self, query<font color="#909090">=None</font>)</dt><dd><tt>Fetches the users Google Health profile feed.<br>
+ <br>
+Args:<br>
+ query: <a href="#HealthProfileListQuery">HealthProfileListQuery</a> or string (optional) A query to use<br>
+ on the profile list feed. If None, a <a href="#HealthProfileListQuery">HealthProfileListQuery</a> is<br>
+ constructed to /health/feeds/profile/list or /h9/feeds/profile/list.<br>
+ <br>
+Returns:<br>
+ A gdata.health.ProfileListFeed object containing the user's list<br>
+ of profiles.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-SendNotice"><strong>SendNotice</strong></a>(self, subject, body<font color="#909090">=None</font>, content_type<font color="#909090">='html'</font>, ccr<font color="#909090">=None</font>, profile_id<font color="#909090">=None</font>)</dt><dd><tt>Sends (posts) a notice to the user's Google Health profile.<br>
+ <br>
+Args:<br>
+ subject: A string representing the message's subject line.<br>
+ body: string (optional) The message body.<br>
+ content_type: string (optional) The content type of the notice message<br>
+ body. This parameter is only honored when a message body is<br>
+ specified.<br>
+ ccr: string (optional) The CCR XML document to reconcile into the<br>
+ user's profile.<br>
+ profile_id: string (optional) The profile id to work with when using<br>
+ ClientLogin. Note: this parameter is ignored if query is set.<br>
+ <br>
+Returns:<br>
+ A gdata.health.ProfileEntry object of the posted entry.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, use_h9_sandbox<font color="#909090">=False</font>, server<font color="#909090">='www.google.com'</font>, additional_headers<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a client for the Google Health service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ use_h9_sandbox: boolean (optional) True to issue requests against the<br>
+ /h9 developer's sandbox.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened.<br>
+ additional_headers: dictionary (optional) Any additional headers which<br>
+ should be included with CRUD operations.<br>
+ kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="HealthService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="HealthService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="HealthService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="HealthService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="HealthService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#HealthService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="HealthService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="HealthService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="HealthService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="HealthService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="HealthService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#HealthService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#HealthService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="HealthService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="HealthService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="HealthService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'api.eric@google.com (Eric Bidelman)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.eric@google.com (Eric Bidelman)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.html b/pydocs/gdata.html
new file mode 100644
index 0000000..fb2d54c
--- /dev/null
+++ b/pydocs/gdata.html
@@ -0,0 +1,1506 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong>gdata</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains classes representing Google Data elements.<br>
+ <br>
+Extends Atom classes to add Google Data specific elements.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.Crypto.html"><strong>Crypto</strong> (package)</a><br>
+<a href="gdata.acl.html"><strong>acl</strong> (package)</a><br>
+<a href="gdata.alt.html"><strong>alt</strong> (package)</a><br>
+<a href="gdata.analytics.html"><strong>analytics</strong> (package)</a><br>
+<a href="gdata.apps.html"><strong>apps</strong> (package)</a><br>
+<a href="gdata.apps_property.html">apps_property</a><br>
+<a href="gdata.auth.html">auth</a><br>
+<a href="gdata.blogger.html"><strong>blogger</strong> (package)</a><br>
+<a href="gdata.books.html"><strong>books</strong> (package)</a><br>
+<a href="gdata.calendar.html"><strong>calendar</strong> (package)</a><br>
+<a href="gdata.calendar_resource.html"><strong>calendar_resource</strong> (package)</a><br>
+</td><td width="25%" valign=top><a href="gdata.client.html">client</a><br>
+<a href="gdata.codesearch.html"><strong>codesearch</strong> (package)</a><br>
+<a href="gdata.contacts.html"><strong>contacts</strong> (package)</a><br>
+<a href="gdata.contentforshopping.html"><strong>contentforshopping</strong> (package)</a><br>
+<a href="gdata.core.html">core</a><br>
+<a href="gdata.data.html">data</a><br>
+<a href="gdata.docs.html"><strong>docs</strong> (package)</a><br>
+<a href="gdata.dublincore.html"><strong>dublincore</strong> (package)</a><br>
+<a href="gdata.exif.html"><strong>exif</strong> (package)</a><br>
+<a href="gdata.finance.html"><strong>finance</strong> (package)</a><br>
+<a href="gdata.gauth.html">gauth</a><br>
+</td><td width="25%" valign=top><a href="gdata.geo.html"><strong>geo</strong> (package)</a><br>
+<a href="gdata.health.html"><strong>health</strong> (package)</a><br>
+<a href="gdata.marketplace.html"><strong>marketplace</strong> (package)</a><br>
+<a href="gdata.media.html"><strong>media</strong> (package)</a><br>
+<a href="gdata.notebook.html"><strong>notebook</strong> (package)</a><br>
+<a href="gdata.oauth.html"><strong>oauth</strong> (package)</a><br>
+<a href="gdata.opensearch.html"><strong>opensearch</strong> (package)</a><br>
+<a href="gdata.photos.html"><strong>photos</strong> (package)</a><br>
+<a href="gdata.projecthosting.html"><strong>projecthosting</strong> (package)</a><br>
+<a href="gdata.sample_util.html">sample_util</a><br>
+<a href="gdata.service.html">service</a><br>
+</td><td width="25%" valign=top><a href="gdata.sites.html"><strong>sites</strong> (package)</a><br>
+<a href="gdata.spreadsheet.html"><strong>spreadsheet</strong> (package)</a><br>
+<a href="gdata.spreadsheets.html"><strong>spreadsheets</strong> (package)</a><br>
+<a href="gdata.test_config.html">test_config</a><br>
+<a href="gdata.test_data.html">test_data</a><br>
+<a href="gdata.tlslite.html"><strong>tlslite</strong> (package)</a><br>
+<a href="gdata.urlfetch.html">urlfetch</a><br>
+<a href="gdata.webmastertools.html"><strong>webmastertools</strong> (package)</a><br>
+<a href="gdata.youtube.html"><strong>youtube</strong> (package)</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#MediaSource">MediaSource</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchId">BatchId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.html#BatchInterrupted">BatchInterrupted</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.html#BatchOperation">BatchOperation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.html#BatchStatus">BatchStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.html#EntryLink">EntryLink</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.html#ExtendedProperty">ExtendedProperty</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.html#FeedLink">FeedLink</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.html#ItemsPerPage">ItemsPerPage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.html#StartIndex">StartIndex</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.html#TotalResults">TotalResults</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Entry">atom.Entry</a>(<a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchEntry">BatchEntry</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Feed">atom.Feed</a>(<a href="atom.html#Source">atom.Source</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchFeed">BatchFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#LinkFinder">atom.LinkFinder</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#LinkFinder">LinkFinder</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchEntry">BatchEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchFeed">BatchFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.html#MissingRequiredParameters">MissingRequiredParameters</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchEntry">class <strong>BatchEntry</strong></a>(<a href="gdata.html#GDataEntry">GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An atom:entry for use in batch requests.<br>
+ <br>
+The <a href="#BatchEntry">BatchEntry</a> contains additional members to specify the operation to be<br>
+performed on this entry and a batch ID so that the server can reference<br>
+individual operations in the response feed. For more information, see:<br>
+<a href="http://code.google.com/apis/gdata/batch.html">http://code.google.com/apis/gdata/batch.html</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#BatchEntry">BatchEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BatchEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, source<font color="#909090">=None</font>, summary<font color="#909090">=None</font>, control<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, batch_operation<font color="#909090">=None</font>, batch_id<font color="#909090">=None</font>, batch_status<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">GDataEntry</a>:<br>
+<dl><dt><a name="BatchEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BatchEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BatchEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="BatchEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BatchEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="BatchEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchFeed">class <strong>BatchFeed</strong></a>(<a href="gdata.html#GDataFeed">GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing a list of batch request entries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#BatchFeed">BatchFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BatchFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+ <br>
+If the entry is not a <a href="#BatchEntry">BatchEntry</a>, it is converted to a <a href="#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="#BatchEntry">BatchEntry</a>, atom.<a href="atom.html#Entry">Entry</a>, or another <a href="atom.html#Entry">Entry</a> flavor (optional) The<br>
+ entry which will be sent to the server as part of the batch request.<br>
+ The item must have a valid atom id so that the server knows which<br>
+ entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ <a href="#MissingRequiredParameters">MissingRequiredParameters</a>: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-AddDelete"><strong>AddDelete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ <a href="#MissingRequiredParameters">MissingRequiredParameters</a>: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-AddInsert"><strong>AddInsert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-AddQuery"><strong>AddQuery</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="#BatchEntry">BatchEntry</a>, and you may pass in the <a href="#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ <a href="#MissingRequiredParameters">MissingRequiredParameters</a></tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-AddUpdate"><strong>AddUpdate</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-GetBatchLink"><strong>GetBatchLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, interrupted<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BatchFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BatchFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="BatchFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BatchFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="BatchFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BatchFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchId">class <strong>BatchId</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#BatchId">BatchId</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BatchId-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchId-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="BatchId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BatchId-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchInterrupted">class <strong>BatchInterrupted</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#BatchInterrupted">BatchInterrupted</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BatchInterrupted-__init__"><strong>__init__</strong></a>(self, reason<font color="#909090">=None</font>, success<font color="#909090">=None</font>, failures<font color="#909090">=None</font>, parsed<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BatchInterrupted-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchInterrupted-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BatchInterrupted-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchOperation">class <strong>BatchOperation</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#BatchOperation">BatchOperation</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BatchOperation-__init__"><strong>__init__</strong></a>(self, op_type<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BatchOperation-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchOperation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BatchOperation-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BatchStatus">class <strong>BatchStatus</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+<a href="atom.html#Entry">Entry</a> operation has a corresponding <a href="atom.html#Entry">Entry</a> in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#BatchStatus">BatchStatus</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BatchStatus-__init__"><strong>__init__</strong></a>(self, code<font color="#909090">=None</font>, reason<font color="#909090">=None</font>, content_type<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BatchStatus-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BatchStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BatchStatus-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EntryLink">class <strong>EntryLink</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:entryLink element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#EntryLink">EntryLink</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="EntryLink-__init__"><strong>__init__</strong></a>(self, href<font color="#909090">=None</font>, read_only<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="EntryLink-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="EntryLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="EntryLink-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ExtendedProperty">class <strong>ExtendedProperty</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Data extendedProperty element.<br>
+ <br>
+Used to store arbitrary key-value information specific to your<br>
+application. The value can either be a text string stored as an XML<br>
+attribute (.value), or an XML node (XmlBlob) as a child element.<br>
+ <br>
+This element is used in the Google Calendar data API and the Google<br>
+Contacts data API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#ExtendedProperty">ExtendedProperty</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ExtendedProperty-GetXmlBlobExtensionElement"><strong>GetXmlBlobExtensionElement</strong></a>(self)</dt><dd><tt>Returns the XML blob as an atom.ExtensionElement.<br>
+ <br>
+Returns:<br>
+ An atom.ExtensionElement representing the blob's XML, or None if no<br>
+ blob was set.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-GetXmlBlobString"><strong>GetXmlBlobString</strong></a>(self)</dt><dd><tt>Returns the XML blob as a string.<br>
+ <br>
+Returns:<br>
+ A string containing the blob's XML, or None if no blob was set.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-SetXmlBlob"><strong>SetXmlBlob</strong></a>(self, blob)</dt><dd><tt>Sets the contents of the extendedProperty to XML as a child node.<br>
+ <br>
+Since the extendedProperty is only allowed one child element as an XML<br>
+blob, setting the XML blob will erase any preexisting extension elements<br>
+in this <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+Args:<br>
+ blob: str, ElementTree Element or atom.ExtensionElement representing<br>
+ the XML blob stored in the extendedProperty.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, value<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ExtendedProperty-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ExtendedProperty-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ExtendedProperty-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FeedLink">class <strong>FeedLink</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gd:feedLink element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#FeedLink">FeedLink</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="FeedLink-__init__"><strong>__init__</strong></a>(self, count_hint<font color="#909090">=None</font>, href<font color="#909090">=None</font>, read_only<font color="#909090">=None</font>, rel<font color="#909090">=None</font>, feed<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="FeedLink-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="FeedLink-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="FeedLink-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GDataEntry">class <strong>GDataEntry</strong></a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Extends Atom <a href="atom.html#Entry">Entry</a> to provide data processing<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#GDataEntry">GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GDataEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="GDataEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Entry">atom.Entry</a>:<br>
+<dl><dt><a name="GDataEntry-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GDataEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GDataEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GDataEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="GDataEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="GDataEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="GDataEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GDataEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="GDataEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GDataFeed">class <strong>GDataFeed</strong></a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A <a href="atom.html#Feed">Feed</a> from a GData service<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#GDataFeed">GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GDataFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the <a href="atom.html#Entry">Entry</a> instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the <a href="atom.html#Entry">Entry</a>'s XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GDataFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GDataFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GDataFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="GDataFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="GDataFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="GDataFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GDataFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="GDataFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ItemsPerPage">class <strong>ItemsPerPage</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The opensearch:itemsPerPage element in GData feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#ItemsPerPage">ItemsPerPage</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ItemsPerPage-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ItemsPerPage-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ItemsPerPage-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LinkFinder">class <strong>LinkFinder</strong></a>(<a href="atom.html#LinkFinder">atom.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An "interface" providing methods to find link elements<br>
+ <br>
+GData <a href="atom.html#Entry">Entry</a> elements often contain multiple links which differ in the rel<br>
+attribute or content type. Often, developers are interested in a specific<br>
+type of link so this class provides methods to find specific classes of<br>
+links.<br>
+ <br>
+This class is used as a mixin in GData entries.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="LinkFinder-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="LinkFinder-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaSource">class <strong>MediaSource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>GData Entries can refer to media sources, so this class provides a<br>
+place to store references to these objects along with some metadata.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="MediaSource-__init__"><strong>__init__</strong></a>(self, file_handle<font color="#909090">=None</font>, content_type<font color="#909090">=None</font>, content_length<font color="#909090">=None</font>, file_path<font color="#909090">=None</font>, file_name<font color="#909090">=None</font>)</dt><dd><tt>Creates an <a href="__builtin__.html#object">object</a> of type <a href="#MediaSource">MediaSource</a>.<br>
+ <br>
+Args:<br>
+ file_handle: A file handle pointing to the file to be encapsulated in the<br>
+ <a href="#MediaSource">MediaSource</a><br>
+ content_type: string The MIME type of the file. Required if a file_handle<br>
+ is given.<br>
+ content_length: int The size of the file. Required if a file_handle is<br>
+ given.<br>
+ file_path: string (optional) A full path name to the file. Used in<br>
+ place of a file_handle.<br>
+ file_name: string The name of the file without any path information.<br>
+ Required if a file_handle is given.</tt></dd></dl>
+
+<dl><dt><a name="MediaSource-setFile"><strong>setFile</strong></a>(self, file_name, content_type)</dt><dd><tt>A helper function which can create a file handle from a given filename<br>
+and set the content type and length all at once.<br>
+ <br>
+Args:<br>
+ file_name: string The path and file name to the file containing the media<br>
+ content_type: string A MIME type representing the type of the media</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MissingRequiredParameters">class <strong>MissingRequiredParameters</strong></a>(<a href="gdata.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#MissingRequiredParameters">MissingRequiredParameters</a></dd>
+<dd><a href="gdata.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="MissingRequiredParameters-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#MissingRequiredParameters-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="MissingRequiredParameters-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#MissingRequiredParameters-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="MissingRequiredParameters-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="StartIndex">class <strong>StartIndex</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The opensearch:startIndex element in GData feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#StartIndex">StartIndex</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="StartIndex-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="StartIndex-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="StartIndex-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TotalResults">class <strong>TotalResults</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>opensearch:<a href="#TotalResults">TotalResults</a> for a GData feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.html#TotalResults">TotalResults</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="TotalResults-__init__"><strong>__init__</strong></a>(self, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="TotalResults-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="TotalResults-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-BatchEntryFromString"><strong>BatchEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-BatchFeedFromString"><strong>BatchFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-BatchIdFromString"><strong>BatchIdFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-BatchInterruptedFromString"><strong>BatchInterruptedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-BatchOperationFromString"><strong>BatchOperationFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-BatchStatusFromString"><strong>BatchStatusFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-EntryLinkFromString"><strong>EntryLinkFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ExtendedPropertyFromString"><strong>ExtendedPropertyFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-FeedLinkFromString"><strong>FeedLinkFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-GDataEntryFromString"><strong>GDataEntryFromString</strong></a>(xml_string)</dt><dd><tt>Creates a new <a href="#GDataEntry">GDataEntry</a> instance given a string of XML.</tt></dd></dl>
+ <dl><dt><a name="-GDataFeedFromString"><strong>GDataFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ItemsPerPageFromString"><strong>ItemsPerPageFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-StartIndexFromString"><strong>StartIndexFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TotalResultsFromString"><strong>TotalResultsFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>BATCH_DELETE</strong> = 'delete'<br>
+<strong>BATCH_INSERT</strong> = 'insert'<br>
+<strong>BATCH_NAMESPACE</strong> = 'http://schemas.google.com/gdata/batch'<br>
+<strong>BATCH_QUERY</strong> = 'query'<br>
+<strong>BATCH_UPDATE</strong> = 'update'<br>
+<strong>GACL_NAMESPACE</strong> = 'http://schemas.google.com/acl/2007'<br>
+<strong>GACL_TEMPLATE</strong> = '{http://schemas.google.com/acl/2007}%s'<br>
+<strong>GDATA_NAMESPACE</strong> = 'http://schemas.google.com/g/2005'<br>
+<strong>GDATA_TEMPLATE</strong> = '{http://schemas.google.com/g/2005}%s'<br>
+<strong>OPENSEARCH_NAMESPACE</strong> = 'http://a9.com/-/spec/opensearchrss/1.0/'<br>
+<strong>OPENSEARCH_TEMPLATE</strong> = '{http://a9.com/-/spec/opensearchrss/1.0/}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeffrey Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeffrey Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.maps.client.html b/pydocs/gdata.maps.client.html
new file mode 100644
index 0000000..c76a512
--- /dev/null
+++ b/pydocs/gdata.maps.client.html
@@ -0,0 +1,615 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.maps.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.maps.html"><font color="#ffffff">maps</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/lib/python2.6/dist-packages/gdata/maps/client.py">/usr/local/lib/python2.6/dist-packages/gdata/maps/client.py</a></font></td></tr></table>
+ <p><tt>Contains a client to communicate with the Maps Data servers.<br>
+ <br>
+For documentation on the Maps Data API, see:<br>
+<a href="http://code.google.com/apis/maps/documentation/mapsdata/">http://code.google.com/apis/maps/documentation/mapsdata/</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.maps.client.html#MapsClient">MapsClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MapsClient">class <strong>MapsClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Maps Data API GData client.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.maps.client.html#MapsClient">MapsClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="MapsClient-AddFeature"><strong>AddFeature</strong></a> = <a href="#MapsClient-add_feature">add_feature</a>(self, map_id, title, content, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, content_type<font color="#909090">='application/vnd.google-earth.kml+xml'</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-CreateMap"><strong>CreateMap</strong></a> = <a href="#MapsClient-create_map">create_map</a>(self, title, summary<font color="#909090">=None</font>, unlisted<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, summary_type<font color="#909090">='text'</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-Delete"><strong>Delete</strong></a> = <a href="#MapsClient-delete">delete</a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-GetFeatures"><strong>GetFeatures</strong></a> = <a href="#MapsClient-get_features">get_features</a>(self, map_id, user_id<font color="#909090">='default'</font>, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.maps.data.FeatureFeed'></font>, query<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-GetMaps"><strong>GetMaps</strong></a> = <a href="#MapsClient-get_maps">get_maps</a>(self, user_id<font color="#909090">='default'</font>, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.maps.data.MapFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-Update"><strong>Update</strong></a> = <a href="#MapsClient-update">update</a>(self, entry, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-add_feature"><strong>add_feature</strong></a>(self, map_id, title, content, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, content_type<font color="#909090">='application/vnd.google-earth.kml+xml'</font>, **kwargs)</dt><dd><tt>Adds a new feature to the given map.<br>
+ <br>
+Args:<br>
+ map_id: A string representing the ID of the map to which the new feature<br>
+ should be added.<br>
+ title: A string representing the name/title of the new feature.<br>
+ content: A KML string or gdata.maps.data.KmlContent object representing<br>
+ the new feature's KML contents, including its description.<br>
+ <br>
+Returns:<br>
+ A gdata.maps.data.Feature.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-create_map"><strong>create_map</strong></a>(self, title, summary<font color="#909090">=None</font>, unlisted<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, summary_type<font color="#909090">='text'</font>, **kwargs)</dt><dd><tt>Creates a new map and posts it to the Maps Data servers.<br>
+ <br>
+Args:<br>
+ title: A string representing the title of the new map.<br>
+ summary: An optional string representing the new map's description.<br>
+ unlisted: An optional boolean identifying whether the map should be<br>
+ unlisted (True) or public (False). Default False.<br>
+ <br>
+Returns:<br>
+ A gdata.maps.data.Map.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Deletes the given entry or entry URI server-side.<br>
+ <br>
+Args:<br>
+ entry_or_uri: A gdata.maps.data.Map, gdata.maps.data.Feature, or URI<br>
+ string representing the entry to delete.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-get_features"><strong>get_features</strong></a>(self, map_id, user_id<font color="#909090">='default'</font>, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.maps.data.FeatureFeed'></font>, query<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves a Feature feed for the given map ID/user ID combination.<br>
+ <br>
+Args:<br>
+ map_id: A string representing the ID of the map whose features should be<br>
+ retrieved.<br>
+ user_id: An optional string representing the user ID; should be 'default'.<br>
+ <br>
+Returns:<br>
+ A gdata.maps.data.FeatureFeed.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-get_maps"><strong>get_maps</strong></a>(self, user_id<font color="#909090">='default'</font>, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.maps.data.MapFeed'></font>, **kwargs)</dt><dd><tt>Retrieves a Map feed for the given user ID.<br>
+ <br>
+Args:<br>
+ user_id: An optional string representing the user ID; should be 'default'.<br>
+ <br>
+Returns:<br>
+ A gdata.maps.data.MapFeed.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends changes to a given map or feature entry to the Maps Data servers.<br>
+ <br>
+Args:<br>
+ entry: A gdata.maps.data.Map or gdata.maps.data.Feature to be updated<br>
+ server-side.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '2'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('http://maps.google.com/maps/feeds/',)</dl>
+
+<dl><dt><strong>auth_service</strong> = 'local'</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="MapsClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ None<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as it's only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MapsClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ None<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="MapsClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as it's only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MapsClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="MapsClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-__init__"><strong>__init__</strong></a>(self, http_client<font color="#909090">=None</font>, host<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, source<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new AtomPubClient instance.<br>
+ <br>
+Args:<br>
+ source: The name of your application.<br>
+ http_client: An object capable of performing HTTP requests through a<br>
+ request method. This object is used to perform the request<br>
+ when the AtomPubClient's request method is called. Used to<br>
+ allow HTTP requests to be directed to a mock server, or use<br>
+ an alternate library instead of the default of httplib to<br>
+ make HTTP requests.<br>
+ host: str The default host name to use if a host is not specified in the<br>
+ requested URI.<br>
+ auth_token: An object which sets the HTTP Authorization header when its<br>
+ modify_request method is called.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="MapsClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>KML_CONTENT_TYPE</strong> = 'application/vnd.google-earth.kml+xml'<br>
+<strong>MAP_FEATURE_URL_TEMPLATE</strong> = 'http://maps.google.com/maps/feeds/features/%s/%s/full'<br>
+<strong>MAP_URL_TEMPLATE</strong> = 'http://maps.google.com/maps/feeds/maps/%s/full'<br>
+<strong>__author__</strong> = 'api.roman.public@google.com (Roman Nurik)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.roman.public@google.com (Roman Nurik)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.maps.html b/pydocs/gdata.maps.html
new file mode 100644
index 0000000..a75f013
--- /dev/null
+++ b/pydocs/gdata.maps.html
@@ -0,0 +1,23 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.maps</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.maps</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/lib/python2.6/dist-packages/gdata/maps/__init__.py">/usr/local/lib/python2.6/dist-packages/gdata/maps/__init__.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.maps.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.maps.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.marketplace.client.html b/pydocs/gdata.marketplace.client.html
new file mode 100644
index 0000000..e917de2
--- /dev/null
+++ b/pydocs/gdata.marketplace.client.html
@@ -0,0 +1,689 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.marketplace.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.marketplace.html"><font color="#ffffff">marketplace</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/marketplace/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/marketplace/client.py</a></font></td></tr></table>
+ <p><tt><a href="#LicensingClient">LicensingClient</a> simplifies Google Apps Marketplace Licensing API calls.<br>
+ <br>
+<a href="#LicensingClient">LicensingClient</a> extends gdata.client.<a href="gdata.client.html#GDClient">GDClient</a> to ease interaction with<br>
+the Google Apps Marketplace Licensing API. These interactions include the ability<br>
+to retrieve License informations for an application in the Google Apps Marketplace.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.marketplace.client.html#LicensingClient">LicensingClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LicensingClient">class <strong>LicensingClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Apps Marketplace Licensing API service.<br>
+ <br>
+Attributes:<br>
+ host: string The hostname for the Google Apps Marketplace Licensing API service.<br>
+ api_version: string The version of the Google Apps Marketplace Licensing API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.client.html#LicensingClient">LicensingClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="LicensingClient-GetLicense"><strong>GetLicense</strong></a> = <a href="#LicensingClient-get_license">get_license</a>(self, uri<font color="#909090">=None</font>, app_id<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="LicensingClient-GetLicenseNotifications"><strong>GetLicenseNotifications</strong></a> = <a href="#LicensingClient-get_license_notifications">get_license_notifications</a>(self, uri<font color="#909090">=None</font>, app_id<font color="#909090">=None</font>, startdatetime<font color="#909090">=None</font>, max_results<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="LicensingClient-MakeLicenseFeedUri"><strong>MakeLicenseFeedUri</strong></a> = <a href="#LicensingClient-make_license_feed_uri">make_license_feed_uri</a>(self, app_id<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="LicensingClient-MakeLicenseNotificationsFeedUri"><strong>MakeLicenseNotificationsFeedUri</strong></a> = <a href="#LicensingClient-make_license_notifications_feed_uri">make_license_notifications_feed_uri</a>(self, app_id<font color="#909090">=None</font>, startdatetime<font color="#909090">=None</font>, max_results<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="LicensingClient-__init__"><strong>__init__</strong></a>(self, domain, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a new client for the Google Apps Marketplace Licensing API.<br>
+ <br>
+Args:<br>
+ domain: string The Google Apps domain with the application installed.<br>
+ auth_token: (optional) gdata.gauth.OAuthToken which authorizes this client to retrieve the License information.<br>
+ kwargs: The other parameters to pass to the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a> constructor.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-get_license"><strong>get_license</strong></a>(self, uri<font color="#909090">=None</font>, app_id<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the application's license by application ID.<br>
+ <br>
+Args:<br>
+ uri: string The base URI of the feed from which to fetch the license.<br>
+ app_id: string The string ID of the application for which to fetch the license.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#LicensingClient-get_entry">get_entry</a>().<br>
+ <br>
+Returns:<br>
+ A License feed object representing the license with the given <br>
+ base URI and application ID.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-get_license_notifications"><strong>get_license_notifications</strong></a>(self, uri<font color="#909090">=None</font>, app_id<font color="#909090">=None</font>, startdatetime<font color="#909090">=None</font>, max_results<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the application's license notifications by application ID.<br>
+ <br>
+Args:<br>
+ uri: string The base URI of the feed from which to fetch the license.<br>
+ app_id: string The string ID of the application for which to fetch the license.<br>
+ startdatetime: Start date to retrieve the License notifications.<br>
+ max_results: Number of results per page. Maximum is 100.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>.<a href="#LicensingClient-get_entry">get_entry</a>().<br>
+ <br>
+Returns:<br>
+ A License feed object representing the license notifications with the given <br>
+ base URI and application ID.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-make_license_feed_uri"><strong>make_license_feed_uri</strong></a>(self, app_id<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt><dd><tt>Creates a license feed URI for the Google Apps Marketplace Licensing API.<br>
+ <br>
+Using this client's Google Apps domain, create a license feed URI for a particular application <br>
+in this domain. If params are provided, append them as GET params.<br>
+ <br>
+Args:<br>
+ app_id: string The ID of the application for which to make a license feed URI.<br>
+ params: dict (optional) key -> value params to append as GET vars to the<br>
+ URI. Example: params={'start': 'my-resource-id'}<br>
+Returns:<br>
+ A string giving the URI for the application's license for this client's Google<br>
+ Apps domain.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-make_license_notifications_feed_uri"><strong>make_license_notifications_feed_uri</strong></a>(self, app_id<font color="#909090">=None</font>, startdatetime<font color="#909090">=None</font>, max_results<font color="#909090">=None</font>, params<font color="#909090">=None</font>)</dt><dd><tt>Creates a license notifications feed URI for the Google Apps Marketplace Licensing API.<br>
+ <br>
+Using this client's Google Apps domain, create a license notifications feed URI for a particular application. <br>
+If params are provided, append them as GET params.<br>
+ <br>
+Args:<br>
+ app_id: string The ID of the application for which to make a license feed URI.<br>
+ startdatetime: Start date to retrieve the License notifications.<br>
+ max_results: Number of results per page. Maximum is 100.<br>
+ params: dict (optional) key -> value params to append as GET vars to the<br>
+ URI. Example: params={'start': 'my-resource-id'}<br>
+Returns:<br>
+ A string giving the URI for the application's license notifications for this client's Google<br>
+ Apps domain.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '1.0'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://apps-apis.google.com/a/feeds/user/', 'https://apps-apis.google.com/a/feeds/policies/', 'https://apps-apis.google.com/a/feeds/alias/', 'https://apps-apis.google.com/a/feeds/groups/', 'https://apps-apis.google.com/a/feeds/compliance/audit/', 'https://apps-apis.google.com/a/feeds/migration/', 'https://apps-apis.google.com/a/feeds/emailsettings/2.0/')</dl>
+
+<dl><dt><strong>auth_service</strong> = 'apps'</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="LicensingClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="LicensingClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="LicensingClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="LicensingClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="LicensingClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="LicensingClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="LicensingClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="LicensingClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="LicensingClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="LicensingClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="LicensingClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="LicensingClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="LicensingClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>LICENSE_FEED_TEMPLATE</strong> = 'http://feedserver-enterprise.googleusercontent.com/license?bq='<br>
+<strong>LICENSE_NOTIFICATIONS_FEED_TEMPLATE</strong> = 'http://feedserver-enterprise.googleusercontent.com/licensenotification?bq='<br>
+<strong>LICENSE_ROOT_URL</strong> = 'http://feedserver-enterprise.googleusercontent.com'<br>
+<strong>__author__</strong> = 'Alexandre Vivien <alex@simplecode.fr>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Alexandre Vivien <alex@simplecode.fr></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.marketplace.data.html b/pydocs/gdata.marketplace.data.html
new file mode 100644
index 0000000..52b4e2a
--- /dev/null
+++ b/pydocs/gdata.marketplace.data.html
@@ -0,0 +1,2361 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.marketplace.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.marketplace.html"><font color="#ffffff">marketplace</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/marketplace/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/marketplace/data.py</a></font></td></tr></table>
+ <p><tt>Data model for parsing and generating XML for the Google Apps Marketplace Licensing API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#CustomerId">CustomerId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#DomainName">DomainName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#Enabled">Enabled</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#Entity">Entity</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#Id">Id</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#InstallerEmail">InstallerEmail</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#LastChangeTime">LastChangeTime</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#ProductConfigId">ProductConfigId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#State">State</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#TosAcceptanceTime">TosAcceptanceTime</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Content">atom.data.Content</a>(<a href="atom.data.html#Text">atom.data.Text</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#Content">Content</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#LicenseEntry">LicenseEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.marketplace.data.html#LicenseFeed">LicenseFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Content">class <strong>Content</strong></a>(<a href="atom.data.html#Content">atom.data.Content</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#Content">Content</a></dd>
+<dd><a href="atom.data.html#Content">atom.data.Content</a></dd>
+<dd><a href="atom.data.html#Text">atom.data.Text</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entity</strong> = <class 'gdata.marketplace.data.Entity'><dd><tt>The entity representing the License.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Content">atom.data.Content</a>:<br>
+<dl><dt><strong>src</strong> = 'src'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Text">atom.data.Text</a>:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Content-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Content-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Content-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Content-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Content-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Content-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CustomerId">class <strong>CustomerId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#CustomerId">CustomerId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CustomerId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomerId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomerId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CustomerId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomerId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CustomerId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CustomerId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CustomerId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CustomerId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CustomerId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DomainName">class <strong>DomainName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#DomainName">DomainName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="DomainName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DomainName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DomainName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DomainName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DomainName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="DomainName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="DomainName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DomainName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="DomainName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="DomainName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Enabled">class <strong>Enabled</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#Enabled">Enabled</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Enabled-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Enabled-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Enabled-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Enabled-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Enabled-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Enabled-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Enabled-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Enabled-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Enabled-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Enabled-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Entity">class <strong>Entity</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The entity representing the License.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#Entity">Entity</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>customer_id</strong> = <class 'gdata.marketplace.data.CustomerId'><dd><tt></tt></dl>
+
+<dl><dt><strong>domain_name</strong> = <class 'gdata.marketplace.data.DomainName'><dd><tt></tt></dl>
+
+<dl><dt><strong>enabled</strong> = <class 'gdata.marketplace.data.Enabled'><dd><tt></tt></dl>
+
+<dl><dt><strong>id</strong> = <class 'gdata.marketplace.data.Id'><dd><tt></tt></dl>
+
+<dl><dt><strong>installer_email</strong> = <class 'gdata.marketplace.data.InstallerEmail'><dd><tt></tt></dl>
+
+<dl><dt><strong>last_change_time</strong> = <class 'gdata.marketplace.data.LastChangeTime'><dd><tt></tt></dl>
+
+<dl><dt><strong>product_config_id</strong> = <class 'gdata.marketplace.data.ProductConfigId'><dd><tt></tt></dl>
+
+<dl><dt><strong>state</strong> = <class 'gdata.marketplace.data.State'><dd><tt></tt></dl>
+
+<dl><dt><strong>tos_acceptance_time</strong> = <class 'gdata.marketplace.data.TosAcceptanceTime'><dd><tt></tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Entity-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Entity-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Entity-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Entity-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Entity-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Entity-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Entity-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Entity-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Entity-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Entity-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Id">class <strong>Id</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#Id">Id</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Id-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Id-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Id-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Id-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Id-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Id-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Id-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Id-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Id-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Id-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="InstallerEmail">class <strong>InstallerEmail</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#InstallerEmail">InstallerEmail</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="InstallerEmail-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InstallerEmail-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InstallerEmail-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InstallerEmail-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InstallerEmail-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="InstallerEmail-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="InstallerEmail-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InstallerEmail-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InstallerEmail-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InstallerEmail-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LastChangeTime">class <strong>LastChangeTime</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#LastChangeTime">LastChangeTime</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="LastChangeTime-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastChangeTime-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastChangeTime-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LastChangeTime-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastChangeTime-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="LastChangeTime-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="LastChangeTime-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LastChangeTime-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LastChangeTime-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastChangeTime-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LicenseEntry">class <strong>LicenseEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a <a href="#LicenseEntry">LicenseEntry</a> object.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#LicenseEntry">LicenseEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>content</strong> = <class 'gdata.marketplace.data.Content'></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="LicenseEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="LicenseEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="LicenseEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="LicenseEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="LicenseEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="LicenseEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LicenseFeed">class <strong>LicenseFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of <a href="#LicenseEntry">LicenseEntry</a> objects.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#LicenseFeed">LicenseFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.marketplace.data.LicenseEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="LicenseFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="LicenseFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="LicenseFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="LicenseFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="LicenseFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="LicenseFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LicenseFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProductConfigId">class <strong>ProductConfigId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#ProductConfigId">ProductConfigId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ProductConfigId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductConfigId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductConfigId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductConfigId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductConfigId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ProductConfigId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProductConfigId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ProductConfigId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ProductConfigId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ProductConfigId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="State">class <strong>State</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#State">State</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="State-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="State-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="State-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="State-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="State-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="State-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="State-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="State-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="State-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="State-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TosAcceptanceTime">class <strong>TosAcceptanceTime</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.marketplace.data.html#TosAcceptanceTime">TosAcceptanceTime</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TosAcceptanceTime-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TosAcceptanceTime-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TosAcceptanceTime-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TosAcceptanceTime-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TosAcceptanceTime-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TosAcceptanceTime-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TosAcceptanceTime-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TosAcceptanceTime-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TosAcceptanceTime-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TosAcceptanceTime-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>LICENSES_NAMESPACE</strong> = 'http://www.w3.org/2005/Atom'<br>
+<strong>LICENSES_TEMPLATE</strong> = '{http://www.w3.org/2005/Atom}%s'<br>
+<strong>__author__</strong> = 'Alexandre Vivien <alex@simplecode.fr>'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">Alexandre Vivien <alex@simplecode.fr></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.marketplace.html b/pydocs/gdata.marketplace.html
new file mode 100644
index 0000000..8b676b6
--- /dev/null
+++ b/pydocs/gdata.marketplace.html
@@ -0,0 +1,23 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.marketplace</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.marketplace</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/marketplace/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/marketplace/__init__.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.marketplace.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.marketplace.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.media.data.html b/pydocs/gdata.media.data.html
new file mode 100644
index 0000000..1c4b809
--- /dev/null
+++ b/pydocs/gdata.media.data.html
@@ -0,0 +1,2249 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.media.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.media.html"><font color="#ffffff">media</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/media/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/media/data.py</a></font></td></tr></table>
+ <p><tt>Contains the data classes of the Yahoo! Media RSS Extension</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaCategory">MediaCategory</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaContent">MediaContent</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaCopyright">MediaCopyright</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaCredit">MediaCredit</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaDescription">MediaDescription</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaGroup">MediaGroup</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaHash">MediaHash</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaKeywords">MediaKeywords</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaPlayer">MediaPlayer</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaRating">MediaRating</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaRestriction">MediaRestriction</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaText">MediaText</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaThumbnail">MediaThumbnail</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaTitle">MediaTitle</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaCategory">class <strong>MediaCategory</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media category.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaCategory">MediaCategory</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>label</strong> = 'label'</dl>
+
+<dl><dt><strong>scheme</strong> = 'scheme'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaCategory-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCategory-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCategory-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaCategory-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCategory-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaCategory-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaCategory-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaCategory-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaCategory-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCategory-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaContent">class <strong>MediaContent</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media content.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaContent">MediaContent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>bitrate</strong> = 'bitrate'</dl>
+
+<dl><dt><strong>category</strong> = [<class 'gdata.media.data.MediaCategory'>]</dl>
+
+<dl><dt><strong>channels</strong> = 'channels'</dl>
+
+<dl><dt><strong>copyright</strong> = <class 'gdata.media.data.MediaCopyright'><dd><tt>Describes a media copyright.</tt></dl>
+
+<dl><dt><strong>credit</strong> = [<class 'gdata.media.data.MediaCredit'>]</dl>
+
+<dl><dt><strong>description</strong> = <class 'gdata.media.data.MediaDescription'><dd><tt>Describes a media description.</tt></dl>
+
+<dl><dt><strong>duration</strong> = 'duration'</dl>
+
+<dl><dt><strong>expression</strong> = 'expression'</dl>
+
+<dl><dt><strong>file_size</strong> = 'fileSize'</dl>
+
+<dl><dt><strong>framerate</strong> = 'framerate'</dl>
+
+<dl><dt><strong>hash</strong> = <class 'gdata.media.data.MediaHash'><dd><tt>Describes a media hash.</tt></dl>
+
+<dl><dt><strong>height</strong> = 'height'</dl>
+
+<dl><dt><strong>is_default</strong> = 'isDefault'</dl>
+
+<dl><dt><strong>keywords</strong> = <class 'gdata.media.data.MediaKeywords'><dd><tt>Describes a media keywords.</tt></dl>
+
+<dl><dt><strong>language</strong> = 'language'</dl>
+
+<dl><dt><strong>medium</strong> = 'medium'</dl>
+
+<dl><dt><strong>player</strong> = <class 'gdata.media.data.MediaPlayer'><dd><tt>Describes a media player.</tt></dl>
+
+<dl><dt><strong>rating</strong> = [<class 'gdata.media.data.MediaRating'>]</dl>
+
+<dl><dt><strong>restriction</strong> = [<class 'gdata.media.data.MediaRestriction'>]</dl>
+
+<dl><dt><strong>samplingrate</strong> = 'samplingrate'</dl>
+
+<dl><dt><strong>text</strong> = [<class 'gdata.media.data.MediaText'>]</dl>
+
+<dl><dt><strong>thumbnail</strong> = [<class 'gdata.media.data.MediaThumbnail'>]</dl>
+
+<dl><dt><strong>title</strong> = <class 'gdata.media.data.MediaTitle'><dd><tt>Describes a media title.</tt></dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<dl><dt><strong>url</strong> = 'url'</dl>
+
+<dl><dt><strong>width</strong> = 'width'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaContent-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaContent-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaContent-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaContent-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaContent-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaContent-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaContent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaContent-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaContent-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaContent-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaCopyright">class <strong>MediaCopyright</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media copyright.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaCopyright">MediaCopyright</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>url</strong> = 'url'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaCopyright-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCopyright-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCopyright-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaCopyright-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCopyright-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaCopyright-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaCopyright-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaCopyright-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaCopyright-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCopyright-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaCredit">class <strong>MediaCredit</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media credit.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaCredit">MediaCredit</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>role</strong> = 'role'</dl>
+
+<dl><dt><strong>scheme</strong> = 'scheme'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaCredit-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCredit-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCredit-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaCredit-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCredit-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaCredit-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaCredit-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaCredit-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaCredit-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaCredit-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaDescription">class <strong>MediaDescription</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media description.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaDescription">MediaDescription</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaDescription-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaDescription-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaDescription-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaDescription-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaDescription-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaDescription-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaDescription-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaDescription-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaDescription-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaDescription-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaGroup">class <strong>MediaGroup</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media group.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaGroup">MediaGroup</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>category</strong> = [<class 'gdata.media.data.MediaCategory'>]</dl>
+
+<dl><dt><strong>content</strong> = [<class 'gdata.media.data.MediaContent'>]</dl>
+
+<dl><dt><strong>copyright</strong> = <class 'gdata.media.data.MediaCopyright'><dd><tt>Describes a media copyright.</tt></dl>
+
+<dl><dt><strong>credit</strong> = [<class 'gdata.media.data.MediaCredit'>]</dl>
+
+<dl><dt><strong>description</strong> = <class 'gdata.media.data.MediaDescription'><dd><tt>Describes a media description.</tt></dl>
+
+<dl><dt><strong>hash</strong> = <class 'gdata.media.data.MediaHash'><dd><tt>Describes a media hash.</tt></dl>
+
+<dl><dt><strong>keywords</strong> = <class 'gdata.media.data.MediaKeywords'><dd><tt>Describes a media keywords.</tt></dl>
+
+<dl><dt><strong>player</strong> = <class 'gdata.media.data.MediaPlayer'><dd><tt>Describes a media player.</tt></dl>
+
+<dl><dt><strong>rating</strong> = [<class 'gdata.media.data.MediaRating'>]</dl>
+
+<dl><dt><strong>restriction</strong> = [<class 'gdata.media.data.MediaRestriction'>]</dl>
+
+<dl><dt><strong>text</strong> = [<class 'gdata.media.data.MediaText'>]</dl>
+
+<dl><dt><strong>thumbnail</strong> = [<class 'gdata.media.data.MediaThumbnail'>]</dl>
+
+<dl><dt><strong>title</strong> = <class 'gdata.media.data.MediaTitle'><dd><tt>Describes a media title.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaGroup-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaGroup-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaGroup-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaGroup-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaGroup-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaGroup-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaGroup-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaGroup-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaGroup-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaGroup-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaHash">class <strong>MediaHash</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media hash.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaHash">MediaHash</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>algo</strong> = 'algo'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaHash-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaHash-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaHash-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaHash-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaHash-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaHash-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaHash-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaHash-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaHash-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaHash-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaKeywords">class <strong>MediaKeywords</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media keywords.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaKeywords">MediaKeywords</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaKeywords-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaKeywords-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaKeywords-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaKeywords-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaKeywords-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaKeywords-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaKeywords-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaKeywords-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaKeywords-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaKeywords-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaPlayer">class <strong>MediaPlayer</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media player.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaPlayer">MediaPlayer</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>height</strong> = 'height'</dl>
+
+<dl><dt><strong>url</strong> = 'url'</dl>
+
+<dl><dt><strong>width</strong> = 'width'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaPlayer-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaPlayer-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaPlayer-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaPlayer-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaPlayer-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaPlayer-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaPlayer-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaPlayer-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaPlayer-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaPlayer-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaRating">class <strong>MediaRating</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media rating.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaRating">MediaRating</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>scheme</strong> = 'scheme'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaRating-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaRating-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaRating-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaRating-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaRating-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaRating-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaRating-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaRating-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaRating-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaRating-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaRestriction">class <strong>MediaRestriction</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media restriction.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaRestriction">MediaRestriction</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>relationship</strong> = 'relationship'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaRestriction-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaRestriction-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaRestriction-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaRestriction-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaRestriction-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaRestriction-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaRestriction-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaRestriction-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaRestriction-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaRestriction-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaText">class <strong>MediaText</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media text.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaText">MediaText</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>end</strong> = 'end'</dl>
+
+<dl><dt><strong>lang</strong> = 'lang'</dl>
+
+<dl><dt><strong>start</strong> = 'start'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaText-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaText-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaText-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaText-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaText-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaText-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaText-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaText-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaText-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaText-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaThumbnail">class <strong>MediaThumbnail</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media thumbnail.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaThumbnail">MediaThumbnail</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>height</strong> = 'height'</dl>
+
+<dl><dt><strong>time</strong> = 'time'</dl>
+
+<dl><dt><strong>url</strong> = 'url'</dl>
+
+<dl><dt><strong>width</strong> = 'width'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaThumbnail-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaThumbnail-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaThumbnail-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaThumbnail-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaThumbnail-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaThumbnail-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaThumbnail-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaThumbnail-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaThumbnail-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaThumbnail-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaTitle">class <strong>MediaTitle</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a media title.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.data.html#MediaTitle">MediaTitle</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MediaTitle-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaTitle-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaTitle-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaTitle-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaTitle-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaTitle-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MediaTitle-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MediaTitle-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MediaTitle-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MediaTitle-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>MEDIA_TEMPLATE</strong> = '{http://search.yahoo.com/mrss//}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.media.html b/pydocs/gdata.media.html
new file mode 100644
index 0000000..89ab593
--- /dev/null
+++ b/pydocs/gdata.media.html
@@ -0,0 +1,798 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.media</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.media</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/media/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/media/__init__.py</a></font></td></tr></table>
+ <p><tt>Essential attributes of photos in Google Photos/Picasa Web Albums are <br>
+expressed using elements from the `media' namespace, defined in the <br>
+MediaRSS specification[1].<br>
+ <br>
+Due to copyright issues, the elements herein are documented sparingly, please <br>
+consult with the Google Photos API Reference Guide[2], alternatively the <br>
+official MediaRSS specification[1] for details. <br>
+(If there is a version conflict between the two sources, stick to the <br>
+Google Photos API).<br>
+ <br>
+[1]: <a href="http://search.yahoo.com/mrss">http://search.yahoo.com/mrss</a> (version 1.1.1)<br>
+[2]: <a href="http://code.google.com/apis/picasaweb/reference.html#media_reference">http://code.google.com/apis/picasaweb/reference.html#media_reference</a><br>
+ <br>
+Keep in mind that Google Photos only uses a subset of the MediaRSS elements <br>
+(and some of the attributes are trimmed down, too): <br>
+ <br>
+media:content<br>
+media:credit<br>
+media:description<br>
+media:group<br>
+media:keywords<br>
+media:thumbnail<br>
+media:title</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.media.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.media.html#Duration">Duration</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.media.html#Category">Category</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.html#Content">Content</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.html#Credit">Credit</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.html#Description">Description</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.html#Group">Group</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.html#Keywords">Keywords</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.html#Player">Player</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.html#Thumbnail">Thumbnail</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.media.html#Title">Title</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.media.html#Private">Private</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Category">class <strong>Category</strong></a>(<a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The mediagroup:category element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#Category">Category</a></dd>
+<dd><a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Category-__init__"><strong>__init__</strong></a>(self, term<font color="#909090">=None</font>, scheme<font color="#909090">=None</font>, label<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Category">Category</a><br>
+ <br>
+Args:<br>
+ term: str<br>
+ scheme: str<br>
+ label: str<br>
+ text: str The text data in the this element<br>
+ extension_elements: list A list of ExtensionElement instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Category-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Category-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Category-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Content">class <strong>Content</strong></a>(<a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(attribute container) This element describes the original content,<br>
+ e.g. an image or a video. There may be multiple <a href="#Content">Content</a> elements<br>
+ in a media:<a href="#Group">Group</a>.<br>
+ <br>
+ For example, a video may have a<br>
+ <media:content medium="image"> element that specifies a JPEG<br>
+ representation of the video, and a <media:content medium="video"><br>
+ element that specifies the URL of the video itself.<br>
+ <br>
+Attributes:<br>
+ url: non-ambigous reference to online object<br>
+ width: width of the object frame, in pixels<br>
+ height: width of the object frame, in pixels<br>
+ medium: one of `image' or `video', allowing the api user to quickly<br>
+ determine the object's type<br>
+ type: Internet media Type[1] (a.k.a. mime type) of the object -- a more<br>
+ verbose way of determining the media type. To set the type member<br>
+ in the contructor, use the content_type parameter.<br>
+ (optional) fileSize: the size of the object, in bytes<br>
+ <br>
+[1]: <a href="http://en.wikipedia.org/wiki/Internet_media_type">http://en.wikipedia.org/wiki/Internet_media_type</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#Content">Content</a></dd>
+<dd><a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Content-__init__"><strong>__init__</strong></a>(self, url<font color="#909090">=None</font>, width<font color="#909090">=None</font>, height<font color="#909090">=None</font>, medium<font color="#909090">=None</font>, content_type<font color="#909090">=None</font>, fileSize<font color="#909090">=None</font>, format<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Content-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Content-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Content-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Credit">class <strong>Credit</strong></a>(<a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(string) Contains the nickname of the user who created the content,<br>
+e.g. `Liz Bennet'.<br>
+ <br>
+This is a user-specified value that should be used when referring to<br>
+the user by name.<br>
+ <br>
+Note that none of the attributes from the MediaRSS spec are supported.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#Credit">Credit</a></dd>
+<dd><a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>:<br>
+<dl><dt><a name="Credit-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Credit-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Credit-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Credit-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Description">class <strong>Description</strong></a>(<a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(string) A description of the media object.<br>
+Either plain unicode text, or entity-encoded html (look at the `type'<br>
+attribute).<br>
+ <br>
+E.g `A set of photographs I took while vacationing in Italy.'<br>
+ <br>
+For `api' projections, the description is in plain text;<br>
+for `base' projections, the description is in HTML.<br>
+ <br>
+Attributes:<br>
+ type: either `text' or `html'. To set the type member in the contructor,<br>
+ use the description_type parameter.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#Description">Description</a></dd>
+<dd><a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Description-__init__"><strong>__init__</strong></a>(self, description_type<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Description-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Description-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Description-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Duration">class <strong>Duration</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Duration">Duration</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#Duration">Duration</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Duration-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Duration-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Duration-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Duration-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Group">class <strong>Group</strong></a>(<a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Container element for all media elements.<br>
+The <media:group> element can appear as a child of an album, photo or <br>
+video entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#Group">Group</a></dd>
+<dd><a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Group-__init__"><strong>__init__</strong></a>(self, content<font color="#909090">=None</font>, credit<font color="#909090">=None</font>, description<font color="#909090">=None</font>, keywords<font color="#909090">=None</font>, thumbnail<font color="#909090">=None</font>, title<font color="#909090">=None</font>, duration<font color="#909090">=None</font>, private<font color="#909090">=None</font>, category<font color="#909090">=None</font>, player<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Group-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Group-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Group-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Keywords">class <strong>Keywords</strong></a>(<a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(string) Lists the tags associated with the entry,<br>
+e.g `italy, vacation, sunset'.<br>
+ <br>
+Contains a comma-separated list of tags that have been added to the photo, or<br>
+all tags that have been added to photos in the album.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#Keywords">Keywords</a></dd>
+<dd><a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>:<br>
+<dl><dt><a name="Keywords-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Keywords-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Keywords-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Keywords-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MediaBaseElement">class <strong>MediaBaseElement</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Base class for elements in the MEDIA_NAMESPACE. <br>
+To add new elements, you only need to add the element tag name to self.<strong>_tag</strong><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="MediaBaseElement-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="MediaBaseElement-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="MediaBaseElement-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="MediaBaseElement-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Player">class <strong>Player</strong></a>(<a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(string) Contains the embeddable player URL for the entry's media content <br>
+if the media is a video.<br>
+ <br>
+Attributes:<br>
+url: Always set to plain<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#Player">Player</a></dd>
+<dd><a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Player-__init__"><strong>__init__</strong></a>(self, player_url<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Player-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Player-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Player-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Private">class <strong>Private</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Private">Private</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#Private">Private</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Private-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Private-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Private-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Private-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Thumbnail">class <strong>Thumbnail</strong></a>(<a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(attributes) Contains the URL of a thumbnail of a photo or album cover.<br>
+ <br>
+There can be multiple <media:thumbnail> elements for a given <media:group>; <br>
+for example, a given item may have multiple thumbnails at different sizes. <br>
+Photos generally have two thumbnails at different sizes; <br>
+albums generally have one cropped thumbnail. <br>
+ <br>
+If the thumbsize parameter is set to the initial query, this element points <br>
+to thumbnails of the requested sizes; otherwise the thumbnails are the <br>
+default thumbnail size. <br>
+ <br>
+This element must not be confused with the <gphoto:thumbnail> element.<br>
+ <br>
+Attributes:<br>
+url: The URL of the thumbnail image.<br>
+height: The height of the thumbnail image, in pixels.<br>
+width: The width of the thumbnail image, in pixels.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#Thumbnail">Thumbnail</a></dd>
+<dd><a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Thumbnail-__init__"><strong>__init__</strong></a>(self, url<font color="#909090">=None</font>, width<font color="#909090">=None</font>, height<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Thumbnail-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Thumbnail-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Thumbnail-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Title">class <strong>Title</strong></a>(<a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>(string) Contains the title of the entry's media content, in plain text.<br>
+ <br>
+Attributes:<br>
+ type: Always set to plain. To set the type member in the constructor, use<br>
+ the title_type parameter.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.media.html#Title">Title</a></dd>
+<dd><a href="gdata.media.html#MediaBaseElement">MediaBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Title-__init__"><strong>__init__</strong></a>(self, title_type<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Title-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Title-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Title-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-ContentFromString"><strong>ContentFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CreditFromString"><strong>CreditFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-DescriptionFromString"><strong>DescriptionFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-GroupFromString"><strong>GroupFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-KeywordsFromString"><strong>KeywordsFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ThumbnailFromString"><strong>ThumbnailFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TitleFromString"><strong>TitleFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>MEDIA_NAMESPACE</strong> = 'http://search.yahoo.com/mrss/'<br>
+<strong>YOUTUBE_NAMESPACE</strong> = 'http://gdata.youtube.com/schemas/2007'<br>
+<strong>__author__</strong> = u'havard@gulldahl.no'<br>
+<strong>__license__</strong> = 'Apache License v2'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">havard@gulldahl.no</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.notebook.data.html b/pydocs/gdata.notebook.data.html
new file mode 100644
index 0000000..988f8c2
--- /dev/null
+++ b/pydocs/gdata.notebook.data.html
@@ -0,0 +1,1533 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.notebook.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.notebook.html"><font color="#ffffff">notebook</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/notebook/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/notebook/data.py</a></font></td></tr></table>
+ <p><tt>Contains the data classes of the Google Notebook Data API</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.notebook.data.html#ComesAfter">ComesAfter</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.notebook.data.html#NoteEntry">NoteEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.notebook.data.html#NotebookListEntry">NotebookListEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.notebook.data.html#NotebookFeed">NotebookFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.notebook.data.html#NotebookListFeed">NotebookListFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ComesAfter">class <strong>ComesAfter</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Preceding element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.notebook.data.html#ComesAfter">ComesAfter</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>id</strong> = 'id'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ComesAfter-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComesAfter-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComesAfter-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ComesAfter-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComesAfter-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ComesAfter-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ComesAfter-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComesAfter-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ComesAfter-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComesAfter-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NoteEntry">class <strong>NoteEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a note entry in the feed of a user's notebook.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.notebook.data.html#NoteEntry">NoteEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="NoteEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="NoteEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="NoteEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="NoteEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="NoteEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NoteEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NoteEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NotebookFeed">class <strong>NotebookFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a notebook feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.notebook.data.html#NotebookFeed">NotebookFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.notebook.data.NoteEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="NotebookFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="NotebookFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="NotebookFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="NotebookFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="NotebookFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NotebookFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NotebookListEntry">class <strong>NotebookListEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a note list entry in the feed of a user's list of public notebooks.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.notebook.data.html#NotebookListEntry">NotebookListEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="NotebookListEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="NotebookListEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="NotebookListEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="NotebookListEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="NotebookListEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NotebookListFeed">class <strong>NotebookListFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a notebook list feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.notebook.data.html#NotebookListFeed">NotebookListFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.notebook.data.NotebookListEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="NotebookListFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="NotebookListFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="NotebookListFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="NotebookListFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="NotebookListFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="NotebookListFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="NotebookListFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>NB_TEMPLATE</strong> = '{http://schemas.google.com/notes/2008/}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.notebook.html b/pydocs/gdata.notebook.html
new file mode 100644
index 0000000..71f2377
--- /dev/null
+++ b/pydocs/gdata.notebook.html
@@ -0,0 +1,34 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.notebook</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.notebook</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/notebook/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/notebook/__init__.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.notebook.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.oauth.html b/pydocs/gdata.oauth.html
new file mode 100644
index 0000000..84f13bb
--- /dev/null
+++ b/pydocs/gdata.oauth.html
@@ -0,0 +1,476 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.oauth</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.oauth</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/oauth/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/oauth/__init__.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.oauth.rsa.html">rsa</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.oauth.html#OAuthClient">OAuthClient</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.oauth.html#OAuthConsumer">OAuthConsumer</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.oauth.html#OAuthDataStore">OAuthDataStore</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.oauth.html#OAuthRequest">OAuthRequest</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.oauth.html#OAuthServer">OAuthServer</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.oauth.html#OAuthSignatureMethod">OAuthSignatureMethod</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.oauth.html#OAuthSignatureMethod_HMAC_SHA1">OAuthSignatureMethod_HMAC_SHA1</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.oauth.html#OAuthSignatureMethod_PLAINTEXT">OAuthSignatureMethod_PLAINTEXT</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.oauth.html#OAuthToken">OAuthToken</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#RuntimeError">exceptions.RuntimeError</a>(<a href="exceptions.html#StandardError">exceptions.StandardError</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.oauth.html#OAuthError">OAuthError</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthClient">class <strong>OAuthClient</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt># <a href="#OAuthClient">OAuthClient</a> is a worker to attempt to execute a request<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="OAuthClient-__init__"><strong>__init__</strong></a>(self, oauth_consumer, oauth_token)</dt></dl>
+
+<dl><dt><a name="OAuthClient-access_resource"><strong>access_resource</strong></a>(self, oauth_request)</dt></dl>
+
+<dl><dt><a name="OAuthClient-fetch_access_token"><strong>fetch_access_token</strong></a>(self, oauth_request)</dt></dl>
+
+<dl><dt><a name="OAuthClient-fetch_request_token"><strong>fetch_request_token</strong></a>(self, oauth_request)</dt></dl>
+
+<dl><dt><a name="OAuthClient-get_consumer"><strong>get_consumer</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OAuthClient-get_token"><strong>get_token</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>consumer</strong> = None</dl>
+
+<dl><dt><strong>token</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthConsumer">class <strong>OAuthConsumer</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt># <a href="#OAuthConsumer">OAuthConsumer</a> is a data type that represents the identity of the Consumer<br>
+# via its shared secret with the Service Provider.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="OAuthConsumer-__init__"><strong>__init__</strong></a>(self, key, secret)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>key</strong> = None</dl>
+
+<dl><dt><strong>secret</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthDataStore">class <strong>OAuthDataStore</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt># <a href="#OAuthDataStore">OAuthDataStore</a> is a database abstraction used to lookup consumers and tokens<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="OAuthDataStore-authorize_request_token"><strong>authorize_request_token</strong></a>(self, oauth_token, user)</dt></dl>
+
+<dl><dt><a name="OAuthDataStore-fetch_access_token"><strong>fetch_access_token</strong></a>(self, oauth_consumer, oauth_token)</dt></dl>
+
+<dl><dt><a name="OAuthDataStore-fetch_request_token"><strong>fetch_request_token</strong></a>(self, oauth_consumer)</dt></dl>
+
+<dl><dt><a name="OAuthDataStore-lookup_consumer"><strong>lookup_consumer</strong></a>(self, key)</dt></dl>
+
+<dl><dt><a name="OAuthDataStore-lookup_nonce"><strong>lookup_nonce</strong></a>(self, oauth_consumer, oauth_token, nonce, timestamp)</dt></dl>
+
+<dl><dt><a name="OAuthDataStore-lookup_token"><strong>lookup_token</strong></a>(self, oauth_consumer, token_type, token_token)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthError">class <strong>OAuthError</strong></a>(<a href="exceptions.html#RuntimeError">exceptions.RuntimeError</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt># Generic exception class<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.oauth.html#OAuthError">OAuthError</a></dd>
+<dd><a href="exceptions.html#RuntimeError">exceptions.RuntimeError</a></dd>
+<dd><a href="exceptions.html#StandardError">exceptions.StandardError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OAuthError-__init__"><strong>__init__</strong></a>(self, message<font color="#909090">='OAuth error occured.'</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#RuntimeError">exceptions.RuntimeError</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#OAuthError-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="OAuthError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuthError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="OAuthError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuthError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="OAuthError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuthError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="OAuthError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuthError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="OAuthError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="OAuthError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuthError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="OAuthError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuthError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="OAuthError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="OAuthError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#OAuthError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="OAuthError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthRequest">class <strong>OAuthRequest</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>OAuth parameters:<br>
+ - oauth_consumer_key <br>
+ - oauth_token<br>
+ - oauth_signature_method<br>
+ - oauth_signature <br>
+ - oauth_timestamp <br>
+ - oauth_nonce<br>
+ - oauth_version<br>
+ ... any additional parameters, as defined by the Service Provider.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="OAuthRequest-__init__"><strong>__init__</strong></a>(self, http_method<font color="#909090">='GET'</font>, http_url<font color="#909090">=None</font>, parameters<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OAuthRequest-build_signature"><strong>build_signature</strong></a>(self, signature_method, consumer, token)</dt></dl>
+
+<dl><dt><a name="OAuthRequest-get_nonoauth_parameters"><strong>get_nonoauth_parameters</strong></a>(self)</dt><dd><tt># get any non-oauth parameters</tt></dd></dl>
+
+<dl><dt><a name="OAuthRequest-get_normalized_http_method"><strong>get_normalized_http_method</strong></a>(self)</dt><dd><tt># just uppercases the http method</tt></dd></dl>
+
+<dl><dt><a name="OAuthRequest-get_normalized_http_url"><strong>get_normalized_http_url</strong></a>(self)</dt><dd><tt># parses the url and rebuilds it to be scheme://host/path</tt></dd></dl>
+
+<dl><dt><a name="OAuthRequest-get_normalized_parameters"><strong>get_normalized_parameters</strong></a>(self)</dt><dd><tt># return a string that consists of all the parameters that need to be signed</tt></dd></dl>
+
+<dl><dt><a name="OAuthRequest-get_parameter"><strong>get_parameter</strong></a>(self, parameter)</dt></dl>
+
+<dl><dt><a name="OAuthRequest-set_parameter"><strong>set_parameter</strong></a>(self, parameter, value)</dt></dl>
+
+<dl><dt><a name="OAuthRequest-sign_request"><strong>sign_request</strong></a>(self, signature_method, consumer, token)</dt><dd><tt># set the signature parameter to the result of build_signature</tt></dd></dl>
+
+<dl><dt><a name="OAuthRequest-to_header"><strong>to_header</strong></a>(self, realm<font color="#909090">=''</font>)</dt><dd><tt># serialize as a header for an HTTPAuth request</tt></dd></dl>
+
+<dl><dt><a name="OAuthRequest-to_postdata"><strong>to_postdata</strong></a>(self)</dt><dd><tt># serialize as post data for a POST request</tt></dd></dl>
+
+<dl><dt><a name="OAuthRequest-to_url"><strong>to_url</strong></a>(self)</dt><dd><tt># serialize as a url for a GET request</tt></dd></dl>
+
+<hr>
+Static methods defined here:<br>
+<dl><dt><a name="OAuthRequest-from_consumer_and_token"><strong>from_consumer_and_token</strong></a>(oauth_consumer, token<font color="#909090">=None</font>, http_method<font color="#909090">='GET'</font>, http_url<font color="#909090">=None</font>, parameters<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OAuthRequest-from_request"><strong>from_request</strong></a>(http_method, http_url, headers<font color="#909090">=None</font>, parameters<font color="#909090">=None</font>, query_string<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OAuthRequest-from_token_and_callback"><strong>from_token_and_callback</strong></a>(token, callback<font color="#909090">=None</font>, http_method<font color="#909090">='GET'</font>, http_url<font color="#909090">=None</font>, parameters<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>http_method</strong> = 'GET'</dl>
+
+<dl><dt><strong>http_url</strong> = None</dl>
+
+<dl><dt><strong>parameters</strong> = None</dl>
+
+<dl><dt><strong>version</strong> = '1.0'</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthServer">class <strong>OAuthServer</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt># <a href="#OAuthServer">OAuthServer</a> is a worker to check a requests validity against a data store<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="OAuthServer-__init__"><strong>__init__</strong></a>(self, data_store<font color="#909090">=None</font>, signature_methods<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="OAuthServer-add_signature_method"><strong>add_signature_method</strong></a>(self, signature_method)</dt></dl>
+
+<dl><dt><a name="OAuthServer-authorize_token"><strong>authorize_token</strong></a>(self, token, user)</dt><dd><tt># authorize a request token</tt></dd></dl>
+
+<dl><dt><a name="OAuthServer-build_authenticate_header"><strong>build_authenticate_header</strong></a>(self, realm<font color="#909090">=''</font>)</dt><dd><tt># optional support for the authenticate header</tt></dd></dl>
+
+<dl><dt><a name="OAuthServer-fetch_access_token"><strong>fetch_access_token</strong></a>(self, oauth_request)</dt><dd><tt># process an access_token request<br>
+# returns the access token on success</tt></dd></dl>
+
+<dl><dt><a name="OAuthServer-fetch_request_token"><strong>fetch_request_token</strong></a>(self, oauth_request)</dt><dd><tt># process a request_token request<br>
+# returns the request token on success</tt></dd></dl>
+
+<dl><dt><a name="OAuthServer-get_callback"><strong>get_callback</strong></a>(self, oauth_request)</dt><dd><tt># get the callback url</tt></dd></dl>
+
+<dl><dt><a name="OAuthServer-get_data_store"><strong>get_data_store</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OAuthServer-set_data_store"><strong>set_data_store</strong></a>(self, oauth_data_store)</dt></dl>
+
+<dl><dt><a name="OAuthServer-verify_request"><strong>verify_request</strong></a>(self, oauth_request)</dt><dd><tt># verify an api call, checks all the parameters</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>data_store</strong> = None</dl>
+
+<dl><dt><strong>signature_methods</strong> = None</dl>
+
+<dl><dt><strong>timestamp_threshold</strong> = 300</dl>
+
+<dl><dt><strong>version</strong> = '1.0'</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthSignatureMethod">class <strong>OAuthSignatureMethod</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt># <a href="#OAuthSignatureMethod">OAuthSignatureMethod</a> is a strategy class that implements a signature method<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="OAuthSignatureMethod-build_signature"><strong>build_signature</strong></a>(self, oauth_request, oauth_consumer, oauth_token)</dt></dl>
+
+<dl><dt><a name="OAuthSignatureMethod-build_signature_base_string"><strong>build_signature_base_string</strong></a>(self, oauth_request, oauth_consumer, oauth_token)</dt></dl>
+
+<dl><dt><a name="OAuthSignatureMethod-check_signature"><strong>check_signature</strong></a>(self, oauth_request, consumer, token, signature)</dt></dl>
+
+<dl><dt><a name="OAuthSignatureMethod-get_name"><strong>get_name</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthSignatureMethod_HMAC_SHA1">class <strong>OAuthSignatureMethod_HMAC_SHA1</strong></a>(<a href="gdata.oauth.html#OAuthSignatureMethod">OAuthSignatureMethod</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.oauth.html#OAuthSignatureMethod_HMAC_SHA1">OAuthSignatureMethod_HMAC_SHA1</a></dd>
+<dd><a href="gdata.oauth.html#OAuthSignatureMethod">OAuthSignatureMethod</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OAuthSignatureMethod_HMAC_SHA1-build_signature"><strong>build_signature</strong></a>(self, oauth_request, consumer, token)</dt></dl>
+
+<dl><dt><a name="OAuthSignatureMethod_HMAC_SHA1-build_signature_base_string"><strong>build_signature_base_string</strong></a>(self, oauth_request, consumer, token)</dt></dl>
+
+<dl><dt><a name="OAuthSignatureMethod_HMAC_SHA1-get_name"><strong>get_name</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.oauth.html#OAuthSignatureMethod">OAuthSignatureMethod</a>:<br>
+<dl><dt><a name="OAuthSignatureMethod_HMAC_SHA1-check_signature"><strong>check_signature</strong></a>(self, oauth_request, consumer, token, signature)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.oauth.html#OAuthSignatureMethod">OAuthSignatureMethod</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthSignatureMethod_PLAINTEXT">class <strong>OAuthSignatureMethod_PLAINTEXT</strong></a>(<a href="gdata.oauth.html#OAuthSignatureMethod">OAuthSignatureMethod</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.oauth.html#OAuthSignatureMethod_PLAINTEXT">OAuthSignatureMethod_PLAINTEXT</a></dd>
+<dd><a href="gdata.oauth.html#OAuthSignatureMethod">OAuthSignatureMethod</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OAuthSignatureMethod_PLAINTEXT-build_signature"><strong>build_signature</strong></a>(self, oauth_request, consumer, token)</dt></dl>
+
+<dl><dt><a name="OAuthSignatureMethod_PLAINTEXT-build_signature_base_string"><strong>build_signature_base_string</strong></a>(self, oauth_request, consumer, token)</dt></dl>
+
+<dl><dt><a name="OAuthSignatureMethod_PLAINTEXT-get_name"><strong>get_name</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.oauth.html#OAuthSignatureMethod">OAuthSignatureMethod</a>:<br>
+<dl><dt><a name="OAuthSignatureMethod_PLAINTEXT-check_signature"><strong>check_signature</strong></a>(self, oauth_request, consumer, token, signature)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.oauth.html#OAuthSignatureMethod">OAuthSignatureMethod</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthToken">class <strong>OAuthToken</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt># <a href="#OAuthToken">OAuthToken</a> is a data type that represents an End User via either an access<br>
+# or request token.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="OAuthToken-__init__"><strong>__init__</strong></a>(self, key, secret)</dt></dl>
+
+<dl><dt><a name="OAuthToken-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OAuthToken-to_string"><strong>to_string</strong></a>(self)</dt></dl>
+
+<hr>
+Static methods defined here:<br>
+<dl><dt><a name="OAuthToken-from_string"><strong>from_string</strong></a>(s)</dt><dd><tt># return a token from something like:<br>
+# oauth_token_secret=digg&oauth_token=digg</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>key</strong> = None</dl>
+
+<dl><dt><strong>secret</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-build_authenticate_header"><strong>build_authenticate_header</strong></a>(realm<font color="#909090">=''</font>)</dt><dd><tt># optional WWW-Authenticate header (401 error)</tt></dd></dl>
+ <dl><dt><a name="-escape"><strong>escape</strong></a>(s)</dt><dd><tt># url escape</tt></dd></dl>
+ <dl><dt><a name="-generate_nonce"><strong>generate_nonce</strong></a>(length<font color="#909090">=8</font>)</dt><dd><tt># util function: nonce<br>
+# pseudorandom number</tt></dd></dl>
+ <dl><dt><a name="-generate_timestamp"><strong>generate_timestamp</strong></a>()</dt><dd><tt># util function: current timestamp<br>
+# seconds since epoch (UTC)</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>HTTP_METHOD</strong> = 'GET'<br>
+<strong>SIGNATURE_METHOD</strong> = 'PLAINTEXT'<br>
+<strong>VERSION</strong> = '1.0'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.oauth.rsa.html b/pydocs/gdata.oauth.rsa.html
new file mode 100644
index 0000000..6ec9cfa
--- /dev/null
+++ b/pydocs/gdata.oauth.rsa.html
@@ -0,0 +1,106 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.oauth.rsa</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.oauth.html"><font color="#ffffff">oauth</font></a>.rsa</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/oauth/rsa.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/oauth/rsa.py</a></font></td></tr></table>
+ <p><tt>requires tlslite - <a href="http://trevp.net/tlslite/">http://trevp.net/tlslite/</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.utils.cryptomath.html">gdata.tlslite.utils.cryptomath</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.utils.keyfactory.html">gdata.tlslite.utils.keyfactory</a><br>
+</td><td width="25%" valign=top><a href="gdata.oauth.html">gdata.oauth</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.oauth.html#OAuthSignatureMethod">gdata.oauth.OAuthSignatureMethod</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.oauth.rsa.html#OAuthSignatureMethod_RSA_SHA1">OAuthSignatureMethod_RSA_SHA1</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.oauth.rsa.html#TestOAuthSignatureMethod_RSA_SHA1">TestOAuthSignatureMethod_RSA_SHA1</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OAuthSignatureMethod_RSA_SHA1">class <strong>OAuthSignatureMethod_RSA_SHA1</strong></a>(<a href="gdata.oauth.html#OAuthSignatureMethod">gdata.oauth.OAuthSignatureMethod</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.oauth.rsa.html#OAuthSignatureMethod_RSA_SHA1">OAuthSignatureMethod_RSA_SHA1</a></dd>
+<dd><a href="gdata.oauth.html#OAuthSignatureMethod">gdata.oauth.OAuthSignatureMethod</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="OAuthSignatureMethod_RSA_SHA1-build_signature"><strong>build_signature</strong></a>(self, oauth_request, consumer, token)</dt></dl>
+
+<dl><dt><a name="OAuthSignatureMethod_RSA_SHA1-build_signature_base_string"><strong>build_signature_base_string</strong></a>(self, oauth_request, consumer, token)</dt></dl>
+
+<dl><dt><a name="OAuthSignatureMethod_RSA_SHA1-check_signature"><strong>check_signature</strong></a>(self, oauth_request, consumer, token, signature)</dt></dl>
+
+<dl><dt><a name="OAuthSignatureMethod_RSA_SHA1-get_name"><strong>get_name</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.oauth.html#OAuthSignatureMethod">gdata.oauth.OAuthSignatureMethod</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TestOAuthSignatureMethod_RSA_SHA1">class <strong>TestOAuthSignatureMethod_RSA_SHA1</strong></a>(<a href="gdata.oauth.rsa.html#OAuthSignatureMethod_RSA_SHA1">OAuthSignatureMethod_RSA_SHA1</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.oauth.rsa.html#TestOAuthSignatureMethod_RSA_SHA1">TestOAuthSignatureMethod_RSA_SHA1</a></dd>
+<dd><a href="gdata.oauth.rsa.html#OAuthSignatureMethod_RSA_SHA1">OAuthSignatureMethod_RSA_SHA1</a></dd>
+<dd><a href="gdata.oauth.html#OAuthSignatureMethod">gdata.oauth.OAuthSignatureMethod</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.oauth.rsa.html#OAuthSignatureMethod_RSA_SHA1">OAuthSignatureMethod_RSA_SHA1</a>:<br>
+<dl><dt><a name="TestOAuthSignatureMethod_RSA_SHA1-build_signature"><strong>build_signature</strong></a>(self, oauth_request, consumer, token)</dt></dl>
+
+<dl><dt><a name="TestOAuthSignatureMethod_RSA_SHA1-build_signature_base_string"><strong>build_signature_base_string</strong></a>(self, oauth_request, consumer, token)</dt></dl>
+
+<dl><dt><a name="TestOAuthSignatureMethod_RSA_SHA1-check_signature"><strong>check_signature</strong></a>(self, oauth_request, consumer, token, signature)</dt></dl>
+
+<dl><dt><a name="TestOAuthSignatureMethod_RSA_SHA1-get_name"><strong>get_name</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.oauth.html#OAuthSignatureMethod">gdata.oauth.OAuthSignatureMethod</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.opensearch.data.html b/pydocs/gdata.opensearch.data.html
new file mode 100644
index 0000000..8fbd164
--- /dev/null
+++ b/pydocs/gdata.opensearch.data.html
@@ -0,0 +1,493 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.opensearch.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.opensearch.html"><font color="#ffffff">opensearch</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/opensearch/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/opensearch/data.py</a></font></td></tr></table>
+ <p><tt>Contains the data classes of the OpenSearch Extension</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.opensearch.data.html#ItemsPerPage">ItemsPerPage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.opensearch.data.html#StartIndex">StartIndex</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.opensearch.data.html#TotalResults">TotalResults</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ItemsPerPage">class <strong>ItemsPerPage</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the number of items that will be returned per page for paged feeds<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.opensearch.data.html#ItemsPerPage">ItemsPerPage</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ItemsPerPage-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ItemsPerPage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ItemsPerPage-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ItemsPerPage-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="StartIndex">class <strong>StartIndex</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the starting index of the contained entries for paged feeds<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.opensearch.data.html#StartIndex">StartIndex</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="StartIndex-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="StartIndex-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="StartIndex-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="StartIndex-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TotalResults">class <strong>TotalResults</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the total number of results associated with this feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.opensearch.data.html#TotalResults">TotalResults</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TotalResults-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TotalResults-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TotalResults-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TotalResults-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>OPENSEARCH_TEMPLATE_V1</strong> = '{http://a9.com/-/spec/opensearchrss/1.0//}%s'<br>
+<strong>OPENSEARCH_TEMPLATE_V2</strong> = '{http://a9.com/-/spec/opensearch/1.1//}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.opensearch.html b/pydocs/gdata.opensearch.html
new file mode 100644
index 0000000..dd21fd9
--- /dev/null
+++ b/pydocs/gdata.opensearch.html
@@ -0,0 +1,34 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.opensearch</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.opensearch</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/opensearch/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/opensearch/__init__.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.opensearch.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.photos.html b/pydocs/gdata.photos.html
new file mode 100644
index 0000000..6228ba7
--- /dev/null
+++ b/pydocs/gdata.photos.html
@@ -0,0 +1,4128 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.photos</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.photos</strong></big></big> (version 164)</font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/photos/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/photos/__init__.py</a></font></td></tr></table>
+ <p><tt>This module provides a pythonic, gdata-centric interface to Google Photos<br>
+(a.k.a. Picasa Web Services.<br>
+ <br>
+It is modelled after the gdata/* interfaces from the gdata-python-client<br>
+project[1] by Google. <br>
+ <br>
+You'll find the user-friendly api in photos.service. Please see the<br>
+documentation or live help() system for available methods.<br>
+ <br>
+[1]: <a href="http://gdata-python-client.googlecode.com/">http://gdata-python-client.googlecode.com/</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.photos.service.html">service</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#AlbumData">AlbumData</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#CommentData">CommentData</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#TagData">TagData</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#UserData">UserData</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#PhotoData">PhotoData</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#Access">Access</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Albumid">Albumid</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#BytesUsed">BytesUsed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Checksum">Checksum</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Client">Client</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#CommentCount">CommentCount</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#CommentingEnabled">CommentingEnabled</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Height">Height</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Id">Id</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Location">Location</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#MaxPhotosPerAlbum">MaxPhotosPerAlbum</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Name">Name</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Nickname">Nickname</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Numphotos">Numphotos</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Numphotosremaining">Numphotosremaining</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Photoid">Photoid</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Position">Position</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Quotacurrent">Quotacurrent</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Quotalimit">Quotalimit</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Rotation">Rotation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Size">Size</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Snippet">Snippet</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Snippettype">Snippettype</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Thumbnail">Thumbnail</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Timestamp">Timestamp</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Truncated">Truncated</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#User">User</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Version">Version</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Weight">Weight</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#Width">Width</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Author">atom.Author</a>(<a href="atom.html#Person">atom.Person</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#CommentAuthor">CommentAuthor</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#AlbumEntry">AlbumEntry</a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#AlbumData">AlbumData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#CommentEntry">CommentEntry</a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#CommentData">CommentData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#PhotoEntry">PhotoEntry</a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#PhotoData">PhotoData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#PhotosBaseEntry">PhotosBaseEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#TagEntry">TagEntry</a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#TagData">TagData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#UserEntry">UserEntry</a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#UserData">UserData</a>)
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#AlbumFeed">AlbumFeed</a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#AlbumData">AlbumData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#CommentFeed">CommentFeed</a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#CommentData">CommentData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#PhotoFeed">PhotoFeed</a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#PhotoData">PhotoData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#PhotosBaseFeed">PhotosBaseFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#TagFeed">TagFeed</a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#TagData">TagData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#UserFeed">UserFeed</a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#UserData">UserData</a>)
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#LinkFinder">gdata.LinkFinder</a>(<a href="atom.html#LinkFinder">atom.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#AlbumEntry">AlbumEntry</a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#AlbumData">AlbumData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#CommentEntry">CommentEntry</a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#CommentData">CommentData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#PhotoEntry">PhotoEntry</a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#PhotoData">PhotoData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#PhotosBaseEntry">PhotosBaseEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#TagEntry">TagEntry</a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#TagData">TagData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#UserEntry">UserEntry</a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#UserData">UserData</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.html#AlbumFeed">AlbumFeed</a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#AlbumData">AlbumData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#CommentFeed">CommentFeed</a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#CommentData">CommentData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#PhotoFeed">PhotoFeed</a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#PhotoData">PhotoData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#PhotosBaseFeed">PhotosBaseFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#TagFeed">TagFeed</a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#TagData">TagData</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.photos.html#UserFeed">UserFeed</a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#UserData">UserData</a>)
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Access">class <strong>Access</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Access">Access</a>' element.<br>
+ <br>
+The album's access level. Valid values are `public' or `private'.<br>
+In documentation, access level is also referred to as `visibility.'<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Access">Access</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Access-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Access-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Access-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Access-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Access-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Access-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AlbumData">class <strong>AlbumData</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>access</strong> = None</dl>
+
+<dl><dt><strong>bytesUsed</strong> = None</dl>
+
+<dl><dt><strong>commentCount</strong> = None</dl>
+
+<dl><dt><strong>commentingEnabled</strong> = None</dl>
+
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>location</strong> = None</dl>
+
+<dl><dt><strong>name</strong> = None</dl>
+
+<dl><dt><strong>nickname</strong> = None</dl>
+
+<dl><dt><strong>numphotos</strong> = None</dl>
+
+<dl><dt><strong>numphotosremaining</strong> = None</dl>
+
+<dl><dt><strong>timestamp</strong> = None</dl>
+
+<dl><dt><strong>user</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AlbumEntry">class <strong>AlbumEntry</strong></a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#AlbumData">AlbumData</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>All metadata for a Google Photos Album<br>
+ <br>
+Take a look at <a href="#AlbumData">AlbumData</a> for metadata accessible as attributes to this <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+Notes:<br>
+ To avoid name clashes, and to create a more sensible api, some<br>
+ objects have names that differ from the original elements:<br>
+ <br>
+ o media:group -> self.<strong>media</strong>,<br>
+ o geo:where -> self.<strong>geo</strong>,<br>
+ o photo:id -> self.<strong>gphoto_id</strong><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#AlbumEntry">AlbumEntry</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="gdata.photos.html#AlbumData">AlbumData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AlbumEntry-GetAlbumId"><strong>GetAlbumId</strong></a>(self)</dt><dd><tt>Return the id of this album</tt></dd></dl>
+
+<dl><dt><a name="AlbumEntry-GetCommentsUri"><strong>GetCommentsUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to this albums feed of the <a href="#CommentEntry">CommentEntry</a> kind</tt></dd></dl>
+
+<dl><dt><a name="AlbumEntry-GetPhotosUri"><strong>GetPhotosUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to this albums feed of the <a href="#PhotoEntry">PhotoEntry</a> kind</tt></dd></dl>
+
+<dl><dt><a name="AlbumEntry-GetTagsUri"><strong>GetTagsUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to this albums feed of the <a href="#TagEntry">TagEntry</a> kind</tt></dd></dl>
+
+<dl><dt><a name="AlbumEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, gphoto_id<font color="#909090">=None</font>, name<font color="#909090">=None</font>, location<font color="#909090">=None</font>, access<font color="#909090">=None</font>, timestamp<font color="#909090">=None</font>, numphotos<font color="#909090">=None</font>, user<font color="#909090">=None</font>, nickname<font color="#909090">=None</font>, commentingEnabled<font color="#909090">=None</font>, commentCount<font color="#909090">=None</font>, thumbnail<font color="#909090">=None</font>, media<font color="#909090">=None</font>, geo<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>geo</strong> = <gdata.geo.Where object></dl>
+
+<dl><dt><strong>media</strong> = <gdata.media.Group object></dl>
+
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>:<br>
+<dl><dt><a name="AlbumEntry-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="AlbumEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AlbumEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="AlbumEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="AlbumEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="AlbumEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="AlbumEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="AlbumEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="AlbumEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AlbumEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="AlbumEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.photos.html#AlbumData">AlbumData</a>:<br>
+<dl><dt><strong>access</strong> = None</dl>
+
+<dl><dt><strong>bytesUsed</strong> = None</dl>
+
+<dl><dt><strong>commentCount</strong> = None</dl>
+
+<dl><dt><strong>commentingEnabled</strong> = None</dl>
+
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>location</strong> = None</dl>
+
+<dl><dt><strong>name</strong> = None</dl>
+
+<dl><dt><strong>nickname</strong> = None</dl>
+
+<dl><dt><strong>numphotos</strong> = None</dl>
+
+<dl><dt><strong>numphotosremaining</strong> = None</dl>
+
+<dl><dt><strong>timestamp</strong> = None</dl>
+
+<dl><dt><strong>user</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AlbumFeed">class <strong>AlbumFeed</strong></a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#AlbumData">AlbumData</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>All metadata for a Google Photos Album, including its sub-elements<br>
+ <br>
+This feed represents an album as the container for other objects.<br>
+ <br>
+A Album feed contains entries of<br>
+<a href="#PhotoEntry">PhotoEntry</a>, <a href="#CommentEntry">CommentEntry</a> or <a href="#TagEntry">TagEntry</a>,<br>
+depending on the `kind' parameter in the original query.<br>
+ <br>
+Take a look at <a href="#AlbumData">AlbumData</a> for accessible attributes.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#AlbumFeed">AlbumFeed</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="gdata.photos.html#AlbumData">AlbumData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AlbumFeed-GetCommentsUri"><strong>GetCommentsUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to the same feed, but of the <a href="#CommentEntry">CommentEntry</a> kind</tt></dd></dl>
+
+<dl><dt><a name="AlbumFeed-GetPhotosUri"><strong>GetPhotosUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to the same feed, but of the <a href="#PhotoEntry">PhotoEntry</a> kind</tt></dd></dl>
+
+<dl><dt><a name="AlbumFeed-GetTagsUri"><strong>GetTagsUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to the same feed, but of the <a href="#TagEntry">TagEntry</a> kind</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>:<br>
+<dl><dt><a name="AlbumFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AlbumFeed-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="AlbumFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="AlbumFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="AlbumFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="AlbumFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="AlbumFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="AlbumFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AlbumFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="AlbumFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AlbumFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.photos.html#AlbumData">AlbumData</a>:<br>
+<dl><dt><strong>access</strong> = None</dl>
+
+<dl><dt><strong>bytesUsed</strong> = None</dl>
+
+<dl><dt><strong>commentCount</strong> = None</dl>
+
+<dl><dt><strong>commentingEnabled</strong> = None</dl>
+
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>location</strong> = None</dl>
+
+<dl><dt><strong>name</strong> = None</dl>
+
+<dl><dt><strong>nickname</strong> = None</dl>
+
+<dl><dt><strong>numphotos</strong> = None</dl>
+
+<dl><dt><strong>numphotosremaining</strong> = None</dl>
+
+<dl><dt><strong>timestamp</strong> = None</dl>
+
+<dl><dt><strong>user</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Albumid">class <strong>Albumid</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Albumid">Albumid</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Albumid">Albumid</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Albumid-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Albumid-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Albumid-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Albumid-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Albumid-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Albumid-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BytesUsed">class <strong>BytesUsed</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#BytesUsed">BytesUsed</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#BytesUsed">BytesUsed</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="BytesUsed-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="BytesUsed-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BytesUsed-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="BytesUsed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="BytesUsed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="BytesUsed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Checksum">class <strong>Checksum</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Checksum">Checksum</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Checksum">Checksum</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Checksum-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Checksum-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Checksum-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Checksum-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Checksum-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Checksum-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Client">class <strong>Client</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Client">Client</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Client">Client</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Client-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Client-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Client-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Client-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Client-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Client-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentAuthor">class <strong>CommentAuthor</strong></a>(<a href="atom.html#Author">atom.Author</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Atom `<a href="atom.html#Author">Author</a>' element in <a href="#CommentEntry">CommentEntry</a> entries is augmented to<br>
+contain elements from the PHOTOS_NAMESPACE<br>
+ <br>
+<a href="http://groups.google.com/group/Google-Picasa-Data-API/msg/819b0025b5ff5e38">http://groups.google.com/group/Google-Picasa-Data-API/msg/819b0025b5ff5e38</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#CommentAuthor">CommentAuthor</a></dd>
+<dd><a href="atom.html#Author">atom.Author</a></dd>
+<dd><a href="atom.html#Person">atom.Person</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Author">atom.Author</a>:<br>
+<dl><dt><a name="CommentAuthor-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, email<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="atom.html#Author">Author</a><br>
+ <br>
+Args:<br>
+ name: <a href="#Name">Name</a><br>
+ email: Email<br>
+ uri: Uri<br>
+ extension_elements: list A list of ExtensionElement instances<br>
+ extension_attributes: dict A dictionary of attribute value string pairs<br>
+ text: str The text data in the this element</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CommentAuthor-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentAuthor-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CommentAuthor-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentCount">class <strong>CommentCount</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#CommentCount">CommentCount</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#CommentCount">CommentCount</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="CommentCount-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="CommentCount-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentCount-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CommentCount-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentCount-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CommentCount-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentData">class <strong>CommentData</strong></a>(<a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#CommentData">CommentData</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>albumid</strong> = None</dl>
+
+<dl><dt><strong>author</strong> = None</dl>
+
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>photoid</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentEntry">class <strong>CommentEntry</strong></a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#CommentData">CommentData</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>All metadata for a Google Photos Comment<br>
+ <br>
+The comment is stored in the .content.text attribute,<br>
+with a content type in .content.type.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#CommentEntry">CommentEntry</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="gdata.photos.html#CommentData">CommentData</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CommentEntry-GetAlbumUri"><strong>GetAlbumUri</strong></a>(self)</dt><dd><tt>Return the uri to the <a href="#AlbumEntry">AlbumEntry</a> containing this comment</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetCommentId"><strong>GetCommentId</strong></a>(self)</dt><dd><tt>Return the globally unique id of this comment</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetPhotoUri"><strong>GetPhotoUri</strong></a>(self)</dt><dd><tt>Return the uri to the <a href="#PhotoEntry">PhotoEntry</a> containing this comment</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, gphoto_id<font color="#909090">=None</font>, albumid<font color="#909090">=None</font>, photoid<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>:<br>
+<dl><dt><a name="CommentEntry-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="CommentEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CommentEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CommentEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CommentEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CommentEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.photos.html#CommentData">CommentData</a>:<br>
+<dl><dt><strong>albumid</strong> = None</dl>
+
+<dl><dt><strong>author</strong> = None</dl>
+
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>photoid</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentFeed">class <strong>CommentFeed</strong></a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#CommentData">CommentData</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>All metadata for a Google Photos Comment, including its sub-elements<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#CommentFeed">CommentFeed</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="gdata.photos.html#CommentData">CommentData</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>:<br>
+<dl><dt><a name="CommentFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="CommentFeed-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CommentFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CommentFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="CommentFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="CommentFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.photos.html#CommentData">CommentData</a>:<br>
+<dl><dt><strong>albumid</strong> = None</dl>
+
+<dl><dt><strong>author</strong> = None</dl>
+
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>photoid</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentingEnabled">class <strong>CommentingEnabled</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#CommentingEnabled">CommentingEnabled</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#CommentingEnabled">CommentingEnabled</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="CommentingEnabled-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="CommentingEnabled-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentingEnabled-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CommentingEnabled-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentingEnabled-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CommentingEnabled-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GPhotosBaseData">class <strong>GPhotosBaseData</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GPhotosBaseEntry">class <strong>GPhotosBaseEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Base class for all Entry elements in gdata.photos<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GPhotosBaseEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="GPhotosBaseEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GPhotosBaseEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GPhotosBaseEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="GPhotosBaseEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="GPhotosBaseEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GPhotosBaseFeed">class <strong>GPhotosBaseFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Base class for all Feeds in gdata.photos<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GPhotosBaseFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseFeed-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GPhotosBaseFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GPhotosBaseFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GPhotosBaseFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="GPhotosBaseFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="GPhotosBaseFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="GPhotosBaseFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="GPhotosBaseFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="GPhotosBaseFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GPhotosBaseFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Height">class <strong>Height</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Height">Height</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Height">Height</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Height-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Height-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Height-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Height-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Height-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Height-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Id">class <strong>Id</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Id">Id</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Id">Id</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Id-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Id-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Id-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Id-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Id-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Id-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Location">class <strong>Location</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Location">Location</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Location">Location</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Location-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Location-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Location-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Location-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Location-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Location-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MaxPhotosPerAlbum">class <strong>MaxPhotosPerAlbum</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#MaxPhotosPerAlbum">MaxPhotosPerAlbum</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#MaxPhotosPerAlbum">MaxPhotosPerAlbum</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="MaxPhotosPerAlbum-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="MaxPhotosPerAlbum-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MaxPhotosPerAlbum-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="MaxPhotosPerAlbum-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="MaxPhotosPerAlbum-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="MaxPhotosPerAlbum-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Name">class <strong>Name</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Name">Name</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Name">Name</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Name-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Name-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Name-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Name-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Name-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Name-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Nickname">class <strong>Nickname</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Nickname">Nickname</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Nickname">Nickname</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Nickname-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Nickname-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Nickname-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Nickname-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Nickname-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Nickname-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Numphotos">class <strong>Numphotos</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Numphotos">Numphotos</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Numphotos">Numphotos</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Numphotos-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Numphotos-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Numphotos-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Numphotos-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Numphotos-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Numphotos-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Numphotosremaining">class <strong>Numphotosremaining</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Numphotosremaining">Numphotosremaining</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Numphotosremaining">Numphotosremaining</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Numphotosremaining-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Numphotosremaining-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Numphotosremaining-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Numphotosremaining-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Numphotosremaining-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Numphotosremaining-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PhotoData">class <strong>PhotoData</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>albumid</strong> = None</dl>
+
+<dl><dt><strong>checksum</strong> = None</dl>
+
+<dl><dt><strong>client</strong> = None</dl>
+
+<dl><dt><strong>commentCount</strong> = None</dl>
+
+<dl><dt><strong>commentingEnabled</strong> = None</dl>
+
+<dl><dt><strong>geo</strong> = <gdata.geo.Where object></dl>
+
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>height</strong> = None</dl>
+
+<dl><dt><strong>media</strong> = <gdata.media.Group object></dl>
+
+<dl><dt><strong>position</strong> = None</dl>
+
+<dl><dt><strong>rotation</strong> = None</dl>
+
+<dl><dt><strong>size</strong> = None</dl>
+
+<dl><dt><strong>snippet</strong> = None</dl>
+
+<dl><dt><strong>snippettype</strong> = None</dl>
+
+<dl><dt><strong>tags</strong> = <gdata.exif.Tags object></dl>
+
+<dl><dt><strong>timestamp</strong> = None</dl>
+
+<dl><dt><strong>truncated</strong> = None</dl>
+
+<dl><dt><strong>version</strong> = None</dl>
+
+<dl><dt><strong>width</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PhotoEntry">class <strong>PhotoEntry</strong></a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#PhotoData">PhotoData</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>All metadata for a Google Photos Photo<br>
+ <br>
+Take a look at <a href="#PhotoData">PhotoData</a> for metadata accessible as attributes to this <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+Notes:<br>
+ To avoid name clashes, and to create a more sensible api, some<br>
+ objects have names that differ from the original elements:<br>
+ <br>
+ o media:group -> self.<strong>media</strong>,<br>
+ o exif:tags -> self.<strong>exif</strong>,<br>
+ o geo:where -> self.<strong>geo</strong>,<br>
+ o photo:id -> self.<strong>gphoto_id</strong><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#PhotoEntry">PhotoEntry</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="gdata.photos.html#PhotoData">PhotoData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PhotoEntry-GetAlbumUri"><strong>GetAlbumUri</strong></a>(self)</dt><dd><tt>Return the uri to the <a href="#AlbumEntry">AlbumEntry</a> containing this photo</tt></dd></dl>
+
+<dl><dt><a name="PhotoEntry-GetCommentsUri"><strong>GetCommentsUri</strong></a>(self)</dt><dd><tt>Return the uri to this photo's feed of <a href="#CommentEntry">CommentEntry</a> comments</tt></dd></dl>
+
+<dl><dt><a name="PhotoEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Return the uri to this photo's `POST' link (use it for updates of the <a href="__builtin__.html#object">object</a>)</tt></dd></dl>
+
+<dl><dt><a name="PhotoEntry-GetTagsUri"><strong>GetTagsUri</strong></a>(self)</dt><dd><tt>Return the uri to this photo's feed of <a href="#TagEntry">TagEntry</a> tags</tt></dd></dl>
+
+<dl><dt><a name="PhotoEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, text<font color="#909090">=None</font>, gphoto_id<font color="#909090">=None</font>, albumid<font color="#909090">=None</font>, checksum<font color="#909090">=None</font>, client<font color="#909090">=None</font>, height<font color="#909090">=None</font>, position<font color="#909090">=None</font>, rotation<font color="#909090">=None</font>, size<font color="#909090">=None</font>, timestamp<font color="#909090">=None</font>, version<font color="#909090">=None</font>, width<font color="#909090">=None</font>, commentCount<font color="#909090">=None</font>, commentingEnabled<font color="#909090">=None</font>, media<font color="#909090">=None</font>, exif<font color="#909090">=None</font>, geo<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>:<br>
+<dl><dt><a name="PhotoEntry-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="PhotoEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PhotoEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PhotoEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PhotoEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PhotoEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="PhotoEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="PhotoEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="PhotoEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="PhotoEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.photos.html#PhotoData">PhotoData</a>:<br>
+<dl><dt><strong>albumid</strong> = None</dl>
+
+<dl><dt><strong>checksum</strong> = None</dl>
+
+<dl><dt><strong>client</strong> = None</dl>
+
+<dl><dt><strong>commentCount</strong> = None</dl>
+
+<dl><dt><strong>commentingEnabled</strong> = None</dl>
+
+<dl><dt><strong>geo</strong> = <gdata.geo.Where object></dl>
+
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>height</strong> = None</dl>
+
+<dl><dt><strong>media</strong> = <gdata.media.Group object></dl>
+
+<dl><dt><strong>position</strong> = None</dl>
+
+<dl><dt><strong>rotation</strong> = None</dl>
+
+<dl><dt><strong>size</strong> = None</dl>
+
+<dl><dt><strong>snippet</strong> = None</dl>
+
+<dl><dt><strong>snippettype</strong> = None</dl>
+
+<dl><dt><strong>tags</strong> = <gdata.exif.Tags object></dl>
+
+<dl><dt><strong>timestamp</strong> = None</dl>
+
+<dl><dt><strong>truncated</strong> = None</dl>
+
+<dl><dt><strong>version</strong> = None</dl>
+
+<dl><dt><strong>width</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PhotoFeed">class <strong>PhotoFeed</strong></a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#PhotoData">PhotoData</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>All metadata for a Google Photos Photo, including its sub-elements<br>
+ <br>
+This feed represents a photo as the container for other objects.<br>
+ <br>
+A Photo feed contains entries of<br>
+<a href="#CommentEntry">CommentEntry</a> or <a href="#TagEntry">TagEntry</a>,<br>
+depending on the `kind' parameter in the original query.<br>
+ <br>
+Take a look at <a href="#PhotoData">PhotoData</a> for metadata accessible as attributes to this <a href="__builtin__.html#object">object</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#PhotoFeed">PhotoFeed</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="gdata.photos.html#PhotoData">PhotoData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PhotoFeed-GetCommentsUri"><strong>GetCommentsUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to the same feed, but of the <a href="#CommentEntry">CommentEntry</a> kind</tt></dd></dl>
+
+<dl><dt><a name="PhotoFeed-GetTagsUri"><strong>GetTagsUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to the same feed, but of the <a href="#TagEntry">TagEntry</a> kind</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>:<br>
+<dl><dt><a name="PhotoFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="PhotoFeed-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PhotoFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PhotoFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PhotoFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="PhotoFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="PhotoFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="PhotoFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PhotoFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="PhotoFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotoFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.photos.html#PhotoData">PhotoData</a>:<br>
+<dl><dt><strong>albumid</strong> = None</dl>
+
+<dl><dt><strong>checksum</strong> = None</dl>
+
+<dl><dt><strong>client</strong> = None</dl>
+
+<dl><dt><strong>commentCount</strong> = None</dl>
+
+<dl><dt><strong>commentingEnabled</strong> = None</dl>
+
+<dl><dt><strong>geo</strong> = <gdata.geo.Where object></dl>
+
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>height</strong> = None</dl>
+
+<dl><dt><strong>media</strong> = <gdata.media.Group object></dl>
+
+<dl><dt><strong>position</strong> = None</dl>
+
+<dl><dt><strong>rotation</strong> = None</dl>
+
+<dl><dt><strong>size</strong> = None</dl>
+
+<dl><dt><strong>snippet</strong> = None</dl>
+
+<dl><dt><strong>snippettype</strong> = None</dl>
+
+<dl><dt><strong>tags</strong> = <gdata.exif.Tags object></dl>
+
+<dl><dt><strong>timestamp</strong> = None</dl>
+
+<dl><dt><strong>truncated</strong> = None</dl>
+
+<dl><dt><strong>version</strong> = None</dl>
+
+<dl><dt><strong>width</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Photoid">class <strong>Photoid</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Photoid">Photoid</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Photoid">Photoid</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Photoid-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Photoid-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Photoid-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Photoid-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Photoid-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Photoid-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PhotosBaseElement">class <strong>PhotosBaseElement</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Base class for elements in the PHOTO_NAMESPACE. To add new elements,<br>
+you only need to add the element tag name to self.<strong>_tag</strong><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PhotosBaseElement-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="PhotosBaseElement-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseElement-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PhotosBaseElement-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PhotosBaseElement-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PhotosBaseElement-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PhotosBaseEntry">class <strong>PhotosBaseEntry</strong></a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#PhotosBaseEntry">PhotosBaseEntry</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>:<br>
+<dl><dt><a name="PhotosBaseEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="PhotosBaseEntry-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="PhotosBaseEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PhotosBaseEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PhotosBaseEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PhotosBaseEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PhotosBaseEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="PhotosBaseEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="PhotosBaseEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="PhotosBaseEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PhotosBaseEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="PhotosBaseEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PhotosBaseFeed">class <strong>PhotosBaseFeed</strong></a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#PhotosBaseFeed">PhotosBaseFeed</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>:<br>
+<dl><dt><a name="PhotosBaseFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="PhotosBaseFeed-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PhotosBaseFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PhotosBaseFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PhotosBaseFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="PhotosBaseFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="PhotosBaseFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="PhotosBaseFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PhotosBaseFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="PhotosBaseFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosBaseFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Position">class <strong>Position</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Position">Position</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Position">Position</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Position-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Position-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Position-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Position-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Position-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Position-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Quotacurrent">class <strong>Quotacurrent</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Quotacurrent">Quotacurrent</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Quotacurrent">Quotacurrent</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Quotacurrent-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Quotacurrent-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Quotacurrent-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Quotacurrent-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Quotacurrent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Quotacurrent-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Quotalimit">class <strong>Quotalimit</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Quotalimit">Quotalimit</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Quotalimit">Quotalimit</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Quotalimit-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Quotalimit-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Quotalimit-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Quotalimit-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Quotalimit-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Quotalimit-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Rotation">class <strong>Rotation</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Rotation">Rotation</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Rotation">Rotation</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Rotation-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Rotation-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Rotation-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Rotation-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Rotation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Rotation-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Size">class <strong>Size</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Size">Size</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Size">Size</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Size-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Size-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Size-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Size-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Size-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Size-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Snippet">class <strong>Snippet</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `snippet' element.<br>
+ <br>
+When searching, the snippet element will contain a <br>
+string with the word you're looking for, highlighted in html markup<br>
+E.g. when your query is `hafjell', this element may contain:<br>
+`... here at <b>Hafjell</b>.'<br>
+ <br>
+You'll find this element in searches -- that is, feeds that combine the <br>
+`kind=photo' and `q=yoursearch' parameters in the request.<br>
+ <br>
+See also gphoto:truncated and gphoto:snippettype.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Snippet">Snippet</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Snippet-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Snippet-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Snippet-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Snippet-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Snippet-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Snippet-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Snippettype">class <strong>Snippettype</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Snippettype">Snippettype</a>' element<br>
+ <br>
+When searching, this element will tell you the type of element that matches.<br>
+ <br>
+You'll find this element in searches -- that is, feeds that combine the <br>
+`kind=photo' and `q=yoursearch' parameters in the request.<br>
+ <br>
+See also gphoto:snippet and gphoto:truncated.<br>
+ <br>
+Possible values and their interpretation: <br>
+o ALBUM_TITLE - The album title matches <br>
+o PHOTO_TAGS - The match is a tag/keyword<br>
+o PHOTO_DESCRIPTION - The match is in the photo's description<br>
+ <br>
+If you discover a value not listed here, please submit a patch to update this docstring.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Snippettype">Snippettype</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Snippettype-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Snippettype-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Snippettype-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Snippettype-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Snippettype-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Snippettype-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TagData">class <strong>TagData</strong></a>(<a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#TagData">TagData</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>weight</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TagEntry">class <strong>TagEntry</strong></a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#TagData">TagData</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>All metadata for a Google Photos Tag<br>
+ <br>
+The actual tag is stored in the .title.text attribute<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#TagEntry">TagEntry</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="gdata.photos.html#TagData">TagData</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="TagEntry-GetAlbumUri"><strong>GetAlbumUri</strong></a>(self)</dt><dd><tt>Return the uri to the <a href="#AlbumEntry">AlbumEntry</a> containing this tag</tt></dd></dl>
+
+<dl><dt><a name="TagEntry-GetPhotoUri"><strong>GetPhotoUri</strong></a>(self)</dt><dd><tt>Return the uri to the <a href="#PhotoEntry">PhotoEntry</a> containing this tag</tt></dd></dl>
+
+<dl><dt><a name="TagEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, weight<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>:<br>
+<dl><dt><a name="TagEntry-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="TagEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="TagEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="TagEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="TagEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="TagEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="TagEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="TagEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="TagEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TagEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="TagEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.photos.html#TagData">TagData</a>:<br>
+<dl><dt><strong>weight</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TagFeed">class <strong>TagFeed</strong></a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#TagData">TagData</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>All metadata for a Google Photos Tag, including its sub-elements<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#TagFeed">TagFeed</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="gdata.photos.html#TagData">TagData</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>:<br>
+<dl><dt><a name="TagFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="TagFeed-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="TagFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="TagFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="TagFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="TagFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="TagFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="TagFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TagFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="TagFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TagFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.photos.html#TagData">TagData</a>:<br>
+<dl><dt><strong>weight</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Thumbnail">class <strong>Thumbnail</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Thumbnail">Thumbnail</a>' element<br>
+ <br>
+Used to display user's photo thumbnail (hackergotchi).<br>
+ <br>
+(Not to be confused with the <media:thumbnail> element, which gives you<br>
+small versions of the photo <a href="__builtin__.html#object">object</a>.)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Thumbnail">Thumbnail</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Thumbnail-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Thumbnail-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Thumbnail-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Thumbnail-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Thumbnail-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Thumbnail-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Timestamp">class <strong>Timestamp</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Timestamp">Timestamp</a>' element<br>
+Represented as the number of milliseconds since January 1st, 1970.<br>
+ <br>
+ <br>
+Take a look at the convenience methods .<a href="#Timestamp-isoformat">isoformat</a>() and .<a href="#Timestamp-datetime">datetime</a>():<br>
+ <br>
+photo_epoch = Time.text # 1180294337000<br>
+photo_isostring = Time.<a href="#Timestamp-isoformat">isoformat</a>() # '2007-05-27T19:32:17.000Z'<br>
+ <br>
+Alternatively: <br>
+photo_datetime = Time.<a href="#Timestamp-datetime">datetime</a>() # (requires python >= 2.3)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Timestamp">Timestamp</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Timestamp-datetime"><strong>datetime</strong></a>(self)</dt><dd><tt>(datetime.datetime) Return the timestamp as a datetime.datetime <a href="__builtin__.html#object">object</a><br>
+ <br>
+Requires python 2.3</tt></dd></dl>
+
+<dl><dt><a name="Timestamp-isoformat"><strong>isoformat</strong></a>(self)</dt><dd><tt>(string) Return the timestamp as a ISO 8601 formatted string,<br>
+e.g. '2007-05-27T19:32:17.000Z'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Timestamp-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Timestamp-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Timestamp-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Timestamp-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Timestamp-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Timestamp-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Truncated">class <strong>Truncated</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Truncated">Truncated</a>' element<br>
+ <br>
+You'll find this element in searches -- that is, feeds that combine the <br>
+`kind=photo' and `q=yoursearch' parameters in the request.<br>
+ <br>
+See also gphoto:snippet and gphoto:snippettype.<br>
+ <br>
+Possible values and their interpretation:<br>
+0 -- unknown<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Truncated">Truncated</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Truncated-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Truncated-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Truncated-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Truncated-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Truncated-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Truncated-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="User">class <strong>User</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#User">User</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#User">User</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="User-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="User-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="User-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="User-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="User-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="User-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserData">class <strong>UserData</strong></a>(<a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#UserData">UserData</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>maxPhotosPerAlbum</strong> = None</dl>
+
+<dl><dt><strong>nickname</strong> = None</dl>
+
+<dl><dt><strong>quotacurrent</strong> = None</dl>
+
+<dl><dt><strong>quotalimit</strong> = None</dl>
+
+<dl><dt><strong>thumbnail</strong> = None</dl>
+
+<dl><dt><strong>user</strong> = None</dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserEntry">class <strong>UserEntry</strong></a>(<a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>, <a href="gdata.photos.html#UserData">UserData</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>All metadata for a Google Photos <a href="#User">User</a><br>
+ <br>
+This entry represents an album owner and all appropriate metadata.<br>
+ <br>
+Take a look at at the attributes of the <a href="#UserData">UserData</a> for metadata available.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#UserEntry">UserEntry</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="gdata.photos.html#UserData">UserData</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="UserEntry-GetAlbumsUri"><strong>GetAlbumsUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to this user's feed of the <a href="#AlbumEntry">AlbumEntry</a> kind</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetCommentsUri"><strong>GetCommentsUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to this user's feed of the <a href="#CommentEntry">CommentEntry</a> kind</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetPhotosUri"><strong>GetPhotosUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to this user's feed of the <a href="#PhotoEntry">PhotoEntry</a> kind</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetTagsUri"><strong>GetTagsUri</strong></a>(self)</dt><dd><tt>(string) Return the uri to this user's feed of the <a href="#TagEntry">TagEntry</a> kind</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, gphoto_id<font color="#909090">=None</font>, maxPhotosPerAlbum<font color="#909090">=None</font>, nickname<font color="#909090">=None</font>, quotalimit<font color="#909090">=None</font>, quotacurrent<font color="#909090">=None</font>, thumbnail<font color="#909090">=None</font>, user<font color="#909090">=None</font>, extended_property<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseEntry">GPhotosBaseEntry</a>:<br>
+<dl><dt><a name="UserEntry-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="UserEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="UserEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="UserEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="UserEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="UserEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.photos.html#UserData">UserData</a>:<br>
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>maxPhotosPerAlbum</strong> = None</dl>
+
+<dl><dt><strong>nickname</strong> = None</dl>
+
+<dl><dt><strong>quotacurrent</strong> = None</dl>
+
+<dl><dt><strong>quotalimit</strong> = None</dl>
+
+<dl><dt><strong>thumbnail</strong> = None</dl>
+
+<dl><dt><strong>user</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserFeed">class <strong>UserFeed</strong></a>(<a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>, <a href="gdata.photos.html#UserData">UserData</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Feed for a <a href="#User">User</a> in the google photos api.<br>
+ <br>
+This feed represents a user as the container for other objects.<br>
+ <br>
+A <a href="#User">User</a> feed contains entries of<br>
+<a href="#AlbumEntry">AlbumEntry</a>, <a href="#PhotoEntry">PhotoEntry</a>, <a href="#CommentEntry">CommentEntry</a>, <a href="#UserEntry">UserEntry</a> or <a href="#TagEntry">TagEntry</a>,<br>
+depending on the `kind' parameter in the original query.<br>
+ <br>
+The user feed itself also contains all of the metadata available<br>
+as part of a <a href="#UserData">UserData</a> <a href="__builtin__.html#object">object</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#UserFeed">UserFeed</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="gdata.photos.html#UserData">UserData</a></dd>
+<dd><a href="gdata.photos.html#GPhotosBaseData">GPhotosBaseData</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="UserFeed-GetAlbumsUri"><strong>GetAlbumsUri</strong></a>(self)</dt><dd><tt>Get the uri to this feed, but with entries of the <a href="#AlbumEntry">AlbumEntry</a> kind.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetCommentsUri"><strong>GetCommentsUri</strong></a>(self)</dt><dd><tt>Get the uri to this feed, but with entries of the CommentsEntry kind.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetPhotosUri"><strong>GetPhotosUri</strong></a>(self)</dt><dd><tt>Get the uri to this feed, but with entries of the PhotosEntry kind.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetTagsUri"><strong>GetTagsUri</strong></a>(self)</dt><dd><tt>Get the uri to this feed, but with entries of the <a href="#TagEntry">TagEntry</a> kind.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.photos.html#GPhotosBaseFeed">GPhotosBaseFeed</a>:<br>
+<dl><dt><a name="UserFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="UserFeed-kind"><strong>kind</strong></a>(self)</dt><dd><tt>(string) Returns the kind</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="UserFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="UserFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="UserFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link <a href="__builtin__.html#object">object</a> with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="UserFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.photos.html#UserData">UserData</a>:<br>
+<dl><dt><strong>gphoto_id</strong> = None</dl>
+
+<dl><dt><strong>maxPhotosPerAlbum</strong> = None</dl>
+
+<dl><dt><strong>nickname</strong> = None</dl>
+
+<dl><dt><strong>quotacurrent</strong> = None</dl>
+
+<dl><dt><strong>quotalimit</strong> = None</dl>
+
+<dl><dt><strong>thumbnail</strong> = None</dl>
+
+<dl><dt><strong>user</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Version">class <strong>Version</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Version">Version</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Version">Version</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Version-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Version-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Version-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Version-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Version-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Version-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Weight">class <strong>Weight</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Weight">Weight</a>' element.<br>
+ <br>
+The weight of the tag is the number of times the tag<br>
+appears in the collection of tags currently being viewed.<br>
+The default weight is 1, in which case this tags is omitted.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Weight">Weight</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Weight-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Weight-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Weight-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Weight-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Weight-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Weight-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Width">class <strong>Width</strong></a>(<a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Photo `<a href="#Width">Width</a>' element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.html#Width">Width</a></dd>
+<dd><a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.photos.html#PhotosBaseElement">PhotosBaseElement</a>:<br>
+<dl><dt><a name="Width-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Width-__int__"><strong>__int__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Width-bool"><strong>bool</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Width-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom <a href="__builtin__.html#object">object</a> to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Width-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Width-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this <a href="__builtin__.html#object">object</a> whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-AccessFromString"><strong>AccessFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-AlbumEntryFromString"><strong>AlbumEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-AlbumFeedFromString"><strong>AlbumFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-AlbumidFromString"><strong>AlbumidFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-AnyEntryFromString"><strong>AnyEntryFromString</strong></a>(xml_string)</dt><dd><tt>Creates an instance of the appropriate entry class from the<br>
+ xml string contents.<br>
+ <br>
+Args:<br>
+ xml_string: str A string which contains valid XML. The root element<br>
+ of the XML string should match the tag and namespace of the desired<br>
+ class.<br>
+ <br>
+Returns:<br>
+ An instance of the target class with members assigned according to the<br>
+ contents of the XML - or a basic gdata.GDataEndry instance if it is<br>
+ impossible to determine the appropriate class (look for extra elements<br>
+ in <a href="gdata.html#GDataEntry">GDataEntry</a>'s .FindExtensions() and extension_elements[] ).</tt></dd></dl>
+ <dl><dt><a name="-AnyFeedFromString"><strong>AnyFeedFromString</strong></a>(xml_string)</dt><dd><tt>Creates an instance of the appropriate feed class from the<br>
+ xml string contents.<br>
+ <br>
+Args:<br>
+ xml_string: str A string which contains valid XML. The root element<br>
+ of the XML string should match the tag and namespace of the desired<br>
+ class.<br>
+ <br>
+Returns:<br>
+ An instance of the target class with members assigned according to the<br>
+ contents of the XML - or a basic gdata.<a href="gdata.html#GDataFeed">GDataFeed</a> instance if it is<br>
+ impossible to determine the appropriate class (look for extra elements<br>
+ in <a href="gdata.html#GDataFeed">GDataFeed</a>'s .FindExtensions() and extension_elements[] ).</tt></dd></dl>
+ <dl><dt><a name="-BytesUsedFromString"><strong>BytesUsedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ChecksumFromString"><strong>ChecksumFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ClientFromString"><strong>ClientFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CommentAuthorFromString"><strong>CommentAuthorFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CommentCountFromString"><strong>CommentCountFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CommentEntryFromString"><strong>CommentEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CommentFeedFromString"><strong>CommentFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CommentingEnabledFromString"><strong>CommentingEnabledFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-HeightFromString"><strong>HeightFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-IdFromString"><strong>IdFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-LocationFromString"><strong>LocationFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-MaxPhotosPerAlbumFromString"><strong>MaxPhotosPerAlbumFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-NameFromString"><strong>NameFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-NicknameFromString"><strong>NicknameFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-NumphotosFromString"><strong>NumphotosFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-NumphotosremainingFromString"><strong>NumphotosremainingFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PhotoEntryFromString"><strong>PhotoEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PhotoFeedFromString"><strong>PhotoFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PhotoidFromString"><strong>PhotoidFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PositionFromString"><strong>PositionFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-QuotacurrentFromString"><strong>QuotacurrentFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-QuotalimitFromString"><strong>QuotalimitFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-RotationFromString"><strong>RotationFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SizeFromString"><strong>SizeFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SnippetFromString"><strong>SnippetFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SnippettypeFromString"><strong>SnippettypeFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TagEntryFromString"><strong>TagEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TagFeedFromString"><strong>TagFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ThumbnailFromString"><strong>ThumbnailFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TimestampFromString"><strong>TimestampFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-TruncatedFromString"><strong>TruncatedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-UserEntryFromString"><strong>UserEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-UserFeedFromString"><strong>UserFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-UserFromString"><strong>UserFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-VersionFromString"><strong>VersionFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-WeightFromString"><strong>WeightFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-WidthFromString"><strong>WidthFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>BATCH_NAMESPACE</strong> = 'http://schemas.google.com/gdata/batch'<br>
+<strong>EXIF_NAMESPACE</strong> = 'http://schemas.google.com/photos/exif/2007'<br>
+<strong>GEORSS_NAMESPACE</strong> = 'http://www.georss.org/georss'<br>
+<strong>GEO_NAMESPACE</strong> = 'http://www.w3.org/2003/01/geo/wgs84_pos#'<br>
+<strong>GML_NAMESPACE</strong> = 'http://www.opengis.net/gml'<br>
+<strong>MEDIA_NAMESPACE</strong> = 'http://search.yahoo.com/mrss/'<br>
+<strong>OPENSEARCH_NAMESPACE</strong> = 'http://a9.com/-/spec/opensearchrss/1.0/'<br>
+<strong>PHEED_NAMESPACE</strong> = 'http://www.pheed.com/pheed/'<br>
+<strong>PHOTOS_NAMESPACE</strong> = 'http://schemas.google.com/photos/2007'<br>
+<strong>__author__</strong> = u'havard@gulldahl.no'<br>
+<strong>__license__</strong> = 'Apache License v2'<br>
+<strong>__version__</strong> = '164'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">havard@gulldahl.no</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.photos.service.html b/pydocs/gdata.photos.service.html
new file mode 100644
index 0000000..d451c12
--- /dev/null
+++ b/pydocs/gdata.photos.service.html
@@ -0,0 +1,1027 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.photos.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.photos.html"><font color="#ffffff">photos</font></a>.service</strong></big></big> (version 176)</font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/photos/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/photos/service.py</a></font></td></tr></table>
+ <p><tt>Google PhotoService provides a human-friendly interface to<br>
+Google Photo (a.k.a Picasa Web) services[1].<br>
+ <br>
+It extends gdata.service.<a href="gdata.service.html#GDataService">GDataService</a> and as such hides all the<br>
+nasty details about authenticating, parsing and communicating with<br>
+Google Photos. <br>
+ <br>
+[1]: <a href="http://code.google.com/apis/picasaweb/gdata.html">http://code.google.com/apis/picasaweb/gdata.html</a><br>
+ <br>
+Example:<br>
+ import gdata.photos, gdata.photos.service<br>
+ pws = gdata.photos.service.<a href="#PhotosService">PhotosService</a>()<br>
+ pws.ClientLogin(username, password)<br>
+ #Get all albums<br>
+ albums = pws.GetUserFeed().entry<br>
+ # Get all photos in second album<br>
+ photos = pws.GetFeed(albums[1].GetPhotosUri()).entry<br>
+ # Get all tags for photos in second album and print them<br>
+ tags = pws.GetFeed(albums[1].GetTagsUri()).entry<br>
+ print [ tag.summary.text for tag in tags ]<br>
+ # Get all comments for the first photos in list and print them<br>
+ comments = pws.GetCommentFeed(photos[0].GetCommentsUri()).entry<br>
+ print [ c.summary.text for c in comments ]<br>
+ <br>
+ # Get a photo to work with<br>
+ photo = photos[0]<br>
+ # Update metadata<br>
+ <br>
+ # Attributes from the <gphoto:*> namespace<br>
+ photo.summary.text = u'A nice view from my veranda'<br>
+ photo.title.text = u'Verandaview.jpg'<br>
+ <br>
+ # Attributes from the <media:*> namespace<br>
+ photo.media.keywords.text = u'Home, Long-exposure, Sunset' # Comma-separated<br>
+ <br>
+ # Adding attributes to media object<br>
+ <br>
+ # Rotate 90 degrees clockwise<br>
+ photo.rotation = gdata.photos.Rotation(text='90') <br>
+ <br>
+ # Submit modified photo object<br>
+ photo = pws.UpdatePhotoMetadata(photo)<br>
+ <br>
+ # Make sure you only modify the newly returned object, else you'll get<br>
+ # versioning errors. See Optimistic-concurrency<br>
+ <br>
+ # Add comment to a picture<br>
+ comment = pws.InsertComment(photo, u'I wish the water always was this warm')<br>
+ <br>
+ # Remove comment because it was silly<br>
+ print "*blush*"<br>
+ pws.Delete(comment.GetEditLink().href)</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="StringIO.html">StringIO</a><br>
+<a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="time.html">time</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.service.html#GooglePhotosException">GooglePhotosException</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.photos.service.html#PhotosService">PhotosService</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GooglePhotosException">class <strong>GooglePhotosException</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.service.html#GooglePhotosException">GooglePhotosException</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GooglePhotosException-__init__"><strong>__init__</strong></a>(self, response)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#GooglePhotosException-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="GooglePhotosException-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#GooglePhotosException-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="GooglePhotosException-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#GooglePhotosException-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="GooglePhotosException-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#GooglePhotosException-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="GooglePhotosException-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#GooglePhotosException-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="GooglePhotosException-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="GooglePhotosException-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#GooglePhotosException-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="GooglePhotosException-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#GooglePhotosException-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="GooglePhotosException-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="GooglePhotosException-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#GooglePhotosException-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="GooglePhotosException-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PhotosService">class <strong>PhotosService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.photos.service.html#PhotosService">PhotosService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="PhotosService-Delete"><strong>Delete</strong></a>(self, object_or_uri, *args, **kwargs)</dt><dd><tt>Delete an object.<br>
+ <br>
+Re-implementing the <a href="gdata.service.html#GDataService">GDataService</a>.Delete method, to add some<br>
+convenience.<br>
+ <br>
+Arguments:<br>
+object_or_uri: Any object that has a GetEditLink() method that<br>
+ returns a link, or a uri to that object.<br>
+ <br>
+Returns:<br>
+? or <a href="#GooglePhotosException">GooglePhotosException</a> on errors</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GetContacts"><strong>GetContacts</strong></a>(self, user<font color="#909090">='default'</font>, limit<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a feed that contains a list of your contacts<br>
+ <br>
+Arguments:<br>
+user: Username of the user whose contacts you want<br>
+ <br>
+Returns<br>
+gdata.photos.UserFeed, with UserEntry entries<br>
+ <br>
+See:<br>
+<a href="http://groups.google.com/group/Google-Picasa-Data-API/msg/819b0025b5ff5e38">http://groups.google.com/group/Google-Picasa-Data-API/msg/819b0025b5ff5e38</a></tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GetEntry"><strong>GetEntry</strong></a>(self, uri, limit<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>)</dt><dd><tt>Get an Entry.<br>
+ <br>
+Arguments:<br>
+uri: the uri to the entry<br>
+limit (optional): the maximum number of entries to return. Defaults to what<br>
+ the server returns.<br>
+ <br>
+Returns:<br>
+one of gdata.photos.AlbumEntry,<br>
+ gdata.photos.UserEntry,<br>
+ gdata.photos.PhotoEntry,<br>
+ gdata.photos.CommentEntry,<br>
+ gdata.photos.TagEntry,<br>
+ depending on the results of the query.<br>
+Raises:<br>
+<a href="#GooglePhotosException">GooglePhotosException</a></tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GetFeed"><strong>GetFeed</strong></a>(self, uri, limit<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>)</dt><dd><tt>Get a feed.<br>
+ <br>
+ The results are ordered by the values of their `updated' elements,<br>
+ with the most recently updated entry appearing first in the feed.<br>
+ <br>
+Arguments:<br>
+uri: the uri to fetch<br>
+limit (optional): the maximum number of entries to return. Defaults to what<br>
+ the server returns.<br>
+ <br>
+Returns:<br>
+one of gdata.photos.AlbumFeed,<br>
+ gdata.photos.UserFeed,<br>
+ gdata.photos.PhotoFeed,<br>
+ gdata.photos.CommentFeed,<br>
+ gdata.photos.TagFeed,<br>
+ depending on the results of the query.<br>
+Raises:<br>
+<a href="#GooglePhotosException">GooglePhotosException</a><br>
+ <br>
+See:<br>
+<a href="http://code.google.com/apis/picasaweb/gdata.html#Get_Album_Feed_Manual">http://code.google.com/apis/picasaweb/gdata.html#Get_Album_Feed_Manual</a></tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GetTaggedPhotos"><strong>GetTaggedPhotos</strong></a>(self, tag, user<font color="#909090">='default'</font>, limit<font color="#909090">=None</font>)</dt><dd><tt>Get all photos belonging to a specific user, tagged by the given keyword<br>
+ <br>
+Arguments:<br>
+tag: The tag you're looking for, e.g. `dog'<br>
+user (optional): Whose images/videos you want to search, defaults<br>
+ to current user<br>
+limit (optional): the maximum number of entries to return.<br>
+ Defaults to everything the server returns.<br>
+ <br>
+Returns:<br>
+gdata.photos.UserFeed containing PhotoEntry elements</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GetUserFeed"><strong>GetUserFeed</strong></a>(self, kind<font color="#909090">='album'</font>, user<font color="#909090">='default'</font>, limit<font color="#909090">=None</font>)</dt><dd><tt>Get user-based feed, containing albums, photos, comments or tags;<br>
+ defaults to albums.<br>
+ <br>
+The entries are ordered by the values of their `updated' elements,<br>
+with the most recently updated entry appearing first in the feed.<br>
+ <br>
+Arguments:<br>
+kind: the kind of entries to get, either `album', `photo',<br>
+ `comment' or `tag', or a python list of these. Defaults to `album'.<br>
+user (optional): whose albums we're querying. Defaults to current user.<br>
+limit (optional): the maximum number of entries to return.<br>
+ Defaults to everything the server returns.<br>
+ <br>
+ <br>
+Returns:<br>
+gdata.photos.UserFeed, containing appropriate Entry elements<br>
+ <br>
+See:<br>
+<a href="http://code.google.com/apis/picasaweb/gdata.html#Get_Album_Feed_Manual">http://code.google.com/apis/picasaweb/gdata.html#Get_Album_Feed_Manual</a><br>
+<a href="http://googledataapis.blogspot.com/2007/07/picasa-web-albums-adds-new-api-features.html">http://googledataapis.blogspot.com/2007/07/picasa-web-albums-adds-new-api-features.html</a></tt></dd></dl>
+
+<dl><dt><a name="PhotosService-InsertAlbum"><strong>InsertAlbum</strong></a>(self, title, summary, location<font color="#909090">=None</font>, access<font color="#909090">='public'</font>, commenting_enabled<font color="#909090">='true'</font>, timestamp<font color="#909090">=None</font>)</dt><dd><tt>Add an album.<br>
+ <br>
+Needs authentication, see <a href="#PhotosService-ClientLogin">ClientLogin</a>()<br>
+ <br>
+Arguments:<br>
+title: Album title <br>
+summary: Album summary / description<br>
+access (optional): `private' or `public'. Public albums are searchable<br>
+ by everyone on the internet. Defaults to `public'<br>
+commenting_enabled (optional): `true' or `false'. Defaults to `true'.<br>
+timestamp (optional): A date and time for the album, in milliseconds since<br>
+ Unix epoch[1] UTC. Defaults to now.<br>
+ <br>
+Returns:<br>
+The newly created gdata.photos.AlbumEntry<br>
+ <br>
+See:<br>
+<a href="http://code.google.com/apis/picasaweb/gdata.html#Add_Album_Manual_Installed">http://code.google.com/apis/picasaweb/gdata.html#Add_Album_Manual_Installed</a><br>
+ <br>
+[1]: <a href="http://en.wikipedia.org/wiki/Unix_epoch">http://en.wikipedia.org/wiki/Unix_epoch</a></tt></dd></dl>
+
+<dl><dt><a name="PhotosService-InsertComment"><strong>InsertComment</strong></a>(self, photo_or_uri, comment)</dt><dd><tt>Add a comment to a photo.<br>
+ <br>
+Needs authentication, see <a href="#PhotosService-ClientLogin">ClientLogin</a>()<br>
+ <br>
+Arguments:<br>
+photo_or_uri: a gdata.photos.PhotoEntry that is about to be commented<br>
+ , or a `post' uri pointing to it<br>
+(string) comment: The actual comment<br>
+ <br>
+Returns:<br>
+The new gdata.photos.CommentEntry<br>
+ <br>
+Example:<br>
+p = <a href="#PhotosService-GetFeed">GetFeed</a>(PhotoUri)<br>
+tag = <a href="#PhotosService-InsertComment">InsertComment</a>(p, 'OOOH! I would have loved to be there.<br>
+ Who's that in the back?')</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-InsertPhoto"><strong>InsertPhoto</strong></a>(self, album_or_uri, photo, filename_or_handle, content_type<font color="#909090">='image/jpeg'</font>)</dt><dd><tt>Add a PhotoEntry<br>
+ <br>
+Needs authentication, see <a href="#PhotosService-ClientLogin">ClientLogin</a>()<br>
+ <br>
+Arguments:<br>
+album_or_uri: AlbumFeed or uri of the album where the photo should go<br>
+photo: PhotoEntry to add<br>
+filename_or_handle: A file-like object or file name where the image/video<br>
+ will be read from<br>
+content_type (optional): Internet media type (a.k.a. mime type) of<br>
+ media object. Currently Google Photos supports these types:<br>
+ o image/bmp<br>
+ o image/gif<br>
+ o image/jpeg<br>
+ o image/png<br>
+ <br>
+ Images will be converted to jpeg on upload. Defaults to `image/jpeg'</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-InsertPhotoSimple"><strong>InsertPhotoSimple</strong></a>(self, album_or_uri, title, summary, filename_or_handle, content_type<font color="#909090">='image/jpeg'</font>, keywords<font color="#909090">=None</font>)</dt><dd><tt>Add a photo without constructing a PhotoEntry.<br>
+ <br>
+Needs authentication, see <a href="#PhotosService-ClientLogin">ClientLogin</a>()<br>
+ <br>
+Arguments:<br>
+album_or_uri: AlbumFeed or uri of the album where the photo should go<br>
+title: Photo title<br>
+summary: Photo summary / description<br>
+filename_or_handle: A file-like object or file name where the image/video<br>
+ will be read from<br>
+content_type (optional): Internet media type (a.k.a. mime type) of<br>
+ media object. Currently Google Photos supports these types:<br>
+ o image/bmp<br>
+ o image/gif<br>
+ o image/jpeg<br>
+ o image/png<br>
+ <br>
+ Images will be converted to jpeg on upload. Defaults to `image/jpeg'<br>
+keywords (optional): a 1) comma separated string or 2) a python list() of<br>
+ keywords (a.k.a. tags) to add to the image.<br>
+ E.g. 1) `dog, vacation, happy' 2) ['dog', 'happy', 'vacation']<br>
+ <br>
+Returns:<br>
+The newly created gdata.photos.PhotoEntry or <a href="#GooglePhotosException">GooglePhotosException</a> on errors<br>
+ <br>
+See:<br>
+<a href="http://code.google.com/apis/picasaweb/gdata.html#Add_Album_Manual_Installed">http://code.google.com/apis/picasaweb/gdata.html#Add_Album_Manual_Installed</a><br>
+[1]: <a href="http://en.wikipedia.org/wiki/Unix_epoch">http://en.wikipedia.org/wiki/Unix_epoch</a></tt></dd></dl>
+
+<dl><dt><a name="PhotosService-InsertTag"><strong>InsertTag</strong></a>(self, photo_or_uri, tag)</dt><dd><tt>Add a tag (a.k.a. keyword) to a photo.<br>
+ <br>
+Needs authentication, see <a href="#PhotosService-ClientLogin">ClientLogin</a>()<br>
+ <br>
+Arguments:<br>
+photo_or_uri: a gdata.photos.PhotoEntry that will be tagged, or a<br>
+ `post' uri pointing to it<br>
+(string) tag: The tag/keyword<br>
+ <br>
+Returns:<br>
+The new gdata.photos.TagEntry<br>
+ <br>
+Example:<br>
+p = <a href="#PhotosService-GetFeed">GetFeed</a>(PhotoUri)<br>
+tag = <a href="#PhotosService-InsertTag">InsertTag</a>(p, 'Beautiful sunsets')</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-SearchCommunityPhotos"><strong>SearchCommunityPhotos</strong></a>(self, query, limit<font color="#909090">=100</font>)</dt><dd><tt>Search through all public photos and return a feed.<br>
+This will look for matches in file names and image tags (a.k.a. keywords)<br>
+ <br>
+Arguments:<br>
+query: The string you're looking for, e.g. `vacation'<br>
+limit (optional): Don't return more than `limit' hits, defaults to 100<br>
+ <br>
+Returns:<br>
+gdata.GDataFeed with PhotoEntry elements</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-SearchContactsPhotos"><strong>SearchContactsPhotos</strong></a>(self, user<font color="#909090">='default'</font>, search<font color="#909090">=None</font>, limit<font color="#909090">=None</font>)</dt><dd><tt>Search over your contacts' photos and return a feed<br>
+ <br>
+Arguments:<br>
+user: Username of the user whose contacts you want<br>
+search (optional): What to search for (photo title, description and keywords)<br>
+ <br>
+Returns<br>
+gdata.photos.UserFeed, with PhotoEntry elements<br>
+ <br>
+See:<br>
+<a href="http://groups.google.com/group/Google-Picasa-Data-API/msg/819b0025b5ff5e38">http://groups.google.com/group/Google-Picasa-Data-API/msg/819b0025b5ff5e38</a></tt></dd></dl>
+
+<dl><dt><a name="PhotosService-SearchUserPhotos"><strong>SearchUserPhotos</strong></a>(self, query, user<font color="#909090">='default'</font>, limit<font color="#909090">=100</font>)</dt><dd><tt>Search through all photos for a specific user and return a feed.<br>
+This will look for matches in file names and image tags (a.k.a. keywords)<br>
+ <br>
+Arguments:<br>
+query: The string you're looking for, e.g. `vacation'<br>
+user (optional): The username of whose photos you want to search, defaults<br>
+ to current user.<br>
+limit (optional): Don't return more than `limit' hits, defaults to 100<br>
+ <br>
+Only public photos are searched, unless you are authenticated and<br>
+searching through your own photos.<br>
+ <br>
+Returns:<br>
+gdata.photos.UserFeed with PhotoEntry elements</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-UpdatePhotoBlob"><strong>UpdatePhotoBlob</strong></a>(self, photo_or_uri, filename_or_handle, content_type<font color="#909090">='image/jpeg'</font>)</dt><dd><tt>Update a photo's binary data.<br>
+ <br>
+Needs authentication, see <a href="#PhotosService-ClientLogin">ClientLogin</a>()<br>
+ <br>
+Arguments:<br>
+photo_or_uri: a gdata.photos.PhotoEntry that will be updated, or a<br>
+ `edit-media' uri pointing to it<br>
+filename_or_handle: A file-like object or file name where the image/video<br>
+ will be read from<br>
+content_type (optional): Internet media type (a.k.a. mime type) of<br>
+ media object. Currently Google Photos supports these types:<br>
+ o image/bmp<br>
+ o image/gif<br>
+ o image/jpeg<br>
+ o image/png<br>
+Images will be converted to jpeg on upload. Defaults to `image/jpeg'<br>
+ <br>
+Returns:<br>
+The modified gdata.photos.PhotoEntry<br>
+ <br>
+Example:<br>
+p = <a href="#PhotosService-GetFeed">GetFeed</a>(PhotoUri)<br>
+p = <a href="#PhotosService-UpdatePhotoBlob">UpdatePhotoBlob</a>(p, '/tmp/newPic.jpg')<br>
+ <br>
+It is important that you don't keep the old object around, once<br>
+it has been updated. See<br>
+<a href="http://code.google.com/apis/gdata/reference.html#Optimistic-concurrency">http://code.google.com/apis/gdata/reference.html#Optimistic-concurrency</a></tt></dd></dl>
+
+<dl><dt><a name="PhotosService-UpdatePhotoMetadata"><strong>UpdatePhotoMetadata</strong></a>(self, photo)</dt><dd><tt>Update a photo's metadata. <br>
+ <br>
+Needs authentication, see <a href="#PhotosService-ClientLogin">ClientLogin</a>()<br>
+ <br>
+You can update any or all of the following metadata properties:<br>
+ * <title><br>
+ * <media:description><br>
+ * <gphoto:checksum><br>
+ * <gphoto:client><br>
+ * <gphoto:rotation><br>
+ * <gphoto:timestamp><br>
+ * <gphoto:commentingEnabled><br>
+ <br>
+ Arguments:<br>
+ photo: a gdata.photos.PhotoEntry object with updated elements<br>
+ <br>
+ Returns:<br>
+ The modified gdata.photos.PhotoEntry<br>
+ <br>
+ Example:<br>
+ p = <a href="#PhotosService-GetFeed">GetFeed</a>(uri).entry[0]<br>
+ p.title.text = u'My new text'<br>
+ p.commentingEnabled.text = 'false'<br>
+ p = <a href="#PhotosService-UpdatePhotoMetadata">UpdatePhotoMetadata</a>(p)<br>
+ <br>
+ It is important that you don't keep the old object around, once<br>
+ it has been updated. See<br>
+ <a href="http://code.google.com/apis/gdata/reference.html#Optimistic-concurrency">http://code.google.com/apis/gdata/reference.html#Optimistic-concurrency</a></tt></dd></dl>
+
+<dl><dt><a name="PhotosService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='picasaweb.google.com'</font>, additional_headers<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a client for the Google Photos service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'picasaweb.google.com'.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<dl><dt><strong>userUri</strong> = '/data/feed/api/user/%s'</dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="PhotosService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PhotosService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#PhotosService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ Error if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#PhotosService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#PhotosService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="PhotosService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="PhotosService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-ConvertAtomTimestampToEpoch"><strong>ConvertAtomTimestampToEpoch</strong></a>(timestamp)</dt><dd><tt>Helper function to convert a timestamp string, for instance<br>
+from atom:updated or atom:published, to milliseconds since Unix epoch<br>
+(a.k.a. POSIX time).<br>
+ <br>
+`2007-07-22T00:45:10.000Z' -></tt></dd></dl>
+ <dl><dt><a name="-GetSmallestThumbnail"><strong>GetSmallestThumbnail</strong></a>(media_thumbnail_list)</dt><dd><tt>Helper function to get the smallest thumbnail of a list of<br>
+ gdata.media.Thumbnail.<br>
+Returns gdata.media.Thumbnail</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GPHOTOS_BAD_REQUEST</strong> = 400<br>
+<strong>GPHOTOS_CONFLICT</strong> = 409<br>
+<strong>GPHOTOS_INTERNAL_SERVER_ERROR</strong> = 500<br>
+<strong>GPHOTOS_INVALID_ARGUMENT</strong> = 601<br>
+<strong>GPHOTOS_INVALID_CONTENT_TYPE</strong> = 602<br>
+<strong>GPHOTOS_INVALID_KIND</strong> = 604<br>
+<strong>GPHOTOS_NOT_AN_IMAGE</strong> = 603<br>
+<strong>SUPPORTED_UPLOAD_TYPES</strong> = ('bmp', 'jpeg', 'jpg', 'gif', 'png')<br>
+<strong>UNKOWN_ERROR</strong> = 1000<br>
+<strong>__author__</strong> = u'havard@gulldahl.no'<br>
+<strong>__license__</strong> = 'Apache License v2'<br>
+<strong>__version__</strong> = '176'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">havard@gulldahl.no</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.projecthosting.client.html b/pydocs/gdata.projecthosting.client.html
new file mode 100644
index 0000000..a2f2070
--- /dev/null
+++ b/pydocs/gdata.projecthosting.client.html
@@ -0,0 +1,706 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.projecthosting.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.projecthosting.html"><font color="#ffffff">projecthosting</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/projecthosting/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/projecthosting/client.py</a></font></td></tr></table>
+ <p><tt># Copyright 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.projecthosting.client.html#ProjectHostingClient">ProjectHostingClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#Query">gdata.client.Query</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.projecthosting.client.html#Query">Query</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ProjectHostingClient">class <strong>ProjectHostingClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client to interact with the Project Hosting GData API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.client.html#ProjectHostingClient">ProjectHostingClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ProjectHostingClient-add_issue"><strong>add_issue</strong></a>(self, project_name, title, content, author, status<font color="#909090">=None</font>, owner<font color="#909090">=None</font>, labels<font color="#909090">=None</font>, ccs<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Create a new issue for the project.<br>
+ <br>
+Args:<br>
+ project_name str The name of the project.<br>
+ title str The title of the new issue.<br>
+ content str The summary of the new issue.<br>
+ author str The authenticated user's username.<br>
+ status str The status of the new issue, Accepted, etc.<br>
+ owner str The username of new issue's owner.<br>
+ labels [str] Labels to associate with the new issue.<br>
+ ccs [str] usernames to Cc on the new issue.<br>
+Returns:<br>
+ data.IssueEntry</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt><dd><tt>Unsupported GData delete method.<br>
+ <br>
+Use <a href="#ProjectHostingClient-update_issue">update_issue</a>(status='Closed') instead.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-get_comments"><strong>get_comments</strong></a>(self, project_name, issue_id, desired_class<font color="#909090">=<class 'gdata.projecthosting.data.CommentsFeed'></font>, **kwargs)</dt><dd><tt>Get a feed of all updates to an issue.<br>
+ <br>
+Args:<br>
+ project_name str The name of the issue's project.<br>
+ issue_id str The issue number needing updated.<br>
+ <br>
+Returns:<br>
+ data.CommentsFeed</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-get_issues"><strong>get_issues</strong></a>(self, project_name, desired_class<font color="#909090">=<class 'gdata.projecthosting.data.IssuesFeed'></font>, **kwargs)</dt><dd><tt>Get a feed of issues for a particular project.<br>
+ <br>
+Args:<br>
+ project_name str The name of the project.<br>
+ query <a href="#Query">Query</a> Set returned issues parameters.<br>
+ <br>
+Returns:<br>
+ data.IssuesFeed</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt><dd><tt>Unsupported GData update method.<br>
+ <br>
+Use update_*() instead.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-update_issue"><strong>update_issue</strong></a>(self, project_name, issue_id, author, comment<font color="#909090">=None</font>, summary<font color="#909090">=None</font>, status<font color="#909090">=None</font>, owner<font color="#909090">=None</font>, labels<font color="#909090">=None</font>, ccs<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Update or comment on one issue for the project.<br>
+ <br>
+Args:<br>
+ project_name str The name of the issue's project.<br>
+ issue_id str The issue number needing updated.<br>
+ author str The authenticated user's username.<br>
+ comment str A comment to append to the issue<br>
+ summary str Rewrite the summary of the issue.<br>
+ status str A new status for the issue.<br>
+ owner str The username of the new owner.<br>
+ labels [str] Labels to set on the issue (prepend issue with - to remove a<br>
+ label).<br>
+ ccs [str] Ccs to set on th enew issue (prepend cc with - to remove a cc).<br>
+ <br>
+Returns:<br>
+ data.CommentEntry</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '1.0'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('http://code.google.com/feeds/issues',)</dl>
+
+<dl><dt><strong>auth_service</strong> = 'code'</dl>
+
+<dl><dt><strong>host</strong> = 'code.google.com'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="ProjectHostingClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProjectHostingClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProjectHostingClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProjectHostingClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProjectHostingClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ProjectHostingClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProjectHostingClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProjectHostingClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ProjectHostingClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ProjectHostingClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="ProjectHostingClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-__init__"><strong>__init__</strong></a>(self, http_client<font color="#909090">=None</font>, host<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, source<font color="#909090">=None</font>, xoauth_requestor_id<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new AtomPubClient instance.<br>
+ <br>
+Args:<br>
+ source: The name of your application.<br>
+ http_client: An object capable of performing HTTP requests through a<br>
+ request method. This object is used to perform the request<br>
+ when the AtomPubClient's request method is called. Used to<br>
+ allow HTTP requests to be directed to a mock server, or use<br>
+ an alternate library instead of the default of httplib to<br>
+ make HTTP requests.<br>
+ host: str The default host name to use if a host is not specified in the<br>
+ requested URI.<br>
+ auth_token: An object which sets the HTTP Authorization header when its<br>
+ modify_request method is called.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="ProjectHostingClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Query">class <strong>Query</strong></a>(<a href="gdata.client.html#Query">gdata.client.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.client.html#Query">Query</a></dd>
+<dd><a href="gdata.client.html#Query">gdata.client.Query</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Query-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#Query-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="Query-__init__"><strong>__init__</strong></a>(self, issue_id<font color="#909090">=None</font>, label<font color="#909090">=None</font>, canned_query<font color="#909090">=None</font>, owner<font color="#909090">=None</font>, status<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a Google Data <a href="#Query">Query</a> to filter feed contents serverside.<br>
+Args:<br>
+ issue_id: int or str The issue to return based on the issue id.<br>
+ label: str A label returned issues must have.<br>
+ canned_query: str Return issues based on a canned query identifier<br>
+ owner: str Return issues based on the owner of the issue. For Gmail users,<br>
+ this will be the part of the email preceding the '@' sign.<br>
+ status: str Return issues based on the status of the issue.</tt></dd></dl>
+
+<dl><dt><a name="Query-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><a name="Query-AddCustomParameter"><strong>AddCustomParameter</strong></a> = add_custom_parameter(self, key, value)</dt></dl>
+
+<dl><dt><a name="Query-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.projecthosting.data.html b/pydocs/gdata.projecthosting.data.html
new file mode 100644
index 0000000..2f7f9fa
--- /dev/null
+++ b/pydocs/gdata.projecthosting.data.html
@@ -0,0 +1,3193 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.projecthosting.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.projecthosting.html"><font color="#ffffff">projecthosting</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/projecthosting/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/projecthosting/data.py</a></font></td></tr></table>
+ <p><tt>Provides classes and constants for XML in the Google Project Hosting API.<br>
+ <br>
+Canonical documentation for the raw XML which these classes represent can be<br>
+found here: <a href="http://code.google.com/p/support/wiki/IssueTrackerAPI">http://code.google.com/p/support/wiki/IssueTrackerAPI</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#Cc">Cc</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#CcUpdate">CcUpdate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#Label">Label</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#Owner">Owner</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#OwnerUpdate">OwnerUpdate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#Stars">Stars</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#State">State</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#Status">Status</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#Summary">Summary</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#Updates">Updates</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#Uri">Uri</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#Username">Username</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#CommentEntry">CommentEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#IssueEntry">IssueEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#CommentsFeed">CommentsFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.projecthosting.data.html#IssuesFeed">IssuesFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Cc">class <strong>Cc</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:cc element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#Cc">Cc</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>uri</strong> = <class 'gdata.projecthosting.data.Uri'><dd><tt>The issues:uri element.</tt></dl>
+
+<dl><dt><strong>username</strong> = <class 'gdata.projecthosting.data.Username'><dd><tt>The issues:username element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Cc-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Cc-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Cc-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Cc-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Cc-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Cc-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Cc-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Cc-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Cc-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Cc-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CcUpdate">class <strong>CcUpdate</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:ccUpdate element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#CcUpdate">CcUpdate</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CcUpdate-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CcUpdate-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CcUpdate-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CcUpdate-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CcUpdate-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CcUpdate-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CcUpdate-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CcUpdate-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CcUpdate-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CcUpdate-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentEntry">class <strong>CommentEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An entry detailing one comment on an issue.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#CommentEntry">CommentEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>updates</strong> = <class 'gdata.projecthosting.data.Updates'><dd><tt>The issues:updates element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CommentEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CommentEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CommentEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CommentEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CommentEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentsFeed">class <strong>CommentsFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom feed listing a project's issue's comments.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#CommentsFeed">CommentsFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.projecthosting.data.CommentEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CommentsFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CommentsFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CommentsFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CommentsFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CommentsFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CommentsFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentsFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="IssueEntry">class <strong>IssueEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents the information of one issue.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#IssueEntry">IssueEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>cc</strong> = [<class 'gdata.projecthosting.data.Cc'>]</dl>
+
+<dl><dt><strong>label</strong> = [<class 'gdata.projecthosting.data.Label'>]</dl>
+
+<dl><dt><strong>owner</strong> = <class 'gdata.projecthosting.data.Owner'><dd><tt>The issues:owner element.</tt></dl>
+
+<dl><dt><strong>stars</strong> = <class 'gdata.projecthosting.data.Stars'><dd><tt>The issues:stars element.</tt></dl>
+
+<dl><dt><strong>state</strong> = <class 'gdata.projecthosting.data.State'><dd><tt>The issues:state element.</tt></dl>
+
+<dl><dt><strong>status</strong> = <class 'gdata.projecthosting.data.Status'><dd><tt>The issues:status element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="IssueEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="IssueEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="IssueEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="IssueEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="IssueEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="IssueEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssueEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="IssuesFeed">class <strong>IssuesFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom feed listing a project's issues.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#IssuesFeed">IssuesFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.projecthosting.data.IssueEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="IssuesFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="IssuesFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="IssuesFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="IssuesFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="IssuesFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="IssuesFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IssuesFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Label">class <strong>Label</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:label element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#Label">Label</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Label-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Label-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Label-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Label-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Label-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Label-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Label-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Label-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Label-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Label-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Owner">class <strong>Owner</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:owner element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#Owner">Owner</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>uri</strong> = <class 'gdata.projecthosting.data.Uri'><dd><tt>The issues:uri element.</tt></dl>
+
+<dl><dt><strong>username</strong> = <class 'gdata.projecthosting.data.Username'><dd><tt>The issues:username element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Owner-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Owner-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Owner-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Owner-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Owner-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Owner-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Owner-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Owner-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Owner-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Owner-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="OwnerUpdate">class <strong>OwnerUpdate</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:ownerUpdate element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#OwnerUpdate">OwnerUpdate</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="OwnerUpdate-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OwnerUpdate-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OwnerUpdate-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OwnerUpdate-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OwnerUpdate-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="OwnerUpdate-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="OwnerUpdate-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="OwnerUpdate-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="OwnerUpdate-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="OwnerUpdate-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Stars">class <strong>Stars</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:stars element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#Stars">Stars</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Stars-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Stars-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Stars-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Stars-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Stars-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Stars-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Stars-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Stars-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Stars-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Stars-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="State">class <strong>State</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:state element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#State">State</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="State-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="State-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="State-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="State-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="State-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="State-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="State-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="State-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="State-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="State-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Status">class <strong>Status</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:status element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#Status">Status</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Status-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Status-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Status-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Status-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Status-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Status-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Status-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Summary">class <strong>Summary</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:summary element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#Summary">Summary</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Summary-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Summary-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Summary-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Summary-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Summary-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Summary-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Updates">class <strong>Updates</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:updates element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#Updates">Updates</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>ccUpdate</strong> = [<class 'gdata.projecthosting.data.CcUpdate'>]</dl>
+
+<dl><dt><strong>label</strong> = [<class 'gdata.projecthosting.data.Label'>]</dl>
+
+<dl><dt><strong>ownerUpdate</strong> = <class 'gdata.projecthosting.data.OwnerUpdate'><dd><tt>The issues:ownerUpdate element.</tt></dl>
+
+<dl><dt><strong>status</strong> = <class 'gdata.projecthosting.data.Status'><dd><tt>The issues:status element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'gdata.projecthosting.data.Summary'><dd><tt>The issues:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Updates-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Updates-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Updates-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Updates-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Updates-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Updates-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Updates-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Updates-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Updates-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Updates-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Uri">class <strong>Uri</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:uri element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#Uri">Uri</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Uri-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Uri-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Uri-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Uri-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Uri-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Uri-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Uri-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Uri-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Uri-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Uri-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Username">class <strong>Username</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The issues:username element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.projecthosting.data.html#Username">Username</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Username-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Username-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Username-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Username-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Username-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Username-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Username-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Username-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Username-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Username-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>COMMENTS_FULL_FEED</strong> = '/feeds/issues/p/%s/issues/%s/comments/full'<br>
+<strong>ISSUES_FULL_FEED</strong> = '/feeds/issues/p/%s/issues/full'<br>
+<strong>ISSUES_TEMPLATE</strong> = '{http://schemas.google.com/projecthosting/issues/2009}%s'<br>
+<strong>__author__</strong> = 'jlapenna@google.com (Joe LaPenna)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">jlapenna@google.com (Joe LaPenna)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.projecthosting.html b/pydocs/gdata.projecthosting.html
new file mode 100644
index 0000000..2a1db41
--- /dev/null
+++ b/pydocs/gdata.projecthosting.html
@@ -0,0 +1,23 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.projecthosting</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.projecthosting</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/projecthosting/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/projecthosting/__init__.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.projecthosting.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.projecthosting.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.sample_util.html b/pydocs/gdata.sample_util.html
new file mode 100644
index 0000000..370f256
--- /dev/null
+++ b/pydocs/gdata.sample_util.html
@@ -0,0 +1,97 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.sample_util</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.sample_util</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/sample_util.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/sample_util.py</a></font></td></tr></table>
+ <p><tt>Provides utility functions used with command line samples.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="getpass.html">getpass</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.sample_util.html#SettingsUtil">SettingsUtil</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SettingsUtil">class <strong>SettingsUtil</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Gather's user preferences from flags or command prompts.<br>
+ <br>
+An instance of this <a href="__builtin__.html#object">object</a> stores the choices made by the user. At some<br>
+point it might be useful to save the user's preferences so that they do<br>
+not need to always set flags or answer preference prompts.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="SettingsUtil-__init__"><strong>__init__</strong></a>(self, prefs<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="SettingsUtil-authorize_client"><strong>authorize_client</strong></a>(self, client, auth_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, source<font color="#909090">=None</font>, scopes<font color="#909090">=None</font>, oauth_type<font color="#909090">=None</font>, consumer_key<font color="#909090">=None</font>, consumer_secret<font color="#909090">=None</font>)</dt><dd><tt>Uses command line arguments, or prompts user for token values.</tt></dd></dl>
+
+<dl><dt><a name="SettingsUtil-get_param"><strong>get_param</strong></a>(self, name, prompt<font color="#909090">=''</font>, secret<font color="#909090">=False</font>, ask<font color="#909090">=True</font>, reuse<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-authorize_client"><strong>authorize_client</strong></a>(client, auth_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, source<font color="#909090">=None</font>, scopes<font color="#909090">=None</font>, oauth_type<font color="#909090">=None</font>, consumer_key<font color="#909090">=None</font>, consumer_secret<font color="#909090">=None</font>)</dt><dd><tt>Uses command line arguments, or prompts user for token values.</tt></dd></dl>
+ <dl><dt><a name="-get_param"><strong>get_param</strong></a>(name, prompt<font color="#909090">=''</font>, secret<font color="#909090">=False</font>, ask<font color="#909090">=True</font>)</dt></dl>
+ <dl><dt><a name="-print_options"><strong>print_options</strong></a>()</dt><dd><tt>Displays usage information, available command line params.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>AUTHSUB</strong> = 2<br>
+<strong>CLIENT_LOGIN</strong> = 1<br>
+<strong>HMAC</strong> = 1<br>
+<strong>OAUTH</strong> = 3<br>
+<strong>RSA</strong> = 2<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.service.html b/pydocs/gdata.service.html
new file mode 100644
index 0000000..69aa884
--- /dev/null
+++ b/pydocs/gdata.service.html
@@ -0,0 +1,1864 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/service.py</a></font></td></tr></table>
+ <p><tt><a href="#GDataService">GDataService</a> provides CRUD ops. and programmatic login for GData services.<br>
+ <br>
+<a href="#Error">Error</a>: A base exception class for all exceptions in the gdata_client<br>
+ module.<br>
+ <br>
+<a href="#CaptchaRequired">CaptchaRequired</a>: This exception is thrown when a login attempt results in a<br>
+ captcha challenge from the ClientLogin service. When this<br>
+ exception is thrown, the captcha_token and captcha_url are<br>
+ set to the values provided in the server's response.<br>
+ <br>
+<a href="#BadAuthentication">BadAuthentication</a>: Raised when a login attempt is made with an incorrect<br>
+ username or password.<br>
+ <br>
+<a href="#NotAuthenticated">NotAuthenticated</a>: Raised if an operation requiring authentication is called<br>
+ before a user has authenticated.<br>
+ <br>
+<a href="#NonAuthSubToken">NonAuthSubToken</a>: Raised if a method to modify an AuthSub token is used when<br>
+ the user is either not authenticated or is authenticated<br>
+ through another authentication mechanism.<br>
+ <br>
+<a href="#NonOAuthToken">NonOAuthToken</a>: Raised if a method to modify an OAuth token is used when the<br>
+ user is either not authenticated or is authenticated through<br>
+ another authentication mechanism.<br>
+ <br>
+<a href="#RequestError">RequestError</a>: Raised if a CRUD request returned a non-success code.<br>
+ <br>
+<a href="#UnexpectedReturnType">UnexpectedReturnType</a>: Raised if the response from the server was not of the<br>
+ desired type. For example, this would be raised if the<br>
+ server sent a feed when the client requested an entry.<br>
+ <br>
+<a href="#GDataService">GDataService</a>: Encapsulates user credentials needed to perform insert, update<br>
+ and delete operations with the GData API. An instance can<br>
+ perform user authentication, query, insertion, deletion, and <br>
+ update.<br>
+ <br>
+<a href="#Query">Query</a>: Eases query URI creation by allowing URI parameters to be set as <br>
+ dictionary attributes. For example a query with a feed of <br>
+ '/base/feeds/snippets' and ['bq'] set to 'digital camera' will <br>
+ produce '/base/feeds/snippets?bq=digital+camera' when .ToUri() is <br>
+ called on it.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="xml.etree.cElementTree.html">xml.etree.cElementTree</a><br>
+<a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+<a href="atom.service.html">atom.service</a><br>
+</td><td width="25%" valign=top><a href="re.html">re</a><br>
+<a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top><a href="urlparse.html">urlparse</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#dict">__builtin__.dict</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Query">Query</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.service.html#AtomService">atom.service.AtomService</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">GDataService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#AuthorizationRequired">AuthorizationRequired</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.service.html#BadAuthentication">BadAuthentication</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.service.html#BadAuthenticationServiceURL">BadAuthenticationServiceURL</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.service.html#CaptchaRequired">CaptchaRequired</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.service.html#NonAuthSubToken">NonAuthSubToken</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.service.html#NonOAuthToken">NonOAuthToken</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.service.html#NotAuthenticated">NotAuthenticated</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.service.html#RanOutOfTries">RanOutOfTries</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.service.html#RequestError">RequestError</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#FetchingOAuthRequestTokenFailed">FetchingOAuthRequestTokenFailed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.service.html#RevokingOAuthTokenFailed">RevokingOAuthTokenFailed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.service.html#TokenUpgradeFailed">TokenUpgradeFailed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#TokenHadNoScope">TokenHadNoScope</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.service.html#UnexpectedReturnType">UnexpectedReturnType</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AuthorizationRequired">class <strong>AuthorizationRequired</strong></a>(<a href="gdata.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#AuthorizationRequired">AuthorizationRequired</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="AuthorizationRequired-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#AuthorizationRequired-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#AuthorizationRequired-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="AuthorizationRequired-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#AuthorizationRequired-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="AuthorizationRequired-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#AuthorizationRequired-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="AuthorizationRequired-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#AuthorizationRequired-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="AuthorizationRequired-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#AuthorizationRequired-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="AuthorizationRequired-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="AuthorizationRequired-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#AuthorizationRequired-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="AuthorizationRequired-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#AuthorizationRequired-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="AuthorizationRequired-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="AuthorizationRequired-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#AuthorizationRequired-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="AuthorizationRequired-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BadAuthentication">class <strong>BadAuthentication</strong></a>(<a href="gdata.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#BadAuthentication">BadAuthentication</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="BadAuthentication-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#BadAuthentication-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="BadAuthentication-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="BadAuthentication-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="BadAuthentication-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthentication-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="BadAuthentication-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BadAuthenticationServiceURL">class <strong>BadAuthenticationServiceURL</strong></a>(<a href="gdata.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#BadAuthenticationServiceURL">BadAuthenticationServiceURL</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="BadAuthenticationServiceURL-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#BadAuthenticationServiceURL-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="BadAuthenticationServiceURL-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#BadAuthenticationServiceURL-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="BadAuthenticationServiceURL-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CaptchaRequired">class <strong>CaptchaRequired</strong></a>(<a href="gdata.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#CaptchaRequired">CaptchaRequired</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="CaptchaRequired-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#CaptchaRequired-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="CaptchaRequired-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="CaptchaRequired-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="CaptchaRequired-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FetchingOAuthRequestTokenFailed">class <strong>FetchingOAuthRequestTokenFailed</strong></a>(<a href="gdata.service.html#RequestError">RequestError</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#FetchingOAuthRequestTokenFailed">FetchingOAuthRequestTokenFailed</a></dd>
+<dd><a href="gdata.service.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="FetchingOAuthRequestTokenFailed-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#FetchingOAuthRequestTokenFailed-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#FetchingOAuthRequestTokenFailed-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="FetchingOAuthRequestTokenFailed-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#FetchingOAuthRequestTokenFailed-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="FetchingOAuthRequestTokenFailed-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#FetchingOAuthRequestTokenFailed-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="FetchingOAuthRequestTokenFailed-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#FetchingOAuthRequestTokenFailed-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="FetchingOAuthRequestTokenFailed-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#FetchingOAuthRequestTokenFailed-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="FetchingOAuthRequestTokenFailed-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="FetchingOAuthRequestTokenFailed-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#FetchingOAuthRequestTokenFailed-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="FetchingOAuthRequestTokenFailed-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#FetchingOAuthRequestTokenFailed-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="FetchingOAuthRequestTokenFailed-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="FetchingOAuthRequestTokenFailed-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#FetchingOAuthRequestTokenFailed-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="FetchingOAuthRequestTokenFailed-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GDataService">class <strong>GDataService</strong></a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Contains elements needed for GData login and CRUD request headers.<br>
+ <br>
+Maintains additional headers (tokens for example) needed for the GData <br>
+services to allow a user to perform inserts, updates, and deletes.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#GDataService">GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GDataService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ <a href="#NonAuthSubToken">NonAuthSubToken</a> if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="GDataService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="GDataService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: <a href="__builtin__.html#dict">dict</a> (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: <a href="__builtin__.html#dict">dict</a> (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: <a href="__builtin__.html#dict">dict</a> (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ <a href="#FetchingOAuthRequestTokenFailed">FetchingOAuthRequestTokenFailed</a> if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: <a href="__builtin__.html#dict">dict</a> (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ <a href="#NonOAuthToken">NonOAuthToken</a> if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="GDataService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GDataService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#GDataService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ <a href="#RanOutOfTries">RanOutOfTries</a> on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: <a href="__builtin__.html#dict">dict</a> (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: <a href="__builtin__.html#dict">dict</a> (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="GDataService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: <a href="__builtin__.html#dict">dict</a> (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: <a href="__builtin__.html#dict">dict</a> (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="GDataService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a <a href="#CaptchaRequired">CaptchaRequired</a> error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ <a href="#CaptchaRequired">CaptchaRequired</a> if the login service will require a captcha response<br>
+ <a href="#BadAuthentication">BadAuthentication</a> if the login service rejected the username or password<br>
+ <a href="#Error">Error</a> if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="GDataService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: <a href="__builtin__.html#dict">dict</a> (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: <a href="__builtin__.html#dict">dict</a> (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="GDataService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ <a href="#NonAuthSubToken">NonAuthSubToken</a> if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="GDataService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ <a href="#NonOAuthToken">NonOAuthToken</a> if the user's auth token is not an OAuth token.<br>
+ <a href="#RevokingOAuthTokenFailed">RevokingOAuthTokenFailed</a> if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#GDataService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#GDataService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ <a href="#NonOAuthToken">NonOAuthToken</a> if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ <a href="#TokenUpgradeFailed">TokenUpgradeFailed</a> if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ <a href="#NonAuthSubToken">NonAuthSubToken</a> if the user's auth token is not an AuthSub token<br>
+ <a href="#TokenUpgradeFailed">TokenUpgradeFailed</a> if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">=None</font>, additional_headers<font color="#909090">=None</font>, handler<font color="#909090">=None</font>, tokens<font color="#909090">=None</font>, http_client<font color="#909090">=None</font>, token_store<font color="#909090">=None</font>)</dt><dd><tt>Creates an object of type <a href="#GDataService">GDataService</a>.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ account_type: string (optional) The type of account to use. Use<br>
+ 'GOOGLE' for regular Google accounts or 'HOSTED' for Google<br>
+ Apps accounts, or 'HOSTED_OR_GOOGLE' to try finding a HOSTED<br>
+ account first and, if it doesn't exist, try finding a regular<br>
+ GOOGLE account. Default value: 'HOSTED_OR_GOOGLE'.<br>
+ service: string (optional) The desired service for which credentials<br>
+ will be obtained.<br>
+ auth_service_url: string (optional) User-defined auth token request URL<br>
+ allows users to explicitly specify where to send auth token requests.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'base.google.com'.<br>
+ additional_headers: dictionary (optional) Any additional headers which <br>
+ should be included with CRUD operations.<br>
+ handler: module (optional) This parameter is deprecated and has been<br>
+ replaced by http_client.<br>
+ tokens: This parameter is deprecated, calls should be made to <br>
+ token_store instead.<br>
+ http_client: An object responsible for making HTTP requests using a<br>
+ request method. If none is provided, a new instance of<br>
+ atom.http.ProxiedHttpClient will be used.<br>
+ token_store: Keeps a collection of authorization tokens which can be<br>
+ applied to requests for a specific URLs. Critical methods are<br>
+ find_token based on a URL (atom.url.Url or a string), add_token,<br>
+ and remove_token.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ <a href="#TokenUpgradeFailed">TokenUpgradeFailed</a> if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="GDataService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="GDataService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="GDataService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NonAuthSubToken">class <strong>NonAuthSubToken</strong></a>(<a href="gdata.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#NonAuthSubToken">NonAuthSubToken</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="NonAuthSubToken-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#NonAuthSubToken-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#NonAuthSubToken-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="NonAuthSubToken-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NonAuthSubToken-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="NonAuthSubToken-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#NonAuthSubToken-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="NonAuthSubToken-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#NonAuthSubToken-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="NonAuthSubToken-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#NonAuthSubToken-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="NonAuthSubToken-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NonAuthSubToken-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#NonAuthSubToken-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="NonAuthSubToken-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NonAuthSubToken-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="NonAuthSubToken-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NonAuthSubToken-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#NonAuthSubToken-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="NonAuthSubToken-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NonOAuthToken">class <strong>NonOAuthToken</strong></a>(<a href="gdata.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#NonOAuthToken">NonOAuthToken</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="NonOAuthToken-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#NonOAuthToken-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#NonOAuthToken-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="NonOAuthToken-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NonOAuthToken-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="NonOAuthToken-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#NonOAuthToken-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="NonOAuthToken-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#NonOAuthToken-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="NonOAuthToken-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#NonOAuthToken-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="NonOAuthToken-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NonOAuthToken-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#NonOAuthToken-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="NonOAuthToken-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NonOAuthToken-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="NonOAuthToken-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NonOAuthToken-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#NonOAuthToken-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="NonOAuthToken-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NotAuthenticated">class <strong>NotAuthenticated</strong></a>(<a href="gdata.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#NotAuthenticated">NotAuthenticated</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="NotAuthenticated-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#NotAuthenticated-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#NotAuthenticated-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="NotAuthenticated-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotAuthenticated-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="NotAuthenticated-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#NotAuthenticated-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="NotAuthenticated-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#NotAuthenticated-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="NotAuthenticated-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#NotAuthenticated-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="NotAuthenticated-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NotAuthenticated-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotAuthenticated-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="NotAuthenticated-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#NotAuthenticated-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="NotAuthenticated-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="NotAuthenticated-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#NotAuthenticated-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="NotAuthenticated-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Query">class <strong>Query</strong></a>(<a href="__builtin__.html#dict">__builtin__.dict</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Constructs a query URL to be used in GET requests<br>
+ <br>
+Url parameters are created by adding key-value pairs to this object as a <br>
+<a href="__builtin__.html#dict">dict</a>. For example, to add &max-results=25 to the URL do<br>
+my_query['max-results'] = 25<br>
+ <br>
+Category queries are created by adding category strings to the categories<br>
+member. All items in the categories list will be concatenated with the /<br>
+symbol (symbolizing a category x AND y restriction). If you would like to OR<br>
+2 categories, append them as one string with a | between the categories. <br>
+For example, do query.categories.append('Fritz|Laurie') to create a query<br>
+like this feed/-/Fritz%7CLaurie . This query will look for results in both<br>
+categories.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#Query">Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Query-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Query-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="#Query">Query</a><br>
+ <br>
+Args:<br>
+ feed: str (optional) The path for the feed (Examples: <br>
+ '/base/feeds/snippets' or 'calendar/feeds/jo@gmail.com/private/full'<br>
+ text_query: str (optional) The contents of the q query parameter. The<br>
+ contents of the text_query are URL escaped upon conversion to a URI.<br>
+ params: <a href="__builtin__.html#dict">dict</a> (optional) Parameter value string pairs which become URL<br>
+ params when translated to a URI. These parameters are added to the<br>
+ query's items (key-value pairs).<br>
+ categories: list (optional) List of category strings which should be<br>
+ included as query categories. See <br>
+ <a href="http://code.google.com/apis/gdata/reference.html#Queries">http://code.google.com/apis/gdata/reference.html#Queries</a> for <br>
+ details. If you want to get results from category A or B (both <br>
+ categories), specify a single list item 'A|B'.</tt></dd></dl>
+
+<dl><dt><a name="Query-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="Query-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="Query-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#Query-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="Query-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="Query-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="Query-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="Query-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Query-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Query-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="Query-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="Query-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="Query-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="Query-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="Query-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="Query-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Query-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Query-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="Query-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#Query-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="Query-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#Query-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="Query-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#Query-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="Query-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt><a href="__builtin__.html#dict">dict</a>.<a href="#Query-fromkeys">fromkeys</a>(S[,v]) -> New <a href="__builtin__.html#dict">dict</a> with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="Query-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#Query-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="Query-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#Query-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="Query-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#Query-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="Query-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#Query-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="Query-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#Query-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="Query-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#Query-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="Query-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#Query-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="Query-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#Query-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="Query-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#Query-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="Query-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#Query-setdefault">setdefault</a>(k[,d]) -> D.<a href="#Query-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="Query-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#Query-update">update</a>([E, ]**F) -> None. Update D from <a href="__builtin__.html#dict">dict</a>/iterable E and F.<br>
+If E present and has a .<a href="#Query-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#Query-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="Query-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#Query-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="Query-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#Query-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="Query-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#Query-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="Query-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#Query-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Query-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RanOutOfTries">class <strong>RanOutOfTries</strong></a>(<a href="gdata.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#RanOutOfTries">RanOutOfTries</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="RanOutOfTries-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RanOutOfTries-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RanOutOfTries-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="RanOutOfTries-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RanOutOfTries-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="RanOutOfTries-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RanOutOfTries-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RanOutOfTries-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RanOutOfTries-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RanOutOfTries-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RanOutOfTries-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RanOutOfTries-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RanOutOfTries-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RanOutOfTries-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RanOutOfTries-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RanOutOfTries-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="RanOutOfTries-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RanOutOfTries-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RanOutOfTries-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="RanOutOfTries-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RequestError">class <strong>RequestError</strong></a>(<a href="gdata.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="RequestError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RequestError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="RequestError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RevokingOAuthTokenFailed">class <strong>RevokingOAuthTokenFailed</strong></a>(<a href="gdata.service.html#RequestError">RequestError</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#RevokingOAuthTokenFailed">RevokingOAuthTokenFailed</a></dd>
+<dd><a href="gdata.service.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="RevokingOAuthTokenFailed-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RevokingOAuthTokenFailed-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RevokingOAuthTokenFailed-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="RevokingOAuthTokenFailed-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RevokingOAuthTokenFailed-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="RevokingOAuthTokenFailed-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RevokingOAuthTokenFailed-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RevokingOAuthTokenFailed-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RevokingOAuthTokenFailed-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RevokingOAuthTokenFailed-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RevokingOAuthTokenFailed-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RevokingOAuthTokenFailed-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RevokingOAuthTokenFailed-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RevokingOAuthTokenFailed-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RevokingOAuthTokenFailed-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RevokingOAuthTokenFailed-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="RevokingOAuthTokenFailed-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RevokingOAuthTokenFailed-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RevokingOAuthTokenFailed-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="RevokingOAuthTokenFailed-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TokenHadNoScope">class <strong>TokenHadNoScope</strong></a>(<a href="gdata.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#TokenHadNoScope">TokenHadNoScope</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TokenHadNoScope-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenHadNoScope-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TokenHadNoScope-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TokenHadNoScope-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenHadNoScope-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TokenHadNoScope-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenHadNoScope-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TokenHadNoScope-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenHadNoScope-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TokenHadNoScope-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenHadNoScope-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TokenHadNoScope-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TokenHadNoScope-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenHadNoScope-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TokenHadNoScope-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenHadNoScope-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TokenHadNoScope-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TokenHadNoScope-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenHadNoScope-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TokenHadNoScope-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TokenUpgradeFailed">class <strong>TokenUpgradeFailed</strong></a>(<a href="gdata.service.html#RequestError">RequestError</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#TokenUpgradeFailed">TokenUpgradeFailed</a></dd>
+<dd><a href="gdata.service.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TokenUpgradeFailed-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenUpgradeFailed-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TokenUpgradeFailed-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TokenUpgradeFailed-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenUpgradeFailed-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TokenUpgradeFailed-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenUpgradeFailed-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TokenUpgradeFailed-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenUpgradeFailed-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TokenUpgradeFailed-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenUpgradeFailed-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TokenUpgradeFailed-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TokenUpgradeFailed-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenUpgradeFailed-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TokenUpgradeFailed-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenUpgradeFailed-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TokenUpgradeFailed-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TokenUpgradeFailed-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TokenUpgradeFailed-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TokenUpgradeFailed-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UnexpectedReturnType">class <strong>UnexpectedReturnType</strong></a>(<a href="gdata.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.service.html#UnexpectedReturnType">UnexpectedReturnType</a></dd>
+<dd><a href="gdata.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="UnexpectedReturnType-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#UnexpectedReturnType-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#UnexpectedReturnType-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="UnexpectedReturnType-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnexpectedReturnType-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="UnexpectedReturnType-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#UnexpectedReturnType-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="UnexpectedReturnType-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#UnexpectedReturnType-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="UnexpectedReturnType-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#UnexpectedReturnType-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="UnexpectedReturnType-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="UnexpectedReturnType-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnexpectedReturnType-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="UnexpectedReturnType-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#UnexpectedReturnType-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="UnexpectedReturnType-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="UnexpectedReturnType-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#UnexpectedReturnType-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="UnexpectedReturnType-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-ExtractToken"><strong>ExtractToken</strong></a>(url, scopes_included_in_next<font color="#909090">=True</font>)</dt><dd><tt>Gets the AuthSub token from the current page's URL.<br>
+ <br>
+Designed to be used on the URL that the browser is sent to after the user<br>
+authorizes this application at the page given by GenerateAuthSubRequestUrl.<br>
+ <br>
+Args:<br>
+ url: The current page's URL. It should contain the token as a URL<br>
+ parameter. Example: '<a href="http://example.com/?...&token=abcd435">http://example.com/?...&token=abcd435</a>'<br>
+ scopes_included_in_next: If True, this function looks for a scope value<br>
+ associated with the token. The scope is a URL parameter with the<br>
+ key set to SCOPE_URL_PARAM_NAME. This parameter should be present<br>
+ if the AuthSub request URL was generated using<br>
+ GenerateAuthSubRequestUrl with include_scope_in_next set to True.<br>
+ <br>
+Returns:<br>
+ A tuple containing the token string and a list of scope strings for which<br>
+ this token should be valid. If the scope was not included in the URL, the<br>
+ tuple will contain (token, None).</tt></dd></dl>
+ <dl><dt><a name="-GenerateAuthSubRequestUrl"><strong>GenerateAuthSubRequestUrl</strong></a>(next, scopes, hd<font color="#909090">='default'</font>, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRequest'</font>, include_scopes_in_next<font color="#909090">=True</font>)</dt><dd><tt>Creates a URL to request an AuthSub token to access Google services.<br>
+ <br>
+For more details on AuthSub, see the documentation here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: The URL where the browser should be sent after the user authorizes<br>
+ the application. This page is responsible for receiving the token<br>
+ which is embeded in the URL as a parameter.<br>
+ scopes: The base URL to which access will be granted. Example:<br>
+ '<a href="http://www.google.com/calendar/feeds">http://www.google.com/calendar/feeds</a>' will grant access to all<br>
+ URLs in the Google Calendar data API. If you would like a token for<br>
+ multiple scopes, pass in a list of URL strings.<br>
+ hd: The domain to which the user's account belongs. This is set to the<br>
+ domain name if you are using Google Apps. Example: 'example.org'<br>
+ Defaults to 'default'<br>
+ secure: If set to True, all requests should be signed. The default is<br>
+ False.<br>
+ session: If set to True, the token received by the 'next' URL can be<br>
+ upgraded to a multiuse session token. If session is set to False, the<br>
+ token may only be used once and cannot be upgraded. Default is True.<br>
+ request_url: The base of the URL to which the user will be sent to<br>
+ authorize this application to access their data. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRequest'.<br>
+ include_scopes_in_next: Boolean if set to true, the 'next' parameter will<br>
+ be modified to include the requested scope as a URL parameter. The<br>
+ key for the next's scope parameter will be SCOPE_URL_PARAM_NAME. The<br>
+ benefit of including the scope URL as a parameter to the next URL, is<br>
+ that the page which receives the AuthSub token will be able to tell<br>
+ which URLs the token grants access to.<br>
+ <br>
+Returns:<br>
+ A URL string to which the browser should be sent.</tt></dd></dl>
+ <dl><dt><a name="-lookup_scopes"><strong>lookup_scopes</strong></a>(service_name)</dt><dd><tt>Finds the scope URLs for the desired service.<br>
+ <br>
+In some cases, an unknown service may be used, and in those cases this<br>
+function will return None.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>AUTH_SERVER_HOST</strong> = 'https://www.google.com'<br>
+<strong>CLIENT_LOGIN_SCOPES</strong> = {'analytics': ('https://www.google.com/analytics/feeds/',), 'apps': ('https://apps-apis.google.com/a/feeds/user/', 'https://apps-apis.google.com/a/feeds/policies/', 'https://apps-apis.google.com/a/feeds/alias/', 'https://apps-apis.google.com/a/feeds/groups/', 'https://apps-apis.google.com/a/feeds/compliance/audit/', 'https://apps-apis.google.com/a/feeds/migration/', 'https://apps-apis.google.com/a/feeds/emailsettings/2.0/'), 'blogger': ('http://www.blogger.com/feeds/',), 'books': ('http://www.google.com/books/feeds/',), 'cl': ('https://www.google.com/calendar/feeds/', 'http://www.google.com/calendar/feeds/'), 'code': ('http://code.google.com/feeds/issues',), 'codesearch': ('http://www.google.com/codesearch/feeds/',), 'cp': ('https://www.google.com/m8/feeds/', 'http://www.google.com/m8/feeds/'), 'finance': ('http://finance.google.com/finance/feeds/',), 'gbase': ('http://base.google.com/base/feeds/', 'http://www.google.com/base/feeds/'), ...}<br>
+<strong>DEFAULT_BACKOFF</strong> = 2<br>
+<strong>DEFAULT_DELAY</strong> = 1<br>
+<strong>DEFAULT_NUM_RETRIES</strong> = 3<br>
+<strong>OAUTH_SCOPE_URL_PARAM_NAME</strong> = 'oauth_token_scope'<br>
+<strong>SCOPE_URL_PARAM_NAME</strong> = 'authsub_token_scope'<br>
+<strong>__author__</strong> = 'api.jscudder (Jeffrey Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeffrey Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.sites.client.html b/pydocs/gdata.sites.client.html
new file mode 100644
index 0000000..6ee3804
--- /dev/null
+++ b/pydocs/gdata.sites.client.html
@@ -0,0 +1,819 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.sites.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.sites.html"><font color="#ffffff">sites</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/sites/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/sites/client.py</a></font></td></tr></table>
+ <p><tt><a href="#SitesClient">SitesClient</a> extends gdata.client.<a href="gdata.client.html#GDClient">GDClient</a> to streamline Sites API calls.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.sites.client.html#SitesClient">SitesClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitesClient">class <strong>SitesClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client extension for the Google Sites API service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.client.html#SitesClient">SitesClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SitesClient-CreatePage"><strong>CreatePage</strong></a> = <a href="#SitesClient-create_page">create_page</a>(self, kind, title, html<font color="#909090">=''</font>, page_name<font color="#909090">=None</font>, parent<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, template<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-CreateSite"><strong>CreateSite</strong></a> = <a href="#SitesClient-create_site">create_site</a>(self, title, description<font color="#909090">=None</font>, source_site<font color="#909090">=None</font>, theme<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-CreateWebAttachment"><strong>CreateWebAttachment</strong></a> = <a href="#SitesClient-create_webattachment">create_webattachment</a>(self, src, content_type, title, parent, description<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-DownloadAttachment"><strong>DownloadAttachment</strong></a> = <a href="#SitesClient-download_attachment">download_attachment</a>(self, uri_or_entry, file_path)</dt></dl>
+
+<dl><dt><a name="SitesClient-GetAclFeed"><strong>GetAclFeed</strong></a> = <a href="#SitesClient-get_acl_feed">get_acl_feed</a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-GetActivityFeed"><strong>GetActivityFeed</strong></a> = <a href="#SitesClient-get_activity_feed">get_activity_feed</a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-GetContentFeed"><strong>GetContentFeed</strong></a> = <a href="#SitesClient-get_content_feed">get_content_feed</a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-GetRevisionFeed"><strong>GetRevisionFeed</strong></a> = <a href="#SitesClient-get_revision_feed">get_revision_feed</a>(self, entry_or_uri_or_id, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-GetSiteFeed"><strong>GetSiteFeed</strong></a> = <a href="#SitesClient-get_site_feed">get_site_feed</a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-MakeAclFeedUri"><strong>MakeAclFeedUri</strong></a> = <a href="#SitesClient-make_acl_feed_uri">make_acl_feed_uri</a>(self)</dt></dl>
+
+<dl><dt><a name="SitesClient-MakeActivityFeedUri"><strong>MakeActivityFeedUri</strong></a> = <a href="#SitesClient-make_activity_feed_uri">make_activity_feed_uri</a>(self)</dt></dl>
+
+<dl><dt><a name="SitesClient-MakeContentFeedUri"><strong>MakeContentFeedUri</strong></a> = <a href="#SitesClient-make_content_feed_uri">make_content_feed_uri</a>(self)</dt></dl>
+
+<dl><dt><a name="SitesClient-MakeRevisionFeedUri"><strong>MakeRevisionFeedUri</strong></a> = <a href="#SitesClient-make_revision_feed_uri">make_revision_feed_uri</a>(self)</dt></dl>
+
+<dl><dt><a name="SitesClient-MakeSiteFeedUri"><strong>MakeSiteFeedUri</strong></a> = <a href="#SitesClient-make_site_feed_uri">make_site_feed_uri</a>(self, site_name<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="SitesClient-UploadAttachment"><strong>UploadAttachment</strong></a> = <a href="#SitesClient-upload_attachment">upload_attachment</a>(self, file_handle, parent, content_type<font color="#909090">=None</font>, title<font color="#909090">=None</font>, description<font color="#909090">=None</font>, folder_name<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-__init__"><strong>__init__</strong></a>(self, site<font color="#909090">=None</font>, domain<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Constructs a new client for the Sites API.<br>
+ <br>
+Args:<br>
+ site: string (optional) Name (webspace) of the Google Site<br>
+ domain: string (optional) Domain of the (Google Apps hosted) Site.<br>
+ If no domain is given, the Site is assumed to be a consumer Google<br>
+ Site, in which case the value 'site' is used.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the user's data.<br>
+ kwargs: The other parameters to pass to gdata.client.<a href="gdata.client.html#GDClient">GDClient</a><br>
+ constructor.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-create_page"><strong>create_page</strong></a>(self, kind, title, html<font color="#909090">=''</font>, page_name<font color="#909090">=None</font>, parent<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, template<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new page (specified by kind) on a Google Site.<br>
+ <br>
+Args:<br>
+ kind: string The type of page/item to create. For example, webpage,<br>
+ listpage, comment, announcementspage, filecabinet, etc. The full list<br>
+ of supported kinds can be found in gdata.sites.gdata.SUPPORT_KINDS.<br>
+ title: string Title for the page.<br>
+ html: string (optional) XHTML for the page's content body.<br>
+ page_name: string (optional) The URL page name to set. If not set, the<br>
+ title will be normalized and used as the page's URL path.<br>
+ parent: string or gdata.sites.data.ContentEntry (optional) The parent<br>
+ entry or parent link url to create the page under.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the user's data.<br>
+ template: string or gdata.sites.data.ContentEntry (optional) Create page<br>
+ using the given template. Any content elements will be discarded as<br>
+ they are not valid when creating a page from a template.<br>
+ kwargs: Other parameters to pass to gdata.client.<a href="#SitesClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.sites.data.ContentEntry of the created page.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-create_site"><strong>create_site</strong></a>(self, title, description<font color="#909090">=None</font>, source_site<font color="#909090">=None</font>, theme<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new Google Site.<br>
+ <br>
+Note: This feature is only available to Google Apps domains.<br>
+ <br>
+Args:<br>
+ title: string Title for the site.<br>
+ description: string (optional) A description/summary for the site.<br>
+ source_site: string (optional) The site feed URI of the site to copy.<br>
+ This parameter should only be specified when copying a site.<br>
+ theme: string (optional) The name of the theme to create the site with.<br>
+ uri: string (optional) A full site feed URI to override where the site<br>
+ is created/copied. By default, the site will be created under<br>
+ the currently set domain (e.g. self.<strong>domain</strong>).<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the user's data.<br>
+ kwargs: Other parameters to pass to gdata.client.<a href="#SitesClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.sites.data.SiteEntry of the created site.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-create_webattachment"><strong>create_webattachment</strong></a>(self, src, content_type, title, parent, description<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new webattachment within a filecabinet.<br>
+ <br>
+Args:<br>
+ src: string The url of the web attachment.<br>
+ content_type: string The MIME type of the web attachment.<br>
+ title: string The title to name the web attachment.<br>
+ parent: string or gdata.sites.data.ContentEntry (optional) The<br>
+ parent entry or url of the filecabinet to create the attachment under.<br>
+ description: string (optional) A summary/description for the attachment.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the user's data.<br>
+ kwargs: Other parameters to pass to gdata.client.<a href="#SitesClient-post">post</a>().<br>
+ <br>
+Returns:<br>
+ gdata.sites.data.ContentEntry of the created page.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-download_attachment"><strong>download_attachment</strong></a>(self, uri_or_entry, file_path)</dt><dd><tt>Downloads an attachment file to disk.<br>
+ <br>
+Args:<br>
+ uri_or_entry: string The full URL to download the file from.<br>
+ file_path: string The full path to save the file to.<br>
+ <br>
+Raises:<br>
+ gdata.client.RequestError: on error response from server.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-get_acl_feed"><strong>get_acl_feed</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves the acl feed containing a site's sharing permissions.<br>
+ <br>
+Args:<br>
+ uri: string (optional) A full URI to query the acl feed.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the user's data.<br>
+ kwargs: Other parameters to pass to <a href="#SitesClient-get_feed">get_feed</a>().<br>
+ <br>
+Returns:<br>
+ gdata.sites.data.AclFeed</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-get_activity_feed"><strong>get_activity_feed</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves the activity feed containing recent Site activity.<br>
+ <br>
+Args:<br>
+ uri: string (optional) A full URI to query the Activity feed.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the user's data.<br>
+ kwargs: Other parameters to pass to <a href="#SitesClient-get_feed">get_feed</a>().<br>
+ <br>
+Returns:<br>
+ gdata.sites.data.ActivityFeed</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-get_content_feed"><strong>get_content_feed</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves the content feed containing the current state of site.<br>
+ <br>
+Args:<br>
+ uri: string (optional) A full URI to query the Content feed with.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the user's data.<br>
+ kwargs: Other parameters to pass to <a href="#SitesClient-get_feed">get_feed</a>().<br>
+ <br>
+Returns:<br>
+ gdata.sites.data.ContentFeed</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-get_revision_feed"><strong>get_revision_feed</strong></a>(self, entry_or_uri_or_id, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves the revision feed containing the revision history for a node.<br>
+ <br>
+Args:<br>
+ entry_or_uri_or_id: string or gdata.sites.data.ContentEntry A full URI,<br>
+ content entry node ID, or a content entry object of the entry to<br>
+ retrieve revision information for.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the user's data.<br>
+ kwargs: Other parameters to pass to <a href="#SitesClient-get_feed">get_feed</a>().<br>
+ <br>
+Returns:<br>
+ gdata.sites.data.RevisionFeed</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-get_site_feed"><strong>get_site_feed</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves the site feed containing a list of sites a user has access to.<br>
+ <br>
+Args:<br>
+ uri: string (optional) A full URI to query the site feed.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the user's data.<br>
+ kwargs: Other parameters to pass to <a href="#SitesClient-get_feed">get_feed</a>().<br>
+ <br>
+Returns:<br>
+ gdata.sites.data.SiteFeed</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-make_acl_feed_uri"><strong>make_acl_feed_uri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesClient-make_activity_feed_uri"><strong>make_activity_feed_uri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesClient-make_content_feed_uri"><strong>make_content_feed_uri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesClient-make_revision_feed_uri"><strong>make_revision_feed_uri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesClient-make_site_feed_uri"><strong>make_site_feed_uri</strong></a>(self, site_name<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="SitesClient-upload_attachment"><strong>upload_attachment</strong></a>(self, file_handle, parent, content_type<font color="#909090">=None</font>, title<font color="#909090">=None</font>, description<font color="#909090">=None</font>, folder_name<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Uploads an attachment to a parent page.<br>
+ <br>
+Args:<br>
+ file_handle: MediaSource or string A gdata.data.MediaSource object<br>
+ containing the file to be uploaded or the full path name to the<br>
+ file on disk.<br>
+ parent: gdata.sites.data.ContentEntry or string The parent page to<br>
+ upload the file to or the full URI of the entry's self link.<br>
+ content_type: string (optional) The MIME type of the file<br>
+ (e.g 'application/pdf'). This should be provided if file is not a<br>
+ MediaSource object.<br>
+ title: string (optional) The title to name the attachment. If not<br>
+ included, the filepath or media source's filename is used.<br>
+ description: string (optional) A summary/description for the attachment.<br>
+ folder_name: string (optional) The name of an existing folder to upload<br>
+ the attachment to. This only applies when the parent parameter points<br>
+ to a filecabinet entry.<br>
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or<br>
+ OAuthToken which authorizes this client to edit the user's data.<br>
+ kwargs: Other parameters to pass to __upload().<br>
+ <br>
+Returns:<br>
+ A gdata.sites.data.ContentEntry containing information about the created<br>
+ attachment.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '1.1'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('http://sites.google.com/feeds/', 'https://sites.google.com/feeds/')</dl>
+
+<dl><dt><strong>auth_service</strong> = 'jotspot'</dl>
+
+<dl><dt><strong>domain</strong> = 'site'</dl>
+
+<dl><dt><strong>host</strong> = 'sites.google.com'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="SitesClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="SitesClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitesClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="SitesClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="SitesClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="SitesClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ACL_FEED_TEMPLATE</strong> = '/feeds/acl/site/%s/%s/'<br>
+<strong>ACTIVITY_FEED_TEMPLATE</strong> = '/feeds/activity/%s/%s/'<br>
+<strong>CONTENT_FEED_TEMPLATE</strong> = '/feeds/content/%s/%s/'<br>
+<strong>REVISION_FEED_TEMPLATE</strong> = '/feeds/revision/%s/%s/'<br>
+<strong>SITE_FEED_TEMPLATE</strong> = '/feeds/site/%s/'<br>
+<strong>__author__</strong> = 'e.bidelman (Eric Bidelman)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">e.bidelman (Eric Bidelman)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.sites.data.html b/pydocs/gdata.sites.data.html
new file mode 100644
index 0000000..f98839b
--- /dev/null
+++ b/pydocs/gdata.sites.data.html
@@ -0,0 +1,6037 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.sites.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.sites.html"><font color="#ffffff">sites</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/sites/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/sites/data.py</a></font></td></tr></table>
+ <p><tt><a href="#Data">Data</a> model classes for parsing and generating XML for the Sites <a href="#Data">Data</a> API.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.sites.data.html#Column">Column</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#Data">Data</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#Deleted">Deleted</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#Field">Field</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#Header">Header</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#InReplyTo">InReplyTo</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#PageName">PageName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#Publisher">Publisher</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#Revision">Revision</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#SiteName">SiteName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#Theme">Theme</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#Worksheet">Worksheet</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Content">atom.data.Content</a>(<a href="atom.data.html#Text">atom.data.Text</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.sites.data.html#Content">Content</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Summary">atom.data.Summary</a>(<a href="atom.data.html#Text">atom.data.Text</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.sites.data.html#Summary">Summary</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.sites.data.html#AclEntry">AclEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.acl.data.html#AclFeed">gdata.acl.data.AclFeed</a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.sites.data.html#AclFeed">AclFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.sites.data.html#BaseSiteEntry">BaseSiteEntry</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.sites.data.html#ActivityEntry">ActivityEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#ContentEntry">ContentEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#RevisionEntry">RevisionEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.sites.data.html#SiteEntry">SiteEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.sites.data.html#ActivityFeed">ActivityFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#ContentFeed">ContentFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#RevisionFeed">RevisionFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.sites.data.html#SiteFeed">SiteFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AclEntry">class <strong>AclEntry</strong></a>(<a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites ACL Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#AclEntry">AclEntry</a></dd>
+<dd><a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.acl.data.html#AclEntry">gdata.acl.data.AclEntry</a>:<br>
+<dl><dt><strong>additional_role</strong> = <class 'gdata.acl.data.AclAdditionalRole'><dd><tt>Describes an additionalRole element.</tt></dl>
+
+<dl><dt><strong>role</strong> = <class 'gdata.acl.data.AclRole'><dd><tt>Describes the role of an entry in an access control list.</tt></dl>
+
+<dl><dt><strong>scope</strong> = <class 'gdata.acl.data.AclScope'><dd><tt>Describes the scope of an entry in an access control list.</tt></dl>
+
+<dl><dt><strong>with_key</strong> = <class 'gdata.acl.data.AclWithKey'><dd><tt>Describes a key that can be used to access a document.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="AclEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="AclEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AclEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AclFeed">class <strong>AclFeed</strong></a>(<a href="gdata.acl.data.html#AclFeed">gdata.acl.data.AclFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites ACL Feed.<br>
+ <br>
+The ACL feed can be used to modify the sharing permissions of a Site.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#AclFeed">AclFeed</a></dd>
+<dd><a href="gdata.acl.data.html#AclFeed">gdata.acl.data.AclFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.sites.data.AclEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="AclFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="AclFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="AclFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="AclFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="AclFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AclFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ActivityEntry">class <strong>ActivityEntry</strong></a>(<a href="gdata.sites.data.html#BaseSiteEntry">BaseSiteEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites Activity Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#ActivityEntry">ActivityEntry</a></dd>
+<dd><a href="gdata.sites.data.html#BaseSiteEntry">BaseSiteEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>summary</strong> = <class 'gdata.sites.data.Summary'><dd><tt>Google Sites version of <atom:summary>.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.sites.data.html#BaseSiteEntry">BaseSiteEntry</a>:<br>
+<dl><dt><a name="ActivityEntry-FindParentLink"><strong>FindParentLink</strong></a> = find_parent_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-GetNodeId"><strong>GetNodeId</strong></a> = get_node_id(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-IsDeleted"><strong>IsDeleted</strong></a> = is_deleted(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-Kind"><strong>Kind</strong></a> = kind(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-__init__"><strong>__init__</strong></a>(self, kind<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-find_parent_link"><strong>find_parent_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-get_node_id"><strong>get_node_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-is_deleted"><strong>is_deleted</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-kind"><strong>kind</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="ActivityEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ActivityEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ActivityEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ActivityEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ActivityEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ActivityFeed">class <strong>ActivityFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites Activity Feed.<br>
+ <br>
+The Activity feed is a feed containing recent Site activity.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#ActivityFeed">ActivityFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.sites.data.ActivityEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ActivityFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ActivityFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ActivityFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ActivityFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ActivityFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ActivityFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ActivityFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BaseSiteEntry">class <strong>BaseSiteEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#BaseSiteEntry">BaseSiteEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="BaseSiteEntry-FindParentLink"><strong>FindParentLink</strong></a> = <a href="#BaseSiteEntry-find_parent_link">find_parent_link</a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetNodeId"><strong>GetNodeId</strong></a> = <a href="#BaseSiteEntry-get_node_id">get_node_id</a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-IsDeleted"><strong>IsDeleted</strong></a> = <a href="#BaseSiteEntry-is_deleted">is_deleted</a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-Kind"><strong>Kind</strong></a> = <a href="#BaseSiteEntry-kind">kind</a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-__init__"><strong>__init__</strong></a>(self, kind<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_parent_link"><strong>find_parent_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_node_id"><strong>get_node_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-is_deleted"><strong>is_deleted</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-kind"><strong>kind</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="BaseSiteEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="BaseSiteEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="BaseSiteEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="BaseSiteEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="BaseSiteEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Column">class <strong>Column</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites List Page <gs:column>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#Column">Column</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>index</strong> = 'index'</dl>
+
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Column-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Column-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Column-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Column-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Column-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Column-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Column-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Column-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Column-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Column-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Content">class <strong>Content</strong></a>(<a href="atom.data.html#Content">atom.data.Content</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites version of <atom:content> that encapsulates XHTML.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#Content">Content</a></dd>
+<dd><a href="atom.data.html#Content">atom.data.Content</a></dd>
+<dd><a href="atom.data.html#Text">atom.data.Text</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Content-__init__"><strong>__init__</strong></a>(self, html<font color="#909090">=None</font>, type<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>html</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Content">atom.data.Content</a>:<br>
+<dl><dt><strong>src</strong> = 'src'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Text">atom.data.Text</a>:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Content-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Content-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Content-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Content-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Content-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Content-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContentEntry">class <strong>ContentEntry</strong></a>(<a href="gdata.sites.data.html#BaseSiteEntry">BaseSiteEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites <a href="#Content">Content</a> Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#ContentEntry">ContentEntry</a></dd>
+<dd><a href="gdata.sites.data.html#BaseSiteEntry">BaseSiteEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ContentEntry-FindRevisionLink"><strong>FindRevisionLink</strong></a> = <a href="#ContentEntry-find_revison_link">find_revison_link</a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_revison_link"><strong>find_revison_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>content</strong> = <class 'gdata.sites.data.Content'><dd><tt>Google Sites version of <atom:content> that encapsulates XHTML.</tt></dl>
+
+<dl><dt><strong>data</strong> = <class 'gdata.sites.data.Data'><dd><tt>Google Sites List Page <gs:data>.</tt></dl>
+
+<dl><dt><strong>deleted</strong> = <class 'gdata.sites.data.Deleted'><dd><tt>Google Sites <gd:deleted>.</tt></dl>
+
+<dl><dt><strong>feed_link</strong> = <class 'gdata.data.FeedLink'><dd><tt>The gd:feedLink element.<br>
+ <br>
+Represents a logically nested feed. For example, a calendar feed might<br>
+have a nested feed representing all comments on entries.</tt></dl>
+
+<dl><dt><strong>field</strong> = [<class 'gdata.sites.data.Field'>]</dl>
+
+<dl><dt><strong>header</strong> = <class 'gdata.sites.data.Header'><dd><tt>Google Sites List Page <gs:header>.</tt></dl>
+
+<dl><dt><strong>in_reply_to</strong> = <class 'gdata.sites.data.InReplyTo'><dd><tt>Google Sites List Item <thr:in-reply-to>.</tt></dl>
+
+<dl><dt><strong>page_name</strong> = <class 'gdata.sites.data.PageName'><dd><tt>Google Sites <sites:pageName>.</tt></dl>
+
+<dl><dt><strong>publisher</strong> = <class 'gdata.sites.data.Publisher'><dd><tt>Google Sites <dc:pulisher>.</tt></dl>
+
+<dl><dt><strong>revision</strong> = <class 'gdata.sites.data.Revision'><dd><tt>Google Sites <sites:revision>.</tt></dl>
+
+<dl><dt><strong>worksheet</strong> = <class 'gdata.sites.data.Worksheet'><dd><tt>Google Sites List Page <gs:worksheet>.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.sites.data.html#BaseSiteEntry">BaseSiteEntry</a>:<br>
+<dl><dt><a name="ContentEntry-FindParentLink"><strong>FindParentLink</strong></a> = find_parent_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-GetNodeId"><strong>GetNodeId</strong></a> = get_node_id(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-IsDeleted"><strong>IsDeleted</strong></a> = is_deleted(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-Kind"><strong>Kind</strong></a> = kind(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-__init__"><strong>__init__</strong></a>(self, kind<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_parent_link"><strong>find_parent_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-get_node_id"><strong>get_node_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-is_deleted"><strong>is_deleted</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-kind"><strong>kind</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="ContentEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ContentEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ContentEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ContentEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ContentEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContentFeed">class <strong>ContentFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites <a href="#Content">Content</a> Feed.<br>
+ <br>
+The <a href="#Content">Content</a> feed is a feed containing the current, editable site content.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#ContentFeed">ContentFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ContentFeed-GetAnnouncementPages"><strong>GetAnnouncementPages</strong></a> = <a href="#ContentFeed-get_announcement_pages">get_announcement_pages</a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetAnnouncements"><strong>GetAnnouncements</strong></a> = <a href="#ContentFeed-get_announcements">get_announcements</a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetAttachments"><strong>GetAttachments</strong></a> = <a href="#ContentFeed-get_attachments">get_attachments</a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetComments"><strong>GetComments</strong></a> = <a href="#ContentFeed-get_comments">get_comments</a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetFileCabinets"><strong>GetFileCabinets</strong></a> = <a href="#ContentFeed-get_file_cabinets">get_file_cabinets</a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetListItems"><strong>GetListItems</strong></a> = <a href="#ContentFeed-get_list_items">get_list_items</a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetListPages"><strong>GetListPages</strong></a> = <a href="#ContentFeed-get_list_pages">get_list_pages</a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetWebattachments"><strong>GetWebattachments</strong></a> = <a href="#ContentFeed-get_webattachments">get_webattachments</a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetWebpages"><strong>GetWebpages</strong></a> = <a href="#ContentFeed-get_webpages">get_webpages</a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_announcement_pages"><strong>get_announcement_pages</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_announcements"><strong>get_announcements</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_attachments"><strong>get_attachments</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_comments"><strong>get_comments</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_file_cabinets"><strong>get_file_cabinets</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_list_items"><strong>get_list_items</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_list_pages"><strong>get_list_pages</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_webattachments"><strong>get_webattachments</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_webpages"><strong>get_webpages</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.sites.data.ContentEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ContentFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ContentFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ContentFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ContentFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ContentFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ContentFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ContentFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Data">class <strong>Data</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites List Page <gs:data>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#Data">Data</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>column</strong> = [<class 'gdata.sites.data.Column'>]</dl>
+
+<dl><dt><strong>startRow</strong> = 'startRow'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Data-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Data-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Data-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Data-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Data-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Data-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Data-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Data-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Data-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Data-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Deleted">class <strong>Deleted</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites <gd:deleted>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#Deleted">Deleted</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Deleted-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Deleted-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Deleted-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Deleted-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Field">class <strong>Field</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites List Item <gs:field>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#Field">Field</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>index</strong> = 'index'</dl>
+
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Field-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Field-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Field-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Field-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Field-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Field-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Field-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Field-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Field-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Field-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Header">class <strong>Header</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites List Page <gs:header>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#Header">Header</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>row</strong> = 'row'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Header-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Header-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Header-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Header-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Header-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Header-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Header-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Header-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Header-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Header-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="InReplyTo">class <strong>InReplyTo</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites List Item <thr:in-reply-to>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#InReplyTo">InReplyTo</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>href</strong> = 'href'</dl>
+
+<dl><dt><strong>ref</strong> = 'ref'</dl>
+
+<dl><dt><strong>source</strong> = 'source'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="InReplyTo-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="InReplyTo-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="InReplyTo-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="InReplyTo-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PageName">class <strong>PageName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites <sites:pageName>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#PageName">PageName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PageName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PageName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PageName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PageName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PageName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PageName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="PageName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PageName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PageName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PageName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Publisher">class <strong>Publisher</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites <dc:pulisher>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#Publisher">Publisher</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Publisher-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Publisher-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Publisher-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Publisher-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Revision">class <strong>Revision</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites <sites:revision>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#Revision">Revision</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Revision-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Revision-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Revision-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Revision-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Revision-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Revision-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Revision-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Revision-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Revision-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Revision-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RevisionEntry">class <strong>RevisionEntry</strong></a>(<a href="gdata.sites.data.html#BaseSiteEntry">BaseSiteEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites <a href="#Revision">Revision</a> Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#RevisionEntry">RevisionEntry</a></dd>
+<dd><a href="gdata.sites.data.html#BaseSiteEntry">BaseSiteEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>content</strong> = <class 'gdata.sites.data.Content'><dd><tt>Google Sites version of <atom:content> that encapsulates XHTML.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.sites.data.html#BaseSiteEntry">BaseSiteEntry</a>:<br>
+<dl><dt><a name="RevisionEntry-FindParentLink"><strong>FindParentLink</strong></a> = find_parent_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-GetNodeId"><strong>GetNodeId</strong></a> = get_node_id(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-IsDeleted"><strong>IsDeleted</strong></a> = is_deleted(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-Kind"><strong>Kind</strong></a> = kind(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-__init__"><strong>__init__</strong></a>(self, kind<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-find_parent_link"><strong>find_parent_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-get_node_id"><strong>get_node_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-is_deleted"><strong>is_deleted</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-kind"><strong>kind</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="RevisionEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="RevisionEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="RevisionEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="RevisionEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RevisionEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RevisionFeed">class <strong>RevisionFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites <a href="#Revision">Revision</a> Feed.<br>
+ <br>
+The Activity feed is a feed containing recent Site activity.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#RevisionFeed">RevisionFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.sites.data.RevisionEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="RevisionFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="RevisionFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="RevisionFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="RevisionFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="RevisionFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RevisionFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RevisionFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SiteEntry">class <strong>SiteEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites Site Feed Entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#SiteEntry">SiteEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SiteEntry-FindSourceLink"><strong>FindSourceLink</strong></a> = <a href="#SiteEntry-find_source_link">find_source_link</a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_source_link"><strong>find_source_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>site_name</strong> = <class 'gdata.sites.data.SiteName'><dd><tt>Google Sites <sites:siteName>.</tt></dl>
+
+<dl><dt><strong>theme</strong> = <class 'gdata.sites.data.Theme'><dd><tt>Google Sites <sites:theme>.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="SiteEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="SiteEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SiteEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="SiteEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="SiteEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SiteFeed">class <strong>SiteFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites Site Feed.<br>
+ <br>
+The Site feed can be used to list a user's sites and create new sites.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#SiteFeed">SiteFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.sites.data.SiteEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="SiteFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="SiteFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SiteFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="SiteFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="SiteFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SiteFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SiteName">class <strong>SiteName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites <sites:siteName>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#SiteName">SiteName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SiteName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SiteName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SiteName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SiteName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SiteName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Summary">class <strong>Summary</strong></a>(<a href="atom.data.html#Summary">atom.data.Summary</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites version of <atom:summary>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#Summary">Summary</a></dd>
+<dd><a href="atom.data.html#Summary">atom.data.Summary</a></dd>
+<dd><a href="atom.data.html#Text">atom.data.Text</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Summary-__init__"><strong>__init__</strong></a>(self, html<font color="#909090">=None</font>, type<font color="#909090">=None</font>, text<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>html</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Text">atom.data.Text</a>:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Summary-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Summary-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Summary-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Summary-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Summary-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Summary-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Theme">class <strong>Theme</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites <sites:theme>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#Theme">Theme</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Theme-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Theme-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Theme-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Theme-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Theme-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Theme-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Theme-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Theme-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Theme-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Theme-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Worksheet">class <strong>Worksheet</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Google Sites List Page <gs:worksheet>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.sites.data.html#Worksheet">Worksheet</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Worksheet-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Worksheet-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Worksheet-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ANNOUNCEMENT_KIND_TERM</strong> = 'http://schemas.google.com/sites/2008#announcement'<br>
+<strong>ANNOUNCEMENT_PAGE_KIND_TERM</strong> = 'http://schemas.google.com/sites/2008#announcementspage'<br>
+<strong>ATTACHMENT_KIND_TERM</strong> = 'http://schemas.google.com/sites/2008#attachment'<br>
+<strong>COMMENT_KIND_TERM</strong> = 'http://schemas.google.com/sites/2008#comment'<br>
+<strong>DC_TERMS_TEMPLATE</strong> = '{http://purl.org/dc/terms}%s'<br>
+<strong>FILECABINET_KIND_TERM</strong> = 'http://schemas.google.com/sites/2008#filecabinet'<br>
+<strong>FOLDER_KIND_TERM</strong> = 'http://schemas.google.com/sites/2008#folder'<br>
+<strong>LISTITEM_KIND_TERM</strong> = 'http://schemas.google.com/sites/2008#listitem'<br>
+<strong>LISTPAGE_KIND_TERM</strong> = 'http://schemas.google.com/sites/2008#listpage'<br>
+<strong>SITES_KIND_SCHEME</strong> = 'http://schemas.google.com/g/2005#kind'<br>
+<strong>SITES_NAMESPACE</strong> = 'http://schemas.google.com/sites/2008'<br>
+<strong>SITES_PARENT_LINK_REL</strong> = 'http://schemas.google.com/sites/2008#parent'<br>
+<strong>SITES_REVISION_LINK_REL</strong> = 'http://schemas.google.com/sites/2008#revision'<br>
+<strong>SITES_SOURCE_LINK_REL</strong> = 'http://schemas.google.com/sites/2008#source'<br>
+<strong>SITES_TEMPLATE</strong> = '{http://schemas.google.com/sites/2008}%s'<br>
+<strong>SITES_TEMPLATE_LINK_REL</strong> = 'http://schemas.google.com/sites/2008#template'<br>
+<strong>SPREADSHEETS_NAMESPACE</strong> = 'http://schemas.google.com/spreadsheets/2006'<br>
+<strong>SPREADSHEETS_TEMPLATE</strong> = '{http://schemas.google.com/spreadsheets/2006}%s'<br>
+<strong>SUPPORT_KINDS</strong> = ['announcement', 'announcementspage', 'attachment', 'comment', 'filecabinet', 'listitem', 'listpage', 'webpage', 'webattachment', 'tag']<br>
+<strong>TAG_KIND_TERM</strong> = 'http://schemas.google.com/sites/2008#tag'<br>
+<strong>THR_TERMS_TEMPLATE</strong> = '{http://purl.org/syndication/thread/1.0}%s'<br>
+<strong>WEBATTACHMENT_KIND_TERM</strong> = 'http://schemas.google.com/sites/2008#webattachment'<br>
+<strong>WEBPAGE_KIND_TERM</strong> = 'http://schemas.google.com/sites/2008#webpage'<br>
+<strong>XHTML_NAMESPACE</strong> = 'http://www.w3.org/1999/xhtml'<br>
+<strong>XHTML_TEMPLATE</strong> = '{http://www.w3.org/1999/xhtml}%s'<br>
+<strong>__author__</strong> = 'e.bidelman (Eric Bidelman)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">e.bidelman (Eric Bidelman)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.sites.html b/pydocs/gdata.sites.html
new file mode 100644
index 0000000..f075b37
--- /dev/null
+++ b/pydocs/gdata.sites.html
@@ -0,0 +1,23 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.sites</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.sites</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/sites/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/sites/__init__.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.sites.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.sites.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.spreadsheet.html b/pydocs/gdata.spreadsheet.html
new file mode 100644
index 0000000..7e157b5
--- /dev/null
+++ b/pydocs/gdata.spreadsheet.html
@@ -0,0 +1,1314 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.spreadsheet</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.spreadsheet</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheet/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheet/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains extensions to Atom objects used with Google Spreadsheets.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.spreadsheet.service.html">service</a><br>
+</td><td width="25%" valign=top><a href="gdata.spreadsheet.text_db.html">text_db</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#Cell">Cell</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#ColCount">ColCount</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#Custom">Custom</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#RowCount">RowCount</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchEntry">gdata.BatchEntry</a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#SpreadsheetsCell">SpreadsheetsCell</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#BatchFeed">gdata.BatchFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#SpreadsheetsCellsFeed">SpreadsheetsCellsFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#SpreadsheetsList">SpreadsheetsList</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#SpreadsheetsSpreadsheet">SpreadsheetsSpreadsheet</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#SpreadsheetsWorksheet">SpreadsheetsWorksheet</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#SpreadsheetsListFeed">SpreadsheetsListFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#SpreadsheetsSpreadsheetsFeed">SpreadsheetsSpreadsheetsFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.html#SpreadsheetsWorksheetsFeed">SpreadsheetsWorksheetsFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Cell">class <strong>Cell</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Spreadsheets cell element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#Cell">Cell</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Cell-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, row<font color="#909090">=None</font>, col<font color="#909090">=None</font>, inputValue<font color="#909090">=None</font>, numericValue<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Cell-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Cell-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Cell-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ColCount">class <strong>ColCount</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Spreadsheets colCount element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#ColCount">ColCount</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ColCount-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="ColCount-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="ColCount-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="ColCount-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Custom">class <strong>Custom</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Spreadsheets custom element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#Custom">Custom</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Custom-__init__"><strong>__init__</strong></a>(self, column<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Custom-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Custom-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Custom-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RowCount">class <strong>RowCount</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Google Spreadsheets rowCount element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#RowCount">RowCount</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="RowCount-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="RowCount-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="RowCount-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="RowCount-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetsCell">class <strong>SpreadsheetsCell</strong></a>(<a href="gdata.html#BatchEntry">gdata.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Spreadsheets flavor of a <a href="#Cell">Cell</a> Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#SpreadsheetsCell">SpreadsheetsCell</a></dd>
+<dd><a href="gdata.html#BatchEntry">gdata.BatchEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SpreadsheetsCell-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, source<font color="#909090">=None</font>, summary<font color="#909090">=None</font>, title<font color="#909090">=None</font>, control<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, cell<font color="#909090">=None</font>, batch_operation<font color="#909090">=None</font>, batch_id<font color="#909090">=None</font>, batch_status<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="SpreadsheetsCell-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCell-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SpreadsheetsCell-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCell-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SpreadsheetsCell-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsCell-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCell-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCell-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCell-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCell-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCell-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCell-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCell-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCell-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsCell-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCell-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetsCellsFeed">class <strong>SpreadsheetsCellsFeed</strong></a>(<a href="gdata.html#BatchFeed">gdata.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing Google Spreadsheets Cells<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#SpreadsheetsCellsFeed">SpreadsheetsCellsFeed</a></dd>
+<dd><a href="gdata.html#BatchFeed">gdata.BatchFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SpreadsheetsCellsFeed-GetBatchLink"><strong>GetBatchLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>, row_count<font color="#909090">=None</font>, col_count<font color="#909090">=None</font>, interrupted<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#BatchFeed">gdata.BatchFeed</a>:<br>
+<dl><dt><a name="SpreadsheetsCellsFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+ <br>
+If the entry is not a <a href="gdata.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a>, atom.Entry, or another Entry flavor (optional) The<br>
+ entry which will be sent to the server as part of the batch request.<br>
+ The item must have a valid atom id so that the server knows which<br>
+ entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-AddDelete"><strong>AddDelete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-AddInsert"><strong>AddInsert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-AddQuery"><strong>AddQuery</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-AddUpdate"><strong>AddUpdate</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SpreadsheetsCellsFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SpreadsheetsCellsFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsCellsFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsCellsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsCellsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetsList">class <strong>SpreadsheetsList</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Spreadsheets flavor of a List Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#SpreadsheetsList">SpreadsheetsList</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SpreadsheetsList-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, source<font color="#909090">=None</font>, summary<font color="#909090">=None</font>, title<font color="#909090">=None</font>, control<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, custom<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="SpreadsheetsList-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsList-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SpreadsheetsList-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsList-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SpreadsheetsList-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsList-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsList-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsList-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsList-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsList-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsList-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsList-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsList-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsList-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsList-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsList-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetsListFeed">class <strong>SpreadsheetsListFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing Google Spreadsheets Spreadsheets<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#SpreadsheetsListFeed">SpreadsheetsListFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="SpreadsheetsListFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SpreadsheetsListFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsListFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SpreadsheetsListFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsListFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsListFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsListFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsListFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsListFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsListFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsListFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsListFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsListFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsListFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsListFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetsSpreadsheet">class <strong>SpreadsheetsSpreadsheet</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Spreadsheets flavor of a Spreadsheet Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#SpreadsheetsSpreadsheet">SpreadsheetsSpreadsheet</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SpreadsheetsSpreadsheet-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, source<font color="#909090">=None</font>, summary<font color="#909090">=None</font>, title<font color="#909090">=None</font>, control<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheet-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SpreadsheetsSpreadsheet-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheet-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SpreadsheetsSpreadsheet-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheet-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetsSpreadsheetsFeed">class <strong>SpreadsheetsSpreadsheetsFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing Google Spreadsheets Spreadsheets<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#SpreadsheetsSpreadsheetsFeed">SpreadsheetsSpreadsheetsFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsSpreadsheetsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetsWorksheet">class <strong>SpreadsheetsWorksheet</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Spreadsheets flavor of a Worksheet Atom Entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#SpreadsheetsWorksheet">SpreadsheetsWorksheet</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SpreadsheetsWorksheet-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, source<font color="#909090">=None</font>, summary<font color="#909090">=None</font>, title<font color="#909090">=None</font>, control<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, row_count<font color="#909090">=None</font>, col_count<font color="#909090">=None</font>, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="SpreadsheetsWorksheet-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheet-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SpreadsheetsWorksheet-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheet-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SpreadsheetsWorksheet-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsWorksheet-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheet-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheet-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheet-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheet-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheet-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheet-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheet-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheet-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsWorksheet-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheet-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetsWorksheetsFeed">class <strong>SpreadsheetsWorksheetsFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing Google Spreadsheets Spreadsheets<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.html#SpreadsheetsWorksheetsFeed">SpreadsheetsWorksheetsFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsWorksheetsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-CellFromString"><strong>CellFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-ColCountFromString"><strong>ColCountFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CustomFromString"><strong>CustomFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-RowCountFromString"><strong>RowCountFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SpreadsheetsCellFromString"><strong>SpreadsheetsCellFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SpreadsheetsCellsFeedFromString"><strong>SpreadsheetsCellsFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SpreadsheetsListFeedFromString"><strong>SpreadsheetsListFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SpreadsheetsListFromString"><strong>SpreadsheetsListFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SpreadsheetsSpreadsheetFromString"><strong>SpreadsheetsSpreadsheetFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SpreadsheetsSpreadsheetsFeedFromString"><strong>SpreadsheetsSpreadsheetsFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SpreadsheetsWorksheetFromString"><strong>SpreadsheetsWorksheetFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SpreadsheetsWorksheetsFeedFromString"><strong>SpreadsheetsWorksheetsFeedFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GSPREADSHEETS_EXTENDED_NAMESPACE</strong> = 'http://schemas.google.com/spreadsheets/2006/extended'<br>
+<strong>GSPREADSHEETS_EXTENDED_TEMPLATE</strong> = '{http://schemas.google.com/spreadsheets/2006/extended}%s'<br>
+<strong>GSPREADSHEETS_NAMESPACE</strong> = 'http://schemas.google.com/spreadsheets/2006'<br>
+<strong>GSPREADSHEETS_TEMPLATE</strong> = '{http://schemas.google.com/spreadsheets/2006}%s'<br>
+<strong>__author__</strong> = 'api.laurabeth@gmail.com (Laura Beth Lincoln)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.laurabeth@gmail.com (Laura Beth Lincoln)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.spreadsheet.service.html b/pydocs/gdata.spreadsheet.service.html
new file mode 100644
index 0000000..58507cc
--- /dev/null
+++ b/pydocs/gdata.spreadsheet.service.html
@@ -0,0 +1,1441 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.spreadsheet.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.spreadsheet.html"><font color="#ffffff">spreadsheet</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheet/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheet/service.py</a></font></td></tr></table>
+ <p><tt><a href="#SpreadsheetsService">SpreadsheetsService</a> extends the <a href="gdata.service.html#GDataService">GDataService</a> to streamline Google<br>
+Spreadsheets operations.<br>
+ <br>
+ SpreadsheetService: Provides methods to query feeds and manipulate items.<br>
+ Extends <a href="gdata.service.html#GDataService">GDataService</a>.<br>
+ <br>
+ DictionaryToParamList: Function which converts a dictionary into a list of<br>
+ URL arguments (represented as strings). This is a<br>
+ utility function used in CRUD operations.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#RequestError">RequestError</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#SpreadsheetsService">SpreadsheetsService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Query">gdata.service.Query</a>(<a href="__builtin__.html#dict">__builtin__.dict</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#CellQuery">CellQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#DocumentQuery">DocumentQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.service.html#ListQuery">ListQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CellQuery">class <strong>CellQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.service.html#CellQuery">CellQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>max_col</strong></dt>
+<dd><tt>The max-col query parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_row</strong></dt>
+<dd><tt>The max-row query parameter</tt></dd>
+</dl>
+<dl><dt><strong>min_col</strong></dt>
+<dd><tt>The min-col query parameter</tt></dd>
+</dl>
+<dl><dt><strong>min_row</strong></dt>
+<dd><tt>The min-row query parameter</tt></dd>
+</dl>
+<dl><dt><strong>range</strong></dt>
+<dd><tt>The range query parameter</tt></dd>
+</dl>
+<dl><dt><strong>return_empty</strong></dt>
+<dd><tt>The return-empty query parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="CellQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="gdata.service.html#Query">Query</a><br>
+ <br>
+Args:<br>
+ feed: str (optional) The path for the feed (Examples: <br>
+ '/base/feeds/snippets' or 'calendar/feeds/jo@gmail.com/private/full'<br>
+ text_query: str (optional) The contents of the q query parameter. The<br>
+ contents of the text_query are URL escaped upon conversion to a URI.<br>
+ params: dict (optional) Parameter value string pairs which become URL<br>
+ params when translated to a URI. These parameters are added to the<br>
+ query's items (key-value pairs).<br>
+ categories: list (optional) List of category strings which should be<br>
+ included as query categories. See <br>
+ <a href="http://code.google.com/apis/gdata/reference.html#Queries">http://code.google.com/apis/gdata/reference.html#Queries</a> for <br>
+ details. If you want to get results from category A or B (both <br>
+ categories), specify a single list item 'A|B'.</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="CellQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CellQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#CellQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#CellQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#CellQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#CellQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#CellQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#CellQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DocumentQuery">class <strong>DocumentQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.service.html#DocumentQuery">DocumentQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>title</strong></dt>
+<dd><tt>The title query parameter</tt></dd>
+</dl>
+<dl><dt><strong>title_exact</strong></dt>
+<dd><tt>The title-exact query parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="DocumentQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="DocumentQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="gdata.service.html#Query">Query</a><br>
+ <br>
+Args:<br>
+ feed: str (optional) The path for the feed (Examples: <br>
+ '/base/feeds/snippets' or 'calendar/feeds/jo@gmail.com/private/full'<br>
+ text_query: str (optional) The contents of the q query parameter. The<br>
+ contents of the text_query are URL escaped upon conversion to a URI.<br>
+ params: dict (optional) Parameter value string pairs which become URL<br>
+ params when translated to a URI. These parameters are added to the<br>
+ query's items (key-value pairs).<br>
+ categories: list (optional) List of category strings which should be<br>
+ included as query categories. See <br>
+ <a href="http://code.google.com/apis/gdata/reference.html#Queries">http://code.google.com/apis/gdata/reference.html#Queries</a> for <br>
+ details. If you want to get results from category A or B (both <br>
+ categories), specify a single list item 'A|B'.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The feed query's orderby parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="DocumentQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#DocumentQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#DocumentQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#DocumentQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#DocumentQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#DocumentQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="DocumentQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#DocumentQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#DocumentQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Base class for exceptions in this module.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ListQuery">class <strong>ListQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.service.html#ListQuery">ListQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The orderby query parameter</tt></dd>
+</dl>
+<dl><dt><strong>reverse</strong></dt>
+<dd><tt>The reverse query parameter</tt></dd>
+</dl>
+<dl><dt><strong>sq</strong></dt>
+<dd><tt>The sq query parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="ListQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListQuery-__init__"><strong>__init__</strong></a>(self, feed<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt><dd><tt>Constructor for <a href="gdata.service.html#Query">Query</a><br>
+ <br>
+Args:<br>
+ feed: str (optional) The path for the feed (Examples: <br>
+ '/base/feeds/snippets' or 'calendar/feeds/jo@gmail.com/private/full'<br>
+ text_query: str (optional) The contents of the q query parameter. The<br>
+ contents of the text_query are URL escaped upon conversion to a URI.<br>
+ params: dict (optional) Parameter value string pairs which become URL<br>
+ params when translated to a URI. These parameters are added to the<br>
+ query's items (key-value pairs).<br>
+ categories: list (optional) List of category strings which should be<br>
+ included as query categories. See <br>
+ <a href="http://code.google.com/apis/gdata/reference.html#Queries">http://code.google.com/apis/gdata/reference.html#Queries</a> for <br>
+ details. If you want to get results from category A or B (both <br>
+ categories), specify a single list item 'A|B'.</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="ListQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#ListQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#ListQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#ListQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#ListQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#ListQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#ListQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#ListQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RequestError">class <strong>RequestError</strong></a>(<a href="gdata.spreadsheet.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.service.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.spreadsheet.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.spreadsheet.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="RequestError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RequestError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="RequestError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetsService">class <strong>SpreadsheetsService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Spreadsheets service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.service.html#SpreadsheetsService">SpreadsheetsService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SpreadsheetsService-AddWorksheet"><strong>AddWorksheet</strong></a>(self, title, row_count, col_count, key)</dt><dd><tt>Creates a new worksheet in the desired spreadsheet.<br>
+ <br>
+The new worksheet is appended to the end of the list of worksheets. The<br>
+new worksheet will only have the available number of columns and cells <br>
+specified.<br>
+ <br>
+Args:<br>
+ title: str The title which will be displayed in the list of worksheets.<br>
+ row_count: int or str The number of rows in the new worksheet.<br>
+ col_count: int or str The number of columns in the new worksheet.<br>
+ key: str The spreadsheet key to the spreadsheet to which the new <br>
+ worksheet should be added. <br>
+ <br>
+Returns:<br>
+ A SpreadsheetsWorksheet if the new worksheet was created succesfully.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-DeleteRow"><strong>DeleteRow</strong></a>(self, entry)</dt><dd><tt>Deletes a row, the provided entry<br>
+ <br>
+Args:<br>
+ entry: gdata.spreadsheet.SpreadsheetsList The row to be deleted<br>
+ <br>
+Returns:<br>
+ The delete response</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-DeleteWorksheet"><strong>DeleteWorksheet</strong></a>(self, worksheet_entry<font color="#909090">=None</font>, url<font color="#909090">=None</font>)</dt><dd><tt>Removes the desired worksheet from the spreadsheet<br>
+ <br>
+Args:<br>
+ worksheet_entry: SpreadsheetWorksheet (optional) The worksheet to<br>
+ be deleted. If this is none, then the DELETE reqest is sent to <br>
+ the url specified in the url parameter.<br>
+ url: str (optaional) The URL to which the DELETE request should be<br>
+ sent. If left as None, the worksheet's edit URL is used.<br>
+ <br>
+Returns:<br>
+ True if the worksheet was deleted successfully.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-ExecuteBatch"><strong>ExecuteBatch</strong></a>(self, batch_feed, url<font color="#909090">=None</font>, spreadsheet_key<font color="#909090">=None</font>, worksheet_id<font color="#909090">=None</font>, converter<font color="#909090">=<function SpreadsheetsCellsFeedFromString></font>)</dt><dd><tt>Sends a batch request feed to the server.<br>
+ <br>
+The batch request needs to be sent to the batch URL for a particular <br>
+worksheet. You can specify the worksheet by providing the spreadsheet_key<br>
+and worksheet_id, or by sending the URL from the cells feed's batch link.<br>
+ <br>
+Args:<br>
+ batch_feed: gdata.spreadsheet.SpreadsheetsCellFeed A feed containing <br>
+ BatchEntry elements which contain the desired CRUD operation and <br>
+ any necessary data to modify a cell.<br>
+ url: str (optional) The batch URL for the cells feed to which these <br>
+ changes should be applied. This can be found by calling <br>
+ cells_feed.GetBatchLink().href.<br>
+ spreadsheet_key: str (optional) Used to generate the batch request URL<br>
+ if the url argument is None. If using the spreadsheet key to <br>
+ generate the URL, the worksheet id is also required.<br>
+ worksheet_id: str (optional) Used if the url is not provided, it is <br>
+ oart of the batch feed target URL. This is used with the spreadsheet<br>
+ key.<br>
+ converter: Function (optional) Function to be executed on the server's<br>
+ response. This function should take one string as a parameter. The<br>
+ default value is SpreadsheetsCellsFeedFromString which will turn the result<br>
+ into a gdata.spreadsheet.SpreadsheetsCellsFeed object.<br>
+ <br>
+Returns:<br>
+ A gdata.BatchFeed containing the results.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetCellsFeed"><strong>GetCellsFeed</strong></a>(self, key, wksht_id<font color="#909090">='default'</font>, cell<font color="#909090">=None</font>, query<font color="#909090">=None</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>)</dt><dd><tt>Gets a cells feed or a specific entry if a cell is defined<br>
+Args:<br>
+ key: string The spreadsheet key defined in /ccc?key=<br>
+ wksht_id: string The id for a specific worksheet entry<br>
+ cell: string (optional) The R1C1 address of the cell<br>
+ query: <a href="#DocumentQuery">DocumentQuery</a> (optional) <a href="gdata.service.html#Query">Query</a> parameters<br>
+ <br>
+Returns:<br>
+ If there is no cell, then a SpreadsheetsCellsFeed.<br>
+ If there is a cell, then a SpreadsheetsCell.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetListFeed"><strong>GetListFeed</strong></a>(self, key, wksht_id<font color="#909090">='default'</font>, row_id<font color="#909090">=None</font>, query<font color="#909090">=None</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>)</dt><dd><tt>Gets a list feed or a specific entry if a row_id is defined<br>
+Args:<br>
+ key: string The spreadsheet key defined in /ccc?key=<br>
+ wksht_id: string The id for a specific worksheet entry<br>
+ row_id: string (optional) The row_id of a row in the list<br>
+ query: <a href="#DocumentQuery">DocumentQuery</a> (optional) <a href="gdata.service.html#Query">Query</a> parameters<br>
+ <br>
+Returns:<br>
+ If there is no row_id, then a SpreadsheetsListFeed.<br>
+ If there is a row_id, then a SpreadsheetsList.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetSpreadsheetsFeed"><strong>GetSpreadsheetsFeed</strong></a>(self, key<font color="#909090">=None</font>, query<font color="#909090">=None</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>)</dt><dd><tt>Gets a spreadsheets feed or a specific entry if a key is defined<br>
+Args:<br>
+ key: string (optional) The spreadsheet key defined in /ccc?key=<br>
+ query: <a href="#DocumentQuery">DocumentQuery</a> (optional) <a href="gdata.service.html#Query">Query</a> parameters<br>
+ <br>
+Returns:<br>
+ If there is no key, then a SpreadsheetsSpreadsheetsFeed.<br>
+ If there is a key, then a SpreadsheetsSpreadsheet.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetWorksheetsFeed"><strong>GetWorksheetsFeed</strong></a>(self, key, wksht_id<font color="#909090">=None</font>, query<font color="#909090">=None</font>, visibility<font color="#909090">='private'</font>, projection<font color="#909090">='full'</font>)</dt><dd><tt>Gets a worksheets feed or a specific entry if a wksht is defined<br>
+Args:<br>
+ key: string The spreadsheet key defined in /ccc?key=<br>
+ wksht_id: string (optional) The id for a specific worksheet entry<br>
+ query: <a href="#DocumentQuery">DocumentQuery</a> (optional) <a href="gdata.service.html#Query">Query</a> parameters<br>
+ <br>
+Returns:<br>
+ If there is no wksht_id, then a SpreadsheetsWorksheetsFeed.<br>
+ If there is a wksht_id, then a SpreadsheetsWorksheet.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-InsertRow"><strong>InsertRow</strong></a>(self, row_data, key, wksht_id<font color="#909090">='default'</font>)</dt><dd><tt>Inserts a new row with the provided data<br>
+ <br>
+Args:<br>
+ uri: string The post uri of the list feed<br>
+ row_data: dict A dictionary of column header to row data<br>
+ <br>
+Returns:<br>
+ The inserted row</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-UpdateCell"><strong>UpdateCell</strong></a>(self, row, col, inputValue, key, wksht_id<font color="#909090">='default'</font>)</dt><dd><tt>Updates an existing cell.<br>
+ <br>
+Args:<br>
+ row: int The row the cell to be editted is in<br>
+ col: int The column the cell to be editted is in<br>
+ inputValue: str the new value of the cell<br>
+ key: str The key of the spreadsheet in which this cell resides.<br>
+ wksht_id: str The ID of the worksheet which holds this cell.<br>
+ <br>
+Returns:<br>
+ The updated cell entry</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-UpdateRow"><strong>UpdateRow</strong></a>(self, entry, new_row_data)</dt><dd><tt>Updates a row with the provided data<br>
+ <br>
+If you want to add additional information to a row, it is often<br>
+easier to change the values in entry.custom, then use the Put<br>
+method instead of UpdateRow. This UpdateRow method will replace<br>
+the contents of the row with new_row_data - it will change all columns<br>
+not just the columns specified in the new_row_data dict.<br>
+ <br>
+Args:<br>
+ entry: gdata.spreadsheet.SpreadsheetsList The entry to be updated<br>
+ new_row_data: dict A dictionary of column header to row data<br>
+ <br>
+Returns:<br>
+ The updated row</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-UpdateWorksheet"><strong>UpdateWorksheet</strong></a>(self, worksheet_entry, url<font color="#909090">=None</font>)</dt><dd><tt>Changes the size and/or title of the desired worksheet.<br>
+ <br>
+Args:<br>
+ worksheet_entry: SpreadsheetWorksheet The new contents of the <br>
+ worksheet. <br>
+ url: str (optional) The URL to which the edited worksheet entry should<br>
+ be sent. If the url is None, the edit URL from the worksheet will<br>
+ be used.<br>
+ <br>
+Returns: <br>
+ A SpreadsheetsWorksheet with the new information about the worksheet.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='spreadsheets.google.com'</font>, additional_headers<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a client for the Google Spreadsheets service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'spreadsheets.google.com'.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="SpreadsheetsService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#SpreadsheetsService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ <a href="#Error">Error</a> if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#SpreadsheetsService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#SpreadsheetsService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="SpreadsheetsService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'api.laurabeth@gmail.com (Laura Beth Lincoln)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.laurabeth@gmail.com (Laura Beth Lincoln)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.spreadsheet.text_db.html b/pydocs/gdata.spreadsheet.text_db.html
new file mode 100644
index 0000000..fe60768
--- /dev/null
+++ b/pydocs/gdata.spreadsheet.text_db.html
@@ -0,0 +1,649 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.spreadsheet.text_db</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.spreadsheet.html"><font color="#ffffff">spreadsheet</font></a>.text_db</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheet/text_db.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheet/text_db.py</a></font></td></tr></table>
+ <p><tt># Copyright Google 2007-2008, all rights reserved.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="StringIO.html">StringIO</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#list">__builtin__.list</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.text_db.html#RecordResultSet">RecordResultSet</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.text_db.html#Database">Database</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.text_db.html#DatabaseClient">DatabaseClient</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.text_db.html#Record">Record</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.text_db.html#Table">Table</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.text_db.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheet.text_db.html#BadCredentials">BadCredentials</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheet.text_db.html#CaptchaRequired">CaptchaRequired</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BadCredentials">class <strong>BadCredentials</strong></a>(<a href="gdata.spreadsheet.text_db.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.text_db.html#BadCredentials">BadCredentials</a></dd>
+<dd><a href="gdata.spreadsheet.text_db.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.spreadsheet.text_db.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="BadCredentials-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#BadCredentials-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#BadCredentials-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="BadCredentials-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadCredentials-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="BadCredentials-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#BadCredentials-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="BadCredentials-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#BadCredentials-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="BadCredentials-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#BadCredentials-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="BadCredentials-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="BadCredentials-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadCredentials-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="BadCredentials-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#BadCredentials-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="BadCredentials-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="BadCredentials-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#BadCredentials-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="BadCredentials-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CaptchaRequired">class <strong>CaptchaRequired</strong></a>(<a href="gdata.spreadsheet.text_db.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.text_db.html#CaptchaRequired">CaptchaRequired</a></dd>
+<dd><a href="gdata.spreadsheet.text_db.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.spreadsheet.text_db.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="CaptchaRequired-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#CaptchaRequired-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="CaptchaRequired-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="CaptchaRequired-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="CaptchaRequired-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#CaptchaRequired-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="CaptchaRequired-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Database">class <strong>Database</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Provides interface to find and create tables.<br>
+ <br>
+The database represents a Google Spreadsheet.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Database-CreateTable"><strong>CreateTable</strong></a>(self, name, fields<font color="#909090">=None</font>)</dt><dd><tt>Add a new worksheet to this spreadsheet and fill in column names.<br>
+ <br>
+Args:<br>
+ name: str The title of the new worksheet.<br>
+ fields: <a href="__builtin__.html#list">list</a> of strings The column names which are placed in the<br>
+ first row of this worksheet. These names are converted into XML<br>
+ tags by the server. To avoid changes during the translation<br>
+ process I recommend using all lowercase alphabetic names. For<br>
+ example ['somelongname', 'theothername']<br>
+ <br>
+Returns:<br>
+ <a href="#Table">Table</a> representing the newly created worksheet.</tt></dd></dl>
+
+<dl><dt><a name="Database-Delete"><strong>Delete</strong></a>(self)</dt><dd><tt>Deletes the entire database spreadsheet from Google Spreadsheets.</tt></dd></dl>
+
+<dl><dt><a name="Database-GetTables"><strong>GetTables</strong></a>(self, worksheet_id<font color="#909090">=None</font>, name<font color="#909090">=None</font>)</dt><dd><tt>Searches for a worksheet with the specified ID or name.<br>
+ <br>
+The <a href="__builtin__.html#list">list</a> of results should have one table at most, or no results<br>
+if the id or name were not found.<br>
+ <br>
+Args:<br>
+ worksheet_id: str The ID of the worksheet, example: 'od6'<br>
+ name: str The title of the worksheet.<br>
+ <br>
+Returns:<br>
+ A <a href="__builtin__.html#list">list</a> of length 0 or 1 containing the desired <a href="#Table">Table</a>. A <a href="__builtin__.html#list">list</a> is returned<br>
+ to make this method feel like GetDatabases and GetRecords.</tt></dd></dl>
+
+<dl><dt><a name="Database-__init__"><strong>__init__</strong></a>(self, spreadsheet_entry<font color="#909090">=None</font>, database_client<font color="#909090">=None</font>)</dt><dd><tt>Constructor for a database <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+Args:<br>
+ spreadsheet_entry: gdata.docs.DocumentListEntry The <br>
+ Atom entry which represents the Google Spreadsheet. The<br>
+ spreadsheet's key is extracted from the entry and stored as a <br>
+ member.<br>
+ database_client: <a href="#DatabaseClient">DatabaseClient</a> A client which can talk to the<br>
+ Google Spreadsheets servers to perform operations on worksheets<br>
+ within this spreadsheet.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="DatabaseClient">class <strong>DatabaseClient</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Allows creation and finding of Google Spreadsheets databases.<br>
+ <br>
+The <a href="#DatabaseClient">DatabaseClient</a> simplifies the process of creating and finding Google <br>
+Spreadsheets and will talk to both the Google Spreadsheets API and the <br>
+Google Documents List API.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="DatabaseClient-CreateDatabase"><strong>CreateDatabase</strong></a>(self, name)</dt><dd><tt>Creates a new Google Spreadsheet with the desired name.<br>
+ <br>
+Args:<br>
+ name: str The title for the spreadsheet.<br>
+ <br>
+Returns:<br>
+ A <a href="#Database">Database</a> instance representing the new spreadsheet.</tt></dd></dl>
+
+<dl><dt><a name="DatabaseClient-GetDatabases"><strong>GetDatabases</strong></a>(self, spreadsheet_key<font color="#909090">=None</font>, name<font color="#909090">=None</font>)</dt><dd><tt>Finds spreadsheets which have the unique key or title.<br>
+ <br>
+If querying on the spreadsheet_key there will be at most one result, but<br>
+searching by name could yield multiple results.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str The unique key for the spreadsheet, this <br>
+ usually in the the form 'pk23...We' or 'o23...423.12,,,3'.<br>
+ name: str The title of the spreadsheets.<br>
+ <br>
+Returns:<br>
+ A <a href="__builtin__.html#list">list</a> of <a href="#Database">Database</a> objects representing the desired spreadsheets.</tt></dd></dl>
+
+<dl><dt><a name="DatabaseClient-SetCredentials"><strong>SetCredentials</strong></a>(self, username, password)</dt><dd><tt>Attempts to log in to Google APIs using the provided credentials.<br>
+ <br>
+If the username or password are None, the client will not request auth <br>
+tokens.<br>
+ <br>
+Args:<br>
+ username: str (optional) Example: jo@example.com<br>
+ password: str (optional)</tt></dd></dl>
+
+<dl><dt><a name="DatabaseClient-__init__"><strong>__init__</strong></a>(self, username<font color="#909090">=None</font>, password<font color="#909090">=None</font>)</dt><dd><tt>Constructor for a <a href="#Database">Database</a> Client. <br>
+ <br>
+If the username and password are present, the constructor will contact<br>
+the Google servers to authenticate.<br>
+ <br>
+Args:<br>
+ username: str (optional) Example: jo@example.com<br>
+ password: str (optional)</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.text_db.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Record">class <strong>Record</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents one row in a worksheet and provides a dictionary of values.<br>
+ <br>
+Attributes:<br>
+ custom: dict Represents the contents of the row with cell values mapped<br>
+ to column headers.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Record-Delete"><strong>Delete</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-ExtractContentFromEntry"><strong>ExtractContentFromEntry</strong></a>(self, entry)</dt><dd><tt>Populates the content and row_id based on content of the entry.<br>
+ <br>
+This method is used in the <a href="#Record">Record</a>'s contructor.<br>
+ <br>
+Args:<br>
+ entry: gdata.spreadsheet.SpreadsheetsList The Atom entry <br>
+ representing this row in the worksheet.</tt></dd></dl>
+
+<dl><dt><a name="Record-Pull"><strong>Pull</strong></a>(self)</dt><dd><tt>Query Google Spreadsheets to get the latest data from the server.<br>
+ <br>
+Fetches the entry for this row and repopulates the content dictionary <br>
+with the data found in the row.</tt></dd></dl>
+
+<dl><dt><a name="Record-Push"><strong>Push</strong></a>(self)</dt><dd><tt>Send the content of the record to spreadsheets to edit the row.<br>
+ <br>
+All items in the content dictionary will be sent. Items which have been<br>
+removed from the content may remain in the row. The content member<br>
+of the record will not be modified so additional fields in the row<br>
+might be absent from this local copy.</tt></dd></dl>
+
+<dl><dt><a name="Record-__init__"><strong>__init__</strong></a>(self, content<font color="#909090">=None</font>, row_entry<font color="#909090">=None</font>, spreadsheet_key<font color="#909090">=None</font>, worksheet_id<font color="#909090">=None</font>, database_client<font color="#909090">=None</font>)</dt><dd><tt>Constructor for a record.<br>
+ <br>
+Args:<br>
+ content: dict of strings Mapping of string values to column names.<br>
+ row_entry: gdata.spreadsheet.SpreadsheetsList The Atom entry <br>
+ representing this row in the worksheet.<br>
+ spreadsheet_key: str The ID of the spreadsheet in which this row <br>
+ belongs.<br>
+ worksheet_id: str The ID of the worksheet in which this row belongs.<br>
+ database_client: <a href="#DatabaseClient">DatabaseClient</a> The client which can be used to talk<br>
+ the Google Spreadsheets server to edit this row.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RecordResultSet">class <strong>RecordResultSet</strong></a>(<a href="__builtin__.html#list">__builtin__.list</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A collection of rows which allows fetching of the next set of results.<br>
+ <br>
+The server may not send all rows in the requested range because there are<br>
+too many. Using this result set you can access the first set of results<br>
+as if it is a <a href="__builtin__.html#list">list</a>, then get the next batch (if there are more results) by<br>
+calling <a href="#RecordResultSet-GetNext">GetNext</a>().<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheet.text_db.html#RecordResultSet">RecordResultSet</a></dd>
+<dd><a href="__builtin__.html#list">__builtin__.list</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="RecordResultSet-GetNext"><strong>GetNext</strong></a>(self)</dt><dd><tt>Fetches the next batch of rows in the result set.<br>
+ <br>
+Returns:<br>
+ A new <a href="#RecordResultSet">RecordResultSet</a>.</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__init__"><strong>__init__</strong></a>(self, feed, client, spreadsheet_key, worksheet_id)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#list">__builtin__.list</a>:<br>
+<dl><dt><a name="RecordResultSet-__add__"><strong>__add__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__add__">__add__</a>(y) <==> x+y</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__contains__">__contains__</a>(y) <==> y in x</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__delslice__"><strong>__delslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__delslice__">__delslice__</a>(i, j) <==> del x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__iadd__"><strong>__iadd__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__iadd__">__iadd__</a>(y) <==> x+=y</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__imul__"><strong>__imul__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__imul__">__imul__</a>(y) <==> x*=y</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__mul__"><strong>__mul__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__mul__">__mul__</a>(n) <==> x*n</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__reversed__"><strong>__reversed__</strong></a>(...)</dt><dd><tt>L.<a href="#RecordResultSet-__reversed__">__reversed__</a>() -- return a reverse iterator over the <a href="__builtin__.html#list">list</a></tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__rmul__"><strong>__rmul__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__rmul__">__rmul__</a>(n) <==> n*x</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__setslice__"><strong>__setslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RecordResultSet-__setslice__">__setslice__</a>(i, j, y) <==> x[i:j]=y<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>L.<a href="#RecordResultSet-__sizeof__">__sizeof__</a>() -- size of L in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-append"><strong>append</strong></a>(...)</dt><dd><tt>L.<a href="#RecordResultSet-append">append</a>(<a href="__builtin__.html#object">object</a>) -- append <a href="__builtin__.html#object">object</a> to end</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-count"><strong>count</strong></a>(...)</dt><dd><tt>L.<a href="#RecordResultSet-count">count</a>(value) -> integer -- return number of occurrences of value</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-extend"><strong>extend</strong></a>(...)</dt><dd><tt>L.<a href="#RecordResultSet-extend">extend</a>(iterable) -- extend <a href="__builtin__.html#list">list</a> by appending elements from the iterable</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-index"><strong>index</strong></a>(...)</dt><dd><tt>L.<a href="#RecordResultSet-index">index</a>(value, [start, [stop]]) -> integer -- return first index of value.<br>
+Raises ValueError if the value is not present.</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-insert"><strong>insert</strong></a>(...)</dt><dd><tt>L.<a href="#RecordResultSet-insert">insert</a>(index, <a href="__builtin__.html#object">object</a>) -- insert <a href="__builtin__.html#object">object</a> before index</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-pop"><strong>pop</strong></a>(...)</dt><dd><tt>L.<a href="#RecordResultSet-pop">pop</a>([index]) -> item -- remove and return item at index (default last).<br>
+Raises IndexError if <a href="__builtin__.html#list">list</a> is empty or index is out of range.</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-remove"><strong>remove</strong></a>(...)</dt><dd><tt>L.<a href="#RecordResultSet-remove">remove</a>(value) -- remove first occurrence of value.<br>
+Raises ValueError if the value is not present.</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-reverse"><strong>reverse</strong></a>(...)</dt><dd><tt>L.<a href="#RecordResultSet-reverse">reverse</a>() -- reverse *IN PLACE*</tt></dd></dl>
+
+<dl><dt><a name="RecordResultSet-sort"><strong>sort</strong></a>(...)</dt><dd><tt>L.<a href="#RecordResultSet-sort">sort</a>(cmp=None, key=None, reverse=False) -- stable sort *IN PLACE*;<br>
+cmp(x, y) -> -1, 0, 1</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#list">__builtin__.list</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RecordResultSet-__new__">__new__</a>(S, ...) -> a new <a href="__builtin__.html#object">object</a> with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Table">class <strong>Table</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Table-AddRecord"><strong>AddRecord</strong></a>(self, data)</dt><dd><tt>Adds a new row to this worksheet.<br>
+ <br>
+Args:<br>
+ data: dict of strings Mapping of string values to column names. <br>
+ <br>
+Returns:<br>
+ <a href="#Record">Record</a> which represents this row of the spreadsheet.</tt></dd></dl>
+
+<dl><dt><a name="Table-Delete"><strong>Delete</strong></a>(self)</dt><dd><tt>Deletes this worksheet from the spreadsheet.</tt></dd></dl>
+
+<dl><dt><a name="Table-FindRecords"><strong>FindRecords</strong></a>(self, query_string)</dt><dd><tt>Performs a query against the worksheet to find rows which match.<br>
+ <br>
+For details on query string syntax see the section on sq under<br>
+<a href="http://code.google.com/apis/spreadsheets/reference.html#list_Parameters">http://code.google.com/apis/spreadsheets/reference.html#list_Parameters</a><br>
+ <br>
+Args:<br>
+ query_string: str Examples: 'name == john' to find all rows with john<br>
+ in the name column, '(cost < 19.50 and name != toy) or cost > 500'<br>
+ <br>
+Returns:<br>
+ <a href="#RecordResultSet">RecordResultSet</a> with the first group of matches.</tt></dd></dl>
+
+<dl><dt><a name="Table-GetRecord"><strong>GetRecord</strong></a>(self, row_id<font color="#909090">=None</font>, row_number<font color="#909090">=None</font>)</dt><dd><tt>Gets a single record from the worksheet based on row ID or number.<br>
+ <br>
+Args:<br>
+ row_id: The ID for the individual row.<br>
+ row_number: str or int The position of the desired row. Numbering <br>
+ begins at 1, which refers to the second row in the worksheet since<br>
+ the first row is used for column names.<br>
+ <br>
+Returns:<br>
+ <a href="#Record">Record</a> for the desired row.</tt></dd></dl>
+
+<dl><dt><a name="Table-GetRecords"><strong>GetRecords</strong></a>(self, start_row, end_row)</dt><dd><tt>Gets all rows between the start and end row numbers inclusive.<br>
+ <br>
+Args:<br>
+ start_row: str or int<br>
+ end_row: str or int<br>
+ <br>
+Returns:<br>
+ <a href="#RecordResultSet">RecordResultSet</a> for the desired rows.</tt></dd></dl>
+
+<dl><dt><a name="Table-LookupFields"><strong>LookupFields</strong></a>(self)</dt><dd><tt>Queries to find the column names in the first row of the worksheet.<br>
+ <br>
+Useful when you have retrieved the table from the server and you don't <br>
+know the column names.</tt></dd></dl>
+
+<dl><dt><a name="Table-SetFields"><strong>SetFields</strong></a>(self, fields)</dt><dd><tt>Changes the contents of the cells in the first row of this worksheet.<br>
+ <br>
+Args:<br>
+ fields: <a href="__builtin__.html#list">list</a> of strings The names in the <a href="__builtin__.html#list">list</a> comprise the<br>
+ first row of the worksheet. These names are converted into XML<br>
+ tags by the server. To avoid changes during the translation<br>
+ process I recommend using all lowercase alphabetic names. For<br>
+ example ['somelongname', 'theothername']</tt></dd></dl>
+
+<dl><dt><a name="Table-__init__"><strong>__init__</strong></a>(self, name<font color="#909090">=None</font>, worksheet_entry<font color="#909090">=None</font>, database_client<font color="#909090">=None</font>, spreadsheet_key<font color="#909090">=None</font>, fields<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-ConvertStringsToColumnHeaders"><strong>ConvertStringsToColumnHeaders</strong></a>(proposed_headers)</dt><dd><tt>Converts a <a href="__builtin__.html#list">list</a> of strings to column names which spreadsheets accepts.<br>
+ <br>
+When setting values in a record, the keys which represent column names must<br>
+fit certain rules. They are all lower case, contain no spaces or special<br>
+characters. If two columns have the same name after being sanitized, the <br>
+columns further to the right have _2, _3 _4, etc. appended to them.<br>
+ <br>
+If there are column names which consist of all special characters, or if<br>
+the column header is blank, an obfuscated value will be used for a column<br>
+name. This method does not handle blank column names or column names with<br>
+only special characters.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'api.jscudder (Jeffrey Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeffrey Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.spreadsheets.client.html b/pydocs/gdata.spreadsheets.client.html
new file mode 100644
index 0000000..aa6bec3
--- /dev/null
+++ b/pydocs/gdata.spreadsheets.client.html
@@ -0,0 +1,1216 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.spreadsheets.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.spreadsheets.html"><font color="#ffffff">spreadsheets</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheets/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheets/client.py</a></font></td></tr></table>
+ <p><tt>Contains a client to communicate with the Google Spreadsheets servers.<br>
+ <br>
+For documentation on the Spreadsheets API, see:<br>
+<a href="http://code.google.com/apis/spreadsheets/">http://code.google.com/apis/spreadsheets/</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.client.html#SpreadsheetsClient">SpreadsheetsClient</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#Query">gdata.client.Query</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.client.html#CellQuery">CellQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.client.html#ListQuery">ListQuery</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.client.html#TableQuery">TableQuery</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.client.html#SpreadsheetQuery">SpreadsheetQuery</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.client.html#WorksheetQuery">WorksheetQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CellQuery">class <strong>CellQuery</strong></a>(<a href="gdata.client.html#Query">gdata.client.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.client.html#CellQuery">CellQuery</a></dd>
+<dd><a href="gdata.client.html#Query">gdata.client.Query</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CellQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#CellQuery-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="CellQuery-__init__"><strong>__init__</strong></a>(self, min_row<font color="#909090">=None</font>, max_row<font color="#909090">=None</font>, min_col<font color="#909090">=None</font>, max_col<font color="#909090">=None</font>, range<font color="#909090">=None</font>, return_empty<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds Cells-feed specific query parameters to a request.<br>
+ <br>
+Args:<br>
+ min_row: str or int Positional number of minimum row returned in query.<br>
+ max_row: str or int Positional number of maximum row returned in query.<br>
+ min_col: str or int Positional number of minimum column returned in query.<br>
+ max_col: str or int Positional number of maximum column returned in query.<br>
+ range: str A single cell or a range of cells. Use standard spreadsheet<br>
+ cell-range notations, using a colon to separate start and end of<br>
+ range. Examples:<br>
+ - 'A1' and 'R1C1' both specify only cell A1.<br>
+ - 'D1:F3' and 'R1C4:R3C6' both specify the rectangle of cells with<br>
+ corners at D1 and F3.<br>
+ return_empty: str If 'true' then empty cells will be returned in the feed.<br>
+ If omitted, the default is 'false'.</tt></dd></dl>
+
+<dl><dt><a name="CellQuery-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><a name="CellQuery-AddCustomParameter"><strong>AddCustomParameter</strong></a> = add_custom_parameter(self, key, value)</dt></dl>
+
+<dl><dt><a name="CellQuery-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ListQuery">class <strong>ListQuery</strong></a>(<a href="gdata.client.html#Query">gdata.client.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.client.html#ListQuery">ListQuery</a></dd>
+<dd><a href="gdata.client.html#Query">gdata.client.Query</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ListQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#ListQuery-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="ListQuery-__init__"><strong>__init__</strong></a>(self, order_by<font color="#909090">=None</font>, reverse<font color="#909090">=None</font>, sq<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds List-feed specific query parameters to a request.<br>
+ <br>
+Args:<br>
+ order_by: str Specifies what column to use in ordering the entries in<br>
+ the feed. By position (the default): 'position' returns<br>
+ rows in the order in which they appear in the GUI. Row 1, then<br>
+ row 2, then row 3, and so on. By column:<br>
+ 'column:columnName' sorts rows in ascending order based on the<br>
+ values in the column with the given columnName, where<br>
+ columnName is the value in the header row for that column.<br>
+ reverse: str Specifies whether to sort in descending or ascending order.<br>
+ Reverses default sort order: 'true' results in a descending<br>
+ sort; 'false' (the default) results in an ascending sort.<br>
+ sq: str Structured query on the full text in the worksheet.<br>
+ [columnName][binaryOperator][value]<br>
+ Supported binaryOperators are:<br>
+ - (), for overriding order of operations<br>
+ - = or ==, for strict equality<br>
+ - <> or !=, for strict inequality<br>
+ - and or &&, for boolean and<br>
+ - or or ||, for boolean or</tt></dd></dl>
+
+<dl><dt><a name="ListQuery-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><a name="ListQuery-AddCustomParameter"><strong>AddCustomParameter</strong></a> = add_custom_parameter(self, key, value)</dt></dl>
+
+<dl><dt><a name="ListQuery-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetQuery">class <strong>SpreadsheetQuery</strong></a>(<a href="gdata.client.html#Query">gdata.client.Query</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.client.html#SpreadsheetQuery">SpreadsheetQuery</a></dd>
+<dd><a href="gdata.client.html#Query">gdata.client.Query</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SpreadsheetQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = <a href="#SpreadsheetQuery-modify_request">modify_request</a>(self, http_request)</dt></dl>
+
+<dl><dt><a name="SpreadsheetQuery-__init__"><strong>__init__</strong></a>(self, title<font color="#909090">=None</font>, title_exact<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds Spreadsheets feed query parameters to a request.<br>
+ <br>
+Args:<br>
+ title: str Specifies the search terms for the title of a document.<br>
+ This parameter used without title-exact will only submit partial<br>
+ queries, not exact queries.<br>
+ title_exact: str Specifies whether the title query should be taken as an<br>
+ exact string. Meaningless without title. Possible values are<br>
+ 'true' and 'false'.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetQuery-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><a name="SpreadsheetQuery-AddCustomParameter"><strong>AddCustomParameter</strong></a> = add_custom_parameter(self, key, value)</dt></dl>
+
+<dl><dt><a name="SpreadsheetQuery-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetsClient">class <strong>SpreadsheetsClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.client.html#SpreadsheetsClient">SpreadsheetsClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SpreadsheetsClient-AddListEntry"><strong>AddListEntry</strong></a> = <a href="#SpreadsheetsClient-add_list_entry">add_list_entry</a>(self, list_entry, spreadsheet_key, worksheet_id, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-AddRecord"><strong>AddRecord</strong></a> = <a href="#SpreadsheetsClient-add_record">add_record</a>(self, spreadsheet_key, table_id, fields, title<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-AddTable"><strong>AddTable</strong></a> = <a href="#SpreadsheetsClient-add_table">add_table</a>(self, spreadsheet_key, title, summary, worksheet_name, header_row, num_rows, start_row, insertion_mode, column_headers, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-AddWorksheet"><strong>AddWorksheet</strong></a> = <a href="#SpreadsheetsClient-add_worksheet">add_worksheet</a>(self, spreadsheet_key, title, rows, cols, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetCell"><strong>GetCell</strong></a> = <a href="#SpreadsheetsClient-get_cell">get_cell</a>(self, spreadsheet_key, worksheet_id, row_num, col_num, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.CellEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetCells"><strong>GetCells</strong></a> = <a href="#SpreadsheetsClient-get_cells">get_cells</a>(self, spreadsheet_key, worksheet_id, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.CellsFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetListFeed"><strong>GetListFeed</strong></a> = <a href="#SpreadsheetsClient-get_list_feed">get_list_feed</a>(self, spreadsheet_key, worksheet_id, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.ListsFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetRecord"><strong>GetRecord</strong></a> = <a href="#SpreadsheetsClient-get_record">get_record</a>(self, spreadsheet_key, table_id, record_id, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.Record'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetRecords"><strong>GetRecords</strong></a> = <a href="#SpreadsheetsClient-get_records">get_records</a>(self, spreadsheet_key, table_id, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.RecordsFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetSpreadsheets"><strong>GetSpreadsheets</strong></a> = <a href="#SpreadsheetsClient-get_spreadsheets">get_spreadsheets</a>(self, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.SpreadsheetsFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetTables"><strong>GetTables</strong></a> = <a href="#SpreadsheetsClient-get_tables">get_tables</a>(self, spreadsheet_key, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.TablesFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetWorksheet"><strong>GetWorksheet</strong></a> = <a href="#SpreadsheetsClient-get_worksheet">get_worksheet</a>(self, spreadsheet_key, worksheet_id, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.WorksheetEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetWorksheets"><strong>GetWorksheets</strong></a> = <a href="#SpreadsheetsClient-get_worksheets">get_worksheets</a>(self, spreadsheet_key, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.WorksheetsFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-add_list_entry"><strong>add_list_entry</strong></a>(self, list_entry, spreadsheet_key, worksheet_id, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds a new row to the worksheet's list feed.<br>
+ <br>
+Args:<br>
+ list_entry: gdata.spreadsheets.data.ListsEntry An entry which contains<br>
+ the values which should be set for the columns in this<br>
+ record.<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ worksheet_id: str, The unique ID of the worksheet in this spreadsheet<br>
+ whose cells we want. This can be obtained using<br>
+ WorksheetEntry's get_worksheet_id method.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-add_record"><strong>add_record</strong></a>(self, spreadsheet_key, table_id, fields, title<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds a new row to the table.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ table_id: str, The ID of the table within the worksheet which should<br>
+ receive this new record. The table ID can be found using the<br>
+ get_table_id method of a gdata.spreadsheets.data.Table.<br>
+ fields: dict of strings mapping column names to values.<br>
+ title: str, optional The title for this row.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-add_table"><strong>add_table</strong></a>(self, spreadsheet_key, title, summary, worksheet_name, header_row, num_rows, start_row, insertion_mode, column_headers, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new table within the worksheet.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ title: str, The title for the new table within a worksheet.<br>
+ summary: str, A description of the table.<br>
+ worksheet_name: str The name of the worksheet in which this table<br>
+ should live.<br>
+ header_row: int or str, The number of the row in the worksheet which<br>
+ will contain the column names for the data in this table.<br>
+ num_rows: int or str, The number of adjacent rows in this table.<br>
+ start_row: int or str, The number of the row at which the data begins.<br>
+ insertion_mode: str<br>
+ column_headers: dict of strings, maps the column letters (A, B, C) to<br>
+ the desired name which will be viewable in the<br>
+ worksheet.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-add_worksheet"><strong>add_worksheet</strong></a>(self, spreadsheet_key, title, rows, cols, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new worksheet entry in the spreadsheet.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ title: str, The title to be used in for the worksheet.<br>
+ rows: str or int, The number of rows this worksheet should start with.<br>
+ cols: str or int, The number of columns this worksheet should start with.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_cell"><strong>get_cell</strong></a>(self, spreadsheet_key, worksheet_id, row_num, col_num, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.CellEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves a single cell from the worksheet.<br>
+ <br>
+Indexes are 1 based so the first cell in the worksheet is 1, 1.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ worksheet_id: str, The unique ID of the worksheet in this spreadsheet<br>
+ whose cells we want. This can be obtained using<br>
+ WorksheetEntry's get_worksheet_id method.<br>
+ row_num: int, The row of the cell that we want. Numbering starts with 1.<br>
+ col_num: int, The column of the cell we want. Numbering starts with 1.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.spreadsheets.data.CellEntry.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_cells"><strong>get_cells</strong></a>(self, spreadsheet_key, worksheet_id, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.CellsFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves the cells which have values in this spreadsheet.<br>
+ <br>
+Blank cells are not included.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ worksheet_id: str, The unique ID of the worksheet in this spreadsheet<br>
+ whose cells we want. This can be obtained using<br>
+ WorksheetEntry's get_worksheet_id method.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.spreadsheets.data.CellsFeed.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_list_feed"><strong>get_list_feed</strong></a>(self, spreadsheet_key, worksheet_id, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.ListsFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves the value rows from the worksheet's list feed.<br>
+ <br>
+The list feed is a view of the spreadsheet in which the first row is used<br>
+for column names and subsequent rows up to the first blank line are<br>
+records.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ worksheet_id: str, The unique ID of the worksheet in this spreadsheet<br>
+ whose cells we want. This can be obtained using<br>
+ WorksheetEntry's get_worksheet_id method.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.spreadsheets.data.ListsFeed.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_record"><strong>get_record</strong></a>(self, spreadsheet_key, table_id, record_id, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.Record'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves a single record from the table.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ table_id: str, The ID of the table within the worksheet whose records<br>
+ we would like to fetch. The table ID can be found using the<br>
+ get_table_id method of a gdata.spreadsheets.data.Table.<br>
+ record_id: str, The ID of the record within this table which we want to<br>
+ fetch. You can find the record ID using get_record_id() on<br>
+ an instance of the gdata.spreadsheets.data.Record class.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.spreadsheets.data.RecordsFeed.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_records"><strong>get_records</strong></a>(self, spreadsheet_key, table_id, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.RecordsFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves the records in a table.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ table_id: str, The ID of the table within the worksheet whose records<br>
+ we would like to fetch. The table ID can be found using the<br>
+ get_table_id method of a gdata.spreadsheets.data.Table.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.spreadsheets.data.RecordsFeed.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_spreadsheets"><strong>get_spreadsheets</strong></a>(self, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.SpreadsheetsFeed'></font>, **kwargs)</dt><dd><tt>Obtains a feed with the spreadsheets belonging to the current user.<br>
+ <br>
+Args:<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.spreadsheets.data.SpreadsheetsFeed.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_tables"><strong>get_tables</strong></a>(self, spreadsheet_key, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.TablesFeed'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves a feed listing the tables in this spreadsheet.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.spreadsheets.data.TablesFeed.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_worksheet"><strong>get_worksheet</strong></a>(self, spreadsheet_key, worksheet_id, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.WorksheetEntry'></font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieves a single worksheet.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ worksheet_id: str, The unique ID for the worksheet withing the desired<br>
+ spreadsheet.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.spreadsheets.data.WorksheetEntry.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_worksheets"><strong>get_worksheets</strong></a>(self, spreadsheet_key, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.spreadsheets.data.WorksheetsFeed'></font>, **kwargs)</dt><dd><tt>Finds the worksheets within a given spreadsheet.<br>
+ <br>
+Args:<br>
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This<br>
+ can be the ID from the URL or as provided in a<br>
+ Spreadsheet entry.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others. Represents the current user. Defaults to None<br>
+ and if None, this method will look for a value in the<br>
+ auth_token member of <a href="#SpreadsheetsClient">SpreadsheetsClient</a>.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned. Defaults to<br>
+ gdata.spreadsheets.data.WorksheetsFeed.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '3'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ('https://spreadsheets.google.com/feeds/',)</dl>
+
+<dl><dt><strong>auth_service</strong> = 'wise'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="SpreadsheetsClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ <a href="#SpreadsheetsClient">SpreadsheetsClient</a>, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ <a href="#SpreadsheetsClient">SpreadsheetsClient</a>, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A RequestError or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A RequestError if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="SpreadsheetsClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-__init__"><strong>__init__</strong></a>(self, http_client<font color="#909090">=None</font>, host<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, source<font color="#909090">=None</font>, xoauth_requestor_id<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new AtomPubClient instance.<br>
+ <br>
+Args:<br>
+ source: The name of your application.<br>
+ http_client: An object capable of performing HTTP requests through a<br>
+ request method. This object is used to perform the request<br>
+ when the AtomPubClient's request method is called. Used to<br>
+ allow HTTP requests to be directed to a mock server, or use<br>
+ an alternate library instead of the default of httplib to<br>
+ make HTTP requests.<br>
+ host: str The default host name to use if a host is not specified in the<br>
+ requested URI.<br>
+ auth_token: An object which sets the HTTP Authorization header when its<br>
+ modify_request method is called.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TableQuery">class <strong>TableQuery</strong></a>(<a href="gdata.spreadsheets.client.html#ListQuery">ListQuery</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.client.html#TableQuery">TableQuery</a></dd>
+<dd><a href="gdata.spreadsheets.client.html#ListQuery">ListQuery</a></dd>
+<dd><a href="gdata.client.html#Query">gdata.client.Query</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.spreadsheets.client.html#ListQuery">ListQuery</a>:<br>
+<dl><dt><a name="TableQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt></dl>
+
+<dl><dt><a name="TableQuery-__init__"><strong>__init__</strong></a>(self, order_by<font color="#909090">=None</font>, reverse<font color="#909090">=None</font>, sq<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds List-feed specific query parameters to a request.<br>
+ <br>
+Args:<br>
+ order_by: str Specifies what column to use in ordering the entries in<br>
+ the feed. By position (the default): 'position' returns<br>
+ rows in the order in which they appear in the GUI. Row 1, then<br>
+ row 2, then row 3, and so on. By column:<br>
+ 'column:columnName' sorts rows in ascending order based on the<br>
+ values in the column with the given columnName, where<br>
+ columnName is the value in the header row for that column.<br>
+ reverse: str Specifies whether to sort in descending or ascending order.<br>
+ Reverses default sort order: 'true' results in a descending<br>
+ sort; 'false' (the default) results in an ascending sort.<br>
+ sq: str Structured query on the full text in the worksheet.<br>
+ [columnName][binaryOperator][value]<br>
+ Supported binaryOperators are:<br>
+ - (), for overriding order of operations<br>
+ - = or ==, for strict equality<br>
+ - <> or !=, for strict inequality<br>
+ - and or &&, for boolean and<br>
+ - or or ||, for boolean or</tt></dd></dl>
+
+<dl><dt><a name="TableQuery-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><a name="TableQuery-AddCustomParameter"><strong>AddCustomParameter</strong></a> = add_custom_parameter(self, key, value)</dt></dl>
+
+<dl><dt><a name="TableQuery-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WorksheetQuery">class <strong>WorksheetQuery</strong></a>(<a href="gdata.spreadsheets.client.html#SpreadsheetQuery">SpreadsheetQuery</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.client.html#WorksheetQuery">WorksheetQuery</a></dd>
+<dd><a href="gdata.spreadsheets.client.html#SpreadsheetQuery">SpreadsheetQuery</a></dd>
+<dd><a href="gdata.client.html#Query">gdata.client.Query</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.spreadsheets.client.html#SpreadsheetQuery">SpreadsheetQuery</a>:<br>
+<dl><dt><a name="WorksheetQuery-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt></dl>
+
+<dl><dt><a name="WorksheetQuery-__init__"><strong>__init__</strong></a>(self, title<font color="#909090">=None</font>, title_exact<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Adds Spreadsheets feed query parameters to a request.<br>
+ <br>
+Args:<br>
+ title: str Specifies the search terms for the title of a document.<br>
+ This parameter used without title-exact will only submit partial<br>
+ queries, not exact queries.<br>
+ title_exact: str Specifies whether the title query should be taken as an<br>
+ exact string. Meaningless without title. Possible values are<br>
+ 'true' and 'false'.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetQuery-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><a name="WorksheetQuery-AddCustomParameter"><strong>AddCustomParameter</strong></a> = add_custom_parameter(self, key, value)</dt></dl>
+
+<dl><dt><a name="WorksheetQuery-add_custom_parameter"><strong>add_custom_parameter</strong></a>(self, key, value)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.client.html#Query">gdata.client.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>CELLS_URL</strong> = 'https://spreadsheets.google.com/feeds/cells/%s/%s/private/full'<br>
+<strong>CELL_URL</strong> = 'https://spreadsheets.google.com/feeds/cells/%s/%s/private/full/R%sC%s'<br>
+<strong>LISTS_URL</strong> = 'https://spreadsheets.google.com/feeds/list/%s/%s/private/full'<br>
+<strong>RECORDS_URL</strong> = 'https://spreadsheets.google.com/feeds/%s/records/%s'<br>
+<strong>RECORD_URL</strong> = 'https://spreadsheets.google.com/feeds/%s/records/%s/%s'<br>
+<strong>SPREADSHEETS_URL</strong> = 'https://spreadsheets.google.com/feeds/spreadsheets/private/full'<br>
+<strong>TABLES_URL</strong> = 'https://spreadsheets.google.com/feeds/%s/tables'<br>
+<strong>WORKSHEETS_URL</strong> = 'https://spreadsheets.google.com/feeds/worksheets/%s/private/full'<br>
+<strong>WORKSHEET_URL</strong> = 'https://spreadsheets.google.com/feeds/worksheets/%s/private/full/%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.spreadsheets.data.html b/pydocs/gdata.spreadsheets.data.html
new file mode 100644
index 0000000..8c8f464
--- /dev/null
+++ b/pydocs/gdata.spreadsheets.data.html
@@ -0,0 +1,6024 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.spreadsheets.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.spreadsheets.html"><font color="#ffffff">spreadsheets</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheets/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheets/data.py</a></font></td></tr></table>
+ <p><tt>Provides classes and constants for the XML in the Google Spreadsheets API.<br>
+ <br>
+Documentation for the raw XML which these classes represent can be found here:<br>
+<a href="http://code.google.com/apis/spreadsheets/docs/3.0/reference.html#Elements">http://code.google.com/apis/spreadsheets/docs/3.0/reference.html#Elements</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#Cell">Cell</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#ColCount">ColCount</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#Data">Data</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#Field">Field</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#Column">Column</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#Header">Header</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#ListRow">ListRow</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#RowCount">RowCount</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#Worksheet">Worksheet</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#HeaderNotSet">HeaderNotSet</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#FieldMissing">FieldMissing</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#CellEntry">CellEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#CellsFeed">CellsFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#ListEntry">ListEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#Record">Record</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#Spreadsheet">Spreadsheet</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#Table">Table</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#WorksheetEntry">WorksheetEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#ListsFeed">ListsFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#RecordsFeed">RecordsFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#SpreadsheetsFeed">SpreadsheetsFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#TablesFeed">TablesFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.spreadsheets.data.html#WorksheetsFeed">WorksheetsFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Cell">class <strong>Cell</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gs:cell element.<br>
+ <br>
+A cell in the worksheet. The <gs:cell> element can appear only as a child<br>
+of <atom:entry>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#Cell">Cell</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>col</strong> = 'col'</dl>
+
+<dl><dt><strong>input_value</strong> = 'inputValue'</dl>
+
+<dl><dt><strong>numeric_value</strong> = 'numericValue'</dl>
+
+<dl><dt><strong>row</strong> = 'row'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Cell-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Cell-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Cell-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Cell-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Cell-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Cell-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Cell-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Cell-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Cell-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Cell-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CellEntry">class <strong>CellEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom entry representing a single cell in a worksheet.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#CellEntry">CellEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>cell</strong> = <class 'gdata.spreadsheets.data.Cell'><dd><tt>The gs:cell element.<br>
+ <br>
+A cell in the worksheet. The <gs:cell> element can appear only as a child<br>
+of <atom:entry>.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CellEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CellEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CellEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CellEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CellEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CellEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CellsFeed">class <strong>CellsFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom feed contains one entry per cell in a worksheet.<br>
+ <br>
+The cell feed supports batch operations, you can send multiple cell<br>
+operations in one HTTP request.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#CellsFeed">CellsFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CellsFeed-AddSetCell"><strong>AddSetCell</strong></a> = <a href="#CellsFeed-add_set_cell">add_set_cell</a>(self, row, col, input_value)</dt></dl>
+
+<dl><dt><a name="CellsFeed-add_set_cell"><strong>add_set_cell</strong></a>(self, row, col, input_value)</dt><dd><tt>Adds a request to change the contents of a cell to this batch request.<br>
+ <br>
+Args:<br>
+ row: int, The row number for this cell. Numbering starts at 1.<br>
+ col: int, The column number for this cell. Starts at 1.<br>
+ input_value: str, The desired formula/content this cell should contain.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.spreadsheets.data.CellEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="CellsFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CellsFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CellsFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CellsFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CellsFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CellsFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CellsFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CellsFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ColCount">class <strong>ColCount</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gs:colCount element.<br>
+ <br>
+Indicates the number of columns in the worksheet, including columns that<br>
+contain only empty cells. The <gs:colCount> element can appear as a child<br>
+of <atom:entry> or <atom:feed><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#ColCount">ColCount</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ColCount-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ColCount-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ColCount-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ColCount-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ColCount-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ColCount-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ColCount-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ColCount-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ColCount-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ColCount-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Column">class <strong>Column</strong></a>(<a href="gdata.spreadsheets.data.html#Field">Field</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gs:column element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#Column">Column</a></dd>
+<dd><a href="gdata.spreadsheets.data.html#Field">Field</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.spreadsheets.data.html#Field">Field</a>:<br>
+<dl><dt><strong>index</strong> = 'index'</dl>
+
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Column-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Column-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Column-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Column-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Column-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Column-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Column-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Column-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Column-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Column-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Data">class <strong>Data</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gs:data element.<br>
+ <br>
+A data region of a table. Contained in an <atom:entry> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#Data">Data</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>column</strong> = [<class 'gdata.spreadsheets.data.Column'>]</dl>
+
+<dl><dt><strong>insertion_mode</strong> = 'insertionMode'</dl>
+
+<dl><dt><strong>num_rows</strong> = 'numRows'</dl>
+
+<dl><dt><strong>start_row</strong> = 'startRow'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Data-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Data-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Data-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Data-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Data-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Data-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Data-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Data-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Data-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Data-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Field">class <strong>Field</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gs:field element.<br>
+ <br>
+A field single cell within a record. Contained in an <atom:entry>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#Field">Field</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>index</strong> = 'index'</dl>
+
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Field-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Field-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Field-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Field-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Field-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Field-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Field-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Field-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Field-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Field-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FieldMissing">class <strong>FieldMissing</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#FieldMissing">FieldMissing</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="FieldMissing-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#FieldMissing-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#FieldMissing-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="FieldMissing-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#FieldMissing-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="FieldMissing-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#FieldMissing-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="FieldMissing-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#FieldMissing-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="FieldMissing-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#FieldMissing-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="FieldMissing-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="FieldMissing-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#FieldMissing-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="FieldMissing-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#FieldMissing-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="FieldMissing-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="FieldMissing-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#FieldMissing-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="FieldMissing-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Header">class <strong>Header</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gs:header element.<br>
+ <br>
+Indicates which row is the header row. Contained in an <atom:entry>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#Header">Header</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>row</strong> = 'row'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Header-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Header-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Header-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Header-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Header-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Header-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Header-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Header-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Header-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Header-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HeaderNotSet">class <strong>HeaderNotSet</strong></a>(<a href="gdata.spreadsheets.data.html#Error">Error</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The desired column header had no value for the row in the list feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#HeaderNotSet">HeaderNotSet</a></dd>
+<dd><a href="gdata.spreadsheets.data.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.spreadsheets.data.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="HeaderNotSet-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#HeaderNotSet-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#HeaderNotSet-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="HeaderNotSet-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#HeaderNotSet-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="HeaderNotSet-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#HeaderNotSet-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="HeaderNotSet-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#HeaderNotSet-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="HeaderNotSet-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#HeaderNotSet-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="HeaderNotSet-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="HeaderNotSet-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#HeaderNotSet-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="HeaderNotSet-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#HeaderNotSet-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="HeaderNotSet-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="HeaderNotSet-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#HeaderNotSet-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="HeaderNotSet-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ListEntry">class <strong>ListEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom entry representing a worksheet row in the list feed.<br>
+ <br>
+The values for a particular column can be get and set using<br>
+x.<a href="#ListEntry-get_value">get_value</a>('columnheader') and x.<a href="#ListEntry-set_value">set_value</a>('columnheader', 'value').<br>
+See also the explanation of column names in the ListFeed class.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#ListEntry">ListEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ListEntry-from_dict"><strong>from_dict</strong></a>(self, values)</dt><dd><tt>Sets values for this row from the dictionary.<br>
+ <br>
+Old values which are already in the entry will not be removed unless<br>
+they are overwritten with new values from the dict.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-get_value"><strong>get_value</strong></a>(self, column_name)</dt><dd><tt>Returns the displayed text for the desired column in this row.<br>
+ <br>
+The formula or input which generated the displayed value is not accessible<br>
+through the list feed, to see the user's input, use the cells feed.<br>
+ <br>
+If a column is not present in this spreadsheet, or there is no value<br>
+for a column in this row, this method will return None.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-set_value"><strong>set_value</strong></a>(self, column_name, value)</dt><dd><tt>Changes the value of cell in this row under the desired column name.<br>
+ <br>
+Warning: if the cell contained a formula, it will be wiped out by setting<br>
+the value using the list feed since the list feed only works with<br>
+displayed values.<br>
+ <br>
+No client side checking is performed on the column_name, you need to<br>
+ensure that the column_name is the local tag name in the gsx tag for the<br>
+column. For example, the column_name will not contain special characters,<br>
+spaces, uppercase letters, etc.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-to_dict"><strong>to_dict</strong></a>(self)</dt><dd><tt>Converts this row to a mapping of column names to their values.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="ListEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ListEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ListEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ListEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ListEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ListEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ListRow">class <strong>ListRow</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A gsx column value within a row.<br>
+ <br>
+The local tag in the _qname is blank and must be set to the column<br>
+name. For example, when adding to a <a href="#ListEntry">ListEntry</a>, do:<br>
+col_value = <a href="#ListRow">ListRow</a>(text='something')<br>
+col_value._qname = col_value._qname % 'mycolumnname'<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#ListRow">ListRow</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ListRow-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListRow-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListRow-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ListRow-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListRow-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ListRow-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ListRow-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListRow-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ListRow-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListRow-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ListsFeed">class <strong>ListsFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom feed in which each entry represents a row in a worksheet.<br>
+ <br>
+The first row in the worksheet is used as the column names for the values<br>
+in each row. If a header cell is empty, then a unique column ID is used<br>
+for the gsx element name.<br>
+ <br>
+Spaces in a column name are removed from the name of the corresponding<br>
+gsx element.<br>
+ <br>
+Caution: The columnNames are case-insensitive. For example, if you see<br>
+a <gsx:e-mail> element in a feed, you can't know whether the column<br>
+heading in the original worksheet was "e-mail" or "E-Mail".<br>
+ <br>
+Note: If two or more columns have the same name, then subsequent columns<br>
+of the same name have _n appended to the columnName. For example, if the<br>
+first column name is "e-mail", followed by columns named "E-Mail" and<br>
+"E-mail", then the columnNames will be gsx:e-mail, gsx:e-mail_2, and<br>
+gsx:e-mail_3 respectively.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#ListsFeed">ListsFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.spreadsheets.data.ListEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ListsFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ListsFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ListsFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ListsFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ListsFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ListsFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ListsFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Record">class <strong>Record</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom entry representing a single record in a table.<br>
+ <br>
+Note that the order of items in each record is the same as the order of<br>
+columns in the table definition, which may not match the order of<br>
+columns in the GUI.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#Record">Record</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Record-ValueForIndex"><strong>ValueForIndex</strong></a> = <a href="#Record-value_for_index">value_for_index</a>(self, column_index)</dt></dl>
+
+<dl><dt><a name="Record-ValueForName"><strong>ValueForName</strong></a> = <a href="#Record-value_for_name">value_for_name</a>(self, name)</dt></dl>
+
+<dl><dt><a name="Record-get_record_id"><strong>get_record_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-value_for_index"><strong>value_for_index</strong></a>(self, column_index)</dt></dl>
+
+<dl><dt><a name="Record-value_for_name"><strong>value_for_name</strong></a>(self, name)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>field</strong> = [<class 'gdata.spreadsheets.data.Field'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="Record-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Record-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="Record-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="Record-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Record-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="Record-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Record-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Record-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Record-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Record-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Record-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Record-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Record-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Record-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="Record-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="Record-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Record-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Record-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Record-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Record-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Record-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Record-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="Record-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="Record-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Record-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Record-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Record-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Record-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="Record-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Record-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Record-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Record-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Record-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Record-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Record-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Record-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Record-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Record-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Record-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Record-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Record-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Record-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Record-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Record-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Record-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Record-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Record-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RecordsFeed">class <strong>RecordsFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom feed containing the individuals records in a table.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#RecordsFeed">RecordsFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.spreadsheets.data.Record'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="RecordsFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="RecordsFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="RecordsFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="RecordsFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="RecordsFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RecordsFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordsFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RowCount">class <strong>RowCount</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gs:rowCount element.<br>
+ <br>
+Indicates the number of total rows in the worksheet, including rows that<br>
+contain only empty cells. The <gs:rowCount> element can appear as a<br>
+child of <atom:entry> or <atom:feed>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#RowCount">RowCount</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="RowCount-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RowCount-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RowCount-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RowCount-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RowCount-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="RowCount-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="RowCount-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RowCount-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RowCount-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RowCount-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Spreadsheet">class <strong>Spreadsheet</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom entry which represents a Google <a href="#Spreadsheet">Spreadsheet</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#Spreadsheet">Spreadsheet</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Spreadsheet-FindWorksheetsFeed"><strong>FindWorksheetsFeed</strong></a> = <a href="#Spreadsheet-find_worksheets_feed">find_worksheets_feed</a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-GetSpreadsheetKey"><strong>GetSpreadsheetKey</strong></a> = <a href="#Spreadsheet-get_spreadsheet_key">get_spreadsheet_key</a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-find_worksheets_feed"><strong>find_worksheets_feed</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-get_spreadsheet_key"><strong>get_spreadsheet_key</strong></a>(self)</dt><dd><tt>Extracts the spreadsheet key unique to this spreadsheet.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="Spreadsheet-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="Spreadsheet-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Spreadsheet-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="Spreadsheet-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="Spreadsheet-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Spreadsheet-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Spreadsheet-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SpreadsheetsFeed">class <strong>SpreadsheetsFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom feed listing a user's Google Spreadsheets.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#SpreadsheetsFeed">SpreadsheetsFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.spreadsheets.data.Spreadsheet'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="SpreadsheetsFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="SpreadsheetsFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SpreadsheetsFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="SpreadsheetsFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SpreadsheetsFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Table">class <strong>Table</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom entry that represents a subsection of a worksheet.<br>
+ <br>
+A table allows you to treat part or all of a worksheet somewhat like a<br>
+table in a database that is, as a set of structured data items. Tables<br>
+don't exist until you explicitly create them before you can use a table<br>
+feed, you have to explicitly define where the table data comes from.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#Table">Table</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Table-GetTableId"><strong>GetTableId</strong></a> = <a href="#Table-get_table_id">get_table_id</a>(self)</dt></dl>
+
+<dl><dt><a name="Table-get_table_id"><strong>get_table_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>data</strong> = <class 'gdata.spreadsheets.data.Data'><dd><tt>The gs:data element.<br>
+ <br>
+A data region of a table. Contained in an <atom:entry> element.</tt></dl>
+
+<dl><dt><strong>header</strong> = <class 'gdata.spreadsheets.data.Header'><dd><tt>The gs:header element.<br>
+ <br>
+Indicates which row is the header row. Contained in an <atom:entry>.</tt></dl>
+
+<dl><dt><strong>worksheet</strong> = <class 'gdata.spreadsheets.data.Worksheet'><dd><tt>The gs:worksheet element.<br>
+ <br>
+The worksheet where the table lives.Contained in an <atom:entry>.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="Table-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Table-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="Table-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="Table-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="Table-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="Table-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Table-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Table-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Table-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Table-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Table-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Table-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Table-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Table-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="Table-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="Table-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Table-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Table-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Table-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Table-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Table-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="Table-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="Table-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="Table-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="Table-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="Table-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="Table-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="Table-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="Table-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Table-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Table-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Table-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="Table-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="Table-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Table-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Table-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="Table-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="Table-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="Table-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="Table-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Table-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="Table-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="Table-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="Table-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="Table-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="Table-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Table-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TablesFeed">class <strong>TablesFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom feed containing the tables defined within a worksheet.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#TablesFeed">TablesFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.spreadsheets.data.Table'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="TablesFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="TablesFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TablesFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="TablesFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="TablesFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="TablesFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TablesFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Worksheet">class <strong>Worksheet</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The gs:worksheet element.<br>
+ <br>
+The worksheet where the table lives.Contained in an <atom:entry>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#Worksheet">Worksheet</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Worksheet-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Worksheet-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Worksheet-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Worksheet-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WorksheetEntry">class <strong>WorksheetEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An Atom entry representing a single worksheet in a spreadsheet.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#WorksheetEntry">WorksheetEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="WorksheetEntry-GetWorksheetId"><strong>GetWorksheetId</strong></a> = <a href="#WorksheetEntry-get_worksheet_id">get_worksheet_id</a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-get_worksheet_id"><strong>get_worksheet_id</strong></a>(self)</dt><dd><tt>The worksheet ID identifies this worksheet in its spreadsheet.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>col_count</strong> = <class 'gdata.spreadsheets.data.ColCount'><dd><tt>The gs:colCount element.<br>
+ <br>
+Indicates the number of columns in the worksheet, including columns that<br>
+contain only empty cells. The <gs:colCount> element can appear as a child<br>
+of <atom:entry> or <atom:feed></tt></dl>
+
+<dl><dt><strong>row_count</strong> = <class 'gdata.spreadsheets.data.RowCount'><dd><tt>The gs:rowCount element.<br>
+ <br>
+Indicates the number of total rows in the worksheet, including rows that<br>
+contain only empty cells. The <gs:rowCount> element can appear as a<br>
+child of <atom:entry> or <atom:feed>.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="WorksheetEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="WorksheetEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="WorksheetEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="WorksheetEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="WorksheetEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="WorksheetsFeed">class <strong>WorksheetsFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A feed containing the worksheets in a single spreadsheet.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.spreadsheets.data.html#WorksheetsFeed">WorksheetsFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.spreadsheets.data.WorksheetEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="WorksheetsFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="WorksheetsFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="WorksheetsFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="WorksheetsFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="WorksheetsFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="WorksheetsFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-BuildBatchCellsUpdate"><strong>BuildBatchCellsUpdate</strong></a> = build_batch_cells_update(spreadsheet_key, worksheet_id)</dt><dd><tt>Creates an empty cells feed for adding batch cell updates to.<br>
+ <br>
+Call batch_set_cell on the resulting <a href="#CellsFeed">CellsFeed</a> instance then send the batch<br>
+request TODO: fill in<br>
+ <br>
+Args:<br>
+ spreadsheet_key: The ID of the spreadsheet <br>
+ worksheet_id:</tt></dd></dl>
+ <dl><dt><a name="-build_batch_cells_update"><strong>build_batch_cells_update</strong></a>(spreadsheet_key, worksheet_id)</dt><dd><tt>Creates an empty cells feed for adding batch cell updates to.<br>
+ <br>
+Call batch_set_cell on the resulting <a href="#CellsFeed">CellsFeed</a> instance then send the batch<br>
+request TODO: fill in<br>
+ <br>
+Args:<br>
+ spreadsheet_key: The ID of the spreadsheet <br>
+ worksheet_id:</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>BATCH_EDIT_LINK_TEMPLATE</strong> = '%s/batch'<br>
+<strong>BATCH_ENTRY_ID_TEMPLATE</strong> = '%s/R%sC%s'<br>
+<strong>BATCH_POST_ID_TEMPLATE</strong> = 'https://spreadsheets.google.com/feeds/cells/%s/%s/private/full'<br>
+<strong>GSX_NAMESPACE</strong> = 'http://schemas.google.com/spreadsheets/2006/extended'<br>
+<strong>GS_TEMPLATE</strong> = '{http://schemas.google.com/spreadsheets/2006}%s'<br>
+<strong>INSERT_MODE</strong> = 'insert'<br>
+<strong>OVERWRITE_MODE</strong> = 'overwrite'<br>
+<strong>WORKSHEETS_REL</strong> = 'http://schemas.google.com/spreadsheets/2006#worksheetsfeed'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.spreadsheets.html b/pydocs/gdata.spreadsheets.html
new file mode 100644
index 0000000..3f9b709
--- /dev/null
+++ b/pydocs/gdata.spreadsheets.html
@@ -0,0 +1,23 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.spreadsheets</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.spreadsheets</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheets/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/spreadsheets/__init__.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.spreadsheets.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.spreadsheets.data.html">data</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.test_config.html b/pydocs/gdata.test_config.html
new file mode 100644
index 0000000..335e844
--- /dev/null
+++ b/pydocs/gdata.test_config.html
@@ -0,0 +1,190 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.test_config</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.test_config</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/test_config.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/test_config.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2009 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+<a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="getpass.html">getpass</a><br>
+<a href="inspect.html">inspect</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="unittest.html">unittest</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.test_config.html#ConfigCollection">ConfigCollection</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.test_config.html#Option">Option</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ConfigCollection">class <strong>ConfigCollection</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="ConfigCollection-__init__"><strong>__init__</strong></a>(self, options<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ConfigCollection-get_value"><strong>get_value</strong></a>(self, option_name)</dt></dl>
+
+<dl><dt><a name="ConfigCollection-register"><strong>register</strong></a>(self, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="ConfigCollection-register_option"><strong>register_option</strong></a>(self, option)</dt></dl>
+
+<dl><dt><a name="ConfigCollection-render_usage"><strong>render_usage</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ConfigCollection-set_value"><strong>set_value</strong></a>(self, option_name, value)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Option">class <strong>Option</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Option-__init__"><strong>__init__</strong></a>(self, name, prompt, secret<font color="#909090">=False</font>, description<font color="#909090">=None</font>, default<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="Option-get"><strong>get</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-build_suite"><strong>build_suite</strong></a>(classes)</dt><dd><tt>Creates a TestSuite for all unit test classes in the list.<br>
+ <br>
+Assumes that each of the classes in the list has unit test methods which<br>
+begin with 'test'. Calls unittest.makeSuite.<br>
+ <br>
+Returns: <br>
+ A new unittest.TestSuite containing a test suite for all classes.</tt></dd></dl>
+ <dl><dt><a name="-check_clients_with_auth"><strong>check_clients_with_auth</strong></a>(test, classes)</dt></dl>
+ <dl><dt><a name="-check_data_classes"><strong>check_data_classes</strong></a>(test, classes)</dt></dl>
+ <dl><dt><a name="-close_client"><strong>close_client</strong></a>(client)</dt><dd><tt>Saves the recoded responses to a temp file if the config file allows.<br>
+ <br>
+This should be called in the unit test's tearDown method.<br>
+ <br>
+Checks to see if the 'savecache' option is set to 'true', to make sure we<br>
+only save sessions to repeat if the user desires.</tt></dd></dl>
+ <dl><dt><a name="-close_service"><strong>close_service</strong></a>(service)</dt></dl>
+ <dl><dt><a name="-configure_cache"><strong>configure_cache</strong></a>(client, test_name)</dt><dd><tt>Loads or begins a cached session to record HTTP traffic.<br>
+ <br>
+Should be called at the beginning of each test method.<br>
+ <br>
+Args:<br>
+ client: a gdata.GDClient whose http_client member has been replaced<br>
+ with a atom.mock_http_core.MockHttpClient so that repeated<br>
+ executions can used cached responses instead of contacting<br>
+ the server.<br>
+ test_name: str The name of this test method. Examples: <br>
+ 'TestClass.test_x_works', 'TestClass.test_crud_operations'.<br>
+ This is used to name the recording of the HTTP requests and<br>
+ responses, so it should be unique to each test method in the<br>
+ test case.</tt></dd></dl>
+ <dl><dt><a name="-configure_client"><strong>configure_client</strong></a>(client, case_name, service_name, use_apps_auth<font color="#909090">=False</font>)</dt><dd><tt>Sets up a mock client which will reuse a saved session.<br>
+ <br>
+Should be called during setUp of each unit test.<br>
+ <br>
+Handles authentication to allow the GDClient to make requests which<br>
+require an auth header.<br>
+ <br>
+Args:<br>
+ client: a gdata.GDClient whose http_client member should be replaced<br>
+ with a atom.mock_http_core.MockHttpClient so that repeated<br>
+ executions can used cached responses instead of contacting<br>
+ the server.<br>
+ case_name: str The name of the test case class. Examples: 'BloggerTest',<br>
+ 'ContactsTest'. Used to save a session<br>
+ for the ClientLogin auth token request, so the case_name<br>
+ should be reused if and only if the same username, password,<br>
+ and service are being used.<br>
+ service_name: str The service name as used for ClientLogin to identify<br>
+ the Google Data API being accessed. Example: 'blogger',<br>
+ 'wise', etc.<br>
+ use_apps_auth: bool (optional) If set to True, use appsusername and<br>
+ appspassword command-line args instead of username and<br>
+ password respectively.</tt></dd></dl>
+ <dl><dt><a name="-configure_service"><strong>configure_service</strong></a>(service, case_name, service_name)</dt><dd><tt>Sets up a mock GDataService v1 client to reuse recorded sessions.<br>
+ <br>
+Should be called during setUp of each unit test. This is a duplicate of<br>
+configure_client, modified to handle old v1 service classes.</tt></dd></dl>
+ <dl><dt><a name="-configure_service_cache"><strong>configure_service_cache</strong></a>(service, test_name)</dt><dd><tt>Loads or starts a session recording for a v1 Service <a href="__builtin__.html#object">object</a>.<br>
+ <br>
+Duplicates the behavior of configure_cache, but the target for this<br>
+function is a v1 Service <a href="__builtin__.html#object">object</a> instead of a v2 Client.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>APPS_DOMAIN_OPTION</strong> = <gdata.test_config.Option object><br>
+<strong>BLOG_ID_OPTION</strong> = <gdata.test_config.Option object><br>
+<strong>GA_TABLE_ID</strong> = <gdata.test_config.Option object><br>
+<strong>ISSUE_ASSIGNEE_OPTION</strong> = <gdata.test_config.Option object><br>
+<strong>PROJECT_NAME_OPTION</strong> = <gdata.test_config.Option object><br>
+<strong>SITES_NAME_OPTION</strong> = <gdata.test_config.Option object><br>
+<strong>SPREADSHEET_ID_OPTION</strong> = <gdata.test_config.Option object><br>
+<strong>TARGET_USERNAME_OPTION</strong> = <gdata.test_config.Option object><br>
+<strong>TEST_IMAGE_LOCATION_OPTION</strong> = <gdata.test_config.Option object><br>
+<strong>YT_CLIENT_ID_OPTION</strong> = <gdata.test_config.Option object><br>
+<strong>YT_DEVELOPER_KEY_OPTION</strong> = <gdata.test_config.Option object><br>
+<strong>YT_VIDEO_ID_OPTION</strong> = <gdata.test_config.Option object><br>
+<strong>options</strong> = <gdata.test_config.ConfigCollection object></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.test_config_template.html b/pydocs/gdata.test_config_template.html
new file mode 100644
index 0000000..f1d7968
--- /dev/null
+++ b/pydocs/gdata.test_config_template.html
@@ -0,0 +1,243 @@
+
+<!doctype html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.test_config_template</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.test_config_template</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/svn/gdata-python-client/src/gdata/test_config_template.pyc">/usr/local/svn/gdata-python-client/src/gdata/test_config_template.pyc</a></font></td></tr></table>
+ <p><tt>Fill in this module with configuration data to use in tests.<br>
+ <br>
+See comments in the source code for explanations of the settings.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="os.html">os</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.test_config_template.html#NoAuthConfig">NoAuthConfig</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.test_config_template.html#TestConfig">TestConfig</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.test_config_template.html#BloggerConfig">BloggerConfig</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.test_config_template.html#ContactsConfig">ContactsConfig</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.test_config_template.html#MapsConfig">MapsConfig</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BloggerConfig">class <strong>BloggerConfig</strong></a>(<a href="gdata.test_config_template.html#TestConfig">TestConfig</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.test_config_template.html#BloggerConfig">BloggerConfig</a></dd>
+<dd><a href="gdata.test_config_template.html#TestConfig">TestConfig</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>blog_id</strong> = "<your test blog's id>"</dl>
+
+<dl><dt><strong>content</strong> = 'This is a <b>test</b>.'</dl>
+
+<dl><dt><strong>service</strong> = 'blogger'</dl>
+
+<dl><dt><strong>title</strong> = 'A Test Post'</dl>
+
+<hr>
+Class methods inherited from <a href="gdata.test_config_template.html#TestConfig">TestConfig</a>:<br>
+<dl><dt><a name="BloggerConfig-email"><strong>email</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Provides email to log into the test account for this service.<br>
+ <br>
+By default uses GOOGLE_ACCOUNT_EMAIL, so overwrite this function if you<br>
+have a service-specific test account.</tt></dd></dl>
+
+<dl><dt><a name="BloggerConfig-password"><strong>password</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Provides password to log into the test account for this service.<br>
+ <br>
+By default uses GOOGLE_ACCOUNT_PASSWORD, so overwrite this function if<br>
+you have a service-specific test account.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.test_config_template.html#TestConfig">TestConfig</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.test_config_template.html#TestConfig">TestConfig</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContactsConfig">class <strong>ContactsConfig</strong></a>(<a href="gdata.test_config_template.html#TestConfig">TestConfig</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.test_config_template.html#ContactsConfig">ContactsConfig</a></dd>
+<dd><a href="gdata.test_config_template.html#TestConfig">TestConfig</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Class methods defined here:<br>
+<dl><dt><a name="ContactsConfig-get_image_location"><strong>get_image_location</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>service</strong> = 'cp'</dl>
+
+<hr>
+Class methods inherited from <a href="gdata.test_config_template.html#TestConfig">TestConfig</a>:<br>
+<dl><dt><a name="ContactsConfig-email"><strong>email</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Provides email to log into the test account for this service.<br>
+ <br>
+By default uses GOOGLE_ACCOUNT_EMAIL, so overwrite this function if you<br>
+have a service-specific test account.</tt></dd></dl>
+
+<dl><dt><a name="ContactsConfig-password"><strong>password</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Provides password to log into the test account for this service.<br>
+ <br>
+By default uses GOOGLE_ACCOUNT_PASSWORD, so overwrite this function if<br>
+you have a service-specific test account.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.test_config_template.html#TestConfig">TestConfig</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.test_config_template.html#TestConfig">TestConfig</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MapsConfig">class <strong>MapsConfig</strong></a>(<a href="gdata.test_config_template.html#TestConfig">TestConfig</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.test_config_template.html#MapsConfig">MapsConfig</a></dd>
+<dd><a href="gdata.test_config_template.html#TestConfig">TestConfig</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>map_summary</strong> = 'A test description'</dl>
+
+<dl><dt><strong>map_title</strong> = 'Some test map'</dl>
+
+<dl><dt><strong>service</strong> = 'local'</dl>
+
+<hr>
+Class methods inherited from <a href="gdata.test_config_template.html#TestConfig">TestConfig</a>:<br>
+<dl><dt><a name="MapsConfig-email"><strong>email</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Provides email to log into the test account for this service.<br>
+ <br>
+By default uses GOOGLE_ACCOUNT_EMAIL, so overwrite this function if you<br>
+have a service-specific test account.</tt></dd></dl>
+
+<dl><dt><a name="MapsConfig-password"><strong>password</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Provides password to log into the test account for this service.<br>
+ <br>
+By default uses GOOGLE_ACCOUNT_PASSWORD, so overwrite this function if<br>
+you have a service-specific test account.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.test_config_template.html#TestConfig">TestConfig</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.test_config_template.html#TestConfig">TestConfig</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NoAuthConfig">class <strong>NoAuthConfig</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>auth_token</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TestConfig">class <strong>TestConfig</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Class methods defined here:<br>
+<dl><dt><a name="TestConfig-email"><strong>email</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Provides email to log into the test account for this service.<br>
+ <br>
+By default uses GOOGLE_ACCOUNT_EMAIL, so overwrite this function if you<br>
+have a service-specific test account.</tt></dd></dl>
+
+<dl><dt><a name="TestConfig-password"><strong>password</strong></a>(cls)<font color="#909090"><font face="helvetica, arial"> from <a href="__builtin__.html#type">__builtin__.type</a></font></font></dt><dd><tt>Provides password to log into the test account for this service.<br>
+ <br>
+By default uses GOOGLE_ACCOUNT_PASSWORD, so overwrite this function if<br>
+you have a service-specific test account.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>service</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>CACHE_RESPONSES</strong> = True<br>
+<strong>CLEAR_CACHE</strong> = True<br>
+<strong>GOOGLE_ACCOUNT_EMAIL</strong> = '<your email>'<br>
+<strong>GOOGLE_ACCOUNT_PASSWORD</strong> = '<your password>'<br>
+<strong>RUN_LIVE_TESTS</strong> = False<br>
+<strong>TEST_FILES_DIR</strong> = '<location of the tests directory>'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.test_data.html b/pydocs/gdata.test_data.html
new file mode 100644
index 0000000..e51d0f0
--- /dev/null
+++ b/pydocs/gdata.test_data.html
@@ -0,0 +1,138 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.test_data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.test_data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/test_data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/test_data.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2006 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>ACL_ENTRY</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font> <entry ...com/gCal/2005#owner'><font color="#c040c0">\n</font> </gAcl:role><font color="#c040c0">\n</font> </entry>"<br>
+<strong>ACL_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font> <feed x...#read'><font color="#c040c0">\n</font> </gAcl:role><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font> </feed>"<br>
+<strong>ALBUM_FEED</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><feed xml...ample.user</uri><font color="#c040c0">\n</font> </author><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>ANALYTICS_ACCOUNT_FEED</strong> = "<font color="#c040c0">\n</font><feed xmlns='http://www.w3.org/2005/Atom' xmlns...:tableId>ga:1174</dxp:tableId><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>ANALYTICS_ACCOUNT_FEED_old</strong> = "<font color="#c040c0">\n</font><feed xmlns='http://www.w3.org/2005/Atom' xmlns...e' value='America/Los_Angeles'/><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>ANALYTICS_DATA_FEED</strong> = "<font color="#c040c0">\n</font><feed xmlns='http://www.w3.org/2005/Atom' xmlns...type='integer' value='61095'/><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>ANALYTICS_MGMT_ADV_SEGMENT_FEED</strong> = "<font color="#c040c0">\n</font><feed xmlns='http://www.w3.org/2005/Atom' xmlns...efinition><font color="#c040c0">\n</font> </dxp:segment><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed><font color="#c040c0">\n</font>"<br>
+<strong>ANALYTICS_MGMT_GOAL_FEED</strong> = "<font color="#c040c0">\n</font><feed xmlns='http://www.w3.org/2005/Atom' xmlns...'ga:profileId' value='1174'/><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed><font color="#c040c0">\n</font>"<br>
+<strong>ANALYTICS_MGMT_PROFILE_FEED</strong> = "<font color="#c040c0">\n</font><feed xmlns='http://www.w3.org/2005/Atom' xmlns...value='America/Los_Angeles'/><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed><font color="#c040c0">\n</font>"<br>
+<strong>BATCH_ENTRY</strong> = '<?xml version=<font color="#c040c0">\'</font>1.0<font color="#c040c0">\'</font> encoding=<font color="#c040c0">\'</font>UTF-8<font color="#c040c0">\'</font>?><font color="#c040c0">\n</font><entry xm...tch:status code="201" reason="Created"/><font color="#c040c0">\n</font></entry>'<br>
+<strong>BATCH_FEED_REQUEST</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><feed<font color="#c040c0">\n</font> x...tem_type>recipes</g:item_type><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>BATCH_FEED_RESULT</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><feed<font color="#c040c0">\n</font> x... code="200" reason="Success"/><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>BIG_FEED</strong> = '<?xml version="1.0" encoding="utf-8"?><font color="#c040c0">\n</font> <feed .../div><font color="#c040c0">\n</font> </content><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font> </feed><font color="#c040c0">\n</font>'<br>
+<strong>BLOG_COMMENTS_FEED</strong> = '<feed xmlns="http://www.w3.org/2005/Atom" xmlns:...D<font color="#c040c0">\'\n</font> type=<font color="#c040c0">\'</font>text/html<font color="#c040c0">\'</font> /><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>BLOG_ENTRY</strong> = "<entry xmlns='http://www.w3.org/2005/Atom'><font color="#c040c0">\n</font> <i...<email>liz@gmail.com</email><font color="#c040c0">\n</font> </author><font color="#c040c0">\n</font></entry>"<br>
+<strong>BLOG_POST</strong> = "<entry xmlns='http://www.w3.org/2005/Atom'><font color="#c040c0">\n</font> <t...<email>liz@gmail.com</email><font color="#c040c0">\n</font> </author><font color="#c040c0">\n</font></entry>"<br>
+<strong>BLOG_POSTS_FEED</strong> = "<feed xmlns='http://www.w3.org/2005/Atom'><font color="#c040c0">\n</font> <id...mail.com</email><font color="#c040c0">\n</font> </author><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>BOOK_ENTRY</strong> = "<?xml version='1.0' encoding='UTF-8'?><entry xml...><dc:title>A theory of justice</dc:title></entry>"<br>
+<strong>BOOK_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><feed xmln...tle>A theory of justice</dc:title></entry></feed>"<br>
+<strong>CALENDAR_BATCH_REQUEST</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><feed xml...hsgq1sjbqffqc/63326018324' /><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed><font color="#c040c0">\n</font>"<br>
+<strong>CALENDAR_BATCH_RESPONSE</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><feed xml...type='text'>Deleted</content><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed><font color="#c040c0">\n</font>"<br>
+<strong>CALENDAR_FEED</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><feed xml...re valueString=''></gd:where><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed><font color="#c040c0">\n</font>"<br>
+<strong>CALENDAR_FULL_EVENT_FEED</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><feed xml...07-03-15' /><font color="#c040c0">\n</font> <gd:where /><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed><font color="#c040c0">\n</font>"<br>
+<strong>CALENDAR_RESOURCES_FEED</strong> = '<?xml version="1.0"?><font color="#c040c0">\n</font><feed xmlns="http://www.w3...resourceType" value="(Bike)"/><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>CALENDAR_RESOURCE_ENTRY</strong> = '<?xml version="1.0"?><font color="#c040c0">\n</font><atom:entry xmlns:atom="ht...ty name="resourceType" value="CR"/><font color="#c040c0">\n</font></atom:entry>'<br>
+<strong>CODE_SEARCH_FEED</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><feed xml...cs:match><rights>Apache</rights></entry><font color="#c040c0">\n\n</font></feed>'<br>
+<strong>CONTACTS_FEED</strong> = '<?xml version=<font color="#c040c0">\'</font>1.0<font color="#c040c0">\'</font> encoding=<font color="#c040c0">\'</font>UTF-8<font color="#c040c0">\'</font>?><font color="#c040c0">\n</font><feed xml.../liz%40gmail.com/base/270f" /><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>CONTACT_GROUPS_FEED</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><feed xml.../thin/270f/1210770619070000"/><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>CONTACT_GROUP_ENTRY</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><entry xm...eople.</info><font color="#c040c0">\n</font> </gd:extendedProperty><font color="#c040c0">\n</font></entry>'<br>
+<strong>DOCUMENT_LIST_ACL_ADDITIONAL_ROLE_ENTRY</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><entry xm...ope type='domain' value='example.com' /><font color="#c040c0">\n</font></entry>"<br>
+<strong>DOCUMENT_LIST_ACL_ENTRY</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><entry xm...ope type='user' value='user@gmail.com'/><font color="#c040c0">\n</font></entry>"<br>
+<strong>DOCUMENT_LIST_ACL_FEED</strong> = '<?xml version=<font color="#c040c0">\'</font>1.0<font color="#c040c0">\'</font> encoding=<font color="#c040c0">\'</font>UTF-8<font color="#c040c0">\'</font>?><font color="#c040c0">\n</font><feed xml...pe="domain" value="google.com"/><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>DOCUMENT_LIST_ACL_WITHKEY_ENTRY</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><entry xm...ope type='domain' value='example.com' /><font color="#c040c0">\n</font></entry>"<br>
+<strong>DOCUMENT_LIST_ENTRY</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><ns0:entr...ns2:writersCanInvite value='true'/><font color="#c040c0">\n</font></ns0:entry><font color="#c040c0">\n</font>"<br>
+<strong>DOCUMENT_LIST_ENTRY_V3</strong> = '<?xml version=<font color="#c040c0">\'</font>1.0<font color="#c040c0">\'</font> encoding=<font color="#c040c0">\'</font>UTF-8<font color="#c040c0">\'</font>?><font color="#c040c0">\n</font><ns0:entr...load" label="restricted-download"/><font color="#c040c0">\n</font></ns0:entry><font color="#c040c0">\n</font>'<br>
+<strong>DOCUMENT_LIST_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><ns0:feed...07-07-09T23:07:21.898Z</ns0:updated><font color="#c040c0">\n</font></ns0:feed><font color="#c040c0">\n</font>"<br>
+<strong>DOCUMENT_LIST_METADATA</strong> = '<font color="#c040c0">\n</font><entry xmlns="http://www.w3.org/2005/Atom"<font color="#c040c0">\n</font> ...alRoleSet><font color="#c040c0">\n</font> </docs:additionalRoleInfo><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font>'<br>
+<strong>DOCUMENT_LIST_REVISION_FEED</strong> = '<?xml version=<font color="#c040c0">\'</font>1.0<font color="#c040c0">\'</font> encoding=<font color="#c040c0">\'</font>UTF-8<font color="#c040c0">\'</font>?><font color="#c040c0">\n</font><feed xml...shOutsideDomain value="false"/><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed><font color="#c040c0">\n</font>'<br>
+<strong>EMAIL_LIST_ENTRY</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><atom:ent...mailList/2.0/testlist/recipient/"/><font color="#c040c0">\n</font></atom:entry>'<br>
+<strong>EMAIL_LIST_FEED</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><atom:fee...-eng/recipient/"/><font color="#c040c0">\n</font> </atom:entry><font color="#c040c0">\n</font></atom:feed>'<br>
+<strong>EMAIL_LIST_RECIPIENT_ENTRY</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><atom:ent...:who email="TestUser@example.com"/><font color="#c040c0">\n</font></atom:entry>'<br>
+<strong>EMAIL_LIST_RECIPIENT_FEED</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><atom:fee...san@example.com"/><font color="#c040c0">\n</font> </atom:entry><font color="#c040c0">\n</font></atom:feed>'<br>
+<strong>EXTENSION_TREE</strong> = '<?xml version="1.0" encoding="utf-8"?><font color="#c040c0">\n</font> <feed ...oo><font color="#c040c0">\n</font> </g:name><font color="#c040c0">\n</font> </g:author><font color="#c040c0">\n</font> </feed><font color="#c040c0">\n</font>'<br>
+<strong>GBASE_ATTRIBUTE_ENTRY</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font> <entry x...gm:value><font color="#c040c0">\n</font> </gm:attribute><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font>"<br>
+<strong>GBASE_ATTRIBUTE_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font> <feed... </gm:attribute><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font> </feed><font color="#c040c0">\n</font>"<br>
+<strong>GBASE_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><feed xml...id type='text'>305685-REG</g:id><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>GBASE_LOCALES_FEED</strong> = '<?xml version=<font color="#c040c0">\'</font>1.0<font color="#c040c0">\'</font> encoding=<font color="#c040c0">\'</font>UTF-8<font color="#c040c0">\'</font>?><font color="#c040c0">\n</font><feed xml....com/base/feeds/locales/de_DE"/><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>GBASE_STRING_ENCODING_ENTRY</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><entry xm...2008-02-06T03:26:46Z</g:expiration_date><font color="#c040c0">\n</font></entry>"<br>
+<strong>GROUP_ENTRY</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><entry xm...ty name='description' value='For try' /><font color="#c040c0">\n</font></entry>"<br>
+<strong>GROUP_FEED</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><feed xml...escription' value='For try' /><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>GROUP_MEMBER_ENTRY</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><entry xm...erty name='directMember' value='true' /><font color="#c040c0">\n</font></entry>"<br>
+<strong>GROUP_MEMBER_FEED</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><feed xml...'directMember' value='true' /><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>HEALTH_CCR_NOTICE_PAYLOAD</strong> = '<ContinuityOfCareRecord xmlns="urn:astm-org:CCR"... </Problems><font color="#c040c0">\n</font> </Body><font color="#c040c0">\n</font></ContinuityOfCareRecord>'<br>
+<strong>HEALTH_PROFILE_ENTRY_DIGEST</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><entry xm... </Actors><font color="#c040c0">\n</font> </ContinuityOfCareRecord><font color="#c040c0">\n</font></entry>'<br>
+<strong>HEALTH_PROFILE_FEED</strong> = '<feed xmlns="http://www.w3.org/2005/Atom" xmlns:...y><font color="#c040c0">\n</font> </ContinuityOfCareRecord><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>HEALTH_PROFILE_LIST_ENTRY</strong> = " <entry xmlns='http://www.w3.org/2005/Atom'<font color="#c040c0">\n</font>xmln... <name>user@gmail.com</name><font color="#c040c0">\n</font> </author><font color="#c040c0">\n</font></entry>"<br>
+<strong>MAP_ENTRY</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><entry xm...hor><font color="#c040c0">\n</font> <name>Roman</name><font color="#c040c0">\n</font> </author><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font>'<br>
+<strong>MAP_FEATURE_ENTRY</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><atom:ent...</atom:name><font color="#c040c0">\n</font> </atom:contributor><font color="#c040c0">\n</font></atom:entry><font color="#c040c0">\n</font>'<br>
+<strong>MAP_FEATURE_FEED</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><atom:fee...</atom:contributor><font color="#c040c0">\n</font> </atom:entry><font color="#c040c0">\n</font></atom:feed><font color="#c040c0">\n</font>'<br>
+<strong>MAP_FEATURE_KML</strong> = '<Placemark><font color="#c040c0">\n</font> <name>Some feature title</name><font color="#c040c0">\n</font> ...442726,0.0</coordinates><font color="#c040c0">\n</font> </Point><font color="#c040c0">\n</font></Placemark><font color="#c040c0">\n</font>'<br>
+<strong>MAP_FEED</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><feed xml...me>Roman</name><font color="#c040c0">\n</font> </author><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed><font color="#c040c0">\n</font>'<br>
+<strong>MULTIDOMAIN_ALIAS_ENTRY</strong> = '<?xml version=<font color="#c040c0">\'</font>1.0<font color="#c040c0">\'</font> encoding=<font color="#c040c0">\'</font>UTF-8<font color="#c040c0">\'</font>?><font color="#c040c0">\n</font><entry xm... value="helpdesk@gethelp_example.com" /><font color="#c040c0">\n</font></entry>'<br>
+<strong>MULTIDOMAIN_ALIAS_FEED</strong> = '<?xml version=<font color="#c040c0">\'</font>1.0<font color="#c040c0">\'</font> encoding=<font color="#c040c0">\'</font>UTF-8<font color="#c040c0">\'</font>?><font color="#c040c0">\n</font><feed xml...upport@gethelp_example.com" /><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>MULTIDOMAIN_USER_ENTRY</strong> = '<?xml version="1.0"?><font color="#c040c0">\n</font><atom:entry xmlns:atom=<font color="#c040c0">\'</font>ht...perty name="isAdmin" value="true"/><font color="#c040c0">\n</font></atom:entry>'<br>
+<strong>MULTIDOMAIN_USER_FEED</strong> = '<?xml version=<font color="#c040c0">\'</font>1.0<font color="#c040c0">\'</font> encoding=<font color="#c040c0">\'</font>UTF-8<font color="#c040c0">\'</font>?><font color="#c040c0">\n</font><feed xml...pWhitelisted" value="false" /><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>MULTIDOMAIN_USER_RENAME_REQUEST</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><entry xm...wEmail' value='liz@newexample4liz.com'/><font color="#c040c0">\n</font></entry>"<br>
+<strong>NEW_CONTACT</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><entry xm...re Pkwy Mountain View</gd:postalAddress><font color="#c040c0">\n</font></entry>"<br>
+<strong>NICKNAME_ENTRY</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><entry xm...hag' /><font color="#c040c0">\n</font> <apps:login userName='neha' /><font color="#c040c0">\n</font></entry>"<br>
+<strong>NICKNAME_FEED</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><feed xml...apps:login userName='richa' /><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>NICK_ENTRY</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><atom:ent... <apps:login userName="TestUser"/><font color="#c040c0">\n</font></atom:entry>'<br>
+<strong>NICK_FEED</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><atom:fee...serName="TestUser"/><font color="#c040c0">\n</font> </atom:entry><font color="#c040c0">\n</font></atom:feed>'<br>
+<strong>ORGANIZATION_UNIT_CUSTOMER_ID_ENTRY</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><entry xm...perty name='name' value='example.com' /><font color="#c040c0">\n</font></entry>"<br>
+<strong>ORGANIZATION_UNIT_ORGUNIT_ENTRY</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><entry xm...name='blockInheritance' value='false' /><font color="#c040c0">\n</font></entry>"<br>
+<strong>ORGANIZATION_UNIT_ORGUNIT_FEED</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><feed xml...ockInheritance' value='false' /><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>ORGANIZATION_UNIT_ORGUSER_ENTRY</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><entry xm...perty name='orgUnitPath' value='Test' /><font color="#c040c0">\n</font></entry>"<br>
+<strong>ORGANIZATION_UNIT_ORGUSER_FEED</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><feed xml...me='orgUnitPath' value='Test' /><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>RECURRENCE_EXCEPTION_ENTRY</strong> = "<entry xmlns='http://www.w3.org/2005/Atom'<font color="#c040c0">\n</font>xmlns...tryLink><font color="#c040c0">\n</font> </gd:recurrenceException><font color="#c040c0">\n</font> </entry>"<br>
+<strong>SITEMAPS_FEED</strong> = '<feed xmlns="http://www.w3.org/2005/Atom" <font color="#c040c0">\n</font> xml...itemap-news-publication-label><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>SITES_ACL_FEED</strong> = '<font color="#c040c0">\n</font><feed xmlns="http://www.w3.org/2005/Atom" xmlns..."/><font color="#c040c0">\n</font> <gAcl:role value="owner"/><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>SITES_ACTIVITY_FEED</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><feed xml...user@gmail.com</email><font color="#c040c0">\n</font></author><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>SITES_COMMENT_ENTRY</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><entry xm...t/site/gdatatestsite" type="text/html"/><font color="#c040c0">\n</font></entry>'<br>
+<strong>SITES_CONTENT_FEED</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><feed xml...e/gdatatestsite?parent=abc123"/><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>SITES_FEED</strong> = '<feed xmlns="http://www.w3.org/2005/Atom"<font color="#c040c0">\n</font> xmln....html</wt:verification-method><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>SITES_LISTITEM_ENTRY</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><entry xm...ex="E" name="MyCo">2009-05-31</gs:field><font color="#c040c0">\n</font></entry>'<br>
+<strong>SITES_LISTPAGE_ENTRY</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><entry xm...content/site/gdatatestsite?parent=abc"/><font color="#c040c0">\n</font></entry>'<br>
+<strong>SITES_REVISION_FEED</strong> = '<font color="#c040c0">\n</font><feed xmlns="http://www.w3.org/2005/Atom" xmlns...ites:revision>1</sites:revision><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>SITES_SITE_FEED</strong> = '<font color="#c040c0">\n</font><feed xmlns="http://www.w3.org/2005/Atom" xmlns...ites:theme>default</sites:theme><font color="#c040c0">\n</font></entry><font color="#c040c0">\n</font></feed>'<br>
+<strong>SMALL_FEED</strong> = '<?xml version="1.0" encoding="utf-8"?><font color="#c040c0">\n</font> <feed ...ry>Some text.</summary><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font> </feed><font color="#c040c0">\n</font>'<br>
+<strong>TEST_AUTHOR</strong> = '<?xml version="1.0" encoding="utf-8"?><font color="#c040c0">\n</font> <autho...5/Atom">http://www.google.com</uri><font color="#c040c0">\n</font> </author><font color="#c040c0">\n</font>'<br>
+<strong>TEST_BASE_ENTRY</strong> = "<?xml version='1.0'?><font color="#c040c0">\n</font><entry xmlns='http://www.w...l><font color="#c040c0">\n</font> <g:item_type>products</g:item_type><font color="#c040c0">\n</font></entry>"<br>
+<strong>TEST_GBASE_ATTRIBUTE</strong> = '<?xml version="1.0" encoding="utf-8"?><font color="#c040c0">\n</font> <g:bra...gle.com/ns/1.0">Digital Camera Battery</g:brand><font color="#c040c0">\n</font>'<br>
+<strong>TEST_LINK</strong> = '<?xml version="1.0" encoding="utf-8"?><font color="#c040c0">\n</font> <link ..." <font color="#c040c0">\n</font> rel="test rel" foo1="bar" foo2="rab"/><font color="#c040c0">\n</font>'<br>
+<strong>USER_ENTRY</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><atom:ent...0?recipient=testlist@example.com"/><font color="#c040c0">\n</font></atom:entry>'<br>
+<strong>USER_ENTRY1</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><entry xm...2.0?recipient=abcd12310%40srkapps.com'/><font color="#c040c0">\n</font></entry>"<br>
+<strong>USER_FEED</strong> = '<?xml version="1.0" encoding="UTF-8"?><font color="#c040c0">\n</font><atom:fee...ith@example.com"/><font color="#c040c0">\n</font> </atom:entry><font color="#c040c0">\n</font></atom:feed>'<br>
+<strong>USER_FEED1</strong> = '<?xml version=<font color="#c040c0">\'</font>1.0<font color="#c040c0">\'</font> encoding=<font color="#c040c0">\'</font>utf-8<font color="#c040c0">\'</font>?><font color="#c040c0">\n</font><ns0:feed...ogle.com/apps/2006" /><font color="#c040c0">\n</font> </ns0:entry><font color="#c040c0">\n</font></ns0:feed>'<br>
+<strong>XML_ENTRY_1</strong> = "<?xml version='1.0'?><font color="#c040c0">\n</font><entry xmlns='http://www.w...l><font color="#c040c0">\n</font> <g:item_type>products</g:item_type><font color="#c040c0">\n</font></entry>"<br>
+<strong>YOUTUBE_COMMENT_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><feed xml...testjhartmann</uri></author><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>YOUTUBE_CONTACTS_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><feed xmln...me><yt:status>pending</yt:status></entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>YOUTUBE_ENTRY_PRIVATE</strong> = "<?xml version='1.0' encoding='utf-8'?><font color="#c040c0">\n</font><entry xm... of use.</yt:state><font color="#c040c0">\n</font> </app:control><font color="#c040c0">\n</font></entry>"<br>
+<strong>YOUTUBE_PLAYLIST_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><feed xml...i><font color="#c040c0">\n</font> </author><font color="#c040c0">\n</font> </entry> <font color="#c040c0">\n</font></feed>"<br>
+<strong>YOUTUBE_PLAYLIST_VIDEO_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><feed xmln...ments><yt:position>1</yt:position></entry></feed>"<br>
+<strong>YOUTUBE_PROFILE</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><entry xm...sers/andyland74/uploads' countHint='1'/><font color="#c040c0">\n</font></entry>"<br>
+<strong>YOUTUBE_SUBSCRIPTION_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font><feed xml...feeds/api/users/nbc/uploads'/><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>YOUTUBE_VIDEO_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><feed xmln... countHint='1116'/></gd:comments></entry><font color="#c040c0">\n</font></feed>"<br>
+<strong>YOUTUBE_VIDEO_RESPONSE_FEED</strong> = "<?xml version='1.0' encoding='UTF-8'?><font color="#c040c0">\n</font> <feed x...<font color="#c040c0">\n</font> </gd:comments><font color="#c040c0">\n</font> </entry><font color="#c040c0">\n</font></feed><font color="#c040c0">\n</font>"</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.BaseDB.html b/pydocs/gdata.tlslite.BaseDB.html
new file mode 100644
index 0000000..10e51c6
--- /dev/null
+++ b/pydocs/gdata.tlslite.BaseDB.html
@@ -0,0 +1,74 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.BaseDB</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.BaseDB</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/BaseDB.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/BaseDB.py</a></font></td></tr></table>
+ <p><tt>Base class for SharedKeyDB and VerifierDB.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="anydbm.html">anydbm</a><br>
+</td><td width="25%" valign=top><a href="thread.html">thread</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.BaseDB.html#BaseDB">BaseDB</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="BaseDB">class <strong>BaseDB</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="BaseDB-__contains__"><strong>__contains__</strong></a>(self, username)</dt><dd><tt>Check if the database contains the specified username.<br>
+ <br>
+@type username: str<br>
+@param username: The username to check for.<br>
+ <br>
+@rtype: bool<br>
+@return: True if the database contains the username, False<br>
+otherwise.</tt></dd></dl>
+
+<dl><dt><a name="BaseDB-__delitem__"><strong>__delitem__</strong></a>(self, username)</dt></dl>
+
+<dl><dt><a name="BaseDB-__getitem__"><strong>__getitem__</strong></a>(self, username)</dt></dl>
+
+<dl><dt><a name="BaseDB-__init__"><strong>__init__</strong></a>(self, filename, type)</dt></dl>
+
+<dl><dt><a name="BaseDB-__setitem__"><strong>__setitem__</strong></a>(self, username, value)</dt></dl>
+
+<dl><dt><a name="BaseDB-check"><strong>check</strong></a>(self, username, param)</dt></dl>
+
+<dl><dt><a name="BaseDB-create"><strong>create</strong></a>(self)</dt><dd><tt>Create a new on-disk database.<br>
+ <br>
+@raise anydbm.error: If there's a problem creating the database.</tt></dd></dl>
+
+<dl><dt><a name="BaseDB-keys"><strong>keys</strong></a>(self)</dt><dd><tt>Return a list of usernames in the database.<br>
+ <br>
+@rtype: list<br>
+@return: The usernames in the database.</tt></dd></dl>
+
+<dl><dt><a name="BaseDB-open"><strong>open</strong></a>(self)</dt><dd><tt>Open a pre-existing on-disk database.<br>
+ <br>
+@raise anydbm.error: If there's a problem opening the database.<br>
+@raise ValueError: If the database is not of the right type.</tt></dd></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.Checker.html b/pydocs/gdata.tlslite.Checker.html
new file mode 100644
index 0000000..2111175
--- /dev/null
+++ b/pydocs/gdata.tlslite.Checker.html
@@ -0,0 +1,97 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.Checker</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.Checker</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/Checker.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/Checker.py</a></font></td></tr></table>
+ <p><tt>Class for post-handshake certificate checking.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.Checker.html#Checker">Checker</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Checker">class <strong>Checker</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class is passed to a handshake function to check the other<br>
+party's certificate chain.<br>
+ <br>
+If a handshake function completes successfully, but the <a href="#Checker">Checker</a><br>
+judges the other party's certificate chain to be missing or<br>
+inadequate, a subclass of<br>
+L{tlslite.errors.TLSAuthenticationError} will be raised.<br>
+ <br>
+Currently, the <a href="#Checker">Checker</a> can check either an X.509 or a cryptoID<br>
+chain (for the latter, cryptoIDlib must be installed).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Checker-__call__"><strong>__call__</strong></a>(self, connection)</dt><dd><tt>Check a TLSConnection.<br>
+ <br>
+When a <a href="#Checker">Checker</a> is passed to a handshake function, this will<br>
+be called at the end of the function.<br>
+ <br>
+@type connection: L{tlslite.TLSConnection.TLSConnection}<br>
+@param connection: The TLSConnection to examine.<br>
+ <br>
+@raise tlslite.errors.TLSAuthenticationError: If the other<br>
+party's certificate chain is missing or bad.</tt></dd></dl>
+
+<dl><dt><a name="Checker-__init__"><strong>__init__</strong></a>(self, cryptoID<font color="#909090">=None</font>, protocol<font color="#909090">=None</font>, x509Fingerprint<font color="#909090">=None</font>, x509TrustList<font color="#909090">=None</font>, x509CommonName<font color="#909090">=None</font>, checkResumedSession<font color="#909090">=False</font>)</dt><dd><tt>Create a new <a href="#Checker">Checker</a> instance.<br>
+ <br>
+You must pass in one of these argument combinations:<br>
+ - cryptoID[, protocol] (requires cryptoIDlib)<br>
+ - x509Fingerprint<br>
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)<br>
+ <br>
+@type cryptoID: str<br>
+@param cryptoID: A cryptoID which the other party's certificate<br>
+chain must match. The cryptoIDlib module must be installed.<br>
+Mutually exclusive with all of the 'x509...' arguments.<br>
+ <br>
+@type protocol: str<br>
+@param protocol: A cryptoID protocol URI which the other<br>
+party's certificate chain must match. Requires the 'cryptoID'<br>
+argument.<br>
+ <br>
+@type x509Fingerprint: str<br>
+@param x509Fingerprint: A hex-encoded X.509 end-entity<br>
+fingerprint which the other party's end-entity certificate must<br>
+match. Mutually exclusive with the 'cryptoID' and<br>
+'x509TrustList' arguments.<br>
+ <br>
+@type x509TrustList: list of L{tlslite.X509.X509}<br>
+@param x509TrustList: A list of trusted root certificates. The<br>
+other party must present a certificate chain which extends to<br>
+one of these root certificates. The cryptlib_py module must be<br>
+installed. Mutually exclusive with the 'cryptoID' and<br>
+'x509Fingerprint' arguments.<br>
+ <br>
+@type x509CommonName: str<br>
+@param x509CommonName: The end-entity certificate's 'CN' field<br>
+must match this value. For a web server, this is typically a<br>
+server name such as 'www.amazon.com'. Mutually exclusive with<br>
+the 'cryptoID' and 'x509Fingerprint' arguments. Requires the<br>
+'x509TrustList' argument.<br>
+ <br>
+@type checkResumedSession: bool<br>
+@param checkResumedSession: If resumed sessions should be<br>
+checked. This defaults to False, on the theory that if the<br>
+session was checked once, we don't need to bother<br>
+re-checking it.</tt></dd></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.FileObject.html b/pydocs/gdata.tlslite.FileObject.html
new file mode 100644
index 0000000..18f66be
--- /dev/null
+++ b/pydocs/gdata.tlslite.FileObject.html
@@ -0,0 +1,72 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.FileObject</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.FileObject</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/FileObject.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/FileObject.py</a></font></td></tr></table>
+ <p><tt>Class returned by TLSConnection.makefile().</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.FileObject.html#FileObject">FileObject</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FileObject">class <strong>FileObject</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class provides a file object interface to a<br>
+L{tlslite.TLSConnection.TLSConnection}.<br>
+ <br>
+Call makefile() on a TLSConnection to create a <a href="#FileObject">FileObject</a> instance.<br>
+ <br>
+This class was copied, with minor modifications, from the<br>
+_fileobject class in socket.py. Note that fileno() is not<br>
+implemented.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="FileObject-__del__"><strong>__del__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FileObject-__init__"><strong>__init__</strong></a>(self, sock, mode<font color="#909090">='rb'</font>, bufsize<font color="#909090">=-1</font>)</dt></dl>
+
+<dl><dt><a name="FileObject-__iter__"><strong>__iter__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FileObject-close"><strong>close</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FileObject-flush"><strong>flush</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FileObject-next"><strong>next</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FileObject-read"><strong>read</strong></a>(self, size<font color="#909090">=-1</font>)</dt></dl>
+
+<dl><dt><a name="FileObject-readline"><strong>readline</strong></a>(self, size<font color="#909090">=-1</font>)</dt></dl>
+
+<dl><dt><a name="FileObject-readlines"><strong>readlines</strong></a>(self, sizehint<font color="#909090">=0</font>)</dt></dl>
+
+<dl><dt><a name="FileObject-write"><strong>write</strong></a>(self, data)</dt></dl>
+
+<dl><dt><a name="FileObject-writelines"><strong>writelines</strong></a>(self, list)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>closed</strong></dt>
+<dd><tt>True if the file is closed</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>default_bufsize</strong> = 16384</dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.HandshakeSettings.html b/pydocs/gdata.tlslite.HandshakeSettings.html
new file mode 100644
index 0000000..c35dd93
--- /dev/null
+++ b/pydocs/gdata.tlslite.HandshakeSettings.html
@@ -0,0 +1,110 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.HandshakeSettings</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.HandshakeSettings</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/HandshakeSettings.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/HandshakeSettings.py</a></font></td></tr></table>
+ <p><tt>Class for setting handshake parameters.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.tlslite.utils.cipherfactory.html">gdata.tlslite.utils.cipherfactory</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.utils.cryptomath.html">gdata.tlslite.utils.cryptomath</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.HandshakeSettings.html#HandshakeSettings">HandshakeSettings</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HandshakeSettings">class <strong>HandshakeSettings</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class encapsulates various parameters that can be used with<br>
+a TLS handshake.<br>
+@sort: minKeySize, maxKeySize, cipherNames, certificateTypes,<br>
+minVersion, maxVersion<br>
+ <br>
+@type minKeySize: int<br>
+@ivar minKeySize: The minimum bit length for asymmetric keys.<br>
+ <br>
+If the other party tries to use SRP, RSA, or Diffie-Hellman<br>
+parameters smaller than this length, an alert will be<br>
+signalled. The default is 1023.<br>
+ <br>
+@type maxKeySize: int<br>
+@ivar maxKeySize: The maximum bit length for asymmetric keys.<br>
+ <br>
+If the other party tries to use SRP, RSA, or Diffie-Hellman<br>
+parameters larger than this length, an alert will be signalled.<br>
+The default is 8193.<br>
+ <br>
+@type cipherNames: list<br>
+@ivar cipherNames: The allowed ciphers, in order of preference.<br>
+ <br>
+The allowed values in this list are 'aes256', 'aes128', '3des', and<br>
+'rc4'. If these settings are used with a client handshake, they<br>
+determine the order of the ciphersuites offered in the ClientHello<br>
+message.<br>
+ <br>
+If these settings are used with a server handshake, the server will<br>
+choose whichever ciphersuite matches the earliest entry in this<br>
+list.<br>
+ <br>
+NOTE: If '3des' is used in this list, but TLS Lite can't find an<br>
+add-on library that supports 3DES, then '3des' will be silently<br>
+removed.<br>
+ <br>
+The default value is ['aes256', 'aes128', '3des', 'rc4'].<br>
+ <br>
+@type certificateTypes: list<br>
+@ivar certificateTypes: The allowed certificate types, in order of<br>
+preference.<br>
+ <br>
+The allowed values in this list are 'x509' and 'cryptoID'. This<br>
+list is only used with a client handshake. The client will<br>
+advertise to the server which certificate types are supported, and<br>
+will check that the server uses one of the appropriate types.<br>
+ <br>
+NOTE: If 'cryptoID' is used in this list, but cryptoIDlib is not<br>
+installed, then 'cryptoID' will be silently removed.<br>
+ <br>
+@type minVersion: tuple<br>
+@ivar minVersion: The minimum allowed SSL/TLS version.<br>
+ <br>
+This variable can be set to (3,0) for SSL 3.0, (3,1) for<br>
+TLS 1.0, or (3,2) for TLS 1.1. If the other party wishes to<br>
+use a lower version, a protocol_version alert will be signalled.<br>
+The default is (3,0).<br>
+ <br>
+@type maxVersion: tuple<br>
+@ivar maxVersion: The maximum allowed SSL/TLS version.<br>
+ <br>
+This variable can be set to (3,0) for SSL 3.0, (3,1) for<br>
+TLS 1.0, or (3,2) for TLS 1.1. If the other party wishes to<br>
+use a higher version, a protocol_version alert will be signalled.<br>
+The default is (3,2). (WARNING: Some servers may (improperly)<br>
+reject clients which offer support for TLS 1.1. In this case,<br>
+try lowering maxVersion to (3,1)).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="HandshakeSettings-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.Session.html b/pydocs/gdata.tlslite.Session.html
new file mode 100644
index 0000000..01be017
--- /dev/null
+++ b/pydocs/gdata.tlslite.Session.html
@@ -0,0 +1,115 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.Session</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.Session</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/Session.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/Session.py</a></font></td></tr></table>
+ <p><tt>Class representing a TLS session.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+<a href="base64.html">base64</a><br>
+</td><td width="25%" valign=top><a href="binascii.html">binascii</a><br>
+<a href="hmac.html">hmac</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="md5.html">md5</a><br>
+<a href="os.html">os</a><br>
+<a href="sha.html">sha</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.Session.html#Session">Session</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Session">class <strong>Session</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class represents a TLS session.<br>
+ <br>
+TLS distinguishes between connections and sessions. A new<br>
+handshake creates both a connection and a session. Data is<br>
+transmitted over the connection.<br>
+ <br>
+The session contains a more permanent record of the handshake. The<br>
+session can be inspected to determine handshake results. The<br>
+session can also be used to create a new connection through<br>
+"session resumption". If the client and server both support this,<br>
+they can create a new connection based on an old session without<br>
+the overhead of a full handshake.<br>
+ <br>
+The session for a L{tlslite.TLSConnection.TLSConnection} can be<br>
+retrieved from the connection's 'session' attribute.<br>
+ <br>
+@type srpUsername: str<br>
+@ivar srpUsername: The client's SRP username (or None).<br>
+ <br>
+@type sharedKeyUsername: str<br>
+@ivar sharedKeyUsername: The client's shared-key username (or<br>
+None).<br>
+ <br>
+@type clientCertChain: L{tlslite.X509CertChain.X509CertChain} or<br>
+L{cryptoIDlib.CertChain.CertChain}<br>
+@ivar clientCertChain: The client's certificate chain (or None).<br>
+ <br>
+@type serverCertChain: L{tlslite.X509CertChain.X509CertChain} or<br>
+L{cryptoIDlib.CertChain.CertChain}<br>
+@ivar serverCertChain: The server's certificate chain (or None).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Session-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Session-getCipherName"><strong>getCipherName</strong></a>(self)</dt><dd><tt>Get the name of the cipher used with this connection.<br>
+ <br>
+@rtype: str<br>
+@return: The name of the cipher used with this connection.<br>
+Either 'aes128', 'aes256', 'rc4', or '3des'.</tt></dd></dl>
+
+<dl><dt><a name="Session-valid"><strong>valid</strong></a>(self)</dt><dd><tt>If this session can be used for session resumption.<br>
+ <br>
+@rtype: bool<br>
+@return: If this session can be used for session resumption.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>goodGroupParameters</strong> = [(2, 167609434410335061...389658897350067939L), (2, 148699818592312829...022696100064262587L), (2, 217661744586174357...299250924469288819L), (2, 580960599536995806...769998514148343807L), (5, 104438888141315250...045385534758453247L), (5, 337515218214385611...109988915707117567L), (5, 109074813561941592...353154294858383359L)]<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.SessionCache.html b/pydocs/gdata.tlslite.SessionCache.html
new file mode 100644
index 0000000..7d2a950
--- /dev/null
+++ b/pydocs/gdata.tlslite.SessionCache.html
@@ -0,0 +1,65 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.SessionCache</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.SessionCache</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/SessionCache.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/SessionCache.py</a></font></td></tr></table>
+ <p><tt>Class for caching TLS sessions.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="thread.html">thread</a><br>
+</td><td width="25%" valign=top><a href="time.html">time</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.SessionCache.html#SessionCache">SessionCache</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SessionCache">class <strong>SessionCache</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class is used by the server to cache TLS sessions.<br>
+ <br>
+Caching sessions allows the client to use TLS session resumption<br>
+and avoid the expense of a full handshake. To use this class,<br>
+simply pass a <a href="#SessionCache">SessionCache</a> instance into the server handshake<br>
+function.<br>
+ <br>
+This class is thread-safe.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="SessionCache-__getitem__"><strong>__getitem__</strong></a>(self, sessionID)</dt></dl>
+
+<dl><dt><a name="SessionCache-__init__"><strong>__init__</strong></a>(self, maxEntries<font color="#909090">=10000</font>, maxAge<font color="#909090">=14400</font>)</dt><dd><tt>Create a new <a href="#SessionCache">SessionCache</a>.<br>
+ <br>
+@type maxEntries: int<br>
+@param maxEntries: The maximum size of the cache. When this<br>
+limit is reached, the oldest sessions will be deleted as<br>
+necessary to make room for new ones. The default is 10000.<br>
+ <br>
+@type maxAge: int<br>
+@param maxAge: The number of seconds before a session expires<br>
+from the cache. The default is 14400 (i.e. 4 hours).</tt></dd></dl>
+
+<dl><dt><a name="SessionCache-__setitem__"><strong>__setitem__</strong></a>(self, sessionID, session)</dt></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.SharedKeyDB.html b/pydocs/gdata.tlslite.SharedKeyDB.html
new file mode 100644
index 0000000..ac45792
--- /dev/null
+++ b/pydocs/gdata.tlslite.SharedKeyDB.html
@@ -0,0 +1,134 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.SharedKeyDB</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.SharedKeyDB</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/SharedKeyDB.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/SharedKeyDB.py</a></font></td></tr></table>
+ <p><tt>Class for storing shared keys.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+<a href="base64.html">base64</a><br>
+</td><td width="25%" valign=top><a href="binascii.html">binascii</a><br>
+<a href="hmac.html">hmac</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="md5.html">md5</a><br>
+<a href="os.html">os</a><br>
+<a href="sha.html">sha</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.BaseDB.html#BaseDB">gdata.tlslite.BaseDB.BaseDB</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.SharedKeyDB.html#SharedKeyDB">SharedKeyDB</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SharedKeyDB">class <strong>SharedKeyDB</strong></a>(<a href="gdata.tlslite.BaseDB.html#BaseDB">gdata.tlslite.BaseDB.BaseDB</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class represent an in-memory or on-disk database of shared<br>
+keys.<br>
+ <br>
+A <a href="#SharedKeyDB">SharedKeyDB</a> can be passed to a server handshake function to<br>
+authenticate a client based on one of the shared keys.<br>
+ <br>
+This class is thread-safe.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="SharedKeyDB-__init__"><strong>__init__</strong></a>(self, filename<font color="#909090">=None</font>)</dt><dd><tt>Create a new <a href="#SharedKeyDB">SharedKeyDB</a>.<br>
+ <br>
+@type filename: str<br>
+@param filename: Filename for an on-disk database, or None for<br>
+an in-memory database. If the filename already exists, follow<br>
+this with a call to <a href="#SharedKeyDB-open">open</a>(). To create a new on-disk database,<br>
+follow this with a call to <a href="#SharedKeyDB-create">create</a>().</tt></dd></dl>
+
+<dl><dt><a name="SharedKeyDB-__setitem__"><strong>__setitem__</strong></a>(self, username, sharedKey)</dt><dd><tt>Add a shared key to the database.<br>
+ <br>
+@type username: str<br>
+@param username: The username to associate the shared key with.<br>
+Must be less than or equal to 16 characters in length, and must<br>
+not already be in the database.<br>
+ <br>
+@type sharedKey: str<br>
+@param sharedKey: The shared key to add. Must be less than 48<br>
+characters in length.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.BaseDB.html#BaseDB">gdata.tlslite.BaseDB.BaseDB</a>:<br>
+<dl><dt><a name="SharedKeyDB-__contains__"><strong>__contains__</strong></a>(self, username)</dt><dd><tt>Check if the database contains the specified username.<br>
+ <br>
+@type username: str<br>
+@param username: The username to check for.<br>
+ <br>
+@rtype: bool<br>
+@return: True if the database contains the username, False<br>
+otherwise.</tt></dd></dl>
+
+<dl><dt><a name="SharedKeyDB-__delitem__"><strong>__delitem__</strong></a>(self, username)</dt></dl>
+
+<dl><dt><a name="SharedKeyDB-__getitem__"><strong>__getitem__</strong></a>(self, username)</dt></dl>
+
+<dl><dt><a name="SharedKeyDB-check"><strong>check</strong></a>(self, username, param)</dt></dl>
+
+<dl><dt><a name="SharedKeyDB-create"><strong>create</strong></a>(self)</dt><dd><tt>Create a new on-disk database.<br>
+ <br>
+@raise anydbm.error: If there's a problem creating the database.</tt></dd></dl>
+
+<dl><dt><a name="SharedKeyDB-keys"><strong>keys</strong></a>(self)</dt><dd><tt>Return a list of usernames in the database.<br>
+ <br>
+@rtype: list<br>
+@return: The usernames in the database.</tt></dd></dl>
+
+<dl><dt><a name="SharedKeyDB-open"><strong>open</strong></a>(self)</dt><dd><tt>Open a pre-existing on-disk database.<br>
+ <br>
+@raise anydbm.error: If there's a problem opening the database.<br>
+@raise ValueError: If the database is not of the right type.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>goodGroupParameters</strong> = [(2, 167609434410335061...389658897350067939L), (2, 148699818592312829...022696100064262587L), (2, 217661744586174357...299250924469288819L), (2, 580960599536995806...769998514148343807L), (5, 104438888141315250...045385534758453247L), (5, 337515218214385611...109988915707117567L), (5, 109074813561941592...353154294858383359L)]<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.TLSConnection.html b/pydocs/gdata.tlslite.TLSConnection.html
new file mode 100644
index 0000000..f162adb
--- /dev/null
+++ b/pydocs/gdata.tlslite.TLSConnection.html
@@ -0,0 +1,591 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.TLSConnection</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.TLSConnection</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/TLSConnection.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/TLSConnection.py</a></font></td></tr></table>
+ <p><tt>MAIN CLASS FOR TLS LITE (START HERE!).</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+<a href="base64.html">base64</a><br>
+</td><td width="25%" valign=top><a href="binascii.html">binascii</a><br>
+<a href="hmac.html">hmac</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="md5.html">md5</a><br>
+<a href="os.html">os</a><br>
+<a href="sha.html">sha</a><br>
+</td><td width="25%" valign=top><a href="socket.html">socket</a><br>
+<a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.TLSRecordLayer.html#TLSRecordLayer">gdata.tlslite.TLSRecordLayer.TLSRecordLayer</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.TLSConnection.html#TLSConnection">TLSConnection</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSConnection">class <strong>TLSConnection</strong></a>(<a href="gdata.tlslite.TLSRecordLayer.html#TLSRecordLayer">gdata.tlslite.TLSRecordLayer.TLSRecordLayer</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class wraps a socket and provides TLS handshaking and data<br>
+transfer.<br>
+ <br>
+To use this class, create a new instance, passing a connected<br>
+socket into the constructor. Then call some handshake function.<br>
+If the handshake completes without raising an exception, then a TLS<br>
+connection has been negotiated. You can transfer data over this<br>
+connection as if it were a socket.<br>
+ <br>
+This class provides both synchronous and asynchronous versions of<br>
+its key functions. The synchronous versions should be used when<br>
+writing single-or multi-threaded code using blocking sockets. The<br>
+asynchronous versions should be used when performing asynchronous,<br>
+event-based I/O with non-blocking sockets.<br>
+ <br>
+Asynchronous I/O is a complicated subject; typically, you should<br>
+not use the asynchronous functions directly, but should use some<br>
+framework like asyncore or Twisted which TLS Lite integrates with<br>
+(see<br>
+L{tlslite.integration.TLSAsyncDispatcherMixIn.TLSAsyncDispatcherMixIn} or<br>
+L{tlslite.integration.TLSTwistedProtocolWrapper.TLSTwistedProtocolWrapper}).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="TLSConnection-__init__"><strong>__init__</strong></a>(self, sock)</dt><dd><tt>Create a new <a href="#TLSConnection">TLSConnection</a> instance.<br>
+ <br>
+@param sock: The socket data will be transmitted on. The<br>
+socket should already be connected. It may be in blocking or<br>
+non-blocking mode.<br>
+ <br>
+@type sock: L{socket.socket}</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-handshakeClientCert"><strong>handshakeClientCert</strong></a>(self, certChain<font color="#909090">=None</font>, privateKey<font color="#909090">=None</font>, session<font color="#909090">=None</font>, settings<font color="#909090">=None</font>, checker<font color="#909090">=None</font>, async<font color="#909090">=False</font>)</dt><dd><tt>Perform a certificate-based handshake in the role of client.<br>
+ <br>
+This function performs an SSL or TLS handshake. The server<br>
+will authenticate itself using an X.509 or cryptoID certificate<br>
+chain. If the handshake succeeds, the server's certificate<br>
+chain will be stored in the session's serverCertChain attribute.<br>
+Unless a checker object is passed in, this function does no<br>
+validation or checking of the server's certificate chain.<br>
+ <br>
+If the server requests client authentication, the<br>
+client will send the passed-in certificate chain, and use the<br>
+passed-in private key to authenticate itself. If no<br>
+certificate chain and private key were passed in, the client<br>
+will attempt to proceed without client authentication. The<br>
+server may or may not allow this.<br>
+ <br>
+Like any handshake function, this can be called on a closed<br>
+TLS connection, or on a TLS connection that is already open.<br>
+If called on an open connection it performs a re-handshake.<br>
+ <br>
+If the function completes without raising an exception, the<br>
+TLS connection will be open and available for data transfer.<br>
+ <br>
+If an exception is raised, the connection will have been<br>
+automatically closed (if it was ever open).<br>
+ <br>
+@type certChain: L{tlslite.X509CertChain.X509CertChain} or<br>
+L{cryptoIDlib.CertChain.CertChain}<br>
+@param certChain: The certificate chain to be used if the<br>
+server requests client authentication.<br>
+ <br>
+@type privateKey: L{tlslite.utils.RSAKey.RSAKey}<br>
+@param privateKey: The private key to be used if the server<br>
+requests client authentication.<br>
+ <br>
+@type session: L{tlslite.Session.Session}<br>
+@param session: A TLS session to attempt to resume. If the<br>
+resumption does not succeed, a full handshake will be<br>
+performed.<br>
+ <br>
+@type settings: L{tlslite.HandshakeSettings.HandshakeSettings}<br>
+@param settings: Various settings which can be used to control<br>
+the ciphersuites, certificate types, and SSL/TLS versions<br>
+offered by the client.<br>
+ <br>
+@type checker: L{tlslite.Checker.Checker}<br>
+@param checker: A Checker instance. This instance will be<br>
+invoked to examine the other party's authentication<br>
+credentials, if the handshake completes succesfully.<br>
+ <br>
+@type async: bool<br>
+@param async: If False, this function will block until the<br>
+handshake is completed. If True, this function will return a<br>
+generator. Successive invocations of the generator will<br>
+return 0 if it is waiting to read from the socket, 1 if it is<br>
+waiting to write to the socket, or will raise StopIteration if<br>
+the handshake operation is completed.<br>
+ <br>
+@rtype: None or an iterable<br>
+@return: If 'async' is True, a generator object will be<br>
+returned.<br>
+ <br>
+@raise socket.error: If a socket error occurs.<br>
+@raise tlslite.errors.TLSAbruptCloseError: If the socket is closed<br>
+without a preceding alert.<br>
+@raise tlslite.errors.TLSAlert: If a TLS alert is signalled.<br>
+@raise tlslite.errors.TLSAuthenticationError: If the checker<br>
+doesn't like the other party's authentication credentials.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-handshakeClientSRP"><strong>handshakeClientSRP</strong></a>(self, username, password, session<font color="#909090">=None</font>, settings<font color="#909090">=None</font>, checker<font color="#909090">=None</font>, async<font color="#909090">=False</font>)</dt><dd><tt>Perform an SRP handshake in the role of client.<br>
+ <br>
+This function performs a TLS/SRP handshake. SRP mutually<br>
+authenticates both parties to each other using only a<br>
+username and password. This function may also perform a<br>
+combined SRP and server-certificate handshake, if the server<br>
+chooses to authenticate itself with a certificate chain in<br>
+addition to doing SRP.<br>
+ <br>
+TLS/SRP is non-standard. Most TLS implementations don't<br>
+support it. See<br>
+U{<a href="http://www.ietf.org/html.charters/tls-charter.html">http://www.ietf.org/html.charters/tls-charter.html</a>} or<br>
+U{<a href="http://trevp.net/tlssrp/">http://trevp.net/tlssrp/</a>} for the latest information on<br>
+TLS/SRP.<br>
+ <br>
+Like any handshake function, this can be called on a closed<br>
+TLS connection, or on a TLS connection that is already open.<br>
+If called on an open connection it performs a re-handshake.<br>
+ <br>
+If the function completes without raising an exception, the<br>
+TLS connection will be open and available for data transfer.<br>
+ <br>
+If an exception is raised, the connection will have been<br>
+automatically closed (if it was ever open).<br>
+ <br>
+@type username: str<br>
+@param username: The SRP username.<br>
+ <br>
+@type password: str<br>
+@param password: The SRP password.<br>
+ <br>
+@type session: L{tlslite.Session.Session}<br>
+@param session: A TLS session to attempt to resume. This<br>
+session must be an SRP session performed with the same username<br>
+and password as were passed in. If the resumption does not<br>
+succeed, a full SRP handshake will be performed.<br>
+ <br>
+@type settings: L{tlslite.HandshakeSettings.HandshakeSettings}<br>
+@param settings: Various settings which can be used to control<br>
+the ciphersuites, certificate types, and SSL/TLS versions<br>
+offered by the client.<br>
+ <br>
+@type checker: L{tlslite.Checker.Checker}<br>
+@param checker: A Checker instance. This instance will be<br>
+invoked to examine the other party's authentication<br>
+credentials, if the handshake completes succesfully.<br>
+ <br>
+@type async: bool<br>
+@param async: If False, this function will block until the<br>
+handshake is completed. If True, this function will return a<br>
+generator. Successive invocations of the generator will<br>
+return 0 if it is waiting to read from the socket, 1 if it is<br>
+waiting to write to the socket, or will raise StopIteration if<br>
+the handshake operation is completed.<br>
+ <br>
+@rtype: None or an iterable<br>
+@return: If 'async' is True, a generator object will be<br>
+returned.<br>
+ <br>
+@raise socket.error: If a socket error occurs.<br>
+@raise tlslite.errors.TLSAbruptCloseError: If the socket is closed<br>
+without a preceding alert.<br>
+@raise tlslite.errors.TLSAlert: If a TLS alert is signalled.<br>
+@raise tlslite.errors.TLSAuthenticationError: If the checker<br>
+doesn't like the other party's authentication credentials.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-handshakeClientSharedKey"><strong>handshakeClientSharedKey</strong></a>(self, username, sharedKey, settings<font color="#909090">=None</font>, checker<font color="#909090">=None</font>, async<font color="#909090">=False</font>)</dt><dd><tt>Perform a shared-key handshake in the role of client.<br>
+ <br>
+This function performs a shared-key handshake. Using shared<br>
+symmetric keys of high entropy (128 bits or greater) mutually<br>
+authenticates both parties to each other.<br>
+ <br>
+TLS with shared-keys is non-standard. Most TLS<br>
+implementations don't support it. See<br>
+U{<a href="http://www.ietf.org/html.charters/tls-charter.html">http://www.ietf.org/html.charters/tls-charter.html</a>} for the<br>
+latest information on TLS with shared-keys. If the shared-keys<br>
+Internet-Draft changes or is superceded, TLS Lite will track<br>
+those changes, so the shared-key support in later versions of<br>
+TLS Lite may become incompatible with this version.<br>
+ <br>
+Like any handshake function, this can be called on a closed<br>
+TLS connection, or on a TLS connection that is already open.<br>
+If called on an open connection it performs a re-handshake.<br>
+ <br>
+If the function completes without raising an exception, the<br>
+TLS connection will be open and available for data transfer.<br>
+ <br>
+If an exception is raised, the connection will have been<br>
+automatically closed (if it was ever open).<br>
+ <br>
+@type username: str<br>
+@param username: The shared-key username.<br>
+ <br>
+@type sharedKey: str<br>
+@param sharedKey: The shared key.<br>
+ <br>
+@type settings: L{tlslite.HandshakeSettings.HandshakeSettings}<br>
+@param settings: Various settings which can be used to control<br>
+the ciphersuites, certificate types, and SSL/TLS versions<br>
+offered by the client.<br>
+ <br>
+@type checker: L{tlslite.Checker.Checker}<br>
+@param checker: A Checker instance. This instance will be<br>
+invoked to examine the other party's authentication<br>
+credentials, if the handshake completes succesfully.<br>
+ <br>
+@type async: bool<br>
+@param async: If False, this function will block until the<br>
+handshake is completed. If True, this function will return a<br>
+generator. Successive invocations of the generator will<br>
+return 0 if it is waiting to read from the socket, 1 if it is<br>
+waiting to write to the socket, or will raise StopIteration if<br>
+the handshake operation is completed.<br>
+ <br>
+@rtype: None or an iterable<br>
+@return: If 'async' is True, a generator object will be<br>
+returned.<br>
+ <br>
+@raise socket.error: If a socket error occurs.<br>
+@raise tlslite.errors.TLSAbruptCloseError: If the socket is closed<br>
+without a preceding alert.<br>
+@raise tlslite.errors.TLSAlert: If a TLS alert is signalled.<br>
+@raise tlslite.errors.TLSAuthenticationError: If the checker<br>
+doesn't like the other party's authentication credentials.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-handshakeClientUnknown"><strong>handshakeClientUnknown</strong></a>(self, srpCallback<font color="#909090">=None</font>, certCallback<font color="#909090">=None</font>, session<font color="#909090">=None</font>, settings<font color="#909090">=None</font>, checker<font color="#909090">=None</font>, async<font color="#909090">=False</font>)</dt><dd><tt>Perform a to-be-determined type of handshake in the role of client.<br>
+ <br>
+This function performs an SSL or TLS handshake. If the server<br>
+requests client certificate authentication, the<br>
+certCallback will be invoked and should return a (certChain,<br>
+privateKey) pair. If the callback returns None, the library<br>
+will attempt to proceed without client authentication. The<br>
+server may or may not allow this.<br>
+ <br>
+If the server requests SRP authentication, the srpCallback<br>
+will be invoked and should return a (username, password) pair.<br>
+If the callback returns None, the local implementation will<br>
+signal a user_canceled error alert.<br>
+ <br>
+After the handshake completes, the client can inspect the<br>
+connection's session attribute to determine what type of<br>
+authentication was performed.<br>
+ <br>
+Like any handshake function, this can be called on a closed<br>
+TLS connection, or on a TLS connection that is already open.<br>
+If called on an open connection it performs a re-handshake.<br>
+ <br>
+If the function completes without raising an exception, the<br>
+TLS connection will be open and available for data transfer.<br>
+ <br>
+If an exception is raised, the connection will have been<br>
+automatically closed (if it was ever open).<br>
+ <br>
+@type srpCallback: callable<br>
+@param srpCallback: The callback to be used if the server<br>
+requests SRP authentication. If None, the client will not<br>
+offer support for SRP ciphersuites.<br>
+ <br>
+@type certCallback: callable<br>
+@param certCallback: The callback to be used if the server<br>
+requests client certificate authentication.<br>
+ <br>
+@type session: L{tlslite.Session.Session}<br>
+@param session: A TLS session to attempt to resume. If the<br>
+resumption does not succeed, a full handshake will be<br>
+performed.<br>
+ <br>
+@type settings: L{tlslite.HandshakeSettings.HandshakeSettings}<br>
+@param settings: Various settings which can be used to control<br>
+the ciphersuites, certificate types, and SSL/TLS versions<br>
+offered by the client.<br>
+ <br>
+@type checker: L{tlslite.Checker.Checker}<br>
+@param checker: A Checker instance. This instance will be<br>
+invoked to examine the other party's authentication<br>
+credentials, if the handshake completes succesfully.<br>
+ <br>
+@type async: bool<br>
+@param async: If False, this function will block until the<br>
+handshake is completed. If True, this function will return a<br>
+generator. Successive invocations of the generator will<br>
+return 0 if it is waiting to read from the socket, 1 if it is<br>
+waiting to write to the socket, or will raise StopIteration if<br>
+the handshake operation is completed.<br>
+ <br>
+@rtype: None or an iterable<br>
+@return: If 'async' is True, a generator object will be<br>
+returned.<br>
+ <br>
+@raise socket.error: If a socket error occurs.<br>
+@raise tlslite.errors.TLSAbruptCloseError: If the socket is closed<br>
+without a preceding alert.<br>
+@raise tlslite.errors.TLSAlert: If a TLS alert is signalled.<br>
+@raise tlslite.errors.TLSAuthenticationError: If the checker<br>
+doesn't like the other party's authentication credentials.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-handshakeServer"><strong>handshakeServer</strong></a>(self, sharedKeyDB<font color="#909090">=None</font>, verifierDB<font color="#909090">=None</font>, certChain<font color="#909090">=None</font>, privateKey<font color="#909090">=None</font>, reqCert<font color="#909090">=False</font>, sessionCache<font color="#909090">=None</font>, settings<font color="#909090">=None</font>, checker<font color="#909090">=None</font>)</dt><dd><tt>Perform a handshake in the role of server.<br>
+ <br>
+This function performs an SSL or TLS handshake. Depending on<br>
+the arguments and the behavior of the client, this function can<br>
+perform a shared-key, SRP, or certificate-based handshake. It<br>
+can also perform a combined SRP and server-certificate<br>
+handshake.<br>
+ <br>
+Like any handshake function, this can be called on a closed<br>
+TLS connection, or on a TLS connection that is already open.<br>
+If called on an open connection it performs a re-handshake.<br>
+This function does not send a Hello Request message before<br>
+performing the handshake, so if re-handshaking is required,<br>
+the server must signal the client to begin the re-handshake<br>
+through some other means.<br>
+ <br>
+If the function completes without raising an exception, the<br>
+TLS connection will be open and available for data transfer.<br>
+ <br>
+If an exception is raised, the connection will have been<br>
+automatically closed (if it was ever open).<br>
+ <br>
+@type sharedKeyDB: L{tlslite.SharedKeyDB.SharedKeyDB}<br>
+@param sharedKeyDB: A database of shared symmetric keys<br>
+associated with usernames. If the client performs a<br>
+shared-key handshake, the session's sharedKeyUsername<br>
+attribute will be set.<br>
+ <br>
+@type verifierDB: L{tlslite.VerifierDB.VerifierDB}<br>
+@param verifierDB: A database of SRP password verifiers<br>
+associated with usernames. If the client performs an SRP<br>
+handshake, the session's srpUsername attribute will be set.<br>
+ <br>
+@type certChain: L{tlslite.X509CertChain.X509CertChain} or<br>
+L{cryptoIDlib.CertChain.CertChain}<br>
+@param certChain: The certificate chain to be used if the<br>
+client requests server certificate authentication.<br>
+ <br>
+@type privateKey: L{tlslite.utils.RSAKey.RSAKey}<br>
+@param privateKey: The private key to be used if the client<br>
+requests server certificate authentication.<br>
+ <br>
+@type reqCert: bool<br>
+@param reqCert: Whether to request client certificate<br>
+authentication. This only applies if the client chooses server<br>
+certificate authentication; if the client chooses SRP or<br>
+shared-key authentication, this will be ignored. If the client<br>
+performs a client certificate authentication, the sessions's<br>
+clientCertChain attribute will be set.<br>
+ <br>
+@type sessionCache: L{tlslite.SessionCache.SessionCache}<br>
+@param sessionCache: An in-memory cache of resumable sessions.<br>
+The client can resume sessions from this cache. Alternatively,<br>
+if the client performs a full handshake, a new session will be<br>
+added to the cache.<br>
+ <br>
+@type settings: L{tlslite.HandshakeSettings.HandshakeSettings}<br>
+@param settings: Various settings which can be used to control<br>
+the ciphersuites and SSL/TLS version chosen by the server.<br>
+ <br>
+@type checker: L{tlslite.Checker.Checker}<br>
+@param checker: A Checker instance. This instance will be<br>
+invoked to examine the other party's authentication<br>
+credentials, if the handshake completes succesfully.<br>
+ <br>
+@raise socket.error: If a socket error occurs.<br>
+@raise tlslite.errors.TLSAbruptCloseError: If the socket is closed<br>
+without a preceding alert.<br>
+@raise tlslite.errors.TLSAlert: If a TLS alert is signalled.<br>
+@raise tlslite.errors.TLSAuthenticationError: If the checker<br>
+doesn't like the other party's authentication credentials.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-handshakeServerAsync"><strong>handshakeServerAsync</strong></a>(self, sharedKeyDB<font color="#909090">=None</font>, verifierDB<font color="#909090">=None</font>, certChain<font color="#909090">=None</font>, privateKey<font color="#909090">=None</font>, reqCert<font color="#909090">=False</font>, sessionCache<font color="#909090">=None</font>, settings<font color="#909090">=None</font>, checker<font color="#909090">=None</font>)</dt><dd><tt>Start a server handshake operation on the TLS connection.<br>
+ <br>
+This function returns a generator which behaves similarly to<br>
+<a href="#TLSConnection-handshakeServer">handshakeServer</a>(). Successive invocations of the generator<br>
+will return 0 if it is waiting to read from the socket, 1 if it is<br>
+waiting to write to the socket, or it will raise StopIteration<br>
+if the handshake operation is complete.<br>
+ <br>
+@rtype: iterable<br>
+@return: A generator; see above for details.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.TLSRecordLayer.html#TLSRecordLayer">gdata.tlslite.TLSRecordLayer.TLSRecordLayer</a>:<br>
+<dl><dt><a name="TLSConnection-close"><strong>close</strong></a>(self)</dt><dd><tt>Close the TLS connection.<br>
+ <br>
+This function will block until it has exchanged close_notify<br>
+alerts with the other party. After doing so, it will shut down the<br>
+TLS connection. Further attempts to read through this connection<br>
+will return "". Further attempts to write through this connection<br>
+will raise ValueError.<br>
+ <br>
+If <a href="#TLSConnection-makefile">makefile</a>() has been called on this connection, the connection<br>
+will be not be closed until the connection object and all file<br>
+objects have been closed.<br>
+ <br>
+Even if an exception is raised, the connection will have been<br>
+closed.<br>
+ <br>
+@raise socket.error: If a socket error occurs.<br>
+@raise tlslite.errors.TLSAbruptCloseError: If the socket is closed<br>
+without a preceding alert.<br>
+@raise tlslite.errors.TLSAlert: If a TLS alert is signalled.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-closeAsync"><strong>closeAsync</strong></a>(self)</dt><dd><tt>Start a close operation on the TLS connection.<br>
+ <br>
+This function returns a generator which behaves similarly to<br>
+<a href="#TLSConnection-close">close</a>(). Successive invocations of the generator will return 0<br>
+if it is waiting to read from the socket, 1 if it is waiting<br>
+to write to the socket, or will raise StopIteration if the<br>
+close operation has completed.<br>
+ <br>
+@rtype: iterable<br>
+@return: A generator; see above for details.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-getCipherImplementation"><strong>getCipherImplementation</strong></a>(self)</dt><dd><tt>Get the name of the cipher implementation used with<br>
+this connection.<br>
+ <br>
+@rtype: str<br>
+@return: The name of the cipher implementation used with<br>
+this connection. Either 'python', 'cryptlib', 'openssl',<br>
+or 'pycrypto'.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-getCipherName"><strong>getCipherName</strong></a>(self)</dt><dd><tt>Get the name of the cipher used with this connection.<br>
+ <br>
+@rtype: str<br>
+@return: The name of the cipher used with this connection.<br>
+Either 'aes128', 'aes256', 'rc4', or '3des'.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-getpeername"><strong>getpeername</strong></a>(self)</dt><dd><tt>Return the remote address to which the socket is connected<br>
+(socket emulation).</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-getsockname"><strong>getsockname</strong></a>(self)</dt><dd><tt>Return the socket's own address (socket emulation).</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-gettimeout"><strong>gettimeout</strong></a>(self)</dt><dd><tt>Return the timeout associated with socket operations (socket<br>
+emulation).</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-makefile"><strong>makefile</strong></a>(self, mode<font color="#909090">='r'</font>, bufsize<font color="#909090">=-1</font>)</dt><dd><tt>Create a file object for the TLS connection (socket emulation).<br>
+ <br>
+@rtype: L{tlslite.FileObject.FileObject}</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-read"><strong>read</strong></a>(self, max<font color="#909090">=None</font>, min<font color="#909090">=1</font>)</dt><dd><tt>Read some data from the TLS connection.<br>
+ <br>
+This function will block until at least 'min' bytes are<br>
+available (or the connection is closed).<br>
+ <br>
+If an exception is raised, the connection will have been<br>
+automatically closed.<br>
+ <br>
+@type max: int<br>
+@param max: The maximum number of bytes to return.<br>
+ <br>
+@type min: int<br>
+@param min: The minimum number of bytes to return<br>
+ <br>
+@rtype: str<br>
+@return: A string of no more than 'max' bytes, and no fewer<br>
+than 'min' (unless the connection has been closed, in which<br>
+case fewer than 'min' bytes may be returned).<br>
+ <br>
+@raise socket.error: If a socket error occurs.<br>
+@raise tlslite.errors.TLSAbruptCloseError: If the socket is closed<br>
+without a preceding alert.<br>
+@raise tlslite.errors.TLSAlert: If a TLS alert is signalled.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-readAsync"><strong>readAsync</strong></a>(self, max<font color="#909090">=None</font>, min<font color="#909090">=1</font>)</dt><dd><tt>Start a read operation on the TLS connection.<br>
+ <br>
+This function returns a generator which behaves similarly to<br>
+<a href="#TLSConnection-read">read</a>(). Successive invocations of the generator will return 0<br>
+if it is waiting to read from the socket, 1 if it is waiting<br>
+to write to the socket, or a string if the read operation has<br>
+completed.<br>
+ <br>
+@rtype: iterable<br>
+@return: A generator; see above for details.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-recv"><strong>recv</strong></a>(self, bufsize)</dt><dd><tt>Get some data from the TLS connection (socket emulation).<br>
+ <br>
+@raise socket.error: If a socket error occurs.<br>
+@raise tlslite.errors.TLSAbruptCloseError: If the socket is closed<br>
+without a preceding alert.<br>
+@raise tlslite.errors.TLSAlert: If a TLS alert is signalled.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-send"><strong>send</strong></a>(self, s)</dt><dd><tt>Send data to the TLS connection (socket emulation).<br>
+ <br>
+@raise socket.error: If a socket error occurs.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-sendall"><strong>sendall</strong></a>(self, s)</dt><dd><tt>Send data to the TLS connection (socket emulation).<br>
+ <br>
+@raise socket.error: If a socket error occurs.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-setsockopt"><strong>setsockopt</strong></a>(self, level, optname, value)</dt><dd><tt>Set the value of the given socket option (socket emulation).</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-settimeout"><strong>settimeout</strong></a>(self, value)</dt><dd><tt>Set a timeout on blocking socket operations (socket emulation).</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-write"><strong>write</strong></a>(self, s)</dt><dd><tt>Write some data to the TLS connection.<br>
+ <br>
+This function will block until all the data has been sent.<br>
+ <br>
+If an exception is raised, the connection will have been<br>
+automatically closed.<br>
+ <br>
+@type s: str<br>
+@param s: The data to transmit to the other party.<br>
+ <br>
+@raise socket.error: If a socket error occurs.</tt></dd></dl>
+
+<dl><dt><a name="TLSConnection-writeAsync"><strong>writeAsync</strong></a>(self, s)</dt><dd><tt>Start a write operation on the TLS connection.<br>
+ <br>
+This function returns a generator which behaves similarly to<br>
+<a href="#TLSConnection-write">write</a>(). Successive invocations of the generator will return<br>
+1 if it is waiting to write to the socket, or will raise<br>
+StopIteration if the write operation has completed.<br>
+ <br>
+@rtype: iterable<br>
+@return: A generator; see above for details.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>generators</strong> = _Feature((2, 2, 0, 'alpha', 1), (2, 3, 0, 'final', 0), 0)<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>goodGroupParameters</strong> = [(2, 167609434410335061...389658897350067939L), (2, 148699818592312829...022696100064262587L), (2, 217661744586174357...299250924469288819L), (2, 580960599536995806...769998514148343807L), (5, 104438888141315250...045385534758453247L), (5, 337515218214385611...109988915707117567L), (5, 109074813561941592...353154294858383359L)]<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.TLSRecordLayer.html b/pydocs/gdata.tlslite.TLSRecordLayer.html
new file mode 100644
index 0000000..b6e9bed
--- /dev/null
+++ b/pydocs/gdata.tlslite.TLSRecordLayer.html
@@ -0,0 +1,276 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.TLSRecordLayer</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.TLSRecordLayer</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/TLSRecordLayer.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/TLSRecordLayer.py</a></font></td></tr></table>
+ <p><tt>Helper class for TLSConnection.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+<a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="errno.html">errno</a><br>
+<a href="gdata.tlslite.utils.hmac.html">gdata.tlslite.utils.hmac</a><br>
+<a href="math.html">math</a><br>
+<a href="md5.html">md5</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="sha.html">sha</a><br>
+<a href="socket.html">socket</a><br>
+<a href="sys.html">sys</a><br>
+</td><td width="25%" valign=top><a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.TLSRecordLayer.html#TLSRecordLayer">TLSRecordLayer</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSRecordLayer">class <strong>TLSRecordLayer</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class handles data transmission for a TLS connection.<br>
+ <br>
+Its only subclass is L{tlslite.TLSConnection.TLSConnection}. We've<br>
+separated the code in this class from TLSConnection to make things<br>
+more readable.<br>
+ <br>
+ <br>
+@type sock: socket.socket<br>
+@ivar sock: The underlying socket object.<br>
+ <br>
+@type session: L{tlslite.Session.Session}<br>
+@ivar session: The session corresponding to this connection.<br>
+ <br>
+Due to TLS session resumption, multiple connections can correspond<br>
+to the same underlying session.<br>
+ <br>
+@type version: tuple<br>
+@ivar version: The TLS version being used for this connection.<br>
+ <br>
+(3,0) means SSL 3.0, and (3,1) means TLS 1.0.<br>
+ <br>
+@type closed: bool<br>
+@ivar closed: If this connection is closed.<br>
+ <br>
+@type resumed: bool<br>
+@ivar resumed: If this connection is based on a resumed session.<br>
+ <br>
+@type allegedSharedKeyUsername: str or None<br>
+@ivar allegedSharedKeyUsername: This is set to the shared-key<br>
+username asserted by the client, whether the handshake succeeded or<br>
+not. If the handshake fails, this can be inspected to<br>
+determine if a guessing attack is in progress against a particular<br>
+user account.<br>
+ <br>
+@type allegedSrpUsername: str or None<br>
+@ivar allegedSrpUsername: This is set to the SRP username<br>
+asserted by the client, whether the handshake succeeded or not.<br>
+If the handshake fails, this can be inspected to determine<br>
+if a guessing attack is in progress against a particular user<br>
+account.<br>
+ <br>
+@type closeSocket: bool<br>
+@ivar closeSocket: If the socket should be closed when the<br>
+connection is closed (writable).<br>
+ <br>
+If you set this to True, TLS Lite will assume the responsibility of<br>
+closing the socket when the TLS Connection is shutdown (either<br>
+through an error or through the user calling <a href="#TLSRecordLayer-close">close</a>()). The default<br>
+is False.<br>
+ <br>
+@type ignoreAbruptClose: bool<br>
+@ivar ignoreAbruptClose: If an abrupt close of the socket should<br>
+raise an error (writable).<br>
+ <br>
+If you set this to True, TLS Lite will not raise a<br>
+L{tlslite.errors.TLSAbruptCloseError} exception if the underlying<br>
+socket is unexpectedly closed. Such an unexpected closure could be<br>
+caused by an attacker. However, it also occurs with some incorrect<br>
+TLS implementations.<br>
+ <br>
+You should set this to True only if you're not worried about an<br>
+attacker truncating the connection, and only if necessary to avoid<br>
+spurious errors. The default is False.<br>
+ <br>
+@sort: __init__, read, readAsync, write, writeAsync, close, closeAsync,<br>
+getCipherImplementation, getCipherName<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="TLSRecordLayer-__init__"><strong>__init__</strong></a>(self, sock)</dt></dl>
+
+<dl><dt><a name="TLSRecordLayer-close"><strong>close</strong></a>(self)</dt><dd><tt>Close the TLS connection.<br>
+ <br>
+This function will block until it has exchanged close_notify<br>
+alerts with the other party. After doing so, it will shut down the<br>
+TLS connection. Further attempts to read through this connection<br>
+will return "". Further attempts to write through this connection<br>
+will raise ValueError.<br>
+ <br>
+If <a href="#TLSRecordLayer-makefile">makefile</a>() has been called on this connection, the connection<br>
+will be not be closed until the connection object and all file<br>
+objects have been closed.<br>
+ <br>
+Even if an exception is raised, the connection will have been<br>
+closed.<br>
+ <br>
+@raise socket.error: If a socket error occurs.<br>
+@raise tlslite.errors.TLSAbruptCloseError: If the socket is closed<br>
+without a preceding alert.<br>
+@raise tlslite.errors.TLSAlert: If a TLS alert is signalled.</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-closeAsync"><strong>closeAsync</strong></a>(self)</dt><dd><tt>Start a close operation on the TLS connection.<br>
+ <br>
+This function returns a generator which behaves similarly to<br>
+<a href="#TLSRecordLayer-close">close</a>(). Successive invocations of the generator will return 0<br>
+if it is waiting to read from the socket, 1 if it is waiting<br>
+to write to the socket, or will raise StopIteration if the<br>
+close operation has completed.<br>
+ <br>
+@rtype: iterable<br>
+@return: A generator; see above for details.</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-getCipherImplementation"><strong>getCipherImplementation</strong></a>(self)</dt><dd><tt>Get the name of the cipher implementation used with<br>
+this connection.<br>
+ <br>
+@rtype: str<br>
+@return: The name of the cipher implementation used with<br>
+this connection. Either 'python', 'cryptlib', 'openssl',<br>
+or 'pycrypto'.</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-getCipherName"><strong>getCipherName</strong></a>(self)</dt><dd><tt>Get the name of the cipher used with this connection.<br>
+ <br>
+@rtype: str<br>
+@return: The name of the cipher used with this connection.<br>
+Either 'aes128', 'aes256', 'rc4', or '3des'.</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-getpeername"><strong>getpeername</strong></a>(self)</dt><dd><tt>Return the remote address to which the socket is connected<br>
+(socket emulation).</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-getsockname"><strong>getsockname</strong></a>(self)</dt><dd><tt>Return the socket's own address (socket emulation).</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-gettimeout"><strong>gettimeout</strong></a>(self)</dt><dd><tt>Return the timeout associated with socket operations (socket<br>
+emulation).</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-makefile"><strong>makefile</strong></a>(self, mode<font color="#909090">='r'</font>, bufsize<font color="#909090">=-1</font>)</dt><dd><tt>Create a file object for the TLS connection (socket emulation).<br>
+ <br>
+@rtype: L{tlslite.FileObject.FileObject}</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-read"><strong>read</strong></a>(self, max<font color="#909090">=None</font>, min<font color="#909090">=1</font>)</dt><dd><tt>Read some data from the TLS connection.<br>
+ <br>
+This function will block until at least 'min' bytes are<br>
+available (or the connection is closed).<br>
+ <br>
+If an exception is raised, the connection will have been<br>
+automatically closed.<br>
+ <br>
+@type max: int<br>
+@param max: The maximum number of bytes to return.<br>
+ <br>
+@type min: int<br>
+@param min: The minimum number of bytes to return<br>
+ <br>
+@rtype: str<br>
+@return: A string of no more than 'max' bytes, and no fewer<br>
+than 'min' (unless the connection has been closed, in which<br>
+case fewer than 'min' bytes may be returned).<br>
+ <br>
+@raise socket.error: If a socket error occurs.<br>
+@raise tlslite.errors.TLSAbruptCloseError: If the socket is closed<br>
+without a preceding alert.<br>
+@raise tlslite.errors.TLSAlert: If a TLS alert is signalled.</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-readAsync"><strong>readAsync</strong></a>(self, max<font color="#909090">=None</font>, min<font color="#909090">=1</font>)</dt><dd><tt>Start a read operation on the TLS connection.<br>
+ <br>
+This function returns a generator which behaves similarly to<br>
+<a href="#TLSRecordLayer-read">read</a>(). Successive invocations of the generator will return 0<br>
+if it is waiting to read from the socket, 1 if it is waiting<br>
+to write to the socket, or a string if the read operation has<br>
+completed.<br>
+ <br>
+@rtype: iterable<br>
+@return: A generator; see above for details.</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-recv"><strong>recv</strong></a>(self, bufsize)</dt><dd><tt>Get some data from the TLS connection (socket emulation).<br>
+ <br>
+@raise socket.error: If a socket error occurs.<br>
+@raise tlslite.errors.TLSAbruptCloseError: If the socket is closed<br>
+without a preceding alert.<br>
+@raise tlslite.errors.TLSAlert: If a TLS alert is signalled.</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-send"><strong>send</strong></a>(self, s)</dt><dd><tt>Send data to the TLS connection (socket emulation).<br>
+ <br>
+@raise socket.error: If a socket error occurs.</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-sendall"><strong>sendall</strong></a>(self, s)</dt><dd><tt>Send data to the TLS connection (socket emulation).<br>
+ <br>
+@raise socket.error: If a socket error occurs.</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-setsockopt"><strong>setsockopt</strong></a>(self, level, optname, value)</dt><dd><tt>Set the value of the given socket option (socket emulation).</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-settimeout"><strong>settimeout</strong></a>(self, value)</dt><dd><tt>Set a timeout on blocking socket operations (socket emulation).</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-write"><strong>write</strong></a>(self, s)</dt><dd><tt>Write some data to the TLS connection.<br>
+ <br>
+This function will block until all the data has been sent.<br>
+ <br>
+If an exception is raised, the connection will have been<br>
+automatically closed.<br>
+ <br>
+@type s: str<br>
+@param s: The data to transmit to the other party.<br>
+ <br>
+@raise socket.error: If a socket error occurs.</tt></dd></dl>
+
+<dl><dt><a name="TLSRecordLayer-writeAsync"><strong>writeAsync</strong></a>(self, s)</dt><dd><tt>Start a write operation on the TLS connection.<br>
+ <br>
+This function returns a generator which behaves similarly to<br>
+<a href="#TLSRecordLayer-write">write</a>(). Successive invocations of the generator will return<br>
+1 if it is waiting to write to the socket, or will raise<br>
+StopIteration if the write operation has completed.<br>
+ <br>
+@rtype: iterable<br>
+@return: A generator; see above for details.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>generators</strong> = _Feature((2, 2, 0, 'alpha', 1), (2, 3, 0, 'final', 0), 0)<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>goodGroupParameters</strong> = [(2, 167609434410335061...389658897350067939L), (2, 148699818592312829...022696100064262587L), (2, 217661744586174357...299250924469288819L), (2, 580960599536995806...769998514148343807L), (5, 104438888141315250...045385534758453247L), (5, 337515218214385611...109988915707117567L), (5, 109074813561941592...353154294858383359L)]<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.VerifierDB.html b/pydocs/gdata.tlslite.VerifierDB.html
new file mode 100644
index 0000000..a277761
--- /dev/null
+++ b/pydocs/gdata.tlslite.VerifierDB.html
@@ -0,0 +1,152 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.VerifierDB</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.VerifierDB</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/VerifierDB.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/VerifierDB.py</a></font></td></tr></table>
+ <p><tt>Class for storing SRP password verifiers.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+<a href="base64.html">base64</a><br>
+</td><td width="25%" valign=top><a href="binascii.html">binascii</a><br>
+<a href="math.html">math</a><br>
+<a href="gdata.tlslite.mathtls.html">gdata.tlslite.mathtls</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.BaseDB.html#BaseDB">gdata.tlslite.BaseDB.BaseDB</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.VerifierDB.html#VerifierDB">VerifierDB</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VerifierDB">class <strong>VerifierDB</strong></a>(<a href="gdata.tlslite.BaseDB.html#BaseDB">gdata.tlslite.BaseDB.BaseDB</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class represent an in-memory or on-disk database of SRP<br>
+password verifiers.<br>
+ <br>
+A <a href="#VerifierDB">VerifierDB</a> can be passed to a server handshake to authenticate<br>
+a client based on one of the verifiers.<br>
+ <br>
+This class is thread-safe.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="VerifierDB-__init__"><strong>__init__</strong></a>(self, filename<font color="#909090">=None</font>)</dt><dd><tt>Create a new <a href="#VerifierDB">VerifierDB</a> instance.<br>
+ <br>
+@type filename: str<br>
+@param filename: Filename for an on-disk database, or None for<br>
+an in-memory database. If the filename already exists, follow<br>
+this with a call to <a href="#VerifierDB-open">open</a>(). To create a new on-disk database,<br>
+follow this with a call to <a href="#VerifierDB-create">create</a>().</tt></dd></dl>
+
+<dl><dt><a name="VerifierDB-__setitem__"><strong>__setitem__</strong></a>(self, username, verifierEntry)</dt><dd><tt>Add a verifier entry to the database.<br>
+ <br>
+@type username: str<br>
+@param username: The username to associate the verifier with.<br>
+Must be less than 256 characters in length. Must not already<br>
+be in the database.<br>
+ <br>
+@type verifierEntry: tuple<br>
+@param verifierEntry: The verifier entry to add. Use<br>
+L{tlslite.<a href="#VerifierDB">VerifierDB</a>.<a href="#VerifierDB">VerifierDB</a>.makeVerifier} to create a<br>
+verifier entry.</tt></dd></dl>
+
+<hr>
+Static methods defined here:<br>
+<dl><dt><a name="VerifierDB-makeVerifier"><strong>makeVerifier</strong></a>(username, password, bits)</dt><dd><tt>Create a verifier entry which can be stored in a <a href="#VerifierDB">VerifierDB</a>.<br>
+ <br>
+@type username: str<br>
+@param username: The username for this verifier. Must be less<br>
+than 256 characters in length.<br>
+ <br>
+@type password: str<br>
+@param password: The password for this verifier.<br>
+ <br>
+@type bits: int<br>
+@param bits: This values specifies which SRP group parameters<br>
+to use. It must be one of (1024, 1536, 2048, 3072, 4096, 6144,<br>
+8192). Larger values are more secure but slower. 2048 is a<br>
+good compromise between safety and speed.<br>
+ <br>
+@rtype: tuple<br>
+@return: A tuple which may be stored in a <a href="#VerifierDB">VerifierDB</a>.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.BaseDB.html#BaseDB">gdata.tlslite.BaseDB.BaseDB</a>:<br>
+<dl><dt><a name="VerifierDB-__contains__"><strong>__contains__</strong></a>(self, username)</dt><dd><tt>Check if the database contains the specified username.<br>
+ <br>
+@type username: str<br>
+@param username: The username to check for.<br>
+ <br>
+@rtype: bool<br>
+@return: True if the database contains the username, False<br>
+otherwise.</tt></dd></dl>
+
+<dl><dt><a name="VerifierDB-__delitem__"><strong>__delitem__</strong></a>(self, username)</dt></dl>
+
+<dl><dt><a name="VerifierDB-__getitem__"><strong>__getitem__</strong></a>(self, username)</dt></dl>
+
+<dl><dt><a name="VerifierDB-check"><strong>check</strong></a>(self, username, param)</dt></dl>
+
+<dl><dt><a name="VerifierDB-create"><strong>create</strong></a>(self)</dt><dd><tt>Create a new on-disk database.<br>
+ <br>
+@raise anydbm.error: If there's a problem creating the database.</tt></dd></dl>
+
+<dl><dt><a name="VerifierDB-keys"><strong>keys</strong></a>(self)</dt><dd><tt>Return a list of usernames in the database.<br>
+ <br>
+@rtype: list<br>
+@return: The usernames in the database.</tt></dd></dl>
+
+<dl><dt><a name="VerifierDB-open"><strong>open</strong></a>(self)</dt><dd><tt>Open a pre-existing on-disk database.<br>
+ <br>
+@raise anydbm.error: If there's a problem opening the database.<br>
+@raise ValueError: If the database is not of the right type.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.X509.html b/pydocs/gdata.tlslite.X509.html
new file mode 100644
index 0000000..3d85414
--- /dev/null
+++ b/pydocs/gdata.tlslite.X509.html
@@ -0,0 +1,105 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.X509</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.X509</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/X509.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/X509.py</a></font></td></tr></table>
+ <p><tt>Class representing an X.509 certificate.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.X509.html#X509">X509</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="X509">class <strong>X509</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class represents an X.509 certificate.<br>
+ <br>
+@type bytes: L{array.array} of unsigned bytes<br>
+@ivar bytes: The DER-encoded ASN.1 certificate<br>
+ <br>
+@type publicKey: L{tlslite.utils.RSAKey.RSAKey}<br>
+@ivar publicKey: The subject public key from the certificate.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="X509-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="X509-getCommonName"><strong>getCommonName</strong></a>(self)</dt><dd><tt>Get the Subject's Common Name from the certificate.<br>
+ <br>
+The cryptlib_py module must be installed in order to use this<br>
+function.<br>
+ <br>
+@rtype: str or None<br>
+@return: The CN component of the certificate's subject DN, if<br>
+present.</tt></dd></dl>
+
+<dl><dt><a name="X509-getFingerprint"><strong>getFingerprint</strong></a>(self)</dt><dd><tt>Get the hex-encoded fingerprint of this certificate.<br>
+ <br>
+@rtype: str<br>
+@return: A hex-encoded fingerprint.</tt></dd></dl>
+
+<dl><dt><a name="X509-parse"><strong>parse</strong></a>(self, s)</dt><dd><tt>Parse a PEM-encoded X.509 certificate.<br>
+ <br>
+@type s: str<br>
+@param s: A PEM-encoded X.509 certificate (i.e. a base64-encoded<br>
+certificate wrapped with "-----BEGIN CERTIFICATE-----" and<br>
+"-----END CERTIFICATE-----" tags).</tt></dd></dl>
+
+<dl><dt><a name="X509-parseBinary"><strong>parseBinary</strong></a>(self, bytes)</dt><dd><tt>Parse a DER-encoded X.509 certificate.<br>
+ <br>
+@type bytes: str or L{array.array} of unsigned bytes<br>
+@param bytes: A DER-encoded X.509 certificate.</tt></dd></dl>
+
+<dl><dt><a name="X509-writeBytes"><strong>writeBytes</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.X509CertChain.html b/pydocs/gdata.tlslite.X509CertChain.html
new file mode 100644
index 0000000..714e732
--- /dev/null
+++ b/pydocs/gdata.tlslite.X509CertChain.html
@@ -0,0 +1,90 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.X509CertChain</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.X509CertChain</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/X509CertChain.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/X509CertChain.py</a></font></td></tr></table>
+ <p><tt>Class representing an X.509 certificate chain.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.tlslite.utils.cryptomath.html">gdata.tlslite.utils.cryptomath</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.X509CertChain.html#X509CertChain">X509CertChain</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="X509CertChain">class <strong>X509CertChain</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class represents a chain of X.509 certificates.<br>
+ <br>
+@type x509List: list<br>
+@ivar x509List: A list of L{tlslite.X509.X509} instances,<br>
+starting with the end-entity certificate and with every<br>
+subsequent certificate certifying the previous.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="X509CertChain-__init__"><strong>__init__</strong></a>(self, x509List<font color="#909090">=None</font>)</dt><dd><tt>Create a new <a href="#X509CertChain">X509CertChain</a>.<br>
+ <br>
+@type x509List: list<br>
+@param x509List: A list of L{tlslite.X509.X509} instances,<br>
+starting with the end-entity certificate and with every<br>
+subsequent certificate certifying the previous.</tt></dd></dl>
+
+<dl><dt><a name="X509CertChain-getCommonName"><strong>getCommonName</strong></a>(self)</dt><dd><tt>Get the Subject's Common Name from the end-entity certificate.<br>
+ <br>
+The cryptlib_py module must be installed in order to use this<br>
+function.<br>
+ <br>
+@rtype: str or None<br>
+@return: The CN component of the certificate's subject DN, if<br>
+present.</tt></dd></dl>
+
+<dl><dt><a name="X509CertChain-getEndEntityPublicKey"><strong>getEndEntityPublicKey</strong></a>(self)</dt><dd><tt>Get the public key from the end-entity certificate.<br>
+ <br>
+@rtype: L{tlslite.utils.RSAKey.RSAKey}</tt></dd></dl>
+
+<dl><dt><a name="X509CertChain-getFingerprint"><strong>getFingerprint</strong></a>(self)</dt><dd><tt>Get the hex-encoded fingerprint of the end-entity certificate.<br>
+ <br>
+@rtype: str<br>
+@return: A hex-encoded fingerprint.</tt></dd></dl>
+
+<dl><dt><a name="X509CertChain-getNumCerts"><strong>getNumCerts</strong></a>(self)</dt><dd><tt>Get the number of certificates in this chain.<br>
+ <br>
+@rtype: int</tt></dd></dl>
+
+<dl><dt><a name="X509CertChain-validate"><strong>validate</strong></a>(self, x509TrustList)</dt><dd><tt>Check the validity of the certificate chain.<br>
+ <br>
+This checks that every certificate in the chain validates with<br>
+the subsequent one, until some certificate validates with (or<br>
+is identical to) one of the passed-in root certificates.<br>
+ <br>
+The cryptlib_py module must be installed in order to use this<br>
+function.<br>
+ <br>
+@type x509TrustList: list of L{tlslite.X509.X509}<br>
+@param x509TrustList: A list of trusted root certificates. The<br>
+certificate chain must extend to one of these certificates to<br>
+be considered valid.</tt></dd></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.api.html b/pydocs/gdata.tlslite.api.html
new file mode 100644
index 0000000..533cfe4
--- /dev/null
+++ b/pydocs/gdata.tlslite.api.html
@@ -0,0 +1,67 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.api</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.api</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/api.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/api.py</a></font></td></tr></table>
+ <p><tt>Import this module for easy access to TLS Lite objects.<br>
+ <br>
+The TLS Lite API consists of classes, functions, and variables spread<br>
+throughout this package. Instead of importing them individually with::<br>
+ <br>
+ from tlslite.TLSConnection import TLSConnection<br>
+ from tlslite.HandshakeSettings import HandshakeSettings<br>
+ from tlslite.errors import *<br>
+ .<br>
+ .<br>
+ <br>
+It's easier to do::<br>
+ <br>
+ from tlslite.api import *<br>
+ <br>
+This imports all the important objects (TLSConnection, Checker,<br>
+HandshakeSettings, etc.) into the global namespace. In particular, it<br>
+imports::<br>
+ <br>
+ from constants import AlertLevel, AlertDescription, Fault<br>
+ from errors import *<br>
+ from Checker import Checker<br>
+ from HandshakeSettings import HandshakeSettings<br>
+ from Session import Session<br>
+ from SessionCache import SessionCache<br>
+ from SharedKeyDB import SharedKeyDB<br>
+ from TLSConnection import TLSConnection<br>
+ from VerifierDB import VerifierDB<br>
+ from X509 import X509<br>
+ from X509CertChain import X509CertChain<br>
+ <br>
+ from integration.HTTPTLSConnection import HTTPTLSConnection<br>
+ from integration.POP3_TLS import POP3_TLS<br>
+ from integration.IMAP4_TLS import IMAP4_TLS<br>
+ from integration.SMTP_TLS import SMTP_TLS<br>
+ from integration.XMLRPCTransport import XMLRPCTransport<br>
+ from integration.TLSSocketServerMixIn import TLSSocketServerMixIn<br>
+ from integration.TLSAsyncDispatcherMixIn import TLSAsyncDispatcherMixIn<br>
+ from integration.TLSTwistedProtocolWrapper import TLSTwistedProtocolWrapper<br>
+ from utils.cryptomath import cryptlibpyLoaded, m2cryptoLoaded,<br>
+ gmpyLoaded, pycryptoLoaded, prngName<br>
+ from utils.keyfactory import generateRSAKey, parsePEMKey, parseXMLKey,<br>
+ parseAsPublicKey, parsePrivateKey</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.constants.html b/pydocs/gdata.tlslite.constants.html
new file mode 100644
index 0000000..5477ce5
--- /dev/null
+++ b/pydocs/gdata.tlslite.constants.html
@@ -0,0 +1,288 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.constants</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.constants</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/constants.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/constants.py</a></font></td></tr></table>
+ <p><tt>Constants used in various places.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.constants.html#AlertDescription">AlertDescription</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.constants.html#AlertLevel">AlertLevel</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.constants.html#CertificateType">CertificateType</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.constants.html#CipherSuite">CipherSuite</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.constants.html#ContentType">ContentType</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.constants.html#Fault">Fault</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.constants.html#HandshakeType">HandshakeType</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AlertDescription">class <strong>AlertDescription</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>@cvar bad_record_mac: A TLS record failed to decrypt properly.<br>
+ <br>
+If this occurs during a shared-key or SRP handshake it most likely<br>
+indicates a bad password. It may also indicate an implementation<br>
+error, or some tampering with the data in transit.<br>
+ <br>
+This alert will be signalled by the server if the SRP password is bad. It<br>
+may also be signalled by the server if the SRP username is unknown to the<br>
+server, but it doesn't wish to reveal that fact.<br>
+ <br>
+This alert will be signalled by the client if the shared-key username is<br>
+bad.<br>
+ <br>
+@cvar handshake_failure: A problem occurred while handshaking.<br>
+ <br>
+This typically indicates a lack of common ciphersuites between client and<br>
+server, or some other disagreement (about SRP parameters or key sizes,<br>
+for example).<br>
+ <br>
+@cvar protocol_version: The other party's SSL/TLS version was unacceptable.<br>
+ <br>
+This indicates that the client and server couldn't agree on which version<br>
+of SSL or TLS to use.<br>
+ <br>
+@cvar user_canceled: The handshake is being cancelled for some reason.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Data and other attributes defined here:<br>
+<dl><dt><strong>access_denied</strong> = 49</dl>
+
+<dl><dt><strong>bad_certificate</strong> = 42</dl>
+
+<dl><dt><strong>bad_record_mac</strong> = 20</dl>
+
+<dl><dt><strong>certificate_expired</strong> = 45</dl>
+
+<dl><dt><strong>certificate_revoked</strong> = 44</dl>
+
+<dl><dt><strong>certificate_unknown</strong> = 46</dl>
+
+<dl><dt><strong>close_notify</strong> = 0</dl>
+
+<dl><dt><strong>decode_error</strong> = 50</dl>
+
+<dl><dt><strong>decompression_failure</strong> = 30</dl>
+
+<dl><dt><strong>decrypt_error</strong> = 51</dl>
+
+<dl><dt><strong>decryption_failed</strong> = 21</dl>
+
+<dl><dt><strong>export_restriction</strong> = 60</dl>
+
+<dl><dt><strong>handshake_failure</strong> = 40</dl>
+
+<dl><dt><strong>illegal_parameter</strong> = 47</dl>
+
+<dl><dt><strong>insufficient_security</strong> = 71</dl>
+
+<dl><dt><strong>internal_error</strong> = 80</dl>
+
+<dl><dt><strong>missing_srp_username</strong> = 121</dl>
+
+<dl><dt><strong>no_certificate</strong> = 41</dl>
+
+<dl><dt><strong>no_renegotiation</strong> = 100</dl>
+
+<dl><dt><strong>protocol_version</strong> = 70</dl>
+
+<dl><dt><strong>record_overflow</strong> = 22</dl>
+
+<dl><dt><strong>unexpected_message</strong> = 10</dl>
+
+<dl><dt><strong>unknown_ca</strong> = 48</dl>
+
+<dl><dt><strong>unknown_srp_username</strong> = 120</dl>
+
+<dl><dt><strong>unsupported_certificate</strong> = 43</dl>
+
+<dl><dt><strong>untrusted_srp_parameters</strong> = 122</dl>
+
+<dl><dt><strong>user_canceled</strong> = 90</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AlertLevel">class <strong>AlertLevel</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Data and other attributes defined here:<br>
+<dl><dt><strong>fatal</strong> = 2</dl>
+
+<dl><dt><strong>warning</strong> = 1</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CertificateType">class <strong>CertificateType</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Data and other attributes defined here:<br>
+<dl><dt><strong>cryptoID</strong> = 2</dl>
+
+<dl><dt><strong>openpgp</strong> = 1</dl>
+
+<dl><dt><strong>x509</strong> = 0</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CipherSuite">class <strong>CipherSuite</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Static methods defined here:<br>
+<dl><dt><a name="CipherSuite-getRsaSuites"><strong>getRsaSuites</strong></a>(ciphers)</dt></dl>
+
+<dl><dt><a name="CipherSuite-getSrpRsaSuites"><strong>getSrpRsaSuites</strong></a>(ciphers)</dt></dl>
+
+<dl><dt><a name="CipherSuite-getSrpSuites"><strong>getSrpSuites</strong></a>(ciphers)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>TLS_RSA_WITH_3DES_EDE_CBC_SHA</strong> = 10</dl>
+
+<dl><dt><strong>TLS_RSA_WITH_AES_128_CBC_SHA</strong> = 47</dl>
+
+<dl><dt><strong>TLS_RSA_WITH_AES_256_CBC_SHA</strong> = 53</dl>
+
+<dl><dt><strong>TLS_RSA_WITH_RC4_128_SHA</strong> = 5</dl>
+
+<dl><dt><strong>TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA</strong> = 81</dl>
+
+<dl><dt><strong>TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA</strong> = 84</dl>
+
+<dl><dt><strong>TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA</strong> = 87</dl>
+
+<dl><dt><strong>TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA</strong> = 80</dl>
+
+<dl><dt><strong>TLS_SRP_SHA_WITH_AES_128_CBC_SHA</strong> = 83</dl>
+
+<dl><dt><strong>TLS_SRP_SHA_WITH_AES_256_CBC_SHA</strong> = 86</dl>
+
+<dl><dt><strong>aes128Suites</strong> = [83, 84, 47]</dl>
+
+<dl><dt><strong>aes256Suites</strong> = [86, 87, 53]</dl>
+
+<dl><dt><strong>rc4Suites</strong> = [5]</dl>
+
+<dl><dt><strong>rsaSuites</strong> = [10, 47, 53, 5]</dl>
+
+<dl><dt><strong>srpRsaSuites</strong> = [81, 84, 87]</dl>
+
+<dl><dt><strong>srpSuites</strong> = [80, 83, 86]</dl>
+
+<dl><dt><strong>tripleDESSuites</strong> = [80, 81, 10]</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ContentType">class <strong>ContentType</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Data and other attributes defined here:<br>
+<dl><dt><strong>alert</strong> = 21</dl>
+
+<dl><dt><strong>all</strong> = (20, 21, 22, 23)</dl>
+
+<dl><dt><strong>application_data</strong> = 23</dl>
+
+<dl><dt><strong>change_cipher_spec</strong> = 20</dl>
+
+<dl><dt><strong>handshake</strong> = 22</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Fault">class <strong>Fault</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Data and other attributes defined here:<br>
+<dl><dt><strong>badA</strong> = 103</dl>
+
+<dl><dt><strong>badB</strong> = 201</dl>
+
+<dl><dt><strong>badFinished</strong> = 300</dl>
+
+<dl><dt><strong>badIdentifier</strong> = 401</dl>
+
+<dl><dt><strong>badMAC</strong> = 301</dl>
+
+<dl><dt><strong>badPadding</strong> = 302</dl>
+
+<dl><dt><strong>badPassword</strong> = 102</dl>
+
+<dl><dt><strong>badPremasterPadding</strong> = 501</dl>
+
+<dl><dt><strong>badSharedKey</strong> = 402</dl>
+
+<dl><dt><strong>badUsername</strong> = 101</dl>
+
+<dl><dt><strong>badVerifyMessage</strong> = 601</dl>
+
+<dl><dt><strong>clientCertFaults</strong> = [601]</dl>
+
+<dl><dt><strong>clientNoAuthFaults</strong> = [501, 502]</dl>
+
+<dl><dt><strong>clientSharedKeyFaults</strong> = [401, 402]</dl>
+
+<dl><dt><strong>clientSrpFaults</strong> = [101, 102, 103]</dl>
+
+<dl><dt><strong>faultAlerts</strong> = {101: (120, 20), 102: (20,), 103: (47,), 300: (51,), 301: (20,), 302: (20,), 401: (40,), 402: (20,), 501: (20,), 502: (20,), ...}</dl>
+
+<dl><dt><strong>faultNames</strong> = {101: 'bad username', 102: 'bad password', 103: 'bad A', 300: 'bad finished message', 301: 'bad MAC', 302: 'bad padding', 401: 'bad identifier', 402: 'bad sharedkey', 501: 'bad premaster padding', 502: 'short premaster secret', ...}</dl>
+
+<dl><dt><strong>genericFaults</strong> = [300, 301, 302]</dl>
+
+<dl><dt><strong>serverFaults</strong> = [201]</dl>
+
+<dl><dt><strong>shortPremasterSecret</strong> = 502</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HandshakeType">class <strong>HandshakeType</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Data and other attributes defined here:<br>
+<dl><dt><strong>certificate</strong> = 11</dl>
+
+<dl><dt><strong>certificate_request</strong> = 13</dl>
+
+<dl><dt><strong>certificate_verify</strong> = 15</dl>
+
+<dl><dt><strong>client_hello</strong> = 1</dl>
+
+<dl><dt><strong>client_key_exchange</strong> = 16</dl>
+
+<dl><dt><strong>finished</strong> = 20</dl>
+
+<dl><dt><strong>hello_request</strong> = 0</dl>
+
+<dl><dt><strong>server_hello</strong> = 2</dl>
+
+<dl><dt><strong>server_hello_done</strong> = 14</dl>
+
+<dl><dt><strong>server_key_exchange</strong> = 12</dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.errors.html b/pydocs/gdata.tlslite.errors.html
new file mode 100644
index 0000000..5d6f1f3
--- /dev/null
+++ b/pydocs/gdata.tlslite.errors.html
@@ -0,0 +1,834 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.errors</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.errors</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/errors.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/errors.py</a></font></td></tr></table>
+ <p><tt><a href="exceptions.html#Exception">Exception</a> classes.<br>
+@sort: <a href="#TLSError">TLSError</a>, <a href="#TLSAbruptCloseError">TLSAbruptCloseError</a>, <a href="#TLSAlert">TLSAlert</a>, <a href="#TLSLocalAlert">TLSLocalAlert</a>, <a href="#TLSRemoteAlert">TLSRemoteAlert</a>,<br>
+<a href="#TLSAuthenticationError">TLSAuthenticationError</a>, <a href="#TLSNoAuthenticationError">TLSNoAuthenticationError</a>, <a href="#TLSAuthenticationTypeError">TLSAuthenticationTypeError</a>,<br>
+<a href="#TLSFingerprintError">TLSFingerprintError</a>, <a href="#TLSAuthorizationError">TLSAuthorizationError</a>, <a href="#TLSValidationError">TLSValidationError</a>, <a href="#TLSFaultError">TLSFaultError</a></tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSError">TLSError</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSAbruptCloseError">TLSAbruptCloseError</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSAlert">TLSAlert</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSLocalAlert">TLSLocalAlert</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSRemoteAlert">TLSRemoteAlert</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSAuthenticationTypeError">TLSAuthenticationTypeError</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSAuthorizationError">TLSAuthorizationError</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSFingerprintError">TLSFingerprintError</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSNoAuthenticationError">TLSNoAuthenticationError</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSValidationError">TLSValidationError</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.errors.html#TLSFaultError">TLSFaultError</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSAbruptCloseError">class <strong>TLSAbruptCloseError</strong></a>(<a href="gdata.tlslite.errors.html#TLSError">TLSError</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The socket was closed without a proper TLS shutdown.<br>
+ <br>
+The TLS specification mandates that an alert of some sort<br>
+must be sent before the underlying socket is closed. If the socket<br>
+is closed without this, it could signify that an attacker is trying<br>
+to truncate the connection. It could also signify a misbehaving<br>
+TLS implementation, or a random network failure.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSAbruptCloseError">TLSAbruptCloseError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.tlslite.errors.html#TLSError">TLSError</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TLSAbruptCloseError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAbruptCloseError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSAbruptCloseError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSAbruptCloseError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAbruptCloseError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSAbruptCloseError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAbruptCloseError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSAbruptCloseError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAbruptCloseError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSAbruptCloseError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAbruptCloseError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSAbruptCloseError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSAbruptCloseError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAbruptCloseError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSAbruptCloseError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAbruptCloseError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSAbruptCloseError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSAbruptCloseError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAbruptCloseError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSAbruptCloseError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSAlert">class <strong>TLSAlert</strong></a>(<a href="gdata.tlslite.errors.html#TLSError">TLSError</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A TLS alert has been signalled.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSAlert">TLSAlert</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.tlslite.errors.html#TLSError">TLSError</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TLSAlert-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAlert-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSAlert-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSAlert-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAlert-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSAlert-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAlert-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSAlert-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAlert-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSAlert-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAlert-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSAlert-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSAlert-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAlert-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSAlert-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAlert-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSAlert-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSAlert-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAlert-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSAlert-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSAuthenticationError">class <strong>TLSAuthenticationError</strong></a>(<a href="gdata.tlslite.errors.html#TLSError">TLSError</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The handshake succeeded, but the other party's authentication<br>
+was inadequate.<br>
+ <br>
+This exception will only be raised when a<br>
+L{tlslite.Checker.Checker} has been passed to a handshake function.<br>
+The Checker will be invoked once the handshake completes, and if<br>
+the Checker objects to how the other party authenticated, a<br>
+subclass of this exception will be raised.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.tlslite.errors.html#TLSError">TLSError</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TLSAuthenticationError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSAuthenticationError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSAuthenticationError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSAuthenticationError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSAuthenticationError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSAuthenticationTypeError">class <strong>TLSAuthenticationTypeError</strong></a>(<a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Checker was expecting the other party to authenticate with a<br>
+different type of certificate chain.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSAuthenticationTypeError">TLSAuthenticationTypeError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.tlslite.errors.html#TLSError">TLSError</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TLSAuthenticationTypeError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationTypeError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSAuthenticationTypeError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSAuthenticationTypeError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationTypeError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationTypeError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationTypeError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationTypeError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationTypeError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationTypeError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationTypeError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationTypeError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSAuthenticationTypeError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationTypeError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationTypeError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationTypeError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationTypeError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSAuthenticationTypeError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthenticationTypeError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthenticationTypeError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSAuthorizationError">class <strong>TLSAuthorizationError</strong></a>(<a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Checker was expecting the other party to authenticate with a<br>
+certificate chain that has a different authorization.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSAuthorizationError">TLSAuthorizationError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.tlslite.errors.html#TLSError">TLSError</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TLSAuthorizationError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthorizationError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSAuthorizationError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSAuthorizationError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthorizationError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthorizationError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthorizationError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthorizationError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthorizationError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthorizationError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthorizationError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthorizationError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSAuthorizationError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthorizationError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthorizationError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthorizationError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthorizationError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSAuthorizationError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSAuthorizationError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSAuthorizationError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSError">class <strong>TLSError</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Base class for all TLS Lite exceptions.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TLSError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSFaultError">class <strong>TLSFaultError</strong></a>(<a href="gdata.tlslite.errors.html#TLSError">TLSError</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The other party responded incorrectly to an induced fault.<br>
+ <br>
+This exception will only occur during fault testing, when a<br>
+TLSConnection's fault variable is set to induce some sort of<br>
+faulty behavior, and the other party doesn't respond appropriately.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSFaultError">TLSFaultError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.tlslite.errors.html#TLSError">TLSError</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TLSFaultError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFaultError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSFaultError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSFaultError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFaultError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSFaultError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFaultError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSFaultError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFaultError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSFaultError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFaultError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSFaultError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSFaultError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFaultError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSFaultError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFaultError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSFaultError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSFaultError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFaultError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSFaultError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSFingerprintError">class <strong>TLSFingerprintError</strong></a>(<a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Checker was expecting the other party to authenticate with a<br>
+certificate chain that matches a different fingerprint.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSFingerprintError">TLSFingerprintError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.tlslite.errors.html#TLSError">TLSError</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TLSFingerprintError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFingerprintError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSFingerprintError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSFingerprintError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFingerprintError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSFingerprintError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFingerprintError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSFingerprintError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFingerprintError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSFingerprintError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFingerprintError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSFingerprintError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSFingerprintError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFingerprintError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSFingerprintError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFingerprintError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSFingerprintError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSFingerprintError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSFingerprintError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSFingerprintError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSLocalAlert">class <strong>TLSLocalAlert</strong></a>(<a href="gdata.tlslite.errors.html#TLSAlert">TLSAlert</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A TLS alert has been signalled by the local implementation.<br>
+ <br>
+@type description: int<br>
+@ivar description: Set to one of the constants in<br>
+L{tlslite.constants.AlertDescription}<br>
+ <br>
+@type level: int<br>
+@ivar level: Set to one of the constants in<br>
+L{tlslite.constants.AlertLevel}<br>
+ <br>
+@type message: str<br>
+@ivar message: Description of what went wrong.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSLocalAlert">TLSLocalAlert</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSAlert">TLSAlert</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="TLSLocalAlert-__init__"><strong>__init__</strong></a>(self, alert, message<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="TLSLocalAlert-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.tlslite.errors.html#TLSError">TLSError</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSLocalAlert-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSLocalAlert-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSLocalAlert-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSLocalAlert-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSLocalAlert-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSLocalAlert-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSLocalAlert-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSLocalAlert-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSLocalAlert-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSLocalAlert-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSLocalAlert-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSLocalAlert-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSLocalAlert-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSLocalAlert-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSLocalAlert-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSLocalAlert-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSNoAuthenticationError">class <strong>TLSNoAuthenticationError</strong></a>(<a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Checker was expecting the other party to authenticate with a<br>
+certificate chain, but this did not occur.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSNoAuthenticationError">TLSNoAuthenticationError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.tlslite.errors.html#TLSError">TLSError</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TLSNoAuthenticationError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSNoAuthenticationError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSNoAuthenticationError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSNoAuthenticationError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSNoAuthenticationError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSNoAuthenticationError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSNoAuthenticationError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSNoAuthenticationError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSNoAuthenticationError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSNoAuthenticationError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSNoAuthenticationError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSNoAuthenticationError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSNoAuthenticationError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSNoAuthenticationError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSNoAuthenticationError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSNoAuthenticationError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSNoAuthenticationError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSNoAuthenticationError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSNoAuthenticationError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSNoAuthenticationError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSRemoteAlert">class <strong>TLSRemoteAlert</strong></a>(<a href="gdata.tlslite.errors.html#TLSAlert">TLSAlert</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A TLS alert has been signalled by the remote implementation.<br>
+ <br>
+@type description: int<br>
+@ivar description: Set to one of the constants in<br>
+L{tlslite.constants.AlertDescription}<br>
+ <br>
+@type level: int<br>
+@ivar level: Set to one of the constants in<br>
+L{tlslite.constants.AlertLevel}<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSRemoteAlert">TLSRemoteAlert</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSAlert">TLSAlert</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="TLSRemoteAlert-__init__"><strong>__init__</strong></a>(self, alert)</dt></dl>
+
+<dl><dt><a name="TLSRemoteAlert-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.tlslite.errors.html#TLSError">TLSError</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSRemoteAlert-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSRemoteAlert-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSRemoteAlert-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSRemoteAlert-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSRemoteAlert-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSRemoteAlert-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSRemoteAlert-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSRemoteAlert-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSRemoteAlert-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSRemoteAlert-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSRemoteAlert-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSRemoteAlert-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSRemoteAlert-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSRemoteAlert-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSRemoteAlert-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSRemoteAlert-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSValidationError">class <strong>TLSValidationError</strong></a>(<a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The Checker has determined that the other party's certificate<br>
+chain is invalid.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.errors.html#TLSValidationError">TLSValidationError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSAuthenticationError">TLSAuthenticationError</a></dd>
+<dd><a href="gdata.tlslite.errors.html#TLSError">TLSError</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.tlslite.errors.html#TLSError">TLSError</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="TLSValidationError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSValidationError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#TLSValidationError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="TLSValidationError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSValidationError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSValidationError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSValidationError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="TLSValidationError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSValidationError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="TLSValidationError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSValidationError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="TLSValidationError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSValidationError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSValidationError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSValidationError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSValidationError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="TLSValidationError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="TLSValidationError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#TLSValidationError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="TLSValidationError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.html b/pydocs/gdata.tlslite.html
new file mode 100644
index 0000000..443c92d
--- /dev/null
+++ b/pydocs/gdata.tlslite.html
@@ -0,0 +1,63 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.tlslite</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.tlslite</strong></big></big> (version 0.3.8)</font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/__init__.py</a></font></td></tr></table>
+ <p><tt>TLS Lite is a free python library that implements SSL v3, TLS v1, and<br>
+TLS v1.1. TLS Lite supports non-traditional authentication methods<br>
+such as SRP, shared keys, and cryptoIDs, in addition to X.509<br>
+certificates. TLS Lite is pure python, however it can access OpenSSL,<br>
+cryptlib, pycrypto, and GMPY for faster crypto operations. TLS Lite<br>
+integrates with httplib, xmlrpclib, poplib, imaplib, smtplib,<br>
+SocketServer, asyncore, and Twisted.<br>
+ <br>
+To use, do::<br>
+ <br>
+ from tlslite.api import *<br>
+ <br>
+Then use the L{tlslite.TLSConnection.TLSConnection} class with a socket,<br>
+or use one of the integration classes in L{tlslite.integration}.<br>
+ <br>
+@version: 0.3.8</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.tlslite.BaseDB.html">BaseDB</a><br>
+<a href="gdata.tlslite.Checker.html">Checker</a><br>
+<a href="gdata.tlslite.FileObject.html">FileObject</a><br>
+<a href="gdata.tlslite.HandshakeSettings.html">HandshakeSettings</a><br>
+<a href="gdata.tlslite.Session.html">Session</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.SessionCache.html">SessionCache</a><br>
+<a href="gdata.tlslite.SharedKeyDB.html">SharedKeyDB</a><br>
+<a href="gdata.tlslite.TLSConnection.html">TLSConnection</a><br>
+<a href="gdata.tlslite.TLSRecordLayer.html">TLSRecordLayer</a><br>
+<a href="gdata.tlslite.VerifierDB.html">VerifierDB</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.X509.html">X509</a><br>
+<a href="gdata.tlslite.X509CertChain.html">X509CertChain</a><br>
+<a href="gdata.tlslite.api.html">api</a><br>
+<a href="gdata.tlslite.constants.html">constants</a><br>
+<a href="gdata.tlslite.errors.html">errors</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.integration.html"><strong>integration</strong> (package)</a><br>
+<a href="gdata.tlslite.mathtls.html">mathtls</a><br>
+<a href="gdata.tlslite.messages.html">messages</a><br>
+<a href="gdata.tlslite.utils.html"><strong>utils</strong> (package)</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__all__</strong> = ['api', 'BaseDB', 'Checker', 'constants', 'errors', 'FileObject', 'HandshakeSettings', 'mathtls', 'messages', 'Session', 'SessionCache', 'SharedKeyDB', 'TLSConnection', 'TLSRecordLayer', 'VerifierDB', 'X509', 'X509CertChain', 'integration', 'utils']<br>
+<strong>__version__</strong> = '0.3.8'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.AsyncStateMachine.html b/pydocs/gdata.tlslite.integration.AsyncStateMachine.html
new file mode 100644
index 0000000..34ab7b1
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.AsyncStateMachine.html
@@ -0,0 +1,104 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.integration.AsyncStateMachine</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.integration.html"><font color="#ffffff">integration</font></a>.AsyncStateMachine</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/AsyncStateMachine.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/AsyncStateMachine.py</a></font></td></tr></table>
+ <p><tt>A state machine for using TLS Lite with asynchronous I/O.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">AsyncStateMachine</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AsyncStateMachine">class <strong>AsyncStateMachine</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This is an abstract class that's used to integrate TLS Lite with<br>
+asyncore and Twisted.<br>
+ <br>
+This class signals wantsReadsEvent() and <a href="#AsyncStateMachine-wantsWriteEvent">wantsWriteEvent</a>(). When<br>
+the underlying socket has become readable or writeable, the event<br>
+should be passed to this class by calling <a href="#AsyncStateMachine-inReadEvent">inReadEvent</a>() or<br>
+<a href="#AsyncStateMachine-inWriteEvent">inWriteEvent</a>(). This class will then try to read or write through<br>
+the socket, and will update its state appropriately.<br>
+ <br>
+This class will forward higher-level events to its subclass. For<br>
+example, when a complete TLS record has been received,<br>
+<a href="#AsyncStateMachine-outReadEvent">outReadEvent</a>() will be called with the decrypted data.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="AsyncStateMachine-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="AsyncStateMachine-inReadEvent"><strong>inReadEvent</strong></a>(self)</dt><dd><tt>Tell the state machine it can read from the socket.</tt></dd></dl>
+
+<dl><dt><a name="AsyncStateMachine-inWriteEvent"><strong>inWriteEvent</strong></a>(self)</dt><dd><tt>Tell the state machine it can write to the socket.</tt></dd></dl>
+
+<dl><dt><a name="AsyncStateMachine-outCloseEvent"><strong>outCloseEvent</strong></a>(self)</dt><dd><tt>Called when a close operation completes.<br>
+ <br>
+May be overridden in subclass.</tt></dd></dl>
+
+<dl><dt><a name="AsyncStateMachine-outConnectEvent"><strong>outConnectEvent</strong></a>(self)</dt><dd><tt>Called when a handshake operation completes.<br>
+ <br>
+May be overridden in subclass.</tt></dd></dl>
+
+<dl><dt><a name="AsyncStateMachine-outReadEvent"><strong>outReadEvent</strong></a>(self, readBuffer)</dt><dd><tt>Called when a read operation completes.<br>
+ <br>
+May be overridden in subclass.</tt></dd></dl>
+
+<dl><dt><a name="AsyncStateMachine-outWriteEvent"><strong>outWriteEvent</strong></a>(self)</dt><dd><tt>Called when a write operation completes.<br>
+ <br>
+May be overridden in subclass.</tt></dd></dl>
+
+<dl><dt><a name="AsyncStateMachine-setCloseOp"><strong>setCloseOp</strong></a>(self)</dt><dd><tt>Start a close operation.</tt></dd></dl>
+
+<dl><dt><a name="AsyncStateMachine-setHandshakeOp"><strong>setHandshakeOp</strong></a>(self, handshaker)</dt><dd><tt>Start a handshake operation.<br>
+ <br>
+@type handshaker: generator<br>
+@param handshaker: A generator created by using one of the<br>
+asynchronous handshake functions (i.e. handshakeServerAsync, or<br>
+handshakeClientxxx(..., async=True).</tt></dd></dl>
+
+<dl><dt><a name="AsyncStateMachine-setServerHandshakeOp"><strong>setServerHandshakeOp</strong></a>(self, **args)</dt><dd><tt>Start a handshake operation.<br>
+ <br>
+The arguments passed to this function will be forwarded to<br>
+L{tlslite.TLSConnection.TLSConnection.handshakeServerAsync}.</tt></dd></dl>
+
+<dl><dt><a name="AsyncStateMachine-setWriteOp"><strong>setWriteOp</strong></a>(self, writeBuffer)</dt><dd><tt>Start a write operation.<br>
+ <br>
+@type writeBuffer: str<br>
+@param writeBuffer: The string to transmit.</tt></dd></dl>
+
+<dl><dt><a name="AsyncStateMachine-wantsReadEvent"><strong>wantsReadEvent</strong></a>(self)</dt><dd><tt>If the state machine wants to read.<br>
+ <br>
+If an operation is active, this returns whether or not the<br>
+operation wants to read from the socket. If an operation is<br>
+not active, this returns None.<br>
+ <br>
+@rtype: bool or None<br>
+@return: If the state machine wants to read.</tt></dd></dl>
+
+<dl><dt><a name="AsyncStateMachine-wantsWriteEvent"><strong>wantsWriteEvent</strong></a>(self)</dt><dd><tt>If the state machine wants to write.<br>
+ <br>
+If an operation is active, this returns whether or not the<br>
+operation wants to write to the socket. If an operation is<br>
+not active, this returns None.<br>
+ <br>
+@rtype: bool or None<br>
+@return: If the state machine wants to write.</tt></dd></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.ClientHelper.html b/pydocs/gdata.tlslite.integration.ClientHelper.html
new file mode 100644
index 0000000..dfdd259
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.ClientHelper.html
@@ -0,0 +1,117 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.integration.ClientHelper</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.integration.html"><font color="#ffffff">integration</font></a>.ClientHelper</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/ClientHelper.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/ClientHelper.py</a></font></td></tr></table>
+ <p><tt>A helper class for using TLS Lite with stdlib clients<br>
+(httplib, xmlrpclib, imaplib, poplib).</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">ClientHelper</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ClientHelper">class <strong>ClientHelper</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This is a helper class used to integrate TLS Lite with various<br>
+TLS clients (e.g. poplib, smtplib, httplib, etc.)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="ClientHelper-__init__"><strong>__init__</strong></a>(self, username<font color="#909090">=None</font>, password<font color="#909090">=None</font>, sharedKey<font color="#909090">=None</font>, certChain<font color="#909090">=None</font>, privateKey<font color="#909090">=None</font>, cryptoID<font color="#909090">=None</font>, protocol<font color="#909090">=None</font>, x509Fingerprint<font color="#909090">=None</font>, x509TrustList<font color="#909090">=None</font>, x509CommonName<font color="#909090">=None</font>, settings<font color="#909090">=None</font>)</dt><dd><tt>For client authentication, use one of these argument<br>
+combinations:<br>
+ - username, password (SRP)<br>
+ - username, sharedKey (shared-key)<br>
+ - certChain, privateKey (certificate)<br>
+ <br>
+For server authentication, you can either rely on the<br>
+implicit mutual authentication performed by SRP or<br>
+shared-keys, or you can do certificate-based server<br>
+authentication with one of these argument combinations:<br>
+ - cryptoID[, protocol] (requires cryptoIDlib)<br>
+ - x509Fingerprint<br>
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)<br>
+ <br>
+Certificate-based server authentication is compatible with<br>
+SRP or certificate-based client authentication. It is<br>
+not compatible with shared-keys.<br>
+ <br>
+The constructor does not perform the TLS handshake itself, but<br>
+simply stores these arguments for later. The handshake is<br>
+performed only when this class needs to connect with the<br>
+server. Then you should be prepared to handle TLS-specific<br>
+exceptions. See the client handshake functions in<br>
+L{tlslite.TLSConnection.TLSConnection} for details on which<br>
+exceptions might be raised.<br>
+ <br>
+@type username: str<br>
+@param username: SRP or shared-key username. Requires the<br>
+'password' or 'sharedKey' argument.<br>
+ <br>
+@type password: str<br>
+@param password: SRP password for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type sharedKey: str<br>
+@param sharedKey: Shared key for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type certChain: L{tlslite.X509CertChain.X509CertChain} or<br>
+L{cryptoIDlib.CertChain.CertChain}<br>
+@param certChain: Certificate chain for client authentication.<br>
+Requires the 'privateKey' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type privateKey: L{tlslite.utils.RSAKey.RSAKey}<br>
+@param privateKey: Private key for client authentication.<br>
+Requires the 'certChain' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type cryptoID: str<br>
+@param cryptoID: cryptoID for server authentication. Mutually<br>
+exclusive with the 'x509...' arguments.<br>
+ <br>
+@type protocol: str<br>
+@param protocol: cryptoID protocol URI for server<br>
+authentication. Requires the 'cryptoID' argument.<br>
+ <br>
+@type x509Fingerprint: str<br>
+@param x509Fingerprint: Hex-encoded X.509 fingerprint for<br>
+server authentication. Mutually exclusive with the 'cryptoID'<br>
+and 'x509TrustList' arguments.<br>
+ <br>
+@type x509TrustList: list of L{tlslite.X509.X509}<br>
+@param x509TrustList: A list of trusted root certificates. The<br>
+other party must present a certificate chain which extends to<br>
+one of these root certificates. The cryptlib_py module must be<br>
+installed to use this parameter. Mutually exclusive with the<br>
+'cryptoID' and 'x509Fingerprint' arguments.<br>
+ <br>
+@type x509CommonName: str<br>
+@param x509CommonName: The end-entity certificate's 'CN' field<br>
+must match this value. For a web server, this is typically a<br>
+server name such as 'www.amazon.com'. Mutually exclusive with<br>
+the 'cryptoID' and 'x509Fingerprint' arguments. Requires the<br>
+'x509TrustList' argument.<br>
+ <br>
+@type settings: L{tlslite.HandshakeSettings.HandshakeSettings}<br>
+@param settings: Various settings which can be used to control<br>
+the ciphersuites, certificate types, and SSL/TLS versions<br>
+offered by the client.</tt></dd></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.HTTPTLSConnection.html b/pydocs/gdata.tlslite.integration.HTTPTLSConnection.html
new file mode 100644
index 0000000..9f72d2e
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.HTTPTLSConnection.html
@@ -0,0 +1,273 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.integration.HTTPTLSConnection</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.integration.html"><font color="#ffffff">integration</font></a>.HTTPTLSConnection</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/HTTPTLSConnection.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/HTTPTLSConnection.py</a></font></td></tr></table>
+ <p><tt>TLS Lite + httplib.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="httplib.html">httplib</a><br>
+</td><td width="25%" valign=top><a href="socket.html">socket</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="httplib.html#HTTPConnection">httplib.HTTPConnection</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.HTTPTLSConnection.html#HTTPBaseTLSConnection">HTTPBaseTLSConnection</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.HTTPTLSConnection.html#HTTPTLSConnection">HTTPTLSConnection</a>(<a href="gdata.tlslite.integration.HTTPTLSConnection.html#HTTPBaseTLSConnection">HTTPBaseTLSConnection</a>, <a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>)
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HTTPBaseTLSConnection">class <strong>HTTPBaseTLSConnection</strong></a>(<a href="httplib.html#HTTPConnection">httplib.HTTPConnection</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This abstract class provides a framework for adding TLS support<br>
+to httplib.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="HTTPBaseTLSConnection-__init__"><strong>__init__</strong></a>(self, host, port<font color="#909090">=None</font>, strict<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="HTTPBaseTLSConnection-connect"><strong>connect</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>default_port</strong> = 443</dl>
+
+<hr>
+Methods inherited from <a href="httplib.html#HTTPConnection">httplib.HTTPConnection</a>:<br>
+<dl><dt><a name="HTTPBaseTLSConnection-close"><strong>close</strong></a>(self)</dt><dd><tt>Close the connection to the HTTP server.</tt></dd></dl>
+
+<dl><dt><a name="HTTPBaseTLSConnection-endheaders"><strong>endheaders</strong></a>(self, message_body<font color="#909090">=None</font>)</dt><dd><tt>Indicate that the last header line has been sent to the server.<br>
+ <br>
+This method sends the request to the server. The optional<br>
+message_body argument can be used to pass a message body<br>
+associated with the request. The message body will be sent in<br>
+the same packet as the message headers if it is string, otherwise it is<br>
+sent as a separate packet.</tt></dd></dl>
+
+<dl><dt><a name="HTTPBaseTLSConnection-getresponse"><strong>getresponse</strong></a>(self, buffering<font color="#909090">=False</font>)</dt><dd><tt>Get the response from the server.</tt></dd></dl>
+
+<dl><dt><a name="HTTPBaseTLSConnection-putheader"><strong>putheader</strong></a>(self, header, *values)</dt><dd><tt>Send a request header line to the server.<br>
+ <br>
+For example: h.<a href="#HTTPBaseTLSConnection-putheader">putheader</a>('Accept', 'text/html')</tt></dd></dl>
+
+<dl><dt><a name="HTTPBaseTLSConnection-putrequest"><strong>putrequest</strong></a>(self, method, url, skip_host<font color="#909090">=0</font>, skip_accept_encoding<font color="#909090">=0</font>)</dt><dd><tt>Send a request to the server.<br>
+ <br>
+`method' specifies an HTTP request method, e.g. 'GET'.<br>
+`url' specifies the object being requested, e.g. '/index.html'.<br>
+`skip_host' if True does not add automatically a 'Host:' header<br>
+`skip_accept_encoding' if True does not add automatically an<br>
+ 'Accept-Encoding:' header</tt></dd></dl>
+
+<dl><dt><a name="HTTPBaseTLSConnection-request"><strong>request</strong></a>(self, method, url, body<font color="#909090">=None</font>, headers<font color="#909090">={}</font>)</dt><dd><tt>Send a complete request to the server.</tt></dd></dl>
+
+<dl><dt><a name="HTTPBaseTLSConnection-send"><strong>send</strong></a>(self, data)</dt><dd><tt>Send `data' to the server.</tt></dd></dl>
+
+<dl><dt><a name="HTTPBaseTLSConnection-set_debuglevel"><strong>set_debuglevel</strong></a>(self, level)</dt></dl>
+
+<dl><dt><a name="HTTPBaseTLSConnection-set_tunnel"><strong>set_tunnel</strong></a>(self, host, port<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Sets up the host and the port for the HTTP CONNECT Tunnelling.<br>
+ <br>
+The headers argument should be a mapping of extra HTTP headers<br>
+to send with the CONNECT request.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="httplib.html#HTTPConnection">httplib.HTTPConnection</a>:<br>
+<dl><dt><strong>auto_open</strong> = 1</dl>
+
+<dl><dt><strong>debuglevel</strong> = 0</dl>
+
+<dl><dt><strong>response_class</strong> = <class httplib.HTTPResponse></dl>
+
+<dl><dt><strong>strict</strong> = 0</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HTTPTLSConnection">class <strong>HTTPTLSConnection</strong></a>(<a href="gdata.tlslite.integration.HTTPTLSConnection.html#HTTPBaseTLSConnection">HTTPBaseTLSConnection</a>, <a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class extends L{<a href="#HTTPBaseTLSConnection">HTTPBaseTLSConnection</a>} to support the<br>
+common types of handshaking.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.integration.HTTPTLSConnection.html#HTTPTLSConnection">HTTPTLSConnection</a></dd>
+<dd><a href="gdata.tlslite.integration.HTTPTLSConnection.html#HTTPBaseTLSConnection">HTTPBaseTLSConnection</a></dd>
+<dd><a href="httplib.html#HTTPConnection">httplib.HTTPConnection</a></dd>
+<dd><a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="HTTPTLSConnection-__init__"><strong>__init__</strong></a>(self, host, port<font color="#909090">=None</font>, username<font color="#909090">=None</font>, password<font color="#909090">=None</font>, sharedKey<font color="#909090">=None</font>, certChain<font color="#909090">=None</font>, privateKey<font color="#909090">=None</font>, cryptoID<font color="#909090">=None</font>, protocol<font color="#909090">=None</font>, x509Fingerprint<font color="#909090">=None</font>, x509TrustList<font color="#909090">=None</font>, x509CommonName<font color="#909090">=None</font>, settings<font color="#909090">=None</font>)</dt><dd><tt>Create a new <a href="#HTTPTLSConnection">HTTPTLSConnection</a>.<br>
+ <br>
+For client authentication, use one of these argument<br>
+combinations:<br>
+ - username, password (SRP)<br>
+ - username, sharedKey (shared-key)<br>
+ - certChain, privateKey (certificate)<br>
+ <br>
+For server authentication, you can either rely on the<br>
+implicit mutual authentication performed by SRP or<br>
+shared-keys, or you can do certificate-based server<br>
+authentication with one of these argument combinations:<br>
+ - cryptoID[, protocol] (requires cryptoIDlib)<br>
+ - x509Fingerprint<br>
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)<br>
+ <br>
+Certificate-based server authentication is compatible with<br>
+SRP or certificate-based client authentication. It is<br>
+not compatible with shared-keys.<br>
+ <br>
+The constructor does not perform the TLS handshake itself, but<br>
+simply stores these arguments for later. The handshake is<br>
+performed only when this class needs to connect with the<br>
+server. Thus you should be prepared to handle TLS-specific<br>
+exceptions when calling methods inherited from<br>
+L{httplib.<a href="httplib.html#HTTPConnection">HTTPConnection</a>} such as <a href="#HTTPTLSConnection-request">request</a>(), <a href="#HTTPTLSConnection-connect">connect</a>(), and<br>
+<a href="#HTTPTLSConnection-send">send</a>(). See the client handshake functions in<br>
+L{tlslite.TLSConnection.TLSConnection} for details on which<br>
+exceptions might be raised.<br>
+ <br>
+@type host: str<br>
+@param host: Server to connect to.<br>
+ <br>
+@type port: int<br>
+@param port: Port to connect to.<br>
+ <br>
+@type username: str<br>
+@param username: SRP or shared-key username. Requires the<br>
+'password' or 'sharedKey' argument.<br>
+ <br>
+@type password: str<br>
+@param password: SRP password for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type sharedKey: str<br>
+@param sharedKey: Shared key for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type certChain: L{tlslite.X509CertChain.X509CertChain} or<br>
+L{cryptoIDlib.CertChain.CertChain}<br>
+@param certChain: Certificate chain for client authentication.<br>
+Requires the 'privateKey' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type privateKey: L{tlslite.utils.RSAKey.RSAKey}<br>
+@param privateKey: Private key for client authentication.<br>
+Requires the 'certChain' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type cryptoID: str<br>
+@param cryptoID: cryptoID for server authentication. Mutually<br>
+exclusive with the 'x509...' arguments.<br>
+ <br>
+@type protocol: str<br>
+@param protocol: cryptoID protocol URI for server<br>
+authentication. Requires the 'cryptoID' argument.<br>
+ <br>
+@type x509Fingerprint: str<br>
+@param x509Fingerprint: Hex-encoded X.509 fingerprint for<br>
+server authentication. Mutually exclusive with the 'cryptoID'<br>
+and 'x509TrustList' arguments.<br>
+ <br>
+@type x509TrustList: list of L{tlslite.X509.X509}<br>
+@param x509TrustList: A list of trusted root certificates. The<br>
+other party must present a certificate chain which extends to<br>
+one of these root certificates. The cryptlib_py module must be<br>
+installed to use this parameter. Mutually exclusive with the<br>
+'cryptoID' and 'x509Fingerprint' arguments.<br>
+ <br>
+@type x509CommonName: str<br>
+@param x509CommonName: The end-entity certificate's 'CN' field<br>
+must match this value. For a web server, this is typically a<br>
+server name such as 'www.amazon.com'. Mutually exclusive with<br>
+the 'cryptoID' and 'x509Fingerprint' arguments. Requires the<br>
+'x509TrustList' argument.<br>
+ <br>
+@type settings: L{tlslite.HandshakeSettings.HandshakeSettings}<br>
+@param settings: Various settings which can be used to control<br>
+the ciphersuites, certificate types, and SSL/TLS versions<br>
+offered by the client.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.integration.HTTPTLSConnection.html#HTTPBaseTLSConnection">HTTPBaseTLSConnection</a>:<br>
+<dl><dt><a name="HTTPTLSConnection-connect"><strong>connect</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.tlslite.integration.HTTPTLSConnection.html#HTTPBaseTLSConnection">HTTPBaseTLSConnection</a>:<br>
+<dl><dt><strong>default_port</strong> = 443</dl>
+
+<hr>
+Methods inherited from <a href="httplib.html#HTTPConnection">httplib.HTTPConnection</a>:<br>
+<dl><dt><a name="HTTPTLSConnection-close"><strong>close</strong></a>(self)</dt><dd><tt>Close the connection to the HTTP server.</tt></dd></dl>
+
+<dl><dt><a name="HTTPTLSConnection-endheaders"><strong>endheaders</strong></a>(self, message_body<font color="#909090">=None</font>)</dt><dd><tt>Indicate that the last header line has been sent to the server.<br>
+ <br>
+This method sends the request to the server. The optional<br>
+message_body argument can be used to pass a message body<br>
+associated with the request. The message body will be sent in<br>
+the same packet as the message headers if it is string, otherwise it is<br>
+sent as a separate packet.</tt></dd></dl>
+
+<dl><dt><a name="HTTPTLSConnection-getresponse"><strong>getresponse</strong></a>(self, buffering<font color="#909090">=False</font>)</dt><dd><tt>Get the response from the server.</tt></dd></dl>
+
+<dl><dt><a name="HTTPTLSConnection-putheader"><strong>putheader</strong></a>(self, header, *values)</dt><dd><tt>Send a request header line to the server.<br>
+ <br>
+For example: h.<a href="#HTTPTLSConnection-putheader">putheader</a>('Accept', 'text/html')</tt></dd></dl>
+
+<dl><dt><a name="HTTPTLSConnection-putrequest"><strong>putrequest</strong></a>(self, method, url, skip_host<font color="#909090">=0</font>, skip_accept_encoding<font color="#909090">=0</font>)</dt><dd><tt>Send a request to the server.<br>
+ <br>
+`method' specifies an HTTP request method, e.g. 'GET'.<br>
+`url' specifies the object being requested, e.g. '/index.html'.<br>
+`skip_host' if True does not add automatically a 'Host:' header<br>
+`skip_accept_encoding' if True does not add automatically an<br>
+ 'Accept-Encoding:' header</tt></dd></dl>
+
+<dl><dt><a name="HTTPTLSConnection-request"><strong>request</strong></a>(self, method, url, body<font color="#909090">=None</font>, headers<font color="#909090">={}</font>)</dt><dd><tt>Send a complete request to the server.</tt></dd></dl>
+
+<dl><dt><a name="HTTPTLSConnection-send"><strong>send</strong></a>(self, data)</dt><dd><tt>Send `data' to the server.</tt></dd></dl>
+
+<dl><dt><a name="HTTPTLSConnection-set_debuglevel"><strong>set_debuglevel</strong></a>(self, level)</dt></dl>
+
+<dl><dt><a name="HTTPTLSConnection-set_tunnel"><strong>set_tunnel</strong></a>(self, host, port<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Sets up the host and the port for the HTTP CONNECT Tunnelling.<br>
+ <br>
+The headers argument should be a mapping of extra HTTP headers<br>
+to send with the CONNECT request.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="httplib.html#HTTPConnection">httplib.HTTPConnection</a>:<br>
+<dl><dt><strong>auto_open</strong> = 1</dl>
+
+<dl><dt><strong>debuglevel</strong> = 0</dl>
+
+<dl><dt><strong>response_class</strong> = <class httplib.HTTPResponse></dl>
+
+<dl><dt><strong>strict</strong> = 0</dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.IMAP4_TLS.html b/pydocs/gdata.tlslite.integration.IMAP4_TLS.html
new file mode 100644
index 0000000..a2c8be4
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.IMAP4_TLS.html
@@ -0,0 +1,409 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.integration.IMAP4_TLS</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.integration.html"><font color="#ffffff">integration</font></a>.IMAP4_TLS</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/IMAP4_TLS.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/IMAP4_TLS.py</a></font></td></tr></table>
+ <p><tt>TLS Lite + imaplib.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="socket.html">socket</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.IMAP4_TLS.html#IMAP4_TLS">IMAP4_TLS</a>(<a href="imaplib.html#IMAP4">imaplib.IMAP4</a>, <a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="imaplib.html#IMAP4">imaplib.IMAP4</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.IMAP4_TLS.html#IMAP4_TLS">IMAP4_TLS</a>(<a href="imaplib.html#IMAP4">imaplib.IMAP4</a>, <a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>)
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="IMAP4_TLS">class <strong>IMAP4_TLS</strong></a>(<a href="imaplib.html#IMAP4">imaplib.IMAP4</a>, <a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class extends L{imaplib.<a href="imaplib.html#IMAP4">IMAP4</a>} with TLS support.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.integration.IMAP4_TLS.html#IMAP4_TLS">IMAP4_TLS</a></dd>
+<dd><a href="imaplib.html#IMAP4">imaplib.IMAP4</a></dd>
+<dd><a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="IMAP4_TLS-__init__"><strong>__init__</strong></a>(self, host<font color="#909090">=''</font>, port<font color="#909090">=993</font>, username<font color="#909090">=None</font>, password<font color="#909090">=None</font>, sharedKey<font color="#909090">=None</font>, certChain<font color="#909090">=None</font>, privateKey<font color="#909090">=None</font>, cryptoID<font color="#909090">=None</font>, protocol<font color="#909090">=None</font>, x509Fingerprint<font color="#909090">=None</font>, x509TrustList<font color="#909090">=None</font>, x509CommonName<font color="#909090">=None</font>, settings<font color="#909090">=None</font>)</dt><dd><tt>Create a new <a href="#IMAP4_TLS">IMAP4_TLS</a>.<br>
+ <br>
+For client authentication, use one of these argument<br>
+combinations:<br>
+ - username, password (SRP)<br>
+ - username, sharedKey (shared-key)<br>
+ - certChain, privateKey (certificate)<br>
+ <br>
+For server authentication, you can either rely on the<br>
+implicit mutual authentication performed by SRP or<br>
+shared-keys, or you can do certificate-based server<br>
+authentication with one of these argument combinations:<br>
+ - cryptoID[, protocol] (requires cryptoIDlib)<br>
+ - x509Fingerprint<br>
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)<br>
+ <br>
+Certificate-based server authentication is compatible with<br>
+SRP or certificate-based client authentication. It is<br>
+not compatible with shared-keys.<br>
+ <br>
+The caller should be prepared to handle TLS-specific<br>
+exceptions. See the client handshake functions in<br>
+L{tlslite.TLSConnection.TLSConnection} for details on which<br>
+exceptions might be raised.<br>
+ <br>
+@type host: str<br>
+@param host: Server to connect to.<br>
+ <br>
+@type port: int<br>
+@param port: Port to connect to.<br>
+ <br>
+@type username: str<br>
+@param username: SRP or shared-key username. Requires the<br>
+'password' or 'sharedKey' argument.<br>
+ <br>
+@type password: str<br>
+@param password: SRP password for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type sharedKey: str<br>
+@param sharedKey: Shared key for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type certChain: L{tlslite.X509CertChain.X509CertChain} or<br>
+L{cryptoIDlib.CertChain.CertChain}<br>
+@param certChain: Certificate chain for client authentication.<br>
+Requires the 'privateKey' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type privateKey: L{tlslite.utils.RSAKey.RSAKey}<br>
+@param privateKey: Private key for client authentication.<br>
+Requires the 'certChain' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type cryptoID: str<br>
+@param cryptoID: cryptoID for server authentication. Mutually<br>
+exclusive with the 'x509...' arguments.<br>
+ <br>
+@type protocol: str<br>
+@param protocol: cryptoID protocol URI for server<br>
+authentication. Requires the 'cryptoID' argument.<br>
+ <br>
+@type x509Fingerprint: str<br>
+@param x509Fingerprint: Hex-encoded X.509 fingerprint for<br>
+server authentication. Mutually exclusive with the 'cryptoID'<br>
+and 'x509TrustList' arguments.<br>
+ <br>
+@type x509TrustList: list of L{tlslite.X509.X509}<br>
+@param x509TrustList: A list of trusted root certificates. The<br>
+other party must present a certificate chain which extends to<br>
+one of these root certificates. The cryptlib_py module must be<br>
+installed to use this parameter. Mutually exclusive with the<br>
+'cryptoID' and 'x509Fingerprint' arguments.<br>
+ <br>
+@type x509CommonName: str<br>
+@param x509CommonName: The end-entity certificate's 'CN' field<br>
+must match this value. For a web server, this is typically a<br>
+server name such as 'www.amazon.com'. Mutually exclusive with<br>
+the 'cryptoID' and 'x509Fingerprint' arguments. Requires the<br>
+'x509TrustList' argument.<br>
+ <br>
+@type settings: L{tlslite.HandshakeSettings.HandshakeSettings}<br>
+@param settings: Various settings which can be used to control<br>
+the ciphersuites, certificate types, and SSL/TLS versions<br>
+offered by the client.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-open"><strong>open</strong></a>(self, host<font color="#909090">=''</font>, port<font color="#909090">=993</font>)</dt><dd><tt>Setup connection to remote server on "host:port".<br>
+ <br>
+This connection will be used by the routines:<br>
+read, readline, send, shutdown.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="imaplib.html#IMAP4">imaplib.IMAP4</a>:<br>
+<dl><dt><a name="IMAP4_TLS-__getattr__"><strong>__getattr__</strong></a>(self, attr)</dt></dl>
+
+<dl><dt><a name="IMAP4_TLS-append"><strong>append</strong></a>(self, mailbox, flags, date_time, message)</dt><dd><tt>Append message to named mailbox.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-append">append</a>(mailbox, flags, date_time, message)<br>
+ <br>
+ All args except `message' can be None.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-authenticate"><strong>authenticate</strong></a>(self, mechanism, authobject)</dt><dd><tt>Authenticate command - requires response processing.<br>
+ <br>
+'mechanism' specifies which authentication mechanism is to<br>
+be used - it must appear in <instance>.capabilities in the<br>
+form AUTH=<mechanism>.<br>
+ <br>
+'authobject' must be a callable object:<br>
+ <br>
+ data = authobject(response)<br>
+ <br>
+It will be called to process server continuation responses.<br>
+It should return data that will be encoded and sent to server.<br>
+It should return None if the client abort response '*' should<br>
+be sent instead.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-capability"><strong>capability</strong></a>(self)</dt><dd><tt>(typ, [data]) = <instance>.<a href="#IMAP4_TLS-capability">capability</a>()<br>
+Fetch capabilities list from server.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-check"><strong>check</strong></a>(self)</dt><dd><tt>Checkpoint mailbox on server.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-check">check</a>()</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-close"><strong>close</strong></a>(self)</dt><dd><tt>Close currently selected mailbox.<br>
+ <br>
+Deleted messages are removed from writable mailbox.<br>
+This is the recommended command before 'LOGOUT'.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-close">close</a>()</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-copy"><strong>copy</strong></a>(self, message_set, new_mailbox)</dt><dd><tt>Copy 'message_set' messages onto end of 'new_mailbox'.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-copy">copy</a>(message_set, new_mailbox)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-create"><strong>create</strong></a>(self, mailbox)</dt><dd><tt>Create new mailbox.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-create">create</a>(mailbox)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-delete"><strong>delete</strong></a>(self, mailbox)</dt><dd><tt>Delete old mailbox.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-delete">delete</a>(mailbox)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-deleteacl"><strong>deleteacl</strong></a>(self, mailbox, who)</dt><dd><tt>Delete the ACLs (remove any rights) set for who on mailbox.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-deleteacl">deleteacl</a>(mailbox, who)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-expunge"><strong>expunge</strong></a>(self)</dt><dd><tt>Permanently remove deleted items from selected mailbox.<br>
+ <br>
+Generates 'EXPUNGE' response for each deleted message.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-expunge">expunge</a>()<br>
+ <br>
+'data' is list of 'EXPUNGE'd message numbers in order received.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-fetch"><strong>fetch</strong></a>(self, message_set, message_parts)</dt><dd><tt>Fetch (parts of) messages.<br>
+ <br>
+(typ, [data, ...]) = <instance>.<a href="#IMAP4_TLS-fetch">fetch</a>(message_set, message_parts)<br>
+ <br>
+'message_parts' should be a string of selected parts<br>
+enclosed in parentheses, eg: "(UID BODY[TEXT])".<br>
+ <br>
+'data' are tuples of message part envelope and data.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-getacl"><strong>getacl</strong></a>(self, mailbox)</dt><dd><tt>Get the ACLs for a mailbox.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-getacl">getacl</a>(mailbox)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-getannotation"><strong>getannotation</strong></a>(self, mailbox, entry, attribute)</dt><dd><tt>(typ, [data]) = <instance>.<a href="#IMAP4_TLS-getannotation">getannotation</a>(mailbox, entry, attribute)<br>
+Retrieve ANNOTATIONs.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-getquota"><strong>getquota</strong></a>(self, root)</dt><dd><tt>Get the quota root's resource usage and limits.<br>
+ <br>
+Part of the <a href="imaplib.html#IMAP4">IMAP4</a> QUOTA extension defined in rfc2087.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-getquota">getquota</a>(root)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-getquotaroot"><strong>getquotaroot</strong></a>(self, mailbox)</dt><dd><tt>Get the list of quota roots for the named mailbox.<br>
+ <br>
+(typ, [[QUOTAROOT responses...], [QUOTA responses]]) = <instance>.<a href="#IMAP4_TLS-getquotaroot">getquotaroot</a>(mailbox)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-list"><strong>list</strong></a>(self, directory<font color="#909090">='""'</font>, pattern<font color="#909090">='*'</font>)</dt><dd><tt>List mailbox names in directory matching pattern.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-list">list</a>(directory='""', pattern='*')<br>
+ <br>
+'data' is list of LIST responses.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-login"><strong>login</strong></a>(self, user, password)</dt><dd><tt>Identify client using plaintext password.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-login">login</a>(user, password)<br>
+ <br>
+NB: 'password' will be quoted.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-login_cram_md5"><strong>login_cram_md5</strong></a>(self, user, password)</dt><dd><tt>Force use of CRAM-MD5 authentication.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-login_cram_md5">login_cram_md5</a>(user, password)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-logout"><strong>logout</strong></a>(self)</dt><dd><tt>Shutdown connection to server.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-logout">logout</a>()<br>
+ <br>
+Returns server 'BYE' response.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-lsub"><strong>lsub</strong></a>(self, directory<font color="#909090">='""'</font>, pattern<font color="#909090">='*'</font>)</dt><dd><tt>List 'subscribed' mailbox names in directory matching pattern.<br>
+ <br>
+(typ, [data, ...]) = <instance>.<a href="#IMAP4_TLS-lsub">lsub</a>(directory='""', pattern='*')<br>
+ <br>
+'data' are tuples of message part envelope and data.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-myrights"><strong>myrights</strong></a>(self, mailbox)</dt><dd><tt>Show my ACLs for a mailbox (i.e. the rights that I have on mailbox).<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-myrights">myrights</a>(mailbox)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-namespace"><strong>namespace</strong></a>(self)</dt><dd><tt>Returns IMAP namespaces ala rfc2342<br>
+ <br>
+(typ, [data, ...]) = <instance>.<a href="#IMAP4_TLS-namespace">namespace</a>()</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-noop"><strong>noop</strong></a>(self)</dt><dd><tt>Send NOOP command.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-noop">noop</a>()</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-partial"><strong>partial</strong></a>(self, message_num, message_part, start, length)</dt><dd><tt>Fetch truncated part of a message.<br>
+ <br>
+(typ, [data, ...]) = <instance>.<a href="#IMAP4_TLS-partial">partial</a>(message_num, message_part, start, length)<br>
+ <br>
+'data' is tuple of message part envelope and data.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-print_log"><strong>print_log</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="IMAP4_TLS-proxyauth"><strong>proxyauth</strong></a>(self, user)</dt><dd><tt>Assume authentication as "user".<br>
+ <br>
+Allows an authorised administrator to proxy into any user's<br>
+mailbox.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-proxyauth">proxyauth</a>(user)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-read"><strong>read</strong></a>(self, size)</dt><dd><tt>Read 'size' bytes from remote.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-readline"><strong>readline</strong></a>(self)</dt><dd><tt>Read line from remote.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-recent"><strong>recent</strong></a>(self)</dt><dd><tt>Return most recent 'RECENT' responses if any exist,<br>
+else prompt server for an update using the 'NOOP' command.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-recent">recent</a>()<br>
+ <br>
+'data' is None if no new messages,<br>
+else list of RECENT responses, most recent last.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-rename"><strong>rename</strong></a>(self, oldmailbox, newmailbox)</dt><dd><tt>Rename old mailbox name to new.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-rename">rename</a>(oldmailbox, newmailbox)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-response"><strong>response</strong></a>(self, code)</dt><dd><tt>Return data for response 'code' if received, or None.<br>
+ <br>
+Old value for response 'code' is cleared.<br>
+ <br>
+(code, [data]) = <instance>.<a href="#IMAP4_TLS-response">response</a>(code)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-search"><strong>search</strong></a>(self, charset, *criteria)</dt><dd><tt>Search mailbox for matching messages.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-search">search</a>(charset, criterion, ...)<br>
+ <br>
+'data' is space separated list of matching message numbers.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-select"><strong>select</strong></a>(self, mailbox<font color="#909090">='INBOX'</font>, readonly<font color="#909090">=False</font>)</dt><dd><tt>Select a mailbox.<br>
+ <br>
+Flush all untagged responses.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-select">select</a>(mailbox='INBOX', readonly=False)<br>
+ <br>
+'data' is count of messages in mailbox ('EXISTS' response).<br>
+ <br>
+Mandated responses are ('FLAGS', 'EXISTS', 'RECENT', 'UIDVALIDITY'), so<br>
+other responses should be obtained via <instance>.<a href="#IMAP4_TLS-response">response</a>('FLAGS') etc.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-send"><strong>send</strong></a>(self, data)</dt><dd><tt>Send data to remote.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-setacl"><strong>setacl</strong></a>(self, mailbox, who, what)</dt><dd><tt>Set a mailbox acl.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-setacl">setacl</a>(mailbox, who, what)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-setannotation"><strong>setannotation</strong></a>(self, *args)</dt><dd><tt>(typ, [data]) = <instance>.<a href="#IMAP4_TLS-setannotation">setannotation</a>(mailbox[, entry, attribute]+)<br>
+Set ANNOTATIONs.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-setquota"><strong>setquota</strong></a>(self, root, limits)</dt><dd><tt>Set the quota root's resource limits.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-setquota">setquota</a>(root, limits)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-shutdown"><strong>shutdown</strong></a>(self)</dt><dd><tt>Close I/O established in "open".</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-socket"><strong>socket</strong></a>(self)</dt><dd><tt>Return socket instance used to connect to <a href="imaplib.html#IMAP4">IMAP4</a> server.<br>
+ <br>
+socket = <instance>.<a href="#IMAP4_TLS-socket">socket</a>()</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-sort"><strong>sort</strong></a>(self, sort_criteria, charset, *search_criteria)</dt><dd><tt>IMAP4rev1 extension SORT command.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-sort">sort</a>(sort_criteria, charset, search_criteria, ...)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-status"><strong>status</strong></a>(self, mailbox, names)</dt><dd><tt>Request named status conditions for mailbox.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-status">status</a>(mailbox, names)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-store"><strong>store</strong></a>(self, message_set, command, flags)</dt><dd><tt>Alters flag dispositions for messages in mailbox.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-store">store</a>(message_set, command, flags)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-subscribe"><strong>subscribe</strong></a>(self, mailbox)</dt><dd><tt>Subscribe to new mailbox.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-subscribe">subscribe</a>(mailbox)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-thread"><strong>thread</strong></a>(self, threading_algorithm, charset, *search_criteria)</dt><dd><tt>IMAPrev1 extension THREAD command.<br>
+ <br>
+(type, [data]) = <instance>.<a href="#IMAP4_TLS-thread">thread</a>(threading_algorithm, charset, search_criteria, ...)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-uid"><strong>uid</strong></a>(self, command, *args)</dt><dd><tt>Execute "command arg ..." with messages identified by UID,<br>
+ rather than message number.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-uid">uid</a>(command, arg1, arg2, ...)<br>
+ <br>
+Returns response appropriate to 'command'.</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-unsubscribe"><strong>unsubscribe</strong></a>(self, mailbox)</dt><dd><tt>Unsubscribe from old mailbox.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-unsubscribe">unsubscribe</a>(mailbox)</tt></dd></dl>
+
+<dl><dt><a name="IMAP4_TLS-xatom"><strong>xatom</strong></a>(self, name, *args)</dt><dd><tt>Allow simple extension commands<br>
+ notified by server in CAPABILITY response.<br>
+ <br>
+Assumes command is legal in current state.<br>
+ <br>
+(typ, [data]) = <instance>.<a href="#IMAP4_TLS-xatom">xatom</a>(name, arg, ...)<br>
+ <br>
+Returns response appropriate to extension command `name'.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="imaplib.html#IMAP4">imaplib.IMAP4</a>:<br>
+<dl><dt><strong>abort</strong> = <class 'imaplib.abort'></dl>
+
+<dl><dt><strong>error</strong> = <class 'imaplib.error'></dl>
+
+<dl><dt><strong>mustquote</strong> = <_sre.SRE_Pattern object></dl>
+
+<dl><dt><strong>readonly</strong> = <class 'imaplib.readonly'></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>IMAP4_TLS_PORT</strong> = 993</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.IntegrationHelper.html b/pydocs/gdata.tlslite.integration.IntegrationHelper.html
new file mode 100644
index 0000000..7cba99a
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.IntegrationHelper.html
@@ -0,0 +1,34 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.integration.IntegrationHelper</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.integration.html"><font color="#ffffff">integration</font></a>.IntegrationHelper</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/IntegrationHelper.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/IntegrationHelper.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.IntegrationHelper.html#IntegrationHelper">IntegrationHelper</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="IntegrationHelper">class <strong>IntegrationHelper</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="IntegrationHelper-__init__"><strong>__init__</strong></a>(self, username<font color="#909090">=None</font>, password<font color="#909090">=None</font>, sharedKey<font color="#909090">=None</font>, certChain<font color="#909090">=None</font>, privateKey<font color="#909090">=None</font>, cryptoID<font color="#909090">=None</font>, protocol<font color="#909090">=None</font>, x509Fingerprint<font color="#909090">=None</font>, x509TrustList<font color="#909090">=None</font>, x509CommonName<font color="#909090">=None</font>, settings<font color="#909090">=None</font>)</dt></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.POP3_TLS.html b/pydocs/gdata.tlslite.integration.POP3_TLS.html
new file mode 100644
index 0000000..45af505
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.POP3_TLS.html
@@ -0,0 +1,223 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.integration.POP3_TLS</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.integration.html"><font color="#ffffff">integration</font></a>.POP3_TLS</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/POP3_TLS.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/POP3_TLS.py</a></font></td></tr></table>
+ <p><tt>TLS Lite + poplib.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="socket.html">socket</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.POP3_TLS.html#POP3_TLS">POP3_TLS</a>(<a href="poplib.html#POP3">poplib.POP3</a>, <a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="poplib.html#POP3">poplib.POP3</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.POP3_TLS.html#POP3_TLS">POP3_TLS</a>(<a href="poplib.html#POP3">poplib.POP3</a>, <a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>)
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="POP3_TLS">class <strong>POP3_TLS</strong></a>(<a href="poplib.html#POP3">poplib.POP3</a>, <a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class extends L{poplib.<a href="poplib.html#POP3">POP3</a>} with TLS support.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.integration.POP3_TLS.html#POP3_TLS">POP3_TLS</a></dd>
+<dd><a href="poplib.html#POP3">poplib.POP3</a></dd>
+<dd><a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="POP3_TLS-__init__"><strong>__init__</strong></a>(self, host, port<font color="#909090">=995</font>, username<font color="#909090">=None</font>, password<font color="#909090">=None</font>, sharedKey<font color="#909090">=None</font>, certChain<font color="#909090">=None</font>, privateKey<font color="#909090">=None</font>, cryptoID<font color="#909090">=None</font>, protocol<font color="#909090">=None</font>, x509Fingerprint<font color="#909090">=None</font>, x509TrustList<font color="#909090">=None</font>, x509CommonName<font color="#909090">=None</font>, settings<font color="#909090">=None</font>)</dt><dd><tt>Create a new <a href="#POP3_TLS">POP3_TLS</a>.<br>
+ <br>
+For client authentication, use one of these argument<br>
+combinations:<br>
+ - username, password (SRP)<br>
+ - username, sharedKey (shared-key)<br>
+ - certChain, privateKey (certificate)<br>
+ <br>
+For server authentication, you can either rely on the<br>
+implicit mutual authentication performed by SRP or<br>
+shared-keys, or you can do certificate-based server<br>
+authentication with one of these argument combinations:<br>
+ - cryptoID[, protocol] (requires cryptoIDlib)<br>
+ - x509Fingerprint<br>
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)<br>
+ <br>
+Certificate-based server authentication is compatible with<br>
+SRP or certificate-based client authentication. It is<br>
+not compatible with shared-keys.<br>
+ <br>
+The caller should be prepared to handle TLS-specific<br>
+exceptions. See the client handshake functions in<br>
+L{tlslite.TLSConnection.TLSConnection} for details on which<br>
+exceptions might be raised.<br>
+ <br>
+@type host: str<br>
+@param host: Server to connect to.<br>
+ <br>
+@type port: int<br>
+@param port: Port to connect to.<br>
+ <br>
+@type username: str<br>
+@param username: SRP or shared-key username. Requires the<br>
+'password' or 'sharedKey' argument.<br>
+ <br>
+@type password: str<br>
+@param password: SRP password for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type sharedKey: str<br>
+@param sharedKey: Shared key for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type certChain: L{tlslite.X509CertChain.X509CertChain} or<br>
+L{cryptoIDlib.CertChain.CertChain}<br>
+@param certChain: Certificate chain for client authentication.<br>
+Requires the 'privateKey' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type privateKey: L{tlslite.utils.RSAKey.RSAKey}<br>
+@param privateKey: Private key for client authentication.<br>
+Requires the 'certChain' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type cryptoID: str<br>
+@param cryptoID: cryptoID for server authentication. Mutually<br>
+exclusive with the 'x509...' arguments.<br>
+ <br>
+@type protocol: str<br>
+@param protocol: cryptoID protocol URI for server<br>
+authentication. Requires the 'cryptoID' argument.<br>
+ <br>
+@type x509Fingerprint: str<br>
+@param x509Fingerprint: Hex-encoded X.509 fingerprint for<br>
+server authentication. Mutually exclusive with the 'cryptoID'<br>
+and 'x509TrustList' arguments.<br>
+ <br>
+@type x509TrustList: list of L{tlslite.X509.X509}<br>
+@param x509TrustList: A list of trusted root certificates. The<br>
+other party must present a certificate chain which extends to<br>
+one of these root certificates. The cryptlib_py module must be<br>
+installed to use this parameter. Mutually exclusive with the<br>
+'cryptoID' and 'x509Fingerprint' arguments.<br>
+ <br>
+@type x509CommonName: str<br>
+@param x509CommonName: The end-entity certificate's 'CN' field<br>
+must match this value. For a web server, this is typically a<br>
+server name such as 'www.amazon.com'. Mutually exclusive with<br>
+the 'cryptoID' and 'x509Fingerprint' arguments. Requires the<br>
+'x509TrustList' argument.<br>
+ <br>
+@type settings: L{tlslite.HandshakeSettings.HandshakeSettings}<br>
+@param settings: Various settings which can be used to control<br>
+the ciphersuites, certificate types, and SSL/TLS versions<br>
+offered by the client.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="poplib.html#POP3">poplib.POP3</a>:<br>
+<dl><dt><a name="POP3_TLS-apop"><strong>apop</strong></a>(self, user, secret)</dt><dd><tt>Authorisation<br>
+ <br>
+- only possible if server has supplied a timestamp in initial greeting.<br>
+ <br>
+Args:<br>
+ user - mailbox user;<br>
+ secret - secret shared between client and server.<br>
+ <br>
+NB: mailbox is locked by server from here to '<a href="#POP3_TLS-quit">quit</a>()'</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-dele"><strong>dele</strong></a>(self, which)</dt><dd><tt>Delete message number 'which'.<br>
+ <br>
+Result is 'response'.</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-getwelcome"><strong>getwelcome</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="POP3_TLS-list"><strong>list</strong></a>(self, which<font color="#909090">=None</font>)</dt><dd><tt>Request listing, return result.<br>
+ <br>
+Result without a message number argument is in form<br>
+['response', ['mesg_num octets', ...], octets].<br>
+ <br>
+Result when a message number argument is given is a<br>
+single response: the "scan listing" for that message.</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-noop"><strong>noop</strong></a>(self)</dt><dd><tt>Does nothing.<br>
+ <br>
+One supposes the response indicates the server is alive.</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-pass_"><strong>pass_</strong></a>(self, pswd)</dt><dd><tt>Send password, return response<br>
+ <br>
+(response includes message count, mailbox size).<br>
+ <br>
+NB: mailbox is locked by server from here to '<a href="#POP3_TLS-quit">quit</a>()'</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-quit"><strong>quit</strong></a>(self)</dt><dd><tt>Signoff: commit changes on server, unlock mailbox, close connection.</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-retr"><strong>retr</strong></a>(self, which)</dt><dd><tt>Retrieve whole message number 'which'.<br>
+ <br>
+Result is in form ['response', ['line', ...], octets].</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-rpop"><strong>rpop</strong></a>(self, user)</dt><dd><tt>Not sure what this does.</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-rset"><strong>rset</strong></a>(self)</dt><dd><tt>Unmark all messages marked for deletion.</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-set_debuglevel"><strong>set_debuglevel</strong></a>(self, level)</dt></dl>
+
+<dl><dt><a name="POP3_TLS-stat"><strong>stat</strong></a>(self)</dt><dd><tt>Get mailbox status.<br>
+ <br>
+Result is tuple of 2 ints (message count, mailbox size)</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-top"><strong>top</strong></a>(self, which, howmuch)</dt><dd><tt>Retrieve message header of message number 'which'<br>
+and first 'howmuch' lines of message body.<br>
+ <br>
+Result is in form ['response', ['line', ...], octets].</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-uidl"><strong>uidl</strong></a>(self, which<font color="#909090">=None</font>)</dt><dd><tt>Return message digest (unique id) list.<br>
+ <br>
+If 'which', result contains unique id for that message<br>
+in the form 'response mesgnum uid', otherwise result is<br>
+the list ['response', ['mesgnum uid', ...], octets]</tt></dd></dl>
+
+<dl><dt><a name="POP3_TLS-user"><strong>user</strong></a>(self, user)</dt><dd><tt>Send user name, return response<br>
+ <br>
+(should indicate password required).</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="poplib.html#POP3">poplib.POP3</a>:<br>
+<dl><dt><strong>timestamp</strong> = <_sre.SRE_Pattern object></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>POP3_TLS_PORT</strong> = 995</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.SMTP_TLS.html b/pydocs/gdata.tlslite.integration.SMTP_TLS.html
new file mode 100644
index 0000000..d02f323
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.SMTP_TLS.html
@@ -0,0 +1,303 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.integration.SMTP_TLS</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.integration.html"><font color="#ffffff">integration</font></a>.SMTP_TLS</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/SMTP_TLS.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/SMTP_TLS.py</a></font></td></tr></table>
+ <p><tt>TLS Lite + smtplib.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="smtplib.html#SMTP">smtplib.SMTP</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.SMTP_TLS.html#SMTP_TLS">SMTP_TLS</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SMTP_TLS">class <strong>SMTP_TLS</strong></a>(<a href="smtplib.html#SMTP">smtplib.SMTP</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class extends L{smtplib.<a href="smtplib.html#SMTP">SMTP</a>} with TLS support.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="SMTP_TLS-starttls"><strong>starttls</strong></a>(self, username<font color="#909090">=None</font>, password<font color="#909090">=None</font>, sharedKey<font color="#909090">=None</font>, certChain<font color="#909090">=None</font>, privateKey<font color="#909090">=None</font>, cryptoID<font color="#909090">=None</font>, protocol<font color="#909090">=None</font>, x509Fingerprint<font color="#909090">=None</font>, x509TrustList<font color="#909090">=None</font>, x509CommonName<font color="#909090">=None</font>, settings<font color="#909090">=None</font>)</dt><dd><tt>Puts the connection to the <a href="smtplib.html#SMTP">SMTP</a> server into TLS mode.<br>
+ <br>
+If the server supports TLS, this will encrypt the rest of the <a href="smtplib.html#SMTP">SMTP</a><br>
+session.<br>
+ <br>
+For client authentication, use one of these argument<br>
+combinations:<br>
+ - username, password (SRP)<br>
+ - username, sharedKey (shared-key)<br>
+ - certChain, privateKey (certificate)<br>
+ <br>
+For server authentication, you can either rely on the<br>
+implicit mutual authentication performed by SRP or<br>
+shared-keys, or you can do certificate-based server<br>
+authentication with one of these argument combinations:<br>
+ - cryptoID[, protocol] (requires cryptoIDlib)<br>
+ - x509Fingerprint<br>
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)<br>
+ <br>
+Certificate-based server authentication is compatible with<br>
+SRP or certificate-based client authentication. It is<br>
+not compatible with shared-keys.<br>
+ <br>
+The caller should be prepared to handle TLS-specific<br>
+exceptions. See the client handshake functions in<br>
+L{tlslite.TLSConnection.TLSConnection} for details on which<br>
+exceptions might be raised.<br>
+ <br>
+@type username: str<br>
+@param username: SRP or shared-key username. Requires the<br>
+'password' or 'sharedKey' argument.<br>
+ <br>
+@type password: str<br>
+@param password: SRP password for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type sharedKey: str<br>
+@param sharedKey: Shared key for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type certChain: L{tlslite.X509CertChain.X509CertChain} or<br>
+L{cryptoIDlib.CertChain.CertChain}<br>
+@param certChain: Certificate chain for client authentication.<br>
+Requires the 'privateKey' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type privateKey: L{tlslite.utils.RSAKey.RSAKey}<br>
+@param privateKey: Private key for client authentication.<br>
+Requires the 'certChain' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type cryptoID: str<br>
+@param cryptoID: cryptoID for server authentication. Mutually<br>
+exclusive with the 'x509...' arguments.<br>
+ <br>
+@type protocol: str<br>
+@param protocol: cryptoID protocol URI for server<br>
+authentication. Requires the 'cryptoID' argument.<br>
+ <br>
+@type x509Fingerprint: str<br>
+@param x509Fingerprint: Hex-encoded X.509 fingerprint for<br>
+server authentication. Mutually exclusive with the 'cryptoID'<br>
+and 'x509TrustList' arguments.<br>
+ <br>
+@type x509TrustList: list of L{tlslite.X509.X509}<br>
+@param x509TrustList: A list of trusted root certificates. The<br>
+other party must present a certificate chain which extends to<br>
+one of these root certificates. The cryptlib_py module must be<br>
+installed to use this parameter. Mutually exclusive with the<br>
+'cryptoID' and 'x509Fingerprint' arguments.<br>
+ <br>
+@type x509CommonName: str<br>
+@param x509CommonName: The end-entity certificate's 'CN' field<br>
+must match this value. For a web server, this is typically a<br>
+server name such as 'www.amazon.com'. Mutually exclusive with<br>
+the 'cryptoID' and 'x509Fingerprint' arguments. Requires the<br>
+'x509TrustList' argument.<br>
+ <br>
+@type settings: L{tlslite.HandshakeSettings.HandshakeSettings}<br>
+@param settings: Various settings which can be used to control<br>
+the ciphersuites, certificate types, and SSL/TLS versions<br>
+offered by the client.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="smtplib.html#SMTP">smtplib.SMTP</a>:<br>
+<dl><dt><a name="SMTP_TLS-__init__"><strong>__init__</strong></a>(self, host<font color="#909090">=''</font>, port<font color="#909090">=0</font>, local_hostname<font color="#909090">=None</font>, timeout<font color="#909090">=<object object></font>)</dt><dd><tt>Initialize a new instance.<br>
+ <br>
+If specified, `host' is the name of the remote host to which to<br>
+connect. If specified, `port' specifies the port to which to connect.<br>
+By default, smtplib.SMTP_PORT is used. An SMTPConnectError is raised<br>
+if the specified `host' doesn't respond correctly. If specified,<br>
+`local_hostname` is used as the FQDN of the local host. By default,<br>
+the local hostname is found using socket.getfqdn().</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-close"><strong>close</strong></a>(self)</dt><dd><tt>Close the connection to the <a href="smtplib.html#SMTP">SMTP</a> server.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-connect"><strong>connect</strong></a>(self, host<font color="#909090">='localhost'</font>, port<font color="#909090">=0</font>)</dt><dd><tt>Connect to a host on a given port.<br>
+ <br>
+If the hostname ends with a colon (`:') followed by a number, and<br>
+there is no port specified, that suffix will be stripped off and the<br>
+number interpreted as the port number to use.<br>
+ <br>
+Note: This method is automatically invoked by __init__, if a host is<br>
+specified during instantiation.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-data"><strong>data</strong></a>(self, msg)</dt><dd><tt><a href="smtplib.html#SMTP">SMTP</a> 'DATA' command -- sends message data to server.<br>
+ <br>
+Automatically quotes lines beginning with a period per rfc821.<br>
+Raises SMTPDataError if there is an unexpected reply to the<br>
+DATA command; the return value from this method is the final<br>
+response code received when the all data is sent.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-docmd"><strong>docmd</strong></a>(self, cmd, args<font color="#909090">=''</font>)</dt><dd><tt>Send a command, and return its response code.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-ehlo"><strong>ehlo</strong></a>(self, name<font color="#909090">=''</font>)</dt><dd><tt><a href="smtplib.html#SMTP">SMTP</a> 'ehlo' command.<br>
+Hostname to send for this command defaults to the FQDN of the local<br>
+host.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-ehlo_or_helo_if_needed"><strong>ehlo_or_helo_if_needed</strong></a>(self)</dt><dd><tt>Call <a href="#SMTP_TLS-ehlo_msg">ehlo</a>() and/or <a href="#SMTP_TLS-helo">helo</a>() if needed.<br>
+ <br>
+If there has been no previous EHLO or HELO command this session, this<br>
+method tries ESMTP EHLO first.<br>
+ <br>
+This method may raise the following exceptions:<br>
+ <br>
+ SMTPHeloError The server didn't reply properly to<br>
+ the helo greeting.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-expn"><strong>expn</strong></a>(self, address)</dt><dd><tt><a href="smtplib.html#SMTP">SMTP</a> 'expn' command -- expands a mailing list.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-getreply"><strong>getreply</strong></a>(self)</dt><dd><tt>Get a reply from the server.<br>
+ <br>
+Returns a tuple consisting of:<br>
+ <br>
+ - server response code (e.g. '250', or such, if all goes well)<br>
+ Note: returns -1 if it can't read response code.<br>
+ <br>
+ - server response string corresponding to response code (multiline<br>
+ responses are converted to a single, multiline string).<br>
+ <br>
+Raises SMTPServerDisconnected if end-of-file is reached.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-has_extn"><strong>has_extn</strong></a>(self, opt)</dt><dd><tt>Does the server support a given <a href="smtplib.html#SMTP">SMTP</a> service extension?</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-helo"><strong>helo</strong></a>(self, name<font color="#909090">=''</font>)</dt><dd><tt><a href="smtplib.html#SMTP">SMTP</a> 'helo' command.<br>
+Hostname to send for this command defaults to the FQDN of the local<br>
+host.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-help"><strong>help</strong></a>(self, args<font color="#909090">=''</font>)</dt><dd><tt><a href="smtplib.html#SMTP">SMTP</a> 'help' command.<br>
+Returns help text from server.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-login"><strong>login</strong></a>(self, user, password)</dt><dd><tt>Log in on an <a href="smtplib.html#SMTP">SMTP</a> server that requires authentication.<br>
+ <br>
+The arguments are:<br>
+ - user: The user name to authenticate with.<br>
+ - password: The password for the authentication.<br>
+ <br>
+If there has been no previous EHLO or HELO command this session, this<br>
+method tries ESMTP EHLO first.<br>
+ <br>
+This method will return normally if the authentication was successful.<br>
+ <br>
+This method may raise the following exceptions:<br>
+ <br>
+ SMTPHeloError The server didn't reply properly to<br>
+ the helo greeting.<br>
+ SMTPAuthenticationError The server didn't accept the username/<br>
+ password combination.<br>
+ SMTPException No suitable authentication method was<br>
+ found.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-mail"><strong>mail</strong></a>(self, sender, options<font color="#909090">=[]</font>)</dt><dd><tt><a href="smtplib.html#SMTP">SMTP</a> 'mail' command -- begins mail xfer session.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-noop"><strong>noop</strong></a>(self)</dt><dd><tt><a href="smtplib.html#SMTP">SMTP</a> 'noop' command -- doesn't do anything :></tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-putcmd"><strong>putcmd</strong></a>(self, cmd, args<font color="#909090">=''</font>)</dt><dd><tt>Send a command to the server.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-quit"><strong>quit</strong></a>(self)</dt><dd><tt>Terminate the <a href="smtplib.html#SMTP">SMTP</a> session.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-rcpt"><strong>rcpt</strong></a>(self, recip, options<font color="#909090">=[]</font>)</dt><dd><tt><a href="smtplib.html#SMTP">SMTP</a> 'rcpt' command -- indicates 1 recipient for this mail.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-rset"><strong>rset</strong></a>(self)</dt><dd><tt><a href="smtplib.html#SMTP">SMTP</a> 'rset' command -- resets session.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-send"><strong>send</strong></a>(self, str)</dt><dd><tt>Send `str' to the server.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-sendmail"><strong>sendmail</strong></a>(self, from_addr, to_addrs, msg, mail_options<font color="#909090">=[]</font>, rcpt_options<font color="#909090">=[]</font>)</dt><dd><tt>This command performs an entire mail transaction.<br>
+ <br>
+The arguments are:<br>
+ - from_addr : The address sending this mail.<br>
+ - to_addrs : A list of addresses to send this mail to. A bare<br>
+ string will be treated as a list with 1 address.<br>
+ - msg : The message to send.<br>
+ - mail_options : List of ESMTP options (such as 8bitmime) for the<br>
+ mail command.<br>
+ - rcpt_options : List of ESMTP options (such as DSN commands) for<br>
+ all the rcpt commands.<br>
+ <br>
+If there has been no previous EHLO or HELO command this session, this<br>
+method tries ESMTP EHLO first. If the server does ESMTP, message size<br>
+and each of the specified options will be passed to it. If EHLO<br>
+fails, HELO will be tried and ESMTP options suppressed.<br>
+ <br>
+This method will return normally if the mail is accepted for at least<br>
+one recipient. It returns a dictionary, with one entry for each<br>
+recipient that was refused. Each entry contains a tuple of the <a href="smtplib.html#SMTP">SMTP</a><br>
+error code and the accompanying error message sent by the server.<br>
+ <br>
+This method may raise the following exceptions:<br>
+ <br>
+ SMTPHeloError The server didn't reply properly to<br>
+ the helo greeting.<br>
+ SMTPRecipientsRefused The server rejected ALL recipients<br>
+ (no mail was sent).<br>
+ SMTPSenderRefused The server didn't accept the from_addr.<br>
+ SMTPDataError The server replied with an unexpected<br>
+ error code (other than a refusal of<br>
+ a recipient).<br>
+ <br>
+Note: the connection will be open even after an exception is raised.<br>
+ <br>
+Example:<br>
+ <br>
+ >>> import smtplib<br>
+ >>> s=smtplib.<a href="smtplib.html#SMTP">SMTP</a>("localhost")<br>
+ >>> tolist=["one@one.org","two@two.org","three@three.org","four@four.org"]<br>
+ >>> msg = '''\<br>
+ ... From: Me@my.org<br>
+ ... Subject: testin'...<br>
+ ...<br>
+ ... This is a test '''<br>
+ >>> s.<a href="#SMTP_TLS-sendmail">sendmail</a>("me@my.org",tolist,msg)<br>
+ { "three@three.org" : ( 550 ,"User unknown" ) }<br>
+ >>> s.<a href="#SMTP_TLS-quit">quit</a>()<br>
+ <br>
+In the above example, the message was accepted for delivery to three<br>
+of the four addresses, and one was rejected, with the error code<br>
+550. If all addresses are accepted, then the method will return an<br>
+empty dictionary.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-set_debuglevel"><strong>set_debuglevel</strong></a>(self, debuglevel)</dt><dd><tt>Set the debug output level.<br>
+ <br>
+A non-false value results in debug messages for connection and for all<br>
+messages sent to and received from the server.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-verify"><strong>verify</strong></a>(self, address)</dt><dd><tt><a href="smtplib.html#SMTP">SMTP</a> 'verify' command -- checks for address validity.</tt></dd></dl>
+
+<dl><dt><a name="SMTP_TLS-vrfy"><strong>vrfy</strong></a> = verify(self, address)</dt><dd><tt><a href="smtplib.html#SMTP">SMTP</a> 'verify' command -- checks for address validity.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="smtplib.html#SMTP">smtplib.SMTP</a>:<br>
+<dl><dt><strong>debuglevel</strong> = 0</dl>
+
+<dl><dt><strong>default_port</strong> = 25</dl>
+
+<dl><dt><strong>does_esmtp</strong> = 0</dl>
+
+<dl><dt><strong>ehlo_msg</strong> = 'ehlo'</dl>
+
+<dl><dt><strong>ehlo_resp</strong> = None</dl>
+
+<dl><dt><strong>file</strong> = None</dl>
+
+<dl><dt><strong>helo_resp</strong> = None</dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.TLSAsyncDispatcherMixIn.html b/pydocs/gdata.tlslite.integration.TLSAsyncDispatcherMixIn.html
new file mode 100644
index 0000000..077015c
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.TLSAsyncDispatcherMixIn.html
@@ -0,0 +1,175 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.integration.TLSAsyncDispatcherMixIn</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.integration.html"><font color="#ffffff">integration</font></a>.TLSAsyncDispatcherMixIn</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/TLSAsyncDispatcherMixIn.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/TLSAsyncDispatcherMixIn.py</a></font></td></tr></table>
+ <p><tt>TLS Lite + asyncore.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="asyncore.html">asyncore</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">gdata.tlslite.integration.AsyncStateMachine.AsyncStateMachine</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.TLSAsyncDispatcherMixIn.html#TLSAsyncDispatcherMixIn">TLSAsyncDispatcherMixIn</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSAsyncDispatcherMixIn">class <strong>TLSAsyncDispatcherMixIn</strong></a>(<a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">gdata.tlslite.integration.AsyncStateMachine.AsyncStateMachine</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class can be "mixed in" with an<br>
+L{asyncore.dispatcher} to add TLS support.<br>
+ <br>
+This class essentially sits between the dispatcher and the select<br>
+loop, intercepting events and only calling the dispatcher when<br>
+applicable.<br>
+ <br>
+In the case of <a href="#TLSAsyncDispatcherMixIn-handle_read">handle_read</a>(), a read operation will be activated,<br>
+and when it completes, the bytes will be placed in a buffer where<br>
+the dispatcher can retrieve them by calling <a href="#TLSAsyncDispatcherMixIn-recv">recv</a>(), and the<br>
+dispatcher's <a href="#TLSAsyncDispatcherMixIn-handle_read">handle_read</a>() will be called.<br>
+ <br>
+In the case of <a href="#TLSAsyncDispatcherMixIn-handle_write">handle_write</a>(), the dispatcher's <a href="#TLSAsyncDispatcherMixIn-handle_write">handle_write</a>() will<br>
+be called, and when it calls <a href="#TLSAsyncDispatcherMixIn-send">send</a>(), a write operation will be<br>
+activated.<br>
+ <br>
+To use this class, you must combine it with an asyncore.dispatcher,<br>
+and pass in a handshake operation with <a href="#TLSAsyncDispatcherMixIn-setServerHandshakeOp">setServerHandshakeOp</a>().<br>
+ <br>
+Below is an example of using this class with medusa. This class is<br>
+mixed in with http_channel to create http_tls_channel. Note:<br>
+ 1. the mix-in is listed first in the inheritance list<br>
+ <br>
+ 2. the input buffer size must be at least 16K, otherwise the<br>
+ dispatcher might not read all the bytes from the TLS layer,<br>
+ leaving some bytes in limbo.<br>
+ <br>
+ 3. IE seems to have a problem receiving a whole HTTP response in a<br>
+ single TLS record, so HTML pages containing '\r\n\r\n' won't<br>
+ be displayed on IE.<br>
+ <br>
+Add the following text into 'start_medusa.py', in the 'HTTP Server'<br>
+section::<br>
+ <br>
+ from tlslite.api import *<br>
+ s = open("./serverX509Cert.pem").read()<br>
+ x509 = X509()<br>
+ x509.parse(s)<br>
+ certChain = X509CertChain([x509])<br>
+ <br>
+ s = open("./serverX509Key.pem").read()<br>
+ privateKey = parsePEMKey(s, private=True)<br>
+ <br>
+ class http_tls_channel(<a href="#TLSAsyncDispatcherMixIn">TLSAsyncDispatcherMixIn</a>,<br>
+ http_server.http_channel):<br>
+ ac_in_buffer_size = 16384<br>
+ <br>
+ def __init__ (self, server, conn, addr):<br>
+ http_server.http_channel.<a href="#TLSAsyncDispatcherMixIn-__init__">__init__</a>(self, server, conn, addr)<br>
+ <a href="#TLSAsyncDispatcherMixIn">TLSAsyncDispatcherMixIn</a>.<a href="#TLSAsyncDispatcherMixIn-__init__">__init__</a>(self, conn)<br>
+ self.<strong>tlsConnection</strong>.ignoreAbruptClose = True<br>
+ <a href="#TLSAsyncDispatcherMixIn-setServerHandshakeOp">setServerHandshakeOp</a>(certChain=certChain,<br>
+ privateKey=privateKey)<br>
+ <br>
+ hs.channel_class = http_tls_channel<br>
+ <br>
+If the TLS layer raises an exception, the exception will be caught<br>
+in asyncore.dispatcher, which will call <a href="#TLSAsyncDispatcherMixIn-close">close</a>() on this class. The<br>
+TLS layer always closes the TLS connection before raising an<br>
+exception, so the close operation will complete right away, causing<br>
+asyncore.dispatcher.<a href="#TLSAsyncDispatcherMixIn-close">close</a>() to be called, which closes the socket<br>
+and removes this instance from the asyncore loop.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="TLSAsyncDispatcherMixIn-__init__"><strong>__init__</strong></a>(self, sock<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-close"><strong>close</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-handle_read"><strong>handle_read</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-handle_write"><strong>handle_write</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-outCloseEvent"><strong>outCloseEvent</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-outConnectEvent"><strong>outConnectEvent</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-outReadEvent"><strong>outReadEvent</strong></a>(self, readBuffer)</dt></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-outWriteEvent"><strong>outWriteEvent</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-readable"><strong>readable</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-recv"><strong>recv</strong></a>(self, bufferSize<font color="#909090">=16384</font>)</dt></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-send"><strong>send</strong></a>(self, writeBuffer)</dt></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-writable"><strong>writable</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">gdata.tlslite.integration.AsyncStateMachine.AsyncStateMachine</a>:<br>
+<dl><dt><a name="TLSAsyncDispatcherMixIn-inReadEvent"><strong>inReadEvent</strong></a>(self)</dt><dd><tt>Tell the state machine it can read from the socket.</tt></dd></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-inWriteEvent"><strong>inWriteEvent</strong></a>(self)</dt><dd><tt>Tell the state machine it can write to the socket.</tt></dd></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-setCloseOp"><strong>setCloseOp</strong></a>(self)</dt><dd><tt>Start a close operation.</tt></dd></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-setHandshakeOp"><strong>setHandshakeOp</strong></a>(self, handshaker)</dt><dd><tt>Start a handshake operation.<br>
+ <br>
+@type handshaker: generator<br>
+@param handshaker: A generator created by using one of the<br>
+asynchronous handshake functions (i.e. handshakeServerAsync, or<br>
+handshakeClientxxx(..., async=True).</tt></dd></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-setServerHandshakeOp"><strong>setServerHandshakeOp</strong></a>(self, **args)</dt><dd><tt>Start a handshake operation.<br>
+ <br>
+The arguments passed to this function will be forwarded to<br>
+L{tlslite.TLSConnection.TLSConnection.handshakeServerAsync}.</tt></dd></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-setWriteOp"><strong>setWriteOp</strong></a>(self, writeBuffer)</dt><dd><tt>Start a write operation.<br>
+ <br>
+@type writeBuffer: str<br>
+@param writeBuffer: The string to transmit.</tt></dd></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-wantsReadEvent"><strong>wantsReadEvent</strong></a>(self)</dt><dd><tt>If the state machine wants to read.<br>
+ <br>
+If an operation is active, this returns whether or not the<br>
+operation wants to read from the socket. If an operation is<br>
+not active, this returns None.<br>
+ <br>
+@rtype: bool or None<br>
+@return: If the state machine wants to read.</tt></dd></dl>
+
+<dl><dt><a name="TLSAsyncDispatcherMixIn-wantsWriteEvent"><strong>wantsWriteEvent</strong></a>(self)</dt><dd><tt>If the state machine wants to write.<br>
+ <br>
+If an operation is active, this returns whether or not the<br>
+operation wants to write to the socket. If an operation is<br>
+not active, this returns None.<br>
+ <br>
+@rtype: bool or None<br>
+@return: If the state machine wants to write.</tt></dd></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.TLSSocketServerMixIn.html b/pydocs/gdata.tlslite.integration.TLSSocketServerMixIn.html
new file mode 100644
index 0000000..8230cf9
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.TLSSocketServerMixIn.html
@@ -0,0 +1,78 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.integration.TLSSocketServerMixIn</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.integration.html"><font color="#ffffff">integration</font></a>.TLSSocketServerMixIn</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/TLSSocketServerMixIn.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/TLSSocketServerMixIn.py</a></font></td></tr></table>
+ <p><tt>TLS Lite + SocketServer.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.TLSSocketServerMixIn.html#TLSSocketServerMixIn">TLSSocketServerMixIn</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSSocketServerMixIn">class <strong>TLSSocketServerMixIn</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class can be mixed in with any L{SocketServer.TCPServer} to<br>
+add TLS support.<br>
+ <br>
+To use this class, define a new class that inherits from it and<br>
+some L{SocketServer.TCPServer} (with the mix-in first). Then<br>
+implement the <a href="#TLSSocketServerMixIn-handshake">handshake</a>() method, doing some sort of server<br>
+handshake on the connection argument. If the handshake method<br>
+returns True, the RequestHandler will be triggered. Below is a<br>
+complete example of a threaded HTTPS server::<br>
+ <br>
+ from SocketServer import *<br>
+ from BaseHTTPServer import *<br>
+ from SimpleHTTPServer import *<br>
+ from tlslite.api import *<br>
+ <br>
+ s = open("./serverX509Cert.pem").read()<br>
+ x509 = X509()<br>
+ x509.parse(s)<br>
+ certChain = X509CertChain([x509])<br>
+ <br>
+ s = open("./serverX509Key.pem").read()<br>
+ privateKey = parsePEMKey(s, private=True)<br>
+ <br>
+ sessionCache = SessionCache()<br>
+ <br>
+ class MyHTTPServer(ThreadingMixIn, <a href="#TLSSocketServerMixIn">TLSSocketServerMixIn</a>,<br>
+ HTTPServer):<br>
+ def <a href="#TLSSocketServerMixIn-handshake">handshake</a>(self, tlsConnection):<br>
+ try:<br>
+ tlsConnection.handshakeServer(certChain=certChain,<br>
+ privateKey=privateKey,<br>
+ sessionCache=sessionCache)<br>
+ tlsConnection.ignoreAbruptClose = True<br>
+ return True<br>
+ except TLSError, error:<br>
+ print "Handshake failure:", str(error)<br>
+ return False<br>
+ <br>
+ httpd = MyHTTPServer(('localhost', 443), SimpleHTTPRequestHandler)<br>
+ httpd.serve_forever()<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="TLSSocketServerMixIn-finish_request"><strong>finish_request</strong></a>(self, sock, client_address)</dt></dl>
+
+<dl><dt><a name="TLSSocketServerMixIn-handshake"><strong>handshake</strong></a>(self, tlsConnection)</dt><dd><tt>#Implement this method to do some form of handshaking. Return True<br>
+#if the handshake finishes properly and the request is authorized.</tt></dd></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.TLSTwistedProtocolWrapper.html b/pydocs/gdata.tlslite.integration.TLSTwistedProtocolWrapper.html
new file mode 100644
index 0000000..b05aa62
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.TLSTwistedProtocolWrapper.html
@@ -0,0 +1,277 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.integration.TLSTwistedProtocolWrapper</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.integration.html"><font color="#ffffff">integration</font></a>.TLSTwistedProtocolWrapper</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/TLSTwistedProtocolWrapper.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/TLSTwistedProtocolWrapper.py</a></font></td></tr></table>
+ <p><tt>TLS Lite + Twisted.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="errno.html">errno</a><br>
+</td><td width="25%" valign=top><a href="socket.html">socket</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">gdata.tlslite.integration.AsyncStateMachine.AsyncStateMachine</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.TLSTwistedProtocolWrapper.html#TLSTwistedProtocolWrapper">TLSTwistedProtocolWrapper</a>(<a href="twisted.protocols.policies.html#ProtocolWrapper">twisted.protocols.policies.ProtocolWrapper</a>, <a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">gdata.tlslite.integration.AsyncStateMachine.AsyncStateMachine</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="twisted.protocols.policies.html#ProtocolWrapper">twisted.protocols.policies.ProtocolWrapper</a>(<a href="twisted.internet.protocol.html#Protocol">twisted.internet.protocol.Protocol</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.TLSTwistedProtocolWrapper.html#TLSTwistedProtocolWrapper">TLSTwistedProtocolWrapper</a>(<a href="twisted.protocols.policies.html#ProtocolWrapper">twisted.protocols.policies.ProtocolWrapper</a>, <a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">gdata.tlslite.integration.AsyncStateMachine.AsyncStateMachine</a>)
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TLSTwistedProtocolWrapper">class <strong>TLSTwistedProtocolWrapper</strong></a>(<a href="twisted.protocols.policies.html#ProtocolWrapper">twisted.protocols.policies.ProtocolWrapper</a>, <a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">gdata.tlslite.integration.AsyncStateMachine.AsyncStateMachine</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This class can wrap Twisted protocols to add TLS support.<br>
+ <br>
+Below is a complete example of using TLS Lite with a Twisted echo<br>
+server.<br>
+ <br>
+There are two server implementations below. Echo is the original<br>
+protocol, which is oblivious to TLS. Echo1 subclasses Echo and<br>
+negotiates TLS when the client connects. Echo2 subclasses Echo and<br>
+negotiates TLS when the client sends "STARTTLS"::<br>
+ <br>
+ from twisted.internet.protocol import Protocol, Factory<br>
+ from twisted.internet import reactor<br>
+ from twisted.protocols.policies import WrappingFactory<br>
+ from twisted.protocols.basic import LineReceiver<br>
+ from twisted.python import log<br>
+ from twisted.python.failure import Failure<br>
+ import sys<br>
+ from tlslite.api import *<br>
+ <br>
+ s = open("./serverX509Cert.pem").read()<br>
+ x509 = X509()<br>
+ x509.parse(s)<br>
+ certChain = X509CertChain([x509])<br>
+ <br>
+ s = open("./serverX509Key.pem").read()<br>
+ privateKey = parsePEMKey(s, private=True)<br>
+ <br>
+ verifierDB = VerifierDB("verifierDB")<br>
+ verifierDB.open()<br>
+ <br>
+ class Echo(LineReceiver):<br>
+ def <a href="#TLSTwistedProtocolWrapper-connectionMade">connectionMade</a>(self):<br>
+ self.<strong>transport</strong>.<a href="#TLSTwistedProtocolWrapper-write">write</a>("Welcome to the echo server!\r\n")<br>
+ <br>
+ def lineReceived(self, line):<br>
+ self.<strong>transport</strong>.<a href="#TLSTwistedProtocolWrapper-write">write</a>(line + "\r\n")<br>
+ <br>
+ class Echo1(Echo):<br>
+ def <a href="#TLSTwistedProtocolWrapper-connectionMade">connectionMade</a>(self):<br>
+ if not self.<strong>transport</strong>.tlsStarted:<br>
+ self.<strong>transport</strong>.<a href="#TLSTwistedProtocolWrapper-setServerHandshakeOp">setServerHandshakeOp</a>(certChain=certChain,<br>
+ privateKey=privateKey,<br>
+ verifierDB=verifierDB)<br>
+ else:<br>
+ Echo.<a href="#TLSTwistedProtocolWrapper-connectionMade">connectionMade</a>(self)<br>
+ <br>
+ def <a href="#TLSTwistedProtocolWrapper-connectionLost">connectionLost</a>(self, reason):<br>
+ pass #Handle any TLS exceptions here<br>
+ <br>
+ class Echo2(Echo):<br>
+ def lineReceived(self, data):<br>
+ if data == "STARTTLS":<br>
+ self.<strong>transport</strong>.<a href="#TLSTwistedProtocolWrapper-setServerHandshakeOp">setServerHandshakeOp</a>(certChain=certChain,<br>
+ privateKey=privateKey,<br>
+ verifierDB=verifierDB)<br>
+ else:<br>
+ Echo.lineReceived(self, data)<br>
+ <br>
+ def <a href="#TLSTwistedProtocolWrapper-connectionLost">connectionLost</a>(self, reason):<br>
+ pass #Handle any TLS exceptions here<br>
+ <br>
+ factory = Factory()<br>
+ factory.protocol = Echo1<br>
+ #factory.protocol = Echo2<br>
+ <br>
+ wrappingFactory = WrappingFactory(factory)<br>
+ wrappingFactory.protocol = <a href="#TLSTwistedProtocolWrapper">TLSTwistedProtocolWrapper</a><br>
+ <br>
+ log.startLogging(sys.stdout)<br>
+ reactor.listenTCP(1079, wrappingFactory)<br>
+ reactor.run()<br>
+ <br>
+This class works as follows:<br>
+ <br>
+Data comes in and is given to the <a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">AsyncStateMachine</a> for handling.<br>
+<a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">AsyncStateMachine</a> will forward events to this class, and we'll<br>
+pass them on to the ProtocolHandler, which will proxy them to the<br>
+wrapped protocol. The wrapped protocol may then call back into<br>
+this class, and these calls will be proxied into the<br>
+<a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">AsyncStateMachine</a>.<br>
+ <br>
+The call graph looks like this:<br>
+ - self.<strong>dataReceived</strong><br>
+ - <a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">AsyncStateMachine</a>.inReadEvent<br>
+ - out(Connect|Close|Read)Event<br>
+ - <a href="twisted.protocols.policies.html#ProtocolWrapper">ProtocolWrapper</a>.(connectionMade|loseConnection|dataReceived)<br>
+ - self.(loseConnection|write|writeSequence)<br>
+ - <a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">AsyncStateMachine</a>.(setCloseOp|setWriteOp)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.integration.TLSTwistedProtocolWrapper.html#TLSTwistedProtocolWrapper">TLSTwistedProtocolWrapper</a></dd>
+<dd><a href="twisted.protocols.policies.html#ProtocolWrapper">twisted.protocols.policies.ProtocolWrapper</a></dd>
+<dd><a href="twisted.internet.protocol.html#Protocol">twisted.internet.protocol.Protocol</a></dd>
+<dd><a href="twisted.internet.protocol.html#BaseProtocol">twisted.internet.protocol.BaseProtocol</a></dd>
+<dd><a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">gdata.tlslite.integration.AsyncStateMachine.AsyncStateMachine</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="TLSTwistedProtocolWrapper-__init__"><strong>__init__</strong></a>(self, factory, wrappedProtocol)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-connectionLost"><strong>connectionLost</strong></a>(self, reason)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-connectionMade"><strong>connectionMade</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-dataReceived"><strong>dataReceived</strong></a>(self, data)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-loseConnection"><strong>loseConnection</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-outCloseEvent"><strong>outCloseEvent</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-outConnectEvent"><strong>outConnectEvent</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-outReadEvent"><strong>outReadEvent</strong></a>(self, data)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-setServerHandshakeOp"><strong>setServerHandshakeOp</strong></a>(self, **args)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-write"><strong>write</strong></a>(self, data)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-writeSequence"><strong>writeSequence</strong></a>(self, seq)</dt></dl>
+
+<hr>
+Methods inherited from <a href="twisted.protocols.policies.html#ProtocolWrapper">twisted.protocols.policies.ProtocolWrapper</a>:<br>
+<dl><dt><a name="TLSTwistedProtocolWrapper-__getattr__"><strong>__getattr__</strong></a>(self, name)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-getHost"><strong>getHost</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-getPeer"><strong>getPeer</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-logPrefix"><strong>logPrefix</strong></a>(self)</dt><dd><tt>Use a customized log prefix mentioning both the wrapped protocol and<br>
+the current one.</tt></dd></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-makeConnection"><strong>makeConnection</strong></a>(self, transport)</dt><dd><tt>When a connection is made, register this wrapper with its factory,<br>
+save the real transport, and connect the wrapped protocol to this<br>
+L{<a href="twisted.protocols.policies.html#ProtocolWrapper">ProtocolWrapper</a>} to intercept any transport calls it makes.</tt></dd></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-registerProducer"><strong>registerProducer</strong></a>(self, producer, streaming)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-stopConsuming"><strong>stopConsuming</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-unregisterProducer"><strong>unregisterProducer</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="twisted.protocols.policies.html#ProtocolWrapper">twisted.protocols.policies.ProtocolWrapper</a>:<br>
+<dl><dt><strong>disconnecting</strong> = 0</dl>
+
+<hr>
+Methods inherited from <a href="twisted.internet.protocol.html#Protocol">twisted.internet.protocol.Protocol</a>:<br>
+<dl><dt><strong>__provides__</strong></dt>
+<dd><tt>Special descriptor for class __provides__<br>
+ <br>
+The descriptor caches the implementedBy info, so that<br>
+we can get declarations for objects without instance-specific<br>
+interfaces a bit quicker.<br>
+ <br>
+For example:<br>
+ <br>
+ >>> from zope.interface import Interface<br>
+ >>> class IFooFactory(Interface):<br>
+ ... pass<br>
+ >>> class IFoo(Interface):<br>
+ ... pass<br>
+ >>> class C(object):<br>
+ ... implements(IFoo)<br>
+ ... classProvides(IFooFactory)<br>
+ >>> [i.getName() for i in C.__provides__]<br>
+ ['IFooFactory']<br>
+ <br>
+ >>> [i.getName() for i in C().__provides__]<br>
+ ['IFoo']</tt></dd>
+</dl>
+
+<hr>
+Data and other attributes inherited from <a href="twisted.internet.protocol.html#Protocol">twisted.internet.protocol.Protocol</a>:<br>
+<dl><dt><strong>__implemented__</strong> = <implementedBy twisted.internet.protocol.Protocol></dl>
+
+<hr>
+Methods inherited from <a href="twisted.internet.protocol.html#BaseProtocol">twisted.internet.protocol.BaseProtocol</a>:<br>
+<strong>__providedBy__</strong> = <zope.interface.declarations.Declaration object>
+<hr>
+Data and other attributes inherited from <a href="twisted.internet.protocol.html#BaseProtocol">twisted.internet.protocol.BaseProtocol</a>:<br>
+<dl><dt><strong>connected</strong> = 0</dl>
+
+<dl><dt><strong>transport</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.integration.AsyncStateMachine.html#AsyncStateMachine">gdata.tlslite.integration.AsyncStateMachine.AsyncStateMachine</a>:<br>
+<dl><dt><a name="TLSTwistedProtocolWrapper-inReadEvent"><strong>inReadEvent</strong></a>(self)</dt><dd><tt>Tell the state machine it can read from the socket.</tt></dd></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-inWriteEvent"><strong>inWriteEvent</strong></a>(self)</dt><dd><tt>Tell the state machine it can write to the socket.</tt></dd></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-outWriteEvent"><strong>outWriteEvent</strong></a>(self)</dt><dd><tt>Called when a write operation completes.<br>
+ <br>
+May be overridden in subclass.</tt></dd></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-setCloseOp"><strong>setCloseOp</strong></a>(self)</dt><dd><tt>Start a close operation.</tt></dd></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-setHandshakeOp"><strong>setHandshakeOp</strong></a>(self, handshaker)</dt><dd><tt>Start a handshake operation.<br>
+ <br>
+@type handshaker: generator<br>
+@param handshaker: A generator created by using one of the<br>
+asynchronous handshake functions (i.e. handshakeServerAsync, or<br>
+handshakeClientxxx(..., async=True).</tt></dd></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-setWriteOp"><strong>setWriteOp</strong></a>(self, writeBuffer)</dt><dd><tt>Start a write operation.<br>
+ <br>
+@type writeBuffer: str<br>
+@param writeBuffer: The string to transmit.</tt></dd></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-wantsReadEvent"><strong>wantsReadEvent</strong></a>(self)</dt><dd><tt>If the state machine wants to read.<br>
+ <br>
+If an operation is active, this returns whether or not the<br>
+operation wants to read from the socket. If an operation is<br>
+not active, this returns None.<br>
+ <br>
+@rtype: bool or None<br>
+@return: If the state machine wants to read.</tt></dd></dl>
+
+<dl><dt><a name="TLSTwistedProtocolWrapper-wantsWriteEvent"><strong>wantsWriteEvent</strong></a>(self)</dt><dd><tt>If the state machine wants to write.<br>
+ <br>
+If an operation is active, this returns whether or not the<br>
+operation wants to write to the socket. If an operation is<br>
+not active, this returns None.<br>
+ <br>
+@rtype: bool or None<br>
+@return: If the state machine wants to write.</tt></dd></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.XMLRPCTransport.html b/pydocs/gdata.tlslite.integration.XMLRPCTransport.html
new file mode 100644
index 0000000..152059b
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.XMLRPCTransport.html
@@ -0,0 +1,187 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.integration.XMLRPCTransport</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.integration.html"><font color="#ffffff">integration</font></a>.XMLRPCTransport</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/XMLRPCTransport.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/XMLRPCTransport.py</a></font></td></tr></table>
+ <p><tt>TLS Lite + xmlrpclib.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="httplib.html">httplib</a><br>
+</td><td width="25%" valign=top><a href="xmlrpclib.html">xmlrpclib</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.XMLRPCTransport.html#XMLRPCTransport">XMLRPCTransport</a>(<a href="xmlrpclib.html#Transport">xmlrpclib.Transport</a>, <a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="xmlrpclib.html#Transport">xmlrpclib.Transport</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.integration.XMLRPCTransport.html#XMLRPCTransport">XMLRPCTransport</a>(<a href="xmlrpclib.html#Transport">xmlrpclib.Transport</a>, <a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>)
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="XMLRPCTransport">class <strong>XMLRPCTransport</strong></a>(<a href="xmlrpclib.html#Transport">xmlrpclib.Transport</a>, <a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Handles an HTTPS transaction to an XML-RPC server.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.integration.XMLRPCTransport.html#XMLRPCTransport">XMLRPCTransport</a></dd>
+<dd><a href="xmlrpclib.html#Transport">xmlrpclib.Transport</a></dd>
+<dd><a href="gdata.tlslite.integration.ClientHelper.html#ClientHelper">gdata.tlslite.integration.ClientHelper.ClientHelper</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="XMLRPCTransport-__init__"><strong>__init__</strong></a>(self, username<font color="#909090">=None</font>, password<font color="#909090">=None</font>, sharedKey<font color="#909090">=None</font>, certChain<font color="#909090">=None</font>, privateKey<font color="#909090">=None</font>, cryptoID<font color="#909090">=None</font>, protocol<font color="#909090">=None</font>, x509Fingerprint<font color="#909090">=None</font>, x509TrustList<font color="#909090">=None</font>, x509CommonName<font color="#909090">=None</font>, settings<font color="#909090">=None</font>)</dt><dd><tt>Create a new <a href="#XMLRPCTransport">XMLRPCTransport</a>.<br>
+ <br>
+An instance of this class can be passed to L{xmlrpclib.ServerProxy}<br>
+to use TLS with XML-RPC calls::<br>
+ <br>
+ from tlslite.api import <a href="#XMLRPCTransport">XMLRPCTransport</a><br>
+ from xmlrpclib import ServerProxy<br>
+ <br>
+ transport = <a href="#XMLRPCTransport">XMLRPCTransport</a>(user="alice", password="abra123")<br>
+ server = ServerProxy("https://localhost", transport)<br>
+ <br>
+For client authentication, use one of these argument<br>
+combinations:<br>
+ - username, password (SRP)<br>
+ - username, sharedKey (shared-key)<br>
+ - certChain, privateKey (certificate)<br>
+ <br>
+For server authentication, you can either rely on the<br>
+implicit mutual authentication performed by SRP or<br>
+shared-keys, or you can do certificate-based server<br>
+authentication with one of these argument combinations:<br>
+ - cryptoID[, protocol] (requires cryptoIDlib)<br>
+ - x509Fingerprint<br>
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)<br>
+ <br>
+Certificate-based server authentication is compatible with<br>
+SRP or certificate-based client authentication. It is<br>
+not compatible with shared-keys.<br>
+ <br>
+The constructor does not perform the TLS handshake itself, but<br>
+simply stores these arguments for later. The handshake is<br>
+performed only when this class needs to connect with the<br>
+server. Thus you should be prepared to handle TLS-specific<br>
+exceptions when calling methods of L{xmlrpclib.ServerProxy}. See the<br>
+client handshake functions in<br>
+L{tlslite.TLSConnection.TLSConnection} for details on which<br>
+exceptions might be raised.<br>
+ <br>
+@type username: str<br>
+@param username: SRP or shared-key username. Requires the<br>
+'password' or 'sharedKey' argument.<br>
+ <br>
+@type password: str<br>
+@param password: SRP password for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type sharedKey: str<br>
+@param sharedKey: Shared key for mutual authentication.<br>
+Requires the 'username' argument.<br>
+ <br>
+@type certChain: L{tlslite.X509CertChain.X509CertChain} or<br>
+L{cryptoIDlib.CertChain.CertChain}<br>
+@param certChain: Certificate chain for client authentication.<br>
+Requires the 'privateKey' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type privateKey: L{tlslite.utils.RSAKey.RSAKey}<br>
+@param privateKey: Private key for client authentication.<br>
+Requires the 'certChain' argument. Excludes the SRP or<br>
+shared-key related arguments.<br>
+ <br>
+@type cryptoID: str<br>
+@param cryptoID: cryptoID for server authentication. Mutually<br>
+exclusive with the 'x509...' arguments.<br>
+ <br>
+@type protocol: str<br>
+@param protocol: cryptoID protocol URI for server<br>
+authentication. Requires the 'cryptoID' argument.<br>
+ <br>
+@type x509Fingerprint: str<br>
+@param x509Fingerprint: Hex-encoded X.509 fingerprint for<br>
+server authentication. Mutually exclusive with the 'cryptoID'<br>
+and 'x509TrustList' arguments.<br>
+ <br>
+@type x509TrustList: list of L{tlslite.X509.X509}<br>
+@param x509TrustList: A list of trusted root certificates. The<br>
+other party must present a certificate chain which extends to<br>
+one of these root certificates. The cryptlib_py module must be<br>
+installed to use this parameter. Mutually exclusive with the<br>
+'cryptoID' and 'x509Fingerprint' arguments.<br>
+ <br>
+@type x509CommonName: str<br>
+@param x509CommonName: The end-entity certificate's 'CN' field<br>
+must match this value. For a web server, this is typically a<br>
+server name such as 'www.amazon.com'. Mutually exclusive with<br>
+the 'cryptoID' and 'x509Fingerprint' arguments. Requires the<br>
+'x509TrustList' argument.<br>
+ <br>
+@type settings: L{tlslite.HandshakeSettings.HandshakeSettings}<br>
+@param settings: Various settings which can be used to control<br>
+the ciphersuites, certificate types, and SSL/TLS versions<br>
+offered by the client.</tt></dd></dl>
+
+<dl><dt><a name="XMLRPCTransport-make_connection"><strong>make_connection</strong></a>(self, host)</dt></dl>
+
+<hr>
+Methods inherited from <a href="xmlrpclib.html#Transport">xmlrpclib.Transport</a>:<br>
+<dl><dt><a name="XMLRPCTransport-close"><strong>close</strong></a>(self)</dt><dd><tt>##<br>
+# Clear any cached connection object.<br>
+# Used in the event of socket errors.</tt></dd></dl>
+
+<dl><dt><a name="XMLRPCTransport-get_host_info"><strong>get_host_info</strong></a>(self, host)</dt></dl>
+
+<dl><dt><a name="XMLRPCTransport-getparser"><strong>getparser</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="XMLRPCTransport-parse_response"><strong>parse_response</strong></a>(self, response)</dt></dl>
+
+<dl><dt><a name="XMLRPCTransport-request"><strong>request</strong></a>(self, host, handler, request_body, verbose<font color="#909090">=0</font>)</dt></dl>
+
+<dl><dt><a name="XMLRPCTransport-send_content"><strong>send_content</strong></a>(self, connection, request_body)</dt></dl>
+
+<dl><dt><a name="XMLRPCTransport-send_host"><strong>send_host</strong></a>(self, connection, host)</dt></dl>
+
+<dl><dt><a name="XMLRPCTransport-send_request"><strong>send_request</strong></a>(self, connection, handler, request_body)</dt></dl>
+
+<dl><dt><a name="XMLRPCTransport-send_user_agent"><strong>send_user_agent</strong></a>(self, connection)</dt></dl>
+
+<dl><dt><a name="XMLRPCTransport-single_request"><strong>single_request</strong></a>(self, host, handler, request_body, verbose<font color="#909090">=0</font>)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="xmlrpclib.html#Transport">xmlrpclib.Transport</a>:<br>
+<dl><dt><strong>accept_gzip_encoding</strong> = True</dl>
+
+<dl><dt><strong>encode_threshold</strong> = None</dl>
+
+<dl><dt><strong>user_agent</strong> = 'xmlrpclib.py/1.0.1 (by www.pythonware.com)'</dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.integration.html b/pydocs/gdata.tlslite.integration.html
new file mode 100644
index 0000000..1a7ec1c
--- /dev/null
+++ b/pydocs/gdata.tlslite.integration.html
@@ -0,0 +1,39 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.tlslite.integration</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.integration</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/integration/__init__.py</a></font></td></tr></table>
+ <p><tt>Classes for integrating TLS Lite with other packages.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.tlslite.integration.AsyncStateMachine.html">AsyncStateMachine</a><br>
+<a href="gdata.tlslite.integration.ClientHelper.html">ClientHelper</a><br>
+<a href="gdata.tlslite.integration.HTTPTLSConnection.html">HTTPTLSConnection</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.integration.IMAP4_TLS.html">IMAP4_TLS</a><br>
+<a href="gdata.tlslite.integration.IntegrationHelper.html">IntegrationHelper</a><br>
+<a href="gdata.tlslite.integration.POP3_TLS.html">POP3_TLS</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.integration.SMTP_TLS.html">SMTP_TLS</a><br>
+<a href="gdata.tlslite.integration.TLSAsyncDispatcherMixIn.html">TLSAsyncDispatcherMixIn</a><br>
+<a href="gdata.tlslite.integration.TLSSocketServerMixIn.html">TLSSocketServerMixIn</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.integration.TLSTwistedProtocolWrapper.html">TLSTwistedProtocolWrapper</a><br>
+<a href="gdata.tlslite.integration.XMLRPCTransport.html">XMLRPCTransport</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__all__</strong> = ['AsyncStateMachine', 'HTTPTLSConnection', 'POP3_TLS', 'IMAP4_TLS', 'SMTP_TLS', 'XMLRPCTransport', 'TLSSocketServerMixIn', 'TLSAsyncDispatcherMixIn', 'TLSTwistedProtocolWrapper']</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.mathtls.html b/pydocs/gdata.tlslite.mathtls.html
new file mode 100644
index 0000000..b78a93f
--- /dev/null
+++ b/pydocs/gdata.tlslite.mathtls.html
@@ -0,0 +1,103 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.mathtls</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.mathtls</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/mathtls.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/mathtls.py</a></font></td></tr></table>
+ <p><tt>Miscellaneous helper functions.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+<a href="base64.html">base64</a><br>
+</td><td width="25%" valign=top><a href="binascii.html">binascii</a><br>
+<a href="hmac.html">hmac</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="md5.html">md5</a><br>
+<a href="os.html">os</a><br>
+<a href="sha.html">sha</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.mathtls.html#MAC_SSL">MAC_SSL</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MAC_SSL">class <strong>MAC_SSL</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#MAC_SSL">MAC_SSL</a> class.<br>
+ <br>
+This supports the API for Cryptographic Hash Functions (<a href="http://www.python.org/dev/peps/pep-0247/">PEP 247</a>).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="MAC_SSL-__init__"><strong>__init__</strong></a>(self, key, msg<font color="#909090">=None</font>, digestmod<font color="#909090">=None</font>)</dt><dd><tt>Create a new <a href="#MAC_SSL">MAC_SSL</a> object.<br>
+ <br>
+key: key for the keyed hash object.<br>
+msg: Initial input for the hash, if provided.<br>
+digestmod: A module supporting <a href="http://www.python.org/dev/peps/pep-0247/">PEP 247</a>. Defaults to the md5 module.</tt></dd></dl>
+
+<dl><dt><a name="MAC_SSL-copy"><strong>copy</strong></a>(self)</dt><dd><tt>Return a separate copy of this hashing object.<br>
+ <br>
+An update to this copy won't affect the original object.</tt></dd></dl>
+
+<dl><dt><a name="MAC_SSL-digest"><strong>digest</strong></a>(self)</dt><dd><tt>Return the hash value of this hashing object.<br>
+ <br>
+This returns a string containing 8-bit data. The object is<br>
+not altered in any way by this function; you can continue<br>
+updating the object after calling this function.</tt></dd></dl>
+
+<dl><dt><a name="MAC_SSL-hexdigest"><strong>hexdigest</strong></a>(self)</dt><dd><tt>Like <a href="#MAC_SSL-digest">digest</a>(), but returns a string of hexadecimal digits instead.</tt></dd></dl>
+
+<dl><dt><a name="MAC_SSL-update"><strong>update</strong></a>(self, msg)</dt><dd><tt>Update this hashing object with the string msg.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-PAD"><strong>PAD</strong></a>(n, x)</dt></dl>
+ <dl><dt><a name="-PRF"><strong>PRF</strong></a>(secret, label, seed, length)</dt></dl>
+ <dl><dt><a name="-PRF_SSL"><strong>PRF_SSL</strong></a>(secret, seed, length)</dt></dl>
+ <dl><dt><a name="-P_hash"><strong>P_hash</strong></a>(hashModule, secret, seed, length)</dt></dl>
+ <dl><dt><a name="-makeK"><strong>makeK</strong></a>(N, g)</dt></dl>
+ <dl><dt><a name="-makeU"><strong>makeU</strong></a>(N, A, B)</dt></dl>
+ <dl><dt><a name="-makeVerifier"><strong>makeVerifier</strong></a>(username, password, bits)</dt><dd><tt>#This function is used by VerifierDB.makeVerifier</tt></dd></dl>
+ <dl><dt><a name="-makeX"><strong>makeX</strong></a>(salt, username, password)</dt></dl>
+ <dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>goodGroupParameters</strong> = [(2, 167609434410335061...389658897350067939L), (2, 148699818592312829...022696100064262587L), (2, 217661744586174357...299250924469288819L), (2, 580960599536995806...769998514148343807L), (5, 104438888141315250...045385534758453247L), (5, 337515218214385611...109988915707117567L), (5, 109074813561941592...353154294858383359L)]<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.messages.html b/pydocs/gdata.tlslite.messages.html
new file mode 100644
index 0000000..a6bd662
--- /dev/null
+++ b/pydocs/gdata.tlslite.messages.html
@@ -0,0 +1,478 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.messages</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.messages</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/messages.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/messages.py</a></font></td></tr></table>
+ <p><tt>Classes representing TLS messages.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+<a href="base64.html">base64</a><br>
+</td><td width="25%" valign=top><a href="binascii.html">binascii</a><br>
+<a href="math.html">math</a><br>
+<a href="md5.html">md5</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="sha.html">sha</a><br>
+<a href="sys.html">sys</a><br>
+</td><td width="25%" valign=top><a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#Msg">Msg</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#Alert">Alert</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#ApplicationData">ApplicationData</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#ChangeCipherSpec">ChangeCipherSpec</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#Certificate">Certificate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#CertificateRequest">CertificateRequest</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#CertificateVerify">CertificateVerify</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#ClientHello">ClientHello</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#ClientKeyExchange">ClientKeyExchange</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#Finished">Finished</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#ServerHello">ServerHello</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#ServerHelloDone">ServerHelloDone</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#ServerKeyExchange">ServerKeyExchange</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#RecordHeader2">RecordHeader2</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.messages.html#RecordHeader3">RecordHeader3</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Alert">class <strong>Alert</strong></a>(<a href="gdata.tlslite.messages.html#Msg">Msg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Alert-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Alert-create"><strong>create</strong></a>(self, description, level<font color="#909090">=2</font>)</dt></dl>
+
+<dl><dt><a name="Alert-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="Alert-write"><strong>write</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="Alert-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+<dl><dt><a name="Alert-preWrite"><strong>preWrite</strong></a>(self, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ApplicationData">class <strong>ApplicationData</strong></a>(<a href="gdata.tlslite.messages.html#Msg">Msg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="ApplicationData-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ApplicationData-create"><strong>create</strong></a>(self, bytes)</dt></dl>
+
+<dl><dt><a name="ApplicationData-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="ApplicationData-write"><strong>write</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="ApplicationData-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+<dl><dt><a name="ApplicationData-preWrite"><strong>preWrite</strong></a>(self, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Certificate">class <strong>Certificate</strong></a>(<a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.messages.html#Certificate">Certificate</a></dd>
+<dd><a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a></dd>
+<dd><a href="gdata.tlslite.messages.html#Msg">Msg</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Certificate-__init__"><strong>__init__</strong></a>(self, certificateType)</dt></dl>
+
+<dl><dt><a name="Certificate-create"><strong>create</strong></a>(self, certChain)</dt></dl>
+
+<dl><dt><a name="Certificate-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="Certificate-write"><strong>write</strong></a>(self, trial<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>:<br>
+<dl><dt><a name="Certificate-preWrite"><strong>preWrite</strong></a>(self, handshakeType, trial)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="Certificate-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CertificateRequest">class <strong>CertificateRequest</strong></a>(<a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.messages.html#CertificateRequest">CertificateRequest</a></dd>
+<dd><a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a></dd>
+<dd><a href="gdata.tlslite.messages.html#Msg">Msg</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CertificateRequest-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CertificateRequest-create"><strong>create</strong></a>(self, certificate_types, certificate_authorities)</dt></dl>
+
+<dl><dt><a name="CertificateRequest-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="CertificateRequest-write"><strong>write</strong></a>(self, trial<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>:<br>
+<dl><dt><a name="CertificateRequest-preWrite"><strong>preWrite</strong></a>(self, handshakeType, trial)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="CertificateRequest-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CertificateVerify">class <strong>CertificateVerify</strong></a>(<a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.messages.html#CertificateVerify">CertificateVerify</a></dd>
+<dd><a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a></dd>
+<dd><a href="gdata.tlslite.messages.html#Msg">Msg</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="CertificateVerify-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CertificateVerify-create"><strong>create</strong></a>(self, signature)</dt></dl>
+
+<dl><dt><a name="CertificateVerify-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="CertificateVerify-write"><strong>write</strong></a>(self, trial<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>:<br>
+<dl><dt><a name="CertificateVerify-preWrite"><strong>preWrite</strong></a>(self, handshakeType, trial)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="CertificateVerify-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ChangeCipherSpec">class <strong>ChangeCipherSpec</strong></a>(<a href="gdata.tlslite.messages.html#Msg">Msg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="ChangeCipherSpec-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeCipherSpec-create"><strong>create</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChangeCipherSpec-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="ChangeCipherSpec-write"><strong>write</strong></a>(self, trial<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="ChangeCipherSpec-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+<dl><dt><a name="ChangeCipherSpec-preWrite"><strong>preWrite</strong></a>(self, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ClientHello">class <strong>ClientHello</strong></a>(<a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.messages.html#ClientHello">ClientHello</a></dd>
+<dd><a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a></dd>
+<dd><a href="gdata.tlslite.messages.html#Msg">Msg</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ClientHello-__init__"><strong>__init__</strong></a>(self, ssl2<font color="#909090">=False</font>)</dt></dl>
+
+<dl><dt><a name="ClientHello-create"><strong>create</strong></a>(self, version, random, session_id, cipher_suites, certificate_types<font color="#909090">=None</font>, srp_username<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ClientHello-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="ClientHello-write"><strong>write</strong></a>(self, trial<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>:<br>
+<dl><dt><a name="ClientHello-preWrite"><strong>preWrite</strong></a>(self, handshakeType, trial)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="ClientHello-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ClientKeyExchange">class <strong>ClientKeyExchange</strong></a>(<a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.messages.html#ClientKeyExchange">ClientKeyExchange</a></dd>
+<dd><a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a></dd>
+<dd><a href="gdata.tlslite.messages.html#Msg">Msg</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ClientKeyExchange-__init__"><strong>__init__</strong></a>(self, cipherSuite, version<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="ClientKeyExchange-createRSA"><strong>createRSA</strong></a>(self, encryptedPreMasterSecret)</dt></dl>
+
+<dl><dt><a name="ClientKeyExchange-createSRP"><strong>createSRP</strong></a>(self, srp_A)</dt></dl>
+
+<dl><dt><a name="ClientKeyExchange-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="ClientKeyExchange-write"><strong>write</strong></a>(self, trial<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>:<br>
+<dl><dt><a name="ClientKeyExchange-preWrite"><strong>preWrite</strong></a>(self, handshakeType, trial)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="ClientKeyExchange-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Finished">class <strong>Finished</strong></a>(<a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.messages.html#Finished">Finished</a></dd>
+<dd><a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a></dd>
+<dd><a href="gdata.tlslite.messages.html#Msg">Msg</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Finished-__init__"><strong>__init__</strong></a>(self, version)</dt></dl>
+
+<dl><dt><a name="Finished-create"><strong>create</strong></a>(self, verify_data)</dt></dl>
+
+<dl><dt><a name="Finished-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="Finished-write"><strong>write</strong></a>(self, trial<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>:<br>
+<dl><dt><a name="Finished-preWrite"><strong>preWrite</strong></a>(self, handshakeType, trial)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="Finished-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HandshakeMsg">class <strong>HandshakeMsg</strong></a>(<a href="gdata.tlslite.messages.html#Msg">Msg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="HandshakeMsg-preWrite"><strong>preWrite</strong></a>(self, handshakeType, trial)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="HandshakeMsg-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Msg">class <strong>Msg</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Msg-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+<dl><dt><a name="Msg-preWrite"><strong>preWrite</strong></a>(self, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RecordHeader2">class <strong>RecordHeader2</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="RecordHeader2-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordHeader2-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RecordHeader3">class <strong>RecordHeader3</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="RecordHeader3-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RecordHeader3-create"><strong>create</strong></a>(self, version, type, length)</dt></dl>
+
+<dl><dt><a name="RecordHeader3-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="RecordHeader3-write"><strong>write</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ServerHello">class <strong>ServerHello</strong></a>(<a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.messages.html#ServerHello">ServerHello</a></dd>
+<dd><a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a></dd>
+<dd><a href="gdata.tlslite.messages.html#Msg">Msg</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ServerHello-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ServerHello-create"><strong>create</strong></a>(self, version, random, session_id, cipher_suite, certificate_type)</dt></dl>
+
+<dl><dt><a name="ServerHello-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="ServerHello-write"><strong>write</strong></a>(self, trial<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>:<br>
+<dl><dt><a name="ServerHello-preWrite"><strong>preWrite</strong></a>(self, handshakeType, trial)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="ServerHello-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ServerHelloDone">class <strong>ServerHelloDone</strong></a>(<a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.messages.html#ServerHelloDone">ServerHelloDone</a></dd>
+<dd><a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a></dd>
+<dd><a href="gdata.tlslite.messages.html#Msg">Msg</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ServerHelloDone-__init__"><strong>__init__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ServerHelloDone-create"><strong>create</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ServerHelloDone-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="ServerHelloDone-write"><strong>write</strong></a>(self, trial<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>:<br>
+<dl><dt><a name="ServerHelloDone-preWrite"><strong>preWrite</strong></a>(self, handshakeType, trial)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="ServerHelloDone-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ServerKeyExchange">class <strong>ServerKeyExchange</strong></a>(<a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.tlslite.messages.html#ServerKeyExchange">ServerKeyExchange</a></dd>
+<dd><a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a></dd>
+<dd><a href="gdata.tlslite.messages.html#Msg">Msg</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="ServerKeyExchange-__init__"><strong>__init__</strong></a>(self, cipherSuite)</dt></dl>
+
+<dl><dt><a name="ServerKeyExchange-createSRP"><strong>createSRP</strong></a>(self, srp_N, srp_g, srp_s, srp_B)</dt></dl>
+
+<dl><dt><a name="ServerKeyExchange-hash"><strong>hash</strong></a>(self, clientRandom, serverRandom)</dt></dl>
+
+<dl><dt><a name="ServerKeyExchange-parse"><strong>parse</strong></a>(self, p)</dt></dl>
+
+<dl><dt><a name="ServerKeyExchange-write"><strong>write</strong></a>(self, trial<font color="#909090">=False</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#HandshakeMsg">HandshakeMsg</a>:<br>
+<dl><dt><a name="ServerKeyExchange-preWrite"><strong>preWrite</strong></a>(self, handshakeType, trial)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.messages.html#Msg">Msg</a>:<br>
+<dl><dt><a name="ServerKeyExchange-postWrite"><strong>postWrite</strong></a>(self, w, trial)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.AES.html b/pydocs/gdata.tlslite.utils.AES.html
new file mode 100644
index 0000000..f5eb62c
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.AES.html
@@ -0,0 +1,40 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.AES</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.AES</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/AES.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/AES.py</a></font></td></tr></table>
+ <p><tt>Abstract class for <a href="#AES">AES</a>.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.AES.html#AES">AES</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AES">class <strong>AES</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="AES-__init__"><strong>__init__</strong></a>(self, key, mode, IV, implementation)</dt></dl>
+
+<dl><dt><a name="AES-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt>#CBC-Mode decryption, returns plaintext<br>
+#WARNING: *MAY* modify the input as well</tt></dd></dl>
+
+<dl><dt><a name="AES-encrypt"><strong>encrypt</strong></a>(self, plaintext)</dt><dd><tt>#CBC-Mode encryption, returns ciphertext<br>
+#WARNING: *MAY* modify the input as well</tt></dd></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.ASN1Parser.html b/pydocs/gdata.tlslite.utils.ASN1Parser.html
new file mode 100644
index 0000000..d23627c
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.ASN1Parser.html
@@ -0,0 +1,50 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.ASN1Parser</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.ASN1Parser</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/ASN1Parser.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/ASN1Parser.py</a></font></td></tr></table>
+ <p><tt>Class for parsing ASN.1</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="array.html">array</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="sys.html">sys</a><br>
+</td><td width="25%" valign=top><a href="traceback.html">traceback</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.ASN1Parser.html#ASN1Parser">ASN1Parser</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ASN1Parser">class <strong>ASN1Parser</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>#Takes a byte array which has a DER TLV field at its head<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="ASN1Parser-__init__"><strong>__init__</strong></a>(self, bytes)</dt></dl>
+
+<dl><dt><a name="ASN1Parser-getChild"><strong>getChild</strong></a>(self, which)</dt><dd><tt>#Assuming this is a sequence...</tt></dd></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.Cryptlib_AES.html b/pydocs/gdata.tlslite.utils.Cryptlib_AES.html
new file mode 100644
index 0000000..395ba1e
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.Cryptlib_AES.html
@@ -0,0 +1,49 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.Cryptlib_AES</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.Cryptlib_AES</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Cryptlib_AES.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Cryptlib_AES.py</a></font></td></tr></table>
+ <p><tt>Cryptlib AES implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.Cryptlib_RC4.html b/pydocs/gdata.tlslite.utils.Cryptlib_RC4.html
new file mode 100644
index 0000000..2544bda
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.Cryptlib_RC4.html
@@ -0,0 +1,49 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.Cryptlib_RC4</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.Cryptlib_RC4</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Cryptlib_RC4.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Cryptlib_RC4.py</a></font></td></tr></table>
+ <p><tt>Cryptlib RC4 implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.Cryptlib_TripleDES.html b/pydocs/gdata.tlslite.utils.Cryptlib_TripleDES.html
new file mode 100644
index 0000000..16cfaa9
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.Cryptlib_TripleDES.html
@@ -0,0 +1,49 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.Cryptlib_TripleDES</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.Cryptlib_TripleDES</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Cryptlib_TripleDES.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Cryptlib_TripleDES.py</a></font></td></tr></table>
+ <p><tt>Cryptlib 3DES implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.OpenSSL_AES.html b/pydocs/gdata.tlslite.utils.OpenSSL_AES.html
new file mode 100644
index 0000000..863bef0
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.OpenSSL_AES.html
@@ -0,0 +1,49 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.OpenSSL_AES</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.OpenSSL_AES</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/OpenSSL_AES.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/OpenSSL_AES.py</a></font></td></tr></table>
+ <p><tt>OpenSSL/M2Crypto AES implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.OpenSSL_RC4.html b/pydocs/gdata.tlslite.utils.OpenSSL_RC4.html
new file mode 100644
index 0000000..8e1c822
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.OpenSSL_RC4.html
@@ -0,0 +1,49 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.OpenSSL_RC4</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.OpenSSL_RC4</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/OpenSSL_RC4.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/OpenSSL_RC4.py</a></font></td></tr></table>
+ <p><tt>OpenSSL/M2Crypto RC4 implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.OpenSSL_RSAKey.html b/pydocs/gdata.tlslite.utils.OpenSSL_RSAKey.html
new file mode 100644
index 0000000..de2ce1f
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.OpenSSL_RSAKey.html
@@ -0,0 +1,51 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.OpenSSL_RSAKey</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.OpenSSL_RSAKey</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/OpenSSL_RSAKey.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/OpenSSL_RSAKey.py</a></font></td></tr></table>
+ <p><tt>OpenSSL/M2Crypto RSA implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-password_callback"><strong>password_callback</strong></a>(v, prompt1<font color="#909090">='Enter private key passphrase:'</font>, prompt2<font color="#909090">='Verify passphrase:'</font>)</dt><dd><tt>#copied from M2Crypto.util.py, so when we load the local copy of m2<br>
+#we can still use it</tt></dd></dl>
+ <dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.OpenSSL_TripleDES.html b/pydocs/gdata.tlslite.utils.OpenSSL_TripleDES.html
new file mode 100644
index 0000000..1bee2fe
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.OpenSSL_TripleDES.html
@@ -0,0 +1,49 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.OpenSSL_TripleDES</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.OpenSSL_TripleDES</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/OpenSSL_TripleDES.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/OpenSSL_TripleDES.py</a></font></td></tr></table>
+ <p><tt>OpenSSL/M2Crypto 3DES implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.PyCrypto_AES.html b/pydocs/gdata.tlslite.utils.PyCrypto_AES.html
new file mode 100644
index 0000000..1a1d6e3
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.PyCrypto_AES.html
@@ -0,0 +1,79 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.PyCrypto_AES</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.PyCrypto_AES</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/PyCrypto_AES.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/PyCrypto_AES.py</a></font></td></tr></table>
+ <p><tt>PyCrypto <a href="gdata.tlslite.utils.AES.html#AES">AES</a> implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.AES.html#AES">gdata.tlslite.utils.AES.AES</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.PyCrypto_AES.html#PyCrypto_AES">PyCrypto_AES</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PyCrypto_AES">class <strong>PyCrypto_AES</strong></a>(<a href="gdata.tlslite.utils.AES.html#AES">gdata.tlslite.utils.AES.AES</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="PyCrypto_AES-__init__"><strong>__init__</strong></a>(self, key, mode, IV)</dt></dl>
+
+<dl><dt><a name="PyCrypto_AES-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt></dl>
+
+<dl><dt><a name="PyCrypto_AES-encrypt"><strong>encrypt</strong></a>(self, plaintext)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-new"><strong>new</strong></a>(key, mode, IV)</dt></dl>
+ <dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.PyCrypto_RC4.html b/pydocs/gdata.tlslite.utils.PyCrypto_RC4.html
new file mode 100644
index 0000000..c9b7f1b
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.PyCrypto_RC4.html
@@ -0,0 +1,79 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.PyCrypto_RC4</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.PyCrypto_RC4</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/PyCrypto_RC4.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/PyCrypto_RC4.py</a></font></td></tr></table>
+ <p><tt>PyCrypto <a href="gdata.tlslite.utils.RC4.html#RC4">RC4</a> implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.RC4.html#RC4">gdata.tlslite.utils.RC4.RC4</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.PyCrypto_RC4.html#PyCrypto_RC4">PyCrypto_RC4</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PyCrypto_RC4">class <strong>PyCrypto_RC4</strong></a>(<a href="gdata.tlslite.utils.RC4.html#RC4">gdata.tlslite.utils.RC4.RC4</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="PyCrypto_RC4-__init__"><strong>__init__</strong></a>(self, key)</dt></dl>
+
+<dl><dt><a name="PyCrypto_RC4-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt></dl>
+
+<dl><dt><a name="PyCrypto_RC4-encrypt"><strong>encrypt</strong></a>(self, plaintext)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-new"><strong>new</strong></a>(key)</dt></dl>
+ <dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.PyCrypto_RSAKey.html b/pydocs/gdata.tlslite.utils.PyCrypto_RSAKey.html
new file mode 100644
index 0000000..62ca1c4
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.PyCrypto_RSAKey.html
@@ -0,0 +1,178 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.PyCrypto_RSAKey</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.PyCrypto_RSAKey</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/PyCrypto_RSAKey.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/PyCrypto_RSAKey.py</a></font></td></tr></table>
+ <p><tt>PyCrypto RSA implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="Crypto.PublicKey.RSA.html">Crypto.PublicKey.RSA</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.RSAKey.html#RSAKey">gdata.tlslite.utils.RSAKey.RSAKey</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.PyCrypto_RSAKey.html#PyCrypto_RSAKey">PyCrypto_RSAKey</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PyCrypto_RSAKey">class <strong>PyCrypto_RSAKey</strong></a>(<a href="gdata.tlslite.utils.RSAKey.html#RSAKey">gdata.tlslite.utils.RSAKey.RSAKey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="PyCrypto_RSAKey-__getattr__"><strong>__getattr__</strong></a>(self, name)</dt></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-__init__"><strong>__init__</strong></a>(self, n<font color="#909090">=0</font>, e<font color="#909090">=0</font>, d<font color="#909090">=0</font>, p<font color="#909090">=0</font>, q<font color="#909090">=0</font>, dP<font color="#909090">=0</font>, dQ<font color="#909090">=0</font>, qInv<font color="#909090">=0</font>)</dt></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-hasPrivateKey"><strong>hasPrivateKey</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-hash"><strong>hash</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-writeXMLPublicKey"><strong>writeXMLPublicKey</strong></a>(self, indent<font color="#909090">=''</font>)</dt></dl>
+
+<hr>
+Static methods defined here:<br>
+<dl><dt><a name="PyCrypto_RSAKey-generate"><strong>generate</strong></a>(bits)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.utils.RSAKey.html#RSAKey">gdata.tlslite.utils.RSAKey.RSAKey</a>:<br>
+<dl><dt><a name="PyCrypto_RSAKey-__len__"><strong>__len__</strong></a>(self)</dt><dd><tt>Return the length of this key in bits.<br>
+ <br>
+@rtype: int</tt></dd></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-acceptsPassword"><strong>acceptsPassword</strong></a>(self)</dt><dd><tt>Return True if the <a href="#PyCrypto_RSAKey-write">write</a>() method accepts a password for use<br>
+in encrypting the private key.<br>
+ <br>
+@rtype: bool</tt></dd></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-decrypt"><strong>decrypt</strong></a>(self, encBytes)</dt><dd><tt>Decrypt the passed-in bytes.<br>
+ <br>
+This requires the key to have a private component. It performs<br>
+PKCS1 decryption of the passed-in data.<br>
+ <br>
+@type encBytes: L{array.array} of unsigned bytes<br>
+@param encBytes: The value which will be decrypted.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes or None.<br>
+@return: A PKCS1 decryption of the passed-in data or None if<br>
+the data is not properly formatted.</tt></dd></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-encrypt"><strong>encrypt</strong></a>(self, bytes)</dt><dd><tt>Encrypt the passed-in bytes.<br>
+ <br>
+This performs PKCS1 encryption of the passed-in data.<br>
+ <br>
+@type bytes: L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be encrypted.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes.<br>
+@return: A PKCS1 encryption of the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-getSigningAlgorithm"><strong>getSigningAlgorithm</strong></a>(self)</dt><dd><tt>Return the cryptoID sigAlgo value corresponding to this key.<br>
+ <br>
+@rtype: str</tt></dd></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-hashAndSign"><strong>hashAndSign</strong></a>(self, bytes)</dt><dd><tt>Hash and sign the passed-in bytes.<br>
+ <br>
+This requires the key to have a private component. It performs<br>
+a PKCS1-SHA1 signature on the passed-in data.<br>
+ <br>
+@type bytes: str or L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be hashed and signed.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes.<br>
+@return: A PKCS1-SHA1 signature on the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-hashAndVerify"><strong>hashAndVerify</strong></a>(self, sigBytes, bytes)</dt><dd><tt>Hash and verify the passed-in bytes with the signature.<br>
+ <br>
+This verifies a PKCS1-SHA1 signature on the passed-in data.<br>
+ <br>
+@type sigBytes: L{array.array} of unsigned bytes<br>
+@param sigBytes: A PKCS1-SHA1 signature.<br>
+ <br>
+@type bytes: str or L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be hashed and verified.<br>
+ <br>
+@rtype: bool<br>
+@return: Whether the signature matches the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-sign"><strong>sign</strong></a>(self, bytes)</dt><dd><tt>Sign the passed-in bytes.<br>
+ <br>
+This requires the key to have a private component. It performs<br>
+a PKCS1 signature on the passed-in data.<br>
+ <br>
+@type bytes: L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be signed.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes.<br>
+@return: A PKCS1 signature on the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-verify"><strong>verify</strong></a>(self, sigBytes, bytes)</dt><dd><tt>Verify the passed-in bytes with the signature.<br>
+ <br>
+This verifies a PKCS1 signature on the passed-in data.<br>
+ <br>
+@type sigBytes: L{array.array} of unsigned bytes<br>
+@param sigBytes: A PKCS1 signature.<br>
+ <br>
+@type bytes: L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be verified.<br>
+ <br>
+@rtype: bool<br>
+@return: Whether the signature matches the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="PyCrypto_RSAKey-write"><strong>write</strong></a>(self, password<font color="#909090">=None</font>)</dt><dd><tt>Return a string containing the key.<br>
+ <br>
+@rtype: str<br>
+@return: A string describing the key, in whichever format (PEM<br>
+or XML) is native to the implementation.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.PyCrypto_TripleDES.html b/pydocs/gdata.tlslite.utils.PyCrypto_TripleDES.html
new file mode 100644
index 0000000..23a2c0b
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.PyCrypto_TripleDES.html
@@ -0,0 +1,79 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.PyCrypto_TripleDES</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.PyCrypto_TripleDES</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/PyCrypto_TripleDES.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/PyCrypto_TripleDES.py</a></font></td></tr></table>
+ <p><tt>PyCrypto 3DES implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.TripleDES.html#TripleDES">gdata.tlslite.utils.TripleDES.TripleDES</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.PyCrypto_TripleDES.html#PyCrypto_TripleDES">PyCrypto_TripleDES</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PyCrypto_TripleDES">class <strong>PyCrypto_TripleDES</strong></a>(<a href="gdata.tlslite.utils.TripleDES.html#TripleDES">gdata.tlslite.utils.TripleDES.TripleDES</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="PyCrypto_TripleDES-__init__"><strong>__init__</strong></a>(self, key, mode, IV)</dt></dl>
+
+<dl><dt><a name="PyCrypto_TripleDES-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt></dl>
+
+<dl><dt><a name="PyCrypto_TripleDES-encrypt"><strong>encrypt</strong></a>(self, plaintext)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-new"><strong>new</strong></a>(key, mode, IV)</dt></dl>
+ <dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.Python_AES.html b/pydocs/gdata.tlslite.utils.Python_AES.html
new file mode 100644
index 0000000..71c3ea9
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.Python_AES.html
@@ -0,0 +1,79 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.Python_AES</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.Python_AES</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Python_AES.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Python_AES.py</a></font></td></tr></table>
+ <p><tt>Pure-Python <a href="gdata.tlslite.utils.AES.html#AES">AES</a> implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.AES.html#AES">gdata.tlslite.utils.AES.AES</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.Python_AES.html#Python_AES">Python_AES</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Python_AES">class <strong>Python_AES</strong></a>(<a href="gdata.tlslite.utils.AES.html#AES">gdata.tlslite.utils.AES.AES</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Python_AES-__init__"><strong>__init__</strong></a>(self, key, mode, IV)</dt></dl>
+
+<dl><dt><a name="Python_AES-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt></dl>
+
+<dl><dt><a name="Python_AES-encrypt"><strong>encrypt</strong></a>(self, plaintext)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-new"><strong>new</strong></a>(key, mode, IV)</dt></dl>
+ <dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.Python_RC4.html b/pydocs/gdata.tlslite.utils.Python_RC4.html
new file mode 100644
index 0000000..45491d6
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.Python_RC4.html
@@ -0,0 +1,79 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.Python_RC4</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.Python_RC4</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Python_RC4.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Python_RC4.py</a></font></td></tr></table>
+ <p><tt>Pure-Python <a href="gdata.tlslite.utils.RC4.html#RC4">RC4</a> implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.RC4.html#RC4">gdata.tlslite.utils.RC4.RC4</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.Python_RC4.html#Python_RC4">Python_RC4</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Python_RC4">class <strong>Python_RC4</strong></a>(<a href="gdata.tlslite.utils.RC4.html#RC4">gdata.tlslite.utils.RC4.RC4</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Python_RC4-__init__"><strong>__init__</strong></a>(self, key)</dt></dl>
+
+<dl><dt><a name="Python_RC4-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt></dl>
+
+<dl><dt><a name="Python_RC4-encrypt"><strong>encrypt</strong></a>(self, plaintext)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-new"><strong>new</strong></a>(key)</dt></dl>
+ <dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.Python_RSAKey.html b/pydocs/gdata.tlslite.utils.Python_RSAKey.html
new file mode 100644
index 0000000..e30d7ee
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.Python_RSAKey.html
@@ -0,0 +1,174 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.Python_RSAKey</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.Python_RSAKey</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Python_RSAKey.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/Python_RSAKey.py</a></font></td></tr></table>
+ <p><tt>Pure-Python RSA implementation.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+<a href="base64.html">base64</a><br>
+</td><td width="25%" valign=top><a href="binascii.html">binascii</a><br>
+<a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+<a href="gdata.tlslite.utils.xmltools.html">gdata.tlslite.utils.xmltools</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.RSAKey.html#RSAKey">gdata.tlslite.utils.RSAKey.RSAKey</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.Python_RSAKey.html#Python_RSAKey">Python_RSAKey</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Python_RSAKey">class <strong>Python_RSAKey</strong></a>(<a href="gdata.tlslite.utils.RSAKey.html#RSAKey">gdata.tlslite.utils.RSAKey.RSAKey</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Python_RSAKey-__init__"><strong>__init__</strong></a>(self, n<font color="#909090">=0</font>, e<font color="#909090">=0</font>, d<font color="#909090">=0</font>, p<font color="#909090">=0</font>, q<font color="#909090">=0</font>, dP<font color="#909090">=0</font>, dQ<font color="#909090">=0</font>, qInv<font color="#909090">=0</font>)</dt></dl>
+
+<dl><dt><a name="Python_RSAKey-acceptsPassword"><strong>acceptsPassword</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Python_RSAKey-hasPrivateKey"><strong>hasPrivateKey</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Python_RSAKey-hash"><strong>hash</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Python_RSAKey-write"><strong>write</strong></a>(self, indent<font color="#909090">=''</font>)</dt></dl>
+
+<dl><dt><a name="Python_RSAKey-writeXMLPublicKey"><strong>writeXMLPublicKey</strong></a>(self, indent<font color="#909090">=''</font>)</dt></dl>
+
+<hr>
+Static methods defined here:<br>
+<dl><dt><a name="Python_RSAKey-generate"><strong>generate</strong></a>(bits)</dt></dl>
+
+<dl><dt><a name="Python_RSAKey-parsePEM"><strong>parsePEM</strong></a>(s, passwordCallback<font color="#909090">=None</font>)</dt><dd><tt>Parse a string containing a <privateKey> or <publicKey>, or<br>
+PEM-encoded key.</tt></dd></dl>
+
+<dl><dt><a name="Python_RSAKey-parseXML"><strong>parseXML</strong></a>(s)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.tlslite.utils.RSAKey.html#RSAKey">gdata.tlslite.utils.RSAKey.RSAKey</a>:<br>
+<dl><dt><a name="Python_RSAKey-__len__"><strong>__len__</strong></a>(self)</dt><dd><tt>Return the length of this key in bits.<br>
+ <br>
+@rtype: int</tt></dd></dl>
+
+<dl><dt><a name="Python_RSAKey-decrypt"><strong>decrypt</strong></a>(self, encBytes)</dt><dd><tt>Decrypt the passed-in bytes.<br>
+ <br>
+This requires the key to have a private component. It performs<br>
+PKCS1 decryption of the passed-in data.<br>
+ <br>
+@type encBytes: L{array.array} of unsigned bytes<br>
+@param encBytes: The value which will be decrypted.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes or None.<br>
+@return: A PKCS1 decryption of the passed-in data or None if<br>
+the data is not properly formatted.</tt></dd></dl>
+
+<dl><dt><a name="Python_RSAKey-encrypt"><strong>encrypt</strong></a>(self, bytes)</dt><dd><tt>Encrypt the passed-in bytes.<br>
+ <br>
+This performs PKCS1 encryption of the passed-in data.<br>
+ <br>
+@type bytes: L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be encrypted.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes.<br>
+@return: A PKCS1 encryption of the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="Python_RSAKey-getSigningAlgorithm"><strong>getSigningAlgorithm</strong></a>(self)</dt><dd><tt>Return the cryptoID sigAlgo value corresponding to this key.<br>
+ <br>
+@rtype: str</tt></dd></dl>
+
+<dl><dt><a name="Python_RSAKey-hashAndSign"><strong>hashAndSign</strong></a>(self, bytes)</dt><dd><tt>Hash and sign the passed-in bytes.<br>
+ <br>
+This requires the key to have a private component. It performs<br>
+a PKCS1-SHA1 signature on the passed-in data.<br>
+ <br>
+@type bytes: str or L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be hashed and signed.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes.<br>
+@return: A PKCS1-SHA1 signature on the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="Python_RSAKey-hashAndVerify"><strong>hashAndVerify</strong></a>(self, sigBytes, bytes)</dt><dd><tt>Hash and verify the passed-in bytes with the signature.<br>
+ <br>
+This verifies a PKCS1-SHA1 signature on the passed-in data.<br>
+ <br>
+@type sigBytes: L{array.array} of unsigned bytes<br>
+@param sigBytes: A PKCS1-SHA1 signature.<br>
+ <br>
+@type bytes: str or L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be hashed and verified.<br>
+ <br>
+@rtype: bool<br>
+@return: Whether the signature matches the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="Python_RSAKey-sign"><strong>sign</strong></a>(self, bytes)</dt><dd><tt>Sign the passed-in bytes.<br>
+ <br>
+This requires the key to have a private component. It performs<br>
+a PKCS1 signature on the passed-in data.<br>
+ <br>
+@type bytes: L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be signed.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes.<br>
+@return: A PKCS1 signature on the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="Python_RSAKey-verify"><strong>verify</strong></a>(self, sigBytes, bytes)</dt><dd><tt>Verify the passed-in bytes with the signature.<br>
+ <br>
+This verifies a PKCS1 signature on the passed-in data.<br>
+ <br>
+@type sigBytes: L{array.array} of unsigned bytes<br>
+@param sigBytes: A PKCS1 signature.<br>
+ <br>
+@type bytes: L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be verified.<br>
+ <br>
+@rtype: bool<br>
+@return: Whether the signature matches the passed-in data.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.RC4.html b/pydocs/gdata.tlslite.utils.RC4.html
new file mode 100644
index 0000000..01085b3
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.RC4.html
@@ -0,0 +1,50 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.RC4</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.RC4</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/RC4.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/RC4.py</a></font></td></tr></table>
+ <p><tt>Abstract class for <a href="#RC4">RC4</a>.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="array.html">array</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="sys.html">sys</a><br>
+</td><td width="25%" valign=top><a href="traceback.html">traceback</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.RC4.html#RC4">RC4</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RC4">class <strong>RC4</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="RC4-__init__"><strong>__init__</strong></a>(self, keyBytes, implementation)</dt></dl>
+
+<dl><dt><a name="RC4-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt></dl>
+
+<dl><dt><a name="RC4-encrypt"><strong>encrypt</strong></a>(self, plaintext)</dt></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.RSAKey.html b/pydocs/gdata.tlslite.utils.RSAKey.html
new file mode 100644
index 0000000..2b219f8
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.RSAKey.html
@@ -0,0 +1,198 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.RSAKey</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.RSAKey</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/RSAKey.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/RSAKey.py</a></font></td></tr></table>
+ <p><tt>Abstract class for RSA.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.RSAKey.html#RSAKey">RSAKey</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RSAKey">class <strong>RSAKey</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>This is an abstract base class for RSA keys.<br>
+ <br>
+Particular implementations of RSA keys, such as<br>
+L{OpenSSL_RSAKey.OpenSSL_RSAKey},<br>
+L{Python_RSAKey.Python_RSAKey}, and<br>
+L{PyCrypto_RSAKey.PyCrypto_RSAKey},<br>
+inherit from this.<br>
+ <br>
+To create or parse an RSA key, don't use one of these classes<br>
+directly. Instead, use the factory functions in<br>
+L{tlslite.utils.keyfactory}.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="RSAKey-__init__"><strong>__init__</strong></a>(self, n<font color="#909090">=0</font>, e<font color="#909090">=0</font>)</dt><dd><tt>Create a new RSA key.<br>
+ <br>
+If n and e are passed in, the new key will be initialized.<br>
+ <br>
+@type n: int<br>
+@param n: RSA modulus.<br>
+ <br>
+@type e: int<br>
+@param e: RSA public exponent.</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-__len__"><strong>__len__</strong></a>(self)</dt><dd><tt>Return the length of this key in bits.<br>
+ <br>
+@rtype: int</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-acceptsPassword"><strong>acceptsPassword</strong></a>(self)</dt><dd><tt>Return True if the <a href="#RSAKey-write">write</a>() method accepts a password for use<br>
+in encrypting the private key.<br>
+ <br>
+@rtype: bool</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-decrypt"><strong>decrypt</strong></a>(self, encBytes)</dt><dd><tt>Decrypt the passed-in bytes.<br>
+ <br>
+This requires the key to have a private component. It performs<br>
+PKCS1 decryption of the passed-in data.<br>
+ <br>
+@type encBytes: L{array.array} of unsigned bytes<br>
+@param encBytes: The value which will be decrypted.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes or None.<br>
+@return: A PKCS1 decryption of the passed-in data or None if<br>
+the data is not properly formatted.</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-encrypt"><strong>encrypt</strong></a>(self, bytes)</dt><dd><tt>Encrypt the passed-in bytes.<br>
+ <br>
+This performs PKCS1 encryption of the passed-in data.<br>
+ <br>
+@type bytes: L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be encrypted.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes.<br>
+@return: A PKCS1 encryption of the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-getSigningAlgorithm"><strong>getSigningAlgorithm</strong></a>(self)</dt><dd><tt>Return the cryptoID sigAlgo value corresponding to this key.<br>
+ <br>
+@rtype: str</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-hasPrivateKey"><strong>hasPrivateKey</strong></a>(self)</dt><dd><tt>Return whether or not this key has a private component.<br>
+ <br>
+@rtype: bool</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-hash"><strong>hash</strong></a>(self)</dt><dd><tt>Return the cryptoID <keyHash> value corresponding to this<br>
+key.<br>
+ <br>
+@rtype: str</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-hashAndSign"><strong>hashAndSign</strong></a>(self, bytes)</dt><dd><tt>Hash and sign the passed-in bytes.<br>
+ <br>
+This requires the key to have a private component. It performs<br>
+a PKCS1-SHA1 signature on the passed-in data.<br>
+ <br>
+@type bytes: str or L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be hashed and signed.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes.<br>
+@return: A PKCS1-SHA1 signature on the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-hashAndVerify"><strong>hashAndVerify</strong></a>(self, sigBytes, bytes)</dt><dd><tt>Hash and verify the passed-in bytes with the signature.<br>
+ <br>
+This verifies a PKCS1-SHA1 signature on the passed-in data.<br>
+ <br>
+@type sigBytes: L{array.array} of unsigned bytes<br>
+@param sigBytes: A PKCS1-SHA1 signature.<br>
+ <br>
+@type bytes: str or L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be hashed and verified.<br>
+ <br>
+@rtype: bool<br>
+@return: Whether the signature matches the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-sign"><strong>sign</strong></a>(self, bytes)</dt><dd><tt>Sign the passed-in bytes.<br>
+ <br>
+This requires the key to have a private component. It performs<br>
+a PKCS1 signature on the passed-in data.<br>
+ <br>
+@type bytes: L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be signed.<br>
+ <br>
+@rtype: L{array.array} of unsigned bytes.<br>
+@return: A PKCS1 signature on the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-verify"><strong>verify</strong></a>(self, sigBytes, bytes)</dt><dd><tt>Verify the passed-in bytes with the signature.<br>
+ <br>
+This verifies a PKCS1 signature on the passed-in data.<br>
+ <br>
+@type sigBytes: L{array.array} of unsigned bytes<br>
+@param sigBytes: A PKCS1 signature.<br>
+ <br>
+@type bytes: L{array.array} of unsigned bytes<br>
+@param bytes: The value which will be verified.<br>
+ <br>
+@rtype: bool<br>
+@return: Whether the signature matches the passed-in data.</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-write"><strong>write</strong></a>(self, password<font color="#909090">=None</font>)</dt><dd><tt>Return a string containing the key.<br>
+ <br>
+@rtype: str<br>
+@return: A string describing the key, in whichever format (PEM<br>
+or XML) is native to the implementation.</tt></dd></dl>
+
+<dl><dt><a name="RSAKey-writeXMLPublicKey"><strong>writeXMLPublicKey</strong></a>(self, indent<font color="#909090">=''</font>)</dt><dd><tt>Return a string containing the key.<br>
+ <br>
+@rtype: str<br>
+@return: A string describing the public key, in XML format.</tt></dd></dl>
+
+<hr>
+Static methods defined here:<br>
+<dl><dt><a name="RSAKey-generate"><strong>generate</strong></a>(bits)</dt><dd><tt>Generate a new key with the specified bit length.<br>
+ <br>
+@rtype: L{tlslite.utils.<a href="#RSAKey">RSAKey</a>.<a href="#RSAKey">RSAKey</a>}</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.TripleDES.html b/pydocs/gdata.tlslite.utils.TripleDES.html
new file mode 100644
index 0000000..d73d61b
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.TripleDES.html
@@ -0,0 +1,52 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.TripleDES</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.TripleDES</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/TripleDES.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/TripleDES.py</a></font></td></tr></table>
+ <p><tt>Abstract class for 3DES.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="array.html">array</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="sys.html">sys</a><br>
+</td><td width="25%" valign=top><a href="traceback.html">traceback</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.TripleDES.html#TripleDES">TripleDES</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TripleDES">class <strong>TripleDES</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="TripleDES-__init__"><strong>__init__</strong></a>(self, key, mode, IV, implementation)</dt></dl>
+
+<dl><dt><a name="TripleDES-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt><dd><tt>#CBC-Mode decryption, returns plaintext<br>
+#WARNING: *MAY* modify the input as well</tt></dd></dl>
+
+<dl><dt><a name="TripleDES-encrypt"><strong>encrypt</strong></a>(self, plaintext)</dt><dd><tt>#CBC-Mode encryption, returns ciphertext<br>
+#WARNING: *MAY* modify the input as well</tt></dd></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.cipherfactory.html b/pydocs/gdata.tlslite.utils.cipherfactory.html
new file mode 100644
index 0000000..af8d18f
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.cipherfactory.html
@@ -0,0 +1,72 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.cipherfactory</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.cipherfactory</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/cipherfactory.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/cipherfactory.py</a></font></td></tr></table>
+ <p><tt>Factory functions for symmetric cryptography.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.tlslite.utils.PyCrypto_AES.html">gdata.tlslite.utils.PyCrypto_AES</a><br>
+<a href="gdata.tlslite.utils.PyCrypto_RC4.html">gdata.tlslite.utils.PyCrypto_RC4</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.utils.PyCrypto_TripleDES.html">gdata.tlslite.utils.PyCrypto_TripleDES</a><br>
+<a href="gdata.tlslite.utils.Python_AES.html">gdata.tlslite.utils.Python_AES</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.utils.Python_RC4.html">gdata.tlslite.utils.Python_RC4</a><br>
+<a href="gdata.tlslite.utils.cryptomath.html">gdata.tlslite.utils.cryptomath</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-createAES"><strong>createAES</strong></a>(key, IV, implList<font color="#909090">=None</font>)</dt><dd><tt>Create a new AES object.<br>
+ <br>
+@type key: str<br>
+@param key: A 16, 24, or 32 byte string.<br>
+ <br>
+@type IV: str<br>
+@param IV: A 16 byte string<br>
+ <br>
+@rtype: L{tlslite.utils.AES}<br>
+@return: An AES object.</tt></dd></dl>
+ <dl><dt><a name="-createRC4"><strong>createRC4</strong></a>(key, IV, implList<font color="#909090">=None</font>)</dt><dd><tt>Create a new RC4 object.<br>
+ <br>
+@type key: str<br>
+@param key: A 16 to 32 byte string.<br>
+ <br>
+@type IV: object<br>
+@param IV: Ignored, whatever it is.<br>
+ <br>
+@rtype: L{tlslite.utils.RC4}<br>
+@return: An RC4 object.</tt></dd></dl>
+ <dl><dt><a name="-createTripleDES"><strong>createTripleDES</strong></a>(key, IV, implList<font color="#909090">=None</font>)</dt><dd><tt>Create a new 3DES object.<br>
+ <br>
+@type key: str<br>
+@param key: A 24 byte string.<br>
+ <br>
+@type IV: str<br>
+@param IV: An 8 byte string<br>
+ <br>
+@rtype: L{tlslite.utils.TripleDES}<br>
+@return: A 3DES object.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>tripleDESPresent</strong> = True</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.codec.html b/pydocs/gdata.tlslite.utils.codec.html
new file mode 100644
index 0000000..7c13356
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.codec.html
@@ -0,0 +1,81 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.codec</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.codec</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/codec.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/codec.py</a></font></td></tr></table>
+ <p><tt>Classes for reading/writing binary data (such as TLS records).</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="array.html">array</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="sys.html">sys</a><br>
+</td><td width="25%" valign=top><a href="traceback.html">traceback</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.codec.html#Parser">Parser</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.codec.html#Writer">Writer</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Parser">class <strong>Parser</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Parser-__init__"><strong>__init__</strong></a>(self, bytes)</dt></dl>
+
+<dl><dt><a name="Parser-atLengthCheck"><strong>atLengthCheck</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Parser-get"><strong>get</strong></a>(self, length)</dt></dl>
+
+<dl><dt><a name="Parser-getFixBytes"><strong>getFixBytes</strong></a>(self, lengthBytes)</dt></dl>
+
+<dl><dt><a name="Parser-getFixList"><strong>getFixList</strong></a>(self, length, lengthList)</dt></dl>
+
+<dl><dt><a name="Parser-getVarBytes"><strong>getVarBytes</strong></a>(self, lengthLength)</dt></dl>
+
+<dl><dt><a name="Parser-getVarList"><strong>getVarList</strong></a>(self, length, lengthLength)</dt></dl>
+
+<dl><dt><a name="Parser-setLengthCheck"><strong>setLengthCheck</strong></a>(self, length)</dt></dl>
+
+<dl><dt><a name="Parser-startLengthCheck"><strong>startLengthCheck</strong></a>(self, lengthLength)</dt></dl>
+
+<dl><dt><a name="Parser-stopLengthCheck"><strong>stopLengthCheck</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Writer">class <strong>Writer</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="Writer-__init__"><strong>__init__</strong></a>(self, length<font color="#909090">=0</font>)</dt></dl>
+
+<dl><dt><a name="Writer-add"><strong>add</strong></a>(self, x, length)</dt></dl>
+
+<dl><dt><a name="Writer-addFixSeq"><strong>addFixSeq</strong></a>(self, seq, length)</dt></dl>
+
+<dl><dt><a name="Writer-addVarSeq"><strong>addVarSeq</strong></a>(self, seq, length, lengthLength)</dt></dl>
+
+</td></tr></table></td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.compat.html b/pydocs/gdata.tlslite.utils.compat.html
new file mode 100644
index 0000000..2f83690
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.compat.html
@@ -0,0 +1,40 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.compat</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.compat</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/compat.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/compat.py</a></font></td></tr></table>
+ <p><tt>Miscellaneous functions to mask Python version differences.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="array.html">array</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="sys.html">sys</a><br>
+</td><td width="25%" valign=top><a href="traceback.html">traceback</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-bytesToString"><strong>bytesToString</strong></a>(bytes)</dt></dl>
+ <dl><dt><a name="-concatArrays"><strong>concatArrays</strong></a>(a1, a2)</dt></dl>
+ <dl><dt><a name="-createByteArraySequence"><strong>createByteArraySequence</strong></a>(seq)</dt></dl>
+ <dl><dt><a name="-createByteArrayZeros"><strong>createByteArrayZeros</strong></a>(howMany)</dt></dl>
+ <dl><dt><a name="-formatExceptionTrace"><strong>formatExceptionTrace</strong></a>(e)</dt></dl>
+ <dl><dt><a name="-numBits"><strong>numBits</strong></a>(n)</dt></dl>
+ <dl><dt><a name="-stringToBytes"><strong>stringToBytes</strong></a>(s)</dt></dl>
+</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.cryptomath.html b/pydocs/gdata.tlslite.utils.cryptomath.html
new file mode 100644
index 0000000..5e8dff0
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.cryptomath.html
@@ -0,0 +1,79 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.cryptomath</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.cryptomath</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/cryptomath.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/cryptomath.py</a></font></td></tr></table>
+ <p><tt>cryptomath module<br>
+ <br>
+This module has basic math/crypto code.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="Crypto.html">Crypto</a><br>
+<a href="array.html">array</a><br>
+</td><td width="25%" valign=top><a href="base64.html">base64</a><br>
+<a href="binascii.html">binascii</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-base64ToBytes"><strong>base64ToBytes</strong></a>(s)</dt></dl>
+ <dl><dt><a name="-base64ToNumber"><strong>base64ToNumber</strong></a>(s)</dt></dl>
+ <dl><dt><a name="-base64ToString"><strong>base64ToString</strong></a>(s)</dt></dl>
+ <dl><dt><a name="-bytesToBase64"><strong>bytesToBase64</strong></a>(bytes)</dt></dl>
+ <dl><dt><a name="-bytesToNumber"><strong>bytesToNumber</strong></a>(bytes)</dt></dl>
+ <dl><dt><a name="-gcd"><strong>gcd</strong></a>(a, b)</dt></dl>
+ <dl><dt><a name="-getBase64Nonce"><strong>getBase64Nonce</strong></a>(numChars<font color="#909090">=22</font>)</dt></dl>
+ <dl><dt><a name="-getRandomBytes"><strong>getRandomBytes</strong></a>(howMany)</dt></dl>
+ <dl><dt><a name="-getRandomNumber"><strong>getRandomNumber</strong></a>(low, high)</dt></dl>
+ <dl><dt><a name="-getRandomPrime"><strong>getRandomPrime</strong></a>(bits, display<font color="#909090">=False</font>)</dt></dl>
+ <dl><dt><a name="-getRandomSafePrime"><strong>getRandomSafePrime</strong></a>(bits, display<font color="#909090">=False</font>)</dt><dd><tt>#Unused at the moment...</tt></dd></dl>
+ <dl><dt><a name="-hashAndBase64"><strong>hashAndBase64</strong></a>(s)</dt></dl>
+ <dl><dt><a name="-invMod"><strong>invMod</strong></a>(a, b)</dt><dd><tt>#Returns inverse of a mod b, zero if none<br>
+#Uses Extended Euclidean Algorithm</tt></dd></dl>
+ <dl><dt><a name="-isPrime"><strong>isPrime</strong></a>(n, iterations<font color="#909090">=5</font>, display<font color="#909090">=False</font>)</dt></dl>
+ <dl><dt><a name="-lcm"><strong>lcm</strong></a>(a, b)</dt></dl>
+ <dl><dt><a name="-makeSieve"><strong>makeSieve</strong></a>(n)</dt><dd><tt>#Pre-calculate a sieve of the ~100 primes < 1000:</tt></dd></dl>
+ <dl><dt><a name="-mpiToNumber"><strong>mpiToNumber</strong></a>(mpi)</dt></dl>
+ <dl><dt><a name="-numBytes"><strong>numBytes</strong></a>(n)</dt></dl>
+ <dl><dt><a name="-numberToBase64"><strong>numberToBase64</strong></a>(n)</dt></dl>
+ <dl><dt><a name="-numberToBytes"><strong>numberToBytes</strong></a>(n)</dt></dl>
+ <dl><dt><a name="-numberToMPI"><strong>numberToMPI</strong></a>(n)</dt></dl>
+ <dl><dt><a name="-numberToString"><strong>numberToString</strong></a>(s)</dt></dl>
+ <dl><dt><a name="-powMod"><strong>powMod</strong></a>(base, power, modulus)</dt><dd><tt>#Copied from Bryan G. Olson's post to comp.lang.python<br>
+#Does left-to-right instead of pow()'s right-to-left,<br>
+#thus about 30% faster than the python built-in with small bases</tt></dd></dl>
+ <dl><dt><a name="-sha1"><strong>sha1</strong></a> = openssl_sha1(...)</dt><dd><tt>Returns a sha1 hash object; optionally initialized with a string</tt></dd></dl>
+ <dl><dt><a name="-stringToBase64"><strong>stringToBase64</strong></a>(s)</dt></dl>
+ <dl><dt><a name="-stringToNumber"><strong>stringToNumber</strong></a>(s)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>cryptlibpyLoaded</strong> = False<br>
+<strong>gmpyLoaded</strong> = False<br>
+<strong>m2cryptoLoaded</strong> = False<br>
+<strong>prngName</strong> = 'os.urandom'<br>
+<strong>pycryptoLoaded</strong> = True<br>
+<strong>sieve</strong> = [2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59, 61, 67, 71, ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.dateFuncs.html b/pydocs/gdata.tlslite.utils.dateFuncs.html
new file mode 100644
index 0000000..a1682f5
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.dateFuncs.html
@@ -0,0 +1,38 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.dateFuncs</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.dateFuncs</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/dateFuncs.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/dateFuncs.py</a></font></td></tr></table>
+ <p></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="os.html">os</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-createDateClass"><strong>createDateClass</strong></a>(year, month, day, hour, minute, second)</dt><dd><tt>#Helper functions for working with a date/time class</tt></dd></dl>
+ <dl><dt><a name="-getHoursFromNow"><strong>getHoursFromNow</strong></a>(hours)</dt></dl>
+ <dl><dt><a name="-getMinutesFromNow"><strong>getMinutesFromNow</strong></a>(minutes)</dt></dl>
+ <dl><dt><a name="-getNow"><strong>getNow</strong></a>()</dt></dl>
+ <dl><dt><a name="-isDateClassBefore"><strong>isDateClassBefore</strong></a>(d1, d2)</dt></dl>
+ <dl><dt><a name="-isDateClassExpired"><strong>isDateClassExpired</strong></a>(d)</dt></dl>
+ <dl><dt><a name="-parseDateClass"><strong>parseDateClass</strong></a>(s)</dt><dd><tt>#Functions for manipulating datetime objects<br>
+#CCYY-MM-DDThh:mm:ssZ</tt></dd></dl>
+ <dl><dt><a name="-printDateClass"><strong>printDateClass</strong></a>(d)</dt></dl>
+</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.hmac.html b/pydocs/gdata.tlslite.utils.hmac.html
new file mode 100644
index 0000000..0857a02
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.hmac.html
@@ -0,0 +1,84 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.hmac</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.hmac</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/hmac.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/hmac.py</a></font></td></tr></table>
+ <p><tt><a href="#HMAC">HMAC</a> (Keyed-Hashing for Message Authentication) Python module.<br>
+ <br>
+Implements the <a href="#HMAC">HMAC</a> algorithm as described by <a href="http://www.rfc-editor.org/rfc/rfc2104.txt">RFC 2104</a>.<br>
+ <br>
+(This file is modified from the standard library version to do faster<br>
+copying)</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.hmac.html#HMAC">HMAC</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HMAC">class <strong>HMAC</strong></a></font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="http://www.rfc-editor.org/rfc/rfc2104.txt">RFC2104</a> <a href="#HMAC">HMAC</a> class.<br>
+ <br>
+This supports the API for Cryptographic Hash Functions (<a href="http://www.python.org/dev/peps/pep-0247/">PEP 247</a>).<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="HMAC-__init__"><strong>__init__</strong></a>(self, key, msg<font color="#909090">=None</font>, digestmod<font color="#909090">=None</font>)</dt><dd><tt>Create a new <a href="#HMAC">HMAC</a> object.<br>
+ <br>
+key: key for the keyed hash object.<br>
+msg: Initial input for the hash, if provided.<br>
+digestmod: A module supporting <a href="http://www.python.org/dev/peps/pep-0247/">PEP 247</a>. Defaults to the md5 module.</tt></dd></dl>
+
+<dl><dt><a name="HMAC-copy"><strong>copy</strong></a>(self)</dt><dd><tt>Return a separate copy of this hashing object.<br>
+ <br>
+An update to this copy won't affect the original object.</tt></dd></dl>
+
+<dl><dt><a name="HMAC-digest"><strong>digest</strong></a>(self)</dt><dd><tt>Return the hash value of this hashing object.<br>
+ <br>
+This returns a string containing 8-bit data. The object is<br>
+not altered in any way by this function; you can continue<br>
+updating the object after calling this function.</tt></dd></dl>
+
+<dl><dt><a name="HMAC-hexdigest"><strong>hexdigest</strong></a>(self)</dt><dd><tt>Like <a href="#HMAC-digest">digest</a>(), but returns a string of hexadecimal digits instead.</tt></dd></dl>
+
+<dl><dt><a name="HMAC-update"><strong>update</strong></a>(self, msg)</dt><dd><tt>Update this hashing object with the string msg.</tt></dd></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-new"><strong>new</strong></a>(key, msg<font color="#909090">=None</font>, digestmod<font color="#909090">=None</font>)</dt><dd><tt>Create a new hashing object and return it.<br>
+ <br>
+key: The starting key for the hash.<br>
+msg: if available, will immediately be hashed into the object's starting<br>
+state.<br>
+ <br>
+You can now feed arbitrary strings into the object using its update()<br>
+method, and can ask for the hash value at any time by calling its digest()<br>
+method.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>digest_size</strong> = None</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.html b/pydocs/gdata.tlslite.utils.html
new file mode 100644
index 0000000..00d872d
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.html
@@ -0,0 +1,57 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.tlslite.utils</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.utils</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/__init__.py</a></font></td></tr></table>
+ <p><tt>Toolkit for crypto and other stuff.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.tlslite.utils.AES.html">AES</a><br>
+<a href="gdata.tlslite.utils.ASN1Parser.html">ASN1Parser</a><br>
+<a href="gdata.tlslite.utils.Cryptlib_AES.html">Cryptlib_AES</a><br>
+<a href="gdata.tlslite.utils.Cryptlib_RC4.html">Cryptlib_RC4</a><br>
+<a href="gdata.tlslite.utils.Cryptlib_TripleDES.html">Cryptlib_TripleDES</a><br>
+<a href="gdata.tlslite.utils.OpenSSL_AES.html">OpenSSL_AES</a><br>
+<a href="gdata.tlslite.utils.OpenSSL_RC4.html">OpenSSL_RC4</a><br>
+<a href="gdata.tlslite.utils.OpenSSL_RSAKey.html">OpenSSL_RSAKey</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.utils.OpenSSL_TripleDES.html">OpenSSL_TripleDES</a><br>
+<a href="gdata.tlslite.utils.PyCrypto_AES.html">PyCrypto_AES</a><br>
+<a href="gdata.tlslite.utils.PyCrypto_RC4.html">PyCrypto_RC4</a><br>
+<a href="gdata.tlslite.utils.PyCrypto_RSAKey.html">PyCrypto_RSAKey</a><br>
+<a href="gdata.tlslite.utils.PyCrypto_TripleDES.html">PyCrypto_TripleDES</a><br>
+<a href="gdata.tlslite.utils.Python_AES.html">Python_AES</a><br>
+<a href="gdata.tlslite.utils.Python_RC4.html">Python_RC4</a><br>
+<a href="gdata.tlslite.utils.Python_RSAKey.html">Python_RSAKey</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.utils.RC4.html">RC4</a><br>
+<a href="gdata.tlslite.utils.RSAKey.html">RSAKey</a><br>
+<a href="gdata.tlslite.utils.TripleDES.html">TripleDES</a><br>
+<a href="gdata.tlslite.utils.cipherfactory.html">cipherfactory</a><br>
+<a href="gdata.tlslite.utils.codec.html">codec</a><br>
+<a href="gdata.tlslite.utils.compat.html">compat</a><br>
+<a href="gdata.tlslite.utils.cryptomath.html">cryptomath</a><br>
+<a href="gdata.tlslite.utils.dateFuncs.html">dateFuncs</a><br>
+</td><td width="25%" valign=top><a href="gdata.tlslite.utils.hmac.html">hmac</a><br>
+<a href="gdata.tlslite.utils.jython_compat.html">jython_compat</a><br>
+<a href="gdata.tlslite.utils.keyfactory.html">keyfactory</a><br>
+<a href="gdata.tlslite.utils.rijndael.html">rijndael</a><br>
+<a href="gdata.tlslite.utils.xmltools.html">xmltools</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__all__</strong> = ['AES', 'ASN1Parser', 'cipherfactory', 'codec', 'Cryptlib_AES', 'Cryptlib_RC4', 'Cryptlib_TripleDES', 'cryptomath: cryptomath module', 'dateFuncs', 'hmac', 'JCE_RSAKey', 'compat', 'keyfactory', 'OpenSSL_AES', 'OpenSSL_RC4', 'OpenSSL_RSAKey', 'OpenSSL_TripleDES', 'PyCrypto_AES', 'PyCrypto_RC4', 'PyCrypto_RSAKey', ...]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.jython_compat.html b/pydocs/gdata.tlslite.utils.jython_compat.html
new file mode 100644
index 0000000..3b1757c
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.jython_compat.html
@@ -0,0 +1,84 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.jython_compat</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.jython_compat</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/jython_compat.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/jython_compat.py</a></font></td></tr></table>
+ <p><tt>Miscellaneous functions to mask Python/Jython differences.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="array.html">array</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="sha.html">sha</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.jython_compat.html#CertChainBase">CertChainBase</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.jython_compat.html#ReportFuncBase">ReportFuncBase</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.jython_compat.html#SelfTestBase">SelfTestBase</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CertChainBase">class <strong>CertChainBase</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"></td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ReportFuncBase">class <strong>ReportFuncBase</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"></td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SelfTestBase">class <strong>SelfTestBase</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-bytesToString"><strong>bytesToString</strong></a>(bytes)</dt></dl>
+ <dl><dt><a name="-concatArrays"><strong>concatArrays</strong></a>(a1, a2)</dt></dl>
+ <dl><dt><a name="-createByteArraySequence"><strong>createByteArraySequence</strong></a>(seq)</dt></dl>
+ <dl><dt><a name="-createByteArrayZeros"><strong>createByteArrayZeros</strong></a>(howMany)</dt></dl>
+ <dl><dt><a name="-formatExceptionTrace"><strong>formatExceptionTrace</strong></a>(e)</dt></dl>
+ <dl><dt><a name="-getListFromSet"><strong>getListFromSet</strong></a>(set)</dt></dl>
+ <dl><dt><a name="-getSHA1"><strong>getSHA1</strong></a>(s)</dt><dd><tt>#Factory function for getting a SHA1 object</tt></dd></dl>
+ <dl><dt><a name="-iterSet"><strong>iterSet</strong></a>(set)</dt><dd><tt>#Helper functions for working with sets (from Python 2.3)</tt></dd></dl>
+ <dl><dt><a name="-numBits"><strong>numBits</strong></a>(n)</dt></dl>
+ <dl><dt><a name="-stringToBytes"><strong>stringToBytes</strong></a>(s)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__warningregistry__</strong> = {('the sets module is deprecated', <type 'exceptions.DeprecationWarning'>, 9): True}</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.keyfactory.html b/pydocs/gdata.tlslite.utils.keyfactory.html
new file mode 100644
index 0000000..725cf7a
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.keyfactory.html
@@ -0,0 +1,152 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.keyfactory</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.keyfactory</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/keyfactory.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/keyfactory.py</a></font></td></tr></table>
+ <p><tt>Factory functions for asymmetric cryptography.<br>
+@sort: generateRSAKey, parseXMLKey, parsePEMKey, parseAsPublicKey,<br>
+parseAsPrivateKey</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="array.html">array</a><br>
+<a href="gdata.tlslite.utils.cryptomath.html">gdata.tlslite.utils.cryptomath</a><br>
+</td><td width="25%" valign=top><a href="math.html">math</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-generateRSAKey"><strong>generateRSAKey</strong></a>(bits, implementations<font color="#909090">=['openssl', 'python']</font>)</dt><dd><tt>Generate an RSA key with the specified bit length.<br>
+ <br>
+@type bits: int<br>
+@param bits: Desired bit length of the new key's modulus.<br>
+ <br>
+@rtype: L{tlslite.utils.RSAKey.RSAKey}<br>
+@return: A new RSA private key.</tt></dd></dl>
+ <dl><dt><a name="-parseAsPublicKey"><strong>parseAsPublicKey</strong></a>(s)</dt><dd><tt>Parse an XML or PEM-formatted public key.<br>
+ <br>
+@type s: str<br>
+@param s: A string containing an XML or PEM-encoded public or private key.<br>
+ <br>
+@rtype: L{tlslite.utils.RSAKey.RSAKey}<br>
+@return: An RSA public key.<br>
+ <br>
+@raise SyntaxError: If the key is not properly formatted.</tt></dd></dl>
+ <dl><dt><a name="-parsePEMKey"><strong>parsePEMKey</strong></a>(s, private<font color="#909090">=False</font>, public<font color="#909090">=False</font>, passwordCallback<font color="#909090">=None</font>, implementations<font color="#909090">=['openssl', 'python']</font>)</dt><dd><tt>Parse a PEM-format key.<br>
+ <br>
+The PEM format is used by OpenSSL and other tools. The<br>
+format is typically used to store both the public and private<br>
+components of a key. For example::<br>
+ <br>
+ -----BEGIN RSA PRIVATE KEY-----<br>
+ MIICXQIBAAKBgQDYscuoMzsGmW0pAYsmyHltxB2TdwHS0dImfjCMfaSDkfLdZY5+<br>
+ dOWORVns9etWnr194mSGA1F0Pls/VJW8+cX9+3vtJV8zSdANPYUoQf0TP7VlJxkH<br>
+ dSRkUbEoz5bAAs/+970uos7n7iXQIni+3erUTdYEk2iWnMBjTljfgbK/dQIDAQAB<br>
+ AoGAJHoJZk75aKr7DSQNYIHuruOMdv5ZeDuJvKERWxTrVJqE32/xBKh42/IgqRrc<br>
+ esBN9ZregRCd7YtxoL+EVUNWaJNVx2mNmezEznrc9zhcYUrgeaVdFO2yBF1889zO<br>
+ gCOVwrO8uDgeyj6IKa25H6c1N13ih/o7ZzEgWbGG+ylU1yECQQDv4ZSJ4EjSh/Fl<br>
+ aHdz3wbBa/HKGTjC8iRy476Cyg2Fm8MZUe9Yy3udOrb5ZnS2MTpIXt5AF3h2TfYV<br>
+ VoFXIorjAkEA50FcJmzT8sNMrPaV8vn+9W2Lu4U7C+K/O2g1iXMaZms5PC5zV5aV<br>
+ CKXZWUX1fq2RaOzlbQrpgiolhXpeh8FjxwJBAOFHzSQfSsTNfttp3KUpU0LbiVvv<br>
+ i+spVSnA0O4rq79KpVNmK44Mq67hsW1P11QzrzTAQ6GVaUBRv0YS061td1kCQHnP<br>
+ wtN2tboFR6lABkJDjxoGRvlSt4SOPr7zKGgrWjeiuTZLHXSAnCY+/hr5L9Q3ZwXG<br>
+ 6x6iBdgLjVIe4BZQNtcCQQDXGv/gWinCNTN3MPWfTW/RGzuMYVmyBFais0/VrgdH<br>
+ h1dLpztmpQqfyH/zrBXQ9qL/zR4ojS6XYneO/U18WpEe<br>
+ -----END RSA PRIVATE KEY-----<br>
+ <br>
+To generate a key like this with OpenSSL, run::<br>
+ <br>
+ openssl genrsa 2048 > key.pem<br>
+ <br>
+This format also supports password-encrypted private keys. TLS<br>
+Lite can only handle password-encrypted private keys when OpenSSL<br>
+and M2Crypto are installed. In this case, passwordCallback will be<br>
+invoked to query the user for the password.<br>
+ <br>
+@type s: str<br>
+@param s: A string containing a PEM-encoded public or private key.<br>
+ <br>
+@type private: bool<br>
+@param private: If True, a L{SyntaxError} will be raised if the<br>
+private key component is not present.<br>
+ <br>
+@type public: bool<br>
+@param public: If True, the private key component (if present) will<br>
+be discarded, so this function will always return a public key.<br>
+ <br>
+@type passwordCallback: callable<br>
+@param passwordCallback: This function will be called, with no<br>
+arguments, if the PEM-encoded private key is password-encrypted.<br>
+The callback should return the password string. If the password is<br>
+incorrect, SyntaxError will be raised. If no callback is passed<br>
+and the key is password-encrypted, a prompt will be displayed at<br>
+the console.<br>
+ <br>
+@rtype: L{tlslite.utils.RSAKey.RSAKey}<br>
+@return: An RSA key.<br>
+ <br>
+@raise SyntaxError: If the key is not properly formatted.</tt></dd></dl>
+ <dl><dt><a name="-parsePrivateKey"><strong>parsePrivateKey</strong></a>(s)</dt><dd><tt>Parse an XML or PEM-formatted private key.<br>
+ <br>
+@type s: str<br>
+@param s: A string containing an XML or PEM-encoded private key.<br>
+ <br>
+@rtype: L{tlslite.utils.RSAKey.RSAKey}<br>
+@return: An RSA private key.<br>
+ <br>
+@raise SyntaxError: If the key is not properly formatted.</tt></dd></dl>
+ <dl><dt><a name="-parseXMLKey"><strong>parseXMLKey</strong></a>(s, private<font color="#909090">=False</font>, public<font color="#909090">=False</font>, implementations<font color="#909090">=['python']</font>)</dt><dd><tt>Parse an XML-format key.<br>
+ <br>
+The XML format used here is specific to tlslite and cryptoIDlib. The<br>
+format can store the public component of a key, or the public and<br>
+private components. For example::<br>
+ <br>
+ <publicKey xmlns="<a href="http://trevp.net/rsa">http://trevp.net/rsa</a>"><br>
+ <n>4a5yzB8oGNlHo866CAspAC47M4Fvx58zwK8pou...<br>
+ <e>Aw==</e><br>
+ </publicKey><br>
+ <br>
+ <privateKey xmlns="<a href="http://trevp.net/rsa">http://trevp.net/rsa</a>"><br>
+ <n>4a5yzB8oGNlHo866CAspAC47M4Fvx58zwK8pou...<br>
+ <e>Aw==</e><br>
+ <d>JZ0TIgUxWXmL8KJ0VqyG1V0J3ern9pqIoB0xmy...<br>
+ <p>5PreIj6z6ldIGL1V4+1C36dQFHNCQHJvW52GXc...<br>
+ <q>/E/wDit8YXPCxx126zTq2ilQ3IcW54NJYyNjiZ...<br>
+ <dP>mKc+wX8inDowEH45Qp4slRo1YveBgExKPROu6...<br>
+ <dQ>qDVKtBz9lk0shL5PR3ickXDgkwS576zbl2ztB...<br>
+ <qInv>j6E8EA7dNsTImaXexAmLA1DoeArsYeFAInr...<br>
+ </privateKey><br>
+ <br>
+@type s: str<br>
+@param s: A string containing an XML public or private key.<br>
+ <br>
+@type private: bool<br>
+@param private: If True, a L{SyntaxError} will be raised if the private<br>
+key component is not present.<br>
+ <br>
+@type public: bool<br>
+@param public: If True, the private key component (if present) will be<br>
+discarded, so this function will always return a public key.<br>
+ <br>
+@rtype: L{tlslite.utils.RSAKey.RSAKey}<br>
+@return: An RSA key.<br>
+ <br>
+@raise SyntaxError: If the key is not properly formatted.</tt></dd></dl>
+</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.rijndael.html b/pydocs/gdata.tlslite.utils.rijndael.html
new file mode 100644
index 0000000..4312589
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.rijndael.html
@@ -0,0 +1,101 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.rijndael</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.rijndael</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/rijndael.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/rijndael.py</a></font></td></tr></table>
+ <p><tt>A pure python (slow) implementation of <a href="#rijndael">rijndael</a> with a decent interface<br>
+ <br>
+To include -<br>
+ <br>
+from <a href="#rijndael">rijndael</a> import <a href="#rijndael">rijndael</a><br>
+ <br>
+To do a key setup -<br>
+ <br>
+r = <a href="#rijndael">rijndael</a>(key, block_size = 16)<br>
+ <br>
+key must be a string of length 16, 24, or 32<br>
+blocksize must be 16, 24, or 32. Default is 16<br>
+ <br>
+To use -<br>
+ <br>
+ciphertext = r.<a href="#-encrypt">encrypt</a>(plaintext)<br>
+plaintext = r.<a href="#-decrypt">decrypt</a>(ciphertext)<br>
+ <br>
+If any strings are of the wrong length a ValueError is thrown</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="copy.html">copy</a><br>
+<a href="exceptions.html">exceptions</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+<a href="string.html">string</a><br>
+</td><td width="25%" valign=top><a href="warnings.html">warnings</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="gdata.tlslite.utils.rijndael.html#rijndael">rijndael</a>
+</font></dt></dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="rijndael">class <strong>rijndael</strong></a></font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="rijndael-__init__"><strong>__init__</strong></a>(self, key, block_size<font color="#909090">=16</font>)</dt></dl>
+
+<dl><dt><a name="rijndael-decrypt"><strong>decrypt</strong></a>(self, ciphertext)</dt></dl>
+
+<dl><dt><a name="rijndael-encrypt"><strong>encrypt</strong></a>(self, plaintext)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-decrypt"><strong>decrypt</strong></a>(key, block)</dt></dl>
+ <dl><dt><a name="-encrypt"><strong>encrypt</strong></a>(key, block)</dt></dl>
+ <dl><dt><a name="-test"><strong>test</strong></a>()</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>S</strong> = [99, 124, 119, 123, 242, 107, 111, 197, 48, 1, 103, 43, 254, 215, 171, 118, 202, 130, 201, 125, ...]<br>
+<strong>Si</strong> = [82, 9, 106, 213, 48, 54, 165, 56, 191, 64, 163, 158, 129, 243, 215, 251, 124, 227, 57, 130, ...]<br>
+<strong>T1</strong> = [3328402341, 4168907908, 4000806809, 4135287693, 4294111757, 3597364157, 3731845041, 2445657428, 1613770832, 33620227, 3462883241, 1445669757, 3892248089, 3050821474, 1303096294, 3967186586, 2412431941, 528646813, 2311702848, 4202528135, ...]<br>
+<strong>T2</strong> = [2781242211, 2230877308, 2582542199, 2381740923, 234877682, 3184946027, 2984144751, 1418839493, 1348481072, 50462977, 2848876391, 2102799147, 434634494, 1656084439, 3863849899, 2599188086, 1167051466, 2636087938, 1082771913, 2281340285, ...]<br>
+<strong>T3</strong> = [1671808611, 2089089148, 2006576759, 2072901243, 4061003762, 1807603307, 1873927791, 3310653893, 810573872, 16974337, 1739181671, 729634347, 4263110654, 3613570519, 2883997099, 1989864566, 3393556426, 2191335298, 3376449993, 2106063485, ...]<br>
+<strong>T4</strong> = [1667474886, 2088535288, 2004326894, 2071694838, 4075949567, 1802223062, 1869591006, 3318043793, 808472672, 16843522, 1734846926, 724270422, 4278065639, 3621216949, 2880169549, 1987484396, 3402253711, 2189597983, 3385409673, 2105378810, ...]<br>
+<strong>T5</strong> = [1374988112, 2118214995, 437757123, 975658646, 1001089995, 530400753, 2902087851, 1273168787, 540080725, 2910219766, 2295101073, 4110568485, 1340463100, 3307916247, 641025152, 3043140495, 3736164937, 632953703, 1172967064, 1576976609, ...]<br>
+<strong>T6</strong> = [1347548327, 1400783205, 3273267108, 2520393566, 3409685355, 4045380933, 2880240216, 2471224067, 1428173050, 4138563181, 2441661558, 636813900, 4233094615, 3620022987, 2149987652, 2411029155, 1239331162, 1730525723, 2554718734, 3781033664, ...]<br>
+<strong>T7</strong> = [2807058932, 1699970625, 2764249623, 1586903591, 1808481195, 1173430173, 1487645946, 59984867, 4199882800, 1844882806, 1989249228, 1277555970, 3623636965, 3419915562, 1149249077, 2744104290, 1514790577, 459744698, 244860394, 3235995134, ...]<br>
+<strong>T8</strong> = [4104605777, 1097159550, 396673818, 660510266, 2875968315, 2638606623, 4200115116, 3808662347, 821712160, 1986918061, 3430322568, 38544885, 3856137295, 718002117, 893681702, 1654886325, 2975484382, 3122358053, 3926825029, 4274053469, ...]<br>
+<strong>U1</strong> = [0, 235474187, 470948374, 303765277, 941896748, 908933415, 607530554, 708780849, 1883793496, 2118214995, 1817866830, 1649639237, 1215061108, 1181045119, 1417561698, 1517767529, 3767586992, 4003061179, 4236429990, 4069246893, ...]<br>
+<strong>U2</strong> = [0, 185469197, 370938394, 487725847, 741876788, 657861945, 975451694, 824852259, 1483753576, 1400783205, 1315723890, 1164071807, 1950903388, 2135319889, 1649704518, 1767536459, 2967507152, 3152976349, 2801566410, 2918353863, ...]<br>
+<strong>U3</strong> = [0, 218828297, 437656594, 387781147, 875313188, 958871085, 775562294, 590424639, 1750626376, 1699970625, 1917742170, 2135253587, 1551124588, 1367295589, 1180849278, 1265195639, 3501252752, 3720081049, 3399941250, 3350065803, ...]<br>
+<strong>U4</strong> = [0, 151849742, 303699484, 454499602, 607398968, 758720310, 908999204, 1059270954, 1214797936, 1097159550, 1517440620, 1400849762, 1817998408, 1699839814, 2118541908, 2001430874, 2429595872, 2581445614, 2194319100, 2345119218, ...]<br>
+<strong>num_rounds</strong> = {16: {16: 10, 24: 12, 32: 14}, 24: {16: 12, 24: 12, 32: 14}, 32: {16: 14, 24: 14, 32: 14}}<br>
+<strong>rcon</strong> = [1, 2, 4, 8, 16, 32, 64, 128, 27, 54, 108, 216, 171, 77, 154, 47, 94, 188, 99, 198, ...]<br>
+<strong>shifts</strong> = [[[0, 0], [1, 3], [2, 2], [3, 1]], [[0, 0], [1, 5], [2, 4], [3, 3]], [[0, 0], [1, 7], [3, 5], [4, 4]]]</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.tlslite.utils.xmltools.html b/pydocs/gdata.tlslite.utils.xmltools.html
new file mode 100644
index 0000000..0a8f79d
--- /dev/null
+++ b/pydocs/gdata.tlslite.utils.xmltools.html
@@ -0,0 +1,72 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.tlslite.utils.xmltools</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.tlslite.html"><font color="#ffffff">tlslite</font></a>.<a href="gdata.tlslite.utils.html"><font color="#ffffff">utils</font></a>.xmltools</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/xmltools.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/tlslite/utils/xmltools.py</a></font></td></tr></table>
+ <p><tt>Helper functions for XML.<br>
+ <br>
+This module has misc. helper functions for working with XML DOM nodes.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="array.html">array</a><br>
+<a href="math.html">math</a><br>
+</td><td width="25%" valign=top><a href="xml.dom.minidom.html">xml.dom.minidom</a><br>
+<a href="os.html">os</a><br>
+</td><td width="25%" valign=top><a href="re.html">re</a><br>
+<a href="xml.sax.saxutils.html">xml.sax.saxutils</a><br>
+</td><td width="25%" valign=top><a href="sys.html">sys</a><br>
+<a href="traceback.html">traceback</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-checkName"><strong>checkName</strong></a>(element, name)</dt></dl>
+ <dl><dt><a name="-checkNoMoreAttributes"><strong>checkNoMoreAttributes</strong></a>(element)</dt></dl>
+ <dl><dt><a name="-escape"><strong>escape</strong></a>(s)</dt></dl>
+ <dl><dt><a name="-getAttribute"><strong>getAttribute</strong></a>(element, attrName, regEx<font color="#909090">=''</font>)</dt></dl>
+ <dl><dt><a name="-getChild"><strong>getChild</strong></a>(element, index, name<font color="#909090">=None</font>)</dt></dl>
+ <dl><dt><a name="-getChildIter"><strong>getChildIter</strong></a>(element, index)</dt></dl>
+ <dl><dt><a name="-getChildOrNone"><strong>getChildOrNone</strong></a>(element, index)</dt></dl>
+ <dl><dt><a name="-getLastChild"><strong>getLastChild</strong></a>(element, index, name<font color="#909090">=None</font>)</dt></dl>
+ <dl><dt><a name="-getReqAttribute"><strong>getReqAttribute</strong></a>(element, attrName, regEx<font color="#909090">=''</font>)</dt></dl>
+ <dl><dt><a name="-getText"><strong>getText</strong></a>(element, regEx<font color="#909090">=''</font>)</dt></dl>
+ <dl><dt><a name="-indent"><strong>indent</strong></a>(s, steps, ch<font color="#909090">='<font color="#c040c0">\t</font>'</font>)</dt><dd><tt>#Function for adding tabs to a string</tt></dd></dl>
+ <dl><dt><a name="-parseAndStripWhitespace"><strong>parseAndStripWhitespace</strong></a>(s)</dt></dl>
+ <dl><dt><a name="-parseDocument"><strong>parseDocument</strong></a>(s)</dt></dl>
+ <dl><dt><a name="-stripWhitespace"><strong>stripWhitespace</strong></a>(element, tab<font color="#909090">=0</font>)</dt><dd><tt>#Goes through a DOM tree and removes whitespace besides child elements,<br>
+#as long as this whitespace is correctly tab-ified</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>base64RegEx</strong> = r'[A-Za-z0-9+/]+={0,4}\Z'<br>
+<strong>booleanRegEx</strong> = '(true)|(false)'<br>
+<strong>certsListRegEx</strong> = r'(0)?(1)?(2)?(3)?(4)?(5)?(6)?(7)?(8)?(9)?\Z'<br>
+<strong>cryptoIDRegEx</strong> = r'([a-km-z3-9]{5}\.){3}[a-km-z3-9]{5}\Z'<br>
+<strong>dateTimeRegEx</strong> = r'\d\d\d\d-\d\d-\d\dT\d\d:\d\d:\d\dZ\Z'<br>
+<strong>exprRegEx</strong> = r'[a-zA-Z0-9 ,()]{1,200}\Z'<br>
+<strong>keyRegEx</strong> = r'[A-Z]\Z'<br>
+<strong>keysListRegEx</strong> = r'(A)?(B)?(C)?(D)?(E)?(F)?(G)?(H)?(I)?(J)?(K)?(L)?...O)?(P)?(Q)?(R)?(S)?(T)?(U)?(V)?(W)?(X)?(Y)?(Z)?\Z'<br>
+<strong>notAfterDeltaRegEx</strong> = r'0|([1-9][0-9]{0,8})\Z'<br>
+<strong>nsRegEx</strong> = r'http://trevp.net/cryptoID\Z'<br>
+<strong>sha1Base64RegEx</strong> = r'[A-Za-z0-9+/]{27}=\Z'<br>
+<strong>shortStringRegEx</strong> = r'.{1,100}\Z'<br>
+<strong>urlRegEx</strong> = r'http(s)?://.{1,100}\Z'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.urlfetch.html b/pydocs/gdata.urlfetch.html
new file mode 100644
index 0000000..865c50f
--- /dev/null
+++ b/pydocs/gdata.urlfetch.html
@@ -0,0 +1,212 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.urlfetch</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.urlfetch</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/urlfetch.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/urlfetch.py</a></font></td></tr></table>
+ <p><tt>Provides HTTP functions for gdata.service to use on Google App Engine<br>
+ <br>
+<a href="#AppEngineHttpClient">AppEngineHttpClient</a>: Provides an HTTP request method which uses App Engine's<br>
+ urlfetch API. Set the http_client member of a GDataService <a href="__builtin__.html#object">object</a> to an<br>
+ instance of an <a href="#AppEngineHttpClient">AppEngineHttpClient</a> to allow the gdata library to run on<br>
+ Google App Engine.<br>
+ <br>
+run_on_appengine: Function which will modify an existing GDataService <a href="__builtin__.html#object">object</a><br>
+ to allow it to run on App Engine. It works by creating a new instance of<br>
+ the <a href="#AppEngineHttpClient">AppEngineHttpClient</a> and replacing the GDataService <a href="__builtin__.html#object">object</a>'s <br>
+ http_client.<br>
+ <br>
+HttpRequest: Function that wraps google.appengine.api.urlfetch.Fetch in a <br>
+ common interface which is used by gdata.service.GDataService. In other <br>
+ words, this module can be used as the gdata service request handler so <br>
+ that all HTTP requests will be performed by the hosting Google App Engine<br>
+ server.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="StringIO.html">StringIO</a><br>
+</td><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="google.appengine.api.urlfetch.html">google.appengine.api.urlfetch</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="__builtin__.html#object">__builtin__.object</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.urlfetch.html#HttpResponse">HttpResponse</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.urlfetch.html#AppEngineHttpClient">AppEngineHttpClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="AppEngineHttpClient">class <strong>AppEngineHttpClient</strong></a>(<a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.urlfetch.html#AppEngineHttpClient">AppEngineHttpClient</a></dd>
+<dd><a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="AppEngineHttpClient-__init__"><strong>__init__</strong></a>(self, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AppEngineHttpClient-request"><strong>request</strong></a>(self, operation, url, data<font color="#909090">=None</font>, headers<font color="#909090">=None</font>)</dt><dd><tt>Performs an HTTP call to the server, supports GET, POST, PUT, and<br>
+DELETE.<br>
+ <br>
+Usage example, perform and HTTP GET on <a href="http://www.google.com/">http://www.google.com/</a>:<br>
+ import atom.http<br>
+ client = atom.http.HttpClient()<br>
+ http_response = client.<a href="#AppEngineHttpClient-request">request</a>('GET', '<a href="http://www.google.com/">http://www.google.com/</a>')<br>
+ <br>
+Args:<br>
+ operation: str The HTTP operation to be performed. This is usually one<br>
+ of 'GET', 'POST', 'PUT', or 'DELETE'<br>
+ data: filestream, list of parts, or other <a href="__builtin__.html#object">object</a> which can be converted<br>
+ to a string. Should be set to None when performing a GET or DELETE.<br>
+ If data is a file-like <a href="__builtin__.html#object">object</a> which can be read, this method will<br>
+ read a chunk of 100K bytes at a time and send them.<br>
+ If the data is a list of parts to be sent, each part will be<br>
+ evaluated and sent.<br>
+ url: The full URL to which the request should be sent. Can be a string<br>
+ or atom.url.Url.<br>
+ headers: dict of strings. HTTP headers which should be sent<br>
+ in the request.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><a name="AppEngineHttpClient-delete"><strong>delete</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AppEngineHttpClient-get"><strong>get</strong></a>(self, url, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AppEngineHttpClient-post"><strong>post</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="AppEngineHttpClient-put"><strong>put</strong></a>(self, url, data, headers<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.http_interface.html#GenericHttpClient">atom.http_interface.GenericHttpClient</a>:<br>
+<dl><dt><strong>debug</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="HttpResponse">class <strong>HttpResponse</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Translates a urlfetch resoinse to look like an hhtplib resoinse.<br>
+ <br>
+Used to allow the resoinse from HttpRequest to be usable by gdata.service<br>
+methods.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%">Methods defined here:<br>
+<dl><dt><a name="HttpResponse-__init__"><strong>__init__</strong></a>(self, urlfetch_response)</dt></dl>
+
+<dl><dt><a name="HttpResponse-getheader"><strong>getheader</strong></a>(self, name)</dt></dl>
+
+<dl><dt><a name="HttpResponse-read"><strong>read</strong></a>(self, length<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-HttpRequest"><strong>HttpRequest</strong></a>(service, operation, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, content_type<font color="#909090">='application/atom+xml'</font>)</dt><dd><tt>Performs an HTTP call to the server, supports GET, POST, PUT, and DELETE.<br>
+ <br>
+This function is deprecated, use <a href="#AppEngineHttpClient">AppEngineHttpClient</a>.request instead.<br>
+ <br>
+To use this module with gdata.service, you can set this module to be the<br>
+http_request_handler so that HTTP requests use Google App Engine's urlfetch.<br>
+import gdata.service<br>
+import gdata.urlfetch<br>
+gdata.service.http_request_handler = gdata.urlfetch<br>
+ <br>
+Args:<br>
+ service: atom.AtomService <a href="__builtin__.html#object">object</a> which contains some of the parameters<br>
+ needed to make the request. The following members are used to<br>
+ construct the HTTP call: server (str), additional_headers (dict),<br>
+ port (int), and ssl (bool).<br>
+ operation: str The HTTP operation to be performed. This is usually one of<br>
+ 'GET', 'POST', 'PUT', or 'DELETE'<br>
+ data: filestream, list of parts, or other <a href="__builtin__.html#object">object</a> which can be<br>
+ converted to a string.<br>
+ Should be set to None when performing a GET or PUT.<br>
+ If data is a file-like <a href="__builtin__.html#object">object</a> which can be read, this method will read<br>
+ a chunk of 100K bytes at a time and send them.<br>
+ If the data is a list of parts to be sent, each part will be evaluated<br>
+ and sent.<br>
+ uri: The beginning of the URL to which the request should be sent.<br>
+ Examples: '/', '/base/feeds/snippets',<br>
+ '/m8/feeds/contacts/default/base'<br>
+ extra_headers: dict of strings. HTTP headers which should be sent<br>
+ in the request. These headers are in addition to those stored in<br>
+ service.additional_headers.<br>
+ url_params: dict of strings. Key value pairs to be added to the URL as<br>
+ URL parameters. For example {'foo':'bar', 'test':'param'} will<br>
+ become ?foo=bar&test=param.<br>
+ escape_params: bool default True. If true, the keys and values in<br>
+ url_params will be URL escaped when the form is constructed<br>
+ (Special characters converted to %XX form.)<br>
+ content_type: str The MIME type for the data being sent. Defaults to<br>
+ 'application/atom+xml', this is only used if data is set.</tt></dd></dl>
+ <dl><dt><a name="-run_on_appengine"><strong>run_on_appengine</strong></a>(gdata_service)</dt><dd><tt>Modifies a GDataService <a href="__builtin__.html#object">object</a> to allow it to run on App Engine.<br>
+ <br>
+Args:<br>
+ gdata_service: An instance of AtomService, GDataService, or any<br>
+ of their subclasses which has an http_client member.</tt></dd></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>__author__</strong> = 'api.jscudder (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.jscudder (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.webmastertools.data.html b/pydocs/gdata.webmastertools.data.html
new file mode 100644
index 0000000..46d34f1
--- /dev/null
+++ b/pydocs/gdata.webmastertools.data.html
@@ -0,0 +1,6809 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.webmastertools.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.webmastertools.html"><font color="#ffffff">webmastertools</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/webmastertools/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/webmastertools/data.py</a></font></td></tr></table>
+ <p><tt>Contains the data classes of the Google Webmaster Tools Data API</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#CrawlIssueCrawlType">CrawlIssueCrawlType</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#CrawlIssueDateDetected">CrawlIssueDateDetected</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#CrawlIssueDetail">CrawlIssueDetail</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#CrawlIssueIssueType">CrawlIssueIssueType</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#CrawlIssueLinkedFromUrl">CrawlIssueLinkedFromUrl</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#CrawlIssueUrl">CrawlIssueUrl</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#Indexed">Indexed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#Keyword">Keyword</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#LastCrawled">LastCrawled</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#MessageBody">MessageBody</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#MessageDate">MessageDate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#MessageLanguage">MessageLanguage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#MessageRead">MessageRead</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#MessageSubject">MessageSubject</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#SiteId">SiteId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#SitemapMobile">SitemapMobile</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#SitemapMobileMarkupLanguage">SitemapMobileMarkupLanguage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#SitemapNews">SitemapNews</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#SitemapNewsPublicationLabel">SitemapNewsPublicationLabel</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#SitemapType">SitemapType</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#SitemapUrlCount">SitemapUrlCount</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#VerificationMethod">VerificationMethod</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#Verified">Verified</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#CrawlIssueEntry">CrawlIssueEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#KeywordEntry">KeywordEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#MessageEntry">MessageEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#SiteEntry">SiteEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#SitemapEntry">SitemapEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#CrawlIssuesFeed">CrawlIssuesFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#KeywordsFeed">KeywordsFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#MessagesFeed">MessagesFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#SitemapsFeed">SitemapsFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.data.html#SitesFeed">SitesFeed</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CrawlIssueCrawlType">class <strong>CrawlIssueCrawlType</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Type of crawl of the crawl issue<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#CrawlIssueCrawlType">CrawlIssueCrawlType</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CrawlIssueCrawlType-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueCrawlType-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueCrawlType-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueCrawlType-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueCrawlType-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueCrawlType-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CrawlIssueCrawlType-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueCrawlType-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueCrawlType-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueCrawlType-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CrawlIssueDateDetected">class <strong>CrawlIssueDateDetected</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Detection date for the issue<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#CrawlIssueDateDetected">CrawlIssueDateDetected</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CrawlIssueDateDetected-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDateDetected-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDateDetected-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDateDetected-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDateDetected-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDateDetected-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CrawlIssueDateDetected-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueDateDetected-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDateDetected-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDateDetected-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CrawlIssueDetail">class <strong>CrawlIssueDetail</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Detail of the crawl issue<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#CrawlIssueDetail">CrawlIssueDetail</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CrawlIssueDetail-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDetail-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDetail-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDetail-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDetail-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDetail-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CrawlIssueDetail-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueDetail-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDetail-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueDetail-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CrawlIssueEntry">class <strong>CrawlIssueEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a crawl issue entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#CrawlIssueEntry">CrawlIssueEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>crawl_type</strong> = <class 'gdata.webmastertools.data.CrawlIssueCrawlType'><dd><tt>Type of crawl of the crawl issue</tt></dl>
+
+<dl><dt><strong>date_detected</strong> = <class 'gdata.webmastertools.data.CrawlIssueDateDetected'><dd><tt>Detection date for the issue</tt></dl>
+
+<dl><dt><strong>detail</strong> = <class 'gdata.webmastertools.data.CrawlIssueDetail'><dd><tt>Detail of the crawl issue</tt></dl>
+
+<dl><dt><strong>issue_type</strong> = <class 'gdata.webmastertools.data.CrawlIssueIssueType'><dd><tt>Type of crawl issue</tt></dl>
+
+<dl><dt><strong>linked_from</strong> = [<class 'gdata.webmastertools.data.CrawlIssueLinkedFromUrl'>]</dl>
+
+<dl><dt><strong>url</strong> = <class 'gdata.webmastertools.data.CrawlIssueUrl'><dd><tt>URL affected by the crawl issue</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CrawlIssueEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CrawlIssueEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CrawlIssueEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CrawlIssueEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CrawlIssueEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CrawlIssueIssueType">class <strong>CrawlIssueIssueType</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Type of crawl issue<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#CrawlIssueIssueType">CrawlIssueIssueType</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CrawlIssueIssueType-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueIssueType-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueIssueType-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueIssueType-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueIssueType-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueIssueType-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CrawlIssueIssueType-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueIssueType-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueIssueType-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueIssueType-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CrawlIssueLinkedFromUrl">class <strong>CrawlIssueLinkedFromUrl</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Source URL that links to the issue URL<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#CrawlIssueLinkedFromUrl">CrawlIssueLinkedFromUrl</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CrawlIssueLinkedFromUrl-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueLinkedFromUrl-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueLinkedFromUrl-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueLinkedFromUrl-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueLinkedFromUrl-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueLinkedFromUrl-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CrawlIssueLinkedFromUrl-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueLinkedFromUrl-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueLinkedFromUrl-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueLinkedFromUrl-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CrawlIssueUrl">class <strong>CrawlIssueUrl</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>URL affected by the crawl issue<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#CrawlIssueUrl">CrawlIssueUrl</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CrawlIssueUrl-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueUrl-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueUrl-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueUrl-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueUrl-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueUrl-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="CrawlIssueUrl-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssueUrl-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueUrl-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssueUrl-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CrawlIssuesFeed">class <strong>CrawlIssuesFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Feed of crawl issues for a particular site<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#CrawlIssuesFeed">CrawlIssuesFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.webmastertools.data.CrawlIssueEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CrawlIssuesFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CrawlIssuesFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CrawlIssuesFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CrawlIssuesFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CrawlIssuesFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CrawlIssuesFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Indexed">class <strong>Indexed</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the indexing status of a site<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#Indexed">Indexed</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Indexed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Indexed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Indexed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Indexed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Indexed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Indexed-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Indexed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Indexed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Indexed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Indexed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Keyword">class <strong>Keyword</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A keyword in a site or in a link to a site<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#Keyword">Keyword</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>source</strong> = 'source'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Keyword-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Keyword-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Keyword-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Keyword-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Keyword-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Keyword-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Keyword-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Keyword-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Keyword-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Keyword-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="KeywordEntry">class <strong>KeywordEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a keyword entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#KeywordEntry">KeywordEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="KeywordEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="KeywordEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="KeywordEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="KeywordEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="KeywordEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="KeywordEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="KeywordsFeed">class <strong>KeywordsFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Feed of keywords for a particular site<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#KeywordsFeed">KeywordsFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.webmastertools.data.KeywordEntry'>]</dl>
+
+<dl><dt><strong>keyword</strong> = [<class 'gdata.webmastertools.data.Keyword'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="KeywordsFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="KeywordsFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="KeywordsFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="KeywordsFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="KeywordsFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="KeywordsFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="KeywordsFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LastCrawled">class <strong>LastCrawled</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the last crawled date of a site<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#LastCrawled">LastCrawled</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="LastCrawled-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastCrawled-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastCrawled-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LastCrawled-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastCrawled-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="LastCrawled-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="LastCrawled-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LastCrawled-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="LastCrawled-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="LastCrawled-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MessageBody">class <strong>MessageBody</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Message body<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#MessageBody">MessageBody</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MessageBody-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageBody-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageBody-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageBody-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageBody-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MessageBody-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MessageBody-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageBody-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageBody-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageBody-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MessageDate">class <strong>MessageDate</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Message date<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#MessageDate">MessageDate</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MessageDate-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageDate-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageDate-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageDate-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageDate-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MessageDate-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MessageDate-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageDate-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageDate-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageDate-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MessageEntry">class <strong>MessageEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a message entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#MessageEntry">MessageEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>body</strong> = <class 'gdata.webmastertools.data.MessageBody'><dd><tt>Message body</tt></dl>
+
+<dl><dt><strong>date</strong> = <class 'gdata.webmastertools.data.MessageDate'><dd><tt>Message date</tt></dl>
+
+<dl><dt><strong>language</strong> = <class 'gdata.webmastertools.data.MessageLanguage'><dd><tt>Message language</tt></dl>
+
+<dl><dt><strong>read</strong> = <class 'gdata.webmastertools.data.MessageRead'><dd><tt>Indicates if the message has already been read</tt></dl>
+
+<dl><dt><strong>subject</strong> = <class 'gdata.webmastertools.data.MessageSubject'><dd><tt>Message subject</tt></dl>
+
+<dl><dt><strong>wt_id</strong> = <class 'gdata.webmastertools.data.SiteId'><dd><tt>Site URL</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="MessageEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="MessageEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MessageEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="MessageEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="MessageEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="MessageEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MessageLanguage">class <strong>MessageLanguage</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Message language<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#MessageLanguage">MessageLanguage</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MessageLanguage-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageLanguage-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageLanguage-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageLanguage-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageLanguage-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MessageLanguage-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MessageLanguage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageLanguage-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageLanguage-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageLanguage-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MessageRead">class <strong>MessageRead</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Indicates if the message has already been read<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#MessageRead">MessageRead</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MessageRead-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageRead-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageRead-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageRead-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageRead-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MessageRead-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MessageRead-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageRead-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageRead-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageRead-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MessageSubject">class <strong>MessageSubject</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Message subject<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#MessageSubject">MessageSubject</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MessageSubject-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageSubject-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageSubject-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageSubject-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageSubject-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MessageSubject-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="MessageSubject-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessageSubject-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessageSubject-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessageSubject-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MessagesFeed">class <strong>MessagesFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a messages feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#MessagesFeed">MessagesFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.webmastertools.data.MessageEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="MessagesFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="MessagesFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="MessagesFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="MessagesFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="MessagesFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="MessagesFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="MessagesFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SiteEntry">class <strong>SiteEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a site entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#SiteEntry">SiteEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>indexed</strong> = <class 'gdata.webmastertools.data.Indexed'><dd><tt>Describes the indexing status of a site</tt></dl>
+
+<dl><dt><strong>last_crawled</strong> = <class 'gdata.webmastertools.data.LastCrawled'><dd><tt>Describes the last crawled date of a site</tt></dl>
+
+<dl><dt><strong>verification_method</strong> = [<class 'gdata.webmastertools.data.VerificationMethod'>]</dl>
+
+<dl><dt><strong>verified</strong> = <class 'gdata.webmastertools.data.Verified'><dd><tt>Describes the verification status of a site</tt></dl>
+
+<dl><dt><strong>wt_id</strong> = <class 'gdata.webmastertools.data.SiteId'><dd><tt>Site URL</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="SiteEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="SiteEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SiteEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="SiteEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="SiteEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SiteEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SiteId">class <strong>SiteId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Site URL<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#SiteId">SiteId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SiteId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SiteId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SiteId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SiteId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SiteId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SiteId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SiteId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapEntry">class <strong>SitemapEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a sitemap entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#SitemapEntry">SitemapEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>indexed</strong> = <class 'gdata.webmastertools.data.Indexed'><dd><tt>Describes the indexing status of a site</tt></dl>
+
+<dl><dt><strong>wt_id</strong> = <class 'gdata.webmastertools.data.SiteId'><dd><tt>Site URL</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="SitemapEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="SitemapEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SitemapEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="SitemapEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="SitemapEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SitemapEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapMobile">class <strong>SitemapMobile</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Lists acceptable mobile markup languages for URLs in this sitemap<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#SitemapMobile">SitemapMobile</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>sitemap_mobile_markup_language</strong> = [<class 'gdata.webmastertools.data.SitemapMobileMarkupLanguage'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SitemapMobile-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobile-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobile-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobile-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobile-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobile-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitemapMobile-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapMobile-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobile-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobile-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapMobileMarkupLanguage">class <strong>SitemapMobileMarkupLanguage</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a markup language for URLs in this sitemap<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#SitemapMobileMarkupLanguage">SitemapMobileMarkupLanguage</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SitemapMobileMarkupLanguage-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobileMarkupLanguage-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobileMarkupLanguage-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobileMarkupLanguage-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobileMarkupLanguage-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobileMarkupLanguage-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitemapMobileMarkupLanguage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapMobileMarkupLanguage-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobileMarkupLanguage-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobileMarkupLanguage-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapNews">class <strong>SitemapNews</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Lists publication labels for this sitemap<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#SitemapNews">SitemapNews</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>sitemap_news_publication_label</strong> = [<class 'gdata.webmastertools.data.SitemapNewsPublicationLabel'>]</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SitemapNews-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNews-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNews-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNews-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNews-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNews-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitemapNews-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapNews-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNews-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNews-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapNewsPublicationLabel">class <strong>SitemapNewsPublicationLabel</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Specifies the publication label for this sitemap<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#SitemapNewsPublicationLabel">SitemapNewsPublicationLabel</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SitemapNewsPublicationLabel-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNewsPublicationLabel-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNewsPublicationLabel-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNewsPublicationLabel-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNewsPublicationLabel-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNewsPublicationLabel-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitemapNewsPublicationLabel-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapNewsPublicationLabel-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNewsPublicationLabel-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNewsPublicationLabel-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapType">class <strong>SitemapType</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Indicates the type of sitemap. Not used for News or Mobile Sitemaps<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#SitemapType">SitemapType</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SitemapType-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapType-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapType-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapType-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapType-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapType-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitemapType-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapType-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapType-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapType-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapUrlCount">class <strong>SitemapUrlCount</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Indicates the number of URLs contained in the sitemap<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#SitemapUrlCount">SitemapUrlCount</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SitemapUrlCount-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapUrlCount-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapUrlCount-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapUrlCount-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapUrlCount-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapUrlCount-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="SitemapUrlCount-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapUrlCount-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapUrlCount-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapUrlCount-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapsFeed">class <strong>SitemapsFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a sitemaps feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#SitemapsFeed">SitemapsFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.webmastertools.data.SitemapEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="SitemapsFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="SitemapsFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SitemapsFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="SitemapsFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="SitemapsFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitesFeed">class <strong>SitesFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a sites feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#SitesFeed">SitesFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.webmastertools.data.SiteEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="SitesFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="SitesFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SitesFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="SitesFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="SitesFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VerificationMethod">class <strong>VerificationMethod</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a verification method that may be used for a site<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#VerificationMethod">VerificationMethod</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>in_use</strong> = 'in-use'</dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="VerificationMethod-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VerificationMethod-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VerificationMethod-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VerificationMethod-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VerificationMethod-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="VerificationMethod-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="VerificationMethod-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VerificationMethod-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VerificationMethod-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VerificationMethod-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Verified">class <strong>Verified</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes the verification status of a site<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.data.html#Verified">Verified</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="Verified-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Verified-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Verified-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Verified-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Verified-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="Verified-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="Verified-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="Verified-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="Verified-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="Verified-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>WT_TEMPLATE</strong> = '{http://schemas.google.com/webmaster/tools/2007/}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.webmastertools.html b/pydocs/gdata.webmastertools.html
new file mode 100644
index 0000000..631b54f
--- /dev/null
+++ b/pydocs/gdata.webmastertools.html
@@ -0,0 +1,1464 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.webmastertools</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.webmastertools</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/webmastertools/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/webmastertools/__init__.py</a></font></td></tr></table>
+ <p><tt>Contains extensions to Atom objects used with Google Webmaster Tools.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.webmastertools.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.webmastertools.service.html">service</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#CrawlRate">CrawlRate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#EnhancedImageSearch">EnhancedImageSearch</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#GeoLocation">GeoLocation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#Indexed">Indexed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#MarkupLanguage">MarkupLanguage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#PreferredDomain">PreferredDomain</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#PublicationLabel">PublicationLabel</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapMobile">SitemapMobile</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapMobileMarkupLanguage">SitemapMobileMarkupLanguage</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapNews">SitemapNews</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapNewsPublicationLabel">SitemapNewsPublicationLabel</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapStatus">SitemapStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapType">SitemapType</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapUrlCount">SitemapUrlCount</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#VerificationMethod">VerificationMethod</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#VerificationMethodMeta">VerificationMethodMeta</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#Verified">Verified</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Date">atom.Date</a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#Crawled">Crawled</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapLastDownloaded">SitemapLastDownloaded</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Entry">atom.Entry</a>(<a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapsEntry">SitemapsEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitesEntry">SitesEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#Feed">atom.Feed</a>(<a href="atom.html#Source">atom.Source</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapsFeed">SitemapsFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitesFeed">SitesFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.html#LinkFinder">atom.LinkFinder</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapsEntry">SitemapsEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitemapsFeed">SitemapsFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitesEntry">SitesEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.webmastertools.html#SitesFeed">SitesFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CrawlRate">class <strong>CrawlRate</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#CrawlRate">CrawlRate</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="CrawlRate-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="CrawlRate-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="CrawlRate-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="CrawlRate-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Crawled">class <strong>Crawled</strong></a>(<a href="atom.html#Date">atom.Date</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#Crawled">Crawled</a></dd>
+<dd><a href="atom.html#Date">atom.Date</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Date">atom.Date</a>:<br>
+<dl><dt><a name="Crawled-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Crawled-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Crawled-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Crawled-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="EnhancedImageSearch">class <strong>EnhancedImageSearch</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#EnhancedImageSearch">EnhancedImageSearch</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="EnhancedImageSearch-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="EnhancedImageSearch-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="EnhancedImageSearch-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="EnhancedImageSearch-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GeoLocation">class <strong>GeoLocation</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#GeoLocation">GeoLocation</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="GeoLocation-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="GeoLocation-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="GeoLocation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="GeoLocation-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Indexed">class <strong>Indexed</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#Indexed">Indexed</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Indexed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Indexed-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Indexed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Indexed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LinkFinder">class <strong>LinkFinder</strong></a>(<a href="atom.html#LinkFinder">atom.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>An "interface" providing methods to find link elements<br>
+ <br>
+<a href="#SitesEntry">SitesEntry</a> elements often contain multiple links which differ in the rel <br>
+attribute or content type. Often, developers are interested in a specific<br>
+type of link so this class provides methods to find specific classes of links.<br>
+ <br>
+This class is used as a mixin in <a href="#SitesEntry">SitesEntry</a>.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="LinkFinder-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="LinkFinder-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="LinkFinder-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="LinkFinder-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="MarkupLanguage">class <strong>MarkupLanguage</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#MarkupLanguage">MarkupLanguage</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="MarkupLanguage-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="MarkupLanguage-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="MarkupLanguage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="MarkupLanguage-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PreferredDomain">class <strong>PreferredDomain</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#PreferredDomain">PreferredDomain</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PreferredDomain-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PreferredDomain-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="PreferredDomain-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PreferredDomain-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PublicationLabel">class <strong>PublicationLabel</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#PublicationLabel">PublicationLabel</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="PublicationLabel-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="PublicationLabel-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="PublicationLabel-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="PublicationLabel-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapLastDownloaded">class <strong>SitemapLastDownloaded</strong></a>(<a href="atom.html#Date">atom.Date</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitemapLastDownloaded">SitemapLastDownloaded</a></dd>
+<dd><a href="atom.html#Date">atom.Date</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Date">atom.Date</a>:<br>
+<dl><dt><a name="SitemapLastDownloaded-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitemapLastDownloaded-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapLastDownloaded-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitemapLastDownloaded-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapMobile">class <strong>SitemapMobile</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitemapMobile">SitemapMobile</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SitemapMobile-__init__"><strong>__init__</strong></a>(self, markup_language<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitemapMobile-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobile-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitemapMobile-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapMobileMarkupLanguage">class <strong>SitemapMobileMarkupLanguage</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitemapMobileMarkupLanguage">SitemapMobileMarkupLanguage</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitemapMobileMarkupLanguage-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobileMarkupLanguage-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="SitemapMobileMarkupLanguage-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitemapMobileMarkupLanguage-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapNews">class <strong>SitemapNews</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitemapNews">SitemapNews</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SitemapNews-__init__"><strong>__init__</strong></a>(self, publication_label<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitemapNews-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNews-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitemapNews-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapNewsPublicationLabel">class <strong>SitemapNewsPublicationLabel</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitemapNewsPublicationLabel">SitemapNewsPublicationLabel</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitemapNewsPublicationLabel-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNewsPublicationLabel-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="SitemapNewsPublicationLabel-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitemapNewsPublicationLabel-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapStatus">class <strong>SitemapStatus</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitemapStatus">SitemapStatus</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitemapStatus-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapStatus-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="SitemapStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitemapStatus-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapType">class <strong>SitemapType</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitemapType">SitemapType</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitemapType-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapType-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="SitemapType-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitemapType-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapUrlCount">class <strong>SitemapUrlCount</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitemapUrlCount">SitemapUrlCount</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitemapUrlCount-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapUrlCount-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="SitemapUrlCount-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitemapUrlCount-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapsEntry">class <strong>SitemapsEntry</strong></a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Webmaster Tools meta Sitemaps <a href="atom.html#Entry">Entry</a> flavor of an Atom <a href="atom.html#Entry">Entry</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitemapsEntry">SitemapsEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SitemapsEntry-__init__"><strong>__init__</strong></a>(self, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, sitemap_type<font color="#909090">=None</font>, sitemap_status<font color="#909090">=None</font>, sitemap_last_downloaded<font color="#909090">=None</font>, sitemap_url_count<font color="#909090">=None</font>, sitemap_mobile_markup_language<font color="#909090">=None</font>, sitemap_news_publication_label<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitemapsEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitemapsEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="SitemapsEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SitemapsEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitemapsFeed">class <strong>SitemapsFeed</strong></a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Webmaster Tools meta Sitemaps feed flavor of an Atom <a href="atom.html#Feed">Feed</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitemapsFeed">SitemapsFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SitemapsFeed-__init__"><strong>__init__</strong></a>(self, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, sitemap_mobile<font color="#909090">=None</font>, sitemap_news<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitemapsFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitemapsFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="SitemapsFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SitemapsFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SitemapsFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitemapsFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitesEntry">class <strong>SitesEntry</strong></a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Webmaster Tools meta <a href="atom.html#Entry">Entry</a> flavor of an Atom <a href="atom.html#Entry">Entry</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitesEntry">SitesEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SitesEntry-__init__"><strong>__init__</strong></a>(self, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry_link<font color="#909090">=None</font>, indexed<font color="#909090">=None</font>, crawled<font color="#909090">=None</font>, geolocation<font color="#909090">=None</font>, preferred_domain<font color="#909090">=None</font>, crawl_rate<font color="#909090">=None</font>, enhanced_image_search<font color="#909090">=None</font>, verified<font color="#909090">=None</font>, verification_method<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitesEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitesEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitesEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="SitesEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SitesEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SitesEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SitesFeed">class <strong>SitesFeed</strong></a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A Google Webmaster Tools meta Sites feed flavor of an Atom <a href="atom.html#Feed">Feed</a><br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#SitesFeed">SitesFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="SitesFeed-__init__"><strong>__init__</strong></a>(self, start_index<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, title<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, category<font color="#909090">=None</font>, link<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ category: list (optional) A list of Category instances<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the <a href="atom.html#Entry">Entry</a> instances contained in the <br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the <br>
+ contents of the <a href="atom.html#Entry">Entry</a>'s XML text node. <br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are <br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="SitesFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="SitesFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.webmastertools.html#LinkFinder">LinkFinder</a>:<br>
+<dl><dt><a name="SitesFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SitesFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="SitesFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SitesFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VerificationMethod">class <strong>VerificationMethod</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#VerificationMethod">VerificationMethod</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="VerificationMethod-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, in_use<font color="#909090">=None</font>, meta<font color="#909090">=None</font>, type<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="VerificationMethod-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="VerificationMethod-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="VerificationMethod-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VerificationMethodMeta">class <strong>VerificationMethodMeta</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#VerificationMethodMeta">VerificationMethodMeta</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="VerificationMethodMeta-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, name<font color="#909090">=None</font>, content<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="VerificationMethodMeta-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="VerificationMethodMeta-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="VerificationMethodMeta-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Verified">class <strong>Verified</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.html#Verified">Verified</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Verified-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Verified-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Verified-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Verified-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-CrawlRateFromString"><strong>CrawlRateFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-CrawledFromString"><strong>CrawledFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-EnhancedImageSearchFromString"><strong>EnhancedImageSearchFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-GeoLocationFromString"><strong>GeoLocationFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-IndexedFromString"><strong>IndexedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-MarkupLanguageFromString"><strong>MarkupLanguageFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PreferredDomainFromString"><strong>PreferredDomainFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-PublicationLabelFromString"><strong>PublicationLabelFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitemapLastDownloadedFromString"><strong>SitemapLastDownloadedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitemapMobileFromString"><strong>SitemapMobileFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitemapMobileMarkupLanguageFromString"><strong>SitemapMobileMarkupLanguageFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitemapNewsFromString"><strong>SitemapNewsFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitemapNewsPublicationLabelFromString"><strong>SitemapNewsPublicationLabelFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitemapStatusFromString"><strong>SitemapStatusFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitemapTypeFromString"><strong>SitemapTypeFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitemapUrlCountFromString"><strong>SitemapUrlCountFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitemapsEntryFromString"><strong>SitemapsEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitemapsFeedFromString"><strong>SitemapsFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitesEntryFromString"><strong>SitesEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-SitesFeedFromString"><strong>SitesFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-VerificationMethodFromString"><strong>VerificationMethodFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-VerificationMethodMetaFromString"><strong>VerificationMethodMetaFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-VerifiedFromString"><strong>VerifiedFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>GWEBMASTERTOOLS_NAMESPACE</strong> = 'http://schemas.google.com/webmasters/tools/2007'<br>
+<strong>GWEBMASTERTOOLS_TEMPLATE</strong> = '{http://schemas.google.com/webmasters/tools/2007}%s'<br>
+<strong>__author__</strong> = 'livibetter (Yu-Jie Lin)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">livibetter (Yu-Jie Lin)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.webmastertools.service.html b/pydocs/gdata.webmastertools.service.html
new file mode 100644
index 0000000..2f918b6
--- /dev/null
+++ b/pydocs/gdata.webmastertools.service.html
@@ -0,0 +1,1028 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.webmastertools.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.webmastertools.html"><font color="#ffffff">webmastertools</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/webmastertools/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/webmastertools/service.py</a></font></td></tr></table>
+ <p><tt><a href="#GWebmasterToolsService">GWebmasterToolsService</a> extends the <a href="gdata.service.html#GDataService">GDataService</a> to streamline<br>
+Google Webmaster Tools operations.<br>
+ <br>
+ <a href="#GWebmasterToolsService">GWebmasterToolsService</a>: Provides methods to query feeds and manipulate items.<br>
+ Extends <a href="gdata.service.html#GDataService">GDataService</a>.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="urllib.html">urllib</a><br>
+</td><td width="25%" valign=top><a href="gdata.webmastertools.html">gdata.webmastertools</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.service.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.service.html#RequestError">RequestError</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.webmastertools.service.html#GWebmasterToolsService">GWebmasterToolsService</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="GWebmasterToolsService">class <strong>GWebmasterToolsService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the Google Webmaster Tools service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.service.html#GWebmasterToolsService">GWebmasterToolsService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="GWebmasterToolsService-AddMobileSitemap"><strong>AddMobileSitemap</strong></a>(self, site_uri, sitemap_uri, sitemap_mobile_markup_language<font color="#909090">='XHTML'</font>, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/%(site_id)s/sitemaps/'</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Adds a mobile sitemap to a site.<br>
+ <br>
+Args: <br>
+ site_uri: str URI of which site to add sitemap for.<br>
+ sitemap_uri: str URI of sitemap to add to a site.<br>
+ sitemap_mobile_markup_language: str Format of added sitemap. Valid types:<br>
+ XHTML, WML, or cHTML.<br>
+ uri: str (optional) URI template to add a sitemap.<br>
+ Default SITEMAP_FEED_TEMPLATE.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ converter: func (optional) Function which is executed on the server's<br>
+ response before it is returned. Usually this is a function like<br>
+ SitemapsEntryFromString which will parse the response and turn it into<br>
+ an object.<br>
+ <br>
+Returns:<br>
+ If converter is defined, the results of running converter on the server's<br>
+ response. Otherwise, it will be a SitemapsEntry object.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-AddNewsSitemap"><strong>AddNewsSitemap</strong></a>(self, site_uri, sitemap_uri, sitemap_news_publication_label, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/%(site_id)s/sitemaps/'</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Adds a news sitemap to a site.<br>
+ <br>
+Args: <br>
+ site_uri: str URI of which site to add sitemap for.<br>
+ sitemap_uri: str URI of sitemap to add to a site.<br>
+ sitemap_news_publication_label: str, list of str Publication Labels for<br>
+ sitemap.<br>
+ uri: str (optional) URI template to add a sitemap.<br>
+ Default SITEMAP_FEED_TEMPLATE.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ converter: func (optional) Function which is executed on the server's<br>
+ response before it is returned. Usually this is a function like<br>
+ SitemapsEntryFromString which will parse the response and turn it into<br>
+ an object.<br>
+ <br>
+Returns:<br>
+ If converter is defined, the results of running converter on the server's<br>
+ response. Otherwise, it will be a SitemapsEntry object.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-AddSite"><strong>AddSite</strong></a>(self, site_uri, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/sites/'</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Adds a site to Google Webmaster Tools.<br>
+ <br>
+Args: <br>
+ site_uri: str URI of which site to add.<br>
+ uri: str (optional) URI to add a site.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ converter: func (optional) Function which is executed on the server's<br>
+ response before it is returned. Usually this is a function like<br>
+ SitesEntryFromString which will parse the response and turn it into<br>
+ an object.<br>
+ <br>
+Returns:<br>
+ If converter is defined, the results of running converter on the server's<br>
+ response. Otherwise, it will be a SitesEntry object.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-AddSitemap"><strong>AddSitemap</strong></a>(self, site_uri, sitemap_uri, sitemap_type<font color="#909090">='WEB'</font>, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/%(site_id)s/sitemaps/'</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Adds a regular sitemap to a site.<br>
+ <br>
+Args: <br>
+ site_uri: str URI of which site to add sitemap for.<br>
+ sitemap_uri: str URI of sitemap to add to a site.<br>
+ sitemap_type: str Type of added sitemap. Valid types: WEB, VIDEO, or CODE.<br>
+ uri: str (optional) URI template to add a sitemap.<br>
+ Default SITEMAP_FEED_TEMPLATE.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ converter: func (optional) Function which is executed on the server's<br>
+ response before it is returned. Usually this is a function like<br>
+ SitemapsEntryFromString which will parse the response and turn it into<br>
+ an object.<br>
+ <br>
+Returns:<br>
+ If converter is defined, the results of running converter on the server's<br>
+ response. Otherwise, it will be a SitemapsEntry object.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-DeleteSite"><strong>DeleteSite</strong></a>(self, site_uri, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/sites/%s'</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Removes a site from Google Webmaster Tools.<br>
+ <br>
+Args: <br>
+ site_uri: str URI of which site to remove.<br>
+ uri: str (optional) A URI template to send DELETE request.<br>
+ Default SITE_TEMPLATE.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ True if the delete succeeded.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-DeleteSitemap"><strong>DeleteSitemap</strong></a>(self, site_uri, sitemap_uri, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/%(site_id)s/sitemaps/%(sitemap_id)s'</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>)</dt><dd><tt>Removes a sitemap from a site.<br>
+ <br>
+Args: <br>
+ site_uri: str URI of which site to remove a sitemap from.<br>
+ sitemap_uri: str URI of sitemap to remove from a site.<br>
+ uri: str (optional) A URI template to send DELETE request.<br>
+ Default SITEMAP_TEMPLATE.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ <br>
+Returns:<br>
+ True if the delete succeeded.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GetSitemapsFeed"><strong>GetSitemapsFeed</strong></a>(self, site_uri, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/%(site_id)s/sitemaps/'</font>, converter<font color="#909090">=<function SitemapsFeedFromString></font>)</dt><dd><tt>Gets sitemaps feed of a site.<br>
+ <br>
+Args:<br>
+ site_uri: str (optional) URI of which site to retrieve its sitemaps feed.<br>
+ uri: str (optional) URI to retrieve sites feed.<br>
+ converter: func (optional) Function which is executed on the server's<br>
+ response before it is returned. Usually this is a function like<br>
+ SitemapsFeedFromString which will parse the response and turn it into<br>
+ an object.<br>
+ <br>
+Returns:<br>
+ If converter is defined, the results of running converter on the server's<br>
+ response. Otherwise, it will be a SitemapsFeed object.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GetSitesFeed"><strong>GetSitesFeed</strong></a>(self, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/sites/'</font>, converter<font color="#909090">=<function SitesFeedFromString></font>)</dt><dd><tt>Gets sites feed.<br>
+ <br>
+Args:<br>
+ uri: str (optional) URI to retrieve sites feed.<br>
+ converter: func (optional) Function which is executed on the server's<br>
+ response before it is returned. Usually this is a function like<br>
+ SitesFeedFromString which will parse the response and turn it into<br>
+ an object.<br>
+ <br>
+Returns:<br>
+ If converter is defined, the results of running converter on the server's<br>
+ response. Otherwise, it will be a SitesFeed object.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-UpdateCrawlRate"><strong>UpdateCrawlRate</strong></a>(self, site_uri, crawl_rate, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/sites/%s'</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates crawl rate setting of a site.<br>
+ <br>
+Args: <br>
+ site_uri: str URI of which site to add sitemap for.<br>
+ crawl_rate: str The crawl rate for a site. Valid values are 'slower',<br>
+ 'normal', and 'faster'.<br>
+ uri: str (optional) URI template to update a site.<br>
+ Default SITE_TEMPLATE.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ converter: func (optional) Function which is executed on the server's<br>
+ response before it is returned. Usually this is a function like<br>
+ SitemapsEntryFromString which will parse the response and turn it into<br>
+ an object.<br>
+ <br>
+Returns:<br>
+ If converter is defined, the results of running converter on the server's<br>
+ response. Otherwise, it will be a SitesEntry object.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-UpdateEnhancedImageSearch"><strong>UpdateEnhancedImageSearch</strong></a>(self, site_uri, enhanced_image_search, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/sites/%s'</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates enhanced image search setting of a site.<br>
+ <br>
+Args: <br>
+ site_uri: str URI of which site to add sitemap for.<br>
+ enhanced_image_search: str The enhanced image search setting for a site.<br>
+ Valid values are 'true', and 'false'.<br>
+ uri: str (optional) URI template to update a site.<br>
+ Default SITE_TEMPLATE.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ converter: func (optional) Function which is executed on the server's<br>
+ response before it is returned. Usually this is a function like<br>
+ SitemapsEntryFromString which will parse the response and turn it into<br>
+ an object.<br>
+ <br>
+Returns:<br>
+ If converter is defined, the results of running converter on the server's<br>
+ response. Otherwise, it will be a SitesEntry object.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-UpdateGeoLocation"><strong>UpdateGeoLocation</strong></a>(self, site_uri, geolocation, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/sites/%s'</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates geolocation setting of a site.<br>
+ <br>
+Args: <br>
+ site_uri: str URI of which site to add sitemap for.<br>
+ geolocation: str The geographic location. Valid values are listed in<br>
+ <a href="http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2">http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2</a><br>
+ uri: str (optional) URI template to update a site.<br>
+ Default SITE_TEMPLATE.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ converter: func (optional) Function which is executed on the server's<br>
+ response before it is returned. Usually this is a function like<br>
+ SitemapsEntryFromString which will parse the response and turn it into<br>
+ an object.<br>
+ <br>
+Returns:<br>
+ If converter is defined, the results of running converter on the server's<br>
+ response. Otherwise, it will be a SitesEntry object.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-UpdatePreferredDomain"><strong>UpdatePreferredDomain</strong></a>(self, site_uri, preferred_domain, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/sites/%s'</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates preferred domain setting of a site.<br>
+ <br>
+Note that if using 'preferwww', will also need www.example.com in account to<br>
+take effect.<br>
+ <br>
+Args: <br>
+ site_uri: str URI of which site to add sitemap for.<br>
+ preferred_domain: str The preferred domain for a site. Valid values are 'none',<br>
+ 'preferwww', and 'prefernowww'.<br>
+ uri: str (optional) URI template to update a site.<br>
+ Default SITE_TEMPLATE.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ converter: func (optional) Function which is executed on the server's<br>
+ response before it is returned. Usually this is a function like<br>
+ SitemapsEntryFromString which will parse the response and turn it into<br>
+ an object.<br>
+ <br>
+Returns:<br>
+ If converter is defined, the results of running converter on the server's<br>
+ response. Otherwise, it will be a SitesEntry object.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-VerifySite"><strong>VerifySite</strong></a>(self, site_uri, verification_method, uri<font color="#909090">='https://www.google.com/webmasters/tools/feeds/sites/%s'</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Requests a verification of a site.<br>
+ <br>
+Args: <br>
+ site_uri: str URI of which site to add sitemap for.<br>
+ verification_method: str The method to verify a site. Valid values are<br>
+ 'htmlpage', and 'metatag'.<br>
+ uri: str (optional) URI template to update a site.<br>
+ Default SITE_TEMPLATE.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the insertion request. <br>
+ escape_params: boolean (optional) If true, the url_parameters will be<br>
+ escaped before they are included in the request.<br>
+ converter: func (optional) Function which is executed on the server's<br>
+ response before it is returned. Usually this is a function like<br>
+ SitemapsEntryFromString which will parse the response and turn it into<br>
+ an object.<br>
+ <br>
+Returns:<br>
+ If converter is defined, the results of running converter on the server's<br>
+ response. Otherwise, it will be a SitesEntry object.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='www.google.com'</font>, **kwargs)</dt><dd><tt>Creates a client for the Google Webmaster Tools service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'www.google.com'.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="GWebmasterToolsService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Query the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt>Query the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="GWebmasterToolsService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#GWebmasterToolsService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ <a href="#Error">Error</a> if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#GWebmasterToolsService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#GWebmasterToolsService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="GWebmasterToolsService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="GWebmasterToolsService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+<dl><dt><strong>ssl</strong> = False</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RequestError">class <strong>RequestError</strong></a>(<a href="gdata.webmastertools.service.html#Error">Error</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.webmastertools.service.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.webmastertools.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.webmastertools.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="RequestError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RequestError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="RequestError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>FEED_BASE</strong> = 'https://www.google.com/webmasters/tools/feeds/'<br>
+<strong>SITEMAPS_FEED_TEMPLATE</strong> = 'https://www.google.com/webmasters/tools/feeds/%(site_id)s/sitemaps/'<br>
+<strong>SITEMAP_TEMPLATE</strong> = 'https://www.google.com/webmasters/tools/feeds/%(site_id)s/sitemaps/%(sitemap_id)s'<br>
+<strong>SITES_FEED</strong> = 'https://www.google.com/webmasters/tools/feeds/sites/'<br>
+<strong>SITE_TEMPLATE</strong> = 'https://www.google.com/webmasters/tools/feeds/sites/%s'<br>
+<strong>__author__</strong> = 'livibetter (Yu-Jie Lin)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">livibetter (Yu-Jie Lin)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.youtube.client.html b/pydocs/gdata.youtube.client.html
new file mode 100644
index 0000000..cc17955
--- /dev/null
+++ b/pydocs/gdata.youtube.client.html
@@ -0,0 +1,909 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.youtube.client</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.youtube.html"><font color="#ffffff">youtube</font></a>.client</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/youtube/client.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/youtube/client.py</a></font></td></tr></table>
+ <p><tt>Contains a client to communicate with the YouTube servers.<br>
+ <br>
+A quick and dirty port of the YouTube GDATA 1.0 Python client<br>
+libraries to version 2.0 of the GDATA library.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="logging.html">logging</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.client.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.client.html#RequestError">RequestError</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.client.html#YouTubeError">YouTubeError</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.client.html#GDClient">gdata.client.GDClient</a>(<a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.client.html#YouTubeClient">YouTubeClient</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Base class for errors within the YouTube service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RequestError">class <strong>RequestError</strong></a>(<a href="gdata.youtube.client.html#Error">Error</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Error">Error</a> class that is thrown in response to an invalid HTTP Request.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.client.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.youtube.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.youtube.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="RequestError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RequestError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="RequestError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeClient">class <strong>YouTubeClient</strong></a>(<a href="gdata.client.html#GDClient">gdata.client.GDClient</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the YouTube service.<br>
+ <br>
+Performs a partial list of Google Data YouTube API functions, such as<br>
+retrieving the videos feed for a user and the feed for a video.<br>
+YouTube Service requires authentication for any write, update or delete<br>
+actions.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.client.html#YouTubeClient">YouTubeClient</a></dd>
+<dd><a href="gdata.client.html#GDClient">gdata.client.GDClient</a></dd>
+<dd><a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubeClient-CreateTrack"><strong>CreateTrack</strong></a> = <a href="#YouTubeClient-create_track">create_track</a>(self, video_id, title, language, body, client_id, developer_key, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-DeleteTrack"><strong>DeleteTrack</strong></a> = <a href="#YouTubeClient-delete_track">delete_track</a>(self, video_id, track, client_id, developer_key, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-GetCaptionFeed"><strong>GetCaptionFeed</strong></a> = <a href="#YouTubeClient-get_caption_feed">get_caption_feed</a>(self, uri)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-GetCaptionTrack"><strong>GetCaptionTrack</strong></a> = <a href="#YouTubeClient-get_caption_track">get_caption_track</a>(self, track_url, client_id, developer_key, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-GetUserFeed"><strong>GetUserFeed</strong></a> = <a href="#YouTubeClient-get_user_feed">get_user_feed</a>(self, uri<font color="#909090">=None</font>, username<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-GetVideoEntry"><strong>GetVideoEntry</strong></a> = <a href="#YouTubeClient-get_video_entry">get_video_entry</a>(self, uri<font color="#909090">=None</font>, video_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-GetVideos"><strong>GetVideos</strong></a> = <a href="#YouTubeClient-get_videos">get_videos</a>(self, uri<font color="#909090">='http://gdata.youtube.com/feeds/api/videos'</font>, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.youtube.data.VideoFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-UpdateTrack"><strong>UpdateTrack</strong></a> = <a href="#YouTubeClient-update_track">update_track</a>(self, video_id, track, body, client_id, developer_key, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-create_track"><strong>create_track</strong></a>(self, video_id, title, language, body, client_id, developer_key, auth_token<font color="#909090">=None</font>, title_type<font color="#909090">='text'</font>, **kwargs)</dt><dd><tt>Creates a closed-caption track and adds to an existing YouTube video.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-delete_track"><strong>delete_track</strong></a>(self, video_id, track, client_id, developer_key, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Deletes a track.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-get_caption_feed"><strong>get_caption_feed</strong></a>(self, uri)</dt><dd><tt>Retrieve a Caption feed of tracks.<br>
+ <br>
+Args:<br>
+ uri: A string representing the caption feed's URI to be retrieved.<br>
+ <br>
+Returns:<br>
+ A YouTube CaptionFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-get_caption_track"><strong>get_caption_track</strong></a>(self, track_url, client_id, developer_key, auth_token<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-get_user_feed"><strong>get_user_feed</strong></a>(self, uri<font color="#909090">=None</font>, username<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a YouTubeVideoFeed of user uploaded videos.<br>
+ <br>
+Either a uri or a username must be provided. This will retrieve list<br>
+of videos uploaded by specified user. The uri will be of format<br>
+"<a href="http://gdata.youtube.com/feeds/api/users/{username}/uploads">http://gdata.youtube.com/feeds/api/users/{username}/uploads</a>".<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the user feed that is<br>
+ to be retrieved.<br>
+ username: An optional string representing the username.<br>
+ <br>
+Returns:<br>
+ A YouTubeUserFeed if successfully retrieved.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a uri or a username to the<br>
+ GetYouTubeUserFeed() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-get_video_entry"><strong>get_video_entry</strong></a>(self, uri<font color="#909090">=None</font>, video_id<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Retrieve a YouTubeVideoEntry.<br>
+ <br>
+Either a uri or a video_id must be provided.<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the entry that is to<br>
+ be retrieved.<br>
+ video_id: An optional string representing the ID of the video.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a uri or a video_id to the<br>
+ GetYouTubeVideoEntry() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-get_videos"><strong>get_videos</strong></a>(self, uri<font color="#909090">='http://gdata.youtube.com/feeds/api/videos'</font>, auth_token<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.youtube.data.VideoFeed'></font>, **kwargs)</dt><dd><tt>Retrieves a YouTube video feed.<br>
+Args:<br>
+ uri: A string representing the URI of the feed that is to be retrieved.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-update_track"><strong>update_track</strong></a>(self, video_id, track, body, client_id, developer_key, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Updates a closed-caption track for an existing YouTube video.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>api_version</strong> = '2'</dl>
+
+<dl><dt><strong>auth_scopes</strong> = ['https://gdata.youtube.com/feeds/api']</dl>
+
+<dl><dt><strong>auth_service</strong> = 'youtube'</dl>
+
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><a name="YouTubeClient-Batch"><strong>Batch</strong></a> = batch(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-ClientLogin"><strong>ClientLogin</strong></a> = client_login(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A <a href="#RequestError">RequestError</a> or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-Delete"><strong>Delete</strong></a> = delete(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-GetAccessToken"><strong>GetAccessToken</strong></a> = get_access_token(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-GetEntry"><strong>GetEntry</strong></a> = get_entry(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-GetFeed"><strong>GetFeed</strong></a> = get_feed(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-GetNext"><strong>GetNext</strong></a> = get_next(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-GetOAuthToken"><strong>GetOAuthToken</strong></a> = get_oauth_token(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-ModifyRequest"><strong>ModifyRequest</strong></a> = modify_request(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-Post"><strong>Post</strong></a> = post(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-Request"><strong>Request</strong></a> = request(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-RequestClientLoginToken"><strong>RequestClientLoginToken</strong></a> = request_client_login_token(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-RevokeToken"><strong>RevokeToken</strong></a> = revoke_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A <a href="#RequestError">RequestError</a> if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-Update"><strong>Update</strong></a> = update(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-UpgradeToken"><strong>UpgradeToken</strong></a> = upgrade_token(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-batch"><strong>batch</strong></a>(self, feed, uri<font color="#909090">=None</font>, force<font color="#909090">=False</font>, auth_token<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends a batch request to the server to execute operation entries.<br>
+ <br>
+Args:<br>
+ feed: A batch feed containing batch entries, each is an operation.<br>
+ uri: (optional) The uri to which the batch request feed should be POSTed.<br>
+ If none is provided, then the feed's edit link will be used.<br>
+ force: (optional) boolean set to True if you want the batch update to<br>
+ clobber all data. If False, the version in the information in the<br>
+ feed object will cause the server to check to see that no changes<br>
+ intervened between when you fetched the data and when you sent the<br>
+ changes.<br>
+ auth_token: (optional) An object which sets the Authorization HTTP header<br>
+ in its modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-client_login"><strong>client_login</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Performs an auth request using the user's email address and password.<br>
+ <br>
+In order to modify user specific data and read user private data, your<br>
+application must be authorized by the user. One way to demonstrage<br>
+authorization is by including a Client Login token in the Authorization<br>
+HTTP header of all requests. This method requests the Client Login token<br>
+by sending the user's email address, password, the name of the<br>
+application, and the service code for the service which will be accessed<br>
+by the application. If the username and password are correct, the server<br>
+will respond with the client login code and a new ClientLoginToken<br>
+object will be set in the client's auth_token member. With the auth_token<br>
+set, future requests from this client will include the Client Login<br>
+token.<br>
+ <br>
+For a list of service names, see <br>
+<a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+For more information on Client Login, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ email: str The user's email address or username.<br>
+ password: str The password for the user's account.<br>
+ source: str The name of your application. This can be anything you<br>
+ like but should should give some indication of which app is<br>
+ making the request.<br>
+ service: str The service code for the service you would like to access.<br>
+ For example, 'cp' for contacts, 'cl' for calendar. For a full<br>
+ list see<br>
+ <a href="http://code.google.com/apis/gdata/faq.html#clientlogin">http://code.google.com/apis/gdata/faq.html#clientlogin</a><br>
+ If you are using a subclass of the gdata.client.<a href="gdata.client.html#GDClient">GDClient</a>, the<br>
+ service will usually be filled in for you so you do not need<br>
+ to specify it. For example see BloggerClient,<br>
+ SpreadsheetsClient, etc.<br>
+ account_type: str (optional) The type of account which is being<br>
+ authenticated. This can be either 'GOOGLE' for a Google<br>
+ Account, 'HOSTED' for a Google Apps Account, or the<br>
+ default 'HOSTED_OR_GOOGLE' which will select the Google<br>
+ Apps Account if the same email address is used for both<br>
+ a Google Account and a Google Apps Account.<br>
+ auth_url: str (optional) The URL to which the login request should be<br>
+ sent.<br>
+ captcha_token: str (optional) If a previous login attempt was reponded<br>
+ to with a CAPTCHA challenge, this is the token which<br>
+ identifies the challenge (from the CAPTCHA's URL).<br>
+ captcha_response: str (optional) If a previous login attempt was<br>
+ reponded to with a CAPTCHA challenge, this is the<br>
+ response text which was contained in the challenge.<br>
+ <br>
+ Returns:<br>
+ Generated token, which is also stored in this object.<br>
+ <br>
+ Raises:<br>
+ A <a href="#RequestError">RequestError</a> or one of its suclasses: BadAuthentication,<br>
+ BadAuthenticationServiceURL, ClientLoginFailed,<br>
+ ClientLoginTokenMissing, or CaptchaChallenge</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-delete"><strong>delete</strong></a>(self, entry_or_uri, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-get_access_token"><strong>get_access_token</strong></a>(self, request_token, url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>)</dt><dd><tt>Exchanges an authorized OAuth request token for an access token.<br>
+ <br>
+Contacts the Google OAuth server to upgrade a previously authorized<br>
+request token. Once the request token is upgraded to an access token,<br>
+the access token may be used to access the user's data.<br>
+ <br>
+For more details, see the Google Accounts OAuth documentation:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken">http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken</a><br>
+ <br>
+Args:<br>
+ request_token: An OAuth token which has been authorized by the user.<br>
+ url: (optional) The URL to which the upgrade request should be sent.<br>
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-get_entry"><strong>get_entry</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDEntry'></font>, etag<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-get_feed"><strong>get_feed</strong></a>(self, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=<class 'gdata.data.GDFeed'></font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-get_next"><strong>get_next</strong></a>(self, feed, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Fetches the next set of results from the feed.<br>
+ <br>
+When requesting a feed, the number of entries returned is capped at a<br>
+service specific default limit (often 25 entries). You can specify your<br>
+own entry-count cap using the max-results URL query parameter. If there<br>
+are more results than could fit under max-results, the feed will contain<br>
+a next link. This method performs a GET against this next results URL.<br>
+ <br>
+Returns:<br>
+ A new feed object containing the next set of entries in this feed.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-get_oauth_token"><strong>get_oauth_token</strong></a>(self, scopes, next, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_private_key<font color="#909090">=None</font>, url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>)</dt><dd><tt>Obtains an OAuth request token to allow the user to authorize this app.<br>
+ <br>
+Once this client has a request token, the user can authorize the request<br>
+token by visiting the authorization URL in their browser. After being<br>
+redirected back to this app at the 'next' URL, this app can then exchange<br>
+the authorized request token for an access token.<br>
+ <br>
+For more information see the documentation on Google Accounts with OAuth:<br>
+<a href="http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess">http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess</a><br>
+ <br>
+Args:<br>
+ scopes: list of strings or atom.http_core.Uri objects which specify the<br>
+ URL prefixes which this app will be accessing. For example, to access<br>
+ the Google Calendar API, you would want to use scopes:<br>
+ ['https://www.google.com/calendar/feeds/',<br>
+ '<a href="http://www.google.com/calendar/feeds/">http://www.google.com/calendar/feeds/</a>']<br>
+ next: str or atom.http_core.Uri object, The URL which the user's browser<br>
+ should be sent to after they authorize access to their data. This<br>
+ should be a URL in your application which will read the token<br>
+ information from the URL and upgrade the request token to an access<br>
+ token.<br>
+ consumer_key: str This is the identifier for this application which you<br>
+ should have received when you registered your application with Google<br>
+ to use OAuth.<br>
+ consumer_secret: str (optional) The shared secret between your app and<br>
+ Google which provides evidence that this request is coming from you<br>
+ application and not another app. If present, this libraries assumes<br>
+ you want to use an HMAC signature to verify requests. Keep this data<br>
+ a secret.<br>
+ rsa_private_key: str (optional) The RSA private key which is used to<br>
+ generate a digital signature which is checked by Google's server. If<br>
+ present, this library assumes that you want to use an RSA signature<br>
+ to verify requests. Keep this data a secret.<br>
+ url: The URL to which a request for a token should be made. The default<br>
+ is Google's OAuth request token provider.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-modify_request"><strong>modify_request</strong></a>(self, http_request)</dt><dd><tt>Adds or changes request before making the HTTP request.<br>
+ <br>
+This client will add the API version if it is specified.<br>
+Subclasses may override this method to add their own request<br>
+modifications before the request is made.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-post"><strong>post</strong></a>(self, entry, uri, auth_token<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-request"><strong>request</strong></a>(self, method<font color="#909090">=None</font>, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, converter<font color="#909090">=None</font>, desired_class<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, **kwargs)</dt><dd><tt>Make an HTTP request to the server.<br>
+ <br>
+See also documentation for atom.client.AtomPubClient.request.<br>
+ <br>
+If a 302 redirect is sent from the server to the client, this client<br>
+assumes that the redirect is in the form used by the Google Calendar API.<br>
+The same request URI and method will be used as in the original request,<br>
+but a gsessionid URL parameter will be added to the request URI with<br>
+the value provided in the server's 302 redirect response. If the 302<br>
+redirect is not in the format specified by the Google Calendar API, a<br>
+RedirectError will be raised containing the body of the server's<br>
+response.<br>
+ <br>
+The method calls the client's modify_request method to make any changes<br>
+required by the client before the request is made. For example, a<br>
+version 2 client could add a GData-Version: 2 header to the request in<br>
+its modify_request method.<br>
+ <br>
+Args:<br>
+ method: str The HTTP verb for this request, usually 'GET', 'POST',<br>
+ 'PUT', or 'DELETE'<br>
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.<br>
+ auth_token: An object which sets the Authorization HTTP header in its<br>
+ modify_request method. Recommended classes include<br>
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken<br>
+ among others.<br>
+ http_request: (optional) atom.http_core.HttpRequest<br>
+ converter: function which takes the body of the response as its only<br>
+ argument and returns the desired object.<br>
+ desired_class: class descended from atom.core.XmlElement to which a<br>
+ successful response should be converted. If there is no<br>
+ converter function specified (converter=None) then the<br>
+ desired_class will be used in calling the<br>
+ atom.core.parse function. If neither<br>
+ the desired_class nor the converter is specified, an<br>
+ HTTP reponse object will be returned.<br>
+ redirects_remaining: (optional) int, if this number is 0 and the<br>
+ server sends a 302 redirect, the request method<br>
+ will raise an exception. This parameter is used in<br>
+ recursive request calls to avoid an infinite loop.<br>
+ <br>
+Any additional arguments are passed through to<br>
+atom.client.AtomPubClient.request.<br>
+ <br>
+Returns:<br>
+ An HTTP response object (see atom.http_core.HttpResponse for a<br>
+ description of the object's interface) if no converter was<br>
+ specified and no desired_class was specified. If a converter function<br>
+ was provided, the results of calling the converter are returned. If no<br>
+ converter was specified but a desired_class was provided, the response<br>
+ body will be converted to the class using<br>
+ atom.core.parse.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-request_client_login_token"><strong>request_client_login_token</strong></a>(self, email, password, source, service<font color="#909090">=None</font>, account_type<font color="#909090">='HOSTED_OR_GOOGLE'</font>, auth_url<font color="#909090">=<atom.http_core.Uri object></font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt></dl>
+
+<dl><dt><a name="YouTubeClient-revoke_token"><strong>revoke_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Requests that the token be invalidated.<br>
+ <br>
+This method can be used for both AuthSub and OAuth tokens (to invalidate<br>
+a ClientLogin token, the user must change their password).<br>
+ <br>
+Returns:<br>
+ True if the server responded with a 200.<br>
+ <br>
+Raises:<br>
+ A <a href="#RequestError">RequestError</a> if the server responds with a non-200 status.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-update"><strong>update</strong></a>(self, entry, auth_token<font color="#909090">=None</font>, force<font color="#909090">=False</font>, uri<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Edits the entry on the server by sending the XML for this entry.<br>
+ <br>
+Performs a PUT and converts the response to a new entry object with a<br>
+matching class to the entry passed in.<br>
+ <br>
+Args:<br>
+ entry:<br>
+ auth_token:<br>
+ force: boolean stating whether an update should be forced. Defaults to<br>
+ False. Normally, if a change has been made since the passed in<br>
+ entry was obtained, the server will not overwrite the entry since<br>
+ the changes were based on an obsolete version of the entry.<br>
+ Setting force to True will cause the update to silently<br>
+ overwrite whatever version is present.<br>
+ uri: The uri to put to. If provided, this uri is PUT to rather than the<br>
+ inferred uri from the entry's edit link.<br>
+ <br>
+Returns:<br>
+ A new Entry object of a matching type to the entry which was passed in.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-upgrade_token"><strong>upgrade_token</strong></a>(self, token<font color="#909090">=None</font>, url<font color="#909090">=<atom.http_core.Uri object></font>)</dt><dd><tt>Asks the Google auth server for a multi-use AuthSub token.<br>
+ <br>
+For details on AuthSub, see:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken<br>
+ (optional) If no token is passed in, the client's auth_token member<br>
+ is used to request the new token. The token object will be modified<br>
+ to contain the new session token string.<br>
+ url: str or atom.http_core.Uri (optional) The URL to which the token<br>
+ upgrade request should be sent. Defaults to:<br>
+ https://www.google.com/accounts/AuthSubSessionToken<br>
+ <br>
+Returns:<br>
+ The upgraded gdata.gauth.AuthSubToken object.</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.client.html#GDClient">gdata.client.GDClient</a>:<br>
+<dl><dt><strong>alt_auth_service</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><a name="YouTubeClient-Get"><strong>Get</strong></a> = get(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-Put"><strong>Put</strong></a> = put(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-__init__"><strong>__init__</strong></a>(self, http_client<font color="#909090">=None</font>, host<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, source<font color="#909090">=None</font>, xoauth_requestor_id<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a new AtomPubClient instance.<br>
+ <br>
+Args:<br>
+ source: The name of your application.<br>
+ http_client: An object capable of performing HTTP requests through a<br>
+ request method. This object is used to perform the request<br>
+ when the AtomPubClient's request method is called. Used to<br>
+ allow HTTP requests to be directed to a mock server, or use<br>
+ an alternate library instead of the default of httplib to<br>
+ make HTTP requests.<br>
+ host: str The default host name to use if a host is not specified in the<br>
+ requested URI.<br>
+ auth_token: An object which sets the HTTP Authorization header when its<br>
+ modify_request method is called.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-get"><strong>get</strong></a>(self, uri<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Performs a request using the GET method, returns an HTTP response.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeClient-put"><strong>put</strong></a>(self, uri<font color="#909090">=None</font>, data<font color="#909090">=None</font>, auth_token<font color="#909090">=None</font>, http_request<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Sends data using the PUT method, returns an HTTP response.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.client.html#AtomPubClient">atom.client.AtomPubClient</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>host</strong> = None</dl>
+
+<dl><dt><strong>xoauth_requestor_id</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeError">class <strong>YouTubeError</strong></a>(<a href="gdata.youtube.client.html#Error">Error</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>YouTube service specific error class.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.client.html#YouTubeError">YouTubeError</a></dd>
+<dd><a href="gdata.youtube.client.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.youtube.client.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="YouTubeError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#YouTubeError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="YouTubeError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="YouTubeError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="YouTubeError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>YOUTUBE_CAPTION_FEED_URI</strong> = 'http://gdata.youtube.com/feeds/api/videos/%s/captions'<br>
+<strong>YOUTUBE_CAPTION_MIME_TYPE</strong> = 'application/vnd.youtube.timedtext; charset=UTF-8'<br>
+<strong>YOUTUBE_CAPTION_URI</strong> = 'http://gdata.youtube.com/feeds/api/videos/%s/captiondata/%s'<br>
+<strong>YOUTUBE_CLIENTLOGIN_AUTHENTICATION_URL</strong> = 'https://www.google.com/youtube/accounts/ClientLogin'<br>
+<strong>YOUTUBE_QUERY_VALID_FORMAT_PARAMETERS</strong> = ('1', '5', '6')<br>
+<strong>YOUTUBE_QUERY_VALID_ORDERBY_PARAMETERS</strong> = ('published', 'viewCount', 'rating', 'relevance')<br>
+<strong>YOUTUBE_QUERY_VALID_RACY_PARAMETERS</strong> = ('include', 'exclude')<br>
+<strong>YOUTUBE_QUERY_VALID_TIME_PARAMETERS</strong> = ('today', 'this_week', 'this_month', 'all_time')<br>
+<strong>YOUTUBE_SERVER</strong> = 'gdata.youtube.com/feeds/api'<br>
+<strong>YOUTUBE_SERVICE</strong> = 'youtube'<br>
+<strong>YOUTUBE_STANDARDFEEDS</strong> = ('most_recent', 'recently_featured', 'top_rated', 'most_viewed', 'watch_on_mobile')<br>
+<strong>YOUTUBE_SUPPORTED_UPLOAD_TYPES</strong> = ('mov', 'avi', 'wmv', 'mpg', 'quicktime', 'flv')<br>
+<strong>YOUTUBE_UPLOAD_TOKEN_URI</strong> = 'http://gdata.youtube.com/action/GetUploadToken'<br>
+<strong>YOUTUBE_USER_FEED_URI</strong> = 'http://gdata.youtube.com/feeds/api/users/'<br>
+<strong>YOUTUBE_VIDEO_FEED_URI</strong> = 'http://gdata.youtube.com/feeds/api/videos'</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.youtube.data.html b/pydocs/gdata.youtube.data.html
new file mode 100644
index 0000000..1222f65
--- /dev/null
+++ b/pydocs/gdata.youtube.data.html
@@ -0,0 +1,20234 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.youtube.data</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.youtube.html"><font color="#ffffff">youtube</font></a>.data</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/youtube/data.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/youtube/data.py</a></font></td></tr></table>
+ <p><tt>Contains the data classes of the YouTube Data API</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top></td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.core.html#XmlElement">atom.core.XmlElement</a>(<a href="__builtin__.html#object">__builtin__.object</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtAboutMe">YtAboutMe</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtAge">YtAge</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtAspectRatio">YtAspectRatio</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtBasePublicationState">YtBasePublicationState</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtCaptionPublicationState">YtCaptionPublicationState</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtPublicationState">YtPublicationState</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtBooks">YtBooks</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtCompany">YtCompany</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtCountHint">YtCountHint</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtDescription">YtDescription</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtDuration">YtDuration</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtFirstName">YtFirstName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtGender">YtGender</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtHobbies">YtHobbies</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtHometown">YtHometown</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtLastName">YtLastName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtLocation">YtLocation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtModerationStatus">YtModerationStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtMovies">YtMovies</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtMusic">YtMusic</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtNoEmbed">YtNoEmbed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtOccupation">YtOccupation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtPlaylistId">YtPlaylistId</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtPlaylistTitle">YtPlaylistTitle</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtPosition">YtPosition</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtPrivate">YtPrivate</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtQueryString">YtQueryString</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtRacy">YtRacy</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtRecorded">YtRecorded</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtRelationship">YtRelationship</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtSchool">YtSchool</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtSpam">YtSpam</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtStatistics">YtStatistics</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtUserProfileStatistics">YtUserProfileStatistics</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtVideoStatistics">YtVideoStatistics</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtStatus">YtStatus</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtUploaded">YtUploaded</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtUsername">YtUsername</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YtVideoId">YtVideoId</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Content">atom.data.Content</a>(<a href="atom.data.html#Text">atom.data.Text</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#TrackContent">TrackContent</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="atom.data.html#Control">atom.data.Control</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YouTubeAppControl">YouTubeAppControl</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YouTubeCaptionAppControl">YouTubeCaptionAppControl</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#CommentEntry">CommentEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#FavoriteEntry">FavoriteEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#FriendEntry">FriendEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#PlaylistEntry">PlaylistEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#PlaylistLinkEntry">PlaylistLinkEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#SubscriptionEntry">SubscriptionEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#UserProfileEntry">UserProfileEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#VideoEntry">VideoEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#VideoMessageEntry">VideoMessageEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#CommentFeed">CommentFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#FavoriteFeed">FavoriteFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#FriendFeed">FriendFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#PlaylistFeed">PlaylistFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#PlaylistLinkFeed">PlaylistLinkFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#SubscriptionFeed">SubscriptionFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#UserProfileFeed">UserProfileFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#VideoFeed">VideoFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#VideoMessageFeed">VideoMessageFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>(<a href="atom.data.html#Entry">atom.data.Entry</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#CaptionTrackEntry">CaptionTrackEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#ChannelEntry">ChannelEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#ComplaintEntry">ComplaintEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#RatingEntry">RatingEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#TrackEntry">TrackEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#UserEventEntry">UserEventEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#VideoEntryBase">VideoEntryBase</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#VideoModerationEntry">VideoModerationEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>(<a href="atom.data.html#Feed">atom.data.Feed</a>, <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#CaptionFeed">CaptionFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#CaptionTrackFeed">CaptionTrackFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#ChannelFeed">ChannelFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#ComplaintFeed">ComplaintFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#RatingFeed">RatingFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#UserEventFeed">UserEventFeed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#VideoModerationFeed">VideoModerationFeed</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaContent">gdata.media.data.MediaContent</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YouTubeMediaContent">YouTubeMediaContent</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaCredit">gdata.media.data.MediaCredit</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YouTubeMediaCredit">YouTubeMediaCredit</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaGroup">gdata.media.data.MediaGroup</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YouTubeMediaGroup">YouTubeMediaGroup</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.media.data.html#MediaRating">gdata.media.data.MediaRating</a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.data.html#YouTubeMediaRating">YouTubeMediaRating</a>
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CaptionFeed">class <strong>CaptionFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a caption feed for a video on YouTube.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#CaptionFeed">CaptionFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.TrackEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CaptionFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CaptionFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CaptionFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CaptionFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CaptionFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CaptionFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CaptionTrackEntry">class <strong>CaptionTrackEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a caption track<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#CaptionTrackEntry">CaptionTrackEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CaptionTrackEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CaptionTrackEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CaptionTrackEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CaptionTrackEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CaptionTrackEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CaptionTrackFeed">class <strong>CaptionTrackFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes caption tracks<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#CaptionTrackFeed">CaptionTrackFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.CaptionTrackEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CaptionTrackFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CaptionTrackFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CaptionTrackFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CaptionTrackFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CaptionTrackFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CaptionTrackFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ChannelEntry">class <strong>ChannelEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a video channel<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#ChannelEntry">ChannelEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="ChannelEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ChannelEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ChannelEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ChannelEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ChannelEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ChannelEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ChannelFeed">class <strong>ChannelFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes channels<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#ChannelFeed">ChannelFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.ChannelEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ChannelFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ChannelFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ChannelFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ChannelFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ChannelFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ChannelFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ChannelFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentEntry">class <strong>CommentEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a comment for a video<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#CommentEntry">CommentEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>spam</strong> = <class 'gdata.youtube.data.YtSpam'><dd><tt>Indicates that the entry probably contains spam</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="CommentEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CommentEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CommentEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CommentEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CommentEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CommentEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="CommentFeed">class <strong>CommentFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes comments for a video<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#CommentFeed">CommentFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.CommentEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="CommentFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="CommentFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="CommentFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="CommentFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="CommentFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="CommentFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="CommentFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="CommentFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ComplaintEntry">class <strong>ComplaintEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a complaint about a video<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#ComplaintEntry">ComplaintEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="ComplaintEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ComplaintEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ComplaintEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ComplaintEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ComplaintEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="ComplaintFeed">class <strong>ComplaintFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes complaints about a video<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#ComplaintFeed">ComplaintFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.ComplaintEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="ComplaintFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="ComplaintFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="ComplaintFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="ComplaintFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="ComplaintFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="ComplaintFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="ComplaintFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FavoriteEntry">class <strong>FavoriteEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a favorite video<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#FavoriteEntry">FavoriteEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="FavoriteEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="FavoriteEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FavoriteEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="FavoriteEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="FavoriteEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FavoriteFeed">class <strong>FavoriteFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes favorite videos<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#FavoriteFeed">FavoriteFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.FavoriteEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="FavoriteFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="FavoriteFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="FavoriteFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FavoriteFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="FavoriteFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="FavoriteFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="FavoriteFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FavoriteFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FriendEntry">class <strong>FriendEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a contact in friend list<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#FriendEntry">FriendEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>email</strong> = <class 'gdata.data.Email'><dd><tt>The gd:email element.<br>
+ <br>
+An email address associated with the containing entity (which is<br>
+usually an entity representing a person or a location).</tt></dl>
+
+<dl><dt><strong>status</strong> = <class 'gdata.youtube.data.YtStatus'><dd><tt>Status of a contact</tt></dl>
+
+<dl><dt><strong>username</strong> = <class 'gdata.youtube.data.YtUsername'><dd><tt>Youtube username</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="FriendEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="FriendEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FriendEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="FriendEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="FriendEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="FriendEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FriendFeed">class <strong>FriendFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes user's friends<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#FriendFeed">FriendFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.FriendEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="FriendFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="FriendFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="FriendFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="FriendFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="FriendFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="FriendFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="FriendFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="FriendFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PlaylistEntry">class <strong>PlaylistEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a video in a playlist<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#PlaylistEntry">PlaylistEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>description</strong> = <class 'gdata.youtube.data.YtDescription'><dd><tt>Description</tt></dl>
+
+<dl><dt><strong>position</strong> = <class 'gdata.youtube.data.YtPosition'><dd><tt>Video position on the playlist</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="PlaylistEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="PlaylistEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PlaylistEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="PlaylistEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="PlaylistEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PlaylistFeed">class <strong>PlaylistFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes videos in a playlist<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#PlaylistFeed">PlaylistFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.PlaylistEntry'>]</dl>
+
+<dl><dt><strong>group</strong> = <class 'gdata.youtube.data.YouTubeMediaGroup'><dd><tt>Describes a you tube media group</tt></dl>
+
+<dl><dt><strong>playlist_id</strong> = <class 'gdata.youtube.data.YtPlaylistId'><dd><tt>Playlist id</tt></dl>
+
+<dl><dt><strong>private</strong> = <class 'gdata.youtube.data.YtPrivate'><dd><tt>Flags the entry as private</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="PlaylistFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="PlaylistFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="PlaylistFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PlaylistFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="PlaylistFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="PlaylistFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PlaylistLinkEntry">class <strong>PlaylistLinkEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a playlist<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#PlaylistLinkEntry">PlaylistLinkEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>count_hint</strong> = <class 'gdata.youtube.data.YtCountHint'><dd><tt>Hint as to how many entries the linked feed contains</tt></dl>
+
+<dl><dt><strong>description</strong> = <class 'gdata.youtube.data.YtDescription'><dd><tt>Description</tt></dl>
+
+<dl><dt><strong>playlist_id</strong> = <class 'gdata.youtube.data.YtPlaylistId'><dd><tt>Playlist id</tt></dl>
+
+<dl><dt><strong>private</strong> = <class 'gdata.youtube.data.YtPrivate'><dd><tt>Flags the entry as private</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="PlaylistLinkEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="PlaylistLinkEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PlaylistLinkEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="PlaylistLinkEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="PlaylistLinkEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="PlaylistLinkFeed">class <strong>PlaylistLinkFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes list of playlists<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#PlaylistLinkFeed">PlaylistLinkFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.PlaylistLinkEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="PlaylistLinkFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="PlaylistLinkFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="PlaylistLinkFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="PlaylistLinkFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="PlaylistLinkFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="PlaylistLinkFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="PlaylistLinkFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RatingEntry">class <strong>RatingEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>A rating about a video<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#RatingEntry">RatingEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>rating</strong> = <class 'gdata.data.Rating'><dd><tt>The gd:rating element.<br>
+ <br>
+Represents a numeric rating of the enclosing entity, such as a<br>
+comment. Each rating supplies its own scale, although it may be<br>
+normalized by a service; for example, some services might convert all<br>
+ratings to a scale from 1 to 5.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="RatingEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="RatingEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="RatingEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="RatingEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="RatingEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RatingEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RatingFeed">class <strong>RatingFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes ratings for a video<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#RatingFeed">RatingFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.RatingEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="RatingFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="RatingFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="RatingFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="RatingFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="RatingFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="RatingFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="RatingFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SubscriptionEntry">class <strong>SubscriptionEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes user's channel subscritpions<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#SubscriptionEntry">SubscriptionEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>count_hint</strong> = <class 'gdata.youtube.data.YtCountHint'><dd><tt>Hint as to how many entries the linked feed contains</tt></dl>
+
+<dl><dt><strong>playlist_id</strong> = <class 'gdata.youtube.data.YtPlaylistId'><dd><tt>Playlist id</tt></dl>
+
+<dl><dt><strong>playlist_title</strong> = <class 'gdata.youtube.data.YtPlaylistTitle'><dd><tt>Playlist title</tt></dl>
+
+<dl><dt><strong>query_string</strong> = <class 'gdata.youtube.data.YtQueryString'><dd><tt>Keywords or query string associated with a subscription</tt></dl>
+
+<dl><dt><strong>thumbnail</strong> = <class 'gdata.media.data.MediaThumbnail'><dd><tt>Describes a media thumbnail.</tt></dl>
+
+<dl><dt><strong>username</strong> = <class 'gdata.youtube.data.YtUsername'><dd><tt>Youtube username</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="SubscriptionEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="SubscriptionEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SubscriptionEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="SubscriptionEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="SubscriptionEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="SubscriptionFeed">class <strong>SubscriptionFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes list of user's video subscriptions<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#SubscriptionFeed">SubscriptionFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.SubscriptionEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="SubscriptionFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="SubscriptionFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="SubscriptionFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="SubscriptionFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="SubscriptionFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="SubscriptionFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="SubscriptionFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TrackContent">class <strong>TrackContent</strong></a>(<a href="atom.data.html#Content">atom.data.Content</a>)</font></td></tr>
+
+<tr><td bgcolor="#ffc8d8"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#TrackContent">TrackContent</a></dd>
+<dd><a href="atom.data.html#Content">atom.data.Content</a></dd>
+<dd><a href="atom.data.html#Text">atom.data.Text</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>lang</strong> = '{http://www.w3.org/XML/1998/namespace}lang'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Content">atom.data.Content</a>:<br>
+<dl><dt><strong>src</strong> = 'src'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Text">atom.data.Text</a>:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TrackContent-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TrackContent-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TrackContent-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TrackContent-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TrackContent-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TrackContent-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="TrackContent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackContent-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TrackContent-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TrackContent-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="TrackEntry">class <strong>TrackEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents the URL for a caption track<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#TrackEntry">TrackEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="TrackEntry-GetCaptionTrackId"><strong>GetCaptionTrackId</strong></a> = <a href="#TrackEntry-get_caption_track_id">get_caption_track_id</a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-get_caption_track_id"><strong>get_caption_track_id</strong></a>(self)</dt><dd><tt>Extracts the ID of this caption track.<br>
+Returns:<br>
+ The caption track's id as a string.</tt></dd></dl>
+
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>content</strong> = <class 'gdata.youtube.data.TrackContent'></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="TrackEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="TrackEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="TrackEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="TrackEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="TrackEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="TrackEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="TrackEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserEventEntry">class <strong>UserEventEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a user event<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#UserEventEntry">UserEventEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>playlist_id</strong> = <class 'gdata.youtube.data.YtPlaylistId'><dd><tt>Playlist id</tt></dl>
+
+<dl><dt><strong>query_string</strong> = <class 'gdata.youtube.data.YtQueryString'><dd><tt>Keywords or query string associated with a subscription</tt></dl>
+
+<dl><dt><strong>rating</strong> = <class 'gdata.data.Rating'><dd><tt>The gd:rating element.<br>
+ <br>
+Represents a numeric rating of the enclosing entity, such as a<br>
+comment. Each rating supplies its own scale, although it may be<br>
+normalized by a service; for example, some services might convert all<br>
+ratings to a scale from 1 to 5.</tt></dl>
+
+<dl><dt><strong>username</strong> = <class 'gdata.youtube.data.YtUsername'><dd><tt>Youtube username</tt></dl>
+
+<dl><dt><strong>videoid</strong> = <class 'gdata.youtube.data.YtVideoId'><dd><tt>Video id</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="UserEventEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="UserEventEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UserEventEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserEventEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserEventEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserEventEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserEventFeed">class <strong>UserEventFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes list of events<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#UserEventFeed">UserEventFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.UserEventEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="UserEventFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="UserEventFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UserEventFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserEventFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserEventFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserEventFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserEventFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserProfileEntry">class <strong>UserProfileEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes an user's profile<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#UserProfileEntry">UserProfileEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>about_me</strong> = <class 'gdata.youtube.data.YtAboutMe'><dd><tt>User's self description</tt></dl>
+
+<dl><dt><strong>age</strong> = <class 'gdata.youtube.data.YtAge'><dd><tt>User's age</tt></dl>
+
+<dl><dt><strong>books</strong> = <class 'gdata.youtube.data.YtBooks'><dd><tt>User's favorite books</tt></dl>
+
+<dl><dt><strong>company</strong> = <class 'gdata.youtube.data.YtCompany'><dd><tt>User's company</tt></dl>
+
+<dl><dt><strong>description</strong> = <class 'gdata.youtube.data.YtDescription'><dd><tt>Description</tt></dl>
+
+<dl><dt><strong>first_name</strong> = <class 'gdata.youtube.data.YtFirstName'><dd><tt>User's first name</tt></dl>
+
+<dl><dt><strong>gender</strong> = <class 'gdata.youtube.data.YtGender'><dd><tt>User's gender</tt></dl>
+
+<dl><dt><strong>hobbies</strong> = <class 'gdata.youtube.data.YtHobbies'><dd><tt>User's hobbies</tt></dl>
+
+<dl><dt><strong>hometown</strong> = <class 'gdata.youtube.data.YtHometown'><dd><tt>User's hometown</tt></dl>
+
+<dl><dt><strong>last_name</strong> = <class 'gdata.youtube.data.YtLastName'><dd><tt>User's last name</tt></dl>
+
+<dl><dt><strong>location</strong> = <class 'gdata.youtube.data.YtLocation'><dd><tt>Location</tt></dl>
+
+<dl><dt><strong>movies</strong> = <class 'gdata.youtube.data.YtMovies'><dd><tt>User's favorite movies</tt></dl>
+
+<dl><dt><strong>music</strong> = <class 'gdata.youtube.data.YtMusic'><dd><tt>User's favorite music</tt></dl>
+
+<dl><dt><strong>occupation</strong> = <class 'gdata.youtube.data.YtOccupation'><dd><tt>User's occupation</tt></dl>
+
+<dl><dt><strong>relationship</strong> = <class 'gdata.youtube.data.YtRelationship'><dd><tt>User's relationship status</tt></dl>
+
+<dl><dt><strong>school</strong> = <class 'gdata.youtube.data.YtSchool'><dd><tt>User's school</tt></dl>
+
+<dl><dt><strong>statistics</strong> = <class 'gdata.youtube.data.YtUserProfileStatistics'><dd><tt>User statistics</tt></dl>
+
+<dl><dt><strong>thumbnail</strong> = <class 'gdata.media.data.MediaThumbnail'><dd><tt>Describes a media thumbnail.</tt></dl>
+
+<dl><dt><strong>username</strong> = <class 'gdata.youtube.data.YtUsername'><dd><tt>Youtube username</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="UserProfileEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="UserProfileEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UserProfileEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserProfileEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserProfileEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="UserProfileFeed">class <strong>UserProfileFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a feed of user's profile<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#UserProfileFeed">UserProfileFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.UserProfileEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="UserProfileFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="UserProfileFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="UserProfileFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="UserProfileFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserProfileFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="UserProfileFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="UserProfileFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="UserProfileFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VideoEntry">class <strong>VideoEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a video<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#VideoEntry">VideoEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="VideoEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="VideoEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="VideoEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VideoEntryBase">class <strong>VideoEntryBase</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Elements that describe or contain videos<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#VideoEntryBase">VideoEntryBase</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>comments</strong> = <class 'gdata.data.Comments'><dd><tt>The gd:comments element.<br>
+ <br>
+Contains a comments feed for the enclosing entry (such as a calendar event).</tt></dl>
+
+<dl><dt><strong>group</strong> = <class 'gdata.youtube.data.YouTubeMediaGroup'><dd><tt>Describes a you tube media group</tt></dl>
+
+<dl><dt><strong>location</strong> = <class 'gdata.youtube.data.YtLocation'><dd><tt>Location</tt></dl>
+
+<dl><dt><strong>noembed</strong> = <class 'gdata.youtube.data.YtNoEmbed'><dd><tt>Disables embedding for the video</tt></dl>
+
+<dl><dt><strong>racy</strong> = <class 'gdata.youtube.data.YtRacy'><dd><tt>Mature content</tt></dl>
+
+<dl><dt><strong>rating</strong> = <class 'gdata.data.Rating'><dd><tt>The gd:rating element.<br>
+ <br>
+Represents a numeric rating of the enclosing entity, such as a<br>
+comment. Each rating supplies its own scale, although it may be<br>
+normalized by a service; for example, some services might convert all<br>
+ratings to a scale from 1 to 5.</tt></dl>
+
+<dl><dt><strong>recorded</strong> = <class 'gdata.youtube.data.YtRecorded'><dd><tt>Date when the video was recorded</tt></dl>
+
+<dl><dt><strong>statistics</strong> = <class 'gdata.youtube.data.YtVideoStatistics'><dd><tt>Video statistics</tt></dl>
+
+<dl><dt><strong>where</strong> = <class 'gdata.geo.data.GeoRssWhere'><dd><tt>Describes a geographical location or region.</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="VideoEntryBase-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="VideoEntryBase-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="VideoEntryBase-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoEntryBase-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoEntryBase-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoEntryBase-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoEntryBase-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VideoFeed">class <strong>VideoFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a video feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#VideoFeed">VideoFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.VideoEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="VideoFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="VideoFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="VideoFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="VideoFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VideoMessageEntry">class <strong>VideoMessageEntry</strong></a>(<a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a video message<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#VideoMessageEntry">VideoMessageEntry</a></dd>
+<dd><a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>description</strong> = <class 'gdata.youtube.data.YtDescription'><dd><tt>Description</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchEntry">gdata.data.BatchEntry</a>:<br>
+<dl><dt><strong>batch_id</strong> = <class 'gdata.data.BatchId'><dd><tt>Identifies a single operation in a batch request.</tt></dl>
+
+<dl><dt><strong>batch_operation</strong> = <class 'gdata.data.BatchOperation'><dd><tt>The CRUD operation which this batch entry represents.</tt></dl>
+
+<dl><dt><strong>batch_status</strong> = <class 'gdata.data.BatchStatus'><dd><tt>The batch:status element present in a batch response entry.<br>
+ <br>
+A status element contains the code (HTTP response code) and<br>
+reason as elements. In a single request these fields would<br>
+be part of the HTTP response, but in a batch request each<br>
+Entry operation has a corresponding Entry in the response<br>
+feed which includes status information.<br>
+ <br>
+See <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="VideoMessageEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="VideoMessageEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="VideoMessageEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoMessageEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoMessageEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VideoMessageFeed">class <strong>VideoMessageFeed</strong></a>(<a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes videos in a videoMessage<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#VideoMessageFeed">VideoMessageFeed</a></dd>
+<dd><a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.VideoMessageEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><a name="VideoMessageFeed-AddBatchEntry"><strong>AddBatchEntry</strong></a> = add_batch_entry(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-AddDelete"><strong>AddDelete</strong></a> = add_delete(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-AddInsert"><strong>AddInsert</strong></a> = add_insert(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-AddQuery"><strong>AddQuery</strong></a> = add_query(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-AddUpdate"><strong>AddUpdate</strong></a> = add_update(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindBatchLink"><strong>FindBatchLink</strong></a> = find_batch_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-add_batch_entry"><strong>add_batch_entry</strong></a>(self, entry<font color="#909090">=None</font>, id_url_string<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>, operation_string<font color="#909090">=None</font>)</dt><dd><tt>Logic for populating members of a <a href="gdata.data.html#BatchEntry">BatchEntry</a> and adding to the feed.<br>
+ <br>
+If the entry is not a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, it is converted to a <a href="gdata.data.html#BatchEntry">BatchEntry</a> so<br>
+that the batch specific members will be present.<br>
+ <br>
+The id_url_string can be used in place of an entry if the batch operation<br>
+applies to a URL. For example query and delete operations require just<br>
+the URL of an entry, no body is sent in the HTTP request. If an<br>
+id_url_string is sent instead of an entry, a <a href="gdata.data.html#BatchEntry">BatchEntry</a> is created and<br>
+added to the feed.<br>
+ <br>
+This method also assigns the desired batch id to the entry so that it<br>
+can be referenced in the server's response. If the batch_id_string is<br>
+None, this method will assign a batch_id to be the index at which this<br>
+entry will be in the feed's entry list.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a>, atom.data.Entry, or another Entry flavor (optional)<br>
+ The entry which will be sent to the server as part of the batch<br>
+ request. The item must have a valid atom id so that the server<br>
+ knows which entry this request references.<br>
+ id_url_string: str (optional) The URL of the entry to be acted on. You<br>
+ can find this URL in the text member of the atom id for an entry.<br>
+ If an entry is not sent, this id will be used to construct a new<br>
+ <a href="gdata.data.html#BatchEntry">BatchEntry</a> which will be added to the request feed.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.<br>
+ operation_string: str (optional) The desired batch operation which will<br>
+ set the batch_operation.type member of the entry. Options are<br>
+ 'insert', 'update', 'delete', and 'query'<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an<br>
+ entry are provided in the request.<br>
+ <br>
+Returns:<br>
+ The added entry.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-add_delete"><strong>add_delete</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a delete request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the atom id of the item<br>
+to be deleted, or the entry itself. The atom id of the entry must be<br>
+present so that the server knows which entry should be deleted.<br>
+ <br>
+Args:<br>
+ url_string: str (optional) The URL of the entry to be deleted. You can<br>
+ find this URL in the text member of the atom id for an entry.<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional) The entry to be deleted.<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters: Raised if neither a url_string nor an entry<br>
+ are provided in the request.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-add_insert"><strong>add_insert</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an insert request to the operations in this batch request feed.<br>
+ <br>
+If the entry doesn't yet have an operation or a batch id, these will<br>
+be set to the insert operation and a batch_id specified as a parameter.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent in the batch feed as an<br>
+ insert request.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. Note that batch_ids should either always be specified or<br>
+ never, mixing could potentially result in duplicate batch ids.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-add_query"><strong>add_query</strong></a>(self, url_string<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Adds a query request to the batch request feed.<br>
+ <br>
+This method takes either the url_string which is the query URL<br>
+whose results will be added to the result feed. The query URL will<br>
+be encapsulated in a <a href="gdata.data.html#BatchEntry">BatchEntry</a>, and you may pass in the <a href="gdata.data.html#BatchEntry">BatchEntry</a><br>
+with a query URL instead of sending a url_string.<br>
+ <br>
+Args:<br>
+ url_string: str (optional)<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> (optional)<br>
+ batch_id_string: str (optional)<br>
+ <br>
+Raises:<br>
+ MissingRequiredParameters</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-add_update"><strong>add_update</strong></a>(self, entry, batch_id_string<font color="#909090">=None</font>)</dt><dd><tt>Add an update request to the list of batch operations in this feed.<br>
+ <br>
+Sets the operation type of the entry to insert if it is not already set<br>
+and assigns the desired batch id to the entry so that it can be<br>
+referenced in the server's response.<br>
+ <br>
+Args:<br>
+ entry: <a href="gdata.data.html#BatchEntry">BatchEntry</a> The entry which will be sent to the server as an<br>
+ update (HTTP PUT) request. The item must have a valid atom id<br>
+ so that the server knows which entry to replace.<br>
+ batch_id_string: str (optional) The batch ID to be used to reference<br>
+ this batch operation in the results feed. If this parameter is None,<br>
+ the current length of the feed's entry array will be used as a<br>
+ count. See also comments for AddInsert.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_batch_link"><strong>find_batch_link</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#BatchFeed">gdata.data.BatchFeed</a>:<br>
+<dl><dt><strong>interrupted</strong> = <class 'gdata.data.BatchInterrupted'><dd><tt>The batch:interrupted element sent if batch request was interrupted.<br>
+ <br>
+Only appears in a feed if some of the batch entries could not be processed.<br>
+See: <a href="http://code.google.com/apis/gdata/batch.html#Handling_Errors">http://code.google.com/apis/gdata/batch.html#Handling_Errors</a></tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="VideoMessageFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="VideoMessageFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="VideoMessageFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoMessageFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoMessageFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoMessageFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VideoModerationEntry">class <strong>VideoModerationEntry</strong></a>(<a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes video moderation<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#VideoModerationEntry">VideoModerationEntry</a></dd>
+<dd><a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a></dd>
+<dd><a href="atom.data.html#Entry">atom.data.Entry</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>moderation_status</strong> = <class 'gdata.youtube.data.YtModerationStatus'><dd><tt>Moderation status</tt></dl>
+
+<dl><dt><strong>videoid</strong> = <class 'gdata.youtube.data.YtVideoId'><dd><tt>Video id</tt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><a name="VideoModerationEntry-FindMediaLink"><strong>FindMediaLink</strong></a> = find_media_link(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-IsMedia"><strong>IsMedia</strong></a> = is_media(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_media_link"><strong>find_media_link</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-is_media"><strong>is_media</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDEntry">gdata.data.GDEntry</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Entry">atom.data.Entry</a>:<br>
+<dl><dt><strong>content</strong> = <class 'atom.data.Content'><dd><tt>The atom:content element.</tt></dl>
+
+<dl><dt><strong>control</strong> = <class 'atom.data.Control'><dd><tt>The app:control element indicating restrictions on publication.<br>
+ <br>
+The APP control element may contain a draft element indicating whether or<br>
+not this entry should be publicly available.</tt></dl>
+
+<dl><dt><strong>published</strong> = <class 'atom.data.Published'><dd><tt>The atom:published element.</tt></dl>
+
+<dl><dt><strong>source</strong> = <class 'atom.data.Source'><dd><tt>The atom:source element.</tt></dl>
+
+<dl><dt><strong>summary</strong> = <class 'atom.data.Summary'><dd><tt>The atom:summary element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="VideoModerationEntry-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="VideoModerationEntry-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoModerationEntry-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoModerationEntry-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationEntry-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="VideoModerationFeed">class <strong>VideoModerationFeed</strong></a>(<a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a video moderation feed<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#VideoModerationFeed">VideoModerationFeed</a></dd>
+<dd><a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a></dd>
+<dd><a href="atom.data.html#Feed">atom.data.Feed</a></dd>
+<dd><a href="atom.data.html#Source">atom.data.Source</a></dd>
+<dd><a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a></dd>
+<dd><a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>entry</strong> = [<class 'gdata.youtube.data.VideoModerationEntry'>]</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><a name="VideoModerationFeed-GetId"><strong>GetId</strong></a> = get_id(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_generator"><strong>get_generator</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_id"><strong>get_id</strong></a>(self)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.data.html#GDFeed">gdata.data.GDFeed</a>:<br>
+<dl><dt><strong>etag</strong> = '{http://schemas.google.com/g/2005}etag'</dl>
+
+<dl><dt><strong>items_per_page</strong> = <class 'gdata.data.ItemsPerPage'><dd><tt>The opensearch:itemsPerPage element in GData feed.</tt></dl>
+
+<dl><dt><strong>start_index</strong> = <class 'gdata.data.StartIndex'><dd><tt>The opensearch:startIndex element in GData feed.</tt></dl>
+
+<dl><dt><strong>total_results</strong> = <class 'gdata.data.TotalResults'><dd><tt>opensearch:TotalResults for a GData feed.</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Source">atom.data.Source</a>:<br>
+<dl><dt><strong>generator</strong> = <class 'atom.data.Generator'><dd><tt>The atom:generator element.</tt></dl>
+
+<dl><dt><strong>icon</strong> = <class 'atom.data.Icon'><dd><tt>The atom:icon element.</tt></dl>
+
+<dl><dt><strong>logo</strong> = <class 'atom.data.Logo'><dd><tt>The atom:logo element.</tt></dl>
+
+<dl><dt><strong>subtitle</strong> = <class 'atom.data.Subtitle'><dd><tt>The atom:subtitle element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><a name="VideoModerationFeed-__init__"><strong>__init__</strong></a>(self, atom_id<font color="#909090">=None</font>, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#FeedEntryParent">atom.data.FeedEntryParent</a>:<br>
+<dl><dt><strong>author</strong> = [<class 'atom.data.Author'>]</dl>
+
+<dl><dt><strong>category</strong> = [<class 'atom.data.Category'>]</dl>
+
+<dl><dt><strong>contributor</strong> = [<class 'atom.data.Contributor'>]</dl>
+
+<dl><dt><strong>id</strong> = <class 'atom.data.Id'><dd><tt>The atom:id element.</tt></dl>
+
+<dl><dt><strong>link</strong> = [<class 'atom.data.Link'>]</dl>
+
+<dl><dt><strong>rights</strong> = <class 'atom.data.Rights'><dd><tt>The atom:rights element.</tt></dl>
+
+<dl><dt><strong>title</strong> = <class 'atom.data.Title'><dd><tt>The atom:title element.</tt></dl>
+
+<dl><dt><strong>updated</strong> = <class 'atom.data.Updated'><dd><tt>The atom:updated element.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="VideoModerationFeed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="gdata.data.html#LinkFinder">gdata.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoModerationFeed-FindAclLink"><strong>FindAclLink</strong></a> = find_acl_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-FindFeedLink"><strong>FindFeedLink</strong></a> = find_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-FindHtmlLink"><strong>FindHtmlLink</strong></a> = find_html_link(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-FindPostLink"><strong>FindPostLink</strong></a> = find_post_link(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-FindPreviousLink"><strong>FindPreviousLink</strong></a> = find_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetAclLink"><strong>GetAclLink</strong></a> = get_acl_link(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetFeedLink"><strong>GetFeedLink</strong></a> = get_feed_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a> = get_html_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetPostLink"><strong>GetPostLink</strong></a> = get_post_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetPreviousLink"><strong>GetPreviousLink</strong></a> = get_previous_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_acl_link"><strong>find_acl_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_feed_link"><strong>find_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_html_link"><strong>find_html_link</strong></a>(self)</dt><dd><tt>Finds the first link with rel of alternate and type of text/html.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_post_link"><strong>find_post_link</strong></a>(self)</dt><dd><tt>Get the URL to which new entries should be POSTed.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A str for the URL in the link with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_previous_link"><strong>find_previous_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_acl_link"><strong>get_acl_link</strong></a>(self)</dt><dd><tt>Searches for a link or feed_link (if present) with the rel for ACL.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_feed_link"><strong>get_feed_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_html_link"><strong>get_html_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_post_link"><strong>get_post_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_previous_link"><strong>get_previous_link</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.data.html#LinkFinder">atom.data.LinkFinder</a>:<br>
+<dl><dt><a name="VideoModerationFeed-FindAlternateLink"><strong>FindAlternateLink</strong></a> = find_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-FindEditLink"><strong>FindEditLink</strong></a> = find_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-FindEditMediaLink"><strong>FindEditMediaLink</strong></a> = find_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-FindLicenseLink"><strong>FindLicenseLink</strong></a> = find_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-FindNextLink"><strong>FindNextLink</strong></a> = find_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-FindSelfLink"><strong>FindSelfLink</strong></a> = find_self_link(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-FindUrl"><strong>FindUrl</strong></a> = find_url(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a> = get_alternate_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetEditLink"><strong>GetEditLink</strong></a> = get_edit_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a> = get_edit_media_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a> = get_license_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetLink"><strong>GetLink</strong></a> = get_link(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetNextLink"><strong>GetNextLink</strong></a> = get_next_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-GetSelfLink"><strong>GetSelfLink</strong></a> = get_self_link(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_alternate_link"><strong>find_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_edit_link"><strong>find_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_edit_media_link"><strong>find_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_license_link"><strong>find_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_next_link"><strong>find_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_self_link"><strong>find_self_link</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ A str containing the link's href or None if none of the links had rel<br>
+ equal to 'self'</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-find_url"><strong>find_url</strong></a>(self, rel)</dt><dd><tt>Returns the URL (as a string) in a link with the desired rel value.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_alternate_link"><strong>get_alternate_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_edit_link"><strong>get_edit_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_edit_media_link"><strong>get_edit_media_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_license_link"><strong>get_license_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_link"><strong>get_link</strong></a>(self, rel)</dt><dd><tt>Returns a link object which has the desired rel value.<br>
+ <br>
+If you are interested in the URL instead of the link object,<br>
+consider using find_url instead.</tt></dd></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_next_link"><strong>get_next_link</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="VideoModerationFeed-get_self_link"><strong>get_self_link</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeAppControl">class <strong>YouTubeAppControl</strong></a>(<a href="atom.data.html#Control">atom.data.Control</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a you tube app control<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YouTubeAppControl">YouTubeAppControl</a></dd>
+<dd><a href="atom.data.html#Control">atom.data.Control</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>state</strong> = <class 'gdata.youtube.data.YtPublicationState'><dd><tt>Status of an unpublished video</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Control">atom.data.Control</a>:<br>
+<dl><dt><strong>draft</strong> = <class 'atom.data.Draft'><dd><tt>The app:draft element which indicates if this entry should be public.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YouTubeAppControl-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeAppControl-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeAppControl-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeAppControl-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeAppControl-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeAppControl-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeAppControl-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeAppControl-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeAppControl-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeAppControl-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeCaptionAppControl">class <strong>YouTubeCaptionAppControl</strong></a>(<a href="atom.data.html#Control">atom.data.Control</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a you tube caption app control<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YouTubeCaptionAppControl">YouTubeCaptionAppControl</a></dd>
+<dd><a href="atom.data.html#Control">atom.data.Control</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>state</strong> = <class 'gdata.youtube.data.YtCaptionPublicationState'><dd><tt>Status of an unpublished caption track</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="atom.data.html#Control">atom.data.Control</a>:<br>
+<dl><dt><strong>draft</strong> = <class 'atom.data.Draft'><dd><tt>The app:draft element which indicates if this entry should be public.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YouTubeCaptionAppControl-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeCaptionAppControl-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeCaptionAppControl-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeCaptionAppControl-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeCaptionAppControl-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeCaptionAppControl-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeCaptionAppControl-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeCaptionAppControl-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeCaptionAppControl-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeCaptionAppControl-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeMediaContent">class <strong>YouTubeMediaContent</strong></a>(<a href="gdata.media.data.html#MediaContent">gdata.media.data.MediaContent</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a you tube media content<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YouTubeMediaContent">YouTubeMediaContent</a></dd>
+<dd><a href="gdata.media.data.html#MediaContent">gdata.media.data.MediaContent</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>format</strong> = 'format'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.media.data.html#MediaContent">gdata.media.data.MediaContent</a>:<br>
+<dl><dt><strong>bitrate</strong> = 'bitrate'</dl>
+
+<dl><dt><strong>category</strong> = [<class 'gdata.media.data.MediaCategory'>]</dl>
+
+<dl><dt><strong>channels</strong> = 'channels'</dl>
+
+<dl><dt><strong>copyright</strong> = <class 'gdata.media.data.MediaCopyright'><dd><tt>Describes a media copyright.</tt></dl>
+
+<dl><dt><strong>credit</strong> = [<class 'gdata.media.data.MediaCredit'>]</dl>
+
+<dl><dt><strong>description</strong> = <class 'gdata.media.data.MediaDescription'><dd><tt>Describes a media description.</tt></dl>
+
+<dl><dt><strong>duration</strong> = 'duration'</dl>
+
+<dl><dt><strong>expression</strong> = 'expression'</dl>
+
+<dl><dt><strong>file_size</strong> = 'fileSize'</dl>
+
+<dl><dt><strong>framerate</strong> = 'framerate'</dl>
+
+<dl><dt><strong>hash</strong> = <class 'gdata.media.data.MediaHash'><dd><tt>Describes a media hash.</tt></dl>
+
+<dl><dt><strong>height</strong> = 'height'</dl>
+
+<dl><dt><strong>is_default</strong> = 'isDefault'</dl>
+
+<dl><dt><strong>keywords</strong> = <class 'gdata.media.data.MediaKeywords'><dd><tt>Describes a media keywords.</tt></dl>
+
+<dl><dt><strong>language</strong> = 'language'</dl>
+
+<dl><dt><strong>medium</strong> = 'medium'</dl>
+
+<dl><dt><strong>player</strong> = <class 'gdata.media.data.MediaPlayer'><dd><tt>Describes a media player.</tt></dl>
+
+<dl><dt><strong>rating</strong> = [<class 'gdata.media.data.MediaRating'>]</dl>
+
+<dl><dt><strong>restriction</strong> = [<class 'gdata.media.data.MediaRestriction'>]</dl>
+
+<dl><dt><strong>samplingrate</strong> = 'samplingrate'</dl>
+
+<dl><dt><strong>text</strong> = [<class 'gdata.media.data.MediaText'>]</dl>
+
+<dl><dt><strong>thumbnail</strong> = [<class 'gdata.media.data.MediaThumbnail'>]</dl>
+
+<dl><dt><strong>title</strong> = <class 'gdata.media.data.MediaTitle'><dd><tt>Describes a media title.</tt></dl>
+
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<dl><dt><strong>url</strong> = 'url'</dl>
+
+<dl><dt><strong>width</strong> = 'width'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YouTubeMediaContent-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaContent-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaContent-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaContent-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaContent-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaContent-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeMediaContent-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeMediaContent-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaContent-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaContent-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeMediaCredit">class <strong>YouTubeMediaCredit</strong></a>(<a href="gdata.media.data.html#MediaCredit">gdata.media.data.MediaCredit</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a you tube media credit<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YouTubeMediaCredit">YouTubeMediaCredit</a></dd>
+<dd><a href="gdata.media.data.html#MediaCredit">gdata.media.data.MediaCredit</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>type</strong> = 'type'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.media.data.html#MediaCredit">gdata.media.data.MediaCredit</a>:<br>
+<dl><dt><strong>role</strong> = 'role'</dl>
+
+<dl><dt><strong>scheme</strong> = 'scheme'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YouTubeMediaCredit-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaCredit-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaCredit-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaCredit-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaCredit-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaCredit-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeMediaCredit-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeMediaCredit-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaCredit-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaCredit-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeMediaGroup">class <strong>YouTubeMediaGroup</strong></a>(<a href="gdata.media.data.html#MediaGroup">gdata.media.data.MediaGroup</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a you tube media group<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YouTubeMediaGroup">YouTubeMediaGroup</a></dd>
+<dd><a href="gdata.media.data.html#MediaGroup">gdata.media.data.MediaGroup</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>aspect_ratio</strong> = <class 'gdata.youtube.data.YtAspectRatio'><dd><tt>The aspect ratio of a media file</tt></dl>
+
+<dl><dt><strong>duration</strong> = <class 'gdata.youtube.data.YtDuration'><dd><tt>Video duration</tt></dl>
+
+<dl><dt><strong>private</strong> = <class 'gdata.youtube.data.YtPrivate'><dd><tt>Flags the entry as private</tt></dl>
+
+<dl><dt><strong>uploaded</strong> = <class 'gdata.youtube.data.YtUploaded'><dd><tt>Date/Time at which the video was uploaded</tt></dl>
+
+<dl><dt><strong>videoid</strong> = <class 'gdata.youtube.data.YtVideoId'><dd><tt>Video id</tt></dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.media.data.html#MediaGroup">gdata.media.data.MediaGroup</a>:<br>
+<dl><dt><strong>category</strong> = [<class 'gdata.media.data.MediaCategory'>]</dl>
+
+<dl><dt><strong>content</strong> = [<class 'gdata.media.data.MediaContent'>]</dl>
+
+<dl><dt><strong>copyright</strong> = <class 'gdata.media.data.MediaCopyright'><dd><tt>Describes a media copyright.</tt></dl>
+
+<dl><dt><strong>credit</strong> = [<class 'gdata.media.data.MediaCredit'>]</dl>
+
+<dl><dt><strong>description</strong> = <class 'gdata.media.data.MediaDescription'><dd><tt>Describes a media description.</tt></dl>
+
+<dl><dt><strong>hash</strong> = <class 'gdata.media.data.MediaHash'><dd><tt>Describes a media hash.</tt></dl>
+
+<dl><dt><strong>keywords</strong> = <class 'gdata.media.data.MediaKeywords'><dd><tt>Describes a media keywords.</tt></dl>
+
+<dl><dt><strong>player</strong> = <class 'gdata.media.data.MediaPlayer'><dd><tt>Describes a media player.</tt></dl>
+
+<dl><dt><strong>rating</strong> = [<class 'gdata.media.data.MediaRating'>]</dl>
+
+<dl><dt><strong>restriction</strong> = [<class 'gdata.media.data.MediaRestriction'>]</dl>
+
+<dl><dt><strong>text</strong> = [<class 'gdata.media.data.MediaText'>]</dl>
+
+<dl><dt><strong>thumbnail</strong> = [<class 'gdata.media.data.MediaThumbnail'>]</dl>
+
+<dl><dt><strong>title</strong> = <class 'gdata.media.data.MediaTitle'><dd><tt>Describes a media title.</tt></dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YouTubeMediaGroup-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaGroup-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaGroup-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaGroup-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaGroup-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaGroup-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeMediaGroup-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeMediaGroup-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaGroup-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaGroup-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeMediaRating">class <strong>YouTubeMediaRating</strong></a>(<a href="gdata.media.data.html#MediaRating">gdata.media.data.MediaRating</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Describes a you tube media rating<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YouTubeMediaRating">YouTubeMediaRating</a></dd>
+<dd><a href="gdata.media.data.html#MediaRating">gdata.media.data.MediaRating</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>country</strong> = 'country'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.media.data.html#MediaRating">gdata.media.data.MediaRating</a>:<br>
+<dl><dt><strong>scheme</strong> = 'scheme'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YouTubeMediaRating-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaRating-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaRating-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaRating-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaRating-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaRating-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YouTubeMediaRating-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeMediaRating-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaRating-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeMediaRating-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtAboutMe">class <strong>YtAboutMe</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's self description<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtAboutMe">YtAboutMe</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtAboutMe-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAboutMe-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAboutMe-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtAboutMe-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAboutMe-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtAboutMe-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtAboutMe-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtAboutMe-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtAboutMe-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAboutMe-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtAge">class <strong>YtAge</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's age<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtAge">YtAge</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtAge-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAge-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAge-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtAge-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAge-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtAge-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtAge-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtAge-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtAge-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAge-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtAspectRatio">class <strong>YtAspectRatio</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The aspect ratio of a media file<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtAspectRatio">YtAspectRatio</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtAspectRatio-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAspectRatio-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAspectRatio-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtAspectRatio-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAspectRatio-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtAspectRatio-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtAspectRatio-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtAspectRatio-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtAspectRatio-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtAspectRatio-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtBasePublicationState">class <strong>YtBasePublicationState</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Status of an unpublished entry<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtBasePublicationState">YtBasePublicationState</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>help_url</strong> = 'helpUrl'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtBasePublicationState-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtBasePublicationState-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtBasePublicationState-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtBasePublicationState-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtBasePublicationState-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtBasePublicationState-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtBasePublicationState-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtBasePublicationState-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtBasePublicationState-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtBasePublicationState-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtBooks">class <strong>YtBooks</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's favorite books<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtBooks">YtBooks</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtBooks-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtBooks-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtBooks-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtBooks-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtBooks-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtBooks-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtBooks-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtBooks-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtBooks-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtBooks-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtCaptionPublicationState">class <strong>YtCaptionPublicationState</strong></a>(<a href="gdata.youtube.data.html#YtBasePublicationState">YtBasePublicationState</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Status of an unpublished caption track<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtCaptionPublicationState">YtCaptionPublicationState</a></dd>
+<dd><a href="gdata.youtube.data.html#YtBasePublicationState">YtBasePublicationState</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>reason_code</strong> = 'reasonCode'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.youtube.data.html#YtBasePublicationState">YtBasePublicationState</a>:<br>
+<dl><dt><strong>help_url</strong> = 'helpUrl'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtCaptionPublicationState-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCaptionPublicationState-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCaptionPublicationState-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtCaptionPublicationState-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCaptionPublicationState-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtCaptionPublicationState-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtCaptionPublicationState-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtCaptionPublicationState-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtCaptionPublicationState-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCaptionPublicationState-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtCompany">class <strong>YtCompany</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's company<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtCompany">YtCompany</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtCompany-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCompany-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCompany-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtCompany-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCompany-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtCompany-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtCompany-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtCompany-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtCompany-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCompany-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtCountHint">class <strong>YtCountHint</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Hint as to how many entries the linked feed contains<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtCountHint">YtCountHint</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtCountHint-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCountHint-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCountHint-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtCountHint-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCountHint-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtCountHint-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtCountHint-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtCountHint-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtCountHint-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtCountHint-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtDescription">class <strong>YtDescription</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Description<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtDescription">YtDescription</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtDescription-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtDescription-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtDescription-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtDescription-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtDescription-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtDescription-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtDescription-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtDescription-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtDescription-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtDescription-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtDuration">class <strong>YtDuration</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Video duration<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtDuration">YtDuration</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>seconds</strong> = 'seconds'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtDuration-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtDuration-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtDuration-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtDuration-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtDuration-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtDuration-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtDuration-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtDuration-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtDuration-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtDuration-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtFirstName">class <strong>YtFirstName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's first name<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtFirstName">YtFirstName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtFirstName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtFirstName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtFirstName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtFirstName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtFirstName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtFirstName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtFirstName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtFirstName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtFirstName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtFirstName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtGender">class <strong>YtGender</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's gender<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtGender">YtGender</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtGender-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtGender-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtGender-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtGender-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtGender-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtGender-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtGender-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtGender-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtGender-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtGender-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtHobbies">class <strong>YtHobbies</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's hobbies<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtHobbies">YtHobbies</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtHobbies-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtHobbies-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtHobbies-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtHobbies-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtHobbies-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtHobbies-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtHobbies-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtHobbies-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtHobbies-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtHobbies-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtHometown">class <strong>YtHometown</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's hometown<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtHometown">YtHometown</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtHometown-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtHometown-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtHometown-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtHometown-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtHometown-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtHometown-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtHometown-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtHometown-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtHometown-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtHometown-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtLastName">class <strong>YtLastName</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's last name<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtLastName">YtLastName</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtLastName-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtLastName-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtLastName-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtLastName-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtLastName-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtLastName-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtLastName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtLastName-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtLastName-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtLastName-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtLocation">class <strong>YtLocation</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Location<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtLocation">YtLocation</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtLocation-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtLocation-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtLocation-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtLocation-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtLocation-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtLocation-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtLocation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtLocation-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtLocation-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtLocation-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtModerationStatus">class <strong>YtModerationStatus</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Moderation status<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtModerationStatus">YtModerationStatus</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtModerationStatus-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtModerationStatus-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtModerationStatus-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtModerationStatus-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtModerationStatus-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtModerationStatus-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtModerationStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtModerationStatus-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtModerationStatus-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtModerationStatus-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtMovies">class <strong>YtMovies</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's favorite movies<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtMovies">YtMovies</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtMovies-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtMovies-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtMovies-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtMovies-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtMovies-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtMovies-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtMovies-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtMovies-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtMovies-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtMovies-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtMusic">class <strong>YtMusic</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's favorite music<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtMusic">YtMusic</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtMusic-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtMusic-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtMusic-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtMusic-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtMusic-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtMusic-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtMusic-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtMusic-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtMusic-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtMusic-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtNoEmbed">class <strong>YtNoEmbed</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Disables embedding for the video<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtNoEmbed">YtNoEmbed</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtNoEmbed-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtNoEmbed-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtNoEmbed-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtNoEmbed-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtNoEmbed-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtNoEmbed-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtNoEmbed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtNoEmbed-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtNoEmbed-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtNoEmbed-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtOccupation">class <strong>YtOccupation</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's occupation<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtOccupation">YtOccupation</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtOccupation-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtOccupation-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtOccupation-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtOccupation-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtOccupation-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtOccupation-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtOccupation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtOccupation-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtOccupation-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtOccupation-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtPlaylistId">class <strong>YtPlaylistId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Playlist id<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtPlaylistId">YtPlaylistId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtPlaylistId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtPlaylistId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtPlaylistId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtPlaylistTitle">class <strong>YtPlaylistTitle</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Playlist title<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtPlaylistTitle">YtPlaylistTitle</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtPlaylistTitle-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistTitle-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistTitle-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistTitle-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistTitle-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistTitle-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtPlaylistTitle-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtPlaylistTitle-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistTitle-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPlaylistTitle-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtPosition">class <strong>YtPosition</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Video position on the playlist<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtPosition">YtPosition</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtPosition-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPosition-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPosition-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtPosition-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPosition-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtPosition-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtPosition-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtPosition-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtPosition-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPosition-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtPrivate">class <strong>YtPrivate</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Flags the entry as private<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtPrivate">YtPrivate</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtPrivate-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPrivate-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPrivate-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtPrivate-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPrivate-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtPrivate-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtPrivate-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtPrivate-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtPrivate-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPrivate-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtPublicationState">class <strong>YtPublicationState</strong></a>(<a href="gdata.youtube.data.html#YtBasePublicationState">YtBasePublicationState</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Status of an unpublished video<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtPublicationState">YtPublicationState</a></dd>
+<dd><a href="gdata.youtube.data.html#YtBasePublicationState">YtBasePublicationState</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>name</strong> = 'name'</dl>
+
+<dl><dt><strong>reason_code</strong> = 'reasonCode'</dl>
+
+<hr>
+Data and other attributes inherited from <a href="gdata.youtube.data.html#YtBasePublicationState">YtBasePublicationState</a>:<br>
+<dl><dt><strong>help_url</strong> = 'helpUrl'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtPublicationState-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPublicationState-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPublicationState-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtPublicationState-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPublicationState-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtPublicationState-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtPublicationState-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtPublicationState-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtPublicationState-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtPublicationState-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtQueryString">class <strong>YtQueryString</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Keywords or query string associated with a subscription<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtQueryString">YtQueryString</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtQueryString-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtQueryString-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtQueryString-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtQueryString-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtQueryString-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtQueryString-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtQueryString-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtQueryString-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtQueryString-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtQueryString-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtRacy">class <strong>YtRacy</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Mature content<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtRacy">YtRacy</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtRacy-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRacy-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRacy-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtRacy-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRacy-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtRacy-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtRacy-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtRacy-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtRacy-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRacy-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtRecorded">class <strong>YtRecorded</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Date when the video was recorded<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtRecorded">YtRecorded</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtRecorded-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRecorded-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRecorded-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtRecorded-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRecorded-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtRecorded-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtRecorded-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtRecorded-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtRecorded-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRecorded-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtRelationship">class <strong>YtRelationship</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's relationship status<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtRelationship">YtRelationship</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtRelationship-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRelationship-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRelationship-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtRelationship-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRelationship-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtRelationship-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtRelationship-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtRelationship-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtRelationship-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtRelationship-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtSchool">class <strong>YtSchool</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User's school<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtSchool">YtSchool</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtSchool-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtSchool-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtSchool-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtSchool-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtSchool-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtSchool-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtSchool-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtSchool-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtSchool-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtSchool-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtSpam">class <strong>YtSpam</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Indicates that the entry probably contains spam<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtSpam">YtSpam</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtSpam-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtSpam-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtSpam-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtSpam-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtSpam-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtSpam-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtSpam-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtSpam-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtSpam-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtSpam-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtStatistics">class <strong>YtStatistics</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Video and user statistics<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtStatistics">YtStatistics</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>favorite_count</strong> = 'favoriteCount'</dl>
+
+<dl><dt><strong>last_web_access</strong> = 'lastWebAccess'</dl>
+
+<dl><dt><strong>subscriber_count</strong> = 'subscriberCount'</dl>
+
+<dl><dt><strong>video_watch_count</strong> = 'videoWatchCount'</dl>
+
+<dl><dt><strong>view_count</strong> = 'viewCount'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtStatistics-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtStatistics-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtStatistics-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtStatistics-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtStatistics-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtStatistics-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtStatistics-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtStatistics-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtStatistics-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtStatistics-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtStatus">class <strong>YtStatus</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Status of a contact<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtStatus">YtStatus</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtStatus-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtStatus-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtStatus-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtStatus-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtStatus-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtStatus-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtStatus-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtStatus-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtStatus-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtStatus-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtUploaded">class <strong>YtUploaded</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Date/Time at which the video was uploaded<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtUploaded">YtUploaded</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtUploaded-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUploaded-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUploaded-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtUploaded-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUploaded-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtUploaded-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtUploaded-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtUploaded-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtUploaded-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUploaded-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtUserProfileStatistics">class <strong>YtUserProfileStatistics</strong></a>(<a href="gdata.youtube.data.html#YtStatistics">YtStatistics</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>User statistics<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtUserProfileStatistics">YtUserProfileStatistics</a></dd>
+<dd><a href="gdata.youtube.data.html#YtStatistics">YtStatistics</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.youtube.data.html#YtStatistics">YtStatistics</a>:<br>
+<dl><dt><strong>favorite_count</strong> = 'favoriteCount'</dl>
+
+<dl><dt><strong>last_web_access</strong> = 'lastWebAccess'</dl>
+
+<dl><dt><strong>subscriber_count</strong> = 'subscriberCount'</dl>
+
+<dl><dt><strong>video_watch_count</strong> = 'videoWatchCount'</dl>
+
+<dl><dt><strong>view_count</strong> = 'viewCount'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtUserProfileStatistics-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUserProfileStatistics-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUserProfileStatistics-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtUserProfileStatistics-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUserProfileStatistics-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtUserProfileStatistics-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtUserProfileStatistics-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtUserProfileStatistics-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtUserProfileStatistics-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUserProfileStatistics-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtUsername">class <strong>YtUsername</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Youtube username<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtUsername">YtUsername</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtUsername-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUsername-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUsername-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtUsername-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUsername-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtUsername-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtUsername-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtUsername-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtUsername-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtUsername-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtVideoId">class <strong>YtVideoId</strong></a>(<a href="atom.core.html#XmlElement">atom.core.XmlElement</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Video id<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtVideoId">YtVideoId</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtVideoId-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoId-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoId-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoId-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoId-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoId-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtVideoId-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtVideoId-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoId-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoId-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YtVideoStatistics">class <strong>YtVideoStatistics</strong></a>(<a href="gdata.youtube.data.html#YtStatistics">YtStatistics</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Video statistics<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.data.html#YtVideoStatistics">YtVideoStatistics</a></dd>
+<dd><a href="gdata.youtube.data.html#YtStatistics">YtStatistics</a></dd>
+<dd><a href="atom.core.html#XmlElement">atom.core.XmlElement</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.youtube.data.html#YtStatistics">YtStatistics</a>:<br>
+<dl><dt><strong>favorite_count</strong> = 'favoriteCount'</dl>
+
+<dl><dt><strong>last_web_access</strong> = 'lastWebAccess'</dl>
+
+<dl><dt><strong>subscriber_count</strong> = 'subscriberCount'</dl>
+
+<dl><dt><strong>video_watch_count</strong> = 'videoWatchCount'</dl>
+
+<dl><dt><strong>view_count</strong> = 'viewCount'</dl>
+
+<hr>
+Methods inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><a name="YtVideoStatistics-FindChildren"><strong>FindChildren</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoStatistics-FindExtensions"><strong>FindExtensions</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoStatistics-GetAttributes"><strong>GetAttributes</strong></a> = get_attributes(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoStatistics-GetElements"><strong>GetElements</strong></a> = get_elements(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoStatistics-ToString"><strong>ToString</strong></a> = to_string(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoStatistics-__init__"><strong>__init__</strong></a>(self, text<font color="#909090">=None</font>, *args, **kwargs)</dt></dl>
+
+<dl><dt><a name="YtVideoStatistics-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YtVideoStatistics-get_attributes"><strong>get_attributes</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all attributes which match the tag and namespace.<br>
+ <br>
+To find all attributes in this object, call get_attributes with the tag<br>
+and namespace both set to None (the default). This method searches<br>
+through the object's members and the attributes stored in<br>
+_other_attributes which did not fit any of the XML parsing rules for this<br>
+class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching attributes.<br>
+ <br>
+Returns:<br>
+ A list of XmlAttribute objects for the matching attributes.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoStatistics-get_elements"><strong>get_elements</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>, version<font color="#909090">=1</font>)</dt><dd><tt>Find all sub elements which match the tag and namespace.<br>
+ <br>
+To find all elements in this object, call get_elements with the tag and<br>
+namespace both set to None (the default). This method searches through<br>
+the object's members and the elements stored in _other_elements which<br>
+did not match any of the XML parsing rules for this class.<br>
+ <br>
+Args:<br>
+ tag: str<br>
+ namespace: str<br>
+ version: int Specifies the version of the XML rules to be used when<br>
+ searching for matching elements.<br>
+ <br>
+Returns:<br>
+ A list of the matching XmlElements.</tt></dd></dl>
+
+<dl><dt><a name="YtVideoStatistics-to_string"><strong>to_string</strong></a>(self, version<font color="#909090">=1</font>, encoding<font color="#909090">=None</font>, pretty_print<font color="#909090">=None</font>)</dt><dd><tt>Converts this object to XML.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>attributes</strong></dt>
+</dl>
+<dl><dt><strong>children</strong></dt>
+</dl>
+<dl><dt><strong>extension_attributes</strong></dt>
+</dl>
+<dl><dt><strong>extension_elements</strong></dt>
+</dl>
+<dl><dt><strong>namespace</strong></dt>
+</dl>
+<dl><dt><strong>tag</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.core.html#XmlElement">atom.core.XmlElement</a>:<br>
+<dl><dt><strong>text</strong> = None</dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>YT_TEMPLATE</strong> = '{http://gdata.youtube.com/schemas/2007/}%s'<br>
+<strong>__author__</strong> = 'j.s@google.com (Jeff Scudder)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">j.s@google.com (Jeff Scudder)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.youtube.html b/pydocs/gdata.youtube.html
new file mode 100644
index 0000000..182c761
--- /dev/null
+++ b/pydocs/gdata.youtube.html
@@ -0,0 +1,3177 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: package gdata.youtube</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.youtube</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/youtube/__init__.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/youtube/__init__.py</a></font></td></tr></table>
+ <p><tt># Copyright (C) 2008 Google Inc.<br>
+#<br>
+# Licensed under the Apache License, Version 2.0 (the "License");<br>
+# you may not use this file except in compliance with the License.<br>
+# You may obtain a copy of the License at<br>
+#<br>
+# <a href="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</a><br>
+#<br>
+# Unless required by applicable law or agreed to in writing, software<br>
+# distributed under the License is distributed on an "AS IS" BASIS,<br>
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<br>
+# See the License for the specific language governing permissions and<br>
+# limitations under the License.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Package Contents</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="gdata.youtube.client.html">client</a><br>
+</td><td width="25%" valign=top><a href="gdata.youtube.data.html">data</a><br>
+</td><td width="25%" valign=top><a href="gdata.youtube.service.html">service</a><br>
+</td><td width="25%" valign=top></td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="atom.html#AtomBase">atom.AtomBase</a>(<a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.html#Age">Age</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Books">Books</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Comments">Comments</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Company">Company</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Description">Description</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#FirstName">FirstName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Gender">Gender</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Hobbies">Hobbies</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Hometown">Hometown</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#LastName">LastName</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Location">Location</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Movies">Movies</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Music">Music</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#NoEmbed">NoEmbed</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Occupation">Occupation</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Position">Position</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Private">Private</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#QueryString">QueryString</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Racy">Racy</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Rating">Rating</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Recorded">Recorded</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Relationship">Relationship</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#School">School</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Statistics">Statistics</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Status">Status</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#Username">Username</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataEntry">gdata.GDataEntry</a>(<a href="atom.html#Entry">atom.Entry</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeContactEntry">YouTubeContactEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubePlaylistEntry">YouTubePlaylistEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubePlaylistVideoEntry">YouTubePlaylistVideoEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeSubscriptionEntry">YouTubeSubscriptionEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeUserEntry">YouTubeUserEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeVideoCommentEntry">YouTubeVideoCommentEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeVideoEntry">YouTubeVideoEntry</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeVideoResponseEntry">YouTubeVideoResponseEntry</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#GDataFeed">gdata.GDataFeed</a>(<a href="atom.html#Feed">atom.Feed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeContactFeed">YouTubeContactFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubePlaylistFeed">YouTubePlaylistFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubePlaylistVideoFeed">YouTubePlaylistVideoFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeSubscriptionFeed">YouTubeSubscriptionFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeVideoCommentFeed">YouTubeVideoCommentFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeVideoFeed">YouTubeVideoFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeVideoResponseFeed">YouTubeVideoResponseFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.html#LinkFinder">gdata.LinkFinder</a>(<a href="atom.html#LinkFinder">atom.LinkFinder</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeContactFeed">YouTubeContactFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubePlaylistFeed">YouTubePlaylistFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubePlaylistVideoFeed">YouTubePlaylistVideoFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeSubscriptionFeed">YouTubeSubscriptionFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeVideoCommentFeed">YouTubeVideoCommentFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeVideoFeed">YouTubeVideoFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.html#YouTubeVideoResponseFeed">YouTubeVideoResponseFeed</a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)
+</font></dt></dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Age">class <strong>Age</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Age">Age</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Age">Age</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Age-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Age-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Age-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Age-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Books">class <strong>Books</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Books">Books</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Books">Books</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Books-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Books-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Books-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Books-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Comments">class <strong>Comments</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The GData <a href="#Comments">Comments</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Comments">Comments</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Comments-__init__"><strong>__init__</strong></a>(self, feed_link<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Comments-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Comments-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Comments-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Company">class <strong>Company</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Company">Company</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Company">Company</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Company-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Company-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Company-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Company-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Description">class <strong>Description</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Description">Description</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Description">Description</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Description-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Description-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Description-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Description-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="FirstName">class <strong>FirstName</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#FirstName">FirstName</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#FirstName">FirstName</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="FirstName-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="FirstName-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="FirstName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="FirstName-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Gender">class <strong>Gender</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Gender">Gender</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Gender">Gender</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Gender-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Gender-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Gender-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Gender-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Hobbies">class <strong>Hobbies</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Hobbies">Hobbies</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Hobbies">Hobbies</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Hobbies-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Hobbies-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Hobbies-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Hobbies-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Hometown">class <strong>Hometown</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Hometown">Hometown</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Hometown">Hometown</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Hometown-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Hometown-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Hometown-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Hometown-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="LastName">class <strong>LastName</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#LastName">LastName</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#LastName">LastName</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="LastName-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="LastName-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="LastName-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="LastName-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Location">class <strong>Location</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Location">Location</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Location">Location</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Location-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Location-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Location-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Location-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Movies">class <strong>Movies</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Movies">Movies</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Movies">Movies</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Movies-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Movies-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Movies-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Movies-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Music">class <strong>Music</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Music">Music</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Music">Music</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Music-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Music-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Music-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Music-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="NoEmbed">class <strong>NoEmbed</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube VideoShare element. Whether a video can be embedded or not.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#NoEmbed">NoEmbed</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="NoEmbed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="NoEmbed-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="NoEmbed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="NoEmbed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Occupation">class <strong>Occupation</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Occupation">Occupation</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Occupation">Occupation</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Occupation-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Occupation-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Occupation-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Occupation-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Position">class <strong>Position</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Position">Position</a> element. The position in a playlist feed.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Position">Position</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Position-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Position-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Position-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Position-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Private">class <strong>Private</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Private">Private</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Private">Private</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Private-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Private-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Private-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Private-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="QueryString">class <strong>QueryString</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#QueryString">QueryString</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#QueryString">QueryString</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="QueryString-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="QueryString-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="QueryString-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="QueryString-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Racy">class <strong>Racy</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Racy">Racy</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Racy">Racy</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Racy-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Racy-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Racy-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Racy-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Rating">class <strong>Rating</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The GData <a href="#Rating">Rating</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Rating">Rating</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Rating-__init__"><strong>__init__</strong></a>(self, min<font color="#909090">=None</font>, max<font color="#909090">=None</font>, num_raters<font color="#909090">=None</font>, average<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Rating-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Rating-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Rating-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Recorded">class <strong>Recorded</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Recorded">Recorded</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Recorded">Recorded</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Recorded-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Recorded-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Recorded-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Recorded-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Relationship">class <strong>Relationship</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Relationship">Relationship</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Relationship">Relationship</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Relationship-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Relationship-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Relationship-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Relationship-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="School">class <strong>School</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#School">School</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#School">School</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="School-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="School-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="School-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="School-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Statistics">class <strong>Statistics</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Statistics">Statistics</a> element.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Statistics">Statistics</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="Statistics-__init__"><strong>__init__</strong></a>(self, view_count<font color="#909090">=None</font>, video_watch_count<font color="#909090">=None</font>, favorite_count<font color="#909090">=None</font>, subscriber_count<font color="#909090">=None</font>, last_web_access<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Statistics-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Statistics-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Statistics-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Status">class <strong>Status</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Status">Status</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Status">Status</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Status-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Status-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Status-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Status-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Username">class <strong>Username</strong></a>(<a href="atom.html#AtomBase">atom.AtomBase</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>The YouTube <a href="#Username">Username</a> element<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#Username">Username</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="Username-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="Username-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="Username-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="Username-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeContactEntry">class <strong>YouTubeContactEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a contact entry.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubeContactEntry">YouTubeContactEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubeContactEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, username<font color="#909090">=None</font>, status<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="YouTubeContactEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeContactEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubeContactEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeContactEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubeContactEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeContactEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeContactEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubeContactEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeContactEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeContactEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeContactFeed">class <strong>YouTubeContactFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of a users contacts.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubeContactFeed">YouTubeContactFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="YouTubeContactFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubeContactFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeContactFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubeContactFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeContactFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeContactFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubeContactFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeContactFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeContactFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeContactFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubePlaylistEntry">class <strong>YouTubePlaylistEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a playlist in YouTube.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubePlaylistEntry">YouTubePlaylistEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubePlaylistEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, private<font color="#909090">=None</font>, feed_link<font color="#909090">=None</font>, description<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="YouTubePlaylistEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubePlaylistEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubePlaylistEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubePlaylistEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubePlaylistEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubePlaylistFeed">class <strong>YouTubePlaylistFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of a user's playlists<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubePlaylistFeed">YouTubePlaylistFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="YouTubePlaylistFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubePlaylistFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubePlaylistFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubePlaylistFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubePlaylistFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubePlaylistVideoEntry">class <strong>YouTubePlaylistVideoEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a <a href="#YouTubeVideoEntry">YouTubeVideoEntry</a> on a YouTubePlaylist.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubePlaylistVideoEntry">YouTubePlaylistVideoEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubePlaylistVideoEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, feed_link<font color="#909090">=None</font>, description<font color="#909090">=None</font>, rating<font color="#909090">=None</font>, comments<font color="#909090">=None</font>, statistics<font color="#909090">=None</font>, location<font color="#909090">=None</font>, position<font color="#909090">=None</font>, media<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubePlaylistVideoEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubePlaylistVideoEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubePlaylistVideoFeed">class <strong>YouTubePlaylistVideoFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of video entry on a playlist.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubePlaylistVideoFeed">YouTubePlaylistVideoFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="YouTubePlaylistVideoFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubePlaylistVideoFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubePlaylistVideoFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubePlaylistVideoFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubePlaylistVideoFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistVideoFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeSubscriptionEntry">class <strong>YouTubeSubscriptionEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a subscription entry on YouTube.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubeSubscriptionEntry">YouTubeSubscriptionEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubeSubscriptionEntry-GetSubscriptionType"><strong>GetSubscriptionType</strong></a>(self)</dt><dd><tt>Retrieve the type of this subscription.<br>
+ <br>
+Returns:<br>
+ A string that is either 'channel, 'query' or 'favorites'</tt></dd></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, username<font color="#909090">=None</font>, query_string<font color="#909090">=None</font>, feed_link<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="YouTubeSubscriptionEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubeSubscriptionEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubeSubscriptionEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeSubscriptionEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeSubscriptionEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeSubscriptionFeed">class <strong>YouTubeSubscriptionFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of a users subscriptions.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubeSubscriptionFeed">YouTubeSubscriptionFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="YouTubeSubscriptionFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubeSubscriptionFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeSubscriptionFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubeSubscriptionFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeSubscriptionFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeSubscriptionFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubeSubscriptionFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeSubscriptionFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeSubscriptionFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeSubscriptionFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeUserEntry">class <strong>YouTubeUserEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a user on YouTube.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubeUserEntry">YouTubeUserEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubeUserEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, username<font color="#909090">=None</font>, first_name<font color="#909090">=None</font>, last_name<font color="#909090">=None</font>, age<font color="#909090">=None</font>, books<font color="#909090">=None</font>, gender<font color="#909090">=None</font>, company<font color="#909090">=None</font>, description<font color="#909090">=None</font>, hobbies<font color="#909090">=None</font>, hometown<font color="#909090">=None</font>, location<font color="#909090">=None</font>, movies<font color="#909090">=None</font>, music<font color="#909090">=None</font>, occupation<font color="#909090">=None</font>, school<font color="#909090">=None</font>, relationship<font color="#909090">=None</font>, statistics<font color="#909090">=None</font>, feed_link<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="YouTubeUserEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubeUserEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubeUserEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeUserEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeUserEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeUserEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeUserEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeUserEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeUserEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeUserEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeUserEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeVideoCommentEntry">class <strong>YouTubeVideoCommentEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a comment on YouTube.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubeVideoCommentEntry">YouTubeVideoCommentEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="YouTubeVideoCommentEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoCommentEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#Entry">atom.Entry</a>:<br>
+<dl><dt><a name="YouTubeVideoCommentEntry-__init__"><strong>__init__</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubeVideoCommentEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoCommentEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubeVideoCommentEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoCommentEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoCommentEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoCommentEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoCommentEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoCommentEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeVideoCommentFeed">class <strong>YouTubeVideoCommentFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of comments for a video.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubeVideoCommentFeed">YouTubeVideoCommentFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="YouTubeVideoCommentFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubeVideoCommentFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoCommentFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubeVideoCommentFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoCommentFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoCommentFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoCommentFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoCommentFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoCommentFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoCommentFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeVideoEntry">class <strong>YouTubeVideoEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a video on YouTube.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubeVideoEntry">YouTubeVideoEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubeVideoEntry-AddDeveloperTags"><strong>AddDeveloperTags</strong></a>(self, developer_tags)</dt><dd><tt>Add a developer tag for this entry.<br>
+ <br>
+Developer tags can only be set during the initial upload.<br>
+ <br>
+Arguments:<br>
+ developer_tags: A list of developer tags as strings.<br>
+ <br>
+Returns:<br>
+ A list of all developer tags for this video entry.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetDeveloperTags"><strong>GetDeveloperTags</strong></a>(self)</dt><dd><tt>Retrieve developer tags for this video entry.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetSwfUrl"><strong>GetSwfUrl</strong></a>(self)</dt><dd><tt>Return the URL for the embeddable Video<br>
+ <br>
+Returns:<br>
+ URL of the embeddable video</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetYouTubeCategoryAsString"><strong>GetYouTubeCategoryAsString</strong></a>(self)</dt><dd><tt>Convenience method to return the YouTube category as string.<br>
+ <br>
+YouTubeVideoEntries can contain multiple Category objects with differing <br>
+ schemes. This method returns only the category with the correct<br>
+ scheme, ignoring developer tags.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, rating<font color="#909090">=None</font>, noembed<font color="#909090">=None</font>, statistics<font color="#909090">=None</font>, racy<font color="#909090">=None</font>, media<font color="#909090">=None</font>, geo<font color="#909090">=None</font>, recorded<font color="#909090">=None</font>, comments<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="YouTubeVideoEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubeVideoEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubeVideoEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeVideoFeed">class <strong>YouTubeVideoFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a video feed on YouTube.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubeVideoFeed">YouTubeVideoFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="YouTubeVideoFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubeVideoFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubeVideoFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeVideoResponseEntry">class <strong>YouTubeVideoResponseEntry</strong></a>(<a href="gdata.html#GDataEntry">gdata.GDataEntry</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a video response.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubeVideoResponseEntry">YouTubeVideoResponseEntry</a></dd>
+<dd><a href="gdata.html#GDataEntry">gdata.GDataEntry</a></dd>
+<dd><a href="atom.html#Entry">atom.Entry</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubeVideoResponseEntry-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, content<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, published<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, rating<font color="#909090">=None</font>, noembed<font color="#909090">=None</font>, statistics<font color="#909090">=None</font>, racy<font color="#909090">=None</font>, media<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Methods inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><a name="YouTubeVideoResponseEntry-GetMediaURL"><strong>GetMediaURL</strong></a>(self)</dt><dd><tt>Returns the URL to the media content, if the entry is a media entry.<br>
+Otherwise returns None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoResponseEntry-IsMedia"><strong>IsMedia</strong></a>(self)</dt><dd><tt>Determines whether or not an entry is a GData Media entry.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataEntry">gdata.GDataEntry</a>:<br>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubeVideoResponseEntry-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoResponseEntry-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubeVideoResponseEntry-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoResponseEntry-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseEntry-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseEntry-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoResponseEntry-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseEntry-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoResponseEntry-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseEntry-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoResponseEntry-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseEntry-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoResponseEntry-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseEntry-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeVideoResponseFeed">class <strong>YouTubeVideoResponseFeed</strong></a>(<a href="gdata.html#GDataFeed">gdata.GDataFeed</a>, <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Represents a feed of video responses.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.html#YouTubeVideoResponseFeed">YouTubeVideoResponseFeed</a></dd>
+<dd><a href="gdata.html#GDataFeed">gdata.GDataFeed</a></dd>
+<dd><a href="atom.html#Feed">atom.Feed</a></dd>
+<dd><a href="atom.html#Source">atom.Source</a></dd>
+<dd><a href="atom.html#FeedEntryParent">atom.FeedEntryParent</a></dd>
+<dd><a href="atom.html#AtomBase">atom.AtomBase</a></dd>
+<dd><a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a></dd>
+<dd><a href="gdata.html#LinkFinder">gdata.LinkFinder</a></dd>
+<dd><a href="atom.html#LinkFinder">atom.LinkFinder</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><a name="YouTubeVideoResponseFeed-__init__"><strong>__init__</strong></a>(self, author<font color="#909090">=None</font>, category<font color="#909090">=None</font>, contributor<font color="#909090">=None</font>, generator<font color="#909090">=None</font>, icon<font color="#909090">=None</font>, atom_id<font color="#909090">=None</font>, link<font color="#909090">=None</font>, logo<font color="#909090">=None</font>, rights<font color="#909090">=None</font>, subtitle<font color="#909090">=None</font>, title<font color="#909090">=None</font>, updated<font color="#909090">=None</font>, entry<font color="#909090">=None</font>, total_results<font color="#909090">=None</font>, start_index<font color="#909090">=None</font>, items_per_page<font color="#909090">=None</font>, extension_elements<font color="#909090">=None</font>, extension_attributes<font color="#909090">=None</font>, text<font color="#909090">=None</font>)</dt><dd><tt>Constructor for Source<br>
+ <br>
+Args:<br>
+ author: list (optional) A list of Author instances which belong to this<br>
+ class.<br>
+ category: list (optional) A list of Category instances<br>
+ contributor: list (optional) A list on Contributor instances<br>
+ generator: Generator (optional)<br>
+ icon: Icon (optional)<br>
+ id: Id (optional) The entry's Id element<br>
+ link: list (optional) A list of Link instances<br>
+ logo: Logo (optional)<br>
+ rights: Rights (optional) The entry's Rights element<br>
+ subtitle: Subtitle (optional) The entry's subtitle element<br>
+ title: Title (optional) the entry's title element<br>
+ updated: Updated (optional) the entry's updated element<br>
+ entry: list (optional) A list of the Entry instances contained in the<br>
+ feed.<br>
+ text: String (optional) The text contents of the element. This is the<br>
+ contents of the Entry's XML text node.<br>
+ (Example: <foo>This is the text</foo>)<br>
+ extension_elements: list (optional) A list of ExtensionElement instances<br>
+ which are children of this element.<br>
+ extension_attributes: dict (optional) A dictionary of strings which are<br>
+ the values for additional XML attributes of this element.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.html#GDataFeed">gdata.GDataFeed</a>:<br>
+<dl><dt><strong>generator</strong></dt>
+</dl>
+<dl><dt><strong>id</strong></dt>
+</dl>
+<hr>
+Methods inherited from <a href="atom.html#AtomBase">atom.AtomBase</a>:<br>
+<dl><dt><a name="YouTubeVideoResponseFeed-ToString"><strong>ToString</strong></a>(self, string_encoding<font color="#909090">='UTF-8'</font>)</dt><dd><tt>Converts the Atom object to a string containing XML.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoResponseFeed-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><a name="YouTubeVideoResponseFeed-FindExtensions"><strong>FindExtensions</strong></a>(self, tag<font color="#909090">=None</font>, namespace<font color="#909090">=None</font>)</dt><dd><tt>Searches extension elements for child nodes with the desired name.<br>
+ <br>
+Returns a list of extension elements within this object whose tag<br>
+and/or namespace match those passed in. To find all extensions in<br>
+a particular namespace, specify the namespace but not the tag name.<br>
+If you specify only the tag, the result list may contain extension<br>
+elements in multiple namespaces.<br>
+ <br>
+Args:<br>
+ tag: str (optional) The desired tag<br>
+ namespace: str (optional) The desired namespace<br>
+ <br>
+Returns:<br>
+ A list of elements whose tag and/or namespace match the parameters<br>
+ values</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.html#ExtensionContainer">atom.ExtensionContainer</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.html#LinkFinder">gdata.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoResponseFeed-GetAclLink"><strong>GetAclLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseFeed-GetEditLink"><strong>GetEditLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseFeed-GetEditMediaLink"><strong>GetEditMediaLink</strong></a>(self)</dt><dd><tt>The Picasa API mistakenly returns media-edit rather than edit-media, but<br>
+this may change soon.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoResponseFeed-GetFeedLink"><strong>GetFeedLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseFeed-GetHtmlLink"><strong>GetHtmlLink</strong></a>(self)</dt><dd><tt>Find the first link with rel of alternate and type of text/html<br>
+ <br>
+Returns:<br>
+ An atom.Link or None if no links matched</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoResponseFeed-GetNextLink"><strong>GetNextLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseFeed-GetPostLink"><strong>GetPostLink</strong></a>(self)</dt><dd><tt>Get a link containing the POST target URL.<br>
+ <br>
+The POST target URL is used to insert new entries.<br>
+ <br>
+Returns:<br>
+ A link object with a rel matching the POST type.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoResponseFeed-GetPrevLink"><strong>GetPrevLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseFeed-GetSelfLink"><strong>GetSelfLink</strong></a>(self)</dt><dd><tt>Find the first link with rel set to 'self'<br>
+ <br>
+Returns:<br>
+ An atom.Link or none if none of the links had rel equal to 'self'</tt></dd></dl>
+
+<hr>
+Methods inherited from <a href="atom.html#LinkFinder">atom.LinkFinder</a>:<br>
+<dl><dt><a name="YouTubeVideoResponseFeed-GetAlternateLink"><strong>GetAlternateLink</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoResponseFeed-GetLicenseLink"><strong>GetLicenseLink</strong></a>(self)</dt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#eeaa77">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Functions</strong></big></font></td></tr>
+
+<tr><td bgcolor="#eeaa77"><tt> </tt></td><td> </td>
+<td width="100%"><dl><dt><a name="-YouTubeContactEntryFromString"><strong>YouTubeContactEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubeContactFeedFromString"><strong>YouTubeContactFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubePlaylistEntryFromString"><strong>YouTubePlaylistEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubePlaylistFeedFromString"><strong>YouTubePlaylistFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubePlaylistVideoEntryFromString"><strong>YouTubePlaylistVideoEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubePlaylistVideoFeedFromString"><strong>YouTubePlaylistVideoFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubeSubscriptionEntryFromString"><strong>YouTubeSubscriptionEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubeSubscriptionFeedFromString"><strong>YouTubeSubscriptionFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubeUserEntryFromString"><strong>YouTubeUserEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubeUserFeedFromString"><strong>YouTubeUserFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubeVideoCommentEntryFromString"><strong>YouTubeVideoCommentEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubeVideoCommentFeedFromString"><strong>YouTubeVideoCommentFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubeVideoEntryFromString"><strong>YouTubeVideoEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubeVideoFeedFromString"><strong>YouTubeVideoFeedFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubeVideoResponseEntryFromString"><strong>YouTubeVideoResponseEntryFromString</strong></a>(xml_string)</dt></dl>
+ <dl><dt><a name="-YouTubeVideoResponseFeedFromString"><strong>YouTubeVideoResponseFeedFromString</strong></a>(xml_string)</dt></dl>
+</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>YOUTUBE_DEVELOPER_TAG_SCHEME</strong> = 'http://gdata.youtube.com/schemas/2007/developertags.cat'<br>
+<strong>YOUTUBE_FORMAT</strong> = '{http://gdata.youtube.com/schemas/2007}format'<br>
+<strong>YOUTUBE_NAMESPACE</strong> = 'http://gdata.youtube.com/schemas/2007'<br>
+<strong>YOUTUBE_SUBSCRIPTION_TYPE_SCHEME</strong> = 'http://gdata.youtube.com/schemas/2007/subscriptiontypes.cat'<br>
+<strong>__author__</strong> = 'api.stephaniel@gmail.com (Stephanie Liu), api.jhartmann@gmail.com (Jochen Hartmann)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.stephaniel@gmail.com (Stephanie Liu), api.jhartmann@gmail.com (Jochen Hartmann)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/gdata.youtube.service.html b/pydocs/gdata.youtube.service.html
new file mode 100644
index 0000000..bac1681
--- /dev/null
+++ b/pydocs/gdata.youtube.service.html
@@ -0,0 +1,2137 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html><head><title>Python: module gdata.youtube.service</title>
+</head><body bgcolor="#f0f0f8">
+
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="heading">
+<tr bgcolor="#7799ee">
+<td valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"> <br><big><big><strong><a href="gdata.html"><font color="#ffffff">gdata</font></a>.<a href="gdata.youtube.html"><font color="#ffffff">youtube</font></a>.service</strong></big></big></font></td
+><td align=right valign=bottom
+><font color="#ffffff" face="helvetica, arial"><a href=".">index</a><br><a href="file:/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/youtube/service.py">/usr/local/google/home/afshar/src/external-gdata-release/google3/src/gdata/youtube/service.py</a></font></td></tr></table>
+ <p><tt><a href="#YouTubeService">YouTubeService</a> extends <a href="gdata.service.html#GDataService">GDataService</a> to streamline YouTube operations.<br>
+ <br>
+<a href="#YouTubeService">YouTubeService</a>: Provides methods to perform CRUD operations on YouTube feeds.<br>
+Extends <a href="gdata.service.html#GDataService">GDataService</a>.</tt></p>
+<p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#aa55cc">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Modules</strong></big></font></td></tr>
+
+<tr><td bgcolor="#aa55cc"><tt> </tt></td><td> </td>
+<td width="100%"><table width="100%" summary="list"><tr><td width="25%" valign=top><a href="xml.etree.cElementTree.html">xml.etree.cElementTree</a><br>
+</td><td width="25%" valign=top><a href="atom.html">atom</a><br>
+</td><td width="25%" valign=top><a href="gdata.html">gdata</a><br>
+</td><td width="25%" valign=top><a href="os.html">os</a><br>
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ee77aa">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Classes</strong></big></font></td></tr>
+
+<tr><td bgcolor="#ee77aa"><tt> </tt></td><td> </td>
+<td width="100%"><dl>
+<dt><font face="helvetica, arial"><a href="exceptions.html#Exception">exceptions.Exception</a>(<a href="exceptions.html#BaseException">exceptions.BaseException</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.service.html#Error">Error</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.service.html#RequestError">RequestError</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.service.html#YouTubeError">YouTubeError</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#GDataService">gdata.service.GDataService</a>(<a href="atom.service.html#AtomService">atom.service.AtomService</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.service.html#YouTubeService">YouTubeService</a>
+</font></dt></dl>
+</dd>
+<dt><font face="helvetica, arial"><a href="gdata.service.html#Query">gdata.service.Query</a>(<a href="__builtin__.html#dict">__builtin__.dict</a>)
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.service.html#YouTubeVideoQuery">YouTubeVideoQuery</a>
+</font></dt><dd>
+<dl>
+<dt><font face="helvetica, arial"><a href="gdata.youtube.service.html#YouTubePlaylistQuery">YouTubePlaylistQuery</a>
+</font></dt><dt><font face="helvetica, arial"><a href="gdata.youtube.service.html#YouTubeUserQuery">YouTubeUserQuery</a>
+</font></dt></dl>
+</dd>
+</dl>
+</dd>
+</dl>
+ <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="Error">class <strong>Error</strong></a>(<a href="exceptions.html#Exception">exceptions.Exception</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Base class for errors within the YouTube service.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="Error-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#Error-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="Error-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="Error-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="Error-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="Error-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="Error-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="Error-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#Error-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="Error-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="RequestError">class <strong>RequestError</strong></a>(<a href="gdata.youtube.service.html#Error">Error</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt><a href="#Error">Error</a> class that is thrown in response to an invalid HTTP Request.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.service.html#RequestError">RequestError</a></dd>
+<dd><a href="gdata.youtube.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.youtube.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="RequestError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#RequestError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="RequestError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="RequestError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#RequestError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="RequestError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeError">class <strong>YouTubeError</strong></a>(<a href="gdata.youtube.service.html#Error">Error</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>YouTube service specific error class.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.service.html#YouTubeError">YouTubeError</a></dd>
+<dd><a href="gdata.youtube.service.html#Error">Error</a></dd>
+<dd><a href="exceptions.html#Exception">exceptions.Exception</a></dd>
+<dd><a href="exceptions.html#BaseException">exceptions.BaseException</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Data descriptors inherited from <a href="gdata.youtube.service.html#Error">Error</a>:<br>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><a name="YouTubeError-__init__"><strong>__init__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__init__">__init__</a>(...) initializes x; see help(type(x)) for signature</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="exceptions.html#Exception">exceptions.Exception</a>:<br>
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#YouTubeError-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+<hr>
+Methods inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><a name="YouTubeError-__delattr__"><strong>__delattr__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__delattr__">__delattr__</a>('name') <==> del x.name</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__getslice__"><strong>__getslice__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__getslice__">__getslice__</a>(i, j) <==> x[i:j]<br>
+ <br>
+Use of negative indices is not supported.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__reduce__"><strong>__reduce__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="YouTubeError-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__setattr__"><strong>__setattr__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__setattr__">__setattr__</a>('name', value) <==> x.name = value</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__setstate__"><strong>__setstate__</strong></a>(...)</dt></dl>
+
+<dl><dt><a name="YouTubeError-__str__"><strong>__str__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeError-__str__">__str__</a>() <==> str(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeError-__unicode__"><strong>__unicode__</strong></a>(...)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="exceptions.html#BaseException">exceptions.BaseException</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+</dl>
+<dl><dt><strong>args</strong></dt>
+</dl>
+<dl><dt><strong>message</strong></dt>
+</dl>
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubePlaylistQuery">class <strong>YouTubePlaylistQuery</strong></a>(<a href="gdata.youtube.service.html#YouTubeVideoQuery">YouTubeVideoQuery</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Subclasses <a href="#YouTubeVideoQuery">YouTubeVideoQuery</a> to perform playlist-specific queries.<br>
+ <br>
+Attributes are set dynamically via properties. Properties correspond to<br>
+the standard Google Data API query parameters with YouTube Data API<br>
+extensions.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.service.html#YouTubePlaylistQuery">YouTubePlaylistQuery</a></dd>
+<dd><a href="gdata.youtube.service.html#YouTubeVideoQuery">YouTubeVideoQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubePlaylistQuery-__init__"><strong>__init__</strong></a>(self, playlist_id, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.youtube.service.html#YouTubeVideoQuery">YouTubeVideoQuery</a>:<br>
+<dl><dt><strong>format</strong></dt>
+<dd><tt>The format query parameter</tt></dd>
+</dl>
+<dl><dt><strong>location</strong></dt>
+<dd><tt>The location query parameter</tt></dd>
+</dl>
+<dl><dt><strong>lr</strong></dt>
+<dd><tt>The lr (language restriction) query parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The orderby query parameter</tt></dd>
+</dl>
+<dl><dt><strong>racy</strong></dt>
+<dd><tt>The racy query parameter</tt></dd>
+</dl>
+<dl><dt><strong>restriction</strong></dt>
+<dd><tt>The restriction query parameter</tt></dd>
+</dl>
+<dl><dt><strong>time</strong></dt>
+<dd><tt>The time query parameter</tt></dd>
+</dl>
+<dl><dt><strong>vq</strong></dt>
+<dd><tt>The video query (vq) query parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="YouTubePlaylistQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="YouTubePlaylistQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubePlaylistQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#YouTubePlaylistQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#YouTubePlaylistQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#YouTubePlaylistQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#YouTubePlaylistQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="YouTubePlaylistQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubePlaylistQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#YouTubePlaylistQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeService">class <strong>YouTubeService</strong></a>(<a href="gdata.service.html#GDataService">gdata.service.GDataService</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Client for the YouTube service.<br>
+ <br>
+Performs all documented Google Data YouTube API functions, such as inserting,<br>
+updating and deleting videos, comments, playlist, subscriptions etc.<br>
+YouTube Service requires authentication for any write, update or delete<br>
+actions.<br>
+ <br>
+Attributes:<br>
+ email: An optional string identifying the user. Required only for<br>
+ authenticated actions.<br>
+ password: An optional string identifying the user's password.<br>
+ source: An optional string identifying the name of your application.<br>
+ server: An optional address of the YouTube API server. gdata.youtube.com <br>
+ is provided as the default value.<br>
+ additional_headers: An optional dictionary containing additional headers<br>
+ to be passed along with each request. Use to store developer key.<br>
+ client_id: An optional string identifying your application, required for <br>
+ authenticated requests, along with a developer key.<br>
+ developer_key: An optional string value. Register your application at<br>
+ <a href="http://code.google.com/apis/youtube/dashboard">http://code.google.com/apis/youtube/dashboard</a> to obtain a (free) key.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.service.html#YouTubeService">YouTubeService</a></dd>
+<dd><a href="gdata.service.html#GDataService">gdata.service.GDataService</a></dd>
+<dd><a href="atom.service.html#AtomService">atom.service.AtomService</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubeService-AddComment"><strong>AddComment</strong></a>(self, comment_text, video_entry)</dt><dd><tt>Add a comment to a video entry.<br>
+ <br>
+Needs authentication. Note that each comment that is posted must contain<br>
+ the video entry that it is to be posted to.<br>
+ <br>
+Args:<br>
+ comment_text: A string representing the text of the comment.<br>
+ video_entry: The YouTubeVideoEntry to be commented on.<br>
+ <br>
+Returns:<br>
+ True if the comment was added successfully.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-AddComplaint"><strong>AddComplaint</strong></a>(self, complaint_text, complaint_term, video_id)</dt><dd><tt>Add a complaint for a particular video entry.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ complaint_text: A string representing the complaint text.<br>
+ complaint_term: A string representing the complaint category term.<br>
+ video_id: A string representing the ID of YouTubeVideoEntry to<br>
+ complain about.<br>
+ <br>
+Returns:<br>
+ True if posted successfully.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: Your complaint_term is not valid.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-AddContact"><strong>AddContact</strong></a>(self, contact_username, my_username<font color="#909090">='default'</font>)</dt><dd><tt>Add a new contact to the currently authenticated user's contact feed.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ contact_username: A string representing the username of the contact<br>
+ that you wish to add.<br>
+ my_username: An optional string representing the username to whose<br>
+ contact the new contact is to be added.<br>
+ <br>
+Returns:<br>
+ A YouTubeContactEntry if added successfully.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-AddPlaylist"><strong>AddPlaylist</strong></a>(self, playlist_title, playlist_description, playlist_private<font color="#909090">=None</font>)</dt><dd><tt>Add a new playlist to the currently authenticated users account.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ playlist_title: A string representing the title for the new playlist.<br>
+ playlist_description: A string representing the description of the<br>
+ playlist.<br>
+ playlist_private: An optional boolean, set to True if the playlist is<br>
+ to be private.<br>
+ <br>
+Returns:<br>
+ The YouTubePlaylistEntry if successfully posted.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-AddPlaylistVideoEntryToPlaylist"><strong>AddPlaylistVideoEntryToPlaylist</strong></a>(self, playlist_uri, video_id, custom_video_title<font color="#909090">=None</font>, custom_video_description<font color="#909090">=None</font>)</dt><dd><tt>Add a video entry to a playlist, optionally providing a custom title<br>
+and description.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ playlist_uri: A string representing the URI of the playlist to which this<br>
+ video entry is to be added.<br>
+ video_id: A string representing the ID of the video entry to add.<br>
+ custom_video_title: An optional string representing a custom title for<br>
+ the video (only shown on the playlist).<br>
+ custom_video_description: An optional string representing a custom<br>
+ description for the video (only shown on the playlist).<br>
+ <br>
+Returns:<br>
+ A YouTubePlaylistVideoEntry if successfully posted.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-AddRating"><strong>AddRating</strong></a>(self, rating_value, video_entry)</dt><dd><tt>Add a rating to a video entry.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ rating_value: The integer value for the rating (between 1 and 5).<br>
+ video_entry: The YouTubeVideoEntry to be rated.<br>
+ <br>
+Returns:<br>
+ True if the rating was added successfully.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: rating_value must be between 1 and 5 in <a href="#YouTubeService-AddRating">AddRating</a>().</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-AddSubscriptionToChannel"><strong>AddSubscriptionToChannel</strong></a>(self, username_to_subscribe_to, my_username<font color="#909090">='default'</font>)</dt><dd><tt>Add a new channel subscription to the currently authenticated users<br>
+account.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ username_to_subscribe_to: A string representing the username of the <br>
+ channel to which we want to subscribe to.<br>
+ my_username: An optional string representing the name of the user which<br>
+ we want to subscribe. Defaults to currently authenticated user.<br>
+ <br>
+Returns:<br>
+ A new YouTubeSubscriptionEntry if successfully posted.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-AddSubscriptionToFavorites"><strong>AddSubscriptionToFavorites</strong></a>(self, username, my_username<font color="#909090">='default'</font>)</dt><dd><tt>Add a new subscription to a users favorites to the currently<br>
+authenticated user's account.<br>
+ <br>
+Needs authentication<br>
+ <br>
+Args:<br>
+ username: A string representing the username of the user's favorite feed<br>
+ to subscribe to.<br>
+ my_username: An optional string representing the username of the user<br>
+ that is to be subscribed. Defaults to currently authenticated user.<br>
+ <br>
+Returns:<br>
+ A new YouTubeSubscriptionEntry if successful.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-AddSubscriptionToQuery"><strong>AddSubscriptionToQuery</strong></a>(self, query, my_username<font color="#909090">='default'</font>)</dt><dd><tt>Add a new subscription to a specific keyword query to the currently<br>
+authenticated user's account.<br>
+ <br>
+Needs authentication<br>
+ <br>
+Args:<br>
+ query: A string representing the keyword query to subscribe to.<br>
+ my_username: An optional string representing the username of the user<br>
+ that is to be subscribed. Defaults to currently authenticated user.<br>
+ <br>
+Returns:<br>
+ A new YouTubeSubscriptionEntry if successful.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-AddVideoEntryToFavorites"><strong>AddVideoEntryToFavorites</strong></a>(self, video_entry, username<font color="#909090">='default'</font>)</dt><dd><tt>Add a video entry to a users favorite feed.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ video_entry: The YouTubeVideoEntry to add.<br>
+ username: An optional string representing the username to whose favorite<br>
+ feed you wish to add the entry. Defaults to the currently<br>
+ authenticated user.<br>
+Returns:<br>
+ The posted YouTubeVideoEntry if successfully posted.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-AddVideoResponse"><strong>AddVideoResponse</strong></a>(self, video_id_to_respond_to, video_response)</dt><dd><tt>Add a video response.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ video_id_to_respond_to: A string representing the ID of the video to be<br>
+ responded to.<br>
+ video_response: YouTubeVideoEntry to be posted as a response.<br>
+ <br>
+Returns:<br>
+ True if video response was posted successfully.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-CheckUploadStatus"><strong>CheckUploadStatus</strong></a>(self, video_entry<font color="#909090">=None</font>, video_id<font color="#909090">=None</font>)</dt><dd><tt>Check upload status on a recently uploaded video entry.<br>
+ <br>
+Needs authentication. Either video_entry or video_id must be provided.<br>
+ <br>
+Args:<br>
+ video_entry: An optional YouTubeVideoEntry whose upload status to check<br>
+ video_id: An optional string representing the ID of the uploaded video<br>
+ whose status is to be checked.<br>
+ <br>
+Returns:<br>
+ A tuple containing (video_upload_state, detailed_message) or None if<br>
+ no status information is found.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a video_entry or a video_id to the<br>
+ <a href="#YouTubeService-CheckUploadStatus">CheckUploadStatus</a>() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-DeleteContact"><strong>DeleteContact</strong></a>(self, contact_username, my_username<font color="#909090">='default'</font>)</dt><dd><tt>Delete a contact from a users contact feed.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ contact_username: A string representing the username of the contact<br>
+ that is to be deleted.<br>
+ my_username: An optional string representing the username of the user's<br>
+ contact feed from which to delete the contact. Defaults to the<br>
+ currently authenticated user.<br>
+ <br>
+Returns:<br>
+ True if the contact was deleted successfully</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-DeletePlaylist"><strong>DeletePlaylist</strong></a>(self, playlist_uri)</dt><dd><tt>Delete a playlist from the currently authenticated users playlists.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ playlist_uri: A string representing the URI of the playlist that is<br>
+ to be deleted.<br>
+ <br>
+Returns:<br>
+ True if successfully deleted.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-DeletePlaylistVideoEntry"><strong>DeletePlaylistVideoEntry</strong></a>(self, playlist_uri, playlist_video_entry_id)</dt><dd><tt>Delete a playlist video entry from a playlist.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ playlist_uri: A URI representing the playlist from which the playlist<br>
+ video entry is to be removed from.<br>
+ playlist_video_entry_id: A string representing id of the playlist video<br>
+ entry that is to be removed.<br>
+ <br>
+Returns:<br>
+ True if entry was successfully deleted.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-DeleteSubscription"><strong>DeleteSubscription</strong></a>(self, subscription_uri)</dt><dd><tt>Delete a subscription from the currently authenticated user's account.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ subscription_uri: A string representing the URI of the subscription that<br>
+ is to be deleted.<br>
+ <br>
+Returns:<br>
+ True if deleted successfully.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-DeleteVideoEntry"><strong>DeleteVideoEntry</strong></a>(self, video_entry)</dt><dd><tt>Deletes a video entry.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ video_entry: The YouTubeVideoEntry to be deleted.<br>
+ <br>
+Returns:<br>
+ True if entry was deleted successfully.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-DeleteVideoEntryFromFavorites"><strong>DeleteVideoEntryFromFavorites</strong></a>(self, video_id, username<font color="#909090">='default'</font>)</dt><dd><tt>Delete a video entry from the users favorite feed.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ video_id: A string representing the ID of the video that is to be removed<br>
+ username: An optional string representing the username of the user's<br>
+ favorite feed. Defaults to the currently authenticated user.<br>
+ <br>
+Returns:<br>
+ True if entry was successfully deleted.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-DeleteVideoResponse"><strong>DeleteVideoResponse</strong></a>(self, video_id, response_video_id)</dt><dd><tt>Delete a video response.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ video_id: A string representing the ID of video that contains the<br>
+ response.<br>
+ response_video_id: A string representing the ID of the video that was<br>
+ posted as a response.<br>
+ <br>
+Returns:<br>
+ True if video response was deleted succcessfully.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetFormUploadToken"><strong>GetFormUploadToken</strong></a>(self, video_entry, uri<font color="#909090">='https://gdata.youtube.com/action/GetUploadToken'</font>)</dt><dd><tt>Receives a YouTube Token and a YouTube PostUrl from a YouTubeVideoEntry.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ video_entry: The YouTubeVideoEntry to upload (meta-data only).<br>
+ uri: An optional string representing the URI from where to fetch the<br>
+ token information. Defaults to the YOUTUBE_UPLOADTOKEN_URI.<br>
+ <br>
+Returns:<br>
+ A tuple containing the URL to which to post your video file, along<br>
+ with the youtube token that must be included with your upload in the<br>
+ form of: (post_url, youtube_token).</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetMostDiscussedVideoFeed"><strong>GetMostDiscussedVideoFeed</strong></a>(self)</dt><dd><tt>Retrieve the 'most_discussed' standard video feed.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetMostLinkedVideoFeed"><strong>GetMostLinkedVideoFeed</strong></a>(self)</dt><dd><tt>Retrieve the 'most_linked' standard video feed.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetMostRecentVideoFeed"><strong>GetMostRecentVideoFeed</strong></a>(self)</dt><dd><tt>Retrieve the 'most_recent' standard video feed.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetMostRespondedVideoFeed"><strong>GetMostRespondedVideoFeed</strong></a>(self)</dt><dd><tt>Retrieve the 'most_responded' standard video feed.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetMostViewedVideoFeed"><strong>GetMostViewedVideoFeed</strong></a>(self)</dt><dd><tt>Retrieve the 'most_viewed' standard video feed.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetRecentlyFeaturedVideoFeed"><strong>GetRecentlyFeaturedVideoFeed</strong></a>(self)</dt><dd><tt>Retrieve the 'recently_featured' standard video feed.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetTopFavoritesVideoFeed"><strong>GetTopFavoritesVideoFeed</strong></a>(self)</dt><dd><tt>Retrieve the 'top_favorites' standard video feed.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetTopRatedVideoFeed"><strong>GetTopRatedVideoFeed</strong></a>(self)</dt><dd><tt>Retrieve the 'top_rated' standard video feed.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetUserFavoritesFeed"><strong>GetUserFavoritesFeed</strong></a>(self, username<font color="#909090">='default'</font>)</dt><dd><tt>Retrieve the favorites feed for a given user.<br>
+ <br>
+Args:<br>
+ username: An optional string representing the username whose favorites<br>
+ feed is to be retrieved. Defaults to the currently authenticated user.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetWatchOnMobileVideoFeed"><strong>GetWatchOnMobileVideoFeed</strong></a>(self)</dt><dd><tt>Retrieve the 'watch_on_mobile' standard video feed.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeContactEntry"><strong>GetYouTubeContactEntry</strong></a>(self, uri)</dt><dd><tt>Retrieve a YouTubeContactEntry.<br>
+ <br>
+Args:<br>
+ uri: A string representing the URI of the contact entry that is to<br>
+ be retrieved.<br>
+ <br>
+Returns:<br>
+ A YouTubeContactEntry if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeContactFeed"><strong>GetYouTubeContactFeed</strong></a>(self, uri<font color="#909090">=None</font>, username<font color="#909090">='default'</font>)</dt><dd><tt>Retrieve a YouTubeContactFeed.<br>
+ <br>
+Either a uri or a username must be provided.<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the contact feed that<br>
+ is to be retrieved.<br>
+ username: An optional string representing the username. Defaults to the<br>
+ currently authenticated user.<br>
+ <br>
+Returns:<br>
+ A YouTubeContactFeed if successfully retrieved.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a uri or a username to the<br>
+ <a href="#YouTubeService-GetYouTubeContactFeed">GetYouTubeContactFeed</a>() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubePlaylistEntry"><strong>GetYouTubePlaylistEntry</strong></a>(self, uri)</dt><dd><tt>Retrieve a YouTubePlaylistEntry.<br>
+ <br>
+Args:<br>
+ uri: A string representing the URI of the playlist feed that is to<br>
+ be retrieved.<br>
+ <br>
+Returns:<br>
+ A YouTubePlaylistEntry if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubePlaylistFeed"><strong>GetYouTubePlaylistFeed</strong></a>(self, uri<font color="#909090">=None</font>, username<font color="#909090">='default'</font>)</dt><dd><tt>Retrieve a YouTubePlaylistFeed (a feed of playlists for a user).<br>
+ <br>
+Either a uri or a username must be provided.<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the playlist feed that<br>
+ is to be retrieved.<br>
+ username: An optional string representing the username. Defaults to the<br>
+ currently authenticated user.<br>
+ <br>
+Returns:<br>
+ A YouTubePlaylistFeed if successfully retrieved.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a uri or a username to the<br>
+ <a href="#YouTubeService-GetYouTubePlaylistFeed">GetYouTubePlaylistFeed</a>() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubePlaylistVideoFeed"><strong>GetYouTubePlaylistVideoFeed</strong></a>(self, uri<font color="#909090">=None</font>, playlist_id<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a YouTubePlaylistVideoFeed (a feed of videos on a playlist).<br>
+ <br>
+Either a uri or a playlist_id must be provided.<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the playlist video feed<br>
+ that is to be retrieved.<br>
+ playlist_id: An optional string representing the Id of the playlist whose<br>
+ playlist video feed is to be retrieved.<br>
+ <br>
+Returns:<br>
+ A YouTubePlaylistVideoFeed if successfully retrieved.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a uri or a playlist_id to the<br>
+ <a href="#YouTubeService-GetYouTubePlaylistVideoFeed">GetYouTubePlaylistVideoFeed</a>() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeRelatedVideoFeed"><strong>GetYouTubeRelatedVideoFeed</strong></a>(self, uri<font color="#909090">=None</font>, video_id<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a YouTubeRelatedVideoFeed.<br>
+ <br>
+Either a uri for the feed or a video_id is required.<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the feed that is to<br>
+ be retrieved.<br>
+ video_id: An optional string representing the ID of the video for which<br>
+ to retrieve the related video feed.<br>
+ <br>
+Returns:<br>
+ A YouTubeRelatedVideoFeed if successfully retrieved.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a uri or a video_id to the<br>
+ <a href="#YouTubeService-GetYouTubeRelatedVideoFeed">GetYouTubeRelatedVideoFeed</a>() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeSubscriptionEntry"><strong>GetYouTubeSubscriptionEntry</strong></a>(self, uri)</dt><dd><tt>Retrieve a YouTubeSubscriptionEntry.<br>
+ <br>
+Args:<br>
+ uri: A string representing the URI of the entry that is to be retrieved.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoSubscriptionEntry if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeSubscriptionFeed"><strong>GetYouTubeSubscriptionFeed</strong></a>(self, uri<font color="#909090">=None</font>, username<font color="#909090">='default'</font>)</dt><dd><tt>Retrieve a YouTubeSubscriptionFeed.<br>
+ <br>
+Either the uri of the feed or a username must be provided.<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the feed that is to<br>
+ be retrieved.<br>
+ username: An optional string representing the username whose subscription<br>
+ feed is to be retrieved. Defaults to the currently authenticted user.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoSubscriptionFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeUserEntry"><strong>GetYouTubeUserEntry</strong></a>(self, uri<font color="#909090">=None</font>, username<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a YouTubeUserEntry.<br>
+ <br>
+Either a uri or a username must be provided.<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the user entry that is<br>
+ to be retrieved.<br>
+ username: An optional string representing the username.<br>
+ <br>
+Returns:<br>
+ A YouTubeUserEntry if successfully retrieved.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a uri or a username to the<br>
+ <a href="#YouTubeService-GetYouTubeUserEntry">GetYouTubeUserEntry</a>() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeUserFeed"><strong>GetYouTubeUserFeed</strong></a>(self, uri<font color="#909090">=None</font>, username<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a YouTubeVideoFeed of user uploaded videos<br>
+ <br>
+Either a uri or a username must be provided. This will retrieve list<br>
+of videos uploaded by specified user. The uri will be of format<br>
+"<a href="http://gdata.youtube.com/feeds/api/users/{username}/uploads">http://gdata.youtube.com/feeds/api/users/{username}/uploads</a>".<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the user feed that is<br>
+ to be retrieved.<br>
+ username: An optional string representing the username.<br>
+ <br>
+Returns:<br>
+ A YouTubeUserFeed if successfully retrieved.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a uri or a username to the<br>
+ <a href="#YouTubeService-GetYouTubeUserFeed">GetYouTubeUserFeed</a>() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeVideoCommentEntry"><strong>GetYouTubeVideoCommentEntry</strong></a>(self, uri)</dt><dd><tt>Retrieve a YouTubeVideoCommentEntry.<br>
+ <br>
+Args:<br>
+ uri: A string representing the URI of the comment entry that is to<br>
+ be retrieved.<br>
+ <br>
+Returns:<br>
+ A YouTubeCommentEntry if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeVideoCommentFeed"><strong>GetYouTubeVideoCommentFeed</strong></a>(self, uri<font color="#909090">=None</font>, video_id<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a YouTubeVideoCommentFeed.<br>
+ <br>
+Either a uri or a video_id must be provided.<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the comment feed that<br>
+ is to be retrieved.<br>
+ video_id: An optional string representing the ID of the video for which<br>
+ to retrieve the comment feed.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoCommentFeed if successfully retrieved.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a uri or a video_id to the<br>
+ <a href="#YouTubeService-GetYouTubeVideoCommentFeed">GetYouTubeVideoCommentFeed</a>() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeVideoEntry"><strong>GetYouTubeVideoEntry</strong></a>(self, uri<font color="#909090">=None</font>, video_id<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a YouTubeVideoEntry.<br>
+ <br>
+Either a uri or a video_id must be provided.<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the entry that is to <br>
+ be retrieved.<br>
+ video_id: An optional string representing the ID of the video.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a uri or a video_id to the<br>
+ <a href="#YouTubeService-GetYouTubeVideoEntry">GetYouTubeVideoEntry</a>() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeVideoFeed"><strong>GetYouTubeVideoFeed</strong></a>(self, uri)</dt><dd><tt>Retrieve a YouTubeVideoFeed.<br>
+ <br>
+Args:<br>
+ uri: A string representing the URI of the feed that is to be retrieved.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoFeed if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeVideoResponseEntry"><strong>GetYouTubeVideoResponseEntry</strong></a>(self, uri)</dt><dd><tt>Retrieve a YouTubeVideoResponseEntry.<br>
+ <br>
+Args:<br>
+ uri: A string representing the URI of the video response entry that<br>
+ is to be retrieved.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoResponseEntry if successfully retrieved.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetYouTubeVideoResponseFeed"><strong>GetYouTubeVideoResponseFeed</strong></a>(self, uri<font color="#909090">=None</font>, video_id<font color="#909090">=None</font>)</dt><dd><tt>Retrieve a YouTubeVideoResponseFeed.<br>
+ <br>
+Either a uri or a playlist_id must be provided.<br>
+ <br>
+Args:<br>
+ uri: An optional string representing the URI of the video response feed<br>
+ that is to be retrieved.<br>
+ video_id: An optional string representing the ID of the video whose<br>
+ response feed is to be retrieved.<br>
+ <br>
+Returns:<br>
+ A YouTubeVideoResponseFeed if successfully retrieved.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: You must provide at least a uri or a video_id to the<br>
+ <a href="#YouTubeService-GetYouTubeVideoResponseFeed">GetYouTubeVideoResponseFeed</a>() method.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-InsertVideoEntry"><strong>InsertVideoEntry</strong></a>(self, video_entry, filename_or_handle, youtube_username<font color="#909090">='default'</font>, content_type<font color="#909090">='video/quicktime'</font>)</dt><dd><tt>Upload a new video to YouTube using the direct upload mechanism.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ video_entry: The YouTubeVideoEntry to upload.<br>
+ filename_or_handle: A file-like object or file name where the video<br>
+ will be read from.<br>
+ youtube_username: An optional string representing the username into whose<br>
+ account this video is to be uploaded to. Defaults to the currently<br>
+ authenticated user.<br>
+ content_type: An optional string representing internet media type<br>
+ (a.k.a. mime type) of the media object. Currently the YouTube API<br>
+ supports these types:<br>
+ o video/mpeg<br>
+ o video/quicktime<br>
+ o video/x-msvideo<br>
+ o video/mp4<br>
+ o video/x-flv<br>
+ <br>
+Returns:<br>
+ The newly created YouTubeVideoEntry if successful.<br>
+ <br>
+Raises:<br>
+ AssertionError: video_entry must be a gdata.youtube.VideoEntry instance.<br>
+ <a href="#YouTubeError">YouTubeError</a>: An error occurred trying to read the video file provided.<br>
+ gdata.service.<a href="#RequestError">RequestError</a>: An error occurred trying to upload the video<br>
+ to the API server.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-Query"><strong>Query</strong></a>(self, uri)</dt><dd><tt>Performs a query and returns a resulting feed or entry.<br>
+ <br>
+Args:<br>
+ uri: A string representing the URI of the feed that is to be queried.<br>
+ <br>
+Returns:<br>
+ On success, a tuple in the form:<br>
+ (boolean succeeded=True, ElementTree._Element result)<br>
+ On failure, a tuple in the form:<br>
+ (boolean succeeded=False, {'status': HTTP status code from server,<br>
+ 'reason': HTTP reason from the server,<br>
+ 'body': HTTP body of the server's response})</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-UpdateContact"><strong>UpdateContact</strong></a>(self, contact_username, new_contact_status, new_contact_category, my_username<font color="#909090">='default'</font>)</dt><dd><tt>Update a contact, providing a new status and a new category.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ contact_username: A string representing the username of the contact<br>
+ that is to be updated.<br>
+ new_contact_status: A string representing the new status of the contact.<br>
+ This can either be set to 'accepted' or 'rejected'.<br>
+ new_contact_category: A string representing the new category for the<br>
+ contact, either 'Friends' or 'Family'.<br>
+ my_username: An optional string representing the username of the user<br>
+ whose contact feed we are modifying. Defaults to the currently<br>
+ authenticated user.<br>
+ <br>
+Returns:<br>
+ A YouTubeContactEntry if updated succesfully.<br>
+ <br>
+Raises:<br>
+ <a href="#YouTubeError">YouTubeError</a>: New contact status must be within the accepted values. Or<br>
+ new contact category must be within the accepted categories.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-UpdatePlaylist"><strong>UpdatePlaylist</strong></a>(self, playlist_id, new_playlist_title, new_playlist_description, playlist_private<font color="#909090">=None</font>, username<font color="#909090">='default'</font>)</dt><dd><tt>Update a playlist with new meta-data.<br>
+ <br>
+ Needs authentication.<br>
+ <br>
+ Args:<br>
+ playlist_id: A string representing the ID of the playlist to be updated.<br>
+ new_playlist_title: A string representing a new title for the playlist.<br>
+ new_playlist_description: A string representing a new description for the<br>
+ playlist.<br>
+ playlist_private: An optional boolean, set to True if the playlist is<br>
+ to be private.<br>
+ username: An optional string representing the username whose playlist is<br>
+ to be updated. Defaults to the currently authenticated user.<br>
+ <br>
+Returns:<br>
+ A YouTubePlaylistEntry if the update was successful.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-UpdatePlaylistVideoEntryMetaData"><strong>UpdatePlaylistVideoEntryMetaData</strong></a>(self, playlist_uri, playlist_entry_id, new_video_title, new_video_description, new_video_position)</dt><dd><tt>Update the meta data for a YouTubePlaylistVideoEntry.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ playlist_uri: A string representing the URI of the playlist that contains<br>
+ the entry to be updated.<br>
+ playlist_entry_id: A string representing the ID of the entry to be<br>
+ updated.<br>
+ new_video_title: A string representing the new title for the video entry.<br>
+ new_video_description: A string representing the new description for<br>
+ the video entry.<br>
+ new_video_position: An integer representing the new position on the<br>
+ playlist for the video.<br>
+ <br>
+Returns:<br>
+ A YouTubePlaylistVideoEntry if the update was successful.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-UpdateVideoEntry"><strong>UpdateVideoEntry</strong></a>(self, video_entry)</dt><dd><tt>Updates a video entry's meta-data.<br>
+ <br>
+Needs authentication.<br>
+ <br>
+Args:<br>
+ video_entry: The YouTubeVideoEntry to update, containing updated<br>
+ meta-data.<br>
+ <br>
+Returns:<br>
+ An updated YouTubeVideoEntry on success or None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-YouTubeQuery"><strong>YouTubeQuery</strong></a>(self, query)</dt><dd><tt>Performs a YouTube specific query and returns a resulting feed or entry.<br>
+ <br>
+Args:<br>
+ query: A <a href="gdata.service.html#Query">Query</a> object or one if its sub-classes (<a href="#YouTubeVideoQuery">YouTubeVideoQuery</a>,<br>
+ <a href="#YouTubeUserQuery">YouTubeUserQuery</a> or <a href="#YouTubePlaylistQuery">YouTubePlaylistQuery</a>).<br>
+ <br>
+Returns:<br>
+ Depending on the type of <a href="gdata.service.html#Query">Query</a> object submitted returns either a<br>
+ YouTubeVideoFeed, a YouTubeUserFeed, a YouTubePlaylistFeed. If the<br>
+ <a href="gdata.service.html#Query">Query</a> object provided was not YouTube-related, a tuple is returned.<br>
+ On success the tuple will be in this form:<br>
+ (boolean succeeded=True, ElementTree._Element result)<br>
+ On failure, the tuple will be in this form:<br>
+ (boolean succeeded=False, {'status': HTTP status code from server,<br>
+ 'reason': HTTP reason from the server,<br>
+ 'body': HTTP body of the server response})</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-__init__"><strong>__init__</strong></a>(self, email<font color="#909090">=None</font>, password<font color="#909090">=None</font>, source<font color="#909090">=None</font>, server<font color="#909090">='gdata.youtube.com'</font>, additional_headers<font color="#909090">=None</font>, client_id<font color="#909090">=None</font>, developer_key<font color="#909090">=None</font>, **kwargs)</dt><dd><tt>Creates a client for the YouTube service.<br>
+ <br>
+Args:<br>
+ email: string (optional) The user's email address, used for<br>
+ authentication.<br>
+ password: string (optional) The user's password.<br>
+ source: string (optional) The name of the user's application.<br>
+ server: string (optional) The name of the server to which a connection<br>
+ will be opened. Default value: 'gdata.youtube.com'.<br>
+ client_id: string (optional) Identifies your application, required for<br>
+ authenticated requests, along with a developer key.<br>
+ developer_key: string (optional) Register your application at<br>
+ <a href="http://code.google.com/apis/youtube/dashboard">http://code.google.com/apis/youtube/dashboard</a> to obtain a (free) key.<br>
+ **kwargs: The other parameters to pass to gdata.service.<a href="gdata.service.html#GDataService">GDataService</a><br>
+ constructor.</tt></dd></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>client_id</strong></dt>
+<dd><tt>The ClientId property</tt></dd>
+</dl>
+<dl><dt><strong>developer_key</strong></dt>
+<dd><tt>The Developer Key property</tt></dd>
+</dl>
+<hr>
+Data and other attributes defined here:<br>
+<dl><dt><strong>ssl</strong> = True</dl>
+
+<hr>
+Methods inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><a name="YouTubeService-AuthSubTokenInfo"><strong>AuthSubTokenInfo</strong></a>(self)</dt><dd><tt>Fetches the AuthSub token's metadata from the server.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-ClientLogin"><strong>ClientLogin</strong></a>(self, username, password, account_type<font color="#909090">=None</font>, service<font color="#909090">=None</font>, auth_service_url<font color="#909090">=None</font>, source<font color="#909090">=None</font>, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Convenience method for authenticating using ProgrammaticLogin. <br>
+ <br>
+Sets values for email, password, and other optional members.<br>
+ <br>
+Args:<br>
+ username:<br>
+ password:<br>
+ account_type: string (optional)<br>
+ service: string (optional)<br>
+ auth_service_url: string (optional)<br>
+ captcha_token: string (optional)<br>
+ captcha_response: string (optional)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-Delete"><strong>Delete</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>)</dt><dd><tt>Deletes the entry at the given URI.<br>
+ <br>
+Args:<br>
+ uri: string The URI of the entry to be deleted. Example: <br>
+ '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ <br>
+Returns:<br>
+ True if the entry was deleted.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-FetchOAuthRequestToken"><strong>FetchOAuthRequestToken</strong></a>(self, scopes<font color="#909090">=None</font>, extra_parameters<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetRequestToken'</font>, oauth_callback<font color="#909090">=None</font>)</dt><dd><tt>Fetches and sets the OAuth request token and returns it.<br>
+ <br>
+Args:<br>
+ scopes: string or list of string base URL(s) of the service(s) to be<br>
+ accessed. If None, then this method tries to determine the<br>
+ scope(s) from the current service.<br>
+ extra_parameters: dict (optional) key-value pairs as any additional<br>
+ parameters to be included in the URL and signature while making a<br>
+ request for fetching an OAuth request token. All the OAuth parameters<br>
+ are added by default. But if provided through this argument, any<br>
+ default parameters will be overwritten. For e.g. a default parameter<br>
+ oauth_version 1.0 can be overwritten if<br>
+ extra_parameters = {'oauth_version': '2.0'}<br>
+ request_url: Request token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.<br>
+ oauth_callback: str (optional) If set, it is assume the client is using<br>
+ the OAuth v1.0a protocol where the callback url is sent in the<br>
+ request token step. If the oauth_callback is also set in<br>
+ extra_params, this value will override that one.<br>
+ <br>
+Returns:<br>
+ The fetched request token as a gdata.auth.OAuthToken object.<br>
+ <br>
+Raises:<br>
+ FetchingOAuthRequestTokenFailed if the server responded to the request<br>
+ with an error.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GenerateAuthSubURL"><strong>GenerateAuthSubURL</strong></a>(self, next, scope, secure<font color="#909090">=False</font>, session<font color="#909090">=True</font>, domain<font color="#909090">='default'</font>)</dt><dd><tt>Generate a URL at which the user will login and be redirected back.<br>
+ <br>
+Users enter their credentials on a Google login page and a token is sent<br>
+to the URL specified in next. See documentation for AuthSub login at:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthSub.html">http://code.google.com/apis/accounts/docs/AuthSub.html</a><br>
+ <br>
+Args:<br>
+ next: string The URL user will be sent to after logging in.<br>
+ scope: string or list of strings. The URLs of the services to be <br>
+ accessed.<br>
+ secure: boolean (optional) Determines whether or not the issued token<br>
+ is a secure token.<br>
+ session: boolean (optional) Determines whether or not the issued token<br>
+ can be upgraded to a session token.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GenerateOAuthAuthorizationURL"><strong>GenerateOAuthAuthorizationURL</strong></a>(self, request_token<font color="#909090">=None</font>, callback_url<font color="#909090">=None</font>, extra_params<font color="#909090">=None</font>, include_scopes_in_callback<font color="#909090">=False</font>, scopes_param_prefix<font color="#909090">='oauth_token_scope'</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthAuthorizeToken'</font>)</dt><dd><tt>Generates URL at which user will login to authorize the request token.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.<br>
+ If not specified, then the current token will be used if it is of<br>
+ type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope. <br>
+ callback_url: string (optional) The URL user will be sent to after<br>
+ logging in and granting access.<br>
+ extra_params: dict (optional) Additional parameters to be sent.<br>
+ include_scopes_in_callback: Boolean (default=False) if set to True, and<br>
+ if 'callback_url' is present, the 'callback_url' will be modified to<br>
+ include the scope(s) from the request token as a URL parameter. The<br>
+ key for the 'callback' URL's scope parameter will be<br>
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as<br>
+ a parameter to the 'callback' URL, is that the page which receives<br>
+ the OAuth token will be able to tell which URLs the token grants<br>
+ access to.<br>
+ scopes_param_prefix: string (default='oauth_token_scope') The URL<br>
+ parameter key which maps to the list of valid scopes for the token.<br>
+ This URL parameter will be included in the callback URL along with<br>
+ the scopes of the token as value if include_scopes_in_callback=True.<br>
+ request_url: Authorization URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.<br>
+Returns:<br>
+ A string URL at which the user is required to login.<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's request token is not an OAuth token or if a<br>
+ request token was not available.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-Get"><strong>Get</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI<br>
+ <br>
+The uri is the portion of the URI after the server value <br>
+(ex: www.google.com).<br>
+ <br>
+To perform a query against Google Base, set the server to <br>
+'base.google.com' and set the uri to '/base/feeds/...', where ... is <br>
+your query. For example, to find snippets for all digital cameras uri <br>
+should be set to: '/base/feeds/snippets?bq=digital+camera'<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to <br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and <br>
+ Authorization headers.<br>
+ redirects_remaining: int (optional) Tracks the number of additional<br>
+ redirects this method will allow. If the service object receives<br>
+ a redirect and remaining is 0, it will not follow the redirect. <br>
+ This was added to avoid infinite redirect loops.<br>
+ encoding: string (optional) The character encoding for the server's<br>
+ response. Default is UTF-8<br>
+ converter: func (optional) A function which will transform<br>
+ the server's results before it is returned. Example: use <br>
+ GDataFeedFromString to parse the server response as if it<br>
+ were a GDataFeed.<br>
+ <br>
+Returns:<br>
+ If there is no ResultsTransformer specified in the call, a GDataFeed <br>
+ or GDataEntry depending on which is sent from the server. If the <br>
+ response is niether a feed or entry and there is no ResultsTransformer,<br>
+ return a string. If there is a ResultsTransformer, the returned value <br>
+ will be that of the ResultsTransformer function.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetAuthSubToken"><strong>GetAuthSubToken</strong></a>(self)</dt><dd><tt>Returns the AuthSub token as a string.<br>
+ <br>
+If the token is an gdta.auth.AuthSubToken, the Authorization Label<br>
+("AuthSub token") is removed.<br>
+ <br>
+This method examines the current_token to see if it is an AuthSubToken<br>
+or SecureAuthSubToken. If not, it searches the token_store for a token<br>
+which matches the current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+ <br>
+Returns:<br>
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,<br>
+ return the token string. If there is no current_token, a token string<br>
+ for a token which matches the service object's default scope is returned.<br>
+ If there are no tokens valid for the scope, returns None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetClientLoginToken"><strong>GetClientLoginToken</strong></a>(self)</dt><dd><tt>Returns the token string for the current token or a token matching the <br>
+service scope.<br>
+ <br>
+If the current_token is a ClientLoginToken, the token string for <br>
+the current token is returned. If the current_token is not set, this method<br>
+searches for a token in the token_store which is valid for the service <br>
+object's current scope.<br>
+ <br>
+The current scope is determined by the service name string member.<br>
+The token string is the end of the Authorization header, it doesn not<br>
+include the ClientLogin label.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetEntry"><strong>GetEntry</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive an Entry.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataEntry built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetFeed"><strong>GetFeed</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, converter<font color="#909090">=<function GDataFeedFromString></font>)</dt><dd><tt><a href="gdata.service.html#Query">Query</a> the GData API with the given URI and receive a Feed.<br>
+ <br>
+See also documentation for gdata.service.Get<br>
+ <br>
+Args:<br>
+ uri: string The query in the form of a URI. Example:<br>
+ '/base/feeds/snippets?bq=digital+camera'.<br>
+ extra_headers: dictionary (optional) Extra HTTP headers to be included<br>
+ in the GET request. These headers are in addition to<br>
+ those stored in the client's additional_headers property.<br>
+ The client automatically sets the Content-Type and<br>
+ Authorization headers.<br>
+ <br>
+Returns:<br>
+ A GDataFeed built from the XML in the server's response.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetGeneratorFromLinkFinder"><strong>GetGeneratorFromLinkFinder</strong></a>(self, link_finder, func, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>)</dt><dd><tt>returns a generator for pagination</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetMedia"><strong>GetMedia</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>)</dt><dd><tt>Returns a MediaSource containing media and its metadata from the given<br>
+URI string.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetNext"><strong>GetNext</strong></a>(self, feed)</dt><dd><tt>Requests the next 'page' of results in the feed.<br>
+ <br>
+This method uses the feed's next link to request an additional feed<br>
+and uses the class of the feed to convert the results of the GET request.<br>
+ <br>
+Args:<br>
+ feed: atom.Feed or a subclass. The feed should contain a next link and<br>
+ the type of the feed will be applied to the results from the <br>
+ server. The new feed which is returned will be of the same class<br>
+ as this feed which was passed in.<br>
+ <br>
+Returns:<br>
+ A new feed representing the next set of results in the server's feed.<br>
+ The type of this feed will match that of the feed argument.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-GetOAuthInputParameters"><strong>GetOAuthInputParameters</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeService-GetWithRetries"><strong>GetWithRetries</strong></a>(self, uri, extra_headers<font color="#909090">=None</font>, redirects_remaining<font color="#909090">=4</font>, encoding<font color="#909090">='UTF-8'</font>, converter<font color="#909090">=None</font>, num_retries<font color="#909090">=3</font>, delay<font color="#909090">=1</font>, backoff<font color="#909090">=2</font>, logger<font color="#909090">=None</font>)</dt><dd><tt>This is a wrapper method for Get with retrying capability.<br>
+ <br>
+To avoid various errors while retrieving bulk entities by retrying<br>
+specified times.<br>
+ <br>
+Note this method relies on the time module and so may not be usable<br>
+by default in Python2.2.<br>
+ <br>
+Args:<br>
+ num_retries: Integer; the retry count.<br>
+ delay: Integer; the initial delay for retrying.<br>
+ backoff: Integer; how much the delay should lengthen after each failure.<br>
+ logger: An object which has a <a href="#YouTubeService-debug">debug</a>(str) method to receive logging<br>
+ messages. Recommended that you pass in the logging module.<br>
+Raises:<br>
+ ValueError if any of the parameters has an invalid value.<br>
+ RanOutOfTries on failure after number of retries.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-Post"><strong>Post</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert or update data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri.<br>
+ uri: string The location (feed) to which the data should be inserted.<br>
+ Example: '/base/feeds/items'.<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the<br>
+ server's response. Often this is a function like<br>
+ GDataEntryFromString which will parse the body of the server's<br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-PostOrPut"><strong>PostOrPut</strong></a>(self, verb, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=4</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Insert data into a GData service at the given URI.<br>
+ <br>
+Args:<br>
+ verb: string, either 'POST' or 'PUT'<br>
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The<br>
+ XML to be sent to the uri. <br>
+ uri: string The location (feed) to which the data should be inserted. <br>
+ Example: '/base/feeds/items'. <br>
+ extra_headers: dict (optional) HTTP headers which are to be included. <br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ media_source: MediaSource (optional) Container for the media to be sent<br>
+ along with the entry, if provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-ProgrammaticLogin"><strong>ProgrammaticLogin</strong></a>(self, captcha_token<font color="#909090">=None</font>, captcha_response<font color="#909090">=None</font>)</dt><dd><tt>Authenticates the user and sets the GData Auth token.<br>
+ <br>
+Login retreives a temporary auth token which must be used with all<br>
+requests to GData services. The auth token is stored in the GData client<br>
+object.<br>
+ <br>
+Login is also used to respond to a captcha challenge. If the user's login<br>
+attempt failed with a CaptchaRequired error, the user can respond by<br>
+calling Login with the captcha token and the answer to the challenge.<br>
+ <br>
+Args:<br>
+ captcha_token: string (optional) The identifier for the captcha challenge<br>
+ which was presented to the user.<br>
+ captcha_response: string (optional) The user's answer to the captch <br>
+ challenge.<br>
+ <br>
+Raises:<br>
+ CaptchaRequired if the login service will require a captcha response<br>
+ BadAuthentication if the login service rejected the username or password<br>
+ <a href="#Error">Error</a> if the login service responded with a 403 different from the above</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-Put"><strong>Put</strong></a>(self, data, uri, extra_headers<font color="#909090">=None</font>, url_params<font color="#909090">=None</font>, escape_params<font color="#909090">=True</font>, redirects_remaining<font color="#909090">=3</font>, media_source<font color="#909090">=None</font>, converter<font color="#909090">=None</font>)</dt><dd><tt>Updates an entry at the given URI.<br>
+ <br>
+Args:<br>
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The <br>
+ XML containing the updated data.<br>
+ uri: string A URI indicating entry to which the update will be applied.<br>
+ Example: '/base/feeds/items/ITEM-ID'<br>
+ extra_headers: dict (optional) HTTP headers which are to be included.<br>
+ The client automatically sets the Content-Type,<br>
+ Authorization, and Content-Length headers.<br>
+ url_params: dict (optional) Additional URL parameters to be included<br>
+ in the URI. These are translated into query arguments<br>
+ in the form '&dict_key=value&...'.<br>
+ Example: {'max-results': '250'} becomes &max-results=250<br>
+ escape_params: boolean (optional) If false, the calling code has already<br>
+ ensured that the query will form a valid URL (all<br>
+ reserved characters have been escaped). If true, this<br>
+ method will escape the query and any URL parameters<br>
+ provided.<br>
+ converter: func (optional) A function which will be executed on the <br>
+ server's response. Often this is a function like <br>
+ GDataEntryFromString which will parse the body of the server's <br>
+ response and return a GDataEntry.<br>
+ <br>
+Returns:<br>
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,<br>
+ or the results of running converter on the server's result body (if<br>
+ converter was specified).</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-RevokeAuthSubToken"><strong>RevokeAuthSubToken</strong></a>(self)</dt><dd><tt>Revokes an existing AuthSub token.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-RevokeOAuthToken"><strong>RevokeOAuthToken</strong></a>(self, request_url<font color="#909090">='https://www.google.com/accounts/AuthSubRevokeToken'</font>)</dt><dd><tt>Revokes an existing OAuth token.<br>
+ <br>
+request_url: Token revoke URL. The default is<br>
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.<br>
+Raises:<br>
+ NonOAuthToken if the user's auth token is not an OAuth token.<br>
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-SetAuthSubToken"><strong>SetAuthSubToken</strong></a>(self, token, scopes<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to an AuthSub token.<br>
+ <br>
+Sets the current_token and attempts to add the token to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the AuthSub<br>
+service. The auth token is set automatically when <a href="#YouTubeService-UpgradeToSessionToken">UpgradeToSessionToken</a>()<br>
+is used. See documentation for Google AuthSub here:<br>
+<a href="http://code.google.com/apis/accounts/AuthForWebApps.html">http://code.google.com/apis/accounts/AuthForWebApps.html</a> <br>
+ <br>
+Args:<br>
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string<br>
+ The token returned by the AuthSub service. If the token is an<br>
+ AuthSubToken or SecureAuthSubToken, the scope information stored in<br>
+ the token is used. If the token is a string, the scopes parameter is<br>
+ used to determine the valid scopes.<br>
+ scopes: list of URLs for which the token is valid. This is only used<br>
+ if the token parameter is a string.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method. This parameter is necessary if the token is a string<br>
+ representing a secure token.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-SetClientLoginToken"><strong>SetClientLoginToken</strong></a>(self, token, scopes<font color="#909090">=None</font>)</dt><dd><tt>Sets the token sent in requests to a ClientLogin token.<br>
+ <br>
+This method sets the current_token to a new ClientLoginToken and it <br>
+also attempts to add the ClientLoginToken to the token_store.<br>
+ <br>
+Only use this method if you have received a token from the ClientLogin<br>
+service. The auth_token is set automatically when <a href="#YouTubeService-ProgrammaticLogin">ProgrammaticLogin</a>()<br>
+is used. See documentation for Google ClientLogin here:<br>
+<a href="http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html">http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html</a><br>
+ <br>
+Args:<br>
+ token: string or instance of a ClientLoginToken.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-SetOAuthInputParameters"><strong>SetOAuthInputParameters</strong></a>(self, signature_method, consumer_key, consumer_secret<font color="#909090">=None</font>, rsa_key<font color="#909090">=None</font>, two_legged_oauth<font color="#909090">=False</font>, requestor_id<font color="#909090">=None</font>)</dt><dd><tt>Sets parameters required for using OAuth authentication mechanism.<br>
+ <br>
+NOTE: Though consumer_secret and rsa_key are optional, either of the two<br>
+is required depending on the value of the signature_method.<br>
+ <br>
+Args:<br>
+ signature_method: class which provides implementation for strategy class<br>
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for<br>
+ signing each request. Valid implementations are provided as the<br>
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently<br>
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and<br>
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1<br>
+ consumer_key: string Domain identifying third_party web application.<br>
+ consumer_secret: string (optional) Secret generated during registration.<br>
+ Required only for HMAC_SHA1 signature method.<br>
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature<br>
+ method.<br>
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.<br>
+ requestor_id: string (optional) User email adress to make requests on<br>
+ their behalf. This parameter should only be set when two_legged_oauth<br>
+ is True.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-SetOAuthToken"><strong>SetOAuthToken</strong></a>(self, oauth_token)</dt><dd><tt>Attempts to set the current token and add it to the token store.<br>
+ <br>
+The oauth_token can be any OAuth token i.e. unauthorized request token,<br>
+authorized request token or access token.<br>
+This method also attempts to add the token to the token store.<br>
+Use this method any time you want the current token to point to the<br>
+oauth_token passed. For e.g. call this method with the request token<br>
+you receive from FetchOAuthRequestToken.<br>
+ <br>
+Args:<br>
+ request_token: gdata.auth.OAuthToken OAuth request token.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-UpgradeToOAuthAccessToken"><strong>UpgradeToOAuthAccessToken</strong></a>(self, authorized_request_token<font color="#909090">=None</font>, request_url<font color="#909090">='https://www.google.com/accounts/OAuthGetAccessToken'</font>, oauth_version<font color="#909090">='1.0'</font>, oauth_verifier<font color="#909090">=None</font>)</dt><dd><tt>Upgrades the authorized request token to an access token and returns it<br>
+ <br>
+Args:<br>
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request<br>
+ token. If not specified, then the current token will be used if it is<br>
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the<br>
+ token_store by looking for a token for the current scope.<br>
+ request_url: Access token URL. The default is<br>
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.<br>
+ oauth_version: str (default='1.0') oauth_version parameter. All other<br>
+ 'oauth_' parameters are added by default. This parameter too, is<br>
+ added by default but here you can override it's value.<br>
+ oauth_verifier: str (optional) If present, it is assumed that the client<br>
+ will use the OAuth v1.0a protocol which includes passing the<br>
+ oauth_verifier (as returned by the SP) in the access token step.<br>
+ <br>
+Returns:<br>
+ Access token<br>
+ <br>
+Raises:<br>
+ NonOAuthToken if the user's authorized request token is not an OAuth<br>
+ token or if an authorized request token was not available.<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-UpgradeToSessionToken"><strong>UpgradeToSessionToken</strong></a>(self, token<font color="#909090">=None</font>)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ (optional) which is good for a single use but can be upgraded<br>
+ to a session token. If no token is passed in, the token<br>
+ is found by looking in the token_store by looking for a token<br>
+ for the current scope.<br>
+ <br>
+Raises:<br>
+ NonAuthSubToken if the user's auth token is not an AuthSub token<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-upgrade_to_session_token"><strong>upgrade_to_session_token</strong></a>(self, token)</dt><dd><tt>Upgrades a single use AuthSub token to a session token.<br>
+ <br>
+Args:<br>
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken<br>
+ which is good for a single use but can be upgraded to a<br>
+ session token.<br>
+ <br>
+Returns:<br>
+ The upgraded token as a gdata.auth.AuthSubToken object.<br>
+ <br>
+Raises:<br>
+ TokenUpgradeFailed if the server responded to the request with an <br>
+ error.</tt></dd></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>captcha_token</strong></dt>
+<dd><tt>Get the captcha token for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>captcha_url</strong></dt>
+<dd><tt>Get the captcha URL for a login request.</tt></dd>
+</dl>
+<dl><dt><strong>source</strong></dt>
+<dd><tt>The source is the name of the application making the request. <br>
+It should be in the form company_id-app_name-app_version</tt></dd>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="gdata.service.html#GDataService">gdata.service.GDataService</a>:<br>
+<dl><dt><strong>auth_token</strong> = None</dl>
+
+<dl><dt><strong>handler</strong> = None</dl>
+
+<dl><dt><strong>tokens</strong> = None</dl>
+
+<hr>
+Methods inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><a name="YouTubeService-UseBasicAuth"><strong>UseBasicAuth</strong></a>(self, username, password, for_proxy<font color="#909090">=False</font>)</dt><dd><tt>Sets an Authenticaiton: Basic HTTP header containing plaintext.<br>
+ <br>
+Deprecated, use use_basic_auth instead.<br>
+ <br>
+The username and password are base64 encoded and added to an HTTP header<br>
+which will be included in each request. Note that your username and <br>
+password are sent in plaintext.<br>
+ <br>
+Args:<br>
+ username: str<br>
+ password: str</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-request"><strong>request</strong></a>(*args, **kwargs)</dt><dd><tt># The deprecated_function wraps the actual call to f.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeService-use_basic_auth"><strong>use_basic_auth</strong></a>(self, username, password, scopes<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>debug</strong></dt>
+<dd><tt>If True, HTTP debug information is printed.</tt></dd>
+</dl>
+<dl><dt><strong>override_token</strong></dt>
+</dl>
+<hr>
+Data and other attributes inherited from <a href="atom.service.html#AtomService">atom.service.AtomService</a>:<br>
+<dl><dt><strong>auto_set_current_token</strong> = True</dl>
+
+<dl><dt><strong>auto_store_tokens</strong> = True</dl>
+
+<dl><dt><strong>current_token</strong> = None</dl>
+
+<dl><dt><strong>port</strong> = 80</dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeUserQuery">class <strong>YouTubeUserQuery</strong></a>(<a href="gdata.youtube.service.html#YouTubeVideoQuery">YouTubeVideoQuery</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Subclasses <a href="#YouTubeVideoQuery">YouTubeVideoQuery</a> to perform user-specific queries.<br>
+ <br>
+Attributes are set dynamically via properties. Properties correspond to<br>
+the standard Google Data API query parameters with YouTube Data API<br>
+extensions.<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.service.html#YouTubeUserQuery">YouTubeUserQuery</a></dd>
+<dd><a href="gdata.youtube.service.html#YouTubeVideoQuery">YouTubeVideoQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubeUserQuery-__init__"><strong>__init__</strong></a>(self, username<font color="#909090">=None</font>, feed_type<font color="#909090">=None</font>, subscription_id<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.youtube.service.html#YouTubeVideoQuery">YouTubeVideoQuery</a>:<br>
+<dl><dt><strong>format</strong></dt>
+<dd><tt>The format query parameter</tt></dd>
+</dl>
+<dl><dt><strong>location</strong></dt>
+<dd><tt>The location query parameter</tt></dd>
+</dl>
+<dl><dt><strong>lr</strong></dt>
+<dd><tt>The lr (language restriction) query parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The orderby query parameter</tt></dd>
+</dl>
+<dl><dt><strong>racy</strong></dt>
+<dd><tt>The racy query parameter</tt></dd>
+</dl>
+<dl><dt><strong>restriction</strong></dt>
+<dd><tt>The restriction query parameter</tt></dd>
+</dl>
+<dl><dt><strong>time</strong></dt>
+<dd><tt>The time query parameter</tt></dd>
+</dl>
+<dl><dt><strong>vq</strong></dt>
+<dd><tt>The video query (vq) query parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="YouTubeUserQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="YouTubeUserQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeUserQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#YouTubeUserQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#YouTubeUserQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#YouTubeUserQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#YouTubeUserQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="YouTubeUserQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeUserQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#YouTubeUserQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table> <p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#ffc8d8">
+<td colspan=3 valign=bottom> <br>
+<font color="#000000" face="helvetica, arial"><a name="YouTubeVideoQuery">class <strong>YouTubeVideoQuery</strong></a>(<a href="gdata.service.html#Query">gdata.service.Query</a>)</font></td></tr>
+
+<tr bgcolor="#ffc8d8"><td rowspan=2><tt> </tt></td>
+<td colspan=2><tt>Subclasses gdata.service.<a href="gdata.service.html#Query">Query</a> to represent a YouTube Data API query.<br>
+ <br>
+Attributes are set dynamically via properties. Properties correspond to<br>
+the standard Google Data API query parameters with YouTube Data API<br>
+extensions. Please refer to the API documentation for details.<br>
+ <br>
+Attributes:<br>
+ vq: The vq parameter, which is only supported for video feeds, specifies a<br>
+ search query term. Refer to API documentation for further details.<br>
+ orderby: The orderby parameter, which is only supported for video feeds,<br>
+ specifies the value that will be used to sort videos in the search<br>
+ result set. Valid values for this parameter are relevance, published,<br>
+ viewCount and rating.<br>
+ time: The time parameter, which is only available for the top_rated,<br>
+ top_favorites, most_viewed, most_discussed, most_linked and<br>
+ most_responded standard feeds, restricts the search to videos uploaded<br>
+ within the specified time. Valid values for this parameter are today<br>
+ (1 day), this_week (7 days), this_month (1 month) and all_time.<br>
+ The default value for this parameter is all_time.<br>
+ format: The format parameter specifies that videos must be available in a<br>
+ particular video format. Refer to the API documentation for details.<br>
+ racy: The racy parameter allows a search result set to include restricted<br>
+ content as well as standard content. Valid values for this parameter<br>
+ are include and exclude. By default, restricted content is excluded.<br>
+ lr: The lr parameter restricts the search to videos that have a title,<br>
+ description or keywords in a specific language. Valid values for the lr<br>
+ parameter are ISO 639-1 two-letter language codes.<br>
+ restriction: The restriction parameter identifies the IP address that<br>
+ should be used to filter videos that can only be played in specific<br>
+ countries.<br>
+ location: A string of geo coordinates. Note that this is not used when the<br>
+ search is performed but rather to filter the returned videos for ones<br>
+ that match to the location entered.<br>
+ feed: str (optional) The base URL which is the beginning of the query URL.<br>
+ defaults to '<a href="http://%s/feeds/videos">http://%s/feeds/videos</a>' % (YOUTUBE_SERVER)<br> </tt></td></tr>
+<tr><td> </td>
+<td width="100%"><dl><dt>Method resolution order:</dt>
+<dd><a href="gdata.youtube.service.html#YouTubeVideoQuery">YouTubeVideoQuery</a></dd>
+<dd><a href="gdata.service.html#Query">gdata.service.Query</a></dd>
+<dd><a href="__builtin__.html#dict">__builtin__.dict</a></dd>
+<dd><a href="__builtin__.html#object">__builtin__.object</a></dd>
+</dl>
+<hr>
+Methods defined here:<br>
+<dl><dt><a name="YouTubeVideoQuery-__init__"><strong>__init__</strong></a>(self, video_id<font color="#909090">=None</font>, feed_type<font color="#909090">=None</font>, text_query<font color="#909090">=None</font>, params<font color="#909090">=None</font>, categories<font color="#909090">=None</font>, feed<font color="#909090">=None</font>)</dt></dl>
+
+<hr>
+Data descriptors defined here:<br>
+<dl><dt><strong>format</strong></dt>
+<dd><tt>The format query parameter</tt></dd>
+</dl>
+<dl><dt><strong>location</strong></dt>
+<dd><tt>The location query parameter</tt></dd>
+</dl>
+<dl><dt><strong>lr</strong></dt>
+<dd><tt>The lr (language restriction) query parameter</tt></dd>
+</dl>
+<dl><dt><strong>orderby</strong></dt>
+<dd><tt>The orderby query parameter</tt></dd>
+</dl>
+<dl><dt><strong>racy</strong></dt>
+<dd><tt>The racy query parameter</tt></dd>
+</dl>
+<dl><dt><strong>restriction</strong></dt>
+<dd><tt>The restriction query parameter</tt></dd>
+</dl>
+<dl><dt><strong>time</strong></dt>
+<dd><tt>The time query parameter</tt></dd>
+</dl>
+<dl><dt><strong>vq</strong></dt>
+<dd><tt>The video query (vq) query parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><a name="YouTubeVideoQuery-ToUri"><strong>ToUri</strong></a>(self)</dt></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__str__"><strong>__str__</strong></a>(self)</dt></dl>
+
+<hr>
+Data descriptors inherited from <a href="gdata.service.html#Query">gdata.service.Query</a>:<br>
+<dl><dt><strong>__dict__</strong></dt>
+<dd><tt>dictionary for instance variables (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>__weakref__</strong></dt>
+<dd><tt>list of weak references to the object (if defined)</tt></dd>
+</dl>
+<dl><dt><strong>alt</strong></dt>
+<dd><tt>The feed query's alt parameter</tt></dd>
+</dl>
+<dl><dt><strong>author</strong></dt>
+<dd><tt>The feed query's author parameter</tt></dd>
+</dl>
+<dl><dt><strong>max_results</strong></dt>
+<dd><tt>The feed query's max-results parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_max</strong></dt>
+<dd><tt>The feed query's published-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>published_min</strong></dt>
+<dd><tt>The feed query's published-min parameter</tt></dd>
+</dl>
+<dl><dt><strong>start_index</strong></dt>
+<dd><tt>The feed query's start-index parameter</tt></dd>
+</dl>
+<dl><dt><strong>text_query</strong></dt>
+<dd><tt>The feed query's q parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_max</strong></dt>
+<dd><tt>The feed query's updated-max parameter</tt></dd>
+</dl>
+<dl><dt><strong>updated_min</strong></dt>
+<dd><tt>The feed query's updated-min parameter</tt></dd>
+</dl>
+<hr>
+Methods inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><a name="YouTubeVideoQuery-__cmp__"><strong>__cmp__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__cmp__">__cmp__</a>(y) <==> cmp(x,y)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__contains__"><strong>__contains__</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-__contains__">__contains__</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__delitem__"><strong>__delitem__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__delitem__">__delitem__</a>(y) <==> del x[y]</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__eq__"><strong>__eq__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__eq__">__eq__</a>(y) <==> x==y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__ge__"><strong>__ge__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__ge__">__ge__</a>(y) <==> x>=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__getattribute__"><strong>__getattribute__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__getattribute__">__getattribute__</a>('name') <==> x.name</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__getitem__"><strong>__getitem__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__getitem__">__getitem__</a>(y) <==> x[y]</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__gt__"><strong>__gt__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__gt__">__gt__</a>(y) <==> x>y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__iter__"><strong>__iter__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__iter__">__iter__</a>() <==> iter(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__le__"><strong>__le__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__le__">__le__</a>(y) <==> x<=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__len__"><strong>__len__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__len__">__len__</a>() <==> len(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__lt__"><strong>__lt__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__lt__">__lt__</a>(y) <==> x<y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__ne__"><strong>__ne__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__ne__">__ne__</a>(y) <==> x!=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__repr__"><strong>__repr__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__repr__">__repr__</a>() <==> repr(x)</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__setitem__"><strong>__setitem__</strong></a>(...)</dt><dd><tt>x.<a href="#YouTubeVideoQuery-__setitem__">__setitem__</a>(i, y) <==> x[i]=y</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-__sizeof__"><strong>__sizeof__</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-__sizeof__">__sizeof__</a>() -> size of D in memory, in bytes</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-clear"><strong>clear</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-clear">clear</a>() -> None. Remove all items from D.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-copy"><strong>copy</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-copy">copy</a>() -> a shallow copy of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-fromkeys"><strong>fromkeys</strong></a>(...)</dt><dd><tt>dict.<a href="#YouTubeVideoQuery-fromkeys">fromkeys</a>(S[,v]) -> New dict with keys from S and values equal to v.<br>
+v defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-get"><strong>get</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-get">get</a>(k[,d]) -> D[k] if k in D, else d. d defaults to None.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-has_key"><strong>has_key</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-has_key">has_key</a>(k) -> True if D has a key k, else False</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-items"><strong>items</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-items">items</a>() -> list of D's (key, value) pairs, as 2-tuples</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-iteritems"><strong>iteritems</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-iteritems">iteritems</a>() -> an iterator over the (key, value) items of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-iterkeys"><strong>iterkeys</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-iterkeys">iterkeys</a>() -> an iterator over the keys of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-itervalues"><strong>itervalues</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-itervalues">itervalues</a>() -> an iterator over the values of D</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-keys"><strong>keys</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-keys">keys</a>() -> list of D's keys</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-pop"><strong>pop</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-pop">pop</a>(k[,d]) -> v, remove specified key and return the corresponding value.<br>
+If key is not found, d is returned if given, otherwise KeyError is raised</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-popitem"><strong>popitem</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-popitem">popitem</a>() -> (k, v), remove and return some (key, value) pair as a<br>
+2-tuple; but raise KeyError if D is empty.</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-setdefault"><strong>setdefault</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-setdefault">setdefault</a>(k[,d]) -> D.<a href="#YouTubeVideoQuery-get">get</a>(k,d), also set D[k]=d if k not in D</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-update"><strong>update</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-update">update</a>([E, ]**F) -> None. Update D from dict/iterable E and F.<br>
+If E present and has a .<a href="#YouTubeVideoQuery-keys">keys</a>() method, does: for k in E: D[k] = E[k]<br>
+If E present and lacks .<a href="#YouTubeVideoQuery-keys">keys</a>() method, does: for (k, v) in E: D[k] = v<br>
+In either case, this is followed by: for k in F: D[k] = F[k]</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-values"><strong>values</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-values">values</a>() -> list of D's values</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-viewitems"><strong>viewitems</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-viewitems">viewitems</a>() -> a set-like object providing a view on D's items</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-viewkeys"><strong>viewkeys</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-viewkeys">viewkeys</a>() -> a set-like object providing a view on D's keys</tt></dd></dl>
+
+<dl><dt><a name="YouTubeVideoQuery-viewvalues"><strong>viewvalues</strong></a>(...)</dt><dd><tt>D.<a href="#YouTubeVideoQuery-viewvalues">viewvalues</a>() -> an object providing a view on D's values</tt></dd></dl>
+
+<hr>
+Data and other attributes inherited from <a href="__builtin__.html#dict">__builtin__.dict</a>:<br>
+<dl><dt><strong>__hash__</strong> = None</dl>
+
+<dl><dt><strong>__new__</strong> = <built-in method __new__ of type object><dd><tt>T.<a href="#YouTubeVideoQuery-__new__">__new__</a>(S, ...) -> a new object with type S, a subtype of T</tt></dl>
+
+</td></tr></table></td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#55aa55">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Data</strong></big></font></td></tr>
+
+<tr><td bgcolor="#55aa55"><tt> </tt></td><td> </td>
+<td width="100%"><strong>UNKOWN_ERROR</strong> = 1000<br>
+<strong>YOUTUBE_BAD_REQUEST</strong> = 400<br>
+<strong>YOUTUBE_CLIENTLOGIN_AUTHENTICATION_URL</strong> = 'https://www.google.com/accounts/ClientLogin'<br>
+<strong>YOUTUBE_COMPLAINT_CATEGORY_SCHEME</strong> = 'http://gdata.youtube.com/schemas/complaint-reasons.cat'<br>
+<strong>YOUTUBE_COMPLAINT_CATEGORY_TERMS</strong> = ('PORN', 'VIOLENCE', 'HATE', 'DANGEROUS', 'RIGHTS', 'SPAM')<br>
+<strong>YOUTUBE_CONFLICT</strong> = 409<br>
+<strong>YOUTUBE_CONTACT_CATEGORY</strong> = ('Friends', 'Family')<br>
+<strong>YOUTUBE_CONTACT_STATUS</strong> = ('accepted', 'rejected')<br>
+<strong>YOUTUBE_INTERNAL_SERVER_ERROR</strong> = 500<br>
+<strong>YOUTUBE_INVALID_ARGUMENT</strong> = 601<br>
+<strong>YOUTUBE_INVALID_CONTENT_TYPE</strong> = 602<br>
+<strong>YOUTUBE_INVALID_KIND</strong> = 604<br>
+<strong>YOUTUBE_NOT_A_VIDEO</strong> = 603<br>
+<strong>YOUTUBE_PLAYLIST_FEED_URI</strong> = 'https://gdata.youtube.com/feeds/api/playlists'<br>
+<strong>YOUTUBE_QUERY_VALID_FORMAT_PARAMETERS</strong> = ('1', '5', '6')<br>
+<strong>YOUTUBE_QUERY_VALID_ORDERBY_PARAMETERS</strong> = ('published', 'viewCount', 'rating', 'relevance')<br>
+<strong>YOUTUBE_QUERY_VALID_RACY_PARAMETERS</strong> = ('include', 'exclude')<br>
+<strong>YOUTUBE_QUERY_VALID_TIME_PARAMETERS</strong> = ('today', 'this_week', 'this_month', 'all_time')<br>
+<strong>YOUTUBE_RATING_LINK_REL</strong> = 'http://gdata.youtube.com/schemas#video.ratings'<br>
+<strong>YOUTUBE_SCHEMA</strong> = 'http://gdata.youtube.com/schemas'<br>
+<strong>YOUTUBE_SERVER</strong> = 'gdata.youtube.com'<br>
+<strong>YOUTUBE_SERVICE</strong> = 'youtube'<br>
+<strong>YOUTUBE_STANDARDFEEDS</strong> = ('most_recent', 'recently_featured', 'top_rated', 'most_viewed', 'watch_on_mobile')<br>
+<strong>YOUTUBE_STANDARD_FEEDS</strong> = 'https://gdata.youtube.com/feeds/api/standardfeeds'<br>
+<strong>YOUTUBE_STANDARD_MOST_DISCUSSED_URI</strong> = 'https://gdata.youtube.com/feeds/api/standardfeeds/most_discussed'<br>
+<strong>YOUTUBE_STANDARD_MOST_LINKED_URI</strong> = 'https://gdata.youtube.com/feeds/api/standardfeeds/most_linked'<br>
+<strong>YOUTUBE_STANDARD_MOST_RECENT_URI</strong> = 'https://gdata.youtube.com/feeds/api/standardfeeds/most_recent'<br>
+<strong>YOUTUBE_STANDARD_MOST_RESPONDED_URI</strong> = 'https://gdata.youtube.com/feeds/api/standardfeeds/most_responded'<br>
+<strong>YOUTUBE_STANDARD_MOST_VIEWED_URI</strong> = 'https://gdata.youtube.com/feeds/api/standardfeeds/most_viewed'<br>
+<strong>YOUTUBE_STANDARD_RECENTLY_FEATURED_URI</strong> = 'https://gdata.youtube.com/feeds/api/standardfeeds/recently_featured'<br>
+<strong>YOUTUBE_STANDARD_TOP_FAVORITES_URI</strong> = 'https://gdata.youtube.com/feeds/api/standardfeeds/top_favorites'<br>
+<strong>YOUTUBE_STANDARD_TOP_RATED_URI</strong> = 'https://gdata.youtube.com/feeds/api/standardfeeds/top_rated'<br>
+<strong>YOUTUBE_STANDARD_WATCH_ON_MOBILE_URI</strong> = 'https://gdata.youtube.com/feeds/api/standardfeeds/watch_on_mobile'<br>
+<strong>YOUTUBE_SUBSCRIPTION_CATEGORY_SCHEME</strong> = 'http://gdata.youtube.com/schemas/subscriptiontypes.cat'<br>
+<strong>YOUTUBE_SUPPORTED_UPLOAD_TYPES</strong> = ('mov', 'avi', 'wmv', 'mpg', 'quicktime', 'flv', 'mp4', 'x-flv')<br>
+<strong>YOUTUBE_UPLOAD_TOKEN_URI</strong> = 'https://gdata.youtube.com/action/GetUploadToken'<br>
+<strong>YOUTUBE_UPLOAD_URI</strong> = 'https://uploads.gdata.youtube.com/feeds/api/users'<br>
+<strong>YOUTUBE_USER_FEED_URI</strong> = 'https://gdata.youtube.com/feeds/api/users'<br>
+<strong>YOUTUBE_VIDEO_URI</strong> = 'https://gdata.youtube.com/feeds/api/videos'<br>
+<strong>__author__</strong> = 'api.stephaniel@gmail.com (Stephanie Liu), api.jhartmann@gmail.com (Jochen Hartmann)'</td></tr></table><p>
+<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
+<tr bgcolor="#7799ee">
+<td colspan=3 valign=bottom> <br>
+<font color="#ffffff" face="helvetica, arial"><big><strong>Author</strong></big></font></td></tr>
+
+<tr><td bgcolor="#7799ee"><tt> </tt></td><td> </td>
+<td width="100%">api.stephaniel@gmail.com (Stephanie Liu), api.jhartmann@gmail.com (Jochen Hartmann)</td></tr></table>
+</body></html>
\ No newline at end of file
diff --git a/pydocs/generate_docs b/pydocs/generate_docs
new file mode 100755
index 0000000..94c63dd
--- /dev/null
+++ b/pydocs/generate_docs
@@ -0,0 +1,14 @@
+#!/bin/bash
+#
+# Copyright 2010 Google Inc. All Rights Reserved.
+# Author: jcgregorio@google.com (Joe Gregorio)
+#
+# Creates the documentation set for the library by
+# running pydoc on all the files in apiclient.
+#
+# Notes: You may have to update the location of the
+# App Engine library for your local system.
+
+export GOOGLE_APPENGINE=/usr/local/google_appengine/
+export PYTHONPATH=`pwd`/../src:$GOOGLE_APPENGINE
+find ../src/ -name "*.py" | sed "s/\/__init__.py//" | sed "s/\.py//" | sed "s#^\.\.\/src\/##" | sed "s#/#.#g" | xargs pydoc -w
diff --git a/samples/analytics/account_feed_demo.py b/samples/analytics/account_feed_demo.py
new file mode 100755
index 0000000..aa95e26
--- /dev/null
+++ b/samples/analytics/account_feed_demo.py
@@ -0,0 +1,189 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample Google Analytics Data Export API Account Feed application.
+
+This sample demonstrates how to retrieve the important data from the Google
+Analytics Data Export API Account feed using the Python Client library. This
+requires a Google Analytics username and password and uses the Client Login
+authorization routine.
+
+ Class AccountFeedDemo: Prints all the import Account Feed data.
+"""
+
+__author__ = 'api.nickm@google.com (Nick Mihailovski)'
+
+
+import gdata.analytics.client
+import gdata.sample_util
+
+def main():
+ """Main fucntion for the sample."""
+
+ demo = AccountFeedDemo()
+ demo.PrintFeedDetails()
+ demo.PrintAdvancedSegments()
+ demo.PrintCustomVarForOneEntry()
+ demo.PrintGoalsForOneEntry()
+ demo.PrintAccountEntries()
+
+
+class AccountFeedDemo(object):
+ """Prints the Google Analytics account feed
+
+ Attributes:
+ account_feed: Google Analytics AccountList returned form the API.
+ """
+
+ def __init__(self):
+ """Inits AccountFeedDemo."""
+
+ SOURCE_APP_NAME = 'Google-accountFeedDemoPython-v1'
+ my_client = gdata.analytics.client.AnalyticsClient(source=SOURCE_APP_NAME)
+
+ try:
+ gdata.sample_util.authorize_client(
+ my_client,
+ service=my_client.auth_service,
+ source=SOURCE_APP_NAME,
+ scopes=['https://www.google.com/analytics/feeds/'])
+ except gdata.client.BadAuthentication:
+ exit('Invalid user credentials given.')
+ except gdata.client.Error:
+ exit('Login Error')
+
+ account_query = gdata.analytics.client.AccountFeedQuery()
+ self.feed = my_client.GetAccountFeed(account_query)
+
+ def PrintFeedDetails(self):
+ """Prints important Analytics related data found at the top of the feed."""
+
+ print '-------- Important Feed Data --------'
+ print 'Feed Title = ' + self.feed.title.text
+ print 'Feed Id = ' + self.feed.id.text
+ print 'Total Results Found = ' + self.feed.total_results.text
+ print 'Start Index = ' + self.feed.start_index.text
+ print 'Results Returned = ' + self.feed.items_per_page.text
+
+ def PrintAdvancedSegments(self):
+ """Prints the advanced segments for this user."""
+
+ print '-------- Advances Segments --------'
+ if not self.feed.segment:
+ print 'No advanced segments found'
+ else:
+ for segment in self.feed.segment:
+ print 'Segment Name = ' + segment.name
+ print 'Segment Id = ' + segment.id
+ print 'Segment Definition = ' + segment.definition.text
+
+ def PrintCustomVarForOneEntry(self):
+ """Prints custom variable information for the first profile that has
+ custom variable configured."""
+
+ print '-------- Custom Variables --------'
+ if not self.feed.entry:
+ print 'No entries found'
+ else:
+ for entry in self.feed.entry:
+ if entry.custom_variable:
+ for custom_variable in entry.custom_variable:
+ print 'Custom Variable Index = ' + custom_variable.index
+ print 'Custom Variable Name = ' + custom_variable.name
+ print 'Custom Variable Scope = ' + custom_variable.scope
+ return
+ print 'No custom variables defined for this user'
+
+ def PrintGoalsForOneEntry(self):
+ """Prints All the goal information for one profile."""
+
+ print '-------- Goal Configuration --------'
+ if not self.feed.entry:
+ print 'No entries found'
+ else:
+ for entry in self.feed.entry:
+ if entry.goal:
+ for goal in entry.goal:
+ print 'Goal Number = ' + goal.number
+ print 'Goal Name = ' + goal.name
+ print 'Goal Value = ' + goal.value
+ print 'Goal Active = ' + goal.active
+
+ if goal.destination:
+ self.PrintDestinationGoal(goal.destination)
+ elif goal.engagement:
+ self.PrintEngagementGoal(goal.engagement)
+ return
+
+ def PrintDestinationGoal(self, destination):
+ """Prints the important information for destination goals including all
+ the configured steps if they exist.
+
+ Args:
+ destination: gdata.data.Destination The destination goal configuration.
+ """
+
+ print '----- Destination Goal -----'
+ print 'Expression = ' + destination.expression
+ print 'Match Type = ' + destination.match_type
+ print 'Step 1 Required = ' + destination.step1_required
+ print 'Case Sensitive = ' + destination.case_sensitive
+
+ # Print goal steps.
+ if destination.step:
+ print '----- Destination Goal Steps -----'
+ for step in destination.step:
+ print 'Step Number = ' + step.number
+ print 'Step Name = ' + step.name
+ print 'Step Path = ' + step.path
+
+ def PrintEngagementGoal(self, engagement):
+ """Prints the important information for engagement goals.
+
+ Args:
+ engagement: gdata.data.Engagement The engagement goal configuration.
+ """
+
+ print '----- Engagement Goal -----'
+ print 'Goal Type = ' + engagement.type
+ print 'Goal Engagement = ' + engagement.comparison
+ print 'Goal Threshold = ' + engagement.threshold_value
+
+ def PrintAccountEntries(self):
+ """Prints important Analytics data found in each account entry"""
+
+ print '-------- First 1000 Profiles in Account Feed --------'
+ if not self.feed.entry:
+ print 'No entries found'
+ else:
+ for entry in self.feed.entry:
+ print 'Web Property ID = ' + entry.GetProperty('ga:webPropertyId').value
+ print 'Account Name = ' + entry.GetProperty('ga:accountName').value
+ print 'Account Id = ' + entry.GetProperty('ga:accountId').value
+ print 'Profile Name = ' + entry.title.text
+ print 'Profile ID = ' + entry.GetProperty('ga:profileId').value
+ print 'Table ID = ' + entry.table_id.text
+ print 'Currency = ' + entry.GetProperty('ga:currency').value
+ print 'TimeZone = ' + entry.GetProperty('ga:timezone').value
+ if entry.custom_variable:
+ print 'This profile has custom variables'
+ if entry.goal:
+ print 'This profile has goals'
+
+
+if __name__ == '__main__':
+ main()
+
diff --git a/samples/analytics/data_feed_demo.py b/samples/analytics/data_feed_demo.py
new file mode 100755
index 0000000..e704571
--- /dev/null
+++ b/samples/analytics/data_feed_demo.py
@@ -0,0 +1,184 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample Google Analytics Data Export API Data Feed application.
+
+This sample demonstrates how to make requests and retrieve the important
+information from the Google Analytics Data Export API Data Feed. This
+sample requires a Google Analytics username and password and uses the
+Client Login authorization routine.
+
+ Class DataFeedDemo: Prints all the important Data Feed informantion.
+"""
+
+__author__ = 'api.nickm@google.com (Nick Mihailovski)'
+
+
+import gdata.analytics.client
+import gdata.sample_util
+
+def main():
+ """Main function for the sample."""
+
+ demo = DataFeedDemo()
+ demo.PrintFeedDetails()
+ demo.PrintDataSources()
+ demo.PrintFeedAggregates()
+ demo.PrintSegmentInfo()
+ demo.PrintOneEntry()
+ demo.PrintFeedTable()
+
+
+class DataFeedDemo(object):
+ """Gets data from the Data Feed.
+
+ Attributes:
+ data_feed: Google Analytics AccountList returned form the API.
+ """
+
+ def __init__(self):
+ """Inits DataFeedDemo."""
+
+ SOURCE_APP_NAME = 'Google-dataFeedDemoPython-v2'
+ my_client = gdata.analytics.client.AnalyticsClient(source=SOURCE_APP_NAME)
+
+ try:
+ gdata.sample_util.authorize_client(
+ my_client,
+ service=my_client.auth_service,
+ source=SOURCE_APP_NAME,
+ scopes=['https://www.google.com/analytics/feeds/'])
+ except gdata.client.BadAuthentication:
+ exit('Invalid user credentials given.')
+ except gdata.client.Error:
+ exit('Login Error')
+
+ table_id = gdata.sample_util.get_param(
+ name='table_id',
+ prompt='Please enter your Google Analytics Table id (format ga:xxxx)')
+
+ # DataFeedQuery simplifies constructing API queries and uri encodes params.
+ data_query = gdata.analytics.client.DataFeedQuery({
+ 'ids': table_id,
+ 'start-date': '2008-10-01',
+ 'end-date': '2008-10-30',
+ 'dimensions': 'ga:source,ga:medium',
+ 'metrics': 'ga:visits',
+ 'sort': '-ga:visits',
+ 'filters': 'ga:medium==referral',
+ 'max-results': '50'})
+
+ self.feed = my_client.GetDataFeed(data_query)
+
+ def PrintFeedDetails(self):
+ """Prints important Analytics related data found at the top of the feed."""
+
+ print '\n-------- Feed Data --------'
+ print 'Feed Title = ' + self.feed.title.text
+ print 'Feed Id = ' + self.feed.id.text
+ print 'Total Results Found = ' + self.feed.total_results.text
+ print 'Start Index = ' + self.feed.start_index.text
+ print 'Results Returned = ' + self.feed.items_per_page.text
+ print 'Start Date = ' + self.feed.start_date.text
+ print 'End Date = ' + self.feed.end_date.text
+ print 'Has Sampled Data = ' + str(self.feed.HasSampledData())
+
+ def PrintDataSources(self):
+ """Prints data found in the data source elements.
+
+ This data has information about the Google Analytics account the referenced
+ table ID belongs to. Note there is currently exactly one data source in
+ the data feed.
+ """
+
+ data_source = self.feed.data_source[0]
+
+ print '\n-------- Data Source Data --------'
+ print 'Table ID = ' + data_source.table_id.text
+ print 'Table Name = ' + data_source.table_name.text
+ print 'Web Property Id = ' + data_source.GetProperty('ga:webPropertyId').value
+ print 'Profile Id = ' + data_source.GetProperty('ga:profileId').value
+ print 'Account Name = ' + data_source.GetProperty('ga:accountName').value
+
+ def PrintFeedAggregates(self):
+ """Prints data found in the aggregates elements.
+
+ This contains the sum of all the metrics defined in the query across.
+ This sum spans all the rows matched in the feed.total_results property
+ and not just the rows returned by the response.
+ """
+
+ aggregates = self.feed.aggregates
+
+ print '\n-------- Metric Aggregates --------'
+ for met in aggregates.metric:
+ print ''
+ print 'Metric Name = ' + met.name
+ print 'Metric Value = ' + met.value
+ print 'Metric Type = ' + met.type
+ print 'Metric CI = ' + met.confidence_interval
+
+ def PrintSegmentInfo(self):
+ """Prints segment information if the query has advanced segments
+ defined."""
+
+ print '-------- Advanced Segments Information --------'
+ if self.feed.segment:
+ if segment.name:
+ print 'Segment Name = ' + str(segment.name)
+ if segment.id:
+ print 'Segment Id = ' + str(segment.id)
+ print 'Segment Definition = ' + segment.definition.text
+ else:
+ print 'No segments defined'
+
+ def PrintOneEntry(self):
+ """Prints all the important Google Analytics data found in an entry"""
+
+ print '\n-------- One Entry --------'
+ if len(self.feed.entry) == 0:
+ print 'No entries found'
+ return
+
+ entry = self.feed.entry[0]
+ print 'ID = ' + entry.id.text
+
+ for dim in entry.dimension:
+ print 'Dimension Name = ' + dim.name
+ print 'Dimension Value = ' + dim.value
+
+ for met in entry.metric:
+ print 'Metric Name = ' + met.name
+ print 'Metric Value = ' + met.value
+ print 'Metric Type = ' + met.type
+ print 'Metric CI = ' + met.confidence_interval
+
+ def PrintFeedTable(self):
+ """Prints all the entries as a table."""
+
+ print '\n-------- All Entries In a Table --------'
+ for entry in self.feed.entry:
+ for dim in entry.dimension:
+ print ('Dimension Name = %s \t Dimension Value = %s'
+ % (dim.name, dim.value))
+ for met in entry.metric:
+ print ('Metric Name = %s \t Metric Value = %s'
+ % (met.name, met.value))
+ print '---'
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/analytics/mgmt_feed_demo.py b/samples/analytics/mgmt_feed_demo.py
new file mode 100755
index 0000000..dc4ab8f
--- /dev/null
+++ b/samples/analytics/mgmt_feed_demo.py
@@ -0,0 +1,243 @@
+#!/usr/bin/python
+#
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google Analytics Management API Demo.
+
+This script demonstrates how to retrieve the important data from the Google
+Analytics Data Management API using the Python Client library. This example
+requires a Google Analytics account with data and a username and password.
+Each feed in the Management API is retrieved and printed using the respective
+print method in ManagementFeedDemo. To simplify setting filters and query
+parameters, each feed has it's own query class. Check the
+<code>gdata.analytics.client</code> module for more details on usage.
+
+ main: The main method of this example.
+ GetAnalyticsClient: Returns an authorized AnalyticsClient object.
+ Class ManagementFeedDemo: Prints all the import Account Feed data.
+"""
+
+__author__ = 'api.nickm@google.com (Nick Mihailovski)'
+
+
+import gdata.analytics.client
+import gdata.sample_util
+
+
+ACCOUNT_ID = '~all'
+WEB_PROPERTY_ID = '~all'
+PROFILE_ID = '~all'
+
+
+def main():
+ """Main example script. Un-comment each method to print the feed."""
+
+ demo = ManagementFeedDemo(GetAnalyticsClient())
+ demo.PrintAccountFeed()
+ # demo.PrintWebPropertyFeed()
+ # demo.PrintProfileFeed()
+ # demo.PrintGoalFeed()
+ # demo.PrintSegmentFeed()
+
+
+def GetAnalyticsClient():
+ """Returns an authorized GoogleAnalayticsClient object.
+
+ Uses the Google Data python samples wrapper to prompt the user for
+ credentials then tries to authorize the client object with the
+ Google Analytics API.
+
+ Returns:
+ An authorized GoogleAnalyticsClient object.
+ """
+
+ SOURCE_APP_NAME = 'Analytics-ManagementAPI-Demo-v1'
+ my_client = gdata.analytics.client.AnalyticsClient(source=SOURCE_APP_NAME)
+
+ try:
+ gdata.sample_util.authorize_client(
+ my_client,
+ service=my_client.auth_service,
+ source=SOURCE_APP_NAME,
+ scopes=['https://www.google.com/analytics/feeds/'])
+ except gdata.client.BadAuthentication:
+ exit('Invalid user credentials given.')
+ except gdata.client.Error:
+ exit('Login Error')
+
+ return my_client
+
+
+class ManagementFeedDemo(object):
+ """The main demo for the management feed.
+
+ Attributes:
+ my_client: gdata.analytics.client The AnalyticsClient object for this demo.
+ """
+
+ def __init__(self, my_client):
+ """Initializes the ManagementFeedDemo class.
+
+ Args:
+ my_client: gdata.analytics.client An authorized GoogleAnalyticsClient
+ object.
+ """
+ self.my_client = my_client
+
+ def PrintAccountFeed(self):
+ """Requests and prints the important data in the Account Feed.
+
+ Note:
+ AccountQuery is used for the ManagementAPI.
+ AccountFeedQuery is used for the Data Export API.
+ """
+
+ account_query = gdata.analytics.client.AccountQuery()
+ results = self.my_client.GetManagementFeed(account_query)
+
+ print '-------- Account Feed Data --------'
+ if not results.entry:
+ print 'no entries found'
+ else:
+ for entry in results.entry:
+ print 'Account Name = ' + entry.GetProperty('ga:accountName').value
+ print 'Account ID = ' + entry.GetProperty('ga:accountId').value
+ print 'Child Feed Link = ' + entry.GetChildLink('analytics#webproperties').href
+ print
+
+ def PrintWebPropertyFeed(self):
+ """Requests and prints the important data in the Web Property Feed."""
+
+ web_property_query = gdata.analytics.client.WebPropertyQuery(
+ acct_id=ACCOUNT_ID)
+ results = self.my_client.GetManagementFeed(web_property_query)
+
+ print '-------- Web Property Feed Data --------'
+ if not results.entry:
+ print 'no entries found'
+ else:
+ for entry in results.entry:
+ print 'Account ID = ' + entry.GetProperty('ga:accountId').value
+ print 'Web Property ID = ' + entry.GetProperty('ga:webPropertyId').value
+ print 'Child Feed Link = ' + entry.GetChildLink('analytics#profiles').href
+ print
+
+ def PrintProfileFeed(self):
+ """Requests and prints the important data in the Profile Feed.
+
+ Note:
+ TableId has a different namespace (dxp:) than all the
+ other properties (ga:).
+ """
+
+ profile_query = gdata.analytics.client.ProfileQuery(
+ acct_id=ACCOUNT_ID, web_prop_id=WEB_PROPERTY_ID)
+ results = self.my_client.GetManagementFeed(profile_query)
+
+ print '-------- Profile Feed Data --------'
+ if not results.entry:
+ print 'no entries found'
+ else:
+ for entry in results.entry:
+ print 'Account ID = ' + entry.GetProperty('ga:accountId').value
+ print 'Web Property ID = ' + entry.GetProperty('ga:webPropertyId').value
+ print 'Profile ID = ' + entry.GetProperty('ga:profileId').value
+ print 'Currency = ' + entry.GetProperty('ga:currency').value
+ print 'Timezone = ' + entry.GetProperty('ga:timezone').value
+ print 'TableId = ' + entry.GetProperty('dxp:tableId').value
+ print 'Child Feed Link = ' + entry.GetChildLink('analytics#goals').href
+ print
+
+ def PrintGoalFeed(self):
+ """Requests and prints the important data in the Goal Feed.
+
+ Note:
+ There are two types of goals, destination and engagement which need to
+ be handled differently.
+ """
+
+ goal_query = gdata.analytics.client.GoalQuery(
+ acct_id=ACCOUNT_ID, web_prop_id=WEB_PROPERTY_ID, profile_id=PROFILE_ID)
+ results = self.my_client.GetManagementFeed(goal_query)
+
+ print '-------- Goal Feed Data --------'
+ if not results.entry:
+ print 'no entries found'
+ else:
+ for entry in results.entry:
+ print 'Goal Number = ' + entry.goal.number
+ print 'Goal Name = ' + entry.goal.name
+ print 'Goal Value = ' + entry.goal.value
+ print 'Goal Active = ' + entry.goal.active
+
+ if entry.goal.destination:
+ self.PrintDestinationGoal(entry.goal.destination)
+ elif entry.goal.engagement:
+ self.PrintEngagementGoal(entry.goal.engagement)
+
+ def PrintDestinationGoal(self, destination):
+ """Prints the important information for destination goals including all
+ the configured steps if they exist.
+
+ Args:
+ destination: gdata.data.Destination The destination goal configuration.
+ """
+
+ print '\t----- Destination Goal -----'
+ print '\tExpression = ' + destination.expression
+ print '\tMatch Type = ' + destination.match_type
+ print '\tStep 1 Required = ' + destination.step1_required
+ print '\tCase Sensitive = ' + destination.case_sensitive
+
+ if destination.step:
+ print '\t\t----- Destination Goal Steps -----'
+ for step in destination.step:
+ print '\t\tStep Number = ' + step.number
+ print '\t\tStep Name = ' + step.name
+ print '\t\tStep Path = ' + step.path
+ print
+
+ def PrintEngagementGoal(self, engagement):
+ """Prints the important information for engagement goals.
+
+ Args:
+ engagement: gdata.data.Engagement The engagement goal configuration.
+ """
+
+ print '\t----- Engagement Goal -----'
+ print '\tGoal Type = ' + engagement.type
+ print '\tGoal Engagement = ' + engagement.comparison
+ print '\tGoal Threshold = ' + engagement.threshold_value
+ print
+
+ def PrintSegmentFeed(self):
+ """Requests and prints the important data in the Profile Feed."""
+
+ adv_seg_query = gdata.analytics.client.AdvSegQuery()
+ results = self.my_client.GetManagementFeed(adv_seg_query)
+
+ print '-------- Advanced Segment Feed Data --------'
+ if not results.entry:
+ print 'no entries found'
+ else:
+ for entry in results.entry:
+ print 'Segment ID = ' + entry.segment.id
+ print 'Segment Name = ' + entry.segment.name
+ print 'Segment Definition = ' + entry.segment.definition.text
+ print
+
+if __name__ == '__main__':
+ main()
+
diff --git a/samples/apps/adminsettings_example.py b/samples/apps/adminsettings_example.py
new file mode 100755
index 0000000..efe0d77
--- /dev/null
+++ b/samples/apps/adminsettings_example.py
@@ -0,0 +1,151 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains a Sample for Google Apps Admin Settings.
+
+ AdminSettingsSample: shows everything you ever wanted to know about
+ your Google Apps Domain but were afraid to ask.
+"""
+
+__author__ = 'jlee@pbu.edu'
+
+import getopt
+import getpass
+import sys
+import time
+
+import gdata.apps.service
+import gdata.apps.adminsettings.service
+
+class AdminSettingsSample(object):
+ """AdminSettingsSample object demos Admin Settings API."""
+
+ def __init__(self, email, password, domain):
+ """Constructor for the AdminSettingsSample object.
+
+ Takes an email and password corresponding to a google apps admin
+ account to demon the Admin Settings API.
+
+ Args:
+ email: [string] The e-mail address of the account to use for the sample.
+ password: [string] The password corresponding to the account specified by
+ the email parameter.
+ domain: [string] The domain for the Profiles feed
+ """
+ self.gd_client = gdata.apps.adminsettings.service.AdminSettingsService()
+ self.gd_client.domain = domain
+ self.gd_client.email = email
+ self.gd_client.password = password
+ self.gd_client.source = 'GoogleInc-AdminSettingsPythonSample-1'
+ self.gd_client.ProgrammaticLogin()
+
+ def Run(self):
+ #pause 1 sec inbetween calls to prevent quota warning
+ print 'Google Apps Domain: ', self.gd_client.domain
+ time.sleep(1)
+ print 'Default Language: ', self.gd_client.GetDefaultLanguage()
+ time.sleep(1)
+ print 'Organization Name: ', self.gd_client.GetOrganizationName()
+ time.sleep(1)
+ print 'Maximum Users: ', self.gd_client.GetMaximumNumberOfUsers()
+ time.sleep(1)
+ print 'Current Users: ', self.gd_client.GetCurrentNumberOfUsers()
+ time.sleep(1)
+ print 'Domain is Verified: ',self.gd_client.IsDomainVerified()
+ time.sleep(1)
+ print 'Support PIN: ',self.gd_client.GetSupportPIN()
+ time.sleep(1)
+ print 'Domain Edition: ', self.gd_client.GetEdition()
+ time.sleep(1)
+ print 'Customer PIN: ', self.gd_client.GetCustomerPIN()
+ time.sleep(1)
+ print 'Domain Creation Time: ', self.gd_client.GetCreationTime()
+ time.sleep(1)
+ print 'Domain Country Code: ', self.gd_client.GetCountryCode()
+ time.sleep(1)
+ print 'Admin Secondary Email: ', self.gd_client.GetAdminSecondaryEmail()
+ time.sleep(1)
+ cnameverificationstatus = self.gd_client.GetCNAMEVerificationStatus()
+ print 'CNAME Verification Record Name: ', cnameverificationstatus['recordName']
+ print 'CNAME Verification Verified: ', cnameverificationstatus['verified']
+ print 'CNAME Verification Method: ', cnameverificationstatus['verificationMethod']
+ time.sleep(1)
+ mxverificationstatus = self.gd_client.GetMXVerificationStatus()
+ print 'MX Verification Verified: ', mxverificationstatus['verified']
+ print 'MX Verification Method: ', mxverificationstatus['verificationMethod']
+ time.sleep(1)
+ ssosettings = self.gd_client.GetSSOSettings()
+ print 'SSO Enabled: ', ssosettings['enableSSO']
+ print 'SSO Signon Page: ', ssosettings['samlSignonUri']
+ print 'SSO Logout Page: ', ssosettings['samlLogoutUri']
+ print 'SSO Password Page: ', ssosettings['changePasswordUri']
+ print 'SSO Whitelist IPs: ', ssosettings['ssoWhitelist']
+ print 'SSO Use Domain Specific Issuer: ', ssosettings['useDomainSpecificIssuer']
+ time.sleep(1)
+ ssokey = self.gd_client.GetSSOKey()
+ print 'SSO Key Modulus: ', ssokey['modulus']
+ print 'SSO Key Exponent: ', ssokey['exponent']
+ print 'SSO Key Algorithm: ', ssokey['algorithm']
+ print 'SSO Key Format: ', ssokey['format']
+ print 'User Migration Enabled: ', self.gd_client.IsUserMigrationEnabled()
+ time.sleep(1)
+ outboundgatewaysettings = self.gd_client.GetOutboundGatewaySettings()
+ print 'Outbound Gateway Smart Host: ', outboundgatewaysettings['smartHost']
+ print 'Outbound Gateway Mode: ', outboundgatewaysettings['smtpMode']
+
+def main():
+ """Demonstrates use of the Admin Settings API using the AdminSettingsSample object."""
+ # Parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['user=', 'pw=', 'domain='])
+ except getopt.error, msg:
+ print 'python adminsettings_example.py --user [username] --pw [password]'
+ print ' --domain [domain]'
+ sys.exit(2)
+
+ user = ''
+ pw = ''
+ domain = ''
+
+ # Process options
+ for option, arg in opts:
+ if option == '--user':
+ user = arg
+ elif option == '--pw':
+ pw = arg
+ elif option == '--domain':
+ domain = arg
+
+ while not domain:
+ print 'NOTE: Please run these tests only with a test account.'
+ domain = raw_input('Please enter your apps domain: ')
+ while not user:
+ user = raw_input('Please enter a administrator account: ')+'@'+domain
+ while not pw:
+ pw = getpass.getpass('Please enter password: ')
+ if not pw:
+ print 'Password cannot be blank.'
+
+ try:
+ sample = AdminSettingsSample(user, pw, domain)
+ except gdata.service.BadAuthentication:
+ print 'Invalid user credentials given.'
+ return
+
+ sample.Run()
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/client_secrets.json b/samples/apps/client_secrets.json
new file mode 100644
index 0000000..323ffd0
--- /dev/null
+++ b/samples/apps/client_secrets.json
@@ -0,0 +1,9 @@
+{
+ "installed": {
+ "client_id": "[[INSERT CLIENT ID HERE]]",
+ "client_secret": "[[INSERT CLIENT SECRET HERE]]",
+ "redirect_uris": [],
+ "auth_uri": "https://accounts.google.com/o/oauth2/auth",
+ "token_uri": "https://accounts.google.com/o/oauth2/token"
+ }
+}
diff --git a/samples/apps/create_update_group.py b/samples/apps/create_update_group.py
new file mode 100644
index 0000000..15cae15
--- /dev/null
+++ b/samples/apps/create_update_group.py
@@ -0,0 +1,161 @@
+#!/usr/bin/python
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Create group and update settings using two APIs.
+
+Sample to use the Groups Settings API in google-api-python client library
+http://code.google.com/p/google-api-python-client/source/checkout
+with the Groups Provisioning API in gdata-python-client library
+http://code.google.com/p/gdata-python-client/source/checkout to create a
+group and update its settings.
+
+Usage:
+ $ python create_update_group.py
+"""
+
+__author__ = 'Shraddha Gupta <shraddhag@google.com>'
+
+import os
+import pprint
+import sys
+
+from apiclient.discovery import build
+import gdata.apps.groups.client
+import gflags
+import httplib2
+from oauth2client.client import flow_from_clientsecrets
+from oauth2client.file import Storage
+from oauth2client.tools import run
+
+
+# CLIENT_SECRETS, name of a file containing the OAuth 2.0 information for this
+# application, including client_id and client_secret, which are found
+# on the API Access tab on the Google APIs
+# Console <http://code.google.com/apis/console>
+CLIENT_SECRETS = 'client_secrets.json'
+
+# Helpful message to display in the browser if the CLIENT_SECRETS file
+# is missing.
+MISSING_CLIENT_SECRETS_MESSAGE = """
+WARNING: Please configure OAuth 2.0
+
+To make this sample run you will need to populate the client_secrets.json file
+found at:
+
+ %s
+
+with information from the APIs Console <https://code.google.com/apis/console>.
+
+""" % os.path.join(os.path.dirname(__file__), CLIENT_SECRETS)
+
+# Request a token for the scope of two APIs:
+# Groups Provisioning and Groups Settings APIs
+SCOPES = ('https://apps-apis.google.com/a/feeds/groups/ '
+ 'https://www.googleapis.com/auth/apps.groups.settings')
+
+FLOW = flow_from_clientsecrets(CLIENT_SECRETS,
+ scope=SCOPES,
+ message=MISSING_CLIENT_SECRETS_MESSAGE)
+FLAGS = gflags.FLAGS
+
+
+def GetOAuth2Token(client_id, client_secret, access_token, refresh_token):
+ """Get the OAuth 2.0 token to be used with the Groups Provisioning API.
+
+ Args:
+ client_id: String client_id of the installed application
+ client_secret: String client_secret of the installed application
+ access_token: String access token obtained from OAuth 2.0 server flow
+ refresh_token: String refresh token obtained with access token
+
+ Returns:
+ token: String OAuth 2.0 token adapted for the Groups Provisioning API.
+ """
+ token = gdata.gauth.OAuth2Token(client_id=client_id,
+ client_secret=client_secret,
+ scope=SCOPES,
+ access_token=access_token,
+ refresh_token=refresh_token,
+ user_agent='create-manage-group-sample')
+ return token
+
+
+def CreateAndUpdateGroup(http, groups_client, domain):
+ """Create a group and update its settings.
+
+ Args:
+ http: httplib2.Http authorized object
+ groups_client: gdata.apps.groups.client.GroupsProvisioningClient
+ authorized group provisioning client
+ domain: String domain name
+ """
+ group_id = raw_input('Enter the group id: ')
+ group_name = raw_input('Enter the group name: ')
+ group_description = raw_input('Enter the group description: ')
+ email_permission = raw_input('Enter the email permission: ')
+
+ if not (group_id and group_name):
+ print 'One or more required fields missing: group id, group name'
+ sys.exit(1)
+
+ new_group = groups_client.CreateGroup(group_id=group_id,
+ group_name=group_name, description=group_description,
+ email_permission=email_permission)
+ print 'Group Created %s' % new_group.group_id
+ print 'Name: %s\nDescription %s\nEmail Permission %s' % (
+ new_group.group_name, new_group.description, new_group.email_permission)
+
+ group_id = '%s@%s' % (new_group.group_id, domain)
+ service = build('groupssettings', 'v1', http=http)
+ # Get the resource 'group' from the set of resources of the API.
+ group_resource = service.groups()
+
+ body = {'showInGroupDirectory': True,
+ 'whoCanViewGroup': 'ALL_IN_DOMAIN_CAN_VIEW',
+ 'whoCanViewMembership': 'ALL_IN_DOMAIN_CAN_VIEW'}
+ # Update the group properties
+ g = group_resource.update(groupUniqueId=group_id, body=body).execute()
+ print '\nUpdated Access Permissions to the group\n'
+ pprint.pprint(g)
+
+
+def main(argv):
+ """Demonstrates creation of a group and updation of its settings."""
+ storage = Storage('group.dat')
+ credentials = storage.get()
+ if credentials is None or credentials.invalid:
+ print 'Credentials are invalid or do not exist.'
+ credentials = run(FLOW, storage)
+
+ # Create an httplib2.Http object to handle our HTTP requests and authorize it
+ # with the valid credentials.
+ http = httplib2.Http()
+ http = credentials.authorize(http)
+
+ domain = raw_input('Enter the domain: ')
+
+ # Create an OAuth 2.0 token suitable for use with the GData client library
+ oauth2token = GetOAuth2Token(credentials.client_id,
+ credentials.client_secret,
+ credentials.access_token,
+ credentials.refresh_token)
+ groups_client = oauth2token.authorize(
+ gdata.apps.groups.client.GroupsProvisioningClient(domain=domain))
+ CreateAndUpdateGroup(http, groups_client, domain)
+
+
+if __name__ == '__main__':
+ main(sys.argv)
diff --git a/samples/apps/email_audit_email_monitoring.py b/samples/apps/email_audit_email_monitoring.py
new file mode 100644
index 0000000..cab46cd
--- /dev/null
+++ b/samples/apps/email_audit_email_monitoring.py
@@ -0,0 +1,275 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2012 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample to demonstrate the Email Audit API's email monitoring functions.
+
+The sample demonstrates the creating, updating, retrieving and deleting of
+email monitors.
+"""
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+from datetime import datetime
+import getopt
+import re
+import sys
+import gdata
+from gdata.apps.audit.service import AuditService
+
+
+class EmailMonitoringException(Exception):
+ """Exception class for EmailMonitoring, shows appropriate error message."""
+
+
+class EmailMonitoring(object):
+ """Sample demonstrating how to perform CRUD operations on email monitor."""
+
+ def __init__(self, consumer_key, consumer_secret, domain):
+ """Create a new EmailMonitoring object configured for a domain.
+
+ Args:
+ consumer_key: A string representing a consumerKey.
+ consumer_secret: A string representing a consumerSecret.
+ domain: A string representing the domain to work on in the sample.
+ """
+ self.consumer_key = consumer_key
+ self.consumer_secret = consumer_secret
+ self.domain = domain
+ self._Authorize()
+
+ def _Authorize(self):
+ """Asks the domain's admin to authorize access to the apps Apis."""
+ self.service = AuditService(domain=self.domain, source='emailAuditSample')
+ self.service.SetOAuthInputParameters(
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1,
+ self.consumer_key, self.consumer_secret)
+ request_token = self.service.FetchOAuthRequestToken()
+ self.service.SetOAuthToken(request_token)
+ auth_url = self.service.GenerateOAuthAuthorizationURL()
+ print auth_url
+ raw_input('Manually go to the above URL and authenticate.'
+ 'Press Return after authorization.')
+ self.service.UpgradeToOAuthAccessToken()
+
+ def _CheckUsername(self, username):
+ """Checks if a given username is valid or not.
+
+ Args:
+ username: A string to check for validity.
+
+ Returns:
+ True if username is valid, False otherwise.
+ """
+ if len(username) > 64:
+ print 'Username length should be less than 64'
+ return False
+ pattern = re.compile('[^\w\.\+-_\']+')
+ return not bool(pattern.search(username))
+
+ def _GetValidUsername(self, typeof):
+ """Takes a valid username as input.
+
+ Args:
+ typeof: A string representing the type of user.
+
+ Returns:
+ A valid string corresponding to username.
+ """
+ username = ''
+ while not username:
+ username = raw_input('Enter a valid %s username: ' % typeof)
+ if not self._CheckUsername(username):
+ print 'Invalid username'
+ username = ''
+ return username
+
+ def _GetValidDate(self, is_neccessary):
+ """Takes a valid date as input in 'yyyy-mm-dd HH:MM' format.
+
+ Args:
+ is_neccessary: A boolean denoting if a non empty value is needed.
+
+ Returns:
+ A valid string corresponding to date.
+ """
+ date = ''
+ extra_stmt = ''
+ if not is_neccessary:
+ extra_stmt = '. Press enter to skip.'
+ while not date:
+ date = raw_input(
+ 'Enter a valid date as (yyyy-mm-dd HH:MM)%s:' % extra_stmt)
+ if not (date and is_neccessary):
+ return date
+ try:
+ datetime.strptime(date, '%Y-%m-%d %H:%M')
+ return date
+ except ValueError:
+ print 'Not a valid date!'
+ date = ''
+
+ def _GetBool(self, name):
+ """Takes a boolean value as input.
+
+ Args:
+ name: A string for which input is to be taken.
+
+ Returns:
+ A boolean for an entity represented by name.
+ """
+ choice = raw_input(
+ 'Enter your choice (t/f) for %s (defaults to False):' % name).strip()
+ if choice == 't':
+ return True
+ return False
+
+ def _CreateEmailMonitor(self):
+ """Creates/Updates an email monitor."""
+ src_user = self._GetValidUsername('source')
+ dest_user = self._GetValidUsername('destination')
+ end_date = self._GetValidDate(True)
+ start_date = self._GetValidDate(False)
+ incoming_headers = self._GetBool('incoming headers')
+ outgoing_headers = self._GetBool('outgoing headers')
+ drafts = self._GetBool('drafts')
+ drafts_headers = False
+ if drafts:
+ drafts_headers = self._GetBool('drafts headers')
+ chats = self._GetBool('chats')
+ chats_headers = False
+ if chats:
+ self._GetBool('chats headers')
+ self.service.createEmailMonitor(
+ src_user, dest_user,
+ end_date, start_date,
+ incoming_headers, outgoing_headers,
+ drafts, drafts_headers,
+ chats, chats_headers)
+ print 'Email monitor created/updated successfully!\n'
+
+ def _RetrieveEmailMonitor(self):
+ """Retrieves all email monitors for a user."""
+ src_user = self._GetValidUsername('source')
+ monitors = self.service.getEmailMonitors(src_user)
+ for monitor in monitors:
+ for key in monitor.keys():
+ print '%s ----------- %s' % (key, monitor.get(key))
+ print ''
+ print 'Email monitors retrieved successfully!\n'
+
+ def _DeleteEmailMonitor(self):
+ """Deletes an email monitor."""
+ src_user = self._GetValidUsername('source')
+ dest_user = self._GetValidUsername('destination')
+ self.service.deleteEmailMonitor(src_user, dest_user)
+ print 'Email monitor deleted successfully!\n'
+
+ def Run(self):
+ """Handles the flow of the sample."""
+ functions_list = [
+ {
+ 'function': self._CreateEmailMonitor,
+ 'description': 'Create a email monitor for a domain user'
+ },
+ {
+ 'function': self._CreateEmailMonitor,
+ 'description': 'Update a email monitor for a domain user'
+ },
+ {
+ 'function': self._RetrieveEmailMonitor,
+ 'description': 'Retrieve all email monitors for a domain user'
+ },
+ {
+ 'function': self._DeleteEmailMonitor,
+ 'description': 'Delete a email monitor for a domain user'
+ }
+ ]
+
+ while True:
+ print 'What would you like to do? Choose an option:'
+ print '0 - To exit'
+ for i in range (0, len(functions_list)):
+ print '%d - %s' % ((i + 1), functions_list[i].get('description'))
+ choice = raw_input('Enter your choice: ').strip()
+ if choice.isdigit():
+ choice = int(choice)
+ if choice == 0:
+ break
+ if choice < 0 or choice > len(functions_list):
+ print 'Not a valid option!'
+ continue
+ try:
+ functions_list[choice - 1].get('function')()
+ except gdata.apps.service.AppsForYourDomainException, e:
+ if e.error_code == 1301:
+ print '\nError: Invalid username!!\n'
+ else:
+ raise e
+
+
+def PrintUsageString():
+ """Prints the correct call for running the sample."""
+ print ('python email_audit_email_monitoring.py '
+ '--consumer_key [ConsumerKey] --consumer_secret [ConsumerSecret] '
+ '--domain [domain]')
+
+
+def main():
+ """Runs the sample using an instance of EmailMonitoring."""
+
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['consumer_key=',
+ 'consumer_secret=',
+ 'domain='])
+ except getopt.error, msg:
+ PrintUsageString()
+ sys.exit(1)
+
+ consumer_key = ''
+ consumer_secret = ''
+ domain = ''
+ for option, arg in opts:
+ if option == '--consumer_key':
+ consumer_key = arg
+ elif option == '--consumer_secret':
+ consumer_secret = arg
+ elif option == '--domain':
+ domain = arg
+
+ if not (consumer_key and consumer_secret and domain):
+ print 'Requires exactly three flags.'
+ PrintUsageString()
+ sys.exit(1)
+
+ try:
+ email_monitoring = EmailMonitoring(
+ consumer_key, consumer_secret, domain)
+ email_monitoring.Run()
+ except gdata.apps.service.AppsForYourDomainException, e:
+ raise EmailMonitoringException('Invalid Domain')
+ except gdata.service.FetchingOAuthRequestTokenFailed, e:
+ raise EmailMonitoringException('Invalid consumer credentials')
+ except Exception, e:
+ if e.args[0].get('status') == 503:
+ raise EmailMonitoringException('Server busy')
+ elif e.args[0].get('status') == 500:
+ raise EmailMonitoringException('Internal server error')
+ else:
+ raise EmailMonitoringException('Unknown error')
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/email_settings_labels_filters.py b/samples/apps/email_settings_labels_filters.py
new file mode 100644
index 0000000..d06ebc3
--- /dev/null
+++ b/samples/apps/email_settings_labels_filters.py
@@ -0,0 +1,233 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample to demonstrate the Email Settings API's labels and filters creation.
+ The sample creates labels and filters corresponding to festivals,
+ which are some days ahead.
+"""
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+from datetime import date
+from datetime import datetime
+import getopt
+import random
+import sys
+import time
+import gdata.apps.client
+import gdata.apps.emailsettings.client
+
+
+SCOPES = ['https://apps-apis.google.com/a/feeds/emailsettings/2.0/',
+ 'https://apps-apis.google.com/a/feeds/user/']
+FESTIVALS_LIST = [
+ {
+ 'name': 'Christmas',
+ 'date': '25/12',
+ 'tags': ['Merry Christmas', 'Happy Christmas',
+ 'Happy X-mas', 'Merry X-mas']
+ },
+ {
+ 'name': 'Halloween',
+ 'date': '31/10',
+ 'tags': ['Happy Halloween', 'Trick or Treat', 'Guise']
+ },
+ {
+ 'name': 'Sankranti',
+ 'date': '14/01',
+ 'tags': ['Makar Sankranti', 'Happy Sankranti']
+ },
+ {
+ 'name': 'New Year',
+ 'date': '31/12',
+ 'tags': ['Happy New Year', 'New Year Best Wishes']
+ }]
+# Number of days left before a festival should be less than MAX_DAY_LEFT
+# to be considered for filter creation.
+MAX_DAYS_LEFT = 15
+# Maximum retries to be done for exponential back-off
+MAX_RETRIES = 6
+
+
+class FestivalSettingsException(Exception):
+ """Exception class for FestivalSettings to show appropriate error message."""
+
+ def __init__(self, message):
+ """Create new FestivalSettingsException with appropriate error message."""
+ super(FestivalSettingsException, self).__init__(message)
+
+
+class FestivalSettings(object):
+ """Sample demonstrating how to create filter and label for domain's user."""
+
+ def __init__(self, consumer_key, consumer_secret, domain):
+ """Create a new FestivalSettings object configured for a domain.
+
+ Args:
+ consumer_key: [string] The consumerKey of the domain.
+ consumer_secret: [string] The consumerSecret of the domain.
+ domain: [string] The domain whose user's POP settings to be changed.
+ """
+ self.consumer_key = consumer_key
+ self.consumer_secret = consumer_secret
+ self.domain = domain
+
+ def Authorize(self):
+ """Asks the domain's admin to authorize.
+
+ Access to the two APIs needs to be authorized,
+ provisioning users and Gmail settings.
+ The function creates clients for both APIs.
+ """
+ self.email_settings_client = (
+ gdata.apps.emailsettings.client.EmailSettingsClient(
+ domain=self.domain))
+ self.provisioning_client = gdata.apps.client.AppsClient(domain=self.domain)
+ request_token = self.email_settings_client.GetOAuthToken(
+ SCOPES, None, self.consumer_key, consumer_secret=self.consumer_secret)
+ print request_token.GenerateAuthorizationUrl()
+
+ raw_input('Manually go to the above URL and authenticate.'
+ 'Press Return after authorization.')
+ access_token = self.email_settings_client.GetAccessToken(request_token)
+ self.email_settings_client.auth_token = access_token
+ self.provisioning_client.auth_token = access_token
+
+ def _CreateLabelsFiltersForUser(self, username):
+ """Creates labels and filters for a domain's user.
+
+ Args:
+ username: [string] The user's username to create labels and filters for.
+ """
+ today = date.today()
+
+ for festival in FESTIVALS_LIST:
+ d = datetime.strptime(festival['date'], '%d/%m').date()
+ d = d.replace(year=today.year)
+ days_left = (d - today).days
+ d = d.replace(year=today.year+1)
+ days_left_next_year = (d - today).days
+ if ((0 <= days_left <= MAX_DAYS_LEFT) or
+ (0 <= days_left_next_year <= MAX_DAYS_LEFT)):
+ self._CreateFestivalSettingsForUser(username, festival, 1)
+
+ def _CreateFestivalSettingsForUser(self, username, festival, tries):
+ """Creates the festival wishes labels and filters for a domain's user.
+
+ Args:
+ username: [string] The user's username to create labels and filters for.
+ festival: [dictionary] The details for the festival.
+ tries: Number of times the operation has been retried.
+ """
+ label_name = festival['name'] + ' Wishes'
+ try:
+ self.email_settings_client.CreateLabel(username=username,
+ name=label_name)
+ for tag in festival['tags']:
+ self.email_settings_client.CreateFilter(username=username,
+ has_the_word=tag,
+ label=label_name)
+ except gdata.client.RequestError, e:
+ if e.status == 503 and tries < MAX_RETRIES:
+ time.sleep(2 ^ tries + random.randint(0, 10))
+ self._CreateFestivalSettingsForUser(username, festival, tries+1)
+
+ def Run(self):
+ """Handles the flow of the sample.
+ Asks application user for whom to create the festival wishes
+ labels and filters.
+ """
+ print 'Whom would you like to create labels for?'
+ print ('1 - For all user in the domain.'
+ '(WARNING: May take a long time depending on your domain size.)')
+ print '2 - Single user'
+
+ choice = raw_input('Enter your choice: ').strip()
+ if choice.isdigit():
+ choice = int(choice)
+
+ if choice == 1:
+ users = self.provisioning_client.RetrieveAllUsers()
+ for user in users.entry:
+ self._CreateLabelsFiltersForUser(user.login.user_name)
+ elif choice == 2:
+ username = raw_input('Enter a valid username: ')
+ self._CreateLabelsFiltersForUser(username)
+ else:
+ print 'Invalid choice'
+ return
+ print 'Labels and Filters created successfully'
+
+
+def PrintUsageString():
+ """Prints the correct call for running the sample."""
+ print ('python emailsettings_labels_filters.py'
+ '--consumer_key [ConsumerKey] --consumer_secret [ConsumerSecret]'
+ '--domain [domain]')
+
+
+def main():
+ """Runs the sample using an instance of FestivalSettings."""
+
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['consumer_key=',
+ 'consumer_secret=',
+ 'domain='])
+ except getopt.error, msg:
+ PrintUsageString()
+ sys.exit(1)
+
+ consumer_key = ''
+ consumer_secret = ''
+ domain = ''
+ for option, arg in opts:
+ if option == '--consumer_key':
+ consumer_key = arg
+ elif option == '--consumer_secret':
+ consumer_secret = arg
+ elif option == '--domain':
+ domain = arg
+
+ if not (consumer_key and consumer_secret and domain):
+ print 'Requires exactly three flags.'
+ PrintUsageString()
+ sys.exit(1)
+
+ festival_wishes_labels = FestivalSettings(
+ consumer_key, consumer_secret, domain)
+ try:
+ festival_wishes_labels.Authorize()
+ except gdata.client.RequestError, e:
+ if e.status == 400:
+ raise FestivalSettingsException('Invalid consumer credentials')
+ else:
+ raise FestivalSettingsException('Unknown server error')
+ sys.exit(1)
+
+ try:
+ festival_wishes_labels.Run()
+ except gdata.client.RequestError, e:
+ if e.status == 403:
+ raise FestivalSettingsException('Invalid Domain')
+ elif e.status == 400:
+ raise FestivalSettingsException('Invalid username')
+ else:
+ print e.reason
+ raise FestivalSettingsException('Unknown error')
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/emailsettings_example.py b/samples/apps/emailsettings_example.py
new file mode 100755
index 0000000..4c784ba
--- /dev/null
+++ b/samples/apps/emailsettings_example.py
@@ -0,0 +1,314 @@
+#!/usr/bin/python
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""A sample app for Google Apps Email Settings features.
+
+ EmailSettingsSample: demonstrates getting and setting/updating email settings
+"""
+
+__author__ = 'Prashant Tiwari <pti@google.com>'
+
+from optparse import OptionParser
+from gdata.apps.emailsettings.client import EmailSettingsClient
+
+#defaults for sendAs alias settings
+SEND_AS_NAME = 'test-alias'
+#update SEND_AS_ADDRESS to a valid account on your domain
+SEND_AS_ADDRESS = 'johndoe@domain.com'
+SEND_AS_REPLY_TO = 'replyto@example.com'
+SEND_AS_MAKE_DEFAULT = False
+
+#defaults for label settings
+LABEL_NAME = 'label'
+
+#defaults for forwarding settings
+#update FORWARD_TO to a valid account on your domain
+FORWARD_TO = 'account@domain.com'
+FORWARDING_ACTION = 'ARCHIVE'
+
+#defaults for pop settings
+POP_ENABLE_FOR = 'MAIL_FROM_NOW_ON'
+POP_ACTION = 'ARCHIVE'
+
+#defaults for signature settings
+SIGNATURE = "<Insert witty signature here>"
+
+#defaults for vacation settings
+VACATION_SUBJECT = "On vacation"
+VACATION_MESSAGE = "I'm on vacation, will respond when I return."
+VACATION_CONTACTS_ONLY = True
+
+#defaults for filter settings
+FILTER_FROM = 'me@domain.com'
+FILTER_TO = 'you@domain.com'
+FILTER_SUBJECT = 'subject'
+FILTER_HAS_THE_WORD = 'has'
+FILTER_DOES_NOT_HAVE_THE_WORD = 'no'
+FILTER_HAS_ATTACHMENT = True
+FILTER_SHOULD_MARK_AS_READ = True
+FILTER_SHOULD_ARCHIVE = True
+FILTER_LABEL = 'label'
+
+#defaults for general settings
+GENERAL_PAGE_SIZE = '50'
+GENERAL_ENABLE_SHORTCUTS = True
+GENERAL_ENABLE_ARROWS = True
+GENERAL_ENABLE_SNIPPETS = True
+GENERAL_ENABLE_UNICODE = True
+
+#defaults for language settings
+LANGUAGE = 'en-US'
+
+parser = None
+options = None
+
+class EmailSettingsSample(object):
+ """EmailsSettingsSample object demos the Email Settings API."""
+
+ def __init__(self, domain, email, password, app):
+ """Constructor for the EmailSettingsSample object.
+
+ Takes an email, password and an app id corresponding to a google apps admin
+ account to demo the Email Settings API.
+
+ Args:
+ domain: [string] The domain name (e.g. domain.com)
+ email: [string] The e-mail address of a domain admin account.
+ password: [string] The domain admin's password.
+ app: [string] The app name of the form
+ companyName-applicationName-versionID
+ """
+ self.client = EmailSettingsClient(domain=domain)
+ self.client.ClientLogin(email=email, password=password,
+ source=app)
+
+ def run(self, username, setting, method, args):
+ """Method that invokes the EmailSettingsClient services
+
+ Args:
+ username: [string] The name of the account for whom to get/set settings
+ setting: [string] The email setting to be got/set/updated
+ method: [string] Specifies the get or set method
+ """
+ if setting == 'label':
+ if method == 'get':
+ print "getting labels for %s...\n" % (username)
+ print self.client.RetrieveLabels(username=username)
+ elif method == 'set':
+ print "creating label for %s...\n" % (username)
+ print self.client.CreateLabel(username=username, name=LABEL_NAME)
+ else:
+ print "deleting labels isn't supported"
+ elif setting == 'forwarding':
+ if method == 'get':
+ print "getting forwarding for %s...\n" % (username)
+ print self.client.RetrieveForwarding(username)
+ elif method == 'set':
+ print "updating forwarding settings for %s...\n" % (username)
+ print self.client.UpdateForwarding(username=username,
+ enable=not(options.disable),
+ forward_to=FORWARD_TO,
+ action=FORWARDING_ACTION)
+ else:
+ print "deleting forwarding settings isn't supported"
+ elif setting == 'sendas':
+ if method == 'get':
+ print "getting sendAs alias for %s...\n" % (username)
+ print self.client.RetrieveSendAs(username=username)
+ elif method == 'set':
+ print "creating sendAs alias for %s...\n" % (username)
+ print self.client.CreateSendAs(username=username, name=SEND_AS_NAME,
+ address=SEND_AS_ADDRESS,
+ reply_to=SEND_AS_REPLY_TO,
+ make_default=SEND_AS_MAKE_DEFAULT)
+ else:
+ print "deleting send-as settings isn't supported"
+ elif setting == 'pop':
+ if method == 'get':
+ print "getting pop settings for %s...\n" % (username)
+ print self.client.RetrievePop(username=username)
+ elif method == 'set':
+ print "updating pop settings for %s...\n" % (username)
+ print self.client.UpdatePop(username=username,
+ enable=not(options.disable),
+ enable_for=POP_ENABLE_FOR,
+ action=POP_ACTION)
+ else:
+ print "deleting pop settings isn't supported"
+ elif setting == 'signature':
+ if method == 'get':
+ print "getting signature for %s...\n" % (username)
+ print self.client.RetrieveSignature(username=username)
+ elif method == 'set':
+ print "updating signature for %s...\n" % (username)
+ print self.client.UpdateSignature(username=username,
+ signature=SIGNATURE)
+ else:
+ print "deleting signature settings isn't supported"
+ elif setting == 'vacation':
+ if method == 'get':
+ print "getting vacation settings for %s...\n" % (username)
+ print self.client.RetrieveVacation(username=username)
+ elif method == 'set':
+ print "updating vacation settings for %s...\n" % (username)
+ print self.client.UpdateVacation(username=username,
+ enable=not(options.disable),
+ subject=VACATION_SUBJECT,
+ message=VACATION_MESSAGE,
+ contacts_only=VACATION_CONTACTS_ONLY)
+ else:
+ print "deleting vacation settings isn't supported"
+ elif setting == 'imap':
+ if method == 'get':
+ print "getting imap settings for %s...\n" % (username)
+ print self.client.RetrieveImap(username)
+ elif setting == 'set':
+ print "updating imap settings for %s...\n" % (username)
+ print self.client.UpdateImap(username=username,
+ enable=not(options.disable))
+ else:
+ print "deleting imap settings isn't supported"
+ elif setting == 'filter':
+ if method == 'get':
+ print "getting email filters is not yet possible\n"
+ parser.print_help()
+ elif method == 'set':
+ print "creating an email filter for %s...\n" % (username)
+ print self.client.CreateFilter(username=username,
+ from_address=FILTER_FROM,
+ to_address=FILTER_TO,
+ subject=FILTER_SUBJECT,
+ has_the_word=FILTER_HAS_THE_WORD,
+ does_not_have_the_word=
+ FILTER_DOES_NOT_HAVE_THE_WORD,
+ has_attachments=FILTER_HAS_ATTACHMENT,
+ label=FILTER_LABEL,
+ mark_as_read=FILTER_SHOULD_MARK_AS_READ,
+ archive=FILTER_SHOULD_ARCHIVE)
+ else:
+ print "deleting filters isn't supported"
+ elif setting == 'general':
+ if method == 'get':
+ print "getting general email settings is not yet possible\n"
+ parser.print_help()
+ elif method == 'set':
+ print "updating general settings for %s...\n" % (username)
+ print self.client.UpdateGeneralSettings(username=username,
+ page_size=GENERAL_PAGE_SIZE,
+ shortcuts=
+ GENERAL_ENABLE_SHORTCUTS,
+ arrows=
+ GENERAL_ENABLE_ARROWS,
+ snippets=
+ GENERAL_ENABLE_SNIPPETS,
+ use_unicode=
+ GENERAL_ENABLE_UNICODE)
+ else:
+ print "deleting general settings isn't supported"
+ elif setting == 'language':
+ if method == 'get':
+ print "getting language settings is not yet possible\n"
+ parser.print_help()
+ elif method == 'set':
+ print "updating language for %s...\n" % (username)
+ print self.client.UpdateLanguage(username=username, language=LANGUAGE)
+ else:
+ print "deleting language settings isn't supported"
+ elif setting == 'webclip':
+ if method == 'get':
+ print "getting webclip settings is not yet possible\n"
+ parser.print_help()
+ elif method == 'get':
+ print "updating webclip settings for %s...\n" % (username)
+ print self.client.UpdateWebclip(username=username,
+ enable=not(options.disable))
+ else:
+ print "deleting webclip settings isn't supported"
+ elif setting == 'delegation':
+ if method == 'get':
+ print "getting email delegates for %s..." % (username)
+ print self.client.RetrieveEmailDelegates(username=username)
+ elif method == 'set':
+ address = args['delegationId']
+ print "adding %s as an email delegate to %s..." % (address, username)
+ print self.client.AddEmailDelegate(username=username, address=address)
+ else:
+ address = args['delegationId']
+ print "deleting %s as an email delegate for %s..." % (address, username)
+ print self.client.DeleteEmailDelegate(username=username,
+ address=address)
+ else:
+ parser.print_help()
+
+
+def main():
+ """Demos the Email Settings API using the EmailSettingsSample object."""
+
+ usage = 'usage: %prog [options]'
+ global parser
+ global options
+ parser = OptionParser(usage=usage)
+ parser.add_option('--domain',
+ help="The Google Apps domain, e.g. 'domain.com'.")
+ parser.add_option('--email',
+ help="The admin's email account, e.g. 'admin@domain.com'.")
+ parser.add_option('--password',
+ help="The admin's password.")
+ parser.add_option('--app',
+ help="The name of the app.")
+ parser.add_option('--username',
+ help="The user account on which to perform operations.")
+ parser.add_option('--setting',
+ choices=['filter', 'label', 'forwarding', 'sendas', 'pop',
+ 'signature', 'vacation', 'imap', 'general',
+ 'language', 'webclip', 'delegation'],
+ help="The email setting to use. Choose from filter, label, \
+ forwarding, sendas, pop, signature, vacation, imap, \
+ general, language, webclip, and delegation.")
+ parser.add_option('--method',
+ default='get',
+ choices=['get', 'set', 'delete'],
+ help="Specify whether to get, set/update or delete \
+ setting. Choose between get (default), set, and delete.")
+ parser.add_option('--disable',
+ action="store_true",
+ default=False,
+ dest="disable",
+ help="Disable a setting when using the set method with the\
+ --disable option. The default is to enable the setting.")
+ parser.add_option('--delegationId',
+ default=None,
+ help="The emailId of the account to which email access has\
+ to be delegated. Required for adding or deleting an \
+ email delegate.")
+ (options, args) = parser.parse_args()
+
+ if (options.domain is None or options.email is None or options.password ==
+ None or options.username is None or options.app is None or
+ options.setting is None or (options.setting == 'delegation' and
+ options.method != 'get' and
+ options.delegationId is None)):
+ parser.print_help()
+ return
+
+ args = {'delegationId':options.delegationId}
+
+ sample = EmailSettingsSample(options.domain, options.email, options.password,
+ options.app)
+ sample.run(options.username, options.setting, options.method, args)
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/emailsettings_pop_settings.py b/samples/apps/emailsettings_pop_settings.py
new file mode 100644
index 0000000..c03474b
--- /dev/null
+++ b/samples/apps/emailsettings_pop_settings.py
@@ -0,0 +1,141 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Demonstrates Email Settings API's POP settings.
+ Enables POP for all of the domain's users for all messages and
+ archives Gmail's copy.
+"""
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+import getopt
+import sys
+import gdata.apps.client
+import gdata.apps.emailsettings.client
+
+
+SCOPES = ['https://apps-apis.google.com/a/feeds/emailsettings/2.0/',
+ 'https://apps-apis.google.com/a/feeds/user/']
+
+
+class PopSettingsException(Exception):
+ """Exception class for PopSettings to show appropriate error message."""
+
+ def __init__(self, message):
+ """Create a new PopSettingsException with the appropriate error message."""
+ super(PopSettingsException, self).__init__(message)
+
+
+class PopSettings(object):
+ """Sample demonstrating how to enable POP for all of a domain's users."""
+
+ def __init__(self, consumer_key, consumer_secret, domain):
+ """Create a new PopSettings object configured for a domain.
+
+ Args:
+ consumer_key: [string] The consumerKey of the domain.
+ consumer_secret: [string] The consumerSecret of the domain.
+ domain: [string] The domain whose user's POP settings to be changed.
+ """
+ self.consumer_key = consumer_key
+ self.consumer_secret = consumer_secret
+ self.domain = domain
+
+ def Authorize(self):
+ """Asks the domain's admin to authorize.
+
+ Access to two APIs needs to be authorized,
+ provisioning users and Gmail settings.
+ The function creates clients for both APIs.
+ """
+ self.email_settings_client = (
+ gdata.apps.emailsettings.client.EmailSettingsClient(
+ domain=self.domain))
+ self.provisioning_client = gdata.apps.client.AppsClient(domain=self.domain)
+ request_token = self.email_settings_client.GetOAuthToken(
+ SCOPES, None, self.consumer_key, consumer_secret=self.consumer_secret)
+ print request_token.GenerateAuthorizationUrl()
+ raw_input('Manually go to the above URL and authenticate.'
+ 'Press Return after authorization.')
+ access_token = self.email_settings_client.GetAccessToken(request_token)
+ self.email_settings_client.auth_token = access_token
+ self.provisioning_client.auth_token = access_token
+
+ def UpdateDomainUsersPopSettings(self):
+ """Updates POP settings for all of the domain's users."""
+ users = self.provisioning_client.RetrieveAllUsers()
+ for user in users.entry:
+ self.email_settings_client.UpdatePop(username=user.login.user_name,
+ enable=True,
+ enable_for='ALL_MAIL',
+ action='ARCHIVE')
+
+
+def PrintUsageString():
+ """Prints the correct call for running the sample."""
+ print ('python emailsettings_pop_settings.py'
+ '--consumer_key [ConsumerKey] --consumer_secret [ConsumerSecret]'
+ '--domain [domain]')
+
+
+def main():
+ """Updates POP settings for all of the domain's users
+ using the Email Settings API.
+ """
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['consumer_key=',
+ 'consumer_secret=',
+ 'domain='])
+ except getopt.error, msg:
+ PrintUsageString()
+ sys.exit(1)
+
+ consumer_key = ''
+ consumer_secret = ''
+ domain = ''
+ for option, arg in opts:
+ if option == '--consumer_key':
+ consumer_key = arg
+ elif option == '--consumer_secret':
+ consumer_secret = arg
+ elif option == '--domain':
+ domain = arg
+
+ if not (consumer_key and consumer_secret and domain):
+ print 'Requires exactly three flags.'
+ PrintUsageString()
+ sys.exit(1)
+
+ pop_settings = PopSettings(
+ consumer_key, consumer_secret, domain)
+ try:
+ pop_settings.Authorize()
+ pop_settings.UpdateDomainUsersPopSettings()
+ except gdata.client.RequestError, e:
+ if e.status == 403:
+ raise PopSettingsException('Invalid Domain')
+ elif e.status == 400:
+ raise PopSettingsException('Invalid consumer credentials')
+ elif e.status == 503:
+ raise PopSettingsException('Server busy')
+ else e.status == 500:
+ raise PopSettingsException('Internal server error')
+ else:
+ raise PopSettingsException('Unknown error')
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/groups_provisioning_quick_start_example.py b/samples/apps/groups_provisioning_quick_start_example.py
new file mode 100644
index 0000000..9a88123
--- /dev/null
+++ b/samples/apps/groups_provisioning_quick_start_example.py
@@ -0,0 +1,305 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+import getopt
+import sys
+import gdata.apps.groups.client
+import gdata.apps.groups.data
+
+SCOPE = 'https://apps-apis.google.com/a/feeds/groups/'
+USER_AGENT = 'GroupsQuickStartExample'
+
+
+class GroupsQuickStartExample(object):
+ """Demonstrates all the functions of Groups provisioning."""
+
+ def __init__(self, client_id, client_secret, domain):
+ """Constructor for the GroupsQuickStartExample object.
+
+ Takes a client_id, client_secret and domain needed to create an object for
+ groups provisioning.
+
+ Args:
+ client_id: [string] The clientId of the developer.
+ client_secret: [string] The clientSecret of the developer.
+ domain: [string] The domain on which the functions are to be performed.
+ """
+ self.client_id = client_id
+ self.client_secret = client_secret
+ self.domain = domain
+
+ def CreateGroupsClient(self):
+ """Creates a groups provisioning client using OAuth2.0 flow."""
+ token = gdata.gauth.OAuth2Token(
+ client_id=self.client_id, client_secret=self.client_secret,
+ scope=SCOPE, user_agent=USER_AGENT)
+ uri = token.generate_authorize_url()
+ print 'Please visit this URL to authorize the application:'
+ print uri
+ # Get the verification code from the standard input.
+ code = raw_input('What is the verification code? ').strip()
+ token.get_access_token(code)
+ self.groups_client = gdata.apps.groups.client.GroupsProvisioningClient(
+ domain=self.domain, auth_token=token)
+
+ def _GetValidGroupId(self):
+ """Takes a valid group email address as input.
+
+ Return:
+ group_id: [string] a valid group email address
+ """
+ group_id = ''
+ while not group_id:
+ group_id = raw_input('Enter a valid group email address'
+ '(group@domain.com): ')
+ return group_id
+
+ def _GetValidMemberId(self):
+ """Takes a valid member email address as input.
+
+ Return:
+ member_id: [string] a valid member email address
+ """
+ member_id = ''
+ while not member_id:
+ member_id = raw_input('Enter a valid member email address'
+ '(username@domain.com): ')
+ return member_id
+
+ def _PrintGroupDetails(self, group_entry):
+ """Print all the details of a group.
+
+ Args:
+ group_entry: [GroupEntry] contains all the data about the group.
+ """
+ print 'Group ID: ' + group_entry.group_id
+ print 'Group Name: ' + group_entry.group_name
+ print 'Description: ' + group_entry.description
+ print 'Email Permissions: ' + group_entry.email_permission
+ print ''
+
+ def _PrintMemberDetails(self, member_entry):
+ """Print all the details of a group member.
+
+ Args:
+ member_entry: [GroupMemberEntry] contains all the data about the group member.
+ """
+ print 'Member ID: ' + member_entry.member_id
+ print 'Member Type: ' + member_entry.member_type
+ print 'Is Direct Member: ' + member_entry.direct_member
+ print ''
+
+ def _TakeGroupData(self, function='create'):
+ """Takes input data for _UpdateGroup and _CreateGroup functions.
+
+ Args:
+ function: [string] representing the kind of function (create/update)
+ from where this function was called.
+
+ Return:
+ group_data: [gdata.apps.groups.data.GroupEntry] All data for a group.
+ """
+ email_permission_options = ['Owner', 'Member', 'Domain', 'Anyone']
+ extra_stmt = ''
+ if function == 'update':
+ extra_stmt = '. Press enter to not update the field'
+ group_data = gdata.apps.groups.data.GroupEntry()
+ group_data.group_id = self._GetValidGroupId()
+ while not group_data.group_name:
+ group_data.group_name = raw_input('Enter name for the group%s: '
+ % extra_stmt)
+ if function == 'update':
+ break
+ group_data.description = raw_input('Enter description for the group%s: '
+ % extra_stmt)
+
+ print ('Choose an option for email permission%s:'
+ % extra_stmt)
+ i = 1
+ for option in email_permission_options:
+ print '%d - %s' % (i, option)
+ i += 1
+ choice = (raw_input())
+ if not choice:
+ choice = -1
+ choice = int(choice)
+ if choice > 0 and choice <= len(email_permission_options):
+ group_data.email_permission = email_permission_options[choice-1]
+
+ return group_data
+
+ def _CreateGroup(self):
+ """Creates a new group."""
+ group_data = self._TakeGroupData()
+ self.groups_client.CreateGroup(group_data.group_id,
+ group_data.group_name,
+ group_data.description,
+ group_data.email_permission)
+
+ def _UpdateGroup(self):
+ """Updates an existing group."""
+ group_data = self._TakeGroupData(function='update')
+ group_entry = self.groups_client.RetrieveGroup(group_data.group_id)
+ if group_data.group_name:
+ group_entry.group_name = group_data.group_name
+ if group_data.description:
+ group_entry.description = group_data.description
+ if group_data.email_permission:
+ group_entry.email_permission = group_data.email_permission
+
+ self.groups_client.UpdateGroup(group_data.GetGroupId(), group_entry)
+
+ def _RetrieveSingleGroup(self):
+ """Retrieves a single group."""
+ group_id = self._GetValidGroupId()
+ group_entry = self.groups_client.RetrieveGroup(group_id)
+ self._PrintGroupDetails(group_entry)
+
+ def _RetrieveAllGroupsForMember(self):
+ """Retrieves all the groups the user is a member of."""
+ member_id = self._GetValidMemberId()
+ direct_only = raw_input('Write true/false for direct_only: ')
+ if direct_only == 'true':
+ direct_only = True
+ else:
+ direct_only = False
+ groups_feed = self.groups_client.RetrieveGroups(member_id, direct_only)
+ for entry in groups_feed.entry:
+ self._PrintGroupDetails(entry)
+
+ def _RetrieveAllGroups(self):
+ """Retrieves all the groups in a domain."""
+ groups_feed = self.groups_client.RetrieveAllGroups()
+ for entry in groups_feed.entry:
+ self._PrintGroupDetails(entry)
+
+ def _DeleteGroup(self):
+ """Delete a group."""
+ group_id = self._GetValidGroupId()
+ self.groups_client.DeleteGroup(group_id)
+
+ def _AddMemberToGroup(self):
+ """Add a member to a particular group."""
+ group_id = self._GetValidGroupId()
+ member_id = self._GetValidMemberId()
+ self.groups_client.AddMemberToGroup(group_id, member_id)
+
+ def _RetrieveSingleMember(self):
+ """Retrieve a single member from a group."""
+ group_id = self._GetValidGroupId()
+ member_id = self._GetValidMemberId()
+ member_entry = self.groups_client.RetrieveGroupMember(group_id, member_id)
+ self._PrintMemberDetails(member_entry)
+
+ def _RetrieveAllMembersOfGroup(self):
+ """Retrieve all the members of a group."""
+ group_id = self._GetValidGroupId()
+ members_feed = self.groups_client.RetrieveAllMembers(group_id)
+ for entry in members_feed.entry:
+ self._PrintMemberDetails(entry)
+
+ def _RemoveMemberFromGroup(self):
+ """Remove a member from a group."""
+ group_id = self._GetValidGroupId()
+ member_id = self._GetValidMemberId()
+ self.groups_client.RemoveMemberFromGroup(group_id, member_id)
+
+ def Run(self):
+ """Runs the sample by getting user input and takin appropriate action."""
+ #List of all the function and there description
+ functions_list = [
+ {'function': self._CreateGroup,
+ 'description': 'Create a Group'},
+ {'function': self._UpdateGroup,
+ 'description': 'Updating a Group'},
+ {'function': self._RetrieveSingleGroup,
+ 'description': 'Retrieve a single Group'},
+ {'function': self._RetrieveAllGroupsForMember,
+ 'description': 'Retrieve all Groups for a member'},
+ {'function': self._RetrieveAllGroups,
+ 'description': 'Retrieve all Groups in a domain'},
+ {'function': self._DeleteGroup,
+ 'description': 'Deleting a Group from a domain'},
+ {'function': self._AddMemberToGroup,
+ 'description': 'Add a member to a Group'},
+ {'function': self._RetrieveSingleMember,
+ 'description': 'Retrieve a member of a group'},
+ {'function': self._RetrieveAllMembersOfGroup,
+ 'description': 'Retrieve all members of a group'},
+ {'function': self._RemoveMemberFromGroup,
+ 'description': 'Delete a member from a Group'}
+ ]
+
+ while True:
+ print 'Choose an option:\n0 - to exit'
+ for i in range (0, len(functions_list)):
+ print '%d - %s' % ((i+1), functions_list[i]['description'])
+ choice = int(raw_input())
+ if choice == 0:
+ break
+ if choice < 0 or choice > len(functions_list):
+ print 'Not a valid option!'
+ continue
+ functions_list[choice-1]['function']()
+
+
+def main():
+ """Runs the sample using an instance of GroupsQuickStartExample."""
+ # Parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['client_id=',
+ 'client_secret=',
+ 'domain='])
+ except getopt.error, msg:
+ print ('python groups_provisioning_quick_start_example.py'
+ ' --client_id [clientId] --client_secret [clientSecret]'
+ ' --domain [domain]')
+ sys.exit(2)
+
+ client_id = ''
+ client_secret = ''
+ domain = ''
+ # Parse options
+ for option, arg in opts:
+ if option == '--client_id':
+ client_id = arg
+ elif option == '--client_secret':
+ client_secret = arg
+ elif option == '--domain':
+ domain = arg
+
+ while not client_id:
+ client_id = raw_input('Please enter a clientId: ')
+ while not client_secret:
+ client_secret = raw_input('Please enter a clientSecret: ')
+ while not domain:
+ domain = raw_input('Please enter domain name (example.com): ')
+
+ try:
+ groups_quick_start_example = GroupsQuickStartExample(
+ client_id, client_secret, domain)
+ except gdata.service.BadAuthentication:
+ print 'Invalid user credentials given.'
+ return
+
+ groups_quick_start_example.CreateGroupsClient()
+ groups_quick_start_example.Run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/list_group_members.py b/samples/apps/list_group_members.py
new file mode 100644
index 0000000..cd99a66
--- /dev/null
+++ b/samples/apps/list_group_members.py
@@ -0,0 +1,115 @@
+#!/usr/bin/python
+#
+# Copyright 2012 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample to list all the members of a group.
+
+The sample demonstrates how to get all members from a group (say Group1)
+including members from groups that are members of Group1. It recursively finds
+the members of groups that are the member of given group and lists them.
+"""
+
+__author__ = 'Shraddha Gupta <shraddhag@google.com>'
+
+from optparse import OptionParser
+import gdata.apps.groups.client
+
+
+SCOPE = 'https://apps-apis.google.com/a/feeds/groups/'
+USER_AGENT = 'ListUserMembersFromGroup'
+
+
+def GetAuthToken(client_id, client_secret):
+ """Get an OAuth 2.0 access token using the given client_id and client_secret.
+
+ Client_id and client_secret can be found on the API Access tab on the
+ Google APIs Console <http://code.google.com/apis/console>.
+
+ Args:
+ client_id: String, client id of the developer.
+ client_secret: String, client secret of the developer.
+
+ Returns:
+ token: String, authorized OAuth 2.0 token.
+ """
+ token = gdata.gauth.OAuth2Token(
+ client_id=client_id, client_secret=client_secret,
+ scope=SCOPE, user_agent=USER_AGENT)
+ uri = token.generate_authorize_url()
+ print 'Please visit this URL to authorize the application:'
+ print uri
+ # Get the verification code from the standard input.
+ code = raw_input('What is the verification code? ').strip()
+ token.get_access_token(code)
+ return token
+
+
+def ListAllMembers(group_client, group_id):
+ """Lists all members including members of sub-groups.
+
+ Args:
+ group_client: gdata.apps.groups.client.GroupsProvisioningClient instance.
+ group_id: String, identifier of the group from which members are listed.
+
+ Returns:
+ members_list: List containing the member_id of group members.
+ """
+ members_list = []
+ try:
+ group_members = group_client.RetrieveAllMembers(group_id)
+ for member in group_members.entry:
+ if member.member_type == 'Group':
+ temp_list = ListAllMembers(group_client, member.member_id)
+ members_list.extend(temp_list)
+ else:
+ members_list.append(member.member_id)
+ except gdata.client.RequestError, e:
+ print 'Request error: %s %s %s' % (e.status, e.reason, e.body)
+ return members_list
+
+
+def main():
+ """Demonstrates retrieval of members of a group."""
+ usage = ('Usage: %prog --DOMAIN <domain> --CLIENT_ID <client_id> '
+ '--CLIENT_SECRET <client_secret> --GROUP_ID <group_id> ')
+ parser = OptionParser(usage=usage)
+ parser.add_option('--DOMAIN',
+ help='Google Apps Domain, e.g. "domain.com".')
+ parser.add_option('--CLIENT_ID',
+ help='Registered CLIENT_ID of Domain.')
+ parser.add_option('--CLIENT_SECRET',
+ help='Registered CLIENT_SECRET of Domain.')
+ parser.add_option('--GROUP_ID',
+ help='Group identifier of the group to list members from.')
+ (options, args) = parser.parse_args()
+
+ if not (options.DOMAIN and options.CLIENT_ID and options.CLIENT_SECRET
+ and options.GROUP_ID):
+ parser.print_help()
+ return
+
+ group_client = gdata.apps.groups.client.GroupsProvisioningClient(
+ domain=options.DOMAIN)
+ token = GetAuthToken(options.CLIENT_ID, options.CLIENT_SECRET)
+ token.authorize(group_client)
+
+ members_list = ListAllMembers(group_client, options.GROUP_ID)
+ no_duplicate_members_list = list(set(members_list))
+ print 'User members of the group %s are: ' % options.GROUP_ID
+ print no_duplicate_members_list
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/marketplace_sample/app.yaml b/samples/apps/marketplace_sample/app.yaml
new file mode 100644
index 0000000..bcf3810
--- /dev/null
+++ b/samples/apps/marketplace_sample/app.yaml
@@ -0,0 +1,21 @@
+application: domain-mgmt
+version: 1
+runtime: python
+api_version: 1
+
+handlers:
+- url: /css
+ static_dir: css
+
+- url: /js
+ static_dir: js
+
+- url: /images
+ static_dir: images
+
+- url: /_ah/login_required
+ script: domain_mgmt_app.py
+
+- url: .*
+ script: domain_mgmt_app.py
+ login: required
diff --git a/samples/apps/marketplace_sample/appengine_utilities/__init__.py b/samples/apps/marketplace_sample/appengine_utilities/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/__init__.py
diff --git a/samples/apps/marketplace_sample/appengine_utilities/cache.py b/samples/apps/marketplace_sample/appengine_utilities/cache.py
new file mode 100644
index 0000000..4172711
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/cache.py
@@ -0,0 +1,363 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+# main python imports
+import datetime
+import pickle
+import random
+import sys
+
+# google appengine import
+from google.appengine.ext import db
+from google.appengine.api import memcache
+
+# settings
+try:
+ import settings_default
+ import settings
+
+ if settings.__name__.rsplit('.', 1)[0] != settings_default.__name__.rsplit('.', 1)[0]:
+ settings = settings_default
+except:
+ settings = settings_default
+
+class _AppEngineUtilities_Cache(db.Model):
+ cachekey = db.StringProperty()
+ createTime = db.DateTimeProperty(auto_now_add=True)
+ timeout = db.DateTimeProperty()
+ value = db.BlobProperty()
+
+
+class Cache(object):
+ """
+ Cache is used for storing pregenerated output and/or objects in the Big
+ Table datastore to minimize the amount of queries needed for page
+ displays. The idea is that complex queries that generate the same
+ results really should only be run once. Cache can be used to store
+ pregenerated value made from queries (or other calls such as
+ urlFetch()), or the query objects themselves.
+
+ Cache is a standard dictionary object and can be used as such. It attesmpts
+ to store data in both memcache, and the datastore. However, should a
+ datastore write fail, it will not try again. This is for performance
+ reasons.
+ """
+
+ def __init__(self, clean_check_percent = settings.cache["CLEAN_CHECK_PERCENT"],
+ max_hits_to_clean = settings.cache["MAX_HITS_TO_CLEAN"],
+ default_timeout = settings.cache["DEFAULT_TIMEOUT"]):
+ """
+ Initializer
+
+ Args:
+ clean_check_percent: how often cache initialization should
+ run the cache cleanup
+ max_hits_to_clean: maximum number of stale hits to clean
+ default_timeout: default length a cache item is good for
+ """
+ self.clean_check_percent = clean_check_percent
+ self.max_hits_to_clean = max_hits_to_clean
+ self.default_timeout = default_timeout
+
+ if random.randint(1, 100) < self.clean_check_percent:
+ try:
+ self._clean_cache()
+ except:
+ pass
+
+ if 'AEU_Events' in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event('cacheInitialized')
+
+ def _clean_cache(self):
+ """
+ _clean_cache is a routine that is run to find and delete cache
+ items that are old. This helps keep the size of your over all
+ datastore down.
+
+ It only deletes the max_hits_to_clean per attempt, in order
+ to maximize performance. Default settings are 20 hits, 50%
+ of requests. Generally less hits cleaned on more requests will
+ give you better performance.
+
+ Returns True on completion
+ """
+ query = _AppEngineUtilities_Cache.all()
+ query.filter('timeout < ', datetime.datetime.now())
+ results = query.fetch(self.max_hits_to_clean)
+ db.delete(results)
+
+ return True
+
+ def _validate_key(self, key):
+ """
+ Internal method for key validation. This can be used by a superclass
+ to introduce more checks on key names.
+
+ Args:
+ key: Key name to check
+
+ Returns True is key is valid, otherwise raises KeyError.
+ """
+ if key == None:
+ raise KeyError
+ return True
+
+ def _validate_value(self, value):
+ """
+ Internal method for value validation. This can be used by a superclass
+ to introduce more checks on key names.
+
+ Args:
+ value: value to check
+
+ Returns True is value is valid, otherwise raises ValueError.
+ """
+ if value == None:
+ raise ValueError
+ return True
+
+ def _validate_timeout(self, timeout):
+ """
+ Internal method to validate timeouts. If no timeout
+ is passed, then the default_timeout is used.
+
+ Args:
+ timeout: datetime.datetime format
+
+ Returns the timeout
+ """
+ if timeout == None:
+ timeout = datetime.datetime.now() +\
+ datetime.timedelta(seconds=self.default_timeout)
+ if type(timeout) == type(1):
+ timeout = datetime.datetime.now() + \
+ datetime.timedelta(seconds = timeout)
+ if type(timeout) != datetime.datetime:
+ raise TypeError
+ if timeout < datetime.datetime.now():
+ raise ValueError
+
+ return timeout
+
+ def add(self, key = None, value = None, timeout = None):
+ """
+ Adds an entry to the cache, if one does not already exist. If they key
+ already exists, KeyError will be raised.
+
+ Args:
+ key: Key name of the cache object
+ value: Value of the cache object
+ timeout: timeout value for the cache object.
+
+ Returns the cache object.
+ """
+ self._validate_key(key)
+ self._validate_value(value)
+ timeout = self._validate_timeout(timeout)
+
+ if key in self:
+ raise KeyError
+
+ cacheEntry = _AppEngineUtilities_Cache()
+ cacheEntry.cachekey = key
+ cacheEntry.value = pickle.dumps(value)
+ cacheEntry.timeout = timeout
+
+ # try to put the entry, if it fails silently pass
+ # failures may happen due to timeouts, the datastore being read
+ # only for maintenance or other applications. However, cache
+ # not being able to write to the datastore should not
+ # break the application
+ try:
+ cacheEntry.put()
+ except:
+ pass
+
+ memcache_timeout = timeout - datetime.datetime.now()
+ memcache.set('cache-%s' % (key), value, int(memcache_timeout.seconds))
+
+ if 'AEU_Events' in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event('cacheAdded')
+
+ return self.get(key)
+
+ def set(self, key = None, value = None, timeout = None):
+ """
+ Sets an entry to the cache, overwriting an existing value
+ if one already exists.
+
+ Args:
+ key: Key name of the cache object
+ value: Value of the cache object
+ timeout: timeout value for the cache object.
+
+ Returns the cache object.
+ """
+ self._validate_key(key)
+ self._validate_value(value)
+ timeout = self._validate_timeout(timeout)
+
+ cacheEntry = self._read(key)
+ if not cacheEntry:
+ cacheEntry = _AppEngineUtilities_Cache()
+ cacheEntry.cachekey = key
+ cacheEntry.value = pickle.dumps(value)
+ cacheEntry.timeout = timeout
+
+ try:
+ cacheEntry.put()
+ except:
+ pass
+
+ memcache_timeout = timeout - datetime.datetime.now()
+ memcache.set('cache-%s' % (key), value, int(memcache_timeout.seconds))
+
+ if 'AEU_Events' in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event('cacheSet')
+
+ return value
+
+ def _read(self, key = None):
+ """
+ _read is an internal method that will get the cache entry directly
+ from the datastore, and return the entity. This is used for datastore
+ maintenance within the class.
+
+ Args:
+ key: The key to retrieve
+
+ Returns the cache entity
+ """
+ query = _AppEngineUtilities_Cache.all()
+ query.filter('cachekey', key)
+ query.filter('timeout > ', datetime.datetime.now())
+ results = query.fetch(1)
+ if len(results) is 0:
+ return None
+
+ if 'AEU_Events' in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event('cacheReadFromDatastore')
+ if 'AEU_Events' in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event('cacheRead')
+
+ return results[0]
+
+ def delete(self, key = None):
+ """
+ Deletes a cache object.
+
+ Args:
+ key: The key of the cache object to delete.
+
+ Returns True.
+ """
+ memcache.delete('cache-%s' % (key))
+ result = self._read(key)
+ if result:
+ if 'AEU_Events' in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event('cacheDeleted')
+ result.delete()
+ return True
+
+ def get(self, key):
+ """
+ Used to return the cache value associated with the key passed.
+
+ Args:
+ key: The key of the value to retrieve.
+
+ Returns the value of the cache item.
+ """
+ mc = memcache.get('cache-%s' % (key))
+ if mc:
+ if 'AEU_Events' in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event('cacheReadFromMemcache')
+ if 'AEU_Events' in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event('cacheRead')
+ return mc
+ result = self._read(key)
+ if result:
+ timeout = result.timeout - datetime.datetime.now()
+ memcache.set('cache-%s' % (key), pickle.loads(result.value),
+ int(timeout.seconds))
+ if 'AEU_Events' in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event('cacheRead')
+ return pickle.loads(result.value)
+ else:
+ raise KeyError
+
+ def get_many(self, keys):
+ """
+ Returns a dict mapping each key in keys to its value. If the given
+ key is missing, it will be missing from the response dict.
+
+ Args:
+ keys: A list of keys to retrieve.
+
+ Returns a dictionary of key/value pairs.
+ """
+ dict = {}
+ for key in keys:
+ value = self.get(key)
+ if value is not None:
+ dict[key] = value
+ return dict
+
+ def __getitem__(self, key):
+ """
+ __getitem__ is necessary for this object to emulate a container.
+ """
+ return self.get(key)
+
+ def __setitem__(self, key, value):
+ """
+ __setitem__ is necessary for this object to emulate a container.
+ """
+ return self.set(key, value)
+
+ def __delitem__(self, key):
+ """
+ Implement the 'del' keyword
+ """
+ return self.delete(key)
+
+ def __contains__(self, key):
+ """
+ Implements "in" operator
+ """
+ try:
+ self.__getitem__(key)
+ except KeyError:
+ return False
+ return True
+
+ def has_key(self, keyname):
+ """
+ Equivalent to k in a, use that form in new code
+ """
+ return self.__contains__(keyname)
diff --git a/samples/apps/marketplace_sample/appengine_utilities/django-middleware/__init__.py b/samples/apps/marketplace_sample/appengine_utilities/django-middleware/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/django-middleware/__init__.py
diff --git a/samples/apps/marketplace_sample/appengine_utilities/django-middleware/middleware.py b/samples/apps/marketplace_sample/appengine_utilities/django-middleware/middleware.py
new file mode 100644
index 0000000..9b91e8a
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/django-middleware/middleware.py
@@ -0,0 +1,68 @@
+import Cookie
+import os
+
+from common.appengine_utilities import sessions
+
+
+class SessionMiddleware(object):
+ TEST_COOKIE_NAME = 'testcookie'
+ TEST_COOKIE_VALUE = 'worked'
+
+ def process_request(self, request):
+ """
+ Check to see if a valid session token exists, if not,
+ then use a cookie only session. It's up to the application
+ to convert the session to a datastore session. Once this
+ has been done, the session will continue to use the datastore
+ unless the writer is set to "cookie".
+
+ Setting the session to use the datastore is as easy as resetting
+ request.session anywhere if your application.
+
+ Example:
+ from common.appengine_utilities import sessions
+ request.session = sessions.Session()
+ """
+ self.request = request
+ if sessions.Session.check_token():
+ request.session = sessions.Session()
+ else:
+ request.session = sessions.Session(writer="cookie")
+ request.session.set_test_cookie = self.set_test_cookie
+ request.session.test_cookie_worked = self.test_cookie_worked
+ request.session.delete_test_cookie = self.delete_test_cookie
+ request.session.save = self.save
+ return None
+
+ def set_test_cookie(self):
+ string_cookie = os.environ.get('HTTP_COOKIE', '')
+
+ self.cookie = Cookie.SimpleCookie()
+ self.cookie.load(string_cookie)
+ self.cookie[self.TEST_COOKIE_NAME] = self.TEST_COOKIE_VALUE
+ print self.cookie
+
+ def test_cookie_worked(self):
+ string_cookie = os.environ.get('HTTP_COOKIE', '')
+
+ self.cookie = Cookie.SimpleCookie()
+ self.cookie.load(string_cookie)
+
+ return self.cookie.get(self.TEST_COOKIE_NAME)
+
+ def delete_test_cookie(self):
+ string_cookie = os.environ.get('HTTP_COOKIE', '')
+
+ self.cookie = Cookie.SimpleCookie()
+ self.cookie.load(string_cookie)
+ self.cookie[self.TEST_COOKIE_NAME] = ''
+ self.cookie[self.TEST_COOKIE_NAME]['path'] = '/'
+ self.cookie[self.TEST_COOKIE_NAME]['expires'] = 0
+
+ def save(self):
+ self.request.session = sessions.Session()
+
+ def process_response(self, request, response):
+ if hasattr(request, "session"):
+ response.cookies= request.session.output_cookie
+ return response
diff --git a/samples/apps/marketplace_sample/appengine_utilities/event.py b/samples/apps/marketplace_sample/appengine_utilities/event.py
new file mode 100644
index 0000000..54807bf
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/event.py
@@ -0,0 +1,119 @@
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+import sys
+
+
+class Event(object):
+ """
+ Event is a simple publish/subscribe based event dispatcher. It's a way
+ to add, or take advantage of, hooks in your application. If you want to
+ tie actions in with lower level classes you're developing within your
+ application, you can set events to fire, and then subscribe to them with
+ callback methods in other methods in your application.
+
+ It sets itself to the sys.modules['__main__'] function. In order to use it,
+ you must import it with your sys.modules['__main__'] method, and make sure
+ you import sys.modules['__main__'] and it's accessible for the methods where
+ you want to use it.
+
+ For example, from sessions.py
+
+ # if the event class has been loaded, fire off the sessionDeleted
+ # event
+ if u"AEU_Events" in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event(u"sessionDelete")
+
+ You can the subscribe to session delete events, adding a callback
+
+ if u"AEU_Events" in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.subscribe(u"sessionDelete", \
+ clear_user_session)
+ """
+
+ def __init__(self):
+ self.events = []
+
+ def subscribe(self, event, callback, args = None):
+ """
+ This method will subscribe a callback function to an event name.
+
+ Args:
+ event: The event to subscribe to.
+ callback: The callback method to run.
+ args: Optional arguments to pass with the callback.
+
+ Returns True
+ """
+ if not {"event": event, "callback": callback, "args": args, } \
+ in self.events:
+ self.events.append({"event": event, "callback": callback, \
+ "args": args, })
+ return True
+
+ def unsubscribe(self, event, callback, args = None):
+ """
+ This method will unsubscribe a callback from an event.
+
+ Args:
+ event: The event to subscribe to.
+ callback: The callback method to run.
+ args: Optional arguments to pass with the callback.
+
+ Returns True
+ """
+ if {"event": event, "callback": callback, "args": args, }\
+ in self.events:
+ self.events.remove({"event": event, "callback": callback,\
+ "args": args, })
+
+ return True
+
+ def fire_event(self, event = None):
+ """
+ This method is what a method uses to fire an event,
+ initiating all registered callbacks
+
+ Args:
+ event: The name of the event to fire.
+
+ Returns True
+ """
+ for e in self.events:
+ if e["event"] == event:
+ if type(e["args"]) == type([]):
+ e["callback"](*e["args"])
+ elif type(e["args"]) == type({}):
+ e["callback"](**e["args"])
+ elif e["args"] == None:
+ e["callback"]()
+ else:
+ e["callback"](e["args"])
+ return True
+"""
+Assign to the event class to sys.modules['__main__']
+"""
+sys.modules['__main__'].AEU_Events = Event()
diff --git a/samples/apps/marketplace_sample/appengine_utilities/flash.py b/samples/apps/marketplace_sample/appengine_utilities/flash.py
new file mode 100644
index 0000000..1f249d6
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/flash.py
@@ -0,0 +1,130 @@
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+import os
+import Cookie
+from time import strftime
+
+from django.utils import simplejson
+
+# settings
+try:
+ import settings_default
+ import settings
+
+ if settings.__name__.rsplit('.', 1)[0] != settings_default.__name__.rsplit('.', 1)[0]:
+ settings = settings_default
+except:
+ settings = settings_default
+
+COOKIE_NAME = settings.flash["COOKIE_NAME"]
+
+
+class Flash(object):
+ """
+ Send messages to the user between pages.
+
+ When you instantiate the class, the attribute 'msg' will be set from the
+ cookie, and the cookie will be deleted. If there is no flash cookie, 'msg'
+ will default to None.
+
+ To set a flash message for the next page, simply set the 'msg' attribute.
+
+ Example psuedocode:
+
+ if new_entity.put():
+ flash = Flash()
+ flash.msg = 'Your new entity has been created!'
+ return redirect_to_entity_list()
+
+ Then in the template on the next page:
+
+ {% if flash.msg %}
+ <div class="flash-msg">{{ flash.msg }}</div>
+ {% endif %}
+ """
+
+ def __init__(self, cookie=None):
+ """
+ Load the flash message and clear the cookie.
+ """
+ print self.no_cache_headers()
+ # load cookie
+ if cookie is None:
+ browser_cookie = os.environ.get('HTTP_COOKIE', '')
+ self.cookie = Cookie.SimpleCookie()
+ self.cookie.load(browser_cookie)
+ else:
+ self.cookie = cookie
+ # check for flash data
+ if self.cookie.get(COOKIE_NAME):
+ # set 'msg' attribute
+ cookie_val = self.cookie[COOKIE_NAME].value
+ # we don't want to trigger __setattr__(), which creates a cookie
+ try:
+ self.__dict__['msg'] = simplejson.loads(cookie_val)
+ except:
+ # not able to load the json, so do not set message. This should
+ # catch for when the browser doesn't delete the cookie in time for
+ # the next request, and only blanks out the content.
+ pass
+ # clear the cookie
+ self.cookie[COOKIE_NAME] = ''
+ self.cookie[COOKIE_NAME]['path'] = '/'
+ self.cookie[COOKIE_NAME]['expires'] = 0
+ print self.cookie[COOKIE_NAME]
+ else:
+ # default 'msg' attribute to None
+ self.__dict__['msg'] = None
+
+ def __setattr__(self, name, value):
+ """
+ Create a cookie when setting the 'msg' attribute.
+ """
+ if name == 'cookie':
+ self.__dict__['cookie'] = value
+ elif name == 'msg':
+ self.__dict__['msg'] = value
+ self.__dict__['cookie'][COOKIE_NAME] = simplejson.dumps(value)
+ self.__dict__['cookie'][COOKIE_NAME]['path'] = '/'
+ print self.cookie
+ else:
+ raise ValueError('You can only set the "msg" attribute.')
+
+ def no_cache_headers(self):
+ """
+ Generates headers to avoid any page caching in the browser.
+ Useful for highly dynamic sites.
+
+ Returns a unicode string of headers.
+ """
+ return u"".join([u"Expires: Tue, 03 Jul 2001 06:00:00 GMT",
+ strftime("Last-Modified: %a, %d %b %y %H:%M:%S %Z").decode("utf-8"),
+ u"Cache-Control: no-store, no-cache, must-revalidate, max-age=0",
+ u"Cache-Control: post-check=0, pre-check=0",
+ u"Pragma: no-cache",
+ ])
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/__init__.py b/samples/apps/marketplace_sample/appengine_utilities/interface/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/__init__.py
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-context-min.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-context-min.css
new file mode 100644
index 0000000..0adba34
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-context-min.css
@@ -0,0 +1,79 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/* base.css, part of YUI's CSS Foundation */
+.yui-cssbase h1 {
+ /*18px via YUI Fonts CSS foundation*/
+ font-size:138.5%;
+}
+.yui-cssbase h2 {
+ /*16px via YUI Fonts CSS foundation*/
+ font-size:123.1%;
+}
+.yui-cssbase h3 {
+ /*14px via YUI Fonts CSS foundation*/
+ font-size:108%;
+}
+.yui-cssbase h1,.yui-cssbase h2,.yui-cssbase h3 {
+ /* top & bottom margin based on font size */
+ margin:1em 0;
+}
+.yui-cssbase h1,.yui-cssbase h2,.yui-cssbase h3,.yui-cssbase h4,.yui-cssbase h5,.yui-cssbase h6,.yui-cssbase strong {
+ /*bringing boldness back to headers and the strong element*/
+ font-weight:bold;
+}
+.yui-cssbase abbr,.yui-cssbase acronym {
+ /*indicating to users that more info is available */
+ border-bottom:1px dotted #000;
+ cursor:help;
+}
+.yui-cssbase em {
+ /*bringing italics back to the em element*/
+ font-style:italic;
+}
+.yui-cssbase blockquote,.yui-cssbase ul,.yui-cssbase ol,.yui-cssbase dl {
+ /*giving blockquotes and lists room to breath*/
+ margin:1em;
+}
+.yui-cssbase ol,.yui-cssbase ul,.yui-cssbase dl {
+ /*bringing lists on to the page with breathing room */
+ margin-left:2em;
+}
+.yui-cssbase ol li {
+ /*giving OL's LIs generated numbers*/
+ list-style: decimal outside;
+}
+.yui-cssbase ul li {
+ /*giving UL's LIs generated disc markers*/
+ list-style: disc outside;
+}
+.yui-cssbase dl dd {
+ /*giving UL's LIs generated numbers*/
+ margin-left:1em;
+}
+.yui-cssbase th,.yui-cssbase td {
+ /*borders and padding to make the table readable*/
+ border:1px solid #000;
+ padding:.5em;
+}
+.yui-cssbase th {
+ /*distinguishing table headers from data cells*/
+ font-weight:bold;
+ text-align:center;
+}
+.yui-cssbase caption {
+ /*coordinated margin to match cell's padding*/
+ margin-bottom:.5em;
+ /*centered so it doesn't blend in to other content*/
+ text-align:center;
+}
+.yui-cssbase p,.yui-cssbase fieldset,.yui-cssbase table,.yui-cssbase pre {
+ /*so things don't run into each other*/
+ margin-bottom:1em;
+}
+/* setting a consistent width, 160px;
+ control of type=file still not possible */
+.yui-cssbase input[type=text],.yui-cssbase input[type=password],.yui-cssbase textarea{width:12.25em;*width:11.9em;}
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-context.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-context.css
new file mode 100644
index 0000000..0adba34
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-context.css
@@ -0,0 +1,79 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/* base.css, part of YUI's CSS Foundation */
+.yui-cssbase h1 {
+ /*18px via YUI Fonts CSS foundation*/
+ font-size:138.5%;
+}
+.yui-cssbase h2 {
+ /*16px via YUI Fonts CSS foundation*/
+ font-size:123.1%;
+}
+.yui-cssbase h3 {
+ /*14px via YUI Fonts CSS foundation*/
+ font-size:108%;
+}
+.yui-cssbase h1,.yui-cssbase h2,.yui-cssbase h3 {
+ /* top & bottom margin based on font size */
+ margin:1em 0;
+}
+.yui-cssbase h1,.yui-cssbase h2,.yui-cssbase h3,.yui-cssbase h4,.yui-cssbase h5,.yui-cssbase h6,.yui-cssbase strong {
+ /*bringing boldness back to headers and the strong element*/
+ font-weight:bold;
+}
+.yui-cssbase abbr,.yui-cssbase acronym {
+ /*indicating to users that more info is available */
+ border-bottom:1px dotted #000;
+ cursor:help;
+}
+.yui-cssbase em {
+ /*bringing italics back to the em element*/
+ font-style:italic;
+}
+.yui-cssbase blockquote,.yui-cssbase ul,.yui-cssbase ol,.yui-cssbase dl {
+ /*giving blockquotes and lists room to breath*/
+ margin:1em;
+}
+.yui-cssbase ol,.yui-cssbase ul,.yui-cssbase dl {
+ /*bringing lists on to the page with breathing room */
+ margin-left:2em;
+}
+.yui-cssbase ol li {
+ /*giving OL's LIs generated numbers*/
+ list-style: decimal outside;
+}
+.yui-cssbase ul li {
+ /*giving UL's LIs generated disc markers*/
+ list-style: disc outside;
+}
+.yui-cssbase dl dd {
+ /*giving UL's LIs generated numbers*/
+ margin-left:1em;
+}
+.yui-cssbase th,.yui-cssbase td {
+ /*borders and padding to make the table readable*/
+ border:1px solid #000;
+ padding:.5em;
+}
+.yui-cssbase th {
+ /*distinguishing table headers from data cells*/
+ font-weight:bold;
+ text-align:center;
+}
+.yui-cssbase caption {
+ /*coordinated margin to match cell's padding*/
+ margin-bottom:.5em;
+ /*centered so it doesn't blend in to other content*/
+ text-align:center;
+}
+.yui-cssbase p,.yui-cssbase fieldset,.yui-cssbase table,.yui-cssbase pre {
+ /*so things don't run into each other*/
+ margin-bottom:1em;
+}
+/* setting a consistent width, 160px;
+ control of type=file still not possible */
+.yui-cssbase input[type=text],.yui-cssbase input[type=password],.yui-cssbase textarea{width:12.25em;*width:11.9em;}
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-min.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-min.css
new file mode 100644
index 0000000..e7352a4
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base-min.css
@@ -0,0 +1,79 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/* base.css, part of YUI's CSS Foundation */
+h1 {
+ /*18px via YUI Fonts CSS foundation*/
+ font-size:138.5%;
+}
+h2 {
+ /*16px via YUI Fonts CSS foundation*/
+ font-size:123.1%;
+}
+h3 {
+ /*14px via YUI Fonts CSS foundation*/
+ font-size:108%;
+}
+h1,h2,h3 {
+ /* top & bottom margin based on font size */
+ margin:1em 0;
+}
+h1,h2,h3,h4,h5,h6,strong {
+ /*bringing boldness back to headers and the strong element*/
+ font-weight:bold;
+}
+abbr,acronym {
+ /*indicating to users that more info is available */
+ border-bottom:1px dotted #000;
+ cursor:help;
+}
+em {
+ /*bringing italics back to the em element*/
+ font-style:italic;
+}
+blockquote,ul,ol,dl {
+ /*giving blockquotes and lists room to breath*/
+ margin:1em;
+}
+ol,ul,dl {
+ /*bringing lists on to the page with breathing room */
+ margin-left:2em;
+}
+ol li {
+ /*giving OL's LIs generated numbers*/
+ list-style: decimal outside;
+}
+ul li {
+ /*giving UL's LIs generated disc markers*/
+ list-style: disc outside;
+}
+dl dd {
+ /*giving UL's LIs generated numbers*/
+ margin-left:1em;
+}
+th,td {
+ /*borders and padding to make the table readable*/
+ border:1px solid #000;
+ padding:.5em;
+}
+th {
+ /*distinguishing table headers from data cells*/
+ font-weight:bold;
+ text-align:center;
+}
+caption {
+ /*coordinated margin to match cell's padding*/
+ margin-bottom:.5em;
+ /*centered so it doesn't blend in to other content*/
+ text-align:center;
+}
+p,fieldset,table,pre {
+ /*so things don't run into each other*/
+ margin-bottom:1em;
+}
+/* setting a consistent width, 160px;
+ control of type=file still not possible */
+input[type=text],input[type=password],textarea{width:12.25em;*width:11.9em;}
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base.css
new file mode 100644
index 0000000..e7352a4
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssbase/base.css
@@ -0,0 +1,79 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/* base.css, part of YUI's CSS Foundation */
+h1 {
+ /*18px via YUI Fonts CSS foundation*/
+ font-size:138.5%;
+}
+h2 {
+ /*16px via YUI Fonts CSS foundation*/
+ font-size:123.1%;
+}
+h3 {
+ /*14px via YUI Fonts CSS foundation*/
+ font-size:108%;
+}
+h1,h2,h3 {
+ /* top & bottom margin based on font size */
+ margin:1em 0;
+}
+h1,h2,h3,h4,h5,h6,strong {
+ /*bringing boldness back to headers and the strong element*/
+ font-weight:bold;
+}
+abbr,acronym {
+ /*indicating to users that more info is available */
+ border-bottom:1px dotted #000;
+ cursor:help;
+}
+em {
+ /*bringing italics back to the em element*/
+ font-style:italic;
+}
+blockquote,ul,ol,dl {
+ /*giving blockquotes and lists room to breath*/
+ margin:1em;
+}
+ol,ul,dl {
+ /*bringing lists on to the page with breathing room */
+ margin-left:2em;
+}
+ol li {
+ /*giving OL's LIs generated numbers*/
+ list-style: decimal outside;
+}
+ul li {
+ /*giving UL's LIs generated disc markers*/
+ list-style: disc outside;
+}
+dl dd {
+ /*giving UL's LIs generated numbers*/
+ margin-left:1em;
+}
+th,td {
+ /*borders and padding to make the table readable*/
+ border:1px solid #000;
+ padding:.5em;
+}
+th {
+ /*distinguishing table headers from data cells*/
+ font-weight:bold;
+ text-align:center;
+}
+caption {
+ /*coordinated margin to match cell's padding*/
+ margin-bottom:.5em;
+ /*centered so it doesn't blend in to other content*/
+ text-align:center;
+}
+p,fieldset,table,pre {
+ /*so things don't run into each other*/
+ margin-bottom:1em;
+}
+/* setting a consistent width, 160px;
+ control of type=file still not possible */
+input[type=text],input[type=password],textarea{width:12.25em;*width:11.9em;}
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-context-min.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-context-min.css
new file mode 100644
index 0000000..db8be8a
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-context-min.css
@@ -0,0 +1,46 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/**
+ * Percents could work for IE, but for backCompat purposes, we are using keywords.
+ * x-small is for IE6/7 quirks mode.
+ */
+.yui-cssfonts body {
+ font:13px/1.231 arial,helvetica,clean,sans-serif;
+ *font-size:small; /* for IE */
+ *font:x-small; /* for IE in quirks mode */
+}
+
+/**
+ * Nudge down to get to 13px equivalent for these form elements
+ */
+.yui-cssfonts select,
+.yui-cssfonts input,
+.yui-cssfonts button,
+.yui-cssfonts textarea {
+ font:99% arial,helvetica,clean,sans-serif;
+}
+
+/**
+ * To help tables remember to inherit
+ */
+.yui-cssfonts table {
+ font-size:inherit;
+ font:100%;
+}
+
+/**
+ * Bump up IE to get to 13px equivalent for these fixed-width elements
+ */
+.yui-cssfonts pre,
+.yui-cssfonts code,
+.yui-cssfonts kbd,
+.yui-cssfonts samp,
+.yui-cssfonts tt {
+ font-family:monospace;
+ *font-size:108%;
+ line-height:100%;
+}
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-context.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-context.css
new file mode 100644
index 0000000..d3e7831
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-context.css
@@ -0,0 +1,46 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/**
+ * Percents could work for IE, but for backCompat purposes, we are using keywords.
+ * x-small is for IE6/7 quirks mode.
+ */
+.yui-cssfonts body, .yui-cssfonts {
+ font:13px/1.231 arial,helvetica,clean,sans-serif;
+ *font-size:small; /* for IE */
+ *font:x-small; /* for IE in quirks mode */
+}
+
+/**
+ * Nudge down to get to 13px equivalent for these form elements
+ */
+.yui-cssfonts select,
+.yui-cssfonts input,
+.yui-cssfonts button,
+.yui-cssfonts textarea {
+ font:99% arial,helvetica,clean,sans-serif;
+}
+
+/**
+ * To help tables remember to inherit
+ */
+.yui-cssfonts table {
+ font-size:inherit;
+ font:100%;
+}
+
+/**
+ * Bump up IE to get to 13px equivalent for these fixed-width elements
+ */
+.yui-cssfonts pre,
+.yui-cssfonts code,
+.yui-cssfonts kbd,
+.yui-cssfonts samp,
+.yui-cssfonts tt {
+ font-family:monospace;
+ *font-size:108%;
+ line-height:100%;
+}
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-min.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-min.css
new file mode 100644
index 0000000..d3aabb4
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts-min.css
@@ -0,0 +1,46 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/**
+ * Percents could work for IE, but for backCompat purposes, we are using keywords.
+ * x-small is for IE6/7 quirks mode.
+ */
+body {
+ font:13px/1.231 arial,helvetica,clean,sans-serif;
+ *font-size:small; /* for IE */
+ *font:x-small; /* for IE in quirks mode */
+}
+
+/**
+ * Nudge down to get to 13px equivalent for these form elements
+ */
+select,
+input,
+button,
+textarea {
+ font:99% arial,helvetica,clean,sans-serif;
+}
+
+/**
+ * To help tables remember to inherit
+ */
+table {
+ font-size:inherit;
+ font:100%;
+}
+
+/**
+ * Bump up IE to get to 13px equivalent for these fixed-width elements
+ */
+pre,
+code,
+kbd,
+samp,
+tt {
+ font-family:monospace;
+ *font-size:108%;
+ line-height:100%;
+}
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts.css
new file mode 100644
index 0000000..d3aabb4
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssfonts/fonts.css
@@ -0,0 +1,46 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/**
+ * Percents could work for IE, but for backCompat purposes, we are using keywords.
+ * x-small is for IE6/7 quirks mode.
+ */
+body {
+ font:13px/1.231 arial,helvetica,clean,sans-serif;
+ *font-size:small; /* for IE */
+ *font:x-small; /* for IE in quirks mode */
+}
+
+/**
+ * Nudge down to get to 13px equivalent for these form elements
+ */
+select,
+input,
+button,
+textarea {
+ font:99% arial,helvetica,clean,sans-serif;
+}
+
+/**
+ * To help tables remember to inherit
+ */
+table {
+ font-size:inherit;
+ font:100%;
+}
+
+/**
+ * Bump up IE to get to 13px equivalent for these fixed-width elements
+ */
+pre,
+code,
+kbd,
+samp,
+tt {
+ font-family:monospace;
+ *font-size:108%;
+ line-height:100%;
+}
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-context-min.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-context-min.css
new file mode 100644
index 0000000..e8b68b1
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-context-min.css
@@ -0,0 +1,323 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/*
+ TODO README: removed yui-t7
+*/
+
+/**
+ *
+ * The YUI CSS Foundation uses the *property and _property CSS filter
+ * techniques to shield a value from A-grade browsers [1] other than
+ * IE6 & IE7 (*property) and IE6 (_property)
+ *
+/
+
+/**
+ * Center's the page
+/
+
+ Section: General Rules
+*/
+/*
+ TODO Maybe remove
+*/
+ .yui-grids body {
+ text-align:center;
+ margin-left:auto;margin-right:auto;
+ }
+
+/*
+ TODO - not sure I need this if the BD is already clearing.
+ #ft {
+ clear:both;
+ }
+*/
+/*
+ Section: Page Width Rules (#doc, #doc2, #doc3, #doc4)
+*/
+
+ /*
+ Subsection: General
+ */
+
+ .yui-grids .yui-d0, /* 100% */
+ .yui-grids .yui-d1, /* 750px */
+ .yui-grids .yui-d2, /* 950px */
+ .yui-grids .yui-d3, /* 974px */
+ .yui-t1,
+ .yui-t2,
+ .yui-t3,
+ .yui-t4,
+ .yui-t5,
+ .yui-t6 /* the Ts are here to collect margin and text-alignment rules */{
+ margin:auto;
+ text-align:left;
+ width:57.69em;*width:56.25em; /* doc1*/
+ min-width:750px;
+ }
+
+ .yui-t1,
+ .yui-t2,
+ .yui-t3,
+ .yui-t4,
+ .yui-t5,
+ .yui-t6 {width:100%;}
+
+ /*
+ Subsection: 100% (doc)
+ */
+ .yui-grids .yui-d0 {
+ /* Left and Right margins are not a structural part of Grids. Without them Grids
+ works fine, but content bleeds to the very edge of the document, which often
+ impairs readability and usability. They are
+ provided because they prevent the content from "bleeding" into the browser's chrome.*/
+ margin:auto 10px;
+ width:auto;
+ }
+
+
+ .yui-grids .yui-d0f {width:100%;}
+ /*
+ Subsection: 950 Centered (doc2)
+ */
+ .yui-grids .yui-d2 {width:73.076em;*width:71.25em;}
+ .yui-grids .yui-d2f {width:950px;}
+
+
+
+ /*
+ Subsection: 974 Centered (doc3)
+ */
+ .yui-grids .yui-d3 {width:74.923em;*width:73.05em;}
+ .yui-grids .yui-d3f {width:974px;}
+
+/*
+ Section: Preset Template Rules (.yui-t[1-6])
+*/
+
+ /*
+ Subsection: General
+ */
+
+ /* to preserve source-order independence for Gecko without breaking */
+ .yui-b{position:relative;}
+ .yui-b{_position:static;}
+ .yui-main .yui-b{position:static;}
+
+ .yui-main {width:100%;}
+
+ .yui-t1 .yui-main,
+ .yui-t2 .yui-main,
+ .yui-t3 .yui-main{float:right;margin-left:-25em;/* IE: preserve layout at narrow widths */}
+
+ .yui-t4 .yui-main,
+ .yui-t5 .yui-main,
+ .yui-t6 .yui-main{float:left;margin-right:-25em;/* IE: preserve layout at narrow widths */}
+
+ /*
+ Subsection: For Specific Template Presets
+ */
+
+ /**
+ * Nudge down to get to 13px equivalent for these form elements
+ */
+
+ /*
+ TODO Create t1-6's that are based on fixed widths
+ */
+ .yui-t1 .yui-b {float:left;width:12.30769em;*width:12.00em;}
+ .yui-t1 .yui-main .yui-b{margin-left:13.30769em;*margin-left:12.975em;}
+
+ .yui-t2 .yui-b {float:left;width:13.84615em;*width:13.50em;}
+ .yui-t2 .yui-main .yui-b {margin-left:14.84615em;*margin-left:14.475em;}
+
+ .yui-t3 .yui-b {float:left;width:23.0769em;*width:22.50em;}
+ .yui-t3 .yui-main .yui-b {margin-left:24.0769em;*margin-left:23.475em;}
+
+ .yui-t4 .yui-b {float:right;width:13.8456em;*width:13.50em;}
+ .yui-t4 .yui-main .yui-b {margin-right:14.8456em;*margin-right:14.475em;}
+
+ .yui-t5 .yui-b {float:right;width:18.4615em;*width:18.00em;}
+ .yui-t5 .yui-main .yui-b {margin-right:19.4615em;*margin-right:18.975em;}
+
+ .yui-t6 .yui-b {float:right;width:23.0769em;*width:22.50em;}
+ .yui-t6 .yui-main .yui-b {margin-right:24.0769em;*margin-right:23.475em;}
+
+ .yui-t7 .yui-main .yui-b {display:block;margin:0 0 1em 0;}
+
+ .yui-main .yui-b {float:none;width:auto;}
+
+/*
+ Section: Grids and Nesting Grids
+*/
+
+ /*
+ Subsection: Children generally take half the available space
+ */
+
+ .yui-gb .yui-u,
+ .yui-g .yui-gb .yui-u,
+ .yui-gb .yui-g,
+ .yui-gb .yui-gb,
+ .yui-gb .yui-gc,
+ .yui-gb .yui-gd,
+ .yui-gb .yui-ge,
+ .yui-gb .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gc .yui-g,
+ .yui-gd .yui-u {float:right;}
+
+ /*Float units (and sub grids) to the right */
+ .yui-g .yui-u,
+ .yui-g .yui-g,
+ .yui-g .yui-gb,
+ .yui-g .yui-gc,
+ .yui-g .yui-gd,
+ .yui-g .yui-ge,
+ .yui-g .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gd .yui-g,
+ .yui-g .yui-gc .yui-u,
+ .yui-ge .yui-u,
+ .yui-ge .yui-g,
+ .yui-gf .yui-g,
+ .yui-gf .yui-u{float:right;}
+
+ /*Float units (and sub grids) to the left */
+ .yui-g div.first,
+ .yui-gb div.first,
+ .yui-gc div.first,
+ .yui-gd div.first,
+ .yui-ge div.first,
+ .yui-gf div.first,
+ .yui-g .yui-gc div.first,
+ .yui-g .yui-ge div.first,
+ .yui-gc div.first div.first {float:left;}
+
+ .yui-g .yui-u,
+ .yui-g .yui-g,
+ .yui-g .yui-gb,
+ .yui-g .yui-gc,
+ .yui-g .yui-gd,
+ .yui-g .yui-ge,
+ .yui-g .yui-gf {width:49.1%;}
+
+ .yui-gb .yui-u,
+ .yui-g .yui-gb .yui-u,
+ .yui-gb .yui-g,
+ .yui-gb .yui-gb,
+ .yui-gb .yui-gc,
+ .yui-gb .yui-gd,
+ .yui-gb .yui-ge,
+ .yui-gb .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gc .yui-g,
+ .yui-gd .yui-u {width:32%;margin-left:2.0%;}
+
+ /* Give IE some extra breathing room for 1/3-based rounding issues */
+ .yui-gb .yui-u {*width:31.8%;*margin-left:1.9%;}
+
+ .yui-gc div.first,
+ .yui-gd .yui-u {width:66%;_width:65.7%;}
+ .yui-gd div.first {width:32%;_width:31.5%;}
+
+ .yui-ge div.first,
+ .yui-gf .yui-u{width:74.2%;_width:74%;}
+
+ .yui-ge .yui-u,
+ .yui-gf div.first {width:24%;_width:23.8%;}
+
+ .yui-g .yui-gb div.first,
+ .yui-gb div.first,
+ .yui-gc div.first,
+ .yui-gd div.first {margin-left:0;}
+
+ /*
+ Section: Deep Nesting
+ */
+ .yui-g .yui-g .yui-u,
+ .yui-gb .yui-g .yui-u,
+ .yui-gc .yui-g .yui-u,
+ .yui-gd .yui-g .yui-u,
+ .yui-ge .yui-g .yui-u,
+ .yui-gf .yui-g .yui-u {width:49%;*width:48.1%;*margin-left:0;}
+
+ .yui-g .yui-gb div.first,
+ .yui-gb .yui-gb div.first {*margin-right:0;*width:32%;_width:31.7%;}
+
+ .yui-g .yui-gc div.first,
+ .yui-gd .yui-g {width:66%;}
+
+ .yui-gb .yui-g div.first {*margin-right:4%;_margin-right:1.3%;}
+
+ .yui-gb .yui-gc div.first,
+ .yui-gb .yui-gd div.first {*margin-right:0;}
+
+ .yui-gb .yui-gb .yui-u,
+ .yui-gb .yui-gc .yui-u {*margin-left:1.8%;_margin-left:4%;}
+
+ .yui-g .yui-gb .yui-u {_margin-left:1.0%;}
+
+ .yui-gb .yui-gd .yui-u {*width:66%;_width:61.2%;}
+ .yui-gb .yui-gd div.first {*width:31%;_width:29.5%;}
+
+ .yui-g .yui-gc .yui-u,
+ .yui-gb .yui-gc .yui-u {width:32%;_float:right;margin-right:0;_margin-left:0;}
+ .yui-gb .yui-gc div.first {width:66%;*float:left;*margin-left:0;}
+
+ .yui-gb .yui-ge .yui-u,
+ .yui-gb .yui-gf .yui-u {margin:0;}
+
+ .yui-gb .yui-gb .yui-u {_margin-left:.7%;}
+
+ .yui-gb .yui-g div.first,
+ .yui-gb .yui-gb div.first {*margin-left:0;}
+
+ .yui-gc .yui-g .yui-u,
+ .yui-gd .yui-g .yui-u {*width:48.1%;*margin-left:0;}
+
+ .yui-gb .yui-gd div.first {width:32%;}
+ .yui-g .yui-gd div.first {_width:29.9%;}
+
+ .yui-ge .yui-g {width:24%;}
+ .yui-gf .yui-g {width:74.2%;}
+
+ .yui-gb .yui-ge div.yui-u,
+ .yui-gb .yui-gf div.yui-u {float:right;}
+ .yui-gb .yui-ge div.first,
+ .yui-gb .yui-gf div.first {float:left;}
+
+ /* Width Accommodation for Nested Contexts */
+ .yui-gb .yui-ge .yui-u,
+ .yui-gb .yui-gf div.first {*width:24%;_width:20%;}
+
+ /* Width Accommodation for Nested Contexts */
+ .yui-gb .yui-ge div.first,
+ .yui-gb .yui-gf .yui-u{*width:73.5%;_width:65.5%;}
+
+ /* Patch for GD within GE */
+ .yui-ge div.first .yui-gd .yui-u {width:65%;}
+ .yui-ge div.first .yui-gd div.first {width:32%;}
+
+/*
+ Section: Clearing
+*/
+
+#bd:after,
+.yui-g:after,
+.yui-gb:after,
+.yui-gc:after,
+.yui-gd:after,
+.yui-ge:after,
+.yui-gf:after{content:".";display:block;height:0;clear:both;visibility:hidden;}
+#bd,
+.yui-g,
+.yui-gb,
+.yui-gc,
+.yui-gd,
+.yui-ge,
+.yui-gf{zoom:1;}
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-context.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-context.css
new file mode 100644
index 0000000..11925ee
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-context.css
@@ -0,0 +1,326 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/*
+ TODO README: removed yui-t7
+*/
+
+/**
+ *
+ * The YUI CSS Foundation uses the *property and _property CSS filter
+ * techniques to shield a value from A-grade browsers [1] other than
+ * IE6 & IE7 (*property) and IE6 (_property)
+ *
+/
+
+/**
+ * Center's the page
+/
+
+ Section: General Rules
+*/
+/*
+ TODO Maybe remove
+*/
+ .yui-grids body {
+ text-align:center;
+ margin-left:auto;margin-right:auto;
+ }
+
+/*
+ TODO - not sure I need this if the BD is already clearing.
+ #ft {
+ clear:both;
+ }
+*/
+/*
+ Section: Page Width Rules (#doc, #doc2, #doc3, #doc4)
+*/
+
+ /*
+ Subsection: General
+ */
+
+ .yui-grids .yui-d0, /* 100% */
+ .yui-grids .yui-d1, /* 750px */
+ .yui-grids .yui-d1f, /* 750px fixed */
+ .yui-grids .yui-d2, /* 950px */
+ .yui-grids .yui-d2f, /* 950px fixed */
+ .yui-grids .yui-d3, /* 974px */
+ .yui-grids .yui-d3f, /* 974px fixed */
+ .yui-t1,
+ .yui-t2,
+ .yui-t3,
+ .yui-t4,
+ .yui-t5,
+ .yui-t6 /* the Ts are here to collect margin and text-alignment rules */{
+ margin:auto;
+ text-align:left;
+ width:57.69em;*width:56.25em; /* doc1*/
+ min-width:750px;
+ }
+
+ .yui-t1,
+ .yui-t2,
+ .yui-t3,
+ .yui-t4,
+ .yui-t5,
+ .yui-t6 {width:100%;}
+
+ /*
+ Subsection: 100% (doc)
+ */
+ .yui-grids .yui-d0 {
+ /* Left and Right margins are not a structural part of Grids. Without them Grids
+ works fine, but content bleeds to the very edge of the document, which often
+ impairs readability and usability. They are
+ provided because they prevent the content from "bleeding" into the browser's chrome.*/
+ margin:auto 10px;
+ width:auto;
+ }
+
+
+ .yui-grids .yui-d0f {width:100%;}
+ /*
+ Subsection: 950 Centered (doc2)
+ */
+ .yui-grids .yui-d2 {width:73.076em;*width:71.25em;}
+ .yui-grids .yui-d2f {width:950px;}
+
+
+
+ /*
+ Subsection: 974 Centered (doc3)
+ */
+ .yui-grids .yui-d3 {width:74.923em;*width:73.05em;}
+ .yui-grids .yui-d3f {width:974px;}
+
+/*
+ Section: Preset Template Rules (.yui-t[1-6])
+*/
+
+ /*
+ Subsection: General
+ */
+
+ /* to preserve source-order independence for Gecko without breaking */
+ .yui-b{position:relative;}
+ .yui-b{_position:static;}
+ .yui-main .yui-b{position:static;}
+
+ .yui-main {width:100%;}
+
+ .yui-t1 .yui-main,
+ .yui-t2 .yui-main,
+ .yui-t3 .yui-main{float:right;margin-left:-25em;/* IE: preserve layout at narrow widths */}
+
+ .yui-t4 .yui-main,
+ .yui-t5 .yui-main,
+ .yui-t6 .yui-main{float:left;margin-right:-25em;/* IE: preserve layout at narrow widths */}
+
+ /*
+ Subsection: For Specific Template Presets
+ */
+
+ /**
+ * Nudge down to get to 13px equivalent for these form elements
+ */
+
+ /*
+ TODO Create t1-6's that are based on fixed widths
+ */
+ .yui-t1 .yui-b {float:left;width:12.30769em;*width:12.00em;}
+ .yui-t1 .yui-main .yui-b{margin-left:13.30769em;*margin-left:12.975em;}
+
+ .yui-t2 .yui-b {float:left;width:13.84615em;*width:13.50em;}
+ .yui-t2 .yui-main .yui-b {margin-left:14.84615em;*margin-left:14.475em;}
+
+ .yui-t3 .yui-b {float:left;width:23.0769em;*width:22.50em;}
+ .yui-t3 .yui-main .yui-b {margin-left:24.0769em;*margin-left:23.475em;}
+
+ .yui-t4 .yui-b {float:right;width:13.8456em;*width:13.50em;}
+ .yui-t4 .yui-main .yui-b {margin-right:14.8456em;*margin-right:14.475em;}
+
+ .yui-t5 .yui-b {float:right;width:18.4615em;*width:18.00em;}
+ .yui-t5 .yui-main .yui-b {margin-right:19.4615em;*margin-right:18.975em;}
+
+ .yui-t6 .yui-b {float:right;width:23.0769em;*width:22.50em;}
+ .yui-t6 .yui-main .yui-b {margin-right:24.0769em;*margin-right:23.475em;}
+
+ .yui-t7 .yui-main .yui-b {display:block;margin:0 0 1em 0;}
+
+ .yui-main .yui-b {float:none;width:auto;}
+
+/*
+ Section: Grids and Nesting Grids
+*/
+
+ /*
+ Subsection: Children generally take half the available space
+ */
+
+ .yui-gb .yui-u,
+ .yui-g .yui-gb .yui-u,
+ .yui-gb .yui-g,
+ .yui-gb .yui-gb,
+ .yui-gb .yui-gc,
+ .yui-gb .yui-gd,
+ .yui-gb .yui-ge,
+ .yui-gb .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gc .yui-g,
+ .yui-gd .yui-u {float:right;}
+
+ /*Float units (and sub grids) to the right */
+ .yui-g .yui-u,
+ .yui-g .yui-g,
+ .yui-g .yui-gb,
+ .yui-g .yui-gc,
+ .yui-g .yui-gd,
+ .yui-g .yui-ge,
+ .yui-g .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gd .yui-g,
+ .yui-g .yui-gc .yui-u,
+ .yui-ge .yui-u,
+ .yui-ge .yui-g,
+ .yui-gf .yui-g,
+ .yui-gf .yui-u{float:right;}
+
+ /*Float units (and sub grids) to the left */
+ .yui-g div.first,
+ .yui-gb div.first,
+ .yui-gc div.first,
+ .yui-gd div.first,
+ .yui-ge div.first,
+ .yui-gf div.first,
+ .yui-g .yui-gc div.first,
+ .yui-g .yui-ge div.first,
+ .yui-gc div.first div.first {float:left;}
+
+ .yui-g .yui-u,
+ .yui-g .yui-g,
+ .yui-g .yui-gb,
+ .yui-g .yui-gc,
+ .yui-g .yui-gd,
+ .yui-g .yui-ge,
+ .yui-g .yui-gf {width:49.1%;}
+
+ .yui-gb .yui-u,
+ .yui-g .yui-gb .yui-u,
+ .yui-gb .yui-g,
+ .yui-gb .yui-gb,
+ .yui-gb .yui-gc,
+ .yui-gb .yui-gd,
+ .yui-gb .yui-ge,
+ .yui-gb .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gc .yui-g,
+ .yui-gd .yui-u {width:32%;margin-left:2.0%;}
+
+ /* Give IE some extra breathing room for 1/3-based rounding issues */
+ .yui-gb .yui-u {*width:31.8%;*margin-left:1.9%;}
+
+ .yui-gc div.first,
+ .yui-gd .yui-u {width:66%;_width:65.7%;}
+ .yui-gd div.first {width:32%;_width:31.5%;}
+
+ .yui-ge div.first,
+ .yui-gf .yui-u{width:74.2%;_width:74%;}
+
+ .yui-ge .yui-u,
+ .yui-gf div.first {width:24%;_width:23.8%;}
+
+ .yui-g .yui-gb div.first,
+ .yui-gb div.first,
+ .yui-gc div.first,
+ .yui-gd div.first {margin-left:0;}
+
+ /*
+ Section: Deep Nesting
+ */
+ .yui-g .yui-g .yui-u,
+ .yui-gb .yui-g .yui-u,
+ .yui-gc .yui-g .yui-u,
+ .yui-gd .yui-g .yui-u,
+ .yui-ge .yui-g .yui-u,
+ .yui-gf .yui-g .yui-u {width:49%;*width:48.1%;*margin-left:0;}
+
+ .yui-g .yui-gb div.first,
+ .yui-gb .yui-gb div.first {*margin-right:0;*width:32%;_width:31.7%;}
+
+ .yui-g .yui-gc div.first,
+ .yui-gd .yui-g {width:66%;}
+
+ .yui-gb .yui-g div.first {*margin-right:4%;_margin-right:1.3%;}
+
+ .yui-gb .yui-gc div.first,
+ .yui-gb .yui-gd div.first {*margin-right:0;}
+
+ .yui-gb .yui-gb .yui-u,
+ .yui-gb .yui-gc .yui-u {*margin-left:1.8%;_margin-left:4%;}
+
+ .yui-g .yui-gb .yui-u {_margin-left:1.0%;}
+
+ .yui-gb .yui-gd .yui-u {*width:66%;_width:61.2%;}
+ .yui-gb .yui-gd div.first {*width:31%;_width:29.5%;}
+
+ .yui-g .yui-gc .yui-u,
+ .yui-gb .yui-gc .yui-u {width:32%;_float:right;margin-right:0;_margin-left:0;}
+ .yui-gb .yui-gc div.first {width:66%;*float:left;*margin-left:0;}
+
+ .yui-gb .yui-ge .yui-u,
+ .yui-gb .yui-gf .yui-u {margin:0;}
+
+ .yui-gb .yui-gb .yui-u {_margin-left:.7%;}
+
+ .yui-gb .yui-g div.first,
+ .yui-gb .yui-gb div.first {*margin-left:0;}
+
+ .yui-gc .yui-g .yui-u,
+ .yui-gd .yui-g .yui-u {*width:48.1%;*margin-left:0;}
+
+ .yui-gb .yui-gd div.first {width:32%;}
+ .yui-g .yui-gd div.first {_width:29.9%;}
+
+ .yui-ge .yui-g {width:24%;}
+ .yui-gf .yui-g {width:74.2%;}
+
+ .yui-gb .yui-ge div.yui-u,
+ .yui-gb .yui-gf div.yui-u {float:right;}
+ .yui-gb .yui-ge div.first,
+ .yui-gb .yui-gf div.first {float:left;}
+
+ /* Width Accommodation for Nested Contexts */
+ .yui-gb .yui-ge .yui-u,
+ .yui-gb .yui-gf div.first {*width:24%;_width:20%;}
+
+ /* Width Accommodation for Nested Contexts */
+ .yui-gb .yui-ge div.first,
+ .yui-gb .yui-gf .yui-u{*width:73.5%;_width:65.5%;}
+
+ /* Patch for GD within GE */
+ .yui-ge div.first .yui-gd .yui-u {width:65%;}
+ .yui-ge div.first .yui-gd div.first {width:32%;}
+
+/*
+ Section: Clearing
+*/
+
+#bd:after,
+.yui-g:after,
+.yui-gb:after,
+.yui-gc:after,
+.yui-gd:after,
+.yui-ge:after,
+.yui-gf:after{content:".";display:block;height:0;clear:both;visibility:hidden;}
+#bd,
+.yui-g,
+.yui-gb,
+.yui-gc,
+.yui-gd,
+.yui-ge,
+.yui-gf{zoom:1;}
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-min.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-min.css
new file mode 100644
index 0000000..c85952d
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids-min.css
@@ -0,0 +1,326 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/*
+ TODO README: removed yui-t7
+*/
+
+/**
+ *
+ * The YUI CSS Foundation uses the *property and _property CSS filter
+ * techniques to shield a value from A-grade browsers [1] other than
+ * IE6 & IE7 (*property) and IE6 (_property)
+ *
+/
+
+/**
+ * Center's the page
+/
+
+ Section: General Rules
+*/
+/*
+ TODO Maybe remove
+*/
+ body {
+ text-align:center;
+ margin-left:auto;margin-right:auto;
+ }
+
+/*
+ TODO - not sure I need this if the BD is already clearing.
+ #ft {
+ clear:both;
+ }
+*/
+/*
+ Section: Page Width Rules (#doc, #doc2, #doc3, #doc4)
+*/
+
+ /*
+ Subsection: General
+ */
+
+ .yui-d0, /* 100% */
+ .yui-d1, /* 750px */
+ .yui-d1f, /* 750px fixed */
+ .yui-d2, /* 950px */
+ .yui-d2f, /* 950px fixed */
+ .yui-d3, /* 974px */
+ .yui-d3f, /* 974px fixed */
+ .yui-t1,
+ .yui-t2,
+ .yui-t3,
+ .yui-t4,
+ .yui-t5,
+ .yui-t6 /* the Ts are here to collect margin and text-alignment rules */{
+ margin:auto;
+ text-align:left;
+ width:57.69em;*width:56.25em; /* doc1*/
+ min-width:750px;
+ }
+
+ .yui-t1,
+ .yui-t2,
+ .yui-t3,
+ .yui-t4,
+ .yui-t5,
+ .yui-t6 {width:100%;}
+
+ /*
+ Subsection: 100% (doc)
+ */
+ .yui-d0 {
+ /* Left and Right margins are not a structural part of Grids. Without them Grids
+ works fine, but content bleeds to the very edge of the document, which often
+ impairs readability and usability. They are
+ provided because they prevent the content from "bleeding" into the browser's chrome.*/
+ margin:auto 10px;
+ width:auto;
+ }
+
+
+ .yui-d0f {width:100%;}
+ /*
+ Subsection: 950 Centered (doc2)
+ */
+ .yui-d2 {width:73.076em;*width:71.25em;}
+ .yui-d2f {width:950px;}
+
+
+
+ /*
+ Subsection: 974 Centered (doc3)
+ */
+ .yui-d3 {width:74.923em;*width:73.05em;}
+ .yui-d3f {width:974px;}
+
+/*
+ Section: Preset Template Rules (.yui-t[1-6])
+*/
+
+ /*
+ Subsection: General
+ */
+
+ /* to preserve source-order independence for Gecko without breaking */
+ .yui-b{position:relative;}
+ .yui-b{_position:static;}
+ .yui-main .yui-b{position:static;}
+
+ .yui-main {width:100%;}
+
+ .yui-t1 .yui-main,
+ .yui-t2 .yui-main,
+ .yui-t3 .yui-main{float:right;margin-left:-25em;/* IE: preserve layout at narrow widths */}
+
+ .yui-t4 .yui-main,
+ .yui-t5 .yui-main,
+ .yui-t6 .yui-main{float:left;margin-right:-25em;/* IE: preserve layout at narrow widths */}
+
+ /*
+ Subsection: For Specific Template Presets
+ */
+
+ /**
+ * Nudge down to get to 13px equivalent for these form elements
+ */
+
+ /*
+ TODO Create t1-6's that are based on fixed widths
+ */
+ .yui-t1 .yui-b {float:left;width:12.30769em;*width:12.00em;}
+ .yui-t1 .yui-main .yui-b{margin-left:13.30769em;*margin-left:12.975em;}
+
+ .yui-t2 .yui-b {float:left;width:13.84615em;*width:13.50em;}
+ .yui-t2 .yui-main .yui-b {margin-left:14.84615em;*margin-left:14.475em;}
+
+ .yui-t3 .yui-b {float:left;width:23.0769em;*width:22.50em;}
+ .yui-t3 .yui-main .yui-b {margin-left:24.0769em;*margin-left:23.475em;}
+
+ .yui-t4 .yui-b {float:right;width:13.8456em;*width:13.50em;}
+ .yui-t4 .yui-main .yui-b {margin-right:14.8456em;*margin-right:14.475em;}
+
+ .yui-t5 .yui-b {float:right;width:18.4615em;*width:18.00em;}
+ .yui-t5 .yui-main .yui-b {margin-right:19.4615em;*margin-right:18.975em;}
+
+ .yui-t6 .yui-b {float:right;width:23.0769em;*width:22.50em;}
+ .yui-t6 .yui-main .yui-b {margin-right:24.0769em;*margin-right:23.475em;}
+
+ .yui-t7 .yui-main .yui-b {display:block;margin:0 0 1em 0;}
+
+ .yui-main .yui-b {float:none;width:auto;}
+
+/*
+ Section: Grids and Nesting Grids
+*/
+
+ /*
+ Subsection: Children generally take half the available space
+ */
+
+ .yui-gb .yui-u,
+ .yui-g .yui-gb .yui-u,
+ .yui-gb .yui-g,
+ .yui-gb .yui-gb,
+ .yui-gb .yui-gc,
+ .yui-gb .yui-gd,
+ .yui-gb .yui-ge,
+ .yui-gb .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gc .yui-g,
+ .yui-gd .yui-u {float:right;}
+
+ /*Float units (and sub grids) to the right */
+ .yui-g .yui-u,
+ .yui-g .yui-g,
+ .yui-g .yui-gb,
+ .yui-g .yui-gc,
+ .yui-g .yui-gd,
+ .yui-g .yui-ge,
+ .yui-g .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gd .yui-g,
+ .yui-g .yui-gc .yui-u,
+ .yui-ge .yui-u,
+ .yui-ge .yui-g,
+ .yui-gf .yui-g,
+ .yui-gf .yui-u{float:right;}
+
+ /*Float units (and sub grids) to the left */
+ .yui-g div.first,
+ .yui-gb div.first,
+ .yui-gc div.first,
+ .yui-gd div.first,
+ .yui-ge div.first,
+ .yui-gf div.first,
+ .yui-g .yui-gc div.first,
+ .yui-g .yui-ge div.first,
+ .yui-gc div.first div.first {float:left;}
+
+ .yui-g .yui-u,
+ .yui-g .yui-g,
+ .yui-g .yui-gb,
+ .yui-g .yui-gc,
+ .yui-g .yui-gd,
+ .yui-g .yui-ge,
+ .yui-g .yui-gf {width:49.1%;}
+
+ .yui-gb .yui-u,
+ .yui-g .yui-gb .yui-u,
+ .yui-gb .yui-g,
+ .yui-gb .yui-gb,
+ .yui-gb .yui-gc,
+ .yui-gb .yui-gd,
+ .yui-gb .yui-ge,
+ .yui-gb .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gc .yui-g,
+ .yui-gd .yui-u {width:32%;margin-left:2.0%;}
+
+ /* Give IE some extra breathing room for 1/3-based rounding issues */
+ .yui-gb .yui-u {*width:31.8%;*margin-left:1.9%;}
+
+ .yui-gc div.first,
+ .yui-gd .yui-u {width:66%;_width:65.7%;}
+ .yui-gd div.first {width:32%;_width:31.5%;}
+
+ .yui-ge div.first,
+ .yui-gf .yui-u{width:74.2%;_width:74%;}
+
+ .yui-ge .yui-u,
+ .yui-gf div.first {width:24%;_width:23.8%;}
+
+ .yui-g .yui-gb div.first,
+ .yui-gb div.first,
+ .yui-gc div.first,
+ .yui-gd div.first {margin-left:0;}
+
+ /*
+ Section: Deep Nesting
+ */
+ .yui-g .yui-g .yui-u,
+ .yui-gb .yui-g .yui-u,
+ .yui-gc .yui-g .yui-u,
+ .yui-gd .yui-g .yui-u,
+ .yui-ge .yui-g .yui-u,
+ .yui-gf .yui-g .yui-u {width:49%;*width:48.1%;*margin-left:0;}
+
+ .yui-g .yui-gb div.first,
+ .yui-gb .yui-gb div.first {*margin-right:0;*width:32%;_width:31.7%;}
+
+ .yui-g .yui-gc div.first,
+ .yui-gd .yui-g {width:66%;}
+
+ .yui-gb .yui-g div.first {*margin-right:4%;_margin-right:1.3%;}
+
+ .yui-gb .yui-gc div.first,
+ .yui-gb .yui-gd div.first {*margin-right:0;}
+
+ .yui-gb .yui-gb .yui-u,
+ .yui-gb .yui-gc .yui-u {*margin-left:1.8%;_margin-left:4%;}
+
+ .yui-g .yui-gb .yui-u {_margin-left:1.0%;}
+
+ .yui-gb .yui-gd .yui-u {*width:66%;_width:61.2%;}
+ .yui-gb .yui-gd div.first {*width:31%;_width:29.5%;}
+
+ .yui-g .yui-gc .yui-u,
+ .yui-gb .yui-gc .yui-u {width:32%;_float:right;margin-right:0;_margin-left:0;}
+ .yui-gb .yui-gc div.first {width:66%;*float:left;*margin-left:0;}
+
+ .yui-gb .yui-ge .yui-u,
+ .yui-gb .yui-gf .yui-u {margin:0;}
+
+ .yui-gb .yui-gb .yui-u {_margin-left:.7%;}
+
+ .yui-gb .yui-g div.first,
+ .yui-gb .yui-gb div.first {*margin-left:0;}
+
+ .yui-gc .yui-g .yui-u,
+ .yui-gd .yui-g .yui-u {*width:48.1%;*margin-left:0;}
+
+ .yui-gb .yui-gd div.first {width:32%;}
+ .yui-g .yui-gd div.first {_width:29.9%;}
+
+ .yui-ge .yui-g {width:24%;}
+ .yui-gf .yui-g {width:74.2%;}
+
+ .yui-gb .yui-ge div.yui-u,
+ .yui-gb .yui-gf div.yui-u {float:right;}
+ .yui-gb .yui-ge div.first,
+ .yui-gb .yui-gf div.first {float:left;}
+
+ /* Width Accommodation for Nested Contexts */
+ .yui-gb .yui-ge .yui-u,
+ .yui-gb .yui-gf div.first {*width:24%;_width:20%;}
+
+ /* Width Accommodation for Nested Contexts */
+ .yui-gb .yui-ge div.first,
+ .yui-gb .yui-gf .yui-u{*width:73.5%;_width:65.5%;}
+
+ /* Patch for GD within GE */
+ .yui-ge div.first .yui-gd .yui-u {width:65%;}
+ .yui-ge div.first .yui-gd div.first {width:32%;}
+
+/*
+ Section: Clearing
+*/
+
+#bd:after,
+.yui-g:after,
+.yui-gb:after,
+.yui-gc:after,
+.yui-gd:after,
+.yui-ge:after,
+.yui-gf:after{content:".";display:block;height:0;clear:both;visibility:hidden;}
+#bd,
+.yui-g,
+.yui-gb,
+.yui-gc,
+.yui-gd,
+.yui-ge,
+.yui-gf{zoom:1;}
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids.css
new file mode 100644
index 0000000..c85952d
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssgrids/grids.css
@@ -0,0 +1,326 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/*
+ TODO README: removed yui-t7
+*/
+
+/**
+ *
+ * The YUI CSS Foundation uses the *property and _property CSS filter
+ * techniques to shield a value from A-grade browsers [1] other than
+ * IE6 & IE7 (*property) and IE6 (_property)
+ *
+/
+
+/**
+ * Center's the page
+/
+
+ Section: General Rules
+*/
+/*
+ TODO Maybe remove
+*/
+ body {
+ text-align:center;
+ margin-left:auto;margin-right:auto;
+ }
+
+/*
+ TODO - not sure I need this if the BD is already clearing.
+ #ft {
+ clear:both;
+ }
+*/
+/*
+ Section: Page Width Rules (#doc, #doc2, #doc3, #doc4)
+*/
+
+ /*
+ Subsection: General
+ */
+
+ .yui-d0, /* 100% */
+ .yui-d1, /* 750px */
+ .yui-d1f, /* 750px fixed */
+ .yui-d2, /* 950px */
+ .yui-d2f, /* 950px fixed */
+ .yui-d3, /* 974px */
+ .yui-d3f, /* 974px fixed */
+ .yui-t1,
+ .yui-t2,
+ .yui-t3,
+ .yui-t4,
+ .yui-t5,
+ .yui-t6 /* the Ts are here to collect margin and text-alignment rules */{
+ margin:auto;
+ text-align:left;
+ width:57.69em;*width:56.25em; /* doc1*/
+ min-width:750px;
+ }
+
+ .yui-t1,
+ .yui-t2,
+ .yui-t3,
+ .yui-t4,
+ .yui-t5,
+ .yui-t6 {width:100%;}
+
+ /*
+ Subsection: 100% (doc)
+ */
+ .yui-d0 {
+ /* Left and Right margins are not a structural part of Grids. Without them Grids
+ works fine, but content bleeds to the very edge of the document, which often
+ impairs readability and usability. They are
+ provided because they prevent the content from "bleeding" into the browser's chrome.*/
+ margin:auto 10px;
+ width:auto;
+ }
+
+
+ .yui-d0f {width:100%;}
+ /*
+ Subsection: 950 Centered (doc2)
+ */
+ .yui-d2 {width:73.076em;*width:71.25em;}
+ .yui-d2f {width:950px;}
+
+
+
+ /*
+ Subsection: 974 Centered (doc3)
+ */
+ .yui-d3 {width:74.923em;*width:73.05em;}
+ .yui-d3f {width:974px;}
+
+/*
+ Section: Preset Template Rules (.yui-t[1-6])
+*/
+
+ /*
+ Subsection: General
+ */
+
+ /* to preserve source-order independence for Gecko without breaking */
+ .yui-b{position:relative;}
+ .yui-b{_position:static;}
+ .yui-main .yui-b{position:static;}
+
+ .yui-main {width:100%;}
+
+ .yui-t1 .yui-main,
+ .yui-t2 .yui-main,
+ .yui-t3 .yui-main{float:right;margin-left:-25em;/* IE: preserve layout at narrow widths */}
+
+ .yui-t4 .yui-main,
+ .yui-t5 .yui-main,
+ .yui-t6 .yui-main{float:left;margin-right:-25em;/* IE: preserve layout at narrow widths */}
+
+ /*
+ Subsection: For Specific Template Presets
+ */
+
+ /**
+ * Nudge down to get to 13px equivalent for these form elements
+ */
+
+ /*
+ TODO Create t1-6's that are based on fixed widths
+ */
+ .yui-t1 .yui-b {float:left;width:12.30769em;*width:12.00em;}
+ .yui-t1 .yui-main .yui-b{margin-left:13.30769em;*margin-left:12.975em;}
+
+ .yui-t2 .yui-b {float:left;width:13.84615em;*width:13.50em;}
+ .yui-t2 .yui-main .yui-b {margin-left:14.84615em;*margin-left:14.475em;}
+
+ .yui-t3 .yui-b {float:left;width:23.0769em;*width:22.50em;}
+ .yui-t3 .yui-main .yui-b {margin-left:24.0769em;*margin-left:23.475em;}
+
+ .yui-t4 .yui-b {float:right;width:13.8456em;*width:13.50em;}
+ .yui-t4 .yui-main .yui-b {margin-right:14.8456em;*margin-right:14.475em;}
+
+ .yui-t5 .yui-b {float:right;width:18.4615em;*width:18.00em;}
+ .yui-t5 .yui-main .yui-b {margin-right:19.4615em;*margin-right:18.975em;}
+
+ .yui-t6 .yui-b {float:right;width:23.0769em;*width:22.50em;}
+ .yui-t6 .yui-main .yui-b {margin-right:24.0769em;*margin-right:23.475em;}
+
+ .yui-t7 .yui-main .yui-b {display:block;margin:0 0 1em 0;}
+
+ .yui-main .yui-b {float:none;width:auto;}
+
+/*
+ Section: Grids and Nesting Grids
+*/
+
+ /*
+ Subsection: Children generally take half the available space
+ */
+
+ .yui-gb .yui-u,
+ .yui-g .yui-gb .yui-u,
+ .yui-gb .yui-g,
+ .yui-gb .yui-gb,
+ .yui-gb .yui-gc,
+ .yui-gb .yui-gd,
+ .yui-gb .yui-ge,
+ .yui-gb .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gc .yui-g,
+ .yui-gd .yui-u {float:right;}
+
+ /*Float units (and sub grids) to the right */
+ .yui-g .yui-u,
+ .yui-g .yui-g,
+ .yui-g .yui-gb,
+ .yui-g .yui-gc,
+ .yui-g .yui-gd,
+ .yui-g .yui-ge,
+ .yui-g .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gd .yui-g,
+ .yui-g .yui-gc .yui-u,
+ .yui-ge .yui-u,
+ .yui-ge .yui-g,
+ .yui-gf .yui-g,
+ .yui-gf .yui-u{float:right;}
+
+ /*Float units (and sub grids) to the left */
+ .yui-g div.first,
+ .yui-gb div.first,
+ .yui-gc div.first,
+ .yui-gd div.first,
+ .yui-ge div.first,
+ .yui-gf div.first,
+ .yui-g .yui-gc div.first,
+ .yui-g .yui-ge div.first,
+ .yui-gc div.first div.first {float:left;}
+
+ .yui-g .yui-u,
+ .yui-g .yui-g,
+ .yui-g .yui-gb,
+ .yui-g .yui-gc,
+ .yui-g .yui-gd,
+ .yui-g .yui-ge,
+ .yui-g .yui-gf {width:49.1%;}
+
+ .yui-gb .yui-u,
+ .yui-g .yui-gb .yui-u,
+ .yui-gb .yui-g,
+ .yui-gb .yui-gb,
+ .yui-gb .yui-gc,
+ .yui-gb .yui-gd,
+ .yui-gb .yui-ge,
+ .yui-gb .yui-gf,
+ .yui-gc .yui-u,
+ .yui-gc .yui-g,
+ .yui-gd .yui-u {width:32%;margin-left:2.0%;}
+
+ /* Give IE some extra breathing room for 1/3-based rounding issues */
+ .yui-gb .yui-u {*width:31.8%;*margin-left:1.9%;}
+
+ .yui-gc div.first,
+ .yui-gd .yui-u {width:66%;_width:65.7%;}
+ .yui-gd div.first {width:32%;_width:31.5%;}
+
+ .yui-ge div.first,
+ .yui-gf .yui-u{width:74.2%;_width:74%;}
+
+ .yui-ge .yui-u,
+ .yui-gf div.first {width:24%;_width:23.8%;}
+
+ .yui-g .yui-gb div.first,
+ .yui-gb div.first,
+ .yui-gc div.first,
+ .yui-gd div.first {margin-left:0;}
+
+ /*
+ Section: Deep Nesting
+ */
+ .yui-g .yui-g .yui-u,
+ .yui-gb .yui-g .yui-u,
+ .yui-gc .yui-g .yui-u,
+ .yui-gd .yui-g .yui-u,
+ .yui-ge .yui-g .yui-u,
+ .yui-gf .yui-g .yui-u {width:49%;*width:48.1%;*margin-left:0;}
+
+ .yui-g .yui-gb div.first,
+ .yui-gb .yui-gb div.first {*margin-right:0;*width:32%;_width:31.7%;}
+
+ .yui-g .yui-gc div.first,
+ .yui-gd .yui-g {width:66%;}
+
+ .yui-gb .yui-g div.first {*margin-right:4%;_margin-right:1.3%;}
+
+ .yui-gb .yui-gc div.first,
+ .yui-gb .yui-gd div.first {*margin-right:0;}
+
+ .yui-gb .yui-gb .yui-u,
+ .yui-gb .yui-gc .yui-u {*margin-left:1.8%;_margin-left:4%;}
+
+ .yui-g .yui-gb .yui-u {_margin-left:1.0%;}
+
+ .yui-gb .yui-gd .yui-u {*width:66%;_width:61.2%;}
+ .yui-gb .yui-gd div.first {*width:31%;_width:29.5%;}
+
+ .yui-g .yui-gc .yui-u,
+ .yui-gb .yui-gc .yui-u {width:32%;_float:right;margin-right:0;_margin-left:0;}
+ .yui-gb .yui-gc div.first {width:66%;*float:left;*margin-left:0;}
+
+ .yui-gb .yui-ge .yui-u,
+ .yui-gb .yui-gf .yui-u {margin:0;}
+
+ .yui-gb .yui-gb .yui-u {_margin-left:.7%;}
+
+ .yui-gb .yui-g div.first,
+ .yui-gb .yui-gb div.first {*margin-left:0;}
+
+ .yui-gc .yui-g .yui-u,
+ .yui-gd .yui-g .yui-u {*width:48.1%;*margin-left:0;}
+
+ .yui-gb .yui-gd div.first {width:32%;}
+ .yui-g .yui-gd div.first {_width:29.9%;}
+
+ .yui-ge .yui-g {width:24%;}
+ .yui-gf .yui-g {width:74.2%;}
+
+ .yui-gb .yui-ge div.yui-u,
+ .yui-gb .yui-gf div.yui-u {float:right;}
+ .yui-gb .yui-ge div.first,
+ .yui-gb .yui-gf div.first {float:left;}
+
+ /* Width Accommodation for Nested Contexts */
+ .yui-gb .yui-ge .yui-u,
+ .yui-gb .yui-gf div.first {*width:24%;_width:20%;}
+
+ /* Width Accommodation for Nested Contexts */
+ .yui-gb .yui-ge div.first,
+ .yui-gb .yui-gf .yui-u{*width:73.5%;_width:65.5%;}
+
+ /* Patch for GD within GE */
+ .yui-ge div.first .yui-gd .yui-u {width:65%;}
+ .yui-ge div.first .yui-gd div.first {width:32%;}
+
+/*
+ Section: Clearing
+*/
+
+#bd:after,
+.yui-g:after,
+.yui-gb:after,
+.yui-gc:after,
+.yui-gd:after,
+.yui-ge:after,
+.yui-gf:after{content:".";display:block;height:0;clear:both;visibility:hidden;}
+#bd,
+.yui-g,
+.yui-gb,
+.yui-gc,
+.yui-gd,
+.yui-ge,
+.yui-gf{zoom:1;}
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-context-min.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-context-min.css
new file mode 100644
index 0000000..7d66160
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-context-min.css
@@ -0,0 +1,125 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/*
+ TODO will need to remove settings on HTML since we can't namespace it.
+ TODO with the prefix, should I group by selector or property for weight savings?
+*/
+.yui-cssreset html{
+ color:#000;
+ background:#FFF;
+}
+/*
+ TODO remove settings on BODY since we can't namespace it.
+*/
+/*
+ TODO test putting a class on HEAD.
+ - Fails on FF.
+*/
+.yui-cssreset body,
+.yui-cssreset div,
+.yui-cssreset dl,
+.yui-cssreset dt,
+.yui-cssreset dd,
+.yui-cssreset ul,
+.yui-cssreset ol,
+.yui-cssreset li,
+.yui-cssreset h1,
+.yui-cssreset h2,
+.yui-cssreset h3,
+.yui-cssreset h4,
+.yui-cssreset h5,
+.yui-cssreset h6,
+.yui-cssreset pre,
+.yui-cssreset code,
+.yui-cssreset form,
+.yui-cssreset fieldset,
+.yui-cssreset legend,
+.yui-cssreset input,
+.yui-cssreset textarea,
+.yui-cssreset p,
+.yui-cssreset blockquote,
+.yui-cssreset th,
+.yui-cssreset td {
+ margin:0;
+ padding:0;
+}
+.yui-cssreset table {
+ border-collapse:collapse;
+ border-spacing:0;
+}
+.yui-cssreset fieldset,
+.yui-cssreset img {
+ border:0;
+}
+/*
+ TODO think about hanlding inheritence differently, maybe letting IE6 fail a bit...
+*/
+.yui-cssreset address,
+.yui-cssreset caption,
+.yui-cssreset cite,
+.yui-cssreset code,
+.yui-cssreset dfn,
+.yui-cssreset em,
+.yui-cssreset strong,
+.yui-cssreset th,
+.yui-cssreset var {
+ font-style:normal;
+ font-weight:normal;
+}
+/*
+ TODO Figure out where this list-style rule is best set. Hedger has a request to investigate.
+*/
+.yui-cssreset li {
+ list-style:none;
+}
+
+.yui-cssreset caption,
+.yui-cssreset th {
+ text-align:left;
+}
+.yui-cssreset h1,
+.yui-cssreset h2,
+.yui-cssreset h3,
+.yui-cssreset h4,
+.yui-cssreset h5,
+.yui-cssreset h6 {
+ font-size:100%;
+ font-weight:normal;
+}
+.yui-cssreset q:before,
+.yui-cssreset q:after {
+ content:'';
+}
+.yui-cssreset abbr,
+.yui-cssreset acronym {
+ border:0;
+ font-variant:normal;
+}
+/* to preserve line-height and selector appearance */
+.yui-cssreset sup {
+ vertical-align:text-top;
+}
+.yui-cssreset sub {
+ vertical-align:text-bottom;
+}
+.yui-cssreset input,
+.yui-cssreset textarea,
+.yui-cssreset select {
+ font-family:inherit;
+ font-size:inherit;
+ font-weight:inherit;
+}
+/*to enable resizing for IE*/
+.yui-cssreset input,
+.yui-cssreset textarea,
+.yui-cssreset select {
+ *font-size:100%;
+}
+/*because legend doesn't inherit in IE */
+.yui-cssreset legend {
+ color:#000;
+}
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-context.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-context.css
new file mode 100644
index 0000000..7d66160
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-context.css
@@ -0,0 +1,125 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/*
+ TODO will need to remove settings on HTML since we can't namespace it.
+ TODO with the prefix, should I group by selector or property for weight savings?
+*/
+.yui-cssreset html{
+ color:#000;
+ background:#FFF;
+}
+/*
+ TODO remove settings on BODY since we can't namespace it.
+*/
+/*
+ TODO test putting a class on HEAD.
+ - Fails on FF.
+*/
+.yui-cssreset body,
+.yui-cssreset div,
+.yui-cssreset dl,
+.yui-cssreset dt,
+.yui-cssreset dd,
+.yui-cssreset ul,
+.yui-cssreset ol,
+.yui-cssreset li,
+.yui-cssreset h1,
+.yui-cssreset h2,
+.yui-cssreset h3,
+.yui-cssreset h4,
+.yui-cssreset h5,
+.yui-cssreset h6,
+.yui-cssreset pre,
+.yui-cssreset code,
+.yui-cssreset form,
+.yui-cssreset fieldset,
+.yui-cssreset legend,
+.yui-cssreset input,
+.yui-cssreset textarea,
+.yui-cssreset p,
+.yui-cssreset blockquote,
+.yui-cssreset th,
+.yui-cssreset td {
+ margin:0;
+ padding:0;
+}
+.yui-cssreset table {
+ border-collapse:collapse;
+ border-spacing:0;
+}
+.yui-cssreset fieldset,
+.yui-cssreset img {
+ border:0;
+}
+/*
+ TODO think about hanlding inheritence differently, maybe letting IE6 fail a bit...
+*/
+.yui-cssreset address,
+.yui-cssreset caption,
+.yui-cssreset cite,
+.yui-cssreset code,
+.yui-cssreset dfn,
+.yui-cssreset em,
+.yui-cssreset strong,
+.yui-cssreset th,
+.yui-cssreset var {
+ font-style:normal;
+ font-weight:normal;
+}
+/*
+ TODO Figure out where this list-style rule is best set. Hedger has a request to investigate.
+*/
+.yui-cssreset li {
+ list-style:none;
+}
+
+.yui-cssreset caption,
+.yui-cssreset th {
+ text-align:left;
+}
+.yui-cssreset h1,
+.yui-cssreset h2,
+.yui-cssreset h3,
+.yui-cssreset h4,
+.yui-cssreset h5,
+.yui-cssreset h6 {
+ font-size:100%;
+ font-weight:normal;
+}
+.yui-cssreset q:before,
+.yui-cssreset q:after {
+ content:'';
+}
+.yui-cssreset abbr,
+.yui-cssreset acronym {
+ border:0;
+ font-variant:normal;
+}
+/* to preserve line-height and selector appearance */
+.yui-cssreset sup {
+ vertical-align:text-top;
+}
+.yui-cssreset sub {
+ vertical-align:text-bottom;
+}
+.yui-cssreset input,
+.yui-cssreset textarea,
+.yui-cssreset select {
+ font-family:inherit;
+ font-size:inherit;
+ font-weight:inherit;
+}
+/*to enable resizing for IE*/
+.yui-cssreset input,
+.yui-cssreset textarea,
+.yui-cssreset select {
+ *font-size:100%;
+}
+/*because legend doesn't inherit in IE */
+.yui-cssreset legend {
+ color:#000;
+}
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-min.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-min.css
new file mode 100644
index 0000000..b9d5299
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset-min.css
@@ -0,0 +1,125 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/*
+ TODO will need to remove settings on HTML since we can't namespace it.
+ TODO with the prefix, should I group by selector or property for weight savings?
+*/
+html{
+ color:#000;
+ background:#FFF;
+}
+/*
+ TODO remove settings on BODY since we can't namespace it.
+*/
+/*
+ TODO test putting a class on HEAD.
+ - Fails on FF.
+*/
+body,
+div,
+dl,
+dt,
+dd,
+ul,
+ol,
+li,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+pre,
+code,
+form,
+fieldset,
+legend,
+input,
+textarea,
+p,
+blockquote,
+th,
+td {
+ margin:0;
+ padding:0;
+}
+table {
+ border-collapse:collapse;
+ border-spacing:0;
+}
+fieldset,
+img {
+ border:0;
+}
+/*
+ TODO think about hanlding inheritence differently, maybe letting IE6 fail a bit...
+*/
+address,
+caption,
+cite,
+code,
+dfn,
+em,
+strong,
+th,
+var {
+ font-style:normal;
+ font-weight:normal;
+}
+/*
+ TODO Figure out where this list-style rule is best set. Hedger has a request to investigate.
+*/
+li {
+ list-style:none;
+}
+
+caption,
+th {
+ text-align:left;
+}
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+ font-size:100%;
+ font-weight:normal;
+}
+q:before,
+q:after {
+ content:'';
+}
+abbr,
+acronym {
+ border:0;
+ font-variant:normal;
+}
+/* to preserve line-height and selector appearance */
+sup {
+ vertical-align:text-top;
+}
+sub {
+ vertical-align:text-bottom;
+}
+input,
+textarea,
+select {
+ font-family:inherit;
+ font-size:inherit;
+ font-weight:inherit;
+}
+/*to enable resizing for IE*/
+input,
+textarea,
+select {
+ *font-size:100%;
+}
+/*because legend doesn't inherit in IE */
+legend {
+ color:#000;
+}
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset.css
new file mode 100644
index 0000000..b9d5299
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/cssreset/reset.css
@@ -0,0 +1,125 @@
+/*
+Copyright (c) 2008, Yahoo! Inc. All rights reserved.
+Code licensed under the BSD License:
+http://developer.yahoo.net/yui/license.txt
+version: 3.0.0pr1
+*/
+/*
+ TODO will need to remove settings on HTML since we can't namespace it.
+ TODO with the prefix, should I group by selector or property for weight savings?
+*/
+html{
+ color:#000;
+ background:#FFF;
+}
+/*
+ TODO remove settings on BODY since we can't namespace it.
+*/
+/*
+ TODO test putting a class on HEAD.
+ - Fails on FF.
+*/
+body,
+div,
+dl,
+dt,
+dd,
+ul,
+ol,
+li,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6,
+pre,
+code,
+form,
+fieldset,
+legend,
+input,
+textarea,
+p,
+blockquote,
+th,
+td {
+ margin:0;
+ padding:0;
+}
+table {
+ border-collapse:collapse;
+ border-spacing:0;
+}
+fieldset,
+img {
+ border:0;
+}
+/*
+ TODO think about hanlding inheritence differently, maybe letting IE6 fail a bit...
+*/
+address,
+caption,
+cite,
+code,
+dfn,
+em,
+strong,
+th,
+var {
+ font-style:normal;
+ font-weight:normal;
+}
+/*
+ TODO Figure out where this list-style rule is best set. Hedger has a request to investigate.
+*/
+li {
+ list-style:none;
+}
+
+caption,
+th {
+ text-align:left;
+}
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+ font-size:100%;
+ font-weight:normal;
+}
+q:before,
+q:after {
+ content:'';
+}
+abbr,
+acronym {
+ border:0;
+ font-variant:normal;
+}
+/* to preserve line-height and selector appearance */
+sup {
+ vertical-align:text-top;
+}
+sub {
+ vertical-align:text-bottom;
+}
+input,
+textarea,
+select {
+ font-family:inherit;
+ font-size:inherit;
+ font-weight:inherit;
+}
+/*to enable resizing for IE*/
+input,
+textarea,
+select {
+ *font-size:100%;
+}
+/*because legend doesn't inherit in IE */
+legend {
+ color:#000;
+}
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/css/main.css b/samples/apps/marketplace_sample/appengine_utilities/interface/css/main.css
new file mode 100644
index 0000000..97afbbe
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/css/main.css
@@ -0,0 +1,64 @@
+/*
+
+ project: Conceptnova (free CSS template)
+ author: luka cvrk (www.solucija.com)
+
+*/
+
+*{ margin: 0; padding: 0; }*
+body { background: #fff repeat-x; font: 74% Arial, Helvetica, Sans-Serif; color: #454545; line-height: 1.6em; }
+
+a { text-decoration: none; color: #C40000; background: inherit; }
+a:hover { color: #808080; background: inherit; }
+a:focus { outline: 0; }
+h1 { font-size: 2.8em; line-height: 35px; }
+h2 { color: #000; font: bold 170% Arial, Sans-Serif; letter-spacing: -1px; padding: 0; margin: 0 0 10px; }
+img { border: 0; }
+
+.grey { color: #484848; }
+
+#wrap { width: 900px; margin: 10px auto 0; }
+
+#logo { float: left; width: 400px; margin: 0 0 7px; }
+ #header_top { background: no-repeat top right; border-right: 2px solid #fff; color: #454545; padding: 10px 0 0 7px; clear: both; margin: 0 0 0px 0; height: 74px; }
+ #header_top p { padding: 0; margin: 0; }
+
+ #header_top ul { float: right; padding: 12px 160px 0 0; margin: 0 0 5px 0; }
+ #header_top ul li { list-style-type: none; display: inline; font-weight: bold; }
+ #header_top ul li a { padding-left: 7px; background: #FFF no-repeat center left; margin-right: 5px; color: #C40000; }
+ #header_top ul li a:hover { padding-left: 7px; background: #FFF no-repeat center left; margin-right: 5px; color: #808080; }
+
+ #header_bottom { background: #454545 no-repeat top right; color: #EBEBEB; padding: 20px 240px 20px 10px; clear: both; border-left: 2px solid #fff; border-right: 2px solid #fff; margin: 0 0 1px 0; }
+ #header_bottom h2 { color: #F3F2BF; width: 250px; margin: 0 0 10px; background: #454545; }
+ #header_bottom a { text-decoration: none; color: #FFFFFF; background: inherit; }
+ #header_bottom a:hover { text-decoration: underline; }
+ #header_bottom ul {padding-top: 1em;}
+ #header_bottom li {margin-left: 1em;}
+
+
+ #slogan { clear: left; width: 730px; border-top: 1px solid #eee; margin: 0; padding: 5px 0 0 0; }
+
+#maincontent { padding: 20px 0; clear: both; background: repeat-x; }
+
+#left { float: left; width: 630px; padding: 5px 15px 0 5px; margin: 0 0 25px 0; }
+ #left p { margin: 0 0 15px; }
+
+#right { width: 220px; float: right; }
+ #info { border: 1px solid #ccc; padding: 7px; font-size: .9em; background: #f4f4f4; }
+ #searchform { background: no-repeat; padding: 8px 4px 10px 4px; height: 27px; font: bold 0.9em Arial, Sans-Serif; margin: 0 0 20px; }
+ #searchform p { padding: 0; margin: 0; }
+ input.search { width: 127px; border: none; background: no-repeat; padding: 7px; margin: 0 4px 0 5px; }
+ input.submit { width: 53px; height: 29px; border: none; background: #FFF no-repeat; font: bold 1.2em Arial, Sans-Serif; padding: 0px; color: #FFF; }
+
+#footer { clear: both; padding: 10px; margin: 10px 0 0 0; border-top: 1px solid #ccc; line-height: 2em; }
+
+.code { background: #454545 no-repeat top right; color: #EBEBEB; padding: 20px 240px 20px 10px; clear: both; border-left: 2px solid #fff; border-right: 2px solid #fff; margin: 0 0 1px 0; }
+pre
+{
+white-space: pre-wrap; /* CSS2.1 compliant */
+white-space: -moz-pre-wrap; /* Mozilla-based browsers */
+white-space: o-pre-wrap; /* Opera 7+ */
+}
+
+td { padding: .5em; }
+th { background: #454545 no-repeat top right; color: #EBEBEB; }
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/main.py b/samples/apps/marketplace_sample/appengine_utilities/interface/main.py
new file mode 100644
index 0000000..648f1d7
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/main.py
@@ -0,0 +1,50 @@
+'''
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+Neither the name of the appengine-utilities project nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+'''
+
+import os, cgi, __main__
+from google.appengine.ext.webapp import template
+import wsgiref.handlers
+from google.appengine.ext import webapp
+from google.appengine.api import memcache
+from google.appengine.ext import db
+
+from appengine_utilities import cron
+
+class MainPage(webapp.RequestHandler):
+ def get(self):
+ c = cron.Cron()
+ query = cron._AppEngineUtilities_Cron.all()
+ results = query.fetch(1000)
+ template_values = {"cron_entries" : results}
+ path = os.path.join(os.path.dirname(__file__), 'templates/scheduler_form.html')
+ self.response.out.write(template.render(path, template_values))
+
+ def post(self):
+ if str(self.request.get('action')) == 'Add':
+ cron.Cron().add_cron(str(self.request.get('cron_entry')))
+ elif str(self.request.get('action')) == 'Delete':
+ entry = db.get(db.Key(str(self.request.get('key'))))
+ entry.delete()
+ query = cron._AppEngineUtilities_Cron.all()
+ results = query.fetch(1000)
+ template_values = {"cron_entries" : results}
+ path = os.path.join(os.path.dirname(__file__), 'templates/scheduler_form.html')
+ self.response.out.write(template.render(path, template_values))
+
+def main():
+ application = webapp.WSGIApplication(
+ [('/gaeutilities/', MainPage)],
+ debug=True)
+ wsgiref.handlers.CGIHandler().run(application)
+
+if __name__ == "__main__":
+ main()
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/templates/404.html b/samples/apps/marketplace_sample/appengine_utilities/interface/templates/404.html
new file mode 100644
index 0000000..f1b1cb3
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/templates/404.html
@@ -0,0 +1 @@
+404
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/templates/base.html b/samples/apps/marketplace_sample/appengine_utilities/interface/templates/base.html
new file mode 100644
index 0000000..03e3e10
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/templates/base.html
@@ -0,0 +1,49 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+"http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>GAEUtilities</title>
+<meta http-equiv="content-type" content="text/html; charset=utf-8" />
+<meta http-equiv="Cache-Control" content="no-cache" />
+<link rel="stylesheet" type="text/css" href="/gaeutilities/css/cssreset/reset-min.css">
+<link rel="stylesheet" type="text/css" href="/gaeutilities/css/cssfonts/fonts-min.css">
+<link rel="stylesheet" type="text/css" href="/gaeutilities/css/cssgrids/grids.css">
+</head>
+<link rel="stylesheet" href="css/main.css" type="text/css" media="screen, projection" />
+</head>
+<body>
+<div id="wrap" class="yui-d0">
+ <div id="header_top">
+ <h1 id="logo">gaeutilities</span></a></h1>
+ <ul>
+ <li><a href="/">Home</a></li>
+ <li><a href="http://code.google.com/p/gaeutilities/">Project Page</a></li>
+ <li><a href="http://groups.google.com/group/appengine-utilities">Group</a></li>
+ <li><a href="http://code.google.com/p/gaeutilities/w/list">Wiki</a></li>
+ <li><a href="http://code.google.com/p/gaeutilities/downloads/list">Downloads</a></li>
+ </ul>
+ <div id="slogan">
+ <p><b>Utility</b> classes to make working with <b>appengine</b> easier.</p>
+ </div>
+ </div>
+ <div id="header_bottom">
+ {% block header-content %}{% endblock %}
+ <div>
+ <b>CRON SUPPORT IS NOW DEPRECATED, NO FURTHER UPDATES WILL BE MADE. GOOGLE HAS NOW PROVIDED A CRON FOR APPENGINE APPLICATIONS</b>
+ </div>
+ </div>
+ <div id="maincontent">
+ <div id="left">
+ <p><strong>Menu: </strong><a href="/gaeutilities/">Cron</a><br />
+ {% block content %}{% endblock %}
+ </div>
+ <div id="right">
+ </div>
+ </div>
+ <div id="footer">
+ <p>Design: <a href="http://www.solucija.com/">Luka Cvrk</a> · Sponsored by <a href="http://webpoint.wordpress.com/">B4Contact</a> · Released under a <a href="http://creativecommons.org/licenses/by-nc-sa/3.0/">Creative Commons Licence</a></p>
+ <p>© Copyright 2008 <a href="http://www.free-css.com/">Conceptnova</a></p>
+ </div>
+</div>
+</body>
+</html>
diff --git a/samples/apps/marketplace_sample/appengine_utilities/interface/templates/scheduler_form.html b/samples/apps/marketplace_sample/appengine_utilities/interface/templates/scheduler_form.html
new file mode 100644
index 0000000..d778edf
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/interface/templates/scheduler_form.html
@@ -0,0 +1,25 @@
+{% extends "base.html" %}
+{% block header-content %}
+<h3>Cron</h3>
+<p>This utility allows you to schedule url's to be fetched at certain times/intervals. These actions are initiated during normal requests to your website, as long as request includes an import appengine_utlities.event.
+<br />
+<strong>NOTE: </strong>This will not work on the local SDK due to it being single threaded an unable to make a request to itself.
+</p>
+{% endblock %}
+{% block content %}
+<table>
+<tr>
+<th>Cron Entry</th><th colspan=2>Next Run Time</th>
+</tr>
+{% for cron in cron_entries %}
+<tr><td>{{ cron.cron_entry }}</td><td>{{ cron.next_run }}</td>
+<td><form action="" method="post"><input type="hidden" name="key" value="{{ cron.key }}"><input type="submit" name="action" value="Delete" /></form></td>
+</tr>
+{% endfor %}
+</table>
+Add cron entry
+<form method="post" action="">
+<input type="text" size="80" name="cron_entry" /><br />
+<input name="action" type="submit" value="Add" />
+</form>
+{% endblock %}
diff --git a/samples/apps/marketplace_sample/appengine_utilities/rotmodel.py b/samples/apps/marketplace_sample/appengine_utilities/rotmodel.py
new file mode 100644
index 0000000..0db3f6c
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/rotmodel.py
@@ -0,0 +1,134 @@
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+import time
+from google.appengine.api import datastore
+from google.appengine.ext import db
+
+# settings
+try:
+ import settings_default
+ import settings
+
+ if settings.__name__.rsplit('.', 1)[0] != settings_default.__name__.rsplit('.', 1)[0]:
+ settings = settings_default
+except:
+ settings = settings_default
+
+class ROTModel(db.Model):
+ """
+ ROTModel overrides the db.Model functions, retrying each method each time
+ a timeout exception is raised.
+
+ Methods superclassed from db.Model are:
+ get(cls, keys)
+ get_by_id(cls, ids, parent)
+ get_by_key_name(cls, key_names, parent)
+ get_or_insert(cls, key_name, kwargs)
+ put(self)
+ """
+
+ @classmethod
+ def get(cls, keys):
+ count = 0
+ while count < settings.rotmodel["RETRY_ATTEMPTS"]:
+ try:
+ return db.Model.get(keys)
+ except db.Timeout:
+ count += 1
+ time.sleep(count * settings.rotmodel["RETRY_INTERVAL"])
+ else:
+ raise db.Timeout()
+
+ @classmethod
+ def get_by_id(cls, ids, parent=None):
+ count = 0
+ while count < settings.rotmodel["RETRY_ATTEMPTS"]:
+ try:
+ return db.Model.get_by_id(ids, parent)
+ except db.Timeout:
+ count += 1
+ time.sleep(count * settings.rotmodel["RETRY_INTERVAL"])
+ else:
+ raise db.Timeout()
+
+ @classmethod
+ def get_by_key_name(cls, key_names, parent=None):
+ if isinstance(parent, db.Model):
+ parent = parent.key()
+ key_names, multiple = datastore.NormalizeAndTypeCheck(key_names, basestring)
+ keys = [datastore.Key.from_path(cls.kind(), name, parent=parent)
+ for name in key_names]
+ count = 0
+ if multiple:
+ while count < settings.rotmodel["RETRY_ATTEMPTS"]:
+ try:
+ return db.get(keys)
+ except db.Timeout:
+ count += 1
+ time.sleep(count * settings.rotmodel["RETRY_INTERVAL"])
+ else:
+ while count < settings.rotmodel["RETRY_ATTEMPTS"]:
+ try:
+ return db.get(*keys)
+ except db.Timeout:
+ count += 1
+ time.sleep(count * settings.rotmodel["RETRY_INTERVAL"])
+
+ @classmethod
+ def get_or_insert(cls, key_name, **kwargs):
+ def txn():
+ entity = cls.get_by_key_name(key_name, parent=kwargs.get('parent'))
+ if entity is None:
+ entity = cls(key_name=key_name, **kwargs)
+ entity.put()
+ return entity
+ return db.run_in_transaction(txn)
+
+ def put(self):
+ count = 0
+ while count < settings.rotmodel["RETRY_ATTEMPTS"]:
+ try:
+ return db.Model.put(self)
+ except db.Timeout:
+ count += 1
+ time.sleep(count * settings.rotmodel["RETRY_INTERVAL"])
+ else:
+ raise db.Timeout()
+
+ def delete(self):
+ count = 0
+ while count < settings.rotmodel["RETRY_ATTEMPTS"]:
+ try:
+ return db.Model.delete(self)
+ except db.Timeout:
+ count += 1
+ time.sleep(count * settings.rotmodel["RETRY_INTERVAL"])
+ else:
+ raise db.Timeout()
+
+
diff --git a/samples/apps/marketplace_sample/appengine_utilities/sessions.py b/samples/apps/marketplace_sample/appengine_utilities/sessions.py
new file mode 100644
index 0000000..2c4c058
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/sessions.py
@@ -0,0 +1,1153 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+# main python imports
+import os
+import time
+import datetime
+import random
+import hashlib
+import Cookie
+import pickle
+import sys
+import logging
+from time import strftime
+
+# google appengine imports
+from google.appengine.ext import db
+from google.appengine.api import memcache
+
+from django.utils import simplejson
+
+# settings
+try:
+ import settings_default
+ import settings
+
+ if settings.__name__.rsplit('.', 1)[0] != settings_default.__name__.rsplit('.', 1)[0]:
+ settings = settings_default
+except:
+ settings = settings_default
+
+
+
+
+class _AppEngineUtilities_Session(db.Model):
+ """
+ Model for the sessions in the datastore. This contains the identifier and
+ validation information for the session.
+ """
+
+ sid = db.StringListProperty()
+ ip = db.StringProperty()
+ ua = db.StringProperty()
+ last_activity = db.DateTimeProperty()
+ dirty = db.BooleanProperty(default=False)
+ working = db.BooleanProperty(default=False)
+ deleted = db.BooleanProperty(default=False)
+
+ def put(self):
+ """
+ Extends put so that it writes vaules to memcache as well as the
+ datastore, and keeps them in sync, even when datastore writes fails.
+
+ Returns the session object.
+ """
+ try:
+ memcache.set(u"_AppEngineUtilities_Session_%s" % \
+ (str(self.key())), self)
+ except:
+ # new session, generate a new key, which will handle the
+ # put and set the memcache
+ db.put(self)
+
+ self.last_activity = datetime.datetime.now()
+
+ try:
+ self.dirty = False
+ db.put(self)
+ memcache.set(u"_AppEngineUtilities_Session_%s" % \
+ (str(self.key())), self)
+ except:
+ self.dirty = True
+ memcache.set(u"_AppEngineUtilities_Session_%s" % \
+ (str(self.key())), self)
+
+ return self
+
+ @classmethod
+ def get_session(cls, session_obj=None):
+ """
+ Uses the passed objects sid to get a session object from memcache,
+ or datastore if a valid one exists.
+
+ Args:
+ session_obj: a session object
+
+ Returns a validated session object.
+ """
+ if session_obj.sid == None:
+ return None
+ session_key = session_obj.sid.split(u'_')[0]
+ session = memcache.get(u"_AppEngineUtilities_Session_%s" % \
+ (str(session_key)))
+ if session:
+ if session.deleted == True:
+ session.delete()
+ return None
+ if session.dirty == True and session.working != False:
+ # the working bit is used to make sure multiple requests,
+ # which can happen with ajax oriented sites, don't try to put
+ # at the same time
+ session.working = True
+ memcache.set(u"_AppEngineUtilities_Session_%s" % \
+ (str(session_key)), session)
+ session.put()
+ if session_obj.sid in session.sid:
+ sessionAge = datetime.datetime.now() - session.last_activity
+ if sessionAge.seconds > session_obj.session_expire_time:
+ session.delete()
+ return None
+ return session
+ else:
+ return None
+
+ # Not in memcache, check datastore
+
+ ds_session = db.get(str(session_key))
+ if ds_session:
+ sessionAge = datetime.datetime.now() - ds_session.last_activity
+ if sessionAge.seconds > session_obj.session_expire_time:
+ ds_session.delete()
+ return None
+ memcache.set(u"_AppEngineUtilities_Session_%s" % \
+ (str(session_key)), ds_session)
+ memcache.set(u"_AppEngineUtilities_SessionData_%s" % \
+ (str(session_key)), ds_session.get_items_ds())
+ return ds_session
+
+
+ def get_items(self):
+ """
+ Returns all the items stored in a session. Queries memcache first
+ and will try the datastore next.
+ """
+ items = memcache.get(u"_AppEngineUtilities_SessionData_%s" % \
+ (str(self.key())))
+ if items:
+ for item in items:
+ if item.deleted == True:
+ item.delete()
+ items.remove(item)
+ return items
+
+ query = _AppEngineUtilities_SessionData.all()
+ query.filter(u"session", self)
+ results = query.fetch(1000)
+ return results
+
+ def get_item(self, keyname = None):
+ """
+ Returns a single session data item from the memcache or datastore
+
+ Args:
+ keyname: keyname of the session data object
+
+ Returns the session data object if it exists, otherwise returns None
+ """
+ mc = memcache.get(u"_AppEngineUtilities_SessionData_%s" % \
+ (str(self.key())))
+ if mc:
+ for item in mc:
+ if item.keyname == keyname:
+ if item.deleted == True:
+ item.delete()
+ return None
+ return item
+ query = _AppEngineUtilities_SessionData.all()
+ query.filter(u"session = ", self)
+ query.filter(u"keyname = ", keyname)
+ results = query.fetch(1)
+ if len(results) > 0:
+ memcache.set(u"_AppEngineUtilities_SessionData_%s" % \
+ (str(self.key())), self.get_items_ds())
+ return results[0]
+ return None
+
+ def get_items_ds(self):
+ """
+ This gets all session data objects from the datastore, bypassing
+ memcache.
+
+ Returns a list of session data entities.
+ """
+ query = _AppEngineUtilities_SessionData.all()
+ query.filter(u"session", self)
+ results = query.fetch(1000)
+ return results
+
+ def delete(self):
+ """
+ Deletes a session and all it's associated data from the datastore and
+ memcache.
+
+ Returns True
+ """
+ try:
+ query = _AppEngineUtilities_SessionData.all()
+ query.filter(u"session = ", self)
+ results = query.fetch(1000)
+ db.delete(results)
+ db.delete(self)
+ memcache.delete_multi([u"_AppEngineUtilities_Session_%s" % \
+ (str(self.key())), \
+ u"_AppEngineUtilities_SessionData_%s" % \
+ (str(self.key()))])
+ except:
+ mc = memcache.get(u"_AppEngineUtilities_Session_%s" %+ \
+ (str(self.key())))
+ if mc:
+ mc.deleted = True
+ else:
+ # not in the memcache, check to see if it should be
+ query = _AppEngineUtilities_Session.all()
+ query.filter(u"sid = ", self.sid)
+ results = query.fetch(1)
+ if len(results) > 0:
+ results[0].deleted = True
+ memcache.set(u"_AppEngineUtilities_Session_%s" % \
+ (unicode(self.key())), results[0])
+ return True
+
+class _AppEngineUtilities_SessionData(db.Model):
+ """
+ Model for the session data in the datastore.
+ """
+
+ # session_key = db.FloatProperty()
+ keyname = db.StringProperty()
+ content = db.BlobProperty()
+ model = db.ReferenceProperty()
+ session = db.ReferenceProperty(_AppEngineUtilities_Session)
+ dirty = db.BooleanProperty(default=False)
+ deleted = db.BooleanProperty(default=False)
+
+ def put(self):
+ """
+ Adds a keyname/value for session to the datastore and memcache
+
+ Returns the key from the datastore put or u"dirty"
+ """
+ # update or insert in datastore
+ try:
+ return_val = db.put(self)
+ self.dirty = False
+ except:
+ return_val = u"dirty"
+ self.dirty = True
+
+ # update or insert in memcache
+ mc_items = memcache.get(u"_AppEngineUtilities_SessionData_%s" % \
+ (str(self.session.key())))
+ if mc_items:
+ value_updated = False
+ for item in mc_items:
+ if value_updated == True:
+ break
+ if item.keyname == self.keyname:
+ item.content = self.content
+ item.model = self.model
+ memcache.set(u"_AppEngineUtilities_SessionData_%s" % \
+ (str(self.session.key())), mc_items)
+ value_updated = True
+ break
+ if value_updated == False:
+ mc_items.append(self)
+ memcache.set(u"_AppEngineUtilities_SessionData_%s" % \
+ (str(self.session.key())), mc_items)
+ return return_val
+
+ def delete(self):
+ """
+ Deletes an entity from the session in memcache and the datastore
+
+ Returns True
+ """
+ try:
+ db.delete(self)
+ except:
+ self.deleted = True
+ mc_items = memcache.get(u"_AppEngineUtilities_SessionData_%s" % \
+ (str(self.session.key())))
+ value_handled = False
+ for item in mc_items:
+ if value_handled == True:
+ break
+ if item.keyname == self.keyname:
+ if self.deleted == True:
+ item.deleted = True
+ else:
+ mc_items.remove(item)
+ memcache.set(u"_AppEngineUtilities_SessionData_%s" % \
+ (str(self.session.key())), mc_items)
+ return True
+
+
+class _DatastoreWriter(object):
+
+ def put(self, keyname, value, session):
+ """
+ Insert a keyname/value pair into the datastore for the session.
+
+ Args:
+ keyname: The keyname of the mapping.
+ value: The value of the mapping.
+
+ Returns the model entity key
+ """
+ keyname = session._validate_key(keyname)
+ if value is None:
+ raise ValueError(u"You must pass a value to put.")
+
+ # datestore write trumps cookie. If there is a cookie value
+ # with this keyname, delete it so we don't have conflicting
+ # entries.
+ if session.cookie_vals.has_key(keyname):
+ del(session.cookie_vals[keyname])
+ session.output_cookie["%s_data" % (session.cookie_name)] = \
+ simplejson.dumps(session.cookie_vals)
+ session.output_cookie["%s_data" % (session.cookie_name)]["path"] = \
+ session.cookie_path
+ if session.cookie_domain:
+ session.output_cookie["%s_data" % \
+ (session.cookie_name)]["domain"] = session.cookie_domain
+ print session.output_cookie.output()
+
+ sessdata = session._get(keyname=keyname)
+ if sessdata is None:
+ sessdata = _AppEngineUtilities_SessionData()
+ # sessdata.session_key = session.session.key()
+ sessdata.keyname = keyname
+ try:
+ db.model_to_protobuf(value)
+ if not value.is_saved():
+ value.put()
+ sessdata.model = value
+ except:
+ sessdata.content = pickle.dumps(value)
+ sessdata.model = None
+ sessdata.session = session.session
+
+ session.cache[keyname] = value
+ return sessdata.put()
+
+
+class _CookieWriter(object):
+ def put(self, keyname, value, session):
+ """
+ Insert a keyname/value pair into the datastore for the session.
+
+ Args:
+ keyname: The keyname of the mapping.
+ value: The value of the mapping.
+
+ Returns True
+ """
+ keyname = session._validate_key(keyname)
+ if value is None:
+ raise ValueError(u"You must pass a value to put.")
+
+ # Use simplejson for cookies instead of pickle.
+ session.cookie_vals[keyname] = value
+ # update the requests session cache as well.
+ session.cache[keyname] = value
+ # simplejson will raise any error I'd raise about an invalid value
+ # so let it raise exceptions
+ session.output_cookie["%s_data" % (session.cookie_name)] = \
+ simplejson.dumps(session.cookie_vals)
+ session.output_cookie["%s_data" % (session.cookie_name)]["path"] = \
+ session.cookie_path
+ if session.cookie_domain:
+ session.output_cookie["%s_data" % \
+ (session.cookie_name)]["domain"] = session.cookie_domain
+ print session.output_cookie.output()
+ return True
+
+class Session(object):
+ """
+ Sessions are used to maintain user presence between requests.
+
+ Sessions can either be stored server side in the datastore/memcache, or
+ be kept entirely as cookies. This is set either with the settings file
+ or on initialization, using the writer argument/setting field. Valid
+ values are "datastore" or "cookie".
+
+ Session can be used as a standard dictionary object.
+ session = appengine_utilities.sessions.Session()
+ session["keyname"] = "value" # sets keyname to value
+ print session["keyname"] # will print value
+
+ Datastore Writer:
+ The datastore writer was written with the focus being on security,
+ reliability, and performance. In that order.
+
+ It is based off of a session token system. All data is stored
+ server side in the datastore and memcache. A token is given to
+ the browser, and stored server side. Optionally (and on by default),
+ user agent and ip checking is enabled. Tokens have a configurable
+ time to live (TTL), which defaults to 5 seconds. The current token,
+ plus the previous 2, are valid for any request. This is done in order
+ to manage ajax enabled sites which may have more than on request
+ happening at a time. This means any token is valid for 15 seconds.
+ A request with a token who's TTL has passed will have a new token
+ generated.
+
+ In order to take advantage of the token system for an authentication
+ system, you will want to tie sessions to accounts, and make sure
+ only one session is valid for an account. You can do this by setting
+ a db.ReferenceProperty(_AppEngineUtilities_Session) attribute on
+ your user Model, and use the get_ds_entity() method on a valid
+ session to populate it on login.
+
+ Note that even with this complex system, sessions can still be hijacked
+ and it will take the user logging in to retrieve the account. In the
+ future an ssl only cookie option may be implemented for the datastore
+ writer, which would further protect the session token from being
+ sniffed, however it would be restricted to using cookies on the
+ .appspot.com domain, and ssl requests are a finite resource. This is
+ why such a thing is not currently implemented.
+
+ Session data objects are stored in the datastore pickled, so any
+ python object is valid for storage.
+
+ Cookie Writer:
+ Sessions using the cookie writer are stored entirely in the browser
+ and no interaction with the datastore is required. This creates
+ a drastic improvement in performance, but provides no security for
+ session hijack. This is useful for requests where identity is not
+ important, but you wish to keep state between requests.
+
+ Information is stored in a json format, as pickled data from the
+ server is unreliable.
+
+ Note: There is no checksum validation of session data on this method,
+ it's streamlined for pure performance. If you need to make sure data
+ is not tampered with, use the datastore writer which stores the data
+ server side.
+
+ django-middleware:
+ Included with the GAEUtilties project is a
+ django-middleware.middleware.SessionMiddleware which can be included in
+ your settings file. This uses the cookie writer for anonymous requests,
+ and you can switch to the datastore writer on user login. This will
+ require an extra set in your login process of calling
+ request.session.save() once you validated the user information. This
+ will convert the cookie writer based session to a datastore writer.
+ """
+
+ # cookie name declaration for class methods
+ COOKIE_NAME = settings.session["COOKIE_NAME"]
+
+ def __init__(self, cookie_path=settings.session["DEFAULT_COOKIE_PATH"],
+ cookie_domain=settings.session["DEFAULT_COOKIE_DOMAIN"],
+ cookie_name=settings.session["COOKIE_NAME"],
+ session_expire_time=settings.session["SESSION_EXPIRE_TIME"],
+ clean_check_percent=settings.session["CLEAN_CHECK_PERCENT"],
+ integrate_flash=settings.session["INTEGRATE_FLASH"],
+ check_ip=settings.session["CHECK_IP"],
+ check_user_agent=settings.session["CHECK_USER_AGENT"],
+ set_cookie_expires=settings.session["SET_COOKIE_EXPIRES"],
+ session_token_ttl=settings.session["SESSION_TOKEN_TTL"],
+ last_activity_update=settings.session["UPDATE_LAST_ACTIVITY"],
+ writer=settings.session["WRITER"]):
+ """
+ Initializer
+
+ Args:
+ cookie_path: The path setting for the cookie.
+ cookie_domain: The domain setting for the cookie. (Set to False
+ to not use)
+ cookie_name: The name for the session cookie stored in the browser.
+ session_expire_time: The amount of time between requests before the
+ session expires.
+ clean_check_percent: The percentage of requests the will fire off a
+ cleaning routine that deletes stale session data.
+ integrate_flash: If appengine-utilities flash utility should be
+ integrated into the session object.
+ check_ip: If browser IP should be used for session validation
+ check_user_agent: If the browser user agent should be used for
+ sessoin validation.
+ set_cookie_expires: True adds an expires field to the cookie so
+ it saves even if the browser is closed.
+ session_token_ttl: Number of sessions a session token is valid
+ for before it should be regenerated.
+ """
+
+ self.cookie_path = cookie_path
+ self.cookie_domain = cookie_domain
+ self.cookie_name = cookie_name
+ self.session_expire_time = session_expire_time
+ self.integrate_flash = integrate_flash
+ self.check_user_agent = check_user_agent
+ self.check_ip = check_ip
+ self.set_cookie_expires = set_cookie_expires
+ self.session_token_ttl = session_token_ttl
+ self.last_activity_update = last_activity_update
+ self.writer = writer
+
+ # make sure the page is not cached in the browser
+ print self.no_cache_headers()
+ # Check the cookie and, if necessary, create a new one.
+ self.cache = {}
+ string_cookie = os.environ.get(u"HTTP_COOKIE", u"")
+ self.cookie = Cookie.SimpleCookie()
+ self.output_cookie = Cookie.SimpleCookie()
+ if string_cookie == "":
+ self.cookie_vals = {}
+ else:
+ self.cookie.load(string_cookie)
+ try:
+ self.cookie_vals = \
+ simplejson.loads(self.cookie["%s_data" % (self.cookie_name)].value)
+ # sync self.cache and self.cookie_vals which will make those
+ # values available for all gets immediately.
+ for k in self.cookie_vals:
+ self.cache[k] = self.cookie_vals[k]
+ # sync the input cookie with the output cookie
+ self.output_cookie["%s_data" % (self.cookie_name)] = \
+ simplejson.dumps(self.cookie_vals) #self.cookie["%s_data" % (self.cookie_name)]
+ except Exception, e:
+ self.cookie_vals = {}
+
+
+ if writer == "cookie":
+ pass
+ else:
+ self.sid = None
+ new_session = True
+
+ # do_put is used to determine if a datastore write should
+ # happen on this request.
+ do_put = False
+
+ # check for existing cookie
+ if self.cookie.get(cookie_name):
+ self.sid = self.cookie[cookie_name].value
+ # The following will return None if the sid has expired.
+ self.session = _AppEngineUtilities_Session.get_session(self)
+ if self.session:
+ new_session = False
+
+ if new_session:
+ # start a new session
+ self.session = _AppEngineUtilities_Session()
+ self.session.put()
+ self.sid = self.new_sid()
+ if u"HTTP_USER_AGENT" in os.environ:
+ self.session.ua = os.environ[u"HTTP_USER_AGENT"]
+ else:
+ self.session.ua = None
+ if u"REMOTE_ADDR" in os.environ:
+ self.session.ip = os.environ["REMOTE_ADDR"]
+ else:
+ self.session.ip = None
+ self.session.sid = [self.sid]
+ # do put() here to get the session key
+ self.session.put()
+ else:
+ # check the age of the token to determine if a new one
+ # is required
+ duration = datetime.timedelta(seconds=self.session_token_ttl)
+ session_age_limit = datetime.datetime.now() - duration
+ if self.session.last_activity < session_age_limit:
+ self.sid = self.new_sid()
+ if len(self.session.sid) > 2:
+ self.session.sid.remove(self.session.sid[0])
+ self.session.sid.append(self.sid)
+ do_put = True
+ else:
+ self.sid = self.session.sid[-1]
+ # check if last_activity needs updated
+ ula = datetime.timedelta(seconds=self.last_activity_update)
+ if datetime.datetime.now() > self.session.last_activity + \
+ ula:
+ do_put = True
+
+ self.output_cookie[cookie_name] = self.sid
+ self.output_cookie[cookie_name]["path"] = self.cookie_path
+ if self.cookie_domain:
+ self.output_cookie[cookie_name]["domain"] = self.cookie_domain
+ if self.set_cookie_expires:
+ self.output_cookie[cookie_name]["expires"] = \
+ self.session_expire_time
+
+ self.cache[u"sid"] = self.sid
+
+ if do_put:
+ if self.sid != None or self.sid != u"":
+ self.session.put()
+
+ if self.set_cookie_expires:
+ if not self.output_cookie.has_key("%s_data" % (cookie_name)):
+ self.output_cookie["%s_data" % (cookie_name)] = u""
+ self.output_cookie["%s_data" % (cookie_name)]["expires"] = \
+ self.session_expire_time
+ print self.output_cookie.output()
+
+ # fire up a Flash object if integration is enabled
+ if self.integrate_flash:
+ import flash
+ self.flash = flash.Flash(cookie=self.cookie)
+
+ # randomly delete old stale sessions in the datastore (see
+ # CLEAN_CHECK_PERCENT variable)
+ if random.randint(1, 100) < clean_check_percent:
+ self._clean_old_sessions()
+
+ def new_sid(self):
+ """
+ Create a new session id.
+
+ Returns session id as a unicode string.
+ """
+ sid = u"%s_%s" % (str(self.session.key()),
+ hashlib.md5(repr(time.time()) + \
+ unicode(random.random())).hexdigest()
+ )
+ #sid = unicode(self.session.session_key) + "_" + \
+ # hashlib.md5(repr(time.time()) + \
+ # unicode(random.random())).hexdigest()
+ return sid
+
+ def _get(self, keyname=None):
+ """
+ private method
+
+ Return all of the SessionData object data from the datastore only,
+ unless keyname is specified, in which case only that instance of
+ SessionData is returned.
+
+ Important: This does not interact with memcache and pulls directly
+ from the datastore. This also does not get items from the cookie
+ store.
+
+ Args:
+ keyname: The keyname of the value you are trying to retrieve.
+
+ Returns a list of datastore entities.
+ """
+ if hasattr(self, 'session'):
+ if keyname != None:
+ return self.session.get_item(keyname)
+ return self.session.get_items()
+ return None
+
+ def _validate_key(self, keyname):
+ """
+ private method
+
+ Validate the keyname, making sure it is set and not a reserved name.
+
+ Returns the validated keyname.
+ """
+ if keyname is None:
+ raise ValueError(
+ u"You must pass a keyname for the session data content."
+ )
+ elif keyname in (u"sid", u"flash"):
+ raise ValueError(u"%s is a reserved keyname." % keyname)
+
+ if type(keyname) != type([str, unicode]):
+ return unicode(keyname)
+ return keyname
+
+ def _put(self, keyname, value):
+ """
+ Insert a keyname/value pair into the datastore for the session.
+
+ Args:
+ keyname: The keyname of the mapping.
+ value: The value of the mapping.
+
+ Returns the value from the writer put operation, varies based on writer.
+ """
+ if self.writer == "datastore":
+ writer = _DatastoreWriter()
+ else:
+ writer = _CookieWriter()
+
+ return writer.put(keyname, value, self)
+
+ def _delete_session(self):
+ """
+ private method
+
+ Delete the session and all session data.
+
+ Returns True.
+ """
+ # if the event class has been loaded, fire off the preSessionDelete event
+ if u"AEU_Events" in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event(u"preSessionDelete")
+ if hasattr(self, u"session"):
+ self.session.delete()
+ self.cookie_vals = {}
+ self.cache = {}
+ self.output_cookie["%s_data" % (self.cookie_name)] = \
+ simplejson.dumps(self.cookie_vals)
+ self.output_cookie["%s_data" % (self.cookie_name)]["path"] = \
+ self.cookie_path
+ if self.cookie_domain:
+ self.output_cookie["%s_data" % \
+ (self.cookie_name)]["domain"] = self.cookie_domain
+
+ print self.output_cookie.output()
+ # if the event class has been loaded, fire off the sessionDelete event
+ if u"AEU_Events" in sys.modules['__main__'].__dict__:
+ sys.modules['__main__'].AEU_Events.fire_event(u"sessionDelete")
+ return True
+
+ def delete(self):
+ """
+ Delete the current session and start a new one.
+
+ This is useful for when you need to get rid of all data tied to a
+ current session, such as when you are logging out a user.
+
+ Returns True
+ """
+ self._delete_session()
+
+ @classmethod
+ def delete_all_sessions(cls):
+ """
+ Deletes all sessions and session data from the data store. This
+ does not delete the entities from memcache (yet). Depending on the
+ amount of sessions active in your datastore, this request could
+ timeout before completion and may have to be called multiple times.
+
+ NOTE: This can not delete cookie only sessions as it has no way to
+ access them. It will only delete datastore writer sessions.
+
+ Returns True on completion.
+ """
+ all_sessions_deleted = False
+
+ while not all_sessions_deleted:
+ query = _AppEngineUtilities_Session.all()
+ results = query.fetch(75)
+ if len(results) is 0:
+ all_sessions_deleted = True
+ else:
+ for result in results:
+ result.delete()
+ return True
+
+
+ def _clean_old_sessions(self):
+ """
+ Delete 50 expired sessions from the datastore.
+
+ This is only called for CLEAN_CHECK_PERCENT percent of requests because
+ it could be rather intensive.
+
+ Returns True on completion
+ """
+ self.clean_old_sessions(self.session_expire_time, 50)
+
+
+ @classmethod
+ def clean_old_sessions(cls, session_expire_time, count=50):
+ """
+ Delete expired sessions from the datastore.
+
+ This is a class method which can be used by applications for
+ maintenance if they don't want to use the built in session
+ cleaning.
+
+ Args:
+ count: The amount of session to clean.
+ session_expire_time: The age in seconds to determine outdated
+ sessions.
+
+ Returns True on completion
+ """
+ duration = datetime.timedelta(seconds=session_expire_time)
+ session_age = datetime.datetime.now() - duration
+ query = _AppEngineUtilities_Session.all()
+ query.filter(u"last_activity <", session_age)
+ results = query.fetch(50)
+ for result in results:
+ result.delete()
+ return True
+
+ def cycle_key(self):
+ """
+ Changes the session id/token.
+
+ Returns new token.
+ """
+ self.sid = self.new_sid()
+ if len(self.session.sid) > 2:
+ self.session.sid.remove(self.session.sid[0])
+ self.session.sid.append(self.sid)
+
+ return self.sid
+
+ def flush(self):
+ """
+ Delete's the current session, creating a new one.
+
+ Returns True
+ """
+ self._delete_session()
+ self.__init__()
+ return True
+
+ def no_cache_headers(self):
+ """
+ Generates headers to avoid any page caching in the browser.
+ Useful for highly dynamic sites.
+
+ Returns a unicode string of headers.
+ """
+ return u"".join([u"Expires: Tue, 03 Jul 2001 06:00:00 GMT",
+ strftime("Last-Modified: %a, %d %b %y %H:%M:%S %Z").decode("utf-8"),
+ u"Cache-Control: no-store, no-cache, must-revalidate, max-age=0",
+ u"Cache-Control: post-check=0, pre-check=0",
+ u"Pragma: no-cache",
+ ])
+
+ def clear(self):
+ """
+ Removes session data items, doesn't delete the session. It does work
+ with cookie sessions, and must be called before any output is sent
+ to the browser, as it set cookies.
+
+ Returns True
+ """
+ sessiondata = self._get()
+ # delete from datastore
+ if sessiondata is not None:
+ for sd in sessiondata:
+ sd.delete()
+ # delete from memcache
+ self.cache = {}
+ self.cookie_vals = {}
+ self.output_cookie["%s_data" %s (self.cookie_name)] = \
+ simplejson.dumps(self.cookie_vals)
+ self.output_cookie["%s_data" % (self.cookie_name)]["path"] = \
+ self.cookie_path
+ if self.cookie_domain:
+ self.output_cookie["%s_data" % \
+ (self.cookie_name)]["domain"] = self.cookie_domain
+
+ print self.output_cookie.output()
+ return True
+
+ def has_key(self, keyname):
+ """
+ Equivalent to k in a, use that form in new code
+
+ Args:
+ keyname: keyname to check
+
+ Returns True/False
+ """
+ return self.__contains__(keyname)
+
+ def items(self):
+ """
+ Creates a copy of just the data items.
+
+ Returns dictionary of session data objects.
+ """
+ op = {}
+ for k in self:
+ op[k] = self[k]
+ return op
+
+ def keys(self):
+ """
+ Returns a list of keys.
+ """
+ l = []
+ for k in self:
+ l.append(k)
+ return l
+
+ def update(self, *dicts):
+ """
+ Updates with key/value pairs from b, overwriting existing keys
+
+ Returns None
+ """
+ for dict in dicts:
+ for k in dict:
+ self._put(k, dict[k])
+ return None
+
+ def values(self):
+ """
+ Returns a list object of just values in the session.
+ """
+ v = []
+ for k in self:
+ v.append(self[k])
+ return v
+
+ def get(self, keyname, default = None):
+ """
+ Returns either the value for the keyname or a default value
+ passed.
+
+ Args:
+ keyname: keyname to look up
+ default: (optional) value to return on keyname miss
+
+ Returns value of keyname, or default, or None
+ """
+ try:
+ return self.__getitem__(keyname)
+ except KeyError:
+ if default is not None:
+ return default
+ return None
+
+ def setdefault(self, keyname, default = None):
+ """
+ Returns either the value for the keyname or a default value
+ passed. If keyname lookup is a miss, the keyname is set with
+ a value of default.
+
+ Args:
+ keyname: keyname to look up
+ default: (optional) value to return on keyname miss
+
+ Returns value of keyname, or default, or None
+ """
+ try:
+ return self.__getitem__(keyname)
+ except KeyError:
+ if default is not None:
+ self.__setitem__(keyname, default)
+ return default
+ return None
+
+ @classmethod
+ def check_token(cls, cookie_name=COOKIE_NAME, delete_invalid=True):
+ """
+ Retrieves the token from a cookie and validates that it is
+ a valid token for an existing cookie. Cookie validation is based
+ on the token existing on a session that has not expired.
+
+ This is useful for determining if datastore or cookie writer
+ should be used in hybrid implementations.
+
+ Args:
+ cookie_name: Name of the cookie to check for a token.
+ delete_invalid: If the token is not valid, delete the session
+ cookie, to avoid datastore queries on future
+ requests.
+
+ Returns True/False
+ """
+
+ string_cookie = os.environ.get(u"HTTP_COOKIE", u"")
+ cookie = Cookie.SimpleCookie()
+ cookie.load(string_cookie)
+ if cookie.has_key(cookie_name):
+ query = _AppEngineUtilities_Session.all()
+ query.filter(u"sid", cookie[cookie_name].value)
+ results = query.fetch(1)
+ if len(results) > 0:
+ return True
+ else:
+ if delete_invalid:
+ output_cookie = Cookie.SimpleCookie()
+ output_cookie[cookie_name] = cookie[cookie_name]
+ output_cookie[cookie_name][u"expires"] = 0
+ print output_cookie.output()
+ return False
+
+ def get_ds_entity(self):
+ """
+ Will return the session entity from the datastore if one
+ exists, otherwise will return None (as in the case of cookie writer
+ session.
+ """
+ if hasattr(self, u"session"):
+ return self.session
+ return None
+
+ # Implement Python container methods
+
+ def __getitem__(self, keyname):
+ """
+ Get item from session data.
+
+ keyname: The keyname of the mapping.
+ """
+ # flash messages don't go in the datastore
+
+ if self.integrate_flash and (keyname == u"flash"):
+ return self.flash.msg
+ if keyname in self.cache:
+ return self.cache[keyname]
+ if keyname in self.cookie_vals:
+ return self.cookie_vals[keyname]
+ if hasattr(self, u"session"):
+ data = self._get(keyname)
+ if data:
+ # TODO: It's broke here, but I'm not sure why, it's
+ # returning a model object, but I can't seem to modify
+ # it.
+ try:
+ if data.model != None:
+ self.cache[keyname] = data.model
+ return self.cache[keyname]
+ else:
+ self.cache[keyname] = pickle.loads(data.content)
+ return self.cache[keyname]
+ except:
+ self.delete_item(keyname)
+
+ else:
+ raise KeyError(unicode(keyname))
+ raise KeyError(unicode(keyname))
+
+ def __setitem__(self, keyname, value):
+ """
+ Set item in session data.
+
+ Args:
+ keyname: They keyname of the mapping.
+ value: The value of mapping.
+ """
+
+ if self.integrate_flash and (keyname == u"flash"):
+ self.flash.msg = value
+ else:
+ keyname = self._validate_key(keyname)
+ self.cache[keyname] = value
+ return self._put(keyname, value)
+
+ def delete_item(self, keyname, throw_exception=False):
+ """
+ Delete item from session data, ignoring exceptions if
+ necessary.
+
+ Args:
+ keyname: The keyname of the object to delete.
+ throw_exception: false if exceptions are to be ignored.
+ Returns:
+ Nothing.
+ """
+ if throw_exception:
+ self.__delitem__(keyname)
+ return None
+ else:
+ try:
+ self.__delitem__(keyname)
+ except KeyError:
+ return None
+
+ def __delitem__(self, keyname):
+ """
+ Delete item from session data.
+
+ Args:
+ keyname: The keyname of the object to delete.
+ """
+ bad_key = False
+ sessdata = self._get(keyname = keyname)
+ if sessdata is None:
+ bad_key = True
+ else:
+ sessdata.delete()
+ if keyname in self.cookie_vals:
+ del self.cookie_vals[keyname]
+ bad_key = False
+ self.output_cookie["%s_data" % (self.cookie_name)] = \
+ simplejson.dumps(self.cookie_vals)
+ self.output_cookie["%s_data" % (self.cookie_name)]["path"] = \
+ self.cookie_path
+ if self.cookie_domain:
+ self.output_cookie["%s_data" % \
+ (self.cookie_name)]["domain"] = self.cookie_domain
+
+ print self.output_cookie.output()
+ if bad_key:
+ raise KeyError(unicode(keyname))
+ if keyname in self.cache:
+ del self.cache[keyname]
+
+ def __len__(self):
+ """
+ Return size of session.
+ """
+ # check memcache first
+ if hasattr(self, u"session"):
+ results = self._get()
+ if results is not None:
+ return len(results) + len(self.cookie_vals)
+ else:
+ return 0
+ return len(self.cookie_vals)
+
+ def __contains__(self, keyname):
+ """
+ Check if an item is in the session data.
+
+ Args:
+ keyname: The keyname being searched.
+ """
+ try:
+ self.__getitem__(keyname)
+ except KeyError:
+ return False
+ return True
+
+ def __iter__(self):
+ """
+ Iterate over the keys in the session data.
+ """
+ # try memcache first
+ if hasattr(self, u"session"):
+ vals = self._get()
+ if vals is not None:
+ for k in vals:
+ yield k.keyname
+ for k in self.cookie_vals:
+ yield k
+
+ def __str__(self):
+ """
+ Return string representation.
+ """
+ return u"{%s}" % ', '.join(['"%s" = "%s"' % (k, self[k]) for k in self])
diff --git a/samples/apps/marketplace_sample/appengine_utilities/settings_default.py b/samples/apps/marketplace_sample/appengine_utilities/settings_default.py
new file mode 100644
index 0000000..21b5577
--- /dev/null
+++ b/samples/apps/marketplace_sample/appengine_utilities/settings_default.py
@@ -0,0 +1,81 @@
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+__author__="jbowman"
+__date__ ="$Sep 11, 2009 4:20:11 PM$"
+
+
+# Configuration settings for the session class.
+session = {
+ "COOKIE_NAME": "gaeutilities_session",
+ "DEFAULT_COOKIE_PATH": "/",
+ "DEFAULT_COOKIE_DOMAIN": False, # Set to False if you do not want this value
+ # set on the cookie, otherwise put the
+ # domain value you wish used.
+ "SESSION_EXPIRE_TIME": 7200, # sessions are valid for 7200 seconds
+ # (2 hours)
+ "INTEGRATE_FLASH": True, # integrate functionality from flash module?
+ "SET_COOKIE_EXPIRES": True, # Set to True to add expiration field to
+ # cookie
+ "WRITER":"datastore", # Use the datastore writer by default.
+ # cookie is the other option.
+ "CLEAN_CHECK_PERCENT": 50, # By default, 50% of all requests will clean
+ # the datastore of expired sessions
+ "CHECK_IP": True, # validate sessions by IP
+ "CHECK_USER_AGENT": True, # validate sessions by user agent
+ "SESSION_TOKEN_TTL": 5, # Number of seconds a session token is valid
+ # for.
+ "UPDATE_LAST_ACTIVITY": 60, # Number of seconds that may pass before
+ # last_activity is updated
+}
+
+# Configuration settings for the cache class
+cache = {
+ "DEFAULT_TIMEOUT": 3600, # cache expires after one hour (3600 sec)
+ "CLEAN_CHECK_PERCENT": 50, # 50% of all requests will clean the database
+ "MAX_HITS_TO_CLEAN": 20, # the maximum number of cache hits to clean
+}
+
+# Configuration settings for the flash class
+flash = {
+ "COOKIE_NAME": "appengine-utilities-flash",
+}
+
+# Configuration settings for the paginator class
+paginator = {
+ "DEFAULT_COUNT": 10,
+ "CACHE": 10,
+ "DEFAULT_SORT_ORDER": "ASC",
+}
+
+rotmodel = {
+ "RETRY_ATTEMPTS": 3,
+ "RETRY_INTERVAL": .2,
+}
+if __name__ == "__main__":
+ print "Hello World";
+
diff --git a/samples/apps/marketplace_sample/atom/__init__.py b/samples/apps/marketplace_sample/atom/__init__.py
new file mode 100755
index 0000000..6aa96c1
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/__init__.py
@@ -0,0 +1,1484 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains classes representing Atom elements.
+
+ Module objective: provide data classes for Atom constructs. These classes hide
+ the XML-ness of Atom and provide a set of native Python classes to interact
+ with.
+
+ Conversions to and from XML should only be necessary when the Atom classes
+ "touch the wire" and are sent over HTTP. For this reason this module
+ provides methods and functions to convert Atom classes to and from strings.
+
+ For more information on the Atom data model, see RFC 4287
+ (http://www.ietf.org/rfc/rfc4287.txt)
+
+ AtomBase: A foundation class on which Atom classes are built. It
+ handles the parsing of attributes and children which are common to all
+ Atom classes. By default, the AtomBase class translates all XML child
+ nodes into ExtensionElements.
+
+ ExtensionElement: Atom allows Atom objects to contain XML which is not part
+ of the Atom specification, these are called extension elements. If a
+ classes parser encounters an unexpected XML construct, it is translated
+ into an ExtensionElement instance. ExtensionElement is designed to fully
+ capture the information in the XML. Child nodes in an XML extension are
+ turned into ExtensionElements as well.
+"""
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import warnings
+
+
+# XML namespaces which are often used in Atom entities.
+ATOM_NAMESPACE = 'http://www.w3.org/2005/Atom'
+ELEMENT_TEMPLATE = '{http://www.w3.org/2005/Atom}%s'
+APP_NAMESPACE = 'http://purl.org/atom/app#'
+APP_TEMPLATE = '{http://purl.org/atom/app#}%s'
+
+# This encoding is used for converting strings before translating the XML
+# into an object.
+XML_STRING_ENCODING = 'utf-8'
+# The desired string encoding for object members. set or monkey-patch to
+# unicode if you want object members to be Python unicode strings, instead of
+# encoded strings
+MEMBER_STRING_ENCODING = 'utf-8'
+#MEMBER_STRING_ENCODING = unicode
+
+# If True, all methods which are exclusive to v1 will raise a
+# DeprecationWarning
+ENABLE_V1_WARNINGS = False
+
+
+def v1_deprecated(warning=None):
+ """Shows a warning if ENABLE_V1_WARNINGS is True.
+
+ Function decorator used to mark methods used in v1 classes which
+ may be removed in future versions of the library.
+ """
+ warning = warning or ''
+ # This closure is what is returned from the deprecated function.
+ def mark_deprecated(f):
+ # The deprecated_function wraps the actual call to f.
+ def optional_warn_function(*args, **kwargs):
+ if ENABLE_V1_WARNINGS:
+ warnings.warn(warning, DeprecationWarning, stacklevel=2)
+ return f(*args, **kwargs)
+ # Preserve the original name to avoid masking all decorated functions as
+ # 'deprecated_function'
+ try:
+ optional_warn_function.func_name = f.func_name
+ except TypeError:
+ pass # In Python2.3 we can't set the func_name
+ return optional_warn_function
+ return mark_deprecated
+
+
+def CreateClassFromXMLString(target_class, xml_string, string_encoding=None):
+ """Creates an instance of the target class from the string contents.
+
+ Args:
+ target_class: class The class which will be instantiated and populated
+ with the contents of the XML. This class must have a _tag and a
+ _namespace class variable.
+ xml_string: str A string which contains valid XML. The root element
+ of the XML string should match the tag and namespace of the desired
+ class.
+ string_encoding: str The character encoding which the xml_string should
+ be converted to before it is interpreted and translated into
+ objects. The default is None in which case the string encoding
+ is not changed.
+
+ Returns:
+ An instance of the target class with members assigned according to the
+ contents of the XML - or None if the root XML tag and namespace did not
+ match those of the target class.
+ """
+ encoding = string_encoding or XML_STRING_ENCODING
+ if encoding and isinstance(xml_string, unicode):
+ xml_string = xml_string.encode(encoding)
+ tree = ElementTree.fromstring(xml_string)
+ return _CreateClassFromElementTree(target_class, tree)
+
+
+CreateClassFromXMLString = v1_deprecated(
+ 'Please use atom.core.parse with atom.data classes instead.')(
+ CreateClassFromXMLString)
+
+
+def _CreateClassFromElementTree(target_class, tree, namespace=None, tag=None):
+ """Instantiates the class and populates members according to the tree.
+
+ Note: Only use this function with classes that have _namespace and _tag
+ class members.
+
+ Args:
+ target_class: class The class which will be instantiated and populated
+ with the contents of the XML.
+ tree: ElementTree An element tree whose contents will be converted into
+ members of the new target_class instance.
+ namespace: str (optional) The namespace which the XML tree's root node must
+ match. If omitted, the namespace defaults to the _namespace of the
+ target class.
+ tag: str (optional) The tag which the XML tree's root node must match. If
+ omitted, the tag defaults to the _tag class member of the target
+ class.
+
+ Returns:
+ An instance of the target class - or None if the tag and namespace of
+ the XML tree's root node did not match the desired namespace and tag.
+ """
+ if namespace is None:
+ namespace = target_class._namespace
+ if tag is None:
+ tag = target_class._tag
+ if tree.tag == '{%s}%s' % (namespace, tag):
+ target = target_class()
+ target._HarvestElementTree(tree)
+ return target
+ else:
+ return None
+
+
+class ExtensionContainer(object):
+
+ def __init__(self, extension_elements=None, extension_attributes=None,
+ text=None):
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ self.text = text
+
+ __init__ = v1_deprecated(
+ 'Please use data model classes in atom.data instead.')(
+ __init__)
+
+ # Three methods to create an object from an ElementTree
+ def _HarvestElementTree(self, tree):
+ # Fill in the instance members from the contents of the XML tree.
+ for child in tree:
+ self._ConvertElementTreeToMember(child)
+ for attribute, value in tree.attrib.iteritems():
+ self._ConvertElementAttributeToMember(attribute, value)
+ # Encode the text string according to the desired encoding type. (UTF-8)
+ if tree.text:
+ if MEMBER_STRING_ENCODING is unicode:
+ self.text = tree.text
+ else:
+ self.text = tree.text.encode(MEMBER_STRING_ENCODING)
+
+ def _ConvertElementTreeToMember(self, child_tree, current_class=None):
+ self.extension_elements.append(_ExtensionElementFromElementTree(
+ child_tree))
+
+ def _ConvertElementAttributeToMember(self, attribute, value):
+ # Encode the attribute value's string with the desired type Default UTF-8
+ if value:
+ if MEMBER_STRING_ENCODING is unicode:
+ self.extension_attributes[attribute] = value
+ else:
+ self.extension_attributes[attribute] = value.encode(
+ MEMBER_STRING_ENCODING)
+
+ # One method to create an ElementTree from an object
+ def _AddMembersToElementTree(self, tree):
+ for child in self.extension_elements:
+ child._BecomeChildElement(tree)
+ for attribute, value in self.extension_attributes.iteritems():
+ if value:
+ if isinstance(value, unicode) or MEMBER_STRING_ENCODING is unicode:
+ tree.attrib[attribute] = value
+ else:
+ # Decode the value from the desired encoding (default UTF-8).
+ tree.attrib[attribute] = value.decode(MEMBER_STRING_ENCODING)
+ if self.text:
+ if isinstance(self.text, unicode) or MEMBER_STRING_ENCODING is unicode:
+ tree.text = self.text
+ else:
+ tree.text = self.text.decode(MEMBER_STRING_ENCODING)
+
+ def FindExtensions(self, tag=None, namespace=None):
+ """Searches extension elements for child nodes with the desired name.
+
+ Returns a list of extension elements within this object whose tag
+ and/or namespace match those passed in. To find all extensions in
+ a particular namespace, specify the namespace but not the tag name.
+ If you specify only the tag, the result list may contain extension
+ elements in multiple namespaces.
+
+ Args:
+ tag: str (optional) The desired tag
+ namespace: str (optional) The desired namespace
+
+ Returns:
+ A list of elements whose tag and/or namespace match the parameters
+ values
+ """
+
+ results = []
+
+ if tag and namespace:
+ for element in self.extension_elements:
+ if element.tag == tag and element.namespace == namespace:
+ results.append(element)
+ elif tag and not namespace:
+ for element in self.extension_elements:
+ if element.tag == tag:
+ results.append(element)
+ elif namespace and not tag:
+ for element in self.extension_elements:
+ if element.namespace == namespace:
+ results.append(element)
+ else:
+ for element in self.extension_elements:
+ results.append(element)
+
+ return results
+
+
+class AtomBase(ExtensionContainer):
+
+ _children = {}
+ _attributes = {}
+
+ def __init__(self, extension_elements=None, extension_attributes=None,
+ text=None):
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ self.text = text
+
+ __init__ = v1_deprecated(
+ 'Please use data model classes in atom.data instead.')(
+ __init__)
+
+ def _ConvertElementTreeToMember(self, child_tree):
+ # Find the element's tag in this class's list of child members
+ if self.__class__._children.has_key(child_tree.tag):
+ member_name = self.__class__._children[child_tree.tag][0]
+ member_class = self.__class__._children[child_tree.tag][1]
+ # If the class member is supposed to contain a list, make sure the
+ # matching member is set to a list, then append the new member
+ # instance to the list.
+ if isinstance(member_class, list):
+ if getattr(self, member_name) is None:
+ setattr(self, member_name, [])
+ getattr(self, member_name).append(_CreateClassFromElementTree(
+ member_class[0], child_tree))
+ else:
+ setattr(self, member_name,
+ _CreateClassFromElementTree(member_class, child_tree))
+ else:
+ ExtensionContainer._ConvertElementTreeToMember(self, child_tree)
+
+ def _ConvertElementAttributeToMember(self, attribute, value):
+ # Find the attribute in this class's list of attributes.
+ if self.__class__._attributes.has_key(attribute):
+ # Find the member of this class which corresponds to the XML attribute
+ # (lookup in current_class._attributes) and set this member to the
+ # desired value (using self.__dict__).
+ if value:
+ # Encode the string to capture non-ascii characters (default UTF-8)
+ if MEMBER_STRING_ENCODING is unicode:
+ setattr(self, self.__class__._attributes[attribute], value)
+ else:
+ setattr(self, self.__class__._attributes[attribute],
+ value.encode(MEMBER_STRING_ENCODING))
+ else:
+ ExtensionContainer._ConvertElementAttributeToMember(
+ self, attribute, value)
+
+ # Three methods to create an ElementTree from an object
+ def _AddMembersToElementTree(self, tree):
+ # Convert the members of this class which are XML child nodes.
+ # This uses the class's _children dictionary to find the members which
+ # should become XML child nodes.
+ member_node_names = [values[0] for tag, values in
+ self.__class__._children.iteritems()]
+ for member_name in member_node_names:
+ member = getattr(self, member_name)
+ if member is None:
+ pass
+ elif isinstance(member, list):
+ for instance in member:
+ instance._BecomeChildElement(tree)
+ else:
+ member._BecomeChildElement(tree)
+ # Convert the members of this class which are XML attributes.
+ for xml_attribute, member_name in self.__class__._attributes.iteritems():
+ member = getattr(self, member_name)
+ if member is not None:
+ if isinstance(member, unicode) or MEMBER_STRING_ENCODING is unicode:
+ tree.attrib[xml_attribute] = member
+ else:
+ tree.attrib[xml_attribute] = member.decode(MEMBER_STRING_ENCODING)
+ # Lastly, call the ExtensionContainers's _AddMembersToElementTree to
+ # convert any extension attributes.
+ ExtensionContainer._AddMembersToElementTree(self, tree)
+
+
+ def _BecomeChildElement(self, tree):
+ """
+
+ Note: Only for use with classes that have a _tag and _namespace class
+ member. It is in AtomBase so that it can be inherited but it should
+ not be called on instances of AtomBase.
+
+ """
+ new_child = ElementTree.Element('')
+ tree.append(new_child)
+ new_child.tag = '{%s}%s' % (self.__class__._namespace,
+ self.__class__._tag)
+ self._AddMembersToElementTree(new_child)
+
+ def _ToElementTree(self):
+ """
+
+ Note, this method is designed to be used only with classes that have a
+ _tag and _namespace. It is placed in AtomBase for inheritance but should
+ not be called on this class.
+
+ """
+ new_tree = ElementTree.Element('{%s}%s' % (self.__class__._namespace,
+ self.__class__._tag))
+ self._AddMembersToElementTree(new_tree)
+ return new_tree
+
+ def ToString(self, string_encoding='UTF-8'):
+ """Converts the Atom object to a string containing XML."""
+ return ElementTree.tostring(self._ToElementTree(), encoding=string_encoding)
+
+ def __str__(self):
+ return self.ToString()
+
+
+class Name(AtomBase):
+ """The atom:name element"""
+
+ _tag = 'name'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Name
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def NameFromString(xml_string):
+ return CreateClassFromXMLString(Name, xml_string)
+
+
+class Email(AtomBase):
+ """The atom:email element"""
+
+ _tag = 'email'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Email
+
+ Args:
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ text: str The text data in the this element
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def EmailFromString(xml_string):
+ return CreateClassFromXMLString(Email, xml_string)
+
+
+class Uri(AtomBase):
+ """The atom:uri element"""
+
+ _tag = 'uri'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Uri
+
+ Args:
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ text: str The text data in the this element
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def UriFromString(xml_string):
+ return CreateClassFromXMLString(Uri, xml_string)
+
+
+class Person(AtomBase):
+ """A foundation class from which atom:author and atom:contributor extend.
+
+ A person contains information like name, email address, and web page URI for
+ an author or contributor to an Atom feed.
+ """
+
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _children['{%s}name' % (ATOM_NAMESPACE)] = ('name', Name)
+ _children['{%s}email' % (ATOM_NAMESPACE)] = ('email', Email)
+ _children['{%s}uri' % (ATOM_NAMESPACE)] = ('uri', Uri)
+
+ def __init__(self, name=None, email=None, uri=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ """Foundation from which author and contributor are derived.
+
+ The constructor is provided for illustrative purposes, you should not
+ need to instantiate a Person.
+
+ Args:
+ name: Name The person's name
+ email: Email The person's email address
+ uri: Uri The URI of the person's webpage
+ extension_elements: list A list of ExtensionElement instances which are
+ children of this element.
+ extension_attributes: dict A dictionary of strings which are the values
+ for additional XML attributes of this element.
+ text: String The text contents of the element. This is the contents
+ of the Entry's XML text node. (Example: <foo>This is the text</foo>)
+ """
+
+ self.name = name
+ self.email = email
+ self.uri = uri
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ self.text = text
+
+
+class Author(Person):
+ """The atom:author element
+
+ An author is a required element in Feed.
+ """
+
+ _tag = 'author'
+ _namespace = ATOM_NAMESPACE
+ _children = Person._children.copy()
+ _attributes = Person._attributes.copy()
+ #_children = {}
+ #_attributes = {}
+
+ def __init__(self, name=None, email=None, uri=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ """Constructor for Author
+
+ Args:
+ name: Name
+ email: Email
+ uri: Uri
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ text: str The text data in the this element
+ """
+
+ self.name = name
+ self.email = email
+ self.uri = uri
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ self.text = text
+
+
+def AuthorFromString(xml_string):
+ return CreateClassFromXMLString(Author, xml_string)
+
+
+class Contributor(Person):
+ """The atom:contributor element"""
+
+ _tag = 'contributor'
+ _namespace = ATOM_NAMESPACE
+ _children = Person._children.copy()
+ _attributes = Person._attributes.copy()
+
+ def __init__(self, name=None, email=None, uri=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ """Constructor for Contributor
+
+ Args:
+ name: Name
+ email: Email
+ uri: Uri
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ text: str The text data in the this element
+ """
+
+ self.name = name
+ self.email = email
+ self.uri = uri
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ self.text = text
+
+
+def ContributorFromString(xml_string):
+ return CreateClassFromXMLString(Contributor, xml_string)
+
+
+class Link(AtomBase):
+ """The atom:link element"""
+
+ _tag = 'link'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _attributes['rel'] = 'rel'
+ _attributes['href'] = 'href'
+ _attributes['type'] = 'type'
+ _attributes['title'] = 'title'
+ _attributes['length'] = 'length'
+ _attributes['hreflang'] = 'hreflang'
+
+ def __init__(self, href=None, rel=None, link_type=None, hreflang=None,
+ title=None, length=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Link
+
+ Args:
+ href: string The href attribute of the link
+ rel: string
+ type: string
+ hreflang: string The language for the href
+ title: string
+ length: string The length of the href's destination
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ text: str The text data in the this element
+ """
+
+ self.href = href
+ self.rel = rel
+ self.type = link_type
+ self.hreflang = hreflang
+ self.title = title
+ self.length = length
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def LinkFromString(xml_string):
+ return CreateClassFromXMLString(Link, xml_string)
+
+
+class Generator(AtomBase):
+ """The atom:generator element"""
+
+ _tag = 'generator'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _attributes['uri'] = 'uri'
+ _attributes['version'] = 'version'
+
+ def __init__(self, uri=None, version=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ """Constructor for Generator
+
+ Args:
+ uri: string
+ version: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.uri = uri
+ self.version = version
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+def GeneratorFromString(xml_string):
+ return CreateClassFromXMLString(Generator, xml_string)
+
+
+class Text(AtomBase):
+ """A foundation class from which atom:title, summary, etc. extend.
+
+ This class should never be instantiated.
+ """
+
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _attributes['type'] = 'type'
+
+ def __init__(self, text_type=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Text
+
+ Args:
+ text_type: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = text_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Title(Text):
+ """The atom:title element"""
+
+ _tag = 'title'
+ _namespace = ATOM_NAMESPACE
+ _children = Text._children.copy()
+ _attributes = Text._attributes.copy()
+
+ def __init__(self, title_type=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Title
+
+ Args:
+ title_type: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = title_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def TitleFromString(xml_string):
+ return CreateClassFromXMLString(Title, xml_string)
+
+
+class Subtitle(Text):
+ """The atom:subtitle element"""
+
+ _tag = 'subtitle'
+ _namespace = ATOM_NAMESPACE
+ _children = Text._children.copy()
+ _attributes = Text._attributes.copy()
+
+ def __init__(self, subtitle_type=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Subtitle
+
+ Args:
+ subtitle_type: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = subtitle_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SubtitleFromString(xml_string):
+ return CreateClassFromXMLString(Subtitle, xml_string)
+
+
+class Rights(Text):
+ """The atom:rights element"""
+
+ _tag = 'rights'
+ _namespace = ATOM_NAMESPACE
+ _children = Text._children.copy()
+ _attributes = Text._attributes.copy()
+
+ def __init__(self, rights_type=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Rights
+
+ Args:
+ rights_type: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = rights_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def RightsFromString(xml_string):
+ return CreateClassFromXMLString(Rights, xml_string)
+
+
+class Summary(Text):
+ """The atom:summary element"""
+
+ _tag = 'summary'
+ _namespace = ATOM_NAMESPACE
+ _children = Text._children.copy()
+ _attributes = Text._attributes.copy()
+
+ def __init__(self, summary_type=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Summary
+
+ Args:
+ summary_type: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = summary_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SummaryFromString(xml_string):
+ return CreateClassFromXMLString(Summary, xml_string)
+
+
+class Content(Text):
+ """The atom:content element"""
+
+ _tag = 'content'
+ _namespace = ATOM_NAMESPACE
+ _children = Text._children.copy()
+ _attributes = Text._attributes.copy()
+ _attributes['src'] = 'src'
+
+ def __init__(self, content_type=None, src=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ """Constructor for Content
+
+ Args:
+ content_type: string
+ src: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = content_type
+ self.src = src
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+def ContentFromString(xml_string):
+ return CreateClassFromXMLString(Content, xml_string)
+
+
+class Category(AtomBase):
+ """The atom:category element"""
+
+ _tag = 'category'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _attributes['term'] = 'term'
+ _attributes['scheme'] = 'scheme'
+ _attributes['label'] = 'label'
+
+ def __init__(self, term=None, scheme=None, label=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ """Constructor for Category
+
+ Args:
+ term: str
+ scheme: str
+ label: str
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.term = term
+ self.scheme = scheme
+ self.label = label
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def CategoryFromString(xml_string):
+ return CreateClassFromXMLString(Category, xml_string)
+
+
+class Id(AtomBase):
+ """The atom:id element."""
+
+ _tag = 'id'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Id
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def IdFromString(xml_string):
+ return CreateClassFromXMLString(Id, xml_string)
+
+
+class Icon(AtomBase):
+ """The atom:icon element."""
+
+ _tag = 'icon'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Icon
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def IconFromString(xml_string):
+ return CreateClassFromXMLString(Icon, xml_string)
+
+
+class Logo(AtomBase):
+ """The atom:logo element."""
+
+ _tag = 'logo'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Logo
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def LogoFromString(xml_string):
+ return CreateClassFromXMLString(Logo, xml_string)
+
+
+class Draft(AtomBase):
+ """The app:draft element which indicates if this entry should be public."""
+
+ _tag = 'draft'
+ _namespace = APP_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for app:draft
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def DraftFromString(xml_string):
+ return CreateClassFromXMLString(Draft, xml_string)
+
+
+class Control(AtomBase):
+ """The app:control element indicating restrictions on publication.
+
+ The APP control element may contain a draft element indicating whether or
+ not this entry should be publicly available.
+ """
+
+ _tag = 'control'
+ _namespace = APP_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _children['{%s}draft' % APP_NAMESPACE] = ('draft', Draft)
+
+ def __init__(self, draft=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for app:control"""
+
+ self.draft = draft
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def ControlFromString(xml_string):
+ return CreateClassFromXMLString(Control, xml_string)
+
+
+class Date(AtomBase):
+ """A parent class for atom:updated, published, etc."""
+
+ #TODO Add text to and from time conversion methods to allow users to set
+ # the contents of a Date to a python DateTime object.
+
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Updated(Date):
+ """The atom:updated element."""
+
+ _tag = 'updated'
+ _namespace = ATOM_NAMESPACE
+ _children = Date._children.copy()
+ _attributes = Date._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Updated
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def UpdatedFromString(xml_string):
+ return CreateClassFromXMLString(Updated, xml_string)
+
+
+class Published(Date):
+ """The atom:published element."""
+
+ _tag = 'published'
+ _namespace = ATOM_NAMESPACE
+ _children = Date._children.copy()
+ _attributes = Date._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Published
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def PublishedFromString(xml_string):
+ return CreateClassFromXMLString(Published, xml_string)
+
+
+class LinkFinder(object):
+ """An "interface" providing methods to find link elements
+
+ Entry elements often contain multiple links which differ in the rel
+ attribute or content type. Often, developers are interested in a specific
+ type of link so this class provides methods to find specific classes of
+ links.
+
+ This class is used as a mixin in Atom entries and feeds.
+ """
+
+ def GetSelfLink(self):
+ """Find the first link with rel set to 'self'
+
+ Returns:
+ An atom.Link or none if none of the links had rel equal to 'self'
+ """
+
+ for a_link in self.link:
+ if a_link.rel == 'self':
+ return a_link
+ return None
+
+ def GetEditLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'edit':
+ return a_link
+ return None
+
+ def GetEditMediaLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'edit-media':
+ return a_link
+ return None
+
+ def GetNextLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'next':
+ return a_link
+ return None
+
+ def GetLicenseLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'license':
+ return a_link
+ return None
+
+ def GetAlternateLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'alternate':
+ return a_link
+ return None
+
+
+class FeedEntryParent(AtomBase, LinkFinder):
+ """A super class for atom:feed and entry, contains shared attributes"""
+
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _children['{%s}author' % ATOM_NAMESPACE] = ('author', [Author])
+ _children['{%s}category' % ATOM_NAMESPACE] = ('category', [Category])
+ _children['{%s}contributor' % ATOM_NAMESPACE] = ('contributor', [Contributor])
+ _children['{%s}id' % ATOM_NAMESPACE] = ('id', Id)
+ _children['{%s}link' % ATOM_NAMESPACE] = ('link', [Link])
+ _children['{%s}rights' % ATOM_NAMESPACE] = ('rights', Rights)
+ _children['{%s}title' % ATOM_NAMESPACE] = ('title', Title)
+ _children['{%s}updated' % ATOM_NAMESPACE] = ('updated', Updated)
+
+ def __init__(self, author=None, category=None, contributor=None,
+ atom_id=None, link=None, rights=None, title=None, updated=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ self.author = author or []
+ self.category = category or []
+ self.contributor = contributor or []
+ self.id = atom_id
+ self.link = link or []
+ self.rights = rights
+ self.title = title
+ self.updated = updated
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Source(FeedEntryParent):
+ """The atom:source element"""
+
+ _tag = 'source'
+ _namespace = ATOM_NAMESPACE
+ _children = FeedEntryParent._children.copy()
+ _attributes = FeedEntryParent._attributes.copy()
+ _children['{%s}generator' % ATOM_NAMESPACE] = ('generator', Generator)
+ _children['{%s}icon' % ATOM_NAMESPACE] = ('icon', Icon)
+ _children['{%s}logo' % ATOM_NAMESPACE] = ('logo', Logo)
+ _children['{%s}subtitle' % ATOM_NAMESPACE] = ('subtitle', Subtitle)
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ """Constructor for Source
+
+ Args:
+ author: list (optional) A list of Author instances which belong to this
+ class.
+ category: list (optional) A list of Category instances
+ contributor: list (optional) A list on Contributor instances
+ generator: Generator (optional)
+ icon: Icon (optional)
+ id: Id (optional) The entry's Id element
+ link: list (optional) A list of Link instances
+ logo: Logo (optional)
+ rights: Rights (optional) The entry's Rights element
+ subtitle: Subtitle (optional) The entry's subtitle element
+ title: Title (optional) the entry's title element
+ updated: Updated (optional) the entry's updated element
+ text: String (optional) The text contents of the element. This is the
+ contents of the Entry's XML text node.
+ (Example: <foo>This is the text</foo>)
+ extension_elements: list (optional) A list of ExtensionElement instances
+ which are children of this element.
+ extension_attributes: dict (optional) A dictionary of strings which are
+ the values for additional XML attributes of this element.
+ """
+
+ self.author = author or []
+ self.category = category or []
+ self.contributor = contributor or []
+ self.generator = generator
+ self.icon = icon
+ self.id = atom_id
+ self.link = link or []
+ self.logo = logo
+ self.rights = rights
+ self.subtitle = subtitle
+ self.title = title
+ self.updated = updated
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SourceFromString(xml_string):
+ return CreateClassFromXMLString(Source, xml_string)
+
+
+class Entry(FeedEntryParent):
+ """The atom:entry element"""
+
+ _tag = 'entry'
+ _namespace = ATOM_NAMESPACE
+ _children = FeedEntryParent._children.copy()
+ _attributes = FeedEntryParent._attributes.copy()
+ _children['{%s}content' % ATOM_NAMESPACE] = ('content', Content)
+ _children['{%s}published' % ATOM_NAMESPACE] = ('published', Published)
+ _children['{%s}source' % ATOM_NAMESPACE] = ('source', Source)
+ _children['{%s}summary' % ATOM_NAMESPACE] = ('summary', Summary)
+ _children['{%s}control' % APP_NAMESPACE] = ('control', Control)
+
+ def __init__(self, author=None, category=None, content=None,
+ contributor=None, atom_id=None, link=None, published=None, rights=None,
+ source=None, summary=None, control=None, title=None, updated=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ """Constructor for atom:entry
+
+ Args:
+ author: list A list of Author instances which belong to this class.
+ category: list A list of Category instances
+ content: Content The entry's Content
+ contributor: list A list on Contributor instances
+ id: Id The entry's Id element
+ link: list A list of Link instances
+ published: Published The entry's Published element
+ rights: Rights The entry's Rights element
+ source: Source the entry's source element
+ summary: Summary the entry's summary element
+ title: Title the entry's title element
+ updated: Updated the entry's updated element
+ control: The entry's app:control element which can be used to mark an
+ entry as a draft which should not be publicly viewable.
+ text: String The text contents of the element. This is the contents
+ of the Entry's XML text node. (Example: <foo>This is the text</foo>)
+ extension_elements: list A list of ExtensionElement instances which are
+ children of this element.
+ extension_attributes: dict A dictionary of strings which are the values
+ for additional XML attributes of this element.
+ """
+
+ self.author = author or []
+ self.category = category or []
+ self.content = content
+ self.contributor = contributor or []
+ self.id = atom_id
+ self.link = link or []
+ self.published = published
+ self.rights = rights
+ self.source = source
+ self.summary = summary
+ self.title = title
+ self.updated = updated
+ self.control = control
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ __init__ = v1_deprecated('Please use atom.data.Entry instead.')(__init__)
+
+
+def EntryFromString(xml_string):
+ return CreateClassFromXMLString(Entry, xml_string)
+
+
+class Feed(Source):
+ """The atom:feed element"""
+
+ _tag = 'feed'
+ _namespace = ATOM_NAMESPACE
+ _children = Source._children.copy()
+ _attributes = Source._attributes.copy()
+ _children['{%s}entry' % ATOM_NAMESPACE] = ('entry', [Entry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None, entry=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ """Constructor for Source
+
+ Args:
+ author: list (optional) A list of Author instances which belong to this
+ class.
+ category: list (optional) A list of Category instances
+ contributor: list (optional) A list on Contributor instances
+ generator: Generator (optional)
+ icon: Icon (optional)
+ id: Id (optional) The entry's Id element
+ link: list (optional) A list of Link instances
+ logo: Logo (optional)
+ rights: Rights (optional) The entry's Rights element
+ subtitle: Subtitle (optional) The entry's subtitle element
+ title: Title (optional) the entry's title element
+ updated: Updated (optional) the entry's updated element
+ entry: list (optional) A list of the Entry instances contained in the
+ feed.
+ text: String (optional) The text contents of the element. This is the
+ contents of the Entry's XML text node.
+ (Example: <foo>This is the text</foo>)
+ extension_elements: list (optional) A list of ExtensionElement instances
+ which are children of this element.
+ extension_attributes: dict (optional) A dictionary of strings which are
+ the values for additional XML attributes of this element.
+ """
+
+ self.author = author or []
+ self.category = category or []
+ self.contributor = contributor or []
+ self.generator = generator
+ self.icon = icon
+ self.id = atom_id
+ self.link = link or []
+ self.logo = logo
+ self.rights = rights
+ self.subtitle = subtitle
+ self.title = title
+ self.updated = updated
+ self.entry = entry or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ __init__ = v1_deprecated('Please use atom.data.Feed instead.')(__init__)
+
+
+def FeedFromString(xml_string):
+ return CreateClassFromXMLString(Feed, xml_string)
+
+
+class ExtensionElement(object):
+ """Represents extra XML elements contained in Atom classes."""
+
+ def __init__(self, tag, namespace=None, attributes=None,
+ children=None, text=None):
+ """Constructor for EtensionElement
+
+ Args:
+ namespace: string (optional) The XML namespace for this element.
+ tag: string (optional) The tag (without the namespace qualifier) for
+ this element. To reconstruct the full qualified name of the element,
+ combine this tag with the namespace.
+ attributes: dict (optinal) The attribute value string pairs for the XML
+ attributes of this element.
+ children: list (optional) A list of ExtensionElements which represent
+ the XML child nodes of this element.
+ """
+
+ self.namespace = namespace
+ self.tag = tag
+ self.attributes = attributes or {}
+ self.children = children or []
+ self.text = text
+
+ def ToString(self):
+ element_tree = self._TransferToElementTree(ElementTree.Element(''))
+ return ElementTree.tostring(element_tree, encoding="UTF-8")
+
+ def _TransferToElementTree(self, element_tree):
+ if self.tag is None:
+ return None
+
+ if self.namespace is not None:
+ element_tree.tag = '{%s}%s' % (self.namespace, self.tag)
+ else:
+ element_tree.tag = self.tag
+
+ for key, value in self.attributes.iteritems():
+ element_tree.attrib[key] = value
+
+ for child in self.children:
+ child._BecomeChildElement(element_tree)
+
+ element_tree.text = self.text
+
+ return element_tree
+
+ def _BecomeChildElement(self, element_tree):
+ """Converts this object into an etree element and adds it as a child node.
+
+ Adds self to the ElementTree. This method is required to avoid verbose XML
+ which constantly redefines the namespace.
+
+ Args:
+ element_tree: ElementTree._Element The element to which this object's XML
+ will be added.
+ """
+ new_element = ElementTree.Element('')
+ element_tree.append(new_element)
+ self._TransferToElementTree(new_element)
+
+ def FindChildren(self, tag=None, namespace=None):
+ """Searches child nodes for objects with the desired tag/namespace.
+
+ Returns a list of extension elements within this object whose tag
+ and/or namespace match those passed in. To find all children in
+ a particular namespace, specify the namespace but not the tag name.
+ If you specify only the tag, the result list may contain extension
+ elements in multiple namespaces.
+
+ Args:
+ tag: str (optional) The desired tag
+ namespace: str (optional) The desired namespace
+
+ Returns:
+ A list of elements whose tag and/or namespace match the parameters
+ values
+ """
+
+ results = []
+
+ if tag and namespace:
+ for element in self.children:
+ if element.tag == tag and element.namespace == namespace:
+ results.append(element)
+ elif tag and not namespace:
+ for element in self.children:
+ if element.tag == tag:
+ results.append(element)
+ elif namespace and not tag:
+ for element in self.children:
+ if element.namespace == namespace:
+ results.append(element)
+ else:
+ for element in self.children:
+ results.append(element)
+
+ return results
+
+
+def ExtensionElementFromString(xml_string):
+ element_tree = ElementTree.fromstring(xml_string)
+ return _ExtensionElementFromElementTree(element_tree)
+
+
+def _ExtensionElementFromElementTree(element_tree):
+ element_tag = element_tree.tag
+ if '}' in element_tag:
+ namespace = element_tag[1:element_tag.index('}')]
+ tag = element_tag[element_tag.index('}')+1:]
+ else:
+ namespace = None
+ tag = element_tag
+ extension = ExtensionElement(namespace=namespace, tag=tag)
+ for key, value in element_tree.attrib.iteritems():
+ extension.attributes[key] = value
+ for child in element_tree:
+ extension.children.append(_ExtensionElementFromElementTree(child))
+ extension.text = element_tree.text
+ return extension
+
+
+def deprecated(warning=None):
+ """Decorator to raise warning each time the function is called.
+
+ Args:
+ warning: The warning message to be displayed as a string (optinoal).
+ """
+ warning = warning or ''
+ # This closure is what is returned from the deprecated function.
+ def mark_deprecated(f):
+ # The deprecated_function wraps the actual call to f.
+ def deprecated_function(*args, **kwargs):
+ warnings.warn(warning, DeprecationWarning, stacklevel=2)
+ return f(*args, **kwargs)
+ # Preserve the original name to avoid masking all decorated functions as
+ # 'deprecated_function'
+ try:
+ deprecated_function.func_name = f.func_name
+ except TypeError:
+ # Setting the func_name is not allowed in Python2.3.
+ pass
+ return deprecated_function
+ return mark_deprecated
diff --git a/samples/apps/marketplace_sample/atom/auth.py b/samples/apps/marketplace_sample/atom/auth.py
new file mode 100644
index 0000000..1d84175
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/auth.py
@@ -0,0 +1,43 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import base64
+
+
+class BasicAuth(object):
+ """Sets the Authorization header as defined in RFC1945"""
+
+ def __init__(self, user_id, password):
+ self.basic_cookie = base64.encodestring(
+ '%s:%s' % (user_id, password)).strip()
+
+ def modify_request(self, http_request):
+ http_request.headers['Authorization'] = 'Basic %s' % self.basic_cookie
+
+ ModifyRequest = modify_request
+
+
+class NoAuth(object):
+
+ def modify_request(self, http_request):
+ pass
diff --git a/samples/apps/marketplace_sample/atom/client.py b/samples/apps/marketplace_sample/atom/client.py
new file mode 100755
index 0000000..0c516f6
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/client.py
@@ -0,0 +1,221 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""AtomPubClient provides CRUD ops. in line with the Atom Publishing Protocol.
+
+"""
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.http_core
+
+
+class Error(Exception):
+ pass
+
+
+class MissingHost(Error):
+ pass
+
+
+class AtomPubClient(object):
+ host = None
+ auth_token = None
+ ssl = False # Whether to force all requests over https
+ xoauth_requestor_id = None
+
+ def __init__(self, http_client=None, host=None, auth_token=None, source=None,
+ xoauth_requestor_id=None, **kwargs):
+ """Creates a new AtomPubClient instance.
+
+ Args:
+ source: The name of your application.
+ http_client: An object capable of performing HTTP requests through a
+ request method. This object is used to perform the request
+ when the AtomPubClient's request method is called. Used to
+ allow HTTP requests to be directed to a mock server, or use
+ an alternate library instead of the default of httplib to
+ make HTTP requests.
+ host: str The default host name to use if a host is not specified in the
+ requested URI.
+ auth_token: An object which sets the HTTP Authorization header when its
+ modify_request method is called.
+ """
+ self.http_client = http_client or atom.http_core.ProxiedHttpClient()
+ if host is not None:
+ self.host = host
+ if auth_token is not None:
+ self.auth_token = auth_token
+ self.xoauth_requestor_id = xoauth_requestor_id
+ self.source = source
+
+ def request(self, method=None, uri=None, auth_token=None,
+ http_request=None, **kwargs):
+ """Performs an HTTP request to the server indicated.
+
+ Uses the http_client instance to make the request.
+
+ Args:
+ method: The HTTP method as a string, usually one of 'GET', 'POST',
+ 'PUT', or 'DELETE'
+ uri: The URI desired as a string or atom.http_core.Uri.
+ http_request:
+ auth_token: An authorization token object whose modify_request method
+ sets the HTTP Authorization header.
+
+ Returns:
+ The results of calling self.http_client.request. With the default
+ http_client, this is an HTTP response object.
+ """
+ # Modify the request based on the AtomPubClient settings and parameters
+ # passed in to the request.
+ http_request = self.modify_request(http_request)
+ if isinstance(uri, (str, unicode)):
+ uri = atom.http_core.Uri.parse_uri(uri)
+ if uri is not None:
+ uri.modify_request(http_request)
+ if isinstance(method, (str, unicode)):
+ http_request.method = method
+ # Any unrecognized arguments are assumed to be capable of modifying the
+ # HTTP request.
+ for name, value in kwargs.iteritems():
+ if value is not None:
+ value.modify_request(http_request)
+ # Default to an http request if the protocol scheme is not set.
+ if http_request.uri.scheme is None:
+ http_request.uri.scheme = 'http'
+ # Override scheme. Force requests over https.
+ if self.ssl:
+ http_request.uri.scheme = 'https'
+ if http_request.uri.path is None:
+ http_request.uri.path = '/'
+ # Add the Authorization header at the very end. The Authorization header
+ # value may need to be calculated using information in the request.
+ if auth_token:
+ auth_token.modify_request(http_request)
+ elif self.auth_token:
+ self.auth_token.modify_request(http_request)
+ # Check to make sure there is a host in the http_request.
+ if http_request.uri.host is None:
+ raise MissingHost('No host provided in request %s %s' % (
+ http_request.method, str(http_request.uri)))
+ # Perform the fully specified request using the http_client instance.
+ # Sends the request to the server and returns the server's response.
+ return self.http_client.request(http_request)
+
+ Request = request
+
+ def get(self, uri=None, auth_token=None, http_request=None, **kwargs):
+ """Performs a request using the GET method, returns an HTTP response."""
+ return self.request(method='GET', uri=uri, auth_token=auth_token,
+ http_request=http_request, **kwargs)
+
+ Get = get
+
+ def post(self, uri=None, data=None, auth_token=None, http_request=None,
+ **kwargs):
+ """Sends data using the POST method, returns an HTTP response."""
+ return self.request(method='POST', uri=uri, auth_token=auth_token,
+ http_request=http_request, data=data, **kwargs)
+
+ Post = post
+
+ def put(self, uri=None, data=None, auth_token=None, http_request=None,
+ **kwargs):
+ """Sends data using the PUT method, returns an HTTP response."""
+ return self.request(method='PUT', uri=uri, auth_token=auth_token,
+ http_request=http_request, data=data, **kwargs)
+
+ Put = put
+
+ def delete(self, uri=None, auth_token=None, http_request=None, **kwargs):
+ """Performs a request using the DELETE method, returns an HTTP response."""
+ return self.request(method='DELETE', uri=uri, auth_token=auth_token,
+ http_request=http_request, **kwargs)
+
+ Delete = delete
+
+ def modify_request(self, http_request):
+ """Changes the HTTP request before sending it to the server.
+
+ Sets the User-Agent HTTP header and fills in the HTTP host portion
+ of the URL if one was not included in the request (for this it uses
+ the self.host member if one is set). This method is called in
+ self.request.
+
+ Args:
+ http_request: An atom.http_core.HttpRequest() (optional) If one is
+ not provided, a new HttpRequest is instantiated.
+
+ Returns:
+ An atom.http_core.HttpRequest() with the User-Agent header set and
+ if this client has a value in its host member, the host in the request
+ URL is set.
+ """
+ if http_request is None:
+ http_request = atom.http_core.HttpRequest()
+
+ if self.host is not None and http_request.uri.host is None:
+ http_request.uri.host = self.host
+
+ if self.xoauth_requestor_id is not None:
+ http_request.uri.query['xoauth_requestor_id'] = self.xoauth_requestor_id
+
+ # Set the user agent header for logging purposes.
+ if self.source:
+ http_request.headers['User-Agent'] = '%s gdata-py/2.0.15' % self.source
+ else:
+ http_request.headers['User-Agent'] = 'gdata-py/2.0.15'
+
+ return http_request
+
+ ModifyRequest = modify_request
+
+
+class CustomHeaders(object):
+ """Add custom headers to an http_request.
+
+ Usage:
+ >>> custom_headers = atom.client.CustomHeaders(header1='value1',
+ header2='value2')
+ >>> client.get(uri, custom_headers=custom_headers)
+ """
+
+ def __init__(self, **kwargs):
+ """Creates a CustomHeaders instance.
+
+ Initialize the headers dictionary with the arguments list.
+ """
+ self.headers = kwargs
+
+ def modify_request(self, http_request):
+ """Changes the HTTP request before sending it to the server.
+
+ Adds the custom headers to the HTTP request.
+
+ Args:
+ http_request: An atom.http_core.HttpRequest().
+
+ Returns:
+ An atom.http_core.HttpRequest() with the added custom headers.
+ """
+
+ for name, value in self.headers.iteritems():
+ if value is not None:
+ http_request.headers[name] = value
+ return http_request
diff --git a/samples/apps/marketplace_sample/atom/core.py b/samples/apps/marketplace_sample/atom/core.py
new file mode 100644
index 0000000..a19a70d
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/core.py
@@ -0,0 +1,550 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import inspect
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+
+
+try:
+ from xml.dom.minidom import parseString as xmlString
+except ImportError:
+ xmlString = None
+
+STRING_ENCODING = 'utf-8'
+
+
+class XmlElement(object):
+ """Represents an element node in an XML document.
+
+ The text member is a UTF-8 encoded str or unicode.
+ """
+ _qname = None
+ _other_elements = None
+ _other_attributes = None
+ # The rule set contains mappings for XML qnames to child members and the
+ # appropriate member classes.
+ _rule_set = None
+ _members = None
+ text = None
+
+ def __init__(self, text=None, *args, **kwargs):
+ if ('_members' not in self.__class__.__dict__
+ or self.__class__._members is None):
+ self.__class__._members = tuple(self.__class__._list_xml_members())
+ for member_name, member_type in self.__class__._members:
+ if member_name in kwargs:
+ setattr(self, member_name, kwargs[member_name])
+ else:
+ if isinstance(member_type, list):
+ setattr(self, member_name, [])
+ else:
+ setattr(self, member_name, None)
+ self._other_elements = []
+ self._other_attributes = {}
+ if text is not None:
+ self.text = text
+
+ def _list_xml_members(cls):
+ """Generator listing all members which are XML elements or attributes.
+
+ The following members would be considered XML members:
+ foo = 'abc' - indicates an XML attribute with the qname abc
+ foo = SomeElement - indicates an XML child element
+ foo = [AnElement] - indicates a repeating XML child element, each instance
+ will be stored in a list in this member
+ foo = ('att1', '{http://example.com/namespace}att2') - indicates an XML
+ attribute which has different parsing rules in different versions of
+ the protocol. Version 1 of the XML parsing rules will look for an
+ attribute with the qname 'att1' but verion 2 of the parsing rules will
+ look for a namespaced attribute with the local name of 'att2' and an
+ XML namespace of 'http://example.com/namespace'.
+ """
+ members = []
+ for pair in inspect.getmembers(cls):
+ if not pair[0].startswith('_') and pair[0] != 'text':
+ member_type = pair[1]
+ if (isinstance(member_type, tuple) or isinstance(member_type, list)
+ or isinstance(member_type, (str, unicode))
+ or (inspect.isclass(member_type)
+ and issubclass(member_type, XmlElement))):
+ members.append(pair)
+ return members
+
+ _list_xml_members = classmethod(_list_xml_members)
+
+ def _get_rules(cls, version):
+ """Initializes the _rule_set for the class which is used when parsing XML.
+
+ This method is used internally for parsing and generating XML for an
+ XmlElement. It is not recommended that you call this method directly.
+
+ Returns:
+ A tuple containing the XML parsing rules for the appropriate version.
+
+ The tuple looks like:
+ (qname, {sub_element_qname: (member_name, member_class, repeating), ..},
+ {attribute_qname: member_name})
+
+ To give a couple of concrete example, the atom.data.Control _get_rules
+ with version of 2 will return:
+ ('{http://www.w3.org/2007/app}control',
+ {'{http://www.w3.org/2007/app}draft': ('draft',
+ <class 'atom.data.Draft'>,
+ False)},
+ {})
+ Calling _get_rules with version 1 on gdata.data.FeedLink will produce:
+ ('{http://schemas.google.com/g/2005}feedLink',
+ {'{http://www.w3.org/2005/Atom}feed': ('feed',
+ <class 'gdata.data.GDFeed'>,
+ False)},
+ {'href': 'href', 'readOnly': 'read_only', 'countHint': 'count_hint',
+ 'rel': 'rel'})
+ """
+ # Initialize the _rule_set to make sure there is a slot available to store
+ # the parsing rules for this version of the XML schema.
+ # Look for rule set in the class __dict__ proxy so that only the
+ # _rule_set for this class will be found. By using the dict proxy
+ # we avoid finding rule_sets defined in superclasses.
+ # The four lines below provide support for any number of versions, but it
+ # runs a bit slower then hard coding slots for two versions, so I'm using
+ # the below two lines.
+ #if '_rule_set' not in cls.__dict__ or cls._rule_set is None:
+ # cls._rule_set = []
+ #while len(cls.__dict__['_rule_set']) < version:
+ # cls._rule_set.append(None)
+ # If there is no rule set cache in the class, provide slots for two XML
+ # versions. If and when there is a version 3, this list will need to be
+ # expanded.
+ if '_rule_set' not in cls.__dict__ or cls._rule_set is None:
+ cls._rule_set = [None, None]
+ # If a version higher than 2 is requested, fall back to version 2 because
+ # 2 is currently the highest supported version.
+ if version > 2:
+ return cls._get_rules(2)
+ # Check the dict proxy for the rule set to avoid finding any rule sets
+ # which belong to the superclass. We only want rule sets for this class.
+ if cls._rule_set[version-1] is None:
+ # The rule set for each version consists of the qname for this element
+ # ('{namespace}tag'), a dictionary (elements) for looking up the
+ # corresponding class member when given a child element's qname, and a
+ # dictionary (attributes) for looking up the corresponding class member
+ # when given an XML attribute's qname.
+ elements = {}
+ attributes = {}
+ if ('_members' not in cls.__dict__ or cls._members is None):
+ cls._members = tuple(cls._list_xml_members())
+ for member_name, target in cls._members:
+ if isinstance(target, list):
+ # This member points to a repeating element.
+ elements[_get_qname(target[0], version)] = (member_name, target[0],
+ True)
+ elif isinstance(target, tuple):
+ # This member points to a versioned XML attribute.
+ if version <= len(target):
+ attributes[target[version-1]] = member_name
+ else:
+ attributes[target[-1]] = member_name
+ elif isinstance(target, (str, unicode)):
+ # This member points to an XML attribute.
+ attributes[target] = member_name
+ elif issubclass(target, XmlElement):
+ # This member points to a single occurance element.
+ elements[_get_qname(target, version)] = (member_name, target, False)
+ version_rules = (_get_qname(cls, version), elements, attributes)
+ cls._rule_set[version-1] = version_rules
+ return version_rules
+ else:
+ return cls._rule_set[version-1]
+
+ _get_rules = classmethod(_get_rules)
+
+ def get_elements(self, tag=None, namespace=None, version=1):
+ """Find all sub elements which match the tag and namespace.
+
+ To find all elements in this object, call get_elements with the tag and
+ namespace both set to None (the default). This method searches through
+ the object's members and the elements stored in _other_elements which
+ did not match any of the XML parsing rules for this class.
+
+ Args:
+ tag: str
+ namespace: str
+ version: int Specifies the version of the XML rules to be used when
+ searching for matching elements.
+
+ Returns:
+ A list of the matching XmlElements.
+ """
+ matches = []
+ ignored1, elements, ignored2 = self.__class__._get_rules(version)
+ if elements:
+ for qname, element_def in elements.iteritems():
+ member = getattr(self, element_def[0])
+ if member:
+ if _qname_matches(tag, namespace, qname):
+ if element_def[2]:
+ # If this is a repeating element, copy all instances into the
+ # result list.
+ matches.extend(member)
+ else:
+ matches.append(member)
+ for element in self._other_elements:
+ if _qname_matches(tag, namespace, element._qname):
+ matches.append(element)
+ return matches
+
+ GetElements = get_elements
+ # FindExtensions and FindChildren are provided for backwards compatibility
+ # to the atom.AtomBase class.
+ # However, FindExtensions may return more results than the v1 atom.AtomBase
+ # method does, because get_elements searches both the expected children
+ # and the unexpected "other elements". The old AtomBase.FindExtensions
+ # method searched only "other elements" AKA extension_elements.
+ FindExtensions = get_elements
+ FindChildren = get_elements
+
+ def get_attributes(self, tag=None, namespace=None, version=1):
+ """Find all attributes which match the tag and namespace.
+
+ To find all attributes in this object, call get_attributes with the tag
+ and namespace both set to None (the default). This method searches
+ through the object's members and the attributes stored in
+ _other_attributes which did not fit any of the XML parsing rules for this
+ class.
+
+ Args:
+ tag: str
+ namespace: str
+ version: int Specifies the version of the XML rules to be used when
+ searching for matching attributes.
+
+ Returns:
+ A list of XmlAttribute objects for the matching attributes.
+ """
+ matches = []
+ ignored1, ignored2, attributes = self.__class__._get_rules(version)
+ if attributes:
+ for qname, attribute_def in attributes.iteritems():
+ if isinstance(attribute_def, (list, tuple)):
+ attribute_def = attribute_def[0]
+ member = getattr(self, attribute_def)
+ # TODO: ensure this hasn't broken existing behavior.
+ #member = getattr(self, attribute_def[0])
+ if member:
+ if _qname_matches(tag, namespace, qname):
+ matches.append(XmlAttribute(qname, member))
+ for qname, value in self._other_attributes.iteritems():
+ if _qname_matches(tag, namespace, qname):
+ matches.append(XmlAttribute(qname, value))
+ return matches
+
+ GetAttributes = get_attributes
+
+ def _harvest_tree(self, tree, version=1):
+ """Populates object members from the data in the tree Element."""
+ qname, elements, attributes = self.__class__._get_rules(version)
+ for element in tree:
+ if elements and element.tag in elements:
+ definition = elements[element.tag]
+ # If this is a repeating element, make sure the member is set to a
+ # list.
+ if definition[2]:
+ if getattr(self, definition[0]) is None:
+ setattr(self, definition[0], [])
+ getattr(self, definition[0]).append(_xml_element_from_tree(element,
+ definition[1], version))
+ else:
+ setattr(self, definition[0], _xml_element_from_tree(element,
+ definition[1], version))
+ else:
+ self._other_elements.append(_xml_element_from_tree(element, XmlElement,
+ version))
+ for attrib, value in tree.attrib.iteritems():
+ if attributes and attrib in attributes:
+ setattr(self, attributes[attrib], value)
+ else:
+ self._other_attributes[attrib] = value
+ if tree.text:
+ self.text = tree.text
+
+ def _to_tree(self, version=1, encoding=None):
+ new_tree = ElementTree.Element(_get_qname(self, version))
+ self._attach_members(new_tree, version, encoding)
+ return new_tree
+
+ def _attach_members(self, tree, version=1, encoding=None):
+ """Convert members to XML elements/attributes and add them to the tree.
+
+ Args:
+ tree: An ElementTree.Element which will be modified. The members of
+ this object will be added as child elements or attributes
+ according to the rules described in _expected_elements and
+ _expected_attributes. The elements and attributes stored in
+ other_attributes and other_elements are also added a children
+ of this tree.
+ version: int Ingnored in this method but used by VersionedElement.
+ encoding: str (optional)
+ """
+ qname, elements, attributes = self.__class__._get_rules(version)
+ encoding = encoding or STRING_ENCODING
+ # Add the expected elements and attributes to the tree.
+ if elements:
+ for tag, element_def in elements.iteritems():
+ member = getattr(self, element_def[0])
+ # If this is a repeating element and there are members in the list.
+ if member and element_def[2]:
+ for instance in member:
+ instance._become_child(tree, version)
+ elif member:
+ member._become_child(tree, version)
+ if attributes:
+ for attribute_tag, member_name in attributes.iteritems():
+ value = getattr(self, member_name)
+ if value:
+ tree.attrib[attribute_tag] = value
+ # Add the unexpected (other) elements and attributes to the tree.
+ for element in self._other_elements:
+ element._become_child(tree, version)
+ for key, value in self._other_attributes.iteritems():
+ # I'm not sure if unicode can be used in the attribute name, so for now
+ # we assume the encoding is correct for the attribute name.
+ if not isinstance(value, unicode):
+ value = value.decode(encoding)
+ tree.attrib[key] = value
+ if self.text:
+ if isinstance(self.text, unicode):
+ tree.text = self.text
+ else:
+ tree.text = self.text.decode(encoding)
+
+ def to_string(self, version=1, encoding=None, pretty_print=None):
+ """Converts this object to XML."""
+
+ tree_string = ElementTree.tostring(self._to_tree(version, encoding))
+
+ if pretty_print and xmlString is not None:
+ return xmlString(tree_string).toprettyxml()
+
+ return tree_string
+
+ ToString = to_string
+
+ def __str__(self):
+ return self.to_string()
+
+ def _become_child(self, tree, version=1):
+ """Adds a child element to tree with the XML data in self."""
+ new_child = ElementTree.Element('')
+ tree.append(new_child)
+ new_child.tag = _get_qname(self, version)
+ self._attach_members(new_child, version)
+
+ def __get_extension_elements(self):
+ return self._other_elements
+
+ def __set_extension_elements(self, elements):
+ self._other_elements = elements
+
+ extension_elements = property(__get_extension_elements,
+ __set_extension_elements,
+ """Provides backwards compatibility for v1 atom.AtomBase classes.""")
+
+ def __get_extension_attributes(self):
+ return self._other_attributes
+
+ def __set_extension_attributes(self, attributes):
+ self._other_attributes = attributes
+
+ extension_attributes = property(__get_extension_attributes,
+ __set_extension_attributes,
+ """Provides backwards compatibility for v1 atom.AtomBase classes.""")
+
+ def _get_tag(self, version=1):
+ qname = _get_qname(self, version)
+ if qname:
+ return qname[qname.find('}')+1:]
+ return None
+
+ def _get_namespace(self, version=1):
+ qname = _get_qname(self, version)
+ if qname.startswith('{'):
+ return qname[1:qname.find('}')]
+ else:
+ return None
+
+ def _set_tag(self, tag):
+ if isinstance(self._qname, tuple):
+ self._qname = self._qname.copy()
+ if self._qname[0].startswith('{'):
+ self._qname[0] = '{%s}%s' % (self._get_namespace(1), tag)
+ else:
+ self._qname[0] = tag
+ else:
+ if self._qname is not None and self._qname.startswith('{'):
+ self._qname = '{%s}%s' % (self._get_namespace(), tag)
+ else:
+ self._qname = tag
+
+ def _set_namespace(self, namespace):
+ tag = self._get_tag(1)
+ if tag is None:
+ tag = ''
+ if isinstance(self._qname, tuple):
+ self._qname = self._qname.copy()
+ if namespace:
+ self._qname[0] = '{%s}%s' % (namespace, tag)
+ else:
+ self._qname[0] = tag
+ else:
+ if namespace:
+ self._qname = '{%s}%s' % (namespace, tag)
+ else:
+ self._qname = tag
+
+ tag = property(_get_tag, _set_tag,
+ """Provides backwards compatibility for v1 atom.AtomBase classes.""")
+
+ namespace = property(_get_namespace, _set_namespace,
+ """Provides backwards compatibility for v1 atom.AtomBase classes.""")
+
+ # Provided for backwards compatibility to atom.ExtensionElement
+ children = extension_elements
+ attributes = extension_attributes
+
+
+def _get_qname(element, version):
+ if isinstance(element._qname, tuple):
+ if version <= len(element._qname):
+ return element._qname[version-1]
+ else:
+ return element._qname[-1]
+ else:
+ return element._qname
+
+
+def _qname_matches(tag, namespace, qname):
+ """Logic determines if a QName matches the desired local tag and namespace.
+
+ This is used in XmlElement.get_elements and XmlElement.get_attributes to
+ find matches in the element's members (among all expected-and-unexpected
+ elements-and-attributes).
+
+ Args:
+ expected_tag: string
+ expected_namespace: string
+ qname: string in the form '{xml_namespace}localtag' or 'tag' if there is
+ no namespace.
+
+ Returns:
+ boolean True if the member's tag and namespace fit the expected tag and
+ namespace.
+ """
+ # If there is no expected namespace or tag, then everything will match.
+ if qname is None:
+ member_tag = None
+ member_namespace = None
+ else:
+ if qname.startswith('{'):
+ member_namespace = qname[1:qname.index('}')]
+ member_tag = qname[qname.index('}') + 1:]
+ else:
+ member_namespace = None
+ member_tag = qname
+ return ((tag is None and namespace is None)
+ # If there is a tag, but no namespace, see if the local tag matches.
+ or (namespace is None and member_tag == tag)
+ # There was no tag, but there was a namespace so see if the namespaces
+ # match.
+ or (tag is None and member_namespace == namespace)
+ # There was no tag, and the desired elements have no namespace, so check
+ # to see that the member's namespace is None.
+ or (tag is None and namespace == ''
+ and member_namespace is None)
+ # The tag and the namespace both match.
+ or (tag == member_tag
+ and namespace == member_namespace)
+ # The tag matches, and the expected namespace is the empty namespace,
+ # check to make sure the member's namespace is None.
+ or (tag == member_tag and namespace == ''
+ and member_namespace is None))
+
+
+def parse(xml_string, target_class=None, version=1, encoding=None):
+ """Parses the XML string according to the rules for the target_class.
+
+ Args:
+ xml_string: str or unicode
+ target_class: XmlElement or a subclass. If None is specified, the
+ XmlElement class is used.
+ version: int (optional) The version of the schema which should be used when
+ converting the XML into an object. The default is 1.
+ encoding: str (optional) The character encoding of the bytes in the
+ xml_string. Default is 'UTF-8'.
+ """
+ if target_class is None:
+ target_class = XmlElement
+ if isinstance(xml_string, unicode):
+ if encoding is None:
+ xml_string = xml_string.encode(STRING_ENCODING)
+ else:
+ xml_string = xml_string.encode(encoding)
+ tree = ElementTree.fromstring(xml_string)
+ return _xml_element_from_tree(tree, target_class, version)
+
+
+Parse = parse
+xml_element_from_string = parse
+XmlElementFromString = xml_element_from_string
+
+
+def _xml_element_from_tree(tree, target_class, version=1):
+ if target_class._qname is None:
+ instance = target_class()
+ instance._qname = tree.tag
+ instance._harvest_tree(tree, version)
+ return instance
+ # TODO handle the namespace-only case
+ # Namespace only will be used with Google Spreadsheets rows and
+ # Google Base item attributes.
+ elif tree.tag == _get_qname(target_class, version):
+ instance = target_class()
+ instance._harvest_tree(tree, version)
+ return instance
+ return None
+
+
+class XmlAttribute(object):
+
+ def __init__(self, qname, value):
+ self._qname = qname
+ self.value = value
+
diff --git a/samples/apps/marketplace_sample/atom/data.py b/samples/apps/marketplace_sample/atom/data.py
new file mode 100644
index 0000000..38017ce
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/data.py
@@ -0,0 +1,338 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+
+
+XML_TEMPLATE = '{http://www.w3.org/XML/1998/namespace}%s'
+ATOM_TEMPLATE = '{http://www.w3.org/2005/Atom}%s'
+APP_TEMPLATE_V1 = '{http://purl.org/atom/app#}%s'
+APP_TEMPLATE_V2 = '{http://www.w3.org/2007/app}%s'
+
+
+class Name(atom.core.XmlElement):
+ """The atom:name element."""
+ _qname = ATOM_TEMPLATE % 'name'
+
+
+class Email(atom.core.XmlElement):
+ """The atom:email element."""
+ _qname = ATOM_TEMPLATE % 'email'
+
+
+class Uri(atom.core.XmlElement):
+ """The atom:uri element."""
+ _qname = ATOM_TEMPLATE % 'uri'
+
+
+class Person(atom.core.XmlElement):
+ """A foundation class which atom:author and atom:contributor extend.
+
+ A person contains information like name, email address, and web page URI for
+ an author or contributor to an Atom feed.
+ """
+ name = Name
+ email = Email
+ uri = Uri
+
+
+class Author(Person):
+ """The atom:author element.
+
+ An author is a required element in Feed unless each Entry contains an Author.
+ """
+ _qname = ATOM_TEMPLATE % 'author'
+
+
+class Contributor(Person):
+ """The atom:contributor element."""
+ _qname = ATOM_TEMPLATE % 'contributor'
+
+
+class Link(atom.core.XmlElement):
+ """The atom:link element."""
+ _qname = ATOM_TEMPLATE % 'link'
+ href = 'href'
+ rel = 'rel'
+ type = 'type'
+ hreflang = 'hreflang'
+ title = 'title'
+ length = 'length'
+
+
+class Generator(atom.core.XmlElement):
+ """The atom:generator element."""
+ _qname = ATOM_TEMPLATE % 'generator'
+ uri = 'uri'
+ version = 'version'
+
+
+class Text(atom.core.XmlElement):
+ """A foundation class from which atom:title, summary, etc. extend.
+
+ This class should never be instantiated.
+ """
+ type = 'type'
+
+
+class Title(Text):
+ """The atom:title element."""
+ _qname = ATOM_TEMPLATE % 'title'
+
+
+class Subtitle(Text):
+ """The atom:subtitle element."""
+ _qname = ATOM_TEMPLATE % 'subtitle'
+
+
+class Rights(Text):
+ """The atom:rights element."""
+ _qname = ATOM_TEMPLATE % 'rights'
+
+
+class Summary(Text):
+ """The atom:summary element."""
+ _qname = ATOM_TEMPLATE % 'summary'
+
+
+class Content(Text):
+ """The atom:content element."""
+ _qname = ATOM_TEMPLATE % 'content'
+ src = 'src'
+
+
+class Category(atom.core.XmlElement):
+ """The atom:category element."""
+ _qname = ATOM_TEMPLATE % 'category'
+ term = 'term'
+ scheme = 'scheme'
+ label = 'label'
+
+
+class Id(atom.core.XmlElement):
+ """The atom:id element."""
+ _qname = ATOM_TEMPLATE % 'id'
+
+
+class Icon(atom.core.XmlElement):
+ """The atom:icon element."""
+ _qname = ATOM_TEMPLATE % 'icon'
+
+
+class Logo(atom.core.XmlElement):
+ """The atom:logo element."""
+ _qname = ATOM_TEMPLATE % 'logo'
+
+
+class Draft(atom.core.XmlElement):
+ """The app:draft element which indicates if this entry should be public."""
+ _qname = (APP_TEMPLATE_V1 % 'draft', APP_TEMPLATE_V2 % 'draft')
+
+
+class Control(atom.core.XmlElement):
+ """The app:control element indicating restrictions on publication.
+
+ The APP control element may contain a draft element indicating whether or
+ not this entry should be publicly available.
+ """
+ _qname = (APP_TEMPLATE_V1 % 'control', APP_TEMPLATE_V2 % 'control')
+ draft = Draft
+
+
+class Date(atom.core.XmlElement):
+ """A parent class for atom:updated, published, etc."""
+
+
+class Updated(Date):
+ """The atom:updated element."""
+ _qname = ATOM_TEMPLATE % 'updated'
+
+
+class Published(Date):
+ """The atom:published element."""
+ _qname = ATOM_TEMPLATE % 'published'
+
+
+class LinkFinder(object):
+ """An "interface" providing methods to find link elements
+
+ Entry elements often contain multiple links which differ in the rel
+ attribute or content type. Often, developers are interested in a specific
+ type of link so this class provides methods to find specific classes of
+ links.
+
+ This class is used as a mixin in Atom entries and feeds.
+ """
+
+ def find_url(self, rel):
+ """Returns the URL (as a string) in a link with the desired rel value."""
+ for link in self.link:
+ if link.rel == rel and link.href:
+ return link.href
+ return None
+
+ FindUrl = find_url
+
+ def get_link(self, rel):
+ """Returns a link object which has the desired rel value.
+
+ If you are interested in the URL instead of the link object,
+ consider using find_url instead.
+ """
+ for link in self.link:
+ if link.rel == rel and link.href:
+ return link
+ return None
+
+ GetLink = get_link
+
+ def find_self_link(self):
+ """Find the first link with rel set to 'self'
+
+ Returns:
+ A str containing the link's href or None if none of the links had rel
+ equal to 'self'
+ """
+ return self.find_url('self')
+
+ FindSelfLink = find_self_link
+
+ def get_self_link(self):
+ return self.get_link('self')
+
+ GetSelfLink = get_self_link
+
+ def find_edit_link(self):
+ return self.find_url('edit')
+
+ FindEditLink = find_edit_link
+
+ def get_edit_link(self):
+ return self.get_link('edit')
+
+ GetEditLink = get_edit_link
+
+ def find_edit_media_link(self):
+ link = self.find_url('edit-media')
+ # Search for media-edit as well since Picasa API used media-edit instead.
+ if link is None:
+ return self.find_url('media-edit')
+ return link
+
+ FindEditMediaLink = find_edit_media_link
+
+ def get_edit_media_link(self):
+ link = self.get_link('edit-media')
+ if link is None:
+ return self.get_link('media-edit')
+ return link
+
+ GetEditMediaLink = get_edit_media_link
+
+ def find_next_link(self):
+ return self.find_url('next')
+
+ FindNextLink = find_next_link
+
+ def get_next_link(self):
+ return self.get_link('next')
+
+ GetNextLink = get_next_link
+
+ def find_license_link(self):
+ return self.find_url('license')
+
+ FindLicenseLink = find_license_link
+
+ def get_license_link(self):
+ return self.get_link('license')
+
+ GetLicenseLink = get_license_link
+
+ def find_alternate_link(self):
+ return self.find_url('alternate')
+
+ FindAlternateLink = find_alternate_link
+
+ def get_alternate_link(self):
+ return self.get_link('alternate')
+
+ GetAlternateLink = get_alternate_link
+
+
+class FeedEntryParent(atom.core.XmlElement, LinkFinder):
+ """A super class for atom:feed and entry, contains shared attributes"""
+ author = [Author]
+ category = [Category]
+ contributor = [Contributor]
+ id = Id
+ link = [Link]
+ rights = Rights
+ title = Title
+ updated = Updated
+
+ def __init__(self, atom_id=None, text=None, *args, **kwargs):
+ if atom_id is not None:
+ self.id = atom_id
+ atom.core.XmlElement.__init__(self, text=text, *args, **kwargs)
+
+
+class Source(FeedEntryParent):
+ """The atom:source element."""
+ _qname = ATOM_TEMPLATE % 'source'
+ generator = Generator
+ icon = Icon
+ logo = Logo
+ subtitle = Subtitle
+
+
+class Entry(FeedEntryParent):
+ """The atom:entry element."""
+ _qname = ATOM_TEMPLATE % 'entry'
+ content = Content
+ published = Published
+ source = Source
+ summary = Summary
+ control = Control
+
+
+class Feed(Source):
+ """The atom:feed element which contains entries."""
+ _qname = ATOM_TEMPLATE % 'feed'
+ entry = [Entry]
+
+
+class ExtensionElement(atom.core.XmlElement):
+ """Provided for backwards compatibility to the v1 atom.ExtensionElement."""
+
+ def __init__(self, tag=None, namespace=None, attributes=None,
+ children=None, text=None, *args, **kwargs):
+ if namespace:
+ self._qname = '{%s}%s' % (namespace, tag)
+ else:
+ self._qname = tag
+ self.children = children or []
+ self.attributes = attributes or {}
+ self.text = text
+
+ _BecomeChildElement = atom.core.XmlElement._become_child
diff --git a/samples/apps/marketplace_sample/atom/http.py b/samples/apps/marketplace_sample/atom/http.py
new file mode 100644
index 0000000..ee62bd0
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/http.py
@@ -0,0 +1,361 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""HttpClients in this module use httplib to make HTTP requests.
+
+This module make HTTP requests based on httplib, but there are environments
+in which an httplib based approach will not work (if running in Google App
+Engine for example). In those cases, higher level classes (like AtomService
+and GDataService) can swap out the HttpClient to transparently use a
+different mechanism for making HTTP requests.
+
+ HttpClient: Contains a request method which performs an HTTP call to the
+ server.
+
+ ProxiedHttpClient: Contains a request method which connects to a proxy using
+ settings stored in operating system environment variables then
+ performs an HTTP call to the endpoint server.
+"""
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import types
+import os
+import httplib
+import atom.url
+import atom.http_interface
+import socket
+import base64
+import atom.http_core
+ssl_imported = False
+ssl = None
+try:
+ import ssl
+ ssl_imported = True
+except ImportError:
+ pass
+
+
+
+class ProxyError(atom.http_interface.Error):
+ pass
+
+
+class TestConfigurationError(Exception):
+ pass
+
+
+DEFAULT_CONTENT_TYPE = 'application/atom+xml'
+
+
+class HttpClient(atom.http_interface.GenericHttpClient):
+ # Added to allow old v1 HttpClient objects to use the new
+ # http_code.HttpClient. Used in unit tests to inject a mock client.
+ v2_http_client = None
+
+ def __init__(self, headers=None):
+ self.debug = False
+ self.headers = headers or {}
+
+ def request(self, operation, url, data=None, headers=None):
+ """Performs an HTTP call to the server, supports GET, POST, PUT, and
+ DELETE.
+
+ Usage example, perform and HTTP GET on http://www.google.com/:
+ import atom.http
+ client = atom.http.HttpClient()
+ http_response = client.request('GET', 'http://www.google.com/')
+
+ Args:
+ operation: str The HTTP operation to be performed. This is usually one
+ of 'GET', 'POST', 'PUT', or 'DELETE'
+ data: filestream, list of parts, or other object which can be converted
+ to a string. Should be set to None when performing a GET or DELETE.
+ If data is a file-like object which can be read, this method will
+ read a chunk of 100K bytes at a time and send them.
+ If the data is a list of parts to be sent, each part will be
+ evaluated and sent.
+ url: The full URL to which the request should be sent. Can be a string
+ or atom.url.Url.
+ headers: dict of strings. HTTP headers which should be sent
+ in the request.
+ """
+ all_headers = self.headers.copy()
+ if headers:
+ all_headers.update(headers)
+
+ # If the list of headers does not include a Content-Length, attempt to
+ # calculate it based on the data object.
+ if data and 'Content-Length' not in all_headers:
+ if isinstance(data, types.StringTypes):
+ all_headers['Content-Length'] = str(len(data))
+ else:
+ raise atom.http_interface.ContentLengthRequired('Unable to calculate '
+ 'the length of the data parameter. Specify a value for '
+ 'Content-Length')
+
+ # Set the content type to the default value if none was set.
+ if 'Content-Type' not in all_headers:
+ all_headers['Content-Type'] = DEFAULT_CONTENT_TYPE
+
+ if self.v2_http_client is not None:
+ http_request = atom.http_core.HttpRequest(method=operation)
+ atom.http_core.Uri.parse_uri(str(url)).modify_request(http_request)
+ http_request.headers = all_headers
+ if data:
+ http_request._body_parts.append(data)
+ return self.v2_http_client.request(http_request=http_request)
+
+ if not isinstance(url, atom.url.Url):
+ if isinstance(url, types.StringTypes):
+ url = atom.url.parse_url(url)
+ else:
+ raise atom.http_interface.UnparsableUrlObject('Unable to parse url '
+ 'parameter because it was not a string or atom.url.Url')
+
+ connection = self._prepare_connection(url, all_headers)
+
+ if self.debug:
+ connection.debuglevel = 1
+
+ connection.putrequest(operation, self._get_access_url(url),
+ skip_host=True)
+ if url.port is not None:
+ connection.putheader('Host', '%s:%s' % (url.host, url.port))
+ else:
+ connection.putheader('Host', url.host)
+
+ # Overcome a bug in Python 2.4 and 2.5
+ # httplib.HTTPConnection.putrequest adding
+ # HTTP request header 'Host: www.google.com:443' instead of
+ # 'Host: www.google.com', and thus resulting the error message
+ # 'Token invalid - AuthSub token has wrong scope' in the HTTP response.
+ if (url.protocol == 'https' and int(url.port or 443) == 443 and
+ hasattr(connection, '_buffer') and
+ isinstance(connection._buffer, list)):
+ header_line = 'Host: %s:443' % url.host
+ replacement_header_line = 'Host: %s' % url.host
+ try:
+ connection._buffer[connection._buffer.index(header_line)] = (
+ replacement_header_line)
+ except ValueError: # header_line missing from connection._buffer
+ pass
+
+ # Send the HTTP headers.
+ for header_name in all_headers:
+ connection.putheader(header_name, all_headers[header_name])
+ connection.endheaders()
+
+ # If there is data, send it in the request.
+ if data:
+ if isinstance(data, list):
+ for data_part in data:
+ _send_data_part(data_part, connection)
+ else:
+ _send_data_part(data, connection)
+
+ # Return the HTTP Response from the server.
+ return connection.getresponse()
+
+ def _prepare_connection(self, url, headers):
+ if not isinstance(url, atom.url.Url):
+ if isinstance(url, types.StringTypes):
+ url = atom.url.parse_url(url)
+ else:
+ raise atom.http_interface.UnparsableUrlObject('Unable to parse url '
+ 'parameter because it was not a string or atom.url.Url')
+ if url.protocol == 'https':
+ if not url.port:
+ return httplib.HTTPSConnection(url.host)
+ return httplib.HTTPSConnection(url.host, int(url.port))
+ else:
+ if not url.port:
+ return httplib.HTTPConnection(url.host)
+ return httplib.HTTPConnection(url.host, int(url.port))
+
+ def _get_access_url(self, url):
+ return url.to_string()
+
+
+class ProxiedHttpClient(HttpClient):
+ """Performs an HTTP request through a proxy.
+
+ The proxy settings are obtained from enviroment variables. The URL of the
+ proxy server is assumed to be stored in the environment variables
+ 'https_proxy' and 'http_proxy' respectively. If the proxy server requires
+ a Basic Auth authorization header, the username and password are expected to
+ be in the 'proxy-username' or 'proxy_username' variable and the
+ 'proxy-password' or 'proxy_password' variable, or in 'http_proxy' or
+ 'https_proxy' as "protocol://[username:password@]host:port".
+
+ After connecting to the proxy server, the request is completed as in
+ HttpClient.request.
+ """
+ def _prepare_connection(self, url, headers):
+ proxy_settings = os.environ.get('%s_proxy' % url.protocol)
+ if not proxy_settings:
+ # The request was HTTP or HTTPS, but there was no appropriate proxy set.
+ return HttpClient._prepare_connection(self, url, headers)
+ else:
+ proxy_auth = _get_proxy_auth(proxy_settings)
+ proxy_netloc = _get_proxy_net_location(proxy_settings)
+ if url.protocol == 'https':
+ # Set any proxy auth headers
+ if proxy_auth:
+ proxy_auth = 'Proxy-authorization: %s' % proxy_auth
+
+ # Construct the proxy connect command.
+ port = url.port
+ if not port:
+ port = '443'
+ proxy_connect = 'CONNECT %s:%s HTTP/1.0\r\n' % (url.host, port)
+
+ # Set the user agent to send to the proxy
+ if headers and 'User-Agent' in headers:
+ user_agent = 'User-Agent: %s\r\n' % (headers['User-Agent'])
+ else:
+ user_agent = 'User-Agent: python\r\n'
+
+ proxy_pieces = '%s%s%s\r\n' % (proxy_connect, proxy_auth, user_agent)
+
+ # Find the proxy host and port.
+ proxy_url = atom.url.parse_url(proxy_netloc)
+ if not proxy_url.port:
+ proxy_url.port = '80'
+
+ # Connect to the proxy server, very simple recv and error checking
+ p_sock = socket.socket(socket.AF_INET,socket.SOCK_STREAM)
+ p_sock.connect((proxy_url.host, int(proxy_url.port)))
+ p_sock.sendall(proxy_pieces)
+ response = ''
+
+ # Wait for the full response.
+ while response.find("\r\n\r\n") == -1:
+ response += p_sock.recv(8192)
+
+ p_status = response.split()[1]
+ if p_status != str(200):
+ raise ProxyError('Error status=%s' % str(p_status))
+
+ # Trivial setup for ssl socket.
+ sslobj = None
+ if ssl_imported:
+ sslobj = ssl.wrap_socket(p_sock, None, None)
+ else:
+ sock_ssl = socket.ssl(p_sock, None, None)
+ sslobj = httplib.FakeSocket(p_sock, sock_ssl)
+
+ # Initalize httplib and replace with the proxy socket.
+ connection = httplib.HTTPConnection(proxy_url.host)
+ connection.sock = sslobj
+ return connection
+ else:
+ # If protocol was not https.
+ # Find the proxy host and port.
+ proxy_url = atom.url.parse_url(proxy_netloc)
+ if not proxy_url.port:
+ proxy_url.port = '80'
+
+ if proxy_auth:
+ headers['Proxy-Authorization'] = proxy_auth.strip()
+
+ return httplib.HTTPConnection(proxy_url.host, int(proxy_url.port))
+
+ def _get_access_url(self, url):
+ return url.to_string()
+
+
+def _get_proxy_auth(proxy_settings):
+ """Returns proxy authentication string for header.
+
+ Will check environment variables for proxy authentication info, starting with
+ proxy(_/-)username and proxy(_/-)password before checking the given
+ proxy_settings for a [protocol://]username:password@host[:port] string.
+
+ Args:
+ proxy_settings: String from http_proxy or https_proxy environment variable.
+
+ Returns:
+ Authentication string for proxy, or empty string if no proxy username was
+ found.
+ """
+ proxy_username = None
+ proxy_password = None
+
+ proxy_username = os.environ.get('proxy-username')
+ if not proxy_username:
+ proxy_username = os.environ.get('proxy_username')
+ proxy_password = os.environ.get('proxy-password')
+ if not proxy_password:
+ proxy_password = os.environ.get('proxy_password')
+
+ if not proxy_username:
+ if '@' in proxy_settings:
+ protocol_and_proxy_auth = proxy_settings.split('@')[0].split(':')
+ if len(protocol_and_proxy_auth) == 3:
+ # 3 elements means we have [<protocol>, //<user>, <password>]
+ proxy_username = protocol_and_proxy_auth[1].lstrip('/')
+ proxy_password = protocol_and_proxy_auth[2]
+ elif len(protocol_and_proxy_auth) == 2:
+ # 2 elements means we have [<user>, <password>]
+ proxy_username = protocol_and_proxy_auth[0]
+ proxy_password = protocol_and_proxy_auth[1]
+ if proxy_username:
+ user_auth = base64.encodestring('%s:%s' % (proxy_username,
+ proxy_password))
+ return 'Basic %s\r\n' % (user_auth.strip())
+ else:
+ return ''
+
+
+def _get_proxy_net_location(proxy_settings):
+ """Returns proxy host and port.
+
+ Args:
+ proxy_settings: String from http_proxy or https_proxy environment variable.
+ Must be in the form of protocol://[username:password@]host:port
+
+ Returns:
+ String in the form of protocol://host:port
+ """
+ if '@' in proxy_settings:
+ protocol = proxy_settings.split(':')[0]
+ netloc = proxy_settings.split('@')[1]
+ return '%s://%s' % (protocol, netloc)
+ else:
+ return proxy_settings
+
+
+def _send_data_part(data, connection):
+ if isinstance(data, types.StringTypes):
+ connection.send(data)
+ return
+ # Check to see if data is a file-like object that has a read method.
+ elif hasattr(data, 'read'):
+ # Read the file and send it a chunk at a time.
+ while 1:
+ binarydata = data.read(100000)
+ if binarydata == '': break
+ connection.send(binarydata)
+ return
+ else:
+ # The data object was not a file.
+ # Try to convert to a string and send the data.
+ connection.send(str(data))
+ return
diff --git a/samples/apps/marketplace_sample/atom/http_core.py b/samples/apps/marketplace_sample/atom/http_core.py
new file mode 100644
index 0000000..0889f3e
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/http_core.py
@@ -0,0 +1,597 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+# TODO: add proxy handling.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import os
+import StringIO
+import urlparse
+import urllib
+import httplib
+ssl = None
+try:
+ import ssl
+except ImportError:
+ pass
+
+
+
+class Error(Exception):
+ pass
+
+
+class UnknownSize(Error):
+ pass
+
+
+class ProxyError(Error):
+ pass
+
+
+MIME_BOUNDARY = 'END_OF_PART'
+
+
+def get_headers(http_response):
+ """Retrieves all HTTP headers from an HTTP response from the server.
+
+ This method is provided for backwards compatibility for Python2.2 and 2.3.
+ The httplib.HTTPResponse object in 2.2 and 2.3 does not have a getheaders
+ method so this function will use getheaders if available, but if not it
+ will retrieve a few using getheader.
+ """
+ if hasattr(http_response, 'getheaders'):
+ return http_response.getheaders()
+ else:
+ headers = []
+ for header in (
+ 'location', 'content-type', 'content-length', 'age', 'allow',
+ 'cache-control', 'content-location', 'content-encoding', 'date',
+ 'etag', 'expires', 'last-modified', 'pragma', 'server',
+ 'set-cookie', 'transfer-encoding', 'vary', 'via', 'warning',
+ 'www-authenticate', 'gdata-version'):
+ value = http_response.getheader(header, None)
+ if value is not None:
+ headers.append((header, value))
+ return headers
+
+
+class HttpRequest(object):
+ """Contains all of the parameters for an HTTP 1.1 request.
+
+ The HTTP headers are represented by a dictionary, and it is the
+ responsibility of the user to ensure that duplicate field names are combined
+ into one header value according to the rules in section 4.2 of RFC 2616.
+ """
+ method = None
+ uri = None
+
+ def __init__(self, uri=None, method=None, headers=None):
+ """Construct an HTTP request.
+
+ Args:
+ uri: The full path or partial path as a Uri object or a string.
+ method: The HTTP method for the request, examples include 'GET', 'POST',
+ etc.
+ headers: dict of strings The HTTP headers to include in the request.
+ """
+ self.headers = headers or {}
+ self._body_parts = []
+ if method is not None:
+ self.method = method
+ if isinstance(uri, (str, unicode)):
+ uri = Uri.parse_uri(uri)
+ self.uri = uri or Uri()
+
+
+ def add_body_part(self, data, mime_type, size=None):
+ """Adds data to the HTTP request body.
+
+ If more than one part is added, this is assumed to be a mime-multipart
+ request. This method is designed to create MIME 1.0 requests as specified
+ in RFC 1341.
+
+ Args:
+ data: str or a file-like object containing a part of the request body.
+ mime_type: str The MIME type describing the data
+ size: int Required if the data is a file like object. If the data is a
+ string, the size is calculated so this parameter is ignored.
+ """
+ if isinstance(data, str):
+ size = len(data)
+ if size is None:
+ # TODO: support chunked transfer if some of the body is of unknown size.
+ raise UnknownSize('Each part of the body must have a known size.')
+ if 'Content-Length' in self.headers:
+ content_length = int(self.headers['Content-Length'])
+ else:
+ content_length = 0
+ # If this is the first part added to the body, then this is not a multipart
+ # request.
+ if len(self._body_parts) == 0:
+ self.headers['Content-Type'] = mime_type
+ content_length = size
+ self._body_parts.append(data)
+ elif len(self._body_parts) == 1:
+ # This is the first member in a mime-multipart request, so change the
+ # _body_parts list to indicate a multipart payload.
+ self._body_parts.insert(0, 'Media multipart posting')
+ boundary_string = '\r\n--%s\r\n' % (MIME_BOUNDARY,)
+ content_length += len(boundary_string) + size
+ self._body_parts.insert(1, boundary_string)
+ content_length += len('Media multipart posting')
+ # Put the content type of the first part of the body into the multipart
+ # payload.
+ original_type_string = 'Content-Type: %s\r\n\r\n' % (
+ self.headers['Content-Type'],)
+ self._body_parts.insert(2, original_type_string)
+ content_length += len(original_type_string)
+ boundary_string = '\r\n--%s\r\n' % (MIME_BOUNDARY,)
+ self._body_parts.append(boundary_string)
+ content_length += len(boundary_string)
+ # Change the headers to indicate this is now a mime multipart request.
+ self.headers['Content-Type'] = 'multipart/related; boundary="%s"' % (
+ MIME_BOUNDARY,)
+ self.headers['MIME-version'] = '1.0'
+ # Include the mime type of this part.
+ type_string = 'Content-Type: %s\r\n\r\n' % (mime_type)
+ self._body_parts.append(type_string)
+ content_length += len(type_string)
+ self._body_parts.append(data)
+ ending_boundary_string = '\r\n--%s--' % (MIME_BOUNDARY,)
+ self._body_parts.append(ending_boundary_string)
+ content_length += len(ending_boundary_string)
+ else:
+ # This is a mime multipart request.
+ boundary_string = '\r\n--%s\r\n' % (MIME_BOUNDARY,)
+ self._body_parts.insert(-1, boundary_string)
+ content_length += len(boundary_string) + size
+ # Include the mime type of this part.
+ type_string = 'Content-Type: %s\r\n\r\n' % (mime_type)
+ self._body_parts.insert(-1, type_string)
+ content_length += len(type_string)
+ self._body_parts.insert(-1, data)
+ self.headers['Content-Length'] = str(content_length)
+ # I could add an "append_to_body_part" method as well.
+
+ AddBodyPart = add_body_part
+
+ def add_form_inputs(self, form_data,
+ mime_type='application/x-www-form-urlencoded'):
+ """Form-encodes and adds data to the request body.
+
+ Args:
+ form_data: dict or sequnce or two member tuples which contains the
+ form keys and values.
+ mime_type: str The MIME type of the form data being sent. Defaults
+ to 'application/x-www-form-urlencoded'.
+ """
+ body = urllib.urlencode(form_data)
+ self.add_body_part(body, mime_type)
+
+ AddFormInputs = add_form_inputs
+
+ def _copy(self):
+ """Creates a deep copy of this request."""
+ copied_uri = Uri(self.uri.scheme, self.uri.host, self.uri.port,
+ self.uri.path, self.uri.query.copy())
+ new_request = HttpRequest(uri=copied_uri, method=self.method,
+ headers=self.headers.copy())
+ new_request._body_parts = self._body_parts[:]
+ return new_request
+
+ def _dump(self):
+ """Converts to a printable string for debugging purposes.
+
+ In order to preserve the request, it does not read from file-like objects
+ in the body.
+ """
+ output = 'HTTP Request\n method: %s\n url: %s\n headers:\n' % (
+ self.method, str(self.uri))
+ for header, value in self.headers.iteritems():
+ output += ' %s: %s\n' % (header, value)
+ output += ' body sections:\n'
+ i = 0
+ for part in self._body_parts:
+ if isinstance(part, (str, unicode)):
+ output += ' %s: %s\n' % (i, part)
+ else:
+ output += ' %s: <file like object>\n' % i
+ i += 1
+ return output
+
+
+def _apply_defaults(http_request):
+ if http_request.uri.scheme is None:
+ if http_request.uri.port == 443:
+ http_request.uri.scheme = 'https'
+ else:
+ http_request.uri.scheme = 'http'
+
+
+class Uri(object):
+ """A URI as used in HTTP 1.1"""
+ scheme = None
+ host = None
+ port = None
+ path = None
+
+ def __init__(self, scheme=None, host=None, port=None, path=None, query=None):
+ """Constructor for a URI.
+
+ Args:
+ scheme: str This is usually 'http' or 'https'.
+ host: str The host name or IP address of the desired server.
+ post: int The server's port number.
+ path: str The path of the resource following the host. This begins with
+ a /, example: '/calendar/feeds/default/allcalendars/full'
+ query: dict of strings The URL query parameters. The keys and values are
+ both escaped so this dict should contain the unescaped values.
+ For example {'my key': 'val', 'second': '!!!'} will become
+ '?my+key=val&second=%21%21%21' which is appended to the path.
+ """
+ self.query = query or {}
+ if scheme is not None:
+ self.scheme = scheme
+ if host is not None:
+ self.host = host
+ if port is not None:
+ self.port = port
+ if path:
+ self.path = path
+
+ def _get_query_string(self):
+ param_pairs = []
+ for key, value in self.query.iteritems():
+ param_pairs.append('='.join((urllib.quote_plus(key),
+ urllib.quote_plus(str(value)))))
+ return '&'.join(param_pairs)
+
+ def _get_relative_path(self):
+ """Returns the path with the query parameters escaped and appended."""
+ param_string = self._get_query_string()
+ if self.path is None:
+ path = '/'
+ else:
+ path = self.path
+ if param_string:
+ return '?'.join([path, param_string])
+ else:
+ return path
+
+ def _to_string(self):
+ if self.scheme is None and self.port == 443:
+ scheme = 'https'
+ elif self.scheme is None:
+ scheme = 'http'
+ else:
+ scheme = self.scheme
+ if self.path is None:
+ path = '/'
+ else:
+ path = self.path
+ if self.port is None:
+ return '%s://%s%s' % (scheme, self.host, self._get_relative_path())
+ else:
+ return '%s://%s:%s%s' % (scheme, self.host, str(self.port),
+ self._get_relative_path())
+
+ def __str__(self):
+ return self._to_string()
+
+ def modify_request(self, http_request=None):
+ """Sets HTTP request components based on the URI."""
+ if http_request is None:
+ http_request = HttpRequest()
+ if http_request.uri is None:
+ http_request.uri = Uri()
+ # Determine the correct scheme.
+ if self.scheme:
+ http_request.uri.scheme = self.scheme
+ if self.port:
+ http_request.uri.port = self.port
+ if self.host:
+ http_request.uri.host = self.host
+ # Set the relative uri path
+ if self.path:
+ http_request.uri.path = self.path
+ if self.query:
+ http_request.uri.query = self.query.copy()
+ return http_request
+
+ ModifyRequest = modify_request
+
+ def parse_uri(uri_string):
+ """Creates a Uri object which corresponds to the URI string.
+
+ This method can accept partial URIs, but it will leave missing
+ members of the Uri unset.
+ """
+ parts = urlparse.urlparse(uri_string)
+ uri = Uri()
+ if parts[0]:
+ uri.scheme = parts[0]
+ if parts[1]:
+ host_parts = parts[1].split(':')
+ if host_parts[0]:
+ uri.host = host_parts[0]
+ if len(host_parts) > 1:
+ uri.port = int(host_parts[1])
+ if parts[2]:
+ uri.path = parts[2]
+ if parts[4]:
+ param_pairs = parts[4].split('&')
+ for pair in param_pairs:
+ pair_parts = pair.split('=')
+ if len(pair_parts) > 1:
+ uri.query[urllib.unquote_plus(pair_parts[0])] = (
+ urllib.unquote_plus(pair_parts[1]))
+ elif len(pair_parts) == 1:
+ uri.query[urllib.unquote_plus(pair_parts[0])] = None
+ return uri
+
+ parse_uri = staticmethod(parse_uri)
+
+ ParseUri = parse_uri
+
+
+parse_uri = Uri.parse_uri
+
+
+ParseUri = Uri.parse_uri
+
+
+class HttpResponse(object):
+ status = None
+ reason = None
+ _body = None
+
+ def __init__(self, status=None, reason=None, headers=None, body=None):
+ self._headers = headers or {}
+ if status is not None:
+ self.status = status
+ if reason is not None:
+ self.reason = reason
+ if body is not None:
+ if hasattr(body, 'read'):
+ self._body = body
+ else:
+ self._body = StringIO.StringIO(body)
+
+ def getheader(self, name, default=None):
+ if name in self._headers:
+ return self._headers[name]
+ else:
+ return default
+
+ def getheaders(self):
+ return self._headers
+
+ def read(self, amt=None):
+ if self._body is None:
+ return None
+ if not amt:
+ return self._body.read()
+ else:
+ return self._body.read(amt)
+
+
+def _dump_response(http_response):
+ """Converts to a string for printing debug messages.
+
+ Does not read the body since that may consume the content.
+ """
+ output = 'HttpResponse\n status: %s\n reason: %s\n headers:' % (
+ http_response.status, http_response.reason)
+ headers = get_headers(http_response)
+ if isinstance(headers, dict):
+ for header, value in headers.iteritems():
+ output += ' %s: %s\n' % (header, value)
+ else:
+ for pair in headers:
+ output += ' %s: %s\n' % (pair[0], pair[1])
+ return output
+
+
+class HttpClient(object):
+ """Performs HTTP requests using httplib."""
+ debug = None
+
+ def request(self, http_request):
+ return self._http_request(http_request.method, http_request.uri,
+ http_request.headers, http_request._body_parts)
+
+ Request = request
+
+ def _get_connection(self, uri, headers=None):
+ """Opens a socket connection to the server to set up an HTTP request.
+
+ Args:
+ uri: The full URL for the request as a Uri object.
+ headers: A dict of string pairs containing the HTTP headers for the
+ request.
+ """
+ connection = None
+ if uri.scheme == 'https':
+ if not uri.port:
+ connection = httplib.HTTPSConnection(uri.host)
+ else:
+ connection = httplib.HTTPSConnection(uri.host, int(uri.port))
+ else:
+ if not uri.port:
+ connection = httplib.HTTPConnection(uri.host)
+ else:
+ connection = httplib.HTTPConnection(uri.host, int(uri.port))
+ return connection
+
+ def _http_request(self, method, uri, headers=None, body_parts=None):
+ """Makes an HTTP request using httplib.
+
+ Args:
+ method: str example: 'GET', 'POST', 'PUT', 'DELETE', etc.
+ uri: str or atom.http_core.Uri
+ headers: dict of strings mapping to strings which will be sent as HTTP
+ headers in the request.
+ body_parts: list of strings, objects with a read method, or objects
+ which can be converted to strings using str. Each of these
+ will be sent in order as the body of the HTTP request.
+ """
+ if isinstance(uri, (str, unicode)):
+ uri = Uri.parse_uri(uri)
+
+ connection = self._get_connection(uri, headers=headers)
+
+ if self.debug:
+ connection.debuglevel = 1
+
+ if connection.host != uri.host:
+ connection.putrequest(method, str(uri))
+ else:
+ connection.putrequest(method, uri._get_relative_path())
+
+ # Overcome a bug in Python 2.4 and 2.5
+ # httplib.HTTPConnection.putrequest adding
+ # HTTP request header 'Host: www.google.com:443' instead of
+ # 'Host: www.google.com', and thus resulting the error message
+ # 'Token invalid - AuthSub token has wrong scope' in the HTTP response.
+ if (uri.scheme == 'https' and int(uri.port or 443) == 443 and
+ hasattr(connection, '_buffer') and
+ isinstance(connection._buffer, list)):
+ header_line = 'Host: %s:443' % uri.host
+ replacement_header_line = 'Host: %s' % uri.host
+ try:
+ connection._buffer[connection._buffer.index(header_line)] = (
+ replacement_header_line)
+ except ValueError: # header_line missing from connection._buffer
+ pass
+
+ # Send the HTTP headers.
+ for header_name, value in headers.iteritems():
+ connection.putheader(header_name, value)
+ connection.endheaders()
+
+ # If there is data, send it in the request.
+ if body_parts and filter(lambda x: x != '', body_parts):
+ for part in body_parts:
+ _send_data_part(part, connection)
+
+ # Return the HTTP Response from the server.
+ return connection.getresponse()
+
+
+def _send_data_part(data, connection):
+ if isinstance(data, (str, unicode)):
+ # I might want to just allow str, not unicode.
+ connection.send(data)
+ return
+ # Check to see if data is a file-like object that has a read method.
+ elif hasattr(data, 'read'):
+ # Read the file and send it a chunk at a time.
+ while 1:
+ binarydata = data.read(100000)
+ if binarydata == '': break
+ connection.send(binarydata)
+ return
+ else:
+ # The data object was not a file.
+ # Try to convert to a string and send the data.
+ connection.send(str(data))
+ return
+
+
+class ProxiedHttpClient(HttpClient):
+
+ def _get_connection(self, uri, headers=None):
+ # Check to see if there are proxy settings required for this request.
+ proxy = None
+ if uri.scheme == 'https':
+ proxy = os.environ.get('https_proxy')
+ elif uri.scheme == 'http':
+ proxy = os.environ.get('http_proxy')
+ if not proxy:
+ return HttpClient._get_connection(self, uri, headers=headers)
+ # Now we have the URL of the appropriate proxy server.
+ # Get a username and password for the proxy if required.
+ proxy_auth = _get_proxy_auth()
+ if uri.scheme == 'https':
+ import socket
+ if proxy_auth:
+ proxy_auth = 'Proxy-authorization: %s' % proxy_auth
+ # Construct the proxy connect command.
+ port = uri.port
+ if not port:
+ port = 443
+ proxy_connect = 'CONNECT %s:%s HTTP/1.0\r\n' % (uri.host, port)
+ # Set the user agent to send to the proxy
+ user_agent = ''
+ if headers and 'User-Agent' in headers:
+ user_agent = 'User-Agent: %s\r\n' % (headers['User-Agent'])
+ proxy_pieces = '%s%s%s\r\n' % (proxy_connect, proxy_auth, user_agent)
+ # Find the proxy host and port.
+ proxy_uri = Uri.parse_uri(proxy)
+ if not proxy_uri.port:
+ proxy_uri.port = '80'
+ # Connect to the proxy server, very simple recv and error checking
+ p_sock = socket.socket(socket.AF_INET,socket.SOCK_STREAM)
+ p_sock.connect((proxy_uri.host, int(proxy_uri.port)))
+ p_sock.sendall(proxy_pieces)
+ response = ''
+ # Wait for the full response.
+ while response.find("\r\n\r\n") == -1:
+ response += p_sock.recv(8192)
+ p_status = response.split()[1]
+ if p_status != str(200):
+ raise ProxyError('Error status=%s' % str(p_status))
+ # Trivial setup for ssl socket.
+ sslobj = None
+ if ssl is not None:
+ sslobj = ssl.wrap_socket(p_sock, None, None)
+ else:
+ sock_ssl = socket.ssl(p_sock, None, Nonesock_)
+ sslobj = httplib.FakeSocket(p_sock, sock_ssl)
+ # Initalize httplib and replace with the proxy socket.
+ connection = httplib.HTTPConnection(proxy_uri.host)
+ connection.sock = sslobj
+ return connection
+ elif uri.scheme == 'http':
+ proxy_uri = Uri.parse_uri(proxy)
+ if not proxy_uri.port:
+ proxy_uri.port = '80'
+ if proxy_auth:
+ headers['Proxy-Authorization'] = proxy_auth.strip()
+ return httplib.HTTPConnection(proxy_uri.host, int(proxy_uri.port))
+ return None
+
+
+def _get_proxy_auth():
+ import base64
+ proxy_username = os.environ.get('proxy-username')
+ if not proxy_username:
+ proxy_username = os.environ.get('proxy_username')
+ proxy_password = os.environ.get('proxy-password')
+ if not proxy_password:
+ proxy_password = os.environ.get('proxy_password')
+ if proxy_username:
+ user_auth = base64.b64encode('%s:%s' % (proxy_username,
+ proxy_password))
+ return 'Basic %s\r\n' % (user_auth.strip())
+ else:
+ return ''
diff --git a/samples/apps/marketplace_sample/atom/http_interface.py b/samples/apps/marketplace_sample/atom/http_interface.py
new file mode 100644
index 0000000..323eab0
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/http_interface.py
@@ -0,0 +1,156 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""This module provides a common interface for all HTTP requests.
+
+ HttpResponse: Represents the server's response to an HTTP request. Provides
+ an interface identical to httplib.HTTPResponse which is the response
+ expected from higher level classes which use HttpClient.request.
+
+ GenericHttpClient: Provides an interface (superclass) for an object
+ responsible for making HTTP requests. Subclasses of this object are
+ used in AtomService and GDataService to make requests to the server. By
+ changing the http_client member object, the AtomService is able to make
+ HTTP requests using different logic (for example, when running on
+ Google App Engine, the http_client makes requests using the App Engine
+ urlfetch API).
+"""
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import StringIO
+
+
+USER_AGENT = '%s GData-Python/2.0.15'
+
+
+class Error(Exception):
+ pass
+
+
+class UnparsableUrlObject(Error):
+ pass
+
+
+class ContentLengthRequired(Error):
+ pass
+
+
+class HttpResponse(object):
+ def __init__(self, body=None, status=None, reason=None, headers=None):
+ """Constructor for an HttpResponse object.
+
+ HttpResponse represents the server's response to an HTTP request from
+ the client. The HttpClient.request method returns a httplib.HTTPResponse
+ object and this HttpResponse class is designed to mirror the interface
+ exposed by httplib.HTTPResponse.
+
+ Args:
+ body: A file like object, with a read() method. The body could also
+ be a string, and the constructor will wrap it so that
+ HttpResponse.read(self) will return the full string.
+ status: The HTTP status code as an int. Example: 200, 201, 404.
+ reason: The HTTP status message which follows the code. Example:
+ OK, Created, Not Found
+ headers: A dictionary containing the HTTP headers in the server's
+ response. A common header in the response is Content-Length.
+ """
+ if body:
+ if hasattr(body, 'read'):
+ self._body = body
+ else:
+ self._body = StringIO.StringIO(body)
+ else:
+ self._body = None
+ if status is not None:
+ self.status = int(status)
+ else:
+ self.status = None
+ self.reason = reason
+ self._headers = headers or {}
+
+ def getheader(self, name, default=None):
+ if name in self._headers:
+ return self._headers[name]
+ else:
+ return default
+
+ def read(self, amt=None):
+ if not amt:
+ return self._body.read()
+ else:
+ return self._body.read(amt)
+
+
+class GenericHttpClient(object):
+ debug = False
+
+ def __init__(self, http_client, headers=None):
+ """
+
+ Args:
+ http_client: An object which provides a request method to make an HTTP
+ request. The request method in GenericHttpClient performs a
+ call-through to the contained HTTP client object.
+ headers: A dictionary containing HTTP headers which should be included
+ in every HTTP request. Common persistent headers include
+ 'User-Agent'.
+ """
+ self.http_client = http_client
+ self.headers = headers or {}
+
+ def request(self, operation, url, data=None, headers=None):
+ all_headers = self.headers.copy()
+ if headers:
+ all_headers.update(headers)
+ return self.http_client.request(operation, url, data=data,
+ headers=all_headers)
+
+ def get(self, url, headers=None):
+ return self.request('GET', url, headers=headers)
+
+ def post(self, url, data, headers=None):
+ return self.request('POST', url, data=data, headers=headers)
+
+ def put(self, url, data, headers=None):
+ return self.request('PUT', url, data=data, headers=headers)
+
+ def delete(self, url, headers=None):
+ return self.request('DELETE', url, headers=headers)
+
+
+class GenericToken(object):
+ """Represents an Authorization token to be added to HTTP requests.
+
+ Some Authorization headers included calculated fields (digital
+ signatures for example) which are based on the parameters of the HTTP
+ request. Therefore the token is responsible for signing the request
+ and adding the Authorization header.
+ """
+ def perform_request(self, http_client, operation, url, data=None,
+ headers=None):
+ """For the GenericToken, no Authorization token is set."""
+ return http_client.request(operation, url, data=data, headers=headers)
+
+ def valid_for_scope(self, url):
+ """Tells the caller if the token authorizes access to the desired URL.
+
+ Since the generic token doesn't add an auth header, it is not valid for
+ any scope.
+ """
+ return False
diff --git a/samples/apps/marketplace_sample/atom/mock_http.py b/samples/apps/marketplace_sample/atom/mock_http.py
new file mode 100644
index 0000000..c420f37
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/mock_http.py
@@ -0,0 +1,132 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import atom.http_interface
+import atom.url
+
+
+class Error(Exception):
+ pass
+
+
+class NoRecordingFound(Error):
+ pass
+
+
+class MockRequest(object):
+ """Holds parameters of an HTTP request for matching against future requests.
+ """
+ def __init__(self, operation, url, data=None, headers=None):
+ self.operation = operation
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ self.url = url
+ self.data = data
+ self.headers = headers
+
+
+class MockResponse(atom.http_interface.HttpResponse):
+ """Simulates an httplib.HTTPResponse object."""
+ def __init__(self, body=None, status=None, reason=None, headers=None):
+ if body and hasattr(body, 'read'):
+ self.body = body.read()
+ else:
+ self.body = body
+ if status is not None:
+ self.status = int(status)
+ else:
+ self.status = None
+ self.reason = reason
+ self._headers = headers or {}
+
+ def read(self):
+ return self.body
+
+
+class MockHttpClient(atom.http_interface.GenericHttpClient):
+ def __init__(self, headers=None, recordings=None, real_client=None):
+ """An HttpClient which responds to request with stored data.
+
+ The request-response pairs are stored as tuples in a member list named
+ recordings.
+
+ The MockHttpClient can be switched from replay mode to record mode by
+ setting the real_client member to an instance of an HttpClient which will
+ make real HTTP requests and store the server's response in list of
+ recordings.
+
+ Args:
+ headers: dict containing HTTP headers which should be included in all
+ HTTP requests.
+ recordings: The initial recordings to be used for responses. This list
+ contains tuples in the form: (MockRequest, MockResponse)
+ real_client: An HttpClient which will make a real HTTP request. The
+ response will be converted into a MockResponse and stored in
+ recordings.
+ """
+ self.recordings = recordings or []
+ self.real_client = real_client
+ self.headers = headers or {}
+
+ def add_response(self, response, operation, url, data=None, headers=None):
+ """Adds a request-response pair to the recordings list.
+
+ After the recording is added, future matching requests will receive the
+ response.
+
+ Args:
+ response: MockResponse
+ operation: str
+ url: str
+ data: str, Currently the data is ignored when looking for matching
+ requests.
+ headers: dict of strings: Currently the headers are ignored when
+ looking for matching requests.
+ """
+ request = MockRequest(operation, url, data=data, headers=headers)
+ self.recordings.append((request, response))
+
+ def request(self, operation, url, data=None, headers=None):
+ """Returns a matching MockResponse from the recordings.
+
+ If the real_client is set, the request will be passed along and the
+ server's response will be added to the recordings and also returned.
+
+ If there is no match, a NoRecordingFound error will be raised.
+ """
+ if self.real_client is None:
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ for recording in self.recordings:
+ if recording[0].operation == operation and recording[0].url == url:
+ return recording[1]
+ raise NoRecordingFound('No recodings found for %s %s' % (
+ operation, url))
+ else:
+ # There is a real HTTP client, so make the request, and record the
+ # response.
+ response = self.real_client.request(operation, url, data=data,
+ headers=headers)
+ # TODO: copy the headers
+ stored_response = MockResponse(body=response, status=response.status,
+ reason=response.reason)
+ self.add_response(stored_response, operation, url, data=data,
+ headers=headers)
+ return stored_response
diff --git a/samples/apps/marketplace_sample/atom/mock_http_core.py b/samples/apps/marketplace_sample/atom/mock_http_core.py
new file mode 100644
index 0000000..f55cdc5
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/mock_http_core.py
@@ -0,0 +1,323 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import StringIO
+import pickle
+import os.path
+import tempfile
+import atom.http_core
+
+
+class Error(Exception):
+ pass
+
+
+class NoRecordingFound(Error):
+ pass
+
+
+class MockHttpClient(object):
+ debug = None
+ real_client = None
+ last_request_was_live = False
+
+ # The following members are used to construct the session cache temp file
+ # name.
+ # These are combined to form the file name
+ # /tmp/cache_prefix.cache_case_name.cache_test_name
+ cache_name_prefix = 'gdata_live_test'
+ cache_case_name = ''
+ cache_test_name = ''
+
+ def __init__(self, recordings=None, real_client=None):
+ self._recordings = recordings or []
+ if real_client is not None:
+ self.real_client = real_client
+
+ def add_response(self, http_request, status, reason, headers=None,
+ body=None):
+ response = MockHttpResponse(status, reason, headers, body)
+ # TODO Scrub the request and the response.
+ self._recordings.append((http_request._copy(), response))
+
+ AddResponse = add_response
+
+ def request(self, http_request):
+ """Provide a recorded response, or record a response for replay.
+
+ If the real_client is set, the request will be made using the
+ real_client, and the response from the server will be recorded.
+ If the real_client is None (the default), this method will examine
+ the recordings and find the first which matches.
+ """
+ request = http_request._copy()
+ _scrub_request(request)
+ if self.real_client is None:
+ self.last_request_was_live = False
+ for recording in self._recordings:
+ if _match_request(recording[0], request):
+ return recording[1]
+ else:
+ # Pass along the debug settings to the real client.
+ self.real_client.debug = self.debug
+ # Make an actual request since we can use the real HTTP client.
+ self.last_request_was_live = True
+ response = self.real_client.request(http_request)
+ scrubbed_response = _scrub_response(response)
+ self.add_response(request, scrubbed_response.status,
+ scrubbed_response.reason,
+ dict(atom.http_core.get_headers(scrubbed_response)),
+ scrubbed_response.read())
+ # Return the recording which we just added.
+ return self._recordings[-1][1]
+ raise NoRecordingFound('No recoding was found for request: %s %s' % (
+ request.method, str(request.uri)))
+
+ Request = request
+
+ def _save_recordings(self, filename):
+ recording_file = open(os.path.join(tempfile.gettempdir(), filename),
+ 'wb')
+ pickle.dump(self._recordings, recording_file)
+ recording_file.close()
+
+ def _load_recordings(self, filename):
+ recording_file = open(os.path.join(tempfile.gettempdir(), filename),
+ 'rb')
+ self._recordings = pickle.load(recording_file)
+ recording_file.close()
+
+ def _delete_recordings(self, filename):
+ full_path = os.path.join(tempfile.gettempdir(), filename)
+ if os.path.exists(full_path):
+ os.remove(full_path)
+
+ def _load_or_use_client(self, filename, http_client):
+ if os.path.exists(os.path.join(tempfile.gettempdir(), filename)):
+ self._load_recordings(filename)
+ else:
+ self.real_client = http_client
+
+ def use_cached_session(self, name=None, real_http_client=None):
+ """Attempts to load recordings from a previous live request.
+
+ If a temp file with the recordings exists, then it is used to fulfill
+ requests. If the file does not exist, then a real client is used to
+ actually make the desired HTTP requests. Requests and responses are
+ recorded and will be written to the desired temprary cache file when
+ close_session is called.
+
+ Args:
+ name: str (optional) The file name of session file to be used. The file
+ is loaded from the temporary directory of this machine. If no name
+ is passed in, a default name will be constructed using the
+ cache_name_prefix, cache_case_name, and cache_test_name of this
+ object.
+ real_http_client: atom.http_core.HttpClient the real client to be used
+ if the cached recordings are not found. If the default
+ value is used, this will be an
+ atom.http_core.HttpClient.
+ """
+ if real_http_client is None:
+ real_http_client = atom.http_core.HttpClient()
+ if name is None:
+ self._recordings_cache_name = self.get_cache_file_name()
+ else:
+ self._recordings_cache_name = name
+ self._load_or_use_client(self._recordings_cache_name, real_http_client)
+
+ def close_session(self):
+ """Saves recordings in the temporary file named in use_cached_session."""
+ if self.real_client is not None:
+ self._save_recordings(self._recordings_cache_name)
+
+ def delete_session(self, name=None):
+ """Removes recordings from a previous live request."""
+ if name is None:
+ self._delete_recordings(self._recordings_cache_name)
+ else:
+ self._delete_recordings(name)
+
+ def get_cache_file_name(self):
+ return '%s.%s.%s' % (self.cache_name_prefix, self.cache_case_name,
+ self.cache_test_name)
+
+ def _dump(self):
+ """Provides debug information in a string."""
+ output = 'MockHttpClient\n real_client: %s\n cache file name: %s\n' % (
+ self.real_client, self.get_cache_file_name())
+ output += ' recordings:\n'
+ i = 0
+ for recording in self._recordings:
+ output += ' recording %i is for: %s %s\n' % (
+ i, recording[0].method, str(recording[0].uri))
+ i += 1
+ return output
+
+
+def _match_request(http_request, stored_request):
+ """Determines whether a request is similar enough to a stored request
+ to cause the stored response to be returned."""
+ # Check to see if the host names match.
+ if (http_request.uri.host is not None
+ and http_request.uri.host != stored_request.uri.host):
+ return False
+ # Check the request path in the URL (/feeds/private/full/x)
+ elif http_request.uri.path != stored_request.uri.path:
+ return False
+ # Check the method used in the request (GET, POST, etc.)
+ elif http_request.method != stored_request.method:
+ return False
+ # If there is a gsession ID in either request, make sure that it is matched
+ # exactly.
+ elif ('gsessionid' in http_request.uri.query
+ or 'gsessionid' in stored_request.uri.query):
+ if 'gsessionid' not in stored_request.uri.query:
+ return False
+ elif 'gsessionid' not in http_request.uri.query:
+ return False
+ elif (http_request.uri.query['gsessionid']
+ != stored_request.uri.query['gsessionid']):
+ return False
+ # Ignores differences in the query params (?start-index=5&max-results=20),
+ # the body of the request, the port number, HTTP headers, just to name a
+ # few.
+ return True
+
+
+def _scrub_request(http_request):
+ """ Removes email address and password from a client login request.
+
+ Since the mock server saves the request and response in plantext, sensitive
+ information like the password should be removed before saving the
+ recordings. At the moment only requests sent to a ClientLogin url are
+ scrubbed.
+ """
+ if (http_request and http_request.uri and http_request.uri.path and
+ http_request.uri.path.endswith('ClientLogin')):
+ # Remove the email and password from a ClientLogin request.
+ http_request._body_parts = []
+ http_request.add_form_inputs(
+ {'form_data': 'client login request has been scrubbed'})
+ else:
+ # We can remove the body of the post from the recorded request, since
+ # the request body is not used when finding a matching recording.
+ http_request._body_parts = []
+ return http_request
+
+
+def _scrub_response(http_response):
+ return http_response
+
+
+class EchoHttpClient(object):
+ """Sends the request data back in the response.
+
+ Used to check the formatting of the request as it was sent. Always responds
+ with a 200 OK, and some information from the HTTP request is returned in
+ special Echo-X headers in the response. The following headers are added
+ in the response:
+ 'Echo-Host': The host name and port number to which the HTTP connection is
+ made. If no port was passed in, the header will contain
+ host:None.
+ 'Echo-Uri': The path portion of the URL being requested. /example?x=1&y=2
+ 'Echo-Scheme': The beginning of the URL, usually 'http' or 'https'
+ 'Echo-Method': The HTTP method being used, 'GET', 'POST', 'PUT', etc.
+ """
+
+ def request(self, http_request):
+ return self._http_request(http_request.uri, http_request.method,
+ http_request.headers, http_request._body_parts)
+
+ def _http_request(self, uri, method, headers=None, body_parts=None):
+ body = StringIO.StringIO()
+ response = atom.http_core.HttpResponse(status=200, reason='OK', body=body)
+ if headers is None:
+ response._headers = {}
+ else:
+ # Copy headers from the request to the response but convert values to
+ # strings. Server response headers always come in as strings, so an int
+ # should be converted to a corresponding string when echoing.
+ for header, value in headers.iteritems():
+ response._headers[header] = str(value)
+ response._headers['Echo-Host'] = '%s:%s' % (uri.host, str(uri.port))
+ response._headers['Echo-Uri'] = uri._get_relative_path()
+ response._headers['Echo-Scheme'] = uri.scheme
+ response._headers['Echo-Method'] = method
+ for part in body_parts:
+ if isinstance(part, str):
+ body.write(part)
+ elif hasattr(part, 'read'):
+ body.write(part.read())
+ body.seek(0)
+ return response
+
+
+class SettableHttpClient(object):
+ """An HTTP Client which responds with the data given in set_response."""
+
+ def __init__(self, status, reason, body, headers):
+ """Configures the response for the server.
+
+ See set_response for details on the arguments to the constructor.
+ """
+ self.set_response(status, reason, body, headers)
+ self.last_request = None
+
+ def set_response(self, status, reason, body, headers):
+ """Determines the response which will be sent for each request.
+
+ Args:
+ status: An int for the HTTP status code, example: 200, 404, etc.
+ reason: String for the HTTP reason, example: OK, NOT FOUND, etc.
+ body: The body of the HTTP response as a string or a file-like
+ object (something with a read method).
+ headers: dict of strings containing the HTTP headers in the response.
+ """
+ self.response = atom.http_core.HttpResponse(status=status, reason=reason,
+ body=body)
+ self.response._headers = headers.copy()
+
+ def request(self, http_request):
+ self.last_request = http_request
+ return self.response
+
+
+class MockHttpResponse(atom.http_core.HttpResponse):
+
+ def __init__(self, status=None, reason=None, headers=None, body=None):
+ self._headers = headers or {}
+ if status is not None:
+ self.status = status
+ if reason is not None:
+ self.reason = reason
+ if body is not None:
+ # Instead of using a file-like object for the body, store as a string
+ # so that reads can be repeated.
+ if hasattr(body, 'read'):
+ self._body = body.read()
+ else:
+ self._body = body
+
+ def read(self):
+ return self._body
diff --git a/samples/apps/marketplace_sample/atom/mock_service.py b/samples/apps/marketplace_sample/atom/mock_service.py
new file mode 100755
index 0000000..601b68a
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/mock_service.py
@@ -0,0 +1,243 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""MockService provides CRUD ops. for mocking calls to AtomPub services.
+
+ MockService: Exposes the publicly used methods of AtomService to provide
+ a mock interface which can be used in unit tests.
+"""
+
+import atom.service
+import pickle
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+
+# Recordings contains pairings of HTTP MockRequest objects with MockHttpResponse objects.
+recordings = []
+# If set, the mock service HttpRequest are actually made through this object.
+real_request_handler = None
+
+def ConcealValueWithSha(source):
+ import sha
+ return sha.new(source[:-5]).hexdigest()
+
+def DumpRecordings(conceal_func=ConcealValueWithSha):
+ if conceal_func:
+ for recording_pair in recordings:
+ recording_pair[0].ConcealSecrets(conceal_func)
+ return pickle.dumps(recordings)
+
+def LoadRecordings(recordings_file_or_string):
+ if isinstance(recordings_file_or_string, str):
+ atom.mock_service.recordings = pickle.loads(recordings_file_or_string)
+ elif hasattr(recordings_file_or_string, 'read'):
+ atom.mock_service.recordings = pickle.loads(
+ recordings_file_or_string.read())
+
+def HttpRequest(service, operation, data, uri, extra_headers=None,
+ url_params=None, escape_params=True, content_type='application/atom+xml'):
+ """Simulates an HTTP call to the server, makes an actual HTTP request if
+ real_request_handler is set.
+
+ This function operates in two different modes depending on if
+ real_request_handler is set or not. If real_request_handler is not set,
+ HttpRequest will look in this module's recordings list to find a response
+ which matches the parameters in the function call. If real_request_handler
+ is set, this function will call real_request_handler.HttpRequest, add the
+ response to the recordings list, and respond with the actual response.
+
+ Args:
+ service: atom.AtomService object which contains some of the parameters
+ needed to make the request. The following members are used to
+ construct the HTTP call: server (str), additional_headers (dict),
+ port (int), and ssl (bool).
+ operation: str The HTTP operation to be performed. This is usually one of
+ 'GET', 'POST', 'PUT', or 'DELETE'
+ data: ElementTree, filestream, list of parts, or other object which can be
+ converted to a string.
+ Should be set to None when performing a GET or PUT.
+ If data is a file-like object which can be read, this method will read
+ a chunk of 100K bytes at a time and send them.
+ If the data is a list of parts to be sent, each part will be evaluated
+ and sent.
+ uri: The beginning of the URL to which the request should be sent.
+ Examples: '/', '/base/feeds/snippets',
+ '/m8/feeds/contacts/default/base'
+ extra_headers: dict of strings. HTTP headers which should be sent
+ in the request. These headers are in addition to those stored in
+ service.additional_headers.
+ url_params: dict of strings. Key value pairs to be added to the URL as
+ URL parameters. For example {'foo':'bar', 'test':'param'} will
+ become ?foo=bar&test=param.
+ escape_params: bool default True. If true, the keys and values in
+ url_params will be URL escaped when the form is constructed
+ (Special characters converted to %XX form.)
+ content_type: str The MIME type for the data being sent. Defaults to
+ 'application/atom+xml', this is only used if data is set.
+ """
+ full_uri = atom.service.BuildUri(uri, url_params, escape_params)
+ (server, port, ssl, uri) = atom.service.ProcessUrl(service, uri)
+ current_request = MockRequest(operation, full_uri, host=server, ssl=ssl,
+ data=data, extra_headers=extra_headers, url_params=url_params,
+ escape_params=escape_params, content_type=content_type)
+ # If the request handler is set, we should actually make the request using
+ # the request handler and record the response to replay later.
+ if real_request_handler:
+ response = real_request_handler.HttpRequest(service, operation, data, uri,
+ extra_headers=extra_headers, url_params=url_params,
+ escape_params=escape_params, content_type=content_type)
+ # TODO: need to copy the HTTP headers from the real response into the
+ # recorded_response.
+ recorded_response = MockHttpResponse(body=response.read(),
+ status=response.status, reason=response.reason)
+ # Insert a tuple which maps the request to the response object returned
+ # when making an HTTP call using the real_request_handler.
+ recordings.append((current_request, recorded_response))
+ return recorded_response
+ else:
+ # Look through available recordings to see if one matches the current
+ # request.
+ for request_response_pair in recordings:
+ if request_response_pair[0].IsMatch(current_request):
+ return request_response_pair[1]
+ return None
+
+
+class MockRequest(object):
+ """Represents a request made to an AtomPub server.
+
+ These objects are used to determine if a client request matches a recorded
+ HTTP request to determine what the mock server's response will be.
+ """
+
+ def __init__(self, operation, uri, host=None, ssl=False, port=None,
+ data=None, extra_headers=None, url_params=None, escape_params=True,
+ content_type='application/atom+xml'):
+ """Constructor for a MockRequest
+
+ Args:
+ operation: str One of 'GET', 'POST', 'PUT', or 'DELETE' this is the
+ HTTP operation requested on the resource.
+ uri: str The URL describing the resource to be modified or feed to be
+ retrieved. This should include the protocol (http/https) and the host
+ (aka domain). For example, these are some valud full_uris:
+ 'http://example.com', 'https://www.google.com/accounts/ClientLogin'
+ host: str (optional) The server name which will be placed at the
+ beginning of the URL if the uri parameter does not begin with 'http'.
+ Examples include 'example.com', 'www.google.com', 'www.blogger.com'.
+ ssl: boolean (optional) If true, the request URL will begin with https
+ instead of http.
+ data: ElementTree, filestream, list of parts, or other object which can be
+ converted to a string. (optional)
+ Should be set to None when performing a GET or PUT.
+ If data is a file-like object which can be read, the constructor
+ will read the entire file into memory. If the data is a list of
+ parts to be sent, each part will be evaluated and stored.
+ extra_headers: dict (optional) HTTP headers included in the request.
+ url_params: dict (optional) Key value pairs which should be added to
+ the URL as URL parameters in the request. For example uri='/',
+ url_parameters={'foo':'1','bar':'2'} could become '/?foo=1&bar=2'.
+ escape_params: boolean (optional) Perform URL escaping on the keys and
+ values specified in url_params. Defaults to True.
+ content_type: str (optional) Provides the MIME type of the data being
+ sent.
+ """
+ self.operation = operation
+ self.uri = _ConstructFullUrlBase(uri, host=host, ssl=ssl)
+ self.data = data
+ self.extra_headers = extra_headers
+ self.url_params = url_params or {}
+ self.escape_params = escape_params
+ self.content_type = content_type
+
+ def ConcealSecrets(self, conceal_func):
+ """Conceal secret data in this request."""
+ if self.extra_headers.has_key('Authorization'):
+ self.extra_headers['Authorization'] = conceal_func(
+ self.extra_headers['Authorization'])
+
+ def IsMatch(self, other_request):
+ """Check to see if the other_request is equivalent to this request.
+
+ Used to determine if a recording matches an incoming request so that a
+ recorded response should be sent to the client.
+
+ The matching is not exact, only the operation and URL are examined
+ currently.
+
+ Args:
+ other_request: MockRequest The request which we want to check this
+ (self) MockRequest against to see if they are equivalent.
+ """
+ # More accurate matching logic will likely be required.
+ return (self.operation == other_request.operation and self.uri ==
+ other_request.uri)
+
+
+def _ConstructFullUrlBase(uri, host=None, ssl=False):
+ """Puts URL components into the form http(s)://full.host.strinf/uri/path
+
+ Used to construct a roughly canonical URL so that URLs which begin with
+ 'http://example.com/' can be compared to a uri of '/' when the host is
+ set to 'example.com'
+
+ If the uri contains 'http://host' already, the host and ssl parameters
+ are ignored.
+
+ Args:
+ uri: str The path component of the URL, examples include '/'
+ host: str (optional) The host name which should prepend the URL. Example:
+ 'example.com'
+ ssl: boolean (optional) If true, the returned URL will begin with https
+ instead of http.
+
+ Returns:
+ String which has the form http(s)://example.com/uri/string/contents
+ """
+ if uri.startswith('http'):
+ return uri
+ if ssl:
+ return 'https://%s%s' % (host, uri)
+ else:
+ return 'http://%s%s' % (host, uri)
+
+
+class MockHttpResponse(object):
+ """Returned from MockService crud methods as the server's response."""
+
+ def __init__(self, body=None, status=None, reason=None, headers=None):
+ """Construct a mock HTTPResponse and set members.
+
+ Args:
+ body: str (optional) The HTTP body of the server's response.
+ status: int (optional)
+ reason: str (optional)
+ headers: dict (optional)
+ """
+ self.body = body
+ self.status = status
+ self.reason = reason
+ self.headers = headers or {}
+
+ def read(self):
+ return self.body
+
+ def getheader(self, header_name):
+ return self.headers[header_name]
+
diff --git a/samples/apps/marketplace_sample/atom/service.py b/samples/apps/marketplace_sample/atom/service.py
new file mode 100755
index 0000000..00f6637
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/service.py
@@ -0,0 +1,740 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006, 2007, 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""AtomService provides CRUD ops. in line with the Atom Publishing Protocol.
+
+ AtomService: Encapsulates the ability to perform insert, update and delete
+ operations with the Atom Publishing Protocol on which GData is
+ based. An instance can perform query, insertion, deletion, and
+ update.
+
+ HttpRequest: Function that performs a GET, POST, PUT, or DELETE HTTP request
+ to the specified end point. An AtomService object or a subclass can be
+ used to specify information about the request.
+"""
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import atom.http_interface
+import atom.url
+import atom.http
+import atom.token_store
+
+import os
+import httplib
+import urllib
+import re
+import base64
+import socket
+import warnings
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import atom
+
+
+class AtomService(object):
+ """Performs Atom Publishing Protocol CRUD operations.
+
+ The AtomService contains methods to perform HTTP CRUD operations.
+ """
+
+ # Default values for members
+ port = 80
+ ssl = False
+ # Set the current_token to force the AtomService to use this token
+ # instead of searching for an appropriate token in the token_store.
+ current_token = None
+ auto_store_tokens = True
+ auto_set_current_token = True
+
+ def _get_override_token(self):
+ return self.current_token
+
+ def _set_override_token(self, token):
+ self.current_token = token
+
+ override_token = property(_get_override_token, _set_override_token)
+
+ #@atom.v1_deprecated('Please use atom.client.AtomPubClient instead.')
+ def __init__(self, server=None, additional_headers=None,
+ application_name='', http_client=None, token_store=None):
+ """Creates a new AtomService client.
+
+ Args:
+ server: string (optional) The start of a URL for the server
+ to which all operations should be directed. Example:
+ 'www.google.com'
+ additional_headers: dict (optional) Any additional HTTP headers which
+ should be included with CRUD operations.
+ http_client: An object responsible for making HTTP requests using a
+ request method. If none is provided, a new instance of
+ atom.http.ProxiedHttpClient will be used.
+ token_store: Keeps a collection of authorization tokens which can be
+ applied to requests for a specific URLs. Critical methods are
+ find_token based on a URL (atom.url.Url or a string), add_token,
+ and remove_token.
+ """
+ self.http_client = http_client or atom.http.ProxiedHttpClient()
+ self.token_store = token_store or atom.token_store.TokenStore()
+ self.server = server
+ self.additional_headers = additional_headers or {}
+ self.additional_headers['User-Agent'] = atom.http_interface.USER_AGENT % (
+ application_name,)
+ # If debug is True, the HTTPConnection will display debug information
+ self._set_debug(False)
+
+ __init__ = atom.v1_deprecated(
+ 'Please use atom.client.AtomPubClient instead.')(
+ __init__)
+
+ def _get_debug(self):
+ return self.http_client.debug
+
+ def _set_debug(self, value):
+ self.http_client.debug = value
+
+ debug = property(_get_debug, _set_debug,
+ doc='If True, HTTP debug information is printed.')
+
+ def use_basic_auth(self, username, password, scopes=None):
+ if username is not None and password is not None:
+ if scopes is None:
+ scopes = [atom.token_store.SCOPE_ALL]
+ base_64_string = base64.encodestring('%s:%s' % (username, password))
+ token = BasicAuthToken('Basic %s' % base_64_string.strip(),
+ scopes=[atom.token_store.SCOPE_ALL])
+ if self.auto_set_current_token:
+ self.current_token = token
+ if self.auto_store_tokens:
+ return self.token_store.add_token(token)
+ return True
+ return False
+
+ def UseBasicAuth(self, username, password, for_proxy=False):
+ """Sets an Authenticaiton: Basic HTTP header containing plaintext.
+
+ Deprecated, use use_basic_auth instead.
+
+ The username and password are base64 encoded and added to an HTTP header
+ which will be included in each request. Note that your username and
+ password are sent in plaintext.
+
+ Args:
+ username: str
+ password: str
+ """
+ self.use_basic_auth(username, password)
+
+ #@atom.v1_deprecated('Please use atom.client.AtomPubClient for requests.')
+ def request(self, operation, url, data=None, headers=None,
+ url_params=None):
+ if isinstance(url, (str, unicode)):
+ if url.startswith('http:') and self.ssl:
+ # Force all requests to be https if self.ssl is True.
+ url = atom.url.parse_url('https:' + url[5:])
+ elif not url.startswith('http') and self.ssl:
+ url = atom.url.parse_url('https://%s%s' % (self.server, url))
+ elif not url.startswith('http'):
+ url = atom.url.parse_url('http://%s%s' % (self.server, url))
+ else:
+ url = atom.url.parse_url(url)
+
+ if url_params:
+ for name, value in url_params.iteritems():
+ url.params[name] = value
+
+ all_headers = self.additional_headers.copy()
+ if headers:
+ all_headers.update(headers)
+
+ # If the list of headers does not include a Content-Length, attempt to
+ # calculate it based on the data object.
+ if data and 'Content-Length' not in all_headers:
+ content_length = CalculateDataLength(data)
+ if content_length:
+ all_headers['Content-Length'] = str(content_length)
+
+ # Find an Authorization token for this URL if one is available.
+ if self.override_token:
+ auth_token = self.override_token
+ else:
+ auth_token = self.token_store.find_token(url)
+ return auth_token.perform_request(self.http_client, operation, url,
+ data=data, headers=all_headers)
+
+ request = atom.v1_deprecated(
+ 'Please use atom.client.AtomPubClient for requests.')(
+ request)
+
+ # CRUD operations
+ def Get(self, uri, extra_headers=None, url_params=None, escape_params=True):
+ """Query the APP server with the given URI
+
+ The uri is the portion of the URI after the server value
+ (server example: 'www.google.com').
+
+ Example use:
+ To perform a query against Google Base, set the server to
+ 'base.google.com' and set the uri to '/base/feeds/...', where ... is
+ your query. For example, to find snippets for all digital cameras uri
+ should be set to: '/base/feeds/snippets?bq=digital+camera'
+
+ Args:
+ uri: string The query in the form of a URI. Example:
+ '/base/feeds/snippets?bq=digital+camera'.
+ extra_headers: dicty (optional) Extra HTTP headers to be included
+ in the GET request. These headers are in addition to
+ those stored in the client's additional_headers property.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the query. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ httplib.HTTPResponse The server's response to the GET request.
+ """
+ return self.request('GET', uri, data=None, headers=extra_headers,
+ url_params=url_params)
+
+ def Post(self, data, uri, extra_headers=None, url_params=None,
+ escape_params=True, content_type='application/atom+xml'):
+ """Insert data into an APP server at the given URI.
+
+ Args:
+ data: string, ElementTree._Element, or something with a __str__ method
+ The XML to be sent to the uri.
+ uri: string The location (feed) to which the data should be inserted.
+ Example: '/base/feeds/items'.
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type,
+ Authorization, and Content-Length headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ httplib.HTTPResponse Server's response to the POST request.
+ """
+ if extra_headers is None:
+ extra_headers = {}
+ if content_type:
+ extra_headers['Content-Type'] = content_type
+ return self.request('POST', uri, data=data, headers=extra_headers,
+ url_params=url_params)
+
+ def Put(self, data, uri, extra_headers=None, url_params=None,
+ escape_params=True, content_type='application/atom+xml'):
+ """Updates an entry at the given URI.
+
+ Args:
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The
+ XML containing the updated data.
+ uri: string A URI indicating entry to which the update will be applied.
+ Example: '/base/feeds/items/ITEM-ID'
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type,
+ Authorization, and Content-Length headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ httplib.HTTPResponse Server's response to the PUT request.
+ """
+ if extra_headers is None:
+ extra_headers = {}
+ if content_type:
+ extra_headers['Content-Type'] = content_type
+ return self.request('PUT', uri, data=data, headers=extra_headers,
+ url_params=url_params)
+
+ def Delete(self, uri, extra_headers=None, url_params=None,
+ escape_params=True):
+ """Deletes the entry at the given URI.
+
+ Args:
+ uri: string The URI of the entry to be deleted. Example:
+ '/base/feeds/items/ITEM-ID'
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ httplib.HTTPResponse Server's response to the DELETE request.
+ """
+ return self.request('DELETE', uri, data=None, headers=extra_headers,
+ url_params=url_params)
+
+
+class BasicAuthToken(atom.http_interface.GenericToken):
+ def __init__(self, auth_header, scopes=None):
+ """Creates a token used to add Basic Auth headers to HTTP requests.
+
+ Args:
+ auth_header: str The value for the Authorization header.
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs
+ for which this token can be used. For example, if scopes contains
+ 'http://example.com/foo', then this token can be used for a request to
+ 'http://example.com/foo/bar' but it cannot be used for a request to
+ 'http://example.com/baz'
+ """
+ self.auth_header = auth_header
+ self.scopes = scopes or []
+
+ def perform_request(self, http_client, operation, url, data=None,
+ headers=None):
+ """Sets the Authorization header to the basic auth string."""
+ if headers is None:
+ headers = {'Authorization':self.auth_header}
+ else:
+ headers['Authorization'] = self.auth_header
+ return http_client.request(operation, url, data=data, headers=headers)
+
+ def __str__(self):
+ return self.auth_header
+
+ def valid_for_scope(self, url):
+ """Tells the caller if the token authorizes access to the desired URL.
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ for scope in self.scopes:
+ if scope == atom.token_store.SCOPE_ALL:
+ return True
+ if isinstance(scope, (str, unicode)):
+ scope = atom.url.parse_url(scope)
+ if scope == url:
+ return True
+ # Check the host and the path, but ignore the port and protocol.
+ elif scope.host == url.host and not scope.path:
+ return True
+ elif scope.host == url.host and scope.path and not url.path:
+ continue
+ elif scope.host == url.host and url.path.startswith(scope.path):
+ return True
+ return False
+
+
+def PrepareConnection(service, full_uri):
+ """Opens a connection to the server based on the full URI.
+
+ This method is deprecated, instead use atom.http.HttpClient.request.
+
+ Examines the target URI and the proxy settings, which are set as
+ environment variables, to open a connection with the server. This
+ connection is used to make an HTTP request.
+
+ Args:
+ service: atom.AtomService or a subclass. It must have a server string which
+ represents the server host to which the request should be made. It may also
+ have a dictionary of additional_headers to send in the HTTP request.
+ full_uri: str Which is the target relative (lacks protocol and host) or
+ absolute URL to be opened. Example:
+ 'https://www.google.com/accounts/ClientLogin' or
+ 'base/feeds/snippets' where the server is set to www.google.com.
+
+ Returns:
+ A tuple containing the httplib.HTTPConnection and the full_uri for the
+ request.
+ """
+ deprecation('calling deprecated function PrepareConnection')
+ (server, port, ssl, partial_uri) = ProcessUrl(service, full_uri)
+ if ssl:
+ # destination is https
+ proxy = os.environ.get('https_proxy')
+ if proxy:
+ (p_server, p_port, p_ssl, p_uri) = ProcessUrl(service, proxy, True)
+ proxy_username = os.environ.get('proxy-username')
+ if not proxy_username:
+ proxy_username = os.environ.get('proxy_username')
+ proxy_password = os.environ.get('proxy-password')
+ if not proxy_password:
+ proxy_password = os.environ.get('proxy_password')
+ if proxy_username:
+ user_auth = base64.encodestring('%s:%s' % (proxy_username,
+ proxy_password))
+ proxy_authorization = ('Proxy-authorization: Basic %s\r\n' % (
+ user_auth.strip()))
+ else:
+ proxy_authorization = ''
+ proxy_connect = 'CONNECT %s:%s HTTP/1.0\r\n' % (server, port)
+ user_agent = 'User-Agent: %s\r\n' % (
+ service.additional_headers['User-Agent'])
+ proxy_pieces = (proxy_connect + proxy_authorization + user_agent
+ + '\r\n')
+
+ #now connect, very simple recv and error checking
+ p_sock = socket.socket(socket.AF_INET,socket.SOCK_STREAM)
+ p_sock.connect((p_server,p_port))
+ p_sock.sendall(proxy_pieces)
+ response = ''
+
+ # Wait for the full response.
+ while response.find("\r\n\r\n") == -1:
+ response += p_sock.recv(8192)
+
+ p_status=response.split()[1]
+ if p_status!=str(200):
+ raise atom.http.ProxyError('Error status=%s' % p_status)
+
+ # Trivial setup for ssl socket.
+ ssl = socket.ssl(p_sock, None, None)
+ fake_sock = httplib.FakeSocket(p_sock, ssl)
+
+ # Initalize httplib and replace with the proxy socket.
+ connection = httplib.HTTPConnection(server)
+ connection.sock=fake_sock
+ full_uri = partial_uri
+
+ else:
+ connection = httplib.HTTPSConnection(server, port)
+ full_uri = partial_uri
+
+ else:
+ # destination is http
+ proxy = os.environ.get('http_proxy')
+ if proxy:
+ (p_server, p_port, p_ssl, p_uri) = ProcessUrl(service.server, proxy, True)
+ proxy_username = os.environ.get('proxy-username')
+ if not proxy_username:
+ proxy_username = os.environ.get('proxy_username')
+ proxy_password = os.environ.get('proxy-password')
+ if not proxy_password:
+ proxy_password = os.environ.get('proxy_password')
+ if proxy_username:
+ UseBasicAuth(service, proxy_username, proxy_password, True)
+ connection = httplib.HTTPConnection(p_server, p_port)
+ if not full_uri.startswith("http://"):
+ if full_uri.startswith("/"):
+ full_uri = "http://%s%s" % (service.server, full_uri)
+ else:
+ full_uri = "http://%s/%s" % (service.server, full_uri)
+ else:
+ connection = httplib.HTTPConnection(server, port)
+ full_uri = partial_uri
+
+ return (connection, full_uri)
+
+
+def UseBasicAuth(service, username, password, for_proxy=False):
+ """Sets an Authenticaiton: Basic HTTP header containing plaintext.
+
+ Deprecated, use AtomService.use_basic_auth insread.
+
+ The username and password are base64 encoded and added to an HTTP header
+ which will be included in each request. Note that your username and
+ password are sent in plaintext. The auth header is added to the
+ additional_headers dictionary in the service object.
+
+ Args:
+ service: atom.AtomService or a subclass which has an
+ additional_headers dict as a member.
+ username: str
+ password: str
+ """
+ deprecation('calling deprecated function UseBasicAuth')
+ base_64_string = base64.encodestring('%s:%s' % (username, password))
+ base_64_string = base_64_string.strip()
+ if for_proxy:
+ header_name = 'Proxy-Authorization'
+ else:
+ header_name = 'Authorization'
+ service.additional_headers[header_name] = 'Basic %s' % (base_64_string,)
+
+
+def ProcessUrl(service, url, for_proxy=False):
+ """Processes a passed URL. If the URL does not begin with https?, then
+ the default value for server is used
+
+ This method is deprecated, use atom.url.parse_url instead.
+ """
+ if not isinstance(url, atom.url.Url):
+ url = atom.url.parse_url(url)
+
+ server = url.host
+ ssl = False
+ port = 80
+
+ if not server:
+ if hasattr(service, 'server'):
+ server = service.server
+ else:
+ server = service
+ if not url.protocol and hasattr(service, 'ssl'):
+ ssl = service.ssl
+ if hasattr(service, 'port'):
+ port = service.port
+ else:
+ if url.protocol == 'https':
+ ssl = True
+ elif url.protocol == 'http':
+ ssl = False
+ if url.port:
+ port = int(url.port)
+ elif port == 80 and ssl:
+ port = 443
+
+ return (server, port, ssl, url.get_request_uri())
+
+def DictionaryToParamList(url_parameters, escape_params=True):
+ """Convert a dictionary of URL arguments into a URL parameter string.
+
+ This function is deprcated, use atom.url.Url instead.
+
+ Args:
+ url_parameters: The dictionaty of key-value pairs which will be converted
+ into URL parameters. For example,
+ {'dry-run': 'true', 'foo': 'bar'}
+ will become ['dry-run=true', 'foo=bar'].
+
+ Returns:
+ A list which contains a string for each key-value pair. The strings are
+ ready to be incorporated into a URL by using '&'.join([] + parameter_list)
+ """
+ # Choose which function to use when modifying the query and parameters.
+ # Use quote_plus when escape_params is true.
+ transform_op = [str, urllib.quote_plus][bool(escape_params)]
+ # Create a list of tuples containing the escaped version of the
+ # parameter-value pairs.
+ parameter_tuples = [(transform_op(param), transform_op(value))
+ for param, value in (url_parameters or {}).items()]
+ # Turn parameter-value tuples into a list of strings in the form
+ # 'PARAMETER=VALUE'.
+ return ['='.join(x) for x in parameter_tuples]
+
+
+def BuildUri(uri, url_params=None, escape_params=True):
+ """Converts a uri string and a collection of parameters into a URI.
+
+ This function is deprcated, use atom.url.Url instead.
+
+ Args:
+ uri: string
+ url_params: dict (optional)
+ escape_params: boolean (optional)
+ uri: string The start of the desired URI. This string can alrady contain
+ URL parameters. Examples: '/base/feeds/snippets',
+ '/base/feeds/snippets?bq=digital+camera'
+ url_parameters: dict (optional) Additional URL parameters to be included
+ in the query. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ string The URI consisting of the escaped URL parameters appended to the
+ initial uri string.
+ """
+ # Prepare URL parameters for inclusion into the GET request.
+ parameter_list = DictionaryToParamList(url_params, escape_params)
+
+ # Append the URL parameters to the URL.
+ if parameter_list:
+ if uri.find('?') != -1:
+ # If there are already URL parameters in the uri string, add the
+ # parameters after a new & character.
+ full_uri = '&'.join([uri] + parameter_list)
+ else:
+ # The uri string did not have any URL parameters (no ? character)
+ # so put a ? between the uri and URL parameters.
+ full_uri = '%s%s' % (uri, '?%s' % ('&'.join([] + parameter_list)))
+ else:
+ full_uri = uri
+
+ return full_uri
+
+
+def HttpRequest(service, operation, data, uri, extra_headers=None,
+ url_params=None, escape_params=True, content_type='application/atom+xml'):
+ """Performs an HTTP call to the server, supports GET, POST, PUT, and DELETE.
+
+ This method is deprecated, use atom.http.HttpClient.request instead.
+
+ Usage example, perform and HTTP GET on http://www.google.com/:
+ import atom.service
+ client = atom.service.AtomService()
+ http_response = client.Get('http://www.google.com/')
+ or you could set the client.server to 'www.google.com' and use the
+ following:
+ client.server = 'www.google.com'
+ http_response = client.Get('/')
+
+ Args:
+ service: atom.AtomService object which contains some of the parameters
+ needed to make the request. The following members are used to
+ construct the HTTP call: server (str), additional_headers (dict),
+ port (int), and ssl (bool).
+ operation: str The HTTP operation to be performed. This is usually one of
+ 'GET', 'POST', 'PUT', or 'DELETE'
+ data: ElementTree, filestream, list of parts, or other object which can be
+ converted to a string.
+ Should be set to None when performing a GET or PUT.
+ If data is a file-like object which can be read, this method will read
+ a chunk of 100K bytes at a time and send them.
+ If the data is a list of parts to be sent, each part will be evaluated
+ and sent.
+ uri: The beginning of the URL to which the request should be sent.
+ Examples: '/', '/base/feeds/snippets',
+ '/m8/feeds/contacts/default/base'
+ extra_headers: dict of strings. HTTP headers which should be sent
+ in the request. These headers are in addition to those stored in
+ service.additional_headers.
+ url_params: dict of strings. Key value pairs to be added to the URL as
+ URL parameters. For example {'foo':'bar', 'test':'param'} will
+ become ?foo=bar&test=param.
+ escape_params: bool default True. If true, the keys and values in
+ url_params will be URL escaped when the form is constructed
+ (Special characters converted to %XX form.)
+ content_type: str The MIME type for the data being sent. Defaults to
+ 'application/atom+xml', this is only used if data is set.
+ """
+ deprecation('call to deprecated function HttpRequest')
+ full_uri = BuildUri(uri, url_params, escape_params)
+ (connection, full_uri) = PrepareConnection(service, full_uri)
+
+ if extra_headers is None:
+ extra_headers = {}
+
+ # Turn on debug mode if the debug member is set.
+ if service.debug:
+ connection.debuglevel = 1
+
+ connection.putrequest(operation, full_uri)
+
+ # If the list of headers does not include a Content-Length, attempt to
+ # calculate it based on the data object.
+ if (data and not service.additional_headers.has_key('Content-Length') and
+ not extra_headers.has_key('Content-Length')):
+ content_length = CalculateDataLength(data)
+ if content_length:
+ extra_headers['Content-Length'] = str(content_length)
+
+ if content_type:
+ extra_headers['Content-Type'] = content_type
+
+ # Send the HTTP headers.
+ if isinstance(service.additional_headers, dict):
+ for header in service.additional_headers:
+ connection.putheader(header, service.additional_headers[header])
+ if isinstance(extra_headers, dict):
+ for header in extra_headers:
+ connection.putheader(header, extra_headers[header])
+ connection.endheaders()
+
+ # If there is data, send it in the request.
+ if data:
+ if isinstance(data, list):
+ for data_part in data:
+ __SendDataPart(data_part, connection)
+ else:
+ __SendDataPart(data, connection)
+
+ # Return the HTTP Response from the server.
+ return connection.getresponse()
+
+
+def __SendDataPart(data, connection):
+ """This method is deprecated, use atom.http._send_data_part"""
+ deprecated('call to deprecated function __SendDataPart')
+ if isinstance(data, str):
+ #TODO add handling for unicode.
+ connection.send(data)
+ return
+ elif ElementTree.iselement(data):
+ connection.send(ElementTree.tostring(data))
+ return
+ # Check to see if data is a file-like object that has a read method.
+ elif hasattr(data, 'read'):
+ # Read the file and send it a chunk at a time.
+ while 1:
+ binarydata = data.read(100000)
+ if binarydata == '': break
+ connection.send(binarydata)
+ return
+ else:
+ # The data object was not a file.
+ # Try to convert to a string and send the data.
+ connection.send(str(data))
+ return
+
+
+def CalculateDataLength(data):
+ """Attempts to determine the length of the data to send.
+
+ This method will respond with a length only if the data is a string or
+ and ElementTree element.
+
+ Args:
+ data: object If this is not a string or ElementTree element this funtion
+ will return None.
+ """
+ if isinstance(data, str):
+ return len(data)
+ elif isinstance(data, list):
+ return None
+ elif ElementTree.iselement(data):
+ return len(ElementTree.tostring(data))
+ elif hasattr(data, 'read'):
+ # If this is a file-like object, don't try to guess the length.
+ return None
+ else:
+ return len(str(data))
+
+
+def deprecation(message):
+ warnings.warn(message, DeprecationWarning, stacklevel=2)
diff --git a/samples/apps/marketplace_sample/atom/token_store.py b/samples/apps/marketplace_sample/atom/token_store.py
new file mode 100644
index 0000000..d618965
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/token_store.py
@@ -0,0 +1,117 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""This module provides a TokenStore class which is designed to manage
+auth tokens required for different services.
+
+Each token is valid for a set of scopes which is the start of a URL. An HTTP
+client will use a token store to find a valid Authorization header to send
+in requests to the specified URL. If the HTTP client determines that a token
+has expired or been revoked, it can remove the token from the store so that
+it will not be used in future requests.
+"""
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import atom.http_interface
+import atom.url
+
+
+SCOPE_ALL = 'http'
+
+
+class TokenStore(object):
+ """Manages Authorization tokens which will be sent in HTTP headers."""
+ def __init__(self, scoped_tokens=None):
+ self._tokens = scoped_tokens or {}
+
+ def add_token(self, token):
+ """Adds a new token to the store (replaces tokens with the same scope).
+
+ Args:
+ token: A subclass of http_interface.GenericToken. The token object is
+ responsible for adding the Authorization header to the HTTP request.
+ The scopes defined in the token are used to determine if the token
+ is valid for a requested scope when find_token is called.
+
+ Returns:
+ True if the token was added, False if the token was not added becase
+ no scopes were provided.
+ """
+ if not hasattr(token, 'scopes') or not token.scopes:
+ return False
+
+ for scope in token.scopes:
+ self._tokens[str(scope)] = token
+ return True
+
+ def find_token(self, url):
+ """Selects an Authorization header token which can be used for the URL.
+
+ Args:
+ url: str or atom.url.Url or a list containing the same.
+ The URL which is going to be requested. All
+ tokens are examined to see if any scopes begin match the beginning
+ of the URL. The first match found is returned.
+
+ Returns:
+ The token object which should execute the HTTP request. If there was
+ no token for the url (the url did not begin with any of the token
+ scopes available), then the atom.http_interface.GenericToken will be
+ returned because the GenericToken calls through to the http client
+ without adding an Authorization header.
+ """
+ if url is None:
+ return None
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ if url in self._tokens:
+ token = self._tokens[url]
+ if token.valid_for_scope(url):
+ return token
+ else:
+ del self._tokens[url]
+ for scope, token in self._tokens.iteritems():
+ if token.valid_for_scope(url):
+ return token
+ return atom.http_interface.GenericToken()
+
+ def remove_token(self, token):
+ """Removes the token from the token_store.
+
+ This method is used when a token is determined to be invalid. If the
+ token was found by find_token, but resulted in a 401 or 403 error stating
+ that the token was invlid, then the token should be removed to prevent
+ future use.
+
+ Returns:
+ True if a token was found and then removed from the token
+ store. False if the token was not in the TokenStore.
+ """
+ token_found = False
+ scopes_to_delete = []
+ for scope, stored_token in self._tokens.iteritems():
+ if stored_token == token:
+ scopes_to_delete.append(scope)
+ token_found = True
+ for scope in scopes_to_delete:
+ del self._tokens[scope]
+ return token_found
+
+ def remove_all_tokens(self):
+ self._tokens = {}
diff --git a/samples/apps/marketplace_sample/atom/url.py b/samples/apps/marketplace_sample/atom/url.py
new file mode 100644
index 0000000..0effa10
--- /dev/null
+++ b/samples/apps/marketplace_sample/atom/url.py
@@ -0,0 +1,139 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import urlparse
+import urllib
+
+
+DEFAULT_PROTOCOL = 'http'
+DEFAULT_PORT = 80
+
+
+def parse_url(url_string):
+ """Creates a Url object which corresponds to the URL string.
+
+ This method can accept partial URLs, but it will leave missing
+ members of the Url unset.
+ """
+ parts = urlparse.urlparse(url_string)
+ url = Url()
+ if parts[0]:
+ url.protocol = parts[0]
+ if parts[1]:
+ host_parts = parts[1].split(':')
+ if host_parts[0]:
+ url.host = host_parts[0]
+ if len(host_parts) > 1:
+ url.port = host_parts[1]
+ if parts[2]:
+ url.path = parts[2]
+ if parts[4]:
+ param_pairs = parts[4].split('&')
+ for pair in param_pairs:
+ pair_parts = pair.split('=')
+ if len(pair_parts) > 1:
+ url.params[urllib.unquote_plus(pair_parts[0])] = (
+ urllib.unquote_plus(pair_parts[1]))
+ elif len(pair_parts) == 1:
+ url.params[urllib.unquote_plus(pair_parts[0])] = None
+ return url
+
+class Url(object):
+ """Represents a URL and implements comparison logic.
+
+ URL strings which are not identical can still be equivalent, so this object
+ provides a better interface for comparing and manipulating URLs than
+ strings. URL parameters are represented as a dictionary of strings, and
+ defaults are used for the protocol (http) and port (80) if not provided.
+ """
+ def __init__(self, protocol=None, host=None, port=None, path=None,
+ params=None):
+ self.protocol = protocol
+ self.host = host
+ self.port = port
+ self.path = path
+ self.params = params or {}
+
+ def to_string(self):
+ url_parts = ['', '', '', '', '', '']
+ if self.protocol:
+ url_parts[0] = self.protocol
+ if self.host:
+ if self.port:
+ url_parts[1] = ':'.join((self.host, str(self.port)))
+ else:
+ url_parts[1] = self.host
+ if self.path:
+ url_parts[2] = self.path
+ if self.params:
+ url_parts[4] = self.get_param_string()
+ return urlparse.urlunparse(url_parts)
+
+ def get_param_string(self):
+ param_pairs = []
+ for key, value in self.params.iteritems():
+ param_pairs.append('='.join((urllib.quote_plus(key),
+ urllib.quote_plus(str(value)))))
+ return '&'.join(param_pairs)
+
+ def get_request_uri(self):
+ """Returns the path with the parameters escaped and appended."""
+ param_string = self.get_param_string()
+ if param_string:
+ return '?'.join([self.path, param_string])
+ else:
+ return self.path
+
+ def __cmp__(self, other):
+ if not isinstance(other, Url):
+ return cmp(self.to_string(), str(other))
+ difference = 0
+ # Compare the protocol
+ if self.protocol and other.protocol:
+ difference = cmp(self.protocol, other.protocol)
+ elif self.protocol and not other.protocol:
+ difference = cmp(self.protocol, DEFAULT_PROTOCOL)
+ elif not self.protocol and other.protocol:
+ difference = cmp(DEFAULT_PROTOCOL, other.protocol)
+ if difference != 0:
+ return difference
+ # Compare the host
+ difference = cmp(self.host, other.host)
+ if difference != 0:
+ return difference
+ # Compare the port
+ if self.port and other.port:
+ difference = cmp(self.port, other.port)
+ elif self.port and not other.port:
+ difference = cmp(self.port, DEFAULT_PORT)
+ elif not self.port and other.port:
+ difference = cmp(DEFAULT_PORT, other.port)
+ if difference != 0:
+ return difference
+ # Compare the path
+ difference = cmp(self.path, other.path)
+ if difference != 0:
+ return difference
+ # Compare the parameters
+ return cmp(self.params, other.params)
+
+ def __str__(self):
+ return self.to_string()
+
diff --git a/samples/apps/marketplace_sample/css/style.css b/samples/apps/marketplace_sample/css/style.css
new file mode 100644
index 0000000..c48aacf
--- /dev/null
+++ b/samples/apps/marketplace_sample/css/style.css
@@ -0,0 +1,24 @@
+#kd-googlebar {
+ position: relative;
+ background: #F1F1F1;
+ height: 70px;
+ line-height: 70px;
+ padding-left: 44px;
+ border-bottom: 1px solid #E5E5E5;
+ z-index: 40;
+ vertical-align: top;
+}
+
+#users {
+ text-align: center;
+ top:200px;
+ right:10px;
+}
+
+#input_details {
+ margin-left: auto;
+ margin-right: auto;
+ border-width: 4px;
+ border-style: outset;
+ border-color: gray;
+}
diff --git a/samples/apps/marketplace_sample/domain_mgmt_app.py b/samples/apps/marketplace_sample/domain_mgmt_app.py
new file mode 100644
index 0000000..062b6b0
--- /dev/null
+++ b/samples/apps/marketplace_sample/domain_mgmt_app.py
@@ -0,0 +1,240 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2012 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google Apps marketplace sample app.
+
+Demonstartes how to use provisoining data in marketplace apps.
+"""
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+import logging
+import os
+import re
+import urllib
+from urlparse import urlparse
+from django.utils import simplejson as json
+from google.appengine.api import users
+from google.appengine.ext import webapp
+from google.appengine.ext.webapp import template
+from google.appengine.ext.webapp import util
+from appengine_utilities.sessions import Session
+from gdata.apps.client import AppsClient
+from gdata.apps.groups.client import GroupsProvisioningClient
+from gdata.apps.organization.client import OrganizationUnitProvisioningClient
+import gdata.auth
+
+CONSUMER_KEY = '965697648820.apps.googleusercontent.com'
+CONSUMER_SECRET = '3GBNP4EJykV7wq8tuN0LTFLr'
+
+
+class TwoLeggedOauthTokenGenerator(webapp.RequestHandler):
+ def Get2loToken(self):
+ user = users.get_current_user()
+ return gdata.gauth.TwoLeggedOAuthHmacToken(
+ CONSUMER_KEY, CONSUMER_SECRET, user.email())
+
+
+class MainHandler(TwoLeggedOauthTokenGenerator):
+ """Handles initial get request and post request to '/' URL."""
+
+ def get(self):
+ """Handels the get request for the MainHandler.
+
+ It checks if a the user is logged in and also that he belogs to the domain,
+ if not redirects it to the login page else to the index.html page.
+ """
+ domain = self.request.get('domain')
+ if not domain:
+ self.response.out.write(
+ 'Missing required params. To use the app start with following URL: '
+ 'http://domain-mgmt.appspot.com?from=google&domain=yourdomain.com')
+ return
+ user = users.get_current_user()
+ if user and self.CheckEmail(user):
+ logging.debug('logged in user: %s', user.email())
+ session = Session()
+ session['domain'] = domain
+ else:
+ self.redirect('/_ah/login_required?' +
+ urllib.urlencode((self.request.str_params)))
+
+ path = os.path.join(os.path.dirname(__file__), 'templates/index.html')
+ self.response.out.write(template.render(path, {}))
+
+ def CheckEmail(self, user):
+ """Performs basic validation of the supplied email address.
+
+ Args:
+ user: A User object corresponding to logged in user.
+
+ Returns:
+ True if user is valid, False otherwise.
+ """
+ domain = urlparse(user.federated_identity()).hostname
+ m = re.search('.*@' + domain, user.email())
+ if m:
+ return True
+ else:
+ return False
+
+ def post(self):
+ """Handels the get request for the MainHandler.
+
+ Retrieves a list of all of the domain's users and sends it
+ to the Client as a JSON object.
+ """
+ users_list = []
+ session = Session()
+ domain = session['domain']
+ client = AppsClient(domain=domain)
+ client.auth_token = self.Get2loToken()
+ client.ssl = True
+ feed = client.RetrieveAllUsers()
+ for entry in feed.entry:
+ users_list.append(entry.login.user_name)
+ self.response.out.write(json.dumps(users_list))
+
+
+class UserDetailsHandler(TwoLeggedOauthTokenGenerator):
+ """Handles get request to '/getdetails' URL."""
+
+ def get(self, username):
+ """Handels the get request for the UserDetailsHandler.
+
+ Sends groups, organization unit and nicknames for the user
+ in a JSON object.
+
+ Args:
+ username: A string denoting the user's username.
+ """
+ session = Session()
+ domain = session['domain']
+ if not domain:
+ self.redirect('/')
+ details = {}
+ details['groups'] = self.GetGroups(domain, username)
+ details['orgunit'] = self.GetOrgunit(domain, username)
+ details['nicknames'] = self.GetNicknames(domain, username)
+ data = json.dumps(details)
+ logging.debug('Sending data...')
+ logging.debug(data)
+ self.response.out.write(data)
+ logging.debug('Data sent successfully')
+
+ def GetGroups(self, domain, username):
+ """Retrieves a list of groups for the given user.
+
+ Args:
+ domain: A string determining the user's domain.
+ username: A string denoting the user's username.
+
+ Returns:
+ A list of dicts of groups with their name and ID if successful.
+ Otherwise a list with single dict entry containing error message.
+ """
+ try:
+ groups_client = GroupsProvisioningClient(domain=domain)
+ groups_client.auth_token = self.Get2loToken()
+ groups_client.ssl = True
+ feed = groups_client.RetrieveGroups(username, True)
+ groups = []
+ for entry in feed.entry:
+ group = {}
+ group['name'] = entry.group_name
+ group['id'] = entry.group_id
+ groups.append(group)
+ return groups
+ except:
+ return [{'name': 'An error occured while retriving Groups for the user',
+ 'id': 'An error occured while retriving Groups for the user'}]
+
+ def GetOrgunit(self, domain, username):
+ """Retrieves the Org Unit corresponding to the user.
+
+ Args:
+ domain: A string determining the user's domain.
+ username: A string denoting the user's username.
+
+ Returns:
+ A dict of orgunit having its name and path if successful.
+ Otherwise a dict entry containing error message.
+ """
+ try:
+ ouclient = OrganizationUnitProvisioningClient(domain=domain)
+ ouclient.auth_token = self.Get2loToken()
+ ouclient.ssl = True
+ customer_id = ouclient.RetrieveCustomerId().customer_id
+ entry = ouclient.RetrieveOrgUser(customer_id, username + '@' + domain)
+ oupath = entry.org_unit_path
+ orgunit = {}
+ if not oupath:
+ orgunit['name'] = 'MAIN ORG UNIT'
+ orgunit['path'] = '/'
+ return orgunit
+ entry = ouclient.RetrieveOrgUnit(customer_id, oupath)
+ orgunit['name'] = entry.org_unit_name
+ orgunit['path'] = entry.org_unit_path
+ return orgunit
+ except:
+ return {'name': 'An error occured while retriving OrgUnit for the user.',
+ 'path': 'An error occured while retriving OrgUnit for the user.'}
+
+ def GetNicknames(self, domain, username):
+ """Retrieves the list of all the nicknames for the user.
+
+ Args:
+ domain: A string determining the user's domain.
+ username: A string denoting the user's username.
+
+ Returns:
+ A list of user's nicknames if successful.
+ Otherwise a list with a single entry containing error message.
+ """
+ try:
+ client = AppsClient(domain=domain)
+ client.auth_token = self.Get2loToken()
+ client.ssl = True
+ feed = client.RetrieveNicknames(username)
+ nicknames = []
+ for entry in feed.entry:
+ nicknames.append(entry.nickname.name)
+ return nicknames
+ except:
+ return ['An error occured while retriving Nicknames for the user.']
+
+
+class OpenIDHandler(webapp.RequestHandler):
+ def get(self):
+ """Begins the OpenID flow for the supplied domain."""
+ domain = self.request.get('domain')
+ self.redirect(users.create_login_url(
+ dest_url='https://domain-mgmt.appspot.com?domain=' + domain,
+ _auth_domain=None,
+ federated_identity=domain))
+
+
+def main():
+ application = webapp.WSGIApplication([('/', MainHandler),
+ ('/getdetails/(.*)',
+ UserDetailsHandler),
+ ('/_ah/login_required', OpenIDHandler)],
+ debug=True)
+ util.run_wsgi_app(application)
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/marketplace_sample/gdata/__init__.py b/samples/apps/marketplace_sample/gdata/__init__.py
new file mode 100755
index 0000000..634889b
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/__init__.py
@@ -0,0 +1,835 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains classes representing Google Data elements.
+
+ Extends Atom classes to add Google Data specific elements.
+"""
+
+
+__author__ = 'j.s@google.com (Jeffrey Scudder)'
+
+import os
+import atom
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+
+
+# XML namespaces which are often used in GData entities.
+GDATA_NAMESPACE = 'http://schemas.google.com/g/2005'
+GDATA_TEMPLATE = '{http://schemas.google.com/g/2005}%s'
+OPENSEARCH_NAMESPACE = 'http://a9.com/-/spec/opensearchrss/1.0/'
+OPENSEARCH_TEMPLATE = '{http://a9.com/-/spec/opensearchrss/1.0/}%s'
+BATCH_NAMESPACE = 'http://schemas.google.com/gdata/batch'
+GACL_NAMESPACE = 'http://schemas.google.com/acl/2007'
+GACL_TEMPLATE = '{http://schemas.google.com/acl/2007}%s'
+
+
+# Labels used in batch request entries to specify the desired CRUD operation.
+BATCH_INSERT = 'insert'
+BATCH_UPDATE = 'update'
+BATCH_DELETE = 'delete'
+BATCH_QUERY = 'query'
+
+class Error(Exception):
+ pass
+
+
+class MissingRequiredParameters(Error):
+ pass
+
+
+class MediaSource(object):
+ """GData Entries can refer to media sources, so this class provides a
+ place to store references to these objects along with some metadata.
+ """
+
+ def __init__(self, file_handle=None, content_type=None, content_length=None,
+ file_path=None, file_name=None):
+ """Creates an object of type MediaSource.
+
+ Args:
+ file_handle: A file handle pointing to the file to be encapsulated in the
+ MediaSource
+ content_type: string The MIME type of the file. Required if a file_handle
+ is given.
+ content_length: int The size of the file. Required if a file_handle is
+ given.
+ file_path: string (optional) A full path name to the file. Used in
+ place of a file_handle.
+ file_name: string The name of the file without any path information.
+ Required if a file_handle is given.
+ """
+ self.file_handle = file_handle
+ self.content_type = content_type
+ self.content_length = content_length
+ self.file_name = file_name
+
+ if (file_handle is None and content_type is not None and
+ file_path is not None):
+ self.setFile(file_path, content_type)
+
+ def setFile(self, file_name, content_type):
+ """A helper function which can create a file handle from a given filename
+ and set the content type and length all at once.
+
+ Args:
+ file_name: string The path and file name to the file containing the media
+ content_type: string A MIME type representing the type of the media
+ """
+
+ self.file_handle = open(file_name, 'rb')
+ self.content_type = content_type
+ self.content_length = os.path.getsize(file_name)
+ self.file_name = os.path.basename(file_name)
+
+
+class LinkFinder(atom.LinkFinder):
+ """An "interface" providing methods to find link elements
+
+ GData Entry elements often contain multiple links which differ in the rel
+ attribute or content type. Often, developers are interested in a specific
+ type of link so this class provides methods to find specific classes of
+ links.
+
+ This class is used as a mixin in GData entries.
+ """
+
+ def GetSelfLink(self):
+ """Find the first link with rel set to 'self'
+
+ Returns:
+ An atom.Link or none if none of the links had rel equal to 'self'
+ """
+
+ for a_link in self.link:
+ if a_link.rel == 'self':
+ return a_link
+ return None
+
+ def GetEditLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'edit':
+ return a_link
+ return None
+
+ def GetEditMediaLink(self):
+ """The Picasa API mistakenly returns media-edit rather than edit-media, but
+ this may change soon.
+ """
+ for a_link in self.link:
+ if a_link.rel == 'edit-media':
+ return a_link
+ if a_link.rel == 'media-edit':
+ return a_link
+ return None
+
+ def GetHtmlLink(self):
+ """Find the first link with rel of alternate and type of text/html
+
+ Returns:
+ An atom.Link or None if no links matched
+ """
+ for a_link in self.link:
+ if a_link.rel == 'alternate' and a_link.type == 'text/html':
+ return a_link
+ return None
+
+ def GetPostLink(self):
+ """Get a link containing the POST target URL.
+
+ The POST target URL is used to insert new entries.
+
+ Returns:
+ A link object with a rel matching the POST type.
+ """
+ for a_link in self.link:
+ if a_link.rel == 'http://schemas.google.com/g/2005#post':
+ return a_link
+ return None
+
+ def GetAclLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'http://schemas.google.com/acl/2007#accessControlList':
+ return a_link
+ return None
+
+ def GetFeedLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'http://schemas.google.com/g/2005#feed':
+ return a_link
+ return None
+
+ def GetNextLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'next':
+ return a_link
+ return None
+
+ def GetPrevLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'previous':
+ return a_link
+ return None
+
+
+class TotalResults(atom.AtomBase):
+ """opensearch:TotalResults for a GData feed"""
+
+ _tag = 'totalResults'
+ _namespace = OPENSEARCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def TotalResultsFromString(xml_string):
+ return atom.CreateClassFromXMLString(TotalResults, xml_string)
+
+
+class StartIndex(atom.AtomBase):
+ """The opensearch:startIndex element in GData feed"""
+
+ _tag = 'startIndex'
+ _namespace = OPENSEARCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def StartIndexFromString(xml_string):
+ return atom.CreateClassFromXMLString(StartIndex, xml_string)
+
+
+class ItemsPerPage(atom.AtomBase):
+ """The opensearch:itemsPerPage element in GData feed"""
+
+ _tag = 'itemsPerPage'
+ _namespace = OPENSEARCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def ItemsPerPageFromString(xml_string):
+ return atom.CreateClassFromXMLString(ItemsPerPage, xml_string)
+
+
+class ExtendedProperty(atom.AtomBase):
+ """The Google Data extendedProperty element.
+
+ Used to store arbitrary key-value information specific to your
+ application. The value can either be a text string stored as an XML
+ attribute (.value), or an XML node (XmlBlob) as a child element.
+
+ This element is used in the Google Calendar data API and the Google
+ Contacts data API.
+ """
+
+ _tag = 'extendedProperty'
+ _namespace = GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+ _attributes['value'] = 'value'
+
+ def __init__(self, name=None, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ def GetXmlBlobExtensionElement(self):
+ """Returns the XML blob as an atom.ExtensionElement.
+
+ Returns:
+ An atom.ExtensionElement representing the blob's XML, or None if no
+ blob was set.
+ """
+ if len(self.extension_elements) < 1:
+ return None
+ else:
+ return self.extension_elements[0]
+
+ def GetXmlBlobString(self):
+ """Returns the XML blob as a string.
+
+ Returns:
+ A string containing the blob's XML, or None if no blob was set.
+ """
+ blob = self.GetXmlBlobExtensionElement()
+ if blob:
+ return blob.ToString()
+ return None
+
+ def SetXmlBlob(self, blob):
+ """Sets the contents of the extendedProperty to XML as a child node.
+
+ Since the extendedProperty is only allowed one child element as an XML
+ blob, setting the XML blob will erase any preexisting extension elements
+ in this object.
+
+ Args:
+ blob: str, ElementTree Element or atom.ExtensionElement representing
+ the XML blob stored in the extendedProperty.
+ """
+ # Erase any existing extension_elements, clears the child nodes from the
+ # extendedProperty.
+ self.extension_elements = []
+ if isinstance(blob, atom.ExtensionElement):
+ self.extension_elements.append(blob)
+ elif ElementTree.iselement(blob):
+ self.extension_elements.append(atom._ExtensionElementFromElementTree(
+ blob))
+ else:
+ self.extension_elements.append(atom.ExtensionElementFromString(blob))
+
+
+def ExtendedPropertyFromString(xml_string):
+ return atom.CreateClassFromXMLString(ExtendedProperty, xml_string)
+
+
+class GDataEntry(atom.Entry, LinkFinder):
+ """Extends Atom Entry to provide data processing"""
+
+ _tag = atom.Entry._tag
+ _namespace = atom.Entry._namespace
+ _children = atom.Entry._children.copy()
+ _attributes = atom.Entry._attributes.copy()
+
+ def __GetId(self):
+ return self.__id
+
+ # This method was created to strip the unwanted whitespace from the id's
+ # text node.
+ def __SetId(self, id):
+ self.__id = id
+ if id is not None and id.text is not None:
+ self.__id.text = id.text.strip()
+
+ id = property(__GetId, __SetId)
+
+ def IsMedia(self):
+ """Determines whether or not an entry is a GData Media entry.
+ """
+ if (self.GetEditMediaLink()):
+ return True
+ else:
+ return False
+
+ def GetMediaURL(self):
+ """Returns the URL to the media content, if the entry is a media entry.
+ Otherwise returns None.
+ """
+ if not self.IsMedia():
+ return None
+ else:
+ return self.content.src
+
+
+def GDataEntryFromString(xml_string):
+ """Creates a new GDataEntry instance given a string of XML."""
+ return atom.CreateClassFromXMLString(GDataEntry, xml_string)
+
+
+class GDataFeed(atom.Feed, LinkFinder):
+ """A Feed from a GData service"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = atom.Feed._children.copy()
+ _attributes = atom.Feed._attributes.copy()
+ _children['{%s}totalResults' % OPENSEARCH_NAMESPACE] = ('total_results',
+ TotalResults)
+ _children['{%s}startIndex' % OPENSEARCH_NAMESPACE] = ('start_index',
+ StartIndex)
+ _children['{%s}itemsPerPage' % OPENSEARCH_NAMESPACE] = ('items_per_page',
+ ItemsPerPage)
+ # Add a conversion rule for atom:entry to make it into a GData
+ # Entry.
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [GDataEntry])
+
+ def __GetId(self):
+ return self.__id
+
+ def __SetId(self, id):
+ self.__id = id
+ if id is not None and id.text is not None:
+ self.__id.text = id.text.strip()
+
+ id = property(__GetId, __SetId)
+
+ def __GetGenerator(self):
+ return self.__generator
+
+ def __SetGenerator(self, generator):
+ self.__generator = generator
+ if generator is not None:
+ self.__generator.text = generator.text.strip()
+
+ generator = property(__GetGenerator, __SetGenerator)
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None, entry=None,
+ total_results=None, start_index=None, items_per_page=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ """Constructor for Source
+
+ Args:
+ author: list (optional) A list of Author instances which belong to this
+ class.
+ category: list (optional) A list of Category instances
+ contributor: list (optional) A list on Contributor instances
+ generator: Generator (optional)
+ icon: Icon (optional)
+ id: Id (optional) The entry's Id element
+ link: list (optional) A list of Link instances
+ logo: Logo (optional)
+ rights: Rights (optional) The entry's Rights element
+ subtitle: Subtitle (optional) The entry's subtitle element
+ title: Title (optional) the entry's title element
+ updated: Updated (optional) the entry's updated element
+ entry: list (optional) A list of the Entry instances contained in the
+ feed.
+ text: String (optional) The text contents of the element. This is the
+ contents of the Entry's XML text node.
+ (Example: <foo>This is the text</foo>)
+ extension_elements: list (optional) A list of ExtensionElement instances
+ which are children of this element.
+ extension_attributes: dict (optional) A dictionary of strings which are
+ the values for additional XML attributes of this element.
+ """
+
+ self.author = author or []
+ self.category = category or []
+ self.contributor = contributor or []
+ self.generator = generator
+ self.icon = icon
+ self.id = atom_id
+ self.link = link or []
+ self.logo = logo
+ self.rights = rights
+ self.subtitle = subtitle
+ self.title = title
+ self.updated = updated
+ self.entry = entry or []
+ self.total_results = total_results
+ self.start_index = start_index
+ self.items_per_page = items_per_page
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def GDataFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(GDataFeed, xml_string)
+
+
+class BatchId(atom.AtomBase):
+ _tag = 'id'
+ _namespace = BATCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+
+def BatchIdFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchId, xml_string)
+
+
+class BatchOperation(atom.AtomBase):
+ _tag = 'operation'
+ _namespace = BATCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['type'] = 'type'
+
+ def __init__(self, op_type=None, extension_elements=None,
+ extension_attributes=None,
+ text=None):
+ self.type = op_type
+ atom.AtomBase.__init__(self,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def BatchOperationFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchOperation, xml_string)
+
+
+class BatchStatus(atom.AtomBase):
+ """The batch:status element present in a batch response entry.
+
+ A status element contains the code (HTTP response code) and
+ reason as elements. In a single request these fields would
+ be part of the HTTP response, but in a batch request each
+ Entry operation has a corresponding Entry in the response
+ feed which includes status information.
+
+ See http://code.google.com/apis/gdata/batch.html#Handling_Errors
+ """
+
+ _tag = 'status'
+ _namespace = BATCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['code'] = 'code'
+ _attributes['reason'] = 'reason'
+ _attributes['content-type'] = 'content_type'
+
+ def __init__(self, code=None, reason=None, content_type=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.code = code
+ self.reason = reason
+ self.content_type = content_type
+ atom.AtomBase.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def BatchStatusFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchStatus, xml_string)
+
+
+class BatchEntry(GDataEntry):
+ """An atom:entry for use in batch requests.
+
+ The BatchEntry contains additional members to specify the operation to be
+ performed on this entry and a batch ID so that the server can reference
+ individual operations in the response feed. For more information, see:
+ http://code.google.com/apis/gdata/batch.html
+ """
+
+ _tag = GDataEntry._tag
+ _namespace = GDataEntry._namespace
+ _children = GDataEntry._children.copy()
+ _children['{%s}operation' % BATCH_NAMESPACE] = ('batch_operation', BatchOperation)
+ _children['{%s}id' % BATCH_NAMESPACE] = ('batch_id', BatchId)
+ _children['{%s}status' % BATCH_NAMESPACE] = ('batch_status', BatchStatus)
+ _attributes = GDataEntry._attributes.copy()
+
+ def __init__(self, author=None, category=None, content=None,
+ contributor=None, atom_id=None, link=None, published=None, rights=None,
+ source=None, summary=None, control=None, title=None, updated=None,
+ batch_operation=None, batch_id=None, batch_status=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.batch_operation = batch_operation
+ self.batch_id = batch_id
+ self.batch_status = batch_status
+ GDataEntry.__init__(self, author=author, category=category,
+ content=content, contributor=contributor, atom_id=atom_id, link=link,
+ published=published, rights=rights, source=source, summary=summary,
+ control=control, title=title, updated=updated,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+
+def BatchEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchEntry, xml_string)
+
+
+class BatchInterrupted(atom.AtomBase):
+ """The batch:interrupted element sent if batch request was interrupted.
+
+ Only appears in a feed if some of the batch entries could not be processed.
+ See: http://code.google.com/apis/gdata/batch.html#Handling_Errors
+ """
+
+ _tag = 'interrupted'
+ _namespace = BATCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['reason'] = 'reason'
+ _attributes['success'] = 'success'
+ _attributes['failures'] = 'failures'
+ _attributes['parsed'] = 'parsed'
+
+ def __init__(self, reason=None, success=None, failures=None, parsed=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.reason = reason
+ self.success = success
+ self.failures = failures
+ self.parsed = parsed
+ atom.AtomBase.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def BatchInterruptedFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchInterrupted, xml_string)
+
+
+class BatchFeed(GDataFeed):
+ """A feed containing a list of batch request entries."""
+
+ _tag = GDataFeed._tag
+ _namespace = GDataFeed._namespace
+ _children = GDataFeed._children.copy()
+ _attributes = GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [BatchEntry])
+ _children['{%s}interrupted' % BATCH_NAMESPACE] = ('interrupted', BatchInterrupted)
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None, entry=None,
+ total_results=None, start_index=None, items_per_page=None,
+ interrupted=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.interrupted = interrupted
+ GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results, start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+ def AddBatchEntry(self, entry=None, id_url_string=None,
+ batch_id_string=None, operation_string=None):
+ """Logic for populating members of a BatchEntry and adding to the feed.
+
+
+ If the entry is not a BatchEntry, it is converted to a BatchEntry so
+ that the batch specific members will be present.
+
+ The id_url_string can be used in place of an entry if the batch operation
+ applies to a URL. For example query and delete operations require just
+ the URL of an entry, no body is sent in the HTTP request. If an
+ id_url_string is sent instead of an entry, a BatchEntry is created and
+ added to the feed.
+
+ This method also assigns the desired batch id to the entry so that it
+ can be referenced in the server's response. If the batch_id_string is
+ None, this method will assign a batch_id to be the index at which this
+ entry will be in the feed's entry list.
+
+ Args:
+ entry: BatchEntry, atom.Entry, or another Entry flavor (optional) The
+ entry which will be sent to the server as part of the batch request.
+ The item must have a valid atom id so that the server knows which
+ entry this request references.
+ id_url_string: str (optional) The URL of the entry to be acted on. You
+ can find this URL in the text member of the atom id for an entry.
+ If an entry is not sent, this id will be used to construct a new
+ BatchEntry which will be added to the request feed.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. Note that batch_ids should either always be specified or
+ never, mixing could potentially result in duplicate batch ids.
+ operation_string: str (optional) The desired batch operation which will
+ set the batch_operation.type member of the entry. Options are
+ 'insert', 'update', 'delete', and 'query'
+
+ Raises:
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an
+ entry are provided in the request.
+
+ Returns:
+ The added entry.
+ """
+ if entry is None and id_url_string is None:
+ raise MissingRequiredParameters('supply either an entry or URL string')
+ if entry is None and id_url_string is not None:
+ entry = BatchEntry(atom_id=atom.Id(text=id_url_string))
+ # TODO: handle cases in which the entry lacks batch_... members.
+ #if not isinstance(entry, BatchEntry):
+ # Convert the entry to a batch entry.
+ if batch_id_string is not None:
+ entry.batch_id = BatchId(text=batch_id_string)
+ elif entry.batch_id is None or entry.batch_id.text is None:
+ entry.batch_id = BatchId(text=str(len(self.entry)))
+ if operation_string is not None:
+ entry.batch_operation = BatchOperation(op_type=operation_string)
+ self.entry.append(entry)
+ return entry
+
+ def AddInsert(self, entry, batch_id_string=None):
+ """Add an insert request to the operations in this batch request feed.
+
+ If the entry doesn't yet have an operation or a batch id, these will
+ be set to the insert operation and a batch_id specified as a parameter.
+
+ Args:
+ entry: BatchEntry The entry which will be sent in the batch feed as an
+ insert request.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. Note that batch_ids should either always be specified or
+ never, mixing could potentially result in duplicate batch ids.
+ """
+ entry = self.AddBatchEntry(entry=entry, batch_id_string=batch_id_string,
+ operation_string=BATCH_INSERT)
+
+ def AddUpdate(self, entry, batch_id_string=None):
+ """Add an update request to the list of batch operations in this feed.
+
+ Sets the operation type of the entry to insert if it is not already set
+ and assigns the desired batch id to the entry so that it can be
+ referenced in the server's response.
+
+ Args:
+ entry: BatchEntry The entry which will be sent to the server as an
+ update (HTTP PUT) request. The item must have a valid atom id
+ so that the server knows which entry to replace.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. See also comments for AddInsert.
+ """
+ entry = self.AddBatchEntry(entry=entry, batch_id_string=batch_id_string,
+ operation_string=BATCH_UPDATE)
+
+ def AddDelete(self, url_string=None, entry=None, batch_id_string=None):
+ """Adds a delete request to the batch request feed.
+
+ This method takes either the url_string which is the atom id of the item
+ to be deleted, or the entry itself. The atom id of the entry must be
+ present so that the server knows which entry should be deleted.
+
+ Args:
+ url_string: str (optional) The URL of the entry to be deleted. You can
+ find this URL in the text member of the atom id for an entry.
+ entry: BatchEntry (optional) The entry to be deleted.
+ batch_id_string: str (optional)
+
+ Raises:
+ MissingRequiredParameters: Raised if neither a url_string nor an entry
+ are provided in the request.
+ """
+ entry = self.AddBatchEntry(entry=entry, id_url_string=url_string,
+ batch_id_string=batch_id_string,
+ operation_string=BATCH_DELETE)
+
+ def AddQuery(self, url_string=None, entry=None, batch_id_string=None):
+ """Adds a query request to the batch request feed.
+
+ This method takes either the url_string which is the query URL
+ whose results will be added to the result feed. The query URL will
+ be encapsulated in a BatchEntry, and you may pass in the BatchEntry
+ with a query URL instead of sending a url_string.
+
+ Args:
+ url_string: str (optional)
+ entry: BatchEntry (optional)
+ batch_id_string: str (optional)
+
+ Raises:
+ MissingRequiredParameters
+ """
+ entry = self.AddBatchEntry(entry=entry, id_url_string=url_string,
+ batch_id_string=batch_id_string,
+ operation_string=BATCH_QUERY)
+
+ def GetBatchLink(self):
+ for link in self.link:
+ if link.rel == 'http://schemas.google.com/g/2005#batch':
+ return link
+ return None
+
+
+def BatchFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchFeed, xml_string)
+
+
+class EntryLink(atom.AtomBase):
+ """The gd:entryLink element"""
+
+ _tag = 'entryLink'
+ _namespace = GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ # The entry used to be an atom.Entry, now it is a GDataEntry.
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', GDataEntry)
+ _attributes['rel'] = 'rel'
+ _attributes['readOnly'] = 'read_only'
+ _attributes['href'] = 'href'
+
+ def __init__(self, href=None, read_only=None, rel=None,
+ entry=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.href = href
+ self.read_only = read_only
+ self.rel = rel
+ self.entry = entry
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def EntryLinkFromString(xml_string):
+ return atom.CreateClassFromXMLString(EntryLink, xml_string)
+
+
+class FeedLink(atom.AtomBase):
+ """The gd:feedLink element"""
+
+ _tag = 'feedLink'
+ _namespace = GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}feed' % atom.ATOM_NAMESPACE] = ('feed', GDataFeed)
+ _attributes['rel'] = 'rel'
+ _attributes['readOnly'] = 'read_only'
+ _attributes['countHint'] = 'count_hint'
+ _attributes['href'] = 'href'
+
+ def __init__(self, count_hint=None, href=None, read_only=None, rel=None,
+ feed=None, extension_elements=None, extension_attributes=None,
+ text=None):
+ self.count_hint = count_hint
+ self.href = href
+ self.read_only = read_only
+ self.rel = rel
+ self.feed = feed
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def FeedLinkFromString(xml_string):
+ return atom.CreateClassFromXMLString(FeedLink, xml_string)
diff --git a/samples/apps/marketplace_sample/gdata/apps/__init__.py b/samples/apps/marketplace_sample/gdata/apps/__init__.py
new file mode 100644
index 0000000..ebdf98e
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/__init__.py
@@ -0,0 +1,526 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 SIOS Technology, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains objects used with Google Apps."""
+
+__author__ = 'tmatsuo@sios.com (Takashi MATSUO)'
+
+
+import atom
+import gdata
+
+
+# XML namespaces which are often used in Google Apps entity.
+APPS_NAMESPACE = 'http://schemas.google.com/apps/2006'
+APPS_TEMPLATE = '{http://schemas.google.com/apps/2006}%s'
+
+
+class EmailList(atom.AtomBase):
+ """The Google Apps EmailList element"""
+
+ _tag = 'emailList'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+
+ def __init__(self, name=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+def EmailListFromString(xml_string):
+ return atom.CreateClassFromXMLString(EmailList, xml_string)
+
+
+class Who(atom.AtomBase):
+ """The Google Apps Who element"""
+
+ _tag = 'who'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['rel'] = 'rel'
+ _attributes['email'] = 'email'
+
+ def __init__(self, rel=None, email=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.rel = rel
+ self.email = email
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+def WhoFromString(xml_string):
+ return atom.CreateClassFromXMLString(Who, xml_string)
+
+
+class Login(atom.AtomBase):
+ """The Google Apps Login element"""
+
+ _tag = 'login'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['userName'] = 'user_name'
+ _attributes['password'] = 'password'
+ _attributes['suspended'] = 'suspended'
+ _attributes['admin'] = 'admin'
+ _attributes['changePasswordAtNextLogin'] = 'change_password'
+ _attributes['agreedToTerms'] = 'agreed_to_terms'
+ _attributes['ipWhitelisted'] = 'ip_whitelisted'
+ _attributes['hashFunctionName'] = 'hash_function_name'
+
+ def __init__(self, user_name=None, password=None, suspended=None,
+ ip_whitelisted=None, hash_function_name=None,
+ admin=None, change_password=None, agreed_to_terms=None,
+ extension_elements=None, extension_attributes=None,
+ text=None):
+ self.user_name = user_name
+ self.password = password
+ self.suspended = suspended
+ self.admin = admin
+ self.change_password = change_password
+ self.agreed_to_terms = agreed_to_terms
+ self.ip_whitelisted = ip_whitelisted
+ self.hash_function_name = hash_function_name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def LoginFromString(xml_string):
+ return atom.CreateClassFromXMLString(Login, xml_string)
+
+
+class Quota(atom.AtomBase):
+ """The Google Apps Quota element"""
+
+ _tag = 'quota'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['limit'] = 'limit'
+
+ def __init__(self, limit=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.limit = limit
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def QuotaFromString(xml_string):
+ return atom.CreateClassFromXMLString(Quota, xml_string)
+
+
+class Name(atom.AtomBase):
+ """The Google Apps Name element"""
+
+ _tag = 'name'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['familyName'] = 'family_name'
+ _attributes['givenName'] = 'given_name'
+
+ def __init__(self, family_name=None, given_name=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.family_name = family_name
+ self.given_name = given_name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def NameFromString(xml_string):
+ return atom.CreateClassFromXMLString(Name, xml_string)
+
+
+class Nickname(atom.AtomBase):
+ """The Google Apps Nickname element"""
+
+ _tag = 'nickname'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+
+ def __init__(self, name=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.name = name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def NicknameFromString(xml_string):
+ return atom.CreateClassFromXMLString(Nickname, xml_string)
+
+
+class NicknameEntry(gdata.GDataEntry):
+ """A Google Apps flavor of an Atom Entry for Nickname"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}login' % APPS_NAMESPACE] = ('login', Login)
+ _children['{%s}nickname' % APPS_NAMESPACE] = ('nickname', Nickname)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ login=None, nickname=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.login = login
+ self.nickname = nickname
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def NicknameEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(NicknameEntry, xml_string)
+
+
+class NicknameFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Apps Nickname feed flavor of an Atom Feed"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [NicknameEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def NicknameFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(NicknameFeed, xml_string)
+
+
+class UserEntry(gdata.GDataEntry):
+ """A Google Apps flavor of an Atom Entry"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}login' % APPS_NAMESPACE] = ('login', Login)
+ _children['{%s}name' % APPS_NAMESPACE] = ('name', Name)
+ _children['{%s}quota' % APPS_NAMESPACE] = ('quota', Quota)
+ # This child may already be defined in GDataEntry, confirm before removing.
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feed_link',
+ [gdata.FeedLink])
+ _children['{%s}who' % gdata.GDATA_NAMESPACE] = ('who', Who)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ login=None, name=None, quota=None, who=None, feed_link=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.login = login
+ self.name = name
+ self.quota = quota
+ self.who = who
+ self.feed_link = feed_link or []
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def UserEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(UserEntry, xml_string)
+
+
+class UserFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Apps User feed flavor of an Atom Feed"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [UserEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def UserFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(UserFeed, xml_string)
+
+
+class EmailListEntry(gdata.GDataEntry):
+ """A Google Apps EmailList flavor of an Atom Entry"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}emailList' % APPS_NAMESPACE] = ('email_list', EmailList)
+ # Might be able to remove this _children entry.
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feed_link',
+ [gdata.FeedLink])
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ email_list=None, feed_link=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.email_list = email_list
+ self.feed_link = feed_link or []
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def EmailListEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(EmailListEntry, xml_string)
+
+
+class EmailListFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Apps EmailList feed flavor of an Atom Feed"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [EmailListEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def EmailListFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(EmailListFeed, xml_string)
+
+
+class EmailListRecipientEntry(gdata.GDataEntry):
+ """A Google Apps EmailListRecipient flavor of an Atom Entry"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}who' % gdata.GDATA_NAMESPACE] = ('who', Who)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ who=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.who = who
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def EmailListRecipientEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(EmailListRecipientEntry, xml_string)
+
+
+class EmailListRecipientFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Apps EmailListRecipient feed flavor of an Atom Feed"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [EmailListRecipientEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def EmailListRecipientFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(EmailListRecipientFeed, xml_string)
+
+
+class Property(atom.AtomBase):
+ """The Google Apps Property element"""
+
+ _tag = 'property'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+ _attributes['value'] = 'value'
+
+ def __init__(self, name=None, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def PropertyFromString(xml_string):
+ return atom.CreateClassFromXMLString(Property, xml_string)
+
+
+class PropertyEntry(gdata.GDataEntry):
+ """A Google Apps Property flavor of an Atom Entry"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}property' % APPS_NAMESPACE] = ('property', [Property])
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ property=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.property = property
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def PropertyEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(PropertyEntry, xml_string)
+
+class PropertyFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Apps Property feed flavor of an Atom Feed"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [PropertyEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+def PropertyFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(PropertyFeed, xml_string)
diff --git a/samples/apps/marketplace_sample/gdata/apps/adminsettings/__init__.py b/samples/apps/marketplace_sample/gdata/apps/adminsettings/__init__.py
new file mode 100644
index 0000000..d284c7c
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/adminsettings/__init__.py
@@ -0,0 +1,16 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
diff --git a/samples/apps/marketplace_sample/gdata/apps/adminsettings/service.py b/samples/apps/marketplace_sample/gdata/apps/adminsettings/service.py
new file mode 100644
index 0000000..a15b54e
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/adminsettings/service.py
@@ -0,0 +1,471 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Allow Google Apps domain administrators to set domain admin settings.
+
+ AdminSettingsService: Set admin settings."""
+
+__author__ = 'jlee@pbu.edu'
+
+
+import gdata.apps
+import gdata.apps.service
+import gdata.service
+
+
+API_VER='2.0'
+
+class AdminSettingsService(gdata.apps.service.PropertyService):
+ """Client for the Google Apps Admin Settings service."""
+
+ def _serviceUrl(self, setting_id, domain=None):
+ if domain is None:
+ domain = self.domain
+ return '/a/feeds/domain/%s/%s/%s' % (API_VER, domain, setting_id)
+
+ def genericGet(self, location):
+ """Generic HTTP Get Wrapper
+
+ Args:
+ location: relative uri to Get
+
+ Returns:
+ A dict containing the result of the get operation."""
+
+ uri = self._serviceUrl(location)
+ try:
+ return self._GetProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def GetDefaultLanguage(self):
+ """Gets Domain Default Language
+
+ Args:
+ None
+
+ Returns:
+ Default Language as a string. All possible values are listed at:
+ http://code.google.com/apis/apps/email_settings/developers_guide_protocol.html#GA_email_language_tags"""
+
+ result = self.genericGet('general/defaultLanguage')
+ return result['defaultLanguage']
+
+ def UpdateDefaultLanguage(self, defaultLanguage):
+ """Updates Domain Default Language
+
+ Args:
+ defaultLanguage: Domain Language to set
+ possible values are at:
+ http://code.google.com/apis/apps/email_settings/developers_guide_protocol.html#GA_email_language_tags
+
+ Returns:
+ A dict containing the result of the put operation"""
+
+ uri = self._serviceUrl('general/defaultLanguage')
+ properties = {'defaultLanguage': defaultLanguage}
+ return self._PutProperties(uri, properties)
+
+ def GetOrganizationName(self):
+ """Gets Domain Default Language
+
+ Args:
+ None
+
+ Returns:
+ Organization Name as a string."""
+
+ result = self.genericGet('general/organizationName')
+ return result['organizationName']
+
+
+ def UpdateOrganizationName(self, organizationName):
+ """Updates Organization Name
+
+ Args:
+ organizationName: Name of organization
+
+ Returns:
+ A dict containing the result of the put operation"""
+
+ uri = self._serviceUrl('general/organizationName')
+ properties = {'organizationName': organizationName}
+ return self._PutProperties(uri, properties)
+
+ def GetMaximumNumberOfUsers(self):
+ """Gets Maximum Number of Users Allowed
+
+ Args:
+ None
+
+ Returns: An integer, the maximum number of users"""
+
+ result = self.genericGet('general/maximumNumberOfUsers')
+ return int(result['maximumNumberOfUsers'])
+
+ def GetCurrentNumberOfUsers(self):
+ """Gets Current Number of Users
+
+ Args:
+ None
+
+ Returns: An integer, the current number of users"""
+
+ result = self.genericGet('general/currentNumberOfUsers')
+ return int(result['currentNumberOfUsers'])
+
+ def IsDomainVerified(self):
+ """Is the domain verified
+
+ Args:
+ None
+
+ Returns: Boolean, is domain verified"""
+
+ result = self.genericGet('accountInformation/isVerified')
+ if result['isVerified'] == 'true':
+ return True
+ else:
+ return False
+
+ def GetSupportPIN(self):
+ """Gets Support PIN
+
+ Args:
+ None
+
+ Returns: A string, the Support PIN"""
+
+ result = self.genericGet('accountInformation/supportPIN')
+ return result['supportPIN']
+
+ def GetEdition(self):
+ """Gets Google Apps Domain Edition
+
+ Args:
+ None
+
+ Returns: A string, the domain's edition (premier, education, partner)"""
+
+ result = self.genericGet('accountInformation/edition')
+ return result['edition']
+
+ def GetCustomerPIN(self):
+ """Gets Customer PIN
+
+ Args:
+ None
+
+ Returns: A string, the customer PIN"""
+
+ result = self.genericGet('accountInformation/customerPIN')
+ return result['customerPIN']
+
+ def GetCreationTime(self):
+ """Gets Domain Creation Time
+
+ Args:
+ None
+
+ Returns: A string, the domain's creation time"""
+
+ result = self.genericGet('accountInformation/creationTime')
+ return result['creationTime']
+
+ def GetCountryCode(self):
+ """Gets Domain Country Code
+
+ Args:
+ None
+
+ Returns: A string, the domain's country code. Possible values at:
+ http://www.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm"""
+
+ result = self.genericGet('accountInformation/countryCode')
+ return result['countryCode']
+
+ def GetAdminSecondaryEmail(self):
+ """Gets Domain Admin Secondary Email Address
+
+ Args:
+ None
+
+ Returns: A string, the secondary email address for domain admin"""
+
+ result = self.genericGet('accountInformation/adminSecondaryEmail')
+ return result['adminSecondaryEmail']
+
+ def UpdateAdminSecondaryEmail(self, adminSecondaryEmail):
+ """Gets Domain Creation Time
+
+ Args:
+ adminSecondaryEmail: string, secondary email address of admin
+
+ Returns: A dict containing the result of the put operation"""
+
+ uri = self._serviceUrl('accountInformation/adminSecondaryEmail')
+ properties = {'adminSecondaryEmail': adminSecondaryEmail}
+ return self._PutProperties(uri, properties)
+
+ def GetDomainLogo(self):
+ """Gets Domain Logo
+
+ This function does not make use of the Google Apps Admin Settings API,
+ it does an HTTP Get of a url specific to the Google Apps domain. It is
+ included for completeness sake.
+
+ Args:
+ None
+
+ Returns: binary image file"""
+
+ import urllib
+ url = 'http://www.google.com/a/cpanel/'+self.domain+'/images/logo.gif'
+ response = urllib.urlopen(url)
+ return response.read()
+
+ def UpdateDomainLogo(self, logoImage):
+ """Update Domain's Custom Logo
+
+ Args:
+ logoImage: binary image data
+
+ Returns: A dict containing the result of the put operation"""
+
+ from base64 import b64encode
+ uri = self._serviceUrl('appearance/customLogo')
+ properties = {'logoImage': b64encode(logoImage)}
+ return self._PutProperties(uri, properties)
+
+ def GetCNAMEVerificationStatus(self):
+ """Gets Domain CNAME Verification Status
+
+ Args:
+ None
+
+ Returns: A dict {recordName, verified, verifiedMethod}"""
+
+ return self.genericGet('verification/cname')
+
+ def UpdateCNAMEVerificationStatus(self, verified):
+ """Updates CNAME Verification Status
+
+ Args:
+ verified: boolean, True will retry verification process
+
+ Returns: A dict containing the result of the put operation"""
+
+ uri = self._serviceUrl('verification/cname')
+ properties = self.GetCNAMEVerificationStatus()
+ properties['verified'] = verified
+ return self._PutProperties(uri, properties)
+
+ def GetMXVerificationStatus(self):
+ """Gets Domain MX Verification Status
+
+ Args:
+ None
+
+ Returns: A dict {verified, verifiedMethod}"""
+
+ return self.genericGet('verification/mx')
+
+ def UpdateMXVerificationStatus(self, verified):
+ """Updates MX Verification Status
+
+ Args:
+ verified: boolean, True will retry verification process
+
+ Returns: A dict containing the result of the put operation"""
+
+ uri = self._serviceUrl('verification/mx')
+ properties = self.GetMXVerificationStatus()
+ properties['verified'] = verified
+ return self._PutProperties(uri, properties)
+
+ def GetSSOSettings(self):
+ """Gets Domain Single Sign-On Settings
+
+ Args:
+ None
+
+ Returns: A dict {samlSignonUri, samlLogoutUri, changePasswordUri, enableSSO, ssoWhitelist, useDomainSpecificIssuer}"""
+
+ return self.genericGet('sso/general')
+
+ def UpdateSSOSettings(self, enableSSO=None, samlSignonUri=None,
+ samlLogoutUri=None, changePasswordUri=None,
+ ssoWhitelist=None, useDomainSpecificIssuer=None):
+ """Update SSO Settings.
+
+ Args:
+ enableSSO: boolean, SSO Master on/off switch
+ samlSignonUri: string, SSO Login Page
+ samlLogoutUri: string, SSO Logout Page
+ samlPasswordUri: string, SSO Password Change Page
+ ssoWhitelist: string, Range of IP Addresses which will see SSO
+ useDomainSpecificIssuer: boolean, Include Google Apps Domain in Issuer
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('sso/general')
+
+ #Get current settings, replace Nones with ''
+ properties = self.GetSSOSettings()
+ if properties['samlSignonUri'] == None:
+ properties['samlSignonUri'] = ''
+ if properties['samlLogoutUri'] == None:
+ properties['samlLogoutUri'] = ''
+ if properties['changePasswordUri'] == None:
+ properties['changePasswordUri'] = ''
+ if properties['ssoWhitelist'] == None:
+ properties['ssoWhitelist'] = ''
+
+ #update only the values we were passed
+ if enableSSO != None:
+ properties['enableSSO'] = gdata.apps.service._bool2str(enableSSO)
+ if samlSignonUri != None:
+ properties['samlSignonUri'] = samlSignonUri
+ if samlLogoutUri != None:
+ properties['samlLogoutUri'] = samlLogoutUri
+ if changePasswordUri != None:
+ properties['changePasswordUri'] = changePasswordUri
+ if ssoWhitelist != None:
+ properties['ssoWhitelist'] = ssoWhitelist
+ if useDomainSpecificIssuer != None:
+ properties['useDomainSpecificIssuer'] = gdata.apps.service._bool2str(useDomainSpecificIssuer)
+
+ return self._PutProperties(uri, properties)
+
+ def GetSSOKey(self):
+ """Gets Domain Single Sign-On Signing Key
+
+ Args:
+ None
+
+ Returns: A dict {modulus, exponent, algorithm, format}"""
+
+ return self.genericGet('sso/signingkey')
+
+ def UpdateSSOKey(self, signingKey):
+ """Update SSO Settings.
+
+ Args:
+ signingKey: string, public key to be uploaded
+
+ Returns:
+ A dict containing the result of the update operation."""
+
+ uri = self._serviceUrl('sso/signingkey')
+ properties = {'signingKey': signingKey}
+ return self._PutProperties(uri, properties)
+
+ def IsUserMigrationEnabled(self):
+ """Is User Migration Enabled
+
+ Args:
+ None
+
+ Returns:
+ boolean, is user migration enabled"""
+
+ result = self.genericGet('email/migration')
+ if result['enableUserMigration'] == 'true':
+ return True
+ else:
+ return False
+
+ def UpdateUserMigrationStatus(self, enableUserMigration):
+ """Update User Migration Status
+
+ Args:
+ enableUserMigration: boolean, user migration enable/disable
+
+ Returns:
+ A dict containing the result of the update operation."""
+
+ uri = self._serviceUrl('email/migration')
+ properties = {'enableUserMigration': enableUserMigration}
+ return self._PutProperties(uri, properties)
+
+ def GetOutboundGatewaySettings(self):
+ """Get Outbound Gateway Settings
+
+ Args:
+ None
+
+ Returns:
+ A dict {smartHost, smtpMode}"""
+
+ uri = self._serviceUrl('email/gateway')
+ try:
+ return self._GetProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+ except TypeError:
+ #if no outbound gateway is set, we get a TypeError,
+ #catch it and return nothing...
+ return {'smartHost': None, 'smtpMode': None}
+
+ def UpdateOutboundGatewaySettings(self, smartHost=None, smtpMode=None):
+ """Update Outbound Gateway Settings
+
+ Args:
+ smartHost: string, ip address or hostname of outbound gateway
+ smtpMode: string, SMTP or SMTP_TLS
+
+ Returns:
+ A dict containing the result of the update operation."""
+
+ uri = self._serviceUrl('email/gateway')
+
+ #Get current settings, replace Nones with ''
+ properties = GetOutboundGatewaySettings()
+ if properties['smartHost'] == None:
+ properties['smartHost'] = ''
+ if properties['smtpMode'] == None:
+ properties['smtpMode'] = ''
+
+ #If we were passed new values for smartHost or smtpMode, update them
+ if smartHost != None:
+ properties['smartHost'] = smartHost
+ if smtpMode != None:
+ properties['smtpMode'] = smtpMode
+
+ return self._PutProperties(uri, properties)
+
+ def AddEmailRoute(self, routeDestination, routeRewriteTo, routeEnabled, bounceNotifications, accountHandling):
+ """Adds Domain Email Route
+
+ Args:
+ routeDestination: string, destination ip address or hostname
+ routeRewriteTo: boolean, rewrite smtp envelop To:
+ routeEnabled: boolean, enable disable email routing
+ bounceNotifications: boolean, send bound notificiations to sender
+ accountHandling: string, which to route, "allAccounts", "provisionedAccounts", "unknownAccounts"
+
+ Returns:
+ A dict containing the result of the update operation."""
+
+ uri = self._serviceUrl('emailrouting')
+ properties = {}
+ properties['routeDestination'] = routeDestination
+ properties['routeRewriteTo'] = gdata.apps.service._bool2str(routeRewriteTo)
+ properties['routeEnabled'] = gdata.apps.service._bool2str(routeEnabled)
+ properties['bounceNotifications'] = gdata.apps.service._bool2str(bounceNotifications)
+ properties['accountHandling'] = accountHandling
+ return self._PostProperties(uri, properties)
diff --git a/samples/apps/marketplace_sample/gdata/apps/apps_property_entry.py b/samples/apps/marketplace_sample/gdata/apps/apps_property_entry.py
new file mode 100644
index 0000000..3177fb8
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/apps_property_entry.py
@@ -0,0 +1,65 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Generic class for Set/Get properties of GData Provisioning clients."""
+
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+
+import gdata.apps
+import gdata.apps_property
+import gdata.data
+
+
+class AppsPropertyEntry(gdata.data.GDEntry):
+ """Represents a generic entry in object form."""
+
+ property = [gdata.apps_property.AppsProperty]
+
+ def _GetProperty(self, name):
+ """Get the apps:property value with the given name.
+
+ Args:
+ name: string Name of the apps:property value to get.
+
+ Returns:
+ The apps:property value with the given name, or None if the name was
+ invalid.
+ """
+ value = None
+ for p in self.property:
+ if p.name == name:
+ value = p.value
+ break
+ return value
+
+ def _SetProperty(self, name, value):
+ """Set the apps:property value with the given name to the given value.
+
+ Args:
+ name: string Name of the apps:property value to set.
+ value: string Value to give the apps:property value with the given name.
+ """
+ found = False
+ for i in range(len(self.property)):
+ if self.property[i].name == name:
+ self.property[i].value = value
+ found = True
+ break
+ if not found:
+ self.property.append(
+ gdata.apps_property.AppsProperty(name=name, value=value))
diff --git a/samples/apps/marketplace_sample/gdata/apps/audit/__init__.py b/samples/apps/marketplace_sample/gdata/apps/audit/__init__.py
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/audit/__init__.py
@@ -0,0 +1 @@
+
diff --git a/samples/apps/marketplace_sample/gdata/apps/audit/service.py b/samples/apps/marketplace_sample/gdata/apps/audit/service.py
new file mode 100644
index 0000000..d8cf72c
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/audit/service.py
@@ -0,0 +1,277 @@
+# Copyright (C) 2008 Google, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Allow Google Apps domain administrators to audit user data.
+
+ AuditService: Set auditing."""
+
+__author__ = 'jlee@pbu.edu'
+
+from base64 import b64encode
+
+import gdata.apps
+import gdata.apps.service
+import gdata.service
+
+class AuditService(gdata.apps.service.PropertyService):
+ """Client for the Google Apps Audit service."""
+
+ def _serviceUrl(self, setting_id, domain=None, user=None):
+ if domain is None:
+ domain = self.domain
+ if user is None:
+ return '/a/feeds/compliance/audit/%s/%s' % (setting_id, domain)
+ else:
+ return '/a/feeds/compliance/audit/%s/%s/%s' % (setting_id, domain, user)
+
+ def updatePGPKey(self, pgpkey):
+ """Updates Public PGP Key Google uses to encrypt audit data
+
+ Args:
+ pgpkey: string, ASCII text of PGP Public Key to be used
+
+ Returns:
+ A dict containing the result of the POST operation."""
+
+ uri = self._serviceUrl('publickey')
+ b64pgpkey = b64encode(pgpkey)
+ properties = {}
+ properties['publicKey'] = b64pgpkey
+ return self._PostProperties(uri, properties)
+
+ def createEmailMonitor(self, source_user, destination_user, end_date,
+ begin_date=None, incoming_headers_only=False,
+ outgoing_headers_only=False, drafts=False,
+ drafts_headers_only=False, chats=False,
+ chats_headers_only=False):
+ """Creates a email monitor, forwarding the source_users emails/chats
+
+ Args:
+ source_user: string, the user whose email will be audited
+ destination_user: string, the user to receive the audited email
+ end_date: string, the date the audit will end in
+ "yyyy-MM-dd HH:mm" format, required
+ begin_date: string, the date the audit will start in
+ "yyyy-MM-dd HH:mm" format, leave blank to use current time
+ incoming_headers_only: boolean, whether to audit only the headers of
+ mail delivered to source user
+ outgoing_headers_only: boolean, whether to audit only the headers of
+ mail sent from the source user
+ drafts: boolean, whether to audit draft messages of the source user
+ drafts_headers_only: boolean, whether to audit only the headers of
+ mail drafts saved by the user
+ chats: boolean, whether to audit archived chats of the source user
+ chats_headers_only: boolean, whether to audit only the headers of
+ archived chats of the source user
+
+ Returns:
+ A dict containing the result of the POST operation."""
+
+ uri = self._serviceUrl('mail/monitor', user=source_user)
+ properties = {}
+ properties['destUserName'] = destination_user
+ if begin_date is not None:
+ properties['beginDate'] = begin_date
+ properties['endDate'] = end_date
+ if incoming_headers_only:
+ properties['incomingEmailMonitorLevel'] = 'HEADER_ONLY'
+ else:
+ properties['incomingEmailMonitorLevel'] = 'FULL_MESSAGE'
+ if outgoing_headers_only:
+ properties['outgoingEmailMonitorLevel'] = 'HEADER_ONLY'
+ else:
+ properties['outgoingEmailMonitorLevel'] = 'FULL_MESSAGE'
+ if drafts:
+ if drafts_headers_only:
+ properties['draftMonitorLevel'] = 'HEADER_ONLY'
+ else:
+ properties['draftMonitorLevel'] = 'FULL_MESSAGE'
+ if chats:
+ if chats_headers_only:
+ properties['chatMonitorLevel'] = 'HEADER_ONLY'
+ else:
+ properties['chatMonitorLevel'] = 'FULL_MESSAGE'
+ return self._PostProperties(uri, properties)
+
+ def getEmailMonitors(self, user):
+ """"Gets the email monitors for the given user
+
+ Args:
+ user: string, the user to retrieve email monitors for
+
+ Returns:
+ list results of the POST operation
+
+ """
+ uri = self._serviceUrl('mail/monitor', user=user)
+ return self._GetPropertiesList(uri)
+
+ def deleteEmailMonitor(self, source_user, destination_user):
+ """Deletes the email monitor for the given user
+
+ Args:
+ source_user: string, the user who is being monitored
+ destination_user: string, theuser who recieves the monitored emails
+
+ Returns:
+ Nothing
+ """
+
+ uri = self._serviceUrl('mail/monitor', user=source_user+'/'+destination_user)
+ try:
+ return self._DeleteProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def createAccountInformationRequest(self, user):
+ """Creates a request for account auditing details
+
+ Args:
+ user: string, the user to request account information for
+
+ Returns:
+ A dict containing the result of the post operation."""
+
+ uri = self._serviceUrl('account', user=user)
+ properties = {}
+ #XML Body is left empty
+ try:
+ return self._PostProperties(uri, properties)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def getAccountInformationRequestStatus(self, user, request_id):
+ """Gets the status of an account auditing request
+
+ Args:
+ user: string, the user whose account auditing details were requested
+ request_id: string, the request_id
+
+ Returns:
+ A dict containing the result of the get operation."""
+
+ uri = self._serviceUrl('account', user=user+'/'+request_id)
+ try:
+ return self._GetProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def getAllAccountInformationRequestsStatus(self):
+ """Gets the status of all account auditing requests for the domain
+
+ Args:
+ None
+
+ Returns:
+ list results of the POST operation
+ """
+
+ uri = self._serviceUrl('account')
+ return self._GetPropertiesList(uri)
+
+
+ def deleteAccountInformationRequest(self, user, request_id):
+ """Deletes the request for account auditing information
+
+ Args:
+ user: string, the user whose account auditing details were requested
+ request_id: string, the request_id
+
+ Returns:
+ Nothing
+ """
+
+ uri = self._serviceUrl('account', user=user+'/'+request_id)
+ try:
+ return self._DeleteProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def createMailboxExportRequest(self, user, begin_date=None, end_date=None, include_deleted=False, search_query=None, headers_only=False):
+ """Creates a mailbox export request
+
+ Args:
+ user: string, the user whose mailbox export is being requested
+ begin_date: string, date of earliest emails to export, optional, defaults to date of account creation
+ format is 'yyyy-MM-dd HH:mm'
+ end_date: string, date of latest emails to export, optional, defaults to current date
+ format is 'yyyy-MM-dd HH:mm'
+ include_deleted: boolean, whether to include deleted emails in export, mutually exclusive with search_query
+ search_query: string, gmail style search query, matched emails will be exported, mutually exclusive with include_deleted
+
+ Returns:
+ A dict containing the result of the post operation."""
+
+ uri = self._serviceUrl('mail/export', user=user)
+ properties = {}
+ if begin_date is not None:
+ properties['beginDate'] = begin_date
+ if end_date is not None:
+ properties['endDate'] = end_date
+ if include_deleted is not None:
+ properties['includeDeleted'] = gdata.apps.service._bool2str(include_deleted)
+ if search_query is not None:
+ properties['searchQuery'] = search_query
+ if headers_only is True:
+ properties['packageContent'] = 'HEADER_ONLY'
+ else:
+ properties['packageContent'] = 'FULL_MESSAGE'
+ return self._PostProperties(uri, properties)
+
+ def getMailboxExportRequestStatus(self, user, request_id):
+ """Gets the status of an mailbox export request
+
+ Args:
+ user: string, the user whose mailbox were requested
+ request_id: string, the request_id
+
+ Returns:
+ A dict containing the result of the get operation."""
+
+ uri = self._serviceUrl('mail/export', user=user+'/'+request_id)
+ try:
+ return self._GetProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def getAllMailboxExportRequestsStatus(self):
+ """Gets the status of all mailbox export requests for the domain
+
+ Args:
+ None
+
+ Returns:
+ list results of the POST operation
+ """
+
+ uri = self._serviceUrl('mail/export')
+ return self._GetPropertiesList(uri)
+
+
+ def deleteMailboxExportRequest(self, user, request_id):
+ """Deletes the request for mailbox export
+
+ Args:
+ user: string, the user whose mailbox were requested
+ request_id: string, the request_id
+
+ Returns:
+ Nothing
+ """
+
+ uri = self._serviceUrl('mail/export', user=user+'/'+request_id)
+ try:
+ return self._DeleteProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
diff --git a/samples/apps/marketplace_sample/gdata/apps/client.py b/samples/apps/marketplace_sample/gdata/apps/client.py
new file mode 100755
index 0000000..7845988
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/client.py
@@ -0,0 +1,203 @@
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""AppsClient adds Client Architecture to Provisioning API."""
+
+
+__author__ = '<Shraddha Gupta shraddhag@google.com>'
+
+
+import gdata.apps.data
+import gdata.client
+import gdata.service
+
+
+class AppsClient(gdata.client.GDClient):
+ """Client extension for the Google Provisioning API service.
+
+ Attributes:
+ host: string The hostname for the Provisioning API service.
+ api_version: string The version of the Provisioning API.
+ """
+
+ host = 'apps-apis.google.com'
+ api_version = '2.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the Provisioning API.
+
+ Args:
+ domain: string Google Apps domain name.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes client to make calls to Provisioning API.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def _baseURL(self):
+ return '/a/feeds/%s' % self.domain
+
+ def _userURL(self):
+ return '%s/user/%s' % (self._baseURL(), self.api_version)
+
+ def _nicknameURL(self):
+ return '%s/nickname/%s' % (self._baseURL(), self.api_version)
+
+ def RetrieveAllPages(self, feed, desired_class=gdata.data.GDFeed):
+ """Retrieve all pages and add all elements.
+
+ Args:
+ feed: gdata.data.GDFeed object with linked elements.
+ desired_class: type of feed to be returned.
+
+ Returns:
+ desired_class: subclass of gdata.data.GDFeed.
+ """
+
+ next = feed.GetNextLink()
+ while next is not None:
+ next_feed = self.GetFeed(next.href, desired_class=desired_class)
+ for a_entry in next_feed.entry:
+ feed.entry.append(a_entry)
+ next = next_feed.GetNextLink()
+ return feed
+
+ def CreateUser(self, user_name, family_name, given_name, password,
+ suspended=False, admin=None, quota_limit=None,
+ password_hash_function=None,
+ agreed_to_terms=None, change_password=None):
+ """Create a user account."""
+
+ uri = self._userURL()
+ user_entry = gdata.apps.data.UserEntry()
+ user_entry.login = gdata.apps.data.Login(user_name=user_name,
+ password=password, suspended=suspended, admin=admin,
+ hash_function_name=password_hash_function,
+ agreed_to_terms=agreed_to_terms,
+ change_password=change_password)
+ user_entry.name = gdata.apps.data.Name(family_name=family_name,
+ given_name=given_name)
+ return self.Post(user_entry, uri)
+
+ def RetrieveUser(self, user_name):
+ """Retrieve a user account.
+
+ Args:
+ user_name: string user_name to be retrieved.
+
+ Returns:
+ gdata.apps.data.UserEntry
+ """
+
+ uri = '%s/%s' % (self._userURL(), user_name)
+ return self.GetEntry(uri, desired_class=gdata.apps.data.UserEntry)
+
+ def RetrievePageOfUsers(self, start_username=None):
+ """Retrieve one page of users in this domain.
+
+ Args:
+ start_username: string user to start from for retrieving a page of users.
+
+ Returns:
+ gdata.apps.data.UserFeed
+ """
+
+ uri = self._userURL()
+ if start_username is not None:
+ uri += '?startUsername=%s' % start_username
+ return self.GetFeed(uri, desired_class=gdata.apps.data.UserFeed)
+
+ def RetrieveAllUsers(self):
+ """Retrieve all users in this domain.
+
+ Returns:
+ gdata.apps.data.UserFeed
+ """
+
+ ret = self.RetrievePageOfUsers()
+ # pagination
+ return self.RetrieveAllPages(ret, gdata.apps.data.UserFeed)
+
+ def UpdateUser(self, user_name, user_entry):
+ """Update a user account.
+
+ Args:
+ user_name: string user_name to be updated.
+ user_entry: gdata.apps.data.UserEntry updated user entry.
+
+ Returns:
+ gdata.apps.data.UserEntry
+ """
+
+ uri = '%s/%s' % (self._userURL(), user_name)
+ return self.Update(entry=user_entry, uri=uri)
+
+ def DeleteUser(self, user_name):
+ """Delete a user account."""
+
+ uri = '%s/%s' % (self._userURL(), user_name)
+ self.Delete(uri)
+
+ def CreateNickname(self, user_name, nickname):
+ """Create a nickname for a user.
+
+ Args:
+ user_name: string user whose nickname is being created.
+ nickname: string nickname.
+
+ Returns:
+ gdata.apps.data.NicknameEntry
+ """
+
+ uri = self._nicknameURL()
+ nickname_entry = gdata.apps.data.NicknameEntry()
+ nickname_entry.login = gdata.apps.data.Login(user_name=user_name)
+ nickname_entry.nickname = gdata.apps.data.Nickname(name=nickname)
+ return self.Post(nickname_entry, uri)
+
+ def RetrieveNickname(self, nickname):
+ """Retrieve a nickname.
+
+ Args:
+ nickname: string nickname to be retrieved.
+
+ Returns:
+ gdata.apps.data.NicknameEntry
+ """
+
+ uri = '%s/%s' % (self._nicknameURL(), nickname)
+ return self.GetEntry(uri, desired_class=gdata.apps.data.NicknameEntry)
+
+ def RetrieveNicknames(self, user_name):
+ """Retrieve nicknames of the user.
+
+ Args:
+ user_name: string user whose nicknames are retrieved.
+
+ Returns:
+ gdata.apps.data.NicknameFeed
+ """
+
+ uri = '%s?username=%s' % (self._nicknameURL(), user_name)
+ ret = self.GetFeed(uri, desired_class=gdata.apps.data.NicknameFeed)
+ # pagination
+ return self.RetrieveAllPages(ret, gdata.apps.data.NicknameFeed)
+
+ def DeleteNickname(self, nickname):
+ """Delete a nickname."""
+
+ uri = '%s/%s' % (self._nicknameURL(), nickname)
+ self.Delete(uri)
diff --git a/samples/apps/marketplace_sample/gdata/apps/data.py b/samples/apps/marketplace_sample/gdata/apps/data.py
new file mode 100644
index 0000000..5ba57a6
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/data.py
@@ -0,0 +1,83 @@
+#!/usr/bin/python
+#
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for the Provisioning API."""
+
+
+__author__ = 'Shraddha Gupta shraddhag@google.com>'
+
+
+import atom.core
+import atom.data
+import gdata.apps
+import gdata.data
+
+
+class Login(atom.core.XmlElement):
+
+ _qname = gdata.apps.APPS_TEMPLATE % 'login'
+ user_name = 'userName'
+ password = 'password'
+ hash_function_name = 'hashFunctionName'
+ suspended = 'suspended'
+ admin = 'admin'
+ agreed_to_terms = 'agreedToTerms'
+ change_password = 'changePasswordAtNextLogin'
+ ip_whitelisted = 'ipWhitelisted'
+
+
+class Name(atom.core.XmlElement):
+
+ _qname = gdata.apps.APPS_TEMPLATE % 'name'
+ given_name = 'givenName'
+ family_name = 'familyName'
+
+
+class Quota(atom.core.XmlElement):
+
+ _qname = gdata.apps.APPS_TEMPLATE % 'quota'
+ limit = 'limit'
+
+
+class UserEntry(gdata.data.GDEntry):
+
+ _qname = atom.data.ATOM_TEMPLATE % 'entry'
+ login = Login
+ name = Name
+ quota = Quota
+
+
+class UserFeed(gdata.data.GDFeed):
+
+ entry = [UserEntry]
+
+
+class Nickname(atom.core.XmlElement):
+
+ _qname = gdata.apps.APPS_TEMPLATE % 'nickname'
+ name = 'name'
+
+
+class NicknameEntry(gdata.data.GDEntry):
+
+ _qname = atom.data.ATOM_TEMPLATE % 'entry'
+ nickname = Nickname
+ login = Login
+
+
+class NicknameFeed(gdata.data.GDFeed):
+
+ entry = [NicknameEntry]
diff --git a/samples/apps/marketplace_sample/gdata/apps/emailsettings/__init__.py b/samples/apps/marketplace_sample/gdata/apps/emailsettings/__init__.py
new file mode 100644
index 0000000..275c6a0
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/emailsettings/__init__.py
@@ -0,0 +1,15 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/samples/apps/marketplace_sample/gdata/apps/emailsettings/client.py b/samples/apps/marketplace_sample/gdata/apps/emailsettings/client.py
new file mode 100644
index 0000000..32fed92
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/emailsettings/client.py
@@ -0,0 +1,584 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""EmailSettingsClient simplifies Email Settings API calls.
+
+EmailSettingsClient extends gdata.client.GDClient to ease interaction with
+the Google Apps Email Settings API. These interactions include the ability
+to create labels, filters, aliases, and update web-clip, forwarding, POP,
+IMAP, vacation-responder, signature, language, and general settings, and
+retrieve labels, send-as, forwarding, pop, imap, vacation and signature
+settings.
+"""
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import urllib
+
+import gdata.apps.emailsettings.data
+import gdata.client
+
+
+# Email Settings URI template
+# The strings in this template are eventually replaced with the API version,
+# Google Apps domain name, username, and settingID, respectively.
+EMAIL_SETTINGS_URI_TEMPLATE = '/a/feeds/emailsettings/%s/%s/%s/%s'
+
+
+# The settingID value for the label requests
+SETTING_ID_LABEL = 'label'
+# The settingID value for the filter requests
+SETTING_ID_FILTER = 'filter'
+# The settingID value for the send-as requests
+SETTING_ID_SENDAS = 'sendas'
+# The settingID value for the webclip requests
+SETTING_ID_WEBCLIP = 'webclip'
+# The settingID value for the forwarding requests
+SETTING_ID_FORWARDING = 'forwarding'
+# The settingID value for the POP requests
+SETTING_ID_POP = 'pop'
+# The settingID value for the IMAP requests
+SETTING_ID_IMAP = 'imap'
+# The settingID value for the vacation responder requests
+SETTING_ID_VACATION_RESPONDER = 'vacation'
+# The settingID value for the signature requests
+SETTING_ID_SIGNATURE = 'signature'
+# The settingID value for the language requests
+SETTING_ID_LANGUAGE = 'language'
+# The settingID value for the general requests
+SETTING_ID_GENERAL = 'general'
+# The settingID value for the delegation requests
+SETTING_ID_DELEGATION = 'delegation'
+
+# The KEEP action for the email settings
+ACTION_KEEP = 'KEEP'
+# The ARCHIVE action for the email settings
+ACTION_ARCHIVE = 'ARCHIVE'
+# The DELETE action for the email settings
+ACTION_DELETE = 'DELETE'
+
+# The ALL_MAIL setting for POP enable_for property
+POP_ENABLE_FOR_ALL_MAIL = 'ALL_MAIL'
+# The MAIL_FROM_NOW_ON setting for POP enable_for property
+POP_ENABLE_FOR_MAIL_FROM_NOW_ON = 'MAIL_FROM_NOW_ON'
+
+
+class EmailSettingsClient(gdata.client.GDClient):
+ """Client extension for the Google Email Settings API service.
+
+ Attributes:
+ host: string The hostname for the Email Settings API service.
+ api_version: string The version of the Email Settings API.
+ """
+
+ host = 'apps-apis.google.com'
+ api_version = '2.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+ ssl = True
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the Email Settings API.
+
+ Args:
+ domain: string The Google Apps domain with Email Settings.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the email settings.
+ kwargs: The other parameters to pass to the gdata.client.GDClient
+ constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def make_email_settings_uri(self, username, setting_id):
+ """Creates the URI for the Email Settings API call.
+
+ Using this client's Google Apps domain, create the URI to setup
+ email settings for the given user in that domain. If params are provided,
+ append them as GET params.
+
+ Args:
+ username: string The name of the user affected by this setting.
+ setting_id: string The key of the setting to be configured.
+
+ Returns:
+ A string giving the URI for Email Settings API calls for this client's
+ Google Apps domain.
+ """
+ if '@' in username:
+ username, domain = username.split('@', 1)
+ else:
+ domain = self.domain
+ uri = EMAIL_SETTINGS_URI_TEMPLATE % (self.api_version, domain,
+ username, setting_id)
+ return uri
+
+ MakeEmailSettingsUri = make_email_settings_uri
+
+ def create_label(self, username, name, **kwargs):
+ """Creates a label with the given properties.
+
+ Args:
+ username: string The name of the user.
+ name: string The name of the label.
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsLabel of the new resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_LABEL)
+ new_label = gdata.apps.emailsettings.data.EmailSettingsLabel(
+ uri=uri, name=name)
+ return self.post(new_label, uri, **kwargs)
+
+ CreateLabel = create_label
+
+ def retrieve_labels(self, username, **kwargs):
+ """Retrieves email labels for the specified username
+
+ Args:
+ username: string The name of the user to get the labels for
+
+ Returns:
+ A gdata.data.GDFeed of the user's email labels
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_LABEL)
+ return self.GetFeed(uri, auth_token=None, query=None, **kwargs)
+
+ RetrieveLabels = retrieve_labels
+
+ def delete_label(self, username, label, **kwargs):
+ """Delete a label from the specified account.
+
+ Args:
+ username: string Name of the user
+ label: string Name of the label to be deleted
+
+ Returns:
+ An atom.http_core.HttpResponse() with the result of the request
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_LABEL)
+ uri = '/'.join([uri, urllib.quote_plus(label)])
+ return self.delete(uri, **kwargs)
+
+ DeleteLabel = delete_label
+
+ def create_filter(self, username, from_address=None,
+ to_address=None, subject=None, has_the_word=None,
+ does_not_have_the_word=None, has_attachments=None,
+ label=None, mark_as_read=None, archive=None, **kwargs):
+ """Creates a filter with the given properties.
+
+ Args:
+ username: string The name of the user.
+ from_address: string The source email address for the filter.
+ to_address: string (optional) The destination email address for
+ the filter.
+ subject: string (optional) The value the email must have in its
+ subject to be filtered.
+ has_the_word: string (optional) The value the email must have
+ in its subject or body to be filtered.
+ does_not_have_the_word: string (optional) The value the email
+ cannot have in its subject or body to be filtered.
+ has_attachments: string (optional) A boolean string representing
+ whether the email must have an attachment to be filtered.
+ label: string (optional) The name of the label to apply to
+ messages matching the filter criteria.
+ mark_as_read: Boolean (optional) Whether or not to mark
+ messages matching the filter criteria as read.
+ archive: Boolean (optional) Whether or not to move messages
+ matching to Archived state.
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsFilter of the new resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_FILTER)
+ new_filter = gdata.apps.emailsettings.data.EmailSettingsFilter(
+ uri=uri, from_address=from_address,
+ to_address=to_address, subject=subject,
+ has_the_word=has_the_word,
+ does_not_have_the_word=does_not_have_the_word,
+ has_attachments=has_attachments, label=label,
+ mark_as_read=mark_as_read, archive=archive)
+ return self.post(new_filter, uri, **kwargs)
+
+ CreateFilter = create_filter
+
+ def create_send_as(self, username, name, address, reply_to=None,
+ make_default=None, **kwargs):
+ """Creates a send-as alias with the given properties.
+
+ Args:
+ username: string The name of the user.
+ name: string The name that will appear in the "From" field.
+ address: string The email address that appears as the
+ origination address for emails sent by this user.
+ reply_to: string (optional) The address to be used as the reply-to
+ address in email sent using the alias.
+ make_default: Boolean (optional) Whether or not this alias should
+ become the default alias for this user.
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsSendAsAlias of the
+ new resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_SENDAS)
+ new_alias = gdata.apps.emailsettings.data.EmailSettingsSendAsAlias(
+ uri=uri, name=name, address=address,
+ reply_to=reply_to, make_default=make_default)
+ return self.post(new_alias, uri, **kwargs)
+
+ CreateSendAs = create_send_as
+
+ def retrieve_send_as(self, username, **kwargs):
+ """Retrieves send-as aliases for the specified username
+
+ Args:
+ username: string The name of the user to get the send-as for
+
+ Returns:
+ A gdata.data.GDFeed of the user's send-as alias settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_SENDAS)
+ return self.GetFeed(uri, auth_token=None, query=None, **kwargs)
+
+ RetrieveSendAs = retrieve_send_as
+
+ def update_webclip(self, username, enable, **kwargs):
+ """Enable/Disable Google Mail web clip.
+
+ Args:
+ username: string The name of the user.
+ enable: Boolean Whether to enable showing Web clips.
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsWebClip of the
+ updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_WEBCLIP)
+ new_webclip = gdata.apps.emailsettings.data.EmailSettingsWebClip(
+ uri=uri, enable=enable)
+ return self.update(new_webclip, **kwargs)
+
+ UpdateWebclip = update_webclip
+
+ def update_forwarding(self, username, enable, forward_to=None,
+ action=None, **kwargs):
+ """Update Google Mail Forwarding settings.
+
+ Args:
+ username: string The name of the user.
+ enable: Boolean Whether to enable incoming email forwarding.
+ forward_to: (optional) string The address email will be forwarded to.
+ action: string (optional) The action to perform after forwarding
+ an email (ACTION_KEEP, ACTION_ARCHIVE, ACTION_DELETE).
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsForwarding of the
+ updated resource
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_FORWARDING)
+ new_forwarding = gdata.apps.emailsettings.data.EmailSettingsForwarding(
+ uri=uri, enable=enable, forward_to=forward_to, action=action)
+ return self.update(new_forwarding, **kwargs)
+
+ UpdateForwarding = update_forwarding
+
+ def retrieve_forwarding(self, username, **kwargs):
+ """Retrieves forwarding settings for the specified username
+
+ Args:
+ username: string The name of the user to get the forwarding settings for
+
+ Returns:
+ A gdata.data.GDEntry of the user's email forwarding settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_FORWARDING)
+ return self.GetEntry(uri, auth_token=None, query=None, **kwargs)
+
+ RetrieveForwarding = retrieve_forwarding
+
+ def update_pop(self, username, enable, enable_for=None, action=None,
+ **kwargs):
+ """Update Google Mail POP settings.
+
+ Args:
+ username: string The name of the user.
+ enable: Boolean Whether to enable incoming POP3 access.
+ enable_for: string (optional) Whether to enable POP3 for all mail
+ (POP_ENABLE_FOR_ALL_MAIL), or mail from now on
+ (POP_ENABLE_FOR_MAIL_FROM_NOW_ON).
+ action: string (optional) What Google Mail should do with its copy
+ of the email after it is retrieved using POP (ACTION_KEEP,
+ ACTION_ARCHIVE, ACTION_DELETE).
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsPop of the updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_POP)
+ new_pop = gdata.apps.emailsettings.data.EmailSettingsPop(
+ uri=uri, enable=enable,
+ enable_for=enable_for, action=action)
+ return self.update(new_pop, **kwargs)
+
+ UpdatePop = update_pop
+
+ def retrieve_pop(self, username, **kwargs):
+ """Retrieves POP settings for the specified username
+
+ Args:
+ username: string The name of the user to get the POP settings for
+
+ Returns:
+ A gdata.data.GDEntry of the user's POP settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_POP)
+ return self.GetEntry(uri, auth_token=None, query=None, **kwargs)
+
+ RetrievePop = retrieve_pop
+
+ def update_imap(self, username, enable, **kwargs):
+ """Update Google Mail IMAP settings.
+
+ Args:
+ username: string The name of the user.
+ enable: Boolean Whether to enable IMAP access.language
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsImap of the updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_IMAP)
+ new_imap = gdata.apps.emailsettings.data.EmailSettingsImap(
+ uri=uri, enable=enable)
+ return self.update(new_imap, **kwargs)
+
+ UpdateImap = update_imap
+
+ def retrieve_imap(self, username, **kwargs):
+ """Retrieves imap settings for the specified username
+
+ Args:
+ username: string The name of the user to get the imap settings for
+
+ Returns:
+ A gdata.data.GDEntry of the user's IMAP settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_IMAP)
+ return self.GetEntry(uri, auth_token=None, query=None, **kwargs)
+
+ RetrieveImap = retrieve_imap
+
+ def update_vacation(self, username, enable, subject=None, message=None,
+ start_date=None, end_date=None, contacts_only=None,
+ domain_only=None, **kwargs):
+ """Update Google Mail vacation-responder settings.
+
+ Args:
+ username: string The name of the user.
+ enable: Boolean Whether to enable the vacation responder.
+ subject: string (optional) The subject line of the vacation responder
+ autoresponse.
+ message: string (optional) The message body of the vacation responder
+ autoresponse.
+ startDate: string (optional) The start date of the vacation responder
+ autoresponse.
+ endDate: string (optional) The end date of the vacation responder
+ autoresponse.
+ contacts_only: Boolean (optional) Whether to only send autoresponses
+ to known contacts.
+ domain_only: Boolean (optional) Whether to only send autoresponses
+ to users in the primary domain.
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsVacationResponder of the
+ updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_VACATION_RESPONDER)
+ new_vacation = gdata.apps.emailsettings.data.EmailSettingsVacationResponder(
+ uri=uri, enable=enable, subject=subject,
+ message=message, start_date=start_date, end_date=end_date,
+ contacts_only=contacts_only, domain_only=domain_only)
+ return self.update(new_vacation, **kwargs)
+
+ UpdateVacation = update_vacation
+
+ def retrieve_vacation(self, username, **kwargs):
+ """Retrieves vacation settings for the specified username
+
+ Args:
+ username: string The name of the user to get the vacation settings for
+
+ Returns:
+ A gdata.data.GDEntry of the user's vacation auto-responder settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_VACATION_RESPONDER)
+ return self.GetEntry(uri, auth_token=None, query=None, **kwargs)
+
+ RetrieveVacation = retrieve_vacation
+
+ def update_signature(self, username, signature, **kwargs):
+ """Update Google Mail signature.
+
+ Args:
+ username: string The name of the user.
+ signature: string The signature to be appended to outgoing messages.
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsSignature of the
+ updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_SIGNATURE)
+ new_signature = gdata.apps.emailsettings.data.EmailSettingsSignature(
+ uri=uri, signature=signature)
+ return self.update(new_signature, **kwargs)
+
+ UpdateSignature = update_signature
+
+ def retrieve_signature(self, username, **kwargs):
+ """Retrieves signature settings for the specified username
+
+ Args:
+ username: string The name of the user to get the signature settings for
+
+ Returns:
+ A gdata.data.GDEntry of the user's signature settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_SIGNATURE)
+ return self.GetEntry(uri, auth_token=None, query=None, **kwargs)
+
+ RetrieveSignature = retrieve_signature
+
+ def update_language(self, username, language, **kwargs):
+ """Update Google Mail language settings.
+
+ Args:
+ username: string The name of the user.
+ language: string The language tag for Google Mail's display language.
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsLanguage of the
+ updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_LANGUAGE)
+ new_language = gdata.apps.emailsettings.data.EmailSettingsLanguage(
+ uri=uri, language=language)
+ return self.update(new_language, **kwargs)
+
+ UpdateLanguage = update_language
+
+ def update_general_settings(self, username, page_size=None, shortcuts=None,
+ arrows=None, snippets=None, use_unicode=None,
+ **kwargs):
+ """Update Google Mail general settings.
+
+ Args:
+ username: string The name of the user.
+ page_size: int (optional) The number of conversations to be shown per
+ page.
+ shortcuts: Boolean (optional) Whether to enable keyboard shortcuts.
+ arrows: Boolean (optional) Whether to display arrow-shaped personal
+ indicators next to email sent specifically to the user.
+ snippets: Boolean (optional) Whether to display snippets of the messages
+ in the inbox and when searching.
+ use_unicode: Boolean (optional) Whether to use UTF-8 (unicode) encoding
+ for all outgoing messages.
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsGeneral of the
+ updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_GENERAL)
+ new_general = gdata.apps.emailsettings.data.EmailSettingsGeneral(
+ uri=uri, page_size=page_size, shortcuts=shortcuts,
+ arrows=arrows, snippets=snippets, use_unicode=use_unicode)
+ return self.update(new_general, **kwargs)
+
+ UpdateGeneralSettings = update_general_settings
+
+ def add_email_delegate(self, username, address, **kwargs):
+ """Add an email delegate to the mail account
+
+ Args:
+ username: string The name of the user
+ address: string The email address of the delegated account
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_DELEGATION)
+ new_delegation = gdata.apps.emailsettings.data.EmailSettingsDelegation(
+ uri=uri, address=address)
+ return self.post(new_delegation, uri, **kwargs)
+
+ AddEmailDelegate = add_email_delegate
+
+ def retrieve_email_delegates(self, username, **kwargs):
+ """Retrieve a feed of the email delegates for the specified username
+
+ Args:
+ username: string The name of the user to get the email delegates for
+
+ Returns:
+ A gdata.data.GDFeed of the user's email delegates
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_DELEGATION)
+ return self.GetFeed(uri, auth_token=None, query=None, **kwargs)
+
+ RetrieveEmailDelegates = retrieve_email_delegates
+
+ def delete_email_delegate(self, username, address, **kwargs):
+ """Delete an email delegate from the specified account
+
+ Args:
+ username: string The name of the user
+ address: string The email address of the delegated account
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_DELEGATION)
+ uri = uri + '/' + address
+ return self.delete(uri, **kwargs)
+
+ DeleteEmailDelegate = delete_email_delegate
diff --git a/samples/apps/marketplace_sample/gdata/apps/emailsettings/data.py b/samples/apps/marketplace_sample/gdata/apps/emailsettings/data.py
new file mode 100644
index 0000000..be573be
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/emailsettings/data.py
@@ -0,0 +1,1257 @@
+#!/usr/bin/python
+#
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for the Email Settings API."""
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import atom.data
+import gdata.apps
+import gdata.apps_property
+import gdata.data
+
+
+# This is required to work around a naming conflict between the Google
+# Spreadsheets API and Python's built-in property function
+pyproperty = property
+
+
+# The apps:property label of the label property
+LABEL_NAME = 'label'
+
+# The apps:property from of the filter property
+FILTER_FROM_NAME = 'from'
+# The apps:property to of the filter property
+FILTER_TO_NAME = 'to'
+# The apps:property subject of the filter property
+FILTER_SUBJECT_NAME = 'subject'
+# The apps:property hasTheWord of the filter property
+FILTER_HAS_THE_WORD_NAME = 'hasTheWord'
+# The apps:property doesNotHaveTheWord of the filter property
+FILTER_DOES_NOT_HAVE_THE_WORD_NAME = 'doesNotHaveTheWord'
+# The apps:property hasAttachment of the filter property
+FILTER_HAS_ATTACHMENTS_NAME = 'hasAttachment'
+# The apps:property label of the filter action property
+FILTER_LABEL = 'label'
+# The apps:property shouldMarkAsRead of the filter action property
+FILTER_MARK_AS_READ = 'shouldMarkAsRead'
+# The apps:property shouldArchive of the filter action propertylabel
+FILTER_ARCHIVE = 'shouldArchive'
+
+# The apps:property name of the send-as alias property
+SENDAS_ALIAS_NAME = 'name'
+# The apps:property address of theAPPS_TEMPLATE send-as alias property
+SENDAS_ALIAS_ADDRESS = 'address'
+# The apps:property replyTo of the send-as alias property
+SENDAS_ALIAS_REPLY_TO = 'replyTo'
+# The apps:property makeDefault of the send-as alias property
+SENDAS_ALIAS_MAKE_DEFAULT = 'makeDefault'
+
+# The apps:property enable of the webclip property
+WEBCLIP_ENABLE = 'enable'
+
+# The apps:property enable of the forwarding property
+FORWARDING_ENABLE = 'enable'
+# The apps:property forwardTo of the forwarding property
+FORWARDING_TO = 'forwardTo'
+# The apps:property action of the forwarding property
+FORWARDING_ACTION = 'action'
+
+# The apps:property enable of the POP property
+POP_ENABLE = 'enable'
+# The apps:property enableFor of the POP propertyACTION
+POP_ENABLE_FOR = 'enableFor'
+# The apps:property action of the POP property
+POP_ACTION = 'action'
+
+# The apps:property enable of the IMAP property
+IMAP_ENABLE = 'enable'
+
+# The apps:property enable of the vacation responder property
+VACATION_RESPONDER_ENABLE = 'enable'
+# The apps:property subject of the vacation responder property
+VACATION_RESPONDER_SUBJECT = 'subject'
+# The apps:property message of the vacation responder property
+VACATION_RESPONDER_MESSAGE = 'message'
+# The apps:property startDate of the vacation responder property
+VACATION_RESPONDER_STARTDATE = 'startDate'
+# The apps:property endDate of the vacation responder property
+VACATION_RESPONDER_ENDDATE = 'endDate'
+# The apps:property contactsOnly of the vacation responder property
+VACATION_RESPONDER_CONTACTS_ONLY = 'contactsOnly'
+# The apps:property domainOnly of the vacation responder property
+VACATION_RESPONDER_DOMAIN_ONLY = 'domainOnly'
+
+# The apps:property signature of the signature property
+SIGNATURE_VALUE = 'signature'
+
+# The apps:property language of the language property
+LANGUAGE_TAG = 'language'
+
+# The apps:property pageSize of the general settings property
+GENERAL_PAGE_SIZE = 'pageSize'
+# The apps:property shortcuts of the general settings property
+GENERAL_SHORTCUTS = 'shortcuts'
+# The apps:property arrows of the general settings property
+GENERAL_ARROWS = 'arrows'
+# The apps:prgdata.appsoperty snippets of the general settings property
+GENERAL_SNIPPETS = 'snippets'
+# The apps:property uniAppsProcode of the general settings property
+GENERAL_UNICODE = 'unicode'
+
+# The apps:property delegationId of the email delegation property
+DELEGATION_ID = 'delegationId'
+# The apps:property address of the email delegation property
+DELEGATION_ADDRESS = 'address'
+# The apps:property delegate of the email delegation property
+DELEGATION_DELEGATE = 'delegate'
+# The apps:property status of the email delegation property
+DELEGATION_STATUS = 'status'
+
+
+class EmailSettingsEntry(gdata.data.GDEntry):
+ """Represents an Email Settings entry in object form."""
+
+ property = [gdata.apps_property.AppsProperty]
+
+ def _GetProperty(self, name):
+ """Get the apps:property value with the given name.
+
+ Args:
+ name: string Name of the apps:property value to get.
+
+ Returns:
+ The apps:property value with the given name, or None if the name was
+ invalid.
+ """
+
+ value = None
+ for p in self.property:
+ if p.name == name:
+ value = p.value
+ break
+ return value
+
+ def _SetProperty(self, name, value):
+ """Set the apps:property value with the given name to the given value.
+
+ Args:
+ name: string Name of the apps:property value to set.
+ value: string Value to give the apps:property value with the given name.
+ """
+ found = False
+ for i in range(len(self.property)):
+ if self.property[i].name == name:
+ self.property[i].value = value
+ found = True
+ break
+ if not found:
+ self.property.append(gdata.apps_property.AppsProperty(name=name, value=value))
+
+ def find_edit_link(self):
+ return self.uri
+
+
+class EmailSettingsLabel(EmailSettingsEntry):
+ """Represents a Label in object form."""
+
+ def GetName(self):
+ """Get the name of the Label object.
+
+ Returns:
+ The name of this Label object as a string or None.
+ """
+
+ return self._GetProperty(LABEL_NAME)
+
+ def SetName(self, value):
+ """Set the name of this Label object.
+
+ Args:
+ value: string The new label name to give this object.
+ """
+
+ self._SetProperty(LABEL_NAME, value)
+
+ name = pyproperty(GetName, SetName)
+
+ def __init__(self, uri=None, name=None, *args, **kwargs):
+ """Constructs a new EmailSettingsLabel object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ name: string (optional) The name to give this new object.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsLabel, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if name:
+ self.name = name
+
+
+class EmailSettingsFilter(EmailSettingsEntry):
+ """Represents an Email Settings Filter in object form."""
+
+ def GetFrom(self):
+ """Get the From value of the Filter object.
+
+ Returns:
+ The From value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_FROM_NAME)
+
+ def SetFrom(self, value):
+ """Set the From value of this Filter object.
+
+ Args:
+ value: string The new From value to give this object.
+ """
+
+ self._SetProperty(FILTER_FROM_NAME, value)
+
+ from_address = pyproperty(GetFrom, SetFrom)
+
+ def GetTo(self):
+ """Get the To value of the Filter object.
+
+ Returns:
+ The To value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_TO_NAME)
+
+ def SetTo(self, value):
+ """Set the To value of this Filter object.
+
+ Args:
+ value: string The new To value to give this object.
+ """
+
+ self._SetProperty(FILTER_TO_NAME, value)
+
+ to_address = pyproperty(GetTo, SetTo)
+
+ def GetSubject(self):
+ """Get the Subject value of the Filter object.
+
+ Returns:
+ The Subject value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_SUBJECT_NAME)
+
+ def SetSubject(self, value):
+ """Set the Subject value of this Filter object.
+
+ Args:
+ value: string The new Subject value to give this object.
+ """
+
+ self._SetProperty(FILTER_SUBJECT_NAME, value)
+
+ subject = pyproperty(GetSubject, SetSubject)
+
+ def GetHasTheWord(self):
+ """Get the HasTheWord value of the Filter object.
+
+ Returns:
+ The HasTheWord value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_HAS_THE_WORD_NAME)
+
+ def SetHasTheWord(self, value):
+ """Set the HasTheWord value of this Filter object.
+
+ Args:
+ value: string The new HasTheWord value to give this object.
+ """
+
+ self._SetProperty(FILTER_HAS_THE_WORD_NAME, value)
+
+ has_the_word = pyproperty(GetHasTheWord, SetHasTheWord)
+
+ def GetDoesNotHaveTheWord(self):
+ """Get the DoesNotHaveTheWord value of the Filter object.
+
+ Returns:
+ The DoesNotHaveTheWord value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_DOES_NOT_HAVE_THE_WORD_NAME)
+
+ def SetDoesNotHaveTheWord(self, value):
+ """Set the DoesNotHaveTheWord value of this Filter object.
+
+ Args:
+ value: string The new DoesNotHaveTheWord value to give this object.
+ """
+
+ self._SetProperty(FILTER_DOES_NOT_HAVE_THE_WORD_NAME, value)
+
+ does_not_have_the_word = pyproperty(GetDoesNotHaveTheWord,
+ SetDoesNotHaveTheWord)
+
+ def GetHasAttachments(self):
+ """Get the HasAttachments value of the Filter object.
+
+ Returns:
+ The HasAttachments value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_HAS_ATTACHMENTS_NAME)
+
+ def SetHasAttachments(self, value):
+ """Set the HasAttachments value of this Filter object.
+
+ Args:
+ value: string The new HasAttachments value to give this object.
+ """
+
+ self._SetProperty(FILTER_HAS_ATTACHMENTS_NAME, value)
+
+ has_attachments = pyproperty(GetHasAttachments,
+ SetHasAttachments)
+
+ def GetLabel(self):
+ """Get the Label value of the Filter object.
+
+ Returns:
+ The Label value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_LABEL)
+
+ def SetLabel(self, value):
+ """Set the Label value of this Filter object.
+
+ Args:
+ value: string The new Label value to give this object.
+ """
+
+ self._SetProperty(FILTER_LABEL, value)
+
+ label = pyproperty(GetLabel, SetLabel)
+
+ def GetMarkAsRead(self):
+ """Get the MarkAsRead value of the Filter object.
+
+ Returns:
+ The MarkAsRead value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_MARK_AS_READ)
+
+ def SetMarkAsRead(self, value):
+ """Set the MarkAsRead value of this Filter object.
+
+ Args:
+ value: string The new MarkAsRead value to give this object.
+ """
+
+ self._SetProperty(FILTER_MARK_AS_READ, value)
+
+ mark_as_read = pyproperty(GetMarkAsRead, SetMarkAsRead)
+
+ def GetArchive(self):
+ """Get the Archive value of the Filter object.
+
+ Returns:
+ The Archive value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_ARCHIVE)
+
+ def SetArchive(self, value):
+ """Set the Archive value of this Filter object.
+
+ Args:
+ value: string The new Archive value to give this object.
+ """
+
+ self._SetProperty(FILTER_ARCHIVE, value)
+
+ archive = pyproperty(GetArchive, SetArchive)
+
+ def __init__(self, uri=None, from_address=None, to_address=None,
+ subject=None, has_the_word=None, does_not_have_the_word=None,
+ has_attachments=None, label=None, mark_as_read=None,
+ archive=None, *args, **kwargs):
+ """Constructs a new EmailSettingsFilter object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ from_address: string (optional) The source email address for the filter.
+ to_address: string (optional) The destination email address for
+ the filter.
+ subject: string (optional) The value the email must have in its
+ subject to be filtered.
+ has_the_word: string (optional) The value the email must have in its
+ subject or body to be filtered.
+ does_not_have_the_word: string (optional) The value the email cannot
+ have in its subject or body to be filtered.
+ has_attachments: Boolean (optional) Whether or not the email must
+ have an attachment to be filtered.
+ label: string (optional) The name of the label to apply to
+ messages matching the filter criteria.
+ mark_as_read: Boolean (optional) Whether or not to mark messages
+ matching the filter criteria as read.
+ archive: Boolean (optional) Whether or not to move messages
+ matching to Archived state.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsFilter, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if from_address:
+ self.from_address = from_address
+ if to_address:
+ self.to_address = to_address
+ if subject:
+ self.subject = subject
+ if has_the_word:
+ self.has_the_word = has_the_word
+ if does_not_have_the_word:
+ self.does_not_have_the_word = does_not_have_the_word
+ if has_attachments is not None:
+ self.has_attachments = str(has_attachments)
+ if label:
+ self.label = label
+ if mark_as_read is not None:
+ self.mark_as_read = str(mark_as_read)
+ if archive is not None:
+ self.archive = str(archive)
+
+
+class EmailSettingsSendAsAlias(EmailSettingsEntry):
+ """Represents an Email Settings send-as Alias in object form."""
+
+ def GetName(self):
+ """Get the Name of the send-as Alias object.
+
+ Returns:
+ The Name of this send-as Alias object as a string or None.
+ """
+
+ return self._GetProperty(SENDAS_ALIAS_NAME)
+
+ def SetName(self, value):
+ """Set the Name of this send-as Alias object.
+
+ Args:
+ value: string The new Name to give this object.
+ """
+
+ self._SetProperty(SENDAS_ALIAS_NAME, value)
+
+ name = pyproperty(GetName, SetName)
+
+ def GetAddress(self):
+ """Get the Address of the send-as Alias object.
+
+ Returns:
+ The Address of this send-as Alias object as a string or None.
+ """
+
+ return self._GetProperty(SENDAS_ALIAS_ADDRESS)
+
+ def SetAddress(self, value):
+ """Set the Address of this send-as Alias object.
+
+ Args:
+ value: string The new Address to give this object.
+ """
+
+ self._SetProperty(SENDAS_ALIAS_ADDRESS, value)
+
+ address = pyproperty(GetAddress, SetAddress)
+
+ def GetReplyTo(self):
+ """Get the ReplyTo address of the send-as Alias object.
+
+ Returns:
+ The ReplyTo address of this send-as Alias object as a string or None.
+ """
+
+ return self._GetProperty(SENDAS_ALIAS_REPLY_TO)
+
+ def SetReplyTo(self, value):
+ """Set the ReplyTo address of this send-as Alias object.
+
+ Args:
+ value: string The new ReplyTo address to give this object.
+ """
+
+ self._SetProperty(SENDAS_ALIAS_REPLY_TO, value)
+
+ reply_to = pyproperty(GetReplyTo, SetReplyTo)
+
+ def GetMakeDefault(self):
+ """Get the MakeDefault value of the send-as Alias object.
+
+ Returns:
+ The MakeDefault value of this send-as Alias object as a string or None.
+ """
+
+ return self._GetProperty(SENDAS_ALIAS_MAKE_DEFAULT)
+
+ def SetMakeDefault(self, value):
+ """Set the MakeDefault value of this send-as Alias object.
+
+ Args:
+ value: string The new MakeDefault valueto give this object.WebClip
+ """
+
+ self._SetProperty(SENDAS_ALIAS_MAKE_DEFAULT, value)
+
+ make_default = pyproperty(GetMakeDefault, SetMakeDefault)
+
+ def __init__(self, uri=None, name=None, address=None, reply_to=None,
+ make_default=None, *args, **kwargs):
+ """Constructs a new EmailSettingsSendAsAlias object with the given
+ arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ name: string (optional) The name that will appear in the "From" field
+ for this user.
+ address: string (optional) The email address that appears as the
+ origination address for emails sent by this user.
+ reply_to: string (optional) The address to be used as the reply-to
+ address in email sent using the alias.
+ make_default: Boolean (optional) Whether or not this alias should
+ become the default alias for this user.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsSendAsAlias, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if name:
+ self.name = name
+ if address:
+ self.address = address
+ if reply_to:
+ self.reply_to = reply_to
+ if make_default is not None:
+ self.make_default = str(make_default)
+
+
+class EmailSettingsWebClip(EmailSettingsEntry):
+ """Represents a WebClip in object form."""
+
+ def GetEnable(self):
+ """Get the Enable value of the WebClip object.
+
+ Returns:
+ The Enable value of this WebClip object as a string or None.
+ """
+
+ return self._GetProperty(WEBCLIP_ENABLE)
+
+ def SetEnable(self, value):
+ """Set the Enable value of this WebClip object.
+
+ Args:
+ value: string The new Enable value to give this object.
+ """
+
+ self._SetProperty(WEBCLIP_ENABLE, value)
+
+ enable = pyproperty(GetEnable, SetEnable)
+
+ def __init__(self, uri=None, enable=None, *args, **kwargs):
+ """Constructs a new EmailSettingsWebClip object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ enable: Boolean (optional) Whether to enable showing Web clips.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsWebClip, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if enable is not None:
+ self.enable = str(enable)
+
+
+class EmailSettingsForwarding(EmailSettingsEntry):
+ """Represents Forwarding settings in object form."""
+
+ def GetEnable(self):
+ """Get the Enable value of the Forwarding object.
+
+ Returns:
+ The Enable value of this Forwarding object as a string or None.
+ """
+
+ return self._GetProperty(FORWARDING_ENABLE)
+
+ def SetEnable(self, value):
+ """Set the Enable value of this Forwarding object.
+
+ Args:
+ value: string The new Enable value to give this object.
+ """
+
+ self._SetProperty(FORWARDING_ENABLE, value)
+
+ enable = pyproperty(GetEnable, SetEnable)
+
+ def GetForwardTo(self):
+ """Get the ForwardTo value of the Forwarding object.
+
+ Returns:
+ The ForwardTo value of this Forwarding object as a string or None.
+ """
+
+ return self._GetProperty(FORWARDING_TO)
+
+ def SetForwardTo(self, value):
+ """Set the ForwardTo value of this Forwarding object.
+
+ Args:
+ value: string The new ForwardTo value to give this object.
+ """
+
+ self._SetProperty(FORWARDING_TO, value)
+
+ forward_to = pyproperty(GetForwardTo, SetForwardTo)
+
+ def GetAction(self):
+ """Get the Action value of the Forwarding object.
+
+ Returns:
+ The Action value of this Forwarding object as a string or None.
+ """
+
+ return self._GetProperty(FORWARDING_ACTION)
+
+ def SetAction(self, value):
+ """Set the Action value of this Forwarding object.
+
+ Args:
+ value: string The new Action value to give this object.
+ """
+
+ self._SetProperty(FORWARDING_ACTION, value)
+
+ action = pyproperty(GetAction, SetAction)
+
+ def __init__(self, uri=None, enable=None, forward_to=None, action=None,
+ *args, **kwargs):
+ """Constructs a new EmailSettingsForwarding object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ enable: Boolean (optional) Whether to enable incoming email forwarding.
+ forward_to: string (optional) The address email will be forwarded to.
+ action: string (optional) The action to perform after forwarding an
+ email ("KEEP", "ARCHIVE", "DELETE").
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsForwarding, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if enable is not None:
+ self.enable = str(enable)
+ if forward_to:
+ self.forward_to = forward_to
+ if action:
+ self.action = action
+
+
+class EmailSettingsPop(EmailSettingsEntry):
+ """Represents POP settings in object form."""
+
+ def GetEnable(self):
+ """Get the Enable value of the POP object.
+
+ Returns:
+ The Enable value of this POP object as a string or None.
+ """
+
+ return self._GetProperty(POP_ENABLE)
+
+ def SetEnable(self, value):
+ """Set the Enable value of this POP object.
+
+ Args:
+ value: string The new Enable value to give this object.
+ """
+
+ self._SetProperty(POP_ENABLE, value)
+
+ enable = pyproperty(GetEnable, SetEnable)
+
+ def GetEnableFor(self):
+ """Get the EnableFor value of the POP object.
+
+ Returns:
+ The EnableFor value of this POP object as a string or None.
+ """
+
+ return self._GetProperty(POP_ENABLE_FOR)
+
+ def SetEnableFor(self, value):
+ """Set the EnableFor value of this POP object.
+
+ Args:
+ value: string The new EnableFor value to give this object.
+ """
+
+ self._SetProperty(POP_ENABLE_FOR, value)
+
+ enable_for = pyproperty(GetEnableFor, SetEnableFor)
+
+ def GetPopAction(self):
+ """Get the Action value of the POP object.
+
+ Returns:
+ The Action value of this POP object as a string or None.
+ """
+
+ return self._GetProperty(POP_ACTION)
+
+ def SetPopAction(self, value):
+ """Set the Action value of this POP object.
+
+ Args:
+ value: string The new Action value to give this object.
+ """
+
+ self._SetProperty(POP_ACTION, value)
+
+ action = pyproperty(GetPopAction, SetPopAction)
+
+ def __init__(self, uri=None, enable=None, enable_for=None,
+ action=None, *args, **kwargs):
+ """Constructs a new EmailSettingsPOP object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ enable: Boolean (optional) Whether to enable incoming POP3 access.
+ enable_for: string (optional) Whether to enable POP3 for all mail
+ ("ALL_MAIL"), or mail from now on ("MAIL_FROM_NOW_ON").
+ action: string (optional) What Google Mail should do with its copy
+ of the email after it is retrieved using POP
+ ("KEEP", "ARCHIVE", or "DELETE").
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsPop, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if enable is not None:
+ self.enable = str(enable)
+ if enable_for:
+ self.enable_for = enable_for
+ if action:
+ self.action = action
+
+
+class EmailSettingsImap(EmailSettingsEntry):
+ """Represents IMAP settings in object form."""
+
+ def GetEnable(self):
+ """Get the Enable value of the IMAP object.
+
+ Returns:
+ The Enable value of this IMAP object as a string or None.
+ """
+
+ return self._GetProperty(IMAP_ENABLE)
+
+ def SetEnable(self, value):
+ """Set the Enable value of this IMAP object.
+
+ Args:
+ value: string The new Enable value to give this object.
+ """
+
+ self._SetProperty(IMAP_ENABLE, value)
+
+ enable = pyproperty(GetEnable, SetEnable)
+
+ def __init__(self, uri=None, enable=None, *args, **kwargs):
+ """Constructs a new EmailSettingsImap object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ enable: Boolean (optional) Whether to enable IMAP access.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsImap, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if enable is not None:
+ self.enable = str(enable)
+
+
+class EmailSettingsVacationResponder(EmailSettingsEntry):
+ """Represents Vacation Responder settings in object form."""
+
+ def GetEnable(self):
+ """Get the Enable value of the Vacation Responder object.
+
+ Returns:
+ The Enable value of this Vacation Responder object as a string or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_ENABLE)
+
+ def SetEnable(self, value):
+ """Set the Enable value of this Vacation Responder object.
+
+ Args:
+ value: string The new Enable value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_ENABLE, value)
+
+ enable = pyproperty(GetEnable, SetEnable)
+
+ def GetSubject(self):
+ """Get the Subject value of the Vacation Responder object.
+
+ Returns:
+ The Subject value of this Vacation Responder object as a string or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_SUBJECT)
+
+ def SetSubject(self, value):
+ """Set the Subject value of this Vacation Responder object.
+
+ Args:
+ value: string The new Subject value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_SUBJECT, value)
+
+ subject = pyproperty(GetSubject, SetSubject)
+
+ def GetMessage(self):
+ """Get the Message value of the Vacation Responder object.
+
+ Returns:
+ The Message value of this Vacation Responder object as a string or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_MESSAGE)
+
+ def SetMessage(self, value):
+ """Set the Message value of this Vacation Responder object.
+
+ Args:
+ value: string The new Message value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_MESSAGE, value)
+
+ message = pyproperty(GetMessage, SetMessage)
+
+ def GetStartDate(self):
+ """Get the StartDate value of the Vacation Responder object.
+
+ Returns:
+ The StartDate value of this Vacation Responder object as a
+ string(YYYY-MM-DD) or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_STARTDATE)
+
+ def SetStartDate(self, value):
+ """Set the StartDate value of this Vacation Responder object.
+
+ Args:
+ value: string The new StartDate value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_STARTDATE, value)
+
+ start_date = pyproperty(GetStartDate, SetStartDate)
+
+ def GetEndDate(self):
+ """Get the EndDate value of the Vacation Responder object.
+
+ Returns:
+ The EndDate value of this Vacation Responder object as a
+ string(YYYY-MM-DD) or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_ENDDATE)
+
+ def SetEndDate(self, value):
+ """Set the EndDate value of this Vacation Responder object.
+
+ Args:
+ value: string The new EndDate value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_ENDDATE, value)
+
+ end_date = pyproperty(GetEndDate, SetEndDate)
+
+ def GetContactsOnly(self):
+ """Get the ContactsOnly value of the Vacation Responder object.
+
+ Returns:
+ The ContactsOnly value of this Vacation Responder object as a
+ string or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_CONTACTS_ONLY)
+
+ def SetContactsOnly(self, value):
+ """Set the ContactsOnly value of this Vacation Responder object.
+
+ Args:
+ value: string The new ContactsOnly value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_CONTACTS_ONLY, value)
+
+ contacts_only = pyproperty(GetContactsOnly, SetContactsOnly)
+
+ def GetDomainOnly(self):
+ """Get the DomainOnly value of the Vacation Responder object.
+
+ Returns:
+ The DomainOnly value of this Vacation Responder object as a
+ string or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_DOMAIN_ONLY)
+
+ def SetDomainOnly(self, value):
+ """Set the DomainOnly value of this Vacation Responder object.
+
+ Args:
+ value: string The new DomainOnly value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_DOMAIN_ONLY, value)
+
+ domain_only = pyproperty(GetDomainOnly, SetDomainOnly)
+
+ def __init__(self, uri=None, enable=None, subject=None,
+ message=None, start_date=None, end_date=None, contacts_only=None,
+ domain_only=None, *args, **kwargs):
+ """Constructs a new EmailSettingsVacationResponder object with the
+ given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ enable: Boolean (optional) Whether to enable the vacation responder.
+ subject: string (optional) The subject line of the vacation responder
+ autoresponse.
+ message: string (optional) The message body of the vacation responder
+ autoresponse.
+ start_date: string (optional) The start date of the vacation responder
+ autoresponse
+ end_date: string (optional) The end date of the vacation responder
+ autoresponse
+ contacts_only: Boolean (optional) Whether to only send autoresponses
+ to known contacts.
+ domain_only: Boolean (optional) Whether to only send autoresponses
+ to users in the same primary domain .
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsVacationResponder, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if enable is not None:
+ self.enable = str(enable)
+ if subject:
+ self.subject = subject
+ if message:
+ self.message = message
+ if start_date:
+ self.start_date = start_date
+ if end_date:
+ self.end_date = end_date
+ if contacts_only is not None:
+ self.contacts_only = str(contacts_only)
+ if domain_only is not None:
+ self.domain_only = str(domain_only)
+
+
+class EmailSettingsSignature(EmailSettingsEntry):
+ """Represents a Signature in object form."""
+
+ def GetValue(self):
+ """Get the value of the Signature object.
+
+ Returns:
+ The value of this Signature object as a string or None.
+ """
+
+ value = self._GetProperty(SIGNATURE_VALUE)
+ if value == ' ': # hack to support empty signature
+ return ''
+ else:
+ return value
+
+ def SetValue(self, value):
+ """Set the name of this Signature object.
+
+ Args:
+ value: string The new signature value to give this object.
+ """
+
+ if value == '': # hack to support empty signature
+ value = ' '
+ self._SetProperty(SIGNATURE_VALUE, value)
+
+ signature_value = pyproperty(GetValue, SetValue)
+
+ def __init__(self, uri=None, signature=None, *args, **kwargs):
+ """Constructs a new EmailSettingsSignature object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ signature: string (optional) The signature to be appended to outgoing
+ messages.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsSignature, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if signature is not None:
+ self.signature_value = signature
+
+
+class EmailSettingsLanguage(EmailSettingsEntry):
+ """Represents Language Settings in object form."""
+
+ def GetLanguage(self):
+ """Get the tag of the Language object.
+
+ Returns:
+ The tag of this Language object as a string or None.
+ """
+
+ return self._GetProperty(LANGUAGE_TAG)
+
+ def SetLanguage(self, value):
+ """Set the tag of this Language object.
+
+ Args:
+ value: string The new tag value to give this object.
+ """
+
+ self._SetProperty(LANGUAGE_TAG, value)
+
+ language_tag = pyproperty(GetLanguage, SetLanguage)
+
+ def __init__(self, uri=None, language=None, *args, **kwargs):
+ """Constructs a new EmailSettingsLanguage object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ language: string (optional) The language tag for Google Mail's display
+ language.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsLanguage, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if language:
+ self.language_tag = language
+
+
+class EmailSettingsGeneral(EmailSettingsEntry):
+ """Represents General Settings in object form."""
+
+ def GetPageSize(self):
+ """Get the Page Size value of the General Settings object.
+
+ Returns:
+ The Page Size value of this General Settings object as a string or None.
+ """
+
+ return self._GetProperty(GENERAL_PAGE_SIZE)
+
+ def SetPageSize(self, value):
+ """Set the Page Size value of this General Settings object.
+
+ Args:
+ value: string The new Page Size value to give this object.
+ """
+
+ self._SetProperty(GENERAL_PAGE_SIZE, value)
+
+ page_size = pyproperty(GetPageSize, SetPageSize)
+
+ def GetShortcuts(self):
+ """Get the Shortcuts value of the General Settings object.
+
+ Returns:
+ The Shortcuts value of this General Settings object as a string or None.
+ """
+
+ return self._GetProperty(GENERAL_SHORTCUTS)
+
+ def SetShortcuts(self, value):
+ """Set the Shortcuts value of this General Settings object.
+
+ Args:
+ value: string The new Shortcuts value to give this object.
+ """
+
+ self._SetProperty(GENERAL_SHORTCUTS, value)
+
+ shortcuts = pyproperty(GetShortcuts, SetShortcuts)
+
+ def GetArrows(self):
+ """Get the Arrows value of the General Settings object.
+
+ Returns:
+ The Arrows value of this General Settings object as a string or None.
+ """
+
+ return self._GetProperty(GENERAL_ARROWS)
+
+ def SetArrows(self, value):
+ """Set the Arrows value of this General Settings object.
+
+ Args:
+ value: string The new Arrows value to give this object.
+ """
+
+ self._SetProperty(GENERAL_ARROWS, value)
+
+ arrows = pyproperty(GetArrows, SetArrows)
+
+ def GetSnippets(self):
+ """Get the Snippets value of the General Settings object.
+
+ Returns:
+ The Snippets value of this General Settings object as a string or None.
+ """
+
+ return self._GetProperty(GENERAL_SNIPPETS)
+
+ def SetSnippets(self, value):
+ """Set the Snippets value of this General Settings object.
+
+ Args:
+ value: string The new Snippets value to give this object.
+ """
+
+ self._SetProperty(GENERAL_SNIPPETS, value)
+
+ snippets = pyproperty(GetSnippets, SetSnippets)
+
+ def GetUnicode(self):
+ """Get the Unicode value of the General Settings object.
+
+ Returns:
+ The Unicode value of this General Settings object as a string or None.
+ """
+
+ return self._GetProperty(GENERAL_UNICODE)
+
+ def SetUnicode(self, value):
+ """Set the Unicode value of this General Settings object.
+
+ Args:
+ value: string The new Unicode value to give this object.
+ """
+
+ self._SetProperty(GENERAL_UNICODE, value)
+
+ use_unicode = pyproperty(GetUnicode, SetUnicode)
+
+ def __init__(self, uri=None, page_size=None, shortcuts=None,
+ arrows=None, snippets=None, use_unicode=None, *args, **kwargs):
+ """Constructs a new EmailSettingsGeneral object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ page_size: int (optional) The number of conversations to be shown per page.
+ shortcuts: Boolean (optional) Whether to enable keyboard shortcuts.
+ arrows: Boolean (optional) Whether to display arrow-shaped personal
+ indicators next to email sent specifically to the user.
+ snippets: Boolean (optional) Whether to display snippets of the messages
+ in the inbox and when searching.
+ use_unicode: Boolean (optional) Whether to use UTF-8 (unicode) encoding
+ for all outgoing messages.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsGeneral, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if page_size is not None:
+ self.page_size = str(page_size)
+ if shortcuts is not None:
+ self.shortcuts = str(shortcuts)
+ if arrows is not None:
+ self.arrows = str(arrows)
+ if snippets is not None:
+ self.snippets = str(snippets)
+ if use_unicode is not None:
+ self.use_unicode = str(use_unicode)
+
+
+class EmailSettingsDelegation(EmailSettingsEntry):
+ """Represents an Email Settings delegation entry in object form."""
+
+ def GetAddress(self):
+ """Get the email address of the delegated user.
+
+ Returns:
+ The email address of the delegated user as a string or None.
+ """
+ return self._GetProperty(DELEGATION_ADDRESS)
+
+ def SetAddress(self, value):
+ """Set the email address of of the delegated user.
+
+ Args:
+ value: string The email address of another user on the same domain
+ """
+ self._SetProperty(DELEGATION_ADDRESS, value)
+
+ address = pyproperty(GetAddress, SetAddress)
+
+ def __init__(self, uri=None, address=None, *args, **kwargs):
+ """Constructs a new EmailSettingsDelegation object with the given
+ arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ address: string The email address of the delegated user.
+ """
+ super(EmailSettingsDelegation, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if address:
+ self.address = address
diff --git a/samples/apps/marketplace_sample/gdata/apps/emailsettings/service.py b/samples/apps/marketplace_sample/gdata/apps/emailsettings/service.py
new file mode 100644
index 0000000..cab61ea
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/emailsettings/service.py
@@ -0,0 +1,264 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Allow Google Apps domain administrators to set users' email settings.
+
+ EmailSettingsService: Set various email settings.
+"""
+
+__author__ = 'google-apps-apis@googlegroups.com'
+
+
+import gdata.apps
+import gdata.apps.service
+import gdata.service
+
+
+API_VER='2.0'
+# Forwarding and POP3 options
+KEEP='KEEP'
+ARCHIVE='ARCHIVE'
+DELETE='DELETE'
+ALL_MAIL='ALL_MAIL'
+MAIL_FROM_NOW_ON='MAIL_FROM_NOW_ON'
+
+
+class EmailSettingsService(gdata.apps.service.PropertyService):
+ """Client for the Google Apps Email Settings service."""
+
+ def _serviceUrl(self, setting_id, username, domain=None):
+ if domain is None:
+ domain = self.domain
+ return '/a/feeds/emailsettings/%s/%s/%s/%s' % (API_VER, domain, username,
+ setting_id)
+
+ def CreateLabel(self, username, label):
+ """Create a label.
+
+ Args:
+ username: User to create label for.
+ label: Label to create.
+
+ Returns:
+ A dict containing the result of the create operation.
+ """
+ uri = self._serviceUrl('label', username)
+ properties = {'label': label}
+ return self._PostProperties(uri, properties)
+
+ def CreateFilter(self, username, from_=None, to=None, subject=None,
+ has_the_word=None, does_not_have_the_word=None,
+ has_attachment=None, label=None, should_mark_as_read=None,
+ should_archive=None):
+ """Create a filter.
+
+ Args:
+ username: User to create filter for.
+ from_: Filter from string.
+ to: Filter to string.
+ subject: Filter subject.
+ has_the_word: Words to filter in.
+ does_not_have_the_word: Words to filter out.
+ has_attachment: Boolean for message having attachment.
+ label: Label to apply.
+ should_mark_as_read: Boolean for marking message as read.
+ should_archive: Boolean for archiving message.
+
+ Returns:
+ A dict containing the result of the create operation.
+ """
+ uri = self._serviceUrl('filter', username)
+ properties = {}
+ properties['from'] = from_
+ properties['to'] = to
+ properties['subject'] = subject
+ properties['hasTheWord'] = has_the_word
+ properties['doesNotHaveTheWord'] = does_not_have_the_word
+ properties['hasAttachment'] = gdata.apps.service._bool2str(has_attachment)
+ properties['label'] = label
+ properties['shouldMarkAsRead'] = gdata.apps.service._bool2str(should_mark_as_read)
+ properties['shouldArchive'] = gdata.apps.service._bool2str(should_archive)
+ return self._PostProperties(uri, properties)
+
+ def CreateSendAsAlias(self, username, name, address, reply_to=None,
+ make_default=None):
+ """Create alias to send mail as.
+
+ Args:
+ username: User to create alias for.
+ name: Name of alias.
+ address: Email address to send from.
+ reply_to: Email address to reply to.
+ make_default: Boolean for whether this is the new default sending alias.
+
+ Returns:
+ A dict containing the result of the create operation.
+ """
+ uri = self._serviceUrl('sendas', username)
+ properties = {}
+ properties['name'] = name
+ properties['address'] = address
+ properties['replyTo'] = reply_to
+ properties['makeDefault'] = gdata.apps.service._bool2str(make_default)
+ return self._PostProperties(uri, properties)
+
+ def UpdateWebClipSettings(self, username, enable):
+ """Update WebClip Settings
+
+ Args:
+ username: User to update forwarding for.
+ enable: Boolean whether to enable Web Clip.
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('webclip', username)
+ properties = {}
+ properties['enable'] = gdata.apps.service._bool2str(enable)
+ return self._PutProperties(uri, properties)
+
+ def UpdateForwarding(self, username, enable, forward_to=None, action=None):
+ """Update forwarding settings.
+
+ Args:
+ username: User to update forwarding for.
+ enable: Boolean whether to enable this forwarding rule.
+ forward_to: Email address to forward to.
+ action: Action to take after forwarding.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('forwarding', username)
+ properties = {}
+ properties['enable'] = gdata.apps.service._bool2str(enable)
+ if enable is True:
+ properties['forwardTo'] = forward_to
+ properties['action'] = action
+ return self._PutProperties(uri, properties)
+
+ def UpdatePop(self, username, enable, enable_for=None, action=None):
+ """Update POP3 settings.
+
+ Args:
+ username: User to update POP3 settings for.
+ enable: Boolean whether to enable POP3.
+ enable_for: Which messages to make available via POP3.
+ action: Action to take after user retrieves email via POP3.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('pop', username)
+ properties = {}
+ properties['enable'] = gdata.apps.service._bool2str(enable)
+ if enable is True:
+ properties['enableFor'] = enable_for
+ properties['action'] = action
+ return self._PutProperties(uri, properties)
+
+ def UpdateImap(self, username, enable):
+ """Update IMAP settings.
+
+ Args:
+ username: User to update IMAP settings for.
+ enable: Boolean whether to enable IMAP.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('imap', username)
+ properties = {'enable': gdata.apps.service._bool2str(enable)}
+ return self._PutProperties(uri, properties)
+
+ def UpdateVacation(self, username, enable, subject=None, message=None,
+ contacts_only=None):
+ """Update vacation settings.
+
+ Args:
+ username: User to update vacation settings for.
+ enable: Boolean whether to enable vacation responses.
+ subject: Vacation message subject.
+ message: Vacation message body.
+ contacts_only: Boolean whether to send message only to contacts.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('vacation', username)
+ properties = {}
+ properties['enable'] = gdata.apps.service._bool2str(enable)
+ if enable is True:
+ properties['subject'] = subject
+ properties['message'] = message
+ properties['contactsOnly'] = gdata.apps.service._bool2str(contacts_only)
+ return self._PutProperties(uri, properties)
+
+ def UpdateSignature(self, username, signature):
+ """Update signature.
+
+ Args:
+ username: User to update signature for.
+ signature: Signature string.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('signature', username)
+ properties = {'signature': signature}
+ return self._PutProperties(uri, properties)
+
+ def UpdateLanguage(self, username, language):
+ """Update user interface language.
+
+ Args:
+ username: User to update language for.
+ language: Language code.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('language', username)
+ properties = {'language': language}
+ return self._PutProperties(uri, properties)
+
+ def UpdateGeneral(self, username, page_size=None, shortcuts=None, arrows=None,
+ snippets=None, unicode=None):
+ """Update general settings.
+
+ Args:
+ username: User to update general settings for.
+ page_size: Number of messages to show.
+ shortcuts: Boolean whether shortcuts are enabled.
+ arrows: Boolean whether arrows are enabled.
+ snippets: Boolean whether snippets are enabled.
+ unicode: Wheter unicode is enabled.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('general', username)
+ properties = {}
+ if page_size != None:
+ properties['pageSize'] = str(page_size)
+ if shortcuts != None:
+ properties['shortcuts'] = gdata.apps.service._bool2str(shortcuts)
+ if arrows != None:
+ properties['arrows'] = gdata.apps.service._bool2str(arrows)
+ if snippets != None:
+ properties['snippets'] = gdata.apps.service._bool2str(snippets)
+ if unicode != None:
+ properties['unicode'] = gdata.apps.service._bool2str(unicode)
+ return self._PutProperties(uri, properties)
diff --git a/samples/apps/marketplace_sample/gdata/apps/groups/__init__.py b/samples/apps/marketplace_sample/gdata/apps/groups/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/groups/__init__.py
diff --git a/samples/apps/marketplace_sample/gdata/apps/groups/client.py b/samples/apps/marketplace_sample/gdata/apps/groups/client.py
new file mode 100644
index 0000000..fabec14
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/groups/client.py
@@ -0,0 +1,341 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""GroupsClient simplifies Groups Provisioning API calls.
+
+GroupsClient extends gdata.client.GDClient to ease interaction
+with the Group Provisioning API. These interactions include the
+ability to create, retrieve, update and delete groups.
+"""
+
+
+__author__ = 'Shraddha gupta <shraddhag@google.com>'
+
+
+import urllib
+import gdata.apps.groups.data
+import gdata.client
+
+
+# Multidomain URI templates
+# The strings in this template are eventually replaced with the API version,
+# and Google Apps domain name respectively.
+GROUP_URI_TEMPLATE = '/a/feeds/group/%s/%s'
+GROUP_MEMBER = 'member'
+
+
+class GroupsProvisioningClient(gdata.client.GDClient):
+ """Client extension for the Google Group Provisioning API service.
+
+ Attributes:
+ host: string The hostname for the Group Provisioning API service.
+ api_version: string The version of the MultiDomain Provisioning API.
+ """
+
+ host = 'apps-apis.google.com'
+ api_version = '2.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+ ssl = True
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the Groups Provisioning API.
+
+ Args:
+ domain: string The Google Apps domain with Group Provisioning.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the email settings.
+ kwargs: The other parameters to pass to the gdata.client.GDClient
+ constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def make_group_provisioning_uri(
+ self, feed_type=None, group_id=None, member_id=None, params=None):
+
+ """Creates a resource feed URI for the Groups Provisioning API.
+
+ Using this client's Google Apps domain, create a feed URI for group
+ provisioning in that domain. If an email address is provided, return a
+ URI for that specific resource. If params are provided, append them as GET
+ params.
+
+ Args:
+ feed_type: string groupmember for groupmember feed else None
+ group_id: string (optional) The identifier of group for which to
+ make a feed URI.
+ member_id: string (optional) The identifier of group member for which to
+ make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for group provisioning for this client's
+ Google Apps domain.
+ """
+ uri = GROUP_URI_TEMPLATE % (self.api_version, self.domain)
+ if group_id:
+ uri += '/' + group_id
+ if feed_type is GROUP_MEMBER:
+ uri += '/' + feed_type
+ if member_id:
+ uri += '/' + member_id
+ if params:
+ uri += '?' + urllib.urlencode(params)
+ return uri
+
+ MakeGroupProvisioningUri = make_group_provisioning_uri
+
+ def make_group_member_uri(self, group_id, member_id=None, params=None):
+ """Creates a resource feed URI for the Group Member Provisioning API."""
+
+ return self.make_group_provisioning_uri(GROUP_MEMBER, group_id=group_id,
+ member_id=member_id, params=params)
+
+ MakeGroupMembersUri = make_group_member_uri
+
+ def RetrieveAllPages(self, feed, desired_class=gdata.data.GDFeed):
+ """Retrieve all pages and add all elements.
+
+ Args:
+ feed: gdata.data.GDFeed object with linked elements.
+ desired_class: type of Feed to be returned.
+
+ Returns:
+ desired_class: subclass of gdata.data.GDFeed.
+ """
+
+ next = feed.GetNextLink()
+ while next is not None:
+ next_feed = self.GetFeed(next.href, desired_class=desired_class)
+ for a_entry in next_feed.entry:
+ feed.entry.append(a_entry)
+ next = next_feed.GetNextLink()
+ return feed
+
+ def retrieve_page_of_groups(self, **kwargs):
+ """Retrieves first page of groups for the given domain.
+
+ Args:
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A gdata.apps.groups.data.GroupFeed of the groups
+ """
+ uri = self.MakeGroupProvisioningUri()
+ return self.GetFeed(uri,
+ desired_class=gdata.apps.groups.data.GroupFeed, **kwargs)
+
+ RetrievePageOfGroups = retrieve_page_of_groups
+
+ def retrieve_all_groups(self):
+ """Retrieve all groups in this domain.
+
+ Returns:
+ gdata.apps.groups.data.GroupFeed of the groups
+ """
+
+ groups_feed = self.RetrievePageOfGroups()
+ # pagination
+ return self.RetrieveAllPages(groups_feed, gdata.apps.groups.data.GroupFeed)
+
+ RetrieveAllGroups = retrieve_all_groups
+
+ def retrieve_group(self, group_id, **kwargs):
+ """Retrieves a single group in the domain.
+
+ Args:
+ group_id: string groupId of the group to be retrieved
+ kwargs: other parameters to pass to gdata.client.GDClient.GetEntry()
+
+ Returns:
+ A gdata.apps.groups.data.GroupEntry representing the group
+ """
+ uri = self.MakeGroupProvisioningUri(group_id=group_id)
+ return self.GetEntry(uri,
+ desired_class=gdata.apps.groups.data.GroupEntry, **kwargs)
+
+ RetrieveGroup = retrieve_group
+
+ def retrieve_page_of_member_groups(self, member_id, direct_only=False,
+ **kwargs):
+ """Retrieve one page of groups that belong to the given member_id.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ direct_only: Boolean whether only return groups that this member
+ directly belongs to.
+
+ Returns:
+ gdata.apps.groups.data.GroupFeed of the groups.
+ """
+ uri = self.MakeGroupProvisioningUri(params={'member':member_id,
+ 'directOnly':direct_only})
+ return self.GetFeed(uri,
+ desired_class=gdata.apps.groups.data.GroupFeed, **kwargs)
+
+ RetrievePageOfMemberGroups = retrieve_page_of_member_groups
+
+ def retrieve_groups(self, member_id, direct_only=False, **kwargs):
+ """Retrieve all groups that belong to the given member_id.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ direct_only: Boolean whether only return groups that this member
+ directly belongs to.
+
+ Returns:
+ gdata.apps.groups.data.GroupFeed of the groups
+ """
+ groups_feed = self.RetrievePageOfMemberGroups(member_id=member_id,
+ direct_only=direct_only)
+ # pagination
+ return self.RetrieveAllPages(groups_feed, gdata.apps.groups.data.GroupFeed)
+
+ RetrieveGroups = retrieve_groups
+
+ def create_group(self, group_id, group_name,
+ description=None, email_permission=None, **kwargs):
+ """Creates a group in the domain with the given properties.
+
+ Args:
+ group_id: string identifier of the group.
+ group_name: string name of the group.
+ description: string (optional) description of the group.
+ email_permission: string (optional) email permission level for the group.
+ kwargs: other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ A gdata.apps.groups.data.GroupEntry of the new group
+ """
+ new_group = gdata.apps.groups.data.GroupEntry(group_id=group_id,
+ group_name=group_name, description=description,
+ email_permission=email_permission)
+ return self.post(new_group, self.MakeGroupProvisioningUri(),
+ **kwargs)
+
+ CreateGroup = create_group
+
+ def update_group(self, group_id, group_entry, **kwargs):
+ """Updates the group with the given groupID.
+
+ Args:
+ group_id: string identifier of the group.
+ group_entry: GroupEntry The group entry with updated values.
+ kwargs: The other parameters to pass to gdata.client.GDClient.put()
+
+ Returns:
+ A gdata.apps.groups.data.GroupEntry representing the group
+ """
+ return self.update(group_entry,
+ uri=self.MakeGroupProvisioningUri(group_id=group_id),
+ **kwargs)
+
+ UpdateGroup = update_group
+
+ def delete_group(self, group_id, **kwargs):
+ """Deletes the group with the given groupId.
+
+ Args:
+ group_id: string groupId of the group to delete.
+ kwargs: The other parameters to pass to gdata.client.GDClient.delete()
+ """
+ self.delete(self.MakeGroupProvisioningUri(group_id=group_id), **kwargs)
+
+ DeleteGroup = delete_group
+
+ def retrieve_page_of_members(self, group_id, **kwargs):
+ """Retrieves first page of group members of the group.
+
+ Args:
+ group_id: string groupId of the group whose members are retrieved
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A gdata.apps.groups.data.GroupMemberFeed of the GroupMember entries
+ """
+ uri = self.MakeGroupMembersUri(group_id=group_id)
+ return self.GetFeed(uri,
+ desired_class=gdata.apps.groups.data.GroupMemberFeed, **kwargs)
+
+ RetrievePageOfMembers = retrieve_page_of_members
+
+ def retrieve_all_members(self, group_id, **kwargs):
+ """Retrieve all members of the group.
+
+ Returns:
+ gdata.apps.groups.data.GroupMemberFeed
+ """
+
+ group_member_feed = self.RetrievePageOfMembers(group_id=group_id)
+ # pagination
+ return self.RetrieveAllPages(group_member_feed,
+ gdata.apps.groups.data.GroupMemberFeed)
+
+ RetrieveAllMembers = retrieve_all_members
+
+ def retrieve_group_member(self, group_id, member_id, **kwargs):
+ """Retrieves a group member with the given id from given group.
+
+ Args:
+ group_id: string groupId of the group whose member is retrieved
+ member_id: string memberId of the group member retrieved
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetEntry()
+
+ Returns:
+ A gdata.apps.groups.data.GroupEntry representing the group member
+ """
+ uri = self.MakeGroupMembersUri(group_id=group_id, member_id=member_id)
+ return self.GetEntry(uri,
+ desired_class=gdata.apps.groups.data.GroupMemberEntry, **kwargs)
+
+ RetrieveGroupMember = retrieve_group_member
+
+ def add_member_to_group(self, group_id, member_id, member_type=None,
+ direct_member=None, **kwargs):
+ """Adds a member with the given id to the group.
+
+ Args:
+ group_id: string groupId of the group where member is added
+ member_id: string memberId of the member added
+ member_type: string (optional) type of member(user or group)
+ direct_member: bool (optional) if member is a direct member
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ A gdata.apps.groups.data.GroupMemberEntry of the group member
+ """
+ member = gdata.apps.groups.data.GroupMemberEntry(member_id=member_id,
+ member_type=member_type, direct_member=direct_member)
+ return self.post(member, self.MakeGroupMembersUri(group_id=group_id),
+ **kwargs)
+
+ AddMemberToGroup = add_member_to_group
+
+ def remove_member_from_group(self, group_id, member_id, **kwargs):
+ """Remove member from the given group.
+
+ Args:
+ group_id: string groupId of the group
+ member_id: string memberId of the member to be removed
+ kwargs: The other parameters to pass to gdata.client.GDClient.delete()
+ """
+ self.delete(
+ self.MakeGroupMembersUri(group_id=group_id, member_id=member_id),
+ **kwargs)
+
+ RemoveMemberFromGroup = remove_member_from_group
diff --git a/samples/apps/marketplace_sample/gdata/apps/groups/data.py b/samples/apps/marketplace_sample/gdata/apps/groups/data.py
new file mode 100644
index 0000000..1f83477
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/groups/data.py
@@ -0,0 +1,236 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for the Groups Provisioning API."""
+
+
+__author__ = 'Shraddha gupta <shraddhag@google.com>'
+
+
+import atom.data
+import gdata.apps
+import gdata.apps.apps_property_entry
+import gdata.apps_property
+import gdata.data
+
+
+# This is required to work around a naming conflict between the Google
+# Spreadsheets API and Python's built-in property function
+pyproperty = property
+
+
+# The apps:property groupId of a group entry
+GROUP_ID = 'groupId'
+# The apps:property groupName of a group entry
+GROUP_NAME = 'groupName'
+# The apps:property description of a group entry
+DESCRIPTION = 'description'
+# The apps:property emailPermission of a group entry
+EMAIL_PERMISSION = 'emailPermission'
+# The apps:property memberId of a group member entry
+MEMBER_ID = 'memberId'
+# The apps:property memberType of a group member entry
+MEMBER_TYPE = 'memberType'
+# The apps:property directMember of a group member entry
+DIRECT_MEMBER = 'directMember'
+
+
+class GroupEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents a group entry in object form."""
+
+ def GetGroupId(self):
+ """Get groupId of the GroupEntry object.
+
+ Returns:
+ The groupId this GroupEntry object as a string or None.
+ """
+ return self._GetProperty(GROUP_ID)
+
+ def SetGroupId(self, value):
+ """Set the groupId of this GroupEntry object.
+
+ Args:
+ value: string The new groupId to give this object.
+ """
+ self._SetProperty(GROUP_ID, value)
+
+ group_id = pyproperty(GetGroupId, SetGroupId)
+
+ def GetGroupName(self):
+ """Get the groupName of the GroupEntry object.
+
+ Returns:
+ The groupName of this GroupEntry object as a string or None.
+ """
+ return self._GetProperty(GROUP_NAME)
+
+ def SetGroupName(self, value):
+ """Set the groupName of this GroupEntry object.
+
+ Args:
+ value: string The new groupName to give this object.
+ """
+ self._SetProperty(GROUP_NAME, value)
+
+ group_name = pyproperty(GetGroupName, SetGroupName)
+
+ def GetDescription(self):
+ """Get the description of the GroupEntry object.
+
+ Returns:
+ The description of this GroupEntry object as a string or None.
+ """
+ return self._GetProperty(DESCRIPTION)
+
+ def SetDescription(self, value):
+ """Set the description of this GroupEntry object.
+
+ Args:
+ value: string The new description to give this object.
+ """
+ self._SetProperty(DESCRIPTION, value)
+
+ description = pyproperty(GetDescription, SetDescription)
+
+ def GetEmailPermission(self):
+ """Get the emailPermission of the GroupEntry object.
+
+ Returns:
+ The emailPermission of this GroupEntry object as a string or None.
+ """
+ return self._GetProperty(EMAIL_PERMISSION)
+
+ def SetEmailPermission(self, value):
+ """Set the emailPermission of this GroupEntry object.
+
+ Args:
+ value: string The new emailPermission to give this object.
+ """
+ self._SetProperty(EMAIL_PERMISSION, value)
+
+ email_permission = pyproperty(GetEmailPermission, SetEmailPermission)
+
+ def __init__(self, group_id=None, group_name=None, description=None,
+ email_permission=None, *args, **kwargs):
+ """Constructs a new GroupEntry object with the given arguments.
+
+ Args:
+ group_id: string identifier of the group.
+ group_name: string name of the group.
+ description: string (optional) the group description.
+ email_permisison: string (optional) permission level of the group.
+ """
+ super(GroupEntry, self).__init__(*args, **kwargs)
+ if group_id:
+ self.group_id = group_id
+ if group_name:
+ self.group_name = group_name
+ if description:
+ self.description = description
+ if email_permission:
+ self.email_permission = email_permission
+
+
+class GroupFeed(gdata.data.GDFeed):
+ """Represents a feed of GroupEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [GroupEntry]
+
+
+class GroupMemberEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents a group member in object form."""
+
+ def GetMemberId(self):
+ """Get the memberId of the GroupMember object.
+
+ Returns:
+ The memberId of this GroupMember object as a string.
+ """
+ return self._GetProperty(MEMBER_ID)
+
+ def SetMemberId(self, value):
+ """Set the memberId of this GroupMember object.
+
+ Args:
+ value: string The new memberId to give this object.
+ """
+ self._SetProperty(MEMBER_ID, value)
+
+ member_id = pyproperty(GetMemberId, SetMemberId)
+
+ def GetMemberType(self):
+ """Get the memberType(User, Group) of the GroupMember object.
+
+ Returns:
+ The memberType of this GroupMember object as a string or None.
+ """
+ return self._GetProperty(MEMBER_TYPE)
+
+ def SetMemberType(self, value):
+ """Set the memberType of this GroupMember object.
+
+ Args:
+ value: string The new memberType to give this object.
+ """
+ self._SetProperty(MEMBER_TYPE, value)
+
+ member_type = pyproperty(GetMemberType, SetMemberType)
+
+ def GetDirectMember(self):
+ """Get the directMember of the GroupMember object.
+
+ Returns:
+ The directMember of this GroupMember object as a bool or None.
+ """
+ return self._GetProperty(DIRECT_MEMBER)
+
+ def SetDirectMember(self, value):
+ """Set the memberType of this GroupMember object.
+
+ Args:
+ value: string The new memberType to give this object.
+ """
+ self._SetProperty(DIRECT_MEMBER, value)
+
+ direct_member = pyproperty(GetDirectMember, SetDirectMember)
+
+ def __init__(self, member_id=None, member_type=None,
+ direct_member=None, *args, **kwargs):
+ """Constructs a new GroupMemberEntry object with the given arguments.
+
+ Args:
+ member_id: string identifier of group member object.
+ member_type: string (optional) member type of group member object.
+ direct_member: bool (optional) if group member object is direct member.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(GroupMemberEntry, self).__init__(*args, **kwargs)
+ if member_id:
+ self.member_id = member_id
+ if member_type:
+ self.member_type = member_type
+ if direct_member:
+ self.direct_member = direct_member
+
+
+class GroupMemberFeed(gdata.data.GDFeed):
+ """Represents a feed of GroupMemberEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [GroupMemberEntry]
+
diff --git a/samples/apps/marketplace_sample/gdata/apps/groups/service.py b/samples/apps/marketplace_sample/gdata/apps/groups/service.py
new file mode 100644
index 0000000..80df417
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/groups/service.py
@@ -0,0 +1,387 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Allow Google Apps domain administrators to manage groups, group members and group owners.
+
+ GroupsService: Provides methods to manage groups, members and owners.
+"""
+
+__author__ = 'google-apps-apis@googlegroups.com'
+
+
+import urllib
+import gdata.apps
+import gdata.apps.service
+import gdata.service
+
+
+API_VER = '2.0'
+BASE_URL = '/a/feeds/group/' + API_VER + '/%s'
+GROUP_MEMBER_URL = BASE_URL + '?member=%s'
+GROUP_MEMBER_DIRECT_URL = GROUP_MEMBER_URL + '&directOnly=%s'
+GROUP_ID_URL = BASE_URL + '/%s'
+MEMBER_URL = BASE_URL + '/%s/member'
+MEMBER_WITH_SUSPENDED_URL = MEMBER_URL + '?includeSuspendedUsers=%s'
+MEMBER_ID_URL = MEMBER_URL + '/%s'
+OWNER_URL = BASE_URL + '/%s/owner'
+OWNER_WITH_SUSPENDED_URL = OWNER_URL + '?includeSuspendedUsers=%s'
+OWNER_ID_URL = OWNER_URL + '/%s'
+
+PERMISSION_OWNER = 'Owner'
+PERMISSION_MEMBER = 'Member'
+PERMISSION_DOMAIN = 'Domain'
+PERMISSION_ANYONE = 'Anyone'
+
+
+class GroupsService(gdata.apps.service.PropertyService):
+ """Client for the Google Apps Groups service."""
+
+ def _ServiceUrl(self, service_type, is_existed, group_id, member_id, owner_email,
+ direct_only=False, domain=None, suspended_users=False):
+ if domain is None:
+ domain = self.domain
+
+ if service_type == 'group':
+ if group_id != '' and is_existed:
+ return GROUP_ID_URL % (domain, group_id)
+ elif member_id != '':
+ if direct_only:
+ return GROUP_MEMBER_DIRECT_URL % (domain, urllib.quote_plus(member_id),
+ self._Bool2Str(direct_only))
+ else:
+ return GROUP_MEMBER_URL % (domain, urllib.quote_plus(member_id))
+ else:
+ return BASE_URL % (domain)
+
+ if service_type == 'member':
+ if member_id != '' and is_existed:
+ return MEMBER_ID_URL % (domain, group_id, urllib.quote_plus(member_id))
+ elif suspended_users:
+ return MEMBER_WITH_SUSPENDED_URL % (domain, group_id,
+ self._Bool2Str(suspended_users))
+ else:
+ return MEMBER_URL % (domain, group_id)
+
+ if service_type == 'owner':
+ if owner_email != '' and is_existed:
+ return OWNER_ID_URL % (domain, group_id, urllib.quote_plus(owner_email))
+ elif suspended_users:
+ return OWNER_WITH_SUSPENDED_URL % (domain, group_id,
+ self._Bool2Str(suspended_users))
+ else:
+ return OWNER_URL % (domain, group_id)
+
+ def _Bool2Str(self, b):
+ if b is None:
+ return None
+ return str(b is True).lower()
+
+ def _IsExisted(self, uri):
+ try:
+ self._GetProperties(uri)
+ return True
+ except gdata.apps.service.AppsForYourDomainException, e:
+ if e.error_code == gdata.apps.service.ENTITY_DOES_NOT_EXIST:
+ return False
+ else:
+ raise e
+
+ def CreateGroup(self, group_id, group_name, description, email_permission):
+ """Create a group.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ group_name: The name of the group.
+ description: A description of the group
+ email_permission: The subscription permission of the group.
+
+ Returns:
+ A dict containing the result of the create operation.
+ """
+ uri = self._ServiceUrl('group', False, group_id, '', '')
+ properties = {}
+ properties['groupId'] = group_id
+ properties['groupName'] = group_name
+ properties['description'] = description
+ properties['emailPermission'] = email_permission
+ return self._PostProperties(uri, properties)
+
+ def UpdateGroup(self, group_id, group_name, description, email_permission):
+ """Update a group's name, description and/or permission.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ group_name: The name of the group.
+ description: A description of the group
+ email_permission: The subscription permission of the group.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._ServiceUrl('group', True, group_id, '', '')
+ properties = {}
+ properties['groupId'] = group_id
+ properties['groupName'] = group_name
+ properties['description'] = description
+ properties['emailPermission'] = email_permission
+ return self._PutProperties(uri, properties)
+
+ def RetrieveGroup(self, group_id):
+ """Retrieve a group based on its ID.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('group', True, group_id, '', '')
+ return self._GetProperties(uri)
+
+ def RetrieveAllGroups(self):
+ """Retrieve all groups in the domain.
+
+ Args:
+ None
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('group', True, '', '', '')
+ return self._GetPropertiesList(uri)
+
+ def RetrievePageOfGroups(self, start_group=None):
+ """Retrieve one page of groups in the domain.
+
+ Args:
+ start_group: The key to continue for pagination through all groups.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('group', True, '', '', '')
+ if start_group is not None:
+ uri += "?start="+start_group
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
+
+ def RetrieveGroups(self, member_id, direct_only=False):
+ """Retrieve all groups that belong to the given member_id.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ direct_only: Boolean whether only return groups that this member directly belongs to.
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('group', True, '', member_id, '', direct_only=direct_only)
+ return self._GetPropertiesList(uri)
+
+ def DeleteGroup(self, group_id):
+ """Delete a group based on its ID.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the delete operation.
+ """
+ uri = self._ServiceUrl('group', True, group_id, '', '')
+ return self._DeleteProperties(uri)
+
+ def AddMemberToGroup(self, member_id, group_id):
+ """Add a member to a group.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the add operation.
+ """
+ uri = self._ServiceUrl('member', False, group_id, member_id, '')
+ properties = {}
+ properties['memberId'] = member_id
+ return self._PostProperties(uri, properties)
+
+ def IsMember(self, member_id, group_id):
+ """Check whether the given member already exists in the given group.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ True if the member exists in the group. False otherwise.
+ """
+ uri = self._ServiceUrl('member', True, group_id, member_id, '')
+ return self._IsExisted(uri)
+
+ def RetrieveMember(self, member_id, group_id):
+ """Retrieve the given member in the given group.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('member', True, group_id, member_id, '')
+ return self._GetProperties(uri)
+
+ def RetrieveAllMembers(self, group_id, suspended_users=False):
+ """Retrieve all members in the given group.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ suspended_users: A boolean; should we include any suspended users in
+ the membership list returned?
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('member', True, group_id, '', '',
+ suspended_users=suspended_users)
+ return self._GetPropertiesList(uri)
+
+ def RetrievePageOfMembers(self, group_id, suspended_users=False, start=None):
+ """Retrieve one page of members of a given group.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ suspended_users: A boolean; should we include any suspended users in
+ the membership list returned?
+ start: The key to continue for pagination through all members.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+
+ uri = self._ServiceUrl('member', True, group_id, '', '',
+ suspended_users=suspended_users)
+ if start is not None:
+ if suspended_users:
+ uri += "&start="+start
+ else:
+ uri += "?start="+start
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
+
+ def RemoveMemberFromGroup(self, member_id, group_id):
+ """Remove the given member from the given group.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the remove operation.
+ """
+ uri = self._ServiceUrl('member', True, group_id, member_id, '')
+ return self._DeleteProperties(uri)
+
+ def AddOwnerToGroup(self, owner_email, group_id):
+ """Add an owner to a group.
+
+ Args:
+ owner_email: The email address of a group owner.
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the add operation.
+ """
+ uri = self._ServiceUrl('owner', False, group_id, '', owner_email)
+ properties = {}
+ properties['email'] = owner_email
+ return self._PostProperties(uri, properties)
+
+ def IsOwner(self, owner_email, group_id):
+ """Check whether the given member an owner of the given group.
+
+ Args:
+ owner_email: The email address of a group owner.
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ True if the member is an owner of the given group. False otherwise.
+ """
+ uri = self._ServiceUrl('owner', True, group_id, '', owner_email)
+ return self._IsExisted(uri)
+
+ def RetrieveOwner(self, owner_email, group_id):
+ """Retrieve the given owner in the given group.
+
+ Args:
+ owner_email: The email address of a group owner.
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('owner', True, group_id, '', owner_email)
+ return self._GetProperties(uri)
+
+ def RetrieveAllOwners(self, group_id, suspended_users=False):
+ """Retrieve all owners of the given group.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ suspended_users: A boolean; should we include any suspended users in
+ the ownership list returned?
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('owner', True, group_id, '', '',
+ suspended_users=suspended_users)
+ return self._GetPropertiesList(uri)
+
+ def RetrievePageOfOwners(self, group_id, suspended_users=False, start=None):
+ """Retrieve one page of owners of the given group.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ suspended_users: A boolean; should we include any suspended users in
+ the ownership list returned?
+ start: The key to continue for pagination through all owners.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('owner', True, group_id, '', '',
+ suspended_users=suspended_users)
+ if start is not None:
+ if suspended_users:
+ uri += "&start="+start
+ else:
+ uri += "?start="+start
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
+
+ def RemoveOwnerFromGroup(self, owner_email, group_id):
+ """Remove the given owner from the given group.
+
+ Args:
+ owner_email: The email address of a group owner.
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the remove operation.
+ """
+ uri = self._ServiceUrl('owner', True, group_id, '', owner_email)
+ return self._DeleteProperties(uri)
diff --git a/samples/apps/marketplace_sample/gdata/apps/migration/__init__.py b/samples/apps/marketplace_sample/gdata/apps/migration/__init__.py
new file mode 100644
index 0000000..0a7df6c
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/migration/__init__.py
@@ -0,0 +1,223 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2008 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains objects used with Google Apps."""
+
+__author__ = 'google-apps-apis@googlegroups.com'
+
+
+import atom
+import gdata
+
+
+# XML namespaces which are often used in Google Apps entity.
+APPS_NAMESPACE = 'http://schemas.google.com/apps/2006'
+APPS_TEMPLATE = '{http://schemas.google.com/apps/2006}%s'
+
+
+class Rfc822Msg(atom.AtomBase):
+ """The Migration rfc822Msg element."""
+
+ _tag = 'rfc822Msg'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['encoding'] = 'encoding'
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.text = text
+ self.encoding = 'base64'
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def Rfc822MsgFromString(xml_string):
+ """Parse in the Rrc822 message from the XML definition."""
+
+ return atom.CreateClassFromXMLString(Rfc822Msg, xml_string)
+
+
+class MailItemProperty(atom.AtomBase):
+ """The Migration mailItemProperty element."""
+
+ _tag = 'mailItemProperty'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def MailItemPropertyFromString(xml_string):
+ """Parse in the MailItemProperiy from the XML definition."""
+
+ return atom.CreateClassFromXMLString(MailItemProperty, xml_string)
+
+
+class Label(atom.AtomBase):
+ """The Migration label element."""
+
+ _tag = 'label'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['labelName'] = 'label_name'
+
+ def __init__(self, label_name=None,
+ extension_elements=None, extension_attributes=None,
+ text=None):
+ self.label_name = label_name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def LabelFromString(xml_string):
+ """Parse in the mailItemProperty from the XML definition."""
+
+ return atom.CreateClassFromXMLString(Label, xml_string)
+
+
+class MailEntry(gdata.GDataEntry):
+ """A Google Migration flavor of an Atom Entry."""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}rfc822Msg' % APPS_NAMESPACE] = ('rfc822_msg', Rfc822Msg)
+ _children['{%s}mailItemProperty' % APPS_NAMESPACE] = ('mail_item_property',
+ [MailItemProperty])
+ _children['{%s}label' % APPS_NAMESPACE] = ('label', [Label])
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ rfc822_msg=None, mail_item_property=None, label=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.rfc822_msg = rfc822_msg
+ self.mail_item_property = mail_item_property
+ self.label = label
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def MailEntryFromString(xml_string):
+ """Parse in the MailEntry from the XML definition."""
+
+ return atom.CreateClassFromXMLString(MailEntry, xml_string)
+
+
+class BatchMailEntry(gdata.BatchEntry):
+ """A Google Migration flavor of an Atom Entry."""
+
+ _tag = gdata.BatchEntry._tag
+ _namespace = gdata.BatchEntry._namespace
+ _children = gdata.BatchEntry._children.copy()
+ _attributes = gdata.BatchEntry._attributes.copy()
+ _children['{%s}rfc822Msg' % APPS_NAMESPACE] = ('rfc822_msg', Rfc822Msg)
+ _children['{%s}mailItemProperty' % APPS_NAMESPACE] = ('mail_item_property',
+ [MailItemProperty])
+ _children['{%s}label' % APPS_NAMESPACE] = ('label', [Label])
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ rfc822_msg=None, mail_item_property=None, label=None,
+ batch_operation=None, batch_id=None, batch_status=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.BatchEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ batch_operation=batch_operation,
+ batch_id=batch_id, batch_status=batch_status,
+ title=title, updated=updated)
+ self.rfc822_msg = rfc822_msg or None
+ self.mail_item_property = mail_item_property or []
+ self.label = label or []
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def BatchMailEntryFromString(xml_string):
+ """Parse in the BatchMailEntry from the XML definition."""
+
+ return atom.CreateClassFromXMLString(BatchMailEntry, xml_string)
+
+
+class BatchMailEventFeed(gdata.BatchFeed):
+ """A Migration event feed flavor of an Atom Feed."""
+
+ _tag = gdata.BatchFeed._tag
+ _namespace = gdata.BatchFeed._namespace
+ _children = gdata.BatchFeed._children.copy()
+ _attributes = gdata.BatchFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [BatchMailEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, interrupted=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.BatchFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ interrupted=interrupted,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+class MailEntryProperties(object):
+ """Represents a mail message and its attributes."""
+
+ def __init__(self, mail_message=None, mail_item_properties=None,
+ mail_labels=None, identifier=None):
+ self.mail_message = mail_message
+ self.mail_item_properties = mail_item_properties or []
+ self.mail_labels = mail_labels or []
+ self.identifier = identifier
+
+
+def BatchMailEventFeedFromString(xml_string):
+ """Parse in the BatchMailEventFeed from the XML definition."""
+
+ return atom.CreateClassFromXMLString(BatchMailEventFeed, xml_string)
diff --git a/samples/apps/marketplace_sample/gdata/apps/migration/service.py b/samples/apps/marketplace_sample/gdata/apps/migration/service.py
new file mode 100644
index 0000000..5a89eff
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/migration/service.py
@@ -0,0 +1,218 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2008 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains the methods to import mail via Google Apps Email Migration API.
+
+ MigrationService: Provides methods to import mail.
+"""
+
+__author__ = ('google-apps-apis@googlegroups.com',
+ 'pti@google.com (Prashant Tiwari)')
+
+
+import base64
+import threading
+import time
+from atom.service import deprecation
+from gdata.apps import migration
+from gdata.apps.migration import MailEntryProperties
+import gdata.apps.service
+import gdata.service
+
+
+API_VER = '2.0'
+
+
+class MigrationService(gdata.apps.service.AppsService):
+ """Client for the EMAPI migration service. Use either ImportMail to import
+ one message at a time, or AddMailEntry and ImportMultipleMails to import a
+ bunch of messages at a time.
+ """
+
+ def __init__(self, email=None, password=None, domain=None, source=None,
+ server='apps-apis.google.com', additional_headers=None):
+ gdata.apps.service.AppsService.__init__(
+ self, email=email, password=password, domain=domain, source=source,
+ server=server, additional_headers=additional_headers)
+ self.mail_batch = migration.BatchMailEventFeed()
+ self.mail_entries = []
+ self.exceptions = 0
+
+ def _BaseURL(self):
+ return '/a/feeds/migration/%s/%s' % (API_VER, self.domain)
+
+ def ImportMail(self, user_name, mail_message, mail_item_properties,
+ mail_labels):
+ """Imports a single mail message.
+
+ Args:
+ user_name: The username to import messages to.
+ mail_message: An RFC822 format email message.
+ mail_item_properties: A list of Gmail properties to apply to the message.
+ mail_labels: A list of labels to apply to the message.
+
+ Returns:
+ A MailEntry representing the successfully imported message.
+
+ Raises:
+ AppsForYourDomainException: An error occurred importing the message.
+ """
+ uri = '%s/%s/mail' % (self._BaseURL(), user_name)
+
+ mail_entry = migration.MailEntry()
+ mail_entry.rfc822_msg = migration.Rfc822Msg(text=(base64.b64encode(
+ mail_message)))
+ mail_entry.rfc822_msg.encoding = 'base64'
+ mail_entry.mail_item_property = map(
+ lambda x: migration.MailItemProperty(value=x), mail_item_properties)
+ mail_entry.label = map(lambda x: migration.Label(label_name=x),
+ mail_labels)
+
+ try:
+ return migration.MailEntryFromString(str(self.Post(mail_entry, uri)))
+ except gdata.service.RequestError, e:
+ # Store the number of failed imports when importing several at a time
+ self.exceptions += 1
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ def AddBatchEntry(self, mail_message, mail_item_properties,
+ mail_labels):
+ """Adds a message to the current batch that you later will submit.
+
+ Deprecated, use AddMailEntry instead
+
+ Args:
+ mail_message: An RFC822 format email message.
+ mail_item_properties: A list of Gmail properties to apply to the message.
+ mail_labels: A list of labels to apply to the message.
+
+ Returns:
+ The length of the MailEntry representing the message.
+ """
+ deprecation("calling deprecated method AddBatchEntry")
+ mail_entry = migration.BatchMailEntry()
+ mail_entry.rfc822_msg = migration.Rfc822Msg(text=(base64.b64encode(
+ mail_message)))
+ mail_entry.rfc822_msg.encoding = 'base64'
+ mail_entry.mail_item_property = map(
+ lambda x: migration.MailItemProperty(value=x), mail_item_properties)
+ mail_entry.label = map(lambda x: migration.Label(label_name=x),
+ mail_labels)
+
+ self.mail_batch.AddBatchEntry(mail_entry)
+
+ return len(str(mail_entry))
+
+ def SubmitBatch(self, user_name):
+ """Sends all the mail items you have added to the batch to the server.
+
+ Deprecated, use ImportMultipleMails instead
+
+ Args:
+ user_name: The username to import messages to.
+
+ Returns:
+ An HTTPResponse from the web service call.
+
+ Raises:
+ AppsForYourDomainException: An error occurred importing the batch.
+ """
+ deprecation("calling deprecated method SubmitBatch")
+ uri = '%s/%s/mail/batch' % (self._BaseURL(), user_name)
+
+ try:
+ self.result = self.Post(self.mail_batch, uri,
+ converter=migration.BatchMailEventFeedFromString)
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ self.mail_batch = migration.BatchMailEventFeed()
+
+ return self.result
+
+ def AddMailEntry(self, mail_message, mail_item_properties=None,
+ mail_labels=None, identifier=None):
+ """Prepares a list of mail messages to import using ImportMultipleMails.
+
+ Args:
+ mail_message: An RFC822 format email message as a string.
+ mail_item_properties: List of Gmail properties to apply to the
+ message.
+ mail_labels: List of Gmail labels to apply to the message.
+ identifier: The optional file identifier string
+
+ Returns:
+ The number of email messages to be imported.
+ """
+ mail_entry_properties = MailEntryProperties(
+ mail_message=mail_message,
+ mail_item_properties=mail_item_properties,
+ mail_labels=mail_labels,
+ identifier=identifier)
+
+ self.mail_entries.append(mail_entry_properties)
+ return len(self.mail_entries)
+
+ def ImportMultipleMails(self, user_name, threads_per_batch=20):
+ """Launches separate threads to import every message added by AddMailEntry.
+
+ Args:
+ user_name: The user account name to import messages to.
+ threads_per_batch: Number of messages to import at a time.
+
+ Returns:
+ The number of email messages that were successfully migrated.
+
+ Raises:
+ Exception: An error occurred while importing mails.
+ """
+ num_entries = len(self.mail_entries)
+
+ if not num_entries:
+ return 0
+
+ threads = []
+ for mail_entry_properties in self.mail_entries:
+ t = threading.Thread(name=mail_entry_properties.identifier,
+ target=self.ImportMail,
+ args=(user_name, mail_entry_properties.mail_message,
+ mail_entry_properties.mail_item_properties,
+ mail_entry_properties.mail_labels))
+ threads.append(t)
+ try:
+ # Determine the number of batches needed with threads_per_batch in each
+ batches = num_entries / threads_per_batch + (
+ 0 if num_entries % threads_per_batch == 0 else 1)
+ batch_min = 0
+ # Start the threads, one batch at a time
+ for batch in range(batches):
+ batch_max = ((batch + 1) * threads_per_batch
+ if (batch + 1) * threads_per_batch < num_entries
+ else num_entries)
+ for i in range(batch_min, batch_max):
+ threads[i].start()
+ time.sleep(1)
+
+ for i in range(batch_min, batch_max):
+ threads[i].join()
+
+ batch_min = batch_max
+
+ self.mail_entries = []
+ except Exception, e:
+ raise Exception(e.args[0])
+ else:
+ return num_entries - self.exceptions
diff --git a/samples/apps/marketplace_sample/gdata/apps/multidomain/__init__.py b/samples/apps/marketplace_sample/gdata/apps/multidomain/__init__.py
new file mode 100755
index 0000000..e69de29
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/multidomain/__init__.py
diff --git a/samples/apps/marketplace_sample/gdata/apps/multidomain/client.py b/samples/apps/marketplace_sample/gdata/apps/multidomain/client.py
new file mode 100755
index 0000000..711794f
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/multidomain/client.py
@@ -0,0 +1,382 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""MultiDomainProvisioningClient simplifies Multidomain Provisioning API calls.
+
+MultiDomainProvisioningClient extends gdata.client.GDClient to ease interaction
+with the Google Multidomain Provisioning API. These interactions include the
+ability to create, retrieve, update and delete users and aliases in multiple
+domains.
+"""
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import urllib
+import gdata.apps.multidomain.data
+import gdata.client
+
+
+# Multidomain URI templates
+# The strings in this template are eventually replaced with the feed type
+# (user/alias), API version and Google Apps domain name, respectively.
+MULTIDOMAIN_URI_TEMPLATE = '/a/feeds/%s/%s/%s'
+# The strings in this template are eventually replaced with the API version,
+# Google Apps domain name and old email address, respectively.
+MULTIDOMAIN_USER_RENAME_URI_TEMPLATE = '/a/feeds/user/userEmail/%s/%s/%s'
+
+# The value for user requests
+MULTIDOMAIN_USER_FEED = 'user'
+# The value for alias requests
+MULTIDOMAIN_ALIAS_FEED = 'alias'
+
+
+class MultiDomainProvisioningClient(gdata.client.GDClient):
+ """Client extension for the Google MultiDomain Provisioning API service.
+
+ Attributes:
+ host: string The hostname for the MultiDomain Provisioning API service.
+ api_version: string The version of the MultiDomain Provisioning API.
+ """
+
+ host = 'apps-apis.google.com'
+ api_version = '2.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+ ssl = True
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the MultiDomain Provisioning API.
+
+ Args:
+ domain: string The Google Apps domain with MultiDomain Provisioning.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the email settings.
+ kwargs: The other parameters to pass to the gdata.client.GDClient
+ constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def make_multidomain_provisioning_uri(
+ self, feed_type, email=None, params=None):
+
+ """Creates a resource feed URI for the MultiDomain Provisioning API.
+
+ Using this client's Google Apps domain, create a feed URI for multidomain
+ provisioning in that domain. If an email address is provided, return a
+ URI for that specific resource. If params are provided, append them as GET
+ params.
+
+ Args:
+ feed_type: string The type of feed (user/alias)
+ email: string (optional) The email address of multidomain resource for
+ which to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for multidomain provisioning for this client's
+ Google Apps domain.
+ """
+ uri = MULTIDOMAIN_URI_TEMPLATE % (feed_type, self.api_version, self.domain)
+ if email:
+ uri += '/' + email
+ if params:
+ uri += '?' + urllib.urlencode(params)
+ return uri
+
+ MakeMultidomainProvisioningUri = make_multidomain_provisioning_uri
+
+ def make_multidomain_user_provisioning_uri(self, email=None, params=None):
+ """Creates a resource feed URI for the MultiDomain User Provisioning API.
+
+ Using this client's Google Apps domain, create a feed URI for multidomain
+ user provisioning in that domain. If an email address is provided, return a
+ URI for that specific resource. If params are provided, append them as GET
+ params.
+
+ Args:
+ email: string (optional) The email address of multidomain user for which
+ to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for multidomain user provisioning for thisis that
+ client's Google Apps domain.
+ """
+ return self.make_multidomain_provisioning_uri(
+ MULTIDOMAIN_USER_FEED, email, params)
+
+ MakeMultidomainUserProvisioningUri = make_multidomain_user_provisioning_uri
+
+ def make_multidomain_alias_provisioning_uri(self, email=None, params=None):
+ """Creates a resource feed URI for the MultiDomain Alias Provisioning API.
+
+ Using this client's Google Apps domain, create a feed URI for multidomain
+ alias provisioning in that domain. If an email address is provided, return a
+ URI for that specific resource. If params are provided, append them as GET
+ params.
+
+ Args:
+ email: string (optional) The email address of multidomain alias for which
+ to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for multidomain alias provisioning for this
+ client's Google Apps domain.
+ """
+ return self.make_multidomain_provisioning_uri(
+ MULTIDOMAIN_ALIAS_FEED, email, params)
+
+ MakeMultidomainAliasProvisioningUri = make_multidomain_alias_provisioning_uri
+
+ def retrieve_all_pages(self, uri, desired_class=gdata.data.GDFeed, **kwargs):
+ """Retrieves all pages from uri.
+
+ Args:
+ uri: The uri where the first page is.
+ desired_class: Type of feed that is retrieved.
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A desired_class feed object.
+ """
+ feed = self.GetFeed(
+ uri,
+ desired_class=desired_class,
+ **kwargs)
+ next_link = feed.GetNextLink()
+ while next_link is not None:
+ uri = next_link.href
+ temp_feed = self.GetFeed(
+ uri, desired_class=desired_class, **kwargs)
+ feed.entry = feed.entry + temp_feed.entry
+ next_link = temp_feed.GetNextLink()
+ return feed
+
+ RetrieveAllPages = retrieve_all_pages
+
+ def retrieve_all_users(self, **kwargs):
+ """Retrieves all users in all domains.
+
+ Args:
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A gdata.data.GDFeed of the domain users
+ """
+ uri = self.MakeMultidomainUserProvisioningUri()
+ return self.RetrieveAllPages(
+ uri,
+ desired_class=gdata.apps.multidomain.data.UserFeed,
+ **kwargs)
+
+ RetrieveAllUsers = retrieve_all_users
+
+ def retrieve_user(self, email, **kwargs):
+ """Retrieves a single user in the domain.
+
+ Args:
+ email: string The email address of the user to be retrieved
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetEntry()
+
+ Returns:
+ A gdata.apps.multidomain.data.UserEntry representing the user
+ """
+ uri = self.MakeMultidomainUserProvisioningUri(email=email)
+ return self.GetEntry(
+ uri,
+ desired_class=gdata.apps.multidomain.data.UserEntry,
+ **kwargs)
+
+ RetrieveUser = retrieve_user
+
+ def create_user(self, email, first_name, last_name, password, is_admin,
+ hash_function=None, suspended=None, change_password=None,
+ ip_whitelisted=None, quota=None, **kwargs):
+ """Creates an user in the domain with the given properties.
+
+ Args:
+ email: string The email address of the user.
+ first_name: string The first name of the user.
+ last_name: string The last name of the user.
+ password: string The password of the user.
+ is_admin: Boolean Whether or not the user has administrator privileges.
+ hash_function: string (optional) The name of the function used to hash the
+ password.
+ suspended: Boolean (optional) Whether or not the user is suspended.
+ change_password: Boolean (optional) Whether or not the user must change
+ password at first login.
+ ip_whitelisted: Boolean (optional) Whether or not the user's ip is
+ whitelisted.
+ quota: string (optional) The value (in GB) of the user's quota.
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ A gdata.apps.multidomain.data.UserEntry of the new user
+ """
+ new_user = gdata.apps.multidomain.data.UserEntry(
+ email=email, first_name=first_name, last_name=last_name,
+ password=password, is_admin=is_admin, hash_function=hash_function,
+ suspended=suspended, change_password=change_password,
+ ip_whitelisted=ip_whitelisted, quota=quota)
+ return self.post(new_user, self.MakeMultidomainUserProvisioningUri(),
+ **kwargs)
+
+ CreateUser = create_user
+
+ def update_user(self, email, user_entry, **kwargs):
+ """Deletes the user with the given email address.
+
+ Args:
+ email: string The email address of the user to be updated.
+ user_entry: UserEntry The user entry with updated values.
+ kwargs: The other parameters to pass to gdata.client.GDClient.put()
+
+ Returns:
+ A gdata.apps.multidomain.data.UserEntry representing the user
+ """
+ return self.update(user_entry,
+ uri=self.MakeMultidomainUserProvisioningUri(email),
+ **kwargs)
+
+ UpdateUser = update_user
+
+ def delete_user(self, email, **kwargs):
+ """Deletes the user with the given email address.
+
+ Args:
+ email: string The email address of the user to delete.
+ kwargs: The other parameters to pass to gdata.client.GDClient.delete()
+
+ Returns:
+ An HTTP response object. See gdata.client.request().
+ """
+ return self.delete(self.MakeMultidomainUserProvisioningUri(email), **kwargs)
+
+ DeleteUser = delete_user
+
+ def rename_user(self, old_email, new_email, **kwargs):
+ """Renames an user's account to a different domain.
+
+ Args:
+ old_email: string The old email address of the user to rename.
+ new_email: string The new email address for the user to be renamed.
+ kwargs: The other parameters to pass to gdata.client.GDClient.put()
+
+ Returns:
+ A gdata.apps.multidomain.data.UserRenameRequest representing the request.
+ """
+ rename_uri = MULTIDOMAIN_USER_RENAME_URI_TEMPLATE % (self.api_version,
+ self.domain,
+ old_email)
+ entry = gdata.apps.multidomain.data.UserRenameRequest(new_email)
+ return self.update(entry, uri=rename_uri, **kwargs)
+
+ RenameUser = rename_user
+
+ def retrieve_all_aliases(self, **kwargs):
+ """Retrieves all aliases in the domain.
+
+ Args:
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A gdata.data.GDFeed of the domain aliases
+ """
+ uri = self.MakeMultidomainAliasProvisioningUri()
+ return self.RetrieveAllPages(
+ uri,
+ desired_class=gdata.apps.multidomain.data.AliasFeed,
+ **kwargs)
+
+ RetrieveAllAliases = retrieve_all_aliases
+
+ def retrieve_alias(self, email, **kwargs):
+ """Retrieves a single alias in the domain.
+
+ Args:
+ email: string The email address of the alias to be retrieved
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetEntry()
+
+ Returns:
+ A gdata.apps.multidomain.data.AliasEntry representing the alias
+ """
+ uri = self.MakeMultidomainAliasProvisioningUri(email=email)
+ return self.GetEntry(
+ uri,
+ desired_class=gdata.apps.multidomain.data.AliasEntry,
+ **kwargs)
+
+ RetrieveAlias = retrieve_alias
+
+ def retrieve_all_user_aliases(self, user_email, **kwargs):
+ """Retrieves all aliases for a given user in the domain.
+
+ Args:
+ user_email: string Email address of the user whose aliases
+ are to be retrieved
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A gdata.data.GDFeed of the user aliases
+ """
+ uri = self.MakeMultidomainAliasProvisioningUri(
+ params = {'userEmail' : user_email})
+ return self.RetrieveAllPages(
+ uri,
+ desired_class=gdata.apps.multidomain.data.AliasFeed,
+ **kwargs)
+
+ RetrieveAllUserAliases = retrieve_all_user_aliases
+
+ def create_alias(self, user_email, alias_email, **kwargs):
+ """Creates an alias in the domain with the given properties.
+
+ Args:
+ user_email: string The email address of the user.
+ alias_email: string The first name of the user.
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ A gdata.apps.multidomain.data.AliasEntry of the new alias
+ """
+ new_alias = gdata.apps.multidomain.data.AliasEntry(
+ user_email=user_email, alias_email=alias_email)
+ return self.post(new_alias, self.MakeMultidomainAliasProvisioningUri(),
+ **kwargs)
+
+ CreateAlias = create_alias
+
+ def delete_alias(self, email, **kwargs):
+ """Deletes the alias with the given email address.
+
+ Args:
+ email: string The email address of the alias to delete.
+ kwargs: The other parameters to pass to gdata.client.GDClient.delete()
+
+ Returns:
+ An HTTP response object. See gdata.client.request().
+ """
+ return self.delete(self.MakeMultidomainAliasProvisioningUri(email),
+ **kwargs)
+
+ DeleteAlias = delete_alias
diff --git a/samples/apps/marketplace_sample/gdata/apps/multidomain/data.py b/samples/apps/marketplace_sample/gdata/apps/multidomain/data.py
new file mode 100755
index 0000000..9bc467a
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/multidomain/data.py
@@ -0,0 +1,414 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for the Multidomain Provisioning API."""
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import gdata.apps
+import gdata.apps.apps_property_entry
+import gdata.apps_property
+import gdata.data
+
+
+# This is required to work around a naming conflict between the Google
+# Spreadsheets API and Python's built-in property function
+pyproperty = property
+
+
+# The apps:property firstName of a user entry
+USER_FIRST_NAME = 'firstName'
+# The apps:property lastName of a user entry
+USER_LAST_NAME = 'lastName'
+# The apps:property userEmail of a user entry
+USER_EMAIL = 'userEmail'
+# The apps:property password of a user entry
+USER_PASSWORD = 'password'
+# The apps:property hashFunction of a user entry
+USER_HASH_FUNCTION = 'hashFunction'
+# The apps:property isChangePasswordAtNextLogin of a user entry
+USER_CHANGE_PASSWORD = 'isChangePasswordAtNextLogin'
+# The apps:property agreedToTerms of a user entry
+USER_AGREED_TO_TERMS = 'agreedToTerms'
+# The apps:property isSuspended of a user entry
+USER_SUSPENDED = 'isSuspended'
+# The apps:property isAdmin of a user entry
+USER_ADMIN = 'isAdmin'
+# The apps:property ipWhitelisted of a user entry
+USER_IP_WHITELISTED = 'ipWhitelisted'
+# The apps:property quotaInGb of a user entry
+USER_QUOTA = 'quotaInGb'
+
+# The apps:property newEmail of a user rename request entry
+USER_NEW_EMAIL = 'newEmail'
+
+# The apps:property aliasEmail of an alias entry
+ALIAS_EMAIL = 'aliasEmail'
+
+
+class UserEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents an User in object form."""
+
+ def GetFirstName(self):
+ """Get the first name of the User object.
+
+ Returns:
+ The first name of this User object as a string or None.
+ """
+ return self._GetProperty(USER_FIRST_NAME)
+
+ def SetFirstName(self, value):
+ """Set the first name of this User object.
+
+ Args:
+ value: string The new first name to give this object.
+ """
+ self._SetProperty(USER_FIRST_NAME, value)
+
+ first_name = pyproperty(GetFirstName, SetFirstName)
+
+ def GetLastName(self):
+ """Get the last name of the User object.
+
+ Returns:
+ The last name of this User object as a string or None.
+ """
+ return self._GetProperty(USER_LAST_NAME)
+
+ def SetLastName(self, value):
+ """Set the last name of this User object.
+
+ Args:
+ value: string The new last name to give this object.
+ """
+ self._SetProperty(USER_LAST_NAME, value)
+
+ last_name = pyproperty(GetLastName, SetLastName)
+
+ def GetEmail(self):
+ """Get the email address of the User object.
+
+ Returns:
+ The email address of this User object as a string or None.
+ """
+ return self._GetProperty(USER_EMAIL)
+
+ def SetEmail(self, value):
+ """Set the email address of this User object.
+
+ Args:
+ value: string The new email address to give this object.
+ """
+ self._SetProperty(USER_EMAIL, value)
+
+ email = pyproperty(GetEmail, SetEmail)
+
+ def GetPassword(self):
+ """Get the password of the User object.
+
+ Returns:
+ The password of this User object as a string or None.
+ """
+ return self._GetProperty(USER_PASSWORD)
+
+ def SetPassword(self, value):
+ """Set the password of this User object.
+
+ Args:
+ value: string The new password to give this object.
+ """
+ self._SetProperty(USER_PASSWORD, value)
+
+ password = pyproperty(GetPassword, SetPassword)
+
+ def GetHashFunction(self):
+ """Get the hash function of the User object.
+
+ Returns:
+ The hash function of this User object as a string or None.
+ """
+ return self._GetProperty(USER_HASH_FUNCTION)
+
+ def SetHashFunction(self, value):
+ """Set the hash function of this User object.
+
+ Args:
+ value: string The new hash function to give this object.
+ """
+ self._SetProperty(USER_HASH_FUNCTION, value)
+
+ hash_function = pyproperty(GetHashFunction, SetHashFunction)
+
+ def GetChangePasswordAtNextLogin(self):
+ """Get the change password at next login flag of the User object.
+
+ Returns:
+ The change password at next login flag of this User object as a string or
+ None.
+ """
+ return self._GetProperty(USER_CHANGE_PASSWORD)
+
+ def SetChangePasswordAtNextLogin(self, value):
+ """Set the change password at next login flag of this User object.
+
+ Args:
+ value: string The new change password at next login flag to give this
+ object.
+ """
+ self._SetProperty(USER_CHANGE_PASSWORD, value)
+
+ change_password_at_next_login = pyproperty(GetChangePasswordAtNextLogin,
+ SetChangePasswordAtNextLogin)
+
+ def GetAgreedToTerms(self):
+ """Get the agreed to terms flag of the User object.
+
+ Returns:
+ The agreed to terms flag of this User object as a string or None.
+ """
+ return self._GetProperty(USER_AGREED_TO_TERMS)
+
+ agreed_to_terms = pyproperty(GetAgreedToTerms)
+
+ def GetSuspended(self):
+ """Get the suspended flag of the User object.
+
+ Returns:
+ The suspended flag of this User object as a string or None.
+ """
+ return self._GetProperty(USER_SUSPENDED)
+
+ def SetSuspended(self, value):
+ """Set the suspended flag of this User object.
+
+ Args:
+ value: string The new suspended flag to give this object.
+ """
+ self._SetProperty(USER_SUSPENDED, value)
+
+ suspended = pyproperty(GetSuspended, SetSuspended)
+
+ def GetIsAdmin(self):
+ """Get the isAdmin flag of the User object.
+
+ Returns:
+ The isAdmin flag of this User object as a string or None.
+ """
+ return self._GetProperty(USER_ADMIN)
+
+ def SetIsAdmin(self, value):
+ """Set the isAdmin flag of this User object.
+
+ Args:
+ value: string The new isAdmin flag to give this object.
+ """
+ self._SetProperty(USER_ADMIN, value)
+
+ is_admin = pyproperty(GetIsAdmin, SetIsAdmin)
+
+ def GetIpWhitelisted(self):
+ """Get the ipWhitelisted flag of the User object.
+
+ Returns:
+ The ipWhitelisted flag of this User object as a string or None.
+ """
+ return self._GetProperty(USER_IP_WHITELISTED)
+
+ def SetIpWhitelisted(self, value):
+ """Set the ipWhitelisted flag of this User object.
+
+ Args:
+ value: string The new ipWhitelisted flag to give this object.
+ """
+ self._SetProperty(USER_IP_WHITELISTED, value)
+
+ ip_whitelisted = pyproperty(GetIpWhitelisted, SetIpWhitelisted)
+
+ def GetQuota(self):
+ """Get the quota of the User object.
+
+ Returns:
+ The quota of this User object as a string or None.
+ """
+ return self._GetProperty(USER_QUOTA)
+
+ def SetQuota(self, value):
+ """Set the quota of this User object.
+
+ Args:
+ value: string The new quota to give this object.
+ """
+ self._SetProperty(USER_QUOTA, value)
+
+ quota = pyproperty(GetQuota, GetQuota)
+
+ def __init__(self, uri=None, email=None, first_name=None, last_name=None,
+ password=None, hash_function=None, change_password=None,
+ agreed_to_terms=None, suspended=None, is_admin=None,
+ ip_whitelisted=None, quota=None, *args, **kwargs):
+ """Constructs a new UserEntry object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ email: string (optional) The email address of the user.
+ first_name: string (optional) The first name of the user.
+ last_name: string (optional) The last name of the user.
+ password: string (optional) The password of the user.
+ hash_function: string (optional) The name of the function used to hash the
+ password.
+ change_password: Boolean (optional) Whether or not the user must change
+ password at first login.
+ agreed_to_terms: Boolean (optional) Whether or not the user has agreed to
+ the Terms of Service.
+ suspended: Boolean (optional) Whether or not the user is suspended.
+ is_admin: Boolean (optional) Whether or not the user has administrator
+ privileges.
+ ip_whitelisted: Boolean (optional) Whether or not the user's ip is
+ whitelisted.
+ quota: string (optional) The value (in GB) of the user's quota.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(UserEntry, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if email:
+ self.email = email
+ if first_name:
+ self.first_name = first_name
+ if last_name:
+ self.last_name = last_name
+ if password:
+ self.password = password
+ if hash_function:
+ self.hash_function = hash_function
+ if change_password is not None:
+ self.change_password_at_next_login = str(change_password)
+ if agreed_to_terms is not None:
+ self.agreed_to_terms = str(agreed_to_terms)
+ if suspended is not None:
+ self.suspended = str(suspended)
+ if is_admin is not None:
+ self.is_admin = str(is_admin)
+ if ip_whitelisted is not None:
+ self.ip_whitelisted = str(ip_whitelisted)
+ if quota:
+ self.quota = quota
+
+
+class UserFeed(gdata.data.GDFeed):
+ """Represents a feed of UserEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [UserEntry]
+
+
+class UserRenameRequest(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents an User rename request in object form."""
+
+ def GetNewEmail(self):
+ """Get the new email address for the User object.
+
+ Returns:
+ The new email address for the User object as a string or None.
+ """
+ return self._GetProperty(USER_NEW_EMAIL)
+
+ def SetNewEmail(self, value):
+ """Set the new email address for the User object.
+
+ Args:
+ value: string The new email address to give this object.
+ """
+ self._SetProperty(USER_NEW_EMAIL, value)
+
+ new_email = pyproperty(GetNewEmail, SetNewEmail)
+
+ def __init__(self, new_email=None, *args, **kwargs):
+ """Constructs a new UserRenameRequest object with the given arguments.
+
+ Args:
+ new_email: string (optional) The new email address for the target user.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(UserRenameRequest, self).__init__(*args, **kwargs)
+ if new_email:
+ self.new_email = new_email
+
+
+class AliasEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents an Alias in object form."""
+
+ def GetUserEmail(self):
+ """Get the user email address of the Alias object.
+
+ Returns:
+ The user email address of this Alias object as a string or None.
+ """
+ return self._GetProperty(USER_EMAIL)
+
+ def SetUserEmail(self, value):
+ """Set the user email address of this Alias object.
+
+ Args:
+ value: string The new user email address to give this object.
+ """
+ self._SetProperty(USER_EMAIL, value)
+
+ user_email = pyproperty(GetUserEmail, SetUserEmail)
+
+ def GetAliasEmail(self):
+ """Get the alias email address of the Alias object.
+
+ Returns:
+ The alias email address of this Alias object as a string or None.
+ """
+ return self._GetProperty(ALIAS_EMAIL)
+
+ def SetAliasEmail(self, value):
+ """Set the alias email address of this Alias object.
+
+ Args:
+ value: string The new alias email address to give this object.
+ """
+ self._SetProperty(ALIAS_EMAIL, value)
+
+ alias_email = pyproperty(GetAliasEmail, SetAliasEmail)
+
+ def __init__(self, user_email=None, alias_email=None, *args, **kwargs):
+ """Constructs a new AliasEntry object with the given arguments.
+
+ Args:
+ user_email: string (optional) The user email address for the object.
+ alias_email: string (optional) The alias email address for the object.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(AliasEntry, self).__init__(*args, **kwargs)
+ if user_email:
+ self.user_email = user_email
+ if alias_email:
+ self.alias_email = alias_email
+
+
+class AliasFeed(gdata.data.GDFeed):
+ """Represents a feed of AliasEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [AliasEntry]
diff --git a/samples/apps/marketplace_sample/gdata/apps/organization/__init__.py b/samples/apps/marketplace_sample/gdata/apps/organization/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/organization/__init__.py
diff --git a/samples/apps/marketplace_sample/gdata/apps/organization/client.py b/samples/apps/marketplace_sample/gdata/apps/organization/client.py
new file mode 100644
index 0000000..b94e767
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/organization/client.py
@@ -0,0 +1,519 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""OrganizationUnitProvisioningClient simplifies OrgUnit Provisioning API calls.
+
+OrganizationUnitProvisioningClient extends gdata.client.GDClient to ease
+interaction with the Google Organization Unit Provisioning API.
+These interactions include the ability to create, retrieve, update and delete
+organization units, move users within organization units, retrieve customerId
+and update and retrieve users in organization units.
+"""
+
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+
+import urllib
+import gdata.apps.organization.data
+import gdata.client
+
+CUSTOMER_ID_URI_TEMPLATE = '/a/feeds/customer/%s/customerId'
+
+# OrganizationUnit URI templates
+# The strings in this template are eventually replaced with the feed type
+# (orgunit/orguser), API version and Google Apps domain name, respectively.
+ORGANIZATION_UNIT_URI_TEMPLATE = '/a/feeds/%s/%s/%s'
+
+# The value for orgunit requests
+ORGANIZATION_UNIT_FEED = 'orgunit'
+# The value for orguser requests
+ORGANIZATION_USER_FEED = 'orguser'
+
+
+class OrganizationUnitProvisioningClient(gdata.client.GDClient):
+ """Client extension for the Google Org Unit Provisioning API service.
+
+ Attributes:
+ host: string The hostname for the MultiDomain Provisioning API service.
+ api_version: string The version of the MultiDomain Provisioning API.
+ """
+
+ host = 'apps-apis.google.com'
+ api_version = '2.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+ ssl = True
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the Organization Unit Provisioning API.
+
+ Args:
+ domain: string The Google Apps domain with Organization Unit
+ Provisioning.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the Organization
+ Units.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def make_organization_unit_provisioning_uri(
+ self, feed_type, customer_id, org_unit_path_or_user_email=None,
+ params=None):
+
+ """Creates a resource feed URI for the Organization Unit Provisioning API.
+
+ Using this client's Google Apps domain, create a feed URI for organization
+ unit provisioning in that domain. If an org unit path or org user email
+ address is provided, return a URI for that specific resource.
+ If params are provided, append them as GET params.
+
+ Args:
+ feed_type: string The type of feed (orgunit/orguser)
+ customer_id: string The customerId of the user.
+ org_unit_path_or_user_email: string (optional) The org unit path or
+ org user email address for which to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for organization unit provisioning for this
+ client's Google Apps domain.
+ """
+ uri = ORGANIZATION_UNIT_URI_TEMPLATE % (feed_type, self.api_version,
+ customer_id)
+ if org_unit_path_or_user_email:
+ uri += '/' + org_unit_path_or_user_email
+ if params:
+ uri += '?' + urllib.urlencode(params)
+ return uri
+
+ MakeOrganizationUnitProvisioningUri = make_organization_unit_provisioning_uri
+
+ def make_organization_unit_orgunit_provisioning_uri(self, customer_id,
+ org_unit_path=None,
+ params=None):
+ """Creates a resource feed URI for the orgunit's Provisioning API calls.
+
+ Using this client's Google Apps domain, create a feed URI for organization
+ unit orgunit's provisioning in that domain. If an org_unit_path is
+ provided, return a URI for that specific resource.
+ If params are provided, append them as GET params.
+
+ Args:
+ customer_id: string The customerId of the user.
+ org_unit_path: string (optional) The organization unit's path for which
+ to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for organization unit provisioning for
+ given org_unit_path
+ """
+ return self.make_organization_unit_provisioning_uri(
+ ORGANIZATION_UNIT_FEED, customer_id, org_unit_path, params)
+
+ MakeOrganizationUnitOrgunitProvisioningUri = make_organization_unit_orgunit_provisioning_uri
+
+ def make_organization_unit_orguser_provisioning_uri(self, customer_id,
+ org_user_email=None,
+ params=None):
+ """Creates a resource feed URI for the orguser's Provisioning API calls.
+
+ Using this client's Google Apps domain, create a feed URI for organization
+ unit orguser's provisioning in that domain. If an org_user_email is
+ provided, return a URI for that specific resource.
+ If params are provided, append them as GET params.
+
+ Args:
+ customer_id: string The customerId of the user.
+ org_user_email: string (optional) The organization unit's path for which
+ to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for organization user provisioning for
+ given org_user_email
+ """
+ return self.make_organization_unit_provisioning_uri(
+ ORGANIZATION_USER_FEED, customer_id, org_user_email, params)
+
+ MakeOrganizationUnitOrguserProvisioningUri = make_organization_unit_orguser_provisioning_uri
+
+ def make_customer_id_feed_uri(self):
+ """Creates a feed uri for retrieving customerId of the user.
+
+ Returns:
+ A string giving the URI for retrieving customerId of the user.
+ """
+ uri = CUSTOMER_ID_URI_TEMPLATE % (self.api_version)
+ return uri
+
+ MakeCustomerIdFeedUri = make_customer_id_feed_uri
+
+ def retrieve_customer_id(self, **kwargs):
+ """Retrieve the Customer ID for the customer domain.
+
+ Returns:
+ A gdata.apps.organization.data.CustomerIdEntry.
+ """
+ uri = self.MakeCustomerIdFeedUri()
+ return self.GetEntry(
+ uri,
+ desired_class=gdata.apps.organization.data.CustomerIdEntry,
+ **kwargs)
+
+ RetrieveCustomerId = retrieve_customer_id
+
+ def create_org_unit(self, customer_id, name, parent_org_unit_path='/',
+ description='', block_inheritance=False, **kwargs):
+ """Create a Organization Unit.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ name: string The simple organization unit text name, not the full path
+ name.
+ parent_org_unit_path: string The full path of the parental tree to this
+ organization unit (default: '/').
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+ description: string The human readable text description of the
+ organization unit (optional).
+ block_inheritance: boolean This parameter blocks policy setting
+ inheritance from organization units higher in
+ the organization tree (default: False).
+
+ Returns:
+ A gdata.apps.organization.data.OrgUnitEntry representing an organization
+ unit.
+ """
+ new_org_unit = gdata.apps.organization.data.OrgUnitEntry(
+ org_unit_name=name, parent_org_unit_path=parent_org_unit_path,
+ org_unit_description=description,
+ org_unit_block_inheritance=block_inheritance)
+ return self.post(
+ new_org_unit,
+ self.MakeOrganizationUnitOrgunitProvisioningUri(customer_id), **kwargs)
+
+ CreateOrgUnit = create_org_unit
+
+ def update_org_unit(self, customer_id, org_unit_path, org_unit_entry,
+ **kwargs):
+ """Update a Organization Unit.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+ org_unit_entry: gdata.apps.organization.data.OrgUnitEntry
+ The updated organization unit entry.
+
+ Returns:
+ A gdata.apps.organization.data.OrgUnitEntry representing an organization
+ unit.
+ """
+ if not org_unit_entry.GetParentOrgUnitPath():
+ org_unit_entry.SetParentOrgUnitPath('/')
+ return self.update(org_unit_entry,
+ uri=self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, org_unit_path=org_unit_path), **kwargs)
+
+ UpdateOrgUnit = update_org_unit
+
+ def move_users_to_org_unit(self, customer_id, org_unit_path, users_to_move,
+ **kwargs):
+ """Move a user to an Organization Unit.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+ users_to_move: list Email addresses of users to move in list format.
+ [Note: You can move a maximum of 25 users at one time.]
+
+ Returns:
+ A gdata.apps.organization.data.OrgUnitEntry representing
+ an organization unit.
+ """
+ org_unit_entry = self.retrieve_org_unit(customer_id, org_unit_path)
+ org_unit_entry.SetUsersToMove(', '.join(users_to_move))
+ if not org_unit_entry.GetParentOrgUnitPath():
+ org_unit_entry.SetParentOrgUnitPath('/')
+ return self.update(org_unit_entry,
+ uri=self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, org_unit_path=org_unit_path), **kwargs)
+
+ MoveUserToOrgUnit = move_users_to_org_unit
+
+ def retrieve_org_unit(self, customer_id, org_unit_path, **kwargs):
+ """Retrieve a Orgunit based on its path.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+
+ Returns:
+ A gdata.apps.organization.data.OrgUnitEntry representing
+ an organization unit.
+ """
+ uri = self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, org_unit_path=org_unit_path)
+ return self.GetEntry(
+ uri, desired_class=gdata.apps.organization.data.OrgUnitEntry, **kwargs)
+
+ RetrieveOrgUnit = retrieve_org_unit
+
+ def retrieve_feed_from_uri(self, uri, desired_class, **kwargs):
+ """Retrieve feed from given uri.
+
+ Args:
+ uri: string The uri from where to get the feed.
+ desired_class: Feed The type of feed that if to be retrieved.
+
+ Returns:
+ Feed of type desired class.
+ """
+ return self.GetFeed(uri, desired_class=desired_class, **kwargs)
+
+ RetrieveFeedFromUri = retrieve_feed_from_uri
+
+ def retrieve_all_org_units_from_uri(self, uri, **kwargs):
+ """Retrieve all OrgUnits from given uri.
+
+ Args:
+ uri: string The uri from where to get the orgunits.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUnitFeed object
+ """
+ orgunit_feed = gdata.apps.organization.data.OrgUnitFeed()
+ temp_feed = self.RetrieveFeedFromUri(
+ uri, gdata.apps.organization.data.OrgUnitFeed)
+ orgunit_feed.entry = temp_feed.entry
+ next_link = temp_feed.GetNextLink()
+ while next_link is not None:
+ uri = next_link.GetAttributes()[0].value
+ temp_feed = self.GetFeed(
+ uri, desired_class=gdata.apps.organization.data.OrgUnitFeed, **kwargs)
+ orgunit_feed.entry[0:0] = temp_feed.entry
+ next_link = temp_feed.GetNextLink()
+ return orgunit_feed
+
+ RetrieveAllOrgUnitsFromUri = retrieve_all_org_units_from_uri
+
+ def retrieve_all_org_units(self, customer_id, **kwargs):
+ """Retrieve all OrgUnits in the customer's domain.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUnitFeed object
+ """
+ uri = self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, params={'get': 'all'}, **kwargs)
+ return self.RetrieveAllOrgUnitsFromUri(uri)
+
+ RetrieveAllOrgUnits = retrieve_all_org_units
+
+ def retrieve_page_of_org_units(self, customer_id, startKey=None, **kwargs):
+ """Retrieve one page of OrgUnits in the customer's domain.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ startKey: string The key to continue for pagination through all OrgUnits.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUnitFeed object
+ """
+ uri = ''
+ if startKey is not None:
+ uri = self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, params={'get': 'all', 'startKey': startKey}, **kwargs)
+ else:
+ uri = self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, params={'get': 'all'}, **kwargs)
+ return self.GetFeed(
+ uri, desired_class=gdata.apps.organization.data.OrgUnitFeed, **kwargs)
+
+ RetrievePageOfOrgUnits = retrieve_page_of_org_units
+
+ def retrieve_sub_org_units(self, customer_id, org_unit_path, **kwargs):
+ """Retrieve all Sub-OrgUnits of the provided OrgUnit.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+
+ Returns:
+ gdata.apps.organisation.data.OrgUnitFeed object
+ """
+ uri = self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id,
+ params={'get': 'children', 'orgUnitPath': org_unit_path}, **kwargs)
+ return self.RetrieveAllOrgUnitsFromUri(uri)
+
+ RetrieveSubOrgUnits = retrieve_sub_org_units
+
+ def delete_org_unit(self, customer_id, org_unit_path, **kwargs):
+ """Delete a Orgunit based on its path.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+
+ Returns:
+ An HTTP response object. See gdata.client.request().
+ """
+ return self.delete(self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, org_unit_path=org_unit_path), **kwargs)
+
+ DeleteOrgUnit = delete_org_unit
+
+ def update_org_user(self, customer_id, user_email, org_unit_path, **kwargs):
+ """Update the OrgUnit of a OrgUser.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ user_email: string The email address of the user.
+ org_unit_path: string The new organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+
+ Returns:
+ A gdata.apps.organization.data.OrgUserEntry representing
+ an organization user.
+ """
+ old_user_entry = self.RetrieveOrgUser(customer_id, user_email)
+ old_org_unit_path = old_user_entry.GetOrgUnitPath()
+ if not old_org_unit_path:
+ old_org_unit_path = '/'
+ old_user_entry.SetOldOrgUnitPath(old_org_unit_path)
+ old_user_entry.SetOrgUnitPath(org_unit_path)
+ return self.update(old_user_entry,
+ uri=self.MakeOrganizationUnitOrguserProvisioningUri(
+ customer_id, user_email), **kwargs)
+
+ UpdateOrgUser = update_org_user
+
+ def retrieve_org_user(self, customer_id, user_email, **kwargs):
+ """Retrieve an organization user.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ user_email: string The email address of the user.
+
+ Returns:
+ A gdata.apps.organization.data.OrgUserEntry representing
+ an organization user.
+ """
+ uri = self.MakeOrganizationUnitOrguserProvisioningUri(customer_id,
+ user_email)
+ return self.GetEntry(
+ uri, desired_class=gdata.apps.organization.data.OrgUserEntry, **kwargs)
+
+ RetrieveOrgUser = retrieve_org_user
+
+ def retrieve_all_org_users_from_uri(self, uri, **kwargs):
+ """Retrieve all OrgUsers from given uri.
+
+ Args:
+ uri: string The uri from where to get the orgusers.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUserFeed object
+ """
+ orguser_feed = gdata.apps.organization.data.OrgUserFeed()
+ temp_feed = self.RetrieveFeedFromUri(
+ uri, gdata.apps.organization.data.OrgUserFeed)
+ orguser_feed.entry = temp_feed.entry
+ next_link = temp_feed.GetNextLink()
+ while next_link is not None:
+ uri = next_link.GetAttributes()[0].value
+ temp_feed = self.GetFeed(
+ uri, desired_class=gdata.apps.organization.data.OrgUserFeed, **kwargs)
+ orguser_feed.entry[0:0] = temp_feed.entry
+ next_link = temp_feed.GetNextLink()
+ return orguser_feed
+
+ RetrieveAllOrgUsersFromUri = retrieve_all_org_users_from_uri
+
+ def retrieve_all_org_users(self, customer_id, **kwargs):
+ """Retrieve all OrgUsers in the customer's domain.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUserFeed object
+ """
+ uri = self.MakeOrganizationUnitOrguserProvisioningUri(
+ customer_id, params={'get': 'all'}, **kwargs)
+ return self.RetrieveAllOrgUsersFromUri(uri)
+
+ RetrieveAllOrgUsers = retrieve_all_org_users
+
+ def retrieve_page_of_org_users(self, customer_id, startKey=None, **kwargs):
+ """Retrieve one page of OrgUsers in the customer's domain.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ startKey: The string key to continue for pagination through all OrgUnits.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUserFeed object
+ """
+ uri = ''
+ if startKey is not None:
+ uri = self.MakeOrganizationUnitOrguserProvisioningUri(
+ customer_id, params={'get': 'all', 'startKey': startKey}, **kwargs)
+ else:
+ uri = self.MakeOrganizationUnitOrguserProvisioningUri(
+ customer_id, params={'get': 'all'})
+ return self.GetFeed(
+ uri, desired_class=gdata.apps.organization.data.OrgUserFeed, **kwargs)
+
+ RetrievePageOfOrgUsers = retrieve_page_of_org_users
+
+ def retrieve_org_unit_users(self, customer_id, org_unit_path, **kwargs):
+ """Retrieve all OrgUsers of the provided OrgUnit.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+
+ Returns:
+ gdata.apps.organisation.data.OrgUserFeed object
+ """
+ uri = self.MakeOrganizationUnitOrguserProvisioningUri(
+ customer_id,
+ params={'get': 'children', 'orgUnitPath': org_unit_path})
+ return self.RetrieveAllOrgUsersFromUri(uri, **kwargs)
+
+ RetrieveOrgUnitUsers = retrieve_org_unit_users
diff --git a/samples/apps/marketplace_sample/gdata/apps/organization/data.py b/samples/apps/marketplace_sample/gdata/apps/organization/data.py
new file mode 100644
index 0000000..e750fe6
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/organization/data.py
@@ -0,0 +1,366 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for the Organization Unit Provisioning API."""
+
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+
+import gdata.apps
+import gdata.apps.apps_property_entry
+import gdata.apps_property
+import gdata.data
+
+
+# This is required to work around a naming conflict between the Google
+# Spreadsheets API and Python's built-in property function
+pyproperty = property
+
+
+# The apps:property name of an organization unit
+ORG_UNIT_NAME = 'name'
+# The apps:property orgUnitPath of an organization unit
+ORG_UNIT_PATH = 'orgUnitPath'
+# The apps:property parentOrgUnitPath of an organization unit
+PARENT_ORG_UNIT_PATH = 'parentOrgUnitPath'
+# The apps:property description of an organization unit
+ORG_UNIT_DESCRIPTION = 'description'
+# The apps:property blockInheritance of an organization unit
+ORG_UNIT_BLOCK_INHERITANCE = 'blockInheritance'
+# The apps:property userEmail of a user entry
+USER_EMAIL = 'orgUserEmail'
+# The apps:property list of users to move
+USERS_TO_MOVE = 'usersToMove'
+# The apps:property list of moved users
+MOVED_USERS = 'usersMoved'
+# The apps:property customerId for the domain
+CUSTOMER_ID = 'customerId'
+# The apps:property name of the customer org unit
+CUSTOMER_ORG_UNIT_NAME = 'customerOrgUnitName'
+# The apps:property description of the customer org unit
+CUSTOMER_ORG_UNIT_DESCRIPTION = 'customerOrgUnitDescription'
+# The apps:property old organization unit's path for a user
+OLD_ORG_UNIT_PATH = 'oldOrgUnitPath'
+
+
+class CustomerIdEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents a customerId entry in object form."""
+
+ def GetCustomerId(self):
+ """Get the customer ID of the customerId object.
+
+ Returns:
+ The customer ID of this customerId object as a string or None.
+ """
+ return self._GetProperty(CUSTOMER_ID)
+
+ customer_id = pyproperty(GetCustomerId)
+
+ def GetOrgUnitName(self):
+ """Get the Organization Unit name of the customerId object.
+
+ Returns:
+ The Organization unit name of this customerId object as a string or None.
+ """
+ return self._GetProperty(ORG_UNIT_NAME)
+
+ org_unit_name = pyproperty(GetOrgUnitName)
+
+ def GetCustomerOrgUnitName(self):
+ """Get the Customer Organization Unit name of the customerId object.
+
+ Returns:
+ The Customer Organization unit name of this customerId object as a string
+ or None.
+ """
+ return self._GetProperty(CUSTOMER_ORG_UNIT_NAME)
+
+ customer_org_unit_name = pyproperty(GetCustomerOrgUnitName)
+
+ def GetOrgUnitDescription(self):
+ """Get the Organization Unit Description of the customerId object.
+
+ Returns:
+ The Organization Unit Description of this customerId object as a string
+ or None.
+ """
+ return self._GetProperty(ORG_UNIT_DESCRIPTION)
+
+ org_unit_description = pyproperty(GetOrgUnitDescription)
+
+ def GetCustomerOrgUnitDescription(self):
+ """Get the Customer Organization Unit Description of the customerId object.
+
+ Returns:
+ The Customer Organization Unit Description of this customerId object
+ as a string or None.
+ """
+ return self._GetProperty(CUSTOMER_ORG_UNIT_DESCRIPTION)
+
+ customer_org_unit_description = pyproperty(GetCustomerOrgUnitDescription)
+
+
+class OrgUnitEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents an OrganizationUnit in object form."""
+
+ def GetOrgUnitName(self):
+ """Get the Organization Unit name of the OrganizationUnit object.
+
+ Returns:
+ The Organization unit name of this OrganizationUnit object as a string
+ or None.
+ """
+ return self._GetProperty(ORG_UNIT_NAME)
+
+ def SetOrgUnitName(self, value):
+ """Set the Organization Unit name of the OrganizationUnit object.
+
+ Args:
+ value: [string] The new Organization Unit name to give this object.
+ """
+ self._SetProperty(ORG_UNIT_NAME, value)
+
+ org_unit_name = pyproperty(GetOrgUnitName, SetOrgUnitName)
+
+ def GetOrgUnitPath(self):
+ """Get the Organization Unit Path of the OrganizationUnit object.
+
+ Returns:
+ The Organization Unit Path of this OrganizationUnit object as a string
+ or None.
+ """
+ return self._GetProperty(ORG_UNIT_PATH)
+
+ def SetOrgUnitPath(self, value):
+ """Set the Organization Unit path of the OrganizationUnit object.
+
+ Args:
+ value: [string] The new Organization Unit path to give this object.
+ """
+ self._SetProperty(ORG_UNIT_PATH, value)
+
+ org_unit_path = pyproperty(GetOrgUnitPath, SetOrgUnitPath)
+
+ def GetParentOrgUnitPath(self):
+ """Get the Parent Organization Unit Path of the OrganizationUnit object.
+
+ Returns:
+ The Parent Organization Unit Path of this OrganizationUnit object
+ as a string or None.
+ """
+ return self._GetProperty(PARENT_ORG_UNIT_PATH)
+
+ def SetParentOrgUnitPath(self, value):
+ """Set the Parent Organization Unit path of the OrganizationUnit object.
+
+ Args:
+ value: [string] The new Parent Organization Unit path
+ to give this object.
+ """
+ self._SetProperty(PARENT_ORG_UNIT_PATH, value)
+
+ parent_org_unit_path = pyproperty(GetParentOrgUnitPath, SetParentOrgUnitPath)
+
+ def GetOrgUnitDescription(self):
+ """Get the Organization Unit Description of the OrganizationUnit object.
+
+ Returns:
+ The Organization Unit Description of this OrganizationUnit object
+ as a string or None.
+ """
+ return self._GetProperty(ORG_UNIT_DESCRIPTION)
+
+ def SetOrgUnitDescription(self, value):
+ """Set the Organization Unit Description of the OrganizationUnit object.
+
+ Args:
+ value: [string] The new Organization Unit Description
+ to give this object.
+ """
+ self._SetProperty(ORG_UNIT_DESCRIPTION, value)
+
+ org_unit_description = pyproperty(GetOrgUnitDescription,
+ SetOrgUnitDescription)
+
+ def GetOrgUnitBlockInheritance(self):
+ """Get the block_inheritance flag of the OrganizationUnit object.
+
+ Returns:
+ The the block_inheritance flag of this OrganizationUnit object
+ as a string or None.
+ """
+ return self._GetProperty(ORG_UNIT_BLOCK_INHERITANCE)
+
+ def SetOrgUnitBlockInheritance(self, value):
+ """Set the block_inheritance flag of the OrganizationUnit object.
+
+ Args:
+ value: [string] The new block_inheritance flag to give this object.
+ """
+ self._SetProperty(ORG_UNIT_BLOCK_INHERITANCE, value)
+
+ org_unit_block_inheritance = pyproperty(GetOrgUnitBlockInheritance,
+ SetOrgUnitBlockInheritance)
+
+ def GetMovedUsers(self):
+ """Get the moved users of the OrganizationUnit object.
+
+ Returns:
+ The the moved users of this OrganizationUnit object as a string or None.
+ """
+ return self._GetProperty(MOVED_USERS)
+
+ def SetUsersToMove(self, value):
+ """Set the Users to Move of the OrganizationUnit object.
+
+ Args:
+ value: [string] The comma seperated list of users to move
+ to give this object.
+ """
+ self._SetProperty(USERS_TO_MOVE, value)
+
+ move_users = pyproperty(GetMovedUsers, SetUsersToMove)
+
+ def __init__(
+ self, org_unit_name=None, org_unit_path=None,
+ parent_org_unit_path=None, org_unit_description=None,
+ org_unit_block_inheritance=None, move_users=None, *args, **kwargs):
+ """Constructs a new OrganizationUnit object with the given arguments.
+
+ Args:
+ org_unit_name: string (optional) The organization unit name
+ for the object.
+ org_unit_path: string (optional) The organization unit path
+ for the object.
+ parent_org_unit_path: string (optional) The parent organization unit path
+ for the object.
+ org_unit_description: string (optional) The organization unit description
+ for the object.
+ org_unit_block_inheritance: boolean (optional) weather or not inheritance
+ from the organization unit is blocked.
+ move_users: string (optional) comma seperated list of users to move.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(OrgUnitEntry, self).__init__(*args, **kwargs)
+ if org_unit_name:
+ self.org_unit_name = org_unit_name
+ if org_unit_path:
+ self.org_unit_path = org_unit_path
+ if parent_org_unit_path:
+ self.parent_org_unit_path = parent_org_unit_path
+ if org_unit_description:
+ self.org_unit_description = org_unit_description
+ if org_unit_block_inheritance is not None:
+ self.org_unit_block_inheritance = str(org_unit_block_inheritance)
+ if move_users:
+ self.move_users = move_users
+
+
+class OrgUnitFeed(gdata.data.GDFeed):
+ """Represents a feed of OrgUnitEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [OrgUnitEntry]
+
+
+class OrgUserEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents an OrgUser in object form."""
+
+ def GetUserEmail(self):
+ """Get the user email address of the OrgUser object.
+
+ Returns:
+ The user email address of this OrgUser object as a string or None.
+ """
+ return self._GetProperty(USER_EMAIL)
+
+ def SetUserEmail(self, value):
+ """Set the user email address of this OrgUser object.
+
+ Args:
+ value: string The new user email address to give this object.
+ """
+ self._SetProperty(USER_EMAIL, value)
+
+ user_email = pyproperty(GetUserEmail, SetUserEmail)
+
+ def GetOrgUnitPath(self):
+ """Get the Organization Unit Path of the OrgUser object.
+
+ Returns:
+ The Organization Unit Path of this OrgUser object as a string or None.
+ """
+ return self._GetProperty(ORG_UNIT_PATH)
+
+ def SetOrgUnitPath(self, value):
+ """Set the Organization Unit path of the OrgUser object.
+
+ Args:
+ value: [string] The new Organization Unit path to give this object.
+ """
+ self._SetProperty(ORG_UNIT_PATH, value)
+
+ org_unit_path = pyproperty(GetOrgUnitPath, SetOrgUnitPath)
+
+ def GetOldOrgUnitPath(self):
+ """Get the Old Organization Unit Path of the OrgUser object.
+
+ Returns:
+ The Old Organization Unit Path of this OrgUser object as a string
+ or None.
+ """
+ return self._GetProperty(OLD_ORG_UNIT_PATH)
+
+ def SetOldOrgUnitPath(self, value):
+ """Set the Old Organization Unit path of the OrgUser object.
+
+ Args:
+ value: [string] The new Old Organization Unit path to give this object.
+ """
+ self._SetProperty(OLD_ORG_UNIT_PATH, value)
+
+ old_org_unit_path = pyproperty(GetOldOrgUnitPath, SetOldOrgUnitPath)
+
+ def __init__(
+ self, user_email=None, org_unit_path=None,
+ old_org_unit_path=None, *args, **kwargs):
+ """Constructs a new OrgUser object with the given arguments.
+
+ Args:
+ user_email: string (optional) The user email address for the object.
+ org_unit_path: string (optional) The organization unit path
+ for the object.
+ old_org_unit_path: string (optional) The old organization unit path
+ for the object.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(OrgUserEntry, self).__init__(*args, **kwargs)
+ if user_email:
+ self.user_email = user_email
+ if org_unit_path:
+ self.org_unit_path = org_unit_path
+ if old_org_unit_path:
+ self.old_org_unit_path = old_org_unit_path
+
+
+class OrgUserFeed(gdata.data.GDFeed):
+ """Represents a feed of OrgUserEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [OrgUserEntry]
diff --git a/samples/apps/marketplace_sample/gdata/apps/organization/service.py b/samples/apps/marketplace_sample/gdata/apps/organization/service.py
new file mode 100644
index 0000000..763a6bc
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/organization/service.py
@@ -0,0 +1,297 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Allow Google Apps domain administrators to manage organization unit and organization user.
+
+ OrganizationService: Provides methods to manage organization unit and organization user.
+"""
+
+__author__ = 'Alexandre Vivien (alex@simplecode.fr)'
+
+
+import gdata.apps
+import gdata.apps.service
+import gdata.service
+
+
+API_VER = '2.0'
+CUSTOMER_BASE_URL = '/a/feeds/customer/2.0/customerId'
+BASE_UNIT_URL = '/a/feeds/orgunit/' + API_VER + '/%s'
+UNIT_URL = BASE_UNIT_URL + '/%s'
+UNIT_ALL_URL = BASE_UNIT_URL + '?get=all'
+UNIT_CHILD_URL = BASE_UNIT_URL + '?get=children&orgUnitPath=%s'
+BASE_USER_URL = '/a/feeds/orguser/' + API_VER + '/%s'
+USER_URL = BASE_USER_URL + '/%s'
+USER_ALL_URL = BASE_USER_URL + '?get=all'
+USER_CHILD_URL = BASE_USER_URL + '?get=children&orgUnitPath=%s'
+
+
+class OrganizationService(gdata.apps.service.PropertyService):
+ """Client for the Google Apps Organizations service."""
+
+ def _Bool2Str(self, b):
+ if b is None:
+ return None
+ return str(b is True).lower()
+
+ def RetrieveCustomerId(self):
+ """Retrieve the Customer ID for the account of the authenticated administrator making this request.
+
+ Args:
+ None.
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+
+ uri = CUSTOMER_BASE_URL
+ return self._GetProperties(uri)
+
+ def CreateOrgUnit(self, customer_id, name, parent_org_unit_path='/', description='', block_inheritance=False):
+ """Create a Organization Unit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ name: The simple organization unit text name, not the full path name.
+ parent_org_unit_path: The full path of the parental tree to this organization unit (default: '/').
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+ description: The human readable text description of the organization unit (optional).
+ block_inheritance: This parameter blocks policy setting inheritance
+ from organization units higher in the organization tree (default: False).
+
+ Returns:
+ A dict containing the result of the create operation.
+ """
+
+ uri = BASE_UNIT_URL % (customer_id)
+ properties = {}
+ properties['name'] = name
+ properties['parentOrgUnitPath'] = parent_org_unit_path
+ properties['description'] = description
+ properties['blockInheritance'] = self._Bool2Str(block_inheritance)
+ return self._PostProperties(uri, properties)
+
+ def UpdateOrgUnit(self, customer_id, org_unit_path, name=None, parent_org_unit_path=None,
+ description=None, block_inheritance=None):
+ """Update a Organization Unit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+ name: The simple organization unit text name, not the full path name.
+ parent_org_unit_path: The full path of the parental tree to this organization unit.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+ description: The human readable text description of the organization unit.
+ block_inheritance: This parameter blocks policy setting inheritance
+ from organization units higher in the organization tree.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+
+ uri = UNIT_URL % (customer_id, org_unit_path)
+ properties = {}
+ if name:
+ properties['name'] = name
+ if parent_org_unit_path:
+ properties['parentOrgUnitPath'] = parent_org_unit_path
+ if description:
+ properties['description'] = description
+ if block_inheritance:
+ properties['blockInheritance'] = self._Bool2Str(block_inheritance)
+ return self._PutProperties(uri, properties)
+
+ def MoveUserToOrgUnit(self, customer_id, org_unit_path, users_to_move):
+ """Move a user to an Organization Unit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+ users_to_move: Email addresses list of users to move. Note: You can move a maximum of 25 users at one time.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+
+ uri = UNIT_URL % (customer_id, org_unit_path)
+ properties = {}
+ if users_to_move and isinstance(users_to_move, list):
+ properties['usersToMove'] = ', '.join(users_to_move)
+ return self._PutProperties(uri, properties)
+
+ def RetrieveOrgUnit(self, customer_id, org_unit_path):
+ """Retrieve a Orgunit based on its path.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+ uri = UNIT_URL % (customer_id, org_unit_path)
+ return self._GetProperties(uri)
+
+ def DeleteOrgUnit(self, customer_id, org_unit_path):
+ """Delete a Orgunit based on its path.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+
+ Returns:
+ A dict containing the result of the delete operation.
+ """
+ uri = UNIT_URL % (customer_id, org_unit_path)
+ return self._DeleteProperties(uri)
+
+ def RetrieveAllOrgUnits(self, customer_id):
+ """Retrieve all OrgUnits in the customer's domain.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = UNIT_ALL_URL % (customer_id)
+ return self._GetPropertiesList(uri)
+
+ def RetrievePageOfOrgUnits(self, customer_id, startKey=None):
+ """Retrieve one page of OrgUnits in the customer's domain.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ startKey: The key to continue for pagination through all OrgUnits.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+ uri = UNIT_ALL_URL % (customer_id)
+ if startKey is not None:
+ uri += "&startKey=" + startKey
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
+
+ def RetrieveSubOrgUnits(self, customer_id, org_unit_path):
+ """Retrieve all Sub-OrgUnits of the provided OrgUnit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = UNIT_CHILD_URL % (customer_id, org_unit_path)
+ return self._GetPropertiesList(uri)
+
+ def RetrieveOrgUser(self, customer_id, user_email):
+ """Retrieve the OrgUnit of the user.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ user_email: The email address of the user.
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+ uri = USER_URL % (customer_id, user_email)
+ return self._GetProperties(uri)
+
+ def UpdateOrgUser(self, customer_id, user_email, org_unit_path):
+ """Update the OrgUnit of a OrgUser.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ user_email: The email address of the user.
+ org_unit_path: The new organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+
+ uri = USER_URL % (customer_id, user_email)
+ properties = {}
+ if org_unit_path:
+ properties['orgUnitPath'] = org_unit_path
+ return self._PutProperties(uri, properties)
+
+ def RetrieveAllOrgUsers(self, customer_id):
+ """Retrieve all OrgUsers in the customer's domain.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = USER_ALL_URL % (customer_id)
+ return self._GetPropertiesList(uri)
+
+ def RetrievePageOfOrgUsers(self, customer_id, startKey=None):
+ """Retrieve one page of OrgUsers in the customer's domain.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ startKey: The key to continue for pagination through all OrgUnits.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+ uri = USER_ALL_URL % (customer_id)
+ if startKey is not None:
+ uri += "&startKey=" + startKey
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
+
+ def RetrieveOrgUnitUsers(self, customer_id, org_unit_path):
+ """Retrieve all OrgUsers of the provided OrgUnit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = USER_CHILD_URL % (customer_id, org_unit_path)
+ return self._GetPropertiesList(uri)
+
+ def RetrieveOrgUnitPageOfUsers(self, customer_id, org_unit_path, startKey=None):
+ """Retrieve one page of OrgUsers of the provided OrgUnit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+ startKey: The key to continue for pagination through all OrgUsers.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+ uri = USER_CHILD_URL % (customer_id, org_unit_path)
+ if startKey is not None:
+ uri += "&startKey=" + startKey
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
diff --git a/samples/apps/marketplace_sample/gdata/apps/service.py b/samples/apps/marketplace_sample/gdata/apps/service.py
new file mode 100644
index 0000000..bc97484
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps/service.py
@@ -0,0 +1,552 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 SIOS Technology, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'tmatsuo@sios.com (Takashi MATSUO)'
+
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import urllib
+import gdata
+import atom.service
+import gdata.service
+import gdata.apps
+import atom
+
+API_VER="2.0"
+HTTP_OK=200
+
+UNKOWN_ERROR=1000
+USER_DELETED_RECENTLY=1100
+USER_SUSPENDED=1101
+DOMAIN_USER_LIMIT_EXCEEDED=1200
+DOMAIN_ALIAS_LIMIT_EXCEEDED=1201
+DOMAIN_SUSPENDED=1202
+DOMAIN_FEATURE_UNAVAILABLE=1203
+ENTITY_EXISTS=1300
+ENTITY_DOES_NOT_EXIST=1301
+ENTITY_NAME_IS_RESERVED=1302
+ENTITY_NAME_NOT_VALID=1303
+INVALID_GIVEN_NAME=1400
+INVALID_FAMILY_NAME=1401
+INVALID_PASSWORD=1402
+INVALID_USERNAME=1403
+INVALID_HASH_FUNCTION_NAME=1404
+INVALID_HASH_DIGGEST_LENGTH=1405
+INVALID_EMAIL_ADDRESS=1406
+INVALID_QUERY_PARAMETER_VALUE=1407
+TOO_MANY_RECIPIENTS_ON_EMAIL_LIST=1500
+
+DEFAULT_QUOTA_LIMIT='2048'
+
+
+class Error(Exception):
+ pass
+
+
+class AppsForYourDomainException(Error):
+
+ def __init__(self, response):
+
+ Error.__init__(self, response)
+ try:
+ self.element_tree = ElementTree.fromstring(response['body'])
+ self.error_code = int(self.element_tree[0].attrib['errorCode'])
+ self.reason = self.element_tree[0].attrib['reason']
+ self.invalidInput = self.element_tree[0].attrib['invalidInput']
+ except:
+ self.error_code = UNKOWN_ERROR
+
+
+class AppsService(gdata.service.GDataService):
+ """Client for the Google Apps Provisioning service."""
+
+ def __init__(self, email=None, password=None, domain=None, source=None,
+ server='apps-apis.google.com', additional_headers=None,
+ **kwargs):
+ """Creates a client for the Google Apps Provisioning service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ domain: string (optional) The Google Apps domain name.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'apps-apis.google.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='apps', source=source,
+ server=server, additional_headers=additional_headers, **kwargs)
+ self.ssl = True
+ self.port = 443
+ self.domain = domain
+
+ def _baseURL(self):
+ return "/a/feeds/%s" % self.domain
+
+ def AddAllElementsFromAllPages(self, link_finder, func):
+ """retrieve all pages and add all elements"""
+ next = link_finder.GetNextLink()
+ while next is not None:
+ next_feed = self.Get(next.href, converter=func)
+ for a_entry in next_feed.entry:
+ link_finder.entry.append(a_entry)
+ next = next_feed.GetNextLink()
+ return link_finder
+
+ def RetrievePageOfEmailLists(self, start_email_list_name=None,
+ num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY,
+ backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve one page of email list"""
+ uri = "%s/emailList/%s" % (self._baseURL(), API_VER)
+ if start_email_list_name is not None:
+ uri += "?startEmailListName=%s" % start_email_list_name
+ try:
+ return gdata.apps.EmailListFeedFromString(str(self.GetWithRetries(
+ uri, num_retries=num_retries, delay=delay, backoff=backoff)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def GetGeneratorForAllEmailLists(
+ self, num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY, backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve a generator for all emaillists in this domain."""
+ first_page = self.RetrievePageOfEmailLists(num_retries=num_retries,
+ delay=delay,
+ backoff=backoff)
+ return self.GetGeneratorFromLinkFinder(
+ first_page, gdata.apps.EmailListRecipientFeedFromString,
+ num_retries=num_retries, delay=delay, backoff=backoff)
+
+ def RetrieveAllEmailLists(self):
+ """Retrieve all email list of a domain."""
+
+ ret = self.RetrievePageOfEmailLists()
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.EmailListFeedFromString)
+
+ def RetrieveEmailList(self, list_name):
+ """Retreive a single email list by the list's name."""
+
+ uri = "%s/emailList/%s/%s" % (
+ self._baseURL(), API_VER, list_name)
+ try:
+ return self.Get(uri, converter=gdata.apps.EmailListEntryFromString)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def RetrieveEmailLists(self, recipient):
+ """Retrieve All Email List Subscriptions for an Email Address."""
+
+ uri = "%s/emailList/%s?recipient=%s" % (
+ self._baseURL(), API_VER, recipient)
+ try:
+ ret = gdata.apps.EmailListFeedFromString(str(self.Get(uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.EmailListFeedFromString)
+
+ def RemoveRecipientFromEmailList(self, recipient, list_name):
+ """Remove recipient from email list."""
+
+ uri = "%s/emailList/%s/%s/recipient/%s" % (
+ self._baseURL(), API_VER, list_name, recipient)
+ try:
+ self.Delete(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def RetrievePageOfRecipients(self, list_name, start_recipient=None,
+ num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY,
+ backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve one page of recipient of an email list. """
+
+ uri = "%s/emailList/%s/%s/recipient" % (
+ self._baseURL(), API_VER, list_name)
+
+ if start_recipient is not None:
+ uri += "?startRecipient=%s" % start_recipient
+ try:
+ return gdata.apps.EmailListRecipientFeedFromString(str(
+ self.GetWithRetries(
+ uri, num_retries=num_retries, delay=delay, backoff=backoff)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def GetGeneratorForAllRecipients(
+ self, list_name, num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY, backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve a generator for all recipients of a particular emaillist."""
+ first_page = self.RetrievePageOfRecipients(list_name,
+ num_retries=num_retries,
+ delay=delay,
+ backoff=backoff)
+ return self.GetGeneratorFromLinkFinder(
+ first_page, gdata.apps.EmailListRecipientFeedFromString,
+ num_retries=num_retries, delay=delay, backoff=backoff)
+
+ def RetrieveAllRecipients(self, list_name):
+ """Retrieve all recipient of an email list."""
+
+ ret = self.RetrievePageOfRecipients(list_name)
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.EmailListRecipientFeedFromString)
+
+ def AddRecipientToEmailList(self, recipient, list_name):
+ """Add a recipient to a email list."""
+
+ uri = "%s/emailList/%s/%s/recipient" % (
+ self._baseURL(), API_VER, list_name)
+ recipient_entry = gdata.apps.EmailListRecipientEntry()
+ recipient_entry.who = gdata.apps.Who(email=recipient)
+
+ try:
+ return gdata.apps.EmailListRecipientEntryFromString(
+ str(self.Post(recipient_entry, uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def DeleteEmailList(self, list_name):
+ """Delete a email list"""
+
+ uri = "%s/emailList/%s/%s" % (self._baseURL(), API_VER, list_name)
+ try:
+ self.Delete(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def CreateEmailList(self, list_name):
+ """Create a email list. """
+
+ uri = "%s/emailList/%s" % (self._baseURL(), API_VER)
+ email_list_entry = gdata.apps.EmailListEntry()
+ email_list_entry.email_list = gdata.apps.EmailList(name=list_name)
+ try:
+ return gdata.apps.EmailListEntryFromString(
+ str(self.Post(email_list_entry, uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def DeleteNickname(self, nickname):
+ """Delete a nickname"""
+
+ uri = "%s/nickname/%s/%s" % (self._baseURL(), API_VER, nickname)
+ try:
+ self.Delete(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def RetrievePageOfNicknames(self, start_nickname=None,
+ num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY,
+ backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve one page of nicknames in the domain"""
+
+ uri = "%s/nickname/%s" % (self._baseURL(), API_VER)
+ if start_nickname is not None:
+ uri += "?startNickname=%s" % start_nickname
+ try:
+ return gdata.apps.NicknameFeedFromString(str(self.GetWithRetries(
+ uri, num_retries=num_retries, delay=delay, backoff=backoff)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def GetGeneratorForAllNicknames(
+ self, num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY, backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve a generator for all nicknames in this domain."""
+ first_page = self.RetrievePageOfNicknames(num_retries=num_retries,
+ delay=delay,
+ backoff=backoff)
+ return self.GetGeneratorFromLinkFinder(
+ first_page, gdata.apps.NicknameFeedFromString, num_retries=num_retries,
+ delay=delay, backoff=backoff)
+
+ def RetrieveAllNicknames(self):
+ """Retrieve all nicknames in the domain"""
+
+ ret = self.RetrievePageOfNicknames()
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.NicknameFeedFromString)
+
+ def GetGeneratorForAllNicknamesOfAUser(
+ self, user_name, num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY, backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve a generator for all nicknames of a particular user."""
+ uri = "%s/nickname/%s?username=%s" % (self._baseURL(), API_VER, user_name)
+ try:
+ first_page = gdata.apps.NicknameFeedFromString(str(self.GetWithRetries(
+ uri, num_retries=num_retries, delay=delay, backoff=backoff)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+ return self.GetGeneratorFromLinkFinder(
+ first_page, gdata.apps.NicknameFeedFromString, num_retries=num_retries,
+ delay=delay, backoff=backoff)
+
+ def RetrieveNicknames(self, user_name):
+ """Retrieve nicknames of the user"""
+
+ uri = "%s/nickname/%s?username=%s" % (self._baseURL(), API_VER, user_name)
+ try:
+ ret = gdata.apps.NicknameFeedFromString(str(self.Get(uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.NicknameFeedFromString)
+
+ def RetrieveNickname(self, nickname):
+ """Retrieve a nickname.
+
+ Args:
+ nickname: string The nickname to retrieve
+
+ Returns:
+ gdata.apps.NicknameEntry
+ """
+
+ uri = "%s/nickname/%s/%s" % (self._baseURL(), API_VER, nickname)
+ try:
+ return gdata.apps.NicknameEntryFromString(str(self.Get(uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def CreateNickname(self, user_name, nickname):
+ """Create a nickname"""
+
+ uri = "%s/nickname/%s" % (self._baseURL(), API_VER)
+ nickname_entry = gdata.apps.NicknameEntry()
+ nickname_entry.login = gdata.apps.Login(user_name=user_name)
+ nickname_entry.nickname = gdata.apps.Nickname(name=nickname)
+
+ try:
+ return gdata.apps.NicknameEntryFromString(
+ str(self.Post(nickname_entry, uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def DeleteUser(self, user_name):
+ """Delete a user account"""
+
+ uri = "%s/user/%s/%s" % (self._baseURL(), API_VER, user_name)
+ try:
+ return self.Delete(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def UpdateUser(self, user_name, user_entry):
+ """Update a user account."""
+
+ uri = "%s/user/%s/%s" % (self._baseURL(), API_VER, user_name)
+ try:
+ return gdata.apps.UserEntryFromString(str(self.Put(user_entry, uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def CreateUser(self, user_name, family_name, given_name, password,
+ suspended='false', quota_limit=None,
+ password_hash_function=None,
+ change_password=None):
+ """Create a user account. """
+
+ uri = "%s/user/%s" % (self._baseURL(), API_VER)
+ user_entry = gdata.apps.UserEntry()
+ user_entry.login = gdata.apps.Login(
+ user_name=user_name, password=password, suspended=suspended,
+ hash_function_name=password_hash_function,
+ change_password=change_password)
+ user_entry.name = gdata.apps.Name(family_name=family_name,
+ given_name=given_name)
+ if quota_limit is not None:
+ user_entry.quota = gdata.apps.Quota(limit=str(quota_limit))
+
+ try:
+ return gdata.apps.UserEntryFromString(str(self.Post(user_entry, uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def SuspendUser(self, user_name):
+ user_entry = self.RetrieveUser(user_name)
+ if user_entry.login.suspended != 'true':
+ user_entry.login.suspended = 'true'
+ user_entry = self.UpdateUser(user_name, user_entry)
+ return user_entry
+
+ def RestoreUser(self, user_name):
+ user_entry = self.RetrieveUser(user_name)
+ if user_entry.login.suspended != 'false':
+ user_entry.login.suspended = 'false'
+ user_entry = self.UpdateUser(user_name, user_entry)
+ return user_entry
+
+ def RetrieveUser(self, user_name):
+ """Retrieve an user account.
+
+ Args:
+ user_name: string The user name to retrieve
+
+ Returns:
+ gdata.apps.UserEntry
+ """
+
+ uri = "%s/user/%s/%s" % (self._baseURL(), API_VER, user_name)
+ try:
+ return gdata.apps.UserEntryFromString(str(self.Get(uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def RetrievePageOfUsers(self, start_username=None,
+ num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY,
+ backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve one page of users in this domain."""
+
+ uri = "%s/user/%s" % (self._baseURL(), API_VER)
+ if start_username is not None:
+ uri += "?startUsername=%s" % start_username
+ try:
+ return gdata.apps.UserFeedFromString(str(self.GetWithRetries(
+ uri, num_retries=num_retries, delay=delay, backoff=backoff)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def GetGeneratorForAllUsers(self,
+ num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY,
+ backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve a generator for all users in this domain."""
+ first_page = self.RetrievePageOfUsers(num_retries=num_retries, delay=delay,
+ backoff=backoff)
+ return self.GetGeneratorFromLinkFinder(
+ first_page, gdata.apps.UserFeedFromString, num_retries=num_retries,
+ delay=delay, backoff=backoff)
+
+ def RetrieveAllUsers(self):
+ """Retrieve all users in this domain. OBSOLETE"""
+
+ ret = self.RetrievePageOfUsers()
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.UserFeedFromString)
+
+
+class PropertyService(gdata.service.GDataService):
+ """Client for the Google Apps Property service."""
+
+ def __init__(self, email=None, password=None, domain=None, source=None,
+ server='apps-apis.google.com', additional_headers=None):
+ gdata.service.GDataService.__init__(self, email=email, password=password,
+ service='apps', source=source,
+ server=server,
+ additional_headers=additional_headers)
+ self.ssl = True
+ self.port = 443
+ self.domain = domain
+
+ def AddAllElementsFromAllPages(self, link_finder, func):
+ """retrieve all pages and add all elements"""
+ next = link_finder.GetNextLink()
+ while next is not None:
+ next_feed = self.Get(next.href, converter=func)
+ for a_entry in next_feed.entry:
+ link_finder.entry.append(a_entry)
+ next = next_feed.GetNextLink()
+ return link_finder
+
+ def _GetPropertyEntry(self, properties):
+ property_entry = gdata.apps.PropertyEntry()
+ property = []
+ for name, value in properties.iteritems():
+ if name is not None and value is not None:
+ property.append(gdata.apps.Property(name=name, value=value))
+ property_entry.property = property
+ return property_entry
+
+ def _PropertyEntry2Dict(self, property_entry):
+ properties = {}
+ for i, property in enumerate(property_entry.property):
+ properties[property.name] = property.value
+ return properties
+
+ def _GetPropertyFeed(self, uri):
+ try:
+ return gdata.apps.PropertyFeedFromString(str(self.Get(uri)))
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ def _GetPropertiesList(self, uri):
+ property_feed = self._GetPropertyFeed(uri)
+ # pagination
+ property_feed = self.AddAllElementsFromAllPages(
+ property_feed, gdata.apps.PropertyFeedFromString)
+ properties_list = []
+ for property_entry in property_feed.entry:
+ properties_list.append(self._PropertyEntry2Dict(property_entry))
+ return properties_list
+
+ def _GetProperties(self, uri):
+ try:
+ return self._PropertyEntry2Dict(gdata.apps.PropertyEntryFromString(
+ str(self.Get(uri))))
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ def _PostProperties(self, uri, properties):
+ property_entry = self._GetPropertyEntry(properties)
+ try:
+ return self._PropertyEntry2Dict(gdata.apps.PropertyEntryFromString(
+ str(self.Post(property_entry, uri))))
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ def _PutProperties(self, uri, properties):
+ property_entry = self._GetPropertyEntry(properties)
+ try:
+ return self._PropertyEntry2Dict(gdata.apps.PropertyEntryFromString(
+ str(self.Put(property_entry, uri))))
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ def _DeleteProperties(self, uri):
+ try:
+ self.Delete(uri)
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+
+def _bool2str(b):
+ if b is None:
+ return None
+ return str(b is True).lower()
diff --git a/samples/apps/marketplace_sample/gdata/apps_property.py b/samples/apps/marketplace_sample/gdata/apps_property.py
new file mode 100644
index 0000000..5afa1f3
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/apps_property.py
@@ -0,0 +1,39 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2010 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+"""Provides a base class to represent property elements in feeds.
+
+This module is used for version 2 of the Google Data APIs. The primary class
+in this module is AppsProperty.
+"""
+
+
+__author__ = 'Vic Fryzel <vicfryzel@google.com>'
+
+
+import atom.core
+import gdata.apps
+
+
+class AppsProperty(atom.core.XmlElement):
+ """Represents an <apps:property> element in a feed."""
+ _qname = gdata.apps.APPS_TEMPLATE % 'property'
+ name = 'name'
+ value = 'value'
diff --git a/samples/apps/marketplace_sample/gdata/auth.py b/samples/apps/marketplace_sample/gdata/auth.py
new file mode 100644
index 0000000..1d7c2af
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/auth.py
@@ -0,0 +1,958 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 - 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import cgi
+import math
+import random
+import re
+import time
+import types
+import urllib
+import atom.http_interface
+import atom.token_store
+import atom.url
+import gdata.oauth as oauth
+import gdata.oauth.rsa as oauth_rsa
+try:
+ import gdata.tlslite.utils.keyfactory as keyfactory
+except ImportError:
+ from tlslite.tlslite.utils import keyfactory
+try:
+ import gdata.tlslite.utils.cryptomath as cryptomath
+except ImportError:
+ from tlslite.tlslite.utils import cryptomath
+
+import gdata.gauth
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+PROGRAMMATIC_AUTH_LABEL = 'GoogleLogin auth='
+AUTHSUB_AUTH_LABEL = 'AuthSub token='
+
+
+"""This module provides functions and objects used with Google authentication.
+
+Details on Google authorization mechanisms used with the Google Data APIs can
+be found here:
+http://code.google.com/apis/gdata/auth.html
+http://code.google.com/apis/accounts/
+
+The essential functions are the following.
+Related to ClientLogin:
+ generate_client_login_request_body: Constructs the body of an HTTP request to
+ obtain a ClientLogin token for a specific
+ service.
+ extract_client_login_token: Creates a ClientLoginToken with the token from a
+ success response to a ClientLogin request.
+ get_captcha_challenge: If the server responded to the ClientLogin request
+ with a CAPTCHA challenge, this method extracts the
+ CAPTCHA URL and identifying CAPTCHA token.
+
+Related to AuthSub:
+ generate_auth_sub_url: Constructs a full URL for a AuthSub request. The
+ user's browser must be sent to this Google Accounts
+ URL and redirected back to the app to obtain the
+ AuthSub token.
+ extract_auth_sub_token_from_url: Once the user's browser has been
+ redirected back to the web app, use this
+ function to create an AuthSubToken with
+ the correct authorization token and scope.
+ token_from_http_body: Extracts the AuthSubToken value string from the
+ server's response to an AuthSub session token upgrade
+ request.
+"""
+
+def generate_client_login_request_body(email, password, service, source,
+ account_type='HOSTED_OR_GOOGLE', captcha_token=None,
+ captcha_response=None):
+ """Creates the body of the autentication request
+
+ See http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request
+ for more details.
+
+ Args:
+ email: str
+ password: str
+ service: str
+ source: str
+ account_type: str (optional) Defaul is 'HOSTED_OR_GOOGLE', other valid
+ values are 'GOOGLE' and 'HOSTED'
+ captcha_token: str (optional)
+ captcha_response: str (optional)
+
+ Returns:
+ The HTTP body to send in a request for a client login token.
+ """
+ return gdata.gauth.generate_client_login_request_body(email, password,
+ service, source, account_type, captcha_token, captcha_response)
+
+
+GenerateClientLoginRequestBody = generate_client_login_request_body
+
+
+def GenerateClientLoginAuthToken(http_body):
+ """Returns the token value to use in Authorization headers.
+
+ Reads the token from the server's response to a Client Login request and
+ creates header value to use in requests.
+
+ Args:
+ http_body: str The body of the server's HTTP response to a Client Login
+ request
+
+ Returns:
+ The value half of an Authorization header.
+ """
+ token = get_client_login_token(http_body)
+ if token:
+ return 'GoogleLogin auth=%s' % token
+ return None
+
+
+def get_client_login_token(http_body):
+ """Returns the token value for a ClientLoginToken.
+
+ Reads the token from the server's response to a Client Login request and
+ creates the token value string to use in requests.
+
+ Args:
+ http_body: str The body of the server's HTTP response to a Client Login
+ request
+
+ Returns:
+ The token value string for a ClientLoginToken.
+ """
+ return gdata.gauth.get_client_login_token_string(http_body)
+
+
+def extract_client_login_token(http_body, scopes):
+ """Parses the server's response and returns a ClientLoginToken.
+
+ Args:
+ http_body: str The body of the server's HTTP response to a Client Login
+ request. It is assumed that the login request was successful.
+ scopes: list containing atom.url.Urls or strs. The scopes list contains
+ all of the partial URLs under which the client login token is
+ valid. For example, if scopes contains ['http://example.com/foo']
+ then the client login token would be valid for
+ http://example.com/foo/bar/baz
+
+ Returns:
+ A ClientLoginToken which is valid for the specified scopes.
+ """
+ token_string = get_client_login_token(http_body)
+ token = ClientLoginToken(scopes=scopes)
+ token.set_token_string(token_string)
+ return token
+
+
+def get_captcha_challenge(http_body,
+ captcha_base_url='http://www.google.com/accounts/'):
+ """Returns the URL and token for a CAPTCHA challenge issued by the server.
+
+ Args:
+ http_body: str The body of the HTTP response from the server which
+ contains the CAPTCHA challenge.
+ captcha_base_url: str This function returns a full URL for viewing the
+ challenge image which is built from the server's response. This
+ base_url is used as the beginning of the URL because the server
+ only provides the end of the URL. For example the server provides
+ 'Captcha?ctoken=Hi...N' and the URL for the image is
+ 'http://www.google.com/accounts/Captcha?ctoken=Hi...N'
+
+ Returns:
+ A dictionary containing the information needed to repond to the CAPTCHA
+ challenge, the image URL and the ID token of the challenge. The
+ dictionary is in the form:
+ {'token': string identifying the CAPTCHA image,
+ 'url': string containing the URL of the image}
+ Returns None if there was no CAPTCHA challenge in the response.
+ """
+ return gdata.gauth.get_captcha_challenge(http_body, captcha_base_url)
+
+
+GetCaptchaChallenge = get_captcha_challenge
+
+
+def GenerateOAuthRequestTokenUrl(
+ oauth_input_params, scopes,
+ request_token_url='https://www.google.com/accounts/OAuthGetRequestToken',
+ extra_parameters=None):
+ """Generate a URL at which a request for OAuth request token is to be sent.
+
+ Args:
+ oauth_input_params: OAuthInputParams OAuth input parameters.
+ scopes: list of strings The URLs of the services to be accessed.
+ request_token_url: string The beginning of the request token URL. This is
+ normally 'https://www.google.com/accounts/OAuthGetRequestToken' or
+ '/accounts/OAuthGetRequestToken'
+ extra_parameters: dict (optional) key-value pairs as any additional
+ parameters to be included in the URL and signature while making a
+ request for fetching an OAuth request token. All the OAuth parameters
+ are added by default. But if provided through this argument, any
+ default parameters will be overwritten. For e.g. a default parameter
+ oauth_version 1.0 can be overwritten if
+ extra_parameters = {'oauth_version': '2.0'}
+
+ Returns:
+ atom.url.Url OAuth request token URL.
+ """
+ scopes_string = ' '.join([str(scope) for scope in scopes])
+ parameters = {'scope': scopes_string}
+ if extra_parameters:
+ parameters.update(extra_parameters)
+ oauth_request = oauth.OAuthRequest.from_consumer_and_token(
+ oauth_input_params.GetConsumer(), http_url=request_token_url,
+ parameters=parameters)
+ oauth_request.sign_request(oauth_input_params.GetSignatureMethod(),
+ oauth_input_params.GetConsumer(), None)
+ return atom.url.parse_url(oauth_request.to_url())
+
+
+def GenerateOAuthAuthorizationUrl(
+ request_token,
+ authorization_url='https://www.google.com/accounts/OAuthAuthorizeToken',
+ callback_url=None, extra_params=None,
+ include_scopes_in_callback=False, scopes_param_prefix='oauth_token_scope'):
+ """Generates URL at which user will login to authorize the request token.
+
+ Args:
+ request_token: gdata.auth.OAuthToken OAuth request token.
+ authorization_url: string The beginning of the authorization URL. This is
+ normally 'https://www.google.com/accounts/OAuthAuthorizeToken' or
+ '/accounts/OAuthAuthorizeToken'
+ callback_url: string (optional) The URL user will be sent to after
+ logging in and granting access.
+ extra_params: dict (optional) Additional parameters to be sent.
+ include_scopes_in_callback: Boolean (default=False) if set to True, and
+ if 'callback_url' is present, the 'callback_url' will be modified to
+ include the scope(s) from the request token as a URL parameter. The
+ key for the 'callback' URL's scope parameter will be
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as
+ a parameter to the 'callback' URL, is that the page which receives
+ the OAuth token will be able to tell which URLs the token grants
+ access to.
+ scopes_param_prefix: string (default='oauth_token_scope') The URL
+ parameter key which maps to the list of valid scopes for the token.
+ This URL parameter will be included in the callback URL along with
+ the scopes of the token as value if include_scopes_in_callback=True.
+
+ Returns:
+ atom.url.Url OAuth authorization URL.
+ """
+ scopes = request_token.scopes
+ if isinstance(scopes, list):
+ scopes = ' '.join(scopes)
+ if include_scopes_in_callback and callback_url:
+ if callback_url.find('?') > -1:
+ callback_url += '&'
+ else:
+ callback_url += '?'
+ callback_url += urllib.urlencode({scopes_param_prefix:scopes})
+ oauth_token = oauth.OAuthToken(request_token.key, request_token.secret)
+ oauth_request = oauth.OAuthRequest.from_token_and_callback(
+ token=oauth_token, callback=callback_url,
+ http_url=authorization_url, parameters=extra_params)
+ return atom.url.parse_url(oauth_request.to_url())
+
+
+def GenerateOAuthAccessTokenUrl(
+ authorized_request_token,
+ oauth_input_params,
+ access_token_url='https://www.google.com/accounts/OAuthGetAccessToken',
+ oauth_version='1.0',
+ oauth_verifier=None):
+ """Generates URL at which user will login to authorize the request token.
+
+ Args:
+ authorized_request_token: gdata.auth.OAuthToken OAuth authorized request
+ token.
+ oauth_input_params: OAuthInputParams OAuth input parameters.
+ access_token_url: string The beginning of the authorization URL. This is
+ normally 'https://www.google.com/accounts/OAuthGetAccessToken' or
+ '/accounts/OAuthGetAccessToken'
+ oauth_version: str (default='1.0') oauth_version parameter.
+ oauth_verifier: str (optional) If present, it is assumed that the client
+ will use the OAuth v1.0a protocol which includes passing the
+ oauth_verifier (as returned by the SP) in the access token step.
+
+ Returns:
+ atom.url.Url OAuth access token URL.
+ """
+ oauth_token = oauth.OAuthToken(authorized_request_token.key,
+ authorized_request_token.secret)
+ parameters = {'oauth_version': oauth_version}
+ if oauth_verifier is not None:
+ parameters['oauth_verifier'] = oauth_verifier
+ oauth_request = oauth.OAuthRequest.from_consumer_and_token(
+ oauth_input_params.GetConsumer(), token=oauth_token,
+ http_url=access_token_url, parameters=parameters)
+ oauth_request.sign_request(oauth_input_params.GetSignatureMethod(),
+ oauth_input_params.GetConsumer(), oauth_token)
+ return atom.url.parse_url(oauth_request.to_url())
+
+
+def GenerateAuthSubUrl(next, scope, secure=False, session=True,
+ request_url='https://www.google.com/accounts/AuthSubRequest',
+ domain='default'):
+ """Generate a URL at which the user will login and be redirected back.
+
+ Users enter their credentials on a Google login page and a token is sent
+ to the URL specified in next. See documentation for AuthSub login at:
+ http://code.google.com/apis/accounts/AuthForWebApps.html
+
+ Args:
+ request_url: str The beginning of the request URL. This is normally
+ 'http://www.google.com/accounts/AuthSubRequest' or
+ '/accounts/AuthSubRequest'
+ next: string The URL user will be sent to after logging in.
+ scope: string The URL of the service to be accessed.
+ secure: boolean (optional) Determines whether or not the issued token
+ is a secure token.
+ session: boolean (optional) Determines whether or not the issued token
+ can be upgraded to a session token.
+ domain: str (optional) The Google Apps domain for this account. If this
+ is not a Google Apps account, use 'default' which is the default
+ value.
+ """
+ # Translate True/False values for parameters into numeric values acceoted
+ # by the AuthSub service.
+ if secure:
+ secure = 1
+ else:
+ secure = 0
+
+ if session:
+ session = 1
+ else:
+ session = 0
+
+ request_params = urllib.urlencode({'next': next, 'scope': scope,
+ 'secure': secure, 'session': session,
+ 'hd': domain})
+ if request_url.find('?') == -1:
+ return '%s?%s' % (request_url, request_params)
+ else:
+ # The request URL already contained url parameters so we should add
+ # the parameters using the & seperator
+ return '%s&%s' % (request_url, request_params)
+
+
+def generate_auth_sub_url(next, scopes, secure=False, session=True,
+ request_url='https://www.google.com/accounts/AuthSubRequest',
+ domain='default', scopes_param_prefix='auth_sub_scopes'):
+ """Constructs a URL string for requesting a multiscope AuthSub token.
+
+ The generated token will contain a URL parameter to pass along the
+ requested scopes to the next URL. When the Google Accounts page
+ redirects the broswser to the 'next' URL, it appends the single use
+ AuthSub token value to the URL as a URL parameter with the key 'token'.
+ However, the information about which scopes were requested is not
+ included by Google Accounts. This method adds the scopes to the next
+ URL before making the request so that the redirect will be sent to
+ a page, and both the token value and the list of scopes can be
+ extracted from the request URL.
+
+ Args:
+ next: atom.url.URL or string The URL user will be sent to after
+ authorizing this web application to access their data.
+ scopes: list containint strings The URLs of the services to be accessed.
+ secure: boolean (optional) Determines whether or not the issued token
+ is a secure token.
+ session: boolean (optional) Determines whether or not the issued token
+ can be upgraded to a session token.
+ request_url: atom.url.Url or str The beginning of the request URL. This
+ is normally 'http://www.google.com/accounts/AuthSubRequest' or
+ '/accounts/AuthSubRequest'
+ domain: The domain which the account is part of. This is used for Google
+ Apps accounts, the default value is 'default' which means that the
+ requested account is a Google Account (@gmail.com for example)
+ scopes_param_prefix: str (optional) The requested scopes are added as a
+ URL parameter to the next URL so that the page at the 'next' URL can
+ extract the token value and the valid scopes from the URL. The key
+ for the URL parameter defaults to 'auth_sub_scopes'
+
+ Returns:
+ An atom.url.Url which the user's browser should be directed to in order
+ to authorize this application to access their information.
+ """
+ if isinstance(next, (str, unicode)):
+ next = atom.url.parse_url(next)
+ scopes_string = ' '.join([str(scope) for scope in scopes])
+ next.params[scopes_param_prefix] = scopes_string
+
+ if isinstance(request_url, (str, unicode)):
+ request_url = atom.url.parse_url(request_url)
+ request_url.params['next'] = str(next)
+ request_url.params['scope'] = scopes_string
+ if session:
+ request_url.params['session'] = 1
+ else:
+ request_url.params['session'] = 0
+ if secure:
+ request_url.params['secure'] = 1
+ else:
+ request_url.params['secure'] = 0
+ request_url.params['hd'] = domain
+ return request_url
+
+
+def AuthSubTokenFromUrl(url):
+ """Extracts the AuthSub token from the URL.
+
+ Used after the AuthSub redirect has sent the user to the 'next' page and
+ appended the token to the URL. This function returns the value to be used
+ in the Authorization header.
+
+ Args:
+ url: str The URL of the current page which contains the AuthSub token as
+ a URL parameter.
+ """
+ token = TokenFromUrl(url)
+ if token:
+ return 'AuthSub token=%s' % token
+ return None
+
+
+def TokenFromUrl(url):
+ """Extracts the AuthSub token from the URL.
+
+ Returns the raw token value.
+
+ Args:
+ url: str The URL or the query portion of the URL string (after the ?) of
+ the current page which contains the AuthSub token as a URL parameter.
+ """
+ if url.find('?') > -1:
+ query_params = url.split('?')[1]
+ else:
+ query_params = url
+ for pair in query_params.split('&'):
+ if pair.startswith('token='):
+ return pair[6:]
+ return None
+
+
+def extract_auth_sub_token_from_url(url,
+ scopes_param_prefix='auth_sub_scopes', rsa_key=None):
+ """Creates an AuthSubToken and sets the token value and scopes from the URL.
+
+ After the Google Accounts AuthSub pages redirect the user's broswer back to
+ the web application (using the 'next' URL from the request) the web app must
+ extract the token from the current page's URL. The token is provided as a
+ URL parameter named 'token' and if generate_auth_sub_url was used to create
+ the request, the token's valid scopes are included in a URL parameter whose
+ name is specified in scopes_param_prefix.
+
+ Args:
+ url: atom.url.Url or str representing the current URL. The token value
+ and valid scopes should be included as URL parameters.
+ scopes_param_prefix: str (optional) The URL parameter key which maps to
+ the list of valid scopes for the token.
+
+ Returns:
+ An AuthSubToken with the token value from the URL and set to be valid for
+ the scopes passed in on the URL. If no scopes were included in the URL,
+ the AuthSubToken defaults to being valid for no scopes. If there was no
+ 'token' parameter in the URL, this function returns None.
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ if 'token' not in url.params:
+ return None
+ scopes = []
+ if scopes_param_prefix in url.params:
+ scopes = url.params[scopes_param_prefix].split(' ')
+ token_value = url.params['token']
+ if rsa_key:
+ token = SecureAuthSubToken(rsa_key, scopes=scopes)
+ else:
+ token = AuthSubToken(scopes=scopes)
+ token.set_token_string(token_value)
+ return token
+
+
+def AuthSubTokenFromHttpBody(http_body):
+ """Extracts the AuthSub token from an HTTP body string.
+
+ Used to find the new session token after making a request to upgrade a
+ single use AuthSub token.
+
+ Args:
+ http_body: str The repsonse from the server which contains the AuthSub
+ key. For example, this function would find the new session token
+ from the server's response to an upgrade token request.
+
+ Returns:
+ The header value to use for Authorization which contains the AuthSub
+ token.
+ """
+ token_value = token_from_http_body(http_body)
+ if token_value:
+ return '%s%s' % (AUTHSUB_AUTH_LABEL, token_value)
+ return None
+
+
+def token_from_http_body(http_body):
+ """Extracts the AuthSub token from an HTTP body string.
+
+ Used to find the new session token after making a request to upgrade a
+ single use AuthSub token.
+
+ Args:
+ http_body: str The repsonse from the server which contains the AuthSub
+ key. For example, this function would find the new session token
+ from the server's response to an upgrade token request.
+
+ Returns:
+ The raw token value to use in an AuthSubToken object.
+ """
+ for response_line in http_body.splitlines():
+ if response_line.startswith('Token='):
+ # Strip off Token= and return the token value string.
+ return response_line[6:]
+ return None
+
+
+TokenFromHttpBody = token_from_http_body
+
+
+def OAuthTokenFromUrl(url, scopes_param_prefix='oauth_token_scope'):
+ """Creates an OAuthToken and sets token key and scopes (if present) from URL.
+
+ After the Google Accounts OAuth pages redirect the user's broswer back to
+ the web application (using the 'callback' URL from the request) the web app
+ can extract the token from the current page's URL. The token is same as the
+ request token, but it is either authorized (if user grants access) or
+ unauthorized (if user denies access). The token is provided as a
+ URL parameter named 'oauth_token' and if it was chosen to use
+ GenerateOAuthAuthorizationUrl with include_scopes_in_param=True, the token's
+ valid scopes are included in a URL parameter whose name is specified in
+ scopes_param_prefix.
+
+ Args:
+ url: atom.url.Url or str representing the current URL. The token value
+ and valid scopes should be included as URL parameters.
+ scopes_param_prefix: str (optional) The URL parameter key which maps to
+ the list of valid scopes for the token.
+
+ Returns:
+ An OAuthToken with the token key from the URL and set to be valid for
+ the scopes passed in on the URL. If no scopes were included in the URL,
+ the OAuthToken defaults to being valid for no scopes. If there was no
+ 'oauth_token' parameter in the URL, this function returns None.
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ if 'oauth_token' not in url.params:
+ return None
+ scopes = []
+ if scopes_param_prefix in url.params:
+ scopes = url.params[scopes_param_prefix].split(' ')
+ token_key = url.params['oauth_token']
+ token = OAuthToken(key=token_key, scopes=scopes)
+ return token
+
+
+def OAuthTokenFromHttpBody(http_body):
+ """Parses the HTTP response body and returns an OAuth token.
+
+ The returned OAuth token will just have key and secret parameters set.
+ It won't have any knowledge about the scopes or oauth_input_params. It is
+ your responsibility to make it aware of the remaining parameters.
+
+ Returns:
+ OAuthToken OAuth token.
+ """
+ token = oauth.OAuthToken.from_string(http_body)
+ oauth_token = OAuthToken(key=token.key, secret=token.secret)
+ return oauth_token
+
+
+class OAuthSignatureMethod(object):
+ """Holds valid OAuth signature methods.
+
+ RSA_SHA1: Class to build signature according to RSA-SHA1 algorithm.
+ HMAC_SHA1: Class to build signature according to HMAC-SHA1 algorithm.
+ """
+
+ HMAC_SHA1 = oauth.OAuthSignatureMethod_HMAC_SHA1
+
+ class RSA_SHA1(oauth_rsa.OAuthSignatureMethod_RSA_SHA1):
+ """Provides implementation for abstract methods to return RSA certs."""
+
+ def __init__(self, private_key, public_cert):
+ self.private_key = private_key
+ self.public_cert = public_cert
+
+ def _fetch_public_cert(self, unused_oauth_request):
+ return self.public_cert
+
+ def _fetch_private_cert(self, unused_oauth_request):
+ return self.private_key
+
+
+class OAuthInputParams(object):
+ """Stores OAuth input parameters.
+
+ This class is a store for OAuth input parameters viz. consumer key and secret,
+ signature method and RSA key.
+ """
+
+ def __init__(self, signature_method, consumer_key, consumer_secret=None,
+ rsa_key=None, requestor_id=None):
+ """Initializes object with parameters required for using OAuth mechanism.
+
+ NOTE: Though consumer_secret and rsa_key are optional, either of the two
+ is required depending on the value of the signature_method.
+
+ Args:
+ signature_method: class which provides implementation for strategy class
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for
+ signing each request. Valid implementations are provided as the
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1. Instead of passing in
+ the strategy class, you may pass in a string for 'RSA_SHA1' or
+ 'HMAC_SHA1'. If you plan to use OAuth on App Engine (or another
+ WSGI environment) I recommend specifying signature method using a
+ string (the only options are 'RSA_SHA1' and 'HMAC_SHA1'). In these
+ environments there are sometimes issues with pickling an object in
+ which a member references a class or function. Storing a string to
+ refer to the signature method mitigates complications when
+ pickling.
+ consumer_key: string Domain identifying third_party web application.
+ consumer_secret: string (optional) Secret generated during registration.
+ Required only for HMAC_SHA1 signature method.
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature
+ method.
+ requestor_id: string (optional) User email adress to make requests on
+ their behalf. This parameter should only be set when performing
+ 2 legged OAuth requests.
+ """
+ if (signature_method == OAuthSignatureMethod.RSA_SHA1
+ or signature_method == 'RSA_SHA1'):
+ self.__signature_strategy = 'RSA_SHA1'
+ elif (signature_method == OAuthSignatureMethod.HMAC_SHA1
+ or signature_method == 'HMAC_SHA1'):
+ self.__signature_strategy = 'HMAC_SHA1'
+ else:
+ self.__signature_strategy = signature_method
+ self.rsa_key = rsa_key
+ self._consumer = oauth.OAuthConsumer(consumer_key, consumer_secret)
+ self.requestor_id = requestor_id
+
+ def __get_signature_method(self):
+ if self.__signature_strategy == 'RSA_SHA1':
+ return OAuthSignatureMethod.RSA_SHA1(self.rsa_key, None)
+ elif self.__signature_strategy == 'HMAC_SHA1':
+ return OAuthSignatureMethod.HMAC_SHA1()
+ else:
+ return self.__signature_strategy()
+
+ def __set_signature_method(self, signature_method):
+ if (signature_method == OAuthSignatureMethod.RSA_SHA1
+ or signature_method == 'RSA_SHA1'):
+ self.__signature_strategy = 'RSA_SHA1'
+ elif (signature_method == OAuthSignatureMethod.HMAC_SHA1
+ or signature_method == 'HMAC_SHA1'):
+ self.__signature_strategy = 'HMAC_SHA1'
+ else:
+ self.__signature_strategy = signature_method
+
+ _signature_method = property(__get_signature_method, __set_signature_method,
+ doc="""Returns object capable of signing the request using RSA of HMAC.
+
+ Replaces the _signature_method member to avoid pickle errors.""")
+
+ def GetSignatureMethod(self):
+ """Gets the OAuth signature method.
+
+ Returns:
+ object of supertype <oauth.oauth.OAuthSignatureMethod>
+ """
+ return self._signature_method
+
+ def GetConsumer(self):
+ """Gets the OAuth consumer.
+
+ Returns:
+ object of type <oauth.oauth.Consumer>
+ """
+ return self._consumer
+
+
+class ClientLoginToken(atom.http_interface.GenericToken):
+ """Stores the Authorization header in auth_header and adds to requests.
+
+ This token will add it's Authorization header to an HTTP request
+ as it is made. Ths token class is simple but
+ some Token classes must calculate portions of the Authorization header
+ based on the request being made, which is why the token is responsible
+ for making requests via an http_client parameter.
+
+ Args:
+ auth_header: str The value for the Authorization header.
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs
+ for which this token can be used. For example, if scopes contains
+ 'http://example.com/foo', then this token can be used for a request to
+ 'http://example.com/foo/bar' but it cannot be used for a request to
+ 'http://example.com/baz'
+ """
+ def __init__(self, auth_header=None, scopes=None):
+ self.auth_header = auth_header
+ self.scopes = scopes or []
+
+ def __str__(self):
+ return self.auth_header
+
+ def perform_request(self, http_client, operation, url, data=None,
+ headers=None):
+ """Sets the Authorization header and makes the HTTP request."""
+ if headers is None:
+ headers = {'Authorization':self.auth_header}
+ else:
+ headers['Authorization'] = self.auth_header
+ return http_client.request(operation, url, data=data, headers=headers)
+
+ def get_token_string(self):
+ """Removes PROGRAMMATIC_AUTH_LABEL to give just the token value."""
+ return self.auth_header[len(PROGRAMMATIC_AUTH_LABEL):]
+
+ def set_token_string(self, token_string):
+ self.auth_header = '%s%s' % (PROGRAMMATIC_AUTH_LABEL, token_string)
+
+ def valid_for_scope(self, url):
+ """Tells the caller if the token authorizes access to the desired URL.
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ for scope in self.scopes:
+ if scope == atom.token_store.SCOPE_ALL:
+ return True
+ if isinstance(scope, (str, unicode)):
+ scope = atom.url.parse_url(scope)
+ if scope == url:
+ return True
+ # Check the host and the path, but ignore the port and protocol.
+ elif scope.host == url.host and not scope.path:
+ return True
+ elif scope.host == url.host and scope.path and not url.path:
+ continue
+ elif scope.host == url.host and url.path.startswith(scope.path):
+ return True
+ return False
+
+
+class AuthSubToken(ClientLoginToken):
+ def get_token_string(self):
+ """Removes AUTHSUB_AUTH_LABEL to give just the token value."""
+ return self.auth_header[len(AUTHSUB_AUTH_LABEL):]
+
+ def set_token_string(self, token_string):
+ self.auth_header = '%s%s' % (AUTHSUB_AUTH_LABEL, token_string)
+
+
+class OAuthToken(atom.http_interface.GenericToken):
+ """Stores the token key, token secret and scopes for which token is valid.
+
+ This token adds the authorization header to each request made. It
+ re-calculates authorization header for every request since the OAuth
+ signature to be added to the authorization header is dependent on the
+ request parameters.
+
+ Attributes:
+ key: str The value for the OAuth token i.e. token key.
+ secret: str The value for the OAuth token secret.
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs
+ for which this token can be used. For example, if scopes contains
+ 'http://example.com/foo', then this token can be used for a request to
+ 'http://example.com/foo/bar' but it cannot be used for a request to
+ 'http://example.com/baz'
+ oauth_input_params: OAuthInputParams OAuth input parameters.
+ """
+
+ def __init__(self, key=None, secret=None, scopes=None,
+ oauth_input_params=None):
+ self.key = key
+ self.secret = secret
+ self.scopes = scopes or []
+ self.oauth_input_params = oauth_input_params
+
+ def __str__(self):
+ return self.get_token_string()
+
+ def get_token_string(self):
+ """Returns the token string.
+
+ The token string returned is of format
+ oauth_token=[0]&oauth_token_secret=[1], where [0] and [1] are some strings.
+
+ Returns:
+ A token string of format oauth_token=[0]&oauth_token_secret=[1],
+ where [0] and [1] are some strings. If self.secret is absent, it just
+ returns oauth_token=[0]. If self.key is absent, it just returns
+ oauth_token_secret=[1]. If both are absent, it returns None.
+ """
+ if self.key and self.secret:
+ return urllib.urlencode({'oauth_token': self.key,
+ 'oauth_token_secret': self.secret})
+ elif self.key:
+ return 'oauth_token=%s' % self.key
+ elif self.secret:
+ return 'oauth_token_secret=%s' % self.secret
+ else:
+ return None
+
+ def set_token_string(self, token_string):
+ """Sets the token key and secret from the token string.
+
+ Args:
+ token_string: str Token string of form
+ oauth_token=[0]&oauth_token_secret=[1]. If oauth_token is not present,
+ self.key will be None. If oauth_token_secret is not present,
+ self.secret will be None.
+ """
+ token_params = cgi.parse_qs(token_string, keep_blank_values=False)
+ if 'oauth_token' in token_params:
+ self.key = token_params['oauth_token'][0]
+ if 'oauth_token_secret' in token_params:
+ self.secret = token_params['oauth_token_secret'][0]
+
+ def GetAuthHeader(self, http_method, http_url, realm=''):
+ """Get the authentication header.
+
+ Args:
+ http_method: string HTTP method i.e. operation e.g. GET, POST, PUT, etc.
+ http_url: string or atom.url.Url HTTP URL to which request is made.
+ realm: string (default='') realm parameter to be included in the
+ authorization header.
+
+ Returns:
+ dict Header to be sent with every subsequent request after
+ authentication.
+ """
+ if isinstance(http_url, types.StringTypes):
+ http_url = atom.url.parse_url(http_url)
+ header = None
+ token = None
+ if self.key or self.secret:
+ token = oauth.OAuthToken(self.key, self.secret)
+ oauth_request = oauth.OAuthRequest.from_consumer_and_token(
+ self.oauth_input_params.GetConsumer(), token=token,
+ http_url=str(http_url), http_method=http_method,
+ parameters=http_url.params)
+ oauth_request.sign_request(self.oauth_input_params.GetSignatureMethod(),
+ self.oauth_input_params.GetConsumer(), token)
+ header = oauth_request.to_header(realm=realm)
+ header['Authorization'] = header['Authorization'].replace('+', '%2B')
+ return header
+
+ def perform_request(self, http_client, operation, url, data=None,
+ headers=None):
+ """Sets the Authorization header and makes the HTTP request."""
+ if not headers:
+ headers = {}
+ if self.oauth_input_params.requestor_id:
+ url.params['xoauth_requestor_id'] = self.oauth_input_params.requestor_id
+ headers.update(self.GetAuthHeader(operation, url))
+ return http_client.request(operation, url, data=data, headers=headers)
+
+ def valid_for_scope(self, url):
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ for scope in self.scopes:
+ if scope == atom.token_store.SCOPE_ALL:
+ return True
+ if isinstance(scope, (str, unicode)):
+ scope = atom.url.parse_url(scope)
+ if scope == url:
+ return True
+ # Check the host and the path, but ignore the port and protocol.
+ elif scope.host == url.host and not scope.path:
+ return True
+ elif scope.host == url.host and scope.path and not url.path:
+ continue
+ elif scope.host == url.host and url.path.startswith(scope.path):
+ return True
+ return False
+
+
+class SecureAuthSubToken(AuthSubToken):
+ """Stores the rsa private key, token, and scopes for the secure AuthSub token.
+
+ This token adds the authorization header to each request made. It
+ re-calculates authorization header for every request since the secure AuthSub
+ signature to be added to the authorization header is dependent on the
+ request parameters.
+
+ Attributes:
+ rsa_key: string The RSA private key in PEM format that the token will
+ use to sign requests
+ token_string: string (optional) The value for the AuthSub token.
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs
+ for which this token can be used. For example, if scopes contains
+ 'http://example.com/foo', then this token can be used for a request to
+ 'http://example.com/foo/bar' but it cannot be used for a request to
+ 'http://example.com/baz'
+ """
+
+ def __init__(self, rsa_key, token_string=None, scopes=None):
+ self.rsa_key = keyfactory.parsePEMKey(rsa_key)
+ self.token_string = token_string or ''
+ self.scopes = scopes or []
+
+ def __str__(self):
+ return self.get_token_string()
+
+ def get_token_string(self):
+ return str(self.token_string)
+
+ def set_token_string(self, token_string):
+ self.token_string = token_string
+
+ def GetAuthHeader(self, http_method, http_url):
+ """Generates the Authorization header.
+
+ The form of the secure AuthSub Authorization header is
+ Authorization: AuthSub token="token" sigalg="sigalg" data="data" sig="sig"
+ and data represents a string in the form
+ data = http_method http_url timestamp nonce
+
+ Args:
+ http_method: string HTTP method i.e. operation e.g. GET, POST, PUT, etc.
+ http_url: string or atom.url.Url HTTP URL to which request is made.
+
+ Returns:
+ dict Header to be sent with every subsequent request after authentication.
+ """
+ timestamp = int(math.floor(time.time()))
+ nonce = '%lu' % random.randrange(1, 2**64)
+ data = '%s %s %d %s' % (http_method, str(http_url), timestamp, nonce)
+ sig = cryptomath.bytesToBase64(self.rsa_key.hashAndSign(data))
+ header = {'Authorization': '%s"%s" data="%s" sig="%s" sigalg="rsa-sha1"' %
+ (AUTHSUB_AUTH_LABEL, self.token_string, data, sig)}
+ return header
+
+ def perform_request(self, http_client, operation, url, data=None,
+ headers=None):
+ """Sets the Authorization header and makes the HTTP request."""
+ if not headers:
+ headers = {}
+ headers.update(self.GetAuthHeader(operation, url))
+ return http_client.request(operation, url, data=data, headers=headers)
diff --git a/samples/apps/marketplace_sample/gdata/calendar/__init__.py b/samples/apps/marketplace_sample/gdata/calendar/__init__.py
new file mode 100755
index 0000000..06c0410
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/calendar/__init__.py
@@ -0,0 +1,1044 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains extensions to ElementWrapper objects used with Google Calendar."""
+
+
+__author__ = 'api.vli (Vivian Li), api.rboyd (Ryan Boyd)'
+
+
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import atom
+import gdata
+
+
+# XML namespaces which are often used in Google Calendar entities.
+GCAL_NAMESPACE = 'http://schemas.google.com/gCal/2005'
+GCAL_TEMPLATE = '{http://schemas.google.com/gCal/2005}%s'
+WEB_CONTENT_LINK_REL = '%s/%s' % (GCAL_NAMESPACE, 'webContent')
+GACL_NAMESPACE = gdata.GACL_NAMESPACE
+GACL_TEMPLATE = gdata.GACL_TEMPLATE
+
+
+
+class ValueAttributeContainer(atom.AtomBase):
+ """A parent class for all Calendar classes which have a value attribute.
+
+ Children include Color, AccessLevel, Hidden
+ """
+
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+class Color(ValueAttributeContainer):
+ """The Google Calendar color element"""
+
+ _tag = 'color'
+ _namespace = GCAL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+
+class AccessLevel(ValueAttributeContainer):
+ """The Google Calendar accesslevel element"""
+
+ _tag = 'accesslevel'
+ _namespace = GCAL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+class Hidden(ValueAttributeContainer):
+ """The Google Calendar hidden element"""
+
+ _tag = 'hidden'
+ _namespace = GCAL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+class Selected(ValueAttributeContainer):
+ """The Google Calendar selected element"""
+
+ _tag = 'selected'
+ _namespace = GCAL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+class Timezone(ValueAttributeContainer):
+ """The Google Calendar timezone element"""
+
+ _tag = 'timezone'
+ _namespace = GCAL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+class Where(atom.AtomBase):
+ """The Google Calendar Where element"""
+
+ _tag = 'where'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['valueString'] = 'value_string'
+
+ def __init__(self, value_string=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value_string = value_string
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class CalendarListEntry(gdata.GDataEntry, gdata.LinkFinder):
+ """A Google Calendar meta Entry flavor of an Atom Entry """
+
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}color' % GCAL_NAMESPACE] = ('color', Color)
+ _children['{%s}accesslevel' % GCAL_NAMESPACE] = ('access_level',
+ AccessLevel)
+ _children['{%s}hidden' % GCAL_NAMESPACE] = ('hidden', Hidden)
+ _children['{%s}selected' % GCAL_NAMESPACE] = ('selected', Selected)
+ _children['{%s}timezone' % GCAL_NAMESPACE] = ('timezone', Timezone)
+ _children['{%s}where' % gdata.GDATA_NAMESPACE] = ('where', Where)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ color=None, access_level=None, hidden=None, timezone=None,
+ selected=None,
+ where=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title,
+ updated=updated, text=None)
+
+ self.color = color
+ self.access_level = access_level
+ self.hidden = hidden
+ self.selected = selected
+ self.timezone = timezone
+ self.where = where
+
+
+class CalendarListFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Calendar meta feed flavor of an Atom Feed"""
+
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [CalendarListEntry])
+
+
+class Scope(atom.AtomBase):
+ """The Google ACL scope element"""
+
+ _tag = 'scope'
+ _namespace = GACL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+ _attributes['type'] = 'type'
+
+ def __init__(self, extension_elements=None, value=None, scope_type=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.type = scope_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Role(ValueAttributeContainer):
+ """The Google Calendar timezone element"""
+
+ _tag = 'role'
+ _namespace = GACL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+class CalendarAclEntry(gdata.GDataEntry, gdata.LinkFinder):
+ """A Google Calendar ACL Entry flavor of an Atom Entry """
+
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}scope' % GACL_NAMESPACE] = ('scope', Scope)
+ _children['{%s}role' % GACL_NAMESPACE] = ('role', Role)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ scope=None, role=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title,
+ updated=updated, text=None)
+ self.scope = scope
+ self.role = role
+
+
+class CalendarAclFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Calendar ACL feed flavor of an Atom Feed"""
+
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [CalendarAclEntry])
+
+
+class CalendarEventCommentEntry(gdata.GDataEntry, gdata.LinkFinder):
+ """A Google Calendar event comments entry flavor of an Atom Entry"""
+
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+
+class CalendarEventCommentFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Calendar event comments feed flavor of an Atom Feed"""
+
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [CalendarEventCommentEntry])
+
+
+class ExtendedProperty(gdata.ExtendedProperty):
+ """A transparent subclass of gdata.ExtendedProperty added to this module
+ for backwards compatibility."""
+
+
+class Reminder(atom.AtomBase):
+ """The Google Calendar reminder element"""
+
+ _tag = 'reminder'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['absoluteTime'] = 'absolute_time'
+ _attributes['days'] = 'days'
+ _attributes['hours'] = 'hours'
+ _attributes['minutes'] = 'minutes'
+ _attributes['method'] = 'method'
+
+ def __init__(self, absolute_time=None,
+ days=None, hours=None, minutes=None, method=None,
+ extension_elements=None,
+ extension_attributes=None, text=None):
+ self.absolute_time = absolute_time
+ if days is not None:
+ self.days = str(days)
+ else:
+ self.days = None
+ if hours is not None:
+ self.hours = str(hours)
+ else:
+ self.hours = None
+ if minutes is not None:
+ self.minutes = str(minutes)
+ else:
+ self.minutes = None
+ self.method = method
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class When(atom.AtomBase):
+ """The Google Calendar When element"""
+
+ _tag = 'when'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}reminder' % gdata.GDATA_NAMESPACE] = ('reminder', [Reminder])
+ _attributes['startTime'] = 'start_time'
+ _attributes['endTime'] = 'end_time'
+
+ def __init__(self, start_time=None, end_time=None, reminder=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.start_time = start_time
+ self.end_time = end_time
+ self.reminder = reminder or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Recurrence(atom.AtomBase):
+ """The Google Calendar Recurrence element"""
+
+ _tag = 'recurrence'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+
+class UriEnumElement(atom.AtomBase):
+
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, tag, enum_map, attrib_name='value',
+ extension_elements=None, extension_attributes=None, text=None):
+ self.tag=tag
+ self.enum_map=enum_map
+ self.attrib_name=attrib_name
+ self.value=None
+ self.text=text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ def findKey(self, value):
+ res=[item[0] for item in self.enum_map.items() if item[1] == value]
+ if res is None or len(res) == 0:
+ return None
+ return res[0]
+
+ def _ConvertElementAttributeToMember(self, attribute, value):
+ # Special logic to use the enum_map to set the value of the object's value member.
+ if attribute == self.attrib_name and value != '':
+ self.value = self.enum_map[value]
+ return
+ # Find the attribute in this class's list of attributes.
+ if self.__class__._attributes.has_key(attribute):
+ # Find the member of this class which corresponds to the XML attribute
+ # (lookup in current_class._attributes) and set this member to the
+ # desired value (using self.__dict__).
+ setattr(self, self.__class__._attributes[attribute], value)
+ else:
+ # The current class doesn't map this attribute, so try to parent class.
+ atom.ExtensionContainer._ConvertElementAttributeToMember(self,
+ attribute,
+ value)
+
+ def _AddMembersToElementTree(self, tree):
+ # Convert the members of this class which are XML child nodes.
+ # This uses the class's _children dictionary to find the members which
+ # should become XML child nodes.
+ member_node_names = [values[0] for tag, values in
+ self.__class__._children.iteritems()]
+ for member_name in member_node_names:
+ member = getattr(self, member_name)
+ if member is None:
+ pass
+ elif isinstance(member, list):
+ for instance in member:
+ instance._BecomeChildElement(tree)
+ else:
+ member._BecomeChildElement(tree)
+ # Special logic to set the desired XML attribute.
+ key = self.findKey(self.value)
+ if key is not None:
+ tree.attrib[self.attrib_name]=key
+ # Convert the members of this class which are XML attributes.
+ for xml_attribute, member_name in self.__class__._attributes.iteritems():
+ member = getattr(self, member_name)
+ if member is not None:
+ tree.attrib[xml_attribute] = member
+ # Lastly, call the parent's _AddMembersToElementTree to get any
+ # extension elements.
+ atom.ExtensionContainer._AddMembersToElementTree(self, tree)
+
+
+
+class AttendeeStatus(UriEnumElement):
+ """The Google Calendar attendeeStatus element"""
+
+ _tag = 'attendeeStatus'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+
+ attendee_enum = {
+ 'http://schemas.google.com/g/2005#event.accepted' : 'ACCEPTED',
+ 'http://schemas.google.com/g/2005#event.declined' : 'DECLINED',
+ 'http://schemas.google.com/g/2005#event.invited' : 'INVITED',
+ 'http://schemas.google.com/g/2005#event.tentative' : 'TENTATIVE'}
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, 'attendeeStatus', AttendeeStatus.attendee_enum,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+class AttendeeType(UriEnumElement):
+ """The Google Calendar attendeeType element"""
+
+ _tag = 'attendeeType'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+
+ attendee_type_enum = {
+ 'http://schemas.google.com/g/2005#event.optional' : 'OPTIONAL',
+ 'http://schemas.google.com/g/2005#event.required' : 'REQUIRED' }
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, 'attendeeType',
+ AttendeeType.attendee_type_enum,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,text=text)
+
+
+class Visibility(UriEnumElement):
+ """The Google Calendar Visibility element"""
+
+ _tag = 'visibility'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+
+ visibility_enum = {
+ 'http://schemas.google.com/g/2005#event.confidential' : 'CONFIDENTIAL',
+ 'http://schemas.google.com/g/2005#event.default' : 'DEFAULT',
+ 'http://schemas.google.com/g/2005#event.private' : 'PRIVATE',
+ 'http://schemas.google.com/g/2005#event.public' : 'PUBLIC' }
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, 'visibility', Visibility.visibility_enum,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+class Transparency(UriEnumElement):
+ """The Google Calendar Transparency element"""
+
+ _tag = 'transparency'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+
+ transparency_enum = {
+ 'http://schemas.google.com/g/2005#event.opaque' : 'OPAQUE',
+ 'http://schemas.google.com/g/2005#event.transparent' : 'TRANSPARENT' }
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, tag='transparency',
+ enum_map=Transparency.transparency_enum,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+class Comments(atom.AtomBase):
+ """The Google Calendar comments element"""
+
+ _tag = 'comments'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feed_link',
+ gdata.FeedLink)
+ _attributes['rel'] = 'rel'
+
+ def __init__(self, rel=None, feed_link=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.rel = rel
+ self.feed_link = feed_link
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class EventStatus(UriEnumElement):
+ """The Google Calendar eventStatus element"""
+
+ _tag = 'eventStatus'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+
+ status_enum = { 'http://schemas.google.com/g/2005#event.canceled' : 'CANCELED',
+ 'http://schemas.google.com/g/2005#event.confirmed' : 'CONFIRMED',
+ 'http://schemas.google.com/g/2005#event.tentative' : 'TENTATIVE'}
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, tag='eventStatus',
+ enum_map=EventStatus.status_enum,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+class Who(UriEnumElement):
+ """The Google Calendar Who element"""
+
+ _tag = 'who'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+ _children['{%s}attendeeStatus' % gdata.GDATA_NAMESPACE] = (
+ 'attendee_status', AttendeeStatus)
+ _children['{%s}attendeeType' % gdata.GDATA_NAMESPACE] = ('attendee_type',
+ AttendeeType)
+ _attributes['valueString'] = 'name'
+ _attributes['email'] = 'email'
+
+ relEnum = { 'http://schemas.google.com/g/2005#event.attendee' : 'ATTENDEE',
+ 'http://schemas.google.com/g/2005#event.organizer' : 'ORGANIZER',
+ 'http://schemas.google.com/g/2005#event.performer' : 'PERFORMER',
+ 'http://schemas.google.com/g/2005#event.speaker' : 'SPEAKER',
+ 'http://schemas.google.com/g/2005#message.bcc' : 'BCC',
+ 'http://schemas.google.com/g/2005#message.cc' : 'CC',
+ 'http://schemas.google.com/g/2005#message.from' : 'FROM',
+ 'http://schemas.google.com/g/2005#message.reply-to' : 'REPLY_TO',
+ 'http://schemas.google.com/g/2005#message.to' : 'TO' }
+
+ def __init__(self, name=None, email=None, attendee_status=None,
+ attendee_type=None, rel=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, 'who', Who.relEnum, attrib_name='rel',
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+ self.name = name
+ self.email = email
+ self.attendee_status = attendee_status
+ self.attendee_type = attendee_type
+ self.rel = rel
+
+
+class OriginalEvent(atom.AtomBase):
+ """The Google Calendar OriginalEvent element"""
+
+ _tag = 'originalEvent'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ # TODO: The when tag used to map to a EntryLink, make sure it should really be a When.
+ _children['{%s}when' % gdata.GDATA_NAMESPACE] = ('when', When)
+ _attributes['id'] = 'id'
+ _attributes['href'] = 'href'
+
+ def __init__(self, id=None, href=None, when=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.id = id
+ self.href = href
+ self.when = when
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def GetCalendarEventEntryClass():
+ return CalendarEventEntry
+
+
+# This class is not completely defined here, because of a circular reference
+# in which CalendarEventEntryLink and CalendarEventEntry refer to one another.
+class CalendarEventEntryLink(gdata.EntryLink):
+ """An entryLink which contains a calendar event entry
+
+ Within an event's recurranceExceptions, an entry link
+ points to a calendar event entry. This class exists
+ to capture the calendar specific extensions in the entry.
+ """
+
+ _tag = 'entryLink'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = gdata.EntryLink._children.copy()
+ _attributes = gdata.EntryLink._attributes.copy()
+ # The CalendarEventEntryLink should like CalendarEventEntry as a child but
+ # that class hasn't been defined yet, so we will wait until after defining
+ # CalendarEventEntry to list it in _children.
+
+
+class RecurrenceException(atom.AtomBase):
+ """The Google Calendar RecurrenceException element"""
+
+ _tag = 'recurrenceException'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}entryLink' % gdata.GDATA_NAMESPACE] = ('entry_link',
+ CalendarEventEntryLink)
+ _children['{%s}originalEvent' % gdata.GDATA_NAMESPACE] = ('original_event',
+ OriginalEvent)
+ _attributes['specialized'] = 'specialized'
+
+ def __init__(self, specialized=None, entry_link=None,
+ original_event=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.specialized = specialized
+ self.entry_link = entry_link
+ self.original_event = original_event
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class SendEventNotifications(atom.AtomBase):
+ """The Google Calendar sendEventNotifications element"""
+
+ _tag = 'sendEventNotifications'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, extension_elements=None,
+ value=None, extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class QuickAdd(atom.AtomBase):
+ """The Google Calendar quickadd element"""
+
+ _tag = 'quickadd'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, extension_elements=None,
+ value=None, extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ def _TransferToElementTree(self, element_tree):
+ if self.value:
+ element_tree.attrib['value'] = self.value
+ element_tree.tag = GCAL_TEMPLATE % 'quickadd'
+ atom.AtomBase._TransferToElementTree(self, element_tree)
+ return element_tree
+
+ def _TakeAttributeFromElementTree(self, attribute, element_tree):
+ if attribute == 'value':
+ self.value = element_tree.attrib[attribute]
+ del element_tree.attrib[attribute]
+ else:
+ atom.AtomBase._TakeAttributeFromElementTree(self, attribute,
+ element_tree)
+
+
+class SyncEvent(atom.AtomBase):
+ _tag = 'syncEvent'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value='false', extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class UID(atom.AtomBase):
+ _tag = 'uid'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Sequence(atom.AtomBase):
+ _tag = 'sequence'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class WebContentGadgetPref(atom.AtomBase):
+
+ _tag = 'webContentGadgetPref'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+ _attributes['value'] = 'value'
+
+ """The Google Calendar Web Content Gadget Preferences element"""
+
+ def __init__(self, name=None, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class WebContent(atom.AtomBase):
+
+ _tag = 'webContent'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}webContentGadgetPref' % GCAL_NAMESPACE] = ('gadget_pref',
+ [WebContentGadgetPref])
+ _attributes['url'] = 'url'
+ _attributes['width'] = 'width'
+ _attributes['height'] = 'height'
+
+ def __init__(self, url=None, width=None, height=None, text=None,
+ gadget_pref=None, extension_elements=None, extension_attributes=None):
+ self.url = url
+ self.width = width
+ self.height = height
+ self.text = text
+ self.gadget_pref = gadget_pref or []
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class WebContentLink(atom.Link):
+
+ _tag = 'link'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = atom.Link._children.copy()
+ _attributes = atom.Link._attributes.copy()
+ _children['{%s}webContent' % GCAL_NAMESPACE] = ('web_content', WebContent)
+
+ def __init__(self, title=None, href=None, link_type=None,
+ web_content=None):
+ atom.Link.__init__(self, rel=WEB_CONTENT_LINK_REL, title=title, href=href,
+ link_type=link_type)
+ self.web_content = web_content
+
+
+class GuestsCanInviteOthers(atom.AtomBase):
+ """Indicates whether event attendees may invite others to the event.
+
+ This element may only be changed by the organizer of the event. If not
+ included as part of the event entry, this element will default to true
+ during a POST request, and will inherit its previous value during a PUT
+ request.
+ """
+ _tag = 'guestsCanInviteOthers'
+ _namespace = GCAL_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value='true', *args, **kwargs):
+ atom.AtomBase.__init__(self, *args, **kwargs)
+ self.value = value
+
+
+class GuestsCanSeeGuests(atom.AtomBase):
+ """Indicates whether attendees can see other people invited to the event.
+
+ The organizer always sees all attendees. Guests always see themselves. This
+ property affects what attendees see in the event's guest list via both the
+ Calendar UI and API feeds.
+
+ This element may only be changed by the organizer of the event.
+
+ If not included as part of the event entry, this element will default to
+ true during a POST request, and will inherit its previous value during a
+ PUT request.
+ """
+ _tag = 'guestsCanSeeGuests'
+ _namespace = GCAL_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value='true', *args, **kwargs):
+ atom.AtomBase.__init__(self, *args, **kwargs)
+ self.value = value
+
+
+class GuestsCanModify(atom.AtomBase):
+ """Indicates whether event attendees may modify the original event.
+
+ If yes, changes are visible to organizer and other attendees. Otherwise,
+ any changes made by attendees will be restricted to that attendee's
+ calendar.
+
+ This element may only be changed by the organizer of the event, and may
+ be set to 'true' only if both gCal:guestsCanInviteOthers and
+ gCal:guestsCanSeeGuests are set to true in the same PUT/POST request.
+ Otherwise, request fails with HTTP error code 400 (Bad Request).
+
+ If not included as part of the event entry, this element will default to
+ false during a POST request, and will inherit its previous value during a
+ PUT request."""
+ _tag = 'guestsCanModify'
+ _namespace = GCAL_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value='false', *args, **kwargs):
+ atom.AtomBase.__init__(self, *args, **kwargs)
+ self.value = value
+
+
+
+class CalendarEventEntry(gdata.BatchEntry):
+ """A Google Calendar flavor of an Atom Entry """
+
+ _tag = gdata.BatchEntry._tag
+ _namespace = gdata.BatchEntry._namespace
+ _children = gdata.BatchEntry._children.copy()
+ _attributes = gdata.BatchEntry._attributes.copy()
+ # This class also contains WebContentLinks but converting those members
+ # is handled in a special version of _ConvertElementTreeToMember.
+ _children['{%s}where' % gdata.GDATA_NAMESPACE] = ('where', [Where])
+ _children['{%s}when' % gdata.GDATA_NAMESPACE] = ('when', [When])
+ _children['{%s}who' % gdata.GDATA_NAMESPACE] = ('who', [Who])
+ _children['{%s}extendedProperty' % gdata.GDATA_NAMESPACE] = (
+ 'extended_property', [ExtendedProperty])
+ _children['{%s}visibility' % gdata.GDATA_NAMESPACE] = ('visibility',
+ Visibility)
+ _children['{%s}transparency' % gdata.GDATA_NAMESPACE] = ('transparency',
+ Transparency)
+ _children['{%s}eventStatus' % gdata.GDATA_NAMESPACE] = ('event_status',
+ EventStatus)
+ _children['{%s}recurrence' % gdata.GDATA_NAMESPACE] = ('recurrence',
+ Recurrence)
+ _children['{%s}recurrenceException' % gdata.GDATA_NAMESPACE] = (
+ 'recurrence_exception', [RecurrenceException])
+ _children['{%s}sendEventNotifications' % GCAL_NAMESPACE] = (
+ 'send_event_notifications', SendEventNotifications)
+ _children['{%s}quickadd' % GCAL_NAMESPACE] = ('quick_add', QuickAdd)
+ _children['{%s}comments' % gdata.GDATA_NAMESPACE] = ('comments', Comments)
+ _children['{%s}originalEvent' % gdata.GDATA_NAMESPACE] = ('original_event',
+ OriginalEvent)
+ _children['{%s}sequence' % GCAL_NAMESPACE] = ('sequence', Sequence)
+ _children['{%s}reminder' % gdata.GDATA_NAMESPACE] = ('reminder', [Reminder])
+ _children['{%s}syncEvent' % GCAL_NAMESPACE] = ('sync_event', SyncEvent)
+ _children['{%s}uid' % GCAL_NAMESPACE] = ('uid', UID)
+ _children['{%s}guestsCanInviteOthers' % GCAL_NAMESPACE] = (
+ 'guests_can_invite_others', GuestsCanInviteOthers)
+ _children['{%s}guestsCanModify' % GCAL_NAMESPACE] = (
+ 'guests_can_modify', GuestsCanModify)
+ _children['{%s}guestsCanSeeGuests' % GCAL_NAMESPACE] = (
+ 'guests_can_see_guests', GuestsCanSeeGuests)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ transparency=None, comments=None, event_status=None,
+ send_event_notifications=None, visibility=None,
+ recurrence=None, recurrence_exception=None,
+ where=None, when=None, who=None, quick_add=None,
+ extended_property=None, original_event=None,
+ batch_operation=None, batch_id=None, batch_status=None,
+ sequence=None, reminder=None, sync_event=None, uid=None,
+ guests_can_invite_others=None, guests_can_modify=None,
+ guests_can_see_guests=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.BatchEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ batch_operation=batch_operation, batch_id=batch_id,
+ batch_status=batch_status,
+ title=title, updated=updated)
+
+ self.transparency = transparency
+ self.comments = comments
+ self.event_status = event_status
+ self.send_event_notifications = send_event_notifications
+ self.visibility = visibility
+ self.recurrence = recurrence
+ self.recurrence_exception = recurrence_exception or []
+ self.where = where or []
+ self.when = when or []
+ self.who = who or []
+ self.quick_add = quick_add
+ self.extended_property = extended_property or []
+ self.original_event = original_event
+ self.sequence = sequence
+ self.reminder = reminder or []
+ self.sync_event = sync_event
+ self.uid = uid
+ self.text = text
+ self.guests_can_invite_others = guests_can_invite_others
+ self.guests_can_modify = guests_can_modify
+ self.guests_can_see_guests = guests_can_see_guests
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ # We needed to add special logic to _ConvertElementTreeToMember because we
+ # want to make links with a rel of WEB_CONTENT_LINK_REL into a
+ # WebContentLink
+ def _ConvertElementTreeToMember(self, child_tree):
+ # Special logic to handle Web Content links
+ if (child_tree.tag == '{%s}link' % atom.ATOM_NAMESPACE and
+ child_tree.attrib['rel'] == WEB_CONTENT_LINK_REL):
+ if self.link is None:
+ self.link = []
+ self.link.append(atom._CreateClassFromElementTree(WebContentLink,
+ child_tree))
+ return
+ # Find the element's tag in this class's list of child members
+ if self.__class__._children.has_key(child_tree.tag):
+ member_name = self.__class__._children[child_tree.tag][0]
+ member_class = self.__class__._children[child_tree.tag][1]
+ # If the class member is supposed to contain a list, make sure the
+ # matching member is set to a list, then append the new member
+ # instance to the list.
+ if isinstance(member_class, list):
+ if getattr(self, member_name) is None:
+ setattr(self, member_name, [])
+ getattr(self, member_name).append(atom._CreateClassFromElementTree(
+ member_class[0], child_tree))
+ else:
+ setattr(self, member_name,
+ atom._CreateClassFromElementTree(member_class, child_tree))
+ else:
+ atom.ExtensionContainer._ConvertElementTreeToMember(self, child_tree)
+
+
+ def GetWebContentLink(self):
+ """Finds the first link with rel set to WEB_CONTENT_REL
+
+ Returns:
+ A gdata.calendar.WebContentLink or none if none of the links had rel
+ equal to WEB_CONTENT_REL
+ """
+
+ for a_link in self.link:
+ if a_link.rel == WEB_CONTENT_LINK_REL:
+ return a_link
+ return None
+
+
+def CalendarEventEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarEventEntry, xml_string)
+
+
+def CalendarEventCommentEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarEventCommentEntry, xml_string)
+
+
+CalendarEventEntryLink._children = {'{%s}entry' % atom.ATOM_NAMESPACE:
+ ('entry', CalendarEventEntry)}
+
+
+def CalendarEventEntryLinkFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarEventEntryLink, xml_string)
+
+
+class CalendarEventFeed(gdata.BatchFeed, gdata.LinkFinder):
+ """A Google Calendar event feed flavor of an Atom Feed"""
+
+ _tag = gdata.BatchFeed._tag
+ _namespace = gdata.BatchFeed._namespace
+ _children = gdata.BatchFeed._children.copy()
+ _attributes = gdata.BatchFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [CalendarEventEntry])
+ _children['{%s}timezone' % GCAL_NAMESPACE] = ('timezone', Timezone)
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None, entry=None,
+ total_results=None, start_index=None, items_per_page=None,
+ interrupted=None, timezone=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ gdata.BatchFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ interrupted=interrupted,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+ self.timezone = timezone
+
+
+def CalendarListEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarListEntry, xml_string)
+
+
+def CalendarAclEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarAclEntry, xml_string)
+
+
+def CalendarListFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarListFeed, xml_string)
+
+
+def CalendarAclFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarAclFeed, xml_string)
+
+
+def CalendarEventFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarEventFeed, xml_string)
+
+
+def CalendarEventCommentFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarEventCommentFeed, xml_string)
diff --git a/samples/apps/marketplace_sample/gdata/calendar/client.py b/samples/apps/marketplace_sample/gdata/calendar/client.py
new file mode 100755
index 0000000..414338d
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/calendar/client.py
@@ -0,0 +1,538 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2011 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""CalendarClient extends the GDataService to streamline Google Calendar operations.
+
+ CalendarService: Provides methods to query feeds and manipulate items. Extends
+ GDataService.
+
+ DictionaryToParamList: Function which converts a dictionary into a list of
+ URL arguments (represented as strings). This is a
+ utility function used in CRUD operations.
+"""
+
+
+__author__ = 'alainv (Alain Vongsouvanh)'
+
+
+import urllib
+import gdata.client
+import gdata.calendar.data
+import atom.data
+import atom.http_core
+import gdata.gauth
+
+
+DEFAULT_BATCH_URL = ('https://www.google.com/calendar/feeds/default/private'
+ '/full/batch')
+
+
+class CalendarClient(gdata.client.GDClient):
+ """Client for the Google Calendar service."""
+ api_version = '2'
+ auth_service = 'cl'
+ server = "www.google.com"
+ contact_list = "default"
+ auth_scopes = gdata.gauth.AUTH_SCOPES['cl']
+
+ def __init__(self, domain=None, auth_token=None, **kwargs):
+ """Constructs a new client for the Calendar API.
+
+ Args:
+ domain: string The Google Apps domain (if any).
+ kwargs: The other parameters to pass to the gdata.client.GDClient
+ constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def get_calendar_feed_uri(self, feed='', projection='full', scheme="https"):
+ """Builds a feed URI.
+
+ Args:
+ projection: The projection to apply to the feed contents, for example
+ 'full', 'base', 'base/12345', 'full/batch'. Default value: 'full'.
+ scheme: The URL scheme such as 'http' or 'https', None to return a
+ relative URI without hostname.
+
+ Returns:
+ A feed URI using the given scheme and projection.
+ Example: '/calendar/feeds/default/owncalendars/full'.
+ """
+ prefix = scheme and '%s://%s' % (scheme, self.server) or ''
+ suffix = feed and '/%s/%s' % (feed, projection) or ''
+ return '%s/calendar/feeds/default%s' % (prefix, suffix)
+
+ GetCalendarFeedUri = get_calendar_feed_uri
+
+ def get_calendar_event_feed_uri(self, calendar='default', visibility='private',
+ projection='full', scheme="https"):
+ """Builds a feed URI.
+
+ Args:
+ projection: The projection to apply to the feed contents, for example
+ 'full', 'base', 'base/12345', 'full/batch'. Default value: 'full'.
+ scheme: The URL scheme such as 'http' or 'https', None to return a
+ relative URI without hostname.
+
+ Returns:
+ A feed URI using the given scheme and projection.
+ Example: '/calendar/feeds/default/private/full'.
+ """
+ prefix = scheme and '%s://%s' % (scheme, self.server) or ''
+ return '%s/calendar/feeds/%s/%s/%s' % (prefix, calendar,
+ visibility, projection)
+
+ GetCalendarEventFeedUri = get_calendar_event_feed_uri
+
+ def get_calendars_feed(self, uri,
+ desired_class=gdata.calendar.data.CalendarFeed,
+ auth_token=None, **kwargs):
+ """Obtains a calendar feed.
+
+ Args:
+ uri: The uri of the calendar feed to request.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_feed(uri, auth_token=auth_token,
+ desired_class=desired_class, **kwargs)
+
+ GetCalendarsFeed = get_calendars_feed
+
+ def get_own_calendars_feed(self,
+ desired_class=gdata.calendar.data.CalendarFeed,
+ auth_token=None, **kwargs):
+ """Obtains a feed containing the calendars owned by the current user.
+
+ Args:
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.GetCalendarsFeed(uri=self.GetCalendarFeedUri(feed='owncalendars'),
+ desired_class=desired_class, auth_token=auth_token,
+ **kwargs)
+
+ GetOwnCalendarsFeed = get_own_calendars_feed
+
+ def get_all_calendars_feed(self, desired_class=gdata.calendar.data.CalendarFeed,
+ auth_token=None, **kwargs):
+ """Obtains a feed containing all the ccalendars the current user has access to.
+
+ Args:
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.GetCalendarsFeed(uri=self.GetCalendarFeedUri(feed='allcalendars'),
+ desired_class=desired_class, auth_token=auth_token,
+ **kwargs)
+
+ GetAllCalendarsFeed = get_all_calendars_feed
+
+ def get_calendar_entry(self, uri, desired_class=gdata.calendar.data.CalendarEntry,
+ auth_token=None, **kwargs):
+ """Obtains a single calendar entry.
+
+ Args:
+ uri: The uri of the desired calendar entry.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarEntry.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_entry(uri, auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetCalendarEntry = get_calendar_entry
+
+ def get_calendar_event_feed(self, uri=None,
+ desired_class=gdata.calendar.data.CalendarEventFeed,
+ auth_token=None, **kwargs):
+ """Obtains a feed of events for the desired calendar.
+
+ Args:
+ uri: The uri of the desired calendar entry.
+ Defaults to https://www.google.com/calendar/feeds/default/private/full.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarEventFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ uri = uri or self.GetCalendarEventFeedUri()
+ return self.get_feed(uri, auth_token=auth_token,
+ desired_class=desired_class, **kwargs)
+
+ GetCalendarEventFeed = get_calendar_event_feed
+
+ def get_event_entry(self, uri, desired_class=gdata.calendar.data.CalendarEventEntry,
+ auth_token=None, **kwargs):
+ """Obtains a single event entry.
+
+ Args:
+ uri: The uri of the desired calendar event entry.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarEventEntry.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_entry(uri, auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetEventEntry = get_event_entry
+
+ def get_calendar_acl_feed(self, uri='https://www.google.com/calendar/feeds/default/acl/full',
+ desired_class=gdata.calendar.data.CalendarAclFeed,
+ auth_token=None, **kwargs):
+ """Obtains an Access Control List feed.
+
+ Args:
+ uri: The uri of the desired Acl feed.
+ Defaults to https://www.google.com/calendar/feeds/default/acl/full.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarAclFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_feed(uri, auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetCalendarAclFeed = get_calendar_acl_feed
+
+ def get_calendar_acl_entry(self, uri, desired_class=gdata.calendar.data.CalendarAclEntry,
+ auth_token=None, **kwargs):
+ """Obtains a single Access Control List entry.
+
+ Args:
+ uri: The uri of the desired Acl feed.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarAclEntry.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_entry(uri, auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetCalendarAclEntry = get_calendar_acl_entry
+
+ def insert_calendar(self, new_calendar, insert_uri=None, auth_token=None, **kwargs):
+ """Adds an new calendar to Google Calendar.
+
+ Args:
+ new_calendar: atom.Entry or subclass A new calendar which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new contacts to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the contact created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ insert_uri = insert_uri or self.GetCalendarFeedUri(feed='owncalendars')
+ return self.Post(new_calendar, insert_uri,
+ auth_token=auth_token, **kwargs)
+
+ InsertCalendar = insert_calendar
+
+ def insert_calendar_subscription(self, calendar, insert_uri=None,
+ auth_token=None, **kwargs):
+ """Subscribes the authenticated user to the provided calendar.
+
+ Args:
+ calendar: The calendar to which the user should be subscribed.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the subscription created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ insert_uri = insert_uri or self.GetCalendarFeedUri(feed='allcalendars')
+ return self.Post(calendar, insert_uri, auth_token=auth_token, **kwargs)
+
+ InsertCalendarSubscription = insert_calendar_subscription
+
+ def insert_event(self, new_event, insert_uri=None, auth_token=None, **kwargs):
+ """Adds an new event to Google Calendar.
+
+ Args:
+ new_event: atom.Entry or subclass A new event which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new contacts to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the contact created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ insert_uri = insert_uri or self.GetCalendarEventFeedUri()
+ return self.Post(new_event, insert_uri,
+ auth_token=auth_token, **kwargs)
+
+
+ InsertEvent = insert_event
+
+ def insert_acl_entry(self, new_acl_entry,
+ insert_uri = 'https://www.google.com/calendar/feeds/default/acl/full',
+ auth_token=None, **kwargs):
+ """Adds an new Acl entry to Google Calendar.
+
+ Args:
+ new_acl_event: atom.Entry or subclass A new acl which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new contacts to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the contact created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ return self.Post(new_acl_entry, insert_uri, auth_token=auth_token, **kwargs)
+
+ InsertAclEntry = insert_acl_entry
+
+ def execute_batch(self, batch_feed, url, desired_class=None):
+ """Sends a batch request feed to the server.
+
+ Args:
+ batch_feed: gdata.contacts.CalendarEventFeed A feed containing batch
+ request entries. Each entry contains the operation to be performed
+ on the data contained in the entry. For example an entry with an
+ operation type of insert will be used as if the individual entry
+ had been inserted.
+ url: str The batch URL to which these operations should be applied.
+ converter: Function (optional) The function used to convert the server's
+ response to an object.
+
+ Returns:
+ The results of the batch request's execution on the server. If the
+ default converter is used, this is stored in a ContactsFeed.
+ """
+ return self.Post(batch_feed, url, desired_class=desired_class)
+
+ ExecuteBatch = execute_batch
+
+ def update(self, entry, auth_token=None, **kwargs):
+ """Edits the entry on the server by sending the XML for this entry.
+
+ Performs a PUT and converts the response to a new entry object with a
+ matching class to the entry passed in.
+
+ Args:
+ entry:
+ auth_token:
+
+ Returns:
+ A new Entry object of a matching type to the entry which was passed in.
+ """
+ return gdata.client.GDClient.Update(self, entry, auth_token=auth_token,
+ force=True, **kwargs)
+
+ Update = update
+
+
+class CalendarEventQuery(gdata.client.Query):
+ """
+ Create a custom Calendar Query
+
+ Full specs can be found at: U{Calendar query parameters reference
+ <http://code.google.com/apis/calendar/data/2.0/reference.html#Parameters>}
+ """
+
+ def __init__(self, feed=None, ctz=None, fields=None, futureevents=None,
+ max_attendees=None, orderby=None, recurrence_expansion_start=None,
+ recurrence_expansion_end=None, singleevents=None, showdeleted=None,
+ showhidden=None, sortorder=None, start_min=None, start_max=None,
+ updated_min=None, **kwargs):
+ """
+ @param max_results: The maximum number of entries to return. If you want
+ to receive all of the contacts, rather than only the default maximum, you
+ can specify a very large number for max-results.
+ @param start-index: The 1-based index of the first result to be retrieved.
+ @param updated-min: The lower bound on entry update dates.
+ @param group: Constrains the results to only the contacts belonging to the
+ group specified. Value of this parameter specifies group ID
+ @param orderby: Sorting criterion. The only supported value is
+ lastmodified.
+ @param showdeleted: Include deleted contacts in the returned contacts feed
+ @pram sortorder: Sorting order direction. Can be either ascending or
+ descending.
+ @param requirealldeleted: Only relevant if showdeleted and updated-min
+ are also provided. It dictates the behavior of the server in case it
+ detects that placeholders of some entries deleted since the point in
+ time specified as updated-min may have been lost.
+ """
+ gdata.client.Query.__init__(self, **kwargs)
+ self.ctz = ctz
+ self.fields = fields
+ self.futureevents = futureevents
+ self.max_attendees = max_attendees
+ self.orderby = orderby
+ self.recurrence_expansion_start = recurrence_expansion_start
+ self.recurrence_expansion_end = recurrence_expansion_end
+ self.singleevents = singleevents
+ self.showdeleted = showdeleted
+ self.showhidden = showhidden
+ self.sortorder = sortorder
+ self.start_min = start_min
+ self.start_max = start_max
+ self.updated_min = updated_min
+
+ def modify_request(self, http_request):
+ if self.ctz:
+ gdata.client._add_query_param('ctz', self.ctz, http_request)
+ if self.fields:
+ gdata.client._add_query_param('fields', self.fields, http_request)
+ if self.futureevents:
+ gdata.client._add_query_param('futureevents', self.futureevents, http_request)
+ if self.max_attendees:
+ gdata.client._add_query_param('max-attendees', self.max_attendees, http_request)
+ if self.orderby:
+ gdata.client._add_query_param('orderby', self.orderby, http_request)
+ if self.recurrence_expansion_start:
+ gdata.client._add_query_param('recurrence-expansion-start',
+ self.recurrence_expansion_start, http_request)
+ if self.recurrence_expansion_end:
+ gdata.client._add_query_param('recurrence-expansion-end',
+ self.recurrence_expansion_end, http_request)
+ if self.singleevents:
+ gdata.client._add_query_param('singleevents', self.singleevents, http_request)
+ if self.showdeleted:
+ gdata.client._add_query_param('showdeleted', self.showdeleted, http_request)
+ if self.showhidden:
+ gdata.client._add_query_param('showhidden', self.showhidden, http_request)
+ if self.sortorder:
+ gdata.client._add_query_param('sortorder', self.sortorder, http_request)
+ if self.start_min:
+ gdata.client._add_query_param('start-min', self.start_min, http_request)
+ if self.start_max:
+ gdata.client._add_query_param('start-max', self.start_max, http_request)
+ if self.updated_min:
+ gdata.client._add_query_param('updated-min', self.updated_min, http_request)
+ gdata.client.Query.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
+
+
+
diff --git a/samples/apps/marketplace_sample/gdata/calendar/data.py b/samples/apps/marketplace_sample/gdata/calendar/data.py
new file mode 100644
index 0000000..0a0235e
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/calendar/data.py
@@ -0,0 +1,327 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains the data classes of the Google Calendar Data API"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+import atom.data
+import gdata.acl.data
+import gdata.data
+import gdata.geo.data
+import gdata.opensearch.data
+
+
+GCAL_NAMESPACE = 'http://schemas.google.com/gCal/2005'
+GCAL_TEMPLATE = '{%s}%%s' % GCAL_NAMESPACE
+WEB_CONTENT_LINK_REL = '%s/%s' % (GCAL_NAMESPACE, 'webContent')
+
+
+class AccessLevelProperty(atom.core.XmlElement):
+ """Describes how much a given user may do with an event or calendar"""
+ _qname = GCAL_TEMPLATE % 'accesslevel'
+ value = 'value'
+
+
+class AllowGSync2Property(atom.core.XmlElement):
+ """Whether the user is permitted to run Google Apps Sync"""
+ _qname = GCAL_TEMPLATE % 'allowGSync2'
+ value = 'value'
+
+
+class AllowGSyncProperty(atom.core.XmlElement):
+ """Whether the user is permitted to run Google Apps Sync"""
+ _qname = GCAL_TEMPLATE % 'allowGSync'
+ value = 'value'
+
+
+class AnyoneCanAddSelfProperty(atom.core.XmlElement):
+ """Whether anyone can add self as attendee"""
+ _qname = GCAL_TEMPLATE % 'anyoneCanAddSelf'
+ value = 'value'
+
+
+class CalendarAclRole(gdata.acl.data.AclRole):
+ """Describes the Calendar roles of an entry in the Calendar access control list"""
+ _qname = gdata.acl.data.GACL_TEMPLATE % 'role'
+
+
+class CalendarCommentEntry(gdata.data.GDEntry):
+ """Describes an entry in a feed of a Calendar event's comments"""
+
+
+class CalendarCommentFeed(gdata.data.GDFeed):
+ """Describes feed of a Calendar event's comments"""
+ entry = [CalendarCommentEntry]
+
+
+class CalendarComments(gdata.data.Comments):
+ """Describes a container of a feed link for Calendar comment entries"""
+ _qname = gdata.data.GD_TEMPLATE % 'comments'
+
+
+class CalendarExtendedProperty(gdata.data.ExtendedProperty):
+ """Defines a value for the realm attribute that is used only in the calendar API"""
+ _qname = gdata.data.GD_TEMPLATE % 'extendedProperty'
+
+
+class CalendarWhere(gdata.data.Where):
+ """Extends the base Where class with Calendar extensions"""
+ _qname = gdata.data.GD_TEMPLATE % 'where'
+
+
+class ColorProperty(atom.core.XmlElement):
+ """Describes the color of a calendar"""
+ _qname = GCAL_TEMPLATE % 'color'
+ value = 'value'
+
+
+class GuestsCanInviteOthersProperty(atom.core.XmlElement):
+ """Whether guests can invite others to the event"""
+ _qname = GCAL_TEMPLATE % 'guestsCanInviteOthers'
+ value = 'value'
+
+
+class GuestsCanModifyProperty(atom.core.XmlElement):
+ """Whether guests can modify event"""
+ _qname = GCAL_TEMPLATE % 'guestsCanModify'
+ value = 'value'
+
+
+class GuestsCanSeeGuestsProperty(atom.core.XmlElement):
+ """Whether guests can see other attendees"""
+ _qname = GCAL_TEMPLATE % 'guestsCanSeeGuests'
+ value = 'value'
+
+
+class HiddenProperty(atom.core.XmlElement):
+ """Describes whether a calendar is hidden"""
+ _qname = GCAL_TEMPLATE % 'hidden'
+ value = 'value'
+
+
+class IcalUIDProperty(atom.core.XmlElement):
+ """Describes the UID in the ical export of the event"""
+ _qname = GCAL_TEMPLATE % 'uid'
+ value = 'value'
+
+
+class OverrideNameProperty(atom.core.XmlElement):
+ """Describes the override name property of a calendar"""
+ _qname = GCAL_TEMPLATE % 'overridename'
+ value = 'value'
+
+
+class PrivateCopyProperty(atom.core.XmlElement):
+ """Indicates whether this is a private copy of the event, changes to which should not be sent to other calendars"""
+ _qname = GCAL_TEMPLATE % 'privateCopy'
+ value = 'value'
+
+
+class QuickAddProperty(atom.core.XmlElement):
+ """Describes whether gd:content is for quick-add processing"""
+ _qname = GCAL_TEMPLATE % 'quickadd'
+ value = 'value'
+
+
+class ResourceProperty(atom.core.XmlElement):
+ """Describes whether gd:who is a resource such as a conference room"""
+ _qname = GCAL_TEMPLATE % 'resource'
+ value = 'value'
+ id = 'id'
+
+
+class EventWho(gdata.data.Who):
+ """Extends the base Who class with Calendar extensions"""
+ _qname = gdata.data.GD_TEMPLATE % 'who'
+ resource = ResourceProperty
+
+
+class SelectedProperty(atom.core.XmlElement):
+ """Describes whether a calendar is selected"""
+ _qname = GCAL_TEMPLATE % 'selected'
+ value = 'value'
+
+
+class SendAclNotificationsProperty(atom.core.XmlElement):
+ """Describes whether to send ACL notifications to grantees"""
+ _qname = GCAL_TEMPLATE % 'sendAclNotifications'
+ value = 'value'
+
+
+class CalendarAclEntry(gdata.acl.data.AclEntry):
+ """Describes an entry in a feed of a Calendar access control list (ACL)"""
+ send_acl_notifications = SendAclNotificationsProperty
+
+
+class CalendarAclFeed(gdata.data.GDFeed):
+ """Describes a Calendar access contorl list (ACL) feed"""
+ entry = [CalendarAclEntry]
+
+
+class SendEventNotificationsProperty(atom.core.XmlElement):
+ """Describes whether to send event notifications to other participants of the event"""
+ _qname = GCAL_TEMPLATE % 'sendEventNotifications'
+ value = 'value'
+
+
+class SequenceNumberProperty(atom.core.XmlElement):
+ """Describes sequence number of an event"""
+ _qname = GCAL_TEMPLATE % 'sequence'
+ value = 'value'
+
+
+class CalendarRecurrenceExceptionEntry(gdata.data.GDEntry):
+ """Describes an entry used by a Calendar recurrence exception entry link"""
+ uid = IcalUIDProperty
+ sequence = SequenceNumberProperty
+
+
+class CalendarRecurrenceException(gdata.data.RecurrenceException):
+ """Describes an exception to a recurring Calendar event"""
+ _qname = gdata.data.GD_TEMPLATE % 'recurrenceException'
+
+
+class SettingsProperty(atom.core.XmlElement):
+ """User preference name-value pair"""
+ _qname = GCAL_TEMPLATE % 'settingsProperty'
+ name = 'name'
+ value = 'value'
+
+
+class SettingsEntry(gdata.data.GDEntry):
+ """Describes a Calendar Settings property entry"""
+ settings_property = SettingsProperty
+
+
+class CalendarSettingsFeed(gdata.data.GDFeed):
+ """Personal settings for Calendar application"""
+ entry = [SettingsEntry]
+
+
+class SuppressReplyNotificationsProperty(atom.core.XmlElement):
+ """Lists notification methods to be suppressed for this reply"""
+ _qname = GCAL_TEMPLATE % 'suppressReplyNotifications'
+ methods = 'methods'
+
+
+class SyncEventProperty(atom.core.XmlElement):
+ """Describes whether this is a sync scenario where the Ical UID and Sequence number are honored during inserts and updates"""
+ _qname = GCAL_TEMPLATE % 'syncEvent'
+ value = 'value'
+
+
+class When(gdata.data.When):
+ """Extends the gd:when element to add reminders"""
+ reminder = [gdata.data.Reminder]
+
+
+class CalendarEventEntry(gdata.data.BatchEntry):
+ """Describes a Calendar event entry"""
+ quick_add = QuickAddProperty
+ send_event_notifications = SendEventNotificationsProperty
+ sync_event = SyncEventProperty
+ anyone_can_add_self = AnyoneCanAddSelfProperty
+ extended_property = [CalendarExtendedProperty]
+ sequence = SequenceNumberProperty
+ guests_can_invite_others = GuestsCanInviteOthersProperty
+ guests_can_modify = GuestsCanModifyProperty
+ guests_can_see_guests = GuestsCanSeeGuestsProperty
+ georss_where = gdata.geo.data.GeoRssWhere
+ private_copy = PrivateCopyProperty
+ suppress_reply_notifications = SuppressReplyNotificationsProperty
+ uid = IcalUIDProperty
+ where = [gdata.data.Where]
+ when = [When]
+ who = [gdata.data.Who]
+ transparency = gdata.data.Transparency
+ comments = gdata.data.Comments
+ event_status = gdata.data.EventStatus
+ visibility = gdata.data.Visibility
+ recurrence = gdata.data.Recurrence
+ recurrence_exception = [gdata.data.RecurrenceException]
+ original_event = gdata.data.OriginalEvent
+ reminder = [gdata.data.Reminder]
+
+
+class TimeZoneProperty(atom.core.XmlElement):
+ """Describes the time zone of a calendar"""
+ _qname = GCAL_TEMPLATE % 'timezone'
+ value = 'value'
+
+
+class TimesCleanedProperty(atom.core.XmlElement):
+ """Describes how many times calendar was cleaned via Manage Calendars"""
+ _qname = GCAL_TEMPLATE % 'timesCleaned'
+ value = 'value'
+
+
+class CalendarEntry(gdata.data.GDEntry):
+ """Describes a Calendar entry in the feed of a user's calendars"""
+ timezone = TimeZoneProperty
+ overridename = OverrideNameProperty
+ hidden = HiddenProperty
+ selected = SelectedProperty
+ times_cleaned = TimesCleanedProperty
+ color = ColorProperty
+ where = [CalendarWhere]
+ accesslevel = AccessLevelProperty
+
+
+class CalendarEventFeed(gdata.data.BatchFeed):
+ """Describes a Calendar event feed"""
+ allow_g_sync2 = AllowGSync2Property
+ timezone = TimeZoneProperty
+ entry = [CalendarEventEntry]
+ times_cleaned = TimesCleanedProperty
+ allow_g_sync = AllowGSyncProperty
+
+
+class CalendarFeed(gdata.data.GDFeed):
+ """Describes a feed of Calendars"""
+ entry = [CalendarEntry]
+
+
+class WebContentGadgetPref(atom.core.XmlElement):
+ """Describes a single web content gadget preference"""
+ _qname = GCAL_TEMPLATE % 'webContentGadgetPref'
+ name = 'name'
+ value = 'value'
+
+
+class WebContent(atom.core.XmlElement):
+ """Describes a "web content" extension"""
+ _qname = GCAL_TEMPLATE % 'webContent'
+ height = 'height'
+ width = 'width'
+ web_content_gadget_pref = [WebContentGadgetPref]
+ url = 'url'
+ display = 'display'
+
+
+class WebContentLink(atom.data.Link):
+ """Describes a "web content" link"""
+ def __init__(self, title=None, href=None, link_type=None,
+ web_content=None):
+ atom.data.Link.__init__(self, rel=WEB_CONTENT_LINK_REL, title=title, href=href,
+ link_type=link_type)
+
+ web_content = WebContent
+
diff --git a/samples/apps/marketplace_sample/gdata/calendar/service.py b/samples/apps/marketplace_sample/gdata/calendar/service.py
new file mode 100755
index 0000000..53a94e3
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/calendar/service.py
@@ -0,0 +1,595 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""CalendarService extends the GDataService to streamline Google Calendar operations.
+
+ CalendarService: Provides methods to query feeds and manipulate items. Extends
+ GDataService.
+
+ DictionaryToParamList: Function which converts a dictionary into a list of
+ URL arguments (represented as strings). This is a
+ utility function used in CRUD operations.
+"""
+
+
+__author__ = 'api.vli (Vivian Li)'
+
+
+import urllib
+import gdata
+import atom.service
+import gdata.service
+import gdata.calendar
+import atom
+
+
+DEFAULT_BATCH_URL = ('http://www.google.com/calendar/feeds/default/private'
+ '/full/batch')
+
+
+class Error(Exception):
+ pass
+
+
+class RequestError(Error):
+ pass
+
+
+class CalendarService(gdata.service.GDataService):
+ """Client for the Google Calendar service."""
+
+ def __init__(self, email=None, password=None, source=None,
+ server='www.google.com', additional_headers=None, **kwargs):
+ """Creates a client for the Google Calendar service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'www.google.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='cl', source=source,
+ server=server, additional_headers=additional_headers, **kwargs)
+
+ def GetCalendarEventFeed(self, uri='/calendar/feeds/default/private/full'):
+ return self.Get(uri, converter=gdata.calendar.CalendarEventFeedFromString)
+
+ def GetCalendarEventEntry(self, uri):
+ return self.Get(uri, converter=gdata.calendar.CalendarEventEntryFromString)
+
+ def GetCalendarListFeed(self, uri='/calendar/feeds/default/allcalendars/full'):
+ return self.Get(uri, converter=gdata.calendar.CalendarListFeedFromString)
+
+ def GetAllCalendarsFeed(self, uri='/calendar/feeds/default/allcalendars/full'):
+ return self.Get(uri, converter=gdata.calendar.CalendarListFeedFromString)
+
+ def GetOwnCalendarsFeed(self, uri='/calendar/feeds/default/owncalendars/full'):
+ return self.Get(uri, converter=gdata.calendar.CalendarListFeedFromString)
+
+ def GetCalendarListEntry(self, uri):
+ return self.Get(uri, converter=gdata.calendar.CalendarListEntryFromString)
+
+ def GetCalendarAclFeed(self, uri='/calendar/feeds/default/acl/full'):
+ return self.Get(uri, converter=gdata.calendar.CalendarAclFeedFromString)
+
+ def GetCalendarAclEntry(self, uri):
+ return self.Get(uri, converter=gdata.calendar.CalendarAclEntryFromString)
+
+ def GetCalendarEventCommentFeed(self, uri):
+ return self.Get(uri, converter=gdata.calendar.CalendarEventCommentFeedFromString)
+
+ def GetCalendarEventCommentEntry(self, uri):
+ return self.Get(uri, converter=gdata.calendar.CalendarEventCommentEntryFromString)
+
+ def Query(self, uri, converter=None):
+ """Performs a query and returns a resulting feed or entry.
+
+ Args:
+ feed: string The feed which is to be queried
+
+ Returns:
+ On success, a GDataFeed or Entry depending on which is sent from the
+ server.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ if converter:
+ result = self.Get(uri, converter=converter)
+ else:
+ result = self.Get(uri)
+ return result
+
+ def CalendarQuery(self, query):
+ if isinstance(query, CalendarEventQuery):
+ return self.Query(query.ToUri(),
+ converter=gdata.calendar.CalendarEventFeedFromString)
+ elif isinstance(query, CalendarListQuery):
+ return self.Query(query.ToUri(),
+ converter=gdata.calendar.CalendarListFeedFromString)
+ elif isinstance(query, CalendarEventCommentQuery):
+ return self.Query(query.ToUri(),
+ converter=gdata.calendar.CalendarEventCommentFeedFromString)
+ else:
+ return self.Query(query.ToUri())
+
+ def InsertEvent(self, new_event, insert_uri, url_params=None,
+ escape_params=True):
+ """Adds an event to Google Calendar.
+
+ Args:
+ new_event: atom.Entry or subclass A new event which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new events to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the event created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ return self.Post(new_event, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarEventEntryFromString)
+
+ def InsertCalendarSubscription(self, calendar, url_params=None,
+ escape_params=True):
+ """Subscribes the authenticated user to the provided calendar.
+
+ Args:
+ calendar: The calendar to which the user should be subscribed.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the subscription created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ insert_uri = '/calendar/feeds/default/allcalendars/full'
+ return self.Post(calendar, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarListEntryFromString)
+
+ def InsertCalendar(self, new_calendar, url_params=None,
+ escape_params=True):
+ """Creates a new calendar.
+
+ Args:
+ new_calendar: The calendar to be created
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the calendar created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ insert_uri = '/calendar/feeds/default/owncalendars/full'
+ response = self.Post(new_calendar, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarListEntryFromString)
+ return response
+
+ def UpdateCalendar(self, calendar, url_params=None,
+ escape_params=True):
+ """Updates a calendar.
+
+ Args:
+ calendar: The calendar which should be updated
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the calendar created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ update_uri = calendar.GetEditLink().href
+ response = self.Put(data=calendar, uri=update_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarListEntryFromString)
+ return response
+
+ def InsertAclEntry(self, new_entry, insert_uri, url_params=None,
+ escape_params=True):
+ """Adds an ACL entry (rule) to Google Calendar.
+
+ Args:
+ new_entry: atom.Entry or subclass A new ACL entry which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new entries to the ACL feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the ACL entry created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ return self.Post(new_entry, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarAclEntryFromString)
+
+ def InsertEventComment(self, new_entry, insert_uri, url_params=None,
+ escape_params=True):
+ """Adds an entry to Google Calendar.
+
+ Args:
+ new_entry: atom.Entry or subclass A new entry which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new entrys to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the comment created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ return self.Post(new_entry, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarEventCommentEntryFromString)
+
+ def _RemoveStandardUrlPrefix(self, url):
+ url_prefix = 'http://%s/' % self.server
+ if url.startswith(url_prefix):
+ return url[len(url_prefix) - 1:]
+ return url
+
+ def DeleteEvent(self, edit_uri, extra_headers=None,
+ url_params=None, escape_params=True):
+ """Removes an event with the specified ID from Google Calendar.
+
+ Args:
+ edit_uri: string The edit URL of the entry to be deleted. Example:
+ 'http://www.google.com/calendar/feeds/default/private/full/abx'
+ url_params: dict (optional) Additional URL parameters to be included
+ in the deletion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful delete, a httplib.HTTPResponse containing the server's
+ response to the DELETE request.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ edit_uri = self._RemoveStandardUrlPrefix(edit_uri)
+ return self.Delete('%s' % edit_uri,
+ url_params=url_params, escape_params=escape_params)
+
+ def DeleteAclEntry(self, edit_uri, extra_headers=None,
+ url_params=None, escape_params=True):
+ """Removes an ACL entry at the given edit_uri from Google Calendar.
+
+ Args:
+ edit_uri: string The edit URL of the entry to be deleted. Example:
+ 'http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/default'
+ url_params: dict (optional) Additional URL parameters to be included
+ in the deletion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful delete, a httplib.HTTPResponse containing the server's
+ response to the DELETE request.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ edit_uri = self._RemoveStandardUrlPrefix(edit_uri)
+ return self.Delete('%s' % edit_uri,
+ url_params=url_params, escape_params=escape_params)
+
+ def DeleteCalendarEntry(self, edit_uri, extra_headers=None,
+ url_params=None, escape_params=True):
+ """Removes a calendar entry at the given edit_uri from Google Calendar.
+
+ Args:
+ edit_uri: string The edit URL of the entry to be deleted. Example:
+ 'http://www.google.com/calendar/feeds/default/allcalendars/abcdef@group.calendar.google.com'
+ url_params: dict (optional) Additional URL parameters to be included
+ in the deletion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful delete, True is returned
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ return self.Delete(edit_uri, url_params=url_params,
+ escape_params=escape_params)
+
+ def UpdateEvent(self, edit_uri, updated_event, url_params=None,
+ escape_params=True):
+ """Updates an existing event.
+
+ Args:
+ edit_uri: string The edit link URI for the element being updated
+ updated_event: string, atom.Entry, or subclass containing
+ the Atom Entry which will replace the event which is
+ stored at the edit_url
+ url_params: dict (optional) Additional URL parameters to be included
+ in the update request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful update, a httplib.HTTPResponse containing the server's
+ response to the PUT request.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ edit_uri = self._RemoveStandardUrlPrefix(edit_uri)
+ return self.Put(updated_event, '%s' % edit_uri,
+ url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarEventEntryFromString)
+
+ def UpdateAclEntry(self, edit_uri, updated_rule, url_params=None,
+ escape_params=True):
+ """Updates an existing ACL rule.
+
+ Args:
+ edit_uri: string The edit link URI for the element being updated
+ updated_rule: string, atom.Entry, or subclass containing
+ the Atom Entry which will replace the event which is
+ stored at the edit_url
+ url_params: dict (optional) Additional URL parameters to be included
+ in the update request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful update, a httplib.HTTPResponse containing the server's
+ response to the PUT request.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ edit_uri = self._RemoveStandardUrlPrefix(edit_uri)
+ return self.Put(updated_rule, '%s' % edit_uri,
+ url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarAclEntryFromString)
+
+ def ExecuteBatch(self, batch_feed, url,
+ converter=gdata.calendar.CalendarEventFeedFromString):
+ """Sends a batch request feed to the server.
+
+ The batch request needs to be sent to the batch URL for a particular
+ calendar. You can find the URL by calling GetBatchLink().href on the
+ CalendarEventFeed.
+
+ Args:
+ batch_feed: gdata.calendar.CalendarEventFeed A feed containing batch
+ request entries. Each entry contains the operation to be performed
+ on the data contained in the entry. For example an entry with an
+ operation type of insert will be used as if the individual entry
+ had been inserted.
+ url: str The batch URL for the Calendar to which these operations should
+ be applied.
+ converter: Function (optional) The function used to convert the server's
+ response to an object. The default value is
+ CalendarEventFeedFromString.
+
+ Returns:
+ The results of the batch request's execution on the server. If the
+ default converter is used, this is stored in a CalendarEventFeed.
+ """
+ return self.Post(batch_feed, url, converter=converter)
+
+
+class CalendarEventQuery(gdata.service.Query):
+
+ def __init__(self, user='default', visibility='private', projection='full',
+ text_query=None, params=None, categories=None):
+ gdata.service.Query.__init__(self,
+ feed='http://www.google.com/calendar/feeds/%s/%s/%s' % (
+ urllib.quote(user),
+ urllib.quote(visibility),
+ urllib.quote(projection)),
+ text_query=text_query, params=params, categories=categories)
+
+ def _GetStartMin(self):
+ if 'start-min' in self.keys():
+ return self['start-min']
+ else:
+ return None
+
+ def _SetStartMin(self, val):
+ self['start-min'] = val
+
+ start_min = property(_GetStartMin, _SetStartMin,
+ doc="""The start-min query parameter""")
+
+ def _GetStartMax(self):
+ if 'start-max' in self.keys():
+ return self['start-max']
+ else:
+ return None
+
+ def _SetStartMax(self, val):
+ self['start-max'] = val
+
+ start_max = property(_GetStartMax, _SetStartMax,
+ doc="""The start-max query parameter""")
+
+ def _GetOrderBy(self):
+ if 'orderby' in self.keys():
+ return self['orderby']
+ else:
+ return None
+
+ def _SetOrderBy(self, val):
+ if val is not 'lastmodified' and val is not 'starttime':
+ raise Error, "Order By must be either 'lastmodified' or 'starttime'"
+ self['orderby'] = val
+
+ orderby = property(_GetOrderBy, _SetOrderBy,
+ doc="""The orderby query parameter""")
+
+ def _GetSortOrder(self):
+ if 'sortorder' in self.keys():
+ return self['sortorder']
+ else:
+ return None
+
+ def _SetSortOrder(self, val):
+ if (val is not 'ascending' and val is not 'descending'
+ and val is not 'a' and val is not 'd' and val is not 'ascend'
+ and val is not 'descend'):
+ raise Error, "Sort order must be either ascending, ascend, " + (
+ "a or descending, descend, or d")
+ self['sortorder'] = val
+
+ sortorder = property(_GetSortOrder, _SetSortOrder,
+ doc="""The sortorder query parameter""")
+
+ def _GetSingleEvents(self):
+ if 'singleevents' in self.keys():
+ return self['singleevents']
+ else:
+ return None
+
+ def _SetSingleEvents(self, val):
+ self['singleevents'] = val
+
+ singleevents = property(_GetSingleEvents, _SetSingleEvents,
+ doc="""The singleevents query parameter""")
+
+ def _GetFutureEvents(self):
+ if 'futureevents' in self.keys():
+ return self['futureevents']
+ else:
+ return None
+
+ def _SetFutureEvents(self, val):
+ self['futureevents'] = val
+
+ futureevents = property(_GetFutureEvents, _SetFutureEvents,
+ doc="""The futureevents query parameter""")
+
+ def _GetRecurrenceExpansionStart(self):
+ if 'recurrence-expansion-start' in self.keys():
+ return self['recurrence-expansion-start']
+ else:
+ return None
+
+ def _SetRecurrenceExpansionStart(self, val):
+ self['recurrence-expansion-start'] = val
+
+ recurrence_expansion_start = property(_GetRecurrenceExpansionStart,
+ _SetRecurrenceExpansionStart,
+ doc="""The recurrence-expansion-start query parameter""")
+
+ def _GetRecurrenceExpansionEnd(self):
+ if 'recurrence-expansion-end' in self.keys():
+ return self['recurrence-expansion-end']
+ else:
+ return None
+
+ def _SetRecurrenceExpansionEnd(self, val):
+ self['recurrence-expansion-end'] = val
+
+ recurrence_expansion_end = property(_GetRecurrenceExpansionEnd,
+ _SetRecurrenceExpansionEnd,
+ doc="""The recurrence-expansion-end query parameter""")
+
+ def _SetTimezone(self, val):
+ self['ctz'] = val
+
+ def _GetTimezone(self):
+ if 'ctz' in self.keys():
+ return self['ctz']
+ else:
+ return None
+
+ ctz = property(_GetTimezone, _SetTimezone,
+ doc="""The ctz query parameter which sets report time on the server.""")
+
+
+class CalendarListQuery(gdata.service.Query):
+ """Queries the Google Calendar meta feed"""
+
+ def __init__(self, userId=None, text_query=None,
+ params=None, categories=None):
+ if userId is None:
+ userId = 'default'
+
+ gdata.service.Query.__init__(self, feed='http://www.google.com/calendar/feeds/'
+ +userId,
+ text_query=text_query, params=params,
+ categories=categories)
+
+class CalendarEventCommentQuery(gdata.service.Query):
+ """Queries the Google Calendar event comments feed"""
+
+ def __init__(self, feed=None):
+ gdata.service.Query.__init__(self, feed=feed)
diff --git a/samples/apps/marketplace_sample/gdata/client.py b/samples/apps/marketplace_sample/gdata/client.py
new file mode 100644
index 0000000..9f5afb5
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/client.py
@@ -0,0 +1,1194 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2008, 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+"""Provides a client to interact with Google Data API servers.
+
+This module is used for version 2 of the Google Data APIs. The primary class
+in this module is GDClient.
+
+ GDClient: handles auth and CRUD operations when communicating with servers.
+ GDataClient: deprecated client for version one services. Will be removed.
+"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import re
+import atom.client
+import atom.core
+import atom.http_core
+import gdata.gauth
+import gdata.data
+
+
+class Error(Exception):
+ pass
+
+
+class RequestError(Error):
+ status = None
+ reason = None
+ body = None
+ headers = None
+
+
+class RedirectError(RequestError):
+ pass
+
+
+class CaptchaChallenge(RequestError):
+ captcha_url = None
+ captcha_token = None
+
+
+class ClientLoginTokenMissing(Error):
+ pass
+
+
+class MissingOAuthParameters(Error):
+ pass
+
+
+class ClientLoginFailed(RequestError):
+ pass
+
+
+class UnableToUpgradeToken(RequestError):
+ pass
+
+
+class Unauthorized(Error):
+ pass
+
+
+class BadAuthenticationServiceURL(RedirectError):
+ pass
+
+
+class BadAuthentication(RequestError):
+ pass
+
+
+class NotModified(RequestError):
+ pass
+
+class NotImplemented(RequestError):
+ pass
+
+
+def error_from_response(message, http_response, error_class,
+ response_body=None):
+
+ """Creates a new exception and sets the HTTP information in the error.
+
+ Args:
+ message: str human readable message to be displayed if the exception is
+ not caught.
+ http_response: The response from the server, contains error information.
+ error_class: The exception to be instantiated and populated with
+ information from the http_response
+ response_body: str (optional) specify if the response has already been read
+ from the http_response object.
+ """
+ if response_body is None:
+ body = http_response.read()
+ else:
+ body = response_body
+ error = error_class('%s: %i, %s' % (message, http_response.status, body))
+ error.status = http_response.status
+ error.reason = http_response.reason
+ error.body = body
+ error.headers = atom.http_core.get_headers(http_response)
+ return error
+
+
+def get_xml_version(version):
+ """Determines which XML schema to use based on the client API version.
+
+ Args:
+ version: string which is converted to an int. The version string is in
+ the form 'Major.Minor.x.y.z' and only the major version number
+ is considered. If None is provided assume version 1.
+ """
+ if version is None:
+ return 1
+ return int(version.split('.')[0])
+
+
+class GDClient(atom.client.AtomPubClient):
+ """Communicates with Google Data servers to perform CRUD operations.
+
+ This class is currently experimental and may change in backwards
+ incompatible ways.
+
+ This class exists to simplify the following three areas involved in using
+ the Google Data APIs.
+
+ CRUD Operations:
+
+ The client provides a generic 'request' method for making HTTP requests.
+ There are a number of convenience methods which are built on top of
+ request, which include get_feed, get_entry, get_next, post, update, and
+ delete. These methods contact the Google Data servers.
+
+ Auth:
+
+ Reading user-specific private data requires authorization from the user as
+ do any changes to user data. An auth_token object can be passed into any
+ of the HTTP requests to set the Authorization header in the request.
+
+ You may also want to set the auth_token member to a an object which can
+ use modify_request to set the Authorization header in the HTTP request.
+
+ If you are authenticating using the email address and password, you can
+ use the client_login method to obtain an auth token and set the
+ auth_token member.
+
+ If you are using browser redirects, specifically AuthSub, you will want
+ to use gdata.gauth.AuthSubToken.from_url to obtain the token after the
+ redirect, and you will probably want to updgrade this since use token
+ to a multiple use (session) token using the upgrade_token method.
+
+ API Versions:
+
+ This client is multi-version capable and can be used with Google Data API
+ version 1 and version 2. The version should be specified by setting the
+ api_version member to a string, either '1' or '2'.
+ """
+
+ # The gsessionid is used by Google Calendar to prevent redirects.
+ __gsessionid = None
+ api_version = None
+ # Name of the Google Data service when making a ClientLogin request.
+ auth_service = None
+ # URL prefixes which should be requested for AuthSub and OAuth.
+ auth_scopes = None
+ # Name of alternate auth service to use in certain cases
+ alt_auth_service = None
+
+ def request(self, method=None, uri=None, auth_token=None,
+ http_request=None, converter=None, desired_class=None,
+ redirects_remaining=4, **kwargs):
+ """Make an HTTP request to the server.
+
+ See also documentation for atom.client.AtomPubClient.request.
+
+ If a 302 redirect is sent from the server to the client, this client
+ assumes that the redirect is in the form used by the Google Calendar API.
+ The same request URI and method will be used as in the original request,
+ but a gsessionid URL parameter will be added to the request URI with
+ the value provided in the server's 302 redirect response. If the 302
+ redirect is not in the format specified by the Google Calendar API, a
+ RedirectError will be raised containing the body of the server's
+ response.
+
+ The method calls the client's modify_request method to make any changes
+ required by the client before the request is made. For example, a
+ version 2 client could add a GData-Version: 2 header to the request in
+ its modify_request method.
+
+ Args:
+ method: str The HTTP verb for this request, usually 'GET', 'POST',
+ 'PUT', or 'DELETE'
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others.
+ http_request: (optional) atom.http_core.HttpRequest
+ converter: function which takes the body of the response as its only
+ argument and returns the desired object.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (converter=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned.
+ redirects_remaining: (optional) int, if this number is 0 and the
+ server sends a 302 redirect, the request method
+ will raise an exception. This parameter is used in
+ recursive request calls to avoid an infinite loop.
+
+ Any additional arguments are passed through to
+ atom.client.AtomPubClient.request.
+
+ Returns:
+ An HTTP response object (see atom.http_core.HttpResponse for a
+ description of the object's interface) if no converter was
+ specified and no desired_class was specified. If a converter function
+ was provided, the results of calling the converter are returned. If no
+ converter was specified but a desired_class was provided, the response
+ body will be converted to the class using
+ atom.core.parse.
+ """
+ if isinstance(uri, (str, unicode)):
+ uri = atom.http_core.Uri.parse_uri(uri)
+
+ # Add the gsession ID to the URL to prevent further redirects.
+ # TODO: If different sessions are using the same client, there will be a
+ # multitude of redirects and session ID shuffling.
+ # If the gsession ID is in the URL, adopt it as the standard location.
+ if uri is not None and uri.query is not None and 'gsessionid' in uri.query:
+ self.__gsessionid = uri.query['gsessionid']
+ # The gsession ID could also be in the HTTP request.
+ elif (http_request is not None and http_request.uri is not None
+ and http_request.uri.query is not None
+ and 'gsessionid' in http_request.uri.query):
+ self.__gsessionid = http_request.uri.query['gsessionid']
+ # If the gsession ID is stored in the client, and was not present in the
+ # URI then add it to the URI.
+ elif self.__gsessionid is not None:
+ uri.query['gsessionid'] = self.__gsessionid
+
+ # The AtomPubClient should call this class' modify_request before
+ # performing the HTTP request.
+ #http_request = self.modify_request(http_request)
+
+ response = atom.client.AtomPubClient.request(self, method=method,
+ uri=uri, auth_token=auth_token, http_request=http_request, **kwargs)
+ # On success, convert the response body using the desired converter
+ # function if present.
+ if response is None:
+ return None
+ if response.status == 200 or response.status == 201:
+ if converter is not None:
+ return converter(response)
+ elif desired_class is not None:
+ if self.api_version is not None:
+ return atom.core.parse(response.read(), desired_class,
+ version=get_xml_version(self.api_version))
+ else:
+ # No API version was specified, so allow parse to
+ # use the default version.
+ return atom.core.parse(response.read(), desired_class)
+ else:
+ return response
+ # TODO: move the redirect logic into the Google Calendar client once it
+ # exists since the redirects are only used in the calendar API.
+ elif response.status == 302:
+ if redirects_remaining > 0:
+ location = (response.getheader('Location')
+ or response.getheader('location'))
+ if location is not None:
+ # Make a recursive call with the gsession ID in the URI to follow
+ # the redirect.
+ return self.request(method=method, uri=location,
+ auth_token=auth_token, http_request=http_request,
+ converter=converter, desired_class=desired_class,
+ redirects_remaining=redirects_remaining-1,
+ **kwargs)
+ else:
+ raise error_from_response('302 received without Location header',
+ response, RedirectError)
+ else:
+ raise error_from_response('Too many redirects from server',
+ response, RedirectError)
+ elif response.status == 401:
+ raise error_from_response('Unauthorized - Server responded with',
+ response, Unauthorized)
+ elif response.status == 304:
+ raise error_from_response('Entry Not Modified - Server responded with',
+ response, NotModified)
+ elif response.status == 501:
+ raise error_from_response(
+ 'This API operation is not implemented. - Server responded with',
+ response, NotImplemented)
+ # If the server's response was not a 200, 201, 302, 304, 401, or 501, raise
+ # an exception.
+ else:
+ raise error_from_response('Server responded with', response,
+ RequestError)
+
+ Request = request
+
+ def request_client_login_token(
+ self, email, password, source, service=None,
+ account_type='HOSTED_OR_GOOGLE',
+ auth_url=atom.http_core.Uri.parse_uri(
+ 'https://www.google.com/accounts/ClientLogin'),
+ captcha_token=None, captcha_response=None):
+ service = service or self.auth_service
+ # Set the target URL.
+ http_request = atom.http_core.HttpRequest(uri=auth_url, method='POST')
+ http_request.add_body_part(
+ gdata.gauth.generate_client_login_request_body(email=email,
+ password=password, service=service, source=source,
+ account_type=account_type, captcha_token=captcha_token,
+ captcha_response=captcha_response),
+ 'application/x-www-form-urlencoded')
+
+ # Use the underlying http_client to make the request.
+ response = self.http_client.request(http_request)
+
+ response_body = response.read()
+ if response.status == 200:
+ token_string = gdata.gauth.get_client_login_token_string(response_body)
+ if token_string is not None:
+ return gdata.gauth.ClientLoginToken(token_string)
+ else:
+ raise ClientLoginTokenMissing(
+ 'Recieved a 200 response to client login request,'
+ ' but no token was present. %s' % (response_body,))
+ elif response.status == 403:
+ captcha_challenge = gdata.gauth.get_captcha_challenge(response_body)
+ if captcha_challenge:
+ challenge = CaptchaChallenge('CAPTCHA required')
+ challenge.captcha_url = captcha_challenge['url']
+ challenge.captcha_token = captcha_challenge['token']
+ raise challenge
+ elif response_body.splitlines()[0] == 'Error=BadAuthentication':
+ raise BadAuthentication('Incorrect username or password')
+ else:
+ raise error_from_response('Server responded with a 403 code',
+ response, RequestError, response_body)
+ elif response.status == 302:
+ # Google tries to redirect all bad URLs back to
+ # http://www.google.<locale>. If a redirect
+ # attempt is made, assume the user has supplied an incorrect
+ # authentication URL
+ raise error_from_response('Server responded with a redirect',
+ response, BadAuthenticationServiceURL,
+ response_body)
+ else:
+ raise error_from_response('Server responded to ClientLogin request',
+ response, ClientLoginFailed, response_body)
+
+ RequestClientLoginToken = request_client_login_token
+
+ def client_login(self, email, password, source, service=None,
+ account_type='HOSTED_OR_GOOGLE',
+ auth_url=atom.http_core.Uri.parse_uri(
+ 'https://www.google.com/accounts/ClientLogin'),
+ captcha_token=None, captcha_response=None):
+ """Performs an auth request using the user's email address and password.
+
+ In order to modify user specific data and read user private data, your
+ application must be authorized by the user. One way to demonstrage
+ authorization is by including a Client Login token in the Authorization
+ HTTP header of all requests. This method requests the Client Login token
+ by sending the user's email address, password, the name of the
+ application, and the service code for the service which will be accessed
+ by the application. If the username and password are correct, the server
+ will respond with the client login code and a new ClientLoginToken
+ object will be set in the client's auth_token member. With the auth_token
+ set, future requests from this client will include the Client Login
+ token.
+
+ For a list of service names, see
+ http://code.google.com/apis/gdata/faq.html#clientlogin
+ For more information on Client Login, see:
+ http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html
+
+ Args:
+ email: str The user's email address or username.
+ password: str The password for the user's account.
+ source: str The name of your application. This can be anything you
+ like but should should give some indication of which app is
+ making the request.
+ service: str The service code for the service you would like to access.
+ For example, 'cp' for contacts, 'cl' for calendar. For a full
+ list see
+ http://code.google.com/apis/gdata/faq.html#clientlogin
+ If you are using a subclass of the gdata.client.GDClient, the
+ service will usually be filled in for you so you do not need
+ to specify it. For example see BloggerClient,
+ SpreadsheetsClient, etc.
+ account_type: str (optional) The type of account which is being
+ authenticated. This can be either 'GOOGLE' for a Google
+ Account, 'HOSTED' for a Google Apps Account, or the
+ default 'HOSTED_OR_GOOGLE' which will select the Google
+ Apps Account if the same email address is used for both
+ a Google Account and a Google Apps Account.
+ auth_url: str (optional) The URL to which the login request should be
+ sent.
+ captcha_token: str (optional) If a previous login attempt was reponded
+ to with a CAPTCHA challenge, this is the token which
+ identifies the challenge (from the CAPTCHA's URL).
+ captcha_response: str (optional) If a previous login attempt was
+ reponded to with a CAPTCHA challenge, this is the
+ response text which was contained in the challenge.
+
+ Returns:
+ Generated token, which is also stored in this object.
+
+ Raises:
+ A RequestError or one of its suclasses: BadAuthentication,
+ BadAuthenticationServiceURL, ClientLoginFailed,
+ ClientLoginTokenMissing, or CaptchaChallenge
+ """
+ service = service or self.auth_service
+ self.auth_token = self.request_client_login_token(email, password,
+ source, service=service, account_type=account_type, auth_url=auth_url,
+ captcha_token=captcha_token, captcha_response=captcha_response)
+ if self.alt_auth_service is not None:
+ self.alt_auth_token = self.request_client_login_token(
+ email, password, source, service=self.alt_auth_service,
+ account_type=account_type, auth_url=auth_url,
+ captcha_token=captcha_token, captcha_response=captcha_response)
+ return self.auth_token
+
+ ClientLogin = client_login
+
+ def upgrade_token(self, token=None, url=atom.http_core.Uri.parse_uri(
+ 'https://www.google.com/accounts/AuthSubSessionToken')):
+ """Asks the Google auth server for a multi-use AuthSub token.
+
+ For details on AuthSub, see:
+ http://code.google.com/apis/accounts/docs/AuthSub.html
+
+ Args:
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken
+ (optional) If no token is passed in, the client's auth_token member
+ is used to request the new token. The token object will be modified
+ to contain the new session token string.
+ url: str or atom.http_core.Uri (optional) The URL to which the token
+ upgrade request should be sent. Defaults to:
+ https://www.google.com/accounts/AuthSubSessionToken
+
+ Returns:
+ The upgraded gdata.gauth.AuthSubToken object.
+ """
+ # Default to using the auth_token member if no token is provided.
+ if token is None:
+ token = self.auth_token
+ # We cannot upgrade a None token.
+ if token is None:
+ raise UnableToUpgradeToken('No token was provided.')
+ if not isinstance(token, gdata.gauth.AuthSubToken):
+ raise UnableToUpgradeToken(
+ 'Cannot upgrade the token because it is not an AuthSubToken object.')
+ http_request = atom.http_core.HttpRequest(uri=url, method='GET')
+ token.modify_request(http_request)
+ # Use the lower level HttpClient to make the request.
+ response = self.http_client.request(http_request)
+ if response.status == 200:
+ token._upgrade_token(response.read())
+ return token
+ else:
+ raise UnableToUpgradeToken(
+ 'Server responded to token upgrade request with %s: %s' % (
+ response.status, response.read()))
+
+ UpgradeToken = upgrade_token
+
+ def revoke_token(self, token=None, url=atom.http_core.Uri.parse_uri(
+ 'https://www.google.com/accounts/AuthSubRevokeToken')):
+ """Requests that the token be invalidated.
+
+ This method can be used for both AuthSub and OAuth tokens (to invalidate
+ a ClientLogin token, the user must change their password).
+
+ Returns:
+ True if the server responded with a 200.
+
+ Raises:
+ A RequestError if the server responds with a non-200 status.
+ """
+ # Default to using the auth_token member if no token is provided.
+ if token is None:
+ token = self.auth_token
+
+ http_request = atom.http_core.HttpRequest(uri=url, method='GET')
+ token.modify_request(http_request)
+ response = self.http_client.request(http_request)
+ if response.status != 200:
+ raise error_from_response('Server sent non-200 to revoke token',
+ response, RequestError, response.read())
+
+ return True
+
+ RevokeToken = revoke_token
+
+ def get_oauth_token(self, scopes, next, consumer_key, consumer_secret=None,
+ rsa_private_key=None,
+ url=gdata.gauth.REQUEST_TOKEN_URL):
+ """Obtains an OAuth request token to allow the user to authorize this app.
+
+ Once this client has a request token, the user can authorize the request
+ token by visiting the authorization URL in their browser. After being
+ redirected back to this app at the 'next' URL, this app can then exchange
+ the authorized request token for an access token.
+
+ For more information see the documentation on Google Accounts with OAuth:
+ http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess
+
+ Args:
+ scopes: list of strings or atom.http_core.Uri objects which specify the
+ URL prefixes which this app will be accessing. For example, to access
+ the Google Calendar API, you would want to use scopes:
+ ['https://www.google.com/calendar/feeds/',
+ 'http://www.google.com/calendar/feeds/']
+ next: str or atom.http_core.Uri object, The URL which the user's browser
+ should be sent to after they authorize access to their data. This
+ should be a URL in your application which will read the token
+ information from the URL and upgrade the request token to an access
+ token.
+ consumer_key: str This is the identifier for this application which you
+ should have received when you registered your application with Google
+ to use OAuth.
+ consumer_secret: str (optional) The shared secret between your app and
+ Google which provides evidence that this request is coming from you
+ application and not another app. If present, this libraries assumes
+ you want to use an HMAC signature to verify requests. Keep this data
+ a secret.
+ rsa_private_key: str (optional) The RSA private key which is used to
+ generate a digital signature which is checked by Google's server. If
+ present, this library assumes that you want to use an RSA signature
+ to verify requests. Keep this data a secret.
+ url: The URL to which a request for a token should be made. The default
+ is Google's OAuth request token provider.
+ """
+ http_request = None
+ if rsa_private_key is not None:
+ http_request = gdata.gauth.generate_request_for_request_token(
+ consumer_key, gdata.gauth.RSA_SHA1, scopes,
+ rsa_key=rsa_private_key, auth_server_url=url, next=next)
+ elif consumer_secret is not None:
+ http_request = gdata.gauth.generate_request_for_request_token(
+ consumer_key, gdata.gauth.HMAC_SHA1, scopes,
+ consumer_secret=consumer_secret, auth_server_url=url, next=next)
+ else:
+ raise MissingOAuthParameters(
+ 'To request an OAuth token, you must provide your consumer secret'
+ ' or your private RSA key.')
+
+ response = self.http_client.request(http_request)
+ response_body = response.read()
+
+ if response.status != 200:
+ raise error_from_response('Unable to obtain OAuth request token',
+ response, RequestError, response_body)
+
+ if rsa_private_key is not None:
+ return gdata.gauth.rsa_token_from_body(response_body, consumer_key,
+ rsa_private_key,
+ gdata.gauth.REQUEST_TOKEN)
+ elif consumer_secret is not None:
+ return gdata.gauth.hmac_token_from_body(response_body, consumer_key,
+ consumer_secret,
+ gdata.gauth.REQUEST_TOKEN)
+
+ GetOAuthToken = get_oauth_token
+
+ def get_access_token(self, request_token,
+ url=gdata.gauth.ACCESS_TOKEN_URL):
+ """Exchanges an authorized OAuth request token for an access token.
+
+ Contacts the Google OAuth server to upgrade a previously authorized
+ request token. Once the request token is upgraded to an access token,
+ the access token may be used to access the user's data.
+
+ For more details, see the Google Accounts OAuth documentation:
+ http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken
+
+ Args:
+ request_token: An OAuth token which has been authorized by the user.
+ url: (optional) The URL to which the upgrade request should be sent.
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken
+ """
+ http_request = gdata.gauth.generate_request_for_access_token(
+ request_token, auth_server_url=url)
+ response = self.http_client.request(http_request)
+ response_body = response.read()
+ if response.status != 200:
+ raise error_from_response(
+ 'Unable to upgrade OAuth request token to access token',
+ response, RequestError, response_body)
+
+ return gdata.gauth.upgrade_to_access_token(request_token, response_body)
+
+ GetAccessToken = get_access_token
+
+ def modify_request(self, http_request):
+ """Adds or changes request before making the HTTP request.
+
+ This client will add the API version if it is specified.
+ Subclasses may override this method to add their own request
+ modifications before the request is made.
+ """
+ http_request = atom.client.AtomPubClient.modify_request(self,
+ http_request)
+ if self.api_version is not None:
+ http_request.headers['GData-Version'] = self.api_version
+ return http_request
+
+ ModifyRequest = modify_request
+
+ def get_feed(self, uri, auth_token=None, converter=None,
+ desired_class=gdata.data.GDFeed, **kwargs):
+ return self.request(method='GET', uri=uri, auth_token=auth_token,
+ converter=converter, desired_class=desired_class,
+ **kwargs)
+
+ GetFeed = get_feed
+
+ def get_entry(self, uri, auth_token=None, converter=None,
+ desired_class=gdata.data.GDEntry, etag=None, **kwargs):
+ http_request = atom.http_core.HttpRequest()
+ # Conditional retrieval
+ if etag is not None:
+ http_request.headers['If-None-Match'] = etag
+ return self.request(method='GET', uri=uri, auth_token=auth_token,
+ http_request=http_request, converter=converter,
+ desired_class=desired_class, **kwargs)
+
+ GetEntry = get_entry
+
+ def get_next(self, feed, auth_token=None, converter=None,
+ desired_class=None, **kwargs):
+ """Fetches the next set of results from the feed.
+
+ When requesting a feed, the number of entries returned is capped at a
+ service specific default limit (often 25 entries). You can specify your
+ own entry-count cap using the max-results URL query parameter. If there
+ are more results than could fit under max-results, the feed will contain
+ a next link. This method performs a GET against this next results URL.
+
+ Returns:
+ A new feed object containing the next set of entries in this feed.
+ """
+ if converter is None and desired_class is None:
+ desired_class = feed.__class__
+ return self.get_feed(feed.find_next_link(), auth_token=auth_token,
+ converter=converter, desired_class=desired_class,
+ **kwargs)
+
+ GetNext = get_next
+
+ # TODO: add a refresh method to re-fetch the entry/feed from the server
+ # if it has been updated.
+
+ def post(self, entry, uri, auth_token=None, converter=None,
+ desired_class=None, **kwargs):
+ if converter is None and desired_class is None:
+ desired_class = entry.__class__
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(
+ entry.to_string(get_xml_version(self.api_version)),
+ 'application/atom+xml')
+ return self.request(method='POST', uri=uri, auth_token=auth_token,
+ http_request=http_request, converter=converter,
+ desired_class=desired_class, **kwargs)
+
+ Post = post
+
+ def update(self, entry, auth_token=None, force=False, uri=None, **kwargs):
+ """Edits the entry on the server by sending the XML for this entry.
+
+ Performs a PUT and converts the response to a new entry object with a
+ matching class to the entry passed in.
+
+ Args:
+ entry:
+ auth_token:
+ force: boolean stating whether an update should be forced. Defaults to
+ False. Normally, if a change has been made since the passed in
+ entry was obtained, the server will not overwrite the entry since
+ the changes were based on an obsolete version of the entry.
+ Setting force to True will cause the update to silently
+ overwrite whatever version is present.
+ uri: The uri to put to. If provided, this uri is PUT to rather than the
+ inferred uri from the entry's edit link.
+
+ Returns:
+ A new Entry object of a matching type to the entry which was passed in.
+ """
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(
+ entry.to_string(get_xml_version(self.api_version)),
+ 'application/atom+xml')
+ # Include the ETag in the request if present.
+ if force:
+ http_request.headers['If-Match'] = '*'
+ elif hasattr(entry, 'etag') and entry.etag:
+ http_request.headers['If-Match'] = entry.etag
+
+ if uri is None:
+ uri = entry.find_edit_link()
+
+ return self.request(method='PUT', uri=uri, auth_token=auth_token,
+ http_request=http_request,
+ desired_class=entry.__class__, **kwargs)
+
+ Update = update
+
+ def delete(self, entry_or_uri, auth_token=None, force=False, **kwargs):
+ http_request = atom.http_core.HttpRequest()
+
+ # Include the ETag in the request if present.
+ if force:
+ http_request.headers['If-Match'] = '*'
+ elif hasattr(entry_or_uri, 'etag') and entry_or_uri.etag:
+ http_request.headers['If-Match'] = entry_or_uri.etag
+
+ # If the user passes in a URL, just delete directly, may not work as
+ # the service might require an ETag.
+ if isinstance(entry_or_uri, (str, unicode, atom.http_core.Uri)):
+ return self.request(method='DELETE', uri=entry_or_uri,
+ http_request=http_request, auth_token=auth_token,
+ **kwargs)
+
+ return self.request(method='DELETE', uri=entry_or_uri.find_edit_link(),
+ http_request=http_request, auth_token=auth_token,
+ **kwargs)
+
+ Delete = delete
+
+ def batch(self, feed, uri=None, force=False, auth_token=None, **kwargs):
+ """Sends a batch request to the server to execute operation entries.
+
+ Args:
+ feed: A batch feed containing batch entries, each is an operation.
+ uri: (optional) The uri to which the batch request feed should be POSTed.
+ If none is provided, then the feed's edit link will be used.
+ force: (optional) boolean set to True if you want the batch update to
+ clobber all data. If False, the version in the information in the
+ feed object will cause the server to check to see that no changes
+ intervened between when you fetched the data and when you sent the
+ changes.
+ auth_token: (optional) An object which sets the Authorization HTTP header
+ in its modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others.
+ """
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(
+ feed.to_string(get_xml_version(self.api_version)),
+ 'application/atom+xml')
+ if force:
+ http_request.headers['If-Match'] = '*'
+ elif hasattr(feed, 'etag') and feed.etag:
+ http_request.headers['If-Match'] = feed.etag
+
+ if uri is None:
+ uri = feed.find_edit_link()
+
+ return self.request(method='POST', uri=uri, auth_token=auth_token,
+ http_request=http_request,
+ desired_class=feed.__class__, **kwargs)
+
+ Batch = batch
+
+ # TODO: add a refresh method to request a conditional update to an entry
+ # or feed.
+
+
+def _add_query_param(param_string, value, http_request):
+ if value:
+ http_request.uri.query[param_string] = value
+
+
+class Query(object):
+
+ def __init__(self, text_query=None, categories=None, author=None, alt=None,
+ updated_min=None, updated_max=None, pretty_print=False,
+ published_min=None, published_max=None, start_index=None,
+ max_results=None, strict=False, **custom_parameters):
+ """Constructs a Google Data Query to filter feed contents serverside.
+
+ Args:
+ text_query: Full text search str (optional)
+ categories: list of strings (optional). Each string is a required
+ category. To include an 'or' query, put a | in the string between
+ terms. For example, to find everything in the Fitz category and
+ the Laurie or Jane category (Fitz and (Laurie or Jane)) you would
+ set categories to ['Fitz', 'Laurie|Jane'].
+ author: str (optional) The service returns entries where the author
+ name and/or email address match your query string.
+ alt: str (optional) for the Alternative representation type you'd like
+ the feed in. If you don't specify an alt parameter, the service
+ returns an Atom feed. This is equivalent to alt='atom'.
+ alt='rss' returns an RSS 2.0 result feed.
+ alt='json' returns a JSON representation of the feed.
+ alt='json-in-script' Requests a response that wraps JSON in a script
+ tag.
+ alt='atom-in-script' Requests an Atom response that wraps an XML
+ string in a script tag.
+ alt='rss-in-script' Requests an RSS response that wraps an XML
+ string in a script tag.
+ updated_min: str (optional), RFC 3339 timestamp format, lower bounds.
+ For example: 2005-08-09T10:57:00-08:00
+ updated_max: str (optional) updated time must be earlier than timestamp.
+ pretty_print: boolean (optional) If True the server's XML response will
+ be indented to make it more human readable. Defaults to False.
+ published_min: str (optional), Similar to updated_min but for published
+ time.
+ published_max: str (optional), Similar to updated_max but for published
+ time.
+ start_index: int or str (optional) 1-based index of the first result to
+ be retrieved. Note that this isn't a general cursoring mechanism.
+ If you first send a query with ?start-index=1&max-results=10 and
+ then send another query with ?start-index=11&max-results=10, the
+ service cannot guarantee that the results are equivalent to
+ ?start-index=1&max-results=20, because insertions and deletions
+ could have taken place in between the two queries.
+ max_results: int or str (optional) Maximum number of results to be
+ retrieved. Each service has a default max (usually 25) which can
+ vary from service to service. There is also a service-specific
+ limit to the max_results you can fetch in a request.
+ strict: boolean (optional) If True, the server will return an error if
+ the server does not recognize any of the parameters in the request
+ URL. Defaults to False.
+ custom_parameters: other query parameters that are not explicitly defined.
+ """
+ self.text_query = text_query
+ self.categories = categories or []
+ self.author = author
+ self.alt = alt
+ self.updated_min = updated_min
+ self.updated_max = updated_max
+ self.pretty_print = pretty_print
+ self.published_min = published_min
+ self.published_max = published_max
+ self.start_index = start_index
+ self.max_results = max_results
+ self.strict = strict
+ self.custom_parameters = custom_parameters
+
+ def add_custom_parameter(self, key, value):
+ self.custom_parameters[key] = value
+
+ AddCustomParameter = add_custom_parameter
+
+ def modify_request(self, http_request):
+ _add_query_param('q', self.text_query, http_request)
+ if self.categories:
+ http_request.uri.query['category'] = ','.join(self.categories)
+ _add_query_param('author', self.author, http_request)
+ _add_query_param('alt', self.alt, http_request)
+ _add_query_param('updated-min', self.updated_min, http_request)
+ _add_query_param('updated-max', self.updated_max, http_request)
+ if self.pretty_print:
+ http_request.uri.query['prettyprint'] = 'true'
+ _add_query_param('published-min', self.published_min, http_request)
+ _add_query_param('published-max', self.published_max, http_request)
+ if self.start_index is not None:
+ http_request.uri.query['start-index'] = str(self.start_index)
+ if self.max_results is not None:
+ http_request.uri.query['max-results'] = str(self.max_results)
+ if self.strict:
+ http_request.uri.query['strict'] = 'true'
+ http_request.uri.query.update(self.custom_parameters)
+
+ ModifyRequest = modify_request
+
+
+class GDQuery(atom.http_core.Uri):
+
+ def _get_text_query(self):
+ return self.query['q']
+
+ def _set_text_query(self, value):
+ self.query['q'] = value
+
+ text_query = property(_get_text_query, _set_text_query,
+ doc='The q parameter for searching for an exact text match on content')
+
+
+class ResumableUploader(object):
+ """Resumable upload helper for the Google Data protocol."""
+
+ DEFAULT_CHUNK_SIZE = 5242880 # 5MB
+ # Initial chunks which are smaller than 256KB might be dropped. The last
+ # chunk for a file can be smaller tan this.
+ MIN_CHUNK_SIZE = 262144 # 256KB
+
+ def __init__(self, client, file_handle, content_type, total_file_size,
+ chunk_size=None, desired_class=None):
+ """Starts a resumable upload to a service that supports the protocol.
+
+ Args:
+ client: gdata.client.GDClient A Google Data API service.
+ file_handle: object A file-like object containing the file to upload.
+ content_type: str The mimetype of the file to upload.
+ total_file_size: int The file's total size in bytes.
+ chunk_size: int The size of each upload chunk. If None, the
+ DEFAULT_CHUNK_SIZE will be used.
+ desired_class: object (optional) The type of gdata.data.GDEntry to parse
+ the completed entry as. This should be specific to the API.
+ """
+ self.client = client
+ self.file_handle = file_handle
+ self.content_type = content_type
+ self.total_file_size = total_file_size
+ self.chunk_size = chunk_size or self.DEFAULT_CHUNK_SIZE
+ if self.chunk_size < self.MIN_CHUNK_SIZE:
+ self.chunk_size = self.MIN_CHUNK_SIZE
+ self.desired_class = desired_class or gdata.data.GDEntry
+ self.upload_uri = None
+
+ # Send the entire file if the chunk size is less than fize's total size.
+ if self.total_file_size <= self.chunk_size:
+ self.chunk_size = total_file_size
+
+ def _init_session(self, resumable_media_link, entry=None, headers=None,
+ auth_token=None, method='POST'):
+ """Starts a new resumable upload to a service that supports the protocol.
+
+ The method makes a request to initiate a new upload session. The unique
+ upload uri returned by the server (and set in this method) should be used
+ to send upload chunks to the server.
+
+ Args:
+ resumable_media_link: str The full URL for the #resumable-create-media or
+ #resumable-edit-media link for starting a resumable upload request or
+ updating media using a resumable PUT.
+ entry: A (optional) gdata.data.GDEntry containging metadata to create the
+ upload from.
+ headers: dict (optional) Additional headers to send in the initial request
+ to create the resumable upload request. These headers will override
+ any default headers sent in the request. For example:
+ headers={'Slug': 'MyTitle'}.
+ auth_token: (optional) An object which sets the Authorization HTTP header
+ in its modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others.
+ method: (optional) Type of HTTP request to start the session with.
+ Defaults to 'POST', but may also be 'PUT'.
+
+ Returns:
+ Result of HTTP request to intialize the session. See atom.client.request.
+
+ Raises:
+ RequestError if the unique upload uri is not set or the
+ server returns something other than an HTTP 308 when the upload is
+ incomplete.
+ """
+ http_request = atom.http_core.HttpRequest()
+
+ # Send empty body if Atom XML wasn't specified.
+ if entry is None:
+ http_request.add_body_part('', self.content_type, size=0)
+ else:
+ http_request.add_body_part(str(entry), 'application/atom+xml',
+ size=len(str(entry)))
+ http_request.headers['X-Upload-Content-Type'] = self.content_type
+ http_request.headers['X-Upload-Content-Length'] = str(self.total_file_size)
+
+ if headers is not None:
+ http_request.headers.update(headers)
+
+ response = self.client.request(method=method,
+ uri=resumable_media_link,
+ auth_token=auth_token,
+ http_request=http_request)
+
+ self.upload_uri = (response.getheader('location') or
+ response.getheader('Location'))
+
+ return response
+
+ _InitSession = _init_session
+
+ def upload_chunk(self, start_byte, content_bytes):
+ """Uploads a byte range (chunk) to the resumable upload server.
+
+ Args:
+ start_byte: int The byte offset of the total file where the byte range
+ passed in lives.
+ content_bytes: str The file contents of this chunk.
+
+ Returns:
+ The final Atom entry created on the server. The entry object's type will
+ be the class specified in self.desired_class.
+
+ Raises:
+ RequestError if the unique upload uri is not set or the
+ server returns something other than an HTTP 308 when the upload is
+ incomplete.
+ """
+ if self.upload_uri is None:
+ raise RequestError('Resumable upload request not initialized.')
+
+ # Adjustment if last byte range is less than defined chunk size.
+ chunk_size = self.chunk_size
+ if len(content_bytes) <= chunk_size:
+ chunk_size = len(content_bytes)
+
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(content_bytes, self.content_type,
+ size=len(content_bytes))
+ http_request.headers['Content-Range'] = ('bytes %s-%s/%s'
+ % (start_byte,
+ start_byte + chunk_size - 1,
+ self.total_file_size))
+
+ try:
+ response = self.client.request(method='PUT', uri=self.upload_uri,
+ http_request=http_request,
+ desired_class=self.desired_class)
+ return response
+ except RequestError, error:
+ if error.status == 308:
+ return None
+ else:
+ raise error
+
+ UploadChunk = upload_chunk
+
+ def upload_file(self, resumable_media_link, entry=None, headers=None,
+ auth_token=None, **kwargs):
+ """Uploads an entire file in chunks using the resumable upload protocol.
+
+ If you are interested in pausing an upload or controlling the chunking
+ yourself, use the upload_chunk() method instead.
+
+ Args:
+ resumable_media_link: str The full URL for the #resumable-create-media for
+ starting a resumable upload request.
+ entry: A (optional) gdata.data.GDEntry containging metadata to create the
+ upload from.
+ headers: dict Additional headers to send in the initial request to create
+ the resumable upload request. These headers will override any default
+ headers sent in the request. For example: headers={'Slug': 'MyTitle'}.
+ auth_token: (optional) An object which sets the Authorization HTTP header
+ in its modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others.
+ kwargs: (optional) Other args to pass to self._init_session.
+
+ Returns:
+ The final Atom entry created on the server. The entry object's type will
+ be the class specified in self.desired_class.
+
+ Raises:
+ RequestError if anything other than a HTTP 308 is returned
+ when the request raises an exception.
+ """
+ self._init_session(resumable_media_link, headers=headers,
+ auth_token=auth_token, entry=entry, **kwargs)
+
+ start_byte = 0
+ entry = None
+
+ while not entry:
+ entry = self.upload_chunk(
+ start_byte, self.file_handle.read(self.chunk_size))
+ start_byte += self.chunk_size
+
+ return entry
+
+ UploadFile = upload_file
+
+ def update_file(self, entry_or_resumable_edit_link, headers=None, force=False,
+ auth_token=None, update_metadata=False, uri_params=None):
+ """Updates the contents of an existing file using the resumable protocol.
+
+ If you are interested in pausing an upload or controlling the chunking
+ yourself, use the upload_chunk() method instead.
+
+ Args:
+ entry_or_resumable_edit_link: object or string A gdata.data.GDEntry for
+ the entry/file to update or the full uri of the link with rel
+ #resumable-edit-media.
+ headers: dict Additional headers to send in the initial request to create
+ the resumable upload request. These headers will override any default
+ headers sent in the request. For example: headers={'Slug': 'MyTitle'}.
+ force boolean (optional) True to force an update and set the If-Match
+ header to '*'. If False and entry_or_resumable_edit_link is a
+ gdata.data.GDEntry object, its etag value is used. Otherwise this
+ parameter should be set to True to force the update.
+ auth_token: (optional) An object which sets the Authorization HTTP header
+ in its modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others.
+ update_metadata: (optional) True to also update the entry's metadata
+ with that in the given GDEntry object in entry_or_resumable_edit_link.
+ uri_params: (optional) Dict of additional parameters to attach to the URI.
+ Some non-dict types are valid here, too, like list of tuple pairs.
+
+ Returns:
+ The final Atom entry created on the server. The entry object's type will
+ be the class specified in self.desired_class.
+
+ Raises:
+ RequestError if anything other than a HTTP 308 is returned when the
+ request raises an exception.
+ """
+
+ custom_headers = {}
+ if headers is not None:
+ custom_headers.update(headers)
+
+ uri = None
+ entry = None
+ if isinstance(entry_or_resumable_edit_link, gdata.data.GDEntry):
+ uri = entry_or_resumable_edit_link.find_url(
+ 'http://schemas.google.com/g/2005#resumable-edit-media')
+ custom_headers['If-Match'] = entry_or_resumable_edit_link.etag
+ if update_metadata:
+ entry = entry_or_resumable_edit_link
+ else:
+ uri = entry_or_resumable_edit_link
+
+ uri = atom.http_core.parse_uri(uri)
+ if uri_params is not None:
+ uri.query.update(uri_params)
+
+ if force:
+ custom_headers['If-Match'] = '*'
+
+ return self.upload_file(str(uri), entry=entry, headers=custom_headers,
+ auth_token=auth_token, method='PUT')
+
+ UpdateFile = update_file
+
+ def query_upload_status(self, uri=None):
+ """Queries the current status of a resumable upload request.
+
+ Args:
+ uri: str (optional) A resumable upload uri to query and override the one
+ that is set in this object.
+
+ Returns:
+ An integer representing the file position (byte) to resume the upload from
+ or True if the upload is complete.
+
+ Raises:
+ RequestError if anything other than a HTTP 308 is returned
+ when the request raises an exception.
+ """
+ # Override object's unique upload uri.
+ if uri is None:
+ uri = self.upload_uri
+
+ http_request = atom.http_core.HttpRequest()
+ http_request.headers['Content-Length'] = '0'
+ http_request.headers['Content-Range'] = 'bytes */%s' % self.total_file_size
+
+ try:
+ response = self.client.request(
+ method='POST', uri=uri, http_request=http_request)
+ if response.status == 201:
+ return True
+ else:
+ raise error_from_response(
+ '%s returned by server' % response.status, response, RequestError)
+ except RequestError, error:
+ if error.status == 308:
+ for pair in error.headers:
+ if pair[0].capitalize() == 'Range':
+ return int(pair[1].split('-')[1]) + 1
+ else:
+ raise error
+
+ QueryUploadStatus = query_upload_status
diff --git a/samples/apps/marketplace_sample/gdata/core.py b/samples/apps/marketplace_sample/gdata/core.py
new file mode 100644
index 0000000..0661ec6
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/core.py
@@ -0,0 +1,279 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2010 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+"""Provides classes and methods for working with JSON-C.
+
+This module is experimental and subject to backwards incompatible changes.
+
+ Jsonc: Class which represents JSON-C data and provides pythonic member
+ access which is a bit cleaner than working with plain old dicts.
+ parse_json: Converts a JSON-C string into a Jsonc object.
+ jsonc_to_string: Converts a Jsonc object into a string of JSON-C.
+"""
+
+
+try:
+ import simplejson
+except ImportError:
+ try:
+ # Try to import from django, should work on App Engine
+ from django.utils import simplejson
+ except ImportError:
+ # Should work for Python2.6 and higher.
+ import json as simplejson
+
+
+def _convert_to_jsonc(x):
+ """Builds a Jsonc objects which wraps the argument's members."""
+
+ if isinstance(x, dict):
+ jsonc_obj = Jsonc()
+ # Recursively transform all members of the dict.
+ # When converting a dict, we do not convert _name items into private
+ # Jsonc members.
+ for key, value in x.iteritems():
+ jsonc_obj._dict[key] = _convert_to_jsonc(value)
+ return jsonc_obj
+ elif isinstance(x, list):
+ # Recursively transform all members of the list.
+ members = []
+ for item in x:
+ members.append(_convert_to_jsonc(item))
+ return members
+ else:
+ # Return the base object.
+ return x
+
+
+def parse_json(json_string):
+ """Converts a JSON-C string into a Jsonc object.
+
+ Args:
+ json_string: str or unicode The JSON to be parsed.
+
+ Returns:
+ A new Jsonc object.
+ """
+
+ return _convert_to_jsonc(simplejson.loads(json_string))
+
+
+def parse_json_file(json_file):
+ return _convert_to_jsonc(simplejson.load(json_file))
+
+
+def jsonc_to_string(jsonc_obj):
+ """Converts a Jsonc object into a string of JSON-C."""
+
+ return simplejson.dumps(_convert_to_object(jsonc_obj))
+
+
+def prettify_jsonc(jsonc_obj, indentation=2):
+ """Converts a Jsonc object to a pretified (intented) JSON string."""
+
+ return simplejson.dumps(_convert_to_object(jsonc_obj), indent=indentation)
+
+
+
+def _convert_to_object(jsonc_obj):
+ """Creates a new dict or list which has the data in the Jsonc object.
+
+ Used to convert the Jsonc object to a plain old Python object to simplify
+ conversion to a JSON-C string.
+
+ Args:
+ jsonc_obj: A Jsonc object to be converted into simple Python objects
+ (dicts, lists, etc.)
+
+ Returns:
+ Either a dict, list, or other object with members converted from Jsonc
+ objects to the corresponding simple Python object.
+ """
+
+ if isinstance(jsonc_obj, Jsonc):
+ plain = {}
+ for key, value in jsonc_obj._dict.iteritems():
+ plain[key] = _convert_to_object(value)
+ return plain
+ elif isinstance(jsonc_obj, list):
+ plain = []
+ for item in jsonc_obj:
+ plain.append(_convert_to_object(item))
+ return plain
+ else:
+ return jsonc_obj
+
+
+def _to_jsonc_name(member_name):
+ """Converts a Python style member name to a JSON-C style name.
+
+ JSON-C uses camelCaseWithLower while Python tends to use
+ lower_with_underscores so this method converts as follows:
+
+ spam becomes spam
+ spam_and_eggs becomes spamAndEggs
+
+ Args:
+ member_name: str or unicode The Python syle name which should be
+ converted to JSON-C style.
+
+ Returns:
+ The JSON-C style name as a str or unicode.
+ """
+
+ characters = []
+ uppercase_next = False
+ for character in member_name:
+ if character == '_':
+ uppercase_next = True
+ elif uppercase_next:
+ characters.append(character.upper())
+ uppercase_next = False
+ else:
+ characters.append(character)
+ return ''.join(characters)
+
+
+class Jsonc(object):
+ """Represents JSON-C data in an easy to access object format.
+
+ To access the members of a JSON structure which looks like this:
+ {
+ "data": {
+ "totalItems": 800,
+ "items": [
+ {
+ "content": {
+ "1": "rtsp://v5.cache3.c.youtube.com/CiILENy.../0/0/0/video.3gp"
+ },
+ "viewCount": 220101,
+ "commentCount": 22,
+ "favoriteCount": 201
+ }
+ ]
+ },
+ "apiVersion": "2.0"
+ }
+
+ You would do the following:
+ x = gdata.core.parse_json(the_above_string)
+ # Gives you 800
+ x.data.total_items
+ # Should be 22
+ x.data.items[0].comment_count
+ # The apiVersion is '2.0'
+ x.api_version
+
+ To create a Jsonc object which would produce the above JSON, you would do:
+ gdata.core.Jsonc(
+ api_version='2.0',
+ data=gdata.core.Jsonc(
+ total_items=800,
+ items=[
+ gdata.core.Jsonc(
+ view_count=220101,
+ comment_count=22,
+ favorite_count=201,
+ content={
+ '1': ('rtsp://v5.cache3.c.youtube.com'
+ '/CiILENy.../0/0/0/video.3gp')})]))
+ or
+ x = gdata.core.Jsonc()
+ x.api_version = '2.0'
+ x.data = gdata.core.Jsonc()
+ x.data.total_items = 800
+ x.data.items = []
+ # etc.
+
+ How it works:
+ The JSON-C data is stored in an internal dictionary (._dict) and the
+ getattr, setattr, and delattr methods rewrite the name which you provide
+ to mirror the expected format in JSON-C. (For more details on name
+ conversion see _to_jsonc_name.) You may also access members using
+ getitem, setitem, delitem as you would for a dictionary. For example
+ x.data.total_items is equivalent to x['data']['totalItems']
+ (Not all dict methods are supported so if you need something other than
+ the item operations, then you will want to use the ._dict member).
+
+ You may need to use getitem or the _dict member to access certain
+ properties in cases where the JSON-C syntax does not map neatly to Python
+ objects. For example the YouTube Video feed has some JSON like this:
+ "content": {"1": "rtsp://v5.cache3.c.youtube.com..."...}
+ You cannot do x.content.1 in Python, so you would use the getitem as
+ follows:
+ x.content['1']
+ or you could use the _dict member as follows:
+ x.content._dict['1']
+
+ If you need to create a new object with such a mapping you could use.
+
+ x.content = gdata.core.Jsonc(_dict={'1': 'rtsp://cache3.c.youtube.com...'})
+ """
+
+ def __init__(self, _dict=None, **kwargs):
+ json = _dict or {}
+ for key, value in kwargs.iteritems():
+ if key.startswith('_'):
+ object.__setattr__(self, key, value)
+ else:
+ json[_to_jsonc_name(key)] = _convert_to_jsonc(value)
+
+ object.__setattr__(self, '_dict', json)
+
+ def __setattr__(self, name, value):
+ if name.startswith('_'):
+ object.__setattr__(self, name, value)
+ else:
+ object.__getattribute__(
+ self, '_dict')[_to_jsonc_name(name)] = _convert_to_jsonc(value)
+
+ def __getattr__(self, name):
+ if name.startswith('_'):
+ object.__getattribute__(self, name)
+ else:
+ try:
+ return object.__getattribute__(self, '_dict')[_to_jsonc_name(name)]
+ except KeyError:
+ raise AttributeError(
+ 'No member for %s or [\'%s\']' % (name, _to_jsonc_name(name)))
+
+
+ def __delattr__(self, name):
+ if name.startswith('_'):
+ object.__delattr__(self, name)
+ else:
+ try:
+ del object.__getattribute__(self, '_dict')[_to_jsonc_name(name)]
+ except KeyError:
+ raise AttributeError(
+ 'No member for %s (or [\'%s\'])' % (name, _to_jsonc_name(name)))
+
+ # For container methods pass-through to the underlying dict.
+ def __getitem__(self, key):
+ return self._dict[key]
+
+ def __setitem__(self, key, value):
+ self._dict[key] = value
+
+ def __delitem__(self, key):
+ del self._dict[key]
diff --git a/samples/apps/marketplace_sample/gdata/data.py b/samples/apps/marketplace_sample/gdata/data.py
new file mode 100644
index 0000000..3bf1850
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/data.py
@@ -0,0 +1,1219 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+"""Provides classes and constants for the XML in the Google Data namespace.
+
+Documentation for the raw XML which these classes represent can be found here:
+http://code.google.com/apis/gdata/docs/2.0/elements.html
+"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import os
+import atom.core
+import atom.data
+
+
+GDATA_TEMPLATE = '{http://schemas.google.com/g/2005}%s'
+GD_TEMPLATE = GDATA_TEMPLATE
+OPENSEARCH_TEMPLATE_V1 = '{http://a9.com/-/spec/opensearchrss/1.0/}%s'
+OPENSEARCH_TEMPLATE_V2 = '{http://a9.com/-/spec/opensearch/1.1/}%s'
+BATCH_TEMPLATE = '{http://schemas.google.com/gdata/batch}%s'
+
+
+# Labels used in batch request entries to specify the desired CRUD operation.
+BATCH_INSERT = 'insert'
+BATCH_UPDATE = 'update'
+BATCH_DELETE = 'delete'
+BATCH_QUERY = 'query'
+
+EVENT_LOCATION = 'http://schemas.google.com/g/2005#event'
+ALTERNATE_LOCATION = 'http://schemas.google.com/g/2005#event.alternate'
+PARKING_LOCATION = 'http://schemas.google.com/g/2005#event.parking'
+
+CANCELED_EVENT = 'http://schemas.google.com/g/2005#event.canceled'
+CONFIRMED_EVENT = 'http://schemas.google.com/g/2005#event.confirmed'
+TENTATIVE_EVENT = 'http://schemas.google.com/g/2005#event.tentative'
+
+CONFIDENTIAL_EVENT = 'http://schemas.google.com/g/2005#event.confidential'
+DEFAULT_EVENT = 'http://schemas.google.com/g/2005#event.default'
+PRIVATE_EVENT = 'http://schemas.google.com/g/2005#event.private'
+PUBLIC_EVENT = 'http://schemas.google.com/g/2005#event.public'
+
+OPAQUE_EVENT = 'http://schemas.google.com/g/2005#event.opaque'
+TRANSPARENT_EVENT = 'http://schemas.google.com/g/2005#event.transparent'
+
+CHAT_MESSAGE = 'http://schemas.google.com/g/2005#message.chat'
+INBOX_MESSAGE = 'http://schemas.google.com/g/2005#message.inbox'
+SENT_MESSAGE = 'http://schemas.google.com/g/2005#message.sent'
+SPAM_MESSAGE = 'http://schemas.google.com/g/2005#message.spam'
+STARRED_MESSAGE = 'http://schemas.google.com/g/2005#message.starred'
+UNREAD_MESSAGE = 'http://schemas.google.com/g/2005#message.unread'
+
+BCC_RECIPIENT = 'http://schemas.google.com/g/2005#message.bcc'
+CC_RECIPIENT = 'http://schemas.google.com/g/2005#message.cc'
+SENDER = 'http://schemas.google.com/g/2005#message.from'
+REPLY_TO = 'http://schemas.google.com/g/2005#message.reply-to'
+TO_RECIPIENT = 'http://schemas.google.com/g/2005#message.to'
+
+ASSISTANT_REL = 'http://schemas.google.com/g/2005#assistant'
+CALLBACK_REL = 'http://schemas.google.com/g/2005#callback'
+CAR_REL = 'http://schemas.google.com/g/2005#car'
+COMPANY_MAIN_REL = 'http://schemas.google.com/g/2005#company_main'
+FAX_REL = 'http://schemas.google.com/g/2005#fax'
+HOME_REL = 'http://schemas.google.com/g/2005#home'
+HOME_FAX_REL = 'http://schemas.google.com/g/2005#home_fax'
+ISDN_REL = 'http://schemas.google.com/g/2005#isdn'
+MAIN_REL = 'http://schemas.google.com/g/2005#main'
+MOBILE_REL = 'http://schemas.google.com/g/2005#mobile'
+OTHER_REL = 'http://schemas.google.com/g/2005#other'
+OTHER_FAX_REL = 'http://schemas.google.com/g/2005#other_fax'
+PAGER_REL = 'http://schemas.google.com/g/2005#pager'
+RADIO_REL = 'http://schemas.google.com/g/2005#radio'
+TELEX_REL = 'http://schemas.google.com/g/2005#telex'
+TTL_TDD_REL = 'http://schemas.google.com/g/2005#tty_tdd'
+WORK_REL = 'http://schemas.google.com/g/2005#work'
+WORK_FAX_REL = 'http://schemas.google.com/g/2005#work_fax'
+WORK_MOBILE_REL = 'http://schemas.google.com/g/2005#work_mobile'
+WORK_PAGER_REL = 'http://schemas.google.com/g/2005#work_pager'
+NETMEETING_REL = 'http://schemas.google.com/g/2005#netmeeting'
+OVERALL_REL = 'http://schemas.google.com/g/2005#overall'
+PRICE_REL = 'http://schemas.google.com/g/2005#price'
+QUALITY_REL = 'http://schemas.google.com/g/2005#quality'
+EVENT_REL = 'http://schemas.google.com/g/2005#event'
+EVENT_ALTERNATE_REL = 'http://schemas.google.com/g/2005#event.alternate'
+EVENT_PARKING_REL = 'http://schemas.google.com/g/2005#event.parking'
+
+AIM_PROTOCOL = 'http://schemas.google.com/g/2005#AIM'
+MSN_PROTOCOL = 'http://schemas.google.com/g/2005#MSN'
+YAHOO_MESSENGER_PROTOCOL = 'http://schemas.google.com/g/2005#YAHOO'
+SKYPE_PROTOCOL = 'http://schemas.google.com/g/2005#SKYPE'
+QQ_PROTOCOL = 'http://schemas.google.com/g/2005#QQ'
+GOOGLE_TALK_PROTOCOL = 'http://schemas.google.com/g/2005#GOOGLE_TALK'
+ICQ_PROTOCOL = 'http://schemas.google.com/g/2005#ICQ'
+JABBER_PROTOCOL = 'http://schemas.google.com/g/2005#JABBER'
+
+REGULAR_COMMENTS = 'http://schemas.google.com/g/2005#regular'
+REVIEW_COMMENTS = 'http://schemas.google.com/g/2005#reviews'
+
+MAIL_BOTH = 'http://schemas.google.com/g/2005#both'
+MAIL_LETTERS = 'http://schemas.google.com/g/2005#letters'
+MAIL_PARCELS = 'http://schemas.google.com/g/2005#parcels'
+MAIL_NEITHER = 'http://schemas.google.com/g/2005#neither'
+
+GENERAL_ADDRESS = 'http://schemas.google.com/g/2005#general'
+LOCAL_ADDRESS = 'http://schemas.google.com/g/2005#local'
+
+OPTIONAL_ATENDEE = 'http://schemas.google.com/g/2005#event.optional'
+REQUIRED_ATENDEE = 'http://schemas.google.com/g/2005#event.required'
+
+ATTENDEE_ACCEPTED = 'http://schemas.google.com/g/2005#event.accepted'
+ATTENDEE_DECLINED = 'http://schemas.google.com/g/2005#event.declined'
+ATTENDEE_INVITED = 'http://schemas.google.com/g/2005#event.invited'
+ATTENDEE_TENTATIVE = 'http://schemas.google.com/g/2005#event.tentative'
+
+FULL_PROJECTION = 'full'
+VALUES_PROJECTION = 'values'
+BASIC_PROJECTION = 'basic'
+
+PRIVATE_VISIBILITY = 'private'
+PUBLIC_VISIBILITY = 'public'
+
+OPAQUE_TRANSPARENCY = 'http://schemas.google.com/g/2005#event.opaque'
+TRANSPARENT_TRANSPARENCY = 'http://schemas.google.com/g/2005#event.transparent'
+
+CONFIDENTIAL_EVENT_VISIBILITY = 'http://schemas.google.com/g/2005#event.confidential'
+DEFAULT_EVENT_VISIBILITY = 'http://schemas.google.com/g/2005#event.default'
+PRIVATE_EVENT_VISIBILITY = 'http://schemas.google.com/g/2005#event.private'
+PUBLIC_EVENT_VISIBILITY = 'http://schemas.google.com/g/2005#event.public'
+
+CANCELED_EVENT_STATUS = 'http://schemas.google.com/g/2005#event.canceled'
+CONFIRMED_EVENT_STATUS = 'http://schemas.google.com/g/2005#event.confirmed'
+TENTATIVE_EVENT_STATUS = 'http://schemas.google.com/g/2005#event.tentative'
+
+ACL_REL = 'http://schemas.google.com/acl/2007#accessControlList'
+
+
+class Error(Exception):
+ pass
+
+
+class MissingRequiredParameters(Error):
+ pass
+
+
+class LinkFinder(atom.data.LinkFinder):
+ """Mixin used in Feed and Entry classes to simplify link lookups by type.
+
+ Provides lookup methods for edit, edit-media, post, ACL and other special
+ links which are common across Google Data APIs.
+ """
+
+ def find_html_link(self):
+ """Finds the first link with rel of alternate and type of text/html."""
+ for link in self.link:
+ if link.rel == 'alternate' and link.type == 'text/html':
+ return link.href
+ return None
+
+ FindHtmlLink = find_html_link
+
+ def get_html_link(self):
+ for a_link in self.link:
+ if a_link.rel == 'alternate' and a_link.type == 'text/html':
+ return a_link
+ return None
+
+ GetHtmlLink = get_html_link
+
+ def find_post_link(self):
+ """Get the URL to which new entries should be POSTed.
+
+ The POST target URL is used to insert new entries.
+
+ Returns:
+ A str for the URL in the link with a rel matching the POST type.
+ """
+ return self.find_url('http://schemas.google.com/g/2005#post')
+
+ FindPostLink = find_post_link
+
+ def get_post_link(self):
+ return self.get_link('http://schemas.google.com/g/2005#post')
+
+ GetPostLink = get_post_link
+
+ def find_acl_link(self):
+ acl_link = self.get_acl_link()
+ if acl_link:
+ return acl_link.href
+
+ return None
+
+ FindAclLink = find_acl_link
+
+ def get_acl_link(self):
+ """Searches for a link or feed_link (if present) with the rel for ACL."""
+
+ acl_link = self.get_link(ACL_REL)
+ if acl_link:
+ return acl_link
+ elif hasattr(self, 'feed_link'):
+ for a_feed_link in self.feed_link:
+ if a_feed_link.rel == ACL_REL:
+ return a_feed_link
+
+ return None
+
+ GetAclLink = get_acl_link
+
+ def find_feed_link(self):
+ return self.find_url('http://schemas.google.com/g/2005#feed')
+
+ FindFeedLink = find_feed_link
+
+ def get_feed_link(self):
+ return self.get_link('http://schemas.google.com/g/2005#feed')
+
+ GetFeedLink = get_feed_link
+
+ def find_previous_link(self):
+ return self.find_url('previous')
+
+ FindPreviousLink = find_previous_link
+
+ def get_previous_link(self):
+ return self.get_link('previous')
+
+ GetPreviousLink = get_previous_link
+
+
+class TotalResults(atom.core.XmlElement):
+ """opensearch:TotalResults for a GData feed."""
+ _qname = (OPENSEARCH_TEMPLATE_V1 % 'totalResults',
+ OPENSEARCH_TEMPLATE_V2 % 'totalResults')
+
+
+class StartIndex(atom.core.XmlElement):
+ """The opensearch:startIndex element in GData feed."""
+ _qname = (OPENSEARCH_TEMPLATE_V1 % 'startIndex',
+ OPENSEARCH_TEMPLATE_V2 % 'startIndex')
+
+
+class ItemsPerPage(atom.core.XmlElement):
+ """The opensearch:itemsPerPage element in GData feed."""
+ _qname = (OPENSEARCH_TEMPLATE_V1 % 'itemsPerPage',
+ OPENSEARCH_TEMPLATE_V2 % 'itemsPerPage')
+
+
+class ExtendedProperty(atom.core.XmlElement):
+ """The Google Data extendedProperty element.
+
+ Used to store arbitrary key-value information specific to your
+ application. The value can either be a text string stored as an XML
+ attribute (.value), or an XML node (XmlBlob) as a child element.
+
+ This element is used in the Google Calendar data API and the Google
+ Contacts data API.
+ """
+ _qname = GDATA_TEMPLATE % 'extendedProperty'
+ name = 'name'
+ value = 'value'
+
+ def get_xml_blob(self):
+ """Returns the XML blob as an atom.core.XmlElement.
+
+ Returns:
+ An XmlElement representing the blob's XML, or None if no
+ blob was set.
+ """
+ if self._other_elements:
+ return self._other_elements[0]
+ else:
+ return None
+
+ GetXmlBlob = get_xml_blob
+
+ def set_xml_blob(self, blob):
+ """Sets the contents of the extendedProperty to XML as a child node.
+
+ Since the extendedProperty is only allowed one child element as an XML
+ blob, setting the XML blob will erase any preexisting member elements
+ in this object.
+
+ Args:
+ blob: str or atom.core.XmlElement representing the XML blob stored in
+ the extendedProperty.
+ """
+ # Erase any existing extension_elements, clears the child nodes from the
+ # extendedProperty.
+ if isinstance(blob, atom.core.XmlElement):
+ self._other_elements = [blob]
+ else:
+ self._other_elements = [atom.core.parse(str(blob))]
+
+ SetXmlBlob = set_xml_blob
+
+
+class GDEntry(atom.data.Entry, LinkFinder):
+ """Extends Atom Entry to provide data processing"""
+ etag = '{http://schemas.google.com/g/2005}etag'
+
+ def get_id(self):
+ if self.id is not None and self.id.text is not None:
+ return self.id.text.strip()
+ return None
+
+ GetId = get_id
+
+ def is_media(self):
+ if self.find_edit_media_link():
+ return True
+ return False
+
+ IsMedia = is_media
+
+ def find_media_link(self):
+ """Returns the URL to the media content, if the entry is a media entry.
+ Otherwise returns None.
+ """
+ if self.is_media():
+ return self.content.src
+ return None
+
+ FindMediaLink = find_media_link
+
+
+class GDFeed(atom.data.Feed, LinkFinder):
+ """A Feed from a GData service."""
+ etag = '{http://schemas.google.com/g/2005}etag'
+ total_results = TotalResults
+ start_index = StartIndex
+ items_per_page = ItemsPerPage
+ entry = [GDEntry]
+
+ def get_id(self):
+ if self.id is not None and self.id.text is not None:
+ return self.id.text.strip()
+ return None
+
+ GetId = get_id
+
+ def get_generator(self):
+ if self.generator and self.generator.text:
+ return self.generator.text.strip()
+ return None
+
+
+class BatchId(atom.core.XmlElement):
+ """Identifies a single operation in a batch request."""
+ _qname = BATCH_TEMPLATE % 'id'
+
+
+class BatchOperation(atom.core.XmlElement):
+ """The CRUD operation which this batch entry represents."""
+ _qname = BATCH_TEMPLATE % 'operation'
+ type = 'type'
+
+
+class BatchStatus(atom.core.XmlElement):
+ """The batch:status element present in a batch response entry.
+
+ A status element contains the code (HTTP response code) and
+ reason as elements. In a single request these fields would
+ be part of the HTTP response, but in a batch request each
+ Entry operation has a corresponding Entry in the response
+ feed which includes status information.
+
+ See http://code.google.com/apis/gdata/batch.html#Handling_Errors
+ """
+ _qname = BATCH_TEMPLATE % 'status'
+ code = 'code'
+ reason = 'reason'
+ content_type = 'content-type'
+
+
+class BatchEntry(GDEntry):
+ """An atom:entry for use in batch requests.
+
+ The BatchEntry contains additional members to specify the operation to be
+ performed on this entry and a batch ID so that the server can reference
+ individual operations in the response feed. For more information, see:
+ http://code.google.com/apis/gdata/batch.html
+ """
+ batch_operation = BatchOperation
+ batch_id = BatchId
+ batch_status = BatchStatus
+
+
+class BatchInterrupted(atom.core.XmlElement):
+ """The batch:interrupted element sent if batch request was interrupted.
+
+ Only appears in a feed if some of the batch entries could not be processed.
+ See: http://code.google.com/apis/gdata/batch.html#Handling_Errors
+ """
+ _qname = BATCH_TEMPLATE % 'interrupted'
+ reason = 'reason'
+ success = 'success'
+ failures = 'failures'
+ parsed = 'parsed'
+
+
+class BatchFeed(GDFeed):
+ """A feed containing a list of batch request entries."""
+ interrupted = BatchInterrupted
+ entry = [BatchEntry]
+
+ def add_batch_entry(self, entry=None, id_url_string=None,
+ batch_id_string=None, operation_string=None):
+ """Logic for populating members of a BatchEntry and adding to the feed.
+
+ If the entry is not a BatchEntry, it is converted to a BatchEntry so
+ that the batch specific members will be present.
+
+ The id_url_string can be used in place of an entry if the batch operation
+ applies to a URL. For example query and delete operations require just
+ the URL of an entry, no body is sent in the HTTP request. If an
+ id_url_string is sent instead of an entry, a BatchEntry is created and
+ added to the feed.
+
+ This method also assigns the desired batch id to the entry so that it
+ can be referenced in the server's response. If the batch_id_string is
+ None, this method will assign a batch_id to be the index at which this
+ entry will be in the feed's entry list.
+
+ Args:
+ entry: BatchEntry, atom.data.Entry, or another Entry flavor (optional)
+ The entry which will be sent to the server as part of the batch
+ request. The item must have a valid atom id so that the server
+ knows which entry this request references.
+ id_url_string: str (optional) The URL of the entry to be acted on. You
+ can find this URL in the text member of the atom id for an entry.
+ If an entry is not sent, this id will be used to construct a new
+ BatchEntry which will be added to the request feed.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. Note that batch_ids should either always be specified or
+ never, mixing could potentially result in duplicate batch ids.
+ operation_string: str (optional) The desired batch operation which will
+ set the batch_operation.type member of the entry. Options are
+ 'insert', 'update', 'delete', and 'query'
+
+ Raises:
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an
+ entry are provided in the request.
+
+ Returns:
+ The added entry.
+ """
+ if entry is None and id_url_string is None:
+ raise MissingRequiredParameters('supply either an entry or URL string')
+ if entry is None and id_url_string is not None:
+ entry = BatchEntry(id=atom.data.Id(text=id_url_string))
+ if batch_id_string is not None:
+ entry.batch_id = BatchId(text=batch_id_string)
+ elif entry.batch_id is None or entry.batch_id.text is None:
+ entry.batch_id = BatchId(text=str(len(self.entry)))
+ if operation_string is not None:
+ entry.batch_operation = BatchOperation(type=operation_string)
+ self.entry.append(entry)
+ return entry
+
+ AddBatchEntry = add_batch_entry
+
+ def add_insert(self, entry, batch_id_string=None):
+ """Add an insert request to the operations in this batch request feed.
+
+ If the entry doesn't yet have an operation or a batch id, these will
+ be set to the insert operation and a batch_id specified as a parameter.
+
+ Args:
+ entry: BatchEntry The entry which will be sent in the batch feed as an
+ insert request.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. Note that batch_ids should either always be specified or
+ never, mixing could potentially result in duplicate batch ids.
+ """
+ self.add_batch_entry(entry=entry, batch_id_string=batch_id_string,
+ operation_string=BATCH_INSERT)
+
+ AddInsert = add_insert
+
+ def add_update(self, entry, batch_id_string=None):
+ """Add an update request to the list of batch operations in this feed.
+
+ Sets the operation type of the entry to insert if it is not already set
+ and assigns the desired batch id to the entry so that it can be
+ referenced in the server's response.
+
+ Args:
+ entry: BatchEntry The entry which will be sent to the server as an
+ update (HTTP PUT) request. The item must have a valid atom id
+ so that the server knows which entry to replace.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. See also comments for AddInsert.
+ """
+ self.add_batch_entry(entry=entry, batch_id_string=batch_id_string,
+ operation_string=BATCH_UPDATE)
+
+ AddUpdate = add_update
+
+ def add_delete(self, url_string=None, entry=None, batch_id_string=None):
+ """Adds a delete request to the batch request feed.
+
+ This method takes either the url_string which is the atom id of the item
+ to be deleted, or the entry itself. The atom id of the entry must be
+ present so that the server knows which entry should be deleted.
+
+ Args:
+ url_string: str (optional) The URL of the entry to be deleted. You can
+ find this URL in the text member of the atom id for an entry.
+ entry: BatchEntry (optional) The entry to be deleted.
+ batch_id_string: str (optional)
+
+ Raises:
+ MissingRequiredParameters: Raised if neither a url_string nor an entry
+ are provided in the request.
+ """
+ self.add_batch_entry(entry=entry, id_url_string=url_string,
+ batch_id_string=batch_id_string, operation_string=BATCH_DELETE)
+
+ AddDelete = add_delete
+
+ def add_query(self, url_string=None, entry=None, batch_id_string=None):
+ """Adds a query request to the batch request feed.
+
+ This method takes either the url_string which is the query URL
+ whose results will be added to the result feed. The query URL will
+ be encapsulated in a BatchEntry, and you may pass in the BatchEntry
+ with a query URL instead of sending a url_string.
+
+ Args:
+ url_string: str (optional)
+ entry: BatchEntry (optional)
+ batch_id_string: str (optional)
+
+ Raises:
+ MissingRequiredParameters
+ """
+ self.add_batch_entry(entry=entry, id_url_string=url_string,
+ batch_id_string=batch_id_string, operation_string=BATCH_QUERY)
+
+ AddQuery = add_query
+
+ def find_batch_link(self):
+ return self.find_url('http://schemas.google.com/g/2005#batch')
+
+ FindBatchLink = find_batch_link
+
+
+class EntryLink(atom.core.XmlElement):
+ """The gd:entryLink element.
+
+ Represents a logically nested entry. For example, a <gd:who>
+ representing a contact might have a nested entry from a contact feed.
+ """
+ _qname = GDATA_TEMPLATE % 'entryLink'
+ entry = GDEntry
+ rel = 'rel'
+ read_only = 'readOnly'
+ href = 'href'
+
+
+class FeedLink(atom.core.XmlElement):
+ """The gd:feedLink element.
+
+ Represents a logically nested feed. For example, a calendar feed might
+ have a nested feed representing all comments on entries.
+ """
+ _qname = GDATA_TEMPLATE % 'feedLink'
+ feed = GDFeed
+ rel = 'rel'
+ read_only = 'readOnly'
+ count_hint = 'countHint'
+ href = 'href'
+
+
+class AdditionalName(atom.core.XmlElement):
+ """The gd:additionalName element.
+
+ Specifies additional (eg. middle) name of the person.
+ Contains an attribute for the phonetic representaton of the name.
+ """
+ _qname = GDATA_TEMPLATE % 'additionalName'
+ yomi = 'yomi'
+
+
+class Comments(atom.core.XmlElement):
+ """The gd:comments element.
+
+ Contains a comments feed for the enclosing entry (such as a calendar event).
+ """
+ _qname = GDATA_TEMPLATE % 'comments'
+ rel = 'rel'
+ feed_link = FeedLink
+
+
+class Country(atom.core.XmlElement):
+ """The gd:country element.
+
+ Country name along with optional country code. The country code is
+ given in accordance with ISO 3166-1 alpha-2:
+ http://www.iso.org/iso/iso-3166-1_decoding_table
+ """
+ _qname = GDATA_TEMPLATE % 'country'
+ code = 'code'
+
+
+class EmailImParent(atom.core.XmlElement):
+ address = 'address'
+ label = 'label'
+ rel = 'rel'
+ primary = 'primary'
+
+
+class Email(EmailImParent):
+ """The gd:email element.
+
+ An email address associated with the containing entity (which is
+ usually an entity representing a person or a location).
+ """
+ _qname = GDATA_TEMPLATE % 'email'
+ display_name = 'displayName'
+
+
+class FamilyName(atom.core.XmlElement):
+ """The gd:familyName element.
+
+ Specifies family name of the person, eg. "Smith".
+ """
+ _qname = GDATA_TEMPLATE % 'familyName'
+ yomi = 'yomi'
+
+
+class Im(EmailImParent):
+ """The gd:im element.
+
+ An instant messaging address associated with the containing entity.
+ """
+ _qname = GDATA_TEMPLATE % 'im'
+ protocol = 'protocol'
+
+
+class GivenName(atom.core.XmlElement):
+ """The gd:givenName element.
+
+ Specifies given name of the person, eg. "John".
+ """
+ _qname = GDATA_TEMPLATE % 'givenName'
+ yomi = 'yomi'
+
+
+class NamePrefix(atom.core.XmlElement):
+ """The gd:namePrefix element.
+
+ Honorific prefix, eg. 'Mr' or 'Mrs'.
+ """
+ _qname = GDATA_TEMPLATE % 'namePrefix'
+
+
+class NameSuffix(atom.core.XmlElement):
+ """The gd:nameSuffix element.
+
+ Honorific suffix, eg. 'san' or 'III'.
+ """
+ _qname = GDATA_TEMPLATE % 'nameSuffix'
+
+
+class FullName(atom.core.XmlElement):
+ """The gd:fullName element.
+
+ Unstructured representation of the name.
+ """
+ _qname = GDATA_TEMPLATE % 'fullName'
+
+
+class Name(atom.core.XmlElement):
+ """The gd:name element.
+
+ Allows storing person's name in a structured way. Consists of
+ given name, additional name, family name, prefix, suffix and full name.
+ """
+ _qname = GDATA_TEMPLATE % 'name'
+ given_name = GivenName
+ additional_name = AdditionalName
+ family_name = FamilyName
+ name_prefix = NamePrefix
+ name_suffix = NameSuffix
+ full_name = FullName
+
+
+class OrgDepartment(atom.core.XmlElement):
+ """The gd:orgDepartment element.
+
+ Describes a department within an organization. Must appear within a
+ gd:organization element.
+ """
+ _qname = GDATA_TEMPLATE % 'orgDepartment'
+
+
+class OrgJobDescription(atom.core.XmlElement):
+ """The gd:orgJobDescription element.
+
+ Describes a job within an organization. Must appear within a
+ gd:organization element.
+ """
+ _qname = GDATA_TEMPLATE % 'orgJobDescription'
+
+
+class OrgName(atom.core.XmlElement):
+ """The gd:orgName element.
+
+ The name of the organization. Must appear within a gd:organization
+ element.
+
+ Contains a Yomigana attribute (Japanese reading aid) for the
+ organization name.
+ """
+ _qname = GDATA_TEMPLATE % 'orgName'
+ yomi = 'yomi'
+
+
+class OrgSymbol(atom.core.XmlElement):
+ """The gd:orgSymbol element.
+
+ Provides a symbol of an organization. Must appear within a
+ gd:organization element.
+ """
+ _qname = GDATA_TEMPLATE % 'orgSymbol'
+
+
+class OrgTitle(atom.core.XmlElement):
+ """The gd:orgTitle element.
+
+ The title of a person within an organization. Must appear within a
+ gd:organization element.
+ """
+ _qname = GDATA_TEMPLATE % 'orgTitle'
+
+
+class Organization(atom.core.XmlElement):
+ """The gd:organization element.
+
+ An organization, typically associated with a contact.
+ """
+ _qname = GDATA_TEMPLATE % 'organization'
+ label = 'label'
+ primary = 'primary'
+ rel = 'rel'
+ department = OrgDepartment
+ job_description = OrgJobDescription
+ name = OrgName
+ symbol = OrgSymbol
+ title = OrgTitle
+
+
+class When(atom.core.XmlElement):
+ """The gd:when element.
+
+ Represents a period of time or an instant.
+ """
+ _qname = GDATA_TEMPLATE % 'when'
+ end = 'endTime'
+ start = 'startTime'
+ value = 'valueString'
+
+
+class OriginalEvent(atom.core.XmlElement):
+ """The gd:originalEvent element.
+
+ Equivalent to the Recurrence ID property specified in section 4.8.4.4
+ of RFC 2445. Appears in every instance of a recurring event, to identify
+ the original event.
+
+ Contains a <gd:when> element specifying the original start time of the
+ instance that has become an exception.
+ """
+ _qname = GDATA_TEMPLATE % 'originalEvent'
+ id = 'id'
+ href = 'href'
+ when = When
+
+
+class PhoneNumber(atom.core.XmlElement):
+ """The gd:phoneNumber element.
+
+ A phone number associated with the containing entity (which is usually
+ an entity representing a person or a location).
+ """
+ _qname = GDATA_TEMPLATE % 'phoneNumber'
+ label = 'label'
+ rel = 'rel'
+ uri = 'uri'
+ primary = 'primary'
+
+
+class PostalAddress(atom.core.XmlElement):
+ """The gd:postalAddress element."""
+ _qname = GDATA_TEMPLATE % 'postalAddress'
+ label = 'label'
+ rel = 'rel'
+ uri = 'uri'
+ primary = 'primary'
+
+
+class Rating(atom.core.XmlElement):
+ """The gd:rating element.
+
+ Represents a numeric rating of the enclosing entity, such as a
+ comment. Each rating supplies its own scale, although it may be
+ normalized by a service; for example, some services might convert all
+ ratings to a scale from 1 to 5.
+ """
+ _qname = GDATA_TEMPLATE % 'rating'
+ average = 'average'
+ max = 'max'
+ min = 'min'
+ num_raters = 'numRaters'
+ rel = 'rel'
+ value = 'value'
+
+
+class Recurrence(atom.core.XmlElement):
+ """The gd:recurrence element.
+
+ Represents the dates and times when a recurring event takes place.
+
+ The string that defines the recurrence consists of a set of properties,
+ each of which is defined in the iCalendar standard (RFC 2445).
+
+ Specifically, the string usually begins with a DTSTART property that
+ indicates the starting time of the first instance of the event, and
+ often a DTEND property or a DURATION property to indicate when the
+ first instance ends. Next come RRULE, RDATE, EXRULE, and/or EXDATE
+ properties, which collectively define a recurring event and its
+ exceptions (but see below). (See section 4.8.5 of RFC 2445 for more
+ information about these recurrence component properties.) Last comes a
+ VTIMEZONE component, providing detailed timezone rules for any timezone
+ ID mentioned in the preceding properties.
+
+ Google services like Google Calendar don't generally generate EXRULE
+ and EXDATE properties to represent exceptions to recurring events;
+ instead, they generate <gd:recurrenceException> elements. However,
+ Google services may include EXRULE and/or EXDATE properties anyway;
+ for example, users can import events and exceptions into Calendar, and
+ if those imported events contain EXRULE or EXDATE properties, then
+ Calendar will provide those properties when it sends a <gd:recurrence>
+ element.
+
+ Note the the use of <gd:recurrenceException> means that you can't be
+ sure just from examining a <gd:recurrence> element whether there are
+ any exceptions to the recurrence description. To ensure that you find
+ all exceptions, look for <gd:recurrenceException> elements in the feed,
+ and use their <gd:originalEvent> elements to match them up with
+ <gd:recurrence> elements.
+ """
+ _qname = GDATA_TEMPLATE % 'recurrence'
+
+
+class RecurrenceException(atom.core.XmlElement):
+ """The gd:recurrenceException element.
+
+ Represents an event that's an exception to a recurring event-that is,
+ an instance of a recurring event in which one or more aspects of the
+ recurring event (such as attendance list, time, or location) have been
+ changed.
+
+ Contains a <gd:originalEvent> element that specifies the original
+ recurring event that this event is an exception to.
+
+ When you change an instance of a recurring event, that instance becomes
+ an exception. Depending on what change you made to it, the exception
+ behaves in either of two different ways when the original recurring
+ event is changed:
+
+ - If you add, change, or remove comments, attendees, or attendee
+ responses, then the exception remains tied to the original event, and
+ changes to the original event also change the exception.
+ - If you make any other changes to the exception (such as changing the
+ time or location) then the instance becomes "specialized," which means
+ that it's no longer as tightly tied to the original event. If you
+ change the original event, specialized exceptions don't change. But
+ see below.
+
+ For example, say you have a meeting every Tuesday and Thursday at
+ 2:00 p.m. If you change the attendance list for this Thursday's meeting
+ (but not for the regularly scheduled meeting), then it becomes an
+ exception. If you change the time for this Thursday's meeting (but not
+ for the regularly scheduled meeting), then it becomes specialized.
+
+ Regardless of whether an exception is specialized or not, if you do
+ something that deletes the instance that the exception was derived from,
+ then the exception is deleted. Note that changing the day or time of a
+ recurring event deletes all instances, and creates new ones.
+
+ For example, after you've specialized this Thursday's meeting, say you
+ change the recurring meeting to happen on Monday, Wednesday, and Friday.
+ That change deletes all of the recurring instances of the
+ Tuesday/Thursday meeting, including the specialized one.
+
+ If a particular instance of a recurring event is deleted, then that
+ instance appears as a <gd:recurrenceException> containing a
+ <gd:entryLink> that has its <gd:eventStatus> set to
+ "http://schemas.google.com/g/2005#event.canceled". (For more
+ information about canceled events, see RFC 2445.)
+ """
+ _qname = GDATA_TEMPLATE % 'recurrenceException'
+ specialized = 'specialized'
+ entry_link = EntryLink
+ original_event = OriginalEvent
+
+
+class Reminder(atom.core.XmlElement):
+ """The gd:reminder element.
+
+ A time interval, indicating how long before the containing entity's start
+ time or due time attribute a reminder should be issued. Alternatively,
+ may specify an absolute time at which a reminder should be issued. Also
+ specifies a notification method, indicating what medium the system
+ should use to remind the user.
+ """
+ _qname = GDATA_TEMPLATE % 'reminder'
+ absolute_time = 'absoluteTime'
+ method = 'method'
+ days = 'days'
+ hours = 'hours'
+ minutes = 'minutes'
+
+
+class Transparency(atom.core.XmlElement):
+ """The gd:transparency element:
+
+ Extensible enum corresponding to the TRANSP property defined in RFC 244.
+ """
+ _qname = GDATA_TEMPLATE % 'transparency'
+ value = 'value'
+
+
+class Agent(atom.core.XmlElement):
+ """The gd:agent element.
+
+ The agent who actually receives the mail. Used in work addresses.
+ Also for 'in care of' or 'c/o'.
+ """
+ _qname = GDATA_TEMPLATE % 'agent'
+
+
+class HouseName(atom.core.XmlElement):
+ """The gd:housename element.
+
+ Used in places where houses or buildings have names (and not
+ necessarily numbers), eg. "The Pillars".
+ """
+ _qname = GDATA_TEMPLATE % 'housename'
+
+
+class Street(atom.core.XmlElement):
+ """The gd:street element.
+
+ Can be street, avenue, road, etc. This element also includes the
+ house number and room/apartment/flat/floor number.
+ """
+ _qname = GDATA_TEMPLATE % 'street'
+
+
+class PoBox(atom.core.XmlElement):
+ """The gd:pobox element.
+
+ Covers actual P.O. boxes, drawers, locked bags, etc. This is usually
+ but not always mutually exclusive with street.
+ """
+ _qname = GDATA_TEMPLATE % 'pobox'
+
+
+class Neighborhood(atom.core.XmlElement):
+ """The gd:neighborhood element.
+
+ This is used to disambiguate a street address when a city contains more
+ than one street with the same name, or to specify a small place whose
+ mail is routed through a larger postal town. In China it could be a
+ county or a minor city.
+ """
+ _qname = GDATA_TEMPLATE % 'neighborhood'
+
+
+class City(atom.core.XmlElement):
+ """The gd:city element.
+
+ Can be city, village, town, borough, etc. This is the postal town and
+ not necessarily the place of residence or place of business.
+ """
+ _qname = GDATA_TEMPLATE % 'city'
+
+
+class Subregion(atom.core.XmlElement):
+ """The gd:subregion element.
+
+ Handles administrative districts such as U.S. or U.K. counties that are
+ not used for mail addressing purposes. Subregion is not intended for
+ delivery addresses.
+ """
+ _qname = GDATA_TEMPLATE % 'subregion'
+
+
+class Region(atom.core.XmlElement):
+ """The gd:region element.
+
+ A state, province, county (in Ireland), Land (in Germany),
+ departement (in France), etc.
+ """
+ _qname = GDATA_TEMPLATE % 'region'
+
+
+class Postcode(atom.core.XmlElement):
+ """The gd:postcode element.
+
+ Postal code. Usually country-wide, but sometimes specific to the
+ city (e.g. "2" in "Dublin 2, Ireland" addresses).
+ """
+ _qname = GDATA_TEMPLATE % 'postcode'
+
+
+class Country(atom.core.XmlElement):
+ """The gd:country element.
+
+ The name or code of the country.
+ """
+ _qname = GDATA_TEMPLATE % 'country'
+
+
+class FormattedAddress(atom.core.XmlElement):
+ """The gd:formattedAddress element.
+
+ The full, unstructured postal address.
+ """
+ _qname = GDATA_TEMPLATE % 'formattedAddress'
+
+
+class StructuredPostalAddress(atom.core.XmlElement):
+ """The gd:structuredPostalAddress element.
+
+ Postal address split into components. It allows to store the address
+ in locale independent format. The fields can be interpreted and used
+ to generate formatted, locale dependent address. The following elements
+ reperesent parts of the address: agent, house name, street, P.O. box,
+ neighborhood, city, subregion, region, postal code, country. The
+ subregion element is not used for postal addresses, it is provided for
+ extended uses of addresses only. In order to store postal address in an
+ unstructured form formatted address field is provided.
+ """
+ _qname = GDATA_TEMPLATE % 'structuredPostalAddress'
+ rel = 'rel'
+ mail_class = 'mailClass'
+ usage = 'usage'
+ label = 'label'
+ primary = 'primary'
+ agent = Agent
+ house_name = HouseName
+ street = Street
+ po_box = PoBox
+ neighborhood = Neighborhood
+ city = City
+ subregion = Subregion
+ region = Region
+ postcode = Postcode
+ country = Country
+ formatted_address = FormattedAddress
+
+
+class Where(atom.core.XmlElement):
+ """The gd:where element.
+
+ A place (such as an event location) associated with the containing
+ entity. The type of the association is determined by the rel attribute;
+ the details of the location are contained in an embedded or linked-to
+ Contact entry.
+
+ A <gd:where> element is more general than a <gd:geoPt> element. The
+ former identifies a place using a text description and/or a Contact
+ entry, while the latter identifies a place using a specific geographic
+ location.
+ """
+ _qname = GDATA_TEMPLATE % 'where'
+ label = 'label'
+ rel = 'rel'
+ value = 'valueString'
+ entry_link = EntryLink
+
+
+class AttendeeType(atom.core.XmlElement):
+ """The gd:attendeeType element."""
+ _qname = GDATA_TEMPLATE % 'attendeeType'
+ value = 'value'
+
+
+class AttendeeStatus(atom.core.XmlElement):
+ """The gd:attendeeStatus element."""
+ _qname = GDATA_TEMPLATE % 'attendeeStatus'
+ value = 'value'
+
+
+class EventStatus(atom.core.XmlElement):
+ """The gd:eventStatus element."""
+ _qname = GDATA_TEMPLATE % 'eventStatus'
+ value = 'value'
+
+
+class Visibility(atom.core.XmlElement):
+ """The gd:visibility element."""
+ _qname = GDATA_TEMPLATE % 'visibility'
+ value = 'value'
+
+
+class Who(atom.core.XmlElement):
+ """The gd:who element.
+
+ A person associated with the containing entity. The type of the
+ association is determined by the rel attribute; the details about the
+ person are contained in an embedded or linked-to Contact entry.
+
+ The <gd:who> element can be used to specify email senders and
+ recipients, calendar event organizers, and so on.
+ """
+ _qname = GDATA_TEMPLATE % 'who'
+ email = 'email'
+ rel = 'rel'
+ value = 'valueString'
+ attendee_status = AttendeeStatus
+ attendee_type = AttendeeType
+ entry_link = EntryLink
+
+
+class Deleted(atom.core.XmlElement):
+ """gd:deleted when present, indicates the containing entry is deleted."""
+ _qname = GD_TEMPLATE % 'deleted'
+
+
+class Money(atom.core.XmlElement):
+ """Describes money"""
+ _qname = GD_TEMPLATE % 'money'
+ amount = 'amount'
+ currency_code = 'currencyCode'
+
+
+class MediaSource(object):
+ """GData Entries can refer to media sources, so this class provides a
+ place to store references to these objects along with some metadata.
+ """
+
+ def __init__(self, file_handle=None, content_type=None, content_length=None,
+ file_path=None, file_name=None):
+ """Creates an object of type MediaSource.
+
+ Args:
+ file_handle: A file handle pointing to the file to be encapsulated in the
+ MediaSource.
+ content_type: string The MIME type of the file. Required if a file_handle
+ is given.
+ content_length: int The size of the file. Required if a file_handle is
+ given.
+ file_path: string (optional) A full path name to the file. Used in
+ place of a file_handle.
+ file_name: string The name of the file without any path information.
+ Required if a file_handle is given.
+ """
+ self.file_handle = file_handle
+ self.content_type = content_type
+ self.content_length = content_length
+ self.file_name = file_name
+
+ if (file_handle is None and content_type is not None and
+ file_path is not None):
+ self.set_file_handle(file_path, content_type)
+
+ def set_file_handle(self, file_name, content_type):
+ """A helper function which can create a file handle from a given filename
+ and set the content type and length all at once.
+
+ Args:
+ file_name: string The path and file name to the file containing the media
+ content_type: string A MIME type representing the type of the media
+ """
+
+ self.file_handle = open(file_name, 'rb')
+ self.content_type = content_type
+ self.content_length = os.path.getsize(file_name)
+ self.file_name = os.path.basename(file_name)
+
+ SetFileHandle = set_file_handle
+
+ def modify_request(self, http_request):
+ http_request.add_body_part(self.file_handle, self.content_type,
+ self.content_length)
+ return http_request
+
+ ModifyRequest = modify_request
diff --git a/samples/apps/marketplace_sample/gdata/gauth.py b/samples/apps/marketplace_sample/gdata/gauth.py
new file mode 100644
index 0000000..9c95e4f
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/gauth.py
@@ -0,0 +1,1558 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+"""Provides auth related token classes and functions for Google Data APIs.
+
+Token classes represent a user's authorization of this app to access their
+data. Usually these are not created directly but by a GDClient object.
+
+ClientLoginToken
+AuthSubToken
+SecureAuthSubToken
+OAuthHmacToken
+OAuthRsaToken
+TwoLeggedOAuthHmacToken
+TwoLeggedOAuthRsaToken
+
+Functions which are often used in application code (as opposed to just within
+the gdata-python-client library) are the following:
+
+generate_auth_sub_url
+authorize_request_token
+
+The following are helper functions which are used to save and load auth token
+objects in the App Engine datastore. These should only be used if you are using
+this library within App Engine:
+
+ae_load
+ae_save
+"""
+
+
+import datetime
+import time
+import random
+import urllib
+import urlparse
+import atom.http_core
+
+try:
+ import simplejson
+except ImportError:
+ try:
+ # Try to import from django, should work on App Engine
+ from django.utils import simplejson
+ except ImportError:
+ # Should work for Python2.6 and higher.
+ import json as simplejson
+
+try:
+ from urlparse import parse_qsl
+except ImportError:
+ from cgi import parse_qsl
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+PROGRAMMATIC_AUTH_LABEL = 'GoogleLogin auth='
+AUTHSUB_AUTH_LABEL = 'AuthSub token='
+OAUTH2_AUTH_LABEL = 'OAuth '
+
+
+# This dict provides the AuthSub and OAuth scopes for all services by service
+# name. The service name (key) is used in ClientLogin requests.
+AUTH_SCOPES = {
+ 'cl': ( # Google Calendar API
+ 'https://www.google.com/calendar/feeds/',
+ 'http://www.google.com/calendar/feeds/'),
+ 'gbase': ( # Google Base API
+ 'http://base.google.com/base/feeds/',
+ 'http://www.google.com/base/feeds/'),
+ 'blogger': ( # Blogger API
+ 'http://www.blogger.com/feeds/',),
+ 'codesearch': ( # Google Code Search API
+ 'http://www.google.com/codesearch/feeds/',),
+ 'cp': ( # Contacts API
+ 'https://www.google.com/m8/feeds/',
+ 'http://www.google.com/m8/feeds/'),
+ 'finance': ( # Google Finance API
+ 'http://finance.google.com/finance/feeds/',),
+ 'health': ( # Google Health API
+ 'https://www.google.com/health/feeds/',),
+ 'writely': ( # Documents List API
+ 'https://docs.google.com/feeds/',
+ 'https://spreadsheets.google.com/feeds/',
+ 'https://docs.googleusercontent.com/'),
+ 'lh2': ( # Picasa Web Albums API
+ 'http://picasaweb.google.com/data/',),
+ 'apps': ( # Google Apps Provisioning API
+ 'https://apps-apis.google.com/a/feeds/user/',
+ 'https://apps-apis.google.com/a/feeds/policies/',
+ 'https://apps-apis.google.com/a/feeds/alias/',
+ 'https://apps-apis.google.com/a/feeds/groups/'),
+ 'weaver': ( # Health H9 Sandbox
+ 'https://www.google.com/h9/feeds/',),
+ 'wise': ( # Spreadsheets Data API
+ 'https://spreadsheets.google.com/feeds/',),
+ 'sitemaps': ( # Google Webmaster Tools API
+ 'https://www.google.com/webmasters/tools/feeds/',),
+ 'youtube': ( # YouTube API
+ 'http://gdata.youtube.com/feeds/api/',
+ 'http://uploads.gdata.youtube.com/feeds/api',
+ 'http://gdata.youtube.com/action/GetUploadToken'),
+ 'books': ( # Google Books API
+ 'http://www.google.com/books/feeds/',),
+ 'analytics': ( # Google Analytics API
+ 'https://www.google.com/analytics/feeds/',),
+ 'jotspot': ( # Google Sites API
+ 'http://sites.google.com/feeds/',
+ 'https://sites.google.com/feeds/'),
+ 'local': ( # Google Maps Data API
+ 'http://maps.google.com/maps/feeds/',),
+ 'code': ( # Project Hosting Data API
+ 'http://code.google.com/feeds/issues',)}
+
+
+
+class Error(Exception):
+ pass
+
+
+class UnsupportedTokenType(Error):
+ """Raised when token to or from blob is unable to convert the token."""
+ pass
+
+
+class OAuth2AccessTokenError(Error):
+ """Raised when an OAuth2 error occurs."""
+ def __init__(self, error_message):
+ self.error_message = error_message
+
+
+# ClientLogin functions and classes.
+def generate_client_login_request_body(email, password, service, source,
+ account_type='HOSTED_OR_GOOGLE', captcha_token=None,
+ captcha_response=None):
+ """Creates the body of the autentication request
+
+ See http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request
+ for more details.
+
+ Args:
+ email: str
+ password: str
+ service: str
+ source: str
+ account_type: str (optional) Defaul is 'HOSTED_OR_GOOGLE', other valid
+ values are 'GOOGLE' and 'HOSTED'
+ captcha_token: str (optional)
+ captcha_response: str (optional)
+
+ Returns:
+ The HTTP body to send in a request for a client login token.
+ """
+ # Create a POST body containing the user's credentials.
+ request_fields = {'Email': email,
+ 'Passwd': password,
+ 'accountType': account_type,
+ 'service': service,
+ 'source': source}
+ if captcha_token and captcha_response:
+ # Send the captcha token and response as part of the POST body if the
+ # user is responding to a captch challenge.
+ request_fields['logintoken'] = captcha_token
+ request_fields['logincaptcha'] = captcha_response
+ return urllib.urlencode(request_fields)
+
+
+GenerateClientLoginRequestBody = generate_client_login_request_body
+
+
+def get_client_login_token_string(http_body):
+ """Returns the token value for a ClientLoginToken.
+
+ Reads the token from the server's response to a Client Login request and
+ creates the token value string to use in requests.
+
+ Args:
+ http_body: str The body of the server's HTTP response to a Client Login
+ request
+
+ Returns:
+ The token value string for a ClientLoginToken.
+ """
+ for response_line in http_body.splitlines():
+ if response_line.startswith('Auth='):
+ # Strip off the leading Auth= and return the Authorization value.
+ return response_line[5:]
+ return None
+
+
+GetClientLoginTokenString = get_client_login_token_string
+
+
+def get_captcha_challenge(http_body,
+ captcha_base_url='http://www.google.com/accounts/'):
+ """Returns the URL and token for a CAPTCHA challenge issued by the server.
+
+ Args:
+ http_body: str The body of the HTTP response from the server which
+ contains the CAPTCHA challenge.
+ captcha_base_url: str This function returns a full URL for viewing the
+ challenge image which is built from the server's response. This
+ base_url is used as the beginning of the URL because the server
+ only provides the end of the URL. For example the server provides
+ 'Captcha?ctoken=Hi...N' and the URL for the image is
+ 'http://www.google.com/accounts/Captcha?ctoken=Hi...N'
+
+ Returns:
+ A dictionary containing the information needed to repond to the CAPTCHA
+ challenge, the image URL and the ID token of the challenge. The
+ dictionary is in the form:
+ {'token': string identifying the CAPTCHA image,
+ 'url': string containing the URL of the image}
+ Returns None if there was no CAPTCHA challenge in the response.
+ """
+ contains_captcha_challenge = False
+ captcha_parameters = {}
+ for response_line in http_body.splitlines():
+ if response_line.startswith('Error=CaptchaRequired'):
+ contains_captcha_challenge = True
+ elif response_line.startswith('CaptchaToken='):
+ # Strip off the leading CaptchaToken=
+ captcha_parameters['token'] = response_line[13:]
+ elif response_line.startswith('CaptchaUrl='):
+ captcha_parameters['url'] = '%s%s' % (captcha_base_url,
+ response_line[11:])
+ if contains_captcha_challenge:
+ return captcha_parameters
+ else:
+ return None
+
+
+GetCaptchaChallenge = get_captcha_challenge
+
+
+class ClientLoginToken(object):
+
+ def __init__(self, token_string):
+ self.token_string = token_string
+
+ def modify_request(self, http_request):
+ http_request.headers['Authorization'] = '%s%s' % (PROGRAMMATIC_AUTH_LABEL,
+ self.token_string)
+
+ ModifyRequest = modify_request
+
+
+# AuthSub functions and classes.
+def _to_uri(str_or_uri):
+ if isinstance(str_or_uri, (str, unicode)):
+ return atom.http_core.Uri.parse_uri(str_or_uri)
+ return str_or_uri
+
+
+def generate_auth_sub_url(next, scopes, secure=False, session=True,
+ request_url=atom.http_core.parse_uri(
+ 'https://www.google.com/accounts/AuthSubRequest'),
+ domain='default', scopes_param_prefix='auth_sub_scopes'):
+ """Constructs a URI for requesting a multiscope AuthSub token.
+
+ The generated token will contain a URL parameter to pass along the
+ requested scopes to the next URL. When the Google Accounts page
+ redirects the broswser to the 'next' URL, it appends the single use
+ AuthSub token value to the URL as a URL parameter with the key 'token'.
+ However, the information about which scopes were requested is not
+ included by Google Accounts. This method adds the scopes to the next
+ URL before making the request so that the redirect will be sent to
+ a page, and both the token value and the list of scopes for which the token
+ was requested.
+
+ Args:
+ next: atom.http_core.Uri or string The URL user will be sent to after
+ authorizing this web application to access their data.
+ scopes: list containint strings or atom.http_core.Uri objects. The URLs
+ of the services to be accessed. Could also be a single string
+ or single atom.http_core.Uri for requesting just one scope.
+ secure: boolean (optional) Determines whether or not the issued token
+ is a secure token.
+ session: boolean (optional) Determines whether or not the issued token
+ can be upgraded to a session token.
+ request_url: atom.http_core.Uri or str The beginning of the request URL.
+ This is normally
+ 'http://www.google.com/accounts/AuthSubRequest' or
+ '/accounts/AuthSubRequest'
+ domain: The domain which the account is part of. This is used for Google
+ Apps accounts, the default value is 'default' which means that
+ the requested account is a Google Account (@gmail.com for
+ example)
+ scopes_param_prefix: str (optional) The requested scopes are added as a
+ URL parameter to the next URL so that the page at
+ the 'next' URL can extract the token value and the
+ valid scopes from the URL. The key for the URL
+ parameter defaults to 'auth_sub_scopes'
+
+ Returns:
+ An atom.http_core.Uri which the user's browser should be directed to in
+ order to authorize this application to access their information.
+ """
+ if isinstance(next, (str, unicode)):
+ next = atom.http_core.Uri.parse_uri(next)
+ # If the user passed in a string instead of a list for scopes, convert to
+ # a single item tuple.
+ if isinstance(scopes, (str, unicode, atom.http_core.Uri)):
+ scopes = (scopes,)
+ scopes_string = ' '.join([str(scope) for scope in scopes])
+ next.query[scopes_param_prefix] = scopes_string
+
+ if isinstance(request_url, (str, unicode)):
+ request_url = atom.http_core.Uri.parse_uri(request_url)
+ request_url.query['next'] = str(next)
+ request_url.query['scope'] = scopes_string
+ if session:
+ request_url.query['session'] = '1'
+ else:
+ request_url.query['session'] = '0'
+ if secure:
+ request_url.query['secure'] = '1'
+ else:
+ request_url.query['secure'] = '0'
+ request_url.query['hd'] = domain
+ return request_url
+
+
+def auth_sub_string_from_url(url, scopes_param_prefix='auth_sub_scopes'):
+ """Finds the token string (and scopes) after the browser is redirected.
+
+ After the Google Accounts AuthSub pages redirect the user's broswer back to
+ the web application (using the 'next' URL from the request) the web app must
+ extract the token from the current page's URL. The token is provided as a
+ URL parameter named 'token' and if generate_auth_sub_url was used to create
+ the request, the token's valid scopes are included in a URL parameter whose
+ name is specified in scopes_param_prefix.
+
+ Args:
+ url: atom.url.Url or str representing the current URL. The token value
+ and valid scopes should be included as URL parameters.
+ scopes_param_prefix: str (optional) The URL parameter key which maps to
+ the list of valid scopes for the token.
+
+ Returns:
+ A tuple containing the token value as a string, and a tuple of scopes
+ (as atom.http_core.Uri objects) which are URL prefixes under which this
+ token grants permission to read and write user data.
+ (token_string, (scope_uri, scope_uri, scope_uri, ...))
+ If no scopes were included in the URL, the second value in the tuple is
+ None. If there was no token param in the url, the tuple returned is
+ (None, None)
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.http_core.Uri.parse_uri(url)
+ if 'token' not in url.query:
+ return (None, None)
+ token = url.query['token']
+ # TODO: decide whether no scopes should be None or ().
+ scopes = None # Default to None for no scopes.
+ if scopes_param_prefix in url.query:
+ scopes = tuple(url.query[scopes_param_prefix].split(' '))
+ return (token, scopes)
+
+
+AuthSubStringFromUrl = auth_sub_string_from_url
+
+
+def auth_sub_string_from_body(http_body):
+ """Extracts the AuthSub token from an HTTP body string.
+
+ Used to find the new session token after making a request to upgrade a
+ single use AuthSub token.
+
+ Args:
+ http_body: str The repsonse from the server which contains the AuthSub
+ key. For example, this function would find the new session token
+ from the server's response to an upgrade token request.
+
+ Returns:
+ The raw token value string to use in an AuthSubToken object.
+ """
+ for response_line in http_body.splitlines():
+ if response_line.startswith('Token='):
+ # Strip off Token= and return the token value string.
+ return response_line[6:]
+ return None
+
+
+class AuthSubToken(object):
+
+ def __init__(self, token_string, scopes=None):
+ self.token_string = token_string
+ self.scopes = scopes or []
+
+ def modify_request(self, http_request):
+ """Sets Authorization header, allows app to act on the user's behalf."""
+ http_request.headers['Authorization'] = '%s%s' % (AUTHSUB_AUTH_LABEL,
+ self.token_string)
+
+ ModifyRequest = modify_request
+
+ def from_url(str_or_uri):
+ """Creates a new AuthSubToken using information in the URL.
+
+ Uses auth_sub_string_from_url.
+
+ Args:
+ str_or_uri: The current page's URL (as a str or atom.http_core.Uri)
+ which should contain a token query parameter since the
+ Google auth server redirected the user's browser to this
+ URL.
+ """
+ token_and_scopes = auth_sub_string_from_url(str_or_uri)
+ return AuthSubToken(token_and_scopes[0], token_and_scopes[1])
+
+ from_url = staticmethod(from_url)
+ FromUrl = from_url
+
+ def _upgrade_token(self, http_body):
+ """Replaces the token value with a session token from the auth server.
+
+ Uses the response of a token upgrade request to modify this token. Uses
+ auth_sub_string_from_body.
+ """
+ self.token_string = auth_sub_string_from_body(http_body)
+
+
+# Functions and classes for Secure-mode AuthSub
+def build_auth_sub_data(http_request, timestamp, nonce):
+ """Creates the data string which must be RSA-signed in secure requests.
+
+ For more details see the documenation on secure AuthSub requests:
+ http://code.google.com/apis/accounts/docs/AuthSub.html#signingrequests
+
+ Args:
+ http_request: The request being made to the server. The Request's URL
+ must be complete before this signature is calculated as any changes
+ to the URL will invalidate the signature.
+ nonce: str Random 64-bit, unsigned number encoded as an ASCII string in
+ decimal format. The nonce/timestamp pair should always be unique to
+ prevent replay attacks.
+ timestamp: Integer representing the time the request is sent. The
+ timestamp should be expressed in number of seconds after January 1,
+ 1970 00:00:00 GMT.
+ """
+ return '%s %s %s %s' % (http_request.method, str(http_request.uri),
+ str(timestamp), nonce)
+
+
+def generate_signature(data, rsa_key):
+ """Signs the data string for a secure AuthSub request."""
+ import base64
+ try:
+ from tlslite.utils import keyfactory
+ except ImportError:
+ try:
+ from gdata.tlslite.utils import keyfactory
+ except ImportError:
+ from tlslite.tlslite.utils import keyfactory
+
+ private_key = keyfactory.parsePrivateKey(rsa_key)
+ signed = private_key.hashAndSign(data)
+ # Python2.3 and lower does not have the base64.b64encode function.
+ if hasattr(base64, 'b64encode'):
+ return base64.b64encode(signed)
+ else:
+ return base64.encodestring(signed).replace('\n', '')
+
+
+class SecureAuthSubToken(AuthSubToken):
+
+ def __init__(self, token_string, rsa_private_key, scopes=None):
+ self.token_string = token_string
+ self.scopes = scopes or []
+ self.rsa_private_key = rsa_private_key
+
+ def from_url(str_or_uri, rsa_private_key):
+ """Creates a new SecureAuthSubToken using information in the URL.
+
+ Uses auth_sub_string_from_url.
+
+ Args:
+ str_or_uri: The current page's URL (as a str or atom.http_core.Uri)
+ which should contain a token query parameter since the Google auth
+ server redirected the user's browser to this URL.
+ rsa_private_key: str the private RSA key cert used to sign all requests
+ made with this token.
+ """
+ token_and_scopes = auth_sub_string_from_url(str_or_uri)
+ return SecureAuthSubToken(token_and_scopes[0], rsa_private_key,
+ token_and_scopes[1])
+
+ from_url = staticmethod(from_url)
+ FromUrl = from_url
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header and includes a digital signature.
+
+ Calculates a digital signature using the private RSA key, a timestamp
+ (uses now at the time this method is called) and a random nonce.
+
+ Args:
+ http_request: The atom.http_core.HttpRequest which contains all of the
+ information needed to send a request to the remote server. The
+ URL and the method of the request must be already set and cannot be
+ changed after this token signs the request, or the signature will
+ not be valid.
+ """
+ timestamp = str(int(time.time()))
+ nonce = ''.join([str(random.randint(0, 9)) for i in xrange(15)])
+ data = build_auth_sub_data(http_request, timestamp, nonce)
+ signature = generate_signature(data, self.rsa_private_key)
+ http_request.headers['Authorization'] = (
+ '%s%s sigalg="rsa-sha1" data="%s" sig="%s"' % (AUTHSUB_AUTH_LABEL,
+ self.token_string, data, signature))
+
+ ModifyRequest = modify_request
+
+
+# OAuth functions and classes.
+RSA_SHA1 = 'RSA-SHA1'
+HMAC_SHA1 = 'HMAC-SHA1'
+
+
+def build_oauth_base_string(http_request, consumer_key, nonce, signaure_type,
+ timestamp, version, next='oob', token=None,
+ verifier=None):
+ """Generates the base string to be signed in the OAuth request.
+
+ Args:
+ http_request: The request being made to the server. The Request's URL
+ must be complete before this signature is calculated as any changes
+ to the URL will invalidate the signature.
+ consumer_key: Domain identifying the third-party web application. This is
+ the domain used when registering the application with Google. It
+ identifies who is making the request on behalf of the user.
+ nonce: Random 64-bit, unsigned number encoded as an ASCII string in decimal
+ format. The nonce/timestamp pair should always be unique to prevent
+ replay attacks.
+ signaure_type: either RSA_SHA1 or HMAC_SHA1
+ timestamp: Integer representing the time the request is sent. The
+ timestamp should be expressed in number of seconds after January 1,
+ 1970 00:00:00 GMT.
+ version: The OAuth version used by the requesting web application. This
+ value must be '1.0' or '1.0a'. If not provided, Google assumes version
+ 1.0 is in use.
+ next: The URL the user should be redirected to after granting access
+ to a Google service(s). It can include url-encoded query parameters.
+ The default value is 'oob'. (This is the oauth_callback.)
+ token: The string for the OAuth request token or OAuth access token.
+ verifier: str Sent as the oauth_verifier and required when upgrading a
+ request token to an access token.
+ """
+ # First we must build the canonical base string for the request.
+ params = http_request.uri.query.copy()
+ params['oauth_consumer_key'] = consumer_key
+ params['oauth_nonce'] = nonce
+ params['oauth_signature_method'] = signaure_type
+ params['oauth_timestamp'] = str(timestamp)
+ if next is not None:
+ params['oauth_callback'] = str(next)
+ if token is not None:
+ params['oauth_token'] = token
+ if version is not None:
+ params['oauth_version'] = version
+ if verifier is not None:
+ params['oauth_verifier'] = verifier
+ # We need to get the key value pairs in lexigraphically sorted order.
+ sorted_keys = None
+ try:
+ sorted_keys = sorted(params.keys())
+ # The sorted function is not available in Python2.3 and lower
+ except NameError:
+ sorted_keys = params.keys()
+ sorted_keys.sort()
+ pairs = []
+ for key in sorted_keys:
+ pairs.append('%s=%s' % (urllib.quote(key, safe='~'),
+ urllib.quote(params[key], safe='~')))
+ # We want to escape /'s too, so use safe='~'
+ all_parameters = urllib.quote('&'.join(pairs), safe='~')
+ normailzed_host = http_request.uri.host.lower()
+ normalized_scheme = (http_request.uri.scheme or 'http').lower()
+ non_default_port = None
+ if (http_request.uri.port is not None
+ and ((normalized_scheme == 'https' and http_request.uri.port != 443)
+ or (normalized_scheme == 'http' and http_request.uri.port != 80))):
+ non_default_port = http_request.uri.port
+ path = http_request.uri.path or '/'
+ request_path = None
+ if not path.startswith('/'):
+ path = '/%s' % path
+ if non_default_port is not None:
+ # Set the only safe char in url encoding to ~ since we want to escape /
+ # as well.
+ request_path = urllib.quote('%s://%s:%s%s' % (
+ normalized_scheme, normailzed_host, non_default_port, path), safe='~')
+ else:
+ # Set the only safe char in url encoding to ~ since we want to escape /
+ # as well.
+ request_path = urllib.quote('%s://%s%s' % (
+ normalized_scheme, normailzed_host, path), safe='~')
+ # TODO: ensure that token escaping logic is correct, not sure if the token
+ # value should be double escaped instead of single.
+ base_string = '&'.join((http_request.method.upper(), request_path,
+ all_parameters))
+ # Now we have the base string, we can calculate the oauth_signature.
+ return base_string
+
+
+def generate_hmac_signature(http_request, consumer_key, consumer_secret,
+ timestamp, nonce, version, next='oob',
+ token=None, token_secret=None, verifier=None):
+ import hmac
+ import base64
+ base_string = build_oauth_base_string(
+ http_request, consumer_key, nonce, HMAC_SHA1, timestamp, version,
+ next, token, verifier=verifier)
+ hash_key = None
+ hashed = None
+ if token_secret is not None:
+ hash_key = '%s&%s' % (urllib.quote(consumer_secret, safe='~'),
+ urllib.quote(token_secret, safe='~'))
+ else:
+ hash_key = '%s&' % urllib.quote(consumer_secret, safe='~')
+ try:
+ import hashlib
+ hashed = hmac.new(hash_key, base_string, hashlib.sha1)
+ except ImportError:
+ import sha
+ hashed = hmac.new(hash_key, base_string, sha)
+ # Python2.3 does not have base64.b64encode.
+ if hasattr(base64, 'b64encode'):
+ return base64.b64encode(hashed.digest())
+ else:
+ return base64.encodestring(hashed.digest()).replace('\n', '')
+
+
+def generate_rsa_signature(http_request, consumer_key, rsa_key,
+ timestamp, nonce, version, next='oob',
+ token=None, token_secret=None, verifier=None):
+ import base64
+ try:
+ from tlslite.utils import keyfactory
+ except ImportError:
+ try:
+ from gdata.tlslite.utils import keyfactory
+ except ImportError:
+ from tlslite.tlslite.utils import keyfactory
+ base_string = build_oauth_base_string(
+ http_request, consumer_key, nonce, RSA_SHA1, timestamp, version,
+ next, token, verifier=verifier)
+ private_key = keyfactory.parsePrivateKey(rsa_key)
+ # Sign using the key
+ signed = private_key.hashAndSign(base_string)
+ # Python2.3 does not have base64.b64encode.
+ if hasattr(base64, 'b64encode'):
+ return base64.b64encode(signed)
+ else:
+ return base64.encodestring(signed).replace('\n', '')
+
+
+def generate_auth_header(consumer_key, timestamp, nonce, signature_type,
+ signature, version='1.0', next=None, token=None,
+ verifier=None):
+ """Builds the Authorization header to be sent in the request.
+
+ Args:
+ consumer_key: Identifies the application making the request (str).
+ timestamp:
+ nonce:
+ signature_type: One of either HMAC_SHA1 or RSA_SHA1
+ signature: The HMAC or RSA signature for the request as a base64
+ encoded string.
+ version: The version of the OAuth protocol that this request is using.
+ Default is '1.0'
+ next: The URL of the page that the user's browser should be sent to
+ after they authorize the token. (Optional)
+ token: str The OAuth token value to be used in the oauth_token parameter
+ of the header.
+ verifier: str The OAuth verifier which must be included when you are
+ upgrading a request token to an access token.
+ """
+ params = {
+ 'oauth_consumer_key': consumer_key,
+ 'oauth_version': version,
+ 'oauth_nonce': nonce,
+ 'oauth_timestamp': str(timestamp),
+ 'oauth_signature_method': signature_type,
+ 'oauth_signature': signature}
+ if next is not None:
+ params['oauth_callback'] = str(next)
+ if token is not None:
+ params['oauth_token'] = token
+ if verifier is not None:
+ params['oauth_verifier'] = verifier
+ pairs = [
+ '%s="%s"' % (
+ k, urllib.quote(v, safe='~')) for k, v in params.iteritems()]
+ return 'OAuth %s' % (', '.join(pairs))
+
+
+REQUEST_TOKEN_URL = 'https://www.google.com/accounts/OAuthGetRequestToken'
+ACCESS_TOKEN_URL = 'https://www.google.com/accounts/OAuthGetAccessToken'
+
+
+def generate_request_for_request_token(
+ consumer_key, signature_type, scopes, rsa_key=None, consumer_secret=None,
+ auth_server_url=REQUEST_TOKEN_URL, next='oob', version='1.0'):
+ """Creates request to be sent to auth server to get an OAuth request token.
+
+ Args:
+ consumer_key:
+ signature_type: either RSA_SHA1 or HMAC_SHA1. The rsa_key must be
+ provided if the signature type is RSA but if the signature method
+ is HMAC, the consumer_secret must be used.
+ scopes: List of URL prefixes for the data which we want to access. For
+ example, to request access to the user's Blogger and Google Calendar
+ data, we would request
+ ['http://www.blogger.com/feeds/',
+ 'https://www.google.com/calendar/feeds/',
+ 'http://www.google.com/calendar/feeds/']
+ rsa_key: Only used if the signature method is RSA_SHA1.
+ consumer_secret: Only used if the signature method is HMAC_SHA1.
+ auth_server_url: The URL to which the token request should be directed.
+ Defaults to 'https://www.google.com/accounts/OAuthGetRequestToken'.
+ next: The URL of the page that the user's browser should be sent to
+ after they authorize the token. (Optional)
+ version: The OAuth version used by the requesting web application.
+ Defaults to '1.0a'
+
+ Returns:
+ An atom.http_core.HttpRequest object with the URL, Authorization header
+ and body filled in.
+ """
+ request = atom.http_core.HttpRequest(auth_server_url, 'POST')
+ # Add the requested auth scopes to the Auth request URL.
+ if scopes:
+ request.uri.query['scope'] = ' '.join(scopes)
+
+ timestamp = str(int(time.time()))
+ nonce = ''.join([str(random.randint(0, 9)) for i in xrange(15)])
+ signature = None
+ if signature_type == HMAC_SHA1:
+ signature = generate_hmac_signature(
+ request, consumer_key, consumer_secret, timestamp, nonce, version,
+ next=next)
+ elif signature_type == RSA_SHA1:
+ signature = generate_rsa_signature(
+ request, consumer_key, rsa_key, timestamp, nonce, version, next=next)
+ else:
+ return None
+
+ request.headers['Authorization'] = generate_auth_header(
+ consumer_key, timestamp, nonce, signature_type, signature, version,
+ next)
+ request.headers['Content-Length'] = '0'
+ return request
+
+
+def generate_request_for_access_token(
+ request_token, auth_server_url=ACCESS_TOKEN_URL):
+ """Creates a request to ask the OAuth server for an access token.
+
+ Requires a request token which the user has authorized. See the
+ documentation on OAuth with Google Data for more details:
+ http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken
+
+ Args:
+ request_token: An OAuthHmacToken or OAuthRsaToken which the user has
+ approved using their browser.
+ auth_server_url: (optional) The URL at which the OAuth access token is
+ requested. Defaults to
+ https://www.google.com/accounts/OAuthGetAccessToken
+
+ Returns:
+ A new HttpRequest object which can be sent to the OAuth server to
+ request an OAuth Access Token.
+ """
+ http_request = atom.http_core.HttpRequest(auth_server_url, 'POST')
+ http_request.headers['Content-Length'] = '0'
+ return request_token.modify_request(http_request)
+
+
+def oauth_token_info_from_body(http_body):
+ """Exracts an OAuth request token from the server's response.
+
+ Returns:
+ A tuple of strings containing the OAuth token and token secret. If
+ neither of these are present in the body, returns (None, None)
+ """
+ token = None
+ token_secret = None
+ for pair in http_body.split('&'):
+ if pair.startswith('oauth_token='):
+ token = urllib.unquote(pair[len('oauth_token='):])
+ if pair.startswith('oauth_token_secret='):
+ token_secret = urllib.unquote(pair[len('oauth_token_secret='):])
+ return (token, token_secret)
+
+
+def hmac_token_from_body(http_body, consumer_key, consumer_secret,
+ auth_state):
+ token_value, token_secret = oauth_token_info_from_body(http_body)
+ token = OAuthHmacToken(consumer_key, consumer_secret, token_value,
+ token_secret, auth_state)
+ return token
+
+
+def rsa_token_from_body(http_body, consumer_key, rsa_private_key,
+ auth_state):
+ token_value, token_secret = oauth_token_info_from_body(http_body)
+ token = OAuthRsaToken(consumer_key, rsa_private_key, token_value,
+ token_secret, auth_state)
+ return token
+
+
+DEFAULT_DOMAIN = 'default'
+OAUTH_AUTHORIZE_URL = 'https://www.google.com/accounts/OAuthAuthorizeToken'
+
+
+def generate_oauth_authorization_url(
+ token, next=None, hd=DEFAULT_DOMAIN, hl=None, btmpl=None,
+ auth_server=OAUTH_AUTHORIZE_URL):
+ """Creates a URL for the page where the request token can be authorized.
+
+ Args:
+ token: str The request token from the OAuth server.
+ next: str (optional) URL the user should be redirected to after granting
+ access to a Google service(s). It can include url-encoded query
+ parameters.
+ hd: str (optional) Identifies a particular hosted domain account to be
+ accessed (for example, 'mycollege.edu'). Uses 'default' to specify a
+ regular Google account ('username@gmail.com').
+ hl: str (optional) An ISO 639 country code identifying what language the
+ approval page should be translated in (for example, 'hl=en' for
+ English). The default is the user's selected language.
+ btmpl: str (optional) Forces a mobile version of the approval page. The
+ only accepted value is 'mobile'.
+ auth_server: str (optional) The start of the token authorization web
+ page. Defaults to
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'
+
+ Returns:
+ An atom.http_core.Uri pointing to the token authorization page where the
+ user may allow or deny this app to access their Google data.
+ """
+ uri = atom.http_core.Uri.parse_uri(auth_server)
+ uri.query['oauth_token'] = token
+ uri.query['hd'] = hd
+ if next is not None:
+ uri.query['oauth_callback'] = str(next)
+ if hl is not None:
+ uri.query['hl'] = hl
+ if btmpl is not None:
+ uri.query['btmpl'] = btmpl
+ return uri
+
+
+def oauth_token_info_from_url(url):
+ """Exracts an OAuth access token from the redirected page's URL.
+
+ Returns:
+ A tuple of strings containing the OAuth token and the OAuth verifier which
+ need to sent when upgrading a request token to an access token.
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.http_core.Uri.parse_uri(url)
+ token = None
+ verifier = None
+ if 'oauth_token' in url.query:
+ token = urllib.unquote(url.query['oauth_token'])
+ if 'oauth_verifier' in url.query:
+ verifier = urllib.unquote(url.query['oauth_verifier'])
+ return (token, verifier)
+
+
+def authorize_request_token(request_token, url):
+ """Adds information to request token to allow it to become an access token.
+
+ Modifies the request_token object passed in by setting and unsetting the
+ necessary fields to allow this token to form a valid upgrade request.
+
+ Args:
+ request_token: The OAuth request token which has been authorized by the
+ user. In order for this token to be upgraded to an access token,
+ certain fields must be extracted from the URL and added to the token
+ so that they can be passed in an upgrade-token request.
+ url: The URL of the current page which the user's browser was redirected
+ to after they authorized access for the app. This function extracts
+ information from the URL which is needed to upgraded the token from
+ a request token to an access token.
+
+ Returns:
+ The same token object which was passed in.
+ """
+ token, verifier = oauth_token_info_from_url(url)
+ request_token.token = token
+ request_token.verifier = verifier
+ request_token.auth_state = AUTHORIZED_REQUEST_TOKEN
+ return request_token
+
+
+AuthorizeRequestToken = authorize_request_token
+
+
+def upgrade_to_access_token(request_token, server_response_body):
+ """Extracts access token information from response to an upgrade request.
+
+ Once the server has responded with the new token info for the OAuth
+ access token, this method modifies the request_token to set and unset
+ necessary fields to create valid OAuth authorization headers for requests.
+
+ Args:
+ request_token: An OAuth token which this function modifies to allow it
+ to be used as an access token.
+ server_response_body: str The server's response to an OAuthAuthorizeToken
+ request. This should contain the new token and token_secret which
+ are used to generate the signature and parameters of the Authorization
+ header in subsequent requests to Google Data APIs.
+
+ Returns:
+ The same token object which was passed in.
+ """
+ token, token_secret = oauth_token_info_from_body(server_response_body)
+ request_token.token = token
+ request_token.token_secret = token_secret
+ request_token.auth_state = ACCESS_TOKEN
+ request_token.next = None
+ request_token.verifier = None
+ return request_token
+
+
+UpgradeToAccessToken = upgrade_to_access_token
+
+
+REQUEST_TOKEN = 1
+AUTHORIZED_REQUEST_TOKEN = 2
+ACCESS_TOKEN = 3
+
+
+class OAuthHmacToken(object):
+ SIGNATURE_METHOD = HMAC_SHA1
+
+ def __init__(self, consumer_key, consumer_secret, token, token_secret,
+ auth_state, next=None, verifier=None):
+ self.consumer_key = consumer_key
+ self.consumer_secret = consumer_secret
+ self.token = token
+ self.token_secret = token_secret
+ self.auth_state = auth_state
+ self.next = next
+ self.verifier = verifier # Used to convert request token to access token.
+
+ def generate_authorization_url(
+ self, google_apps_domain=DEFAULT_DOMAIN, language=None, btmpl=None,
+ auth_server=OAUTH_AUTHORIZE_URL):
+ """Creates the URL at which the user can authorize this app to access.
+
+ Args:
+ google_apps_domain: str (optional) If the user should be signing in
+ using an account under a known Google Apps domain, provide the
+ domain name ('example.com') here. If not provided, 'default'
+ will be used, and the user will be prompted to select an account
+ if they are signed in with a Google Account and Google Apps
+ accounts.
+ language: str (optional) An ISO 639 country code identifying what
+ language the approval page should be translated in (for example,
+ 'en' for English). The default is the user's selected language.
+ btmpl: str (optional) Forces a mobile version of the approval page. The
+ only accepted value is 'mobile'.
+ auth_server: str (optional) The start of the token authorization web
+ page. Defaults to
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'
+ """
+ return generate_oauth_authorization_url(
+ self.token, hd=google_apps_domain, hl=language, btmpl=btmpl,
+ auth_server=auth_server)
+
+ GenerateAuthorizationUrl = generate_authorization_url
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header in the HTTP request using the token.
+
+ Calculates an HMAC signature using the information in the token to
+ indicate that the request came from this application and that this
+ application has permission to access a particular user's data.
+
+ Returns:
+ The same HTTP request object which was passed in.
+ """
+ timestamp = str(int(time.time()))
+ nonce = ''.join([str(random.randint(0, 9)) for i in xrange(15)])
+ signature = generate_hmac_signature(
+ http_request, self.consumer_key, self.consumer_secret, timestamp,
+ nonce, version='1.0', next=self.next, token=self.token,
+ token_secret=self.token_secret, verifier=self.verifier)
+ http_request.headers['Authorization'] = generate_auth_header(
+ self.consumer_key, timestamp, nonce, HMAC_SHA1, signature,
+ version='1.0', next=self.next, token=self.token,
+ verifier=self.verifier)
+ return http_request
+
+ ModifyRequest = modify_request
+
+
+class OAuthRsaToken(OAuthHmacToken):
+ SIGNATURE_METHOD = RSA_SHA1
+
+ def __init__(self, consumer_key, rsa_private_key, token, token_secret,
+ auth_state, next=None, verifier=None):
+ self.consumer_key = consumer_key
+ self.rsa_private_key = rsa_private_key
+ self.token = token
+ self.token_secret = token_secret
+ self.auth_state = auth_state
+ self.next = next
+ self.verifier = verifier # Used to convert request token to access token.
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header in the HTTP request using the token.
+
+ Calculates an RSA signature using the information in the token to
+ indicate that the request came from this application and that this
+ application has permission to access a particular user's data.
+
+ Returns:
+ The same HTTP request object which was passed in.
+ """
+ timestamp = str(int(time.time()))
+ nonce = ''.join([str(random.randint(0, 9)) for i in xrange(15)])
+ signature = generate_rsa_signature(
+ http_request, self.consumer_key, self.rsa_private_key, timestamp,
+ nonce, version='1.0', next=self.next, token=self.token,
+ token_secret=self.token_secret, verifier=self.verifier)
+ http_request.headers['Authorization'] = generate_auth_header(
+ self.consumer_key, timestamp, nonce, RSA_SHA1, signature,
+ version='1.0', next=self.next, token=self.token,
+ verifier=self.verifier)
+ return http_request
+
+ ModifyRequest = modify_request
+
+
+class TwoLeggedOAuthHmacToken(OAuthHmacToken):
+
+ def __init__(self, consumer_key, consumer_secret, requestor_id):
+ self.requestor_id = requestor_id
+ OAuthHmacToken.__init__(
+ self, consumer_key, consumer_secret, None, None, ACCESS_TOKEN,
+ next=None, verifier=None)
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header in the HTTP request using the token.
+
+ Calculates an HMAC signature using the information in the token to
+ indicate that the request came from this application and that this
+ application has permission to access a particular user's data using 2LO.
+
+ Returns:
+ The same HTTP request object which was passed in.
+ """
+ http_request.uri.query['xoauth_requestor_id'] = self.requestor_id
+ return OAuthHmacToken.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
+
+
+class TwoLeggedOAuthRsaToken(OAuthRsaToken):
+
+ def __init__(self, consumer_key, rsa_private_key, requestor_id):
+ self.requestor_id = requestor_id
+ OAuthRsaToken.__init__(
+ self, consumer_key, rsa_private_key, None, None, ACCESS_TOKEN,
+ next=None, verifier=None)
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header in the HTTP request using the token.
+
+ Calculates an RSA signature using the information in the token to
+ indicate that the request came from this application and that this
+ application has permission to access a particular user's data using 2LO.
+
+ Returns:
+ The same HTTP request object which was passed in.
+ """
+ http_request.uri.query['xoauth_requestor_id'] = self.requestor_id
+ return OAuthRsaToken.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
+
+
+class OAuth2Token(object):
+ """Token object for OAuth 2.0 as described on
+ <http://code.google.com/apis/accounts/docs/OAuth2.html>.
+
+ Token can be applied to a gdata.client.GDClient object using the authorize()
+ method, which then signs each request from that object with the OAuth 2.0
+ access token.
+ This class supports 3 flows of OAuth 2.0:
+ Client-side web flow: call generate_authorize_url with `response_type='token''
+ and the registered `redirect_uri'.
+ Server-side web flow: call generate_authorize_url with the registered
+ `redirect_url'.
+ Native applications flow: call generate_authorize_url as it is. You will have
+ to ask the user to go to the generated url and pass in the authorization
+ code to your application.
+ """
+
+ def __init__(self, client_id, client_secret, scope, user_agent,
+ auth_uri='https://accounts.google.com/o/oauth2/auth',
+ token_uri='https://accounts.google.com/o/oauth2/token',
+ access_token=None, refresh_token=None):
+ """Create an instance of OAuth2Token
+
+ This constructor is not usually called by the user, instead
+ OAuth2Credentials objects are instantiated by the OAuth2WebServerFlow.
+
+ Args:
+ client_id: string, client identifier.
+ client_secret: string client secret.
+ scope: string, scope of the credentials being requested.
+ user_agent: string, HTTP User-Agent to provide for this application.
+ auth_uri: string, URI for authorization endpoint. For convenience
+ defaults to Google's endpoints but any OAuth 2.0 provider can be used.
+ token_uri: string, URI for token endpoint. For convenience
+ defaults to Google's endpoints but any OAuth 2.0 provider can be used.
+ access_token: string, access token.
+ refresh_token: string, refresh token.
+ """
+ self.client_id = client_id
+ self.client_secret = client_secret
+ self.scope = scope
+ self.user_agent = user_agent
+ self.auth_uri = auth_uri
+ self.token_uri = token_uri
+ self.access_token = access_token
+ self.refresh_token = refresh_token
+
+ # True if the credentials have been revoked or expired and can't be
+ # refreshed.
+ self._invalid = False
+
+ @property
+ def invalid(self):
+ """True if the credentials are invalid, such as being revoked."""
+ return getattr(self, '_invalid', False)
+
+ def _refresh(self, request):
+ """Refresh the access_token using the refresh_token.
+
+ Args:
+ http: An instance of httplib2.Http.request
+ or something that acts like it.
+ """
+ body = urllib.urlencode({
+ 'grant_type': 'refresh_token',
+ 'client_id': self.client_id,
+ 'client_secret': self.client_secret,
+ 'refresh_token' : self.refresh_token
+ })
+ headers = {
+ 'user-agent': self.user_agent,
+ }
+
+ http_request = atom.http_core.HttpRequest(uri=self.token_uri, method='POST', headers=headers)
+ http_request.add_body_part(body, mime_type='application/x-www-form-urlencoded')
+ response = request(http_request)
+ body = response.read()
+ if response.status == 200:
+ self._extract_tokens(body)
+ else:
+ self._invalid = True
+ return response
+
+ def _extract_tokens(self, body):
+ d = simplejson.loads(body)
+ self.access_token = d['access_token']
+ self.refresh_token = d.get('refresh_token', self.refresh_token)
+ if 'expires_in' in d:
+ self.token_expiry = datetime.timedelta(
+ seconds = int(d['expires_in'])) + datetime.datetime.now()
+ else:
+ self.token_expiry = None
+
+ def generate_authorize_url(self, redirect_uri='oob', response_type='code', **kwargs):
+ """Returns a URI to redirect to the provider.
+
+ Args:
+ redirect_uri: string, Either the string 'oob' for a non-web-based
+ application, or a URI that handles the callback from
+ the authorization server.
+ response_type: string, Either the string 'code' for server-side or
+ native application, or the string 'token' for client-
+ side application.
+
+ If redirect_uri is 'oob' then pass in the
+ generated verification code to get_access_token,
+ otherwise pass in the query parameters received
+ at the callback uri to get_access_token.
+ If the response_type is 'token', no need to call
+ get_access_token as the API will return it within
+ the query parameters received at the callback:
+ oauth2_token.access_token = YOUR_ACCESS_TOKEN
+ """
+ self.redirect_uri = redirect_uri
+ query = {
+ 'response_type': response_type,
+ 'client_id': self.client_id,
+ 'redirect_uri': redirect_uri,
+ 'scope': self.scope,
+ }
+ query.update(kwargs)
+ parts = list(urlparse.urlparse(self.auth_uri))
+ query.update(dict(parse_qsl(parts[4]))) # 4 is the index of the query part
+ parts[4] = urllib.urlencode(query)
+ return urlparse.urlunparse(parts)
+
+ def get_access_token(self, code):
+ """Exhanges a code for an access token.
+
+ Args:
+ code: string or dict, either the code as a string, or a dictionary
+ of the query parameters to the redirect_uri, which contains
+ the code.
+ """
+
+ if not (isinstance(code, str) or isinstance(code, unicode)):
+ code = code['code']
+
+ body = urllib.urlencode({
+ 'grant_type': 'authorization_code',
+ 'client_id': self.client_id,
+ 'client_secret': self.client_secret,
+ 'code': code,
+ 'redirect_uri': self.redirect_uri,
+ 'scope': self.scope
+ })
+ headers = {
+ 'user-agent': self.user_agent,
+ }
+ http_client = atom.http_core.HttpClient()
+ http_request = atom.http_core.HttpRequest(uri=self.token_uri, method='POST',
+ headers=headers)
+ http_request.add_body_part(data=body, mime_type='application/x-www-form-urlencoded')
+ response = http_client.request(http_request)
+ body = response.read()
+ if response.status == 200:
+ self._extract_tokens(body)
+ return self
+ else:
+ error_msg = 'Invalid response %s.' % response.status
+ try:
+ d = simplejson.loads(body)
+ if 'error' in d:
+ error_msg = d['error']
+ except:
+ pass
+ raise OAuth2AccessTokenError(error_msg)
+
+ def authorize(self, client):
+ """Authorize a gdata.client.GDClient instance with these credentials.
+
+ Args:
+ client: An instance of gdata.client.GDClient
+ or something that acts like it.
+
+ Returns:
+ A modified instance of client that was passed in.
+
+ Example:
+
+ c = gdata.client.GDClient(source='user-agent')
+ c = token.authorize(c)
+ """
+ client.auth_token = self
+ request_orig = client.http_client.request
+
+ def new_request(http_request):
+ response = request_orig(http_request)
+ if response.status == 401:
+ refresh_response = self._refresh(request_orig)
+ if self._invalid:
+ return refresh_response
+ else:
+ self.modify_request(http_request)
+ return request_orig(http_request)
+ else:
+ return response
+
+ client.http_client.request = new_request
+ return client
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header in the HTTP request using the token.
+
+ Returns:
+ The same HTTP request object which was passed in.
+ """
+ http_request.headers['Authorization'] = '%s%s' % (OAUTH2_AUTH_LABEL, self.access_token)
+ return http_request
+
+ ModifyRequest = modify_request
+
+
+def _join_token_parts(*args):
+ """"Escapes and combines all strings passed in.
+
+ Used to convert a token object's members into a string instead of
+ using pickle.
+
+ Note: A None value will be converted to an empty string.
+
+ Returns:
+ A string in the form 1x|member1|member2|member3...
+ """
+ return '|'.join([urllib.quote_plus(a or '') for a in args])
+
+
+def _split_token_parts(blob):
+ """Extracts and unescapes fields from the provided binary string.
+
+ Reverses the packing performed by _join_token_parts. Used to extract
+ the members of a token object.
+
+ Note: An empty string from the blob will be interpreted as None.
+
+ Args:
+ blob: str A string of the form 1x|member1|member2|member3 as created
+ by _join_token_parts
+
+ Returns:
+ A list of unescaped strings.
+ """
+ return [urllib.unquote_plus(part) or None for part in blob.split('|')]
+
+
+def token_to_blob(token):
+ """Serializes the token data as a string for storage in a datastore.
+
+ Supported token classes: ClientLoginToken, AuthSubToken, SecureAuthSubToken,
+ OAuthRsaToken, and OAuthHmacToken, TwoLeggedOAuthRsaToken,
+ TwoLeggedOAuthHmacToken and OAuth2Token.
+
+ Args:
+ token: A token object which must be of one of the supported token classes.
+
+ Raises:
+ UnsupportedTokenType if the token is not one of the supported token
+ classes listed above.
+
+ Returns:
+ A string represenging this token. The string can be converted back into
+ an equivalent token object using token_from_blob. Note that any members
+ which are set to '' will be set to None when the token is deserialized
+ by token_from_blob.
+ """
+ if isinstance(token, ClientLoginToken):
+ return _join_token_parts('1c', token.token_string)
+ # Check for secure auth sub type first since it is a subclass of
+ # AuthSubToken.
+ elif isinstance(token, SecureAuthSubToken):
+ return _join_token_parts('1s', token.token_string, token.rsa_private_key,
+ *token.scopes)
+ elif isinstance(token, AuthSubToken):
+ return _join_token_parts('1a', token.token_string, *token.scopes)
+ elif isinstance(token, TwoLeggedOAuthRsaToken):
+ return _join_token_parts(
+ '1rtl', token.consumer_key, token.rsa_private_key, token.requestor_id)
+ elif isinstance(token, TwoLeggedOAuthHmacToken):
+ return _join_token_parts(
+ '1htl', token.consumer_key, token.consumer_secret, token.requestor_id)
+ # Check RSA OAuth token first since the OAuthRsaToken is a subclass of
+ # OAuthHmacToken.
+ elif isinstance(token, OAuthRsaToken):
+ return _join_token_parts(
+ '1r', token.consumer_key, token.rsa_private_key, token.token,
+ token.token_secret, str(token.auth_state), token.next,
+ token.verifier)
+ elif isinstance(token, OAuthHmacToken):
+ return _join_token_parts(
+ '1h', token.consumer_key, token.consumer_secret, token.token,
+ token.token_secret, str(token.auth_state), token.next,
+ token.verifier)
+ elif isinstance(token, OAuth2Token):
+ return _join_token_parts(
+ '2o', token.client_id, token.client_secret, token.scope,
+ token.user_agent, token.auth_uri, token.token_uri,
+ token.access_token, token.refresh_token)
+ else:
+ raise UnsupportedTokenType(
+ 'Unable to serialize token of type %s' % type(token))
+
+
+TokenToBlob = token_to_blob
+
+
+def token_from_blob(blob):
+ """Deserializes a token string from the datastore back into a token object.
+
+ Supported token classes: ClientLoginToken, AuthSubToken, SecureAuthSubToken,
+ OAuthRsaToken, and OAuthHmacToken, TwoLeggedOAuthRsaToken,
+ TwoLeggedOAuthHmacToken and OAuth2Token.
+
+ Args:
+ blob: string created by token_to_blob.
+
+ Raises:
+ UnsupportedTokenType if the token is not one of the supported token
+ classes listed above.
+
+ Returns:
+ A new token object with members set to the values serialized in the
+ blob string. Note that any members which were set to '' in the original
+ token will now be None.
+ """
+ parts = _split_token_parts(blob)
+ if parts[0] == '1c':
+ return ClientLoginToken(parts[1])
+ elif parts[0] == '1a':
+ return AuthSubToken(parts[1], parts[2:])
+ elif parts[0] == '1s':
+ return SecureAuthSubToken(parts[1], parts[2], parts[3:])
+ elif parts[0] == '1rtl':
+ return TwoLeggedOAuthRsaToken(parts[1], parts[2], parts[3])
+ elif parts[0] == '1htl':
+ return TwoLeggedOAuthHmacToken(parts[1], parts[2], parts[3])
+ elif parts[0] == '1r':
+ auth_state = int(parts[5])
+ return OAuthRsaToken(parts[1], parts[2], parts[3], parts[4], auth_state,
+ parts[6], parts[7])
+ elif parts[0] == '1h':
+ auth_state = int(parts[5])
+ return OAuthHmacToken(parts[1], parts[2], parts[3], parts[4], auth_state,
+ parts[6], parts[7])
+ elif parts[0] == '2o':
+ return OAuth2Token(parts[1], parts[2], parts[3], parts[4], parts[5],
+ parts[6], parts[7], parts[8])
+ else:
+ raise UnsupportedTokenType(
+ 'Unable to deserialize token with type marker of %s' % parts[0])
+
+
+TokenFromBlob = token_from_blob
+
+
+def dump_tokens(tokens):
+ return ','.join([token_to_blob(t) for t in tokens])
+
+
+def load_tokens(blob):
+ return [token_from_blob(s) for s in blob.split(',')]
+
+
+def find_scopes_for_services(service_names=None):
+ """Creates a combined list of scope URLs for the desired services.
+
+ This method searches the AUTH_SCOPES dictionary.
+
+ Args:
+ service_names: list of strings (optional) Each name must be a key in the
+ AUTH_SCOPES dictionary. If no list is provided (None) then
+ the resulting list will contain all scope URLs in the
+ AUTH_SCOPES dict.
+
+ Returns:
+ A list of URL strings which are the scopes needed to access these services
+ when requesting a token using AuthSub or OAuth.
+ """
+ result_scopes = []
+ if service_names is None:
+ for service_name, scopes in AUTH_SCOPES.iteritems():
+ result_scopes.extend(scopes)
+ else:
+ for service_name in service_names:
+ result_scopes.extend(AUTH_SCOPES[service_name])
+ return result_scopes
+
+
+FindScopesForServices = find_scopes_for_services
+
+
+def ae_save(token, token_key):
+ """Stores an auth token in the App Engine datastore.
+
+ This is a convenience method for using the library with App Engine.
+ Recommended usage is to associate the auth token with the current_user.
+ If a user is signed in to the app using the App Engine users API, you
+ can use
+ gdata.gauth.ae_save(some_token, users.get_current_user().user_id())
+ If you are not using the Users API you are free to choose whatever
+ string you would like for a token_string.
+
+ Args:
+ token: an auth token object. Must be one of ClientLoginToken,
+ AuthSubToken, SecureAuthSubToken, OAuthRsaToken, or OAuthHmacToken
+ (see token_to_blob).
+ token_key: str A unique identified to be used when you want to retrieve
+ the token. If the user is signed in to App Engine using the
+ users API, I recommend using the user ID for the token_key:
+ users.get_current_user().user_id()
+ """
+ import gdata.alt.app_engine
+ key_name = ''.join(('gd_auth_token', token_key))
+ return gdata.alt.app_engine.set_token(key_name, token_to_blob(token))
+
+
+AeSave = ae_save
+
+
+def ae_load(token_key):
+ """Retrieves a token object from the App Engine datastore.
+
+ This is a convenience method for using the library with App Engine.
+ See also ae_save.
+
+ Args:
+ token_key: str The unique key associated with the desired token when it
+ was saved using ae_save.
+
+ Returns:
+ A token object if there was a token associated with the token_key or None
+ if the key could not be found.
+ """
+ import gdata.alt.app_engine
+ key_name = ''.join(('gd_auth_token', token_key))
+ token_string = gdata.alt.app_engine.get_token(key_name)
+ if token_string is not None:
+ return token_from_blob(token_string)
+ else:
+ return None
+
+
+AeLoad = ae_load
+
+
+def ae_delete(token_key):
+ """Removes the token object from the App Engine datastore."""
+ import gdata.alt.app_engine
+ key_name = ''.join(('gd_auth_token', token_key))
+ gdata.alt.app_engine.delete_token(key_name)
+
+
+AeDelete = ae_delete
diff --git a/samples/apps/marketplace_sample/gdata/oauth/CHANGES.txt b/samples/apps/marketplace_sample/gdata/oauth/CHANGES.txt
new file mode 100755
index 0000000..7c2b92c
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/oauth/CHANGES.txt
@@ -0,0 +1,17 @@
+1. Moved oauth.py to __init__.py
+
+2. Refactored __init__.py for compatibility with python 2.2 (Issue 59)
+
+3. Refactored rsa.py for compatibility with python 2.2 (Issue 59)
+
+4. Refactored OAuthRequest.from_token_and_callback since the callback url was
+getting double url-encoding the callback url in place of single. (Issue 43)
+
+5. Added build_signature_base_string method to rsa.py since it used the
+implementation of this method from oauth.OAuthSignatureMethod_HMAC_SHA1 which
+was incorrect since it enforced the presence of a consumer secret and a token
+secret. Also, changed its super class from oauth.OAuthSignatureMethod_HMAC_SHA1
+to oauth.OAuthSignatureMethod (Issue 64)
+
+6. Refactored <OAuthRequest>.to_header method since it returned non-oauth params
+as well which was incorrect. (Issue 31)
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/oauth/__init__.py b/samples/apps/marketplace_sample/gdata/oauth/__init__.py
new file mode 100755
index 0000000..44d9c7a
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/oauth/__init__.py
@@ -0,0 +1,529 @@
+import cgi
+import urllib
+import time
+import random
+import urlparse
+import hmac
+import binascii
+
+VERSION = '1.0' # Hi Blaine!
+HTTP_METHOD = 'GET'
+SIGNATURE_METHOD = 'PLAINTEXT'
+
+# Generic exception class
+class OAuthError(RuntimeError):
+ def __init__(self, message='OAuth error occured.'):
+ self.message = message
+
+# optional WWW-Authenticate header (401 error)
+def build_authenticate_header(realm=''):
+ return {'WWW-Authenticate': 'OAuth realm="%s"' % realm}
+
+# url escape
+def escape(s):
+ # escape '/' too
+ return urllib.quote(s, safe='~')
+
+# util function: current timestamp
+# seconds since epoch (UTC)
+def generate_timestamp():
+ return int(time.time())
+
+# util function: nonce
+# pseudorandom number
+def generate_nonce(length=8):
+ return ''.join([str(random.randint(0, 9)) for i in range(length)])
+
+# OAuthConsumer is a data type that represents the identity of the Consumer
+# via its shared secret with the Service Provider.
+class OAuthConsumer(object):
+ key = None
+ secret = None
+
+ def __init__(self, key, secret):
+ self.key = key
+ self.secret = secret
+
+# OAuthToken is a data type that represents an End User via either an access
+# or request token.
+class OAuthToken(object):
+ # access tokens and request tokens
+ key = None
+ secret = None
+
+ '''
+ key = the token
+ secret = the token secret
+ '''
+ def __init__(self, key, secret):
+ self.key = key
+ self.secret = secret
+
+ def to_string(self):
+ return urllib.urlencode({'oauth_token': self.key, 'oauth_token_secret': self.secret})
+
+ # return a token from something like:
+ # oauth_token_secret=digg&oauth_token=digg
+ def from_string(s):
+ params = cgi.parse_qs(s, keep_blank_values=False)
+ key = params['oauth_token'][0]
+ secret = params['oauth_token_secret'][0]
+ return OAuthToken(key, secret)
+ from_string = staticmethod(from_string)
+
+ def __str__(self):
+ return self.to_string()
+
+# OAuthRequest represents the request and can be serialized
+class OAuthRequest(object):
+ '''
+ OAuth parameters:
+ - oauth_consumer_key
+ - oauth_token
+ - oauth_signature_method
+ - oauth_signature
+ - oauth_timestamp
+ - oauth_nonce
+ - oauth_version
+ ... any additional parameters, as defined by the Service Provider.
+ '''
+ parameters = None # oauth parameters
+ http_method = HTTP_METHOD
+ http_url = None
+ version = VERSION
+
+ def __init__(self, http_method=HTTP_METHOD, http_url=None, parameters=None):
+ self.http_method = http_method
+ self.http_url = http_url
+ self.parameters = parameters or {}
+
+ def set_parameter(self, parameter, value):
+ self.parameters[parameter] = value
+
+ def get_parameter(self, parameter):
+ try:
+ return self.parameters[parameter]
+ except:
+ raise OAuthError('Parameter not found: %s' % parameter)
+
+ def _get_timestamp_nonce(self):
+ return self.get_parameter('oauth_timestamp'), self.get_parameter('oauth_nonce')
+
+ # get any non-oauth parameters
+ def get_nonoauth_parameters(self):
+ parameters = {}
+ for k, v in self.parameters.iteritems():
+ # ignore oauth parameters
+ if k.find('oauth_') < 0:
+ parameters[k] = v
+ return parameters
+
+ # serialize as a header for an HTTPAuth request
+ def to_header(self, realm=''):
+ auth_header = 'OAuth realm="%s"' % realm
+ # add the oauth parameters
+ if self.parameters:
+ for k, v in self.parameters.iteritems():
+ if k[:6] == 'oauth_':
+ auth_header += ', %s="%s"' % (k, escape(str(v)))
+ return {'Authorization': auth_header}
+
+ # serialize as post data for a POST request
+ def to_postdata(self):
+ return '&'.join(['%s=%s' % (escape(str(k)), escape(str(v))) for k, v in self.parameters.iteritems()])
+
+ # serialize as a url for a GET request
+ def to_url(self):
+ return '%s?%s' % (self.get_normalized_http_url(), self.to_postdata())
+
+ # return a string that consists of all the parameters that need to be signed
+ def get_normalized_parameters(self):
+ params = self.parameters
+ try:
+ # exclude the signature if it exists
+ del params['oauth_signature']
+ except:
+ pass
+ key_values = params.items()
+ # sort lexicographically, first after key, then after value
+ key_values.sort()
+ # combine key value pairs in string and escape
+ return '&'.join(['%s=%s' % (escape(str(k)), escape(str(v))) for k, v in key_values])
+
+ # just uppercases the http method
+ def get_normalized_http_method(self):
+ return self.http_method.upper()
+
+ # parses the url and rebuilds it to be scheme://host/path
+ def get_normalized_http_url(self):
+ parts = urlparse.urlparse(self.http_url)
+ host = parts[1].lower()
+ if host.endswith(':80') or host.endswith(':443'):
+ host = host.split(':')[0]
+ url_string = '%s://%s%s' % (parts[0], host, parts[2]) # scheme, netloc, path
+ return url_string
+
+ # set the signature parameter to the result of build_signature
+ def sign_request(self, signature_method, consumer, token):
+ # set the signature method
+ self.set_parameter('oauth_signature_method', signature_method.get_name())
+ # set the signature
+ self.set_parameter('oauth_signature', self.build_signature(signature_method, consumer, token))
+
+ def build_signature(self, signature_method, consumer, token):
+ # call the build signature method within the signature method
+ return signature_method.build_signature(self, consumer, token)
+
+ def from_request(http_method, http_url, headers=None, parameters=None, query_string=None):
+ # combine multiple parameter sources
+ if parameters is None:
+ parameters = {}
+
+ # headers
+ if headers and 'Authorization' in headers:
+ auth_header = headers['Authorization']
+ # check that the authorization header is OAuth
+ if auth_header.index('OAuth') > -1:
+ try:
+ # get the parameters from the header
+ header_params = OAuthRequest._split_header(auth_header)
+ parameters.update(header_params)
+ except:
+ raise OAuthError('Unable to parse OAuth parameters from Authorization header.')
+
+ # GET or POST query string
+ if query_string:
+ query_params = OAuthRequest._split_url_string(query_string)
+ parameters.update(query_params)
+
+ # URL parameters
+ param_str = urlparse.urlparse(http_url)[4] # query
+ url_params = OAuthRequest._split_url_string(param_str)
+ parameters.update(url_params)
+
+ if parameters:
+ return OAuthRequest(http_method, http_url, parameters)
+
+ return None
+ from_request = staticmethod(from_request)
+
+ def from_consumer_and_token(oauth_consumer, token=None, http_method=HTTP_METHOD, http_url=None, parameters=None):
+ if not parameters:
+ parameters = {}
+
+ defaults = {
+ 'oauth_consumer_key': oauth_consumer.key,
+ 'oauth_timestamp': generate_timestamp(),
+ 'oauth_nonce': generate_nonce(),
+ 'oauth_version': OAuthRequest.version,
+ }
+
+ defaults.update(parameters)
+ parameters = defaults
+
+ if token:
+ parameters['oauth_token'] = token.key
+
+ return OAuthRequest(http_method, http_url, parameters)
+ from_consumer_and_token = staticmethod(from_consumer_and_token)
+
+ def from_token_and_callback(token, callback=None, http_method=HTTP_METHOD, http_url=None, parameters=None):
+ if not parameters:
+ parameters = {}
+
+ parameters['oauth_token'] = token.key
+
+ if callback:
+ parameters['oauth_callback'] = callback
+
+ return OAuthRequest(http_method, http_url, parameters)
+ from_token_and_callback = staticmethod(from_token_and_callback)
+
+ # util function: turn Authorization: header into parameters, has to do some unescaping
+ def _split_header(header):
+ params = {}
+ parts = header[6:].split(',')
+ for param in parts:
+ # ignore realm parameter
+ if param.find('realm') > -1:
+ continue
+ # remove whitespace
+ param = param.strip()
+ # split key-value
+ param_parts = param.split('=', 1)
+ # remove quotes and unescape the value
+ params[param_parts[0]] = urllib.unquote(param_parts[1].strip('\"'))
+ return params
+ _split_header = staticmethod(_split_header)
+
+ # util function: turn url string into parameters, has to do some unescaping
+ # even empty values should be included
+ def _split_url_string(param_str):
+ parameters = cgi.parse_qs(param_str, keep_blank_values=True)
+ for k, v in parameters.iteritems():
+ parameters[k] = urllib.unquote(v[0])
+ return parameters
+ _split_url_string = staticmethod(_split_url_string)
+
+# OAuthServer is a worker to check a requests validity against a data store
+class OAuthServer(object):
+ timestamp_threshold = 300 # in seconds, five minutes
+ version = VERSION
+ signature_methods = None
+ data_store = None
+
+ def __init__(self, data_store=None, signature_methods=None):
+ self.data_store = data_store
+ self.signature_methods = signature_methods or {}
+
+ def set_data_store(self, oauth_data_store):
+ self.data_store = oauth_data_store
+
+ def get_data_store(self):
+ return self.data_store
+
+ def add_signature_method(self, signature_method):
+ self.signature_methods[signature_method.get_name()] = signature_method
+ return self.signature_methods
+
+ # process a request_token request
+ # returns the request token on success
+ def fetch_request_token(self, oauth_request):
+ try:
+ # get the request token for authorization
+ token = self._get_token(oauth_request, 'request')
+ except OAuthError:
+ # no token required for the initial token request
+ version = self._get_version(oauth_request)
+ consumer = self._get_consumer(oauth_request)
+ self._check_signature(oauth_request, consumer, None)
+ # fetch a new token
+ token = self.data_store.fetch_request_token(consumer)
+ return token
+
+ # process an access_token request
+ # returns the access token on success
+ def fetch_access_token(self, oauth_request):
+ version = self._get_version(oauth_request)
+ consumer = self._get_consumer(oauth_request)
+ # get the request token
+ token = self._get_token(oauth_request, 'request')
+ self._check_signature(oauth_request, consumer, token)
+ new_token = self.data_store.fetch_access_token(consumer, token)
+ return new_token
+
+ # verify an api call, checks all the parameters
+ def verify_request(self, oauth_request):
+ # -> consumer and token
+ version = self._get_version(oauth_request)
+ consumer = self._get_consumer(oauth_request)
+ # get the access token
+ token = self._get_token(oauth_request, 'access')
+ self._check_signature(oauth_request, consumer, token)
+ parameters = oauth_request.get_nonoauth_parameters()
+ return consumer, token, parameters
+
+ # authorize a request token
+ def authorize_token(self, token, user):
+ return self.data_store.authorize_request_token(token, user)
+
+ # get the callback url
+ def get_callback(self, oauth_request):
+ return oauth_request.get_parameter('oauth_callback')
+
+ # optional support for the authenticate header
+ def build_authenticate_header(self, realm=''):
+ return {'WWW-Authenticate': 'OAuth realm="%s"' % realm}
+
+ # verify the correct version request for this server
+ def _get_version(self, oauth_request):
+ try:
+ version = oauth_request.get_parameter('oauth_version')
+ except:
+ version = VERSION
+ if version and version != self.version:
+ raise OAuthError('OAuth version %s not supported.' % str(version))
+ return version
+
+ # figure out the signature with some defaults
+ def _get_signature_method(self, oauth_request):
+ try:
+ signature_method = oauth_request.get_parameter('oauth_signature_method')
+ except:
+ signature_method = SIGNATURE_METHOD
+ try:
+ # get the signature method object
+ signature_method = self.signature_methods[signature_method]
+ except:
+ signature_method_names = ', '.join(self.signature_methods.keys())
+ raise OAuthError('Signature method %s not supported try one of the following: %s' % (signature_method, signature_method_names))
+
+ return signature_method
+
+ def _get_consumer(self, oauth_request):
+ consumer_key = oauth_request.get_parameter('oauth_consumer_key')
+ if not consumer_key:
+ raise OAuthError('Invalid consumer key.')
+ consumer = self.data_store.lookup_consumer(consumer_key)
+ if not consumer:
+ raise OAuthError('Invalid consumer.')
+ return consumer
+
+ # try to find the token for the provided request token key
+ def _get_token(self, oauth_request, token_type='access'):
+ token_field = oauth_request.get_parameter('oauth_token')
+ consumer = self._get_consumer(oauth_request)
+ token = self.data_store.lookup_token(consumer, token_type, token_field)
+ if not token:
+ raise OAuthError('Invalid %s token: %s' % (token_type, token_field))
+ return token
+
+ def _check_signature(self, oauth_request, consumer, token):
+ timestamp, nonce = oauth_request._get_timestamp_nonce()
+ self._check_timestamp(timestamp)
+ self._check_nonce(consumer, token, nonce)
+ signature_method = self._get_signature_method(oauth_request)
+ try:
+ signature = oauth_request.get_parameter('oauth_signature')
+ except:
+ raise OAuthError('Missing signature.')
+ # validate the signature
+ valid_sig = signature_method.check_signature(oauth_request, consumer, token, signature)
+ if not valid_sig:
+ key, base = signature_method.build_signature_base_string(oauth_request, consumer, token)
+ raise OAuthError('Invalid signature. Expected signature base string: %s' % base)
+ built = signature_method.build_signature(oauth_request, consumer, token)
+
+ def _check_timestamp(self, timestamp):
+ # verify that timestamp is recentish
+ timestamp = int(timestamp)
+ now = int(time.time())
+ lapsed = now - timestamp
+ if lapsed > self.timestamp_threshold:
+ raise OAuthError('Expired timestamp: given %d and now %s has a greater difference than threshold %d' % (timestamp, now, self.timestamp_threshold))
+
+ def _check_nonce(self, consumer, token, nonce):
+ # verify that the nonce is uniqueish
+ nonce = self.data_store.lookup_nonce(consumer, token, nonce)
+ if nonce:
+ raise OAuthError('Nonce already used: %s' % str(nonce))
+
+# OAuthClient is a worker to attempt to execute a request
+class OAuthClient(object):
+ consumer = None
+ token = None
+
+ def __init__(self, oauth_consumer, oauth_token):
+ self.consumer = oauth_consumer
+ self.token = oauth_token
+
+ def get_consumer(self):
+ return self.consumer
+
+ def get_token(self):
+ return self.token
+
+ def fetch_request_token(self, oauth_request):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def fetch_access_token(self, oauth_request):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def access_resource(self, oauth_request):
+ # -> some protected resource
+ raise NotImplementedError
+
+# OAuthDataStore is a database abstraction used to lookup consumers and tokens
+class OAuthDataStore(object):
+
+ def lookup_consumer(self, key):
+ # -> OAuthConsumer
+ raise NotImplementedError
+
+ def lookup_token(self, oauth_consumer, token_type, token_token):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def lookup_nonce(self, oauth_consumer, oauth_token, nonce, timestamp):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def fetch_request_token(self, oauth_consumer):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def fetch_access_token(self, oauth_consumer, oauth_token):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def authorize_request_token(self, oauth_token, user):
+ # -> OAuthToken
+ raise NotImplementedError
+
+# OAuthSignatureMethod is a strategy class that implements a signature method
+class OAuthSignatureMethod(object):
+ def get_name(self):
+ # -> str
+ raise NotImplementedError
+
+ def build_signature_base_string(self, oauth_request, oauth_consumer, oauth_token):
+ # -> str key, str raw
+ raise NotImplementedError
+
+ def build_signature(self, oauth_request, oauth_consumer, oauth_token):
+ # -> str
+ raise NotImplementedError
+
+ def check_signature(self, oauth_request, consumer, token, signature):
+ built = self.build_signature(oauth_request, consumer, token)
+ return built == signature
+
+class OAuthSignatureMethod_HMAC_SHA1(OAuthSignatureMethod):
+
+ def get_name(self):
+ return 'HMAC-SHA1'
+
+ def build_signature_base_string(self, oauth_request, consumer, token):
+ sig = (
+ escape(oauth_request.get_normalized_http_method()),
+ escape(oauth_request.get_normalized_http_url()),
+ escape(oauth_request.get_normalized_parameters()),
+ )
+
+ key = '%s&' % escape(consumer.secret)
+ if token:
+ key += escape(token.secret)
+ raw = '&'.join(sig)
+ return key, raw
+
+ def build_signature(self, oauth_request, consumer, token):
+ # build the base signature string
+ key, raw = self.build_signature_base_string(oauth_request, consumer, token)
+
+ # hmac object
+ try:
+ import hashlib # 2.5
+ hashed = hmac.new(key, raw, hashlib.sha1)
+ except:
+ import sha # deprecated
+ hashed = hmac.new(key, raw, sha)
+
+ # calculate the digest base 64
+ return binascii.b2a_base64(hashed.digest())[:-1]
+
+class OAuthSignatureMethod_PLAINTEXT(OAuthSignatureMethod):
+
+ def get_name(self):
+ return 'PLAINTEXT'
+
+ def build_signature_base_string(self, oauth_request, consumer, token):
+ # concatenate the consumer key and secret
+ sig = escape(consumer.secret) + '&'
+ if token:
+ sig = sig + escape(token.secret)
+ return sig
+
+ def build_signature(self, oauth_request, consumer, token):
+ return self.build_signature_base_string(oauth_request, consumer, token)
diff --git a/samples/apps/marketplace_sample/gdata/oauth/rsa.py b/samples/apps/marketplace_sample/gdata/oauth/rsa.py
new file mode 100755
index 0000000..733e2bb
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/oauth/rsa.py
@@ -0,0 +1,126 @@
+#!/usr/bin/python
+
+"""
+requires tlslite - http://trevp.net/tlslite/
+
+"""
+
+import binascii
+
+try:
+ from gdata.tlslite.utils import keyfactory
+except ImportError:
+ from tlslite.tlslite.utils import keyfactory
+try:
+ from gdata.tlslite.utils import cryptomath
+except ImportError:
+ from tlslite.tlslite.utils import cryptomath
+
+# XXX andy: ugly local import due to module name, oauth.oauth
+import gdata.oauth as oauth
+
+class OAuthSignatureMethod_RSA_SHA1(oauth.OAuthSignatureMethod):
+ def get_name(self):
+ return "RSA-SHA1"
+
+ def _fetch_public_cert(self, oauth_request):
+ # not implemented yet, ideas are:
+ # (1) do a lookup in a table of trusted certs keyed off of consumer
+ # (2) fetch via http using a url provided by the requester
+ # (3) some sort of specific discovery code based on request
+ #
+ # either way should return a string representation of the certificate
+ raise NotImplementedError
+
+ def _fetch_private_cert(self, oauth_request):
+ # not implemented yet, ideas are:
+ # (1) do a lookup in a table of trusted certs keyed off of consumer
+ #
+ # either way should return a string representation of the certificate
+ raise NotImplementedError
+
+ def build_signature_base_string(self, oauth_request, consumer, token):
+ sig = (
+ oauth.escape(oauth_request.get_normalized_http_method()),
+ oauth.escape(oauth_request.get_normalized_http_url()),
+ oauth.escape(oauth_request.get_normalized_parameters()),
+ )
+ key = ''
+ raw = '&'.join(sig)
+ return key, raw
+
+ def build_signature(self, oauth_request, consumer, token):
+ key, base_string = self.build_signature_base_string(oauth_request,
+ consumer,
+ token)
+
+ # Fetch the private key cert based on the request
+ cert = self._fetch_private_cert(oauth_request)
+
+ # Pull the private key from the certificate
+ privatekey = keyfactory.parsePrivateKey(cert)
+
+ # Convert base_string to bytes
+ #base_string_bytes = cryptomath.createByteArraySequence(base_string)
+
+ # Sign using the key
+ signed = privatekey.hashAndSign(base_string)
+
+ return binascii.b2a_base64(signed)[:-1]
+
+ def check_signature(self, oauth_request, consumer, token, signature):
+ decoded_sig = base64.b64decode(signature);
+
+ key, base_string = self.build_signature_base_string(oauth_request,
+ consumer,
+ token)
+
+ # Fetch the public key cert based on the request
+ cert = self._fetch_public_cert(oauth_request)
+
+ # Pull the public key from the certificate
+ publickey = keyfactory.parsePEMKey(cert, public=True)
+
+ # Check the signature
+ ok = publickey.hashAndVerify(decoded_sig, base_string)
+
+ return ok
+
+
+class TestOAuthSignatureMethod_RSA_SHA1(OAuthSignatureMethod_RSA_SHA1):
+ def _fetch_public_cert(self, oauth_request):
+ cert = """
+-----BEGIN CERTIFICATE-----
+MIIBpjCCAQ+gAwIBAgIBATANBgkqhkiG9w0BAQUFADAZMRcwFQYDVQQDDA5UZXN0
+IFByaW5jaXBhbDAeFw03MDAxMDEwODAwMDBaFw0zODEyMzEwODAwMDBaMBkxFzAV
+BgNVBAMMDlRlc3QgUHJpbmNpcGFsMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKB
+gQC0YjCwIfYoprq/FQO6lb3asXrxLlJFuCvtinTF5p0GxvQGu5O3gYytUvtC2JlY
+zypSRjVxwxrsuRcP3e641SdASwfrmzyvIgP08N4S0IFzEURkV1wp/IpH7kH41Etb
+mUmrXSwfNZsnQRE5SYSOhh+LcK2wyQkdgcMv11l4KoBkcwIDAQABMA0GCSqGSIb3
+DQEBBQUAA4GBAGZLPEuJ5SiJ2ryq+CmEGOXfvlTtEL2nuGtr9PewxkgnOjZpUy+d
+4TvuXJbNQc8f4AMWL/tO9w0Fk80rWKp9ea8/df4qMq5qlFWlx6yOLQxumNOmECKb
+WpkUQDIDJEoFUzKMVuJf4KO/FJ345+BNLGgbJ6WujreoM1X/gYfdnJ/J
+-----END CERTIFICATE-----
+"""
+ return cert
+
+ def _fetch_private_cert(self, oauth_request):
+ cert = """
+-----BEGIN PRIVATE KEY-----
+MIICdgIBADANBgkqhkiG9w0BAQEFAASCAmAwggJcAgEAAoGBALRiMLAh9iimur8V
+A7qVvdqxevEuUkW4K+2KdMXmnQbG9Aa7k7eBjK1S+0LYmVjPKlJGNXHDGuy5Fw/d
+7rjVJ0BLB+ubPK8iA/Tw3hLQgXMRRGRXXCn8ikfuQfjUS1uZSatdLB81mydBETlJ
+hI6GH4twrbDJCR2Bwy/XWXgqgGRzAgMBAAECgYBYWVtleUzavkbrPjy0T5FMou8H
+X9u2AC2ry8vD/l7cqedtwMPp9k7TubgNFo+NGvKsl2ynyprOZR1xjQ7WgrgVB+mm
+uScOM/5HVceFuGRDhYTCObE+y1kxRloNYXnx3ei1zbeYLPCHdhxRYW7T0qcynNmw
+rn05/KO2RLjgQNalsQJBANeA3Q4Nugqy4QBUCEC09SqylT2K9FrrItqL2QKc9v0Z
+zO2uwllCbg0dwpVuYPYXYvikNHHg+aCWF+VXsb9rpPsCQQDWR9TT4ORdzoj+Nccn
+qkMsDmzt0EfNaAOwHOmVJ2RVBspPcxt5iN4HI7HNeG6U5YsFBb+/GZbgfBT3kpNG
+WPTpAkBI+gFhjfJvRw38n3g/+UeAkwMI2TJQS4n8+hid0uus3/zOjDySH3XHCUno
+cn1xOJAyZODBo47E+67R4jV1/gzbAkEAklJaspRPXP877NssM5nAZMU0/O/NGCZ+
+3jPgDUno6WbJn5cqm8MqWhW1xGkImgRk+fkDBquiq4gPiT898jusgQJAd5Zrr6Q8
+AO/0isr/3aa6O6NLQxISLKcPDk2NOccAfS/xOtfOz4sJYM3+Bs4Io9+dZGSDCA54
+Lw03eHTNQghS0A==
+-----END PRIVATE KEY-----
+"""
+ return cert
diff --git a/samples/apps/marketplace_sample/gdata/sample_util.py b/samples/apps/marketplace_sample/gdata/sample_util.py
new file mode 100644
index 0000000..aae866e
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/sample_util.py
@@ -0,0 +1,269 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Provides utility functions used with command line samples."""
+
+# This module is used for version 2 of the Google Data APIs.
+
+import sys
+import getpass
+import urllib
+import gdata.gauth
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+CLIENT_LOGIN = 1
+AUTHSUB = 2
+OAUTH = 3
+
+HMAC = 1
+RSA = 2
+
+
+class SettingsUtil(object):
+ """Gather's user preferences from flags or command prompts.
+
+ An instance of this object stores the choices made by the user. At some
+ point it might be useful to save the user's preferences so that they do
+ not need to always set flags or answer preference prompts.
+ """
+
+ def __init__(self, prefs=None):
+ self.prefs = prefs or {}
+
+ def get_param(self, name, prompt='', secret=False, ask=True, reuse=False):
+ # First, check in this objects stored preferences.
+ if name in self.prefs:
+ return self.prefs[name]
+ # Second, check for a command line parameter.
+ value = None
+ for i in xrange(len(sys.argv)):
+ if sys.argv[i].startswith('--%s=' % name):
+ value = sys.argv[i].split('=')[1]
+ elif sys.argv[i] == '--%s' % name:
+ value = sys.argv[i + 1]
+ # Third, if it was not on the command line, ask the user to input the
+ # value.
+ if value is None and ask:
+ prompt = '%s: ' % prompt
+ if secret:
+ value = getpass.getpass(prompt)
+ else:
+ value = raw_input(prompt)
+ # If we want to save the preference for reuse in future requests, add it
+ # to this object's prefs.
+ if value is not None and reuse:
+ self.prefs[name] = value
+ return value
+
+ def authorize_client(self, client, auth_type=None, service=None,
+ source=None, scopes=None, oauth_type=None,
+ consumer_key=None, consumer_secret=None):
+ """Uses command line arguments, or prompts user for token values."""
+ if 'client_auth_token' in self.prefs:
+ return
+ if auth_type is None:
+ auth_type = int(self.get_param(
+ 'auth_type', 'Please choose the authorization mechanism you want'
+ ' to use.\n'
+ '1. to use your email address and password (ClientLogin)\n'
+ '2. to use a web browser to visit an auth web page (AuthSub)\n'
+ '3. if you have registed to use OAuth\n', reuse=True))
+
+ # Get the scopes for the services we want to access.
+ if auth_type == AUTHSUB or auth_type == OAUTH:
+ if scopes is None:
+ scopes = self.get_param(
+ 'scopes', 'Enter the URL prefixes (scopes) for the resources you '
+ 'would like to access.\nFor multiple scope URLs, place a comma '
+ 'between each URL.\n'
+ 'Example: http://www.google.com/calendar/feeds/,'
+ 'http://www.google.com/m8/feeds/\n', reuse=True).split(',')
+ elif isinstance(scopes, (str, unicode)):
+ scopes = scopes.split(',')
+
+ if auth_type == CLIENT_LOGIN:
+ email = self.get_param('email', 'Please enter your username',
+ reuse=False)
+ password = self.get_param('password', 'Password', True, reuse=False)
+ if service is None:
+ service = self.get_param(
+ 'service', 'What is the name of the service you wish to access?'
+ '\n(See list:'
+ ' http://code.google.com/apis/gdata/faq.html#clientlogin)',
+ reuse=True)
+ if source is None:
+ source = self.get_param('source', ask=False, reuse=True)
+ client.client_login(email, password, source=source, service=service)
+ elif auth_type == AUTHSUB:
+ auth_sub_token = self.get_param('auth_sub_token', ask=False, reuse=True)
+ session_token = self.get_param('session_token', ask=False, reuse=True)
+ private_key = None
+ auth_url = None
+ single_use_token = None
+ rsa_private_key = self.get_param(
+ 'rsa_private_key',
+ 'If you want to use secure mode AuthSub, please provide the\n'
+ ' location of your RSA private key which corresponds to the\n'
+ ' certificate you have uploaded for your domain. If you do not\n'
+ ' have an RSA key, simply press enter', reuse=True)
+
+ if rsa_private_key:
+ try:
+ private_key_file = open(rsa_private_key, 'rb')
+ private_key = private_key_file.read()
+ private_key_file.close()
+ except IOError:
+ print 'Unable to read private key from file'
+
+ if private_key is not None:
+ if client.auth_token is None:
+ if session_token:
+ client.auth_token = gdata.gauth.SecureAuthSubToken(
+ session_token, private_key, scopes)
+ self.prefs['client_auth_token'] = gdata.gauth.token_to_blob(
+ client.auth_token)
+ return
+ elif auth_sub_token:
+ client.auth_token = gdata.gauth.SecureAuthSubToken(
+ auth_sub_token, private_key, scopes)
+ client.upgrade_token()
+ self.prefs['client_auth_token'] = gdata.gauth.token_to_blob(
+ client.auth_token)
+ return
+
+ auth_url = gdata.gauth.generate_auth_sub_url(
+ 'http://gauthmachine.appspot.com/authsub', scopes, True)
+ print 'with a private key, get ready for this URL', auth_url
+
+ else:
+ if client.auth_token is None:
+ if session_token:
+ client.auth_token = gdata.gauth.AuthSubToken(session_token,
+ scopes)
+ self.prefs['client_auth_token'] = gdata.gauth.token_to_blob(
+ client.auth_token)
+ return
+ elif auth_sub_token:
+ client.auth_token = gdata.gauth.AuthSubToken(auth_sub_token,
+ scopes)
+ client.upgrade_token()
+ self.prefs['client_auth_token'] = gdata.gauth.token_to_blob(
+ client.auth_token)
+ return
+
+ auth_url = gdata.gauth.generate_auth_sub_url(
+ 'http://gauthmachine.appspot.com/authsub', scopes)
+
+ print 'Visit the following URL in your browser to authorize this app:'
+ print str(auth_url)
+ print 'After agreeing to authorize the app, copy the token value from'
+ print ' the URL. Example: "www.google.com/?token=ab12" token value is'
+ print ' ab12'
+ token_value = raw_input('Please enter the token value: ')
+ if private_key is not None:
+ single_use_token = gdata.gauth.SecureAuthSubToken(
+ token_value, private_key, scopes)
+ else:
+ single_use_token = gdata.gauth.AuthSubToken(token_value, scopes)
+ client.auth_token = single_use_token
+ client.upgrade_token()
+
+ elif auth_type == OAUTH:
+ if oauth_type is None:
+ oauth_type = int(self.get_param(
+ 'oauth_type', 'Please choose the authorization mechanism you want'
+ ' to use.\n'
+ '1. use an HMAC signature using your consumer key and secret\n'
+ '2. use RSA with your private key to sign requests\n',
+ reuse=True))
+
+ consumer_key = self.get_param(
+ 'consumer_key', 'Please enter your OAuth conumer key '
+ 'which identifies your app', reuse=True)
+
+ if oauth_type == HMAC:
+ consumer_secret = self.get_param(
+ 'consumer_secret', 'Please enter your OAuth conumer secret '
+ 'which you share with the OAuth provider', True, reuse=False)
+ # Swap out this code once the client supports requesting an oauth
+ # token.
+ # Get a request token.
+ request_token = client.get_oauth_token(
+ scopes, 'http://gauthmachine.appspot.com/oauth', consumer_key,
+ consumer_secret=consumer_secret)
+ elif oauth_type == RSA:
+ rsa_private_key = self.get_param(
+ 'rsa_private_key',
+ 'Please provide the location of your RSA private key which\n'
+ ' corresponds to the certificate you have uploaded for your'
+ ' domain.',
+ reuse=True)
+ try:
+ private_key_file = open(rsa_private_key, 'rb')
+ private_key = private_key_file.read()
+ private_key_file.close()
+ except IOError:
+ print 'Unable to read private key from file'
+
+ request_token = client.get_oauth_token(
+ scopes, 'http://gauthmachine.appspot.com/oauth', consumer_key,
+ rsa_private_key=private_key)
+ else:
+ print 'Invalid OAuth signature type'
+ return None
+
+ # Authorize the request token in the browser.
+ print 'Visit the following URL in your browser to authorize this app:'
+ print str(request_token.generate_authorization_url())
+ print 'After agreeing to authorize the app, copy URL from the browser\'s'
+ print ' address bar.'
+ url = raw_input('Please enter the url: ')
+ gdata.gauth.authorize_request_token(request_token, url)
+ # Exchange for an access token.
+ client.auth_token = client.get_access_token(request_token)
+ else:
+ print 'Invalid authorization type.'
+ return None
+ if client.auth_token:
+ self.prefs['client_auth_token'] = gdata.gauth.token_to_blob(
+ client.auth_token)
+
+
+def get_param(name, prompt='', secret=False, ask=True):
+ settings = SettingsUtil()
+ return settings.get_param(name=name, prompt=prompt, secret=secret, ask=ask)
+
+
+def authorize_client(client, auth_type=None, service=None, source=None,
+ scopes=None, oauth_type=None, consumer_key=None,
+ consumer_secret=None):
+ """Uses command line arguments, or prompts user for token values."""
+ settings = SettingsUtil()
+ return settings.authorize_client(client=client, auth_type=auth_type,
+ service=service, source=source,
+ scopes=scopes, oauth_type=oauth_type,
+ consumer_key=consumer_key,
+ consumer_secret=consumer_secret)
+
+
+def print_options():
+ """Displays usage information, available command line params."""
+ # TODO: fill in the usage description for authorizing the client.
+ print ''
+
diff --git a/samples/apps/marketplace_sample/gdata/service.py b/samples/apps/marketplace_sample/gdata/service.py
new file mode 100755
index 0000000..df05d1f
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/service.py
@@ -0,0 +1,1718 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006,2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""GDataService provides CRUD ops. and programmatic login for GData services.
+
+ Error: A base exception class for all exceptions in the gdata_client
+ module.
+
+ CaptchaRequired: This exception is thrown when a login attempt results in a
+ captcha challenge from the ClientLogin service. When this
+ exception is thrown, the captcha_token and captcha_url are
+ set to the values provided in the server's response.
+
+ BadAuthentication: Raised when a login attempt is made with an incorrect
+ username or password.
+
+ NotAuthenticated: Raised if an operation requiring authentication is called
+ before a user has authenticated.
+
+ NonAuthSubToken: Raised if a method to modify an AuthSub token is used when
+ the user is either not authenticated or is authenticated
+ through another authentication mechanism.
+
+ NonOAuthToken: Raised if a method to modify an OAuth token is used when the
+ user is either not authenticated or is authenticated through
+ another authentication mechanism.
+
+ RequestError: Raised if a CRUD request returned a non-success code.
+
+ UnexpectedReturnType: Raised if the response from the server was not of the
+ desired type. For example, this would be raised if the
+ server sent a feed when the client requested an entry.
+
+ GDataService: Encapsulates user credentials needed to perform insert, update
+ and delete operations with the GData API. An instance can
+ perform user authentication, query, insertion, deletion, and
+ update.
+
+ Query: Eases query URI creation by allowing URI parameters to be set as
+ dictionary attributes. For example a query with a feed of
+ '/base/feeds/snippets' and ['bq'] set to 'digital camera' will
+ produce '/base/feeds/snippets?bq=digital+camera' when .ToUri() is
+ called on it.
+"""
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+import re
+import urllib
+import urlparse
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import atom.service
+import gdata
+import atom
+import atom.http_interface
+import atom.token_store
+import gdata.auth
+import gdata.gauth
+
+
+AUTH_SERVER_HOST = 'https://www.google.com'
+
+
+# When requesting an AuthSub token, it is often helpful to track the scope
+# which is being requested. One way to accomplish this is to add a URL
+# parameter to the 'next' URL which contains the requested scope. This
+# constant is the default name (AKA key) for the URL parameter.
+SCOPE_URL_PARAM_NAME = 'authsub_token_scope'
+# When requesting an OAuth access token or authorization of an existing OAuth
+# request token, it is often helpful to track the scope(s) which is/are being
+# requested. One way to accomplish this is to add a URL parameter to the
+# 'callback' URL which contains the requested scope. This constant is the
+# default name (AKA key) for the URL parameter.
+OAUTH_SCOPE_URL_PARAM_NAME = 'oauth_token_scope'
+# Maps the service names used in ClientLogin to scope URLs.
+CLIENT_LOGIN_SCOPES = gdata.gauth.AUTH_SCOPES
+# Default parameters for GDataService.GetWithRetries method
+DEFAULT_NUM_RETRIES = 3
+DEFAULT_DELAY = 1
+DEFAULT_BACKOFF = 2
+
+
+def lookup_scopes(service_name):
+ """Finds the scope URLs for the desired service.
+
+ In some cases, an unknown service may be used, and in those cases this
+ function will return None.
+ """
+ if service_name in CLIENT_LOGIN_SCOPES:
+ return CLIENT_LOGIN_SCOPES[service_name]
+ return None
+
+
+# Module level variable specifies which module should be used by GDataService
+# objects to make HttpRequests. This setting can be overridden on each
+# instance of GDataService.
+# This module level variable is deprecated. Reassign the http_client member
+# of a GDataService object instead.
+http_request_handler = atom.service
+
+
+class Error(Exception):
+ pass
+
+
+class CaptchaRequired(Error):
+ pass
+
+
+class BadAuthentication(Error):
+ pass
+
+
+class NotAuthenticated(Error):
+ pass
+
+
+class NonAuthSubToken(Error):
+ pass
+
+
+class NonOAuthToken(Error):
+ pass
+
+
+class RequestError(Error):
+ pass
+
+
+class UnexpectedReturnType(Error):
+ pass
+
+
+class BadAuthenticationServiceURL(Error):
+ pass
+
+
+class FetchingOAuthRequestTokenFailed(RequestError):
+ pass
+
+
+class TokenUpgradeFailed(RequestError):
+ pass
+
+
+class RevokingOAuthTokenFailed(RequestError):
+ pass
+
+
+class AuthorizationRequired(Error):
+ pass
+
+
+class TokenHadNoScope(Error):
+ pass
+
+
+class RanOutOfTries(Error):
+ pass
+
+
+class GDataService(atom.service.AtomService):
+ """Contains elements needed for GData login and CRUD request headers.
+
+ Maintains additional headers (tokens for example) needed for the GData
+ services to allow a user to perform inserts, updates, and deletes.
+ """
+ # The hander member is deprecated, use http_client instead.
+ handler = None
+ # The auth_token member is deprecated, use the token_store instead.
+ auth_token = None
+ # The tokens dict is deprecated in favor of the token_store.
+ tokens = None
+
+ def __init__(self, email=None, password=None, account_type='HOSTED_OR_GOOGLE',
+ service=None, auth_service_url=None, source=None, server=None,
+ additional_headers=None, handler=None, tokens=None,
+ http_client=None, token_store=None):
+ """Creates an object of type GDataService.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ account_type: string (optional) The type of account to use. Use
+ 'GOOGLE' for regular Google accounts or 'HOSTED' for Google
+ Apps accounts, or 'HOSTED_OR_GOOGLE' to try finding a HOSTED
+ account first and, if it doesn't exist, try finding a regular
+ GOOGLE account. Default value: 'HOSTED_OR_GOOGLE'.
+ service: string (optional) The desired service for which credentials
+ will be obtained.
+ auth_service_url: string (optional) User-defined auth token request URL
+ allows users to explicitly specify where to send auth token requests.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'base.google.com'.
+ additional_headers: dictionary (optional) Any additional headers which
+ should be included with CRUD operations.
+ handler: module (optional) This parameter is deprecated and has been
+ replaced by http_client.
+ tokens: This parameter is deprecated, calls should be made to
+ token_store instead.
+ http_client: An object responsible for making HTTP requests using a
+ request method. If none is provided, a new instance of
+ atom.http.ProxiedHttpClient will be used.
+ token_store: Keeps a collection of authorization tokens which can be
+ applied to requests for a specific URLs. Critical methods are
+ find_token based on a URL (atom.url.Url or a string), add_token,
+ and remove_token.
+ """
+ atom.service.AtomService.__init__(self, http_client=http_client,
+ token_store=token_store)
+ self.email = email
+ self.password = password
+ self.account_type = account_type
+ self.service = service
+ self.auth_service_url = auth_service_url
+ self.server = server
+ self.additional_headers = additional_headers or {}
+ self._oauth_input_params = None
+ self.__SetSource(source)
+ self.__captcha_token = None
+ self.__captcha_url = None
+ self.__gsessionid = None
+
+ if http_request_handler.__name__ == 'gdata.urlfetch':
+ import gdata.alt.appengine
+ self.http_client = gdata.alt.appengine.AppEngineHttpClient()
+
+ def _SetSessionId(self, session_id):
+ """Used in unit tests to simulate a 302 which sets a gsessionid."""
+ self.__gsessionid = session_id
+
+ # Define properties for GDataService
+ def _SetAuthSubToken(self, auth_token, scopes=None):
+ """Deprecated, use SetAuthSubToken instead."""
+ self.SetAuthSubToken(auth_token, scopes=scopes)
+
+ def __SetAuthSubToken(self, auth_token, scopes=None):
+ """Deprecated, use SetAuthSubToken instead."""
+ self._SetAuthSubToken(auth_token, scopes=scopes)
+
+ def _GetAuthToken(self):
+ """Returns the auth token used for authenticating requests.
+
+ Returns:
+ string
+ """
+ current_scopes = lookup_scopes(self.service)
+ if current_scopes:
+ token = self.token_store.find_token(current_scopes[0])
+ if hasattr(token, 'auth_header'):
+ return token.auth_header
+ return None
+
+ def _GetCaptchaToken(self):
+ """Returns a captcha token if the most recent login attempt generated one.
+
+ The captcha token is only set if the Programmatic Login attempt failed
+ because the Google service issued a captcha challenge.
+
+ Returns:
+ string
+ """
+ return self.__captcha_token
+
+ def __GetCaptchaToken(self):
+ return self._GetCaptchaToken()
+
+ captcha_token = property(__GetCaptchaToken,
+ doc="""Get the captcha token for a login request.""")
+
+ def _GetCaptchaURL(self):
+ """Returns the URL of the captcha image if a login attempt generated one.
+
+ The captcha URL is only set if the Programmatic Login attempt failed
+ because the Google service issued a captcha challenge.
+
+ Returns:
+ string
+ """
+ return self.__captcha_url
+
+ def __GetCaptchaURL(self):
+ return self._GetCaptchaURL()
+
+ captcha_url = property(__GetCaptchaURL,
+ doc="""Get the captcha URL for a login request.""")
+
+ def GetGeneratorFromLinkFinder(self, link_finder, func,
+ num_retries=DEFAULT_NUM_RETRIES,
+ delay=DEFAULT_DELAY,
+ backoff=DEFAULT_BACKOFF):
+ """returns a generator for pagination"""
+ yield link_finder
+ next = link_finder.GetNextLink()
+ while next is not None:
+ next_feed = func(str(self.GetWithRetries(
+ next.href, num_retries=num_retries, delay=delay, backoff=backoff)))
+ yield next_feed
+ next = next_feed.GetNextLink()
+
+ def _GetElementGeneratorFromLinkFinder(self, link_finder, func,
+ num_retries=DEFAULT_NUM_RETRIES,
+ delay=DEFAULT_DELAY,
+ backoff=DEFAULT_BACKOFF):
+ for element in self.GetGeneratorFromLinkFinder(link_finder, func,
+ num_retries=num_retries,
+ delay=delay,
+ backoff=backoff).entry:
+ yield element
+
+ def GetOAuthInputParameters(self):
+ return self._oauth_input_params
+
+ def SetOAuthInputParameters(self, signature_method, consumer_key,
+ consumer_secret=None, rsa_key=None,
+ two_legged_oauth=False, requestor_id=None):
+ """Sets parameters required for using OAuth authentication mechanism.
+
+ NOTE: Though consumer_secret and rsa_key are optional, either of the two
+ is required depending on the value of the signature_method.
+
+ Args:
+ signature_method: class which provides implementation for strategy class
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for
+ signing each request. Valid implementations are provided as the
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1
+ consumer_key: string Domain identifying third_party web application.
+ consumer_secret: string (optional) Secret generated during registration.
+ Required only for HMAC_SHA1 signature method.
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature
+ method.
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.
+ requestor_id: string (optional) User email adress to make requests on
+ their behalf. This parameter should only be set when two_legged_oauth
+ is True.
+ """
+ self._oauth_input_params = gdata.auth.OAuthInputParams(
+ signature_method, consumer_key, consumer_secret=consumer_secret,
+ rsa_key=rsa_key, requestor_id=requestor_id)
+ if two_legged_oauth:
+ oauth_token = gdata.auth.OAuthToken(
+ oauth_input_params=self._oauth_input_params)
+ self.SetOAuthToken(oauth_token)
+
+ def FetchOAuthRequestToken(self, scopes=None, extra_parameters=None,
+ request_url='%s/accounts/OAuthGetRequestToken' % \
+ AUTH_SERVER_HOST, oauth_callback=None):
+ """Fetches and sets the OAuth request token and returns it.
+
+ Args:
+ scopes: string or list of string base URL(s) of the service(s) to be
+ accessed. If None, then this method tries to determine the
+ scope(s) from the current service.
+ extra_parameters: dict (optional) key-value pairs as any additional
+ parameters to be included in the URL and signature while making a
+ request for fetching an OAuth request token. All the OAuth parameters
+ are added by default. But if provided through this argument, any
+ default parameters will be overwritten. For e.g. a default parameter
+ oauth_version 1.0 can be overwritten if
+ extra_parameters = {'oauth_version': '2.0'}
+ request_url: Request token URL. The default is
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.
+ oauth_callback: str (optional) If set, it is assume the client is using
+ the OAuth v1.0a protocol where the callback url is sent in the
+ request token step. If the oauth_callback is also set in
+ extra_params, this value will override that one.
+
+ Returns:
+ The fetched request token as a gdata.auth.OAuthToken object.
+
+ Raises:
+ FetchingOAuthRequestTokenFailed if the server responded to the request
+ with an error.
+ """
+ if scopes is None:
+ scopes = lookup_scopes(self.service)
+ if not isinstance(scopes, (list, tuple)):
+ scopes = [scopes,]
+ if oauth_callback:
+ if extra_parameters is not None:
+ extra_parameters['oauth_callback'] = oauth_callback
+ else:
+ extra_parameters = {'oauth_callback': oauth_callback}
+ request_token_url = gdata.auth.GenerateOAuthRequestTokenUrl(
+ self._oauth_input_params, scopes,
+ request_token_url=request_url,
+ extra_parameters=extra_parameters)
+ response = self.http_client.request('GET', str(request_token_url))
+ if response.status == 200:
+ token = gdata.auth.OAuthToken()
+ token.set_token_string(response.read())
+ token.scopes = scopes
+ token.oauth_input_params = self._oauth_input_params
+ self.SetOAuthToken(token)
+ return token
+ error = {
+ 'status': response.status,
+ 'reason': 'Non 200 response on fetch request token',
+ 'body': response.read()
+ }
+ raise FetchingOAuthRequestTokenFailed(error)
+
+ def SetOAuthToken(self, oauth_token):
+ """Attempts to set the current token and add it to the token store.
+
+ The oauth_token can be any OAuth token i.e. unauthorized request token,
+ authorized request token or access token.
+ This method also attempts to add the token to the token store.
+ Use this method any time you want the current token to point to the
+ oauth_token passed. For e.g. call this method with the request token
+ you receive from FetchOAuthRequestToken.
+
+ Args:
+ request_token: gdata.auth.OAuthToken OAuth request token.
+ """
+ if self.auto_set_current_token:
+ self.current_token = oauth_token
+ if self.auto_store_tokens:
+ self.token_store.add_token(oauth_token)
+
+ def GenerateOAuthAuthorizationURL(
+ self, request_token=None, callback_url=None, extra_params=None,
+ include_scopes_in_callback=False,
+ scopes_param_prefix=OAUTH_SCOPE_URL_PARAM_NAME,
+ request_url='%s/accounts/OAuthAuthorizeToken' % AUTH_SERVER_HOST):
+ """Generates URL at which user will login to authorize the request token.
+
+ Args:
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.
+ If not specified, then the current token will be used if it is of
+ type <gdata.auth.OAuthToken>, else it is found by looking in the
+ token_store by looking for a token for the current scope.
+ callback_url: string (optional) The URL user will be sent to after
+ logging in and granting access.
+ extra_params: dict (optional) Additional parameters to be sent.
+ include_scopes_in_callback: Boolean (default=False) if set to True, and
+ if 'callback_url' is present, the 'callback_url' will be modified to
+ include the scope(s) from the request token as a URL parameter. The
+ key for the 'callback' URL's scope parameter will be
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as
+ a parameter to the 'callback' URL, is that the page which receives
+ the OAuth token will be able to tell which URLs the token grants
+ access to.
+ scopes_param_prefix: string (default='oauth_token_scope') The URL
+ parameter key which maps to the list of valid scopes for the token.
+ This URL parameter will be included in the callback URL along with
+ the scopes of the token as value if include_scopes_in_callback=True.
+ request_url: Authorization URL. The default is
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.
+ Returns:
+ A string URL at which the user is required to login.
+
+ Raises:
+ NonOAuthToken if the user's request token is not an OAuth token or if a
+ request token was not available.
+ """
+ if request_token and not isinstance(request_token, gdata.auth.OAuthToken):
+ raise NonOAuthToken
+ if not request_token:
+ if isinstance(self.current_token, gdata.auth.OAuthToken):
+ request_token = self.current_token
+ else:
+ current_scopes = lookup_scopes(self.service)
+ if current_scopes:
+ token = self.token_store.find_token(current_scopes[0])
+ if isinstance(token, gdata.auth.OAuthToken):
+ request_token = token
+ if not request_token:
+ raise NonOAuthToken
+ return str(gdata.auth.GenerateOAuthAuthorizationUrl(
+ request_token,
+ authorization_url=request_url,
+ callback_url=callback_url, extra_params=extra_params,
+ include_scopes_in_callback=include_scopes_in_callback,
+ scopes_param_prefix=scopes_param_prefix))
+
+ def UpgradeToOAuthAccessToken(self, authorized_request_token=None,
+ request_url='%s/accounts/OAuthGetAccessToken' \
+ % AUTH_SERVER_HOST, oauth_version='1.0',
+ oauth_verifier=None):
+ """Upgrades the authorized request token to an access token and returns it
+
+ Args:
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request
+ token. If not specified, then the current token will be used if it is
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the
+ token_store by looking for a token for the current scope.
+ request_url: Access token URL. The default is
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.
+ oauth_version: str (default='1.0') oauth_version parameter. All other
+ 'oauth_' parameters are added by default. This parameter too, is
+ added by default but here you can override it's value.
+ oauth_verifier: str (optional) If present, it is assumed that the client
+ will use the OAuth v1.0a protocol which includes passing the
+ oauth_verifier (as returned by the SP) in the access token step.
+
+ Returns:
+ Access token
+
+ Raises:
+ NonOAuthToken if the user's authorized request token is not an OAuth
+ token or if an authorized request token was not available.
+ TokenUpgradeFailed if the server responded to the request with an
+ error.
+ """
+ if (authorized_request_token and
+ not isinstance(authorized_request_token, gdata.auth.OAuthToken)):
+ raise NonOAuthToken
+ if not authorized_request_token:
+ if isinstance(self.current_token, gdata.auth.OAuthToken):
+ authorized_request_token = self.current_token
+ else:
+ current_scopes = lookup_scopes(self.service)
+ if current_scopes:
+ token = self.token_store.find_token(current_scopes[0])
+ if isinstance(token, gdata.auth.OAuthToken):
+ authorized_request_token = token
+ if not authorized_request_token:
+ raise NonOAuthToken
+ access_token_url = gdata.auth.GenerateOAuthAccessTokenUrl(
+ authorized_request_token,
+ self._oauth_input_params,
+ access_token_url=request_url,
+ oauth_version=oauth_version,
+ oauth_verifier=oauth_verifier)
+ response = self.http_client.request('GET', str(access_token_url))
+ if response.status == 200:
+ token = gdata.auth.OAuthTokenFromHttpBody(response.read())
+ token.scopes = authorized_request_token.scopes
+ token.oauth_input_params = authorized_request_token.oauth_input_params
+ self.SetOAuthToken(token)
+ return token
+ else:
+ raise TokenUpgradeFailed({'status': response.status,
+ 'reason': 'Non 200 response on upgrade',
+ 'body': response.read()})
+
+ def RevokeOAuthToken(self, request_url='%s/accounts/AuthSubRevokeToken' % \
+ AUTH_SERVER_HOST):
+ """Revokes an existing OAuth token.
+
+ request_url: Token revoke URL. The default is
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.
+ Raises:
+ NonOAuthToken if the user's auth token is not an OAuth token.
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.
+ """
+ scopes = lookup_scopes(self.service)
+ token = self.token_store.find_token(scopes[0])
+ if not isinstance(token, gdata.auth.OAuthToken):
+ raise NonOAuthToken
+
+ response = token.perform_request(self.http_client, 'GET', request_url,
+ headers={'Content-Type':'application/x-www-form-urlencoded'})
+ if response.status == 200:
+ self.token_store.remove_token(token)
+ else:
+ raise RevokingOAuthTokenFailed
+
+ def GetAuthSubToken(self):
+ """Returns the AuthSub token as a string.
+
+ If the token is an gdta.auth.AuthSubToken, the Authorization Label
+ ("AuthSub token") is removed.
+
+ This method examines the current_token to see if it is an AuthSubToken
+ or SecureAuthSubToken. If not, it searches the token_store for a token
+ which matches the current scope.
+
+ The current scope is determined by the service name string member.
+
+ Returns:
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,
+ return the token string. If there is no current_token, a token string
+ for a token which matches the service object's default scope is returned.
+ If there are no tokens valid for the scope, returns None.
+ """
+ if isinstance(self.current_token, gdata.auth.AuthSubToken):
+ return self.current_token.get_token_string()
+ current_scopes = lookup_scopes(self.service)
+ if current_scopes:
+ token = self.token_store.find_token(current_scopes[0])
+ if isinstance(token, gdata.auth.AuthSubToken):
+ return token.get_token_string()
+ else:
+ token = self.token_store.find_token(atom.token_store.SCOPE_ALL)
+ if isinstance(token, gdata.auth.ClientLoginToken):
+ return token.get_token_string()
+ return None
+
+ def SetAuthSubToken(self, token, scopes=None, rsa_key=None):
+ """Sets the token sent in requests to an AuthSub token.
+
+ Sets the current_token and attempts to add the token to the token_store.
+
+ Only use this method if you have received a token from the AuthSub
+ service. The auth token is set automatically when UpgradeToSessionToken()
+ is used. See documentation for Google AuthSub here:
+ http://code.google.com/apis/accounts/AuthForWebApps.html
+
+ Args:
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string
+ The token returned by the AuthSub service. If the token is an
+ AuthSubToken or SecureAuthSubToken, the scope information stored in
+ the token is used. If the token is a string, the scopes parameter is
+ used to determine the valid scopes.
+ scopes: list of URLs for which the token is valid. This is only used
+ if the token parameter is a string.
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature
+ method. This parameter is necessary if the token is a string
+ representing a secure token.
+ """
+ if not isinstance(token, gdata.auth.AuthSubToken):
+ token_string = token
+ if rsa_key:
+ token = gdata.auth.SecureAuthSubToken(rsa_key)
+ else:
+ token = gdata.auth.AuthSubToken()
+
+ token.set_token_string(token_string)
+
+ # If no scopes were set for the token, use the scopes passed in, or
+ # try to determine the scopes based on the current service name. If
+ # all else fails, set the token to match all requests.
+ if not token.scopes:
+ if scopes is None:
+ scopes = lookup_scopes(self.service)
+ if scopes is None:
+ scopes = [atom.token_store.SCOPE_ALL]
+ token.scopes = scopes
+ if self.auto_set_current_token:
+ self.current_token = token
+ if self.auto_store_tokens:
+ self.token_store.add_token(token)
+
+ def GetClientLoginToken(self):
+ """Returns the token string for the current token or a token matching the
+ service scope.
+
+ If the current_token is a ClientLoginToken, the token string for
+ the current token is returned. If the current_token is not set, this method
+ searches for a token in the token_store which is valid for the service
+ object's current scope.
+
+ The current scope is determined by the service name string member.
+ The token string is the end of the Authorization header, it doesn not
+ include the ClientLogin label.
+ """
+ if isinstance(self.current_token, gdata.auth.ClientLoginToken):
+ return self.current_token.get_token_string()
+ current_scopes = lookup_scopes(self.service)
+ if current_scopes:
+ token = self.token_store.find_token(current_scopes[0])
+ if isinstance(token, gdata.auth.ClientLoginToken):
+ return token.get_token_string()
+ else:
+ token = self.token_store.find_token(atom.token_store.SCOPE_ALL)
+ if isinstance(token, gdata.auth.ClientLoginToken):
+ return token.get_token_string()
+ return None
+
+ def SetClientLoginToken(self, token, scopes=None):
+ """Sets the token sent in requests to a ClientLogin token.
+
+ This method sets the current_token to a new ClientLoginToken and it
+ also attempts to add the ClientLoginToken to the token_store.
+
+ Only use this method if you have received a token from the ClientLogin
+ service. The auth_token is set automatically when ProgrammaticLogin()
+ is used. See documentation for Google ClientLogin here:
+ http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html
+
+ Args:
+ token: string or instance of a ClientLoginToken.
+ """
+ if not isinstance(token, gdata.auth.ClientLoginToken):
+ token_string = token
+ token = gdata.auth.ClientLoginToken()
+ token.set_token_string(token_string)
+
+ if not token.scopes:
+ if scopes is None:
+ scopes = lookup_scopes(self.service)
+ if scopes is None:
+ scopes = [atom.token_store.SCOPE_ALL]
+ token.scopes = scopes
+ if self.auto_set_current_token:
+ self.current_token = token
+ if self.auto_store_tokens:
+ self.token_store.add_token(token)
+
+ # Private methods to create the source property.
+ def __GetSource(self):
+ return self.__source
+
+ def __SetSource(self, new_source):
+ self.__source = new_source
+ # Update the UserAgent header to include the new application name.
+ self.additional_headers['User-Agent'] = atom.http_interface.USER_AGENT % (
+ self.__source,)
+
+ source = property(__GetSource, __SetSource,
+ doc="""The source is the name of the application making the request.
+ It should be in the form company_id-app_name-app_version""")
+
+ # Authentication operations
+
+ def ProgrammaticLogin(self, captcha_token=None, captcha_response=None):
+ """Authenticates the user and sets the GData Auth token.
+
+ Login retreives a temporary auth token which must be used with all
+ requests to GData services. The auth token is stored in the GData client
+ object.
+
+ Login is also used to respond to a captcha challenge. If the user's login
+ attempt failed with a CaptchaRequired error, the user can respond by
+ calling Login with the captcha token and the answer to the challenge.
+
+ Args:
+ captcha_token: string (optional) The identifier for the captcha challenge
+ which was presented to the user.
+ captcha_response: string (optional) The user's answer to the captch
+ challenge.
+
+ Raises:
+ CaptchaRequired if the login service will require a captcha response
+ BadAuthentication if the login service rejected the username or password
+ Error if the login service responded with a 403 different from the above
+ """
+ request_body = gdata.auth.generate_client_login_request_body(self.email,
+ self.password, self.service, self.source, self.account_type,
+ captcha_token, captcha_response)
+
+ # If the user has defined their own authentication service URL,
+ # send the ClientLogin requests to this URL:
+ if not self.auth_service_url:
+ auth_request_url = AUTH_SERVER_HOST + '/accounts/ClientLogin'
+ else:
+ auth_request_url = self.auth_service_url
+
+ auth_response = self.http_client.request('POST', auth_request_url,
+ data=request_body,
+ headers={'Content-Type':'application/x-www-form-urlencoded'})
+ response_body = auth_response.read()
+
+ if auth_response.status == 200:
+ # TODO: insert the token into the token_store directly.
+ self.SetClientLoginToken(
+ gdata.auth.get_client_login_token(response_body))
+ self.__captcha_token = None
+ self.__captcha_url = None
+
+ elif auth_response.status == 403:
+ # Examine each line to find the error type and the captcha token and
+ # captch URL if they are present.
+ captcha_parameters = gdata.auth.get_captcha_challenge(response_body,
+ captcha_base_url='%s/accounts/' % AUTH_SERVER_HOST)
+ if captcha_parameters:
+ self.__captcha_token = captcha_parameters['token']
+ self.__captcha_url = captcha_parameters['url']
+ raise CaptchaRequired, 'Captcha Required'
+ elif response_body.splitlines()[0] == 'Error=BadAuthentication':
+ self.__captcha_token = None
+ self.__captcha_url = None
+ raise BadAuthentication, 'Incorrect username or password'
+ else:
+ self.__captcha_token = None
+ self.__captcha_url = None
+ raise Error, 'Server responded with a 403 code'
+ elif auth_response.status == 302:
+ self.__captcha_token = None
+ self.__captcha_url = None
+ # Google tries to redirect all bad URLs back to
+ # http://www.google.<locale>. If a redirect
+ # attempt is made, assume the user has supplied an incorrect authentication URL
+ raise BadAuthenticationServiceURL, 'Server responded with a 302 code.'
+
+ def ClientLogin(self, username, password, account_type=None, service=None,
+ auth_service_url=None, source=None, captcha_token=None,
+ captcha_response=None):
+ """Convenience method for authenticating using ProgrammaticLogin.
+
+ Sets values for email, password, and other optional members.
+
+ Args:
+ username:
+ password:
+ account_type: string (optional)
+ service: string (optional)
+ auth_service_url: string (optional)
+ captcha_token: string (optional)
+ captcha_response: string (optional)
+ """
+ self.email = username
+ self.password = password
+
+ if account_type:
+ self.account_type = account_type
+ if service:
+ self.service = service
+ if source:
+ self.source = source
+ if auth_service_url:
+ self.auth_service_url = auth_service_url
+
+ self.ProgrammaticLogin(captcha_token, captcha_response)
+
+ def GenerateAuthSubURL(self, next, scope, secure=False, session=True,
+ domain='default'):
+ """Generate a URL at which the user will login and be redirected back.
+
+ Users enter their credentials on a Google login page and a token is sent
+ to the URL specified in next. See documentation for AuthSub login at:
+ http://code.google.com/apis/accounts/docs/AuthSub.html
+
+ Args:
+ next: string The URL user will be sent to after logging in.
+ scope: string or list of strings. The URLs of the services to be
+ accessed.
+ secure: boolean (optional) Determines whether or not the issued token
+ is a secure token.
+ session: boolean (optional) Determines whether or not the issued token
+ can be upgraded to a session token.
+ """
+ if not isinstance(scope, (list, tuple)):
+ scope = (scope,)
+ return gdata.auth.generate_auth_sub_url(next, scope, secure=secure,
+ session=session,
+ request_url='%s/accounts/AuthSubRequest' % AUTH_SERVER_HOST,
+ domain=domain)
+
+ def UpgradeToSessionToken(self, token=None):
+ """Upgrades a single use AuthSub token to a session token.
+
+ Args:
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken
+ (optional) which is good for a single use but can be upgraded
+ to a session token. If no token is passed in, the token
+ is found by looking in the token_store by looking for a token
+ for the current scope.
+
+ Raises:
+ NonAuthSubToken if the user's auth token is not an AuthSub token
+ TokenUpgradeFailed if the server responded to the request with an
+ error.
+ """
+ if token is None:
+ scopes = lookup_scopes(self.service)
+ if scopes:
+ token = self.token_store.find_token(scopes[0])
+ else:
+ token = self.token_store.find_token(atom.token_store.SCOPE_ALL)
+ if not isinstance(token, gdata.auth.AuthSubToken):
+ raise NonAuthSubToken
+
+ self.SetAuthSubToken(self.upgrade_to_session_token(token))
+
+ def upgrade_to_session_token(self, token):
+ """Upgrades a single use AuthSub token to a session token.
+
+ Args:
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken
+ which is good for a single use but can be upgraded to a
+ session token.
+
+ Returns:
+ The upgraded token as a gdata.auth.AuthSubToken object.
+
+ Raises:
+ TokenUpgradeFailed if the server responded to the request with an
+ error.
+ """
+ response = token.perform_request(self.http_client, 'GET',
+ AUTH_SERVER_HOST + '/accounts/AuthSubSessionToken',
+ headers={'Content-Type':'application/x-www-form-urlencoded'})
+ response_body = response.read()
+ if response.status == 200:
+ token.set_token_string(
+ gdata.auth.token_from_http_body(response_body))
+ return token
+ else:
+ raise TokenUpgradeFailed({'status': response.status,
+ 'reason': 'Non 200 response on upgrade',
+ 'body': response_body})
+
+ def RevokeAuthSubToken(self):
+ """Revokes an existing AuthSub token.
+
+ Raises:
+ NonAuthSubToken if the user's auth token is not an AuthSub token
+ """
+ scopes = lookup_scopes(self.service)
+ token = self.token_store.find_token(scopes[0])
+ if not isinstance(token, gdata.auth.AuthSubToken):
+ raise NonAuthSubToken
+
+ response = token.perform_request(self.http_client, 'GET',
+ AUTH_SERVER_HOST + '/accounts/AuthSubRevokeToken',
+ headers={'Content-Type':'application/x-www-form-urlencoded'})
+ if response.status == 200:
+ self.token_store.remove_token(token)
+
+ def AuthSubTokenInfo(self):
+ """Fetches the AuthSub token's metadata from the server.
+
+ Raises:
+ NonAuthSubToken if the user's auth token is not an AuthSub token
+ """
+ scopes = lookup_scopes(self.service)
+ token = self.token_store.find_token(scopes[0])
+ if not isinstance(token, gdata.auth.AuthSubToken):
+ raise NonAuthSubToken
+
+ response = token.perform_request(self.http_client, 'GET',
+ AUTH_SERVER_HOST + '/accounts/AuthSubTokenInfo',
+ headers={'Content-Type':'application/x-www-form-urlencoded'})
+ result_body = response.read()
+ if response.status == 200:
+ return result_body
+ else:
+ raise RequestError, {'status': response.status,
+ 'body': result_body}
+
+ def GetWithRetries(self, uri, extra_headers=None, redirects_remaining=4,
+ encoding='UTF-8', converter=None, num_retries=DEFAULT_NUM_RETRIES,
+ delay=DEFAULT_DELAY, backoff=DEFAULT_BACKOFF, logger=None):
+ """This is a wrapper method for Get with retrying capability.
+
+ To avoid various errors while retrieving bulk entities by retrying
+ specified times.
+
+ Note this method relies on the time module and so may not be usable
+ by default in Python2.2.
+
+ Args:
+ num_retries: Integer; the retry count.
+ delay: Integer; the initial delay for retrying.
+ backoff: Integer; how much the delay should lengthen after each failure.
+ logger: An object which has a debug(str) method to receive logging
+ messages. Recommended that you pass in the logging module.
+ Raises:
+ ValueError if any of the parameters has an invalid value.
+ RanOutOfTries on failure after number of retries.
+ """
+ # Moved import for time module inside this method since time is not a
+ # default module in Python2.2. This method will not be usable in
+ # Python2.2.
+ import time
+ if backoff <= 1:
+ raise ValueError("backoff must be greater than 1")
+ num_retries = int(num_retries)
+
+ if num_retries < 0:
+ raise ValueError("num_retries must be 0 or greater")
+
+ if delay <= 0:
+ raise ValueError("delay must be greater than 0")
+
+ # Let's start
+ mtries, mdelay = num_retries, delay
+ while mtries > 0:
+ if mtries != num_retries:
+ if logger:
+ logger.debug("Retrying: %s" % uri)
+ try:
+ rv = self.Get(uri, extra_headers=extra_headers,
+ redirects_remaining=redirects_remaining,
+ encoding=encoding, converter=converter)
+ except SystemExit:
+ # Allow this error
+ raise
+ except RequestError, e:
+ # Error 500 is 'internal server error' and warrants a retry
+ # Error 503 is 'service unavailable' and warrants a retry
+ if e[0]['status'] not in [500, 503]:
+ raise e
+ # Else, fall through to the retry code...
+ except Exception, e:
+ if logger:
+ logger.debug(e)
+ # Fall through to the retry code...
+ else:
+ # This is the right path.
+ return rv
+ mtries -= 1
+ time.sleep(mdelay)
+ mdelay *= backoff
+ raise RanOutOfTries('Ran out of tries.')
+
+ # CRUD operations
+ def Get(self, uri, extra_headers=None, redirects_remaining=4,
+ encoding='UTF-8', converter=None):
+ """Query the GData API with the given URI
+
+ The uri is the portion of the URI after the server value
+ (ex: www.google.com).
+
+ To perform a query against Google Base, set the server to
+ 'base.google.com' and set the uri to '/base/feeds/...', where ... is
+ your query. For example, to find snippets for all digital cameras uri
+ should be set to: '/base/feeds/snippets?bq=digital+camera'
+
+ Args:
+ uri: string The query in the form of a URI. Example:
+ '/base/feeds/snippets?bq=digital+camera'.
+ extra_headers: dictionary (optional) Extra HTTP headers to be included
+ in the GET request. These headers are in addition to
+ those stored in the client's additional_headers property.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+ redirects_remaining: int (optional) Tracks the number of additional
+ redirects this method will allow. If the service object receives
+ a redirect and remaining is 0, it will not follow the redirect.
+ This was added to avoid infinite redirect loops.
+ encoding: string (optional) The character encoding for the server's
+ response. Default is UTF-8
+ converter: func (optional) A function which will transform
+ the server's results before it is returned. Example: use
+ GDataFeedFromString to parse the server response as if it
+ were a GDataFeed.
+
+ Returns:
+ If there is no ResultsTransformer specified in the call, a GDataFeed
+ or GDataEntry depending on which is sent from the server. If the
+ response is niether a feed or entry and there is no ResultsTransformer,
+ return a string. If there is a ResultsTransformer, the returned value
+ will be that of the ResultsTransformer function.
+ """
+
+ if extra_headers is None:
+ extra_headers = {}
+
+ if self.__gsessionid is not None:
+ if uri.find('gsessionid=') < 0:
+ if uri.find('?') > -1:
+ uri += '&gsessionid=%s' % (self.__gsessionid,)
+ else:
+ uri += '?gsessionid=%s' % (self.__gsessionid,)
+
+ server_response = self.request('GET', uri,
+ headers=extra_headers)
+ result_body = server_response.read()
+
+ if server_response.status == 200:
+ if converter:
+ return converter(result_body)
+ # There was no ResultsTransformer specified, so try to convert the
+ # server's response into a GDataFeed.
+ feed = gdata.GDataFeedFromString(result_body)
+ if not feed:
+ # If conversion to a GDataFeed failed, try to convert the server's
+ # response to a GDataEntry.
+ entry = gdata.GDataEntryFromString(result_body)
+ if not entry:
+ # The server's response wasn't a feed, or an entry, so return the
+ # response body as a string.
+ return result_body
+ return entry
+ return feed
+ elif server_response.status == 302:
+ if redirects_remaining > 0:
+ location = (server_response.getheader('Location')
+ or server_response.getheader('location'))
+ if location is not None:
+ m = re.compile('[\?\&]gsessionid=(\w*\-)').search(location)
+ if m is not None:
+ self.__gsessionid = m.group(1)
+ return GDataService.Get(self, location, extra_headers, redirects_remaining - 1,
+ encoding=encoding, converter=converter)
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': '302 received without Location header',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': 'Redirect received, but redirects_remaining <= 0',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': server_response.reason, 'body': result_body}
+
+ def GetMedia(self, uri, extra_headers=None):
+ """Returns a MediaSource containing media and its metadata from the given
+ URI string.
+ """
+ response_handle = self.request('GET', uri,
+ headers=extra_headers)
+ return gdata.MediaSource(response_handle, response_handle.getheader(
+ 'Content-Type'),
+ response_handle.getheader('Content-Length'))
+
+ def GetEntry(self, uri, extra_headers=None):
+ """Query the GData API with the given URI and receive an Entry.
+
+ See also documentation for gdata.service.Get
+
+ Args:
+ uri: string The query in the form of a URI. Example:
+ '/base/feeds/snippets?bq=digital+camera'.
+ extra_headers: dictionary (optional) Extra HTTP headers to be included
+ in the GET request. These headers are in addition to
+ those stored in the client's additional_headers property.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+
+ Returns:
+ A GDataEntry built from the XML in the server's response.
+ """
+
+ result = GDataService.Get(self, uri, extra_headers,
+ converter=atom.EntryFromString)
+ if isinstance(result, atom.Entry):
+ return result
+ else:
+ raise UnexpectedReturnType, 'Server did not send an entry'
+
+ def GetFeed(self, uri, extra_headers=None,
+ converter=gdata.GDataFeedFromString):
+ """Query the GData API with the given URI and receive a Feed.
+
+ See also documentation for gdata.service.Get
+
+ Args:
+ uri: string The query in the form of a URI. Example:
+ '/base/feeds/snippets?bq=digital+camera'.
+ extra_headers: dictionary (optional) Extra HTTP headers to be included
+ in the GET request. These headers are in addition to
+ those stored in the client's additional_headers property.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+
+ Returns:
+ A GDataFeed built from the XML in the server's response.
+ """
+
+ result = GDataService.Get(self, uri, extra_headers, converter=converter)
+ if isinstance(result, atom.Feed):
+ return result
+ else:
+ raise UnexpectedReturnType, 'Server did not send a feed'
+
+ def GetNext(self, feed):
+ """Requests the next 'page' of results in the feed.
+
+ This method uses the feed's next link to request an additional feed
+ and uses the class of the feed to convert the results of the GET request.
+
+ Args:
+ feed: atom.Feed or a subclass. The feed should contain a next link and
+ the type of the feed will be applied to the results from the
+ server. The new feed which is returned will be of the same class
+ as this feed which was passed in.
+
+ Returns:
+ A new feed representing the next set of results in the server's feed.
+ The type of this feed will match that of the feed argument.
+ """
+ next_link = feed.GetNextLink()
+ # Create a closure which will convert an XML string to the class of
+ # the feed object passed in.
+ def ConvertToFeedClass(xml_string):
+ return atom.CreateClassFromXMLString(feed.__class__, xml_string)
+ # Make a GET request on the next link and use the above closure for the
+ # converted which processes the XML string from the server.
+ if next_link and next_link.href:
+ return GDataService.Get(self, next_link.href,
+ converter=ConvertToFeedClass)
+ else:
+ return None
+
+ def Post(self, data, uri, extra_headers=None, url_params=None,
+ escape_params=True, redirects_remaining=4, media_source=None,
+ converter=None):
+ """Insert or update data into a GData service at the given URI.
+
+ Args:
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The
+ XML to be sent to the uri.
+ uri: string The location (feed) to which the data should be inserted.
+ Example: '/base/feeds/items'.
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type,
+ Authorization, and Content-Length headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+ media_source: MediaSource (optional) Container for the media to be sent
+ along with the entry, if provided.
+ converter: func (optional) A function which will be executed on the
+ server's response. Often this is a function like
+ GDataEntryFromString which will parse the body of the server's
+ response and return a GDataEntry.
+
+ Returns:
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,
+ or the results of running converter on the server's result body (if
+ converter was specified).
+ """
+ return GDataService.PostOrPut(self, 'POST', data, uri,
+ extra_headers=extra_headers, url_params=url_params,
+ escape_params=escape_params, redirects_remaining=redirects_remaining,
+ media_source=media_source, converter=converter)
+
+ def PostOrPut(self, verb, data, uri, extra_headers=None, url_params=None,
+ escape_params=True, redirects_remaining=4, media_source=None,
+ converter=None):
+ """Insert data into a GData service at the given URI.
+
+ Args:
+ verb: string, either 'POST' or 'PUT'
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The
+ XML to be sent to the uri.
+ uri: string The location (feed) to which the data should be inserted.
+ Example: '/base/feeds/items'.
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type,
+ Authorization, and Content-Length headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+ media_source: MediaSource (optional) Container for the media to be sent
+ along with the entry, if provided.
+ converter: func (optional) A function which will be executed on the
+ server's response. Often this is a function like
+ GDataEntryFromString which will parse the body of the server's
+ response and return a GDataEntry.
+
+ Returns:
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,
+ or the results of running converter on the server's result body (if
+ converter was specified).
+ """
+ if extra_headers is None:
+ extra_headers = {}
+
+ if self.__gsessionid is not None:
+ if uri.find('gsessionid=') < 0:
+ if url_params is None:
+ url_params = {}
+ url_params['gsessionid'] = self.__gsessionid
+
+ if data and media_source:
+ if ElementTree.iselement(data):
+ data_str = ElementTree.tostring(data)
+ else:
+ data_str = str(data)
+
+ multipart = []
+ multipart.append('Media multipart posting\r\n--END_OF_PART\r\n' + \
+ 'Content-Type: application/atom+xml\r\n\r\n')
+ multipart.append('\r\n--END_OF_PART\r\nContent-Type: ' + \
+ media_source.content_type+'\r\n\r\n')
+ multipart.append('\r\n--END_OF_PART--\r\n')
+
+ extra_headers['MIME-version'] = '1.0'
+ extra_headers['Content-Length'] = str(len(multipart[0]) +
+ len(multipart[1]) + len(multipart[2]) +
+ len(data_str) + media_source.content_length)
+
+ extra_headers['Content-Type'] = 'multipart/related; boundary=END_OF_PART'
+ server_response = self.request(verb, uri,
+ data=[multipart[0], data_str, multipart[1], media_source.file_handle,
+ multipart[2]], headers=extra_headers, url_params=url_params)
+ result_body = server_response.read()
+
+ elif media_source or isinstance(data, gdata.MediaSource):
+ if isinstance(data, gdata.MediaSource):
+ media_source = data
+ extra_headers['Content-Length'] = str(media_source.content_length)
+ extra_headers['Content-Type'] = media_source.content_type
+ server_response = self.request(verb, uri,
+ data=media_source.file_handle, headers=extra_headers,
+ url_params=url_params)
+ result_body = server_response.read()
+
+ else:
+ http_data = data
+ if 'Content-Type' not in extra_headers:
+ content_type = 'application/atom+xml'
+ extra_headers['Content-Type'] = content_type
+ server_response = self.request(verb, uri, data=http_data,
+ headers=extra_headers, url_params=url_params)
+ result_body = server_response.read()
+
+ # Server returns 201 for most post requests, but when performing a batch
+ # request the server responds with a 200 on success.
+ if server_response.status == 201 or server_response.status == 200:
+ if converter:
+ return converter(result_body)
+ feed = gdata.GDataFeedFromString(result_body)
+ if not feed:
+ entry = gdata.GDataEntryFromString(result_body)
+ if not entry:
+ return result_body
+ return entry
+ return feed
+ elif server_response.status == 302:
+ if redirects_remaining > 0:
+ location = (server_response.getheader('Location')
+ or server_response.getheader('location'))
+ if location is not None:
+ m = re.compile('[\?\&]gsessionid=(\w*\-)').search(location)
+ if m is not None:
+ self.__gsessionid = m.group(1)
+ return GDataService.PostOrPut(self, verb, data, location,
+ extra_headers, url_params, escape_params,
+ redirects_remaining - 1, media_source, converter=converter)
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': '302 received without Location header',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': 'Redirect received, but redirects_remaining <= 0',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': server_response.reason, 'body': result_body}
+
+ def Put(self, data, uri, extra_headers=None, url_params=None,
+ escape_params=True, redirects_remaining=3, media_source=None,
+ converter=None):
+ """Updates an entry at the given URI.
+
+ Args:
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The
+ XML containing the updated data.
+ uri: string A URI indicating entry to which the update will be applied.
+ Example: '/base/feeds/items/ITEM-ID'
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type,
+ Authorization, and Content-Length headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+ converter: func (optional) A function which will be executed on the
+ server's response. Often this is a function like
+ GDataEntryFromString which will parse the body of the server's
+ response and return a GDataEntry.
+
+ Returns:
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,
+ or the results of running converter on the server's result body (if
+ converter was specified).
+ """
+ return GDataService.PostOrPut(self, 'PUT', data, uri,
+ extra_headers=extra_headers, url_params=url_params,
+ escape_params=escape_params, redirects_remaining=redirects_remaining,
+ media_source=media_source, converter=converter)
+
+ def Delete(self, uri, extra_headers=None, url_params=None,
+ escape_params=True, redirects_remaining=4):
+ """Deletes the entry at the given URI.
+
+ Args:
+ uri: string The URI of the entry to be deleted. Example:
+ '/base/feeds/items/ITEM-ID'
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ True if the entry was deleted.
+ """
+ if extra_headers is None:
+ extra_headers = {}
+
+ if self.__gsessionid is not None:
+ if uri.find('gsessionid=') < 0:
+ if url_params is None:
+ url_params = {}
+ url_params['gsessionid'] = self.__gsessionid
+
+ server_response = self.request('DELETE', uri,
+ headers=extra_headers, url_params=url_params)
+ result_body = server_response.read()
+
+ if server_response.status == 200:
+ return True
+ elif server_response.status == 302:
+ if redirects_remaining > 0:
+ location = (server_response.getheader('Location')
+ or server_response.getheader('location'))
+ if location is not None:
+ m = re.compile('[\?\&]gsessionid=(\w*\-)').search(location)
+ if m is not None:
+ self.__gsessionid = m.group(1)
+ return GDataService.Delete(self, location, extra_headers,
+ url_params, escape_params, redirects_remaining - 1)
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': '302 received without Location header',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': 'Redirect received, but redirects_remaining <= 0',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': server_response.reason, 'body': result_body}
+
+
+def ExtractToken(url, scopes_included_in_next=True):
+ """Gets the AuthSub token from the current page's URL.
+
+ Designed to be used on the URL that the browser is sent to after the user
+ authorizes this application at the page given by GenerateAuthSubRequestUrl.
+
+ Args:
+ url: The current page's URL. It should contain the token as a URL
+ parameter. Example: 'http://example.com/?...&token=abcd435'
+ scopes_included_in_next: If True, this function looks for a scope value
+ associated with the token. The scope is a URL parameter with the
+ key set to SCOPE_URL_PARAM_NAME. This parameter should be present
+ if the AuthSub request URL was generated using
+ GenerateAuthSubRequestUrl with include_scope_in_next set to True.
+
+ Returns:
+ A tuple containing the token string and a list of scope strings for which
+ this token should be valid. If the scope was not included in the URL, the
+ tuple will contain (token, None).
+ """
+ parsed = urlparse.urlparse(url)
+ token = gdata.auth.AuthSubTokenFromUrl(parsed[4])
+ scopes = ''
+ if scopes_included_in_next:
+ for pair in parsed[4].split('&'):
+ if pair.startswith('%s=' % SCOPE_URL_PARAM_NAME):
+ scopes = urllib.unquote_plus(pair.split('=')[1])
+ return (token, scopes.split(' '))
+
+
+def GenerateAuthSubRequestUrl(next, scopes, hd='default', secure=False,
+ session=True, request_url='https://www.google.com/accounts/AuthSubRequest',
+ include_scopes_in_next=True):
+ """Creates a URL to request an AuthSub token to access Google services.
+
+ For more details on AuthSub, see the documentation here:
+ http://code.google.com/apis/accounts/docs/AuthSub.html
+
+ Args:
+ next: The URL where the browser should be sent after the user authorizes
+ the application. This page is responsible for receiving the token
+ which is embeded in the URL as a parameter.
+ scopes: The base URL to which access will be granted. Example:
+ 'http://www.google.com/calendar/feeds' will grant access to all
+ URLs in the Google Calendar data API. If you would like a token for
+ multiple scopes, pass in a list of URL strings.
+ hd: The domain to which the user's account belongs. This is set to the
+ domain name if you are using Google Apps. Example: 'example.org'
+ Defaults to 'default'
+ secure: If set to True, all requests should be signed. The default is
+ False.
+ session: If set to True, the token received by the 'next' URL can be
+ upgraded to a multiuse session token. If session is set to False, the
+ token may only be used once and cannot be upgraded. Default is True.
+ request_url: The base of the URL to which the user will be sent to
+ authorize this application to access their data. The default is
+ 'https://www.google.com/accounts/AuthSubRequest'.
+ include_scopes_in_next: Boolean if set to true, the 'next' parameter will
+ be modified to include the requested scope as a URL parameter. The
+ key for the next's scope parameter will be SCOPE_URL_PARAM_NAME. The
+ benefit of including the scope URL as a parameter to the next URL, is
+ that the page which receives the AuthSub token will be able to tell
+ which URLs the token grants access to.
+
+ Returns:
+ A URL string to which the browser should be sent.
+ """
+ if isinstance(scopes, list):
+ scope = ' '.join(scopes)
+ else:
+ scope = scopes
+ if include_scopes_in_next:
+ if next.find('?') > -1:
+ next += '&%s' % urllib.urlencode({SCOPE_URL_PARAM_NAME:scope})
+ else:
+ next += '?%s' % urllib.urlencode({SCOPE_URL_PARAM_NAME:scope})
+ return gdata.auth.GenerateAuthSubUrl(next=next, scope=scope, secure=secure,
+ session=session, request_url=request_url, domain=hd)
+
+
+class Query(dict):
+ """Constructs a query URL to be used in GET requests
+
+ Url parameters are created by adding key-value pairs to this object as a
+ dict. For example, to add &max-results=25 to the URL do
+ my_query['max-results'] = 25
+
+ Category queries are created by adding category strings to the categories
+ member. All items in the categories list will be concatenated with the /
+ symbol (symbolizing a category x AND y restriction). If you would like to OR
+ 2 categories, append them as one string with a | between the categories.
+ For example, do query.categories.append('Fritz|Laurie') to create a query
+ like this feed/-/Fritz%7CLaurie . This query will look for results in both
+ categories.
+ """
+
+ def __init__(self, feed=None, text_query=None, params=None,
+ categories=None):
+ """Constructor for Query
+
+ Args:
+ feed: str (optional) The path for the feed (Examples:
+ '/base/feeds/snippets' or 'calendar/feeds/jo@gmail.com/private/full'
+ text_query: str (optional) The contents of the q query parameter. The
+ contents of the text_query are URL escaped upon conversion to a URI.
+ params: dict (optional) Parameter value string pairs which become URL
+ params when translated to a URI. These parameters are added to the
+ query's items (key-value pairs).
+ categories: list (optional) List of category strings which should be
+ included as query categories. See
+ http://code.google.com/apis/gdata/reference.html#Queries for
+ details. If you want to get results from category A or B (both
+ categories), specify a single list item 'A|B'.
+ """
+
+ self.feed = feed
+ self.categories = []
+ if text_query:
+ self.text_query = text_query
+ if isinstance(params, dict):
+ for param in params:
+ self[param] = params[param]
+ if isinstance(categories, list):
+ for category in categories:
+ self.categories.append(category)
+
+ def _GetTextQuery(self):
+ if 'q' in self.keys():
+ return self['q']
+ else:
+ return None
+
+ def _SetTextQuery(self, query):
+ self['q'] = query
+
+ text_query = property(_GetTextQuery, _SetTextQuery,
+ doc="""The feed query's q parameter""")
+
+ def _GetAuthor(self):
+ if 'author' in self.keys():
+ return self['author']
+ else:
+ return None
+
+ def _SetAuthor(self, query):
+ self['author'] = query
+
+ author = property(_GetAuthor, _SetAuthor,
+ doc="""The feed query's author parameter""")
+
+ def _GetAlt(self):
+ if 'alt' in self.keys():
+ return self['alt']
+ else:
+ return None
+
+ def _SetAlt(self, query):
+ self['alt'] = query
+
+ alt = property(_GetAlt, _SetAlt,
+ doc="""The feed query's alt parameter""")
+
+ def _GetUpdatedMin(self):
+ if 'updated-min' in self.keys():
+ return self['updated-min']
+ else:
+ return None
+
+ def _SetUpdatedMin(self, query):
+ self['updated-min'] = query
+
+ updated_min = property(_GetUpdatedMin, _SetUpdatedMin,
+ doc="""The feed query's updated-min parameter""")
+
+ def _GetUpdatedMax(self):
+ if 'updated-max' in self.keys():
+ return self['updated-max']
+ else:
+ return None
+
+ def _SetUpdatedMax(self, query):
+ self['updated-max'] = query
+
+ updated_max = property(_GetUpdatedMax, _SetUpdatedMax,
+ doc="""The feed query's updated-max parameter""")
+
+ def _GetPublishedMin(self):
+ if 'published-min' in self.keys():
+ return self['published-min']
+ else:
+ return None
+
+ def _SetPublishedMin(self, query):
+ self['published-min'] = query
+
+ published_min = property(_GetPublishedMin, _SetPublishedMin,
+ doc="""The feed query's published-min parameter""")
+
+ def _GetPublishedMax(self):
+ if 'published-max' in self.keys():
+ return self['published-max']
+ else:
+ return None
+
+ def _SetPublishedMax(self, query):
+ self['published-max'] = query
+
+ published_max = property(_GetPublishedMax, _SetPublishedMax,
+ doc="""The feed query's published-max parameter""")
+
+ def _GetStartIndex(self):
+ if 'start-index' in self.keys():
+ return self['start-index']
+ else:
+ return None
+
+ def _SetStartIndex(self, query):
+ if not isinstance(query, str):
+ query = str(query)
+ self['start-index'] = query
+
+ start_index = property(_GetStartIndex, _SetStartIndex,
+ doc="""The feed query's start-index parameter""")
+
+ def _GetMaxResults(self):
+ if 'max-results' in self.keys():
+ return self['max-results']
+ else:
+ return None
+
+ def _SetMaxResults(self, query):
+ if not isinstance(query, str):
+ query = str(query)
+ self['max-results'] = query
+
+ max_results = property(_GetMaxResults, _SetMaxResults,
+ doc="""The feed query's max-results parameter""")
+
+ def _GetOrderBy(self):
+ if 'orderby' in self.keys():
+ return self['orderby']
+ else:
+ return None
+
+ def _SetOrderBy(self, query):
+ self['orderby'] = query
+
+ orderby = property(_GetOrderBy, _SetOrderBy,
+ doc="""The feed query's orderby parameter""")
+
+ def ToUri(self):
+ q_feed = self.feed or ''
+ category_string = '/'.join(
+ [urllib.quote_plus(c) for c in self.categories])
+ # Add categories to the feed if there are any.
+ if len(self.categories) > 0:
+ q_feed = q_feed + '/-/' + category_string
+ return atom.service.BuildUri(q_feed, self)
+
+ def __str__(self):
+ return self.ToUri()
diff --git a/samples/apps/marketplace_sample/gdata/test_config.py b/samples/apps/marketplace_sample/gdata/test_config.py
new file mode 100644
index 0000000..16e04e5
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/test_config.py
@@ -0,0 +1,441 @@
+#!/usr/bin/env python
+
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import sys
+import unittest
+import getpass
+import inspect
+import atom.mock_http_core
+import gdata.gauth
+
+
+"""Loads configuration for tests which connect to Google servers.
+
+Settings used in tests are stored in a ConfigCollection instance in this
+module called options. If your test needs to get a test related setting,
+use
+
+import gdata.test_config
+option_value = gdata.test_config.options.get_value('x')
+
+The above will check the command line for an '--x' argument, and if not
+found will either use the default value for 'x' or prompt the user to enter
+one.
+
+Your test can override the value specified by the user by performing:
+
+gdata.test_config.options.set_value('x', 'y')
+
+If your test uses a new option which you would like to allow the user to
+specify on the command line or via a prompt, you can use the register_option
+method as follows:
+
+gdata.test_config.options.register(
+ 'option_name', 'Prompt shown to the user', secret=False #As for password.
+ 'This is the description of the option, shown when help is requested.',
+ 'default value, provide only if you do not want the user to be prompted')
+"""
+
+
+class Option(object):
+
+ def __init__(self, name, prompt, secret=False, description=None, default=None):
+ self.name = name
+ self.prompt = prompt
+ self.secret = secret
+ self.description = description
+ self.default = default
+
+ def get(self):
+ value = self.default
+ # Check for a command line parameter.
+ for i in xrange(len(sys.argv)):
+ if sys.argv[i].startswith('--%s=' % self.name):
+ value = sys.argv[i].split('=')[1]
+ elif sys.argv[i] == '--%s' % self.name:
+ value = sys.argv[i + 1]
+ # If the param was not on the command line, ask the user to input the
+ # value.
+ # In order for this to prompt the user, the default value for the option
+ # must be None.
+ if value is None:
+ prompt = '%s: ' % self.prompt
+ if self.secret:
+ value = getpass.getpass(prompt)
+ else:
+ print 'You can specify this on the command line using --%s' % self.name
+ value = raw_input(prompt)
+ return value
+
+
+class ConfigCollection(object):
+
+ def __init__(self, options=None):
+ self.options = options or {}
+ self.values = {}
+
+ def register_option(self, option):
+ self.options[option.name] = option
+
+ def register(self, *args, **kwargs):
+ self.register_option(Option(*args, **kwargs))
+
+ def get_value(self, option_name):
+ if option_name in self.values:
+ return self.values[option_name]
+ value = self.options[option_name].get()
+ if value is not None:
+ self.values[option_name] = value
+ return value
+
+ def set_value(self, option_name, value):
+ self.values[option_name] = value
+
+ def render_usage(self):
+ message_parts = []
+ for opt_name, option in self.options.iteritems():
+ message_parts.append('--%s: %s' % (opt_name, option.description))
+ return '\n'.join(message_parts)
+
+
+options = ConfigCollection()
+
+
+# Register the default options.
+options.register(
+ 'username',
+ 'Please enter the email address of your test account',
+ description=('The email address you want to sign in with. '
+ 'Make sure this is a test account as these tests may edit'
+ ' or delete data.'))
+options.register(
+ 'password',
+ 'Please enter the password for your test account',
+ secret=True, description='The test account password.')
+options.register(
+ 'clearcache',
+ 'Delete cached data? (enter true or false)',
+ description=('If set to true, any temporary files which cache test'
+ ' requests and responses will be deleted.'),
+ default='true')
+options.register(
+ 'savecache',
+ 'Save requests and responses in a temporary file? (enter true or false)',
+ description=('If set to true, requests to the server and responses will'
+ ' be saved in temporary files.'),
+ default='false')
+options.register(
+ 'runlive',
+ 'Run the live tests which contact the server? (enter true or false)',
+ description=('If set to true, the tests will make real HTTP requests to'
+ ' the servers. This slows down test execution and may'
+ ' modify the users data, be sure to use a test account.'),
+ default='true')
+options.register(
+ 'host',
+ 'Run the live tests against the given host',
+ description='Examples: docs.google.com, spreadsheets.google.com, etc.',
+ default='')
+options.register(
+ 'ssl',
+ 'Run the live tests over SSL (enter true or false)',
+ description='If set to true, all tests will be performed over HTTPS (SSL)',
+ default='false')
+options.register(
+ 'clean',
+ 'Clean ALL data first before and after each test (enter true or false)',
+ description='If set to true, all tests will remove all data (DANGEROUS)',
+ default='false')
+options.register(
+ 'appsusername',
+ 'Please enter the email address of your test Apps domain account',
+ description=('The email address you want to sign in with. '
+ 'Make sure this is a test account on your Apps domain as '
+ 'these tests may edit or delete data.'))
+options.register(
+ 'appspassword',
+ 'Please enter the password for your test Apps domain account',
+ secret=True, description='The test Apps account password.')
+
+# Other options which may be used if needed.
+BLOG_ID_OPTION = Option(
+ 'blogid',
+ 'Please enter the ID of your test blog',
+ description=('The blog ID for the blog which should have test posts added'
+ ' to it. Example 7682659670455539811'))
+TEST_IMAGE_LOCATION_OPTION = Option(
+ 'imgpath',
+ 'Please enter the full path to a test image to upload',
+ description=('This test image will be uploaded to a service which'
+ ' accepts a media file, it must be a jpeg.'))
+SPREADSHEET_ID_OPTION = Option(
+ 'spreadsheetid',
+ 'Please enter the ID of a spreadsheet to use in these tests',
+ description=('The spreadsheet ID for the spreadsheet which should be'
+ ' modified by theses tests.'))
+APPS_DOMAIN_OPTION = Option(
+ 'appsdomain',
+ 'Please enter your Google Apps domain',
+ description=('The domain the Google Apps is hosted on or leave blank'
+ ' if n/a'))
+SITES_NAME_OPTION = Option(
+ 'sitename',
+ 'Please enter name of your Google Site',
+ description='The webspace name of the Site found in its URL.')
+PROJECT_NAME_OPTION = Option(
+ 'project_name',
+ 'Please enter the name of your project hosting project',
+ description=('The name of the project which should have test issues added'
+ ' to it. Example gdata-python-client'))
+ISSUE_ASSIGNEE_OPTION = Option(
+ 'issue_assignee',
+ 'Enter the email address of the target owner of the updated issue.',
+ description=('The email address of the user a created issue\'s owner will '
+ ' become. Example testuser2@gmail.com'))
+GA_TABLE_ID = Option(
+ 'table_id',
+ 'Enter the Table ID of the Google Analytics profile to test',
+ description=('The Table ID of the Google Analytics profile to test.'
+ ' Example ga:1174'))
+TARGET_USERNAME_OPTION = Option(
+ 'targetusername',
+ 'Please enter the username (without domain) of the user which will be'
+ ' affected by the tests',
+ description=('The username of the user to be tested'))
+YT_DEVELOPER_KEY_OPTION = Option(
+ 'developerkey',
+ 'Please enter your YouTube developer key',
+ description=('The YouTube developer key for your account'))
+YT_CLIENT_ID_OPTION = Option(
+ 'clientid',
+ 'Please enter your YouTube client ID',
+ description=('The YouTube client ID for your account'))
+YT_VIDEO_ID_OPTION= Option(
+ 'videoid',
+ 'Please enter the ID of a YouTube video you uploaded',
+ description=('The video ID of a YouTube video uploaded to your account'))
+
+
+# Functions to inject a cachable HTTP client into a service client.
+def configure_client(client, case_name, service_name, use_apps_auth=False):
+ """Sets up a mock client which will reuse a saved session.
+
+ Should be called during setUp of each unit test.
+
+ Handles authentication to allow the GDClient to make requests which
+ require an auth header.
+
+ Args:
+ client: a gdata.GDClient whose http_client member should be replaced
+ with a atom.mock_http_core.MockHttpClient so that repeated
+ executions can used cached responses instead of contacting
+ the server.
+ case_name: str The name of the test case class. Examples: 'BloggerTest',
+ 'ContactsTest'. Used to save a session
+ for the ClientLogin auth token request, so the case_name
+ should be reused if and only if the same username, password,
+ and service are being used.
+ service_name: str The service name as used for ClientLogin to identify
+ the Google Data API being accessed. Example: 'blogger',
+ 'wise', etc.
+ use_apps_auth: bool (optional) If set to True, use appsusername and
+ appspassword command-line args instead of username and
+ password respectively.
+ """
+ # Use a mock HTTP client which will record and replay the HTTP traffic
+ # from these tests.
+ client.http_client = atom.mock_http_core.MockHttpClient()
+ client.http_client.cache_case_name = case_name
+ # Getting the auth token only needs to be done once in the course of test
+ # runs.
+ auth_token_key = '%s_auth_token' % service_name
+ if (auth_token_key not in options.values
+ and options.get_value('runlive') == 'true'):
+ client.http_client.cache_test_name = 'client_login'
+ cache_name = client.http_client.get_cache_file_name()
+ if options.get_value('clearcache') == 'true':
+ client.http_client.delete_session(cache_name)
+ client.http_client.use_cached_session(cache_name)
+ if not use_apps_auth:
+ username = options.get_value('username')
+ password = options.get_value('password')
+ else:
+ username = options.get_value('appsusername')
+ password = options.get_value('appspassword')
+ auth_token = client.client_login(username, password, case_name,
+ service=service_name)
+ options.values[auth_token_key] = gdata.gauth.token_to_blob(auth_token)
+ if client.alt_auth_service is not None:
+ options.values[client.alt_auth_service] = gdata.gauth.token_to_blob(
+ client.alt_auth_token)
+ client.http_client.close_session()
+ # Allow a config auth_token of False to prevent the client's auth header
+ # from being modified.
+ if auth_token_key in options.values:
+ client.auth_token = gdata.gauth.token_from_blob(
+ options.values[auth_token_key])
+ if client.alt_auth_service is not None:
+ client.alt_auth_token = gdata.gauth.token_from_blob(
+ options.values[client.alt_auth_service])
+ if options.get_value('host'):
+ client.host = options.get_value('host')
+
+
+def configure_cache(client, test_name):
+ """Loads or begins a cached session to record HTTP traffic.
+
+ Should be called at the beginning of each test method.
+
+ Args:
+ client: a gdata.GDClient whose http_client member has been replaced
+ with a atom.mock_http_core.MockHttpClient so that repeated
+ executions can used cached responses instead of contacting
+ the server.
+ test_name: str The name of this test method. Examples:
+ 'TestClass.test_x_works', 'TestClass.test_crud_operations'.
+ This is used to name the recording of the HTTP requests and
+ responses, so it should be unique to each test method in the
+ test case.
+ """
+ # Auth token is obtained in configure_client which is called as part of
+ # setUp.
+ client.http_client.cache_test_name = test_name
+ cache_name = client.http_client.get_cache_file_name()
+ if options.get_value('clearcache') == 'true':
+ client.http_client.delete_session(cache_name)
+ client.http_client.use_cached_session(cache_name)
+
+
+def close_client(client):
+ """Saves the recoded responses to a temp file if the config file allows.
+
+ This should be called in the unit test's tearDown method.
+
+ Checks to see if the 'savecache' option is set to 'true', to make sure we
+ only save sessions to repeat if the user desires.
+ """
+ if client and options.get_value('savecache') == 'true':
+ # If this was a live request, save the recording.
+ client.http_client.close_session()
+
+
+def configure_service(service, case_name, service_name):
+ """Sets up a mock GDataService v1 client to reuse recorded sessions.
+
+ Should be called during setUp of each unit test. This is a duplicate of
+ configure_client, modified to handle old v1 service classes.
+ """
+ service.http_client.v2_http_client = atom.mock_http_core.MockHttpClient()
+ service.http_client.v2_http_client.cache_case_name = case_name
+ # Getting the auth token only needs to be done once in the course of test
+ # runs.
+ auth_token_key = 'service_%s_auth_token' % service_name
+ if (auth_token_key not in options.values
+ and options.get_value('runlive') == 'true'):
+ service.http_client.v2_http_client.cache_test_name = 'client_login'
+ cache_name = service.http_client.v2_http_client.get_cache_file_name()
+ if options.get_value('clearcache') == 'true':
+ service.http_client.v2_http_client.delete_session(cache_name)
+ service.http_client.v2_http_client.use_cached_session(cache_name)
+ service.ClientLogin(options.get_value('username'),
+ options.get_value('password'),
+ service=service_name, source=case_name)
+ options.values[auth_token_key] = service.GetClientLoginToken()
+ service.http_client.v2_http_client.close_session()
+ if auth_token_key in options.values:
+ service.SetClientLoginToken(options.values[auth_token_key])
+
+
+def configure_service_cache(service, test_name):
+ """Loads or starts a session recording for a v1 Service object.
+
+ Duplicates the behavior of configure_cache, but the target for this
+ function is a v1 Service object instead of a v2 Client.
+ """
+ service.http_client.v2_http_client.cache_test_name = test_name
+ cache_name = service.http_client.v2_http_client.get_cache_file_name()
+ if options.get_value('clearcache') == 'true':
+ service.http_client.v2_http_client.delete_session(cache_name)
+ service.http_client.v2_http_client.use_cached_session(cache_name)
+
+
+def close_service(service):
+ if service and options.get_value('savecache') == 'true':
+ # If this was a live request, save the recording.
+ service.http_client.v2_http_client.close_session()
+
+
+def build_suite(classes):
+ """Creates a TestSuite for all unit test classes in the list.
+
+ Assumes that each of the classes in the list has unit test methods which
+ begin with 'test'. Calls unittest.makeSuite.
+
+ Returns:
+ A new unittest.TestSuite containing a test suite for all classes.
+ """
+ suites = [unittest.makeSuite(a_class, 'test') for a_class in classes]
+ return unittest.TestSuite(suites)
+
+
+def check_data_classes(test, classes):
+ import inspect
+ for data_class in classes:
+ test.assert_(data_class.__doc__ is not None,
+ 'The class %s should have a docstring' % data_class)
+ if hasattr(data_class, '_qname'):
+ qname_versions = None
+ if isinstance(data_class._qname, tuple):
+ qname_versions = data_class._qname
+ else:
+ qname_versions = (data_class._qname,)
+ for versioned_qname in qname_versions:
+ test.assert_(isinstance(versioned_qname, str),
+ 'The class %s has a non-string _qname' % data_class)
+ test.assert_(not versioned_qname.endswith('}'),
+ 'The _qname for class %s is only a namespace' % (
+ data_class))
+
+ for attribute_name, value in data_class.__dict__.iteritems():
+ # Ignore all elements that start with _ (private members)
+ if not attribute_name.startswith('_'):
+ try:
+ if not (isinstance(value, str) or inspect.isfunction(value)
+ or (isinstance(value, list)
+ and issubclass(value[0], atom.core.XmlElement))
+ or type(value) == property # Allow properties.
+ or inspect.ismethod(value) # Allow methods.
+ or inspect.ismethoddescriptor(value) # Allow method descriptors.
+ # staticmethod et al.
+ or issubclass(value, atom.core.XmlElement)):
+ test.fail(
+ 'XmlElement member should have an attribute, XML class,'
+ ' or list of XML classes as attributes.')
+
+ except TypeError:
+ test.fail('Element %s in %s was of type %s' % (
+ attribute_name, data_class._qname, type(value)))
+
+
+def check_clients_with_auth(test, classes):
+ for client_class in classes:
+ test.assert_(hasattr(client_class, 'api_version'))
+ test.assert_(isinstance(client_class.auth_service, (str, unicode, int)))
+ test.assert_(hasattr(client_class, 'auth_service'))
+ test.assert_(isinstance(client_class.auth_service, (str, unicode)))
+ test.assert_(hasattr(client_class, 'auth_scopes'))
+ test.assert_(isinstance(client_class.auth_scopes, (list, tuple)))
diff --git a/samples/apps/marketplace_sample/gdata/test_data.py b/samples/apps/marketplace_sample/gdata/test_data.py
new file mode 100755
index 0000000..7c979e7
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/test_data.py
@@ -0,0 +1,6063 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+
+XML_ENTRY_1 = """<?xml version='1.0'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:g='http://base.google.com/ns/1.0'>
+ <category scheme="http://base.google.com/categories/itemtypes"
+ term="products"/>
+ <id> http://www.google.com/test/id/url </id>
+ <title type='text'>Testing 2000 series laptop</title>
+ <content type='xhtml'>
+ <div xmlns='http://www.w3.org/1999/xhtml'>A Testing Laptop</div>
+ </content>
+ <link rel='alternate' type='text/html'
+ href='http://www.provider-host.com/123456789'/>
+ <link rel='license'
+ href='http://creativecommons.org/licenses/by-nc/2.5/rdf'/>
+ <g:label>Computer</g:label>
+ <g:label>Laptop</g:label>
+ <g:label>testing laptop</g:label>
+ <g:item_type>products</g:item_type>
+</entry>"""
+
+
+TEST_BASE_ENTRY = """<?xml version='1.0'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:g='http://base.google.com/ns/1.0'>
+ <category scheme="http://base.google.com/categories/itemtypes"
+ term="products"/>
+ <title type='text'>Testing 2000 series laptop</title>
+ <content type='xhtml'>
+ <div xmlns='http://www.w3.org/1999/xhtml'>A Testing Laptop</div>
+ </content>
+ <app:control xmlns:app='http://purl.org/atom/app#'>
+ <app:draft>yes</app:draft>
+ <gm:disapproved xmlns:gm='http://base.google.com/ns-metadata/1.0'/>
+ </app:control>
+ <link rel='alternate' type='text/html'
+ href='http://www.provider-host.com/123456789'/>
+ <g:label>Computer</g:label>
+ <g:label>Laptop</g:label>
+ <g:label>testing laptop</g:label>
+ <g:item_type>products</g:item_type>
+</entry>"""
+
+
+BIG_FEED = """<?xml version="1.0" encoding="utf-8"?>
+ <feed xmlns="http://www.w3.org/2005/Atom">
+ <title type="text">dive into mark</title>
+ <subtitle type="html">
+ A <em>lot</em> of effort
+ went into making this effortless
+ </subtitle>
+ <updated>2005-07-31T12:29:29Z</updated>
+ <id>tag:example.org,2003:3</id>
+ <link rel="alternate" type="text/html"
+ hreflang="en" href="http://example.org/"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://example.org/feed.atom"/>
+ <rights>Copyright (c) 2003, Mark Pilgrim</rights>
+ <generator uri="http://www.example.com/" version="1.0">
+ Example Toolkit
+ </generator>
+ <entry>
+ <title>Atom draft-07 snapshot</title>
+ <link rel="alternate" type="text/html"
+ href="http://example.org/2005/04/02/atom"/>
+ <link rel="enclosure" type="audio/mpeg" length="1337"
+ href="http://example.org/audio/ph34r_my_podcast.mp3"/>
+ <id>tag:example.org,2003:3.2397</id>
+ <updated>2005-07-31T12:29:29Z</updated>
+ <published>2003-12-13T08:29:29-04:00</published>
+ <author>
+ <name>Mark Pilgrim</name>
+ <uri>http://example.org/</uri>
+ <email>f8dy@example.com</email>
+ </author>
+ <contributor>
+ <name>Sam Ruby</name>
+ </contributor>
+ <contributor>
+ <name>Joe Gregorio</name>
+ </contributor>
+ <content type="xhtml" xml:lang="en"
+ xml:base="http://diveintomark.org/">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <p><i>[Update: The Atom draft is finished.]</i></p>
+ </div>
+ </content>
+ </entry>
+ </feed>
+"""
+
+SMALL_FEED = """<?xml version="1.0" encoding="utf-8"?>
+ <feed xmlns="http://www.w3.org/2005/Atom">
+ <title>Example Feed</title>
+ <link href="http://example.org/"/>
+ <updated>2003-12-13T18:30:02Z</updated>
+ <author>
+ <name>John Doe</name>
+ </author>
+ <id>urn:uuid:60a76c80-d399-11d9-b93C-0003939e0af6</id>
+ <entry>
+ <title>Atom-Powered Robots Run Amok</title>
+ <link href="http://example.org/2003/12/13/atom03"/>
+ <id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
+ <updated>2003-12-13T18:30:02Z</updated>
+ <summary>Some text.</summary>
+ </entry>
+ </feed>
+"""
+
+GBASE_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:g='http://base.google.com/ns/1.0' xmlns:batch='http://schemas.google.com/gdata/batch'>
+<id>http://www.google.com/base/feeds/snippets</id>
+<updated>2007-02-08T23:18:21.935Z</updated>
+<title type='text'>Items matching query: digital camera</title>
+<link rel='alternate' type='text/html' href='http://base.google.com'>
+</link>
+<link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets'>
+</link>
+<link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets?start-index=1&max-results=25&bq=digital+camera'>
+</link>
+<link rel='next' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets?start-index=26&max-results=25&bq=digital+camera'>
+</link>
+<generator version='1.0' uri='http://base.google.com'>GoogleBase </generator>
+<openSearch:totalResults>2171885</openSearch:totalResults>
+<openSearch:startIndex>1</openSearch:startIndex>
+<openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+<entry>
+<id>http://www.google.com/base/feeds/snippets/13246453826751927533</id>
+<published>2007-02-08T13:23:27.000Z</published>
+<updated>2007-02-08T16:40:57.000Z</updated>
+<category scheme='http://base.google.com/categories/itemtypes' term='Products'>
+</category>
+<title type='text'>Digital Camera Battery Notebook Computer 12v DC Power Cable - 5.5mm x 2.5mm (Center +) Camera Connecting Cables</title>
+<content type='html'>Notebook Computer 12v DC Power Cable - 5.5mm x 2.1mm (Center +) This connection cable will allow any Digital Pursuits battery pack to power portable computers that operate with 12v power and have a 2.1mm power connector (center +) Digital ...</content>
+<link rel='alternate' type='text/html' href='http://www.bhphotovideo.com/bnh/controller/home?O=productlist&A=details&Q=&sku=305668&is=REG&kw=DIDCB5092&BI=583'>
+</link>
+<link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets/13246453826751927533'>
+</link>
+<author>
+<name>B&H Photo-Video</name>
+<email>anon-szot0wdsq0at@base.google.com</email>
+</author>
+<g:payment_notes type='text'>PayPal & Bill Me Later credit available online only.</g:payment_notes>
+<g:condition type='text'>new</g:condition>
+<g:location type='location'>420 9th Ave. 10001</g:location>
+<g:id type='text'>305668-REG</g:id>
+<g:item_type type='text'>Products</g:item_type>
+<g:brand type='text'>Digital Camera Battery</g:brand>
+<g:expiration_date type='dateTime'>2007-03-10T13:23:27.000Z</g:expiration_date>
+<g:customer_id type='int'>1172711</g:customer_id>
+<g:price type='floatUnit'>34.95 usd</g:price>
+<g:product_type type='text'>Digital Photography>Camera Connecting Cables</g:product_type>
+<g:item_language type='text'>EN</g:item_language>
+<g:manufacturer_id type='text'>DCB5092</g:manufacturer_id>
+<g:target_country type='text'>US</g:target_country>
+<g:weight type='float'>1.0</g:weight>
+<g:image_link type='url'>http://base.google.com/base_image?q=http%3A%2F%2Fwww.bhphotovideo.com%2Fimages%2Fitems%2F305668.jpg&dhm=ffffffff84c9a95e&size=6</g:image_link>
+</entry>
+<entry>
+<id>http://www.google.com/base/feeds/snippets/10145771037331858608</id>
+<published>2007-02-08T13:23:27.000Z</published>
+<updated>2007-02-08T16:40:57.000Z</updated>
+<category scheme='http://base.google.com/categories/itemtypes' term='Products'>
+</category>
+<title type='text'>Digital Camera Battery Electronic Device 5v DC Power Cable - 5.5mm x 2.5mm (Center +) Camera Connecting Cables</title>
+<content type='html'>Electronic Device 5v DC Power Cable - 5.5mm x 2.5mm (Center +) This connection cable will allow any Digital Pursuits battery pack to power any electronic device that operates with 5v power and has a 2.5mm power connector (center +) Digital ...</content>
+<link rel='alternate' type='text/html' href='http://www.bhphotovideo.com/bnh/controller/home?O=productlist&A=details&Q=&sku=305656&is=REG&kw=DIDCB5108&BI=583'>
+</link>
+<link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets/10145771037331858608'>
+</link>
+<author>
+<name>B&H Photo-Video</name>
+<email>anon-szot0wdsq0at@base.google.com</email>
+</author>
+<g:location type='location'>420 9th Ave. 10001</g:location>
+<g:condition type='text'>new</g:condition>
+<g:weight type='float'>0.18</g:weight>
+<g:target_country type='text'>US</g:target_country>
+<g:product_type type='text'>Digital Photography>Camera Connecting Cables</g:product_type>
+<g:payment_notes type='text'>PayPal & Bill Me Later credit available online only.</g:payment_notes>
+<g:id type='text'>305656-REG</g:id>
+<g:image_link type='url'>http://base.google.com/base_image?q=http%3A%2F%2Fwww.bhphotovideo.com%2Fimages%2Fitems%2F305656.jpg&dhm=7315bdc8&size=6</g:image_link>
+<g:manufacturer_id type='text'>DCB5108</g:manufacturer_id>
+<g:upc type='text'>838098005108</g:upc>
+<g:price type='floatUnit'>34.95 usd</g:price>
+<g:item_language type='text'>EN</g:item_language>
+<g:brand type='text'>Digital Camera Battery</g:brand>
+<g:customer_id type='int'>1172711</g:customer_id>
+<g:item_type type='text'>Products</g:item_type>
+<g:expiration_date type='dateTime'>2007-03-10T13:23:27.000Z</g:expiration_date>
+</entry>
+<entry>
+<id>http://www.google.com/base/feeds/snippets/3128608193804768644</id>
+<published>2007-02-08T02:21:27.000Z</published>
+<updated>2007-02-08T15:40:13.000Z</updated>
+<category scheme='http://base.google.com/categories/itemtypes' term='Products'>
+</category>
+<title type='text'>Digital Camera Battery Power Cable for Kodak 645 Pro-Back ProBack & DCS-300 Series Camera Connecting Cables</title>
+<content type='html'>Camera Connection Cable - to Power Kodak 645 Pro-Back DCS-300 Series Digital Cameras This connection cable will allow any Digital Pursuits battery pack to power the following digital cameras: Kodak DCS Pro Back 645 DCS-300 series Digital Photography ...</content>
+<link rel='alternate' type='text/html' href='http://www.bhphotovideo.com/bnh/controller/home?O=productlist&A=details&Q=&sku=305685&is=REG&kw=DIDCB6006&BI=583'>
+</link>
+<link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets/3128608193804768644'>
+</link>
+<author>
+<name>B&H Photo-Video</name>
+<email>anon-szot0wdsq0at@base.google.com</email>
+</author>
+<g:weight type='float'>0.3</g:weight>
+<g:manufacturer_id type='text'>DCB6006</g:manufacturer_id>
+<g:image_link type='url'>http://base.google.com/base_image?q=http%3A%2F%2Fwww.bhphotovideo.com%2Fimages%2Fitems%2F305685.jpg&dhm=72f0ca0a&size=6</g:image_link>
+<g:location type='location'>420 9th Ave. 10001</g:location>
+<g:payment_notes type='text'>PayPal & Bill Me Later credit available online only.</g:payment_notes>
+<g:item_type type='text'>Products</g:item_type>
+<g:target_country type='text'>US</g:target_country>
+<g:accessory_for type='text'>digital kodak camera</g:accessory_for>
+<g:brand type='text'>Digital Camera Battery</g:brand>
+<g:expiration_date type='dateTime'>2007-03-10T02:21:27.000Z</g:expiration_date>
+<g:item_language type='text'>EN</g:item_language>
+<g:condition type='text'>new</g:condition>
+<g:price type='floatUnit'>34.95 usd</g:price>
+<g:customer_id type='int'>1172711</g:customer_id>
+<g:product_type type='text'>Digital Photography>Camera Connecting Cables</g:product_type>
+<g:id type='text'>305685-REG</g:id>
+</entry>
+</feed>"""
+
+EXTENSION_TREE = """<?xml version="1.0" encoding="utf-8"?>
+ <feed xmlns="http://www.w3.org/2005/Atom">
+ <g:author xmlns:g="http://www.google.com">
+ <g:name>John Doe
+ <g:foo yes="no" up="down">Bar</g:foo>
+ </g:name>
+ </g:author>
+ </feed>
+"""
+
+TEST_AUTHOR = """<?xml version="1.0" encoding="utf-8"?>
+ <author xmlns="http://www.w3.org/2005/Atom">
+ <name xmlns="http://www.w3.org/2005/Atom">John Doe</name>
+ <email xmlns="http://www.w3.org/2005/Atom">johndoes@someemailadress.com</email>
+ <uri xmlns="http://www.w3.org/2005/Atom">http://www.google.com</uri>
+ </author>
+"""
+
+TEST_LINK = """<?xml version="1.0" encoding="utf-8"?>
+ <link xmlns="http://www.w3.org/2005/Atom" href="http://www.google.com"
+ rel="test rel" foo1="bar" foo2="rab"/>
+"""
+
+TEST_GBASE_ATTRIBUTE = """<?xml version="1.0" encoding="utf-8"?>
+ <g:brand type='text' xmlns:g="http://base.google.com/ns/1.0">Digital Camera Battery</g:brand>
+"""
+
+
+CALENDAR_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:gd='http://schemas.google.com/g/2005'
+xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <id>http://www.google.com/calendar/feeds/default</id>
+ <updated>2007-03-20T22:48:57.833Z</updated>
+ <title type='text'>GData Ops Demo's Calendar List</title>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default'></link>
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default'></link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <generator version='1.0' uri='http://www.google.com/calendar'>
+ Google Calendar</generator>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/gdata.ops.demo%40gmail.com</id>
+ <published>2007-03-20T22:48:57.837Z</published>
+ <updated>2007-03-20T22:48:52.000Z</updated>
+ <title type='text'>GData Ops Demo</title>
+ <link rel='alternate' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/gdata.ops.demo%40gmail.com/private/full'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/gdata.ops.demo%40gmail.com'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:color value='#2952A3'></gCal:color>
+ <gCal:accesslevel value='owner'></gCal:accesslevel>
+ <gCal:hidden value='false'></gCal:hidden>
+ <gCal:timezone value='America/Los_Angeles'></gCal:timezone>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/jnh21ovnjgfph21h32gvms2758%40group.calendar.google.com</id>
+ <published>2007-03-20T22:48:57.837Z</published>
+ <updated>2007-03-20T22:48:53.000Z</updated>
+ <title type='text'>GData Ops Demo Secondary Calendar</title>
+ <summary type='text'></summary>
+ <link rel='alternate' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/jnh21ovnjgfph21h32gvms2758%40group.calendar.google.com/private/full'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/jnh21ovnjgfph21h32gvms2758%40group.calendar.google.com'>
+ </link>
+ <author>
+ <name>GData Ops Demo Secondary Calendar</name>
+ </author>
+ <gCal:color value='#528800'></gCal:color>
+ <gCal:accesslevel value='owner'></gCal:accesslevel>
+ <gCal:hidden value='false'></gCal:hidden>
+ <gCal:timezone value='America/Los_Angeles'></gCal:timezone>
+ <gd:where valueString=''></gd:where>
+ </entry>
+</feed>
+"""
+
+CALENDAR_FULL_EVENT_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:gd='http://schemas.google.com/g/2005'
+xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full</id>
+ <updated>2007-03-20T21:29:57.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>GData Ops Demo</title>
+ <subtitle type='text'>GData Ops Demo</subtitle>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full?updated-min=2001-01-01&max-results=25'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <generator version='1.0' uri='http://www.google.com/calendar'>
+ Google Calendar</generator>
+ <openSearch:totalResults>10</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <gCal:timezone value='America/Los_Angeles'></gCal:timezone>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/o99flmgmkfkfrr8u745ghr3100</id>
+ <published>2007-03-20T21:29:52.000Z</published>
+ <updated>2007-03-20T21:29:57.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>test deleted</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=bzk5ZmxtZ21rZmtmcnI4dTc0NWdocjMxMDAgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/o99flmgmkfkfrr8u745ghr3100'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/o99flmgmkfkfrr8u745ghr3100/63310109397'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.canceled'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/o99flmgmkfkfrr8u745ghr3100/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-23T12:00:00.000-07:00'
+ endTime='2007-03-23T13:00:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/2qt3ao5hbaq7m9igr5ak9esjo0</id>
+ <published>2007-03-20T21:26:04.000Z</published>
+ <updated>2007-03-20T21:28:46.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Afternoon at Dolores Park with Kim</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=MnF0M2FvNWhiYXE3bTlpZ3I1YWs5ZXNqbzAgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/2qt3ao5hbaq7m9igr5ak9esjo0'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/2qt3ao5hbaq7m9igr5ak9esjo0/63310109326'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/2qt3ao5hbaq7m9igr5ak9esjo0/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.private'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:who rel='http://schemas.google.com/g/2005#event.organizer'
+ valueString='GData Ops Demo' email='gdata.ops.demo@gmail.com'>
+ <gd:attendeeStatus value='http://schemas.google.com/g/2005#event.accepted'>
+ </gd:attendeeStatus>
+ </gd:who>
+ <gd:who rel='http://schemas.google.com/g/2005#event.attendee'
+ valueString='Ryan Boyd (API)' email='api.rboyd@gmail.com'>
+ <gd:attendeeStatus value='http://schemas.google.com/g/2005#event.invited'>
+ </gd:attendeeStatus>
+ </gd:who>
+ <gd:when startTime='2007-03-24T12:00:00.000-07:00'
+ endTime='2007-03-24T15:00:00.000-07:00'>
+ <gd:reminder minutes='20'></gd:reminder>
+ </gd:when>
+ <gd:where valueString='Dolores Park with Kim'></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/uvsqhg7klnae40v50vihr1pvos</id>
+ <published>2007-03-20T21:28:37.000Z</published>
+ <updated>2007-03-20T21:28:37.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Team meeting</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=dXZzcWhnN2tsbmFlNDB2NTB2aWhyMXB2b3NfMjAwNzAzMjNUMTYwMDAwWiBnZGF0YS5vcHMuZGVtb0Bt'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/uvsqhg7klnae40v50vihr1pvos'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/uvsqhg7klnae40v50vihr1pvos/63310109317'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gd:recurrence>DTSTART;TZID=America/Los_Angeles:20070323T090000
+ DTEND;TZID=America/Los_Angeles:20070323T100000
+ RRULE:FREQ=WEEKLY;BYDAY=FR;UNTIL=20070817T160000Z;WKST=SU
+ BEGIN:VTIMEZONE TZID:America/Los_Angeles
+ X-LIC-LOCATION:America/Los_Angeles BEGIN:STANDARD
+ TZOFFSETFROM:-0700 TZOFFSETTO:-0800 TZNAME:PST
+ DTSTART:19701025T020000 RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU
+ END:STANDARD BEGIN:DAYLIGHT TZOFFSETFROM:-0800 TZOFFSETTO:-0700
+ TZNAME:PDT DTSTART:19700405T020000
+ RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=1SU END:DAYLIGHT
+ END:VTIMEZONE</gd:recurrence>
+ <gCal:sendEventNotifications value='true'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.public'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:reminder minutes='10'></gd:reminder>
+ <gd:where valueString=''></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/st4vk9kiffs6rasrl32e4a7alo</id>
+ <published>2007-03-20T21:25:46.000Z</published>
+ <updated>2007-03-20T21:25:46.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Movie with Kim and danah</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=c3Q0dms5a2lmZnM2cmFzcmwzMmU0YTdhbG8gZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/st4vk9kiffs6rasrl32e4a7alo'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/st4vk9kiffs6rasrl32e4a7alo/63310109146'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/st4vk9kiffs6rasrl32e4a7alo/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-24T20:00:00.000-07:00'
+ endTime='2007-03-24T21:00:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/ofl1e45ubtsoh6gtu127cls2oo</id>
+ <published>2007-03-20T21:24:43.000Z</published>
+ <updated>2007-03-20T21:25:08.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Dinner with Kim and Sarah</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=b2ZsMWU0NXVidHNvaDZndHUxMjdjbHMyb28gZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ofl1e45ubtsoh6gtu127cls2oo'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ofl1e45ubtsoh6gtu127cls2oo/63310109108'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/ofl1e45ubtsoh6gtu127cls2oo/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-20T19:00:00.000-07:00'
+ endTime='2007-03-20T21:30:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/b69s2avfi2joigsclecvjlc91g</id>
+ <published>2007-03-20T21:24:19.000Z</published>
+ <updated>2007-03-20T21:25:05.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Dinner with Jane and John</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=YjY5czJhdmZpMmpvaWdzY2xlY3ZqbGM5MWcgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/b69s2avfi2joigsclecvjlc91g'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/b69s2avfi2joigsclecvjlc91g/63310109105'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/b69s2avfi2joigsclecvjlc91g/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-22T17:00:00.000-07:00'
+ endTime='2007-03-22T19:30:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/u9p66kkiotn8bqh9k7j4rcnjjc</id>
+ <published>2007-03-20T21:24:33.000Z</published>
+ <updated>2007-03-20T21:24:33.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Tennis with Elizabeth</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=dTlwNjZra2lvdG44YnFoOWs3ajRyY25qamMgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/u9p66kkiotn8bqh9k7j4rcnjjc'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/u9p66kkiotn8bqh9k7j4rcnjjc/63310109073'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/u9p66kkiotn8bqh9k7j4rcnjjc/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-24T10:00:00.000-07:00'
+ endTime='2007-03-24T11:00:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/76oj2kceidob3s708tvfnuaq3c</id>
+ <published>2007-03-20T21:24:00.000Z</published>
+ <updated>2007-03-20T21:24:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Lunch with Jenn</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=NzZvajJrY2VpZG9iM3M3MDh0dmZudWFxM2MgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/76oj2kceidob3s708tvfnuaq3c'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/76oj2kceidob3s708tvfnuaq3c/63310109040'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/76oj2kceidob3s708tvfnuaq3c/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-20T11:30:00.000-07:00'
+ endTime='2007-03-20T12:30:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/5np9ec8m7uoauk1vedh5mhodco</id>
+ <published>2007-03-20T07:50:02.000Z</published>
+ <updated>2007-03-20T20:39:26.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>test entry</title>
+ <content type='text'>test desc</content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=NW5wOWVjOG03dW9hdWsxdmVkaDVtaG9kY28gZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/5np9ec8m7uoauk1vedh5mhodco'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/5np9ec8m7uoauk1vedh5mhodco/63310106366'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/5np9ec8m7uoauk1vedh5mhodco/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.private'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:who rel='http://schemas.google.com/g/2005#event.attendee'
+ valueString='Vivian Li' email='vli@google.com'>
+ <gd:attendeeStatus value='http://schemas.google.com/g/2005#event.declined'>
+ </gd:attendeeStatus>
+ </gd:who>
+ <gd:who rel='http://schemas.google.com/g/2005#event.organizer'
+ valueString='GData Ops Demo' email='gdata.ops.demo@gmail.com'>
+ <gd:attendeeStatus value='http://schemas.google.com/g/2005#event.accepted'>
+ </gd:attendeeStatus>
+ </gd:who>
+ <gd:when startTime='2007-03-21T08:00:00.000-07:00'
+ endTime='2007-03-21T09:00:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where valueString='anywhere'></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/fu6sl0rqakf3o0a13oo1i1a1mg</id>
+ <published>2007-02-14T23:23:37.000Z</published>
+ <updated>2007-02-14T23:25:30.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>test</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=ZnU2c2wwcnFha2YzbzBhMTNvbzFpMWExbWcgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/fu6sl0rqakf3o0a13oo1i1a1mg'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/fu6sl0rqakf3o0a13oo1i1a1mg/63307178730'>
+ </link>
+ <link rel="http://schemas.google.com/gCal/2005/webContent" title="World Cup" href="http://www.google.com/calendar/images/google-holiday.gif" type="image/gif">
+ <gCal:webContent width="276" height="120" url="http://www.google.com/logos/worldcup06.gif" />
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/fu6sl0rqakf3o0a13oo1i1a1mg/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-02-15T08:30:00.000-08:00'
+ endTime='2007-02-15T09:30:00.000-08:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/h7a0haa4da8sil3rr19ia6luvc</id>
+ <published>2007-07-16T22:13:28.000Z</published>
+ <updated>2007-07-16T22:13:29.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event' />
+ <title type='text'></title>
+ <content type='text' />
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=aDdhMGhhYTRkYThzaWwzcnIxOWlhNmx1dmMgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate' />
+ <link rel='http://schemas.google.com/gCal/2005/webContent'
+ type='application/x-google-gadgets+xml'
+ href='http://gdata.ops.demo.googlepages.com/birthdayicon.gif'
+ title='Date and Time Gadget'>
+ <gCal:webContent width='300' height='136'
+ url='http://google.com/ig/modules/datetime.xml'>
+ <gCal:webContentGadgetPref name='color' value='green' />
+ </gCal:webContent>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/h7a0haa4da8sil3rr19ia6luvc' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/h7a0haa4da8sil3rr19ia6luvc/63320307209' />
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/h7a0haa4da8sil3rr19ia6luvc/comments' />
+ </gd:comments>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed' />
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default' />
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque' />
+ <gd:when startTime='2007-03-14' endTime='2007-03-15' />
+ <gd:where />
+ </entry>
+</feed>
+"""
+
+CALENDAR_BATCH_REQUEST = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:batch='http://schemas.google.com/gdata/batch'
+ xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <entry>
+ <batch:id>1</batch:id>
+ <batch:operation type='insert' />
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event inserted via batch</title>
+ </entry>
+ <entry>
+ <batch:id>2</batch:id>
+ <batch:operation type='query' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/glcs0kv2qqa0gf52qi1jo018gc</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event queried via batch</title>
+ </entry>
+ <entry>
+ <batch:id>3</batch:id>
+ <batch:operation type='update' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event updated via batch</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=dWptMGdvNWR0bmdka3I2dTkxZGNxdmowcXMgaGFyaXNodi50ZXN0QG0' title='alternate' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs/63326098791' />
+ </entry>
+ <entry>
+ <batch:id>4</batch:id>
+ <batch:operation type='delete' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/d8qbg9egk1n6lhsgq1sjbqffqc</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event deleted via batch</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=ZDhxYmc5ZWdrMW42bGhzZ3Exc2picWZmcWMgaGFyaXNodi50ZXN0QG0' title='alternate' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/d8qbg9egk1n6lhsgq1sjbqffqc' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/d8qbg9egk1n6lhsgq1sjbqffqc/63326018324' />
+ </entry>
+</feed>
+"""
+
+CALENDAR_BATCH_RESPONSE = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:batch='http://schemas.google.com/gdata/batch'
+ xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <id>http://www.google.com/calendar/feeds/default/private/full</id>
+ <updated>2007-09-21T23:01:00.380Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Batch Feed</title>
+ <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full' />
+ <link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full' />
+ <link rel='http://schemas.google.com/g/2005#batch' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/batch' />
+ <entry>
+ <batch:id>1</batch:id>
+ <batch:status code='201' reason='Created' />
+ <batch:operation type='insert' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/n9ug78gd9tv53ppn4hdjvk68ek</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event inserted via batch</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=bjl1Zzc4Z2Q5dHY1M3BwbjRoZGp2azY4ZWsgaGFyaXNodi50ZXN0QG0' title='alternate' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/n9ug78gd9tv53ppn4hdjvk68ek' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/n9ug78gd9tv53ppn4hdjvk68ek/63326098860' />
+ </entry>
+ <entry>
+ <batch:id>2</batch:id>
+ <batch:status code='200' reason='Success' />
+ <batch:operation type='query' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/glsc0kv2aqa0ff52qi1jo018gc</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event queried via batch</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=Z2xzYzBrdjJhcWEwZmY1MnFpMWpvMDE4Z2MgaGFyaXNodi50ZXN0QG0' title='alternate' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/glsc0kv2aqa0ff52qi1jo018gc' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/glsc0kv2aqa0ff52qi1jo018gc/63326098791' />
+ </entry>
+ <entry xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <batch:id>3</batch:id>
+ <batch:status code='200' reason='Success' />
+ <batch:operation type='update' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event updated via batch</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=dWptMGdvNWR0bmdka3I2dTkxZGNxdmowcXMgaGFyaXNodi50ZXN0QG0' title='alternate' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs/63326098860' />
+ <batch:id>3</batch:id>
+ <batch:status code='200' reason='Success' />
+ <batch:operation type='update' />
+ </entry>
+ <entry>
+ <batch:id>4</batch:id>
+ <batch:status code='200' reason='Success' />
+ <batch:operation type='delete' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/d8qbg9egk1n6lhsgq1sjbqffqc</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event deleted via batch</title>
+ <content type='text'>Deleted</content>
+ </entry>
+</feed>
+"""
+
+GBASE_ATTRIBUTE_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+ <feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gm='http://base.google.com/ns-metadata/1.0'>
+ <id>http://www.google.com/base/feeds/attributes</id>
+ <updated>2006-11-01T20:35:59.578Z</updated>
+ <category scheme='http://base.google.com/categories/itemtypes' term='online jobs'></category>
+ <category scheme='http://base.google.com/categories/itemtypes' term='jobs'></category>
+ <title type='text'>Attribute histogram for query: [item type:jobs]</title>
+ <link rel='alternate' type='text/html' href='http://base.google.com'></link>
+ <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://www.google.com/base/feeds
+/attributes'></link>
+ <link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/attributes/-/jobs'></link>
+ <generator version='1.0' uri='http://base.google.com'>GoogleBase</generator>
+ <openSearch:totalResults>16</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>16</openSearch:itemsPerPage>
+ <entry>
+ <id>http://www.google.com/base/feeds/attributes/job+industry%28text%29N%5Bitem+type%3Ajobs%5D</id>
+ <updated>2006-11-01T20:36:00.100Z</updated>
+ <title type='text'>job industry(text)</title>
+ <content type='text'>Attribute"job industry" of type text.
+ </content>
+ <link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/attributes/job+industry%28text
+%29N%5Bitem+type%3Ajobs%5D'></link>
+ <gm:attribute name='job industry' type='text' count='4416629'>
+ <gm:value count='380772'>it internet</gm:value>
+ <gm:value count='261565'>healthcare</gm:value>
+ <gm:value count='142018'>information technology</gm:value>
+ <gm:value count='124622'>accounting</gm:value>
+ <gm:value count='111311'>clerical and administrative</gm:value>
+ <gm:value count='82928'>other</gm:value>
+ <gm:value count='77620'>sales and sales management</gm:value>
+ <gm:value count='68764'>information systems</gm:value>
+ <gm:value count='65859'>engineering and architecture</gm:value>
+ <gm:value count='64757'>sales</gm:value>
+ </gm:attribute>
+ </entry>
+ </feed>
+"""
+
+
+GBASE_ATTRIBUTE_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+ <entry xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gm='http://base.google.com/ns-metadata/1.0'>
+ <id>http://www.google.com/base/feeds/attributes/job+industry%28text%29N%5Bitem+type%3Ajobs%5D</id>
+ <updated>2006-11-01T20:36:00.100Z</updated>
+ <title type='text'>job industry(text)</title>
+ <content type='text'>Attribute"job industry" of type text.
+ </content>
+ <link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/attributes/job+industry%28text%29N%5Bitem+type%3Ajobs%5D'></link>
+ <gm:attribute name='job industry' type='text' count='4416629'>
+ <gm:value count='380772'>it internet</gm:value>
+ <gm:value count='261565'>healthcare</gm:value>
+ <gm:value count='142018'>information technology</gm:value>
+ <gm:value count='124622'>accounting</gm:value>
+ <gm:value count='111311'>clerical and administrative</gm:value>
+ <gm:value count='82928'>other</gm:value>
+ <gm:value count='77620'>sales and sales management</gm:value>
+ <gm:value count='68764'>information systems</gm:value>
+ <gm:value count='65859'>engineering and architecture</gm:value>
+ <gm:value count='64757'>sales</gm:value>
+ </gm:attribute>
+ </entry>
+"""
+
+GBASE_LOCALES_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+ xmlns:gm='http://base.google.com/ns-metadata/1.0'>
+ <id> http://www.google.com/base/feeds/locales/</id>
+ <updated>2006-06-13T18:11:40.120Z</updated>
+ <title type="text">Locales</title>
+ <link rel="alternate" type="text/html" href="http://base.google.com"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml"
+
+ href="http://www.google.com/base/feeds/locales/"/>
+ <link rel="self" type="application/atom+xml" href="http://www.google.com/base/feeds/locales/"/>
+ <author>
+ <name>Google Inc.</name>
+ <email>base@google.com</email>
+ </author>
+ <generator version="1.0" uri="http://base.google.com">GoogleBase</generator>
+ <openSearch:totalResults>3</openSearch:totalResults>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+
+<entry>
+ <id>http://www.google.com/base/feeds/locales/en_US</id>
+ <updated>2006-03-27T22:27:36.658Z</updated>
+ <category scheme="http://base.google.com/categories/locales" term="en_US"/>
+
+ <title type="text">en_US</title>
+ <content type="text">en_US</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/locales/en_US"></link>
+
+ <link rel="related" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/itemtypes/en_US" title="Item types in en_US"/>
+</entry>
+<entry>
+ <id>http://www.google.com/base/feeds/locales/en_GB</id>
+ <updated>2006-06-13T18:14:18.601Z</updated>
+ <category scheme="http://base.google.com/categories/locales" term="en_GB"/>
+ <title type="text">en_GB</title>
+ <content type="text">en_GB</content>
+ <link rel="related" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/itemtypes/en_GB" title="Item types in en_GB"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/locales/en_GB"/>
+</entry>
+<entry>
+ <id>http://www.google.com/base/feeds/locales/de_DE</id>
+ <updated>2006-06-13T18:14:18.601Z</updated>
+ <category scheme="http://base.google.com/categories/locales" term="de_DE"/>
+ <title type="text">de_DE</title>
+ <content type="text">de_DE</content>
+ <link rel="related" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/itemtypes/de_DE" title="Item types in de_DE"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/locales/de_DE"/>
+</entry>
+</feed>"""
+
+GBASE_STRING_ENCODING_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom' xmlns:gm='http://base.google.com/ns-metadata/1.0'
+ xmlns:g='http://base.google.com/ns/1.0' xmlns:batch='http://schemas.google.com/gdata/batch'>
+ <id>http://www.google.com/base/feeds/snippets/17495780256183230088</id>
+ <published>2007-12-09T03:13:07.000Z</published>
+ <updated>2008-01-07T03:26:46.000Z</updated>
+ <category scheme='http://base.google.com/categories/itemtypes' term='Products'/>
+ <title type='text'>Digital Camera Cord Fits SONY Cybershot DSC-R1 S40</title>
+ <content type='html'>SONY \xC2\xB7 Cybershot Digital Camera Usb Cable DESCRIPTION
+ This is a 2.5 USB 2.0 A to Mini B (5 Pin) high quality digital camera
+ cable used for connecting your Sony Digital Cameras and Camcoders. Backward
+ Compatible with USB 2.0, 1.0 and 1.1. Fully ...</content>
+ <link rel='alternate' type='text/html'
+ href='http://adfarm.mediaplex.com/ad/ck/711-5256-8196-2?loc=http%3A%2F%2Fcgi.ebay.com%2FDigital-Camera-Cord-Fits-SONY-Cybershot-DSC-R1-S40_W0QQitemZ270195049057QQcmdZViewItem'/>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/base/feeds/snippets/17495780256183230088'/>
+ <author>
+ <name>eBay</name>
+ </author>
+ <g:item_type type='text'>Products</g:item_type>
+ <g:item_language type='text'>EN</g:item_language>
+ <g:target_country type='text'>US</g:target_country>
+ <g:price type='floatUnit'>0.99 usd</g:price>
+ <g:image_link type='url'>http://thumbs.ebaystatic.com/pict/270195049057_1.jpg</g:image_link>
+ <g:category type='text'>Cameras & Photo>Digital Camera Accessories>Cables</g:category>
+ <g:category type='text'>Cords & Connectors>USB Cables>For Other Brands</g:category>
+ <g:customer_id type='int'>11729</g:customer_id>
+ <g:id type='text'>270195049057</g:id>
+ <g:expiration_date type='dateTime'>2008-02-06T03:26:46Z</g:expiration_date>
+</entry>"""
+
+
+RECURRENCE_EXCEPTION_ENTRY = """<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:gd='http://schemas.google.com/g/2005'
+xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/composite/i7lgfj69mjqjgnodklif3vbm7g</id>
+ <published>2007-04-05T21:51:49.000Z</published>
+ <updated>2007-04-05T21:51:49.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>testDavid</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=aTdsZ2ZqNjltanFqZ25vZGtsaWYzdmJtN2dfMjAwNzA0MDNUMTgwMDAwWiBnZGF0YS5vcHMudGVzdEBt'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/composite/i7lgfj69mjqjgnodklif3vbm7g'>
+ </link>
+ <author>
+ <name>gdata ops</name>
+ <email>gdata.ops.test@gmail.com</email>
+ </author>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gCal:sendEventNotifications value='true'>
+ </gCal:sendEventNotifications>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:recurrence>DTSTART;TZID=America/Anchorage:20070403T100000
+ DTEND;TZID=America/Anchorage:20070403T110000
+ RRULE:FREQ=DAILY;UNTIL=20070408T180000Z;WKST=SU
+ EXDATE;TZID=America/Anchorage:20070407T100000
+ EXDATE;TZID=America/Anchorage:20070405T100000
+ EXDATE;TZID=America/Anchorage:20070404T100000 BEGIN:VTIMEZONE
+ TZID:America/Anchorage X-LIC-LOCATION:America/Anchorage
+ BEGIN:STANDARD TZOFFSETFROM:-0800 TZOFFSETTO:-0900 TZNAME:AKST
+ DTSTART:19701025T020000 RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU
+ END:STANDARD BEGIN:DAYLIGHT TZOFFSETFROM:-0900 TZOFFSETTO:-0800
+ TZNAME:AKDT DTSTART:19700405T020000
+ RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=1SU END:DAYLIGHT
+ END:VTIMEZONE</gd:recurrence>
+ <gd:where valueString=''></gd:where>
+ <gd:reminder minutes='10'></gd:reminder>
+ <gd:recurrenceException specialized='true'>
+ <gd:entryLink>
+ <entry>
+ <id>i7lgfj69mjqjgnodklif3vbm7g_20070407T180000Z</id>
+ <published>2007-04-05T21:51:49.000Z</published>
+ <updated>2007-04-05T21:52:58.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>testDavid</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=aTdsZ2ZqNjltanFqZ25vZGtsaWYzdmJtN2dfMjAwNzA0MDdUMTgwMDAwWiBnZGF0YS5vcHMudGVzdEBt'
+ title='alternate'></link>
+ <author>
+ <name>gdata ops</name>
+ <email>gdata.ops.test@gmail.com</email>
+ </author>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:originalEvent id='i7lgfj69mjqjgnodklif3vbm7g'
+ href='http://www.google.com/calendar/feeds/default/private/composite/i7lgfj69mjqjgnodklif3vbm7g'>
+
+ <gd:when startTime='2007-04-07T13:00:00.000-05:00'>
+ </gd:when>
+ </gd:originalEvent>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.canceled'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/i7lgfj69mjqjgnodklif3vbm7g_20070407T180000Z/comments'>
+
+ <feed>
+ <updated>2007-04-05T21:54:09.285Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#message'>
+ </category>
+ <title type='text'>Comments for: testDavid</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/feeds/default/private/full/i7lgfj69mjqjgnodklif3vbm7g_20070407T180000Z/comments'
+ title='alternate'></link>
+ </feed>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:when startTime='2007-04-07T13:00:00.000-05:00'
+ endTime='2007-04-07T14:00:00.000-05:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where valueString=''></gd:where>
+ </entry>
+ </gd:entryLink>
+ </gd:recurrenceException>
+ </entry>"""
+
+NICK_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>https://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo</atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname'/>
+ <atom:title type="text">Foo</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo"/>
+ <apps:nickname name="Foo"/>
+ <apps:login userName="TestUser"/>
+</atom:entry>"""
+
+NICK_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:feed xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:apps="http://schemas.google.com/apps/2006">
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/nickname/2.0
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname'/>
+ <atom:title type="text">Nicknames for user SusanJones</atom:title>
+ <atom:link rel='http://schemas.google.com/g/2005#feed'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0"/>
+ <atom:link rel='http://schemas.google.com/g/2005#post'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0"/>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0?username=TestUser"/>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>2</openSearch:itemsPerPage>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo
+ </atom:id>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname'/>
+ <atom:title type="text">Foo</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo"/>
+ <apps:nickname name="Foo"/>
+ <apps:login userName="TestUser"/>
+ </atom:entry>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/suse
+ </atom:id>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname'/>
+ <atom:title type="text">suse</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Bar"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Bar"/>
+ <apps:nickname name="Bar"/>
+ <apps:login userName="TestUser"/>
+ </atom:entry>
+</atom:feed>"""
+
+USER_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>https://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser</atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#user'/>
+ <atom:title type="text">TestUser</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser"/>
+ <apps:login userName="TestUser" password="password" suspended="false"
+ ipWhitelisted='false' hashFunctionName="SHA-1"/>
+ <apps:name familyName="Test" givenName="User"/>
+ <apps:quota limit="1024"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames'
+ href="https://apps-apis.google.com/a/feeds/example.com/nickname/2.0?username=Test-3121"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists'
+ href="https://apps-apis.google.com/a/feeds/example.com/emailList/2.0?recipient=testlist@example.com"/>
+</atom:entry>"""
+
+USER_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:feed xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/user/2.0
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#user'/>
+ <atom:title type="text">Users</atom:title>
+ <atom:link rel="next" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0?startUsername=john"/>
+ <atom:link rel='http://schemas.google.com/g/2005#feed'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0"/>
+ <atom:link rel='http://schemas.google.com/g/2005#post'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0"/>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0"/>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser
+ </atom:id>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#user'/>
+ <atom:title type="text">TestUser</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser"/>
+ <gd:who rel='http://schemas.google.com/apps/2006#user.recipient'
+ email="TestUser@example.com"/>
+ <apps:login userName="TestUser" suspended="false"/>
+ <apps:quota limit="2048"/>
+ <apps:name familyName="Test" givenName="User"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames'
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0?username=TestUser"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists'
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0?recipient=TestUser@example.com"/>
+ </atom:entry>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/user/2.0/JohnSmith
+ </atom:id>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#user'/>
+ <atom:title type="text">JohnSmith</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0/JohnSmith"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0/JohnSmith"/>
+ <gd:who rel='http://schemas.google.com/apps/2006#user.recipient'
+ email="JohnSmith@example.com"/>
+ <apps:login userName="JohnSmith" suspended="false"/>
+ <apps:quota limit="2048"/>
+ <apps:name familyName="Smith" givenName="John"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames'
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0?username=JohnSmith"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists'
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0?recipient=JohnSmith@example.com"/>
+ </atom:entry>
+</atom:feed>"""
+
+EMAIL_LIST_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>
+ https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/testlist
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList'/>
+ <atom:title type="text">testlist</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/testlist"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/testlist"/>
+ <apps:emailList name="testlist"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients'
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/testlist/recipient/"/>
+</atom:entry>"""
+
+EMAIL_LIST_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:feed xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList'/>
+ <atom:title type="text">EmailLists</atom:title>
+ <atom:link rel="next" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0?startEmailListName=john"/>
+ <atom:link rel='http://schemas.google.com/g/2005#feed'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0"/>
+ <atom:link rel='http://schemas.google.com/g/2005#post'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0"/>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0"/>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList'/>
+ <atom:title type="text">us-sales</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales"/>
+ <apps:emailList name="us-sales"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients'
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/"/>
+ </atom:entry>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-eng
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList'/>
+ <atom:title type="text">us-eng</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-eng"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-eng"/>
+ <apps:emailList name="us-eng"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients'
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-eng/recipient/"/>
+ </atom:entry>
+</atom:feed>"""
+
+EMAIL_LIST_RECIPIENT_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/TestUser%40example.com</atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList.recipient'/>
+ <atom:title type="text">TestUser</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/TestUser%40example.com"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/TestUser%40example.com"/>
+ <gd:who email="TestUser@example.com"/>
+</atom:entry>"""
+
+EMAIL_LIST_RECIPIENT_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:feed xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList.recipient'/>
+ <atom:title type="text">Recipients for email list us-sales</atom:title>
+ <atom:link rel="next" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/?startRecipient=terry@example.com"/>
+ <atom:link rel='http://schemas.google.com/g/2005#feed'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient"/>
+ <atom:link rel='http://schemas.google.com/g/2005#post'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient"/>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient"/>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/joe%40example.com
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList.recipient'/>
+ <atom:title type="text">joe@example.com</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/joe%40example.com"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/joe%40example.com"/>
+ <gd:who email="joe@example.com"/>
+ </atom:entry>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/susan%40example.com
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList.recipient'/>
+ <atom:title type="text">susan@example.com</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/susan%40example.com"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/susan%40example.com"/>
+ <gd:who email="susan@example.com"/>
+ </atom:entry>
+</atom:feed>"""
+
+ACL_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+ <feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+ xmlns:gAcl='http://schemas.google.com/acl/2007'>
+ <id>http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full</id>
+ <updated>2007-04-21T00:52:04.000Z</updated>
+ <title type='text'>Elizabeth Bennet's access control list</title>
+ <link rel='http://schemas.google.com/acl/2007#controlledObject'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/private/full'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full'>
+ </link>
+ <generator version='1.0'
+ uri='http://www.google.com/calendar'>Google Calendar</generator>
+ <openSearch:totalResults>2</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com</id>
+ <updated>2007-04-21T00:52:04.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'>
+ </category>
+ <title type='text'>owner</title>
+ <content type='text'></content>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <gAcl:scope type='user' value='liz@gmail.com'></gAcl:scope>
+ <gAcl:role value='http://schemas.google.com/gCal/2005#owner'>
+ </gAcl:role>
+ </entry>
+ <entry>
+ <id>http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/default</id>
+ <updated>2007-04-21T00:52:04.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'>
+ </category>
+ <title type='text'>read</title>
+ <content type='text'></content>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/default'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/default'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <gAcl:scope type='default'></gAcl:scope>
+ <gAcl:role value='http://schemas.google.com/gCal/2005#read'>
+ </gAcl:role>
+ </entry>
+ </feed>"""
+
+ACL_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+ <entry xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gd='http://schemas.google.com/g/2005' xmlns:gCal='http://schemas.google.com/gCal/2005' xmlns:gAcl='http://schemas.google.com/acl/2007'>
+ <id>http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com</id>
+ <updated>2007-04-21T00:52:04.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'>
+ </category>
+ <title type='text'>owner</title>
+ <content type='text'></content>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <gAcl:scope type='user' value='liz@gmail.com'></gAcl:scope>
+ <gAcl:role value='http://schemas.google.com/gCal/2005#owner'>
+ </gAcl:role>
+ </entry>"""
+
+DOCUMENT_LIST_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<ns0:feed xmlns:ns0="http://www.w3.org/2005/Atom" xmlns:ns2="http://schemas.google.com/g/2005" xmlns:ns3="http://schemas.google.com/docs/2007"><ns1:totalResults
+xmlns:ns1="http://a9.com/-/spec/opensearchrss/1.0/">2</ns1:totalResults><ns1:startIndex
+xmlns:ns1="http://a9.com/-/spec/opensearchrss/1.0/">1</ns1:startIndex><ns0:entry><ns0:content
+src="https://foo.com/fm?fmcmd=102&key=supercalifragilisticexpeadocious"
+type="text/html"
+/><ns0:author><ns0:name>test.user</ns0:name><ns0:email>test.user@gmail.com</ns0:email></ns0:author><ns0:category
+label="spreadsheet" scheme="http://schemas.google.com/g/2005#kind"
+term="http://schemas.google.com/docs/2007#spreadsheet"
+/><ns0:id>https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpeadocious</ns0:id><ns0:link
+href="https://foo.com/ccc?key=supercalifragilisticexpeadocious" rel="alternate"
+type="text/html" /><ns0:link
+href="https://foo.com/feeds/worksheets/supercalifragilisticexpeadocious/private/full"
+rel="http://schemas.google.com/spreadsheets/2006#worksheetsfeed"
+type="application/atom+xml" /><ns0:link
+href="https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpeadocious"
+rel="self" type="application/atom+xml" /><ns0:title type="text">Test Spreadsheet</ns0:title><ns0:updated>2007-07-03T18:03:32.045Z</ns0:updated>
+<ns2:feedLink href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3Afoofoofoo" rel="http://schemas.google.com/acl/2007#accessControlList"/>
+<ns2:resourceId>document:dfrkj84g_3348jbxpxcd</ns2:resourceId>
+<ns2:lastModifiedBy>
+ <ns0:name>test.user</ns0:name>
+ <ns0:email>test.user@gmail.com</ns0:email>
+</ns2:lastModifiedBy>
+<ns2:lastViewed>2009-03-05T07:48:21.493Z</ns2:lastViewed>
+<ns3:writersCanInvite value='true'/>
+</ns0:entry><ns0:entry><ns0:content
+src="http://docs.google.com/RawDocContents?action=fetch&docID=gr00vy"
+type="text/html"
+/><ns0:author><ns0:name>test.user</ns0:name><ns0:email>test.user@gmail.com</ns0:email></ns0:author><ns0:category
+label="document" scheme="http://schemas.google.com/g/2005#kind"
+term="http://schemas.google.com/docs/2007#document"
+/><ns0:id>http://docs.google.com/feeds/documents/private/full/document%3Agr00vy</ns0:id><ns0:link
+href="http://foobar.com/Doc?id=gr00vy" rel="alternate" type="text/html"
+/><ns0:link
+href="http://docs.google.com/feeds/documents/private/full/document%3Agr00vy"
+rel="self" type="application/atom+xml" /><ns0:title type="text">Test Document</ns0:title><ns0:updated>2007-07-03T18:02:50.338Z</ns0:updated>
+<ns2:feedLink href="http://docs.google.com/feeds/acl/private/full/document%3Afoofoofoo" rel="http://schemas.google.com/acl/2007#accessControlList"/>
+<ns2:lastModifiedBy>
+ <ns0:name>test.user</ns0:name>
+ <ns0:email>test.user@gmail.com</ns0:email>
+</ns2:lastModifiedBy>
+<ns3:writersCanInvite value='false'/>
+ <ns2:lastViewed>2009-03-05T07:48:21.493Z</ns2:lastViewed>
+</ns0:entry><ns0:id>http://docs.google.com/feeds/documents/private/full</ns0:id><ns0:link
+href="http://docs.google.com" rel="alternate" type="text/html" /><ns0:link
+href="http://docs.google.com/feeds/documents/private/full"
+rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml"
+/><ns0:link href="http://docs.google.com/feeds/documents/private/full"
+rel="http://schemas.google.com/g/2005#post" type="application/atom+xml"
+/><ns0:link href="http://docs.google.com/feeds/documents/private/full"
+rel="self" type="application/atom+xml" /><ns0:title type="text">Available
+Documents -
+test.user@gmail.com</ns0:title><ns0:updated>2007-07-09T23:07:21.898Z</ns0:updated>
+</ns0:feed>
+"""
+
+DOCUMENT_LIST_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<ns0:entry xmlns:ns0="http://www.w3.org/2005/Atom" xmlns:ns1="http://schemas.google.com/g/2005" xmlns:ns2="http://schemas.google.com/docs/2007"><ns0:content
+src="https://foo.com/fm?fmcmd=102&key=supercalifragilisticexpealidocious" type="text/html"/>
+<ns0:author><ns0:name>test.user</ns0:name><ns0:email>test.user@gmail.com</ns0:email></ns0:author>
+<ns0:category label="spreadsheet" scheme="http://schemas.google.com/g/2005#kind"
+term="http://schemas.google.com/docs/2007#spreadsheet"
+/><ns0:id>https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpealidocious</ns0:id>
+<ns0:link href="https://foo.com/ccc?key=supercalifragilisticexpealidocious"
+rel="alternate" type="text/html" /><ns0:link
+href="https://foo.com/feeds/worksheets/supercalifragilisticexpealidocious/private/full"
+rel="http://schemas.google.com/spreadsheets/2006#worksheetsfeed"
+type="application/atom+xml" /><ns0:link
+href="https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpealidocious"
+rel="self" type="application/atom+xml" />
+<ns0:title type="text">Test Spreadsheet</ns0:title><ns0:updated>2007-07-03T18:03:32.045Z</ns0:updated>
+<ns1:resourceId>spreadsheet:supercalifragilisticexpealidocious</ns1:resourceId>
+<ns1:lastModifiedBy>
+ <ns0:name>test.user</ns0:name>
+ <ns0:email>test.user@gmail.com</ns0:email>
+</ns1:lastModifiedBy>
+<ns1:lastViewed>2009-03-05T07:48:21.493Z</ns1:lastViewed>
+<ns2:writersCanInvite value='true'/>
+</ns0:entry>
+"""
+
+DOCUMENT_LIST_ENTRY_V3 = """<?xml version='1.0' encoding='UTF-8'?>
+<ns0:entry xmlns:ns0="http://www.w3.org/2005/Atom" xmlns:ns1="http://schemas.google.com/g/2005" xmlns:ns2="http://schemas.google.com/docs/2007"><ns0:content
+src="https://foo.com/fm?fmcmd=102&key=supercalifragilisticexpealidocious" type="text/html"/>
+<ns0:author><ns0:name>test.user</ns0:name><ns0:email>test.user@gmail.com</ns0:email></ns0:author>
+<ns0:category label="spreadsheet" scheme="http://schemas.google.com/g/2005#kind"
+term="http://schemas.google.com/docs/2007#spreadsheet"
+/><ns0:id>https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpealidocious</ns0:id>
+<ns0:link href="https://foo.com/ccc?key=supercalifragilisticexpealidocious"
+rel="alternate" type="text/html" /><ns0:link
+href="https://foo.com/feeds/worksheets/supercalifragilisticexpealidocious/private/full"
+rel="http://schemas.google.com/spreadsheets/2006#worksheetsfeed"
+type="application/atom+xml" /><ns0:link
+href="https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpealidocious"
+rel="self" type="application/atom+xml" />
+<ns0:link rel="http://schemas.google.com/docs/2007#parent" type="application/atom+xml"
+href="http://docs.google.com/feeds/default/private/full/folder%3A12345" title="AFolderName" />
+<ns0:title type="text">Test Spreadsheet</ns0:title><ns0:updated>2007-07-03T18:03:32.045Z</ns0:updated>
+<ns1:resourceId>spreadsheet:supercalifragilisticexpealidocious</ns1:resourceId>
+<ns1:lastModifiedBy>
+ <ns0:name>test.user</ns0:name>
+ <ns0:email>test.user@gmail.com</ns0:email>
+</ns1:lastModifiedBy>
+<ns1:lastViewed>2009-03-05T07:48:21.493Z</ns1:lastViewed>
+<ns2:writersCanInvite value='true'/>
+<ns1:quotaBytesUsed>1000</ns1:quotaBytesUsed>
+<ns1:feedLink rel="http://schemas.google.com/acl/2007#accessControlList" href="https://docs.google.com/feeds/default/private/full/spreadsheet%3Asupercalifragilisticexpealidocious/acl" />
+<ns1:feedLink rel="http://schemas.google.com/docs/2007/revisions" href="https://docs.google.com/feeds/default/private/full/spreadsheet%3Asupercalifragilisticexpealidocious/revisions" />
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#starred" label="starred"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#viewed" label="viewed"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#hidden" label="hidden"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#trashed" label="trashed"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#mine" label="mine"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#private" label="private"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#shared-with-domain" label="shared-with-domain"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#restricted-download" label="restricted-download"/>
+</ns0:entry>
+"""
+
+DOCUMENT_LIST_ACL_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gAcl='http://schemas.google.com/acl/2007'>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'/>
+ <gAcl:role value='writer'/>
+ <gAcl:scope type='user' value='user@gmail.com'/>
+</entry>"""
+
+
+DOCUMENT_LIST_ACL_WITHKEY_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gAcl='http://schemas.google.com/acl/2007'>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'/>
+ <gAcl:withKey key='somekey'><gAcl:role value='writer' /></gAcl:withKey>
+ <gAcl:scope type='domain' value='example.com' />
+</entry>"""
+
+
+DOCUMENT_LIST_ACL_ADDITIONAL_ROLE_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gAcl='http://schemas.google.com/acl/2007'>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'/>
+ <gAcl:additionalRole value='commenter' />
+ <gAcl:withKey key='somekey'>
+ <gAcl:role value='writer' />
+ <gAcl:additionalRole value='commenter' />
+ </gAcl:withKey>
+ <gAcl:scope type='domain' value='example.com' />
+</entry>"""
+
+
+DOCUMENT_LIST_ACL_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gAcl="http://schemas.google.com/acl/2007"
+ xmlns:batch="http://schemas.google.com/gdata/batch">
+<id>http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZpwUQ</id>
+<updated>2009-02-22T03:48:25.895Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/>
+<title type="text">Document Permissions</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZpwUQ"/>
+<link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZpwUQ"/>
+<link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZpwUQ/batch"/>
+<link rel="self" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZpwUQ"/>
+<openSearch:totalResults>2</openSearch:totalResults>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+ <id>http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQp4pwUwUQ/user%3Auser%40gmail.com</id>
+ <updated>2009-02-22T03:48:25.896Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/>
+ <title type="text">Document Permission - user@gmail.com</title>
+ <link rel="self" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQp4pwUwUQ/user%3Auser%40gmail.com"/>
+ <link rel="edit" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQp4pwUwUQ/user%3Auser%40gmail.com"/>
+ <gAcl:role value="owner"/>
+ <gAcl:scope type="user" value="user@gmail.com"/>
+</entry>
+<entry>
+ <id>http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8fCgZp4pwUwUQ/user%3Auser2%40google.com</id>
+ <updated>2009-02-22T03:48:26.257Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/>
+ <title type="text">Document Permission - user2@google.com</title>
+ <link rel="self" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZp4pwUwUQ/user%3Auser2%40google.com"/>
+ <link rel="edit" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZp4pwUwUQ/user%3Auser2%40google.com"/>
+ <gAcl:role value="writer"/>
+ <gAcl:scope type="domain" value="google.com"/>
+</entry>
+</feed>"""
+
+DOCUMENT_LIST_REVISION_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
+ xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005"
+ xmlns:docs="http://schemas.google.com/docs/2007"
+ gd:etag="W/"CE4HQX08cCt7ImA9WxNTFEU."">
+<id>https://docs.google.com/feeds/default/private/full/resource_id/revisions</id>
+<updated>2009-08-17T04:22:10.378Z</updated>
+<title>Document Revisions</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml"
+ href="https://docs.google.com/feeds/default/private/full/resource_id/revisions"/>
+<link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml"
+ href="https://docs.google.com/feeds/default/private/full/resource_id/revisions/batch"/>
+<link rel="self" type="application/atom+xml"
+ href="https://docs.google.com/feeds/default/private/full/resource_id/revisions"/>
+<openSearch:totalResults>6</openSearch:totalResults>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+ <id>https://docs.google.com/feeds/id/resource_id/revisions/2</id>
+ <updated>2009-08-17T04:22:10.440Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-08-14T07:11:34.197Z</app:edited>
+ <title>Revision 2</title>
+ <content type="text/html" src="https://docs.google.com/feeds/download/documents/Export?docId=doc_id&revision=2"/>
+ <link rel="alternate" type="text/html"
+ href="https://docs.google.com/Doc?id=doc_id&revision=2"/>
+ <link rel="self" type="application/atom+xml"
+ href="https://docs.google.com/feeds/default/private/full/resource_id/revisions/2"/>
+ <link rel='http://schemas.google.com/docs/2007#publish' type='text/html' href='https://docs.google.com/View?docid=dfr4&pageview=1&hgd=1'/>
+ <author>
+ <name>another_user</name>
+ <email>another_user@gmail.com</email>
+ </author>
+ <docs:publish value="true"/>
+ <docs:publishAuto value="true"/>
+ <docs:publishOutsideDomain value="false"/>
+</entry>
+</feed>
+"""
+
+DOCUMENT_LIST_METADATA = """
+<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:docs="http://schemas.google.com/docs/2007"
+ xmlns:gd="http://schemas.google.com/g/2005"
+ xmlns:gAcl="http://schemas.google.com/acl/2007"
+ gd:etag="W/"AkYNRnc_eSt7ImA9WxBUFks."">
+ <docs:additionalRoleInfo kind='document'>
+ <docs:additionalRoleSet primaryRole='reader'>
+ <gAcl:additionalRole value='commenter' />
+ </docs:additionalRoleSet>
+ </docs:additionalRoleInfo>
+</entry>
+"""
+
+BATCH_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:batch="http://schemas.google.com/gdata/batch"
+ xmlns:g="http://base.google.com/ns/1.0">
+ <id>http://www.google.com/base/feeds/items/2173859253842813008</id>
+ <published>2006-07-11T14:51:43.560Z</published>
+ <updated>2006-07-11T14:51: 43.560Z</updated>
+ <title type="text">title</title>
+ <content type="html">content</content>
+ <link rel="self"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/2173859253842813008"/>
+ <link rel="edit"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/2173859253842813008"/>
+ <g:item_type>recipes</g:item_type>
+ <batch:operation type="insert"/>
+ <batch:id>itemB</batch:id>
+ <batch:status code="201" reason="Created"/>
+</entry>"""
+
+BATCH_FEED_REQUEST = """<?xml version="1.0" encoding="UTF-8"?>
+<feed
+ xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:g="http://base.google.com/ns/1.0"
+ xmlns:batch="http://schemas.google.com/gdata/batch">
+ <title type="text">My Batch Feed</title>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/13308004346459454600</id>
+ <batch:operation type="delete"/>
+ </entry>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/17437536661927313949</id>
+ <batch:operation type="delete"/>
+ </entry>
+ <entry>
+ <title type="text">...</title>
+ <content type="html">...</content>
+ <batch:id>itemA</batch:id>
+ <batch:operation type="insert"/>
+ <g:item_type>recipes</g:item_type>
+ </entry>
+ <entry>
+ <title type="text">...</title>
+ <content type="html">...</content>
+ <batch:id>itemB</batch:id>
+ <batch:operation type="insert"/>
+ <g:item_type>recipes</g:item_type>
+ </entry>
+</feed>"""
+
+BATCH_FEED_RESULT = """<?xml version="1.0" encoding="UTF-8"?>
+<feed
+ xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:g="http://base.google.com/ns/1.0"
+ xmlns:batch="http://schemas.google.com/gdata/batch">
+ <id>http://www.google.com/base/feeds/items</id>
+ <updated>2006-07-11T14:51:42.894Z</updated>
+ <title type="text">My Batch</title>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items"/>
+ <link rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items"/>
+ <link rel=" http://schemas.google.com/g/2005#batch"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/batch"/>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/2173859253842813008</id>
+ <published>2006-07-11T14:51:43.560Z</published>
+ <updated>2006-07-11T14:51: 43.560Z</updated>
+ <title type="text">...</title>
+ <content type="html">...</content>
+ <link rel="self"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/2173859253842813008"/>
+ <link rel="edit"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/2173859253842813008"/>
+ <g:item_type>recipes</g:item_type>
+ <batch:operation type="insert"/>
+ <batch:id>itemB</batch:id>
+ <batch:status code="201" reason="Created"/>
+ </entry>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/11974645606383737963</id>
+ <published>2006-07-11T14:51:43.247Z</published>
+ <updated>2006-07-11T14:51: 43.247Z</updated>
+ <title type="text">...</title>
+ <content type="html">...</content>
+ <link rel="self"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/11974645606383737963"/>
+ <link rel="edit"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/11974645606383737963"/>
+ <g:item_type>recipes</g:item_type>
+ <batch:operation type="insert"/>
+ <batch:id>itemA</batch:id>
+ <batch:status code="201" reason="Created"/>
+ </entry>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/13308004346459454600</id>
+ <updated>2006-07-11T14:51:42.894Z</updated>
+ <title type="text">Error</title>
+ <content type="text">Bad request</content>
+ <batch:status code="404"
+ reason="Bad request"
+ content-type="application/xml">
+ <errors>
+ <error type="request" reason="Cannot find item"/>
+ </errors>
+ </batch:status>
+ </entry>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/17437536661927313949</id>
+ <updated>2006-07-11T14:51:43.246Z</updated>
+ <content type="text">Deleted</content>
+ <batch:operation type="delete"/>
+ <batch:status code="200" reason="Success"/>
+ </entry>
+</feed>"""
+
+ALBUM_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:exif="http://schemas.google.com/photos/exif/2007" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#" xmlns:gml="http://www.opengis.net/gml" xmlns:georss="http://www.georss.org/georss" xmlns:photo="http://www.pheed.com/pheed/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gphoto="http://schemas.google.com/photos/2007">
+ <id>http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/1</id>
+ <updated>2007-09-21T18:23:05.000Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/photos/2007#album"/>
+ <title type="text">Test</title>
+ <subtitle type="text"/>
+ <rights type="text">public</rights>
+ <icon>http://lh6.google.com/sample.user/Rt8WNoDZEJE/AAAAAAAAABk/HQGlDhpIgWo/s160-c/Test.jpg</icon>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/1"/>
+ <link rel="alternate" type="text/html" href="http://picasaweb.google.com/sample.user/Test"/>
+ <link rel="http://schemas.google.com/photos/2007#slideshow" type="application/x-shockwave-flash" href="http://picasaweb.google.com/s/c/bin/slideshow.swf?host=picasaweb.google.com&RGB=0x000000&feed=http%3A%2F%2Fpicasaweb.google.com%2Fdata%2Ffeed%2Fapi%2Fuser%2Fsample.user%2Falbumid%2F1%3Falt%3Drss"/>
+ <link rel="self" type="application/atom+xml" href="http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/1?start-index=1&max-results=500&kind=photo%2Ctag"/>
+ <author>
+ <name>sample</name>
+ <uri>http://picasaweb.google.com/sample.user</uri>
+ </author>
+ <generator version="1.00" uri="http://picasaweb.google.com/">Picasaweb</generator> <openSearch:totalResults>4</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>500</openSearch:itemsPerPage>
+ <gphoto:id>1</gphoto:id>
+ <gphoto:name>Test</gphoto:name>
+ <gphoto:location/>
+ <gphoto:access>public</gphoto:access> <gphoto:timestamp>1188975600000</gphoto:timestamp>
+ <gphoto:numphotos>2</gphoto:numphotos>
+ <gphoto:user>sample.user</gphoto:user>
+ <gphoto:nickname>sample</gphoto:nickname>
+ <gphoto:commentingEnabled>true</gphoto:commentingEnabled>
+ <gphoto:commentCount>0</gphoto:commentCount>
+ <entry> <id>http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/photoid/2</id>
+ <published>2007-09-05T20:49:23.000Z</published>
+ <updated>2007-09-21T18:23:05.000Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/photos/2007#photo"/>
+ <title type="text">Aqua Blue.jpg</title>
+ <summary type="text">Blue</summary>
+ <content type="image/jpeg" src="http://lh4.google.com/sample.user/Rt8WU4DZEKI/AAAAAAAAABY/IVgLqmnzJII/Aqua%20Blue.jpg"/> <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/1/photoid/2"/>
+ <link rel="alternate" type="text/html" href="http://picasaweb.google.com/sample.user/Test/photo#2"/>
+ <link rel="self" type="application/atom+xml" href="http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/photoid/2"/>
+ <gphoto:id>2</gphoto:id>
+ <gphoto:version>1190398985145172</gphoto:version>
+ <gphoto:position>0.0</gphoto:position>
+ <gphoto:albumid>1</gphoto:albumid> <gphoto:width>2560</gphoto:width>
+ <gphoto:height>1600</gphoto:height>
+ <gphoto:size>883405</gphoto:size>
+ <gphoto:client/>
+ <gphoto:checksum/>
+ <gphoto:timestamp>1189025362000</gphoto:timestamp>
+ <exif:tags> <exif:flash>true</exif:flash>
+ <exif:imageUniqueID>c041ce17aaa637eb656c81d9cf526c24</exif:imageUniqueID>
+ </exif:tags>
+ <gphoto:commentingEnabled>true</gphoto:commentingEnabled>
+ <gphoto:commentCount>1</gphoto:commentCount>
+ <media:group>
+ <media:title type="plain">Aqua Blue.jpg</media:title> <media:description type="plain">Blue</media:description>
+ <media:keywords>tag, test</media:keywords>
+ <media:content url="http://lh4.google.com/sample.user/Rt8WU4DZEKI/AAAAAAAAABY/IVgLqmnzJII/Aqua%20Blue.jpg" height="1600" width="2560" type="image/jpeg" medium="image"/>
+ <media:thumbnail url="http://lh4.google.com/sample.user/Rt8WU4DZEKI/AAAAAAAAABY/IVgLqmnzJII/s72/Aqua%20Blue.jpg" height="45" width="72"/>
+ <media:thumbnail url="http://lh4.google.com/sample.user/Rt8WU4DZEKI/AAAAAAAAABY/IVgLqmnzJII/s144/Aqua%20Blue.jpg" height="90" width="144"/>
+ <media:thumbnail url="http://lh4.google.com/sample.user/Rt8WU4DZEKI/AAAAAAAAABY/IVgLqmnzJII/s288/Aqua%20Blue.jpg" height="180" width="288"/>
+ <media:credit>sample</media:credit>
+ </media:group>
+ </entry>
+ <entry>
+ <id>http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/photoid/3</id>
+ <published>2007-09-05T20:49:24.000Z</published>
+ <updated>2007-09-21T18:19:38.000Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/photos/2007#photo"/>
+ <title type="text">Aqua Graphite.jpg</title>
+ <summary type="text">Gray</summary>
+ <content type="image/jpeg" src="http://lh5.google.com/sample.user/Rt8WVIDZELI/AAAAAAAAABg/d7e0i7gvhNU/Aqua%20Graphite.jpg"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/1/photoid/3"/>
+ <link rel="alternate" type="text/html" href="http://picasaweb.google.com/sample.user/Test/photo#3"/>
+ <link rel="self" type="application/atom+xml" href="http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/photoid/3"/>
+ <gphoto:id>3</gphoto:id>
+ <gphoto:version>1190398778006402</gphoto:version>
+ <gphoto:position>1.0</gphoto:position>
+ <gphoto:albumid>1</gphoto:albumid>
+ <gphoto:width>2560</gphoto:width>
+ <gphoto:height>1600</gphoto:height>
+ <gphoto:size>798334</gphoto:size>
+ <gphoto:client/>
+ <gphoto:checksum/>
+ <gphoto:timestamp>1189025363000</gphoto:timestamp>
+ <exif:tags>
+ <exif:flash>true</exif:flash>
+ <exif:imageUniqueID>a5ce2e36b9df7d3cb081511c72e73926</exif:imageUniqueID>
+ </exif:tags>
+ <gphoto:commentingEnabled>true</gphoto:commentingEnabled>
+ <gphoto:commentCount>0</gphoto:commentCount>
+ <media:group>
+ <media:title type="plain">Aqua Graphite.jpg</media:title>
+ <media:description type="plain">Gray</media:description>
+ <media:keywords/>
+ <media:content url="http://lh5.google.com/sample.user/Rt8WVIDZELI/AAAAAAAAABg/d7e0i7gvhNU/Aqua%20Graphite.jpg" height="1600" width="2560" type="image/jpeg" medium="image"/>
+ <media:thumbnail url="http://lh5.google.com/sample.user/Rt8WVIDZELI/AAAAAAAAABg/d7e0i7gvhNU/s72/Aqua%20Graphite.jpg" height="45" width="72"/>
+ <media:thumbnail url="http://lh5.google.com/sample.user/Rt8WVIDZELI/AAAAAAAAABg/d7e0i7gvhNU/s144/Aqua%20Graphite.jpg" height="90" width="144"/>
+ <media:thumbnail url="http://lh5.google.com/sample.user/Rt8WVIDZELI/AAAAAAAAABg/d7e0i7gvhNU/s288/Aqua%20Graphite.jpg" height="180" width="288"/>
+ <media:credit>sample</media:credit>
+ </media:group>
+ </entry>
+ <entry>
+ <id>http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/tag/tag</id>
+ <updated>2007-09-05T20:49:24.000Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/photos/2007#tag"/>
+ <title type="text">tag</title>
+ <summary type="text">tag</summary>
+ <link rel="alternate" type="text/html" href="http://picasaweb.google.com/lh/searchbrowse?q=tag&psc=G&uname=sample.user&filter=0"/>
+ <link rel="self" type="application/atom+xml" href="http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/tag/tag"/>
+ <author>
+ <name>sample</name>
+ <uri>http://picasaweb.google.com/sample.user</uri>
+ </author>
+ </entry>
+ <entry>
+ <id>http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/tag/test</id>
+ <updated>2007-09-05T20:49:24.000Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/photos/2007#tag"/>
+ <title type="text">test</title>
+ <summary type="text">test</summary>
+ <link rel="alternate" type="text/html" href="http://picasaweb.google.com/lh/searchbrowse?q=test&psc=G&uname=sample.user&filter=0"/>
+ <link rel="self" type="application/atom+xml" href="http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/tag/test"/>
+ <author>
+ <name>sample</name>
+ <uri>http://picasaweb.google.com/sample.user</uri>
+ </author>
+ </entry>
+</feed>"""
+
+CODE_SEARCH_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:gcs="http://schemas.google.com/codesearch/2006" xml:base="http://www.google.com">
+<id>http://www.google.com/codesearch/feeds/search?q=malloc</id>
+<updated>2007-12-19T16:08:04Z</updated>
+<title type="text">Google Code Search</title>
+<generator version="1.0" uri="http://www.google.com/codesearch">Google Code Search</generator>
+<opensearch:totalResults>2530000</opensearch:totalResults>
+<opensearch:startIndex>1</opensearch:startIndex>
+<author>
+<name>Google Code Search</name>
+
+<uri>http://www.google.com/codesearch</uri>
+</author>
+<link rel="http://schemas.google.com/g/2006#feed" type="application/atom+xml" href="http://schemas.google.com/codesearch/2006"/>
+<link rel="self" type="application/atom+xml" href="http://www.google.com/codesearch/feeds/search?q=malloc"/>
+<link rel="next" type="application/atom+xml" href="http://www.google.com/codesearch/feeds/search?q=malloc&start-index=11"/>
+<link rel="alternate" type="text/html" href="http://www.google.com/codesearch?q=malloc"/>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:LDjwp-Iqc7U:84hEYaYsZk8:xDGReDhvNi0&sa=N&ct=rx&cd=1&cs_p=http://www.gnu.org&cs_f=software/autoconf/manual/autoconf-2.60/autoconf.html-002&cs_p=http://www.gnu.org&cs_f=software/autoconf/manual/autoconf-2.60/autoconf.html-002#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">software/autoconf/manual/autoconf-2.60/autoconf.html</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:LDjwp-Iqc7U:84hEYaYsZk8:xDGReDhvNi0&sa=N&ct=rx&cd=1&cs_p=http://www.gnu.org&cs_f=software/autoconf/manual/autoconf-2.60/autoconf.html-002&cs_p=http://www.gnu.org&cs_f=software/autoconf/manual/autoconf-2.60/autoconf.html-002#first"/><gcs:package name="http://www.gnu.org" uri="http://www.gnu.org"></gcs:package><gcs:file name="software/autoconf/manual/autoconf-2.60/autoconf.html-002"></gcs:file><content type="text/html"><pre> 8: void *<b>malloc</b> ();
+
+
+</pre></content><gcs:match lineNumber="4" type="text/html"><pre> #undef <b>malloc</b>
+</pre></gcs:match><gcs:match lineNumber="8" type="text/html"><pre> void *<b>malloc</b> ();
+
+</pre></gcs:match><gcs:match lineNumber="14" type="text/html"><pre> rpl_<b>malloc</b> (size_t n)
+</pre></gcs:match><gcs:match lineNumber="18" type="text/html"><pre> return <b>malloc</b> (n);
+
+</pre></gcs:match></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:h4hfh-fV-jI:niBq_bwWZNs:H0OhClf0HWQ&sa=N&ct=rx&cd=2&cs_p=ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz&cs_f=guile-1.6.8/libguile/mallocs.c&cs_p=ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz&cs_f=guile-1.6.8/libguile/mallocs.c#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">guile-1.6.8/libguile/mallocs.c</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:h4hfh-fV-jI:niBq_bwWZNs:H0OhClf0HWQ&sa=N&ct=rx&cd=2&cs_p=ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz&cs_f=guile-1.6.8/libguile/mallocs.c&cs_p=ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz&cs_f=guile-1.6.8/libguile/mallocs.c#first"/><gcs:package name="ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz" uri="ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz"></gcs:package><gcs:file name="guile-1.6.8/libguile/mallocs.c"></gcs:file><content type="text/html"><pre> 86: {
+ scm_t_bits mem = n ? (scm_t_bits) <b>malloc</b> (n) : 0;
+ if (n &amp;&amp; !mem)
+
+</pre></content><gcs:match lineNumber="54" type="text/html"><pre>#include &lt;<b>malloc</b>.h&gt;
+</pre></gcs:match><gcs:match lineNumber="62" type="text/html"><pre>scm_t_bits scm_tc16_<b>malloc</b>;
+
+</pre></gcs:match><gcs:match lineNumber="66" type="text/html"><pre><b>malloc</b>_free (SCM ptr)
+</pre></gcs:match><gcs:match lineNumber="75" type="text/html"><pre><b>malloc</b>_print (SCM exp, SCM port, scm_print_state *pstate SCM_UNUSED)
+
+</pre></gcs:match><gcs:match lineNumber="77" type="text/html"><pre> scm_puts(&quot;#&lt;<b>malloc</b> &quot;, port);
+</pre></gcs:match><gcs:match lineNumber="87" type="text/html"><pre> scm_t_bits mem = n ? (scm_t_bits) <b>malloc</b> (n) : 0;
+
+</pre></gcs:match><gcs:match lineNumber="90" type="text/html"><pre> SCM_RETURN_NEWSMOB (scm_tc16_<b>malloc</b>, mem);
+</pre></gcs:match><gcs:match lineNumber="98" type="text/html"><pre> scm_tc16_<b>malloc</b> = scm_make_smob_type (&quot;<b>malloc</b>&quot;, 0);
+
+</pre></gcs:match><gcs:match lineNumber="99" type="text/html"><pre> scm_set_smob_free (scm_tc16_<b>malloc</b>, <b>malloc</b>_free);
+</pre></gcs:match><rights>GPL</rights></entry>
+
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:9wyZUG-N_30:7_dFxoC1ZrY:C0_iYbFj90M&sa=N&ct=rx&cd=3&cs_p=http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz&cs_f=bash-3.0/lib/malloc/alloca.c&cs_p=http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz&cs_f=bash-3.0/lib/malloc/alloca.c#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">bash-3.0/lib/malloc/alloca.c</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:9wyZUG-N_30:7_dFxoC1ZrY:C0_iYbFj90M&sa=N&ct=rx&cd=3&cs_p=http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz&cs_f=bash-3.0/lib/malloc/alloca.c&cs_p=http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz&cs_f=bash-3.0/lib/malloc/alloca.c#first"/><gcs:package name="http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz" uri="http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz"></gcs:package><gcs:file name="bash-3.0/lib/malloc/alloca.c"></gcs:file><content type="text/html"><pre> 78: #ifndef emacs
+ #define <b>malloc</b> x<b>malloc</b>
+ extern pointer x<b>malloc</b> ();
+
+</pre></content><gcs:match lineNumber="69" type="text/html"><pre> <b>malloc</b>. The Emacs executable needs alloca to call x<b>malloc</b>, because
+</pre></gcs:match><gcs:match lineNumber="70" type="text/html"><pre> ordinary <b>malloc</b> isn&#39;t protected from input signals. On the other
+
+</pre></gcs:match><gcs:match lineNumber="71" type="text/html"><pre> hand, the utilities in lib-src need alloca to call <b>malloc</b>; some of
+</pre></gcs:match><gcs:match lineNumber="72" type="text/html"><pre> them are very simple, and don&#39;t have an x<b>malloc</b> routine.
+
+</pre></gcs:match><gcs:match lineNumber="76" type="text/html"><pre> Callers below should use <b>malloc</b>. */
+</pre></gcs:match><gcs:match lineNumber="79" type="text/html"><pre>#define <b>malloc</b> x<b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="80" type="text/html"><pre>extern pointer x<b>malloc</b> ();
+</pre></gcs:match><gcs:match lineNumber="132" type="text/html"><pre> It is very important that sizeof(header) agree with <b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="198" type="text/html"><pre> register pointer new = <b>malloc</b> (sizeof (header) + size);
+</pre></gcs:match><rights>GPL</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:uhVCKyPcT6k:8juMxxzmUJw:H7_IDsTB2L4&sa=N&ct=rx&cd=4&cs_p=http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2&cs_f=mozilla/xpcom/build/malloc.c&cs_p=http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2&cs_f=mozilla/xpcom/build/malloc.c#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">mozilla/xpcom/build/malloc.c</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:uhVCKyPcT6k:8juMxxzmUJw:H7_IDsTB2L4&sa=N&ct=rx&cd=4&cs_p=http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2&cs_f=mozilla/xpcom/build/malloc.c&cs_p=http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2&cs_f=mozilla/xpcom/build/malloc.c#first"/><gcs:package name="http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2" uri="http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2"></gcs:package><gcs:file name="mozilla/xpcom/build/malloc.c"></gcs:file><content type="text/html"><pre> 54: http://gee.cs.oswego.edu/dl/html/<b>malloc</b>.html
+
+ You may already by default be using a c library containing a <b>malloc</b>
+
+</pre></content><gcs:match lineNumber="4" type="text/html"><pre>/* ---------- To make a <b>malloc</b>.h, start cutting here ------------ */
+</pre></gcs:match><gcs:match lineNumber="22" type="text/html"><pre> Note: There may be an updated version of this <b>malloc</b> obtainable at
+
+</pre></gcs:match><gcs:match lineNumber="23" type="text/html"><pre> ftp://gee.cs.oswego.edu/pub/misc/<b>malloc</b>.c
+</pre></gcs:match><gcs:match lineNumber="34" type="text/html"><pre>* Why use this <b>malloc</b>?
+
+</pre></gcs:match><gcs:match lineNumber="37" type="text/html"><pre> most tunable <b>malloc</b> ever written. However it is among the fastest
+</pre></gcs:match><gcs:match lineNumber="40" type="text/html"><pre> allocator for <b>malloc</b>-intensive programs.
+
+</pre></gcs:match><gcs:match lineNumber="54" type="text/html"><pre> http://gee.cs.oswego.edu/dl/html/<b>malloc</b>.html
+</pre></gcs:match><gcs:match lineNumber="56" type="text/html"><pre> You may already by default be using a c library containing a <b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="57" type="text/html"><pre> that is somehow based on some version of this <b>malloc</b> (for example in
+</pre></gcs:match><rights>Mozilla</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:4n1P2HVOISs:Ybbpph0wR2M:OhIN_sDrG0U&sa=N&ct=rx&cd=5&cs_p=http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz&cs_f=hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh&cs_p=http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz&cs_f=hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:4n1P2HVOISs:Ybbpph0wR2M:OhIN_sDrG0U&sa=N&ct=rx&cd=5&cs_p=http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz&cs_f=hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh&cs_p=http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz&cs_f=hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh#first"/><gcs:package name="http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz" uri="http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz"></gcs:package><gcs:file name="hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh"></gcs:file><content type="text/html"><pre> 11: echo ================ unit-must-<b>malloc</b> tests ================
+ ./unit-must-<b>malloc</b>
+ echo ...passed
+
+</pre></content><gcs:match lineNumber="2" type="text/html"><pre># tag: Tom Lord Tue Dec 4 14:54:29 2001 (mem-tests/unit-must-<b>malloc</b>.sh)
+</pre></gcs:match><gcs:match lineNumber="11" type="text/html"><pre>echo ================ unit-must-<b>malloc</b> tests ================
+
+</pre></gcs:match><gcs:match lineNumber="12" type="text/html"><pre>./unit-must-<b>malloc</b>
+</pre></gcs:match><rights>GPL</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:GzkwiWG266M:ykuz3bG00ws:2sTvVSif08g&sa=N&ct=rx&cd=6&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2&cs_f=tar-1.14/lib/malloc.c&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2&cs_f=tar-1.14/lib/malloc.c#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">tar-1.14/lib/malloc.c</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:GzkwiWG266M:ykuz3bG00ws:2sTvVSif08g&sa=N&ct=rx&cd=6&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2&cs_f=tar-1.14/lib/malloc.c&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2&cs_f=tar-1.14/lib/malloc.c#first"/><gcs:package name="http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2" uri="http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2"></gcs:package><gcs:file name="tar-1.14/lib/malloc.c"></gcs:file><content type="text/html"><pre> 22: #endif
+ #undef <b>malloc</b>
+
+
+</pre></content><gcs:match lineNumber="1" type="text/html"><pre>/* Work around bug on some systems where <b>malloc</b> (0) fails.
+</pre></gcs:match><gcs:match lineNumber="23" type="text/html"><pre>#undef <b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="31" type="text/html"><pre>rpl_<b>malloc</b> (size_t n)
+</pre></gcs:match><gcs:match lineNumber="35" type="text/html"><pre> return <b>malloc</b> (n);
+
+</pre></gcs:match><rights>GPL</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:o_TFIeBY6dY:ktI_dt8wPao:AI03BD1Dz0Y&sa=N&ct=rx&cd=7&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz&cs_f=tar-1.16.1/lib/malloc.c&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz&cs_f=tar-1.16.1/lib/malloc.c#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">tar-1.16.1/lib/malloc.c</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:o_TFIeBY6dY:ktI_dt8wPao:AI03BD1Dz0Y&sa=N&ct=rx&cd=7&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz&cs_f=tar-1.16.1/lib/malloc.c&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz&cs_f=tar-1.16.1/lib/malloc.c#first"/><gcs:package name="http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz" uri="http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz"></gcs:package><gcs:file name="tar-1.16.1/lib/malloc.c"></gcs:file><content type="text/html"><pre> 21: #include &lt;config.h&gt;
+ #undef <b>malloc</b>
+
+
+</pre></content><gcs:match lineNumber="1" type="text/html"><pre>/* <b>malloc</b>() function that is glibc compatible.
+</pre></gcs:match><gcs:match lineNumber="22" type="text/html"><pre>#undef <b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="30" type="text/html"><pre>rpl_<b>malloc</b> (size_t n)
+</pre></gcs:match><gcs:match lineNumber="34" type="text/html"><pre> return <b>malloc</b> (n);
+
+</pre></gcs:match><rights>GPL</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:_ibw-VLkMoI:jBOtIJSmFd4:-0NUEVeCwfY&sa=N&ct=rx&cd=8&cs_p=http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2&cs_f=uClibc-0.9.29/include/malloc.h&cs_p=http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2&cs_f=uClibc-0.9.29/include/malloc.h#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">uClibc-0.9.29/include/malloc.h</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:_ibw-VLkMoI:jBOtIJSmFd4:-0NUEVeCwfY&sa=N&ct=rx&cd=8&cs_p=http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2&cs_f=uClibc-0.9.29/include/malloc.h&cs_p=http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2&cs_f=uClibc-0.9.29/include/malloc.h#first"/><gcs:package name="http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2" uri="http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2"></gcs:package><gcs:file name="uClibc-0.9.29/include/malloc.h"></gcs:file><content type="text/html"><pre> 1: /* Prototypes and definition for <b>malloc</b> implementation.
+ Copyright (C) 1996, 1997, 1999, 2000 Free Software Foundation, Inc.
+
+</pre></content><gcs:match lineNumber="1" type="text/html"><pre>/* Prototypes and definition for <b>malloc</b> implementation.
+</pre></gcs:match><gcs:match lineNumber="26" type="text/html"><pre> `pt<b>malloc</b>&#39;, a <b>malloc</b> implementation for multiple threads without
+
+</pre></gcs:match><gcs:match lineNumber="28" type="text/html"><pre> See the files `pt<b>malloc</b>.c&#39; or `COPYRIGHT&#39; for copying conditions.
+</pre></gcs:match><gcs:match lineNumber="32" type="text/html"><pre> This work is mainly derived from <b>malloc</b>-2.6.4 by Doug Lea
+
+</pre></gcs:match><gcs:match lineNumber="35" type="text/html"><pre> ftp://g.oswego.edu/pub/misc/<b>malloc</b>.c
+</pre></gcs:match><gcs:match lineNumber="40" type="text/html"><pre> `pt<b>malloc</b>.c&#39;.
+
+</pre></gcs:match><gcs:match lineNumber="45" type="text/html"><pre># define __<b>malloc</b>_ptr_t void *
+</pre></gcs:match><gcs:match lineNumber="51" type="text/html"><pre># define __<b>malloc</b>_ptr_t char *
+
+</pre></gcs:match><gcs:match lineNumber="56" type="text/html"><pre># define __<b>malloc</b>_size_t size_t
+</pre></gcs:match><rights>LGPL</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:F6qHcZ9vefo:bTX7o9gKfks:hECF4r_eKC0&sa=N&ct=rx&cd=9&cs_p=http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz&cs_f=glibc-2.0.1/hurd/hurdmalloc.h&cs_p=http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz&cs_f=glibc-2.0.1/hurd/hurdmalloc.h#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">glibc-2.0.1/hurd/hurdmalloc.h</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:F6qHcZ9vefo:bTX7o9gKfks:hECF4r_eKC0&sa=N&ct=rx&cd=9&cs_p=http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz&cs_f=glibc-2.0.1/hurd/hurdmalloc.h&cs_p=http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz&cs_f=glibc-2.0.1/hurd/hurdmalloc.h#first"/><gcs:package name="http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz" uri="http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz"></gcs:package><gcs:file name="glibc-2.0.1/hurd/hurdmalloc.h"></gcs:file><content type="text/html"><pre> 15: #define <b>malloc</b> _hurd_<b>malloc</b>
+ #define realloc _hurd_realloc
+
+</pre></content><gcs:match lineNumber="3" type="text/html"><pre> All hurd-internal code which uses <b>malloc</b> et al includes this file so it
+</pre></gcs:match><gcs:match lineNumber="4" type="text/html"><pre> will use the internal <b>malloc</b> routines _hurd_{<b>malloc</b>,realloc,free}
+
+</pre></gcs:match><gcs:match lineNumber="7" type="text/html"><pre> of <b>malloc</b> et al is the unixoid one using sbrk.
+</pre></gcs:match><gcs:match lineNumber="11" type="text/html"><pre>extern void *_hurd_<b>malloc</b> (size_t);
+
+</pre></gcs:match><gcs:match lineNumber="15" type="text/html"><pre>#define <b>malloc</b> _hurd_<b>malloc</b>
+</pre></gcs:match><rights>GPL</rights></entry>
+
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:CHUvHYzyLc8:pdcAfzDA6lY:wjofHuNLTHg&sa=N&ct=rx&cd=10&cs_p=ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2&cs_f=httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h&cs_p=ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2&cs_f=httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:CHUvHYzyLc8:pdcAfzDA6lY:wjofHuNLTHg&sa=N&ct=rx&cd=10&cs_p=ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2&cs_f=httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h&cs_p=ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2&cs_f=httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h#first"/><gcs:package name="ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2" uri="ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2"></gcs:package><gcs:file name="httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h"></gcs:file><content type="text/html"><pre> 173: #undef <b>malloc</b>
+ #define <b>malloc</b>(x) library_<b>malloc</b>(gLibHandle,x)
+
+</pre></content><gcs:match lineNumber="170" type="text/html"><pre>/* Redefine <b>malloc</b> to use the library <b>malloc</b> call so
+</pre></gcs:match><gcs:match lineNumber="173" type="text/html"><pre>#undef <b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="174" type="text/html"><pre>#define <b>malloc</b>(x) library_<b>malloc</b>(gLibHandle,x)
+</pre></gcs:match><rights>Apache</rights></entry>
+
+</feed>"""
+
+YOUTUBE_VIDEO_FEED = """<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gml='http://www.opengis.net/gml' xmlns:georss='http://www.georss.org/georss' xmlns:media='http://search.yahoo.com/mrss/' xmlns:yt='http://gdata.youtube.com/schemas/2007' xmlns:gd='http://schemas.google.com/g/2005'><id>http://gdata.youtube.com/feeds/api/standardfeeds/top_rated</id><updated>2008-05-14T02:24:07.000-07:00</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#video'/><title type='text'>Top Rated</title><logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo><link rel='alternate' type='text/html' href='http://www.youtube.com/browse?s=tr'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/standardfeeds/top_rated'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/standardfeeds/top_rated?start-index=1&max-results=25'/><link rel='next' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/standardfeeds/top_rated?start-index=26&max-results=25'/><author><name>YouTube</name><uri>http://www.youtube.com/</uri></author><generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator><openSearch:totalResults>100</openSearch:totalResults><openSearch:startIndex>1</openSearch:startIndex><openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+<entry><id>http://gdata.youtube.com/feeds/api/videos/C71ypXYGho8</id><published>2008-03-20T10:17:27.000-07:00</published><updated>2008-05-14T04:26:37.000-07:00</updated><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='karyn'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='garcia'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='me'/><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#video'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='boyfriend'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='por'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='te'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='odeio'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='amar'/><category scheme='http://gdata.youtube.com/schemas/2007/categories.cat' term='Music' label='Music'/><title type='text'>Me odeio por te amar - KARYN GARCIA</title><content type='text'>http://www.karyngarcia.com.br</content><link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=C71ypXYGho8'/><link rel='http://gdata.youtube.com/schemas/2007#video.related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/C71ypXYGho8/related'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/standardfeeds/top_rated/C71ypXYGho8'/><author><name>TvKarynGarcia</name><uri>http://gdata.youtube.com/feeds/api/users/tvkaryngarcia</uri></author><media:group><media:title type='plain'>Me odeio por te amar - KARYN GARCIA</media:title><media:description type='plain'>http://www.karyngarcia.com.br</media:description><media:keywords>amar, boyfriend, garcia, karyn, me, odeio, por, te</media:keywords><yt:duration seconds='203'/><media:category label='Music' scheme='http://gdata.youtube.com/schemas/2007/categories.cat'>Music</media:category><media:category label='test111' scheme='http://gdata.youtube.com/schemas/2007/developertags.cat'>test111</media:category><media:category label='test222' scheme='http://gdata.youtube.com/schemas/2007/developertags.cat'>test222</media:category><media:content url='http://www.youtube.com/v/C71ypXYGho8' type='application/x-shockwave-flash' medium='video' isDefault='true' expression='full' duration='203' yt:format='5'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQmPhgZ2pXK9CxMYDSANFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='203' yt:format='1'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQmPhgZ2pXK9CxMYESARFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='203' yt:format='6'/><media:player url='http://www.youtube.com/watch?v=C71ypXYGho8'/><media:thumbnail url='http://img.youtube.com/vi/C71ypXYGho8/2.jpg' height='97' width='130' time='00:01:41.500'/><media:thumbnail url='http://img.youtube.com/vi/C71ypXYGho8/1.jpg' height='97' width='130' time='00:00:50.750'/><media:thumbnail url='http://img.youtube.com/vi/C71ypXYGho8/3.jpg' height='97' width='130' time='00:02:32.250'/><media:thumbnail url='http://img.youtube.com/vi/C71ypXYGho8/0.jpg' height='240' width='320' time='00:01:41.500'/></media:group><yt:statistics viewCount='138864' favoriteCount='2474'/><gd:rating min='1' max='5' numRaters='4626' average='4.95'/><gd:comments><gd:feedLink href='http://gdata.youtube.com/feeds/api/videos/C71ypXYGho8/comments' countHint='27'/></gd:comments></entry>
+<entry><id>http://gdata.youtube.com/feeds/api/videos/gsVaTyb1tBw</id><published>2008-02-15T04:31:45.000-08:00</published><updated>2008-05-14T05:09:42.000-07:00</updated><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='extreme'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='cam'/><category scheme='http://gdata.youtube.com/schemas/2007/categories.cat' term='Sports' label='Sports'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='alcala'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='kani'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='helmet'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='campillo'/><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#video'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='pato'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='dirt'/><title type='text'>extreme helmet cam Kani, Keil and Pato</title><content type='text'>trimmed</content><link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=gsVaTyb1tBw'/><link rel='http://gdata.youtube.com/schemas/2007#video.responses' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/gsVaTyb1tBw/responses'/><link rel='http://gdata.youtube.com/schemas/2007#video.related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/gsVaTyb1tBw/related'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/standardfeeds/recently_featured/gsVaTyb1tBw'/><author><name>peraltamagic</name><uri>http://gdata.youtube.com/feeds/api/users/peraltamagic</uri></author><media:group><media:title type='plain'>extreme helmet cam Kani, Keil and Pato</media:title><media:description type='plain'>trimmed</media:description><media:keywords>alcala, cam, campillo, dirt, extreme, helmet, kani, pato</media:keywords><yt:duration seconds='31'/><media:category label='Sports' scheme='http://gdata.youtube.com/schemas/2007/categories.cat'>Sports</media:category><media:content url='http://www.youtube.com/v/gsVaTyb1tBw' type='application/x-shockwave-flash' medium='video' isDefault='true' expression='full' duration='31' yt:format='5'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQkctPUmT1rFghMYDSANFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='31' yt:format='1'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQkctPUmT1rFghMYESARFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='31' yt:format='6'/><media:player url='http://www.youtube.com/watch?v=gsVaTyb1tBw'/><media:thumbnail url='http://img.youtube.com/vi/gsVaTyb1tBw/2.jpg' height='97' width='130' time='00:00:15.500'/><media:thumbnail url='http://img.youtube.com/vi/gsVaTyb1tBw/1.jpg' height='97' width='130' time='00:00:07.750'/><media:thumbnail url='http://img.youtube.com/vi/gsVaTyb1tBw/3.jpg' height='97' width='130' time='00:00:23.250'/><media:thumbnail url='http://img.youtube.com/vi/gsVaTyb1tBw/0.jpg' height='240' width='320' time='00:00:15.500'/></media:group><yt:statistics viewCount='489941' favoriteCount='561'/><gd:rating min='1' max='5' numRaters='1255' average='4.11'/><gd:comments><gd:feedLink href='http://gdata.youtube.com/feeds/api/videos/gsVaTyb1tBw/comments' countHint='1116'/></gd:comments></entry>
+</feed>"""
+
+YOUTUBE_ENTRY_PRIVATE = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:media='http://search.yahoo.com/mrss/'
+xmlns:gd='http://schemas.google.com/g/2005'
+xmlns:yt='http://gdata.youtube.com/schemas/2007'
+xmlns:gml='http://www.opengis.net/gml'
+xmlns:georss='http://www.georss.org/georss'
+xmlns:app='http://purl.org/atom/app#'>
+ <id>http://gdata.youtube.com/feeds/videos/UMFI1hdm96E</id>
+ <published>2007-01-07T01:50:15.000Z</published>
+ <updated>2007-01-07T01:50:15.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://gdata.youtube.com/schemas/2007#video' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='barkley' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='singing' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='acoustic' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='cover' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/categories.cat'
+ term='Music' label='Music' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='gnarls' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='music' />
+ <title type='text'>"Crazy (Gnarles Barkley)" - Acoustic Cover</title>
+ <content type='html'><div style="color: #000000;font-family:
+ Arial, Helvetica, sans-serif; font-size:12px; font-size: 12px;
+ width: 555px;"><table cellspacing="0" cellpadding="0"
+ border="0"><tbody><tr><td width="140"
+ valign="top" rowspan="2"><div style="border: 1px solid
+ #999999; margin: 0px 10px 5px 0px;"><a
+ href="http://www.youtube.com/watch?v=UMFI1hdm96E"><img
+ alt=""
+ src="http://img.youtube.com/vi/UMFI1hdm96E/2.jpg"></a></div></td>
+ <td width="256" valign="top"><div style="font-size:
+ 12px; font-weight: bold;"><a style="font-size: 15px;
+ font-weight: bold; font-decoration: none;"
+ href="http://www.youtube.com/watch?v=UMFI1hdm96E">&quot;Crazy
+ (Gnarles Barkley)&quot; - Acoustic Cover</a>
+ <br></div> <div style="font-size: 12px; margin:
+ 3px 0px;"><span>Gnarles Barkley acoustic cover
+ http://www.myspace.com/davidchoimusic</span></div></td>
+ <td style="font-size: 11px; line-height: 1.4em; padding-left:
+ 20px; padding-top: 1px;" width="146"
+ valign="top"><div><span style="color: #666666;
+ font-size: 11px;">From:</span> <a
+ href="http://www.youtube.com/profile?user=davidchoimusic">davidchoimusic</a></div>
+ <div><span style="color: #666666; font-size:
+ 11px;">Views:</span> 113321</div> <div
+ style="white-space: nowrap;text-align: left"><img
+ style="border: 0px none; margin: 0px; padding: 0px;
+ vertical-align: middle; font-size: 11px;" align="top" alt=""
+ src="http://gdata.youtube.com/static/images/icn_star_full_11x11.gif">
+ <img style="border: 0px none; margin: 0px; padding: 0px;
+ vertical-align: middle; font-size: 11px;" align="top" alt=""
+ src="http://gdata.youtube.com/static/images/icn_star_full_11x11.gif">
+ <img style="border: 0px none; margin: 0px; padding: 0px;
+ vertical-align: middle; font-size: 11px;" align="top" alt=""
+ src="http://gdata.youtube.com/static/images/icn_star_full_11x11.gif">
+ <img style="border: 0px none; margin: 0px; padding: 0px;
+ vertical-align: middle; font-size: 11px;" align="top" alt=""
+ src="http://gdata.youtube.com/static/images/icn_star_full_11x11.gif">
+ <img style="border: 0px none; margin: 0px; padding: 0px;
+ vertical-align: middle; font-size: 11px;" align="top" alt=""
+ src="http://gdata.youtube.com/static/images/icn_star_half_11x11.gif"></div>
+ <div style="font-size: 11px;">1005 <span style="color:
+ #666666; font-size:
+ 11px;">ratings</span></div></td></tr>
+ <tr><td><span style="color: #666666; font-size:
+ 11px;">Time:</span> <span style="color: #000000;
+ font-size: 11px; font-weight:
+ bold;">04:15</span></td> <td style="font-size:
+ 11px; padding-left: 20px;"><span style="color: #666666;
+ font-size: 11px;">More in</span> <a
+ href="http://www.youtube.com/categories_portal?c=10">Music</a></td></tr></tbody></table></div></content>
+ <link rel='self' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/videos/UMFI1hdm96E' />
+ <link rel='alternate' type='text/html'
+ href='http://www.youtube.com/watch?v=UMFI1hdm96E' />
+ <link rel='http://gdata.youtube.com/schemas/2007#video.responses'
+ type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/videos/UMFI1hdm96E/responses' />
+ <link rel='http://gdata.youtube.com/schemas/2007#video.related'
+ type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/videos/UMFI1hdm96E/related' />
+ <author>
+ <name>davidchoimusic</name>
+ <uri>http://gdata.youtube.com/feeds/users/davidchoimusic</uri>
+ </author>
+ <media:group>
+ <media:title type='plain'>"Crazy (Gnarles Barkley)" - Acoustic Cover</media:title>
+ <media:description type='plain'>Gnarles Barkley acoustic cover http://www.myspace.com/davidchoimusic</media:description>
+ <media:keywords>music, singing, gnarls, barkley, acoustic, cover</media:keywords>
+ <yt:duration seconds='255' />
+ <media:category label='Music'
+ scheme='http://gdata.youtube.com/schemas/2007/categories.cat'>
+ Music</media:category>
+ <media:category
+ scheme='http://gdata.youtube.com/schemas/2007/developertags.cat'>
+ DeveloperTag1</media:category>
+ <media:content url='http://www.youtube.com/v/UMFI1hdm96E'
+ type='application/x-shockwave-flash' medium='video'
+ isDefault='true' expression='full' duration='255'
+ yt:format='5' />
+ <media:player url='http://www.youtube.com/watch?v=UMFI1hdm96E' />
+ <media:thumbnail url='http://img.youtube.com/vi/UMFI1hdm96E/2.jpg'
+ height='97' width='130' time='00:02:07.500' />
+ <media:thumbnail url='http://img.youtube.com/vi/UMFI1hdm96E/1.jpg'
+ height='97' width='130' time='00:01:03.750' />
+ <media:thumbnail url='http://img.youtube.com/vi/UMFI1hdm96E/3.jpg'
+ height='97' width='130' time='00:03:11.250' />
+ <media:thumbnail url='http://img.youtube.com/vi/UMFI1hdm96E/0.jpg'
+ height='240' width='320' time='00:02:07.500' />
+ <yt:private />
+ </media:group>
+ <yt:statistics viewCount='113321' />
+ <gd:rating min='1' max='5' numRaters='1005' average='4.77' />
+ <georss:where>
+ <gml:Point>
+ <gml:pos>37.398529052734375 -122.0635986328125</gml:pos>
+ </gml:Point>
+ </georss:where>
+ <gd:comments>
+ <gd:feedLink href='http://gdata.youtube.com/feeds/videos/UMFI1hdm96E/comments' />
+ </gd:comments>
+ <yt:noembed />
+ <app:control>
+ <app:draft>yes</app:draft>
+ <yt:state
+ name="rejected"
+ reasonCode="inappropriate"
+ helpUrl="http://www.youtube.com/t/community_guidelines">
+ The content of this video may violate the terms of use.</yt:state>
+ </app:control>
+</entry>"""
+
+YOUTUBE_COMMENT_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'><id>http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments</id><updated>2008-05-19T21:45:45.261Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#comment'/><title type='text'>Comments</title><logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo><link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU'/><link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=2Idhz9ef5oU'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments?start-index=1&max-results=25'/><author><name>YouTube</name><uri>http://www.youtube.com/</uri></author><generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator><openSearch:totalResults>0</openSearch:totalResults><openSearch:startIndex>1</openSearch:startIndex><openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/91F809A3DE2EB81B</id>
+ <published>2008-02-22T15:27:15.000-08:00</published><updated>2008-02-22T15:27:15.000-08:00</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#comment'/>
+ <title type='text'>test66</title>
+ <content type='text'>test66</content>
+ <link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU'/>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=2Idhz9ef5oU'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/91F809A3DE2EB81B'/>
+ <author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author>
+ </entry>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/A261AEEFD23674AA</id>
+ <published>2008-02-22T15:27:01.000-08:00</published><updated>2008-02-22T15:27:01.000-08:00</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#comment'/>
+ <title type='text'>test333</title>
+ <content type='text'>test333</content>
+ <link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU'/>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=2Idhz9ef5oU'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/A261AEEFD23674AA'/>
+ <author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author>
+ </entry>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/0DCF1E3531B3FF85</id>
+ <published>2008-02-22T15:11:06.000-08:00</published><updated>2008-02-22T15:11:06.000-08:00</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#comment'/>
+ <title type='text'>test2</title>
+ <content type='text'>test2</content>
+ <link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU'/>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=2Idhz9ef5oU'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/0DCF1E3531B3FF85'/>
+ <author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author>
+ </entry>
+</feed>"""
+
+YOUTUBE_PLAYLIST_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+ xmlns:media='http://search.yahoo.com/mrss/'
+ xmlns:yt='http://gdata.youtube.com/schemas/2007'
+ xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://gdata.youtube.com/feeds/users/andyland74/playlists?start-index=1&max-results=25</id>
+ <updated>2008-02-26T00:26:15.635Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#playlistLink'/>
+ <title type='text'>andyland74's Playlists</title>
+ <logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo>
+ <link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/andyland74'/>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/profile_play_list?user=andyland74'/>
+ <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/andyland74/playlists'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/andyland74/playlists?start-index=1&max-results=25'/>
+ <author>
+ <name>andyland74</name>
+ <uri>http://gdata.youtube.com/feeds/users/andyland74</uri>
+ </author>
+ <generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <yt:description>My new playlist Description</yt:description>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#playlist' href='http://gdata.youtube.com/feeds/playlists/8BCDD04DE8F771B2'/>
+ <id>http://gdata.youtube.com/feeds/users/andyland74/playlists/8BCDD04DE8F771B2</id>
+ <published>2007-11-04T17:30:27.000-08:00</published>
+ <updated>2008-02-22T09:55:14.000-08:00</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#playlistLink'/>
+ <title type='text'>My New Playlist Title</title>
+ <content type='text'>My new playlist Description</content>
+ <link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/andyland74'/>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/view_play_list?p=8BCDD04DE8F771B2'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/andyland74/playlists/8BCDD04DE8F771B2'/>
+ <author>
+ <name>andyland74</name>
+ <uri>http://gdata.youtube.com/feeds/users/andyland74</uri>
+ </author>
+ </entry>
+</feed>"""
+
+YOUTUBE_PLAYLIST_VIDEO_FEED = """<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gml='http://www.opengis.net/gml' xmlns:georss='http://www.georss.org/georss' xmlns:media='http://search.yahoo.com/mrss/' xmlns:yt='http://gdata.youtube.com/schemas/2007' xmlns:gd='http://schemas.google.com/g/2005'><id>http://gdata.youtube.com/feeds/api/playlists/BCB3BB96DF51B505</id><updated>2008-05-16T12:03:17.000-07:00</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#playlist'/><category scheme='http://gdata.youtube.com/schemas/2007/tags.cat' term='videos'/><category scheme='http://gdata.youtube.com/schemas/2007/tags.cat' term='python'/><title type='text'>Test Playlist</title><subtitle type='text'>Test playlist 1</subtitle><logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo><link rel='alternate' type='text/html' href='http://www.youtube.com/view_play_list?p=BCB3BB96DF51B505'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/playlists/BCB3BB96DF51B505'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/playlists/BCB3BB96DF51B505?start-index=1&max-results=25'/><author><name>gdpython</name><uri>http://gdata.youtube.com/feeds/api/users/gdpython</uri></author><generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator><openSearch:totalResults>1</openSearch:totalResults><openSearch:startIndex>1</openSearch:startIndex><openSearch:itemsPerPage>25</openSearch:itemsPerPage><media:group><media:title type='plain'>Test Playlist</media:title><media:description type='plain'>Test playlist 1</media:description><media:content url='http://www.youtube.com/ep.swf?id=BCB3BB96DF51B505' type='application/x-shockwave-flash' yt:format='5'/></media:group><entry><id>http://gdata.youtube.com/feeds/api/playlists/BCB3BB96DF51B505/B0F29389E537F888</id><updated>2008-05-16T20:54:08.520Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#playlist'/><title type='text'>Uploading YouTube Videos with the PHP Client Library</title><content type='text'>Jochen Hartmann demonstrates the basics of how to use the PHP Client Library with the YouTube Data API.
+
+PHP Developer's Guide:
+http://code.google.com/apis/youtube/developers_guide_php.html
+
+Other documentation:
+http://code.google.com/apis/youtube/</content><link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=iIp7OnHXBlo'/><link rel='http://gdata.youtube.com/schemas/2007#video.responses' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/iIp7OnHXBlo/responses'/><link rel='http://gdata.youtube.com/schemas/2007#video.related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/iIp7OnHXBlo/related'/><link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/iIp7OnHXBlo'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/playlists/BCB3BB96DF51B505/B0F29389E537F888'/><author><name>GoogleDevelopers</name><uri>http://gdata.youtube.com/feeds/api/users/googledevelopers</uri></author><media:group><media:title type='plain'>Uploading YouTube Videos with the PHP Client Library</media:title><media:description type='plain'>Jochen Hartmann demonstrates the basics of how to use the PHP Client Library with the YouTube Data API.
+
+PHP Developer's Guide:
+http://code.google.com/apis/youtube/developers_guide_php.html
+
+Other documentation:
+http://code.google.com/apis/youtube/</media:description><media:keywords>api, data, demo, php, screencast, tutorial, uploading, walkthrough, youtube</media:keywords><yt:duration seconds='466'/><media:category label='Education' scheme='http://gdata.youtube.com/schemas/2007/categories.cat'>Education</media:category><media:content url='http://www.youtube.com/v/iIp7OnHXBlo' type='application/x-shockwave-flash' medium='video' isDefault='true' expression='full' duration='466' yt:format='5'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQlaBtdxOnuKiBMYDSANFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='466' yt:format='1'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQlaBtdxOnuKiBMYESARFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='466' yt:format='6'/><media:player url='http://www.youtube.com/watch?v=iIp7OnHXBlo'/><media:thumbnail url='http://img.youtube.com/vi/iIp7OnHXBlo/2.jpg' height='97' width='130' time='00:03:53'/><media:thumbnail url='http://img.youtube.com/vi/iIp7OnHXBlo/1.jpg' height='97' width='130' time='00:01:56.500'/><media:thumbnail url='http://img.youtube.com/vi/iIp7OnHXBlo/3.jpg' height='97' width='130' time='00:05:49.500'/><media:thumbnail url='http://img.youtube.com/vi/iIp7OnHXBlo/0.jpg' height='240' width='320' time='00:03:53'/></media:group><yt:statistics viewCount='1550' favoriteCount='5'/><gd:rating min='1' max='5' numRaters='3' average='4.67'/><yt:location>undefined</yt:location><gd:comments><gd:feedLink href='http://gdata.youtube.com/feeds/api/videos/iIp7OnHXBlo/comments' countHint='2'/></gd:comments><yt:position>1</yt:position></entry></feed>"""
+
+YOUTUBE_SUBSCRIPTION_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+ xmlns:media='http://search.yahoo.com/mrss/'
+ xmlns:yt='http://gdata.youtube.com/schemas/2007'
+ xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://gdata.youtube.com/feeds/users/andyland74/subscriptions?start-index=1&max-results=25</id>
+ <updated>2008-02-26T00:26:15.635Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://gdata.youtube.com/schemas/2007#subscription'/>
+ <title type='text'>andyland74's Subscriptions</title>
+ <logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo>
+ <link rel='related' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74'/>
+ <link rel='alternate' type='text/html'
+ href='http://www.youtube.com/profile_subscriptions?user=andyland74'/>
+ <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74/subscriptions'/>
+ <link rel='self' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74/subscriptions?start-index=1&max-results=25'/>
+ <author>
+ <name>andyland74</name>
+ <uri>http://gdata.youtube.com/feeds/users/andyland74</uri>
+ </author>
+ <generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/users/andyland74/subscriptions/d411759045e2ad8c</id>
+ <published>2007-11-04T17:30:27.000-08:00</published>
+ <updated>2008-02-22T09:55:14.000-08:00</updated>
+ <category scheme='http://gdata.youtube.com/schemas/2007/subscriptiontypes.cat'
+ term='channel'/>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://gdata.youtube.com/schemas/2007#subscription'/>
+ <title type='text'>Videos published by : NBC</title>
+ <link rel='related' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74'/>
+ <link rel='alternate' type='text/html'
+ href='http://www.youtube.com/profile_videos?user=NBC'/>
+ <link rel='self' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74/subscriptions/d411759045e2ad8c'/>
+ <author>
+ <name>andyland74</name>
+ <uri>http://gdata.youtube.com/feeds/users/andyland74</uri>
+ </author>
+ <yt:username>NBC</yt:username>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.uploads'
+ href='http://gdata.youtube.com/feeds/api/users/nbc/uploads'/>
+ </entry>
+</feed>"""
+
+YOUTUBE_VIDEO_RESPONSE_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+ <feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gml='http://www.opengis.net/gml' xmlns:georss='http://www.georss.org/georss' xmlns:media='http://search.yahoo.com/mrss/' xmlns:yt='http://gdata.youtube.com/schemas/2007' xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY/responses</id><updated>2008-05-19T22:37:34.076Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#video'/><title type='text'>Videos responses to 'Giant NES controller coffee table'</title><logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo><link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY'/><link rel='alternate' type='text/html' href='http://www.youtube.com/video_response_view_all?v=2c3q9K4cHzY'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY/responses'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY/responses?start-index=1&max-results=25'/><author><name>YouTube</name><uri>http://www.youtube.com/</uri></author><generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator><openSearch:totalResults>8</openSearch:totalResults><openSearch:startIndex>1</openSearch:startIndex><openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/videos/7b9EnRI9VbY</id><published>2008-03-11T19:08:53.000-07:00</published><updated>2008-05-18T21:33:10.000-07:00</updated>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='OD'/><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#video'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='chat'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='Uncle'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='sex'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='catmint'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='kato'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='kissa'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='katt'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/categories.cat' term='Animals' label='Pets & Animals'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='kat'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='cat'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='cats'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='kedi'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='gato'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='Brattman'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='drug'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='overdose'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='catnip'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='party'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='Katze'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='gatto'/>
+ <title type='text'>Catnip Party</title><content type='html'>snipped</content>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=7b9EnRI9VbY'/>
+ <link rel='http://gdata.youtube.com/schemas/2007#video.responses' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/7b9EnRI9VbY/responses'/>
+ <link rel='http://gdata.youtube.com/schemas/2007#video.related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/7b9EnRI9VbY/related'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY/responses/7b9EnRI9VbY'/>
+ <author><name>PismoBeach</name><uri>http://gdata.youtube.com/feeds/users/pismobeach</uri></author>
+ <media:group>
+ <media:title type='plain'>Catnip Party</media:title>
+ <media:description type='plain'>Uncle, Hillary, Hankette, and B4 all but overdose on the patio</media:description><media:keywords>Brattman, cat, catmint, catnip, cats, chat, drug, gato, gatto, kat, kato, katt, Katze, kedi, kissa, OD, overdose, party, sex, Uncle</media:keywords>
+ <yt:duration seconds='139'/>
+ <media:category label='Pets & Animals' scheme='http://gdata.youtube.com/schemas/2007/categories.cat'>Animals</media:category>
+ <media:content url='http://www.youtube.com/v/7b9EnRI9VbY' type='application/x-shockwave-flash' medium='video' isDefault='true' expression='full' duration='139' yt:format='5'/>
+ <media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQm2VT0SnUS_7RMYDSANFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='139' yt:format='1'/>
+ <media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQm2VT0SnUS_7RMYESARFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='139' yt:format='6'/>
+ <media:player url='http://www.youtube.com/watch?v=7b9EnRI9VbY'/>
+ <media:thumbnail url='http://img.youtube.com/vi/7b9EnRI9VbY/2.jpg' height='97' width='130' time='00:01:09.500'/>
+ <media:thumbnail url='http://img.youtube.com/vi/7b9EnRI9VbY/1.jpg' height='97' width='130' time='00:00:34.750'/>
+ <media:thumbnail url='http://img.youtube.com/vi/7b9EnRI9VbY/3.jpg' height='97' width='130' time='00:01:44.250'/>
+ <media:thumbnail url='http://img.youtube.com/vi/7b9EnRI9VbY/0.jpg' height='240' width='320' time='00:01:09.500'/>
+ </media:group>
+ <yt:statistics viewCount='4235' favoriteCount='3'/>
+ <gd:rating min='1' max='5' numRaters='24' average='3.54'/>
+ <gd:comments>
+ <gd:feedLink href='http://gdata.youtube.com/feeds/videos/7b9EnRI9VbY/comments' countHint='14'/>
+ </gd:comments>
+ </entry>
+</feed>
+"""
+
+
+YOUTUBE_PROFILE = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:media='http://search.yahoo.com/mrss/'
+ xmlns:yt='http://gdata.youtube.com/schemas/2007'
+ xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://gdata.youtube.com/feeds/users/andyland74</id>
+ <published>2006-10-16T00:09:45.000-07:00</published>
+ <updated>2008-02-26T11:48:21.000-08:00</updated>
+ <category scheme='http://gdata.youtube.com/schemas/2007/channeltypes.cat'
+ term='Standard'/>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://gdata.youtube.com/schemas/2007#userProfile'/>
+ <title type='text'>andyland74 Channel</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.youtube.com/profile?user=andyland74'/>
+ <link rel='self' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74'/>
+ <author>
+ <name>andyland74</name>
+ <uri>http://gdata.youtube.com/feeds/users/andyland74</uri>
+ </author>
+ <yt:age>33</yt:age>
+ <yt:username>andyland74</yt:username>
+ <yt:firstName>andy</yt:firstName>
+ <yt:lastName>example</yt:lastName>
+ <yt:books>Catch-22</yt:books>
+ <yt:gender>m</yt:gender>
+ <yt:company>Google</yt:company>
+ <yt:hobbies>Testing YouTube APIs</yt:hobbies>
+ <yt:hometown>Somewhere</yt:hometown>
+ <yt:location>US</yt:location>
+ <yt:movies>Aqua Teen Hungerforce</yt:movies>
+ <yt:music>Elliott Smith</yt:music>
+ <yt:occupation>Technical Writer</yt:occupation>
+ <yt:school>University of North Carolina</yt:school>
+ <media:thumbnail url='http://i.ytimg.com/vi/YFbSxcdOL-w/default.jpg'/>
+ <yt:statistics viewCount='9' videoWatchCount='21' subscriberCount='1'
+ lastWebAccess='2008-02-25T16:03:38.000-08:00'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.favorites'
+ href='http://gdata.youtube.com/feeds/users/andyland74/favorites' countHint='4'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.contacts'
+ href='http://gdata.youtube.com/feeds/users/andyland74/contacts' countHint='1'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.inbox'
+ href='http://gdata.youtube.com/feeds/users/andyland74/inbox' countHint='0'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.playlists'
+ href='http://gdata.youtube.com/feeds/users/andyland74/playlists'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.subscriptions'
+ href='http://gdata.youtube.com/feeds/users/andyland74/subscriptions' countHint='4'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.uploads'
+ href='http://gdata.youtube.com/feeds/users/andyland74/uploads' countHint='1'/>
+</entry>"""
+
+YOUTUBE_CONTACTS_FEED = """<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:yt='http://gdata.youtube.com/schemas/2007' xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts</id><updated>2008-05-16T19:24:34.916Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#friend'/><title type='text'>apitestjhartmann's Contacts</title><logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo><link rel='alternate' type='text/html' href='http://www.youtube.com/profile_friends?user=apitestjhartmann'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts?start-index=1&max-results=25'/><author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author><generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator><openSearch:totalResults>2</openSearch:totalResults><openSearch:startIndex>1</openSearch:startIndex><openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/test89899090</id><published>2008-02-04T11:27:54.000-08:00</published><updated>2008-05-16T19:24:34.916Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#friend'/><title type='text'>test89899090</title><link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/test89899090'/><link rel='alternate' type='text/html' href='http://www.youtube.com/profile?user=test89899090'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/test89899090'/><link rel='edit' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/test89899090'/><author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author><yt:username>test89899090</yt:username><yt:status>requested</yt:status></entry>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/testjfisher</id><published>2008-02-26T14:13:03.000-08:00</published><updated>2008-05-16T19:24:34.916Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#friend'/><title type='text'>testjfisher</title><link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/testjfisher'/><link rel='alternate' type='text/html' href='http://www.youtube.com/profile?user=testjfisher'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/testjfisher'/><link rel='edit' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/testjfisher'/><author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author><yt:username>testjfisher</yt:username><yt:status>pending</yt:status></entry>
+</feed>"""
+
+NEW_CONTACT = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:gd='http://schemas.google.com/g/2005'
+ xmlns:gContact='http://schemas.google.com/contact/2008'>
+ <id>http://www.google.com/m8/feeds/contacts/liz%40gmail.com/base/8411573</id>
+ <updated>2008-02-28T18:47:02.303Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/contact/2008#contact' />
+ <title type='text'>Fitzgerald</title>
+ <content type='text'>Notes</content>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/8411573' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/8411573/1204224422303000' />
+ <gd:email rel='http://schemas.google.com/g/2005#work'
+ address='liz@gmail.com' />
+ <gd:email rel='http://schemas.google.com/g/2005#home'
+ address='liz@example.org' />
+ <gd:phoneNumber rel='http://schemas.google.com/g/2005#work'
+ primary='true'>(206)555-1212</gd:phoneNumber>
+ <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
+ primary='true'>456-123-2133</gd:phoneNumber>
+ <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>(206)555-1213</gd:phoneNumber>
+ <gd:extendedProperty name="pet" value="hamster" />
+ <gd:extendedProperty name="cousine">
+ <italian />
+ </gd:extendedProperty>
+ <gContact:groupMembershipInfo deleted="false" href="http://google.com/m8/feeds/groups/liz%40gmail.com/base/270f" />
+ <gd:im address='liz@gmail.com'
+ protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
+ rel='http://schemas.google.com/g/2005#home' />
+ <gd:postalAddress rel='http://schemas.google.com/g/2005#work'
+ primary='true'>1600 Amphitheatre Pkwy Mountain View</gd:postalAddress>
+</entry>"""
+
+CONTACTS_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+ xmlns:gd='http://schemas.google.com/g/2005'
+ xmlns:gContact='http://schemas.google.com/contact/2008'
+ xmlns:batch='http://schemas.google.com/gdata/batch'>
+ <id>http://www.google.com/m8/feeds/contacts/liz%40gmail.com/base</id>
+ <updated>2008-03-05T12:36:38.836Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/contact/2008#contact' />
+ <title type='text'>Contacts</title>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full' />
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full' />
+ <link rel='http://schemas.google.com/g/2005#batch'
+ type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/batch' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full?max-results=25' />
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <generator version='1.0' uri='http://www.google.com/m8/feeds/contacts'>
+ Contacts
+ </generator>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>
+ http://www.google.com/m8/feeds/contacts/liz%40gmail.com/base/c9012de
+ </id>
+ <updated>2008-03-05T12:36:38.835Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/contact/2008#contact' />
+ <title type='text'>Fitzgerald</title>
+ <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
+ href="http://google.com/m8/feeds/photos/media/liz%40gmail.com/c9012de"/>
+ <link rel="http://schemas.google.com/contacts/2008/rel#edit-photo" type="image/*"
+ href="http://www.google.com/m8/feeds/photos/media/liz%40gmail.com/c9012de/photo4524"/>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/c9012de' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/c9012de/1204720598835000' />
+ <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
+ primary='true'>
+ 456
+ </gd:phoneNumber>
+ <gd:extendedProperty name="pet" value="hamster" />
+ <gContact:groupMembershipInfo deleted="false" href="http://google.com/m8/feeds/groups/liz%40gmail.com/base/270f" />
+ </entry>
+</feed>"""
+
+
+CONTACT_GROUPS_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gContact="http://schemas.google.com/contact/2008"
+ xmlns:batch="http://schemas.google.com/gdata/batch"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <id>jo@gmail.com</id>
+ <updated>2008-05-21T21:11:25.237Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#group"/>
+ <title type="text">Jo's Contact Groups</title>
+ <link rel="alternate" type="text/html" href="http://www.google.com/"/>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml"
+ href="http://google.m/m8/feeds/groups/jo%40gmail.com/thin"/>
+ <link rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml"
+ href="http://google.m/m8/feeds/groups/jo%40gmail.com/thin"/>
+ <link rel="http://schemas.google.com/g/2005#batch"
+ type="application/atom+xml"
+ href="http://googleom/m8/feeds/groups/jo%40gmail.com/thin/batch"/>
+ <link rel="self"
+ type="application/atom+xml"
+ href="http://google.com/m8/feeds/groups/jo%40gmail.com/thin?max-results=25"/>
+ <author>
+ <name>Jo Brown</name>
+ <email>jo@gmail.com</email>
+ </author>
+ <generator version="1.0" uri="http://google.com/m8/feeds">Contacts</generator>
+ <openSearch:totalResults>3</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>http://google.com/m8/feeds/groups/jo%40gmail.com/base/270f</id>
+ <updated>2008-05-14T13:10:19.070Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#group"/>
+ <title type="text">joggers</title>
+ <content type="text">joggers</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://google.com/m8/feeds/groups/jo%40gmail.com/thin/270f"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://google.com/m8/feeds/groups/jo%40gmail.com/thin/270f/1210770619070000"/>
+ </entry>
+</feed>"""
+
+CONTACT_GROUP_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <category scheme="http://schemas.google.com/g/2005#kind"
+ term="http://schemas.google.com/g/2005#group"/>
+ <id>http://www.google.com/feeds/groups/jo%40gmail.com/base/1234</id>
+ <published>2005-01-18T21:00:00Z</published>
+ <updated>2006-01-01T00:00:00Z</updated>
+ <title type="text">Salsa group</title>
+ <content type="text">Salsa group</content>
+ <link rel='self' type='application/atom+xml'
+ href= 'http://www.google.com/m8/feeds/groups/jo%40gmail.com/full/2' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/groups/jo%40gmail.com/full/2/0'/>
+ <gd:extendedProperty name="more info about the group">
+ <info>Very nice people.</info>
+ </gd:extendedProperty>
+</entry>"""
+
+CALENDAR_RESOURCE_ENTRY = """<?xml version="1.0"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom" xmlns:apps="http://schemas.google.com/apps/2006">
+ <apps:property name="resourceId" value="CR-NYC-14-12-BR"/>
+ <apps:property name="resourceCommonName" value="Boardroom"/>
+ <apps:property name="resourceDescription" value="This conference room is in New York City, building 14, floor 12, Boardroom"/>
+ <apps:property name="resourceType" value="CR"/>
+</atom:entry>"""
+
+CALENDAR_RESOURCES_FEED = """<?xml version="1.0"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:apps="http://schemas.google.com/apps/2006">
+ <id>https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com</id>
+ <updated>2008-10-17T15:29:21.064Z</updated>
+ <link rel="next" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/?start=the next resourceId"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com"/>
+ <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com"/>
+ <link rel="self" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com?start=CR-NYC-14-12-BR"/>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/CR-NYC-14-12-BR</id>
+ <updated>2008-10-17T15:29:21.064Z</updated>
+ <link rel="self" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/CR-NYC-14-12-BR"/>
+ <link rel="edit" type="application/atom+xml" href="https://apps-apis.google.com/feeds/calendar/resource/2.0/yourdomain.com/CR-NYC-14-12-BR"/>
+ <apps:property name="resourceId" value="CR-NYC-14-12-BR"/>
+ <apps:property name="resourceCommonName" value="Boardroom"/>
+ <apps:property name="resourceEmail" value="domain_123456@resource.calendar.google.com"/>
+ <apps:property name="resourceDescription" value="This conference room is in New York City, building 14, floor 12, Boardroom"/>
+ <apps:property name="resourceType" value="CR"/>
+ </entry>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/?start=(Bike)-London-43-Lobby-Bike-1</id>
+ <updated>2008-10-17T15:29:21.064Z</updated>
+ <link rel="self" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/(Bike)-London-43-Lobby-Bike-1"/>
+ <link rel="edit" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/(Bike)-London-43-Lobby-Bike-1"/>
+ <apps:property name="resourceId" value="(Bike)-London-43-Lobby-Bike-1"/>
+ <apps:property name="resourceCommonName" value="London bike-1"/>
+ <apps:property name="resourceEmail" value="domain_123457@resource.calendar.google.com"/>
+ <apps:property name="resourceDescription" value="Bike is in London at building 43's lobby."/>
+ <apps:property name="resourceType" value="(Bike)"/>
+ </entry>
+</feed>"""
+
+BLOG_ENTRY = """<entry xmlns='http://www.w3.org/2005/Atom'>
+ <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
+ <published>2006-08-02T18:44:43.089-07:00</published>
+ <updated>2006-11-08T18:10:23.020-08:00</updated>
+ <title type='text'>Lizzy's Diary</title>
+ <summary type='html'>Being the journal of Elizabeth Bennet</summary>
+ <link rel='alternate' type='text/html'
+ href='http://blogName.blogspot.com/'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://blogName.blogspot.com/feeds/posts/default'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://www.blogger.com/feeds/blogID/posts/default'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.blogger.com/feeds/userID/blogs/blogID'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.blogger.com/feeds/userID/blogs/blogID'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+</entry>"""
+
+BLOG_POST = """<entry xmlns='http://www.w3.org/2005/Atom'>
+ <title type='text'>Marriage!</title>
+ <content type='xhtml'>
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <p>Mr. Darcy has <em>proposed marriage</em> to me!</p>
+ <p>He is the last man on earth I would ever desire to marry.</p>
+ <p>Whatever shall I do?</p>
+ </div>
+ </content>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+</entry>"""
+
+BLOG_POSTS_FEED = """<feed xmlns='http://www.w3.org/2005/Atom'>
+ <id>tag:blogger.com,1999:blog-blogID</id>
+ <updated>2006-11-08T18:10:23.020-08:00</updated>
+ <title type='text'>Lizzy's Diary</title>
+ <link rel='alternate' type='text/html'
+ href='http://blogName.blogspot.com/index.html'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://blogName.blogspot.com/feeds/posts/default'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://blogName.blogspot.com/feeds/posts/default'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <generator version='7.00' uri='http://www2.blogger.com'>Blogger</generator>
+ <entry>
+ <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
+ <published>2006-11-08T18:10:00.000-08:00</published>
+ <updated>2006-11-08T18:10:14.954-08:00</updated>
+ <title type='text'>Quite disagreeable</title>
+ <content type='html'><p>I met Mr. Bingley's friend Mr. Darcy
+ this evening. I found him quite disagreeable.</p></content>
+ <link rel='alternate' type='text/html'
+ href='http://blogName.blogspot.com/2006/11/quite-disagreeable.html'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://blogName.blogspot.com/feeds/posts/default/postID'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.blogger.com/feeds/blogID/posts/default/postID'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ </entry>
+</feed>"""
+
+BLOG_COMMENTS_FEED = """<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/">
+ <id>tag:blogger.com,1999:blog-blogID.postpostID..comments</id>
+ <updated>2007-04-04T21:56:29.803-07:00</updated>
+ <title type="text">My Blog : Time to relax</title>
+ <link rel="alternate" type="text/html" href="http://blogName.blogspot.com/2007/04/first-post.html"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default"/>
+ <link rel="self" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default"/>
+ <author>
+ <name>Blog Author name</name>
+ </author>
+ <generator version="7.00" uri="http://www2.blogger.com">Blogger</generator>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>tag:blogger.com,1999:blog-blogID.post-commentID</id>
+ <published>2007-04-04T21:56:00.000-07:00</published>
+ <updated>2007-04-04T21:56:29.803-07:00</updated>
+ <title type="text">This is my first comment</title>
+ <content type="html">This is my first comment</content>
+ <link rel="alternate" type="text/html" href="http://a-blogName.blogspot.com/2007/04/first-post.html#commentID"/>
+ <link rel="self" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default/commentID"/>
+ <link rel="edit" type="application/atom+xml" href="http://www.blogger.com/feeds/blogID/postID/comments/default/commentID"/>
+ <author>
+ <name>Blog Author name</name>
+ </author>
+ <thr:in-reply-to xmlns:thr='http://purl.org/syndication/thread/1.0'
+ href='http://blogName.blogspot.com/2007/04/first-post.html'
+ ref='tag:blogger.com,1999:blog-blogID.post-postID'
+ source='http://blogName.blogspot.com/feeds/posts/default/postID'
+ type='text/html' />
+ </entry>
+</feed>"""
+
+
+SITES_FEED = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gd="http://schemas.google.com/g/2005"
+ xmlns:wt="http://schemas.google.com/webmasters/tools/2007">
+ <id>https://www.google.com/webmasters/tools/feeds/sites</id>
+ <title>Sites</title>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/webmasters/tools/2007#sites-feed" />
+ <link href="http://www.google.com/webmasters/tools/feeds/sites" rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" />
+ <link href="http://www.google.com/webmasters/tools/feeds/sites" rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" />
+ <link href="http://www.google.com/webmasters/tools/feeds/sites" rel="self" type="application/atom+xml" />
+ <updated>2008-10-02T07:26:51.833Z</updated>
+ <entry>
+ <id>http://www.example.com</id>
+ <title type="text">http://www.example.com</title>
+ <link href="http://www.google.com/webmasters/tools/feeds/sites/http%3A%2F%2Fwww.example.com%2F" rel="self" type="application/atom+xml"/>
+ <link href="http://www.google.com/webmasters/tools/feeds/sites/http%3A%2F%2Fwww.example.com%2F" rel="edit" type="application/atom+xml"/>
+ <content src="http://www.example.com"/>
+ <updated>2007-11-17T18:27:32.543Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/webmasters/tools/2007#site-info"/>
+ <gd:entryLink rel="http://schemas.google.com/webmasters/tools/2007#verification"
+ href="https://www.google.com/webmasters/tools/feeds/http%3A%2F%2Fwww%2Eexample%2Ecom%2F/verification" />
+ <gd:entryLink rel="http://schemas.google.com/webmasters/tools/2007#sitemaps"
+ href="https://www.google.com/webmasters/tools/feeds/http%3A%2F%2Fwww%2Eexample%2Ecom%2F/sitemaps" />
+ <wt:indexed>true</wt:indexed>
+ <wt:crawled>2008-09-14T08:59:28.000</wt:crawled>
+ <wt:geolocation>US</wt:geolocation>
+ <wt:preferred-domain>none</wt:preferred-domain>
+ <wt:crawl-rate>normal</wt:crawl-rate>
+ <wt:enhanced-image-search>true</wt:enhanced-image-search>
+ <wt:verified>false</wt:verified>
+ <wt:verification-method type="metatag" in-use="false"><meta name="verify-v1" content="a2Ai"/>
+ </wt:verification-method>
+ <wt:verification-method type="htmlpage" in-use="false">456456-google.html</wt:verification-method>
+ </entry>
+</feed>"""
+
+
+SITEMAPS_FEED = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:wt="http://schemas.google.com/webmasters/tools/2007">
+ <id>http://www.example.com</id>
+ <title type="text">http://www.example.com/</title>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <link rel="self" type="application/atom+xml"
+ href="https://www.google.com/webmasters/tools/feeds/http%3A%2F%2Fwww%2Eexample%2Ecom%2F/sitemaps" />
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/webmasters/tools/2007#sitemaps-feed'/>
+ <wt:sitemap-mobile>
+ <wt:markup-language>HTML</wt:markup-language>
+ <wt:markup-language>WAP</wt:markup-language>
+ </wt:sitemap-mobile>
+ <wt:sitemap-news>
+ <wt:publication-label>Value1</wt:publication-label>
+ <wt:publication-label>Value2</wt:publication-label>
+ <wt:publication-label>Value3</wt:publication-label>
+ </wt:sitemap-news>
+ <entry>
+ <id>http://www.example.com/sitemap-index.xml</id>
+ <title type="text">http://www.example.com/sitemap-index.xml</title>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/webmasters/tools/2007#sitemap-regular'/>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <wt:sitemap-type>WEB</wt:sitemap-type>
+ <wt:sitemap-status>StatusValue</wt:sitemap-status>
+ <wt:sitemap-last-downloaded>2006-11-18T19:27:32.543Z</wt:sitemap-last-downloaded>
+ <wt:sitemap-url-count>102</wt:sitemap-url-count>
+ </entry>
+ <entry>
+ <id>http://www.example.com/mobile/sitemap-index.xml</id>
+ <title type="text">http://www.example.com/mobile/sitemap-index.xml</title>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/webmasters/tools/2007#sitemap-mobile'/>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <wt:sitemap-status>StatusValue</wt:sitemap-status>
+ <wt:sitemap-last-downloaded>2006-11-18T19:27:32.543Z</wt:sitemap-last-downloaded>
+ <wt:sitemap-url-count>102</wt:sitemap-url-count>
+ <wt:sitemap-mobile-markup-language>HTML</wt:sitemap-mobile-markup-language>
+ </entry>
+ <entry>
+ <id>http://www.example.com/news/sitemap-index.xml</id>
+ <title type="text">http://www.example.com/news/sitemap-index.xml</title>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/webmasters/tools/2007#sitemap-news'/>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <wt:sitemap-status>StatusValue</wt:sitemap-status>
+ <wt:sitemap-last-downloaded>2006-11-18T19:27:32.543Z</wt:sitemap-last-downloaded>
+ <wt:sitemap-url-count>102</wt:sitemap-url-count>
+ <wt:sitemap-news-publication-label>LabelValue</wt:sitemap-news-publication-label>
+ </entry>
+</feed>"""
+
+HEALTH_CCR_NOTICE_PAYLOAD = """<ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <Body>
+ <Problems>
+ <Problem>
+ <DateTime>
+ <Type><Text>Start date</Text></Type>
+ <ExactDateTime>2007-04-04T07:00:00Z</ExactDateTime>
+ </DateTime>
+ <Description>
+ <Text>Aortic valve disorders</Text>
+ <Code>
+ <Value>410.10</Value>
+ <CodingSystem>ICD9</CodingSystem>
+ <Version>2004</Version>
+ </Code>
+ </Description>
+ <Status><Text>Active</Text></Status>
+ </Problem>
+ </Problems>
+ </Body>
+</ContinuityOfCareRecord>"""
+
+HEALTH_PROFILE_ENTRY_DIGEST = """<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:ccr="urn:astm-org:CCR" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:h9m="http://schemas.google.com/health/metadata">
+ <id>https://www.google.com/health/feeds/profile/default/vneCn5qdEIY_digest</id>
+ <updated>2008-09-29T07:52:17.176Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile" />
+ <link rel="alternate" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default?digest=true" />
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/vneCn5qdEIY_digest" />
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/vneCn5qdEIY_digest" />
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>vneCn5qdEIY</CCRDocumentObjectID>
+ <Language>
+ <Text>English</Text>
+ <Code>
+ <Value>en</Value>
+ <CodingSystem>ISO-639-1</CodingSystem>
+ </Code>
+ </Language>
+ <Version>V1.0</Version>
+ <DateTime>
+ <ExactDateTime>2008-09-29T07:52:17.176Z</ExactDateTime>
+ </DateTime>
+ <Patient>
+ <ActorID>Google Health Profile</ActorID>
+ </Patient>
+ <Body>
+ <FunctionalStatus>
+ <Function>
+ <Type>
+ <Text>Pregnancy status</Text>
+ </Type>
+ <Description>
+ <Text>Not pregnant</Text>
+ </Description>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@google.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Function>
+ <Function>
+ <Type>
+ <Text>Breastfeeding status</Text>
+ </Type>
+ <Description>
+ <Text>Not breastfeeding</Text>
+ </Description>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Function>
+ </FunctionalStatus>
+ <Problems>
+ <Problem>
+ <CCRDataObjectID>Hn0FE0IlcY-FMFFgSTxkvA/CONDITION/0</CCRDataObjectID>
+ <DateTime>
+ <Type>
+ <Text>Start date</Text>
+ </Type>
+ <ExactDateTime>2007-04-04T07:00:00Z</ExactDateTime>
+ </DateTime>
+ <Description>
+ <Text>Aortic valve disorders</Text>
+ <Code>
+ <Value>410.10</Value>
+ <CodingSystem>ICD9</CodingSystem>
+ <Version>2004</Version>
+ </Code>
+ </Description>
+ <Status>
+ <Text>Active</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>example.com</ActorID>
+ <ActorRole>
+ <Text>Information Provider</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Problem>
+ <Problem>
+ <Type />
+ <Description>
+ <Text>Malaria</Text>
+ <Code>
+ <Value>136.9</Value>
+ <CodingSystem>ICD9_Broader</CodingSystem>
+ </Code>
+ <Code>
+ <Value>084.6</Value>
+ <CodingSystem>ICD9</CodingSystem>
+ </Code>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <HealthStatus>
+ <Description />
+ </HealthStatus>
+ </Problem>
+ </Problems>
+ <SocialHistory>
+ <SocialHistoryElement>
+ <Type>
+ <Text>Race</Text>
+ <Code>
+ <Value>S15814</Value>
+ <CodingSystem>HL7</CodingSystem>
+ </Code>
+ </Type>
+ <Description>
+ <Text>White</Text>
+ </Description>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Episodes>
+ <Frequency>
+ <Units />
+ </Frequency>
+ </Episodes>
+ </SocialHistoryElement>
+ </SocialHistory>
+ <Alerts>
+ <Alert>
+ <Type>
+ <Text>Allergy</Text>
+ </Type>
+ <Description>
+ <Text>A-Fil</Text>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Reaction>
+ <Description />
+ <Severity>
+ <Text>Severe</Text>
+ </Severity>
+ </Reaction>
+ </Alert>
+ <Alert>
+ <Type>
+ <Text>Allergy</Text>
+ </Type>
+ <Description>
+ <Text>A.E.R Traveler</Text>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Reaction>
+ <Description />
+ <Severity>
+ <Text>Severe</Text>
+ </Severity>
+ </Reaction>
+ </Alert>
+ </Alerts>
+ <Medications>
+ <Medication>
+ <Type />
+ <Description />
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>A& D</Text>
+ </ProductName>
+ <Strength>
+ <Units />
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier />
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description />
+ <DeliveryMethod />
+ <Dose>
+ <Units />
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier />
+ </Dose>
+ <Route>
+ <Text>To skin</Text>
+ <Code>
+ <Value>C38305</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier />
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills />
+ </Medication>
+ <Medication>
+ <Type />
+ <Description />
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>A-Fil</Text>
+ </ProductName>
+ <Strength>
+ <Units />
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier />
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description />
+ <DeliveryMethod />
+ <Dose>
+ <Units />
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier />
+ </Dose>
+ <Route>
+ <Text>To skin</Text>
+ <Code>
+ <Value>C38305</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier />
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills />
+ </Medication>
+ <Medication>
+ <Type />
+ <Description />
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>Lipitor</Text>
+ </ProductName>
+ <Strength>
+ <Units />
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier />
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description />
+ <DeliveryMethod />
+ <Dose>
+ <Units />
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier />
+ </Dose>
+ <Route>
+ <Text>By mouth</Text>
+ <Code>
+ <Value>C38288</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier />
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills />
+ </Medication>
+ </Medications>
+ <Immunizations>
+ <Immunization>
+ <Type />
+ <Description />
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>Chickenpox Vaccine</Text>
+ <Code>
+ <Value>21</Value>
+ <CodingSystem>HL7</CodingSystem>
+ </Code>
+ </ProductName>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description />
+ <DeliveryMethod />
+ </Direction>
+ </Directions>
+ <Refills />
+ </Immunization>
+ </Immunizations>
+ <VitalSigns>
+ <Result>
+ <Type />
+ <Description />
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance />
+ <Test>
+ <Type />
+ <Description>
+ <Text>Height</Text>
+ </Description>
+ <Status />
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier />
+ <Value>70</Value>
+ <Units>
+ <Unit>inches</Unit>
+ </Units>
+ </TestResult>
+ <ConfidenceValue />
+ </Test>
+ </Result>
+ <Result>
+ <Type />
+ <Description />
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance />
+ <Test>
+ <Type />
+ <Description>
+ <Text>Weight</Text>
+ </Description>
+ <Status />
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier />
+ <Value>2480</Value>
+ <Units>
+ <Unit>ounces</Unit>
+ </Units>
+ </TestResult>
+ <ConfidenceValue />
+ </Test>
+ </Result>
+ <Result>
+ <Type />
+ <Description />
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance />
+ <Test>
+ <Type />
+ <Description>
+ <Text>Blood Type</Text>
+ </Description>
+ <Status />
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier />
+ <Value>O+</Value>
+ <Units />
+ </TestResult>
+ <ConfidenceValue />
+ </Test>
+ </Result>
+ </VitalSigns>
+ <Results>
+ <Result>
+ <Type />
+ <Description />
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance />
+ <Test>
+ <DateTime>
+ <Type>
+ <Text>Collection start date</Text>
+ </Type>
+ <ExactDateTime>2008-09-03</ExactDateTime>
+ </DateTime>
+ <Type />
+ <Description>
+ <Text>Acetaldehyde - Blood</Text>
+ </Description>
+ <Status />
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier />
+ <Units />
+ </TestResult>
+ <ConfidenceValue />
+ </Test>
+ </Result>
+ </Results>
+ <Procedures>
+ <Procedure>
+ <Type />
+ <Description>
+ <Text>Abdominal Ultrasound</Text>
+ </Description>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Procedure>
+ <Procedure>
+ <Type />
+ <Description>
+ <Text>Abdominoplasty</Text>
+ </Description>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Procedure>
+ </Procedures>
+ </Body>
+ <Actors>
+ <Actor>
+ <ActorObjectID>Google Health Profile</ActorObjectID>
+ <Person>
+ <Name>
+ <BirthName />
+ <CurrentName />
+ </Name>
+ <DateOfBirth>
+ <Type />
+ <ExactDateTime>1984-07-22</ExactDateTime>
+ </DateOfBirth>
+ <Gender>
+ <Text>Male</Text>
+ </Gender>
+ </Person>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Actor>
+ </Actors>
+ </ContinuityOfCareRecord>
+</entry>"""
+
+HEALTH_PROFILE_FEED = """<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+xmlns:ccr="urn:astm-org:CCR" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:h9m="http://schemas.google.com/health/metadata">
+<id>https://www.google.com/health/feeds/profile/default</id>
+<updated>2008-09-30T01:07:17.888Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+<title type="text">Profile Feed</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default"/>
+<link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default"/>
+<link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/batch"/>
+<link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default?digest=false"/>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/DysasdfARnFAao</id>
+ <published>2008-09-29T03:12:50.850Z</published>
+ <updated>2008-09-29T03:12:50.850Z</updated>
+ <category term="MEDICATION"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="A& D"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/MEDICATION/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DA%26+D"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/DysasdfARnFAao"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/DysasdfARnFAao"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>hiD9sEigSzdk8nNT0evR4g</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Medications>
+ <Medication>
+ <Type/>
+ <Description/>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>A& D</Text>
+ </ProductName>
+ <Strength>
+ <Units/>
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier/>
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description/>
+ <DeliveryMethod/>
+ <Dose>
+ <Units/>
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier/>
+ </Dose>
+ <Route>
+ <Text>To skin</Text>
+ <Code>
+ <Value>C38305</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier/>
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills/>
+ </Medication>
+ </Medications>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/7I1WQzZrgp4</id>
+ <published>2008-09-29T03:27:14.909Z</published>
+ <updated>2008-09-29T03:27:14.909Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="A-Fil"/>
+ <category term="ALLERGY"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DA-Fil/ALLERGY"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/7I1WQzZrgp4"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/7I1WQzZrgp4"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>YOyHDxQUiECCPgnsjV8SlQ</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Alerts>
+ <Alert>
+ <Type>
+ <Text>Allergy</Text>
+ </Type>
+ <Description>
+ <Text>A-Fil</Text>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Reaction>
+ <Description/>
+ <Severity>
+ <Text>Severe</Text>
+ </Severity>
+ </Reaction>
+ </Alert>
+ </Alerts>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/Dz9wV83sKFg</id>
+ <published>2008-09-29T03:12:52.166Z</published>
+ <updated>2008-09-29T03:12:52.167Z</updated>
+ <category term="MEDICATION"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="A-Fil"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/MEDICATION/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DA-Fil"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/Dz9wV83sKFg"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/Dz9wV83sKFg"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>7w.XFEPeuIYN3Rn32pUiUw</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Medications>
+ <Medication>
+ <Type/>
+ <Description/>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>A-Fil</Text>
+ </ProductName>
+ <Strength>
+ <Units/>
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier/>
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description/>
+ <DeliveryMethod/>
+ <Dose>
+ <Units/>
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier/>
+ </Dose>
+ <Route>
+ <Text>To skin</Text>
+ <Code>
+ <Value>C38305</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier/>
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills/>
+ </Medication>
+ </Medications>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/lzsxVzqZUyw</id>
+ <published>2008-09-29T03:13:07.496Z</published>
+ <updated>2008-09-29T03:13:07.497Z</updated>
+ <category scheme="http://schemas.google.com/health/item" term="A.E.R Traveler"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="ALLERGY"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DA.E.R+Traveler/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/ALLERGY"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/lzsxVzqZUyw"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/lzsxVzqZUyw"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>5efFB0J2WgEHNUvk2z3A1A</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Alerts>
+ <Alert>
+ <Type>
+ <Text>Allergy</Text>
+ </Type>
+ <Description>
+ <Text>A.E.R Traveler</Text>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Reaction>
+ <Description/>
+ <Severity>
+ <Text>Severe</Text>
+ </Severity>
+ </Reaction>
+ </Alert>
+ </Alerts>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/6PvhfKAXyYw</id>
+ <published>2008-09-29T03:13:02.123Z</published>
+ <updated>2008-09-29T03:13:02.124Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="PROCEDURE"/>
+ <category scheme="http://schemas.google.com/health/item" term="Abdominal Ultrasound"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/PROCEDURE/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DAbdominal+Ultrasound"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/6PvhfKAXyYw"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/6PvhfKAXyYw"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>W3Wbvx_QHwG5pxVchpuF1A</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Procedures>
+ <Procedure>
+ <Type/>
+ <Description>
+ <Text>Abdominal Ultrasound</Text>
+ </Description>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Procedure>
+ </Procedures>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/r2zGPGewCeU</id>
+ <published>2008-09-29T03:13:03.434Z</published>
+ <updated>2008-09-29T03:13:03.435Z</updated>
+ <category scheme="http://schemas.google.com/health/item" term="Abdominoplasty"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="PROCEDURE"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DAbdominoplasty/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/PROCEDURE"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/r2zGPGewCeU"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/r2zGPGewCeU"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>OUKgj5X0KMnbkC5sDL.yHA</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Procedures>
+ <Procedure>
+ <Type/>
+ <Description>
+ <Text>Abdominoplasty</Text>
+ </Description>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Procedure>
+ </Procedures>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/_cCCbQ0O3ug</id>
+ <published>2008-09-29T03:13:29.041Z</published>
+ <updated>2008-09-29T03:13:29.042Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="Acetaldehyde - Blood"/>
+ <category term="LABTEST"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DAcetaldehyde+-+Blood/LABTEST"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/_cCCbQ0O3ug"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/_cCCbQ0O3ug"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>YWtomFb8aG.DueZ7z7fyug</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Results>
+ <Result>
+ <Type/>
+ <Description/>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance/>
+ <Test>
+ <DateTime>
+ <Type>
+ <Text>Collection start date</Text>
+ </Type>
+ <ExactDateTime>2008-09-03</ExactDateTime>
+ </DateTime>
+ <Type/>
+ <Description>
+ <Text>Acetaldehyde - Blood</Text>
+ </Description>
+ <Status/>
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier/>
+ <Units/>
+ </TestResult>
+ <ConfidenceValue/>
+ </Test>
+ </Result>
+ </Results>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/BdyA3iJZyCc</id>
+ <published>2008-09-29T03:00:45.915Z</published>
+ <updated>2008-09-29T03:00:45.915Z</updated>
+ <category scheme="http://schemas.google.com/health/item" term="Aortic valve disorders"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="CONDITION"/>
+ <title type="text">Aortic valve disorders</title>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DAortic+valve+disorders/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/CONDITION"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/BdyA3iJZyCc"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/BdyA3iJZyCc"/>
+ <author>
+ <name>example.com</name>
+ <uri>example.com</uri>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>h1ljpoeKJ85li.1FHsG9Gw</CCRDocumentObjectID>
+ <Body>
+ <Problems>
+ <Problem>
+ <CCRDataObjectID>Hn0FE0IlcY-FMFFgSTxkvA/CONDITION/0</CCRDataObjectID>
+ <DateTime>
+ <Type>
+ <Text>Start date</Text>
+ </Type>
+ <ExactDateTime>2007-04-04T07:00:00Z</ExactDateTime>
+ </DateTime>
+ <Description>
+ <Text>Aortic valve disorders</Text>
+ <Code>
+ <Value>410.10</Value>
+ <CodingSystem>ICD9</CodingSystem>
+ <Version>2004</Version>
+ </Code>
+ </Description>
+ <Status>
+ <Text>Active</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>example.com</ActorID>
+ <ActorRole>
+ <Text>Information Provider</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Problem>
+ </Problems>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/Cl.aMWIH5VA</id>
+ <published>2008-09-29T03:13:34.996Z</published>
+ <updated>2008-09-29T03:13:34.997Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="Chickenpox Vaccine"/>
+ <category term="IMMUNIZATION"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DChickenpox+Vaccine/IMMUNIZATION"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/Cl.aMWIH5VA"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/Cl.aMWIH5VA"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>KlhUqfftgELIitpKbqYalw</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Immunizations>
+ <Immunization>
+ <Type/>
+ <Description/>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>Chickenpox Vaccine</Text>
+ <Code>
+ <Value>21</Value>
+ <CodingSystem>HL7</CodingSystem>
+ </Code>
+ </ProductName>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description/>
+ <DeliveryMethod/>
+ </Direction>
+ </Directions>
+ <Refills/>
+ </Immunization>
+ </Immunizations>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/l0a7.FlX3_0</id>
+ <published>2008-09-29T03:14:47.461Z</published>
+ <updated>2008-09-29T03:14:47.461Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="DEMOGRAPHICS"/>
+ <category scheme="http://schemas.google.com/health/item" term="Demographics"/>
+ <title type="text">Demographics</title>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/DEMOGRAPHICS/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DDemographics"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/l0a7.FlX3_0"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/l0a7.FlX3_0"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>U5GDAVOxFbexQw3iyvqPYg</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body/>
+ <Actors>
+ <Actor>
+ <Person>
+ <Name>
+ <BirthName/>
+ <CurrentName/>
+ </Name>
+ <DateOfBirth>
+ <Type/>
+ <ExactDateTime>1984-07-22</ExactDateTime>
+ </DateOfBirth>
+ <Gender>
+ <Text>Male</Text>
+ </Gender>
+ </Person>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Actor>
+ </Actors>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/oIBDdgwFLyo</id>
+ <published>2008-09-29T03:14:47.690Z</published>
+ <updated>2008-09-29T03:14:47.691Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="DEMOGRAPHICS"/>
+ <category scheme="http://schemas.google.com/health/item" term="FunctionalStatus"/>
+ <title type="text">FunctionalStatus</title>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/DEMOGRAPHICS/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DFunctionalStatus"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/oIBDdgwFLyo"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/oIBDdgwFLyo"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>W.EJcnhxb7W5M4eR4Tr1YA</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <FunctionalStatus>
+ <Function>
+ <Type>
+ <Text>Pregnancy status</Text>
+ </Type>
+ <Description>
+ <Text>Not pregnant</Text>
+ </Description>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Function>
+ <Function>
+ <Type>
+ <Text>Breastfeeding status</Text>
+ </Type>
+ <Description>
+ <Text>Not breastfeeding</Text>
+ </Description>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Function>
+ </FunctionalStatus>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/wwljIlXuTVg</id>
+ <published>2008-09-29T03:26:10.080Z</published>
+ <updated>2008-09-29T03:26:10.081Z</updated>
+ <category term="MEDICATION"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="Lipitor"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/MEDICATION/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DLipitor"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/wwljIlXuTVg"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/wwljIlXuTVg"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>OrpghzvvbG_YaO5koqT2ug</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Medications>
+ <Medication>
+ <Type/>
+ <Description/>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>Lipitor</Text>
+ </ProductName>
+ <Strength>
+ <Units/>
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier/>
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description/>
+ <DeliveryMethod/>
+ <Dose>
+ <Units/>
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier/>
+ </Dose>
+ <Route>
+ <Text>By mouth</Text>
+ <Code>
+ <Value>C38288</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier/>
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills/>
+ </Medication>
+ </Medications>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/dd09TR12SiY</id>
+ <published>2008-09-29T07:52:17.175Z</published>
+ <updated>2008-09-29T07:52:17.176Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="Malaria"/>
+ <category term="CONDITION"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DMalaria/CONDITION"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/dd09TR12SiY"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/dd09TR12SiY"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>XF99N6X4lpy.jfPUPLMMSQ</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Problems>
+ <Problem>
+ <Type/>
+ <Description>
+ <Text>Malaria</Text>
+ <Code>
+ <Value>136.9</Value>
+ <CodingSystem>ICD9_Broader</CodingSystem>
+ </Code>
+ <Code>
+ <Value>084.6</Value>
+ <CodingSystem>ICD9</CodingSystem>
+ </Code>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <HealthStatus>
+ <Description/>
+ </HealthStatus>
+ </Problem>
+ </Problems>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/aS0Cf964DPs</id>
+ <published>2008-09-29T03:14:47.463Z</published>
+ <updated>2008-09-29T03:14:47.463Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="DEMOGRAPHICS"/>
+ <category scheme="http://schemas.google.com/health/item" term="SocialHistory (Drinking, Smoking)"/>
+ <title type="text">SocialHistory (Drinking, Smoking)</title>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/DEMOGRAPHICS/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DSocialHistory+%28Drinking%2C+Smoking%29"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/aS0Cf964DPs"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/aS0Cf964DPs"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>kXylGU5YXLBzriv61xPGZQ</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <SocialHistory>
+ <SocialHistoryElement>
+ <Type>
+ <Text>Race</Text>
+ <Code>
+ <Value>S15814</Value>
+ <CodingSystem>HL7</CodingSystem>
+ </Code>
+ </Type>
+ <Description>
+ <Text>White</Text>
+ </Description>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Episodes>
+ <Frequency>
+ <Units/>
+ </Frequency>
+ </Episodes>
+ </SocialHistoryElement>
+ </SocialHistory>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/s5lII5xfj_g</id>
+ <published>2008-09-29T03:14:47.544Z</published>
+ <updated>2008-09-29T03:14:47.545Z</updated>
+ <category scheme="http://schemas.google.com/health/item" term="VitalSigns"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="DEMOGRAPHICS"/>
+ <title type="text">VitalSigns</title>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DVitalSigns/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/DEMOGRAPHICS"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/s5lII5xfj_g"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/s5lII5xfj_g"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>FTTIiY0TVVj35kZqFFjPjQ</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <VitalSigns>
+ <Result>
+ <Type/>
+ <Description/>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance/>
+ <Test>
+ <Type/>
+ <Description>
+ <Text>Height</Text>
+ </Description>
+ <Status/>
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier/>
+ <Value>70</Value>
+ <Units>
+ <Unit>inches</Unit>
+ </Units>
+ </TestResult>
+ <ConfidenceValue/>
+ </Test>
+ </Result>
+ <Result>
+ <Type/>
+ <Description/>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance/>
+ <Test>
+ <Type/>
+ <Description>
+ <Text>Weight</Text>
+ </Description>
+ <Status/>
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier/>
+ <Value>2480</Value>
+ <Units>
+ <Unit>ounces</Unit>
+ </Units>
+ </TestResult>
+ <ConfidenceValue/>
+ </Test>
+ </Result>
+ <Result>
+ <Type/>
+ <Description/>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance/>
+ <Test>
+ <Type/>
+ <Description>
+ <Text>Blood Type</Text>
+ </Description>
+ <Status/>
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier/>
+ <Value>O+</Value>
+ <Units/>
+ </TestResult>
+ <ConfidenceValue/>
+ </Test>
+ </Result>
+ </VitalSigns>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+</feed>"""
+
+HEALTH_PROFILE_LIST_ENTRY = """ <entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'>
+ <id>
+ https://www.google.com/health/feeds/profile/list/vndCn5sdfwdEIY</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <title type='text'>profile name</title>
+ <content type='text'>vndCn5sdfwdEIY</content>
+ <link rel='self' type='application/atom+xml'
+ href='https://www.google.com/health/feeds/profile/list/vndCn5sdfwdEIY' />
+ <link rel='edit' type='application/atom+xml'
+ href='https://www.google.com/health/feeds/profile/list/vndCn5sdfwdEIY' />
+ <author>
+ <name>user@gmail.com</name>
+ </author>
+</entry>"""
+
+BOOK_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>"""\
+ """<entry xmlns='http://www.w3.org/2005/Atom' xmlns:gbs='http://schemas.google.com/books/2008' xmlns:dc='http://purl.org/dc/terms' xmlns:gd='http://schemas.google.com/g/2005'>"""\
+ """<id>http://www.google.com/books/feeds/volumes/b7GZr5Btp30C</id>"""\
+ """<updated>2009-04-24T23:35:16.000Z</updated>"""\
+ """<category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/books/2008#volume'/>"""\
+ """<title type='text'>A theory of justice</title>"""\
+ """<link rel='http://schemas.google.com/books/2008/thumbnail' type='image/x-unknown' href='http://bks0.books.google.com/books?id=b7GZr5Btp30C&printsec=frontcover&img=1&zoom=5&sig=ACfU3U121bWZsbjBfVwVRSK2o982jJTd1w&source=gbs_gdata'/>"""\
+ """<link rel='http://schemas.google.com/books/2008/info' type='text/html' href='http://books.google.com/books?id=b7GZr5Btp30C&ie=ISO-8859-1&source=gbs_gdata'/>"""\
+ """<link rel='http://schemas.google.com/books/2008/annotation' type='application/atom+xml' href='http://www.google.com/books/feeds/users/me/volumes'/>"""\
+ """<link rel='alternate' type='text/html' href='http://books.google.com/books?id=b7GZr5Btp30C&ie=ISO-8859-1'/>"""\
+ """<link rel='self' type='application/atom+xml' href='http://www.google.com/books/feeds/volumes/b7GZr5Btp30C'/>"""\
+ """<gbs:embeddability value='http://schemas.google.com/books/2008#embeddable'/>"""\
+ """<gbs:openAccess value='http://schemas.google.com/books/2008#disabled'/>"""\
+ """<gd:rating min='1' max='5' average='4.00'/>"""\
+ """<gbs:viewability value='http://schemas.google.com/books/2008#view_partial'/>"""\
+ """<dc:creator>John Rawls</dc:creator>"""\
+ """<dc:date>1999</dc:date>"""\
+ """<dc:description>p Since it appeared in 1971, John Rawls's i A Theory of Justice /i has become a classic. The author has now revised the original edition to clear up a number of difficulties he and others have found in the original book. /p p Rawls aims to express an essential part of the common core of the democratic tradition--justice as fairness--and to provide an alternative to utilitarianism, which had dominated the Anglo-Saxon tradition of political thought since the nineteenth century. Rawls substitutes the ideal of the social contract as a more satisfactory account of the basic rights and liberties of citizens as free and equal persons. "Each person," writes Rawls, "possesses an inviolability founded on justice that even the welfare of society as a whole cannot override." Advancing the ideas of Rousseau, Kant, Emerson, and Lincoln, Rawls's theory is as powerful today as it was when first published. /p</dc:description>"""\
+ """<dc:format>538 pages</dc:format>"""\
+ """<dc:identifier>b7GZr5Btp30C</dc:identifier>"""\
+ """<dc:identifier>ISBN:0198250541</dc:identifier>"""\
+ """<dc:identifier>ISBN:9780198250548</dc:identifier>"""\
+ """<dc:language>en</dc:language>"""\
+ """<dc:publisher>Oxford University Press</dc:publisher>"""\
+ """<dc:title>A theory of justice</dc:title>"""\
+"""</entry>"""
+
+BOOK_FEED = """<?xml version='1.0' encoding='UTF-8'?>"""\
+ """<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gbs='http://schemas.google.com/books/2008' xmlns:dc='http://purl.org/dc/terms' xmlns:gd='http://schemas.google.com/g/2005'>"""\
+ """<id>http://www.google.com/books/feeds/volumes</id>"""\
+ """<updated>2009-04-24T23:39:47.000Z</updated>"""\
+ """<category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/books/2008#volume'/>"""\
+ """<title type='text'>Search results for 9780198250548</title>"""\
+ """<link rel='alternate' type='text/html' href='http://www.google.com'/>"""\
+ """<link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://www.google.com/books/feeds/volumes'/>"""\
+ """<link rel='self' type='application/atom+xml' href='http://www.google.com/books/feeds/volumes?q=9780198250548'/>"""\
+ """<author>"""\
+ """<name>Google Books Search</name>"""\
+ """<uri>http://www.google.com</uri>"""\
+ """</author>"""\
+ """<generator version='beta'>Google Book Search data API</generator>"""\
+ """<openSearch:totalResults>1</openSearch:totalResults>"""\
+ """<openSearch:startIndex>1</openSearch:startIndex>"""\
+ """<openSearch:itemsPerPage>20</openSearch:itemsPerPage>"""\
+ """<entry>"""\
+ """<id>http://www.google.com/books/feeds/volumes/b7GZr5Btp30C</id>"""\
+ """<updated>2009-04-24T23:39:47.000Z</updated>"""\
+ """<category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/books/2008#volume'/>"""\
+ """<title type='text'>A theory of justice</title>"""\
+ """<link rel='http://schemas.google.com/books/2008/thumbnail' type='image/x-unknown' href='http://bks9.books.google.com/books?id=b7GZr5Btp30C&printsec=frontcover&img=1&zoom=5&sig=ACfU3U121bWZsbjBfVwVRSK2o982jJTd1w&source=gbs_gdata'/>"""\
+ """<link rel='http://schemas.google.com/books/2008/info' type='text/html' href='http://books.google.com/books?id=b7GZr5Btp30C&dq=9780198250548&ie=ISO-8859-1&source=gbs_gdata'/>"""\
+ """<link rel='http://schemas.google.com/books/2008/preview' type='text/html' href='http://books.google.com/books?id=b7GZr5Btp30C&pg=PA494&dq=9780198250548&ie=ISO-8859-1&source=gbs_gdata'/>"""\
+ """<link rel='http://schemas.google.com/books/2008/annotation' type='application/atom+xml' href='http://www.google.com/books/feeds/users/me/volumes'/>"""\
+ """<link rel='alternate' type='text/html' href='http://books.google.com/books?id=b7GZr5Btp30C&dq=9780198250548&ie=ISO-8859-1'/>"""\
+ """<link rel='self' type='application/atom+xml' href='http://www.google.com/books/feeds/volumes/b7GZr5Btp30C'/>"""\
+ """<gbs:embeddability value='http://schemas.google.com/books/2008#embeddable'/>"""\
+ """<gbs:openAccess value='http://schemas.google.com/books/2008#disabled'/>"""\
+ """<gbs:viewability value='http://schemas.google.com/books/2008#view_partial'/>"""\
+ """<dc:creator>John Rawls</dc:creator>"""\
+ """<dc:date>1999</dc:date>"""\
+ """<dc:description>... 9780198250548 ...</dc:description>"""\
+ """<dc:format>538 pages</dc:format>"""\
+ """<dc:identifier>b7GZr5Btp30C</dc:identifier>"""\
+ """<dc:identifier>ISBN:0198250541</dc:identifier>"""\
+ """<dc:identifier>ISBN:9780198250548</dc:identifier>"""\
+ """<dc:subject>Law</dc:subject>"""\
+ """<dc:title>A theory of justice</dc:title>"""\
+ """</entry>"""\
+"""</feed>"""
+
+MAP_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CkIESHg4eSp7ImA9WxJbF08."">
+ <id>http://maps.google.com/maps/feeds/maps/208825816854482607313</id>
+ <updated>2009-07-27T18:48:29.631Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#map"/>
+ <title>My maps</title>
+ <link rel="alternate" type="text/html" href="http://maps.google.com/maps/ms?msa=1"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full"/>
+ <link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full"/>
+ <link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full/batch"/>
+ <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full"/>
+ <author>
+ <name>Roman</name>
+ </author>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1</openSearch:itemsPerPage>
+ <entry gd:etag="W/"CkIESHg4eSp7ImA9WxJbF08."">
+ <id>http://maps.google.com/maps/feeds/maps/208825816854482607313/00046fb45f88fa910bcea</id>
+ <published>2009-07-27T18:46:34.451Z</published>
+ <updated>2009-07-27T18:48:29.631Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:48:29.631Z</app:edited>
+ <app:control xmlns:app="http://www.w3.org/2007/app">
+ <app:draft>yes</app:draft>
+ </app:control>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#map"/>
+ <title>Untitled</title>
+ <summary/>
+ <content src="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full"/>
+ <link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full/00046fb45f88fa910bcea"/>
+ <link rel="alternate" type="text/html" href="http://maps.google.com/maps/ms?msa=0&msid=208825816854482607313.00046fb45f88fa910bcea"/>
+ <link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full/00046fb45f88fa910bcea"/>
+ <author>
+ <name>Roman</name>
+ </author>
+ </entry>
+</feed>
+"""
+
+MAP_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns="http://www.w3.org/2005/Atom" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CkIESHg4eSp7ImA9WxJbF08."">
+ <id>http://maps.google.com/maps/feeds/maps/208825816854482607313/00046fb45f88fa910bcea</id>
+ <published>2009-07-27T18:46:34.451Z</published>
+ <updated>2009-07-27T18:48:29.631Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:48:29.631Z</app:edited>
+ <app:control xmlns:app="http://www.w3.org/2007/app">
+ <app:draft>yes</app:draft>
+ </app:control>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#map"/>
+ <title>Untitled</title>
+ <summary/>
+ <content src="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full"/>
+ <link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full/00046fb45f88fa910bcea"/>
+ <link rel="alternate" type="text/html" href="http://maps.google.com/maps/ms?msa=0&msid=208825816854482607313.00046fb45f88fa910bcea"/>
+ <link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full/00046fb45f88fa910bcea"/>
+ <author>
+ <name>Roman</name>
+ </author>
+</entry>
+"""
+
+MAP_FEATURE_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:feed xmlns="http://www.opengis.net/kml/2.2" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CkIESHg4eSp7ImA9WxJbF08."">
+ <atom:id>http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea</atom:id>
+ <atom:updated>2009-07-27T18:48:29.631Z</atom:updated>
+ <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#feature"/>
+ <atom:title>Untitled</atom:title>
+ <atom:link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full"/>
+ <atom:link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full"/>
+ <atom:link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/batch"/>
+ <atom:link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full"/>
+ <openSearch:totalResults>4</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>4</openSearch:itemsPerPage>
+ <atom:entry gd:etag="W/"CkMBRH44fyp7ImA9WxJbF08."">
+ <atom:id>http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/00046fb4632573b19e0b7</atom:id>
+ <atom:published>2009-07-27T18:47:35.037Z</atom:published>
+ <atom:updated>2009-07-27T18:47:35.037Z</atom:updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:47:35.037Z</app:edited>
+ <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#feature"/>
+ <atom:title>Some feature title</atom:title>
+ <atom:content type="application/vnd.google-earth.kml+xml">
+ <Placemark>
+ <name>Some feature title</name>
+ <description><![CDATA[<div dir="ltr">Some feature content</div>]]></description>
+ <Style>
+ <IconStyle>
+ <Icon>
+ <href>http://maps.gstatic.com/intl/en_us/mapfiles/ms/micons/ylw-pushpin.png</href>
+ </Icon>
+ </IconStyle>
+ </Style>
+ <Point>
+ <coordinates>-113.818359,41.442726,0.0</coordinates>
+ </Point>
+ </Placemark>
+ </atom:content>
+ <atom:link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb4632573b19e0b7"/>
+ <atom:link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb4632573b19e0b7"/>
+ <atom:author>
+ <atom:name>Roman</atom:name>
+ </atom:author>
+ <atom:contributor>
+ <atom:name>Roman</atom:name>
+ </atom:contributor>
+ </atom:entry>
+ <atom:entry gd:etag="W/"CkIEQ38zfCp7ImA9WxJbF08."">
+ <atom:id>http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/00046fb46325e839a11e6</atom:id>
+ <atom:published>2009-07-27T18:47:35.067Z</atom:published>
+ <atom:updated>2009-07-27T18:48:22.184Z</atom:updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:48:22.184Z</app:edited>
+ <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#feature"/>
+ <atom:title>A cool poly!</atom:title>
+ <atom:content type="application/vnd.google-earth.kml+xml">
+ <Placemark>
+ <name>A cool poly!</name>
+ <description><![CDATA[<div dir="ltr">And a description</div>]]></description>
+ <Style>
+ <LineStyle>
+ <color>FF0066FF</color>
+ <width>3</width>
+ </LineStyle>
+ <PolyStyle>
+ <color>730099FF</color>
+ <fill>1</fill>
+ <outline>1</outline>
+ </PolyStyle>
+ </Style>
+ <Polygon>
+ <outerBoundaryIs>
+ <LinearRing>
+ <tessellate>1</tessellate>
+ <coordinates>-109.775391,47.457809,0.0 -99.755859,51.508742,0.0 -92.900391,48.04871,0.0 -92.8125,44.339565,0.0 -95.273437,44.402392,0.0 -97.207031,46.619261,0.0 -100.898437,46.073231,0.0 -102.480469,43.068888,0.0 -110.742187,45.274886,0.0 -109.775391,47.457809,0.0 </coordinates>
+ </LinearRing>
+ </outerBoundaryIs>
+ </Polygon>
+ </Placemark>
+ </atom:content>
+ <atom:link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb46325e839a11e6"/>
+ <atom:link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb46325e839a11e6"/>
+ <atom:author>
+ <atom:name>Roman</atom:name>
+ </atom:author>
+ <atom:contributor>
+ <atom:name>Roman</atom:name>
+ </atom:contributor>
+ </atom:entry>
+ <atom:entry gd:etag="W/"CkIEQ38yfCp7ImA9WxJbF08."">
+ <atom:id>http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/00046fb465f5002e56b7a</atom:id>
+ <atom:published>2009-07-27T18:48:22.194Z</atom:published>
+ <atom:updated>2009-07-27T18:48:22.194Z</atom:updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:48:22.194Z</app:edited>
+ <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#feature"/>
+ <atom:title>New Mexico</atom:title>
+ <atom:content type="application/vnd.google-earth.kml+xml">
+ <Placemark>
+ <name>New Mexico</name>
+ <description><![CDATA[<div dir="ltr">Word.</div>]]></description>
+ <Style>
+ <LineStyle>
+ <color>73009900</color>
+ <width>5</width>
+ </LineStyle>
+ </Style>
+ <LineString>
+ <tessellate>1</tessellate>
+ <coordinates>-110.039062,37.788081,0.0 -103.183594,37.926868,0.0 -103.183594,32.472695,0.0 -108.896484,32.026706,0.0 -109.863281,31.203405,0.0 -110.039062,37.788081,0.0 </coordinates>
+ </LineString>
+ </Placemark>
+ </atom:content>
+ <atom:link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb465f5002e56b7a"/>
+ <atom:link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb465f5002e56b7a"/>
+ <atom:author>
+ <atom:name>Roman</atom:name>
+ </atom:author>
+ <atom:contributor>
+ <atom:name>Roman</atom:name>
+ </atom:contributor>
+ </atom:entry>
+</atom:feed>
+"""
+
+MAP_FEATURE_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns="http://www.opengis.net/kml/2.2" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CkMBRH44fyp7ImA9WxJbF08."">
+ <atom:id>http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/00046fb4632573b19e0b7</atom:id>
+ <atom:published>2009-07-27T18:47:35.037Z</atom:published>
+ <atom:updated>2009-07-27T18:47:35.037Z</atom:updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:47:35.037Z</app:edited>
+ <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#feature"/>
+ <atom:title>Some feature title</atom:title>
+ <atom:content type="application/vnd.google-earth.kml+xml">
+ <Placemark>
+ <name>Some feature title</name>
+ <description><![CDATA[<div dir="ltr">Some feature content</div>]]></description>
+ <Style>
+ <IconStyle>
+ <Icon>
+ <href>http://maps.gstatic.com/intl/en_us/mapfiles/ms/micons/ylw-pushpin.png</href>
+ </Icon>
+ </IconStyle>
+ </Style>
+ <Point>
+ <coordinates>-113.818359,41.442726,0.0</coordinates>
+ </Point>
+ </Placemark>
+ </atom:content>
+ <atom:link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb4632573b19e0b7"/>
+ <atom:link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb4632573b19e0b7"/>
+ <atom:author>
+ <atom:name>Roman</atom:name>
+ </atom:author>
+ <atom:contributor>
+ <atom:name>Roman</atom:name>
+ </atom:contributor>
+</atom:entry>
+"""
+
+MAP_FEATURE_KML = """<Placemark>
+ <name>Some feature title</name>
+ <description><![CDATA[<div dir="ltr">Some feature content</div>]]></description>
+ <Style>
+ <IconStyle>
+ <Icon>
+ <href>http://maps.gstatic.com/intl/en_us/mapfiles/ms/micons/ylw-pushpin.png</href>
+ </Icon>
+ </IconStyle>
+ </Style>
+ <Point>
+ <coordinates>-113.818359,41.442726,0.0</coordinates>
+ </Point>
+</Placemark>
+"""
+
+SITES_LISTPAGE_ENTRY = '''<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns="http://www.w3.org/2005/Atom">
+ <id>http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703</id>
+ <updated>2009-06-16T00:37:37.393Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#listpage"/>
+ <title type="text">ListPagesTitle</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <jot:section xmlns:jot="http://www.google.com/ns/jotspot/srvtmpl/" target="content-1">
+ <div dir="ltr">stuff go here<div>asdf</div>
+ <div>sdf</div>
+ <div>
+ <br/>
+ </div>
+ </div>
+ </jot:section>
+ </div>
+ </content>
+ <link rel="self" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703"/>
+ <link rel="edit" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <gs:worksheet xmlns:gs="http://schemas.google.com/spreadsheets/2006" name="listpage"/>
+ <gs:header xmlns:gs="http://schemas.google.com/spreadsheets/2006" row="1"/>
+ <gs:data xmlns:gs="http://schemas.google.com/spreadsheets/2006" startRow="2">
+ <gs:column index="A" name="Owner"/>
+ <gs:column index="B" name="Description"/>
+ <gs:column index="C" name="Resolution"/>
+ <gs:column index="D" name="Complete"/>
+ <gs:column index="E" name="MyCo"/>
+ </gs:data>
+ <gd:feedLink xmlns:gd="http://schemas.google.com/g/2005" href="http:///sites.google.com/feeds/content/site/gdatatestsite?parent=abc"/>
+</entry>'''
+
+SITES_COMMENT_ENTRY = '''<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns="http://www.w3.org/2005/Atom">
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-15T18:40:22.407Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#comment"/>
+ <title type="text"/>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">first comment</div>
+ </content>
+ <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123parent"/>
+ <link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <thr:in-reply-to xmlns:thr="http://purl.org/syndication/thread/1.0" href="http://sites.google.com/site/gdatatestsite/annoucment/testpost" ref="http://sites.google.com/feeds/content/site/gdatatestsite/abc123" source="http://sites.google.com/feeds/content/site/gdatatestsite" type="text/html"/>
+</entry>'''
+
+SITES_LISTITEM_ENTRY = '''<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns="http://www.w3.org/2005/Atom">
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-16T00:34:55.633Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#listitem"/>
+ <title type="text"/>
+ <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123def"/>
+ <link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="A" name="Owner">test value</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="B" name="Description">test</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="C" name="Resolution">90</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="D" name="Complete"/>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="E" name="MyCo">2009-05-31</gs:field>
+</entry>'''
+
+SITES_CONTENT_FEED = '''<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
+xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006"
+xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch"
+xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0">
+<id>http://sites.google.com/feeds/content/site/gdatatestsite</id>
+<updated>2009-06-15T21:35:43.282Z</updated>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite"/>
+<link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite"/>
+<generator version="1" uri="http://sites.google.com">Google Sites</generator>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+ <id>http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703</id>
+ <updated>2009-06-16T00:37:37.393Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#listpage"/>
+ <title type="text">ListPagesTitle</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <jot:section xmlns:jot="http://www.google.com/ns/jotspot/srvtmpl/" target="content-1">
+ <div dir="ltr">stuff go here<div>asdf</div>
+ <div>sdf</div>
+ <div>
+ <br/>
+ </div>
+ </div>
+ </jot:section>
+ </div>
+ </content>
+ <link rel="alternate" type="text/html" href="http:///sites.google.com/site/gdatatestsite/asdfsdfsdf"/>
+ <link rel="self" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703"/>
+ <link rel="edit" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703"/>
+ <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/12345"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <gs:worksheet xmlns:gs="http://schemas.google.com/spreadsheets/2006" name="listpage"/>
+ <gs:header xmlns:gs="http://schemas.google.com/spreadsheets/2006" row="1"/>
+ <gs:data xmlns:gs="http://schemas.google.com/spreadsheets/2006" startRow="2">
+ <gs:column index="A" name="Owner"/>
+ <gs:column index="B" name="Description"/>
+ <gs:column index="C" name="Resolution"/>
+ <gs:column index="D" name="Complete"/>
+ <gs:column index="E" name="MyCo"/>
+ </gs:data>
+ <sites:revision>2</sites:revision>
+ <gd:deleted/>
+ <sites:pageName>home</sites:pageName>
+ <gd:feedLink xmlns:gd="http://schemas.google.com/g/2005" href="http://sites.google.com/feeds/content/site/gdatatestsite?parent=abc"/>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-17T00:40:37.082Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#filecabinet"/>
+ <title type="text">filecabinet</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <jot:section xmlns:jot="http://www.google.com/ns/jotspot/srvtmpl/" target="content-1">
+ <div dir="ltr">sdf</div>
+ </jot:section>
+</div>
+</content>
+<link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+<gd:feedLink xmlns:gd="http://schemas.google.com/g/2005" href="http://sites.google.com/feeds/content/site/gdatatestsite?parent=8472761212299270332"/>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-16T00:34:55.633Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#listitem"/>
+ <title type="text"/>
+ <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123def"/>
+ <link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="A" name="Owner">test value</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="B" name="Description">test</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="C" name="Resolution">90</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="D" name="Complete"/>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="E" name="MyCo">2009-05-31</gs:field>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-15T18:40:32.922Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#attachment"/>
+ <title type="text">testFile.ods</title>
+ <link rel="alternate" type="application/vnd.oasis.opendocument.spreadsheet" href="http://sites.google.com/feeds/SOMELONGURL"/>
+ <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <gd:deleted/>
+ <sites:pageName>something else</sites:pageName>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-15T18:40:22.407Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#comment"/>
+ <title type="text"/>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">first comment</div>
+ </content>
+ <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <thr:in-reply-to xmlns:thr="http://purl.org/syndication/thread/1.0" href="http://sites.google.com/site/gdatatestsite/annoucment/testpost" ref="http://sites.google.com/feeds/content/site/gdatatestsite/abc123" source="http://sites.google.com/feeds/content/site/gdatatestsite" type="text/html"/>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-15T18:40:16.388Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#announcement"/>
+ <title type="text">TestPost</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <jot:section xmlns:jot="http://www.google.com/ns/jotspot/srvtmpl/" target="content-1">
+ <div dir="ltr">content goes here</div>
+ </jot:section>
+</div>
+</content>
+<link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+</author>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-12T23:37:59.417Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#webpage"/>
+ <title type="text">Home</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <jot:section xmlns:jot="http://www.google.com/ns/jotspot/srvtmpl/" target="content-1">
+ <div dir="ltr">Some Content goes here<div>
+ <br/>
+ </div>
+ <div>
+ <jot:embed height="300" id="4981865780428052" props="align:left;width:250;maxDepth:6" src="http://www.google.com/chart?SOMELONGURL" style="display: block; text-align: left; " type="toc" width="250"/>
+ <br/>
+ </div>
+</div>
+</jot:section>
+</div>
+</content>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+</author>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/2639323850129333500</id>
+ <updated>2009-06-12T23:32:09.191Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#announcementspage"/>
+ <title type="text">annoucment</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ </div>
+</content>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+</author>
+<gd:feedLink xmlns:gd="http://schemas.google.com/g/2005" href="http://sites.google.com/feeds/content/site/gdatatestsite?parent=abc123"/>
+</entry>
+</feed>'''
+
+SITES_ACTIVITY_FEED = '''<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/">
+<id>http://sites.google.com/feeds/activity/site/siteName</id>
+<updated>2009-08-19T05:46:01.503Z</updated>
+<title>Activity</title>
+<link rel="alternate" type="text/html" href="http://sites.google.com/a/site/siteName/system/app/pages/recentChanges"/>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://sites.google.com/feeds/activity/site/siteName"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/activity/site/siteName"/>
+<generator version="1" uri="http://sites.google.com">Google Sites</generator>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"DUENSH0zfyl7ImA9WxNTFEs."">
+<id>http://sites.google.com/feeds/activity/site/siteName/197441951793148343</id>
+<updated>2009-08-17T00:08:19.387Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#deletion" label="deletion"/>
+<title>NewWebpage3</title>
+<summary type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">User deleted <a href="http://sites.google.com/site/siteName/newwebpage">NewWebpage3</a>
+</div>
+</summary>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http://sites.google.com/feeds/revision/site/siteName/6397361387376148502"/>
+<link rel="http://schemas.google.com/sites/2008#current" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/siteName/6397361387376148502"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/activity/site/siteName/197441951793148343"/>
+<author>
+ <name>User</name>
+ <email>user@gmail.com</email>
+</author>
+</entry>
+<entry xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"DUEMQnk6eSl7ImA9WxNTFEs."">
+<id>http://sites.google.com/feeds/activity/site/siteName/7299542210274956360</id>
+<updated>2009-08-17T00:08:03.711Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#edit" label="edit"/>
+<title>NewWebpage3</title>
+<summary type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">User edited <a href="http://sites.google.com/site/siteName/newwebpage">NewWebpage3</a>
+</div>
+</summary>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http://sites.google.com/feeds/revision/site/siteName/6397361387376148502"/>
+<link rel="http://schemas.google.com/sites/2008#current" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/siteName/6397361387376148502"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/activity/site/siteName/7299542210274956360"/>
+<author>
+ <name>User</name>
+ <email>user@gmail.com</email>
+</author>
+</entry>
+</feed>'''
+
+SITES_REVISION_FEED = '''
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0">
+<id>http://sites.google.com/feeds/revision/site/siteName/2947510322163358574</id>
+<updated>2009-08-19T06:20:18.151Z</updated>
+<title>Revisions</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://sites.google.com/feeds/revision/2947510322163358574"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/revision/site/siteName/2947510322163358574"/>
+<generator version="1" uri="http://sites.google.com">Google Sites</generator>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry gd:etag="W/"DEQNRXY-fil7ImA9WxNTFkg."">
+<id>http://sites.google.com/feeds/revision/site/siteName/2947510322163358574/1</id>
+<updated>2009-08-19T04:33:14.856Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#comment" label="comment"/>
+<title/>
+<content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <table cellspacing="0" class="sites-layout-name-one-column sites-layout-hbox">
+ <tbody>
+ <tr>
+ <td class="sites-layout-tile sites-tile-name-content-1">testcomment</td>
+ </tr>
+ </tbody>
+ </table>
+</div>
+</content>
+<link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/siteName/54395424125706119"/>
+<link rel="alternate" type="text" href="http://sites.google.com/site/system/app/pages/admin/compare?wuid=wuid%3Agx%3A28e7a9057c581b6e&rev1=1"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/revision/site/siteName/2947510322163358574/1"/>
+<author>
+ <name>User</name>
+ <email>user@gmail.com</email>
+</author>
+<thr:in-reply-to href="http://sites.google.com/site/siteName/code/js" ref="http://sites.google.com/feeds/content/site/siteName/54395424125706119" source="http://sites.google.com/feeds/content/google.com/siteName" type="text/html;charset=UTF-8"/>
+<sites:revision>1</sites:revision>
+</entry>
+</feed>'''
+
+SITES_SITE_FEED = '''
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:gAcl="http://schemas.google.com/acl/2007" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0">
+<id>https://sites.google.com/feeds/site/example.com</id>
+<updated>2009-12-09T01:05:54.631Z</updated>
+<title>Site</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com"/>
+<link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com"/>
+<link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com"/>
+<generator version="1" uri="http://sites.google.com">Google Sites</generator>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry gd:etag="W/"DkIHQH4_eCl7I2A9WxNaF0Q."">
+<id>https://sites.google.com/feeds/site/example.com/new-test-site</id>
+<updated>2009-12-02T22:55:31.040Z</updated>
+<app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-02T22:55:31.040Z</app:edited>
+<title>New Test Site</title>
+<summary>A new site to hold memories</summary>
+<link rel="alternate" type="text/html" href="http://sites.google.com/a/example.com/new-test-site/"/>
+<link rel="http://schemas.google.com/sites/2008#source" type="application/atom+xml" href="http://sites.google.com/feeds/site/example.com/source-site"/>
+<link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="http://sites.google.com/feeds/acl/site/example.com/new-test-site"/>
+<link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/new-test-site"/>
+<link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/new-test-site"/>
+<sites:siteName>new-test-site</sites:siteName>
+<sites:theme>iceberg</sites:theme>
+</entry>
+<entry gd:etag="W/"CE8MQH48fyl7I2A9WxNaGUo."">
+<id>https://sites.google.com/feeds/site/example.com/newautosite2</id>
+<updated>2009-12-05T00:28:01.077Z</updated>
+<app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-05T00:28:01.077Z</app:edited>
+<title>newAutoSite3</title>
+<summary>A new site to hold memories2</summary>
+<link rel="alternate" type="text/html" href="http://sites.google.com/a/example.com/newautosite2/"/>
+<link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="http://sites.google.com/feeds/acl/site/examp.e.com/newautosite2"/>
+<link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/newautosite2"/>
+<link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/newautosite2"/>
+<sites:siteName>newautosite2</sites:siteName>
+<sites:theme>default</sites:theme>
+</entry>
+</feed>'''
+
+SITES_ACL_FEED = '''
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:gAcl="http://schemas.google.com/acl/2007" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0">
+<id>https://sites.google.comsites.google.com/feeds/acl/site/example.com/new-test-site</id>
+<updated>2009-12-09T01:24:59.080Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/>
+<title>Acl</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/new-test-site"/>
+<link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/new-test-site"/>
+<link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/new-test-site"/>
+<generator version="1" uri="http://sites.google.com">Google Sites</generator>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+ <id>https://sites.google.com/feeds/acl/site/google.com/new-test-site/user%3Auser%40example.com</id>
+ <updated>2009-12-09T01:24:59.080Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-09T01:24:59.080Z</app:edited>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/>
+ <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/new-test-site/user%3Auser%40example.com"/>
+ <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/new-test-site/user%3Auser%40example.com"/>
+ <gAcl:scope type="user" value="user@example.com"/>
+ <gAcl:role value="owner"/>
+</entry>
+</feed>'''
+
+ANALYTICS_ACCOUNT_FEED_old = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:dxp='http://schemas.google.com/analytics/2009'>
+<id>http://www.google.com/analytics/feeds/accounts/abc@test.com</id>
+<updated>2009-06-25T03:55:22.000-07:00</updated>
+<title type='text'>Profile list for abc@test.com</title>
+<link rel='self' type='application/atom+xml' href='http://www.google.com/analytics/feeds/accounts/default'/>
+<author>
+<name>Google Analytics</name>
+</author>
+<generator version='1.0'>Google Analytics</generator>
+<openSearch:totalResults>12</openSearch:totalResults>
+<openSearch:startIndex>1</openSearch:startIndex>
+<openSearch:itemsPerPage>12</openSearch:itemsPerPage>
+<entry>
+<id>http://www.google.com/analytics/feeds/accounts/ga:1174</id>
+<updated>2009-06-25T03:55:22.000-07:00</updated>
+<title type='text'>www.googlestore.com</title>
+<link rel='alternate' type='text/html' href='http://www.google.com/analytics'/>
+<dxp:tableId>ga:1174</dxp:tableId>
+<dxp:property name='ga:accountId' value='30481'/>
+<dxp:property name='ga:accountName' value='Google Store'/>
+<dxp:property name='ga:profileId' value='1174'/>
+<dxp:property name='ga:webPropertyId' value='UA-30481-1'/>
+<dxp:property name='ga:currency' value='USD'/>
+<dxp:property name='ga:timezone' value='America/Los_Angeles'/>
+</entry>
+</feed>'''
+
+ANALYTICS_ACCOUNT_FEED = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:dxp='http://schemas.google.com/analytics/2009' xmlns:ga='http://schemas.google.com/ga/2009' xmlns:openSearch='http://a9.com/-/spec/opensearch/1.1/' xmlns:gd='http://schemas.google\
+.com/g/2005' gd:etag='W/"DE8CRH47eCp7I2A9WxNWFU4."' gd:kind='analytics#accounts'>
+ <id>http://www.google.com/analytics/feeds/accounts/api.nickm@google.com</id>
+ <updated>2009-10-14T09:14:25.000-07:00</updated>
+ <title>Profile list for abc@test.com</title>
+ <link rel='self' type='application/atom+xml' href='http://www.google.com/analytics/feeds/accounts/default?v=2'/>
+ <author>
+ <name>Google Analytics</name>
+ </author>
+ <generator version='1.0'>Google Analytics</generator>
+ <openSearch:totalResults>37</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>37</openSearch:itemsPerPage>
+ <dxp:segment id='gaid::-11' name='Visits from iPhones'>
+ <dxp:definition>ga:operatingSystem==iPhone</dxp:definition>
+ </dxp:segment>
+ <entry gd:etag='W/"DE8CRH47eCp7I2A9WxNWFU4."' gd:kind='analytics#account'>
+ <id>http://www.google.com/analytics/feeds/accounts/ga:1174</id>
+ <updated>2009-10-14T09:14:25.000-07:00</updated>
+ <title>www.googlestore.com</title>
+ <link rel='alternate' type='text/html' href='http://www.google.com/analytics'/>
+ <ga:goal active='true' name='Completing Order' number='1' value='10.0'>
+ <ga:destination caseSensitive='false' expression='/purchaseComplete.html' matchType='regex' step1Required='false'>
+ <ga:step name='View Product Categories' number='1' path='/Apps|Accessories|Fun|Kid\+s|Office'/>
+ <ga:step name='View Product' number='2' path='/Apps|Accessories|Fun|Kid\+s|Office|Wearables'/>
+ </ga:destination>
+ </ga:goal>
+ <ga:goal active='true' name='Browsed my site over 5 minutes' number='6' value='0.0'>
+ <ga:engagement comparison='>' thresholdValue='300' type='timeOnSite'/>
+ </ga:goal>
+ <ga:goal active='true' name='Visited > 4 pages' number='7' value='0.25'>
+ <ga:engagement comparison='>' thresholdValue='4' type='pagesVisited'/>
+ </ga:goal>
+ <ga:customVariable index='1' name='My Custom Variable' scope='3'/>
+ <ga:customVariable index='2' name='My Seconds Variable' scope='1'/>
+ <dxp:property name='ga:accountId' value='30481'/>
+ <dxp:property name='ga:accountName' value='Google Store'/>
+ <dxp:property name='ga:profileId' value='1174'/>
+ <dxp:property name='ga:webPropertyId' value='UA-30481-1'/>
+ <dxp:property name='ga:currency' value='USD'/>
+ <dxp:property name='ga:timezone' value='America/Los_Angeles'/>
+ <dxp:tableId>ga:1174</dxp:tableId>
+ </entry>
+</feed>'''
+
+ANALYTICS_DATA_FEED = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:dxp='http://schemas.google.com/analytics/2009'>
+ <id>http://www.google.com/analytics/feeds/data?ids=ga:1174&dimensions=ga:medium,ga:source&metrics=ga:bounces,ga:visits&filters=ga:medium%3D%3Dreferral&start-date=2008-10-01&end-date=2008-10-31</id>
+ <updated>2008-10-31T16:59:59.999-07:00</updated>
+ <title type='text'>Google Analytics Data for Profile 1174</title>
+ <link rel='self' type='application/atom+xml' href='http://www.google.com/analytics/feeds/data?max-results=5&sort=-ga%3Avisits&end-date=2008-10-31&start-date=2008-10-01&metrics=ga%3Avisits%2Cga%3Abounces&ids=ga%3A1174&dimensions=ga%3Asource%2Cga%3Amedium&filters=ga%3Amedium%3D%3Dreferral'/>
+ <link rel='next' type='application/atom+xml' href='http://www.google.com/analytics/feeds/data?start-index=6&max-results=5&sort=-ga%3Avisits&end-date=2008-10-31&start-date=2008-10-01&metrics=ga%3Avisits%2Cga%3Abounces&ids=ga%3A1174&dimensions=ga%3Asource%2Cga%3Amedium&filters=ga%3Amedium%3D%3Dreferral'/>
+ <author>
+ <name>Google Analytics</name>
+ </author>
+ <generator version='1.0'>Google Analytics</generator>
+ <openSearch:totalResults>6451</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>2</openSearch:itemsPerPage>
+ <dxp:startDate>2008-10-01</dxp:startDate>
+ <dxp:endDate>2008-10-31</dxp:endDate>
+ <dxp:segment id='gaid::-11' name='Visits from iPhones'>
+ <dxp:definition>ga:operatingSystem==iPhone</dxp:definition>
+ </dxp:segment>
+ <dxp:aggregates>
+ <dxp:metric confidenceInterval='0.0' name='ga:visits' type='integer' value='136540'/>
+ <dxp:metric confidenceInterval='0.0' name='ga:bounces' type='integer' value='101535'/>
+ </dxp:aggregates>
+ <dxp:containsSampledData>true</dxp:containsSampledData>
+ <dxp:dataSource>
+ <dxp:tableId>ga:1174</dxp:tableId>
+ <dxp:tableName>www.googlestore.com</dxp:tableName>
+ <dxp:property name='ga:profileId' value='1174'/>
+ <dxp:property name='ga:webPropertyId' value='UA-30481-1'/>
+ <dxp:property name='ga:accountName' value='Google Store'/>
+ </dxp:dataSource>
+ <entry>
+ <id>http://www.google.com/analytics/feeds/data?ids=ga:1174&ga:medium=referral&ga:source=blogger.com&filters=ga:medium%3D%3Dreferral&start-date=2008-10-01&end-date=2008-10-31</id>
+ <updated>2008-10-30T17:00:00.001-07:00</updated>
+ <title type='text'>ga:source=blogger.com | ga:medium=referral</title>
+ <link rel='alternate' type='text/html' href='http://www.google.com/analytics'/>
+ <dxp:dimension name='ga:source' value='blogger.com'/>
+ <dxp:dimension name='ga:medium' value='referral'/>
+ <dxp:metric confidenceInterval='0.0' name='ga:visits' type='integer' value='68140'/>
+ <dxp:metric confidenceInterval='0.0' name='ga:bounces' type='integer' value='61095'/>
+ </entry>
+</feed>'''
+
+
+ANALYTICS_MGMT_PROFILE_FEED = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:dxp='http://schemas.google.com/analytics/2009' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gd='http://schemas.google.com/g/2005' gd:kind='analytics#profiles'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/accounts/~all/webproperties/~all/profiles</id>
+ <updated>2010-06-14T22:18:48.676Z</updated>
+ <title type='text'>Google Analytics Profiles for superman@gmail.com</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/~all/webproperties/~all/profiles'/>
+ <author>
+ <name>Google Analytics</name>
+ </author>
+ <generator version='1.0'>Google Analytics</generator>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1000</openSearch:itemsPerPage>
+ <entry gd:etag='W/"CkQAQ3Y-fSp7I2A9WxFXGEU."' gd:kind='analytics#profile'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174</id>
+ <updated>2010-06-09T05:58:15.436-07:00</updated>
+ <title type='text'>Google Analytics Profile www.googlestore.com</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174'/>
+ <link rel='http://schemas.google.com/ga/2009#parent' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1' gd:targetKind='analytics#webproperty'/>
+ <link rel='http://schemas.google.com/ga/2009#child' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174/goals' gd:targetKind='analytics#goals'/>
+ <dxp:property name='ga:accountId' value='30481'/>
+ <dxp:property name='ga:webPropertyId' value='UA-30481-1'/>
+ <dxp:property name='ga:profileName' value='www.googlestore.com'/>
+ <dxp:property name='ga:profileId' value='1174'/>
+ <dxp:property name='dxp:tableId' value='ga:1174'/>
+ <dxp:property name='ga:currency' value='USD'/>
+ <dxp:property name='ga:timezone' value='America/Los_Angeles'/>
+ </entry>
+</feed>
+'''
+
+ANALYTICS_MGMT_GOAL_FEED = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:dxp='http://schemas.google.com/analytics/2009' xmlns:ga='http://schemas.google.com/ga/2009' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gd='http://schemas.google.com/g/2005' gd:kind='analytics#goals'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/accounts/~all/webproperties/~all/profiles/~all/goals</id>
+ <updated>2010-06-14T22:21:18.485Z</updated>
+ <title type='text'>Google Analytics Goals for superman@gmail.com</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/~all/webproperties/~all/profiles/~all/goals'/>
+ <author>
+ <name>Google Analytics</name>
+ </author>
+ <generator version='1.0'>Google Analytics</generator>
+ <openSearch:totalResults>3</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1000</openSearch:itemsPerPage>
+ <entry gd:etag='W/"DUYCQn08fip7I2A9WxBWFUo."' gd:kind='analytics#goal'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174/goals/1</id>
+ <updated>2010-02-07T13:12:43.377-08:00</updated>
+ <title type='text'>Google Analytics Goal 1</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174/goals/1'/>
+ <link rel='http://schemas.google.com/ga/2009#parent' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174' gd:targetKind='analytics#profile'/>
+ <ga:goal active='true' name='Completing Order' number='1' value='10.0'>
+ <ga:destination caseSensitive='false' expression='/purchaseComplete.html' matchType='regex' step1Required='false'>
+ <ga:step name='View Product Categories' number='1' path='/Apps|Accessories'/>
+ </ga:destination>
+ </ga:goal>
+ <dxp:property name='ga:profileId' value='1174'/>
+ </entry>
+ <entry gd:etag='W/"DUYCQn08fip7I2A9WxBWFUo."' gd:kind='analytics#goal'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174/goals/2</id>
+ <updated>2010-02-07T13:12:43.376-08:00</updated>
+ <title type='text'>Google Analytics Goal 2</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174/goals/2'/>
+ <link rel='http://schemas.google.com/ga/2009#parent' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174' gd:targetKind='analytics#profile'/>
+ <ga:goal active='true' name='Browsed my site over 5 minutes' number='2' value='0.0'>
+ <ga:engagement comparison='>' thresholdValue='300' type='timeOnSite'/>
+ </ga:goal>
+ <dxp:property name='ga:profileId' value='1174'/>
+ </entry>
+</feed>
+'''
+
+ANALYTICS_MGMT_ADV_SEGMENT_FEED = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:dxp='http://schemas.google.com/analytics/2009' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gd='http://schemas.google.com/g/2005' gd:kind='analytics#segments'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/segments</id>
+ <updated>2010-06-14T22:22:02.728Z</updated>
+ <title type='text'>Google Analytics Advanced Segments for superman@gmail.com</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/segments'/>
+ <author>
+ <name>Google Analytics</name>
+ </author>
+ <generator version='1.0'>Google Analytics</generator>
+ <openSearch:totalResults>2</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1000</openSearch:itemsPerPage>
+ <entry gd:etag='W/"YDwqeyM."' gd:kind='analytics#segment'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/segments/gaid::0</id>
+ <updated>2009-10-26T13:00:44.915-07:00</updated>
+ <title type='text'>Google Analytics Advanced Segment Sources Form Google</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/segments/gaid::0'/>
+ <dxp:segment id='gaid::0' name='Sources Form Google'>
+ <dxp:definition>ga:source=~^\Qgoogle\E</dxp:definition>
+ </dxp:segment>
+ </entry>
+</feed>
+'''
+
+MULTIDOMAIN_USER_ENTRY = """<?xml version="1.0"?>
+<atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
+ <apps:property name="password" value="51eea05d46317fadd5cad6787a8f562be90b4446"/>
+ <apps:property name="hashFunction" value="SHA-1"/>
+ <apps:property name="userEmail" value="liz@example.com"/>
+ <apps:property name="firstName" value="Liz"/>
+ <apps:property name="lastName" value="Smith"/>
+ <apps:property name="isAdmin" value="true"/>
+</atom:entry>"""
+
+MULTIDOMAIN_USER_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensesearchrss/1.0/"
+ xmlns:apps="http://schemas.google.com/apps/2006">
+ <id>https://apps-apis.google.com/a/feeds/user/2.0/example.com</id>
+ <updated>2010-01-26T23:38:13.215Z</updated>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/user/2.0/example.com" />
+ <link rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/user/2.0/example.com" />
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/user/2.0/example.com?start=admin%40example.com" />
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/user/2.0/example.com/admin%40example.com</id>
+ <updated>2010-01-26T23:38:13.210Z</updated>
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/user/2.0/example.com/admin%40example.com" />
+ <link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/user/2.0/example.com/admin%40example.com" />
+ <apps:property name="lastName" value="Brown" />
+ <apps:property name="isChangePasswordAtNextLogin" value="false" />
+ <apps:property name="isSuspended" value="false" />
+ <apps:property name="userEmail" value="admin@example.com" />
+ <apps:property name="isAdmin" value="true" />
+ <apps:property name="firstName" value="Joe" />
+ <apps:property name="ipWhitelisted" value="false" />
+ </entry>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/user/2.0/example.com/liz%40example.com</id>
+ <updated>2010-01-26T23:38:13.210Z</updated>
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/user/2.0/example.com/liz%40example.com" />
+ <link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/user/2.0/example.com/liz%40example.com" />
+ <apps:property name="lastName" value="Smith" />
+ <apps:property name="isChangePasswordAtNextLogin" value="false" />
+ <apps:property name="isSuspended" value="false" />
+ <apps:property name="userEmail" value="liz@example.com" />
+ <apps:property name="isAdmin" value="true" />
+ <apps:property name="firstName" value="Elizabeth" />
+ <apps:property name="ipWhitelisted" value="false" />
+ </entry>
+</feed>"""
+
+MULTIDOMAIN_USER_RENAME_REQUEST = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
+ <apps:property name='newEmail' value='liz@newexample4liz.com'/>
+</entry>"""
+
+MULTIDOMAIN_ALIAS_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com</id>
+ <updated>2008-10-17T15:02:45.646Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com'/>
+ <link rel='edit' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com'/>
+ <apps:property name="userEmail" value="liz@example.com" />
+ <apps:property name="aliasEmail" value="helpdesk@gethelp_example.com" />
+</entry>"""
+
+MULTIDOMAIN_ALIAS_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:apps="http://schemas.google.com/apps/2006">
+ <id>https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com</id>
+ <updated>2010-01-26T23:38:13.215Z</updated>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com" />
+ <link rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com" />
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com?start=helpdesk%40gethelp_example.com" />
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com</id>
+ <updated>2010-01-26T23:38:13.210Z</updated>
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com" />
+ <link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com" />
+ <apps:property name="userEmail" value="liz@example.com" />
+ <apps:property name="aliasEmail" value="helpdesk@gethelp_example.com" />
+ </entry>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/support%40gethelp_example.com</id>
+ <updated>2010-01-26T23:38:13.210Z</updated>
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/support%40gethelp_example.com" />
+ <link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/support%40gethelp_example.com" />
+ <apps:property name="userEmail" value="joe@example.com" />
+ <apps:property name="aliasEmail" value="support@gethelp_example.com" />
+ </entry>
+</feed>"""
+
+USER_ENTRY1 = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006' xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/abcd12310</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/>
+ <title type='text'>abcd12310</title>
+ <link rel='self' type='application/atom+xml' href='http://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/abcd12310'/>
+ <link rel='edit' type='application/atom+xml' href='http://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/abcd12310'/>
+ <apps:login userName='abcd12310' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='25600'/>
+ <apps:name familyName='efgh3' givenName='abcd33'/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='http://apps-apis.google.com/a/feeds/srkapps.com/nickname/2.0?username=abcd12310'/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='http://apps-apis.google.com/a/feeds/srkapps.com/emailList/2.0?recipient=abcd12310%40srkapps.com'/>
+</entry>"""
+
+USER_FEED1 = """<?xml version='1.0' encoding='utf-8'?>
+<ns0:feed xmlns:ns0="http://www.w3.org/2005/Atom">
+ <ns0:category scheme="http://schemas.google.com/g/2005#kind"
+ term="http://schemas.google.com/apps/2006#user" />
+ <ns0:id>
+ https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0</ns0:id>
+ <ns1:startIndex xmlns:ns1="http://a9.com/-/spec/opensearchrss/1.0/">
+ 1</ns1:startIndex>
+ <ns0:title type="text">Users</ns0:title>
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0"
+ rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml" />
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0"
+ rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml" />
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0?startUsername=user8306"
+ rel="self" type="application/atom+xml" />
+ <ns0:updated>1970-01-01T00:00:00.000Z</ns0:updated>
+ <ns0:entry>
+ <ns1:name familyName="LastName8306"
+ givenName="FirstName8306"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ <ns0:category scheme="http://schemas.google.com/g/2005#kind"
+ term="http://schemas.google.com/apps/2006#user" />
+ <ns0:id>
+ https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8306</ns0:id>
+ <ns0:updated>1970-01-01T00:00:00.000Z</ns0:updated>
+ <ns1:quota limit="25600"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ <ns1:feedLink href="https://apps-apis.google.com/a/feeds/srkapps.com/nickname/2.0?username=user8306"
+ rel="http://schemas.google.com/apps/2006#user.nicknames"
+ xmlns:ns1="http://schemas.google.com/g/2005" />
+ <ns1:feedLink href="https://apps-apis.google.com/a/feeds/srkapps.com/emailList/2.0?recipient=user8306%40srkapps.com"
+ rel="http://schemas.google.com/apps/2006#user.emailLists"
+ xmlns:ns1="http://schemas.google.com/g/2005" />
+ <ns0:title type="text">user8306</ns0:title>
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8306"
+ rel="self" type="application/atom+xml" />
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8306"
+ rel="edit" type="application/atom+xml" />
+ <ns1:login admin="false" agreedToTerms="false"
+ changePasswordAtNextLogin="false" ipWhitelisted="false"
+ suspended="false" userName="user8306"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ </ns0:entry>
+ <ns0:entry>
+ <ns1:name familyName="LastName8307"
+ givenName="FirstName8307"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ <ns0:category scheme="http://schemas.google.com/g/2005#kind"
+ term="http://schemas.google.com/apps/2006#user" />
+ <ns0:id>
+ https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8307</ns0:id>
+ <ns0:updated>1970-01-01T00:00:00.000Z</ns0:updated>
+ <ns1:quota limit="25600"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ <ns1:feedLink href="https://apps-apis.google.com/a/feeds/srkapps.com/nickname/2.0?username=user8307"
+ rel="http://schemas.google.com/apps/2006#user.nicknames"
+ xmlns:ns1="http://schemas.google.com/g/2005" />
+ <ns1:feedLink href="https://apps-apis.google.com/a/feeds/srkapps.com/emailList/2.0?recipient=user8307%40srkapps.com"
+ rel="http://schemas.google.com/apps/2006#user.emailLists"
+ xmlns:ns1="http://schemas.google.com/g/2005" />
+ <ns0:title type="text">user8307</ns0:title>
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8307"
+ rel="self" type="application/atom+xml" />
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8307"
+ rel="edit" type="application/atom+xml" />
+ <ns1:login admin="false" agreedToTerms="false"
+ changePasswordAtNextLogin="false" ipWhitelisted="false"
+ suspended="false" userName="user8307"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ </ns0:entry>
+</ns0:feed>"""
+
+NICKNAME_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname' />
+ <title type='text'>nehag</title>
+ <link rel='self' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag' />
+ <link rel='edit' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag' />
+ <apps:nickname name='nehag' />
+ <apps:login userName='neha' />
+</entry>"""
+
+
+NICKNAME_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname' />
+ <title type='text'>Nicknames</title>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0' />
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0' />
+ <link rel='self' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0' />
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>
+ https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname' />
+ <title type='text'>nehag</title>
+ <link rel='self' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag' />
+ <link rel='edit' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag' />
+ <apps:nickname name='nehag' />
+ <apps:login userName='neha' />
+ </entry>
+ <entry>
+ <id>
+ https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/richag</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname' />
+ <title type='text'>richag</title>
+ <link rel='self' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/richag' />
+ <link rel='edit' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/richag' />
+ <apps:nickname name='richag' />
+ <apps:login userName='richa' />
+ </entry>
+</feed>"""
+
+GROUP_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com</id>
+ <updated>2011-11-10T16:54:56.784Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com' />
+ <apps:property name='groupId' value='trial@srkapps.com' />
+ <apps:property name='groupName' value='Trial' />
+ <apps:property name='emailPermission' value='Domain' />
+ <apps:property name='permissionPreset' value='Custom' />
+ <apps:property name='description' value='For try' />
+</entry>"""
+
+GROUP_FEED= """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com</id>
+ <updated>2011-11-10T16:56:03.830Z</updated>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com' />
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com' />
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com' />
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/firstgroup%40srkapps.com</id>
+ <updated>2011-11-10T16:56:03.830Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/firstgroup%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/firstgroup%40srkapps.com' />
+ <apps:property name='groupId' value='firstgroup@srkapps.com' />
+ <apps:property name='groupName' value='FirstGroup' />
+ <apps:property name='emailPermission' value='Domain' />
+ <apps:property name='permissionPreset' value='Custom' />
+ <apps:property name='description' value='First group' />
+ </entry>
+ <entry>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com</id>
+ <updated>2011-11-10T16:56:03.830Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com' />
+ <apps:property name='groupId' value='trial@srkapps.com' />
+ <apps:property name='groupName' value='Trial' />
+ <apps:property name='emailPermission' value='Domain' />
+ <apps:property name='permissionPreset' value='Custom' />
+ <apps:property name='description' value='For try' />
+ </entry>
+</feed>"""
+
+GROUP_MEMBER_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com</id>
+ <updated>2011-11-10T16:58:40.804Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com' />
+ <apps:property name='memberType' value='User' />
+ <apps:property name='memberId' value='abcd12310@srkapps.com' />
+ <apps:property name='directMember' value='true' />
+</entry>"""
+
+GROUP_MEMBER_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member</id>
+ <updated>2011-11-10T16:57:15.574Z</updated>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member' />
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member' />
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member' />
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com</id>
+ <updated>2011-11-10T16:57:15.574Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com' />
+ <apps:property name='memberType' value='User' />
+ <apps:property name='memberId' value='abcd12310@srkapps.com' />
+ <apps:property name='directMember' value='true' />
+ </entry>
+ <entry>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/neha.technocrat%40srkapps.com</id>
+ <updated>2011-11-10T16:57:15.574Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/neha.technocrat%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/neha.technocrat%40srkapps.com' />
+ <apps:property name='memberType' value='User' />
+ <apps:property name='memberId' value='neha.technocrat@srkapps.com' />
+ <apps:property name='directMember' value='true' />
+ </entry>
+</feed>"""
+
+ORGANIZATION_UNIT_CUSTOMER_ID_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+<id>
+https://apps-apis.google.com/a/feeds/customer/2.0/C123A456B</id>
+<updated>2011-11-21T13:17:02.274Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/customer/2.0/C123A456B' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/customer/2.0/C123A456B' />
+<apps:property name='customerOrgUnitDescription'
+value='example.com' />
+<apps:property name='customerId' value='C123A456B' />
+<apps:property name='customerOrgUnitName' value='example.com' />
+<apps:property name='description' value='tempdescription' />
+<apps:property name='name' value='example.com' />
+</entry>"""
+
+ORGANIZATION_UNIT_ORGUNIT_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+<id>
+https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/Test+Organization</id>
+<updated>2011-11-21T13:32:12.334Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/Test+Organization' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/Test+Organization' />
+<apps:property name='description' value='New Test Org' />
+<apps:property name='parentOrgUnitPath' value='Test' />
+<apps:property name='name' value='Test Organization' />
+<apps:property name='orgUnitPath' value='Test/Test+Organization' />
+<apps:property name='blockInheritance' value='false' />
+</entry>"""
+
+ORGANIZATION_UNIT_ORGUNIT_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+<id>https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B</id>
+<updated>2011-11-21T13:47:12.551Z</updated>
+<link rel='http://schemas.google.com/g/2005#feed'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B' />
+<link rel='http://schemas.google.com/g/2005#post'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B' />
+<link rel='http://schemas.google.com/g/2005#batch'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/batch' />
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B?get=all' />
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+<id>
+https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit92</id>
+<updated>2011-11-21T13:42:45.349Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit92' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit92' />
+<apps:property name='description' value='test92' />
+<apps:property name='parentOrgUnitPath' value='Test' />
+<apps:property name='name' value='testOrgUnit92' />
+<apps:property name='orgUnitPath' value='Test/testOrgUnit92' />
+<apps:property name='blockInheritance' value='false' />
+</entry>
+<entry>
+<id>
+https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit93</id>
+<updated>2011-11-21T13:42:45.349Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit93' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit93' />
+<apps:property name='description' value='test93' />
+<apps:property name='parentOrgUnitPath' value='Test' />
+<apps:property name='name' value='testOrgUnit93' />
+<apps:property name='orgUnitPath' value='Test/testOrgUnit93' />
+<apps:property name='blockInheritance' value='false' />
+</entry>
+</feed>"""
+
+
+ORGANIZATION_UNIT_ORGUSER_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+<id>
+https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/admin%40example.com</id>
+<updated>2011-11-21T14:05:17.734Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/admin%40example.com' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/admin%40example.com' />
+<apps:property name='orgUserEmail' value='admin@example.com' />
+<apps:property name='orgUnitPath' value='Test' />
+</entry>"""
+
+ORGANIZATION_UNIT_ORGUSER_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+<id>https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B</id>
+<updated>2011-11-21T14:10:48.206Z</updated>
+<link rel='http://schemas.google.com/g/2005#feed'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B' />
+<link rel='http://schemas.google.com/g/2005#post'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B' />
+<link rel='http://schemas.google.com/g/2005#batch'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/batch' />
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B?get=all' />
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+<id>
+https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user720430%40example.com</id>
+<updated>2011-11-21T14:09:16.600Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user720430%40example.com' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user720430%40example.com' />
+<apps:property name='orgUserEmail'
+value='user720430@example.com' />
+<apps:property name='orgUnitPath' value='Test' />
+</entry>
+<entry>
+<id>
+https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user832648%40example.com</id>
+<updated>2011-11-21T14:09:16.600Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user832648%40example.com' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user832648%40example.com' />
+<apps:property name='orgUserEmail'
+value='user832648@example.com' />
+<apps:property name='orgUnitPath' value='Test' />
+</entry>
+</feed>"""
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/BaseDB.py b/samples/apps/marketplace_sample/gdata/tlslite/BaseDB.py
new file mode 100755
index 0000000..ca8dff6
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/BaseDB.py
@@ -0,0 +1,120 @@
+"""Base class for SharedKeyDB and VerifierDB."""
+
+import anydbm
+import thread
+
+class BaseDB:
+ def __init__(self, filename, type):
+ self.type = type
+ self.filename = filename
+ if self.filename:
+ self.db = None
+ else:
+ self.db = {}
+ self.lock = thread.allocate_lock()
+
+ def create(self):
+ """Create a new on-disk database.
+
+ @raise anydbm.error: If there's a problem creating the database.
+ """
+ if self.filename:
+ self.db = anydbm.open(self.filename, "n") #raises anydbm.error
+ self.db["--Reserved--type"] = self.type
+ self.db.sync()
+ else:
+ self.db = {}
+
+ def open(self):
+ """Open a pre-existing on-disk database.
+
+ @raise anydbm.error: If there's a problem opening the database.
+ @raise ValueError: If the database is not of the right type.
+ """
+ if not self.filename:
+ raise ValueError("Can only open on-disk databases")
+ self.db = anydbm.open(self.filename, "w") #raises anydbm.error
+ try:
+ if self.db["--Reserved--type"] != self.type:
+ raise ValueError("Not a %s database" % self.type)
+ except KeyError:
+ raise ValueError("Not a recognized database")
+
+ def __getitem__(self, username):
+ if self.db == None:
+ raise AssertionError("DB not open")
+
+ self.lock.acquire()
+ try:
+ valueStr = self.db[username]
+ finally:
+ self.lock.release()
+
+ return self._getItem(username, valueStr)
+
+ def __setitem__(self, username, value):
+ if self.db == None:
+ raise AssertionError("DB not open")
+
+ valueStr = self._setItem(username, value)
+
+ self.lock.acquire()
+ try:
+ self.db[username] = valueStr
+ if self.filename:
+ self.db.sync()
+ finally:
+ self.lock.release()
+
+ def __delitem__(self, username):
+ if self.db == None:
+ raise AssertionError("DB not open")
+
+ self.lock.acquire()
+ try:
+ del(self.db[username])
+ if self.filename:
+ self.db.sync()
+ finally:
+ self.lock.release()
+
+ def __contains__(self, username):
+ """Check if the database contains the specified username.
+
+ @type username: str
+ @param username: The username to check for.
+
+ @rtype: bool
+ @return: True if the database contains the username, False
+ otherwise.
+
+ """
+ if self.db == None:
+ raise AssertionError("DB not open")
+
+ self.lock.acquire()
+ try:
+ return self.db.has_key(username)
+ finally:
+ self.lock.release()
+
+ def check(self, username, param):
+ value = self.__getitem__(username)
+ return self._checkItem(value, username, param)
+
+ def keys(self):
+ """Return a list of usernames in the database.
+
+ @rtype: list
+ @return: The usernames in the database.
+ """
+ if self.db == None:
+ raise AssertionError("DB not open")
+
+ self.lock.acquire()
+ try:
+ usernames = self.db.keys()
+ finally:
+ self.lock.release()
+ usernames = [u for u in usernames if not u.startswith("--Reserved--")]
+ return usernames
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/Checker.py b/samples/apps/marketplace_sample/gdata/tlslite/Checker.py
new file mode 100755
index 0000000..f978697
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/Checker.py
@@ -0,0 +1,146 @@
+"""Class for post-handshake certificate checking."""
+
+from utils.cryptomath import hashAndBase64
+from X509 import X509
+from X509CertChain import X509CertChain
+from errors import *
+
+
+class Checker:
+ """This class is passed to a handshake function to check the other
+ party's certificate chain.
+
+ If a handshake function completes successfully, but the Checker
+ judges the other party's certificate chain to be missing or
+ inadequate, a subclass of
+ L{tlslite.errors.TLSAuthenticationError} will be raised.
+
+ Currently, the Checker can check either an X.509 or a cryptoID
+ chain (for the latter, cryptoIDlib must be installed).
+ """
+
+ def __init__(self, cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ checkResumedSession=False):
+ """Create a new Checker instance.
+
+ You must pass in one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ @type cryptoID: str
+ @param cryptoID: A cryptoID which the other party's certificate
+ chain must match. The cryptoIDlib module must be installed.
+ Mutually exclusive with all of the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: A cryptoID protocol URI which the other
+ party's certificate chain must match. Requires the 'cryptoID'
+ argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: A hex-encoded X.509 end-entity
+ fingerprint which the other party's end-entity certificate must
+ match. Mutually exclusive with the 'cryptoID' and
+ 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed. Mutually exclusive with the 'cryptoID' and
+ 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type checkResumedSession: bool
+ @param checkResumedSession: If resumed sessions should be
+ checked. This defaults to False, on the theory that if the
+ session was checked once, we don't need to bother
+ re-checking it.
+ """
+
+ if cryptoID and (x509Fingerprint or x509TrustList):
+ raise ValueError()
+ if x509Fingerprint and x509TrustList:
+ raise ValueError()
+ if x509CommonName and not x509TrustList:
+ raise ValueError()
+ if protocol and not cryptoID:
+ raise ValueError()
+ if cryptoID:
+ import cryptoIDlib #So we raise an error here
+ if x509TrustList:
+ import cryptlib_py #So we raise an error here
+ self.cryptoID = cryptoID
+ self.protocol = protocol
+ self.x509Fingerprint = x509Fingerprint
+ self.x509TrustList = x509TrustList
+ self.x509CommonName = x509CommonName
+ self.checkResumedSession = checkResumedSession
+
+ def __call__(self, connection):
+ """Check a TLSConnection.
+
+ When a Checker is passed to a handshake function, this will
+ be called at the end of the function.
+
+ @type connection: L{tlslite.TLSConnection.TLSConnection}
+ @param connection: The TLSConnection to examine.
+
+ @raise tlslite.errors.TLSAuthenticationError: If the other
+ party's certificate chain is missing or bad.
+ """
+ if not self.checkResumedSession and connection.resumed:
+ return
+
+ if self.cryptoID or self.x509Fingerprint or self.x509TrustList:
+ if connection._client:
+ chain = connection.session.serverCertChain
+ else:
+ chain = connection.session.clientCertChain
+
+ if self.x509Fingerprint or self.x509TrustList:
+ if isinstance(chain, X509CertChain):
+ if self.x509Fingerprint:
+ if chain.getFingerprint() != self.x509Fingerprint:
+ raise TLSFingerprintError(\
+ "X.509 fingerprint mismatch: %s, %s" % \
+ (chain.getFingerprint(), self.x509Fingerprint))
+ else: #self.x509TrustList
+ if not chain.validate(self.x509TrustList):
+ raise TLSValidationError("X.509 validation failure")
+ if self.x509CommonName and \
+ (chain.getCommonName() != self.x509CommonName):
+ raise TLSAuthorizationError(\
+ "X.509 Common Name mismatch: %s, %s" % \
+ (chain.getCommonName(), self.x509CommonName))
+ elif chain:
+ raise TLSAuthenticationTypeError()
+ else:
+ raise TLSNoAuthenticationError()
+ elif self.cryptoID:
+ import cryptoIDlib.CertChain
+ if isinstance(chain, cryptoIDlib.CertChain.CertChain):
+ if chain.cryptoID != self.cryptoID:
+ raise TLSFingerprintError(\
+ "cryptoID mismatch: %s, %s" % \
+ (chain.cryptoID, self.cryptoID))
+ if self.protocol:
+ if not chain.checkProtocol(self.protocol):
+ raise TLSAuthorizationError(\
+ "cryptoID protocol mismatch")
+ if not chain.validate():
+ raise TLSValidationError("cryptoID validation failure")
+ elif chain:
+ raise TLSAuthenticationTypeError()
+ else:
+ raise TLSNoAuthenticationError()
+
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/FileObject.py b/samples/apps/marketplace_sample/gdata/tlslite/FileObject.py
new file mode 100755
index 0000000..6ee02b2
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/FileObject.py
@@ -0,0 +1,220 @@
+"""Class returned by TLSConnection.makefile()."""
+
+class FileObject:
+ """This class provides a file object interface to a
+ L{tlslite.TLSConnection.TLSConnection}.
+
+ Call makefile() on a TLSConnection to create a FileObject instance.
+
+ This class was copied, with minor modifications, from the
+ _fileobject class in socket.py. Note that fileno() is not
+ implemented."""
+
+ default_bufsize = 16384 #TREV: changed from 8192
+
+ def __init__(self, sock, mode='rb', bufsize=-1):
+ self._sock = sock
+ self.mode = mode # Not actually used in this version
+ if bufsize < 0:
+ bufsize = self.default_bufsize
+ self.bufsize = bufsize
+ self.softspace = False
+ if bufsize == 0:
+ self._rbufsize = 1
+ elif bufsize == 1:
+ self._rbufsize = self.default_bufsize
+ else:
+ self._rbufsize = bufsize
+ self._wbufsize = bufsize
+ self._rbuf = "" # A string
+ self._wbuf = [] # A list of strings
+
+ def _getclosed(self):
+ return self._sock is not None
+ closed = property(_getclosed, doc="True if the file is closed")
+
+ def close(self):
+ try:
+ if self._sock:
+ for result in self._sock._decrefAsync(): #TREV
+ pass
+ finally:
+ self._sock = None
+
+ def __del__(self):
+ try:
+ self.close()
+ except:
+ # close() may fail if __init__ didn't complete
+ pass
+
+ def flush(self):
+ if self._wbuf:
+ buffer = "".join(self._wbuf)
+ self._wbuf = []
+ self._sock.sendall(buffer)
+
+ #def fileno(self):
+ # raise NotImplementedError() #TREV
+
+ def write(self, data):
+ data = str(data) # XXX Should really reject non-string non-buffers
+ if not data:
+ return
+ self._wbuf.append(data)
+ if (self._wbufsize == 0 or
+ self._wbufsize == 1 and '\n' in data or
+ self._get_wbuf_len() >= self._wbufsize):
+ self.flush()
+
+ def writelines(self, list):
+ # XXX We could do better here for very long lists
+ # XXX Should really reject non-string non-buffers
+ self._wbuf.extend(filter(None, map(str, list)))
+ if (self._wbufsize <= 1 or
+ self._get_wbuf_len() >= self._wbufsize):
+ self.flush()
+
+ def _get_wbuf_len(self):
+ buf_len = 0
+ for x in self._wbuf:
+ buf_len += len(x)
+ return buf_len
+
+ def read(self, size=-1):
+ data = self._rbuf
+ if size < 0:
+ # Read until EOF
+ buffers = []
+ if data:
+ buffers.append(data)
+ self._rbuf = ""
+ if self._rbufsize <= 1:
+ recv_size = self.default_bufsize
+ else:
+ recv_size = self._rbufsize
+ while True:
+ data = self._sock.recv(recv_size)
+ if not data:
+ break
+ buffers.append(data)
+ return "".join(buffers)
+ else:
+ # Read until size bytes or EOF seen, whichever comes first
+ buf_len = len(data)
+ if buf_len >= size:
+ self._rbuf = data[size:]
+ return data[:size]
+ buffers = []
+ if data:
+ buffers.append(data)
+ self._rbuf = ""
+ while True:
+ left = size - buf_len
+ recv_size = max(self._rbufsize, left)
+ data = self._sock.recv(recv_size)
+ if not data:
+ break
+ buffers.append(data)
+ n = len(data)
+ if n >= left:
+ self._rbuf = data[left:]
+ buffers[-1] = data[:left]
+ break
+ buf_len += n
+ return "".join(buffers)
+
+ def readline(self, size=-1):
+ data = self._rbuf
+ if size < 0:
+ # Read until \n or EOF, whichever comes first
+ if self._rbufsize <= 1:
+ # Speed up unbuffered case
+ assert data == ""
+ buffers = []
+ recv = self._sock.recv
+ while data != "\n":
+ data = recv(1)
+ if not data:
+ break
+ buffers.append(data)
+ return "".join(buffers)
+ nl = data.find('\n')
+ if nl >= 0:
+ nl += 1
+ self._rbuf = data[nl:]
+ return data[:nl]
+ buffers = []
+ if data:
+ buffers.append(data)
+ self._rbuf = ""
+ while True:
+ data = self._sock.recv(self._rbufsize)
+ if not data:
+ break
+ buffers.append(data)
+ nl = data.find('\n')
+ if nl >= 0:
+ nl += 1
+ self._rbuf = data[nl:]
+ buffers[-1] = data[:nl]
+ break
+ return "".join(buffers)
+ else:
+ # Read until size bytes or \n or EOF seen, whichever comes first
+ nl = data.find('\n', 0, size)
+ if nl >= 0:
+ nl += 1
+ self._rbuf = data[nl:]
+ return data[:nl]
+ buf_len = len(data)
+ if buf_len >= size:
+ self._rbuf = data[size:]
+ return data[:size]
+ buffers = []
+ if data:
+ buffers.append(data)
+ self._rbuf = ""
+ while True:
+ data = self._sock.recv(self._rbufsize)
+ if not data:
+ break
+ buffers.append(data)
+ left = size - buf_len
+ nl = data.find('\n', 0, left)
+ if nl >= 0:
+ nl += 1
+ self._rbuf = data[nl:]
+ buffers[-1] = data[:nl]
+ break
+ n = len(data)
+ if n >= left:
+ self._rbuf = data[left:]
+ buffers[-1] = data[:left]
+ break
+ buf_len += n
+ return "".join(buffers)
+
+ def readlines(self, sizehint=0):
+ total = 0
+ list = []
+ while True:
+ line = self.readline()
+ if not line:
+ break
+ list.append(line)
+ total += len(line)
+ if sizehint and total >= sizehint:
+ break
+ return list
+
+ # Iterator protocols
+
+ def __iter__(self):
+ return self
+
+ def next(self):
+ line = self.readline()
+ if not line:
+ raise StopIteration
+ return line
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/HandshakeSettings.py b/samples/apps/marketplace_sample/gdata/tlslite/HandshakeSettings.py
new file mode 100755
index 0000000..c7c3223
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/HandshakeSettings.py
@@ -0,0 +1,159 @@
+"""Class for setting handshake parameters."""
+
+from constants import CertificateType
+from utils import cryptomath
+from utils import cipherfactory
+
+class HandshakeSettings:
+ """This class encapsulates various parameters that can be used with
+ a TLS handshake.
+ @sort: minKeySize, maxKeySize, cipherNames, certificateTypes,
+ minVersion, maxVersion
+
+ @type minKeySize: int
+ @ivar minKeySize: The minimum bit length for asymmetric keys.
+
+ If the other party tries to use SRP, RSA, or Diffie-Hellman
+ parameters smaller than this length, an alert will be
+ signalled. The default is 1023.
+
+ @type maxKeySize: int
+ @ivar maxKeySize: The maximum bit length for asymmetric keys.
+
+ If the other party tries to use SRP, RSA, or Diffie-Hellman
+ parameters larger than this length, an alert will be signalled.
+ The default is 8193.
+
+ @type cipherNames: list
+ @ivar cipherNames: The allowed ciphers, in order of preference.
+
+ The allowed values in this list are 'aes256', 'aes128', '3des', and
+ 'rc4'. If these settings are used with a client handshake, they
+ determine the order of the ciphersuites offered in the ClientHello
+ message.
+
+ If these settings are used with a server handshake, the server will
+ choose whichever ciphersuite matches the earliest entry in this
+ list.
+
+ NOTE: If '3des' is used in this list, but TLS Lite can't find an
+ add-on library that supports 3DES, then '3des' will be silently
+ removed.
+
+ The default value is ['aes256', 'aes128', '3des', 'rc4'].
+
+ @type certificateTypes: list
+ @ivar certificateTypes: The allowed certificate types, in order of
+ preference.
+
+ The allowed values in this list are 'x509' and 'cryptoID'. This
+ list is only used with a client handshake. The client will
+ advertise to the server which certificate types are supported, and
+ will check that the server uses one of the appropriate types.
+
+ NOTE: If 'cryptoID' is used in this list, but cryptoIDlib is not
+ installed, then 'cryptoID' will be silently removed.
+
+ @type minVersion: tuple
+ @ivar minVersion: The minimum allowed SSL/TLS version.
+
+ This variable can be set to (3,0) for SSL 3.0, (3,1) for
+ TLS 1.0, or (3,2) for TLS 1.1. If the other party wishes to
+ use a lower version, a protocol_version alert will be signalled.
+ The default is (3,0).
+
+ @type maxVersion: tuple
+ @ivar maxVersion: The maximum allowed SSL/TLS version.
+
+ This variable can be set to (3,0) for SSL 3.0, (3,1) for
+ TLS 1.0, or (3,2) for TLS 1.1. If the other party wishes to
+ use a higher version, a protocol_version alert will be signalled.
+ The default is (3,2). (WARNING: Some servers may (improperly)
+ reject clients which offer support for TLS 1.1. In this case,
+ try lowering maxVersion to (3,1)).
+ """
+ def __init__(self):
+ self.minKeySize = 1023
+ self.maxKeySize = 8193
+ self.cipherNames = ["aes256", "aes128", "3des", "rc4"]
+ self.cipherImplementations = ["cryptlib", "openssl", "pycrypto",
+ "python"]
+ self.certificateTypes = ["x509", "cryptoID"]
+ self.minVersion = (3,0)
+ self.maxVersion = (3,2)
+
+ #Filters out options that are not supported
+ def _filter(self):
+ other = HandshakeSettings()
+ other.minKeySize = self.minKeySize
+ other.maxKeySize = self.maxKeySize
+ other.cipherNames = self.cipherNames
+ other.cipherImplementations = self.cipherImplementations
+ other.certificateTypes = self.certificateTypes
+ other.minVersion = self.minVersion
+ other.maxVersion = self.maxVersion
+
+ if not cipherfactory.tripleDESPresent:
+ other.cipherNames = [e for e in self.cipherNames if e != "3des"]
+ if len(other.cipherNames)==0:
+ raise ValueError("No supported ciphers")
+
+ try:
+ import cryptoIDlib
+ except ImportError:
+ other.certificateTypes = [e for e in self.certificateTypes \
+ if e != "cryptoID"]
+ if len(other.certificateTypes)==0:
+ raise ValueError("No supported certificate types")
+
+ if not cryptomath.cryptlibpyLoaded:
+ other.cipherImplementations = [e for e in \
+ self.cipherImplementations if e != "cryptlib"]
+ if not cryptomath.m2cryptoLoaded:
+ other.cipherImplementations = [e for e in \
+ other.cipherImplementations if e != "openssl"]
+ if not cryptomath.pycryptoLoaded:
+ other.cipherImplementations = [e for e in \
+ other.cipherImplementations if e != "pycrypto"]
+ if len(other.cipherImplementations)==0:
+ raise ValueError("No supported cipher implementations")
+
+ if other.minKeySize<512:
+ raise ValueError("minKeySize too small")
+ if other.minKeySize>16384:
+ raise ValueError("minKeySize too large")
+ if other.maxKeySize<512:
+ raise ValueError("maxKeySize too small")
+ if other.maxKeySize>16384:
+ raise ValueError("maxKeySize too large")
+ for s in other.cipherNames:
+ if s not in ("aes256", "aes128", "rc4", "3des"):
+ raise ValueError("Unknown cipher name: '%s'" % s)
+ for s in other.cipherImplementations:
+ if s not in ("cryptlib", "openssl", "python", "pycrypto"):
+ raise ValueError("Unknown cipher implementation: '%s'" % s)
+ for s in other.certificateTypes:
+ if s not in ("x509", "cryptoID"):
+ raise ValueError("Unknown certificate type: '%s'" % s)
+
+ if other.minVersion > other.maxVersion:
+ raise ValueError("Versions set incorrectly")
+
+ if not other.minVersion in ((3,0), (3,1), (3,2)):
+ raise ValueError("minVersion set incorrectly")
+
+ if not other.maxVersion in ((3,0), (3,1), (3,2)):
+ raise ValueError("maxVersion set incorrectly")
+
+ return other
+
+ def _getCertificateTypes(self):
+ l = []
+ for ct in self.certificateTypes:
+ if ct == "x509":
+ l.append(CertificateType.x509)
+ elif ct == "cryptoID":
+ l.append(CertificateType.cryptoID)
+ else:
+ raise AssertionError()
+ return l
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/Session.py b/samples/apps/marketplace_sample/gdata/tlslite/Session.py
new file mode 100755
index 0000000..a951f45
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/Session.py
@@ -0,0 +1,131 @@
+"""Class representing a TLS session."""
+
+from utils.compat import *
+from mathtls import *
+from constants import *
+
+class Session:
+ """
+ This class represents a TLS session.
+
+ TLS distinguishes between connections and sessions. A new
+ handshake creates both a connection and a session. Data is
+ transmitted over the connection.
+
+ The session contains a more permanent record of the handshake. The
+ session can be inspected to determine handshake results. The
+ session can also be used to create a new connection through
+ "session resumption". If the client and server both support this,
+ they can create a new connection based on an old session without
+ the overhead of a full handshake.
+
+ The session for a L{tlslite.TLSConnection.TLSConnection} can be
+ retrieved from the connection's 'session' attribute.
+
+ @type srpUsername: str
+ @ivar srpUsername: The client's SRP username (or None).
+
+ @type sharedKeyUsername: str
+ @ivar sharedKeyUsername: The client's shared-key username (or
+ None).
+
+ @type clientCertChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @ivar clientCertChain: The client's certificate chain (or None).
+
+ @type serverCertChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @ivar serverCertChain: The server's certificate chain (or None).
+ """
+
+ def __init__(self):
+ self.masterSecret = createByteArraySequence([])
+ self.sessionID = createByteArraySequence([])
+ self.cipherSuite = 0
+ self.srpUsername = None
+ self.sharedKeyUsername = None
+ self.clientCertChain = None
+ self.serverCertChain = None
+ self.resumable = False
+ self.sharedKey = False
+
+ def _clone(self):
+ other = Session()
+ other.masterSecret = self.masterSecret
+ other.sessionID = self.sessionID
+ other.cipherSuite = self.cipherSuite
+ other.srpUsername = self.srpUsername
+ other.sharedKeyUsername = self.sharedKeyUsername
+ other.clientCertChain = self.clientCertChain
+ other.serverCertChain = self.serverCertChain
+ other.resumable = self.resumable
+ other.sharedKey = self.sharedKey
+ return other
+
+ def _calcMasterSecret(self, version, premasterSecret, clientRandom,
+ serverRandom):
+ if version == (3,0):
+ self.masterSecret = PRF_SSL(premasterSecret,
+ concatArrays(clientRandom, serverRandom), 48)
+ elif version in ((3,1), (3,2)):
+ self.masterSecret = PRF(premasterSecret, "master secret",
+ concatArrays(clientRandom, serverRandom), 48)
+ else:
+ raise AssertionError()
+
+ def valid(self):
+ """If this session can be used for session resumption.
+
+ @rtype: bool
+ @return: If this session can be used for session resumption.
+ """
+ return self.resumable or self.sharedKey
+
+ def _setResumable(self, boolean):
+ #Only let it be set if this isn't a shared key
+ if not self.sharedKey:
+ #Only let it be set to True if the sessionID is non-null
+ if (not boolean) or (boolean and self.sessionID):
+ self.resumable = boolean
+
+ def getCipherName(self):
+ """Get the name of the cipher used with this connection.
+
+ @rtype: str
+ @return: The name of the cipher used with this connection.
+ Either 'aes128', 'aes256', 'rc4', or '3des'.
+ """
+ if self.cipherSuite in CipherSuite.aes128Suites:
+ return "aes128"
+ elif self.cipherSuite in CipherSuite.aes256Suites:
+ return "aes256"
+ elif self.cipherSuite in CipherSuite.rc4Suites:
+ return "rc4"
+ elif self.cipherSuite in CipherSuite.tripleDESSuites:
+ return "3des"
+ else:
+ return None
+
+ def _createSharedKey(self, sharedKeyUsername, sharedKey):
+ if len(sharedKeyUsername)>16:
+ raise ValueError()
+ if len(sharedKey)>47:
+ raise ValueError()
+
+ self.sharedKeyUsername = sharedKeyUsername
+
+ self.sessionID = createByteArrayZeros(16)
+ for x in range(len(sharedKeyUsername)):
+ self.sessionID[x] = ord(sharedKeyUsername[x])
+
+ premasterSecret = createByteArrayZeros(48)
+ sharedKey = chr(len(sharedKey)) + sharedKey
+ for x in range(48):
+ premasterSecret[x] = ord(sharedKey[x % len(sharedKey)])
+
+ self.masterSecret = PRF(premasterSecret, "shared secret",
+ createByteArraySequence([]), 48)
+ self.sharedKey = True
+ return self
+
+
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/SessionCache.py b/samples/apps/marketplace_sample/gdata/tlslite/SessionCache.py
new file mode 100755
index 0000000..34cf0b0
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/SessionCache.py
@@ -0,0 +1,103 @@
+"""Class for caching TLS sessions."""
+
+import thread
+import time
+
+class SessionCache:
+ """This class is used by the server to cache TLS sessions.
+
+ Caching sessions allows the client to use TLS session resumption
+ and avoid the expense of a full handshake. To use this class,
+ simply pass a SessionCache instance into the server handshake
+ function.
+
+ This class is thread-safe.
+ """
+
+ #References to these instances
+ #are also held by the caller, who may change the 'resumable'
+ #flag, so the SessionCache must return the same instances
+ #it was passed in.
+
+ def __init__(self, maxEntries=10000, maxAge=14400):
+ """Create a new SessionCache.
+
+ @type maxEntries: int
+ @param maxEntries: The maximum size of the cache. When this
+ limit is reached, the oldest sessions will be deleted as
+ necessary to make room for new ones. The default is 10000.
+
+ @type maxAge: int
+ @param maxAge: The number of seconds before a session expires
+ from the cache. The default is 14400 (i.e. 4 hours)."""
+
+ self.lock = thread.allocate_lock()
+
+ # Maps sessionIDs to sessions
+ self.entriesDict = {}
+
+ #Circular list of (sessionID, timestamp) pairs
+ self.entriesList = [(None,None)] * maxEntries
+
+ self.firstIndex = 0
+ self.lastIndex = 0
+ self.maxAge = maxAge
+
+ def __getitem__(self, sessionID):
+ self.lock.acquire()
+ try:
+ self._purge() #Delete old items, so we're assured of a new one
+ session = self.entriesDict[sessionID]
+
+ #When we add sessions they're resumable, but it's possible
+ #for the session to be invalidated later on (if a fatal alert
+ #is returned), so we have to check for resumability before
+ #returning the session.
+
+ if session.valid():
+ return session
+ else:
+ raise KeyError()
+ finally:
+ self.lock.release()
+
+
+ def __setitem__(self, sessionID, session):
+ self.lock.acquire()
+ try:
+ #Add the new element
+ self.entriesDict[sessionID] = session
+ self.entriesList[self.lastIndex] = (sessionID, time.time())
+ self.lastIndex = (self.lastIndex+1) % len(self.entriesList)
+
+ #If the cache is full, we delete the oldest element to make an
+ #empty space
+ if self.lastIndex == self.firstIndex:
+ del(self.entriesDict[self.entriesList[self.firstIndex][0]])
+ self.firstIndex = (self.firstIndex+1) % len(self.entriesList)
+ finally:
+ self.lock.release()
+
+ #Delete expired items
+ def _purge(self):
+ currentTime = time.time()
+
+ #Search through the circular list, deleting expired elements until
+ #we reach a non-expired element. Since elements in list are
+ #ordered in time, we can break once we reach the first non-expired
+ #element
+ index = self.firstIndex
+ while index != self.lastIndex:
+ if currentTime - self.entriesList[index][1] > self.maxAge:
+ del(self.entriesDict[self.entriesList[index][0]])
+ index = (index+1) % len(self.entriesList)
+ else:
+ break
+ self.firstIndex = index
+
+def _test():
+ import doctest, SessionCache
+ return doctest.testmod(SessionCache)
+
+if __name__ == "__main__":
+ _test()
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/SharedKeyDB.py b/samples/apps/marketplace_sample/gdata/tlslite/SharedKeyDB.py
new file mode 100755
index 0000000..3246ec7
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/SharedKeyDB.py
@@ -0,0 +1,58 @@
+"""Class for storing shared keys."""
+
+from utils.cryptomath import *
+from utils.compat import *
+from mathtls import *
+from Session import Session
+from BaseDB import BaseDB
+
+class SharedKeyDB(BaseDB):
+ """This class represent an in-memory or on-disk database of shared
+ keys.
+
+ A SharedKeyDB can be passed to a server handshake function to
+ authenticate a client based on one of the shared keys.
+
+ This class is thread-safe.
+ """
+
+ def __init__(self, filename=None):
+ """Create a new SharedKeyDB.
+
+ @type filename: str
+ @param filename: Filename for an on-disk database, or None for
+ an in-memory database. If the filename already exists, follow
+ this with a call to open(). To create a new on-disk database,
+ follow this with a call to create().
+ """
+ BaseDB.__init__(self, filename, "shared key")
+
+ def _getItem(self, username, valueStr):
+ session = Session()
+ session._createSharedKey(username, valueStr)
+ return session
+
+ def __setitem__(self, username, sharedKey):
+ """Add a shared key to the database.
+
+ @type username: str
+ @param username: The username to associate the shared key with.
+ Must be less than or equal to 16 characters in length, and must
+ not already be in the database.
+
+ @type sharedKey: str
+ @param sharedKey: The shared key to add. Must be less than 48
+ characters in length.
+ """
+ BaseDB.__setitem__(self, username, sharedKey)
+
+ def _setItem(self, username, value):
+ if len(username)>16:
+ raise ValueError("username too long")
+ if len(value)>=48:
+ raise ValueError("shared key too long")
+ return value
+
+ def _checkItem(self, value, username, param):
+ newSession = self._getItem(username, param)
+ return value.masterSecret == newSession.masterSecret
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/TLSConnection.py b/samples/apps/marketplace_sample/gdata/tlslite/TLSConnection.py
new file mode 100755
index 0000000..d125f8f
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/TLSConnection.py
@@ -0,0 +1,1600 @@
+"""
+MAIN CLASS FOR TLS LITE (START HERE!).
+"""
+from __future__ import generators
+
+import socket
+from utils.compat import formatExceptionTrace
+from TLSRecordLayer import TLSRecordLayer
+from Session import Session
+from constants import *
+from utils.cryptomath import getRandomBytes
+from errors import *
+from messages import *
+from mathtls import *
+from HandshakeSettings import HandshakeSettings
+
+
+class TLSConnection(TLSRecordLayer):
+ """
+ This class wraps a socket and provides TLS handshaking and data
+ transfer.
+
+ To use this class, create a new instance, passing a connected
+ socket into the constructor. Then call some handshake function.
+ If the handshake completes without raising an exception, then a TLS
+ connection has been negotiated. You can transfer data over this
+ connection as if it were a socket.
+
+ This class provides both synchronous and asynchronous versions of
+ its key functions. The synchronous versions should be used when
+ writing single-or multi-threaded code using blocking sockets. The
+ asynchronous versions should be used when performing asynchronous,
+ event-based I/O with non-blocking sockets.
+
+ Asynchronous I/O is a complicated subject; typically, you should
+ not use the asynchronous functions directly, but should use some
+ framework like asyncore or Twisted which TLS Lite integrates with
+ (see
+ L{tlslite.integration.TLSAsyncDispatcherMixIn.TLSAsyncDispatcherMixIn} or
+ L{tlslite.integration.TLSTwistedProtocolWrapper.TLSTwistedProtocolWrapper}).
+ """
+
+
+ def __init__(self, sock):
+ """Create a new TLSConnection instance.
+
+ @param sock: The socket data will be transmitted on. The
+ socket should already be connected. It may be in blocking or
+ non-blocking mode.
+
+ @type sock: L{socket.socket}
+ """
+ TLSRecordLayer.__init__(self, sock)
+
+ def handshakeClientSRP(self, username, password, session=None,
+ settings=None, checker=None, async=False):
+ """Perform an SRP handshake in the role of client.
+
+ This function performs a TLS/SRP handshake. SRP mutually
+ authenticates both parties to each other using only a
+ username and password. This function may also perform a
+ combined SRP and server-certificate handshake, if the server
+ chooses to authenticate itself with a certificate chain in
+ addition to doing SRP.
+
+ TLS/SRP is non-standard. Most TLS implementations don't
+ support it. See
+ U{http://www.ietf.org/html.charters/tls-charter.html} or
+ U{http://trevp.net/tlssrp/} for the latest information on
+ TLS/SRP.
+
+ Like any handshake function, this can be called on a closed
+ TLS connection, or on a TLS connection that is already open.
+ If called on an open connection it performs a re-handshake.
+
+ If the function completes without raising an exception, the
+ TLS connection will be open and available for data transfer.
+
+ If an exception is raised, the connection will have been
+ automatically closed (if it was ever open).
+
+ @type username: str
+ @param username: The SRP username.
+
+ @type password: str
+ @param password: The SRP password.
+
+ @type session: L{tlslite.Session.Session}
+ @param session: A TLS session to attempt to resume. This
+ session must be an SRP session performed with the same username
+ and password as were passed in. If the resumption does not
+ succeed, a full SRP handshake will be performed.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+
+ @type checker: L{tlslite.Checker.Checker}
+ @param checker: A Checker instance. This instance will be
+ invoked to examine the other party's authentication
+ credentials, if the handshake completes succesfully.
+
+ @type async: bool
+ @param async: If False, this function will block until the
+ handshake is completed. If True, this function will return a
+ generator. Successive invocations of the generator will
+ return 0 if it is waiting to read from the socket, 1 if it is
+ waiting to write to the socket, or will raise StopIteration if
+ the handshake operation is completed.
+
+ @rtype: None or an iterable
+ @return: If 'async' is True, a generator object will be
+ returned.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ @raise tlslite.errors.TLSAuthenticationError: If the checker
+ doesn't like the other party's authentication credentials.
+ """
+ handshaker = self._handshakeClientAsync(srpParams=(username, password),
+ session=session, settings=settings, checker=checker)
+ if async:
+ return handshaker
+ for result in handshaker:
+ pass
+
+ def handshakeClientCert(self, certChain=None, privateKey=None,
+ session=None, settings=None, checker=None,
+ async=False):
+ """Perform a certificate-based handshake in the role of client.
+
+ This function performs an SSL or TLS handshake. The server
+ will authenticate itself using an X.509 or cryptoID certificate
+ chain. If the handshake succeeds, the server's certificate
+ chain will be stored in the session's serverCertChain attribute.
+ Unless a checker object is passed in, this function does no
+ validation or checking of the server's certificate chain.
+
+ If the server requests client authentication, the
+ client will send the passed-in certificate chain, and use the
+ passed-in private key to authenticate itself. If no
+ certificate chain and private key were passed in, the client
+ will attempt to proceed without client authentication. The
+ server may or may not allow this.
+
+ Like any handshake function, this can be called on a closed
+ TLS connection, or on a TLS connection that is already open.
+ If called on an open connection it performs a re-handshake.
+
+ If the function completes without raising an exception, the
+ TLS connection will be open and available for data transfer.
+
+ If an exception is raised, the connection will have been
+ automatically closed (if it was ever open).
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: The certificate chain to be used if the
+ server requests client authentication.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: The private key to be used if the server
+ requests client authentication.
+
+ @type session: L{tlslite.Session.Session}
+ @param session: A TLS session to attempt to resume. If the
+ resumption does not succeed, a full handshake will be
+ performed.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+
+ @type checker: L{tlslite.Checker.Checker}
+ @param checker: A Checker instance. This instance will be
+ invoked to examine the other party's authentication
+ credentials, if the handshake completes succesfully.
+
+ @type async: bool
+ @param async: If False, this function will block until the
+ handshake is completed. If True, this function will return a
+ generator. Successive invocations of the generator will
+ return 0 if it is waiting to read from the socket, 1 if it is
+ waiting to write to the socket, or will raise StopIteration if
+ the handshake operation is completed.
+
+ @rtype: None or an iterable
+ @return: If 'async' is True, a generator object will be
+ returned.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ @raise tlslite.errors.TLSAuthenticationError: If the checker
+ doesn't like the other party's authentication credentials.
+ """
+ handshaker = self._handshakeClientAsync(certParams=(certChain,
+ privateKey), session=session, settings=settings,
+ checker=checker)
+ if async:
+ return handshaker
+ for result in handshaker:
+ pass
+
+ def handshakeClientUnknown(self, srpCallback=None, certCallback=None,
+ session=None, settings=None, checker=None,
+ async=False):
+ """Perform a to-be-determined type of handshake in the role of client.
+
+ This function performs an SSL or TLS handshake. If the server
+ requests client certificate authentication, the
+ certCallback will be invoked and should return a (certChain,
+ privateKey) pair. If the callback returns None, the library
+ will attempt to proceed without client authentication. The
+ server may or may not allow this.
+
+ If the server requests SRP authentication, the srpCallback
+ will be invoked and should return a (username, password) pair.
+ If the callback returns None, the local implementation will
+ signal a user_canceled error alert.
+
+ After the handshake completes, the client can inspect the
+ connection's session attribute to determine what type of
+ authentication was performed.
+
+ Like any handshake function, this can be called on a closed
+ TLS connection, or on a TLS connection that is already open.
+ If called on an open connection it performs a re-handshake.
+
+ If the function completes without raising an exception, the
+ TLS connection will be open and available for data transfer.
+
+ If an exception is raised, the connection will have been
+ automatically closed (if it was ever open).
+
+ @type srpCallback: callable
+ @param srpCallback: The callback to be used if the server
+ requests SRP authentication. If None, the client will not
+ offer support for SRP ciphersuites.
+
+ @type certCallback: callable
+ @param certCallback: The callback to be used if the server
+ requests client certificate authentication.
+
+ @type session: L{tlslite.Session.Session}
+ @param session: A TLS session to attempt to resume. If the
+ resumption does not succeed, a full handshake will be
+ performed.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+
+ @type checker: L{tlslite.Checker.Checker}
+ @param checker: A Checker instance. This instance will be
+ invoked to examine the other party's authentication
+ credentials, if the handshake completes succesfully.
+
+ @type async: bool
+ @param async: If False, this function will block until the
+ handshake is completed. If True, this function will return a
+ generator. Successive invocations of the generator will
+ return 0 if it is waiting to read from the socket, 1 if it is
+ waiting to write to the socket, or will raise StopIteration if
+ the handshake operation is completed.
+
+ @rtype: None or an iterable
+ @return: If 'async' is True, a generator object will be
+ returned.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ @raise tlslite.errors.TLSAuthenticationError: If the checker
+ doesn't like the other party's authentication credentials.
+ """
+ handshaker = self._handshakeClientAsync(unknownParams=(srpCallback,
+ certCallback), session=session, settings=settings,
+ checker=checker)
+ if async:
+ return handshaker
+ for result in handshaker:
+ pass
+
+ def handshakeClientSharedKey(self, username, sharedKey, settings=None,
+ checker=None, async=False):
+ """Perform a shared-key handshake in the role of client.
+
+ This function performs a shared-key handshake. Using shared
+ symmetric keys of high entropy (128 bits or greater) mutually
+ authenticates both parties to each other.
+
+ TLS with shared-keys is non-standard. Most TLS
+ implementations don't support it. See
+ U{http://www.ietf.org/html.charters/tls-charter.html} for the
+ latest information on TLS with shared-keys. If the shared-keys
+ Internet-Draft changes or is superceded, TLS Lite will track
+ those changes, so the shared-key support in later versions of
+ TLS Lite may become incompatible with this version.
+
+ Like any handshake function, this can be called on a closed
+ TLS connection, or on a TLS connection that is already open.
+ If called on an open connection it performs a re-handshake.
+
+ If the function completes without raising an exception, the
+ TLS connection will be open and available for data transfer.
+
+ If an exception is raised, the connection will have been
+ automatically closed (if it was ever open).
+
+ @type username: str
+ @param username: The shared-key username.
+
+ @type sharedKey: str
+ @param sharedKey: The shared key.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+
+ @type checker: L{tlslite.Checker.Checker}
+ @param checker: A Checker instance. This instance will be
+ invoked to examine the other party's authentication
+ credentials, if the handshake completes succesfully.
+
+ @type async: bool
+ @param async: If False, this function will block until the
+ handshake is completed. If True, this function will return a
+ generator. Successive invocations of the generator will
+ return 0 if it is waiting to read from the socket, 1 if it is
+ waiting to write to the socket, or will raise StopIteration if
+ the handshake operation is completed.
+
+ @rtype: None or an iterable
+ @return: If 'async' is True, a generator object will be
+ returned.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ @raise tlslite.errors.TLSAuthenticationError: If the checker
+ doesn't like the other party's authentication credentials.
+ """
+ handshaker = self._handshakeClientAsync(sharedKeyParams=(username,
+ sharedKey), settings=settings, checker=checker)
+ if async:
+ return handshaker
+ for result in handshaker:
+ pass
+
+ def _handshakeClientAsync(self, srpParams=(), certParams=(),
+ unknownParams=(), sharedKeyParams=(),
+ session=None, settings=None, checker=None,
+ recursive=False):
+
+ handshaker = self._handshakeClientAsyncHelper(srpParams=srpParams,
+ certParams=certParams, unknownParams=unknownParams,
+ sharedKeyParams=sharedKeyParams, session=session,
+ settings=settings, recursive=recursive)
+ for result in self._handshakeWrapperAsync(handshaker, checker):
+ yield result
+
+
+ def _handshakeClientAsyncHelper(self, srpParams, certParams, unknownParams,
+ sharedKeyParams, session, settings, recursive):
+ if not recursive:
+ self._handshakeStart(client=True)
+
+ #Unpack parameters
+ srpUsername = None # srpParams
+ password = None # srpParams
+ clientCertChain = None # certParams
+ privateKey = None # certParams
+ srpCallback = None # unknownParams
+ certCallback = None # unknownParams
+ #session # sharedKeyParams (or session)
+ #settings # settings
+
+ if srpParams:
+ srpUsername, password = srpParams
+ elif certParams:
+ clientCertChain, privateKey = certParams
+ elif unknownParams:
+ srpCallback, certCallback = unknownParams
+ elif sharedKeyParams:
+ session = Session()._createSharedKey(*sharedKeyParams)
+
+ if not settings:
+ settings = HandshakeSettings()
+ settings = settings._filter()
+
+ #Validate parameters
+ if srpUsername and not password:
+ raise ValueError("Caller passed a username but no password")
+ if password and not srpUsername:
+ raise ValueError("Caller passed a password but no username")
+
+ if clientCertChain and not privateKey:
+ raise ValueError("Caller passed a certChain but no privateKey")
+ if privateKey and not clientCertChain:
+ raise ValueError("Caller passed a privateKey but no certChain")
+
+ if clientCertChain:
+ foundType = False
+ try:
+ import cryptoIDlib.CertChain
+ if isinstance(clientCertChain, cryptoIDlib.CertChain.CertChain):
+ if "cryptoID" not in settings.certificateTypes:
+ raise ValueError("Client certificate doesn't "\
+ "match Handshake Settings")
+ settings.certificateTypes = ["cryptoID"]
+ foundType = True
+ except ImportError:
+ pass
+ if not foundType and isinstance(clientCertChain,
+ X509CertChain):
+ if "x509" not in settings.certificateTypes:
+ raise ValueError("Client certificate doesn't match "\
+ "Handshake Settings")
+ settings.certificateTypes = ["x509"]
+ foundType = True
+ if not foundType:
+ raise ValueError("Unrecognized certificate type")
+
+
+ if session:
+ if not session.valid():
+ session = None #ignore non-resumable sessions...
+ elif session.resumable and \
+ (session.srpUsername != srpUsername):
+ raise ValueError("Session username doesn't match")
+
+ #Add Faults to parameters
+ if srpUsername and self.fault == Fault.badUsername:
+ srpUsername += "GARBAGE"
+ if password and self.fault == Fault.badPassword:
+ password += "GARBAGE"
+ if sharedKeyParams:
+ identifier = sharedKeyParams[0]
+ sharedKey = sharedKeyParams[1]
+ if self.fault == Fault.badIdentifier:
+ identifier += "GARBAGE"
+ session = Session()._createSharedKey(identifier, sharedKey)
+ elif self.fault == Fault.badSharedKey:
+ sharedKey += "GARBAGE"
+ session = Session()._createSharedKey(identifier, sharedKey)
+
+
+ #Initialize locals
+ serverCertChain = None
+ cipherSuite = 0
+ certificateType = CertificateType.x509
+ premasterSecret = None
+
+ #Get client nonce
+ clientRandom = getRandomBytes(32)
+
+ #Initialize acceptable ciphersuites
+ cipherSuites = []
+ if srpParams:
+ cipherSuites += CipherSuite.getSrpRsaSuites(settings.cipherNames)
+ cipherSuites += CipherSuite.getSrpSuites(settings.cipherNames)
+ elif certParams:
+ cipherSuites += CipherSuite.getRsaSuites(settings.cipherNames)
+ elif unknownParams:
+ if srpCallback:
+ cipherSuites += \
+ CipherSuite.getSrpRsaSuites(settings.cipherNames)
+ cipherSuites += \
+ CipherSuite.getSrpSuites(settings.cipherNames)
+ cipherSuites += CipherSuite.getRsaSuites(settings.cipherNames)
+ elif sharedKeyParams:
+ cipherSuites += CipherSuite.getRsaSuites(settings.cipherNames)
+ else:
+ cipherSuites += CipherSuite.getRsaSuites(settings.cipherNames)
+
+ #Initialize acceptable certificate types
+ certificateTypes = settings._getCertificateTypes()
+
+ #Tentatively set the version to the client's minimum version.
+ #We'll use this for the ClientHello, and if an error occurs
+ #parsing the Server Hello, we'll use this version for the response
+ self.version = settings.maxVersion
+
+ #Either send ClientHello (with a resumable session)...
+ if session:
+ #If it's a resumable (i.e. not a shared-key session), then its
+ #ciphersuite must be one of the acceptable ciphersuites
+ if (not sharedKeyParams) and \
+ session.cipherSuite not in cipherSuites:
+ raise ValueError("Session's cipher suite not consistent "\
+ "with parameters")
+ else:
+ clientHello = ClientHello()
+ clientHello.create(settings.maxVersion, clientRandom,
+ session.sessionID, cipherSuites,
+ certificateTypes, session.srpUsername)
+
+ #Or send ClientHello (without)
+ else:
+ clientHello = ClientHello()
+ clientHello.create(settings.maxVersion, clientRandom,
+ createByteArraySequence([]), cipherSuites,
+ certificateTypes, srpUsername)
+ for result in self._sendMsg(clientHello):
+ yield result
+
+ #Get ServerHello (or missing_srp_username)
+ for result in self._getMsg((ContentType.handshake,
+ ContentType.alert),
+ HandshakeType.server_hello):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ msg = result
+
+ if isinstance(msg, ServerHello):
+ serverHello = msg
+ elif isinstance(msg, Alert):
+ alert = msg
+
+ #If it's not a missing_srp_username, re-raise
+ if alert.description != AlertDescription.missing_srp_username:
+ self._shutdown(False)
+ raise TLSRemoteAlert(alert)
+
+ #If we're not in SRP callback mode, we won't have offered SRP
+ #without a username, so we shouldn't get this alert
+ if not srpCallback:
+ for result in self._sendError(\
+ AlertDescription.unexpected_message):
+ yield result
+ srpParams = srpCallback()
+ #If the callback returns None, cancel the handshake
+ if srpParams == None:
+ for result in self._sendError(AlertDescription.user_canceled):
+ yield result
+
+ #Recursively perform handshake
+ for result in self._handshakeClientAsyncHelper(srpParams,
+ None, None, None, None, settings, True):
+ yield result
+ return
+
+ #Get the server version. Do this before anything else, so any
+ #error alerts will use the server's version
+ self.version = serverHello.server_version
+
+ #Future responses from server must use this version
+ self._versionCheck = True
+
+ #Check ServerHello
+ if serverHello.server_version < settings.minVersion:
+ for result in self._sendError(\
+ AlertDescription.protocol_version,
+ "Too old version: %s" % str(serverHello.server_version)):
+ yield result
+ if serverHello.server_version > settings.maxVersion:
+ for result in self._sendError(\
+ AlertDescription.protocol_version,
+ "Too new version: %s" % str(serverHello.server_version)):
+ yield result
+ if serverHello.cipher_suite not in cipherSuites:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Server responded with incorrect ciphersuite"):
+ yield result
+ if serverHello.certificate_type not in certificateTypes:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Server responded with incorrect certificate type"):
+ yield result
+ if serverHello.compression_method != 0:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Server responded with incorrect compression method"):
+ yield result
+
+ #Get the server nonce
+ serverRandom = serverHello.random
+
+ #If the server agrees to resume
+ if session and session.sessionID and \
+ serverHello.session_id == session.sessionID:
+
+ #If a shared-key, we're flexible about suites; otherwise the
+ #server-chosen suite has to match the session's suite
+ if sharedKeyParams:
+ session.cipherSuite = serverHello.cipher_suite
+ elif serverHello.cipher_suite != session.cipherSuite:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,\
+ "Server's ciphersuite doesn't match session"):
+ yield result
+
+ #Set the session for this connection
+ self.session = session
+
+ #Calculate pending connection states
+ self._calcPendingStates(clientRandom, serverRandom,
+ settings.cipherImplementations)
+
+ #Exchange ChangeCipherSpec and Finished messages
+ for result in self._getFinished():
+ yield result
+ for result in self._sendFinished():
+ yield result
+
+ #Mark the connection as open
+ self._handshakeDone(resumed=True)
+
+ #If server DOES NOT agree to resume
+ else:
+
+ if sharedKeyParams:
+ for result in self._sendError(\
+ AlertDescription.user_canceled,
+ "Was expecting a shared-key resumption"):
+ yield result
+
+ #We've already validated these
+ cipherSuite = serverHello.cipher_suite
+ certificateType = serverHello.certificate_type
+
+ #If the server chose an SRP suite...
+ if cipherSuite in CipherSuite.srpSuites:
+ #Get ServerKeyExchange, ServerHelloDone
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.server_key_exchange, cipherSuite):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverKeyExchange = result
+
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.server_hello_done):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverHelloDone = result
+
+ #If the server chose an SRP+RSA suite...
+ elif cipherSuite in CipherSuite.srpRsaSuites:
+ #Get Certificate, ServerKeyExchange, ServerHelloDone
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.certificate, certificateType):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverCertificate = result
+
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.server_key_exchange, cipherSuite):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverKeyExchange = result
+
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.server_hello_done):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverHelloDone = result
+
+ #If the server chose an RSA suite...
+ elif cipherSuite in CipherSuite.rsaSuites:
+ #Get Certificate[, CertificateRequest], ServerHelloDone
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.certificate, certificateType):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverCertificate = result
+
+ for result in self._getMsg(ContentType.handshake,
+ (HandshakeType.server_hello_done,
+ HandshakeType.certificate_request)):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ msg = result
+
+ certificateRequest = None
+ if isinstance(msg, CertificateRequest):
+ certificateRequest = msg
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.server_hello_done):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverHelloDone = result
+ elif isinstance(msg, ServerHelloDone):
+ serverHelloDone = msg
+ else:
+ raise AssertionError()
+
+
+ #Calculate SRP premaster secret, if server chose an SRP or
+ #SRP+RSA suite
+ if cipherSuite in CipherSuite.srpSuites + \
+ CipherSuite.srpRsaSuites:
+ #Get and check the server's group parameters and B value
+ N = serverKeyExchange.srp_N
+ g = serverKeyExchange.srp_g
+ s = serverKeyExchange.srp_s
+ B = serverKeyExchange.srp_B
+
+ if (g,N) not in goodGroupParameters:
+ for result in self._sendError(\
+ AlertDescription.untrusted_srp_parameters,
+ "Unknown group parameters"):
+ yield result
+ if numBits(N) < settings.minKeySize:
+ for result in self._sendError(\
+ AlertDescription.untrusted_srp_parameters,
+ "N value is too small: %d" % numBits(N)):
+ yield result
+ if numBits(N) > settings.maxKeySize:
+ for result in self._sendError(\
+ AlertDescription.untrusted_srp_parameters,
+ "N value is too large: %d" % numBits(N)):
+ yield result
+ if B % N == 0:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Suspicious B value"):
+ yield result
+
+ #Check the server's signature, if server chose an
+ #SRP+RSA suite
+ if cipherSuite in CipherSuite.srpRsaSuites:
+ #Hash ServerKeyExchange/ServerSRPParams
+ hashBytes = serverKeyExchange.hash(clientRandom,
+ serverRandom)
+
+ #Extract signature bytes from ServerKeyExchange
+ sigBytes = serverKeyExchange.signature
+ if len(sigBytes) == 0:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Server sent an SRP ServerKeyExchange "\
+ "message without a signature"):
+ yield result
+
+ #Get server's public key from the Certificate message
+ for result in self._getKeyFromChain(serverCertificate,
+ settings):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ publicKey, serverCertChain = result
+
+ #Verify signature
+ if not publicKey.verify(sigBytes, hashBytes):
+ for result in self._sendError(\
+ AlertDescription.decrypt_error,
+ "Signature failed to verify"):
+ yield result
+
+
+ #Calculate client's ephemeral DH values (a, A)
+ a = bytesToNumber(getRandomBytes(32))
+ A = powMod(g, a, N)
+
+ #Calculate client's static DH values (x, v)
+ x = makeX(bytesToString(s), srpUsername, password)
+ v = powMod(g, x, N)
+
+ #Calculate u
+ u = makeU(N, A, B)
+
+ #Calculate premaster secret
+ k = makeK(N, g)
+ S = powMod((B - (k*v)) % N, a+(u*x), N)
+
+ if self.fault == Fault.badA:
+ A = N
+ S = 0
+ premasterSecret = numberToBytes(S)
+
+ #Send ClientKeyExchange
+ for result in self._sendMsg(\
+ ClientKeyExchange(cipherSuite).createSRP(A)):
+ yield result
+
+
+ #Calculate RSA premaster secret, if server chose an RSA suite
+ elif cipherSuite in CipherSuite.rsaSuites:
+
+ #Handle the presence of a CertificateRequest
+ if certificateRequest:
+ if unknownParams and certCallback:
+ certParamsNew = certCallback()
+ if certParamsNew:
+ clientCertChain, privateKey = certParamsNew
+
+ #Get server's public key from the Certificate message
+ for result in self._getKeyFromChain(serverCertificate,
+ settings):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ publicKey, serverCertChain = result
+
+
+ #Calculate premaster secret
+ premasterSecret = getRandomBytes(48)
+ premasterSecret[0] = settings.maxVersion[0]
+ premasterSecret[1] = settings.maxVersion[1]
+
+ if self.fault == Fault.badPremasterPadding:
+ premasterSecret[0] = 5
+ if self.fault == Fault.shortPremasterSecret:
+ premasterSecret = premasterSecret[:-1]
+
+ #Encrypt premaster secret to server's public key
+ encryptedPreMasterSecret = publicKey.encrypt(premasterSecret)
+
+ #If client authentication was requested, send Certificate
+ #message, either with certificates or empty
+ if certificateRequest:
+ clientCertificate = Certificate(certificateType)
+
+ if clientCertChain:
+ #Check to make sure we have the same type of
+ #certificates the server requested
+ wrongType = False
+ if certificateType == CertificateType.x509:
+ if not isinstance(clientCertChain, X509CertChain):
+ wrongType = True
+ elif certificateType == CertificateType.cryptoID:
+ if not isinstance(clientCertChain,
+ cryptoIDlib.CertChain.CertChain):
+ wrongType = True
+ if wrongType:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure,
+ "Client certificate is of wrong type"):
+ yield result
+
+ clientCertificate.create(clientCertChain)
+
+ for result in self._sendMsg(clientCertificate):
+ yield result
+ else:
+ #The server didn't request client auth, so we
+ #zeroize these so the clientCertChain won't be
+ #stored in the session.
+ privateKey = None
+ clientCertChain = None
+
+ #Send ClientKeyExchange
+ clientKeyExchange = ClientKeyExchange(cipherSuite,
+ self.version)
+ clientKeyExchange.createRSA(encryptedPreMasterSecret)
+ for result in self._sendMsg(clientKeyExchange):
+ yield result
+
+ #If client authentication was requested and we have a
+ #private key, send CertificateVerify
+ if certificateRequest and privateKey:
+ if self.version == (3,0):
+ #Create a temporary session object, just for the
+ #purpose of creating the CertificateVerify
+ session = Session()
+ session._calcMasterSecret(self.version,
+ premasterSecret,
+ clientRandom,
+ serverRandom)
+ verifyBytes = self._calcSSLHandshakeHash(\
+ session.masterSecret, "")
+ elif self.version in ((3,1), (3,2)):
+ verifyBytes = stringToBytes(\
+ self._handshake_md5.digest() + \
+ self._handshake_sha.digest())
+ if self.fault == Fault.badVerifyMessage:
+ verifyBytes[0] = ((verifyBytes[0]+1) % 256)
+ signedBytes = privateKey.sign(verifyBytes)
+ certificateVerify = CertificateVerify()
+ certificateVerify.create(signedBytes)
+ for result in self._sendMsg(certificateVerify):
+ yield result
+
+
+ #Create the session object
+ self.session = Session()
+ self.session._calcMasterSecret(self.version, premasterSecret,
+ clientRandom, serverRandom)
+ self.session.sessionID = serverHello.session_id
+ self.session.cipherSuite = cipherSuite
+ self.session.srpUsername = srpUsername
+ self.session.clientCertChain = clientCertChain
+ self.session.serverCertChain = serverCertChain
+
+ #Calculate pending connection states
+ self._calcPendingStates(clientRandom, serverRandom,
+ settings.cipherImplementations)
+
+ #Exchange ChangeCipherSpec and Finished messages
+ for result in self._sendFinished():
+ yield result
+ for result in self._getFinished():
+ yield result
+
+ #Mark the connection as open
+ self.session._setResumable(True)
+ self._handshakeDone(resumed=False)
+
+
+
+ def handshakeServer(self, sharedKeyDB=None, verifierDB=None,
+ certChain=None, privateKey=None, reqCert=False,
+ sessionCache=None, settings=None, checker=None):
+ """Perform a handshake in the role of server.
+
+ This function performs an SSL or TLS handshake. Depending on
+ the arguments and the behavior of the client, this function can
+ perform a shared-key, SRP, or certificate-based handshake. It
+ can also perform a combined SRP and server-certificate
+ handshake.
+
+ Like any handshake function, this can be called on a closed
+ TLS connection, or on a TLS connection that is already open.
+ If called on an open connection it performs a re-handshake.
+ This function does not send a Hello Request message before
+ performing the handshake, so if re-handshaking is required,
+ the server must signal the client to begin the re-handshake
+ through some other means.
+
+ If the function completes without raising an exception, the
+ TLS connection will be open and available for data transfer.
+
+ If an exception is raised, the connection will have been
+ automatically closed (if it was ever open).
+
+ @type sharedKeyDB: L{tlslite.SharedKeyDB.SharedKeyDB}
+ @param sharedKeyDB: A database of shared symmetric keys
+ associated with usernames. If the client performs a
+ shared-key handshake, the session's sharedKeyUsername
+ attribute will be set.
+
+ @type verifierDB: L{tlslite.VerifierDB.VerifierDB}
+ @param verifierDB: A database of SRP password verifiers
+ associated with usernames. If the client performs an SRP
+ handshake, the session's srpUsername attribute will be set.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: The certificate chain to be used if the
+ client requests server certificate authentication.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: The private key to be used if the client
+ requests server certificate authentication.
+
+ @type reqCert: bool
+ @param reqCert: Whether to request client certificate
+ authentication. This only applies if the client chooses server
+ certificate authentication; if the client chooses SRP or
+ shared-key authentication, this will be ignored. If the client
+ performs a client certificate authentication, the sessions's
+ clientCertChain attribute will be set.
+
+ @type sessionCache: L{tlslite.SessionCache.SessionCache}
+ @param sessionCache: An in-memory cache of resumable sessions.
+ The client can resume sessions from this cache. Alternatively,
+ if the client performs a full handshake, a new session will be
+ added to the cache.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites and SSL/TLS version chosen by the server.
+
+ @type checker: L{tlslite.Checker.Checker}
+ @param checker: A Checker instance. This instance will be
+ invoked to examine the other party's authentication
+ credentials, if the handshake completes succesfully.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ @raise tlslite.errors.TLSAuthenticationError: If the checker
+ doesn't like the other party's authentication credentials.
+ """
+ for result in self.handshakeServerAsync(sharedKeyDB, verifierDB,
+ certChain, privateKey, reqCert, sessionCache, settings,
+ checker):
+ pass
+
+
+ def handshakeServerAsync(self, sharedKeyDB=None, verifierDB=None,
+ certChain=None, privateKey=None, reqCert=False,
+ sessionCache=None, settings=None, checker=None):
+ """Start a server handshake operation on the TLS connection.
+
+ This function returns a generator which behaves similarly to
+ handshakeServer(). Successive invocations of the generator
+ will return 0 if it is waiting to read from the socket, 1 if it is
+ waiting to write to the socket, or it will raise StopIteration
+ if the handshake operation is complete.
+
+ @rtype: iterable
+ @return: A generator; see above for details.
+ """
+ handshaker = self._handshakeServerAsyncHelper(\
+ sharedKeyDB=sharedKeyDB,
+ verifierDB=verifierDB, certChain=certChain,
+ privateKey=privateKey, reqCert=reqCert,
+ sessionCache=sessionCache, settings=settings)
+ for result in self._handshakeWrapperAsync(handshaker, checker):
+ yield result
+
+
+ def _handshakeServerAsyncHelper(self, sharedKeyDB, verifierDB,
+ certChain, privateKey, reqCert, sessionCache,
+ settings):
+
+ self._handshakeStart(client=False)
+
+ if (not sharedKeyDB) and (not verifierDB) and (not certChain):
+ raise ValueError("Caller passed no authentication credentials")
+ if certChain and not privateKey:
+ raise ValueError("Caller passed a certChain but no privateKey")
+ if privateKey and not certChain:
+ raise ValueError("Caller passed a privateKey but no certChain")
+
+ if not settings:
+ settings = HandshakeSettings()
+ settings = settings._filter()
+
+ #Initialize acceptable cipher suites
+ cipherSuites = []
+ if verifierDB:
+ if certChain:
+ cipherSuites += \
+ CipherSuite.getSrpRsaSuites(settings.cipherNames)
+ cipherSuites += CipherSuite.getSrpSuites(settings.cipherNames)
+ if sharedKeyDB or certChain:
+ cipherSuites += CipherSuite.getRsaSuites(settings.cipherNames)
+
+ #Initialize acceptable certificate type
+ certificateType = None
+ if certChain:
+ try:
+ import cryptoIDlib.CertChain
+ if isinstance(certChain, cryptoIDlib.CertChain.CertChain):
+ certificateType = CertificateType.cryptoID
+ except ImportError:
+ pass
+ if isinstance(certChain, X509CertChain):
+ certificateType = CertificateType.x509
+ if certificateType == None:
+ raise ValueError("Unrecognized certificate type")
+
+ #Initialize locals
+ clientCertChain = None
+ serverCertChain = None #We may set certChain to this later
+ postFinishedError = None
+
+ #Tentatively set version to most-desirable version, so if an error
+ #occurs parsing the ClientHello, this is what we'll use for the
+ #error alert
+ self.version = settings.maxVersion
+
+ #Get ClientHello
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.client_hello):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ clientHello = result
+
+ #If client's version is too low, reject it
+ if clientHello.client_version < settings.minVersion:
+ self.version = settings.minVersion
+ for result in self._sendError(\
+ AlertDescription.protocol_version,
+ "Too old version: %s" % str(clientHello.client_version)):
+ yield result
+
+ #If client's version is too high, propose my highest version
+ elif clientHello.client_version > settings.maxVersion:
+ self.version = settings.maxVersion
+
+ else:
+ #Set the version to the client's version
+ self.version = clientHello.client_version
+
+ #Get the client nonce; create server nonce
+ clientRandom = clientHello.random
+ serverRandom = getRandomBytes(32)
+
+ #Calculate the first cipher suite intersection.
+ #This is the 'privileged' ciphersuite. We'll use it if we're
+ #doing a shared-key resumption or a new negotiation. In fact,
+ #the only time we won't use it is if we're resuming a non-sharedkey
+ #session, in which case we use the ciphersuite from the session.
+ #
+ #Given the current ciphersuite ordering, this means we prefer SRP
+ #over non-SRP.
+ for cipherSuite in cipherSuites:
+ if cipherSuite in clientHello.cipher_suites:
+ break
+ else:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+
+ #If resumption was requested...
+ if clientHello.session_id and (sharedKeyDB or sessionCache):
+ session = None
+
+ #Check in the sharedKeys container
+ if sharedKeyDB and len(clientHello.session_id)==16:
+ try:
+ #Trim off zero padding, if any
+ for x in range(16):
+ if clientHello.session_id[x]==0:
+ break
+ self.allegedSharedKeyUsername = bytesToString(\
+ clientHello.session_id[:x])
+ session = sharedKeyDB[self.allegedSharedKeyUsername]
+ if not session.sharedKey:
+ raise AssertionError()
+ #use privileged ciphersuite
+ session.cipherSuite = cipherSuite
+ except KeyError:
+ pass
+
+ #Then check in the session cache
+ if sessionCache and not session:
+ try:
+ session = sessionCache[bytesToString(\
+ clientHello.session_id)]
+ if session.sharedKey:
+ raise AssertionError()
+ if not session.resumable:
+ raise AssertionError()
+ #Check for consistency with ClientHello
+ if session.cipherSuite not in cipherSuites:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+ if session.cipherSuite not in clientHello.cipher_suites:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+ if clientHello.srp_username:
+ if clientHello.srp_username != session.srpUsername:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+ except KeyError:
+ pass
+
+ #If a session is found..
+ if session:
+ #Set the session
+ self.session = session
+
+ #Send ServerHello
+ serverHello = ServerHello()
+ serverHello.create(self.version, serverRandom,
+ session.sessionID, session.cipherSuite,
+ certificateType)
+ for result in self._sendMsg(serverHello):
+ yield result
+
+ #From here on, the client's messages must have the right version
+ self._versionCheck = True
+
+ #Calculate pending connection states
+ self._calcPendingStates(clientRandom, serverRandom,
+ settings.cipherImplementations)
+
+ #Exchange ChangeCipherSpec and Finished messages
+ for result in self._sendFinished():
+ yield result
+ for result in self._getFinished():
+ yield result
+
+ #Mark the connection as open
+ self._handshakeDone(resumed=True)
+ return
+
+
+ #If not a resumption...
+
+ #TRICKY: we might have chosen an RSA suite that was only deemed
+ #acceptable because of the shared-key resumption. If the shared-
+ #key resumption failed, because the identifier wasn't recognized,
+ #we might fall through to here, where we have an RSA suite
+ #chosen, but no certificate.
+ if cipherSuite in CipherSuite.rsaSuites and not certChain:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+
+ #If an RSA suite is chosen, check for certificate type intersection
+ #(We do this check down here because if the mismatch occurs but the
+ # client is using a shared-key session, it's okay)
+ if cipherSuite in CipherSuite.rsaSuites + \
+ CipherSuite.srpRsaSuites:
+ if certificateType not in clientHello.certificate_types:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure,
+ "the client doesn't support my certificate type"):
+ yield result
+
+ #Move certChain -> serverCertChain, now that we're using it
+ serverCertChain = certChain
+
+
+ #Create sessionID
+ if sessionCache:
+ sessionID = getRandomBytes(32)
+ else:
+ sessionID = createByteArraySequence([])
+
+ #If we've selected an SRP suite, exchange keys and calculate
+ #premaster secret:
+ if cipherSuite in CipherSuite.srpSuites + CipherSuite.srpRsaSuites:
+
+ #If there's no SRP username...
+ if not clientHello.srp_username:
+
+ #Ask the client to re-send ClientHello with one
+ for result in self._sendMsg(Alert().create(\
+ AlertDescription.missing_srp_username,
+ AlertLevel.warning)):
+ yield result
+
+ #Get ClientHello
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.client_hello):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ clientHello = result
+
+ #Check ClientHello
+ #If client's version is too low, reject it (COPIED CODE; BAD!)
+ if clientHello.client_version < settings.minVersion:
+ self.version = settings.minVersion
+ for result in self._sendError(\
+ AlertDescription.protocol_version,
+ "Too old version: %s" % str(clientHello.client_version)):
+ yield result
+
+ #If client's version is too high, propose my highest version
+ elif clientHello.client_version > settings.maxVersion:
+ self.version = settings.maxVersion
+
+ else:
+ #Set the version to the client's version
+ self.version = clientHello.client_version
+
+ #Recalculate the privileged cipher suite, making sure to
+ #pick an SRP suite
+ cipherSuites = [c for c in cipherSuites if c in \
+ CipherSuite.srpSuites + \
+ CipherSuite.srpRsaSuites]
+ for cipherSuite in cipherSuites:
+ if cipherSuite in clientHello.cipher_suites:
+ break
+ else:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+
+ #Get the client nonce; create server nonce
+ clientRandom = clientHello.random
+ serverRandom = getRandomBytes(32)
+
+ #The username better be there, this time
+ if not clientHello.srp_username:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Client resent a hello, but without the SRP"\
+ " username"):
+ yield result
+
+
+ #Get username
+ self.allegedSrpUsername = clientHello.srp_username
+
+ #Get parameters from username
+ try:
+ entry = verifierDB[self.allegedSrpUsername]
+ except KeyError:
+ for result in self._sendError(\
+ AlertDescription.unknown_srp_username):
+ yield result
+ (N, g, s, v) = entry
+
+ #Calculate server's ephemeral DH values (b, B)
+ b = bytesToNumber(getRandomBytes(32))
+ k = makeK(N, g)
+ B = (powMod(g, b, N) + (k*v)) % N
+
+ #Create ServerKeyExchange, signing it if necessary
+ serverKeyExchange = ServerKeyExchange(cipherSuite)
+ serverKeyExchange.createSRP(N, g, stringToBytes(s), B)
+ if cipherSuite in CipherSuite.srpRsaSuites:
+ hashBytes = serverKeyExchange.hash(clientRandom,
+ serverRandom)
+ serverKeyExchange.signature = privateKey.sign(hashBytes)
+
+ #Send ServerHello[, Certificate], ServerKeyExchange,
+ #ServerHelloDone
+ msgs = []
+ serverHello = ServerHello()
+ serverHello.create(self.version, serverRandom, sessionID,
+ cipherSuite, certificateType)
+ msgs.append(serverHello)
+ if cipherSuite in CipherSuite.srpRsaSuites:
+ certificateMsg = Certificate(certificateType)
+ certificateMsg.create(serverCertChain)
+ msgs.append(certificateMsg)
+ msgs.append(serverKeyExchange)
+ msgs.append(ServerHelloDone())
+ for result in self._sendMsgs(msgs):
+ yield result
+
+ #From here on, the client's messages must have the right version
+ self._versionCheck = True
+
+ #Get and check ClientKeyExchange
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.client_key_exchange,
+ cipherSuite):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ clientKeyExchange = result
+ A = clientKeyExchange.srp_A
+ if A % N == 0:
+ postFinishedError = (AlertDescription.illegal_parameter,
+ "Suspicious A value")
+ #Calculate u
+ u = makeU(N, A, B)
+
+ #Calculate premaster secret
+ S = powMod((A * powMod(v,u,N)) % N, b, N)
+ premasterSecret = numberToBytes(S)
+
+
+ #If we've selected an RSA suite, exchange keys and calculate
+ #premaster secret:
+ elif cipherSuite in CipherSuite.rsaSuites:
+
+ #Send ServerHello, Certificate[, CertificateRequest],
+ #ServerHelloDone
+ msgs = []
+ msgs.append(ServerHello().create(self.version, serverRandom,
+ sessionID, cipherSuite, certificateType))
+ msgs.append(Certificate(certificateType).create(serverCertChain))
+ if reqCert:
+ msgs.append(CertificateRequest())
+ msgs.append(ServerHelloDone())
+ for result in self._sendMsgs(msgs):
+ yield result
+
+ #From here on, the client's messages must have the right version
+ self._versionCheck = True
+
+ #Get [Certificate,] (if was requested)
+ if reqCert:
+ if self.version == (3,0):
+ for result in self._getMsg((ContentType.handshake,
+ ContentType.alert),
+ HandshakeType.certificate,
+ certificateType):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ msg = result
+
+ if isinstance(msg, Alert):
+ #If it's not a no_certificate alert, re-raise
+ alert = msg
+ if alert.description != \
+ AlertDescription.no_certificate:
+ self._shutdown(False)
+ raise TLSRemoteAlert(alert)
+ elif isinstance(msg, Certificate):
+ clientCertificate = msg
+ if clientCertificate.certChain and \
+ clientCertificate.certChain.getNumCerts()!=0:
+ clientCertChain = clientCertificate.certChain
+ else:
+ raise AssertionError()
+ elif self.version in ((3,1), (3,2)):
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.certificate,
+ certificateType):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ clientCertificate = result
+ if clientCertificate.certChain and \
+ clientCertificate.certChain.getNumCerts()!=0:
+ clientCertChain = clientCertificate.certChain
+ else:
+ raise AssertionError()
+
+ #Get ClientKeyExchange
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.client_key_exchange,
+ cipherSuite):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ clientKeyExchange = result
+
+ #Decrypt ClientKeyExchange
+ premasterSecret = privateKey.decrypt(\
+ clientKeyExchange.encryptedPreMasterSecret)
+
+ randomPreMasterSecret = getRandomBytes(48)
+ versionCheck = (premasterSecret[0], premasterSecret[1])
+ if not premasterSecret:
+ premasterSecret = randomPreMasterSecret
+ elif len(premasterSecret)!=48:
+ premasterSecret = randomPreMasterSecret
+ elif versionCheck != clientHello.client_version:
+ if versionCheck != self.version: #Tolerate buggy IE clients
+ premasterSecret = randomPreMasterSecret
+
+ #Get and check CertificateVerify, if relevant
+ if clientCertChain:
+ if self.version == (3,0):
+ #Create a temporary session object, just for the purpose
+ #of checking the CertificateVerify
+ session = Session()
+ session._calcMasterSecret(self.version, premasterSecret,
+ clientRandom, serverRandom)
+ verifyBytes = self._calcSSLHandshakeHash(\
+ session.masterSecret, "")
+ elif self.version in ((3,1), (3,2)):
+ verifyBytes = stringToBytes(self._handshake_md5.digest() +\
+ self._handshake_sha.digest())
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.certificate_verify):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ certificateVerify = result
+ publicKey = clientCertChain.getEndEntityPublicKey()
+ if len(publicKey) < settings.minKeySize:
+ postFinishedError = (AlertDescription.handshake_failure,
+ "Client's public key too small: %d" % len(publicKey))
+ if len(publicKey) > settings.maxKeySize:
+ postFinishedError = (AlertDescription.handshake_failure,
+ "Client's public key too large: %d" % len(publicKey))
+
+ if not publicKey.verify(certificateVerify.signature,
+ verifyBytes):
+ postFinishedError = (AlertDescription.decrypt_error,
+ "Signature failed to verify")
+
+
+ #Create the session object
+ self.session = Session()
+ self.session._calcMasterSecret(self.version, premasterSecret,
+ clientRandom, serverRandom)
+ self.session.sessionID = sessionID
+ self.session.cipherSuite = cipherSuite
+ self.session.srpUsername = self.allegedSrpUsername
+ self.session.clientCertChain = clientCertChain
+ self.session.serverCertChain = serverCertChain
+
+ #Calculate pending connection states
+ self._calcPendingStates(clientRandom, serverRandom,
+ settings.cipherImplementations)
+
+ #Exchange ChangeCipherSpec and Finished messages
+ for result in self._getFinished():
+ yield result
+
+ #If we were holding a post-finished error until receiving the client
+ #finished message, send it now. We delay the call until this point
+ #because calling sendError() throws an exception, and our caller might
+ #shut down the socket upon receiving the exception. If he did, and the
+ #client was still sending its ChangeCipherSpec or Finished messages, it
+ #would cause a socket error on the client side. This is a lot of
+ #consideration to show to misbehaving clients, but this would also
+ #cause problems with fault-testing.
+ if postFinishedError:
+ for result in self._sendError(*postFinishedError):
+ yield result
+
+ for result in self._sendFinished():
+ yield result
+
+ #Add the session object to the session cache
+ if sessionCache and sessionID:
+ sessionCache[bytesToString(sessionID)] = self.session
+
+ #Mark the connection as open
+ self.session._setResumable(True)
+ self._handshakeDone(resumed=False)
+
+
+ def _handshakeWrapperAsync(self, handshaker, checker):
+ if not self.fault:
+ try:
+ for result in handshaker:
+ yield result
+ if checker:
+ try:
+ checker(self)
+ except TLSAuthenticationError:
+ alert = Alert().create(AlertDescription.close_notify,
+ AlertLevel.fatal)
+ for result in self._sendMsg(alert):
+ yield result
+ raise
+ except:
+ self._shutdown(False)
+ raise
+ else:
+ try:
+ for result in handshaker:
+ yield result
+ if checker:
+ try:
+ checker(self)
+ except TLSAuthenticationError:
+ alert = Alert().create(AlertDescription.close_notify,
+ AlertLevel.fatal)
+ for result in self._sendMsg(alert):
+ yield result
+ raise
+ except socket.error, e:
+ raise TLSFaultError("socket error!")
+ except TLSAbruptCloseError, e:
+ raise TLSFaultError("abrupt close error!")
+ except TLSAlert, alert:
+ if alert.description not in Fault.faultAlerts[self.fault]:
+ raise TLSFaultError(str(alert))
+ else:
+ pass
+ except:
+ self._shutdown(False)
+ raise
+ else:
+ raise TLSFaultError("No error!")
+
+
+ def _getKeyFromChain(self, certificate, settings):
+ #Get and check cert chain from the Certificate message
+ certChain = certificate.certChain
+ if not certChain or certChain.getNumCerts() == 0:
+ for result in self._sendError(AlertDescription.illegal_parameter,
+ "Other party sent a Certificate message without "\
+ "certificates"):
+ yield result
+
+ #Get and check public key from the cert chain
+ publicKey = certChain.getEndEntityPublicKey()
+ if len(publicKey) < settings.minKeySize:
+ for result in self._sendError(AlertDescription.handshake_failure,
+ "Other party's public key too small: %d" % len(publicKey)):
+ yield result
+ if len(publicKey) > settings.maxKeySize:
+ for result in self._sendError(AlertDescription.handshake_failure,
+ "Other party's public key too large: %d" % len(publicKey)):
+ yield result
+
+ yield publicKey, certChain
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/TLSRecordLayer.py b/samples/apps/marketplace_sample/gdata/tlslite/TLSRecordLayer.py
new file mode 100755
index 0000000..875ce80
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/TLSRecordLayer.py
@@ -0,0 +1,1123 @@
+"""Helper class for TLSConnection."""
+from __future__ import generators
+
+from utils.compat import *
+from utils.cryptomath import *
+from utils.cipherfactory import createAES, createRC4, createTripleDES
+from utils.codec import *
+from errors import *
+from messages import *
+from mathtls import *
+from constants import *
+from utils.cryptomath import getRandomBytes
+from utils import hmac
+from FileObject import FileObject
+import sha
+import md5
+import socket
+import errno
+import traceback
+
+class _ConnectionState:
+ def __init__(self):
+ self.macContext = None
+ self.encContext = None
+ self.seqnum = 0
+
+ def getSeqNumStr(self):
+ w = Writer(8)
+ w.add(self.seqnum, 8)
+ seqnumStr = bytesToString(w.bytes)
+ self.seqnum += 1
+ return seqnumStr
+
+
+class TLSRecordLayer:
+ """
+ This class handles data transmission for a TLS connection.
+
+ Its only subclass is L{tlslite.TLSConnection.TLSConnection}. We've
+ separated the code in this class from TLSConnection to make things
+ more readable.
+
+
+ @type sock: socket.socket
+ @ivar sock: The underlying socket object.
+
+ @type session: L{tlslite.Session.Session}
+ @ivar session: The session corresponding to this connection.
+
+ Due to TLS session resumption, multiple connections can correspond
+ to the same underlying session.
+
+ @type version: tuple
+ @ivar version: The TLS version being used for this connection.
+
+ (3,0) means SSL 3.0, and (3,1) means TLS 1.0.
+
+ @type closed: bool
+ @ivar closed: If this connection is closed.
+
+ @type resumed: bool
+ @ivar resumed: If this connection is based on a resumed session.
+
+ @type allegedSharedKeyUsername: str or None
+ @ivar allegedSharedKeyUsername: This is set to the shared-key
+ username asserted by the client, whether the handshake succeeded or
+ not. If the handshake fails, this can be inspected to
+ determine if a guessing attack is in progress against a particular
+ user account.
+
+ @type allegedSrpUsername: str or None
+ @ivar allegedSrpUsername: This is set to the SRP username
+ asserted by the client, whether the handshake succeeded or not.
+ If the handshake fails, this can be inspected to determine
+ if a guessing attack is in progress against a particular user
+ account.
+
+ @type closeSocket: bool
+ @ivar closeSocket: If the socket should be closed when the
+ connection is closed (writable).
+
+ If you set this to True, TLS Lite will assume the responsibility of
+ closing the socket when the TLS Connection is shutdown (either
+ through an error or through the user calling close()). The default
+ is False.
+
+ @type ignoreAbruptClose: bool
+ @ivar ignoreAbruptClose: If an abrupt close of the socket should
+ raise an error (writable).
+
+ If you set this to True, TLS Lite will not raise a
+ L{tlslite.errors.TLSAbruptCloseError} exception if the underlying
+ socket is unexpectedly closed. Such an unexpected closure could be
+ caused by an attacker. However, it also occurs with some incorrect
+ TLS implementations.
+
+ You should set this to True only if you're not worried about an
+ attacker truncating the connection, and only if necessary to avoid
+ spurious errors. The default is False.
+
+ @sort: __init__, read, readAsync, write, writeAsync, close, closeAsync,
+ getCipherImplementation, getCipherName
+ """
+
+ def __init__(self, sock):
+ self.sock = sock
+
+ #My session object (Session instance; read-only)
+ self.session = None
+
+ #Am I a client or server?
+ self._client = None
+
+ #Buffers for processing messages
+ self._handshakeBuffer = []
+ self._readBuffer = ""
+
+ #Handshake digests
+ self._handshake_md5 = md5.md5()
+ self._handshake_sha = sha.sha()
+
+ #TLS Protocol Version
+ self.version = (0,0) #read-only
+ self._versionCheck = False #Once we choose a version, this is True
+
+ #Current and Pending connection states
+ self._writeState = _ConnectionState()
+ self._readState = _ConnectionState()
+ self._pendingWriteState = _ConnectionState()
+ self._pendingReadState = _ConnectionState()
+
+ #Is the connection open?
+ self.closed = True #read-only
+ self._refCount = 0 #Used to trigger closure
+
+ #Is this a resumed (or shared-key) session?
+ self.resumed = False #read-only
+
+ #What username did the client claim in his handshake?
+ self.allegedSharedKeyUsername = None
+ self.allegedSrpUsername = None
+
+ #On a call to close(), do we close the socket? (writeable)
+ self.closeSocket = False
+
+ #If the socket is abruptly closed, do we ignore it
+ #and pretend the connection was shut down properly? (writeable)
+ self.ignoreAbruptClose = False
+
+ #Fault we will induce, for testing purposes
+ self.fault = None
+
+ #*********************************************************
+ # Public Functions START
+ #*********************************************************
+
+ def read(self, max=None, min=1):
+ """Read some data from the TLS connection.
+
+ This function will block until at least 'min' bytes are
+ available (or the connection is closed).
+
+ If an exception is raised, the connection will have been
+ automatically closed.
+
+ @type max: int
+ @param max: The maximum number of bytes to return.
+
+ @type min: int
+ @param min: The minimum number of bytes to return
+
+ @rtype: str
+ @return: A string of no more than 'max' bytes, and no fewer
+ than 'min' (unless the connection has been closed, in which
+ case fewer than 'min' bytes may be returned).
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ """
+ for result in self.readAsync(max, min):
+ pass
+ return result
+
+ def readAsync(self, max=None, min=1):
+ """Start a read operation on the TLS connection.
+
+ This function returns a generator which behaves similarly to
+ read(). Successive invocations of the generator will return 0
+ if it is waiting to read from the socket, 1 if it is waiting
+ to write to the socket, or a string if the read operation has
+ completed.
+
+ @rtype: iterable
+ @return: A generator; see above for details.
+ """
+ try:
+ while len(self._readBuffer)<min and not self.closed:
+ try:
+ for result in self._getMsg(ContentType.application_data):
+ if result in (0,1):
+ yield result
+ applicationData = result
+ self._readBuffer += bytesToString(applicationData.write())
+ except TLSRemoteAlert, alert:
+ if alert.description != AlertDescription.close_notify:
+ raise
+ except TLSAbruptCloseError:
+ if not self.ignoreAbruptClose:
+ raise
+ else:
+ self._shutdown(True)
+
+ if max == None:
+ max = len(self._readBuffer)
+
+ returnStr = self._readBuffer[:max]
+ self._readBuffer = self._readBuffer[max:]
+ yield returnStr
+ except:
+ self._shutdown(False)
+ raise
+
+ def write(self, s):
+ """Write some data to the TLS connection.
+
+ This function will block until all the data has been sent.
+
+ If an exception is raised, the connection will have been
+ automatically closed.
+
+ @type s: str
+ @param s: The data to transmit to the other party.
+
+ @raise socket.error: If a socket error occurs.
+ """
+ for result in self.writeAsync(s):
+ pass
+
+ def writeAsync(self, s):
+ """Start a write operation on the TLS connection.
+
+ This function returns a generator which behaves similarly to
+ write(). Successive invocations of the generator will return
+ 1 if it is waiting to write to the socket, or will raise
+ StopIteration if the write operation has completed.
+
+ @rtype: iterable
+ @return: A generator; see above for details.
+ """
+ try:
+ if self.closed:
+ raise ValueError()
+
+ index = 0
+ blockSize = 16384
+ skipEmptyFrag = False
+ while 1:
+ startIndex = index * blockSize
+ endIndex = startIndex + blockSize
+ if startIndex >= len(s):
+ break
+ if endIndex > len(s):
+ endIndex = len(s)
+ block = stringToBytes(s[startIndex : endIndex])
+ applicationData = ApplicationData().create(block)
+ for result in self._sendMsg(applicationData, skipEmptyFrag):
+ yield result
+ skipEmptyFrag = True #only send an empy fragment on 1st message
+ index += 1
+ except:
+ self._shutdown(False)
+ raise
+
+ def close(self):
+ """Close the TLS connection.
+
+ This function will block until it has exchanged close_notify
+ alerts with the other party. After doing so, it will shut down the
+ TLS connection. Further attempts to read through this connection
+ will return "". Further attempts to write through this connection
+ will raise ValueError.
+
+ If makefile() has been called on this connection, the connection
+ will be not be closed until the connection object and all file
+ objects have been closed.
+
+ Even if an exception is raised, the connection will have been
+ closed.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ """
+ if not self.closed:
+ for result in self._decrefAsync():
+ pass
+
+ def closeAsync(self):
+ """Start a close operation on the TLS connection.
+
+ This function returns a generator which behaves similarly to
+ close(). Successive invocations of the generator will return 0
+ if it is waiting to read from the socket, 1 if it is waiting
+ to write to the socket, or will raise StopIteration if the
+ close operation has completed.
+
+ @rtype: iterable
+ @return: A generator; see above for details.
+ """
+ if not self.closed:
+ for result in self._decrefAsync():
+ yield result
+
+ def _decrefAsync(self):
+ self._refCount -= 1
+ if self._refCount == 0 and not self.closed:
+ try:
+ for result in self._sendMsg(Alert().create(\
+ AlertDescription.close_notify, AlertLevel.warning)):
+ yield result
+ alert = None
+ while not alert:
+ for result in self._getMsg((ContentType.alert, \
+ ContentType.application_data)):
+ if result in (0,1):
+ yield result
+ if result.contentType == ContentType.alert:
+ alert = result
+ if alert.description == AlertDescription.close_notify:
+ self._shutdown(True)
+ else:
+ raise TLSRemoteAlert(alert)
+ except (socket.error, TLSAbruptCloseError):
+ #If the other side closes the socket, that's okay
+ self._shutdown(True)
+ except:
+ self._shutdown(False)
+ raise
+
+ def getCipherName(self):
+ """Get the name of the cipher used with this connection.
+
+ @rtype: str
+ @return: The name of the cipher used with this connection.
+ Either 'aes128', 'aes256', 'rc4', or '3des'.
+ """
+ if not self._writeState.encContext:
+ return None
+ return self._writeState.encContext.name
+
+ def getCipherImplementation(self):
+ """Get the name of the cipher implementation used with
+ this connection.
+
+ @rtype: str
+ @return: The name of the cipher implementation used with
+ this connection. Either 'python', 'cryptlib', 'openssl',
+ or 'pycrypto'.
+ """
+ if not self._writeState.encContext:
+ return None
+ return self._writeState.encContext.implementation
+
+
+
+ #Emulate a socket, somewhat -
+ def send(self, s):
+ """Send data to the TLS connection (socket emulation).
+
+ @raise socket.error: If a socket error occurs.
+ """
+ self.write(s)
+ return len(s)
+
+ def sendall(self, s):
+ """Send data to the TLS connection (socket emulation).
+
+ @raise socket.error: If a socket error occurs.
+ """
+ self.write(s)
+
+ def recv(self, bufsize):
+ """Get some data from the TLS connection (socket emulation).
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ """
+ return self.read(bufsize)
+
+ def makefile(self, mode='r', bufsize=-1):
+ """Create a file object for the TLS connection (socket emulation).
+
+ @rtype: L{tlslite.FileObject.FileObject}
+ """
+ self._refCount += 1
+ return FileObject(self, mode, bufsize)
+
+ def getsockname(self):
+ """Return the socket's own address (socket emulation)."""
+ return self.sock.getsockname()
+
+ def getpeername(self):
+ """Return the remote address to which the socket is connected
+ (socket emulation)."""
+ return self.sock.getpeername()
+
+ def settimeout(self, value):
+ """Set a timeout on blocking socket operations (socket emulation)."""
+ return self.sock.settimeout(value)
+
+ def gettimeout(self):
+ """Return the timeout associated with socket operations (socket
+ emulation)."""
+ return self.sock.gettimeout()
+
+ def setsockopt(self, level, optname, value):
+ """Set the value of the given socket option (socket emulation)."""
+ return self.sock.setsockopt(level, optname, value)
+
+
+ #*********************************************************
+ # Public Functions END
+ #*********************************************************
+
+ def _shutdown(self, resumable):
+ self._writeState = _ConnectionState()
+ self._readState = _ConnectionState()
+ #Don't do this: self._readBuffer = ""
+ self.version = (0,0)
+ self._versionCheck = False
+ self.closed = True
+ if self.closeSocket:
+ self.sock.close()
+
+ #Even if resumable is False, we'll never toggle this on
+ if not resumable and self.session:
+ self.session.resumable = False
+
+
+ def _sendError(self, alertDescription, errorStr=None):
+ alert = Alert().create(alertDescription, AlertLevel.fatal)
+ for result in self._sendMsg(alert):
+ yield result
+ self._shutdown(False)
+ raise TLSLocalAlert(alert, errorStr)
+
+ def _sendMsgs(self, msgs):
+ skipEmptyFrag = False
+ for msg in msgs:
+ for result in self._sendMsg(msg, skipEmptyFrag):
+ yield result
+ skipEmptyFrag = True
+
+ def _sendMsg(self, msg, skipEmptyFrag=False):
+ bytes = msg.write()
+ contentType = msg.contentType
+
+ #Whenever we're connected and asked to send a message,
+ #we first send an empty Application Data message. This prevents
+ #an attacker from launching a chosen-plaintext attack based on
+ #knowing the next IV.
+ if not self.closed and not skipEmptyFrag and self.version == (3,1):
+ if self._writeState.encContext:
+ if self._writeState.encContext.isBlockCipher:
+ for result in self._sendMsg(ApplicationData(),
+ skipEmptyFrag=True):
+ yield result
+
+ #Update handshake hashes
+ if contentType == ContentType.handshake:
+ bytesStr = bytesToString(bytes)
+ self._handshake_md5.update(bytesStr)
+ self._handshake_sha.update(bytesStr)
+
+ #Calculate MAC
+ if self._writeState.macContext:
+ seqnumStr = self._writeState.getSeqNumStr()
+ bytesStr = bytesToString(bytes)
+ mac = self._writeState.macContext.copy()
+ mac.update(seqnumStr)
+ mac.update(chr(contentType))
+ if self.version == (3,0):
+ mac.update( chr( int(len(bytes)/256) ) )
+ mac.update( chr( int(len(bytes)%256) ) )
+ elif self.version in ((3,1), (3,2)):
+ mac.update(chr(self.version[0]))
+ mac.update(chr(self.version[1]))
+ mac.update( chr( int(len(bytes)/256) ) )
+ mac.update( chr( int(len(bytes)%256) ) )
+ else:
+ raise AssertionError()
+ mac.update(bytesStr)
+ macString = mac.digest()
+ macBytes = stringToBytes(macString)
+ if self.fault == Fault.badMAC:
+ macBytes[0] = (macBytes[0]+1) % 256
+
+ #Encrypt for Block or Stream Cipher
+ if self._writeState.encContext:
+ #Add padding and encrypt (for Block Cipher):
+ if self._writeState.encContext.isBlockCipher:
+
+ #Add TLS 1.1 fixed block
+ if self.version == (3,2):
+ bytes = self.fixedIVBlock + bytes
+
+ #Add padding: bytes = bytes + (macBytes + paddingBytes)
+ currentLength = len(bytes) + len(macBytes) + 1
+ blockLength = self._writeState.encContext.block_size
+ paddingLength = blockLength-(currentLength % blockLength)
+
+ paddingBytes = createByteArraySequence([paddingLength] * \
+ (paddingLength+1))
+ if self.fault == Fault.badPadding:
+ paddingBytes[0] = (paddingBytes[0]+1) % 256
+ endBytes = concatArrays(macBytes, paddingBytes)
+ bytes = concatArrays(bytes, endBytes)
+ #Encrypt
+ plaintext = stringToBytes(bytes)
+ ciphertext = self._writeState.encContext.encrypt(plaintext)
+ bytes = stringToBytes(ciphertext)
+
+ #Encrypt (for Stream Cipher)
+ else:
+ bytes = concatArrays(bytes, macBytes)
+ plaintext = bytesToString(bytes)
+ ciphertext = self._writeState.encContext.encrypt(plaintext)
+ bytes = stringToBytes(ciphertext)
+
+ #Add record header and send
+ r = RecordHeader3().create(self.version, contentType, len(bytes))
+ s = bytesToString(concatArrays(r.write(), bytes))
+ while 1:
+ try:
+ bytesSent = self.sock.send(s) #Might raise socket.error
+ except socket.error, why:
+ if why[0] == errno.EWOULDBLOCK:
+ yield 1
+ continue
+ else:
+ raise
+ if bytesSent == len(s):
+ return
+ s = s[bytesSent:]
+ yield 1
+
+
+ def _getMsg(self, expectedType, secondaryType=None, constructorType=None):
+ try:
+ if not isinstance(expectedType, tuple):
+ expectedType = (expectedType,)
+
+ #Spin in a loop, until we've got a non-empty record of a type we
+ #expect. The loop will be repeated if:
+ # - we receive a renegotiation attempt; we send no_renegotiation,
+ # then try again
+ # - we receive an empty application-data fragment; we try again
+ while 1:
+ for result in self._getNextRecord():
+ if result in (0,1):
+ yield result
+ recordHeader, p = result
+
+ #If this is an empty application-data fragment, try again
+ if recordHeader.type == ContentType.application_data:
+ if p.index == len(p.bytes):
+ continue
+
+ #If we received an unexpected record type...
+ if recordHeader.type not in expectedType:
+
+ #If we received an alert...
+ if recordHeader.type == ContentType.alert:
+ alert = Alert().parse(p)
+
+ #We either received a fatal error, a warning, or a
+ #close_notify. In any case, we're going to close the
+ #connection. In the latter two cases we respond with
+ #a close_notify, but ignore any socket errors, since
+ #the other side might have already closed the socket.
+ if alert.level == AlertLevel.warning or \
+ alert.description == AlertDescription.close_notify:
+
+ #If the sendMsg() call fails because the socket has
+ #already been closed, we will be forgiving and not
+ #report the error nor invalidate the "resumability"
+ #of the session.
+ try:
+ alertMsg = Alert()
+ alertMsg.create(AlertDescription.close_notify,
+ AlertLevel.warning)
+ for result in self._sendMsg(alertMsg):
+ yield result
+ except socket.error:
+ pass
+
+ if alert.description == \
+ AlertDescription.close_notify:
+ self._shutdown(True)
+ elif alert.level == AlertLevel.warning:
+ self._shutdown(False)
+
+ else: #Fatal alert:
+ self._shutdown(False)
+
+ #Raise the alert as an exception
+ raise TLSRemoteAlert(alert)
+
+ #If we received a renegotiation attempt...
+ if recordHeader.type == ContentType.handshake:
+ subType = p.get(1)
+ reneg = False
+ if self._client:
+ if subType == HandshakeType.hello_request:
+ reneg = True
+ else:
+ if subType == HandshakeType.client_hello:
+ reneg = True
+ #Send no_renegotiation, then try again
+ if reneg:
+ alertMsg = Alert()
+ alertMsg.create(AlertDescription.no_renegotiation,
+ AlertLevel.warning)
+ for result in self._sendMsg(alertMsg):
+ yield result
+ continue
+
+ #Otherwise: this is an unexpected record, but neither an
+ #alert nor renegotiation
+ for result in self._sendError(\
+ AlertDescription.unexpected_message,
+ "received type=%d" % recordHeader.type):
+ yield result
+
+ break
+
+ #Parse based on content_type
+ if recordHeader.type == ContentType.change_cipher_spec:
+ yield ChangeCipherSpec().parse(p)
+ elif recordHeader.type == ContentType.alert:
+ yield Alert().parse(p)
+ elif recordHeader.type == ContentType.application_data:
+ yield ApplicationData().parse(p)
+ elif recordHeader.type == ContentType.handshake:
+ #Convert secondaryType to tuple, if it isn't already
+ if not isinstance(secondaryType, tuple):
+ secondaryType = (secondaryType,)
+
+ #If it's a handshake message, check handshake header
+ if recordHeader.ssl2:
+ subType = p.get(1)
+ if subType != HandshakeType.client_hello:
+ for result in self._sendError(\
+ AlertDescription.unexpected_message,
+ "Can only handle SSLv2 ClientHello messages"):
+ yield result
+ if HandshakeType.client_hello not in secondaryType:
+ for result in self._sendError(\
+ AlertDescription.unexpected_message):
+ yield result
+ subType = HandshakeType.client_hello
+ else:
+ subType = p.get(1)
+ if subType not in secondaryType:
+ for result in self._sendError(\
+ AlertDescription.unexpected_message,
+ "Expecting %s, got %s" % (str(secondaryType), subType)):
+ yield result
+
+ #Update handshake hashes
+ sToHash = bytesToString(p.bytes)
+ self._handshake_md5.update(sToHash)
+ self._handshake_sha.update(sToHash)
+
+ #Parse based on handshake type
+ if subType == HandshakeType.client_hello:
+ yield ClientHello(recordHeader.ssl2).parse(p)
+ elif subType == HandshakeType.server_hello:
+ yield ServerHello().parse(p)
+ elif subType == HandshakeType.certificate:
+ yield Certificate(constructorType).parse(p)
+ elif subType == HandshakeType.certificate_request:
+ yield CertificateRequest().parse(p)
+ elif subType == HandshakeType.certificate_verify:
+ yield CertificateVerify().parse(p)
+ elif subType == HandshakeType.server_key_exchange:
+ yield ServerKeyExchange(constructorType).parse(p)
+ elif subType == HandshakeType.server_hello_done:
+ yield ServerHelloDone().parse(p)
+ elif subType == HandshakeType.client_key_exchange:
+ yield ClientKeyExchange(constructorType, \
+ self.version).parse(p)
+ elif subType == HandshakeType.finished:
+ yield Finished(self.version).parse(p)
+ else:
+ raise AssertionError()
+
+ #If an exception was raised by a Parser or Message instance:
+ except SyntaxError, e:
+ for result in self._sendError(AlertDescription.decode_error,
+ formatExceptionTrace(e)):
+ yield result
+
+
+ #Returns next record or next handshake message
+ def _getNextRecord(self):
+
+ #If there's a handshake message waiting, return it
+ if self._handshakeBuffer:
+ recordHeader, bytes = self._handshakeBuffer[0]
+ self._handshakeBuffer = self._handshakeBuffer[1:]
+ yield (recordHeader, Parser(bytes))
+ return
+
+ #Otherwise...
+ #Read the next record header
+ bytes = createByteArraySequence([])
+ recordHeaderLength = 1
+ ssl2 = False
+ while 1:
+ try:
+ s = self.sock.recv(recordHeaderLength-len(bytes))
+ except socket.error, why:
+ if why[0] == errno.EWOULDBLOCK:
+ yield 0
+ continue
+ else:
+ raise
+
+ #If the connection was abruptly closed, raise an error
+ if len(s)==0:
+ raise TLSAbruptCloseError()
+
+ bytes += stringToBytes(s)
+ if len(bytes)==1:
+ if bytes[0] in ContentType.all:
+ ssl2 = False
+ recordHeaderLength = 5
+ elif bytes[0] == 128:
+ ssl2 = True
+ recordHeaderLength = 2
+ else:
+ raise SyntaxError()
+ if len(bytes) == recordHeaderLength:
+ break
+
+ #Parse the record header
+ if ssl2:
+ r = RecordHeader2().parse(Parser(bytes))
+ else:
+ r = RecordHeader3().parse(Parser(bytes))
+
+ #Check the record header fields
+ if r.length > 18432:
+ for result in self._sendError(AlertDescription.record_overflow):
+ yield result
+
+ #Read the record contents
+ bytes = createByteArraySequence([])
+ while 1:
+ try:
+ s = self.sock.recv(r.length - len(bytes))
+ except socket.error, why:
+ if why[0] == errno.EWOULDBLOCK:
+ yield 0
+ continue
+ else:
+ raise
+
+ #If the connection is closed, raise a socket error
+ if len(s)==0:
+ raise TLSAbruptCloseError()
+
+ bytes += stringToBytes(s)
+ if len(bytes) == r.length:
+ break
+
+ #Check the record header fields (2)
+ #We do this after reading the contents from the socket, so that
+ #if there's an error, we at least don't leave extra bytes in the
+ #socket..
+ #
+ # THIS CHECK HAS NO SECURITY RELEVANCE (?), BUT COULD HURT INTEROP.
+ # SO WE LEAVE IT OUT FOR NOW.
+ #
+ #if self._versionCheck and r.version != self.version:
+ # for result in self._sendError(AlertDescription.protocol_version,
+ # "Version in header field: %s, should be %s" % (str(r.version),
+ # str(self.version))):
+ # yield result
+
+ #Decrypt the record
+ for result in self._decryptRecord(r.type, bytes):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ bytes = result
+ p = Parser(bytes)
+
+ #If it doesn't contain handshake messages, we can just return it
+ if r.type != ContentType.handshake:
+ yield (r, p)
+ #If it's an SSLv2 ClientHello, we can return it as well
+ elif r.ssl2:
+ yield (r, p)
+ else:
+ #Otherwise, we loop through and add the handshake messages to the
+ #handshake buffer
+ while 1:
+ if p.index == len(bytes): #If we're at the end
+ if not self._handshakeBuffer:
+ for result in self._sendError(\
+ AlertDescription.decode_error, \
+ "Received empty handshake record"):
+ yield result
+ break
+ #There needs to be at least 4 bytes to get a header
+ if p.index+4 > len(bytes):
+ for result in self._sendError(\
+ AlertDescription.decode_error,
+ "A record has a partial handshake message (1)"):
+ yield result
+ p.get(1) # skip handshake type
+ msgLength = p.get(3)
+ if p.index+msgLength > len(bytes):
+ for result in self._sendError(\
+ AlertDescription.decode_error,
+ "A record has a partial handshake message (2)"):
+ yield result
+
+ handshakePair = (r, bytes[p.index-4 : p.index+msgLength])
+ self._handshakeBuffer.append(handshakePair)
+ p.index += msgLength
+
+ #We've moved at least one handshake message into the
+ #handshakeBuffer, return the first one
+ recordHeader, bytes = self._handshakeBuffer[0]
+ self._handshakeBuffer = self._handshakeBuffer[1:]
+ yield (recordHeader, Parser(bytes))
+
+
+ def _decryptRecord(self, recordType, bytes):
+ if self._readState.encContext:
+
+ #Decrypt if it's a block cipher
+ if self._readState.encContext.isBlockCipher:
+ blockLength = self._readState.encContext.block_size
+ if len(bytes) % blockLength != 0:
+ for result in self._sendError(\
+ AlertDescription.decryption_failed,
+ "Encrypted data not a multiple of blocksize"):
+ yield result
+ ciphertext = bytesToString(bytes)
+ plaintext = self._readState.encContext.decrypt(ciphertext)
+ if self.version == (3,2): #For TLS 1.1, remove explicit IV
+ plaintext = plaintext[self._readState.encContext.block_size : ]
+ bytes = stringToBytes(plaintext)
+
+ #Check padding
+ paddingGood = True
+ paddingLength = bytes[-1]
+ if (paddingLength+1) > len(bytes):
+ paddingGood=False
+ totalPaddingLength = 0
+ else:
+ if self.version == (3,0):
+ totalPaddingLength = paddingLength+1
+ elif self.version in ((3,1), (3,2)):
+ totalPaddingLength = paddingLength+1
+ paddingBytes = bytes[-totalPaddingLength:-1]
+ for byte in paddingBytes:
+ if byte != paddingLength:
+ paddingGood = False
+ totalPaddingLength = 0
+ else:
+ raise AssertionError()
+
+ #Decrypt if it's a stream cipher
+ else:
+ paddingGood = True
+ ciphertext = bytesToString(bytes)
+ plaintext = self._readState.encContext.decrypt(ciphertext)
+ bytes = stringToBytes(plaintext)
+ totalPaddingLength = 0
+
+ #Check MAC
+ macGood = True
+ macLength = self._readState.macContext.digest_size
+ endLength = macLength + totalPaddingLength
+ if endLength > len(bytes):
+ macGood = False
+ else:
+ #Read MAC
+ startIndex = len(bytes) - endLength
+ endIndex = startIndex + macLength
+ checkBytes = bytes[startIndex : endIndex]
+
+ #Calculate MAC
+ seqnumStr = self._readState.getSeqNumStr()
+ bytes = bytes[:-endLength]
+ bytesStr = bytesToString(bytes)
+ mac = self._readState.macContext.copy()
+ mac.update(seqnumStr)
+ mac.update(chr(recordType))
+ if self.version == (3,0):
+ mac.update( chr( int(len(bytes)/256) ) )
+ mac.update( chr( int(len(bytes)%256) ) )
+ elif self.version in ((3,1), (3,2)):
+ mac.update(chr(self.version[0]))
+ mac.update(chr(self.version[1]))
+ mac.update( chr( int(len(bytes)/256) ) )
+ mac.update( chr( int(len(bytes)%256) ) )
+ else:
+ raise AssertionError()
+ mac.update(bytesStr)
+ macString = mac.digest()
+ macBytes = stringToBytes(macString)
+
+ #Compare MACs
+ if macBytes != checkBytes:
+ macGood = False
+
+ if not (paddingGood and macGood):
+ for result in self._sendError(AlertDescription.bad_record_mac,
+ "MAC failure (or padding failure)"):
+ yield result
+
+ yield bytes
+
+ def _handshakeStart(self, client):
+ self._client = client
+ self._handshake_md5 = md5.md5()
+ self._handshake_sha = sha.sha()
+ self._handshakeBuffer = []
+ self.allegedSharedKeyUsername = None
+ self.allegedSrpUsername = None
+ self._refCount = 1
+
+ def _handshakeDone(self, resumed):
+ self.resumed = resumed
+ self.closed = False
+
+ def _calcPendingStates(self, clientRandom, serverRandom, implementations):
+ if self.session.cipherSuite in CipherSuite.aes128Suites:
+ macLength = 20
+ keyLength = 16
+ ivLength = 16
+ createCipherFunc = createAES
+ elif self.session.cipherSuite in CipherSuite.aes256Suites:
+ macLength = 20
+ keyLength = 32
+ ivLength = 16
+ createCipherFunc = createAES
+ elif self.session.cipherSuite in CipherSuite.rc4Suites:
+ macLength = 20
+ keyLength = 16
+ ivLength = 0
+ createCipherFunc = createRC4
+ elif self.session.cipherSuite in CipherSuite.tripleDESSuites:
+ macLength = 20
+ keyLength = 24
+ ivLength = 8
+ createCipherFunc = createTripleDES
+ else:
+ raise AssertionError()
+
+ if self.version == (3,0):
+ createMACFunc = MAC_SSL
+ elif self.version in ((3,1), (3,2)):
+ createMACFunc = hmac.HMAC
+
+ outputLength = (macLength*2) + (keyLength*2) + (ivLength*2)
+
+ #Calculate Keying Material from Master Secret
+ if self.version == (3,0):
+ keyBlock = PRF_SSL(self.session.masterSecret,
+ concatArrays(serverRandom, clientRandom),
+ outputLength)
+ elif self.version in ((3,1), (3,2)):
+ keyBlock = PRF(self.session.masterSecret,
+ "key expansion",
+ concatArrays(serverRandom,clientRandom),
+ outputLength)
+ else:
+ raise AssertionError()
+
+ #Slice up Keying Material
+ clientPendingState = _ConnectionState()
+ serverPendingState = _ConnectionState()
+ p = Parser(keyBlock)
+ clientMACBlock = bytesToString(p.getFixBytes(macLength))
+ serverMACBlock = bytesToString(p.getFixBytes(macLength))
+ clientKeyBlock = bytesToString(p.getFixBytes(keyLength))
+ serverKeyBlock = bytesToString(p.getFixBytes(keyLength))
+ clientIVBlock = bytesToString(p.getFixBytes(ivLength))
+ serverIVBlock = bytesToString(p.getFixBytes(ivLength))
+ clientPendingState.macContext = createMACFunc(clientMACBlock,
+ digestmod=sha)
+ serverPendingState.macContext = createMACFunc(serverMACBlock,
+ digestmod=sha)
+ clientPendingState.encContext = createCipherFunc(clientKeyBlock,
+ clientIVBlock,
+ implementations)
+ serverPendingState.encContext = createCipherFunc(serverKeyBlock,
+ serverIVBlock,
+ implementations)
+
+ #Assign new connection states to pending states
+ if self._client:
+ self._pendingWriteState = clientPendingState
+ self._pendingReadState = serverPendingState
+ else:
+ self._pendingWriteState = serverPendingState
+ self._pendingReadState = clientPendingState
+
+ if self.version == (3,2) and ivLength:
+ #Choose fixedIVBlock for TLS 1.1 (this is encrypted with the CBC
+ #residue to create the IV for each sent block)
+ self.fixedIVBlock = getRandomBytes(ivLength)
+
+ def _changeWriteState(self):
+ self._writeState = self._pendingWriteState
+ self._pendingWriteState = _ConnectionState()
+
+ def _changeReadState(self):
+ self._readState = self._pendingReadState
+ self._pendingReadState = _ConnectionState()
+
+ def _sendFinished(self):
+ #Send ChangeCipherSpec
+ for result in self._sendMsg(ChangeCipherSpec()):
+ yield result
+
+ #Switch to pending write state
+ self._changeWriteState()
+
+ #Calculate verification data
+ verifyData = self._calcFinished(True)
+ if self.fault == Fault.badFinished:
+ verifyData[0] = (verifyData[0]+1)%256
+
+ #Send Finished message under new state
+ finished = Finished(self.version).create(verifyData)
+ for result in self._sendMsg(finished):
+ yield result
+
+ def _getFinished(self):
+ #Get and check ChangeCipherSpec
+ for result in self._getMsg(ContentType.change_cipher_spec):
+ if result in (0,1):
+ yield result
+ changeCipherSpec = result
+
+ if changeCipherSpec.type != 1:
+ for result in self._sendError(AlertDescription.illegal_parameter,
+ "ChangeCipherSpec type incorrect"):
+ yield result
+
+ #Switch to pending read state
+ self._changeReadState()
+
+ #Calculate verification data
+ verifyData = self._calcFinished(False)
+
+ #Get and check Finished message under new state
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.finished):
+ if result in (0,1):
+ yield result
+ finished = result
+ if finished.verify_data != verifyData:
+ for result in self._sendError(AlertDescription.decrypt_error,
+ "Finished message is incorrect"):
+ yield result
+
+ def _calcFinished(self, send=True):
+ if self.version == (3,0):
+ if (self._client and send) or (not self._client and not send):
+ senderStr = "\x43\x4C\x4E\x54"
+ else:
+ senderStr = "\x53\x52\x56\x52"
+
+ verifyData = self._calcSSLHandshakeHash(self.session.masterSecret,
+ senderStr)
+ return verifyData
+
+ elif self.version in ((3,1), (3,2)):
+ if (self._client and send) or (not self._client and not send):
+ label = "client finished"
+ else:
+ label = "server finished"
+
+ handshakeHashes = stringToBytes(self._handshake_md5.digest() + \
+ self._handshake_sha.digest())
+ verifyData = PRF(self.session.masterSecret, label, handshakeHashes,
+ 12)
+ return verifyData
+ else:
+ raise AssertionError()
+
+ #Used for Finished messages and CertificateVerify messages in SSL v3
+ def _calcSSLHandshakeHash(self, masterSecret, label):
+ masterSecretStr = bytesToString(masterSecret)
+
+ imac_md5 = self._handshake_md5.copy()
+ imac_sha = self._handshake_sha.copy()
+
+ imac_md5.update(label + masterSecretStr + '\x36'*48)
+ imac_sha.update(label + masterSecretStr + '\x36'*40)
+
+ md5Str = md5.md5(masterSecretStr + ('\x5c'*48) + \
+ imac_md5.digest()).digest()
+ shaStr = sha.sha(masterSecretStr + ('\x5c'*40) + \
+ imac_sha.digest()).digest()
+
+ return stringToBytes(md5Str + shaStr)
+
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/VerifierDB.py b/samples/apps/marketplace_sample/gdata/tlslite/VerifierDB.py
new file mode 100755
index 0000000..f706b17
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/VerifierDB.py
@@ -0,0 +1,90 @@
+"""Class for storing SRP password verifiers."""
+
+from utils.cryptomath import *
+from utils.compat import *
+import mathtls
+from BaseDB import BaseDB
+
+class VerifierDB(BaseDB):
+ """This class represent an in-memory or on-disk database of SRP
+ password verifiers.
+
+ A VerifierDB can be passed to a server handshake to authenticate
+ a client based on one of the verifiers.
+
+ This class is thread-safe.
+ """
+ def __init__(self, filename=None):
+ """Create a new VerifierDB instance.
+
+ @type filename: str
+ @param filename: Filename for an on-disk database, or None for
+ an in-memory database. If the filename already exists, follow
+ this with a call to open(). To create a new on-disk database,
+ follow this with a call to create().
+ """
+ BaseDB.__init__(self, filename, "verifier")
+
+ def _getItem(self, username, valueStr):
+ (N, g, salt, verifier) = valueStr.split(" ")
+ N = base64ToNumber(N)
+ g = base64ToNumber(g)
+ salt = base64ToString(salt)
+ verifier = base64ToNumber(verifier)
+ return (N, g, salt, verifier)
+
+ def __setitem__(self, username, verifierEntry):
+ """Add a verifier entry to the database.
+
+ @type username: str
+ @param username: The username to associate the verifier with.
+ Must be less than 256 characters in length. Must not already
+ be in the database.
+
+ @type verifierEntry: tuple
+ @param verifierEntry: The verifier entry to add. Use
+ L{tlslite.VerifierDB.VerifierDB.makeVerifier} to create a
+ verifier entry.
+ """
+ BaseDB.__setitem__(self, username, verifierEntry)
+
+
+ def _setItem(self, username, value):
+ if len(username)>=256:
+ raise ValueError("username too long")
+ N, g, salt, verifier = value
+ N = numberToBase64(N)
+ g = numberToBase64(g)
+ salt = stringToBase64(salt)
+ verifier = numberToBase64(verifier)
+ valueStr = " ".join( (N, g, salt, verifier) )
+ return valueStr
+
+ def _checkItem(self, value, username, param):
+ (N, g, salt, verifier) = value
+ x = mathtls.makeX(salt, username, param)
+ v = powMod(g, x, N)
+ return (verifier == v)
+
+
+ def makeVerifier(username, password, bits):
+ """Create a verifier entry which can be stored in a VerifierDB.
+
+ @type username: str
+ @param username: The username for this verifier. Must be less
+ than 256 characters in length.
+
+ @type password: str
+ @param password: The password for this verifier.
+
+ @type bits: int
+ @param bits: This values specifies which SRP group parameters
+ to use. It must be one of (1024, 1536, 2048, 3072, 4096, 6144,
+ 8192). Larger values are more secure but slower. 2048 is a
+ good compromise between safety and speed.
+
+ @rtype: tuple
+ @return: A tuple which may be stored in a VerifierDB.
+ """
+ return mathtls.makeVerifier(username, password, bits)
+ makeVerifier = staticmethod(makeVerifier)
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/X509.py b/samples/apps/marketplace_sample/gdata/tlslite/X509.py
new file mode 100755
index 0000000..a47ddcf
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/X509.py
@@ -0,0 +1,133 @@
+"""Class representing an X.509 certificate."""
+
+from utils.ASN1Parser import ASN1Parser
+from utils.cryptomath import *
+from utils.keyfactory import _createPublicRSAKey
+
+
+class X509:
+ """This class represents an X.509 certificate.
+
+ @type bytes: L{array.array} of unsigned bytes
+ @ivar bytes: The DER-encoded ASN.1 certificate
+
+ @type publicKey: L{tlslite.utils.RSAKey.RSAKey}
+ @ivar publicKey: The subject public key from the certificate.
+ """
+
+ def __init__(self):
+ self.bytes = createByteArraySequence([])
+ self.publicKey = None
+
+ def parse(self, s):
+ """Parse a PEM-encoded X.509 certificate.
+
+ @type s: str
+ @param s: A PEM-encoded X.509 certificate (i.e. a base64-encoded
+ certificate wrapped with "-----BEGIN CERTIFICATE-----" and
+ "-----END CERTIFICATE-----" tags).
+ """
+
+ start = s.find("-----BEGIN CERTIFICATE-----")
+ end = s.find("-----END CERTIFICATE-----")
+ if start == -1:
+ raise SyntaxError("Missing PEM prefix")
+ if end == -1:
+ raise SyntaxError("Missing PEM postfix")
+ s = s[start+len("-----BEGIN CERTIFICATE-----") : end]
+
+ bytes = base64ToBytes(s)
+ self.parseBinary(bytes)
+ return self
+
+ def parseBinary(self, bytes):
+ """Parse a DER-encoded X.509 certificate.
+
+ @type bytes: str or L{array.array} of unsigned bytes
+ @param bytes: A DER-encoded X.509 certificate.
+ """
+
+ if isinstance(bytes, type("")):
+ bytes = stringToBytes(bytes)
+
+ self.bytes = bytes
+ p = ASN1Parser(bytes)
+
+ #Get the tbsCertificate
+ tbsCertificateP = p.getChild(0)
+
+ #Is the optional version field present?
+ #This determines which index the key is at.
+ if tbsCertificateP.value[0]==0xA0:
+ subjectPublicKeyInfoIndex = 6
+ else:
+ subjectPublicKeyInfoIndex = 5
+
+ #Get the subjectPublicKeyInfo
+ subjectPublicKeyInfoP = tbsCertificateP.getChild(\
+ subjectPublicKeyInfoIndex)
+
+ #Get the algorithm
+ algorithmP = subjectPublicKeyInfoP.getChild(0)
+ rsaOID = algorithmP.value
+ if list(rsaOID) != [6, 9, 42, 134, 72, 134, 247, 13, 1, 1, 1, 5, 0]:
+ raise SyntaxError("Unrecognized AlgorithmIdentifier")
+
+ #Get the subjectPublicKey
+ subjectPublicKeyP = subjectPublicKeyInfoP.getChild(1)
+
+ #Adjust for BIT STRING encapsulation
+ if (subjectPublicKeyP.value[0] !=0):
+ raise SyntaxError()
+ subjectPublicKeyP = ASN1Parser(subjectPublicKeyP.value[1:])
+
+ #Get the modulus and exponent
+ modulusP = subjectPublicKeyP.getChild(0)
+ publicExponentP = subjectPublicKeyP.getChild(1)
+
+ #Decode them into numbers
+ n = bytesToNumber(modulusP.value)
+ e = bytesToNumber(publicExponentP.value)
+
+ #Create a public key instance
+ self.publicKey = _createPublicRSAKey(n, e)
+
+ def getFingerprint(self):
+ """Get the hex-encoded fingerprint of this certificate.
+
+ @rtype: str
+ @return: A hex-encoded fingerprint.
+ """
+ return sha.sha(self.bytes).hexdigest()
+
+ def getCommonName(self):
+ """Get the Subject's Common Name from the certificate.
+
+ The cryptlib_py module must be installed in order to use this
+ function.
+
+ @rtype: str or None
+ @return: The CN component of the certificate's subject DN, if
+ present.
+ """
+ import cryptlib_py
+ import array
+ c = cryptlib_py.cryptImportCert(self.bytes, cryptlib_py.CRYPT_UNUSED)
+ name = cryptlib_py.CRYPT_CERTINFO_COMMONNAME
+ try:
+ try:
+ length = cryptlib_py.cryptGetAttributeString(c, name, None)
+ returnVal = array.array('B', [0] * length)
+ cryptlib_py.cryptGetAttributeString(c, name, returnVal)
+ returnVal = returnVal.tostring()
+ except cryptlib_py.CryptException, e:
+ if e[0] == cryptlib_py.CRYPT_ERROR_NOTFOUND:
+ returnVal = None
+ return returnVal
+ finally:
+ cryptlib_py.cryptDestroyCert(c)
+
+ def writeBytes(self):
+ return self.bytes
+
+
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/X509CertChain.py b/samples/apps/marketplace_sample/gdata/tlslite/X509CertChain.py
new file mode 100755
index 0000000..d5f0b4d
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/X509CertChain.py
@@ -0,0 +1,181 @@
+"""Class representing an X.509 certificate chain."""
+
+from utils import cryptomath
+
+class X509CertChain:
+ """This class represents a chain of X.509 certificates.
+
+ @type x509List: list
+ @ivar x509List: A list of L{tlslite.X509.X509} instances,
+ starting with the end-entity certificate and with every
+ subsequent certificate certifying the previous.
+ """
+
+ def __init__(self, x509List=None):
+ """Create a new X509CertChain.
+
+ @type x509List: list
+ @param x509List: A list of L{tlslite.X509.X509} instances,
+ starting with the end-entity certificate and with every
+ subsequent certificate certifying the previous.
+ """
+ if x509List:
+ self.x509List = x509List
+ else:
+ self.x509List = []
+
+ def getNumCerts(self):
+ """Get the number of certificates in this chain.
+
+ @rtype: int
+ """
+ return len(self.x509List)
+
+ def getEndEntityPublicKey(self):
+ """Get the public key from the end-entity certificate.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ """
+ if self.getNumCerts() == 0:
+ raise AssertionError()
+ return self.x509List[0].publicKey
+
+ def getFingerprint(self):
+ """Get the hex-encoded fingerprint of the end-entity certificate.
+
+ @rtype: str
+ @return: A hex-encoded fingerprint.
+ """
+ if self.getNumCerts() == 0:
+ raise AssertionError()
+ return self.x509List[0].getFingerprint()
+
+ def getCommonName(self):
+ """Get the Subject's Common Name from the end-entity certificate.
+
+ The cryptlib_py module must be installed in order to use this
+ function.
+
+ @rtype: str or None
+ @return: The CN component of the certificate's subject DN, if
+ present.
+ """
+ if self.getNumCerts() == 0:
+ raise AssertionError()
+ return self.x509List[0].getCommonName()
+
+ def validate(self, x509TrustList):
+ """Check the validity of the certificate chain.
+
+ This checks that every certificate in the chain validates with
+ the subsequent one, until some certificate validates with (or
+ is identical to) one of the passed-in root certificates.
+
+ The cryptlib_py module must be installed in order to use this
+ function.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ certificate chain must extend to one of these certificates to
+ be considered valid.
+ """
+
+ import cryptlib_py
+ c1 = None
+ c2 = None
+ lastC = None
+ rootC = None
+
+ try:
+ rootFingerprints = [c.getFingerprint() for c in x509TrustList]
+
+ #Check that every certificate in the chain validates with the
+ #next one
+ for cert1, cert2 in zip(self.x509List, self.x509List[1:]):
+
+ #If we come upon a root certificate, we're done.
+ if cert1.getFingerprint() in rootFingerprints:
+ return True
+
+ c1 = cryptlib_py.cryptImportCert(cert1.writeBytes(),
+ cryptlib_py.CRYPT_UNUSED)
+ c2 = cryptlib_py.cryptImportCert(cert2.writeBytes(),
+ cryptlib_py.CRYPT_UNUSED)
+ try:
+ cryptlib_py.cryptCheckCert(c1, c2)
+ except:
+ return False
+ cryptlib_py.cryptDestroyCert(c1)
+ c1 = None
+ cryptlib_py.cryptDestroyCert(c2)
+ c2 = None
+
+ #If the last certificate is one of the root certificates, we're
+ #done.
+ if self.x509List[-1].getFingerprint() in rootFingerprints:
+ return True
+
+ #Otherwise, find a root certificate that the last certificate
+ #chains to, and validate them.
+ lastC = cryptlib_py.cryptImportCert(self.x509List[-1].writeBytes(),
+ cryptlib_py.CRYPT_UNUSED)
+ for rootCert in x509TrustList:
+ rootC = cryptlib_py.cryptImportCert(rootCert.writeBytes(),
+ cryptlib_py.CRYPT_UNUSED)
+ if self._checkChaining(lastC, rootC):
+ try:
+ cryptlib_py.cryptCheckCert(lastC, rootC)
+ return True
+ except:
+ return False
+ return False
+ finally:
+ if not (c1 is None):
+ cryptlib_py.cryptDestroyCert(c1)
+ if not (c2 is None):
+ cryptlib_py.cryptDestroyCert(c2)
+ if not (lastC is None):
+ cryptlib_py.cryptDestroyCert(lastC)
+ if not (rootC is None):
+ cryptlib_py.cryptDestroyCert(rootC)
+
+
+
+ def _checkChaining(self, lastC, rootC):
+ import cryptlib_py
+ import array
+ def compareNames(name):
+ try:
+ length = cryptlib_py.cryptGetAttributeString(lastC, name, None)
+ lastName = array.array('B', [0] * length)
+ cryptlib_py.cryptGetAttributeString(lastC, name, lastName)
+ lastName = lastName.tostring()
+ except cryptlib_py.CryptException, e:
+ if e[0] == cryptlib_py.CRYPT_ERROR_NOTFOUND:
+ lastName = None
+ try:
+ length = cryptlib_py.cryptGetAttributeString(rootC, name, None)
+ rootName = array.array('B', [0] * length)
+ cryptlib_py.cryptGetAttributeString(rootC, name, rootName)
+ rootName = rootName.tostring()
+ except cryptlib_py.CryptException, e:
+ if e[0] == cryptlib_py.CRYPT_ERROR_NOTFOUND:
+ rootName = None
+
+ return lastName == rootName
+
+ cryptlib_py.cryptSetAttribute(lastC,
+ cryptlib_py.CRYPT_CERTINFO_ISSUERNAME,
+ cryptlib_py.CRYPT_UNUSED)
+
+ if not compareNames(cryptlib_py.CRYPT_CERTINFO_COUNTRYNAME):
+ return False
+ if not compareNames(cryptlib_py.CRYPT_CERTINFO_LOCALITYNAME):
+ return False
+ if not compareNames(cryptlib_py.CRYPT_CERTINFO_ORGANIZATIONNAME):
+ return False
+ if not compareNames(cryptlib_py.CRYPT_CERTINFO_ORGANIZATIONALUNITNAME):
+ return False
+ if not compareNames(cryptlib_py.CRYPT_CERTINFO_COMMONNAME):
+ return False
+ return True
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/__init__.py b/samples/apps/marketplace_sample/gdata/tlslite/__init__.py
new file mode 100755
index 0000000..47cfd1c
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/__init__.py
@@ -0,0 +1,39 @@
+"""
+TLS Lite is a free python library that implements SSL v3, TLS v1, and
+TLS v1.1. TLS Lite supports non-traditional authentication methods
+such as SRP, shared keys, and cryptoIDs, in addition to X.509
+certificates. TLS Lite is pure python, however it can access OpenSSL,
+cryptlib, pycrypto, and GMPY for faster crypto operations. TLS Lite
+integrates with httplib, xmlrpclib, poplib, imaplib, smtplib,
+SocketServer, asyncore, and Twisted.
+
+To use, do::
+
+ from tlslite.api import *
+
+Then use the L{tlslite.TLSConnection.TLSConnection} class with a socket,
+or use one of the integration classes in L{tlslite.integration}.
+
+@version: 0.3.8
+"""
+__version__ = "0.3.8"
+
+__all__ = ["api",
+ "BaseDB",
+ "Checker",
+ "constants",
+ "errors",
+ "FileObject",
+ "HandshakeSettings",
+ "mathtls",
+ "messages",
+ "Session",
+ "SessionCache",
+ "SharedKeyDB",
+ "TLSConnection",
+ "TLSRecordLayer",
+ "VerifierDB",
+ "X509",
+ "X509CertChain",
+ "integration",
+ "utils"]
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/api.py b/samples/apps/marketplace_sample/gdata/tlslite/api.py
new file mode 100755
index 0000000..eebfbc6
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/api.py
@@ -0,0 +1,75 @@
+"""Import this module for easy access to TLS Lite objects.
+
+The TLS Lite API consists of classes, functions, and variables spread
+throughout this package. Instead of importing them individually with::
+
+ from tlslite.TLSConnection import TLSConnection
+ from tlslite.HandshakeSettings import HandshakeSettings
+ from tlslite.errors import *
+ .
+ .
+
+It's easier to do::
+
+ from tlslite.api import *
+
+This imports all the important objects (TLSConnection, Checker,
+HandshakeSettings, etc.) into the global namespace. In particular, it
+imports::
+
+ from constants import AlertLevel, AlertDescription, Fault
+ from errors import *
+ from Checker import Checker
+ from HandshakeSettings import HandshakeSettings
+ from Session import Session
+ from SessionCache import SessionCache
+ from SharedKeyDB import SharedKeyDB
+ from TLSConnection import TLSConnection
+ from VerifierDB import VerifierDB
+ from X509 import X509
+ from X509CertChain import X509CertChain
+
+ from integration.HTTPTLSConnection import HTTPTLSConnection
+ from integration.POP3_TLS import POP3_TLS
+ from integration.IMAP4_TLS import IMAP4_TLS
+ from integration.SMTP_TLS import SMTP_TLS
+ from integration.XMLRPCTransport import XMLRPCTransport
+ from integration.TLSSocketServerMixIn import TLSSocketServerMixIn
+ from integration.TLSAsyncDispatcherMixIn import TLSAsyncDispatcherMixIn
+ from integration.TLSTwistedProtocolWrapper import TLSTwistedProtocolWrapper
+ from utils.cryptomath import cryptlibpyLoaded, m2cryptoLoaded,
+ gmpyLoaded, pycryptoLoaded, prngName
+ from utils.keyfactory import generateRSAKey, parsePEMKey, parseXMLKey,
+ parseAsPublicKey, parsePrivateKey
+"""
+
+from constants import AlertLevel, AlertDescription, Fault
+from errors import *
+from Checker import Checker
+from HandshakeSettings import HandshakeSettings
+from Session import Session
+from SessionCache import SessionCache
+from SharedKeyDB import SharedKeyDB
+from TLSConnection import TLSConnection
+from VerifierDB import VerifierDB
+from X509 import X509
+from X509CertChain import X509CertChain
+
+from integration.HTTPTLSConnection import HTTPTLSConnection
+from integration.TLSSocketServerMixIn import TLSSocketServerMixIn
+from integration.TLSAsyncDispatcherMixIn import TLSAsyncDispatcherMixIn
+from integration.POP3_TLS import POP3_TLS
+from integration.IMAP4_TLS import IMAP4_TLS
+from integration.SMTP_TLS import SMTP_TLS
+from integration.XMLRPCTransport import XMLRPCTransport
+try:
+ import twisted
+ del(twisted)
+ from integration.TLSTwistedProtocolWrapper import TLSTwistedProtocolWrapper
+except ImportError:
+ pass
+
+from utils.cryptomath import cryptlibpyLoaded, m2cryptoLoaded, gmpyLoaded, \
+ pycryptoLoaded, prngName
+from utils.keyfactory import generateRSAKey, parsePEMKey, parseXMLKey, \
+ parseAsPublicKey, parsePrivateKey
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/constants.py b/samples/apps/marketplace_sample/gdata/tlslite/constants.py
new file mode 100755
index 0000000..8f2d559
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/constants.py
@@ -0,0 +1,225 @@
+"""Constants used in various places."""
+
+class CertificateType:
+ x509 = 0
+ openpgp = 1
+ cryptoID = 2
+
+class HandshakeType:
+ hello_request = 0
+ client_hello = 1
+ server_hello = 2
+ certificate = 11
+ server_key_exchange = 12
+ certificate_request = 13
+ server_hello_done = 14
+ certificate_verify = 15
+ client_key_exchange = 16
+ finished = 20
+
+class ContentType:
+ change_cipher_spec = 20
+ alert = 21
+ handshake = 22
+ application_data = 23
+ all = (20,21,22,23)
+
+class AlertLevel:
+ warning = 1
+ fatal = 2
+
+class AlertDescription:
+ """
+ @cvar bad_record_mac: A TLS record failed to decrypt properly.
+
+ If this occurs during a shared-key or SRP handshake it most likely
+ indicates a bad password. It may also indicate an implementation
+ error, or some tampering with the data in transit.
+
+ This alert will be signalled by the server if the SRP password is bad. It
+ may also be signalled by the server if the SRP username is unknown to the
+ server, but it doesn't wish to reveal that fact.
+
+ This alert will be signalled by the client if the shared-key username is
+ bad.
+
+ @cvar handshake_failure: A problem occurred while handshaking.
+
+ This typically indicates a lack of common ciphersuites between client and
+ server, or some other disagreement (about SRP parameters or key sizes,
+ for example).
+
+ @cvar protocol_version: The other party's SSL/TLS version was unacceptable.
+
+ This indicates that the client and server couldn't agree on which version
+ of SSL or TLS to use.
+
+ @cvar user_canceled: The handshake is being cancelled for some reason.
+
+ """
+
+ close_notify = 0
+ unexpected_message = 10
+ bad_record_mac = 20
+ decryption_failed = 21
+ record_overflow = 22
+ decompression_failure = 30
+ handshake_failure = 40
+ no_certificate = 41 #SSLv3
+ bad_certificate = 42
+ unsupported_certificate = 43
+ certificate_revoked = 44
+ certificate_expired = 45
+ certificate_unknown = 46
+ illegal_parameter = 47
+ unknown_ca = 48
+ access_denied = 49
+ decode_error = 50
+ decrypt_error = 51
+ export_restriction = 60
+ protocol_version = 70
+ insufficient_security = 71
+ internal_error = 80
+ user_canceled = 90
+ no_renegotiation = 100
+ unknown_srp_username = 120
+ missing_srp_username = 121
+ untrusted_srp_parameters = 122
+
+class CipherSuite:
+ TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA = 0x0050
+ TLS_SRP_SHA_WITH_AES_128_CBC_SHA = 0x0053
+ TLS_SRP_SHA_WITH_AES_256_CBC_SHA = 0x0056
+
+ TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA = 0x0051
+ TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA = 0x0054
+ TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA = 0x0057
+
+ TLS_RSA_WITH_3DES_EDE_CBC_SHA = 0x000A
+ TLS_RSA_WITH_AES_128_CBC_SHA = 0x002F
+ TLS_RSA_WITH_AES_256_CBC_SHA = 0x0035
+ TLS_RSA_WITH_RC4_128_SHA = 0x0005
+
+ srpSuites = []
+ srpSuites.append(TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA)
+ srpSuites.append(TLS_SRP_SHA_WITH_AES_128_CBC_SHA)
+ srpSuites.append(TLS_SRP_SHA_WITH_AES_256_CBC_SHA)
+ def getSrpSuites(ciphers):
+ suites = []
+ for cipher in ciphers:
+ if cipher == "aes128":
+ suites.append(CipherSuite.TLS_SRP_SHA_WITH_AES_128_CBC_SHA)
+ elif cipher == "aes256":
+ suites.append(CipherSuite.TLS_SRP_SHA_WITH_AES_256_CBC_SHA)
+ elif cipher == "3des":
+ suites.append(CipherSuite.TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA)
+ return suites
+ getSrpSuites = staticmethod(getSrpSuites)
+
+ srpRsaSuites = []
+ srpRsaSuites.append(TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA)
+ srpRsaSuites.append(TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA)
+ srpRsaSuites.append(TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA)
+ def getSrpRsaSuites(ciphers):
+ suites = []
+ for cipher in ciphers:
+ if cipher == "aes128":
+ suites.append(CipherSuite.TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA)
+ elif cipher == "aes256":
+ suites.append(CipherSuite.TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA)
+ elif cipher == "3des":
+ suites.append(CipherSuite.TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA)
+ return suites
+ getSrpRsaSuites = staticmethod(getSrpRsaSuites)
+
+ rsaSuites = []
+ rsaSuites.append(TLS_RSA_WITH_3DES_EDE_CBC_SHA)
+ rsaSuites.append(TLS_RSA_WITH_AES_128_CBC_SHA)
+ rsaSuites.append(TLS_RSA_WITH_AES_256_CBC_SHA)
+ rsaSuites.append(TLS_RSA_WITH_RC4_128_SHA)
+ def getRsaSuites(ciphers):
+ suites = []
+ for cipher in ciphers:
+ if cipher == "aes128":
+ suites.append(CipherSuite.TLS_RSA_WITH_AES_128_CBC_SHA)
+ elif cipher == "aes256":
+ suites.append(CipherSuite.TLS_RSA_WITH_AES_256_CBC_SHA)
+ elif cipher == "rc4":
+ suites.append(CipherSuite.TLS_RSA_WITH_RC4_128_SHA)
+ elif cipher == "3des":
+ suites.append(CipherSuite.TLS_RSA_WITH_3DES_EDE_CBC_SHA)
+ return suites
+ getRsaSuites = staticmethod(getRsaSuites)
+
+ tripleDESSuites = []
+ tripleDESSuites.append(TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA)
+ tripleDESSuites.append(TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA)
+ tripleDESSuites.append(TLS_RSA_WITH_3DES_EDE_CBC_SHA)
+
+ aes128Suites = []
+ aes128Suites.append(TLS_SRP_SHA_WITH_AES_128_CBC_SHA)
+ aes128Suites.append(TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA)
+ aes128Suites.append(TLS_RSA_WITH_AES_128_CBC_SHA)
+
+ aes256Suites = []
+ aes256Suites.append(TLS_SRP_SHA_WITH_AES_256_CBC_SHA)
+ aes256Suites.append(TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA)
+ aes256Suites.append(TLS_RSA_WITH_AES_256_CBC_SHA)
+
+ rc4Suites = []
+ rc4Suites.append(TLS_RSA_WITH_RC4_128_SHA)
+
+
+class Fault:
+ badUsername = 101
+ badPassword = 102
+ badA = 103
+ clientSrpFaults = range(101,104)
+
+ badVerifyMessage = 601
+ clientCertFaults = range(601,602)
+
+ badPremasterPadding = 501
+ shortPremasterSecret = 502
+ clientNoAuthFaults = range(501,503)
+
+ badIdentifier = 401
+ badSharedKey = 402
+ clientSharedKeyFaults = range(401,403)
+
+ badB = 201
+ serverFaults = range(201,202)
+
+ badFinished = 300
+ badMAC = 301
+ badPadding = 302
+ genericFaults = range(300,303)
+
+ faultAlerts = {\
+ badUsername: (AlertDescription.unknown_srp_username, \
+ AlertDescription.bad_record_mac),\
+ badPassword: (AlertDescription.bad_record_mac,),\
+ badA: (AlertDescription.illegal_parameter,),\
+ badIdentifier: (AlertDescription.handshake_failure,),\
+ badSharedKey: (AlertDescription.bad_record_mac,),\
+ badPremasterPadding: (AlertDescription.bad_record_mac,),\
+ shortPremasterSecret: (AlertDescription.bad_record_mac,),\
+ badVerifyMessage: (AlertDescription.decrypt_error,),\
+ badFinished: (AlertDescription.decrypt_error,),\
+ badMAC: (AlertDescription.bad_record_mac,),\
+ badPadding: (AlertDescription.bad_record_mac,)
+ }
+
+ faultNames = {\
+ badUsername: "bad username",\
+ badPassword: "bad password",\
+ badA: "bad A",\
+ badIdentifier: "bad identifier",\
+ badSharedKey: "bad sharedkey",\
+ badPremasterPadding: "bad premaster padding",\
+ shortPremasterSecret: "short premaster secret",\
+ badVerifyMessage: "bad verify message",\
+ badFinished: "bad finished message",\
+ badMAC: "bad MAC",\
+ badPadding: "bad padding"
+ }
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/errors.py b/samples/apps/marketplace_sample/gdata/tlslite/errors.py
new file mode 100755
index 0000000..c7f7ba8
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/errors.py
@@ -0,0 +1,149 @@
+"""Exception classes.
+@sort: TLSError, TLSAbruptCloseError, TLSAlert, TLSLocalAlert, TLSRemoteAlert,
+TLSAuthenticationError, TLSNoAuthenticationError, TLSAuthenticationTypeError,
+TLSFingerprintError, TLSAuthorizationError, TLSValidationError, TLSFaultError
+"""
+
+from constants import AlertDescription, AlertLevel
+
+class TLSError(Exception):
+ """Base class for all TLS Lite exceptions."""
+ pass
+
+class TLSAbruptCloseError(TLSError):
+ """The socket was closed without a proper TLS shutdown.
+
+ The TLS specification mandates that an alert of some sort
+ must be sent before the underlying socket is closed. If the socket
+ is closed without this, it could signify that an attacker is trying
+ to truncate the connection. It could also signify a misbehaving
+ TLS implementation, or a random network failure.
+ """
+ pass
+
+class TLSAlert(TLSError):
+ """A TLS alert has been signalled."""
+ pass
+
+ _descriptionStr = {\
+ AlertDescription.close_notify: "close_notify",\
+ AlertDescription.unexpected_message: "unexpected_message",\
+ AlertDescription.bad_record_mac: "bad_record_mac",\
+ AlertDescription.decryption_failed: "decryption_failed",\
+ AlertDescription.record_overflow: "record_overflow",\
+ AlertDescription.decompression_failure: "decompression_failure",\
+ AlertDescription.handshake_failure: "handshake_failure",\
+ AlertDescription.no_certificate: "no certificate",\
+ AlertDescription.bad_certificate: "bad_certificate",\
+ AlertDescription.unsupported_certificate: "unsupported_certificate",\
+ AlertDescription.certificate_revoked: "certificate_revoked",\
+ AlertDescription.certificate_expired: "certificate_expired",\
+ AlertDescription.certificate_unknown: "certificate_unknown",\
+ AlertDescription.illegal_parameter: "illegal_parameter",\
+ AlertDescription.unknown_ca: "unknown_ca",\
+ AlertDescription.access_denied: "access_denied",\
+ AlertDescription.decode_error: "decode_error",\
+ AlertDescription.decrypt_error: "decrypt_error",\
+ AlertDescription.export_restriction: "export_restriction",\
+ AlertDescription.protocol_version: "protocol_version",\
+ AlertDescription.insufficient_security: "insufficient_security",\
+ AlertDescription.internal_error: "internal_error",\
+ AlertDescription.user_canceled: "user_canceled",\
+ AlertDescription.no_renegotiation: "no_renegotiation",\
+ AlertDescription.unknown_srp_username: "unknown_srp_username",\
+ AlertDescription.missing_srp_username: "missing_srp_username"}
+
+class TLSLocalAlert(TLSAlert):
+ """A TLS alert has been signalled by the local implementation.
+
+ @type description: int
+ @ivar description: Set to one of the constants in
+ L{tlslite.constants.AlertDescription}
+
+ @type level: int
+ @ivar level: Set to one of the constants in
+ L{tlslite.constants.AlertLevel}
+
+ @type message: str
+ @ivar message: Description of what went wrong.
+ """
+ def __init__(self, alert, message=None):
+ self.description = alert.description
+ self.level = alert.level
+ self.message = message
+
+ def __str__(self):
+ alertStr = TLSAlert._descriptionStr.get(self.description)
+ if alertStr == None:
+ alertStr = str(self.description)
+ if self.message:
+ return alertStr + ": " + self.message
+ else:
+ return alertStr
+
+class TLSRemoteAlert(TLSAlert):
+ """A TLS alert has been signalled by the remote implementation.
+
+ @type description: int
+ @ivar description: Set to one of the constants in
+ L{tlslite.constants.AlertDescription}
+
+ @type level: int
+ @ivar level: Set to one of the constants in
+ L{tlslite.constants.AlertLevel}
+ """
+ def __init__(self, alert):
+ self.description = alert.description
+ self.level = alert.level
+
+ def __str__(self):
+ alertStr = TLSAlert._descriptionStr.get(self.description)
+ if alertStr == None:
+ alertStr = str(self.description)
+ return alertStr
+
+class TLSAuthenticationError(TLSError):
+ """The handshake succeeded, but the other party's authentication
+ was inadequate.
+
+ This exception will only be raised when a
+ L{tlslite.Checker.Checker} has been passed to a handshake function.
+ The Checker will be invoked once the handshake completes, and if
+ the Checker objects to how the other party authenticated, a
+ subclass of this exception will be raised.
+ """
+ pass
+
+class TLSNoAuthenticationError(TLSAuthenticationError):
+ """The Checker was expecting the other party to authenticate with a
+ certificate chain, but this did not occur."""
+ pass
+
+class TLSAuthenticationTypeError(TLSAuthenticationError):
+ """The Checker was expecting the other party to authenticate with a
+ different type of certificate chain."""
+ pass
+
+class TLSFingerprintError(TLSAuthenticationError):
+ """The Checker was expecting the other party to authenticate with a
+ certificate chain that matches a different fingerprint."""
+ pass
+
+class TLSAuthorizationError(TLSAuthenticationError):
+ """The Checker was expecting the other party to authenticate with a
+ certificate chain that has a different authorization."""
+ pass
+
+class TLSValidationError(TLSAuthenticationError):
+ """The Checker has determined that the other party's certificate
+ chain is invalid."""
+ pass
+
+class TLSFaultError(TLSError):
+ """The other party responded incorrectly to an induced fault.
+
+ This exception will only occur during fault testing, when a
+ TLSConnection's fault variable is set to induce some sort of
+ faulty behavior, and the other party doesn't respond appropriately.
+ """
+ pass
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/AsyncStateMachine.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/AsyncStateMachine.py
new file mode 100755
index 0000000..abed604
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/AsyncStateMachine.py
@@ -0,0 +1,235 @@
+"""
+A state machine for using TLS Lite with asynchronous I/O.
+"""
+
+class AsyncStateMachine:
+ """
+ This is an abstract class that's used to integrate TLS Lite with
+ asyncore and Twisted.
+
+ This class signals wantsReadsEvent() and wantsWriteEvent(). When
+ the underlying socket has become readable or writeable, the event
+ should be passed to this class by calling inReadEvent() or
+ inWriteEvent(). This class will then try to read or write through
+ the socket, and will update its state appropriately.
+
+ This class will forward higher-level events to its subclass. For
+ example, when a complete TLS record has been received,
+ outReadEvent() will be called with the decrypted data.
+ """
+
+ def __init__(self):
+ self._clear()
+
+ def _clear(self):
+ #These store the various asynchronous operations (i.e.
+ #generators). Only one of them, at most, is ever active at a
+ #time.
+ self.handshaker = None
+ self.closer = None
+ self.reader = None
+ self.writer = None
+
+ #This stores the result from the last call to the
+ #currently active operation. If 0 it indicates that the
+ #operation wants to read, if 1 it indicates that the
+ #operation wants to write. If None, there is no active
+ #operation.
+ self.result = None
+
+ def _checkAssert(self, maxActive=1):
+ #This checks that only one operation, at most, is
+ #active, and that self.result is set appropriately.
+ activeOps = 0
+ if self.handshaker:
+ activeOps += 1
+ if self.closer:
+ activeOps += 1
+ if self.reader:
+ activeOps += 1
+ if self.writer:
+ activeOps += 1
+
+ if self.result == None:
+ if activeOps != 0:
+ raise AssertionError()
+ elif self.result in (0,1):
+ if activeOps != 1:
+ raise AssertionError()
+ else:
+ raise AssertionError()
+ if activeOps > maxActive:
+ raise AssertionError()
+
+ def wantsReadEvent(self):
+ """If the state machine wants to read.
+
+ If an operation is active, this returns whether or not the
+ operation wants to read from the socket. If an operation is
+ not active, this returns None.
+
+ @rtype: bool or None
+ @return: If the state machine wants to read.
+ """
+ if self.result != None:
+ return self.result == 0
+ return None
+
+ def wantsWriteEvent(self):
+ """If the state machine wants to write.
+
+ If an operation is active, this returns whether or not the
+ operation wants to write to the socket. If an operation is
+ not active, this returns None.
+
+ @rtype: bool or None
+ @return: If the state machine wants to write.
+ """
+ if self.result != None:
+ return self.result == 1
+ return None
+
+ def outConnectEvent(self):
+ """Called when a handshake operation completes.
+
+ May be overridden in subclass.
+ """
+ pass
+
+ def outCloseEvent(self):
+ """Called when a close operation completes.
+
+ May be overridden in subclass.
+ """
+ pass
+
+ def outReadEvent(self, readBuffer):
+ """Called when a read operation completes.
+
+ May be overridden in subclass."""
+ pass
+
+ def outWriteEvent(self):
+ """Called when a write operation completes.
+
+ May be overridden in subclass."""
+ pass
+
+ def inReadEvent(self):
+ """Tell the state machine it can read from the socket."""
+ try:
+ self._checkAssert()
+ if self.handshaker:
+ self._doHandshakeOp()
+ elif self.closer:
+ self._doCloseOp()
+ elif self.reader:
+ self._doReadOp()
+ elif self.writer:
+ self._doWriteOp()
+ else:
+ self.reader = self.tlsConnection.readAsync(16384)
+ self._doReadOp()
+ except:
+ self._clear()
+ raise
+
+ def inWriteEvent(self):
+ """Tell the state machine it can write to the socket."""
+ try:
+ self._checkAssert()
+ if self.handshaker:
+ self._doHandshakeOp()
+ elif self.closer:
+ self._doCloseOp()
+ elif self.reader:
+ self._doReadOp()
+ elif self.writer:
+ self._doWriteOp()
+ else:
+ self.outWriteEvent()
+ except:
+ self._clear()
+ raise
+
+ def _doHandshakeOp(self):
+ try:
+ self.result = self.handshaker.next()
+ except StopIteration:
+ self.handshaker = None
+ self.result = None
+ self.outConnectEvent()
+
+ def _doCloseOp(self):
+ try:
+ self.result = self.closer.next()
+ except StopIteration:
+ self.closer = None
+ self.result = None
+ self.outCloseEvent()
+
+ def _doReadOp(self):
+ self.result = self.reader.next()
+ if not self.result in (0,1):
+ readBuffer = self.result
+ self.reader = None
+ self.result = None
+ self.outReadEvent(readBuffer)
+
+ def _doWriteOp(self):
+ try:
+ self.result = self.writer.next()
+ except StopIteration:
+ self.writer = None
+ self.result = None
+
+ def setHandshakeOp(self, handshaker):
+ """Start a handshake operation.
+
+ @type handshaker: generator
+ @param handshaker: A generator created by using one of the
+ asynchronous handshake functions (i.e. handshakeServerAsync, or
+ handshakeClientxxx(..., async=True).
+ """
+ try:
+ self._checkAssert(0)
+ self.handshaker = handshaker
+ self._doHandshakeOp()
+ except:
+ self._clear()
+ raise
+
+ def setServerHandshakeOp(self, **args):
+ """Start a handshake operation.
+
+ The arguments passed to this function will be forwarded to
+ L{tlslite.TLSConnection.TLSConnection.handshakeServerAsync}.
+ """
+ handshaker = self.tlsConnection.handshakeServerAsync(**args)
+ self.setHandshakeOp(handshaker)
+
+ def setCloseOp(self):
+ """Start a close operation.
+ """
+ try:
+ self._checkAssert(0)
+ self.closer = self.tlsConnection.closeAsync()
+ self._doCloseOp()
+ except:
+ self._clear()
+ raise
+
+ def setWriteOp(self, writeBuffer):
+ """Start a write operation.
+
+ @type writeBuffer: str
+ @param writeBuffer: The string to transmit.
+ """
+ try:
+ self._checkAssert(0)
+ self.writer = self.tlsConnection.writeAsync(writeBuffer)
+ self._doWriteOp()
+ except:
+ self._clear()
+ raise
+
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/ClientHelper.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/ClientHelper.py
new file mode 100755
index 0000000..58e0152
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/ClientHelper.py
@@ -0,0 +1,163 @@
+"""
+A helper class for using TLS Lite with stdlib clients
+(httplib, xmlrpclib, imaplib, poplib).
+"""
+
+from gdata.tlslite.Checker import Checker
+
+class ClientHelper:
+ """This is a helper class used to integrate TLS Lite with various
+ TLS clients (e.g. poplib, smtplib, httplib, etc.)"""
+
+ def __init__(self,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings = None):
+ """
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The constructor does not perform the TLS handshake itself, but
+ simply stores these arguments for later. The handshake is
+ performed only when this class needs to connect with the
+ server. Then you should be prepared to handle TLS-specific
+ exceptions. See the client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+
+ self.username = None
+ self.password = None
+ self.sharedKey = None
+ self.certChain = None
+ self.privateKey = None
+ self.checker = None
+
+ #SRP Authentication
+ if username and password and not \
+ (sharedKey or certChain or privateKey):
+ self.username = username
+ self.password = password
+
+ #Shared Key Authentication
+ elif username and sharedKey and not \
+ (password or certChain or privateKey):
+ self.username = username
+ self.sharedKey = sharedKey
+
+ #Certificate Chain Authentication
+ elif certChain and privateKey and not \
+ (username or password or sharedKey):
+ self.certChain = certChain
+ self.privateKey = privateKey
+
+ #No Authentication
+ elif not password and not username and not \
+ sharedKey and not certChain and not privateKey:
+ pass
+
+ else:
+ raise ValueError("Bad parameters")
+
+ #Authenticate the server based on its cryptoID or fingerprint
+ if sharedKey and (cryptoID or protocol or x509Fingerprint):
+ raise ValueError("Can't use shared keys with other forms of"\
+ "authentication")
+
+ self.checker = Checker(cryptoID, protocol, x509Fingerprint,
+ x509TrustList, x509CommonName)
+ self.settings = settings
+
+ self.tlsSession = None
+
+ def _handshake(self, tlsConnection):
+ if self.username and self.password:
+ tlsConnection.handshakeClientSRP(username=self.username,
+ password=self.password,
+ checker=self.checker,
+ settings=self.settings,
+ session=self.tlsSession)
+ elif self.username and self.sharedKey:
+ tlsConnection.handshakeClientSharedKey(username=self.username,
+ sharedKey=self.sharedKey,
+ settings=self.settings)
+ else:
+ tlsConnection.handshakeClientCert(certChain=self.certChain,
+ privateKey=self.privateKey,
+ checker=self.checker,
+ settings=self.settings,
+ session=self.tlsSession)
+ self.tlsSession = tlsConnection.session
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/HTTPTLSConnection.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/HTTPTLSConnection.py
new file mode 100755
index 0000000..58e31a1
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/HTTPTLSConnection.py
@@ -0,0 +1,169 @@
+"""TLS Lite + httplib."""
+
+import socket
+import httplib
+from gdata.tlslite.TLSConnection import TLSConnection
+from gdata.tlslite.integration.ClientHelper import ClientHelper
+
+
+class HTTPBaseTLSConnection(httplib.HTTPConnection):
+ """This abstract class provides a framework for adding TLS support
+ to httplib."""
+
+ default_port = 443
+
+ def __init__(self, host, port=None, strict=None):
+ if strict == None:
+ #Python 2.2 doesn't support strict
+ httplib.HTTPConnection.__init__(self, host, port)
+ else:
+ httplib.HTTPConnection.__init__(self, host, port, strict)
+
+ def connect(self):
+ sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+ if hasattr(sock, 'settimeout'):
+ sock.settimeout(10)
+ sock.connect((self.host, self.port))
+
+ #Use a TLSConnection to emulate a socket
+ self.sock = TLSConnection(sock)
+
+ #When httplib closes this, close the socket
+ self.sock.closeSocket = True
+ self._handshake(self.sock)
+
+ def _handshake(self, tlsConnection):
+ """Called to perform some sort of handshake.
+
+ This method must be overridden in a subclass to do some type of
+ handshake. This method will be called after the socket has
+ been connected but before any data has been sent. If this
+ method does not raise an exception, the TLS connection will be
+ considered valid.
+
+ This method may (or may not) be called every time an HTTP
+ request is performed, depending on whether the underlying HTTP
+ connection is persistent.
+
+ @type tlsConnection: L{tlslite.TLSConnection.TLSConnection}
+ @param tlsConnection: The connection to perform the handshake
+ on.
+ """
+ raise NotImplementedError()
+
+
+class HTTPTLSConnection(HTTPBaseTLSConnection, ClientHelper):
+ """This class extends L{HTTPBaseTLSConnection} to support the
+ common types of handshaking."""
+
+ def __init__(self, host, port=None,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings = None):
+ """Create a new HTTPTLSConnection.
+
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The constructor does not perform the TLS handshake itself, but
+ simply stores these arguments for later. The handshake is
+ performed only when this class needs to connect with the
+ server. Thus you should be prepared to handle TLS-specific
+ exceptions when calling methods inherited from
+ L{httplib.HTTPConnection} such as request(), connect(), and
+ send(). See the client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type host: str
+ @param host: Server to connect to.
+
+ @type port: int
+ @param port: Port to connect to.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+
+ HTTPBaseTLSConnection.__init__(self, host, port)
+
+ ClientHelper.__init__(self,
+ username, password, sharedKey,
+ certChain, privateKey,
+ cryptoID, protocol,
+ x509Fingerprint,
+ x509TrustList, x509CommonName,
+ settings)
+
+ def _handshake(self, tlsConnection):
+ ClientHelper._handshake(self, tlsConnection)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/IMAP4_TLS.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/IMAP4_TLS.py
new file mode 100755
index 0000000..e47076c
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/IMAP4_TLS.py
@@ -0,0 +1,132 @@
+"""TLS Lite + imaplib."""
+
+import socket
+from imaplib import IMAP4
+from gdata.tlslite.TLSConnection import TLSConnection
+from gdata.tlslite.integration.ClientHelper import ClientHelper
+
+# IMAP TLS PORT
+IMAP4_TLS_PORT = 993
+
+class IMAP4_TLS(IMAP4, ClientHelper):
+ """This class extends L{imaplib.IMAP4} with TLS support."""
+
+ def __init__(self, host = '', port = IMAP4_TLS_PORT,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings=None):
+ """Create a new IMAP4_TLS.
+
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The caller should be prepared to handle TLS-specific
+ exceptions. See the client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type host: str
+ @param host: Server to connect to.
+
+ @type port: int
+ @param port: Port to connect to.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+
+ ClientHelper.__init__(self,
+ username, password, sharedKey,
+ certChain, privateKey,
+ cryptoID, protocol,
+ x509Fingerprint,
+ x509TrustList, x509CommonName,
+ settings)
+
+ IMAP4.__init__(self, host, port)
+
+
+ def open(self, host = '', port = IMAP4_TLS_PORT):
+ """Setup connection to remote server on "host:port".
+
+ This connection will be used by the routines:
+ read, readline, send, shutdown.
+ """
+ self.host = host
+ self.port = port
+ self.sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+ self.sock.connect((host, port))
+ self.sock = TLSConnection(self.sock)
+ self.sock.closeSocket = True
+ ClientHelper._handshake(self, self.sock)
+ self.file = self.sock.makefile('rb')
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/IntegrationHelper.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/IntegrationHelper.py
new file mode 100755
index 0000000..af5193b
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/IntegrationHelper.py
@@ -0,0 +1,52 @@
+
+class IntegrationHelper:
+
+ def __init__(self,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings = None):
+
+ self.username = None
+ self.password = None
+ self.sharedKey = None
+ self.certChain = None
+ self.privateKey = None
+ self.checker = None
+
+ #SRP Authentication
+ if username and password and not \
+ (sharedKey or certChain or privateKey):
+ self.username = username
+ self.password = password
+
+ #Shared Key Authentication
+ elif username and sharedKey and not \
+ (password or certChain or privateKey):
+ self.username = username
+ self.sharedKey = sharedKey
+
+ #Certificate Chain Authentication
+ elif certChain and privateKey and not \
+ (username or password or sharedKey):
+ self.certChain = certChain
+ self.privateKey = privateKey
+
+ #No Authentication
+ elif not password and not username and not \
+ sharedKey and not certChain and not privateKey:
+ pass
+
+ else:
+ raise ValueError("Bad parameters")
+
+ #Authenticate the server based on its cryptoID or fingerprint
+ if sharedKey and (cryptoID or protocol or x509Fingerprint):
+ raise ValueError("Can't use shared keys with other forms of"\
+ "authentication")
+
+ self.checker = Checker(cryptoID, protocol, x509Fingerprint,
+ x509TrustList, x509CommonName)
+ self.settings = settings
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/POP3_TLS.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/POP3_TLS.py
new file mode 100755
index 0000000..26b37fd
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/POP3_TLS.py
@@ -0,0 +1,142 @@
+"""TLS Lite + poplib."""
+
+import socket
+from poplib import POP3
+from gdata.tlslite.TLSConnection import TLSConnection
+from gdata.tlslite.integration.ClientHelper import ClientHelper
+
+# POP TLS PORT
+POP3_TLS_PORT = 995
+
+class POP3_TLS(POP3, ClientHelper):
+ """This class extends L{poplib.POP3} with TLS support."""
+
+ def __init__(self, host, port = POP3_TLS_PORT,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings=None):
+ """Create a new POP3_TLS.
+
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The caller should be prepared to handle TLS-specific
+ exceptions. See the client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type host: str
+ @param host: Server to connect to.
+
+ @type port: int
+ @param port: Port to connect to.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+
+ self.host = host
+ self.port = port
+ msg = "getaddrinfo returns an empty list"
+ self.sock = None
+ for res in socket.getaddrinfo(self.host, self.port, 0, socket.SOCK_STREAM):
+ af, socktype, proto, canonname, sa = res
+ try:
+ self.sock = socket.socket(af, socktype, proto)
+ self.sock.connect(sa)
+ except socket.error, msg:
+ if self.sock:
+ self.sock.close()
+ self.sock = None
+ continue
+ break
+ if not self.sock:
+ raise socket.error, msg
+
+ ### New code below (all else copied from poplib)
+ ClientHelper.__init__(self,
+ username, password, sharedKey,
+ certChain, privateKey,
+ cryptoID, protocol,
+ x509Fingerprint,
+ x509TrustList, x509CommonName,
+ settings)
+
+ self.sock = TLSConnection(self.sock)
+ self.sock.closeSocket = True
+ ClientHelper._handshake(self, self.sock)
+ ###
+
+ self.file = self.sock.makefile('rb')
+ self._debugging = 0
+ self.welcome = self._getresp()
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/SMTP_TLS.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/SMTP_TLS.py
new file mode 100755
index 0000000..67e0feb
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/SMTP_TLS.py
@@ -0,0 +1,114 @@
+"""TLS Lite + smtplib."""
+
+from smtplib import SMTP
+from gdata.tlslite.TLSConnection import TLSConnection
+from gdata.tlslite.integration.ClientHelper import ClientHelper
+
+class SMTP_TLS(SMTP):
+ """This class extends L{smtplib.SMTP} with TLS support."""
+
+ def starttls(self,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings=None):
+ """Puts the connection to the SMTP server into TLS mode.
+
+ If the server supports TLS, this will encrypt the rest of the SMTP
+ session.
+
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The caller should be prepared to handle TLS-specific
+ exceptions. See the client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+ (resp, reply) = self.docmd("STARTTLS")
+ if resp == 220:
+ helper = ClientHelper(
+ username, password, sharedKey,
+ certChain, privateKey,
+ cryptoID, protocol,
+ x509Fingerprint,
+ x509TrustList, x509CommonName,
+ settings)
+ conn = TLSConnection(self.sock)
+ conn.closeSocket = True
+ helper._handshake(conn)
+ self.sock = conn
+ self.file = conn.makefile('rb')
+ return (resp, reply)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/TLSAsyncDispatcherMixIn.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/TLSAsyncDispatcherMixIn.py
new file mode 100755
index 0000000..f732f62
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/TLSAsyncDispatcherMixIn.py
@@ -0,0 +1,139 @@
+"""TLS Lite + asyncore."""
+
+
+import asyncore
+from gdata.tlslite.TLSConnection import TLSConnection
+from AsyncStateMachine import AsyncStateMachine
+
+
+class TLSAsyncDispatcherMixIn(AsyncStateMachine):
+ """This class can be "mixed in" with an
+ L{asyncore.dispatcher} to add TLS support.
+
+ This class essentially sits between the dispatcher and the select
+ loop, intercepting events and only calling the dispatcher when
+ applicable.
+
+ In the case of handle_read(), a read operation will be activated,
+ and when it completes, the bytes will be placed in a buffer where
+ the dispatcher can retrieve them by calling recv(), and the
+ dispatcher's handle_read() will be called.
+
+ In the case of handle_write(), the dispatcher's handle_write() will
+ be called, and when it calls send(), a write operation will be
+ activated.
+
+ To use this class, you must combine it with an asyncore.dispatcher,
+ and pass in a handshake operation with setServerHandshakeOp().
+
+ Below is an example of using this class with medusa. This class is
+ mixed in with http_channel to create http_tls_channel. Note:
+ 1. the mix-in is listed first in the inheritance list
+
+ 2. the input buffer size must be at least 16K, otherwise the
+ dispatcher might not read all the bytes from the TLS layer,
+ leaving some bytes in limbo.
+
+ 3. IE seems to have a problem receiving a whole HTTP response in a
+ single TLS record, so HTML pages containing '\\r\\n\\r\\n' won't
+ be displayed on IE.
+
+ Add the following text into 'start_medusa.py', in the 'HTTP Server'
+ section::
+
+ from tlslite.api import *
+ s = open("./serverX509Cert.pem").read()
+ x509 = X509()
+ x509.parse(s)
+ certChain = X509CertChain([x509])
+
+ s = open("./serverX509Key.pem").read()
+ privateKey = parsePEMKey(s, private=True)
+
+ class http_tls_channel(TLSAsyncDispatcherMixIn,
+ http_server.http_channel):
+ ac_in_buffer_size = 16384
+
+ def __init__ (self, server, conn, addr):
+ http_server.http_channel.__init__(self, server, conn, addr)
+ TLSAsyncDispatcherMixIn.__init__(self, conn)
+ self.tlsConnection.ignoreAbruptClose = True
+ self.setServerHandshakeOp(certChain=certChain,
+ privateKey=privateKey)
+
+ hs.channel_class = http_tls_channel
+
+ If the TLS layer raises an exception, the exception will be caught
+ in asyncore.dispatcher, which will call close() on this class. The
+ TLS layer always closes the TLS connection before raising an
+ exception, so the close operation will complete right away, causing
+ asyncore.dispatcher.close() to be called, which closes the socket
+ and removes this instance from the asyncore loop.
+
+ """
+
+
+ def __init__(self, sock=None):
+ AsyncStateMachine.__init__(self)
+
+ if sock:
+ self.tlsConnection = TLSConnection(sock)
+
+ #Calculate the sibling I'm being mixed in with.
+ #This is necessary since we override functions
+ #like readable(), handle_read(), etc., but we
+ #also want to call the sibling's versions.
+ for cl in self.__class__.__bases__:
+ if cl != TLSAsyncDispatcherMixIn and cl != AsyncStateMachine:
+ self.siblingClass = cl
+ break
+ else:
+ raise AssertionError()
+
+ def readable(self):
+ result = self.wantsReadEvent()
+ if result != None:
+ return result
+ return self.siblingClass.readable(self)
+
+ def writable(self):
+ result = self.wantsWriteEvent()
+ if result != None:
+ return result
+ return self.siblingClass.writable(self)
+
+ def handle_read(self):
+ self.inReadEvent()
+
+ def handle_write(self):
+ self.inWriteEvent()
+
+ def outConnectEvent(self):
+ self.siblingClass.handle_connect(self)
+
+ def outCloseEvent(self):
+ asyncore.dispatcher.close(self)
+
+ def outReadEvent(self, readBuffer):
+ self.readBuffer = readBuffer
+ self.siblingClass.handle_read(self)
+
+ def outWriteEvent(self):
+ self.siblingClass.handle_write(self)
+
+ def recv(self, bufferSize=16384):
+ if bufferSize < 16384 or self.readBuffer == None:
+ raise AssertionError()
+ returnValue = self.readBuffer
+ self.readBuffer = None
+ return returnValue
+
+ def send(self, writeBuffer):
+ self.setWriteOp(writeBuffer)
+ return len(writeBuffer)
+
+ def close(self):
+ if hasattr(self, "tlsConnection"):
+ self.setCloseOp()
+ else:
+ asyncore.dispatcher.close(self)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/TLSSocketServerMixIn.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/TLSSocketServerMixIn.py
new file mode 100755
index 0000000..10224b6
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/TLSSocketServerMixIn.py
@@ -0,0 +1,59 @@
+"""TLS Lite + SocketServer."""
+
+from gdata.tlslite.TLSConnection import TLSConnection
+
+class TLSSocketServerMixIn:
+ """
+ This class can be mixed in with any L{SocketServer.TCPServer} to
+ add TLS support.
+
+ To use this class, define a new class that inherits from it and
+ some L{SocketServer.TCPServer} (with the mix-in first). Then
+ implement the handshake() method, doing some sort of server
+ handshake on the connection argument. If the handshake method
+ returns True, the RequestHandler will be triggered. Below is a
+ complete example of a threaded HTTPS server::
+
+ from SocketServer import *
+ from BaseHTTPServer import *
+ from SimpleHTTPServer import *
+ from tlslite.api import *
+
+ s = open("./serverX509Cert.pem").read()
+ x509 = X509()
+ x509.parse(s)
+ certChain = X509CertChain([x509])
+
+ s = open("./serverX509Key.pem").read()
+ privateKey = parsePEMKey(s, private=True)
+
+ sessionCache = SessionCache()
+
+ class MyHTTPServer(ThreadingMixIn, TLSSocketServerMixIn,
+ HTTPServer):
+ def handshake(self, tlsConnection):
+ try:
+ tlsConnection.handshakeServer(certChain=certChain,
+ privateKey=privateKey,
+ sessionCache=sessionCache)
+ tlsConnection.ignoreAbruptClose = True
+ return True
+ except TLSError, error:
+ print "Handshake failure:", str(error)
+ return False
+
+ httpd = MyHTTPServer(('localhost', 443), SimpleHTTPRequestHandler)
+ httpd.serve_forever()
+ """
+
+
+ def finish_request(self, sock, client_address):
+ tlsConnection = TLSConnection(sock)
+ if self.handshake(tlsConnection) == True:
+ self.RequestHandlerClass(tlsConnection, client_address, self)
+ tlsConnection.close()
+
+ #Implement this method to do some form of handshaking. Return True
+ #if the handshake finishes properly and the request is authorized.
+ def handshake(self, tlsConnection):
+ raise NotImplementedError()
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/TLSTwistedProtocolWrapper.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/TLSTwistedProtocolWrapper.py
new file mode 100755
index 0000000..c88703c
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/TLSTwistedProtocolWrapper.py
@@ -0,0 +1,196 @@
+"""TLS Lite + Twisted."""
+
+from twisted.protocols.policies import ProtocolWrapper, WrappingFactory
+from twisted.python.failure import Failure
+
+from AsyncStateMachine import AsyncStateMachine
+from gdata.tlslite.TLSConnection import TLSConnection
+from gdata.tlslite.errors import *
+
+import socket
+import errno
+
+
+#The TLSConnection is created around a "fake socket" that
+#plugs it into the underlying Twisted transport
+class _FakeSocket:
+ def __init__(self, wrapper):
+ self.wrapper = wrapper
+ self.data = ""
+
+ def send(self, data):
+ ProtocolWrapper.write(self.wrapper, data)
+ return len(data)
+
+ def recv(self, numBytes):
+ if self.data == "":
+ raise socket.error, (errno.EWOULDBLOCK, "")
+ returnData = self.data[:numBytes]
+ self.data = self.data[numBytes:]
+ return returnData
+
+class TLSTwistedProtocolWrapper(ProtocolWrapper, AsyncStateMachine):
+ """This class can wrap Twisted protocols to add TLS support.
+
+ Below is a complete example of using TLS Lite with a Twisted echo
+ server.
+
+ There are two server implementations below. Echo is the original
+ protocol, which is oblivious to TLS. Echo1 subclasses Echo and
+ negotiates TLS when the client connects. Echo2 subclasses Echo and
+ negotiates TLS when the client sends "STARTTLS"::
+
+ from twisted.internet.protocol import Protocol, Factory
+ from twisted.internet import reactor
+ from twisted.protocols.policies import WrappingFactory
+ from twisted.protocols.basic import LineReceiver
+ from twisted.python import log
+ from twisted.python.failure import Failure
+ import sys
+ from tlslite.api import *
+
+ s = open("./serverX509Cert.pem").read()
+ x509 = X509()
+ x509.parse(s)
+ certChain = X509CertChain([x509])
+
+ s = open("./serverX509Key.pem").read()
+ privateKey = parsePEMKey(s, private=True)
+
+ verifierDB = VerifierDB("verifierDB")
+ verifierDB.open()
+
+ class Echo(LineReceiver):
+ def connectionMade(self):
+ self.transport.write("Welcome to the echo server!\\r\\n")
+
+ def lineReceived(self, line):
+ self.transport.write(line + "\\r\\n")
+
+ class Echo1(Echo):
+ def connectionMade(self):
+ if not self.transport.tlsStarted:
+ self.transport.setServerHandshakeOp(certChain=certChain,
+ privateKey=privateKey,
+ verifierDB=verifierDB)
+ else:
+ Echo.connectionMade(self)
+
+ def connectionLost(self, reason):
+ pass #Handle any TLS exceptions here
+
+ class Echo2(Echo):
+ def lineReceived(self, data):
+ if data == "STARTTLS":
+ self.transport.setServerHandshakeOp(certChain=certChain,
+ privateKey=privateKey,
+ verifierDB=verifierDB)
+ else:
+ Echo.lineReceived(self, data)
+
+ def connectionLost(self, reason):
+ pass #Handle any TLS exceptions here
+
+ factory = Factory()
+ factory.protocol = Echo1
+ #factory.protocol = Echo2
+
+ wrappingFactory = WrappingFactory(factory)
+ wrappingFactory.protocol = TLSTwistedProtocolWrapper
+
+ log.startLogging(sys.stdout)
+ reactor.listenTCP(1079, wrappingFactory)
+ reactor.run()
+
+ This class works as follows:
+
+ Data comes in and is given to the AsyncStateMachine for handling.
+ AsyncStateMachine will forward events to this class, and we'll
+ pass them on to the ProtocolHandler, which will proxy them to the
+ wrapped protocol. The wrapped protocol may then call back into
+ this class, and these calls will be proxied into the
+ AsyncStateMachine.
+
+ The call graph looks like this:
+ - self.dataReceived
+ - AsyncStateMachine.inReadEvent
+ - self.out(Connect|Close|Read)Event
+ - ProtocolWrapper.(connectionMade|loseConnection|dataReceived)
+ - self.(loseConnection|write|writeSequence)
+ - AsyncStateMachine.(setCloseOp|setWriteOp)
+ """
+
+ #WARNING: IF YOU COPY-AND-PASTE THE ABOVE CODE, BE SURE TO REMOVE
+ #THE EXTRA ESCAPING AROUND "\\r\\n"
+
+ def __init__(self, factory, wrappedProtocol):
+ ProtocolWrapper.__init__(self, factory, wrappedProtocol)
+ AsyncStateMachine.__init__(self)
+ self.fakeSocket = _FakeSocket(self)
+ self.tlsConnection = TLSConnection(self.fakeSocket)
+ self.tlsStarted = False
+ self.connectionLostCalled = False
+
+ def connectionMade(self):
+ try:
+ ProtocolWrapper.connectionMade(self)
+ except TLSError, e:
+ self.connectionLost(Failure(e))
+ ProtocolWrapper.loseConnection(self)
+
+ def dataReceived(self, data):
+ try:
+ if not self.tlsStarted:
+ ProtocolWrapper.dataReceived(self, data)
+ else:
+ self.fakeSocket.data += data
+ while self.fakeSocket.data:
+ AsyncStateMachine.inReadEvent(self)
+ except TLSError, e:
+ self.connectionLost(Failure(e))
+ ProtocolWrapper.loseConnection(self)
+
+ def connectionLost(self, reason):
+ if not self.connectionLostCalled:
+ ProtocolWrapper.connectionLost(self, reason)
+ self.connectionLostCalled = True
+
+
+ def outConnectEvent(self):
+ ProtocolWrapper.connectionMade(self)
+
+ def outCloseEvent(self):
+ ProtocolWrapper.loseConnection(self)
+
+ def outReadEvent(self, data):
+ if data == "":
+ ProtocolWrapper.loseConnection(self)
+ else:
+ ProtocolWrapper.dataReceived(self, data)
+
+
+ def setServerHandshakeOp(self, **args):
+ self.tlsStarted = True
+ AsyncStateMachine.setServerHandshakeOp(self, **args)
+
+ def loseConnection(self):
+ if not self.tlsStarted:
+ ProtocolWrapper.loseConnection(self)
+ else:
+ AsyncStateMachine.setCloseOp(self)
+
+ def write(self, data):
+ if not self.tlsStarted:
+ ProtocolWrapper.write(self, data)
+ else:
+ #Because of the FakeSocket, write operations are guaranteed to
+ #terminate immediately.
+ AsyncStateMachine.setWriteOp(self, data)
+
+ def writeSequence(self, seq):
+ if not self.tlsStarted:
+ ProtocolWrapper.writeSequence(self, seq)
+ else:
+ #Because of the FakeSocket, write operations are guaranteed to
+ #terminate immediately.
+ AsyncStateMachine.setWriteOp(self, "".join(seq))
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/XMLRPCTransport.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/XMLRPCTransport.py
new file mode 100755
index 0000000..3f025e4
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/XMLRPCTransport.py
@@ -0,0 +1,137 @@
+"""TLS Lite + xmlrpclib."""
+
+import xmlrpclib
+import httplib
+from gdata.tlslite.integration.HTTPTLSConnection import HTTPTLSConnection
+from gdata.tlslite.integration.ClientHelper import ClientHelper
+
+
+class XMLRPCTransport(xmlrpclib.Transport, ClientHelper):
+ """Handles an HTTPS transaction to an XML-RPC server."""
+
+ def __init__(self,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings=None):
+ """Create a new XMLRPCTransport.
+
+ An instance of this class can be passed to L{xmlrpclib.ServerProxy}
+ to use TLS with XML-RPC calls::
+
+ from tlslite.api import XMLRPCTransport
+ from xmlrpclib import ServerProxy
+
+ transport = XMLRPCTransport(user="alice", password="abra123")
+ server = ServerProxy("https://localhost", transport)
+
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The constructor does not perform the TLS handshake itself, but
+ simply stores these arguments for later. The handshake is
+ performed only when this class needs to connect with the
+ server. Thus you should be prepared to handle TLS-specific
+ exceptions when calling methods of L{xmlrpclib.ServerProxy}. See the
+ client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+
+ ClientHelper.__init__(self,
+ username, password, sharedKey,
+ certChain, privateKey,
+ cryptoID, protocol,
+ x509Fingerprint,
+ x509TrustList, x509CommonName,
+ settings)
+
+
+ def make_connection(self, host):
+ # create a HTTPS connection object from a host descriptor
+ host, extra_headers, x509 = self.get_host_info(host)
+ http = HTTPTLSConnection(host, None,
+ self.username, self.password,
+ self.sharedKey,
+ self.certChain, self.privateKey,
+ self.checker.cryptoID,
+ self.checker.protocol,
+ self.checker.x509Fingerprint,
+ self.checker.x509TrustList,
+ self.checker.x509CommonName,
+ self.settings)
+ http2 = httplib.HTTP()
+ http2._setup(http)
+ return http2
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/integration/__init__.py b/samples/apps/marketplace_sample/gdata/tlslite/integration/__init__.py
new file mode 100755
index 0000000..960f406
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/integration/__init__.py
@@ -0,0 +1,17 @@
+"""Classes for integrating TLS Lite with other packages."""
+
+__all__ = ["AsyncStateMachine",
+ "HTTPTLSConnection",
+ "POP3_TLS",
+ "IMAP4_TLS",
+ "SMTP_TLS",
+ "XMLRPCTransport",
+ "TLSSocketServerMixIn",
+ "TLSAsyncDispatcherMixIn",
+ "TLSTwistedProtocolWrapper"]
+
+try:
+ import twisted
+ del twisted
+except ImportError:
+ del __all__[__all__.index("TLSTwistedProtocolWrapper")]
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/mathtls.py b/samples/apps/marketplace_sample/gdata/tlslite/mathtls.py
new file mode 100755
index 0000000..3b8ede6
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/mathtls.py
@@ -0,0 +1,170 @@
+"""Miscellaneous helper functions."""
+
+from utils.compat import *
+from utils.cryptomath import *
+
+import hmac
+import md5
+import sha
+
+#1024, 1536, 2048, 3072, 4096, 6144, and 8192 bit groups]
+goodGroupParameters = [(2,0xEEAF0AB9ADB38DD69C33F80AFA8FC5E86072618775FF3C0B9EA2314C9C256576D674DF7496EA81D3383B4813D692C6E0E0D5D8E250B98BE48E495C1D6089DAD15DC7D7B46154D6B6CE8EF4AD69B15D4982559B297BCF1885C529F566660E57EC68EDBC3C05726CC02FD4CBF4976EAA9AFD5138FE8376435B9FC61D2FC0EB06E3),\
+ (2,0x9DEF3CAFB939277AB1F12A8617A47BBBDBA51DF499AC4C80BEEEA9614B19CC4D5F4F5F556E27CBDE51C6A94BE4607A291558903BA0D0F84380B655BB9A22E8DCDF028A7CEC67F0D08134B1C8B97989149B609E0BE3BAB63D47548381DBC5B1FC764E3F4B53DD9DA1158BFD3E2B9C8CF56EDF019539349627DB2FD53D24B7C48665772E437D6C7F8CE442734AF7CCB7AE837C264AE3A9BEB87F8A2FE9B8B5292E5A021FFF5E91479E8CE7A28C2442C6F315180F93499A234DCF76E3FED135F9BB),\
+ (2,0xAC6BDB41324A9A9BF166DE5E1389582FAF72B6651987EE07FC3192943DB56050A37329CBB4A099ED8193E0757767A13DD52312AB4B03310DCD7F48A9DA04FD50E8083969EDB767B0CF6095179A163AB3661A05FBD5FAAAE82918A9962F0B93B855F97993EC975EEAA80D740ADBF4FF747359D041D5C33EA71D281E446B14773BCA97B43A23FB801676BD207A436C6481F1D2B9078717461A5B9D32E688F87748544523B524B0D57D5EA77A2775D2ECFA032CFBDBF52FB3786160279004E57AE6AF874E7303CE53299CCC041C7BC308D82A5698F3A8D0C38271AE35F8E9DBFBB694B5C803D89F7AE435DE236D525F54759B65E372FCD68EF20FA7111F9E4AFF73),\
+ (2,0xFFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F14374FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7EDEE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF0598DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3BE39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF6955817183995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E208E24FA074E5AB3143DB5BFCE0FD108E4B82D120A93AD2CAFFFFFFFFFFFFFFFF),\
+ (5,0xFFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F14374FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7EDEE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF0598DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3BE39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF6955817183995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E208E24FA074E5AB3143DB5BFCE0FD108E4B82D120A92108011A723C12A787E6D788719A10BDBA5B2699C327186AF4E23C1A946834B6150BDA2583E9CA2AD44CE8DBBBC2DB04DE8EF92E8EFC141FBECAA6287C59474E6BC05D99B2964FA090C3A2233BA186515BE7ED1F612970CEE2D7AFB81BDD762170481CD0069127D5B05AA993B4EA988D8FDDC186FFB7DC90A6C08F4DF435C934063199FFFFFFFFFFFFFFFF),\
+ (5,0xFFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F14374FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7EDEE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF0598DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3BE39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF6955817183995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E208E24FA074E5AB3143DB5BFCE0FD108E4B82D120A92108011A723C12A787E6D788719A10BDBA5B2699C327186AF4E23C1A946834B6150BDA2583E9CA2AD44CE8DBBBC2DB04DE8EF92E8EFC141FBECAA6287C59474E6BC05D99B2964FA090C3A2233BA186515BE7ED1F612970CEE2D7AFB81BDD762170481CD0069127D5B05AA993B4EA988D8FDDC186FFB7DC90A6C08F4DF435C93402849236C3FAB4D27C7026C1D4DCB2602646DEC9751E763DBA37BDF8FF9406AD9E530EE5DB382F413001AEB06A53ED9027D831179727B0865A8918DA3EDBEBCF9B14ED44CE6CBACED4BB1BDB7F1447E6CC254B332051512BD7AF426FB8F401378CD2BF5983CA01C64B92ECF032EA15D1721D03F482D7CE6E74FEF6D55E702F46980C82B5A84031900B1C9E59E7C97FBEC7E8F323A97A7E36CC88BE0F1D45B7FF585AC54BD407B22B4154AACC8F6D7EBF48E1D814CC5ED20F8037E0A79715EEF29BE32806A1D58BB7C5DA76F550AA3D8A1FBFF0EB19CCB1A313D55CDA56C9EC2EF29632387FE8D76E3C0468043E8F663F4860EE12BF2D5B0B7474D6E694F91E6DCC4024FFFFFFFFFFFFFFFF),\
+ (5,0xFFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F14374FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7EDEE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF0598DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3BE39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF6955817183995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E208E24FA074E5AB3143DB5BFCE0FD108E4B82D120A92108011A723C12A787E6D788719A10BDBA5B2699C327186AF4E23C1A946834B6150BDA2583E9CA2AD44CE8DBBBC2DB04DE8EF92E8EFC141FBECAA6287C59474E6BC05D99B2964FA090C3A2233BA186515BE7ED1F612970CEE2D7AFB81BDD762170481CD0069127D5B05AA993B4EA988D8FDDC186FFB7DC90A6C08F4DF435C93402849236C3FAB4D27C7026C1D4DCB2602646DEC9751E763DBA37BDF8FF9406AD9E530EE5DB382F413001AEB06A53ED9027D831179727B0865A8918DA3EDBEBCF9B14ED44CE6CBACED4BB1BDB7F1447E6CC254B332051512BD7AF426FB8F401378CD2BF5983CA01C64B92ECF032EA15D1721D03F482D7CE6E74FEF6D55E702F46980C82B5A84031900B1C9E59E7C97FBEC7E8F323A97A7E36CC88BE0F1D45B7FF585AC54BD407B22B4154AACC8F6D7EBF48E1D814CC5ED20F8037E0A79715EEF29BE32806A1D58BB7C5DA76F550AA3D8A1FBFF0EB19CCB1A313D55CDA56C9EC2EF29632387FE8D76E3C0468043E8F663F4860EE12BF2D5B0B7474D6E694F91E6DBE115974A3926F12FEE5E438777CB6A932DF8CD8BEC4D073B931BA3BC832B68D9DD300741FA7BF8AFC47ED2576F6936BA424663AAB639C5AE4F5683423B4742BF1C978238F16CBE39D652DE3FDB8BEFC848AD922222E04A4037C0713EB57A81A23F0C73473FC646CEA306B4BCBC8862F8385DDFA9D4B7FA2C087E879683303ED5BDD3A062B3CF5B3A278A66D2A13F83F44F82DDF310EE074AB6A364597E899A0255DC164F31CC50846851DF9AB48195DED7EA1B1D510BD7EE74D73FAF36BC31ECFA268359046F4EB879F924009438B481C6CD7889A002ED5EE382BC9190DA6FC026E479558E4475677E9AA9E3050E2765694DFC81F56E880B96E7160C980DD98EDD3DFFFFFFFFFFFFFFFFF)]
+
+def P_hash(hashModule, secret, seed, length):
+ bytes = createByteArrayZeros(length)
+ secret = bytesToString(secret)
+ seed = bytesToString(seed)
+ A = seed
+ index = 0
+ while 1:
+ A = hmac.HMAC(secret, A, hashModule).digest()
+ output = hmac.HMAC(secret, A+seed, hashModule).digest()
+ for c in output:
+ if index >= length:
+ return bytes
+ bytes[index] = ord(c)
+ index += 1
+ return bytes
+
+def PRF(secret, label, seed, length):
+ #Split the secret into left and right halves
+ S1 = secret[ : int(math.ceil(len(secret)/2.0))]
+ S2 = secret[ int(math.floor(len(secret)/2.0)) : ]
+
+ #Run the left half through P_MD5 and the right half through P_SHA1
+ p_md5 = P_hash(md5, S1, concatArrays(stringToBytes(label), seed), length)
+ p_sha1 = P_hash(sha, S2, concatArrays(stringToBytes(label), seed), length)
+
+ #XOR the output values and return the result
+ for x in range(length):
+ p_md5[x] ^= p_sha1[x]
+ return p_md5
+
+
+def PRF_SSL(secret, seed, length):
+ secretStr = bytesToString(secret)
+ seedStr = bytesToString(seed)
+ bytes = createByteArrayZeros(length)
+ index = 0
+ for x in range(26):
+ A = chr(ord('A')+x) * (x+1) # 'A', 'BB', 'CCC', etc..
+ input = secretStr + sha.sha(A + secretStr + seedStr).digest()
+ output = md5.md5(input).digest()
+ for c in output:
+ if index >= length:
+ return bytes
+ bytes[index] = ord(c)
+ index += 1
+ return bytes
+
+def makeX(salt, username, password):
+ if len(username)>=256:
+ raise ValueError("username too long")
+ if len(salt)>=256:
+ raise ValueError("salt too long")
+ return stringToNumber(sha.sha(salt + sha.sha(username + ":" + password)\
+ .digest()).digest())
+
+#This function is used by VerifierDB.makeVerifier
+def makeVerifier(username, password, bits):
+ bitsIndex = {1024:0, 1536:1, 2048:2, 3072:3, 4096:4, 6144:5, 8192:6}[bits]
+ g,N = goodGroupParameters[bitsIndex]
+ salt = bytesToString(getRandomBytes(16))
+ x = makeX(salt, username, password)
+ verifier = powMod(g, x, N)
+ return N, g, salt, verifier
+
+def PAD(n, x):
+ nLength = len(numberToString(n))
+ s = numberToString(x)
+ if len(s) < nLength:
+ s = ("\0" * (nLength-len(s))) + s
+ return s
+
+def makeU(N, A, B):
+ return stringToNumber(sha.sha(PAD(N, A) + PAD(N, B)).digest())
+
+def makeK(N, g):
+ return stringToNumber(sha.sha(numberToString(N) + PAD(N, g)).digest())
+
+
+"""
+MAC_SSL
+Modified from Python HMAC by Trevor
+"""
+
+class MAC_SSL:
+ """MAC_SSL class.
+
+ This supports the API for Cryptographic Hash Functions (PEP 247).
+ """
+
+ def __init__(self, key, msg = None, digestmod = None):
+ """Create a new MAC_SSL object.
+
+ key: key for the keyed hash object.
+ msg: Initial input for the hash, if provided.
+ digestmod: A module supporting PEP 247. Defaults to the md5 module.
+ """
+ if digestmod is None:
+ import md5
+ digestmod = md5
+
+ if key == None: #TREVNEW - for faster copying
+ return #TREVNEW
+
+ self.digestmod = digestmod
+ self.outer = digestmod.new()
+ self.inner = digestmod.new()
+ self.digest_size = digestmod.digest_size
+
+ ipad = "\x36" * 40
+ opad = "\x5C" * 40
+
+ self.inner.update(key)
+ self.inner.update(ipad)
+ self.outer.update(key)
+ self.outer.update(opad)
+ if msg is not None:
+ self.update(msg)
+
+
+ def update(self, msg):
+ """Update this hashing object with the string msg.
+ """
+ self.inner.update(msg)
+
+ def copy(self):
+ """Return a separate copy of this hashing object.
+
+ An update to this copy won't affect the original object.
+ """
+ other = MAC_SSL(None) #TREVNEW - for faster copying
+ other.digest_size = self.digest_size #TREVNEW
+ other.digestmod = self.digestmod
+ other.inner = self.inner.copy()
+ other.outer = self.outer.copy()
+ return other
+
+ def digest(self):
+ """Return the hash value of this hashing object.
+
+ This returns a string containing 8-bit data. The object is
+ not altered in any way by this function; you can continue
+ updating the object after calling this function.
+ """
+ h = self.outer.copy()
+ h.update(self.inner.digest())
+ return h.digest()
+
+ def hexdigest(self):
+ """Like digest(), but returns a string of hexadecimal digits instead.
+ """
+ return "".join([hex(ord(x))[2:].zfill(2)
+ for x in tuple(self.digest())])
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/messages.py b/samples/apps/marketplace_sample/gdata/tlslite/messages.py
new file mode 100755
index 0000000..afccc79
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/messages.py
@@ -0,0 +1,561 @@
+"""Classes representing TLS messages."""
+
+from utils.compat import *
+from utils.cryptomath import *
+from errors import *
+from utils.codec import *
+from constants import *
+from X509 import X509
+from X509CertChain import X509CertChain
+
+import sha
+import md5
+
+class RecordHeader3:
+ def __init__(self):
+ self.type = 0
+ self.version = (0,0)
+ self.length = 0
+ self.ssl2 = False
+
+ def create(self, version, type, length):
+ self.type = type
+ self.version = version
+ self.length = length
+ return self
+
+ def write(self):
+ w = Writer(5)
+ w.add(self.type, 1)
+ w.add(self.version[0], 1)
+ w.add(self.version[1], 1)
+ w.add(self.length, 2)
+ return w.bytes
+
+ def parse(self, p):
+ self.type = p.get(1)
+ self.version = (p.get(1), p.get(1))
+ self.length = p.get(2)
+ self.ssl2 = False
+ return self
+
+class RecordHeader2:
+ def __init__(self):
+ self.type = 0
+ self.version = (0,0)
+ self.length = 0
+ self.ssl2 = True
+
+ def parse(self, p):
+ if p.get(1)!=128:
+ raise SyntaxError()
+ self.type = ContentType.handshake
+ self.version = (2,0)
+ #We don't support 2-byte-length-headers; could be a problem
+ self.length = p.get(1)
+ return self
+
+
+class Msg:
+ def preWrite(self, trial):
+ if trial:
+ w = Writer()
+ else:
+ length = self.write(True)
+ w = Writer(length)
+ return w
+
+ def postWrite(self, w, trial):
+ if trial:
+ return w.index
+ else:
+ return w.bytes
+
+class Alert(Msg):
+ def __init__(self):
+ self.contentType = ContentType.alert
+ self.level = 0
+ self.description = 0
+
+ def create(self, description, level=AlertLevel.fatal):
+ self.level = level
+ self.description = description
+ return self
+
+ def parse(self, p):
+ p.setLengthCheck(2)
+ self.level = p.get(1)
+ self.description = p.get(1)
+ p.stopLengthCheck()
+ return self
+
+ def write(self):
+ w = Writer(2)
+ w.add(self.level, 1)
+ w.add(self.description, 1)
+ return w.bytes
+
+
+class HandshakeMsg(Msg):
+ def preWrite(self, handshakeType, trial):
+ if trial:
+ w = Writer()
+ w.add(handshakeType, 1)
+ w.add(0, 3)
+ else:
+ length = self.write(True)
+ w = Writer(length)
+ w.add(handshakeType, 1)
+ w.add(length-4, 3)
+ return w
+
+
+class ClientHello(HandshakeMsg):
+ def __init__(self, ssl2=False):
+ self.contentType = ContentType.handshake
+ self.ssl2 = ssl2
+ self.client_version = (0,0)
+ self.random = createByteArrayZeros(32)
+ self.session_id = createByteArraySequence([])
+ self.cipher_suites = [] # a list of 16-bit values
+ self.certificate_types = [CertificateType.x509]
+ self.compression_methods = [] # a list of 8-bit values
+ self.srp_username = None # a string
+
+ def create(self, version, random, session_id, cipher_suites,
+ certificate_types=None, srp_username=None):
+ self.client_version = version
+ self.random = random
+ self.session_id = session_id
+ self.cipher_suites = cipher_suites
+ self.certificate_types = certificate_types
+ self.compression_methods = [0]
+ self.srp_username = srp_username
+ return self
+
+ def parse(self, p):
+ if self.ssl2:
+ self.client_version = (p.get(1), p.get(1))
+ cipherSpecsLength = p.get(2)
+ sessionIDLength = p.get(2)
+ randomLength = p.get(2)
+ self.cipher_suites = p.getFixList(3, int(cipherSpecsLength/3))
+ self.session_id = p.getFixBytes(sessionIDLength)
+ self.random = p.getFixBytes(randomLength)
+ if len(self.random) < 32:
+ zeroBytes = 32-len(self.random)
+ self.random = createByteArrayZeros(zeroBytes) + self.random
+ self.compression_methods = [0]#Fake this value
+
+ #We're not doing a stopLengthCheck() for SSLv2, oh well..
+ else:
+ p.startLengthCheck(3)
+ self.client_version = (p.get(1), p.get(1))
+ self.random = p.getFixBytes(32)
+ self.session_id = p.getVarBytes(1)
+ self.cipher_suites = p.getVarList(2, 2)
+ self.compression_methods = p.getVarList(1, 1)
+ if not p.atLengthCheck():
+ totalExtLength = p.get(2)
+ soFar = 0
+ while soFar != totalExtLength:
+ extType = p.get(2)
+ extLength = p.get(2)
+ if extType == 6:
+ self.srp_username = bytesToString(p.getVarBytes(1))
+ elif extType == 7:
+ self.certificate_types = p.getVarList(1, 1)
+ else:
+ p.getFixBytes(extLength)
+ soFar += 4 + extLength
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.client_hello, trial)
+ w.add(self.client_version[0], 1)
+ w.add(self.client_version[1], 1)
+ w.addFixSeq(self.random, 1)
+ w.addVarSeq(self.session_id, 1, 1)
+ w.addVarSeq(self.cipher_suites, 2, 2)
+ w.addVarSeq(self.compression_methods, 1, 1)
+
+ extLength = 0
+ if self.certificate_types and self.certificate_types != \
+ [CertificateType.x509]:
+ extLength += 5 + len(self.certificate_types)
+ if self.srp_username:
+ extLength += 5 + len(self.srp_username)
+ if extLength > 0:
+ w.add(extLength, 2)
+
+ if self.certificate_types and self.certificate_types != \
+ [CertificateType.x509]:
+ w.add(7, 2)
+ w.add(len(self.certificate_types)+1, 2)
+ w.addVarSeq(self.certificate_types, 1, 1)
+ if self.srp_username:
+ w.add(6, 2)
+ w.add(len(self.srp_username)+1, 2)
+ w.addVarSeq(stringToBytes(self.srp_username), 1, 1)
+
+ return HandshakeMsg.postWrite(self, w, trial)
+
+
+class ServerHello(HandshakeMsg):
+ def __init__(self):
+ self.contentType = ContentType.handshake
+ self.server_version = (0,0)
+ self.random = createByteArrayZeros(32)
+ self.session_id = createByteArraySequence([])
+ self.cipher_suite = 0
+ self.certificate_type = CertificateType.x509
+ self.compression_method = 0
+
+ def create(self, version, random, session_id, cipher_suite,
+ certificate_type):
+ self.server_version = version
+ self.random = random
+ self.session_id = session_id
+ self.cipher_suite = cipher_suite
+ self.certificate_type = certificate_type
+ self.compression_method = 0
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ self.server_version = (p.get(1), p.get(1))
+ self.random = p.getFixBytes(32)
+ self.session_id = p.getVarBytes(1)
+ self.cipher_suite = p.get(2)
+ self.compression_method = p.get(1)
+ if not p.atLengthCheck():
+ totalExtLength = p.get(2)
+ soFar = 0
+ while soFar != totalExtLength:
+ extType = p.get(2)
+ extLength = p.get(2)
+ if extType == 7:
+ self.certificate_type = p.get(1)
+ else:
+ p.getFixBytes(extLength)
+ soFar += 4 + extLength
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.server_hello, trial)
+ w.add(self.server_version[0], 1)
+ w.add(self.server_version[1], 1)
+ w.addFixSeq(self.random, 1)
+ w.addVarSeq(self.session_id, 1, 1)
+ w.add(self.cipher_suite, 2)
+ w.add(self.compression_method, 1)
+
+ extLength = 0
+ if self.certificate_type and self.certificate_type != \
+ CertificateType.x509:
+ extLength += 5
+
+ if extLength != 0:
+ w.add(extLength, 2)
+
+ if self.certificate_type and self.certificate_type != \
+ CertificateType.x509:
+ w.add(7, 2)
+ w.add(1, 2)
+ w.add(self.certificate_type, 1)
+
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class Certificate(HandshakeMsg):
+ def __init__(self, certificateType):
+ self.certificateType = certificateType
+ self.contentType = ContentType.handshake
+ self.certChain = None
+
+ def create(self, certChain):
+ self.certChain = certChain
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ if self.certificateType == CertificateType.x509:
+ chainLength = p.get(3)
+ index = 0
+ certificate_list = []
+ while index != chainLength:
+ certBytes = p.getVarBytes(3)
+ x509 = X509()
+ x509.parseBinary(certBytes)
+ certificate_list.append(x509)
+ index += len(certBytes)+3
+ if certificate_list:
+ self.certChain = X509CertChain(certificate_list)
+ elif self.certificateType == CertificateType.cryptoID:
+ s = bytesToString(p.getVarBytes(2))
+ if s:
+ try:
+ import cryptoIDlib.CertChain
+ except ImportError:
+ raise SyntaxError(\
+ "cryptoID cert chain received, cryptoIDlib not present")
+ self.certChain = cryptoIDlib.CertChain.CertChain().parse(s)
+ else:
+ raise AssertionError()
+
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.certificate, trial)
+ if self.certificateType == CertificateType.x509:
+ chainLength = 0
+ if self.certChain:
+ certificate_list = self.certChain.x509List
+ else:
+ certificate_list = []
+ #determine length
+ for cert in certificate_list:
+ bytes = cert.writeBytes()
+ chainLength += len(bytes)+3
+ #add bytes
+ w.add(chainLength, 3)
+ for cert in certificate_list:
+ bytes = cert.writeBytes()
+ w.addVarSeq(bytes, 1, 3)
+ elif self.certificateType == CertificateType.cryptoID:
+ if self.certChain:
+ bytes = stringToBytes(self.certChain.write())
+ else:
+ bytes = createByteArraySequence([])
+ w.addVarSeq(bytes, 1, 2)
+ else:
+ raise AssertionError()
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class CertificateRequest(HandshakeMsg):
+ def __init__(self):
+ self.contentType = ContentType.handshake
+ self.certificate_types = []
+ #treat as opaque bytes for now
+ self.certificate_authorities = createByteArraySequence([])
+
+ def create(self, certificate_types, certificate_authorities):
+ self.certificate_types = certificate_types
+ self.certificate_authorities = certificate_authorities
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ self.certificate_types = p.getVarList(1, 1)
+ self.certificate_authorities = p.getVarBytes(2)
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.certificate_request,
+ trial)
+ w.addVarSeq(self.certificate_types, 1, 1)
+ w.addVarSeq(self.certificate_authorities, 1, 2)
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class ServerKeyExchange(HandshakeMsg):
+ def __init__(self, cipherSuite):
+ self.cipherSuite = cipherSuite
+ self.contentType = ContentType.handshake
+ self.srp_N = 0L
+ self.srp_g = 0L
+ self.srp_s = createByteArraySequence([])
+ self.srp_B = 0L
+ self.signature = createByteArraySequence([])
+
+ def createSRP(self, srp_N, srp_g, srp_s, srp_B):
+ self.srp_N = srp_N
+ self.srp_g = srp_g
+ self.srp_s = srp_s
+ self.srp_B = srp_B
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ self.srp_N = bytesToNumber(p.getVarBytes(2))
+ self.srp_g = bytesToNumber(p.getVarBytes(2))
+ self.srp_s = p.getVarBytes(1)
+ self.srp_B = bytesToNumber(p.getVarBytes(2))
+ if self.cipherSuite in CipherSuite.srpRsaSuites:
+ self.signature = p.getVarBytes(2)
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.server_key_exchange,
+ trial)
+ w.addVarSeq(numberToBytes(self.srp_N), 1, 2)
+ w.addVarSeq(numberToBytes(self.srp_g), 1, 2)
+ w.addVarSeq(self.srp_s, 1, 1)
+ w.addVarSeq(numberToBytes(self.srp_B), 1, 2)
+ if self.cipherSuite in CipherSuite.srpRsaSuites:
+ w.addVarSeq(self.signature, 1, 2)
+ return HandshakeMsg.postWrite(self, w, trial)
+
+ def hash(self, clientRandom, serverRandom):
+ oldCipherSuite = self.cipherSuite
+ self.cipherSuite = None
+ try:
+ bytes = clientRandom + serverRandom + self.write()[4:]
+ s = bytesToString(bytes)
+ return stringToBytes(md5.md5(s).digest() + sha.sha(s).digest())
+ finally:
+ self.cipherSuite = oldCipherSuite
+
+class ServerHelloDone(HandshakeMsg):
+ def __init__(self):
+ self.contentType = ContentType.handshake
+
+ def create(self):
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.server_hello_done, trial)
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class ClientKeyExchange(HandshakeMsg):
+ def __init__(self, cipherSuite, version=None):
+ self.cipherSuite = cipherSuite
+ self.version = version
+ self.contentType = ContentType.handshake
+ self.srp_A = 0
+ self.encryptedPreMasterSecret = createByteArraySequence([])
+
+ def createSRP(self, srp_A):
+ self.srp_A = srp_A
+ return self
+
+ def createRSA(self, encryptedPreMasterSecret):
+ self.encryptedPreMasterSecret = encryptedPreMasterSecret
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ if self.cipherSuite in CipherSuite.srpSuites + \
+ CipherSuite.srpRsaSuites:
+ self.srp_A = bytesToNumber(p.getVarBytes(2))
+ elif self.cipherSuite in CipherSuite.rsaSuites:
+ if self.version in ((3,1), (3,2)):
+ self.encryptedPreMasterSecret = p.getVarBytes(2)
+ elif self.version == (3,0):
+ self.encryptedPreMasterSecret = \
+ p.getFixBytes(len(p.bytes)-p.index)
+ else:
+ raise AssertionError()
+ else:
+ raise AssertionError()
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.client_key_exchange,
+ trial)
+ if self.cipherSuite in CipherSuite.srpSuites + \
+ CipherSuite.srpRsaSuites:
+ w.addVarSeq(numberToBytes(self.srp_A), 1, 2)
+ elif self.cipherSuite in CipherSuite.rsaSuites:
+ if self.version in ((3,1), (3,2)):
+ w.addVarSeq(self.encryptedPreMasterSecret, 1, 2)
+ elif self.version == (3,0):
+ w.addFixSeq(self.encryptedPreMasterSecret, 1)
+ else:
+ raise AssertionError()
+ else:
+ raise AssertionError()
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class CertificateVerify(HandshakeMsg):
+ def __init__(self):
+ self.contentType = ContentType.handshake
+ self.signature = createByteArraySequence([])
+
+ def create(self, signature):
+ self.signature = signature
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ self.signature = p.getVarBytes(2)
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.certificate_verify,
+ trial)
+ w.addVarSeq(self.signature, 1, 2)
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class ChangeCipherSpec(Msg):
+ def __init__(self):
+ self.contentType = ContentType.change_cipher_spec
+ self.type = 1
+
+ def create(self):
+ self.type = 1
+ return self
+
+ def parse(self, p):
+ p.setLengthCheck(1)
+ self.type = p.get(1)
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = Msg.preWrite(self, trial)
+ w.add(self.type,1)
+ return Msg.postWrite(self, w, trial)
+
+
+class Finished(HandshakeMsg):
+ def __init__(self, version):
+ self.contentType = ContentType.handshake
+ self.version = version
+ self.verify_data = createByteArraySequence([])
+
+ def create(self, verify_data):
+ self.verify_data = verify_data
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ if self.version == (3,0):
+ self.verify_data = p.getFixBytes(36)
+ elif self.version in ((3,1), (3,2)):
+ self.verify_data = p.getFixBytes(12)
+ else:
+ raise AssertionError()
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.finished, trial)
+ w.addFixSeq(self.verify_data, 1)
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class ApplicationData(Msg):
+ def __init__(self):
+ self.contentType = ContentType.application_data
+ self.bytes = createByteArraySequence([])
+
+ def create(self, bytes):
+ self.bytes = bytes
+ return self
+
+ def parse(self, p):
+ self.bytes = p.bytes
+ return self
+
+ def write(self):
+ return self.bytes
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/AES.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/AES.py
new file mode 100755
index 0000000..8413f4c
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/AES.py
@@ -0,0 +1,31 @@
+"""Abstract class for AES."""
+
+class AES:
+ def __init__(self, key, mode, IV, implementation):
+ if len(key) not in (16, 24, 32):
+ raise AssertionError()
+ if mode != 2:
+ raise AssertionError()
+ if len(IV) != 16:
+ raise AssertionError()
+ self.isBlockCipher = True
+ self.block_size = 16
+ self.implementation = implementation
+ if len(key)==16:
+ self.name = "aes128"
+ elif len(key)==24:
+ self.name = "aes192"
+ elif len(key)==32:
+ self.name = "aes256"
+ else:
+ raise AssertionError()
+
+ #CBC-Mode encryption, returns ciphertext
+ #WARNING: *MAY* modify the input as well
+ def encrypt(self, plaintext):
+ assert(len(plaintext) % 16 == 0)
+
+ #CBC-Mode decryption, returns plaintext
+ #WARNING: *MAY* modify the input as well
+ def decrypt(self, ciphertext):
+ assert(len(ciphertext) % 16 == 0)
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/ASN1Parser.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/ASN1Parser.py
new file mode 100755
index 0000000..16b50f2
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/ASN1Parser.py
@@ -0,0 +1,34 @@
+"""Class for parsing ASN.1"""
+from compat import *
+from codec import *
+
+#Takes a byte array which has a DER TLV field at its head
+class ASN1Parser:
+ def __init__(self, bytes):
+ p = Parser(bytes)
+ p.get(1) #skip Type
+
+ #Get Length
+ self.length = self._getASN1Length(p)
+
+ #Get Value
+ self.value = p.getFixBytes(self.length)
+
+ #Assuming this is a sequence...
+ def getChild(self, which):
+ p = Parser(self.value)
+ for x in range(which+1):
+ markIndex = p.index
+ p.get(1) #skip Type
+ length = self._getASN1Length(p)
+ p.getFixBytes(length)
+ return ASN1Parser(p.bytes[markIndex : p.index])
+
+ #Decode the ASN.1 DER length field
+ def _getASN1Length(self, p):
+ firstLength = p.get(1)
+ if firstLength<=127:
+ return firstLength
+ else:
+ lengthLength = firstLength & 0x7F
+ return p.get(lengthLength)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_AES.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_AES.py
new file mode 100755
index 0000000..9e101fc
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_AES.py
@@ -0,0 +1,34 @@
+"""Cryptlib AES implementation."""
+
+from cryptomath import *
+from AES import *
+
+if cryptlibpyLoaded:
+
+ def new(key, mode, IV):
+ return Cryptlib_AES(key, mode, IV)
+
+ class Cryptlib_AES(AES):
+
+ def __init__(self, key, mode, IV):
+ AES.__init__(self, key, mode, IV, "cryptlib")
+ self.context = cryptlib_py.cryptCreateContext(cryptlib_py.CRYPT_UNUSED, cryptlib_py.CRYPT_ALGO_AES)
+ cryptlib_py.cryptSetAttribute(self.context, cryptlib_py.CRYPT_CTXINFO_MODE, cryptlib_py.CRYPT_MODE_CBC)
+ cryptlib_py.cryptSetAttribute(self.context, cryptlib_py.CRYPT_CTXINFO_KEYSIZE, len(key))
+ cryptlib_py.cryptSetAttributeString(self.context, cryptlib_py.CRYPT_CTXINFO_KEY, key)
+ cryptlib_py.cryptSetAttributeString(self.context, cryptlib_py.CRYPT_CTXINFO_IV, IV)
+
+ def __del__(self):
+ cryptlib_py.cryptDestroyContext(self.context)
+
+ def encrypt(self, plaintext):
+ AES.encrypt(self, plaintext)
+ bytes = stringToBytes(plaintext)
+ cryptlib_py.cryptEncrypt(self.context, bytes)
+ return bytesToString(bytes)
+
+ def decrypt(self, ciphertext):
+ AES.decrypt(self, ciphertext)
+ bytes = stringToBytes(ciphertext)
+ cryptlib_py.cryptDecrypt(self.context, bytes)
+ return bytesToString(bytes)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_RC4.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_RC4.py
new file mode 100755
index 0000000..7c6d087
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_RC4.py
@@ -0,0 +1,28 @@
+"""Cryptlib RC4 implementation."""
+
+from cryptomath import *
+from RC4 import RC4
+
+if cryptlibpyLoaded:
+
+ def new(key):
+ return Cryptlib_RC4(key)
+
+ class Cryptlib_RC4(RC4):
+
+ def __init__(self, key):
+ RC4.__init__(self, key, "cryptlib")
+ self.context = cryptlib_py.cryptCreateContext(cryptlib_py.CRYPT_UNUSED, cryptlib_py.CRYPT_ALGO_RC4)
+ cryptlib_py.cryptSetAttribute(self.context, cryptlib_py.CRYPT_CTXINFO_KEYSIZE, len(key))
+ cryptlib_py.cryptSetAttributeString(self.context, cryptlib_py.CRYPT_CTXINFO_KEY, key)
+
+ def __del__(self):
+ cryptlib_py.cryptDestroyContext(self.context)
+
+ def encrypt(self, plaintext):
+ bytes = stringToBytes(plaintext)
+ cryptlib_py.cryptEncrypt(self.context, bytes)
+ return bytesToString(bytes)
+
+ def decrypt(self, ciphertext):
+ return self.encrypt(ciphertext)
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_TripleDES.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_TripleDES.py
new file mode 100755
index 0000000..a4f8155
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/Cryptlib_TripleDES.py
@@ -0,0 +1,35 @@
+"""Cryptlib 3DES implementation."""
+
+from cryptomath import *
+
+from TripleDES import *
+
+if cryptlibpyLoaded:
+
+ def new(key, mode, IV):
+ return Cryptlib_TripleDES(key, mode, IV)
+
+ class Cryptlib_TripleDES(TripleDES):
+
+ def __init__(self, key, mode, IV):
+ TripleDES.__init__(self, key, mode, IV, "cryptlib")
+ self.context = cryptlib_py.cryptCreateContext(cryptlib_py.CRYPT_UNUSED, cryptlib_py.CRYPT_ALGO_3DES)
+ cryptlib_py.cryptSetAttribute(self.context, cryptlib_py.CRYPT_CTXINFO_MODE, cryptlib_py.CRYPT_MODE_CBC)
+ cryptlib_py.cryptSetAttribute(self.context, cryptlib_py.CRYPT_CTXINFO_KEYSIZE, len(key))
+ cryptlib_py.cryptSetAttributeString(self.context, cryptlib_py.CRYPT_CTXINFO_KEY, key)
+ cryptlib_py.cryptSetAttributeString(self.context, cryptlib_py.CRYPT_CTXINFO_IV, IV)
+
+ def __del__(self):
+ cryptlib_py.cryptDestroyContext(self.context)
+
+ def encrypt(self, plaintext):
+ TripleDES.encrypt(self, plaintext)
+ bytes = stringToBytes(plaintext)
+ cryptlib_py.cryptEncrypt(self.context, bytes)
+ return bytesToString(bytes)
+
+ def decrypt(self, ciphertext):
+ TripleDES.decrypt(self, ciphertext)
+ bytes = stringToBytes(ciphertext)
+ cryptlib_py.cryptDecrypt(self.context, bytes)
+ return bytesToString(bytes)
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_AES.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_AES.py
new file mode 100755
index 0000000..e60679b
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_AES.py
@@ -0,0 +1,49 @@
+"""OpenSSL/M2Crypto AES implementation."""
+
+from cryptomath import *
+from AES import *
+
+if m2cryptoLoaded:
+
+ def new(key, mode, IV):
+ return OpenSSL_AES(key, mode, IV)
+
+ class OpenSSL_AES(AES):
+
+ def __init__(self, key, mode, IV):
+ AES.__init__(self, key, mode, IV, "openssl")
+ self.key = key
+ self.IV = IV
+
+ def _createContext(self, encrypt):
+ context = m2.cipher_ctx_new()
+ if len(self.key)==16:
+ cipherType = m2.aes_128_cbc()
+ if len(self.key)==24:
+ cipherType = m2.aes_192_cbc()
+ if len(self.key)==32:
+ cipherType = m2.aes_256_cbc()
+ m2.cipher_init(context, cipherType, self.key, self.IV, encrypt)
+ return context
+
+ def encrypt(self, plaintext):
+ AES.encrypt(self, plaintext)
+ context = self._createContext(1)
+ ciphertext = m2.cipher_update(context, plaintext)
+ m2.cipher_ctx_free(context)
+ self.IV = ciphertext[-self.block_size:]
+ return ciphertext
+
+ def decrypt(self, ciphertext):
+ AES.decrypt(self, ciphertext)
+ context = self._createContext(0)
+ #I think M2Crypto has a bug - it fails to decrypt and return the last block passed in.
+ #To work around this, we append sixteen zeros to the string, below:
+ plaintext = m2.cipher_update(context, ciphertext+('\0'*16))
+
+ #If this bug is ever fixed, then plaintext will end up having a garbage
+ #plaintext block on the end. That's okay - the below code will discard it.
+ plaintext = plaintext[:len(ciphertext)]
+ m2.cipher_ctx_free(context)
+ self.IV = ciphertext[-self.block_size:]
+ return plaintext
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_RC4.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_RC4.py
new file mode 100755
index 0000000..ac433aa
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_RC4.py
@@ -0,0 +1,25 @@
+"""OpenSSL/M2Crypto RC4 implementation."""
+
+from cryptomath import *
+from RC4 import RC4
+
+if m2cryptoLoaded:
+
+ def new(key):
+ return OpenSSL_RC4(key)
+
+ class OpenSSL_RC4(RC4):
+
+ def __init__(self, key):
+ RC4.__init__(self, key, "openssl")
+ self.rc4 = m2.rc4_new()
+ m2.rc4_set_key(self.rc4, key)
+
+ def __del__(self):
+ m2.rc4_free(self.rc4)
+
+ def encrypt(self, plaintext):
+ return m2.rc4_update(self.rc4, plaintext)
+
+ def decrypt(self, ciphertext):
+ return self.encrypt(ciphertext)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_RSAKey.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_RSAKey.py
new file mode 100755
index 0000000..fe1a3cd
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_RSAKey.py
@@ -0,0 +1,148 @@
+"""OpenSSL/M2Crypto RSA implementation."""
+
+from cryptomath import *
+
+from RSAKey import *
+from Python_RSAKey import Python_RSAKey
+
+#copied from M2Crypto.util.py, so when we load the local copy of m2
+#we can still use it
+def password_callback(v, prompt1='Enter private key passphrase:',
+ prompt2='Verify passphrase:'):
+ from getpass import getpass
+ while 1:
+ try:
+ p1=getpass(prompt1)
+ if v:
+ p2=getpass(prompt2)
+ if p1==p2:
+ break
+ else:
+ break
+ except KeyboardInterrupt:
+ return None
+ return p1
+
+
+if m2cryptoLoaded:
+ class OpenSSL_RSAKey(RSAKey):
+ def __init__(self, n=0, e=0):
+ self.rsa = None
+ self._hasPrivateKey = False
+ if (n and not e) or (e and not n):
+ raise AssertionError()
+ if n and e:
+ self.rsa = m2.rsa_new()
+ m2.rsa_set_n(self.rsa, numberToMPI(n))
+ m2.rsa_set_e(self.rsa, numberToMPI(e))
+
+ def __del__(self):
+ if self.rsa:
+ m2.rsa_free(self.rsa)
+
+ def __getattr__(self, name):
+ if name == 'e':
+ if not self.rsa:
+ return 0
+ return mpiToNumber(m2.rsa_get_e(self.rsa))
+ elif name == 'n':
+ if not self.rsa:
+ return 0
+ return mpiToNumber(m2.rsa_get_n(self.rsa))
+ else:
+ raise AttributeError
+
+ def hasPrivateKey(self):
+ return self._hasPrivateKey
+
+ def hash(self):
+ return Python_RSAKey(self.n, self.e).hash()
+
+ def _rawPrivateKeyOp(self, m):
+ s = numberToString(m)
+ byteLength = numBytes(self.n)
+ if len(s)== byteLength:
+ pass
+ elif len(s) == byteLength-1:
+ s = '\0' + s
+ else:
+ raise AssertionError()
+ c = stringToNumber(m2.rsa_private_encrypt(self.rsa, s,
+ m2.no_padding))
+ return c
+
+ def _rawPublicKeyOp(self, c):
+ s = numberToString(c)
+ byteLength = numBytes(self.n)
+ if len(s)== byteLength:
+ pass
+ elif len(s) == byteLength-1:
+ s = '\0' + s
+ else:
+ raise AssertionError()
+ m = stringToNumber(m2.rsa_public_decrypt(self.rsa, s,
+ m2.no_padding))
+ return m
+
+ def acceptsPassword(self): return True
+
+ def write(self, password=None):
+ bio = m2.bio_new(m2.bio_s_mem())
+ if self._hasPrivateKey:
+ if password:
+ def f(v): return password
+ m2.rsa_write_key(self.rsa, bio, m2.des_ede_cbc(), f)
+ else:
+ def f(): pass
+ m2.rsa_write_key_no_cipher(self.rsa, bio, f)
+ else:
+ if password:
+ raise AssertionError()
+ m2.rsa_write_pub_key(self.rsa, bio)
+ s = m2.bio_read(bio, m2.bio_ctrl_pending(bio))
+ m2.bio_free(bio)
+ return s
+
+ def writeXMLPublicKey(self, indent=''):
+ return Python_RSAKey(self.n, self.e).write(indent)
+
+ def generate(bits):
+ key = OpenSSL_RSAKey()
+ def f():pass
+ key.rsa = m2.rsa_generate_key(bits, 3, f)
+ key._hasPrivateKey = True
+ return key
+ generate = staticmethod(generate)
+
+ def parse(s, passwordCallback=None):
+ if s.startswith("-----BEGIN "):
+ if passwordCallback==None:
+ callback = password_callback
+ else:
+ def f(v, prompt1=None, prompt2=None):
+ return passwordCallback()
+ callback = f
+ bio = m2.bio_new(m2.bio_s_mem())
+ try:
+ m2.bio_write(bio, s)
+ key = OpenSSL_RSAKey()
+ if s.startswith("-----BEGIN RSA PRIVATE KEY-----"):
+ def f():pass
+ key.rsa = m2.rsa_read_key(bio, callback)
+ if key.rsa == None:
+ raise SyntaxError()
+ key._hasPrivateKey = True
+ elif s.startswith("-----BEGIN PUBLIC KEY-----"):
+ key.rsa = m2.rsa_read_pub_key(bio)
+ if key.rsa == None:
+ raise SyntaxError()
+ key._hasPrivateKey = False
+ else:
+ raise SyntaxError()
+ return key
+ finally:
+ m2.bio_free(bio)
+ else:
+ raise SyntaxError()
+
+ parse = staticmethod(parse)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_TripleDES.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_TripleDES.py
new file mode 100755
index 0000000..f5ba165
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/OpenSSL_TripleDES.py
@@ -0,0 +1,44 @@
+"""OpenSSL/M2Crypto 3DES implementation."""
+
+from cryptomath import *
+from TripleDES import *
+
+if m2cryptoLoaded:
+
+ def new(key, mode, IV):
+ return OpenSSL_TripleDES(key, mode, IV)
+
+ class OpenSSL_TripleDES(TripleDES):
+
+ def __init__(self, key, mode, IV):
+ TripleDES.__init__(self, key, mode, IV, "openssl")
+ self.key = key
+ self.IV = IV
+
+ def _createContext(self, encrypt):
+ context = m2.cipher_ctx_new()
+ cipherType = m2.des_ede3_cbc()
+ m2.cipher_init(context, cipherType, self.key, self.IV, encrypt)
+ return context
+
+ def encrypt(self, plaintext):
+ TripleDES.encrypt(self, plaintext)
+ context = self._createContext(1)
+ ciphertext = m2.cipher_update(context, plaintext)
+ m2.cipher_ctx_free(context)
+ self.IV = ciphertext[-self.block_size:]
+ return ciphertext
+
+ def decrypt(self, ciphertext):
+ TripleDES.decrypt(self, ciphertext)
+ context = self._createContext(0)
+ #I think M2Crypto has a bug - it fails to decrypt and return the last block passed in.
+ #To work around this, we append sixteen zeros to the string, below:
+ plaintext = m2.cipher_update(context, ciphertext+('\0'*16))
+
+ #If this bug is ever fixed, then plaintext will end up having a garbage
+ #plaintext block on the end. That's okay - the below code will ignore it.
+ plaintext = plaintext[:len(ciphertext)]
+ m2.cipher_ctx_free(context)
+ self.IV = ciphertext[-self.block_size:]
+ return plaintext
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_AES.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_AES.py
new file mode 100755
index 0000000..e38b19d
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_AES.py
@@ -0,0 +1,22 @@
+"""PyCrypto AES implementation."""
+
+from cryptomath import *
+from AES import *
+
+if pycryptoLoaded:
+ import Crypto.Cipher.AES
+
+ def new(key, mode, IV):
+ return PyCrypto_AES(key, mode, IV)
+
+ class PyCrypto_AES(AES):
+
+ def __init__(self, key, mode, IV):
+ AES.__init__(self, key, mode, IV, "pycrypto")
+ self.context = Crypto.Cipher.AES.new(key, mode, IV)
+
+ def encrypt(self, plaintext):
+ return self.context.encrypt(plaintext)
+
+ def decrypt(self, ciphertext):
+ return self.context.decrypt(ciphertext)
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_RC4.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_RC4.py
new file mode 100755
index 0000000..6c6d86a
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_RC4.py
@@ -0,0 +1,22 @@
+"""PyCrypto RC4 implementation."""
+
+from cryptomath import *
+from RC4 import *
+
+if pycryptoLoaded:
+ import Crypto.Cipher.ARC4
+
+ def new(key):
+ return PyCrypto_RC4(key)
+
+ class PyCrypto_RC4(RC4):
+
+ def __init__(self, key):
+ RC4.__init__(self, key, "pycrypto")
+ self.context = Crypto.Cipher.ARC4.new(key)
+
+ def encrypt(self, plaintext):
+ return self.context.encrypt(plaintext)
+
+ def decrypt(self, ciphertext):
+ return self.context.decrypt(ciphertext)
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_RSAKey.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_RSAKey.py
new file mode 100755
index 0000000..48b5cef
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_RSAKey.py
@@ -0,0 +1,61 @@
+"""PyCrypto RSA implementation."""
+
+from cryptomath import *
+
+from RSAKey import *
+from Python_RSAKey import Python_RSAKey
+
+if pycryptoLoaded:
+
+ from Crypto.PublicKey import RSA
+
+ class PyCrypto_RSAKey(RSAKey):
+ def __init__(self, n=0, e=0, d=0, p=0, q=0, dP=0, dQ=0, qInv=0):
+ if not d:
+ self.rsa = RSA.construct( (n, e) )
+ else:
+ self.rsa = RSA.construct( (n, e, d, p, q) )
+
+ def __getattr__(self, name):
+ return getattr(self.rsa, name)
+
+ def hasPrivateKey(self):
+ return self.rsa.has_private()
+
+ def hash(self):
+ return Python_RSAKey(self.n, self.e).hash()
+
+ def _rawPrivateKeyOp(self, m):
+ s = numberToString(m)
+ byteLength = numBytes(self.n)
+ if len(s)== byteLength:
+ pass
+ elif len(s) == byteLength-1:
+ s = '\0' + s
+ else:
+ raise AssertionError()
+ c = stringToNumber(self.rsa.decrypt((s,)))
+ return c
+
+ def _rawPublicKeyOp(self, c):
+ s = numberToString(c)
+ byteLength = numBytes(self.n)
+ if len(s)== byteLength:
+ pass
+ elif len(s) == byteLength-1:
+ s = '\0' + s
+ else:
+ raise AssertionError()
+ m = stringToNumber(self.rsa.encrypt(s, None)[0])
+ return m
+
+ def writeXMLPublicKey(self, indent=''):
+ return Python_RSAKey(self.n, self.e).write(indent)
+
+ def generate(bits):
+ key = PyCrypto_RSAKey()
+ def f(numBytes):
+ return bytesToString(getRandomBytes(numBytes))
+ key.rsa = RSA.generate(bits, f)
+ return key
+ generate = staticmethod(generate)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_TripleDES.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_TripleDES.py
new file mode 100755
index 0000000..8c22bb8
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/PyCrypto_TripleDES.py
@@ -0,0 +1,22 @@
+"""PyCrypto 3DES implementation."""
+
+from cryptomath import *
+from TripleDES import *
+
+if pycryptoLoaded:
+ import Crypto.Cipher.DES3
+
+ def new(key, mode, IV):
+ return PyCrypto_TripleDES(key, mode, IV)
+
+ class PyCrypto_TripleDES(TripleDES):
+
+ def __init__(self, key, mode, IV):
+ TripleDES.__init__(self, key, mode, IV, "pycrypto")
+ self.context = Crypto.Cipher.DES3.new(key, mode, IV)
+
+ def encrypt(self, plaintext):
+ return self.context.encrypt(plaintext)
+
+ def decrypt(self, ciphertext):
+ return self.context.decrypt(ciphertext)
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/Python_AES.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/Python_AES.py
new file mode 100755
index 0000000..657152f
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/Python_AES.py
@@ -0,0 +1,68 @@
+"""Pure-Python AES implementation."""
+
+from cryptomath import *
+
+from AES import *
+from rijndael import rijndael
+
+def new(key, mode, IV):
+ return Python_AES(key, mode, IV)
+
+class Python_AES(AES):
+ def __init__(self, key, mode, IV):
+ AES.__init__(self, key, mode, IV, "python")
+ self.rijndael = rijndael(key, 16)
+ self.IV = IV
+
+ def encrypt(self, plaintext):
+ AES.encrypt(self, plaintext)
+
+ plaintextBytes = stringToBytes(plaintext)
+ chainBytes = stringToBytes(self.IV)
+
+ #CBC Mode: For each block...
+ for x in range(len(plaintextBytes)/16):
+
+ #XOR with the chaining block
+ blockBytes = plaintextBytes[x*16 : (x*16)+16]
+ for y in range(16):
+ blockBytes[y] ^= chainBytes[y]
+ blockString = bytesToString(blockBytes)
+
+ #Encrypt it
+ encryptedBytes = stringToBytes(self.rijndael.encrypt(blockString))
+
+ #Overwrite the input with the output
+ for y in range(16):
+ plaintextBytes[(x*16)+y] = encryptedBytes[y]
+
+ #Set the next chaining block
+ chainBytes = encryptedBytes
+
+ self.IV = bytesToString(chainBytes)
+ return bytesToString(plaintextBytes)
+
+ def decrypt(self, ciphertext):
+ AES.decrypt(self, ciphertext)
+
+ ciphertextBytes = stringToBytes(ciphertext)
+ chainBytes = stringToBytes(self.IV)
+
+ #CBC Mode: For each block...
+ for x in range(len(ciphertextBytes)/16):
+
+ #Decrypt it
+ blockBytes = ciphertextBytes[x*16 : (x*16)+16]
+ blockString = bytesToString(blockBytes)
+ decryptedBytes = stringToBytes(self.rijndael.decrypt(blockString))
+
+ #XOR with the chaining block and overwrite the input with output
+ for y in range(16):
+ decryptedBytes[y] ^= chainBytes[y]
+ ciphertextBytes[(x*16)+y] = decryptedBytes[y]
+
+ #Set the next chaining block
+ chainBytes = blockBytes
+
+ self.IV = bytesToString(chainBytes)
+ return bytesToString(ciphertextBytes)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/Python_RC4.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/Python_RC4.py
new file mode 100755
index 0000000..56ce5fb
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/Python_RC4.py
@@ -0,0 +1,39 @@
+"""Pure-Python RC4 implementation."""
+
+from RC4 import RC4
+from cryptomath import *
+
+def new(key):
+ return Python_RC4(key)
+
+class Python_RC4(RC4):
+ def __init__(self, key):
+ RC4.__init__(self, key, "python")
+ keyBytes = stringToBytes(key)
+ S = [i for i in range(256)]
+ j = 0
+ for i in range(256):
+ j = (j + S[i] + keyBytes[i % len(keyBytes)]) % 256
+ S[i], S[j] = S[j], S[i]
+
+ self.S = S
+ self.i = 0
+ self.j = 0
+
+ def encrypt(self, plaintext):
+ plaintextBytes = stringToBytes(plaintext)
+ S = self.S
+ i = self.i
+ j = self.j
+ for x in range(len(plaintextBytes)):
+ i = (i + 1) % 256
+ j = (j + S[i]) % 256
+ S[i], S[j] = S[j], S[i]
+ t = (S[i] + S[j]) % 256
+ plaintextBytes[x] ^= S[t]
+ self.i = i
+ self.j = j
+ return bytesToString(plaintextBytes)
+
+ def decrypt(self, ciphertext):
+ return self.encrypt(ciphertext)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/Python_RSAKey.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/Python_RSAKey.py
new file mode 100755
index 0000000..2c469b5
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/Python_RSAKey.py
@@ -0,0 +1,209 @@
+"""Pure-Python RSA implementation."""
+
+from cryptomath import *
+import xmltools
+from ASN1Parser import ASN1Parser
+from RSAKey import *
+
+class Python_RSAKey(RSAKey):
+ def __init__(self, n=0, e=0, d=0, p=0, q=0, dP=0, dQ=0, qInv=0):
+ if (n and not e) or (e and not n):
+ raise AssertionError()
+ self.n = n
+ self.e = e
+ self.d = d
+ self.p = p
+ self.q = q
+ self.dP = dP
+ self.dQ = dQ
+ self.qInv = qInv
+ self.blinder = 0
+ self.unblinder = 0
+
+ def hasPrivateKey(self):
+ return self.d != 0
+
+ def hash(self):
+ s = self.writeXMLPublicKey('\t\t')
+ return hashAndBase64(s.strip())
+
+ def _rawPrivateKeyOp(self, m):
+ #Create blinding values, on the first pass:
+ if not self.blinder:
+ self.unblinder = getRandomNumber(2, self.n)
+ self.blinder = powMod(invMod(self.unblinder, self.n), self.e,
+ self.n)
+
+ #Blind the input
+ m = (m * self.blinder) % self.n
+
+ #Perform the RSA operation
+ c = self._rawPrivateKeyOpHelper(m)
+
+ #Unblind the output
+ c = (c * self.unblinder) % self.n
+
+ #Update blinding values
+ self.blinder = (self.blinder * self.blinder) % self.n
+ self.unblinder = (self.unblinder * self.unblinder) % self.n
+
+ #Return the output
+ return c
+
+
+ def _rawPrivateKeyOpHelper(self, m):
+ #Non-CRT version
+ #c = powMod(m, self.d, self.n)
+
+ #CRT version (~3x faster)
+ s1 = powMod(m, self.dP, self.p)
+ s2 = powMod(m, self.dQ, self.q)
+ h = ((s1 - s2) * self.qInv) % self.p
+ c = s2 + self.q * h
+ return c
+
+ def _rawPublicKeyOp(self, c):
+ m = powMod(c, self.e, self.n)
+ return m
+
+ def acceptsPassword(self): return False
+
+ def write(self, indent=''):
+ if self.d:
+ s = indent+'<privateKey xmlns="http://trevp.net/rsa">\n'
+ else:
+ s = indent+'<publicKey xmlns="http://trevp.net/rsa">\n'
+ s += indent+'\t<n>%s</n>\n' % numberToBase64(self.n)
+ s += indent+'\t<e>%s</e>\n' % numberToBase64(self.e)
+ if self.d:
+ s += indent+'\t<d>%s</d>\n' % numberToBase64(self.d)
+ s += indent+'\t<p>%s</p>\n' % numberToBase64(self.p)
+ s += indent+'\t<q>%s</q>\n' % numberToBase64(self.q)
+ s += indent+'\t<dP>%s</dP>\n' % numberToBase64(self.dP)
+ s += indent+'\t<dQ>%s</dQ>\n' % numberToBase64(self.dQ)
+ s += indent+'\t<qInv>%s</qInv>\n' % numberToBase64(self.qInv)
+ s += indent+'</privateKey>'
+ else:
+ s += indent+'</publicKey>'
+ #Only add \n if part of a larger structure
+ if indent != '':
+ s += '\n'
+ return s
+
+ def writeXMLPublicKey(self, indent=''):
+ return Python_RSAKey(self.n, self.e).write(indent)
+
+ def generate(bits):
+ key = Python_RSAKey()
+ p = getRandomPrime(bits/2, False)
+ q = getRandomPrime(bits/2, False)
+ t = lcm(p-1, q-1)
+ key.n = p * q
+ key.e = 3L #Needed to be long, for Java
+ key.d = invMod(key.e, t)
+ key.p = p
+ key.q = q
+ key.dP = key.d % (p-1)
+ key.dQ = key.d % (q-1)
+ key.qInv = invMod(q, p)
+ return key
+ generate = staticmethod(generate)
+
+ def parsePEM(s, passwordCallback=None):
+ """Parse a string containing a <privateKey> or <publicKey>, or
+ PEM-encoded key."""
+
+ start = s.find("-----BEGIN PRIVATE KEY-----")
+ if start != -1:
+ end = s.find("-----END PRIVATE KEY-----")
+ if end == -1:
+ raise SyntaxError("Missing PEM Postfix")
+ s = s[start+len("-----BEGIN PRIVATE KEY -----") : end]
+ bytes = base64ToBytes(s)
+ return Python_RSAKey._parsePKCS8(bytes)
+ else:
+ start = s.find("-----BEGIN RSA PRIVATE KEY-----")
+ if start != -1:
+ end = s.find("-----END RSA PRIVATE KEY-----")
+ if end == -1:
+ raise SyntaxError("Missing PEM Postfix")
+ s = s[start+len("-----BEGIN RSA PRIVATE KEY -----") : end]
+ bytes = base64ToBytes(s)
+ return Python_RSAKey._parseSSLeay(bytes)
+ raise SyntaxError("Missing PEM Prefix")
+ parsePEM = staticmethod(parsePEM)
+
+ def parseXML(s):
+ element = xmltools.parseAndStripWhitespace(s)
+ return Python_RSAKey._parseXML(element)
+ parseXML = staticmethod(parseXML)
+
+ def _parsePKCS8(bytes):
+ p = ASN1Parser(bytes)
+
+ version = p.getChild(0).value[0]
+ if version != 0:
+ raise SyntaxError("Unrecognized PKCS8 version")
+
+ rsaOID = p.getChild(1).value
+ if list(rsaOID) != [6, 9, 42, 134, 72, 134, 247, 13, 1, 1, 1, 5, 0]:
+ raise SyntaxError("Unrecognized AlgorithmIdentifier")
+
+ #Get the privateKey
+ privateKeyP = p.getChild(2)
+
+ #Adjust for OCTET STRING encapsulation
+ privateKeyP = ASN1Parser(privateKeyP.value)
+
+ return Python_RSAKey._parseASN1PrivateKey(privateKeyP)
+ _parsePKCS8 = staticmethod(_parsePKCS8)
+
+ def _parseSSLeay(bytes):
+ privateKeyP = ASN1Parser(bytes)
+ return Python_RSAKey._parseASN1PrivateKey(privateKeyP)
+ _parseSSLeay = staticmethod(_parseSSLeay)
+
+ def _parseASN1PrivateKey(privateKeyP):
+ version = privateKeyP.getChild(0).value[0]
+ if version != 0:
+ raise SyntaxError("Unrecognized RSAPrivateKey version")
+ n = bytesToNumber(privateKeyP.getChild(1).value)
+ e = bytesToNumber(privateKeyP.getChild(2).value)
+ d = bytesToNumber(privateKeyP.getChild(3).value)
+ p = bytesToNumber(privateKeyP.getChild(4).value)
+ q = bytesToNumber(privateKeyP.getChild(5).value)
+ dP = bytesToNumber(privateKeyP.getChild(6).value)
+ dQ = bytesToNumber(privateKeyP.getChild(7).value)
+ qInv = bytesToNumber(privateKeyP.getChild(8).value)
+ return Python_RSAKey(n, e, d, p, q, dP, dQ, qInv)
+ _parseASN1PrivateKey = staticmethod(_parseASN1PrivateKey)
+
+ def _parseXML(element):
+ try:
+ xmltools.checkName(element, "privateKey")
+ except SyntaxError:
+ xmltools.checkName(element, "publicKey")
+
+ #Parse attributes
+ xmltools.getReqAttribute(element, "xmlns", "http://trevp.net/rsa\Z")
+ xmltools.checkNoMoreAttributes(element)
+
+ #Parse public values (<n> and <e>)
+ n = base64ToNumber(xmltools.getText(xmltools.getChild(element, 0, "n"), xmltools.base64RegEx))
+ e = base64ToNumber(xmltools.getText(xmltools.getChild(element, 1, "e"), xmltools.base64RegEx))
+ d = 0
+ p = 0
+ q = 0
+ dP = 0
+ dQ = 0
+ qInv = 0
+ #Parse private values, if present
+ if element.childNodes.length>=3:
+ d = base64ToNumber(xmltools.getText(xmltools.getChild(element, 2, "d"), xmltools.base64RegEx))
+ p = base64ToNumber(xmltools.getText(xmltools.getChild(element, 3, "p"), xmltools.base64RegEx))
+ q = base64ToNumber(xmltools.getText(xmltools.getChild(element, 4, "q"), xmltools.base64RegEx))
+ dP = base64ToNumber(xmltools.getText(xmltools.getChild(element, 5, "dP"), xmltools.base64RegEx))
+ dQ = base64ToNumber(xmltools.getText(xmltools.getChild(element, 6, "dQ"), xmltools.base64RegEx))
+ qInv = base64ToNumber(xmltools.getText(xmltools.getLastChild(element, 7, "qInv"), xmltools.base64RegEx))
+ return Python_RSAKey(n, e, d, p, q, dP, dQ, qInv)
+ _parseXML = staticmethod(_parseXML)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/RC4.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/RC4.py
new file mode 100755
index 0000000..5506923
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/RC4.py
@@ -0,0 +1,17 @@
+"""Abstract class for RC4."""
+
+from compat import * #For False
+
+class RC4:
+ def __init__(self, keyBytes, implementation):
+ if len(keyBytes) < 16 or len(keyBytes) > 256:
+ raise ValueError()
+ self.isBlockCipher = False
+ self.name = "rc4"
+ self.implementation = implementation
+
+ def encrypt(self, plaintext):
+ raise NotImplementedError()
+
+ def decrypt(self, ciphertext):
+ raise NotImplementedError()
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/RSAKey.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/RSAKey.py
new file mode 100755
index 0000000..2f5d286
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/RSAKey.py
@@ -0,0 +1,264 @@
+"""Abstract class for RSA."""
+
+from cryptomath import *
+
+
+class RSAKey:
+ """This is an abstract base class for RSA keys.
+
+ Particular implementations of RSA keys, such as
+ L{OpenSSL_RSAKey.OpenSSL_RSAKey},
+ L{Python_RSAKey.Python_RSAKey}, and
+ L{PyCrypto_RSAKey.PyCrypto_RSAKey},
+ inherit from this.
+
+ To create or parse an RSA key, don't use one of these classes
+ directly. Instead, use the factory functions in
+ L{tlslite.utils.keyfactory}.
+ """
+
+ def __init__(self, n=0, e=0):
+ """Create a new RSA key.
+
+ If n and e are passed in, the new key will be initialized.
+
+ @type n: int
+ @param n: RSA modulus.
+
+ @type e: int
+ @param e: RSA public exponent.
+ """
+ raise NotImplementedError()
+
+ def __len__(self):
+ """Return the length of this key in bits.
+
+ @rtype: int
+ """
+ return numBits(self.n)
+
+ def hasPrivateKey(self):
+ """Return whether or not this key has a private component.
+
+ @rtype: bool
+ """
+ raise NotImplementedError()
+
+ def hash(self):
+ """Return the cryptoID <keyHash> value corresponding to this
+ key.
+
+ @rtype: str
+ """
+ raise NotImplementedError()
+
+ def getSigningAlgorithm(self):
+ """Return the cryptoID sigAlgo value corresponding to this key.
+
+ @rtype: str
+ """
+ return "pkcs1-sha1"
+
+ def hashAndSign(self, bytes):
+ """Hash and sign the passed-in bytes.
+
+ This requires the key to have a private component. It performs
+ a PKCS1-SHA1 signature on the passed-in data.
+
+ @type bytes: str or L{array.array} of unsigned bytes
+ @param bytes: The value which will be hashed and signed.
+
+ @rtype: L{array.array} of unsigned bytes.
+ @return: A PKCS1-SHA1 signature on the passed-in data.
+ """
+ if not isinstance(bytes, type("")):
+ bytes = bytesToString(bytes)
+ hashBytes = stringToBytes(sha1(bytes).digest())
+ prefixedHashBytes = self._addPKCS1SHA1Prefix(hashBytes)
+ sigBytes = self.sign(prefixedHashBytes)
+ return sigBytes
+
+ def hashAndVerify(self, sigBytes, bytes):
+ """Hash and verify the passed-in bytes with the signature.
+
+ This verifies a PKCS1-SHA1 signature on the passed-in data.
+
+ @type sigBytes: L{array.array} of unsigned bytes
+ @param sigBytes: A PKCS1-SHA1 signature.
+
+ @type bytes: str or L{array.array} of unsigned bytes
+ @param bytes: The value which will be hashed and verified.
+
+ @rtype: bool
+ @return: Whether the signature matches the passed-in data.
+ """
+ if not isinstance(bytes, type("")):
+ bytes = bytesToString(bytes)
+ hashBytes = stringToBytes(sha1(bytes).digest())
+ prefixedHashBytes = self._addPKCS1SHA1Prefix(hashBytes)
+ return self.verify(sigBytes, prefixedHashBytes)
+
+ def sign(self, bytes):
+ """Sign the passed-in bytes.
+
+ This requires the key to have a private component. It performs
+ a PKCS1 signature on the passed-in data.
+
+ @type bytes: L{array.array} of unsigned bytes
+ @param bytes: The value which will be signed.
+
+ @rtype: L{array.array} of unsigned bytes.
+ @return: A PKCS1 signature on the passed-in data.
+ """
+ if not self.hasPrivateKey():
+ raise AssertionError()
+ paddedBytes = self._addPKCS1Padding(bytes, 1)
+ m = bytesToNumber(paddedBytes)
+ if m >= self.n:
+ raise ValueError()
+ c = self._rawPrivateKeyOp(m)
+ sigBytes = numberToBytes(c)
+ return sigBytes
+
+ def verify(self, sigBytes, bytes):
+ """Verify the passed-in bytes with the signature.
+
+ This verifies a PKCS1 signature on the passed-in data.
+
+ @type sigBytes: L{array.array} of unsigned bytes
+ @param sigBytes: A PKCS1 signature.
+
+ @type bytes: L{array.array} of unsigned bytes
+ @param bytes: The value which will be verified.
+
+ @rtype: bool
+ @return: Whether the signature matches the passed-in data.
+ """
+ paddedBytes = self._addPKCS1Padding(bytes, 1)
+ c = bytesToNumber(sigBytes)
+ if c >= self.n:
+ return False
+ m = self._rawPublicKeyOp(c)
+ checkBytes = numberToBytes(m)
+ return checkBytes == paddedBytes
+
+ def encrypt(self, bytes):
+ """Encrypt the passed-in bytes.
+
+ This performs PKCS1 encryption of the passed-in data.
+
+ @type bytes: L{array.array} of unsigned bytes
+ @param bytes: The value which will be encrypted.
+
+ @rtype: L{array.array} of unsigned bytes.
+ @return: A PKCS1 encryption of the passed-in data.
+ """
+ paddedBytes = self._addPKCS1Padding(bytes, 2)
+ m = bytesToNumber(paddedBytes)
+ if m >= self.n:
+ raise ValueError()
+ c = self._rawPublicKeyOp(m)
+ encBytes = numberToBytes(c)
+ return encBytes
+
+ def decrypt(self, encBytes):
+ """Decrypt the passed-in bytes.
+
+ This requires the key to have a private component. It performs
+ PKCS1 decryption of the passed-in data.
+
+ @type encBytes: L{array.array} of unsigned bytes
+ @param encBytes: The value which will be decrypted.
+
+ @rtype: L{array.array} of unsigned bytes or None.
+ @return: A PKCS1 decryption of the passed-in data or None if
+ the data is not properly formatted.
+ """
+ if not self.hasPrivateKey():
+ raise AssertionError()
+ c = bytesToNumber(encBytes)
+ if c >= self.n:
+ return None
+ m = self._rawPrivateKeyOp(c)
+ decBytes = numberToBytes(m)
+ if (len(decBytes) != numBytes(self.n)-1): #Check first byte
+ return None
+ if decBytes[0] != 2: #Check second byte
+ return None
+ for x in range(len(decBytes)-1): #Scan through for zero separator
+ if decBytes[x]== 0:
+ break
+ else:
+ return None
+ return decBytes[x+1:] #Return everything after the separator
+
+ def _rawPrivateKeyOp(self, m):
+ raise NotImplementedError()
+
+ def _rawPublicKeyOp(self, c):
+ raise NotImplementedError()
+
+ def acceptsPassword(self):
+ """Return True if the write() method accepts a password for use
+ in encrypting the private key.
+
+ @rtype: bool
+ """
+ raise NotImplementedError()
+
+ def write(self, password=None):
+ """Return a string containing the key.
+
+ @rtype: str
+ @return: A string describing the key, in whichever format (PEM
+ or XML) is native to the implementation.
+ """
+ raise NotImplementedError()
+
+ def writeXMLPublicKey(self, indent=''):
+ """Return a string containing the key.
+
+ @rtype: str
+ @return: A string describing the public key, in XML format.
+ """
+ return Python_RSAKey(self.n, self.e).write(indent)
+
+ def generate(bits):
+ """Generate a new key with the specified bit length.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ """
+ raise NotImplementedError()
+ generate = staticmethod(generate)
+
+
+ # **************************************************************************
+ # Helper Functions for RSA Keys
+ # **************************************************************************
+
+ def _addPKCS1SHA1Prefix(self, bytes):
+ prefixBytes = createByteArraySequence(\
+ [48,33,48,9,6,5,43,14,3,2,26,5,0,4,20])
+ prefixedBytes = prefixBytes + bytes
+ return prefixedBytes
+
+ def _addPKCS1Padding(self, bytes, blockType):
+ padLength = (numBytes(self.n) - (len(bytes)+3))
+ if blockType == 1: #Signature padding
+ pad = [0xFF] * padLength
+ elif blockType == 2: #Encryption padding
+ pad = createByteArraySequence([])
+ while len(pad) < padLength:
+ padBytes = getRandomBytes(padLength * 2)
+ pad = [b for b in padBytes if b != 0]
+ pad = pad[:padLength]
+ else:
+ raise AssertionError()
+
+ #NOTE: To be proper, we should add [0,blockType]. However,
+ #the zero is lost when the returned padding is converted
+ #to a number, so we don't even bother with it. Also,
+ #adding it would cause a misalignment in verify()
+ padding = createByteArraySequence([blockType] + pad + [0])
+ paddedBytes = padding + bytes
+ return paddedBytes
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/TripleDES.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/TripleDES.py
new file mode 100755
index 0000000..2db4588
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/TripleDES.py
@@ -0,0 +1,26 @@
+"""Abstract class for 3DES."""
+
+from compat import * #For True
+
+class TripleDES:
+ def __init__(self, key, mode, IV, implementation):
+ if len(key) != 24:
+ raise ValueError()
+ if mode != 2:
+ raise ValueError()
+ if len(IV) != 8:
+ raise ValueError()
+ self.isBlockCipher = True
+ self.block_size = 8
+ self.implementation = implementation
+ self.name = "3des"
+
+ #CBC-Mode encryption, returns ciphertext
+ #WARNING: *MAY* modify the input as well
+ def encrypt(self, plaintext):
+ assert(len(plaintext) % 8 == 0)
+
+ #CBC-Mode decryption, returns plaintext
+ #WARNING: *MAY* modify the input as well
+ def decrypt(self, ciphertext):
+ assert(len(ciphertext) % 8 == 0)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/__init__.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/__init__.py
new file mode 100755
index 0000000..e96b4be
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/__init__.py
@@ -0,0 +1,31 @@
+"""Toolkit for crypto and other stuff."""
+
+__all__ = ["AES",
+ "ASN1Parser",
+ "cipherfactory",
+ "codec",
+ "Cryptlib_AES",
+ "Cryptlib_RC4",
+ "Cryptlib_TripleDES",
+ "cryptomath: cryptomath module",
+ "dateFuncs",
+ "hmac",
+ "JCE_RSAKey",
+ "compat",
+ "keyfactory",
+ "OpenSSL_AES",
+ "OpenSSL_RC4",
+ "OpenSSL_RSAKey",
+ "OpenSSL_TripleDES",
+ "PyCrypto_AES",
+ "PyCrypto_RC4",
+ "PyCrypto_RSAKey",
+ "PyCrypto_TripleDES",
+ "Python_AES",
+ "Python_RC4",
+ "Python_RSAKey",
+ "RC4",
+ "rijndael",
+ "RSAKey",
+ "TripleDES",
+ "xmltools"]
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/cipherfactory.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/cipherfactory.py
new file mode 100755
index 0000000..ccbb6b5
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/cipherfactory.py
@@ -0,0 +1,111 @@
+"""Factory functions for symmetric cryptography."""
+
+import os
+
+import Python_AES
+import Python_RC4
+
+import cryptomath
+
+tripleDESPresent = False
+
+if cryptomath.m2cryptoLoaded:
+ import OpenSSL_AES
+ import OpenSSL_RC4
+ import OpenSSL_TripleDES
+ tripleDESPresent = True
+
+if cryptomath.cryptlibpyLoaded:
+ import Cryptlib_AES
+ import Cryptlib_RC4
+ import Cryptlib_TripleDES
+ tripleDESPresent = True
+
+if cryptomath.pycryptoLoaded:
+ import PyCrypto_AES
+ import PyCrypto_RC4
+ import PyCrypto_TripleDES
+ tripleDESPresent = True
+
+# **************************************************************************
+# Factory Functions for AES
+# **************************************************************************
+
+def createAES(key, IV, implList=None):
+ """Create a new AES object.
+
+ @type key: str
+ @param key: A 16, 24, or 32 byte string.
+
+ @type IV: str
+ @param IV: A 16 byte string
+
+ @rtype: L{tlslite.utils.AES}
+ @return: An AES object.
+ """
+ if implList == None:
+ implList = ["cryptlib", "openssl", "pycrypto", "python"]
+
+ for impl in implList:
+ if impl == "cryptlib" and cryptomath.cryptlibpyLoaded:
+ return Cryptlib_AES.new(key, 2, IV)
+ elif impl == "openssl" and cryptomath.m2cryptoLoaded:
+ return OpenSSL_AES.new(key, 2, IV)
+ elif impl == "pycrypto" and cryptomath.pycryptoLoaded:
+ return PyCrypto_AES.new(key, 2, IV)
+ elif impl == "python":
+ return Python_AES.new(key, 2, IV)
+ raise NotImplementedError()
+
+def createRC4(key, IV, implList=None):
+ """Create a new RC4 object.
+
+ @type key: str
+ @param key: A 16 to 32 byte string.
+
+ @type IV: object
+ @param IV: Ignored, whatever it is.
+
+ @rtype: L{tlslite.utils.RC4}
+ @return: An RC4 object.
+ """
+ if implList == None:
+ implList = ["cryptlib", "openssl", "pycrypto", "python"]
+
+ if len(IV) != 0:
+ raise AssertionError()
+ for impl in implList:
+ if impl == "cryptlib" and cryptomath.cryptlibpyLoaded:
+ return Cryptlib_RC4.new(key)
+ elif impl == "openssl" and cryptomath.m2cryptoLoaded:
+ return OpenSSL_RC4.new(key)
+ elif impl == "pycrypto" and cryptomath.pycryptoLoaded:
+ return PyCrypto_RC4.new(key)
+ elif impl == "python":
+ return Python_RC4.new(key)
+ raise NotImplementedError()
+
+#Create a new TripleDES instance
+def createTripleDES(key, IV, implList=None):
+ """Create a new 3DES object.
+
+ @type key: str
+ @param key: A 24 byte string.
+
+ @type IV: str
+ @param IV: An 8 byte string
+
+ @rtype: L{tlslite.utils.TripleDES}
+ @return: A 3DES object.
+ """
+ if implList == None:
+ implList = ["cryptlib", "openssl", "pycrypto"]
+
+ for impl in implList:
+ if impl == "cryptlib" and cryptomath.cryptlibpyLoaded:
+ return Cryptlib_TripleDES.new(key, 2, IV)
+ elif impl == "openssl" and cryptomath.m2cryptoLoaded:
+ return OpenSSL_TripleDES.new(key, 2, IV)
+ elif impl == "pycrypto" and cryptomath.pycryptoLoaded:
+ return PyCrypto_TripleDES.new(key, 2, IV)
+ raise NotImplementedError()
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/codec.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/codec.py
new file mode 100755
index 0000000..13022a0
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/codec.py
@@ -0,0 +1,94 @@
+"""Classes for reading/writing binary data (such as TLS records)."""
+
+from compat import *
+
+class Writer:
+ def __init__(self, length=0):
+ #If length is zero, then this is just a "trial run" to determine length
+ self.index = 0
+ self.bytes = createByteArrayZeros(length)
+
+ def add(self, x, length):
+ if self.bytes:
+ newIndex = self.index+length-1
+ while newIndex >= self.index:
+ self.bytes[newIndex] = x & 0xFF
+ x >>= 8
+ newIndex -= 1
+ self.index += length
+
+ def addFixSeq(self, seq, length):
+ if self.bytes:
+ for e in seq:
+ self.add(e, length)
+ else:
+ self.index += len(seq)*length
+
+ def addVarSeq(self, seq, length, lengthLength):
+ if self.bytes:
+ self.add(len(seq)*length, lengthLength)
+ for e in seq:
+ self.add(e, length)
+ else:
+ self.index += lengthLength + (len(seq)*length)
+
+
+class Parser:
+ def __init__(self, bytes):
+ self.bytes = bytes
+ self.index = 0
+
+ def get(self, length):
+ if self.index + length > len(self.bytes):
+ raise SyntaxError()
+ x = 0
+ for count in range(length):
+ x <<= 8
+ x |= self.bytes[self.index]
+ self.index += 1
+ return x
+
+ def getFixBytes(self, lengthBytes):
+ bytes = self.bytes[self.index : self.index+lengthBytes]
+ self.index += lengthBytes
+ return bytes
+
+ def getVarBytes(self, lengthLength):
+ lengthBytes = self.get(lengthLength)
+ return self.getFixBytes(lengthBytes)
+
+ def getFixList(self, length, lengthList):
+ l = [0] * lengthList
+ for x in range(lengthList):
+ l[x] = self.get(length)
+ return l
+
+ def getVarList(self, length, lengthLength):
+ lengthList = self.get(lengthLength)
+ if lengthList % length != 0:
+ raise SyntaxError()
+ lengthList = int(lengthList/length)
+ l = [0] * lengthList
+ for x in range(lengthList):
+ l[x] = self.get(length)
+ return l
+
+ def startLengthCheck(self, lengthLength):
+ self.lengthCheck = self.get(lengthLength)
+ self.indexCheck = self.index
+
+ def setLengthCheck(self, length):
+ self.lengthCheck = length
+ self.indexCheck = self.index
+
+ def stopLengthCheck(self):
+ if (self.index - self.indexCheck) != self.lengthCheck:
+ raise SyntaxError()
+
+ def atLengthCheck(self):
+ if (self.index - self.indexCheck) < self.lengthCheck:
+ return False
+ elif (self.index - self.indexCheck) == self.lengthCheck:
+ return True
+ else:
+ raise SyntaxError()
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/compat.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/compat.py
new file mode 100755
index 0000000..7d2d925
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/compat.py
@@ -0,0 +1,140 @@
+"""Miscellaneous functions to mask Python version differences."""
+
+import sys
+import os
+
+if sys.version_info < (2,2):
+ raise AssertionError("Python 2.2 or later required")
+
+if sys.version_info < (2,3):
+
+ def enumerate(collection):
+ return zip(range(len(collection)), collection)
+
+ class Set:
+ def __init__(self, seq=None):
+ self.values = {}
+ if seq:
+ for e in seq:
+ self.values[e] = None
+
+ def add(self, e):
+ self.values[e] = None
+
+ def discard(self, e):
+ if e in self.values.keys():
+ del(self.values[e])
+
+ def union(self, s):
+ ret = Set()
+ for e in self.values.keys():
+ ret.values[e] = None
+ for e in s.values.keys():
+ ret.values[e] = None
+ return ret
+
+ def issubset(self, other):
+ for e in self.values.keys():
+ if e not in other.values.keys():
+ return False
+ return True
+
+ def __nonzero__( self):
+ return len(self.values.keys())
+
+ def __contains__(self, e):
+ return e in self.values.keys()
+
+ def __iter__(self):
+ return iter(set.values.keys())
+
+
+if os.name != "java":
+
+ import array
+ def createByteArraySequence(seq):
+ return array.array('B', seq)
+ def createByteArrayZeros(howMany):
+ return array.array('B', [0] * howMany)
+ def concatArrays(a1, a2):
+ return a1+a2
+
+ def bytesToString(bytes):
+ return bytes.tostring()
+ def stringToBytes(s):
+ bytes = createByteArrayZeros(0)
+ bytes.fromstring(s)
+ return bytes
+
+ import math
+ def numBits(n):
+ if n==0:
+ return 0
+ s = "%x" % n
+ return ((len(s)-1)*4) + \
+ {'0':0, '1':1, '2':2, '3':2,
+ '4':3, '5':3, '6':3, '7':3,
+ '8':4, '9':4, 'a':4, 'b':4,
+ 'c':4, 'd':4, 'e':4, 'f':4,
+ }[s[0]]
+ return int(math.floor(math.log(n, 2))+1)
+
+ BaseException = Exception
+ import sys
+ import traceback
+ def formatExceptionTrace(e):
+ newStr = "".join(traceback.format_exception(sys.exc_type, sys.exc_value, sys.exc_traceback))
+ return newStr
+
+else:
+ #Jython 2.1 is missing lots of python 2.3 stuff,
+ #which we have to emulate here:
+ #NOTE: JYTHON SUPPORT NO LONGER WORKS, DUE TO USE OF GENERATORS.
+ #THIS CODE IS LEFT IN SO THAT ONE JYTHON UPDATES TO 2.2, IT HAS A
+ #CHANCE OF WORKING AGAIN.
+
+ import java
+ import jarray
+
+ def createByteArraySequence(seq):
+ if isinstance(seq, type("")): #If it's a string, convert
+ seq = [ord(c) for c in seq]
+ return jarray.array(seq, 'h') #use short instead of bytes, cause bytes are signed
+ def createByteArrayZeros(howMany):
+ return jarray.zeros(howMany, 'h') #use short instead of bytes, cause bytes are signed
+ def concatArrays(a1, a2):
+ l = list(a1)+list(a2)
+ return createByteArraySequence(l)
+
+ #WAY TOO SLOW - MUST BE REPLACED------------
+ def bytesToString(bytes):
+ return "".join([chr(b) for b in bytes])
+
+ def stringToBytes(s):
+ bytes = createByteArrayZeros(len(s))
+ for count, c in enumerate(s):
+ bytes[count] = ord(c)
+ return bytes
+ #WAY TOO SLOW - MUST BE REPLACED------------
+
+ def numBits(n):
+ if n==0:
+ return 0
+ n= 1L * n; #convert to long, if it isn't already
+ return n.__tojava__(java.math.BigInteger).bitLength()
+
+ #Adjust the string to an array of bytes
+ def stringToJavaByteArray(s):
+ bytes = jarray.zeros(len(s), 'b')
+ for count, c in enumerate(s):
+ x = ord(c)
+ if x >= 128: x -= 256
+ bytes[count] = x
+ return bytes
+
+ BaseException = java.lang.Exception
+ import sys
+ import traceback
+ def formatExceptionTrace(e):
+ newStr = "".join(traceback.format_exception(sys.exc_type, sys.exc_value, sys.exc_traceback))
+ return newStr
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/cryptomath.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/cryptomath.py
new file mode 100755
index 0000000..92fb774
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/cryptomath.py
@@ -0,0 +1,404 @@
+"""cryptomath module
+
+This module has basic math/crypto code."""
+
+import os
+import sys
+import math
+import base64
+import binascii
+if sys.version_info[:2] <= (2, 4):
+ from sha import sha as sha1
+else:
+ from hashlib import sha1
+
+from compat import *
+
+
+# **************************************************************************
+# Load Optional Modules
+# **************************************************************************
+
+# Try to load M2Crypto/OpenSSL
+try:
+ from M2Crypto import m2
+ m2cryptoLoaded = True
+
+except ImportError:
+ m2cryptoLoaded = False
+
+
+# Try to load cryptlib
+try:
+ import cryptlib_py
+ try:
+ cryptlib_py.cryptInit()
+ except cryptlib_py.CryptException, e:
+ #If tlslite and cryptoIDlib are both present,
+ #they might each try to re-initialize this,
+ #so we're tolerant of that.
+ if e[0] != cryptlib_py.CRYPT_ERROR_INITED:
+ raise
+ cryptlibpyLoaded = True
+
+except ImportError:
+ cryptlibpyLoaded = False
+
+#Try to load GMPY
+try:
+ import gmpy
+ gmpyLoaded = True
+except ImportError:
+ gmpyLoaded = False
+
+#Try to load pycrypto
+try:
+ import Crypto.Cipher.AES
+ pycryptoLoaded = True
+except ImportError:
+ pycryptoLoaded = False
+
+
+# **************************************************************************
+# PRNG Functions
+# **************************************************************************
+
+# Get os.urandom PRNG
+try:
+ os.urandom(1)
+ def getRandomBytes(howMany):
+ return stringToBytes(os.urandom(howMany))
+ prngName = "os.urandom"
+
+except:
+ # Else get cryptlib PRNG
+ if cryptlibpyLoaded:
+ def getRandomBytes(howMany):
+ randomKey = cryptlib_py.cryptCreateContext(cryptlib_py.CRYPT_UNUSED,
+ cryptlib_py.CRYPT_ALGO_AES)
+ cryptlib_py.cryptSetAttribute(randomKey,
+ cryptlib_py.CRYPT_CTXINFO_MODE,
+ cryptlib_py.CRYPT_MODE_OFB)
+ cryptlib_py.cryptGenerateKey(randomKey)
+ bytes = createByteArrayZeros(howMany)
+ cryptlib_py.cryptEncrypt(randomKey, bytes)
+ return bytes
+ prngName = "cryptlib"
+
+ else:
+ #Else get UNIX /dev/urandom PRNG
+ try:
+ devRandomFile = open("/dev/urandom", "rb")
+ def getRandomBytes(howMany):
+ return stringToBytes(devRandomFile.read(howMany))
+ prngName = "/dev/urandom"
+ except IOError:
+ #Else get Win32 CryptoAPI PRNG
+ try:
+ import win32prng
+ def getRandomBytes(howMany):
+ s = win32prng.getRandomBytes(howMany)
+ if len(s) != howMany:
+ raise AssertionError()
+ return stringToBytes(s)
+ prngName ="CryptoAPI"
+ except ImportError:
+ #Else no PRNG :-(
+ def getRandomBytes(howMany):
+ raise NotImplementedError("No Random Number Generator "\
+ "available.")
+ prngName = "None"
+
+# **************************************************************************
+# Converter Functions
+# **************************************************************************
+
+def bytesToNumber(bytes):
+ total = 0L
+ multiplier = 1L
+ for count in range(len(bytes)-1, -1, -1):
+ byte = bytes[count]
+ total += multiplier * byte
+ multiplier *= 256
+ return total
+
+def numberToBytes(n):
+ howManyBytes = numBytes(n)
+ bytes = createByteArrayZeros(howManyBytes)
+ for count in range(howManyBytes-1, -1, -1):
+ bytes[count] = int(n % 256)
+ n >>= 8
+ return bytes
+
+def bytesToBase64(bytes):
+ s = bytesToString(bytes)
+ return stringToBase64(s)
+
+def base64ToBytes(s):
+ s = base64ToString(s)
+ return stringToBytes(s)
+
+def numberToBase64(n):
+ bytes = numberToBytes(n)
+ return bytesToBase64(bytes)
+
+def base64ToNumber(s):
+ bytes = base64ToBytes(s)
+ return bytesToNumber(bytes)
+
+def stringToNumber(s):
+ bytes = stringToBytes(s)
+ return bytesToNumber(bytes)
+
+def numberToString(s):
+ bytes = numberToBytes(s)
+ return bytesToString(bytes)
+
+def base64ToString(s):
+ try:
+ return base64.decodestring(s)
+ except binascii.Error, e:
+ raise SyntaxError(e)
+ except binascii.Incomplete, e:
+ raise SyntaxError(e)
+
+def stringToBase64(s):
+ return base64.encodestring(s).replace("\n", "")
+
+def mpiToNumber(mpi): #mpi is an openssl-format bignum string
+ if (ord(mpi[4]) & 0x80) !=0: #Make sure this is a positive number
+ raise AssertionError()
+ bytes = stringToBytes(mpi[4:])
+ return bytesToNumber(bytes)
+
+def numberToMPI(n):
+ bytes = numberToBytes(n)
+ ext = 0
+ #If the high-order bit is going to be set,
+ #add an extra byte of zeros
+ if (numBits(n) & 0x7)==0:
+ ext = 1
+ length = numBytes(n) + ext
+ bytes = concatArrays(createByteArrayZeros(4+ext), bytes)
+ bytes[0] = (length >> 24) & 0xFF
+ bytes[1] = (length >> 16) & 0xFF
+ bytes[2] = (length >> 8) & 0xFF
+ bytes[3] = length & 0xFF
+ return bytesToString(bytes)
+
+
+
+# **************************************************************************
+# Misc. Utility Functions
+# **************************************************************************
+
+def numBytes(n):
+ if n==0:
+ return 0
+ bits = numBits(n)
+ return int(math.ceil(bits / 8.0))
+
+def hashAndBase64(s):
+ return stringToBase64(sha1(s).digest())
+
+def getBase64Nonce(numChars=22): #defaults to an 132 bit nonce
+ bytes = getRandomBytes(numChars)
+ bytesStr = "".join([chr(b) for b in bytes])
+ return stringToBase64(bytesStr)[:numChars]
+
+
+# **************************************************************************
+# Big Number Math
+# **************************************************************************
+
+def getRandomNumber(low, high):
+ if low >= high:
+ raise AssertionError()
+ howManyBits = numBits(high)
+ howManyBytes = numBytes(high)
+ lastBits = howManyBits % 8
+ while 1:
+ bytes = getRandomBytes(howManyBytes)
+ if lastBits:
+ bytes[0] = bytes[0] % (1 << lastBits)
+ n = bytesToNumber(bytes)
+ if n >= low and n < high:
+ return n
+
+def gcd(a,b):
+ a, b = max(a,b), min(a,b)
+ while b:
+ a, b = b, a % b
+ return a
+
+def lcm(a, b):
+ #This will break when python division changes, but we can't use // cause
+ #of Jython
+ return (a * b) / gcd(a, b)
+
+#Returns inverse of a mod b, zero if none
+#Uses Extended Euclidean Algorithm
+def invMod(a, b):
+ c, d = a, b
+ uc, ud = 1, 0
+ while c != 0:
+ #This will break when python division changes, but we can't use //
+ #cause of Jython
+ q = d / c
+ c, d = d-(q*c), c
+ uc, ud = ud - (q * uc), uc
+ if d == 1:
+ return ud % b
+ return 0
+
+
+if gmpyLoaded:
+ def powMod(base, power, modulus):
+ base = gmpy.mpz(base)
+ power = gmpy.mpz(power)
+ modulus = gmpy.mpz(modulus)
+ result = pow(base, power, modulus)
+ return long(result)
+
+else:
+ #Copied from Bryan G. Olson's post to comp.lang.python
+ #Does left-to-right instead of pow()'s right-to-left,
+ #thus about 30% faster than the python built-in with small bases
+ def powMod(base, power, modulus):
+ nBitScan = 5
+
+ """ Return base**power mod modulus, using multi bit scanning
+ with nBitScan bits at a time."""
+
+ #TREV - Added support for negative exponents
+ negativeResult = False
+ if (power < 0):
+ power *= -1
+ negativeResult = True
+
+ exp2 = 2**nBitScan
+ mask = exp2 - 1
+
+ # Break power into a list of digits of nBitScan bits.
+ # The list is recursive so easy to read in reverse direction.
+ nibbles = None
+ while power:
+ nibbles = int(power & mask), nibbles
+ power = power >> nBitScan
+
+ # Make a table of powers of base up to 2**nBitScan - 1
+ lowPowers = [1]
+ for i in xrange(1, exp2):
+ lowPowers.append((lowPowers[i-1] * base) % modulus)
+
+ # To exponentiate by the first nibble, look it up in the table
+ nib, nibbles = nibbles
+ prod = lowPowers[nib]
+
+ # For the rest, square nBitScan times, then multiply by
+ # base^nibble
+ while nibbles:
+ nib, nibbles = nibbles
+ for i in xrange(nBitScan):
+ prod = (prod * prod) % modulus
+ if nib: prod = (prod * lowPowers[nib]) % modulus
+
+ #TREV - Added support for negative exponents
+ if negativeResult:
+ prodInv = invMod(prod, modulus)
+ #Check to make sure the inverse is correct
+ if (prod * prodInv) % modulus != 1:
+ raise AssertionError()
+ return prodInv
+ return prod
+
+
+#Pre-calculate a sieve of the ~100 primes < 1000:
+def makeSieve(n):
+ sieve = range(n)
+ for count in range(2, int(math.sqrt(n))):
+ if sieve[count] == 0:
+ continue
+ x = sieve[count] * 2
+ while x < len(sieve):
+ sieve[x] = 0
+ x += sieve[count]
+ sieve = [x for x in sieve[2:] if x]
+ return sieve
+
+sieve = makeSieve(1000)
+
+def isPrime(n, iterations=5, display=False):
+ #Trial division with sieve
+ for x in sieve:
+ if x >= n: return True
+ if n % x == 0: return False
+ #Passed trial division, proceed to Rabin-Miller
+ #Rabin-Miller implemented per Ferguson & Schneier
+ #Compute s, t for Rabin-Miller
+ if display: print "*",
+ s, t = n-1, 0
+ while s % 2 == 0:
+ s, t = s/2, t+1
+ #Repeat Rabin-Miller x times
+ a = 2 #Use 2 as a base for first iteration speedup, per HAC
+ for count in range(iterations):
+ v = powMod(a, s, n)
+ if v==1:
+ continue
+ i = 0
+ while v != n-1:
+ if i == t-1:
+ return False
+ else:
+ v, i = powMod(v, 2, n), i+1
+ a = getRandomNumber(2, n)
+ return True
+
+def getRandomPrime(bits, display=False):
+ if bits < 10:
+ raise AssertionError()
+ #The 1.5 ensures the 2 MSBs are set
+ #Thus, when used for p,q in RSA, n will have its MSB set
+ #
+ #Since 30 is lcm(2,3,5), we'll set our test numbers to
+ #29 % 30 and keep them there
+ low = (2L ** (bits-1)) * 3/2
+ high = 2L ** bits - 30
+ p = getRandomNumber(low, high)
+ p += 29 - (p % 30)
+ while 1:
+ if display: print ".",
+ p += 30
+ if p >= high:
+ p = getRandomNumber(low, high)
+ p += 29 - (p % 30)
+ if isPrime(p, display=display):
+ return p
+
+#Unused at the moment...
+def getRandomSafePrime(bits, display=False):
+ if bits < 10:
+ raise AssertionError()
+ #The 1.5 ensures the 2 MSBs are set
+ #Thus, when used for p,q in RSA, n will have its MSB set
+ #
+ #Since 30 is lcm(2,3,5), we'll set our test numbers to
+ #29 % 30 and keep them there
+ low = (2 ** (bits-2)) * 3/2
+ high = (2 ** (bits-1)) - 30
+ q = getRandomNumber(low, high)
+ q += 29 - (q % 30)
+ while 1:
+ if display: print ".",
+ q += 30
+ if (q >= high):
+ q = getRandomNumber(low, high)
+ q += 29 - (q % 30)
+ #Ideas from Tom Wu's SRP code
+ #Do trial division on p and q before Rabin-Miller
+ if isPrime(q, 0, display=display):
+ p = (2 * q) + 1
+ if isPrime(p, display=display):
+ if isPrime(q, display=display):
+ return p
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/dateFuncs.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/dateFuncs.py
new file mode 100755
index 0000000..38812eb
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/dateFuncs.py
@@ -0,0 +1,75 @@
+
+import os
+
+#Functions for manipulating datetime objects
+#CCYY-MM-DDThh:mm:ssZ
+def parseDateClass(s):
+ year, month, day = s.split("-")
+ day, tail = day[:2], day[2:]
+ hour, minute, second = tail[1:].split(":")
+ second = second[:2]
+ year, month, day = int(year), int(month), int(day)
+ hour, minute, second = int(hour), int(minute), int(second)
+ return createDateClass(year, month, day, hour, minute, second)
+
+
+if os.name != "java":
+ from datetime import datetime, timedelta
+
+ #Helper functions for working with a date/time class
+ def createDateClass(year, month, day, hour, minute, second):
+ return datetime(year, month, day, hour, minute, second)
+
+ def printDateClass(d):
+ #Split off fractional seconds, append 'Z'
+ return d.isoformat().split(".")[0]+"Z"
+
+ def getNow():
+ return datetime.utcnow()
+
+ def getHoursFromNow(hours):
+ return datetime.utcnow() + timedelta(hours=hours)
+
+ def getMinutesFromNow(minutes):
+ return datetime.utcnow() + timedelta(minutes=minutes)
+
+ def isDateClassExpired(d):
+ return d < datetime.utcnow()
+
+ def isDateClassBefore(d1, d2):
+ return d1 < d2
+
+else:
+ #Jython 2.1 is missing lots of python 2.3 stuff,
+ #which we have to emulate here:
+ import java
+ import jarray
+
+ def createDateClass(year, month, day, hour, minute, second):
+ c = java.util.Calendar.getInstance()
+ c.setTimeZone(java.util.TimeZone.getTimeZone("UTC"))
+ c.set(year, month-1, day, hour, minute, second)
+ return c
+
+ def printDateClass(d):
+ return "%04d-%02d-%02dT%02d:%02d:%02dZ" % \
+ (d.get(d.YEAR), d.get(d.MONTH)+1, d.get(d.DATE), \
+ d.get(d.HOUR_OF_DAY), d.get(d.MINUTE), d.get(d.SECOND))
+
+ def getNow():
+ c = java.util.Calendar.getInstance()
+ c.setTimeZone(java.util.TimeZone.getTimeZone("UTC"))
+ c.get(c.HOUR) #force refresh?
+ return c
+
+ def getHoursFromNow(hours):
+ d = getNow()
+ d.add(d.HOUR, hours)
+ return d
+
+ def isDateClassExpired(d):
+ n = getNow()
+ return d.before(n)
+
+ def isDateClassBefore(d1, d2):
+ return d1.before(d2)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/entropy.c b/samples/apps/marketplace_sample/gdata/tlslite/utils/entropy.c
new file mode 100755
index 0000000..c627794
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/entropy.c
@@ -0,0 +1,173 @@
+
+#include "Python.h"
+
+
+#ifdef MS_WINDOWS
+
+/* The following #define is not needed on VC6 with the Platform SDK, and it
+may not be needed on VC7, I'm not sure. I don't think it hurts anything.*/
+#define _WIN32_WINNT 0x0400
+
+#include <windows.h>
+
+
+typedef BOOL (WINAPI *CRYPTACQUIRECONTEXTA)(HCRYPTPROV *phProv,\
+ LPCSTR pszContainer, LPCSTR pszProvider, DWORD dwProvType,\
+ DWORD dwFlags );
+typedef BOOL (WINAPI *CRYPTGENRANDOM)(HCRYPTPROV hProv, DWORD dwLen,\
+ BYTE *pbBuffer );
+typedef BOOL (WINAPI *CRYPTRELEASECONTEXT)(HCRYPTPROV hProv,\
+ DWORD dwFlags);
+
+
+static PyObject* entropy(PyObject *self, PyObject *args)
+{
+ int howMany = 0;
+ HINSTANCE hAdvAPI32 = NULL;
+ CRYPTACQUIRECONTEXTA pCryptAcquireContextA = NULL;
+ CRYPTGENRANDOM pCryptGenRandom = NULL;
+ CRYPTRELEASECONTEXT pCryptReleaseContext = NULL;
+ HCRYPTPROV hCryptProv = 0;
+ unsigned char* bytes = NULL;
+ PyObject* returnVal = NULL;
+
+
+ /* Read arguments */
+ if (!PyArg_ParseTuple(args, "i", &howMany))
+ return(NULL);
+
+ /* Obtain handle to the DLL containing CryptoAPI
+ This should not fail */
+ if( (hAdvAPI32 = GetModuleHandle("advapi32.dll")) == NULL) {
+ PyErr_Format(PyExc_SystemError,
+ "Advapi32.dll not found");
+ return NULL;
+ }
+
+ /* Obtain pointers to the CryptoAPI functions
+ This will fail on some early version of Win95 */
+ pCryptAcquireContextA = (CRYPTACQUIRECONTEXTA)GetProcAddress(hAdvAPI32,\
+ "CryptAcquireContextA");
+ pCryptGenRandom = (CRYPTGENRANDOM)GetProcAddress(hAdvAPI32,\
+ "CryptGenRandom");
+ pCryptReleaseContext = (CRYPTRELEASECONTEXT) GetProcAddress(hAdvAPI32,\
+ "CryptReleaseContext");
+ if (pCryptAcquireContextA == NULL || pCryptGenRandom == NULL ||
+ pCryptReleaseContext == NULL) {
+ PyErr_Format(PyExc_NotImplementedError,
+ "CryptoAPI not available on this version of Windows");
+ return NULL;
+ }
+
+ /* Allocate bytes */
+ if ((bytes = (unsigned char*)PyMem_Malloc(howMany)) == NULL)
+ return PyErr_NoMemory();
+
+
+ /* Acquire context */
+ if(!pCryptAcquireContextA(&hCryptProv, NULL, NULL, PROV_RSA_FULL,
+ CRYPT_VERIFYCONTEXT)) {
+ PyErr_Format(PyExc_SystemError,
+ "CryptAcquireContext failed, error %d", GetLastError());
+ PyMem_Free(bytes);
+ return NULL;
+ }
+
+ /* Get random data */
+ if(!pCryptGenRandom(hCryptProv, howMany, bytes)) {
+ PyErr_Format(PyExc_SystemError,
+ "CryptGenRandom failed, error %d", GetLastError());
+ PyMem_Free(bytes);
+ CryptReleaseContext(hCryptProv, 0);
+ return NULL;
+ }
+
+ /* Build return value */
+ returnVal = Py_BuildValue("s#", bytes, howMany);
+ PyMem_Free(bytes);
+
+ /* Release context */
+ if (!pCryptReleaseContext(hCryptProv, 0)) {
+ PyErr_Format(PyExc_SystemError,
+ "CryptReleaseContext failed, error %d", GetLastError());
+ return NULL;
+ }
+
+ return returnVal;
+}
+
+#elif defined(HAVE_UNISTD_H) && defined(HAVE_FCNTL_H)
+
+#include <unistd.h>
+#include <fcntl.h>
+
+static PyObject* entropy(PyObject *self, PyObject *args)
+{
+ int howMany;
+ int fd;
+ unsigned char* bytes = NULL;
+ PyObject* returnVal = NULL;
+
+
+ /* Read arguments */
+ if (!PyArg_ParseTuple(args, "i", &howMany))
+ return(NULL);
+
+ /* Allocate bytes */
+ if ((bytes = (unsigned char*)PyMem_Malloc(howMany)) == NULL)
+ return PyErr_NoMemory();
+
+ /* Open device */
+ if ((fd = open("/dev/urandom", O_RDONLY, 0)) == -1) {
+ PyErr_Format(PyExc_NotImplementedError,
+ "No entropy source found");
+ PyMem_Free(bytes);
+ return NULL;
+ }
+
+ /* Get random data */
+ if (read(fd, bytes, howMany) < howMany) {
+ PyErr_Format(PyExc_SystemError,
+ "Reading from /dev/urandom failed");
+ PyMem_Free(bytes);
+ close(fd);
+ return NULL;
+ }
+
+ /* Build return value */
+ returnVal = Py_BuildValue("s#", bytes, howMany);
+ PyMem_Free(bytes);
+
+ /* Close device */
+ close(fd);
+
+ return returnVal;
+}
+
+#else
+
+static PyObject* entropy(PyObject *self, PyObject *args)
+{
+ PyErr_Format(PyExc_NotImplementedError,
+ "Function not supported");
+ return NULL;
+}
+
+#endif
+
+
+
+/* List of functions exported by this module */
+
+static struct PyMethodDef entropy_functions[] = {
+ {"entropy", (PyCFunction)entropy, METH_VARARGS, "Return a string of random bytes produced by a platform-specific\nentropy source."},
+ {NULL, NULL} /* Sentinel */
+};
+
+
+/* Initialize this module. */
+
+PyMODINIT_FUNC initentropy(void)
+{
+ Py_InitModule("entropy", entropy_functions);
+}
\ No newline at end of file
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/hmac.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/hmac.py
new file mode 100755
index 0000000..fe8feec
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/hmac.py
@@ -0,0 +1,104 @@
+"""HMAC (Keyed-Hashing for Message Authentication) Python module.
+
+Implements the HMAC algorithm as described by RFC 2104.
+
+(This file is modified from the standard library version to do faster
+copying)
+"""
+
+def _strxor(s1, s2):
+ """Utility method. XOR the two strings s1 and s2 (must have same length).
+ """
+ return "".join(map(lambda x, y: chr(ord(x) ^ ord(y)), s1, s2))
+
+# The size of the digests returned by HMAC depends on the underlying
+# hashing module used.
+digest_size = None
+
+class HMAC:
+ """RFC2104 HMAC class.
+
+ This supports the API for Cryptographic Hash Functions (PEP 247).
+ """
+
+ def __init__(self, key, msg = None, digestmod = None):
+ """Create a new HMAC object.
+
+ key: key for the keyed hash object.
+ msg: Initial input for the hash, if provided.
+ digestmod: A module supporting PEP 247. Defaults to the md5 module.
+ """
+ if digestmod is None:
+ import md5
+ digestmod = md5
+
+ if key == None: #TREVNEW - for faster copying
+ return #TREVNEW
+
+ self.digestmod = digestmod
+ self.outer = digestmod.new()
+ self.inner = digestmod.new()
+ self.digest_size = digestmod.digest_size
+
+ blocksize = 64
+ ipad = "\x36" * blocksize
+ opad = "\x5C" * blocksize
+
+ if len(key) > blocksize:
+ key = digestmod.new(key).digest()
+
+ key = key + chr(0) * (blocksize - len(key))
+ self.outer.update(_strxor(key, opad))
+ self.inner.update(_strxor(key, ipad))
+ if msg is not None:
+ self.update(msg)
+
+## def clear(self):
+## raise NotImplementedError, "clear() method not available in HMAC."
+
+ def update(self, msg):
+ """Update this hashing object with the string msg.
+ """
+ self.inner.update(msg)
+
+ def copy(self):
+ """Return a separate copy of this hashing object.
+
+ An update to this copy won't affect the original object.
+ """
+ other = HMAC(None) #TREVNEW - for faster copying
+ other.digest_size = self.digest_size #TREVNEW
+ other.digestmod = self.digestmod
+ other.inner = self.inner.copy()
+ other.outer = self.outer.copy()
+ return other
+
+ def digest(self):
+ """Return the hash value of this hashing object.
+
+ This returns a string containing 8-bit data. The object is
+ not altered in any way by this function; you can continue
+ updating the object after calling this function.
+ """
+ h = self.outer.copy()
+ h.update(self.inner.digest())
+ return h.digest()
+
+ def hexdigest(self):
+ """Like digest(), but returns a string of hexadecimal digits instead.
+ """
+ return "".join([hex(ord(x))[2:].zfill(2)
+ for x in tuple(self.digest())])
+
+def new(key, msg = None, digestmod = None):
+ """Create a new hashing object and return it.
+
+ key: The starting key for the hash.
+ msg: if available, will immediately be hashed into the object's starting
+ state.
+
+ You can now feed arbitrary strings into the object using its update()
+ method, and can ask for the hash value at any time by calling its digest()
+ method.
+ """
+ return HMAC(key, msg, digestmod)
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/jython_compat.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/jython_compat.py
new file mode 100755
index 0000000..1245183
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/jython_compat.py
@@ -0,0 +1,195 @@
+"""Miscellaneous functions to mask Python/Jython differences."""
+
+import os
+import sha
+
+if os.name != "java":
+ BaseException = Exception
+
+ from sets import Set
+ import array
+ import math
+
+ def createByteArraySequence(seq):
+ return array.array('B', seq)
+ def createByteArrayZeros(howMany):
+ return array.array('B', [0] * howMany)
+ def concatArrays(a1, a2):
+ return a1+a2
+
+ def bytesToString(bytes):
+ return bytes.tostring()
+
+ def stringToBytes(s):
+ bytes = createByteArrayZeros(0)
+ bytes.fromstring(s)
+ return bytes
+
+ def numBits(n):
+ if n==0:
+ return 0
+ return int(math.floor(math.log(n, 2))+1)
+
+ class CertChainBase: pass
+ class SelfTestBase: pass
+ class ReportFuncBase: pass
+
+ #Helper functions for working with sets (from Python 2.3)
+ def iterSet(set):
+ return iter(set)
+
+ def getListFromSet(set):
+ return list(set)
+
+ #Factory function for getting a SHA1 object
+ def getSHA1(s):
+ return sha.sha(s)
+
+ import sys
+ import traceback
+
+ def formatExceptionTrace(e):
+ newStr = "".join(traceback.format_exception(sys.exc_type, sys.exc_value, sys.exc_traceback))
+ return newStr
+
+else:
+ #Jython 2.1 is missing lots of python 2.3 stuff,
+ #which we have to emulate here:
+ import java
+ import jarray
+
+ BaseException = java.lang.Exception
+
+ def createByteArraySequence(seq):
+ if isinstance(seq, type("")): #If it's a string, convert
+ seq = [ord(c) for c in seq]
+ return jarray.array(seq, 'h') #use short instead of bytes, cause bytes are signed
+ def createByteArrayZeros(howMany):
+ return jarray.zeros(howMany, 'h') #use short instead of bytes, cause bytes are signed
+ def concatArrays(a1, a2):
+ l = list(a1)+list(a2)
+ return createByteArraySequence(l)
+
+ #WAY TOO SLOW - MUST BE REPLACED------------
+ def bytesToString(bytes):
+ return "".join([chr(b) for b in bytes])
+
+ def stringToBytes(s):
+ bytes = createByteArrayZeros(len(s))
+ for count, c in enumerate(s):
+ bytes[count] = ord(c)
+ return bytes
+ #WAY TOO SLOW - MUST BE REPLACED------------
+
+ def numBits(n):
+ if n==0:
+ return 0
+ n= 1L * n; #convert to long, if it isn't already
+ return n.__tojava__(java.math.BigInteger).bitLength()
+
+ #This properly creates static methods for Jython
+ class staticmethod:
+ def __init__(self, anycallable): self.__call__ = anycallable
+
+ #Properties are not supported for Jython
+ class property:
+ def __init__(self, anycallable): pass
+
+ #True and False have to be specially defined
+ False = 0
+ True = 1
+
+ class StopIteration(Exception): pass
+
+ def enumerate(collection):
+ return zip(range(len(collection)), collection)
+
+ class Set:
+ def __init__(self, seq=None):
+ self.values = {}
+ if seq:
+ for e in seq:
+ self.values[e] = None
+
+ def add(self, e):
+ self.values[e] = None
+
+ def discard(self, e):
+ if e in self.values.keys():
+ del(self.values[e])
+
+ def union(self, s):
+ ret = Set()
+ for e in self.values.keys():
+ ret.values[e] = None
+ for e in s.values.keys():
+ ret.values[e] = None
+ return ret
+
+ def issubset(self, other):
+ for e in self.values.keys():
+ if e not in other.values.keys():
+ return False
+ return True
+
+ def __nonzero__( self):
+ return len(self.values.keys())
+
+ def __contains__(self, e):
+ return e in self.values.keys()
+
+ def iterSet(set):
+ return set.values.keys()
+
+ def getListFromSet(set):
+ return set.values.keys()
+
+ """
+ class JCE_SHA1:
+ def __init__(self, s=None):
+ self.md = java.security.MessageDigest.getInstance("SHA1")
+ if s:
+ self.update(s)
+
+ def update(self, s):
+ self.md.update(s)
+
+ def copy(self):
+ sha1 = JCE_SHA1()
+ sha1.md = self.md.clone()
+ return sha1
+
+ def digest(self):
+ digest = self.md.digest()
+ bytes = jarray.zeros(20, 'h')
+ for count in xrange(20):
+ x = digest[count]
+ if x < 0: x += 256
+ bytes[count] = x
+ return bytes
+ """
+
+ #Factory function for getting a SHA1 object
+ #The JCE_SHA1 class is way too slow...
+ #the sha.sha object we use instead is broken in the jython 2.1
+ #release, and needs to be patched
+ def getSHA1(s):
+ #return JCE_SHA1(s)
+ return sha.sha(s)
+
+
+ #Adjust the string to an array of bytes
+ def stringToJavaByteArray(s):
+ bytes = jarray.zeros(len(s), 'b')
+ for count, c in enumerate(s):
+ x = ord(c)
+ if x >= 128: x -= 256
+ bytes[count] = x
+ return bytes
+
+ import sys
+ import traceback
+
+ def formatExceptionTrace(e):
+ newStr = "".join(traceback.format_exception(sys.exc_type, sys.exc_value, sys.exc_traceback))
+ return newStr
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/keyfactory.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/keyfactory.py
new file mode 100755
index 0000000..5005af7
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/keyfactory.py
@@ -0,0 +1,243 @@
+"""Factory functions for asymmetric cryptography.
+@sort: generateRSAKey, parseXMLKey, parsePEMKey, parseAsPublicKey,
+parseAsPrivateKey
+"""
+
+from compat import *
+
+from RSAKey import RSAKey
+from Python_RSAKey import Python_RSAKey
+import cryptomath
+
+if cryptomath.m2cryptoLoaded:
+ from OpenSSL_RSAKey import OpenSSL_RSAKey
+
+if cryptomath.pycryptoLoaded:
+ from PyCrypto_RSAKey import PyCrypto_RSAKey
+
+# **************************************************************************
+# Factory Functions for RSA Keys
+# **************************************************************************
+
+def generateRSAKey(bits, implementations=["openssl", "python"]):
+ """Generate an RSA key with the specified bit length.
+
+ @type bits: int
+ @param bits: Desired bit length of the new key's modulus.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ @return: A new RSA private key.
+ """
+ for implementation in implementations:
+ if implementation == "openssl" and cryptomath.m2cryptoLoaded:
+ return OpenSSL_RSAKey.generate(bits)
+ elif implementation == "python":
+ return Python_RSAKey.generate(bits)
+ raise ValueError("No acceptable implementations")
+
+def parseXMLKey(s, private=False, public=False, implementations=["python"]):
+ """Parse an XML-format key.
+
+ The XML format used here is specific to tlslite and cryptoIDlib. The
+ format can store the public component of a key, or the public and
+ private components. For example::
+
+ <publicKey xmlns="http://trevp.net/rsa">
+ <n>4a5yzB8oGNlHo866CAspAC47M4Fvx58zwK8pou...
+ <e>Aw==</e>
+ </publicKey>
+
+ <privateKey xmlns="http://trevp.net/rsa">
+ <n>4a5yzB8oGNlHo866CAspAC47M4Fvx58zwK8pou...
+ <e>Aw==</e>
+ <d>JZ0TIgUxWXmL8KJ0VqyG1V0J3ern9pqIoB0xmy...
+ <p>5PreIj6z6ldIGL1V4+1C36dQFHNCQHJvW52GXc...
+ <q>/E/wDit8YXPCxx126zTq2ilQ3IcW54NJYyNjiZ...
+ <dP>mKc+wX8inDowEH45Qp4slRo1YveBgExKPROu6...
+ <dQ>qDVKtBz9lk0shL5PR3ickXDgkwS576zbl2ztB...
+ <qInv>j6E8EA7dNsTImaXexAmLA1DoeArsYeFAInr...
+ </privateKey>
+
+ @type s: str
+ @param s: A string containing an XML public or private key.
+
+ @type private: bool
+ @param private: If True, a L{SyntaxError} will be raised if the private
+ key component is not present.
+
+ @type public: bool
+ @param public: If True, the private key component (if present) will be
+ discarded, so this function will always return a public key.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ @return: An RSA key.
+
+ @raise SyntaxError: If the key is not properly formatted.
+ """
+ for implementation in implementations:
+ if implementation == "python":
+ key = Python_RSAKey.parseXML(s)
+ break
+ else:
+ raise ValueError("No acceptable implementations")
+
+ return _parseKeyHelper(key, private, public)
+
+#Parse as an OpenSSL or Python key
+def parsePEMKey(s, private=False, public=False, passwordCallback=None,
+ implementations=["openssl", "python"]):
+ """Parse a PEM-format key.
+
+ The PEM format is used by OpenSSL and other tools. The
+ format is typically used to store both the public and private
+ components of a key. For example::
+
+ -----BEGIN RSA PRIVATE KEY-----
+ MIICXQIBAAKBgQDYscuoMzsGmW0pAYsmyHltxB2TdwHS0dImfjCMfaSDkfLdZY5+
+ dOWORVns9etWnr194mSGA1F0Pls/VJW8+cX9+3vtJV8zSdANPYUoQf0TP7VlJxkH
+ dSRkUbEoz5bAAs/+970uos7n7iXQIni+3erUTdYEk2iWnMBjTljfgbK/dQIDAQAB
+ AoGAJHoJZk75aKr7DSQNYIHuruOMdv5ZeDuJvKERWxTrVJqE32/xBKh42/IgqRrc
+ esBN9ZregRCd7YtxoL+EVUNWaJNVx2mNmezEznrc9zhcYUrgeaVdFO2yBF1889zO
+ gCOVwrO8uDgeyj6IKa25H6c1N13ih/o7ZzEgWbGG+ylU1yECQQDv4ZSJ4EjSh/Fl
+ aHdz3wbBa/HKGTjC8iRy476Cyg2Fm8MZUe9Yy3udOrb5ZnS2MTpIXt5AF3h2TfYV
+ VoFXIorjAkEA50FcJmzT8sNMrPaV8vn+9W2Lu4U7C+K/O2g1iXMaZms5PC5zV5aV
+ CKXZWUX1fq2RaOzlbQrpgiolhXpeh8FjxwJBAOFHzSQfSsTNfttp3KUpU0LbiVvv
+ i+spVSnA0O4rq79KpVNmK44Mq67hsW1P11QzrzTAQ6GVaUBRv0YS061td1kCQHnP
+ wtN2tboFR6lABkJDjxoGRvlSt4SOPr7zKGgrWjeiuTZLHXSAnCY+/hr5L9Q3ZwXG
+ 6x6iBdgLjVIe4BZQNtcCQQDXGv/gWinCNTN3MPWfTW/RGzuMYVmyBFais0/VrgdH
+ h1dLpztmpQqfyH/zrBXQ9qL/zR4ojS6XYneO/U18WpEe
+ -----END RSA PRIVATE KEY-----
+
+ To generate a key like this with OpenSSL, run::
+
+ openssl genrsa 2048 > key.pem
+
+ This format also supports password-encrypted private keys. TLS
+ Lite can only handle password-encrypted private keys when OpenSSL
+ and M2Crypto are installed. In this case, passwordCallback will be
+ invoked to query the user for the password.
+
+ @type s: str
+ @param s: A string containing a PEM-encoded public or private key.
+
+ @type private: bool
+ @param private: If True, a L{SyntaxError} will be raised if the
+ private key component is not present.
+
+ @type public: bool
+ @param public: If True, the private key component (if present) will
+ be discarded, so this function will always return a public key.
+
+ @type passwordCallback: callable
+ @param passwordCallback: This function will be called, with no
+ arguments, if the PEM-encoded private key is password-encrypted.
+ The callback should return the password string. If the password is
+ incorrect, SyntaxError will be raised. If no callback is passed
+ and the key is password-encrypted, a prompt will be displayed at
+ the console.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ @return: An RSA key.
+
+ @raise SyntaxError: If the key is not properly formatted.
+ """
+ for implementation in implementations:
+ if implementation == "openssl" and cryptomath.m2cryptoLoaded:
+ key = OpenSSL_RSAKey.parse(s, passwordCallback)
+ break
+ elif implementation == "python":
+ key = Python_RSAKey.parsePEM(s)
+ break
+ else:
+ raise ValueError("No acceptable implementations")
+
+ return _parseKeyHelper(key, private, public)
+
+
+def _parseKeyHelper(key, private, public):
+ if private:
+ if not key.hasPrivateKey():
+ raise SyntaxError("Not a private key!")
+
+ if public:
+ return _createPublicKey(key)
+
+ if private:
+ if hasattr(key, "d"):
+ return _createPrivateKey(key)
+ else:
+ return key
+
+ return key
+
+def parseAsPublicKey(s):
+ """Parse an XML or PEM-formatted public key.
+
+ @type s: str
+ @param s: A string containing an XML or PEM-encoded public or private key.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ @return: An RSA public key.
+
+ @raise SyntaxError: If the key is not properly formatted.
+ """
+ try:
+ return parsePEMKey(s, public=True)
+ except:
+ return parseXMLKey(s, public=True)
+
+def parsePrivateKey(s):
+ """Parse an XML or PEM-formatted private key.
+
+ @type s: str
+ @param s: A string containing an XML or PEM-encoded private key.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ @return: An RSA private key.
+
+ @raise SyntaxError: If the key is not properly formatted.
+ """
+ try:
+ return parsePEMKey(s, private=True)
+ except:
+ return parseXMLKey(s, private=True)
+
+def _createPublicKey(key):
+ """
+ Create a new public key. Discard any private component,
+ and return the most efficient key possible.
+ """
+ if not isinstance(key, RSAKey):
+ raise AssertionError()
+ return _createPublicRSAKey(key.n, key.e)
+
+def _createPrivateKey(key):
+ """
+ Create a new private key. Return the most efficient key possible.
+ """
+ if not isinstance(key, RSAKey):
+ raise AssertionError()
+ if not key.hasPrivateKey():
+ raise AssertionError()
+ return _createPrivateRSAKey(key.n, key.e, key.d, key.p, key.q, key.dP,
+ key.dQ, key.qInv)
+
+def _createPublicRSAKey(n, e, implementations = ["openssl", "pycrypto",
+ "python"]):
+ for implementation in implementations:
+ if implementation == "openssl" and cryptomath.m2cryptoLoaded:
+ return OpenSSL_RSAKey(n, e)
+ elif implementation == "pycrypto" and cryptomath.pycryptoLoaded:
+ return PyCrypto_RSAKey(n, e)
+ elif implementation == "python":
+ return Python_RSAKey(n, e)
+ raise ValueError("No acceptable implementations")
+
+def _createPrivateRSAKey(n, e, d, p, q, dP, dQ, qInv,
+ implementations = ["pycrypto", "python"]):
+ for implementation in implementations:
+ if implementation == "pycrypto" and cryptomath.pycryptoLoaded:
+ return PyCrypto_RSAKey(n, e, d, p, q, dP, dQ, qInv)
+ elif implementation == "python":
+ return Python_RSAKey(n, e, d, p, q, dP, dQ, qInv)
+ raise ValueError("No acceptable implementations")
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/rijndael.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/rijndael.py
new file mode 100755
index 0000000..cb2f547
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/rijndael.py
@@ -0,0 +1,392 @@
+"""
+A pure python (slow) implementation of rijndael with a decent interface
+
+To include -
+
+from rijndael import rijndael
+
+To do a key setup -
+
+r = rijndael(key, block_size = 16)
+
+key must be a string of length 16, 24, or 32
+blocksize must be 16, 24, or 32. Default is 16
+
+To use -
+
+ciphertext = r.encrypt(plaintext)
+plaintext = r.decrypt(ciphertext)
+
+If any strings are of the wrong length a ValueError is thrown
+"""
+
+# ported from the Java reference code by Bram Cohen, bram@gawth.com, April 2001
+# this code is public domain, unless someone makes
+# an intellectual property claim against the reference
+# code, in which case it can be made public domain by
+# deleting all the comments and renaming all the variables
+
+import copy
+import string
+
+
+
+#-----------------------
+#TREV - ADDED BECAUSE THERE'S WARNINGS ABOUT INT OVERFLOW BEHAVIOR CHANGING IN
+#2.4.....
+import os
+if os.name != "java":
+ import exceptions
+ if hasattr(exceptions, "FutureWarning"):
+ import warnings
+ warnings.filterwarnings("ignore", category=FutureWarning, append=1)
+#-----------------------
+
+
+
+shifts = [[[0, 0], [1, 3], [2, 2], [3, 1]],
+ [[0, 0], [1, 5], [2, 4], [3, 3]],
+ [[0, 0], [1, 7], [3, 5], [4, 4]]]
+
+# [keysize][block_size]
+num_rounds = {16: {16: 10, 24: 12, 32: 14}, 24: {16: 12, 24: 12, 32: 14}, 32: {16: 14, 24: 14, 32: 14}}
+
+A = [[1, 1, 1, 1, 1, 0, 0, 0],
+ [0, 1, 1, 1, 1, 1, 0, 0],
+ [0, 0, 1, 1, 1, 1, 1, 0],
+ [0, 0, 0, 1, 1, 1, 1, 1],
+ [1, 0, 0, 0, 1, 1, 1, 1],
+ [1, 1, 0, 0, 0, 1, 1, 1],
+ [1, 1, 1, 0, 0, 0, 1, 1],
+ [1, 1, 1, 1, 0, 0, 0, 1]]
+
+# produce log and alog tables, needed for multiplying in the
+# field GF(2^m) (generator = 3)
+alog = [1]
+for i in xrange(255):
+ j = (alog[-1] << 1) ^ alog[-1]
+ if j & 0x100 != 0:
+ j ^= 0x11B
+ alog.append(j)
+
+log = [0] * 256
+for i in xrange(1, 255):
+ log[alog[i]] = i
+
+# multiply two elements of GF(2^m)
+def mul(a, b):
+ if a == 0 or b == 0:
+ return 0
+ return alog[(log[a & 0xFF] + log[b & 0xFF]) % 255]
+
+# substitution box based on F^{-1}(x)
+box = [[0] * 8 for i in xrange(256)]
+box[1][7] = 1
+for i in xrange(2, 256):
+ j = alog[255 - log[i]]
+ for t in xrange(8):
+ box[i][t] = (j >> (7 - t)) & 0x01
+
+B = [0, 1, 1, 0, 0, 0, 1, 1]
+
+# affine transform: box[i] <- B + A*box[i]
+cox = [[0] * 8 for i in xrange(256)]
+for i in xrange(256):
+ for t in xrange(8):
+ cox[i][t] = B[t]
+ for j in xrange(8):
+ cox[i][t] ^= A[t][j] * box[i][j]
+
+# S-boxes and inverse S-boxes
+S = [0] * 256
+Si = [0] * 256
+for i in xrange(256):
+ S[i] = cox[i][0] << 7
+ for t in xrange(1, 8):
+ S[i] ^= cox[i][t] << (7-t)
+ Si[S[i] & 0xFF] = i
+
+# T-boxes
+G = [[2, 1, 1, 3],
+ [3, 2, 1, 1],
+ [1, 3, 2, 1],
+ [1, 1, 3, 2]]
+
+AA = [[0] * 8 for i in xrange(4)]
+
+for i in xrange(4):
+ for j in xrange(4):
+ AA[i][j] = G[i][j]
+ AA[i][i+4] = 1
+
+for i in xrange(4):
+ pivot = AA[i][i]
+ if pivot == 0:
+ t = i + 1
+ while AA[t][i] == 0 and t < 4:
+ t += 1
+ assert t != 4, 'G matrix must be invertible'
+ for j in xrange(8):
+ AA[i][j], AA[t][j] = AA[t][j], AA[i][j]
+ pivot = AA[i][i]
+ for j in xrange(8):
+ if AA[i][j] != 0:
+ AA[i][j] = alog[(255 + log[AA[i][j] & 0xFF] - log[pivot & 0xFF]) % 255]
+ for t in xrange(4):
+ if i != t:
+ for j in xrange(i+1, 8):
+ AA[t][j] ^= mul(AA[i][j], AA[t][i])
+ AA[t][i] = 0
+
+iG = [[0] * 4 for i in xrange(4)]
+
+for i in xrange(4):
+ for j in xrange(4):
+ iG[i][j] = AA[i][j + 4]
+
+def mul4(a, bs):
+ if a == 0:
+ return 0
+ r = 0
+ for b in bs:
+ r <<= 8
+ if b != 0:
+ r = r | mul(a, b)
+ return r
+
+T1 = []
+T2 = []
+T3 = []
+T4 = []
+T5 = []
+T6 = []
+T7 = []
+T8 = []
+U1 = []
+U2 = []
+U3 = []
+U4 = []
+
+for t in xrange(256):
+ s = S[t]
+ T1.append(mul4(s, G[0]))
+ T2.append(mul4(s, G[1]))
+ T3.append(mul4(s, G[2]))
+ T4.append(mul4(s, G[3]))
+
+ s = Si[t]
+ T5.append(mul4(s, iG[0]))
+ T6.append(mul4(s, iG[1]))
+ T7.append(mul4(s, iG[2]))
+ T8.append(mul4(s, iG[3]))
+
+ U1.append(mul4(t, iG[0]))
+ U2.append(mul4(t, iG[1]))
+ U3.append(mul4(t, iG[2]))
+ U4.append(mul4(t, iG[3]))
+
+# round constants
+rcon = [1]
+r = 1
+for t in xrange(1, 30):
+ r = mul(2, r)
+ rcon.append(r)
+
+del A
+del AA
+del pivot
+del B
+del G
+del box
+del log
+del alog
+del i
+del j
+del r
+del s
+del t
+del mul
+del mul4
+del cox
+del iG
+
+class rijndael:
+ def __init__(self, key, block_size = 16):
+ if block_size != 16 and block_size != 24 and block_size != 32:
+ raise ValueError('Invalid block size: ' + str(block_size))
+ if len(key) != 16 and len(key) != 24 and len(key) != 32:
+ raise ValueError('Invalid key size: ' + str(len(key)))
+ self.block_size = block_size
+
+ ROUNDS = num_rounds[len(key)][block_size]
+ BC = block_size / 4
+ # encryption round keys
+ Ke = [[0] * BC for i in xrange(ROUNDS + 1)]
+ # decryption round keys
+ Kd = [[0] * BC for i in xrange(ROUNDS + 1)]
+ ROUND_KEY_COUNT = (ROUNDS + 1) * BC
+ KC = len(key) / 4
+
+ # copy user material bytes into temporary ints
+ tk = []
+ for i in xrange(0, KC):
+ tk.append((ord(key[i * 4]) << 24) | (ord(key[i * 4 + 1]) << 16) |
+ (ord(key[i * 4 + 2]) << 8) | ord(key[i * 4 + 3]))
+
+ # copy values into round key arrays
+ t = 0
+ j = 0
+ while j < KC and t < ROUND_KEY_COUNT:
+ Ke[t / BC][t % BC] = tk[j]
+ Kd[ROUNDS - (t / BC)][t % BC] = tk[j]
+ j += 1
+ t += 1
+ tt = 0
+ rconpointer = 0
+ while t < ROUND_KEY_COUNT:
+ # extrapolate using phi (the round key evolution function)
+ tt = tk[KC - 1]
+ tk[0] ^= (S[(tt >> 16) & 0xFF] & 0xFF) << 24 ^ \
+ (S[(tt >> 8) & 0xFF] & 0xFF) << 16 ^ \
+ (S[ tt & 0xFF] & 0xFF) << 8 ^ \
+ (S[(tt >> 24) & 0xFF] & 0xFF) ^ \
+ (rcon[rconpointer] & 0xFF) << 24
+ rconpointer += 1
+ if KC != 8:
+ for i in xrange(1, KC):
+ tk[i] ^= tk[i-1]
+ else:
+ for i in xrange(1, KC / 2):
+ tk[i] ^= tk[i-1]
+ tt = tk[KC / 2 - 1]
+ tk[KC / 2] ^= (S[ tt & 0xFF] & 0xFF) ^ \
+ (S[(tt >> 8) & 0xFF] & 0xFF) << 8 ^ \
+ (S[(tt >> 16) & 0xFF] & 0xFF) << 16 ^ \
+ (S[(tt >> 24) & 0xFF] & 0xFF) << 24
+ for i in xrange(KC / 2 + 1, KC):
+ tk[i] ^= tk[i-1]
+ # copy values into round key arrays
+ j = 0
+ while j < KC and t < ROUND_KEY_COUNT:
+ Ke[t / BC][t % BC] = tk[j]
+ Kd[ROUNDS - (t / BC)][t % BC] = tk[j]
+ j += 1
+ t += 1
+ # inverse MixColumn where needed
+ for r in xrange(1, ROUNDS):
+ for j in xrange(BC):
+ tt = Kd[r][j]
+ Kd[r][j] = U1[(tt >> 24) & 0xFF] ^ \
+ U2[(tt >> 16) & 0xFF] ^ \
+ U3[(tt >> 8) & 0xFF] ^ \
+ U4[ tt & 0xFF]
+ self.Ke = Ke
+ self.Kd = Kd
+
+ def encrypt(self, plaintext):
+ if len(plaintext) != self.block_size:
+ raise ValueError('wrong block length, expected ' + str(self.block_size) + ' got ' + str(len(plaintext)))
+ Ke = self.Ke
+
+ BC = self.block_size / 4
+ ROUNDS = len(Ke) - 1
+ if BC == 4:
+ SC = 0
+ elif BC == 6:
+ SC = 1
+ else:
+ SC = 2
+ s1 = shifts[SC][1][0]
+ s2 = shifts[SC][2][0]
+ s3 = shifts[SC][3][0]
+ a = [0] * BC
+ # temporary work array
+ t = []
+ # plaintext to ints + key
+ for i in xrange(BC):
+ t.append((ord(plaintext[i * 4 ]) << 24 |
+ ord(plaintext[i * 4 + 1]) << 16 |
+ ord(plaintext[i * 4 + 2]) << 8 |
+ ord(plaintext[i * 4 + 3]) ) ^ Ke[0][i])
+ # apply round transforms
+ for r in xrange(1, ROUNDS):
+ for i in xrange(BC):
+ a[i] = (T1[(t[ i ] >> 24) & 0xFF] ^
+ T2[(t[(i + s1) % BC] >> 16) & 0xFF] ^
+ T3[(t[(i + s2) % BC] >> 8) & 0xFF] ^
+ T4[ t[(i + s3) % BC] & 0xFF] ) ^ Ke[r][i]
+ t = copy.copy(a)
+ # last round is special
+ result = []
+ for i in xrange(BC):
+ tt = Ke[ROUNDS][i]
+ result.append((S[(t[ i ] >> 24) & 0xFF] ^ (tt >> 24)) & 0xFF)
+ result.append((S[(t[(i + s1) % BC] >> 16) & 0xFF] ^ (tt >> 16)) & 0xFF)
+ result.append((S[(t[(i + s2) % BC] >> 8) & 0xFF] ^ (tt >> 8)) & 0xFF)
+ result.append((S[ t[(i + s3) % BC] & 0xFF] ^ tt ) & 0xFF)
+ return string.join(map(chr, result), '')
+
+ def decrypt(self, ciphertext):
+ if len(ciphertext) != self.block_size:
+ raise ValueError('wrong block length, expected ' + str(self.block_size) + ' got ' + str(len(plaintext)))
+ Kd = self.Kd
+
+ BC = self.block_size / 4
+ ROUNDS = len(Kd) - 1
+ if BC == 4:
+ SC = 0
+ elif BC == 6:
+ SC = 1
+ else:
+ SC = 2
+ s1 = shifts[SC][1][1]
+ s2 = shifts[SC][2][1]
+ s3 = shifts[SC][3][1]
+ a = [0] * BC
+ # temporary work array
+ t = [0] * BC
+ # ciphertext to ints + key
+ for i in xrange(BC):
+ t[i] = (ord(ciphertext[i * 4 ]) << 24 |
+ ord(ciphertext[i * 4 + 1]) << 16 |
+ ord(ciphertext[i * 4 + 2]) << 8 |
+ ord(ciphertext[i * 4 + 3]) ) ^ Kd[0][i]
+ # apply round transforms
+ for r in xrange(1, ROUNDS):
+ for i in xrange(BC):
+ a[i] = (T5[(t[ i ] >> 24) & 0xFF] ^
+ T6[(t[(i + s1) % BC] >> 16) & 0xFF] ^
+ T7[(t[(i + s2) % BC] >> 8) & 0xFF] ^
+ T8[ t[(i + s3) % BC] & 0xFF] ) ^ Kd[r][i]
+ t = copy.copy(a)
+ # last round is special
+ result = []
+ for i in xrange(BC):
+ tt = Kd[ROUNDS][i]
+ result.append((Si[(t[ i ] >> 24) & 0xFF] ^ (tt >> 24)) & 0xFF)
+ result.append((Si[(t[(i + s1) % BC] >> 16) & 0xFF] ^ (tt >> 16)) & 0xFF)
+ result.append((Si[(t[(i + s2) % BC] >> 8) & 0xFF] ^ (tt >> 8)) & 0xFF)
+ result.append((Si[ t[(i + s3) % BC] & 0xFF] ^ tt ) & 0xFF)
+ return string.join(map(chr, result), '')
+
+def encrypt(key, block):
+ return rijndael(key, len(block)).encrypt(block)
+
+def decrypt(key, block):
+ return rijndael(key, len(block)).decrypt(block)
+
+def test():
+ def t(kl, bl):
+ b = 'b' * bl
+ r = rijndael('a' * kl, bl)
+ assert r.decrypt(r.encrypt(b)) == b
+ t(16, 16)
+ t(16, 24)
+ t(16, 32)
+ t(24, 16)
+ t(24, 24)
+ t(24, 32)
+ t(32, 16)
+ t(32, 24)
+ t(32, 32)
+
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/win32prng.c b/samples/apps/marketplace_sample/gdata/tlslite/utils/win32prng.c
new file mode 100755
index 0000000..de08b3b
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/win32prng.c
@@ -0,0 +1,63 @@
+
+#include "Python.h"
+#define _WIN32_WINNT 0x0400 /* Needed for CryptoAPI on some systems */
+#include <windows.h>
+
+
+static PyObject* getRandomBytes(PyObject *self, PyObject *args)
+{
+ int howMany;
+ HCRYPTPROV hCryptProv;
+ unsigned char* bytes = NULL;
+ PyObject* returnVal = NULL;
+
+
+ /* Read Arguments */
+ if (!PyArg_ParseTuple(args, "i", &howMany))
+ return(NULL);
+
+ /* Get Context */
+ if(CryptAcquireContext(
+ &hCryptProv,
+ NULL,
+ NULL,
+ PROV_RSA_FULL,
+ CRYPT_VERIFYCONTEXT) == 0)
+ return Py_BuildValue("s#", NULL, 0);
+
+
+ /* Allocate bytes */
+ bytes = malloc(howMany);
+
+
+ /* Get random data */
+ if(CryptGenRandom(
+ hCryptProv,
+ howMany,
+ bytes) == 0)
+ returnVal = Py_BuildValue("s#", NULL, 0);
+ else
+ returnVal = Py_BuildValue("s#", bytes, howMany);
+
+ free(bytes);
+ CryptReleaseContext(hCryptProv, 0);
+
+ return returnVal;
+}
+
+
+
+/* List of functions exported by this module */
+
+static struct PyMethodDef win32prng_functions[] = {
+ {"getRandomBytes", (PyCFunction)getRandomBytes, METH_VARARGS},
+ {NULL, NULL} /* Sentinel */
+};
+
+
+/* Initialize this module. */
+
+DL_EXPORT(void) initwin32prng(void)
+{
+ Py_InitModule("win32prng", win32prng_functions);
+}
diff --git a/samples/apps/marketplace_sample/gdata/tlslite/utils/xmltools.py b/samples/apps/marketplace_sample/gdata/tlslite/utils/xmltools.py
new file mode 100755
index 0000000..c1e8c4d
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/tlslite/utils/xmltools.py
@@ -0,0 +1,202 @@
+"""Helper functions for XML.
+
+This module has misc. helper functions for working with XML DOM nodes."""
+
+from compat import *
+import os
+import re
+
+if os.name == "java":
+ # Only for Jython
+ from javax.xml.parsers import *
+ import java
+
+ builder = DocumentBuilderFactory.newInstance().newDocumentBuilder()
+
+ def parseDocument(s):
+ stream = java.io.ByteArrayInputStream(java.lang.String(s).getBytes())
+ return builder.parse(stream)
+else:
+ from xml.dom import minidom
+ from xml.sax import saxutils
+
+ def parseDocument(s):
+ return minidom.parseString(s)
+
+def parseAndStripWhitespace(s):
+ try:
+ element = parseDocument(s).documentElement
+ except BaseException, e:
+ raise SyntaxError(str(e))
+ stripWhitespace(element)
+ return element
+
+#Goes through a DOM tree and removes whitespace besides child elements,
+#as long as this whitespace is correctly tab-ified
+def stripWhitespace(element, tab=0):
+ element.normalize()
+
+ lastSpacer = "\n" + ("\t"*tab)
+ spacer = lastSpacer + "\t"
+
+ #Zero children aren't allowed (i.e. <empty/>)
+ #This makes writing output simpler, and matches Canonical XML
+ if element.childNodes.length==0: #DON'T DO len(element.childNodes) - doesn't work in Jython
+ raise SyntaxError("Empty XML elements not allowed")
+
+ #If there's a single child, it must be text context
+ if element.childNodes.length==1:
+ if element.firstChild.nodeType == element.firstChild.TEXT_NODE:
+ #If it's an empty element, remove
+ if element.firstChild.data == lastSpacer:
+ element.removeChild(element.firstChild)
+ return
+ #If not text content, give an error
+ elif element.firstChild.nodeType == element.firstChild.ELEMENT_NODE:
+ raise SyntaxError("Bad whitespace under '%s'" % element.tagName)
+ else:
+ raise SyntaxError("Unexpected node type in XML document")
+
+ #Otherwise there's multiple child element
+ child = element.firstChild
+ while child:
+ if child.nodeType == child.ELEMENT_NODE:
+ stripWhitespace(child, tab+1)
+ child = child.nextSibling
+ elif child.nodeType == child.TEXT_NODE:
+ if child == element.lastChild:
+ if child.data != lastSpacer:
+ raise SyntaxError("Bad whitespace under '%s'" % element.tagName)
+ elif child.data != spacer:
+ raise SyntaxError("Bad whitespace under '%s'" % element.tagName)
+ next = child.nextSibling
+ element.removeChild(child)
+ child = next
+ else:
+ raise SyntaxError("Unexpected node type in XML document")
+
+
+def checkName(element, name):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Missing element: '%s'" % name)
+
+ if name == None:
+ return
+
+ if element.tagName != name:
+ raise SyntaxError("Wrong element name: should be '%s', is '%s'" % (name, element.tagName))
+
+def getChild(element, index, name=None):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in getChild()")
+
+ child = element.childNodes.item(index)
+ if child == None:
+ raise SyntaxError("Missing child: '%s'" % name)
+ checkName(child, name)
+ return child
+
+def getChildIter(element, index):
+ class ChildIter:
+ def __init__(self, element, index):
+ self.element = element
+ self.index = index
+
+ def next(self):
+ if self.index < len(self.element.childNodes):
+ retVal = self.element.childNodes.item(self.index)
+ self.index += 1
+ else:
+ retVal = None
+ return retVal
+
+ def checkEnd(self):
+ if self.index != len(self.element.childNodes):
+ raise SyntaxError("Too many elements under: '%s'" % self.element.tagName)
+ return ChildIter(element, index)
+
+def getChildOrNone(element, index):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in getChild()")
+ child = element.childNodes.item(index)
+ return child
+
+def getLastChild(element, index, name=None):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in getLastChild()")
+
+ child = element.childNodes.item(index)
+ if child == None:
+ raise SyntaxError("Missing child: '%s'" % name)
+ if child != element.lastChild:
+ raise SyntaxError("Too many elements under: '%s'" % element.tagName)
+ checkName(child, name)
+ return child
+
+#Regular expressions for syntax-checking attribute and element content
+nsRegEx = "http://trevp.net/cryptoID\Z"
+cryptoIDRegEx = "([a-km-z3-9]{5}\.){3}[a-km-z3-9]{5}\Z"
+urlRegEx = "http(s)?://.{1,100}\Z"
+sha1Base64RegEx = "[A-Za-z0-9+/]{27}=\Z"
+base64RegEx = "[A-Za-z0-9+/]+={0,4}\Z"
+certsListRegEx = "(0)?(1)?(2)?(3)?(4)?(5)?(6)?(7)?(8)?(9)?\Z"
+keyRegEx = "[A-Z]\Z"
+keysListRegEx = "(A)?(B)?(C)?(D)?(E)?(F)?(G)?(H)?(I)?(J)?(K)?(L)?(M)?(N)?(O)?(P)?(Q)?(R)?(S)?(T)?(U)?(V)?(W)?(X)?(Y)?(Z)?\Z"
+dateTimeRegEx = "\d\d\d\d-\d\d-\d\dT\d\d:\d\d:\d\dZ\Z"
+shortStringRegEx = ".{1,100}\Z"
+exprRegEx = "[a-zA-Z0-9 ,()]{1,200}\Z"
+notAfterDeltaRegEx = "0|([1-9][0-9]{0,8})\Z" #A number from 0 to (1 billion)-1
+booleanRegEx = "(true)|(false)"
+
+def getReqAttribute(element, attrName, regEx=""):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in getReqAttribute()")
+
+ value = element.getAttribute(attrName)
+ if not value:
+ raise SyntaxError("Missing Attribute: " + attrName)
+ if not re.match(regEx, value):
+ raise SyntaxError("Bad Attribute Value for '%s': '%s' " % (attrName, value))
+ element.removeAttribute(attrName)
+ return str(value) #de-unicode it; this is needed for bsddb, for example
+
+def getAttribute(element, attrName, regEx=""):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in getAttribute()")
+
+ value = element.getAttribute(attrName)
+ if value:
+ if not re.match(regEx, value):
+ raise SyntaxError("Bad Attribute Value for '%s': '%s' " % (attrName, value))
+ element.removeAttribute(attrName)
+ return str(value) #de-unicode it; this is needed for bsddb, for example
+
+def checkNoMoreAttributes(element):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in checkNoMoreAttributes()")
+
+ if element.attributes.length!=0:
+ raise SyntaxError("Extra attributes on '%s'" % element.tagName)
+
+def getText(element, regEx=""):
+ textNode = element.firstChild
+ if textNode == None:
+ raise SyntaxError("Empty element '%s'" % element.tagName)
+ if textNode.nodeType != textNode.TEXT_NODE:
+ raise SyntaxError("Non-text node: '%s'" % element.tagName)
+ if not re.match(regEx, textNode.data):
+ raise SyntaxError("Bad Text Value for '%s': '%s' " % (element.tagName, textNode.data))
+ return str(textNode.data) #de-unicode it; this is needed for bsddb, for example
+
+#Function for adding tabs to a string
+def indent(s, steps, ch="\t"):
+ tabs = ch*steps
+ if s[-1] != "\n":
+ s = tabs + s.replace("\n", "\n"+tabs)
+ else:
+ s = tabs + s.replace("\n", "\n"+tabs)
+ s = s[ : -len(tabs)]
+ return s
+
+def escape(s):
+ return saxutils.escape(s)
diff --git a/samples/apps/marketplace_sample/gdata/urlfetch.py b/samples/apps/marketplace_sample/gdata/urlfetch.py
new file mode 100644
index 0000000..890b257
--- /dev/null
+++ b/samples/apps/marketplace_sample/gdata/urlfetch.py
@@ -0,0 +1,247 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Provides HTTP functions for gdata.service to use on Google App Engine
+
+AppEngineHttpClient: Provides an HTTP request method which uses App Engine's
+ urlfetch API. Set the http_client member of a GDataService object to an
+ instance of an AppEngineHttpClient to allow the gdata library to run on
+ Google App Engine.
+
+run_on_appengine: Function which will modify an existing GDataService object
+ to allow it to run on App Engine. It works by creating a new instance of
+ the AppEngineHttpClient and replacing the GDataService object's
+ http_client.
+
+HttpRequest: Function that wraps google.appengine.api.urlfetch.Fetch in a
+ common interface which is used by gdata.service.GDataService. In other
+ words, this module can be used as the gdata service request handler so
+ that all HTTP requests will be performed by the hosting Google App Engine
+ server.
+"""
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import StringIO
+import atom.service
+import atom.http_interface
+from google.appengine.api import urlfetch
+
+
+def run_on_appengine(gdata_service):
+ """Modifies a GDataService object to allow it to run on App Engine.
+
+ Args:
+ gdata_service: An instance of AtomService, GDataService, or any
+ of their subclasses which has an http_client member.
+ """
+ gdata_service.http_client = AppEngineHttpClient()
+
+
+class AppEngineHttpClient(atom.http_interface.GenericHttpClient):
+ def __init__(self, headers=None):
+ self.debug = False
+ self.headers = headers or {}
+
+ def request(self, operation, url, data=None, headers=None):
+ """Performs an HTTP call to the server, supports GET, POST, PUT, and
+ DELETE.
+
+ Usage example, perform and HTTP GET on http://www.google.com/:
+ import atom.http
+ client = atom.http.HttpClient()
+ http_response = client.request('GET', 'http://www.google.com/')
+
+ Args:
+ operation: str The HTTP operation to be performed. This is usually one
+ of 'GET', 'POST', 'PUT', or 'DELETE'
+ data: filestream, list of parts, or other object which can be converted
+ to a string. Should be set to None when performing a GET or DELETE.
+ If data is a file-like object which can be read, this method will
+ read a chunk of 100K bytes at a time and send them.
+ If the data is a list of parts to be sent, each part will be
+ evaluated and sent.
+ url: The full URL to which the request should be sent. Can be a string
+ or atom.url.Url.
+ headers: dict of strings. HTTP headers which should be sent
+ in the request.
+ """
+ all_headers = self.headers.copy()
+ if headers:
+ all_headers.update(headers)
+
+ # Construct the full payload.
+ # Assume that data is None or a string.
+ data_str = data
+ if data:
+ if isinstance(data, list):
+ # If data is a list of different objects, convert them all to strings
+ # and join them together.
+ converted_parts = [__ConvertDataPart(x) for x in data]
+ data_str = ''.join(converted_parts)
+ else:
+ data_str = __ConvertDataPart(data)
+
+ # If the list of headers does not include a Content-Length, attempt to
+ # calculate it based on the data object.
+ if data and 'Content-Length' not in all_headers:
+ all_headers['Content-Length'] = len(data_str)
+
+ # Set the content type to the default value if none was set.
+ if 'Content-Type' not in all_headers:
+ all_headers['Content-Type'] = 'application/atom+xml'
+
+ # Lookup the urlfetch operation which corresponds to the desired HTTP verb.
+ if operation == 'GET':
+ method = urlfetch.GET
+ elif operation == 'POST':
+ method = urlfetch.POST
+ elif operation == 'PUT':
+ method = urlfetch.PUT
+ elif operation == 'DELETE':
+ method = urlfetch.DELETE
+ else:
+ method = None
+ return HttpResponse(urlfetch.Fetch(url=str(url), payload=data_str,
+ method=method, headers=all_headers))
+
+
+def HttpRequest(service, operation, data, uri, extra_headers=None,
+ url_params=None, escape_params=True, content_type='application/atom+xml'):
+ """Performs an HTTP call to the server, supports GET, POST, PUT, and DELETE.
+
+ This function is deprecated, use AppEngineHttpClient.request instead.
+
+ To use this module with gdata.service, you can set this module to be the
+ http_request_handler so that HTTP requests use Google App Engine's urlfetch.
+ import gdata.service
+ import gdata.urlfetch
+ gdata.service.http_request_handler = gdata.urlfetch
+
+ Args:
+ service: atom.AtomService object which contains some of the parameters
+ needed to make the request. The following members are used to
+ construct the HTTP call: server (str), additional_headers (dict),
+ port (int), and ssl (bool).
+ operation: str The HTTP operation to be performed. This is usually one of
+ 'GET', 'POST', 'PUT', or 'DELETE'
+ data: filestream, list of parts, or other object which can be
+ converted to a string.
+ Should be set to None when performing a GET or PUT.
+ If data is a file-like object which can be read, this method will read
+ a chunk of 100K bytes at a time and send them.
+ If the data is a list of parts to be sent, each part will be evaluated
+ and sent.
+ uri: The beginning of the URL to which the request should be sent.
+ Examples: '/', '/base/feeds/snippets',
+ '/m8/feeds/contacts/default/base'
+ extra_headers: dict of strings. HTTP headers which should be sent
+ in the request. These headers are in addition to those stored in
+ service.additional_headers.
+ url_params: dict of strings. Key value pairs to be added to the URL as
+ URL parameters. For example {'foo':'bar', 'test':'param'} will
+ become ?foo=bar&test=param.
+ escape_params: bool default True. If true, the keys and values in
+ url_params will be URL escaped when the form is constructed
+ (Special characters converted to %XX form.)
+ content_type: str The MIME type for the data being sent. Defaults to
+ 'application/atom+xml', this is only used if data is set.
+ """
+ full_uri = atom.service.BuildUri(uri, url_params, escape_params)
+ (server, port, ssl, partial_uri) = atom.service.ProcessUrl(service, full_uri)
+ # Construct the full URL for the request.
+ if ssl:
+ full_url = 'https://%s%s' % (server, partial_uri)
+ else:
+ full_url = 'http://%s%s' % (server, partial_uri)
+
+ # Construct the full payload.
+ # Assume that data is None or a string.
+ data_str = data
+ if data:
+ if isinstance(data, list):
+ # If data is a list of different objects, convert them all to strings
+ # and join them together.
+ converted_parts = [__ConvertDataPart(x) for x in data]
+ data_str = ''.join(converted_parts)
+ else:
+ data_str = __ConvertDataPart(data)
+
+ # Construct the dictionary of HTTP headers.
+ headers = {}
+ if isinstance(service.additional_headers, dict):
+ headers = service.additional_headers.copy()
+ if isinstance(extra_headers, dict):
+ for header, value in extra_headers.iteritems():
+ headers[header] = value
+ # Add the content type header (we don't need to calculate content length,
+ # since urlfetch.Fetch will calculate for us).
+ if content_type:
+ headers['Content-Type'] = content_type
+
+ # Lookup the urlfetch operation which corresponds to the desired HTTP verb.
+ if operation == 'GET':
+ method = urlfetch.GET
+ elif operation == 'POST':
+ method = urlfetch.POST
+ elif operation == 'PUT':
+ method = urlfetch.PUT
+ elif operation == 'DELETE':
+ method = urlfetch.DELETE
+ else:
+ method = None
+ return HttpResponse(urlfetch.Fetch(url=full_url, payload=data_str,
+ method=method, headers=headers))
+
+
+def __ConvertDataPart(data):
+ if not data or isinstance(data, str):
+ return data
+ elif hasattr(data, 'read'):
+ # data is a file like object, so read it completely.
+ return data.read()
+ # The data object was not a file.
+ # Try to convert to a string and send the data.
+ return str(data)
+
+
+class HttpResponse(object):
+ """Translates a urlfetch resoinse to look like an hhtplib resoinse.
+
+ Used to allow the resoinse from HttpRequest to be usable by gdata.service
+ methods.
+ """
+
+ def __init__(self, urlfetch_response):
+ self.body = StringIO.StringIO(urlfetch_response.content)
+ self.headers = urlfetch_response.headers
+ self.status = urlfetch_response.status_code
+ self.reason = ''
+
+ def read(self, length=None):
+ if not length:
+ return self.body.read()
+ else:
+ return self.body.read(length)
+
+ def getheader(self, name):
+ if not self.headers.has_key(name):
+ return self.headers[name.lower()]
+ return self.headers[name]
+
diff --git a/samples/apps/marketplace_sample/images/google.png b/samples/apps/marketplace_sample/images/google.png
new file mode 100644
index 0000000..71b2b98
--- /dev/null
+++ b/samples/apps/marketplace_sample/images/google.png
Binary files differ
diff --git a/samples/apps/marketplace_sample/js/json2.js b/samples/apps/marketplace_sample/js/json2.js
new file mode 100644
index 0000000..b4c02d3
--- /dev/null
+++ b/samples/apps/marketplace_sample/js/json2.js
@@ -0,0 +1,480 @@
+/*
+ http://www.JSON.org/json2.js
+ 2011-02-23
+
+ Public Domain.
+
+ NO WARRANTY EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK.
+
+ See http://www.JSON.org/js.html
+
+
+ This code should be minified before deployment.
+ See http://javascript.crockford.com/jsmin.html
+
+ USE YOUR OWN COPY. IT IS EXTREMELY UNWISE TO LOAD CODE FROM SERVERS YOU DO
+ NOT CONTROL.
+
+
+ This file creates a global JSON object containing two methods: stringify
+ and parse.
+
+ JSON.stringify(value, replacer, space)
+ value any JavaScript value, usually an object or array.
+
+ replacer an optional parameter that determines how object
+ values are stringified for objects. It can be a
+ function or an array of strings.
+
+ space an optional parameter that specifies the indentation
+ of nested structures. If it is omitted, the text will
+ be packed without extra whitespace. If it is a number,
+ it will specify the number of spaces to indent at each
+ level. If it is a string (such as '\t' or ' '),
+ it contains the characters used to indent at each level.
+
+ This method produces a JSON text from a JavaScript value.
+
+ When an object value is found, if the object contains a toJSON
+ method, its toJSON method will be called and the result will be
+ stringified. A toJSON method does not serialize: it returns the
+ value represented by the name/value pair that should be serialized,
+ or undefined if nothing should be serialized. The toJSON method
+ will be passed the key associated with the value, and this will be
+ bound to the value
+
+ For example, this would serialize Dates as ISO strings.
+
+ Date.prototype.toJSON = function (key) {
+ function f(n) {
+ // Format integers to have at least two digits.
+ return n < 10 ? '0' + n : n;
+ }
+
+ return this.getUTCFullYear() + '-' +
+ f(this.getUTCMonth() + 1) + '-' +
+ f(this.getUTCDate()) + 'T' +
+ f(this.getUTCHours()) + ':' +
+ f(this.getUTCMinutes()) + ':' +
+ f(this.getUTCSeconds()) + 'Z';
+ };
+
+ You can provide an optional replacer method. It will be passed the
+ key and value of each member, with this bound to the containing
+ object. The value that is returned from your method will be
+ serialized. If your method returns undefined, then the member will
+ be excluded from the serialization.
+
+ If the replacer parameter is an array of strings, then it will be
+ used to select the members to be serialized. It filters the results
+ such that only members with keys listed in the replacer array are
+ stringified.
+
+ Values that do not have JSON representations, such as undefined or
+ functions, will not be serialized. Such values in objects will be
+ dropped; in arrays they will be replaced with null. You can use
+ a replacer function to replace those with JSON values.
+ JSON.stringify(undefined) returns undefined.
+
+ The optional space parameter produces a stringification of the
+ value that is filled with line breaks and indentation to make it
+ easier to read.
+
+ If the space parameter is a non-empty string, then that string will
+ be used for indentation. If the space parameter is a number, then
+ the indentation will be that many spaces.
+
+ Example:
+
+ text = JSON.stringify(['e', {pluribus: 'unum'}]);
+ // text is '["e",{"pluribus":"unum"}]'
+
+
+ text = JSON.stringify(['e', {pluribus: 'unum'}], null, '\t');
+ // text is '[\n\t"e",\n\t{\n\t\t"pluribus": "unum"\n\t}\n]'
+
+ text = JSON.stringify([new Date()], function (key, value) {
+ return this[key] instanceof Date ?
+ 'Date(' + this[key] + ')' : value;
+ });
+ // text is '["Date(---current time---)"]'
+
+
+ JSON.parse(text, reviver)
+ This method parses a JSON text to produce an object or array.
+ It can throw a SyntaxError exception.
+
+ The optional reviver parameter is a function that can filter and
+ transform the results. It receives each of the keys and values,
+ and its return value is used instead of the original value.
+ If it returns what it received, then the structure is not modified.
+ If it returns undefined then the member is deleted.
+
+ Example:
+
+ // Parse the text. Values that look like ISO date strings will
+ // be converted to Date objects.
+
+ myData = JSON.parse(text, function (key, value) {
+ var a;
+ if (typeof value === 'string') {
+ a =
+/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2}(?:\.\d*)?)Z$/.exec(value);
+ if (a) {
+ return new Date(Date.UTC(+a[1], +a[2] - 1, +a[3], +a[4],
+ +a[5], +a[6]));
+ }
+ }
+ return value;
+ });
+
+ myData = JSON.parse('["Date(09/09/2001)"]', function (key, value) {
+ var d;
+ if (typeof value === 'string' &&
+ value.slice(0, 5) === 'Date(' &&
+ value.slice(-1) === ')') {
+ d = new Date(value.slice(5, -1));
+ if (d) {
+ return d;
+ }
+ }
+ return value;
+ });
+
+
+ This is a reference implementation. You are free to copy, modify, or
+ redistribute.
+*/
+
+/*jslint evil: true, strict: false, regexp: false */
+
+/*members "", "\b", "\t", "\n", "\f", "\r", "\"", JSON, "\\", apply,
+ call, charCodeAt, getUTCDate, getUTCFullYear, getUTCHours,
+ getUTCMinutes, getUTCMonth, getUTCSeconds, hasOwnProperty, join,
+ lastIndex, length, parse, prototype, push, replace, slice, stringify,
+ test, toJSON, toString, valueOf
+*/
+
+
+// Create a JSON object only if one does not already exist. We create the
+// methods in a closure to avoid creating global variables.
+
+var JSON;
+if (!JSON) {
+ JSON = {};
+}
+
+(function () {
+ "use strict";
+
+ function f(n) {
+ // Format integers to have at least two digits.
+ return n < 10 ? '0' + n : n;
+ }
+
+ if (typeof Date.prototype.toJSON !== 'function') {
+
+ Date.prototype.toJSON = function (key) {
+
+ return isFinite(this.valueOf()) ?
+ this.getUTCFullYear() + '-' +
+ f(this.getUTCMonth() + 1) + '-' +
+ f(this.getUTCDate()) + 'T' +
+ f(this.getUTCHours()) + ':' +
+ f(this.getUTCMinutes()) + ':' +
+ f(this.getUTCSeconds()) + 'Z' : null;
+ };
+
+ String.prototype.toJSON =
+ Number.prototype.toJSON =
+ Boolean.prototype.toJSON = function (key) {
+ return this.valueOf();
+ };
+ }
+
+ var cx = /[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
+ escapable = /[\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
+ gap,
+ indent,
+ meta = { // table of character substitutions
+ '\b': '\\b',
+ '\t': '\\t',
+ '\n': '\\n',
+ '\f': '\\f',
+ '\r': '\\r',
+ '"' : '\\"',
+ '\\': '\\\\'
+ },
+ rep;
+
+
+ function quote(string) {
+
+// If the string contains no control characters, no quote characters, and no
+// backslash characters, then we can safely slap some quotes around it.
+// Otherwise we must also replace the offending characters with safe escape
+// sequences.
+
+ escapable.lastIndex = 0;
+ return escapable.test(string) ? '"' + string.replace(escapable, function (a) {
+ var c = meta[a];
+ return typeof c === 'string' ? c :
+ '\\u' + ('0000' + a.charCodeAt(0).toString(16)).slice(-4);
+ }) + '"' : '"' + string + '"';
+ }
+
+
+ function str(key, holder) {
+
+// Produce a string from holder[key].
+
+ var i, // The loop counter.
+ k, // The member key.
+ v, // The member value.
+ length,
+ mind = gap,
+ partial,
+ value = holder[key];
+
+// If the value has a toJSON method, call it to obtain a replacement value.
+
+ if (value && typeof value === 'object' &&
+ typeof value.toJSON === 'function') {
+ value = value.toJSON(key);
+ }
+
+// If we were called with a replacer function, then call the replacer to
+// obtain a replacement value.
+
+ if (typeof rep === 'function') {
+ value = rep.call(holder, key, value);
+ }
+
+// What happens next depends on the value's type.
+
+ switch (typeof value) {
+ case 'string':
+ return quote(value);
+
+ case 'number':
+
+// JSON numbers must be finite. Encode non-finite numbers as null.
+
+ return isFinite(value) ? String(value) : 'null';
+
+ case 'boolean':
+ case 'null':
+
+// If the value is a boolean or null, convert it to a string. Note:
+// typeof null does not produce 'null'. The case is included here in
+// the remote chance that this gets fixed someday.
+
+ return String(value);
+
+// If the type is 'object', we might be dealing with an object or an array or
+// null.
+
+ case 'object':
+
+// Due to a specification blunder in ECMAScript, typeof null is 'object',
+// so watch out for that case.
+
+ if (!value) {
+ return 'null';
+ }
+
+// Make an array to hold the partial results of stringifying this object value.
+
+ gap += indent;
+ partial = [];
+
+// Is the value an array?
+
+ if (Object.prototype.toString.apply(value) === '[object Array]') {
+
+// The value is an array. Stringify every element. Use null as a placeholder
+// for non-JSON values.
+
+ length = value.length;
+ for (i = 0; i < length; i += 1) {
+ partial[i] = str(i, value) || 'null';
+ }
+
+// Join all of the elements together, separated with commas, and wrap them in
+// brackets.
+
+ v = partial.length === 0 ? '[]' : gap ?
+ '[\n' + gap + partial.join(',\n' + gap) + '\n' + mind + ']' :
+ '[' + partial.join(',') + ']';
+ gap = mind;
+ return v;
+ }
+
+// If the replacer is an array, use it to select the members to be stringified.
+
+ if (rep && typeof rep === 'object') {
+ length = rep.length;
+ for (i = 0; i < length; i += 1) {
+ if (typeof rep[i] === 'string') {
+ k = rep[i];
+ v = str(k, value);
+ if (v) {
+ partial.push(quote(k) + (gap ? ': ' : ':') + v);
+ }
+ }
+ }
+ } else {
+
+// Otherwise, iterate through all of the keys in the object.
+
+ for (k in value) {
+ if (Object.prototype.hasOwnProperty.call(value, k)) {
+ v = str(k, value);
+ if (v) {
+ partial.push(quote(k) + (gap ? ': ' : ':') + v);
+ }
+ }
+ }
+ }
+
+// Join all of the member texts together, separated with commas,
+// and wrap them in braces.
+
+ v = partial.length === 0 ? '{}' : gap ?
+ '{\n' + gap + partial.join(',\n' + gap) + '\n' + mind + '}' :
+ '{' + partial.join(',') + '}';
+ gap = mind;
+ return v;
+ }
+ }
+
+// If the JSON object does not yet have a stringify method, give it one.
+
+ if (typeof JSON.stringify !== 'function') {
+ JSON.stringify = function (value, replacer, space) {
+
+// The stringify method takes a value and an optional replacer, and an optional
+// space parameter, and returns a JSON text. The replacer can be a function
+// that can replace values, or an array of strings that will select the keys.
+// A default replacer method can be provided. Use of the space parameter can
+// produce text that is more easily readable.
+
+ var i;
+ gap = '';
+ indent = '';
+
+// If the space parameter is a number, make an indent string containing that
+// many spaces.
+
+ if (typeof space === 'number') {
+ for (i = 0; i < space; i += 1) {
+ indent += ' ';
+ }
+
+// If the space parameter is a string, it will be used as the indent string.
+
+ } else if (typeof space === 'string') {
+ indent = space;
+ }
+
+// If there is a replacer, it must be a function or an array.
+// Otherwise, throw an error.
+
+ rep = replacer;
+ if (replacer && typeof replacer !== 'function' &&
+ (typeof replacer !== 'object' ||
+ typeof replacer.length !== 'number')) {
+ throw new Error('JSON.stringify');
+ }
+
+// Make a fake root object containing our value under the key of ''.
+// Return the result of stringifying the value.
+
+ return str('', {'': value});
+ };
+ }
+
+
+// If the JSON object does not yet have a parse method, give it one.
+
+ if (typeof JSON.parse !== 'function') {
+ JSON.parse = function (text, reviver) {
+
+// The parse method takes a text and an optional reviver function, and returns
+// a JavaScript value if the text is a valid JSON text.
+
+ var j;
+
+ function walk(holder, key) {
+
+// The walk method is used to recursively walk the resulting structure so
+// that modifications can be made.
+
+ var k, v, value = holder[key];
+ if (value && typeof value === 'object') {
+ for (k in value) {
+ if (Object.prototype.hasOwnProperty.call(value, k)) {
+ v = walk(value, k);
+ if (v !== undefined) {
+ value[k] = v;
+ } else {
+ delete value[k];
+ }
+ }
+ }
+ }
+ return reviver.call(holder, key, value);
+ }
+
+
+// Parsing happens in four stages. In the first stage, we replace certain
+// Unicode characters with escape sequences. JavaScript handles many characters
+// incorrectly, either silently deleting them, or treating them as line endings.
+
+ text = String(text);
+ cx.lastIndex = 0;
+ if (cx.test(text)) {
+ text = text.replace(cx, function (a) {
+ return '\\u' +
+ ('0000' + a.charCodeAt(0).toString(16)).slice(-4);
+ });
+ }
+
+// In the second stage, we run the text against regular expressions that look
+// for non-JSON patterns. We are especially concerned with '()' and 'new'
+// because they can cause invocation, and '=' because it can cause mutation.
+// But just to be safe, we want to reject all unexpected forms.
+
+// We split the second stage into 4 regexp operations in order to work around
+// crippling inefficiencies in IE's and Safari's regexp engines. First we
+// replace the JSON backslash pairs with '@' (a non-JSON character). Second, we
+// replace all simple value tokens with ']' characters. Third, we delete all
+// open brackets that follow a colon or comma or that begin the text. Finally,
+// we look to see that the remaining characters are only whitespace or ']' or
+// ',' or ':' or '{' or '}'. If that is so, then the text is safe for eval.
+
+ if (/^[\],:{}\s]*$/
+ .test(text.replace(/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, '@')
+ .replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, ']')
+ .replace(/(?:^|:|,)(?:\s*\[)+/g, ''))) {
+
+// In the third stage we use the eval function to compile the text into a
+// JavaScript structure. The '{' operator is subject to a syntactic ambiguity
+// in JavaScript: it can begin a block or an object literal. We wrap the text
+// in parens to eliminate the ambiguity.
+
+ j = eval('(' + text + ')');
+
+// In the optional fourth stage, we recursively walk the new structure, passing
+// each name/value pair to a reviver function for possible transformation.
+
+ return typeof reviver === 'function' ?
+ walk({'': j}, '') : j;
+ }
+
+// If the text is not JSON parseable, then a SyntaxError is thrown.
+
+ throw new SyntaxError('JSON.parse');
+ };
+ }
+}());
diff --git a/samples/apps/marketplace_sample/js/main.js b/samples/apps/marketplace_sample/js/main.js
new file mode 100644
index 0000000..335da3b
--- /dev/null
+++ b/samples/apps/marketplace_sample/js/main.js
@@ -0,0 +1,87 @@
+/* Copyright 2012 Google Inc. All Rights Reserved.
+ *
+ * @fileoverview This file first retrieves a list of all of the domain users
+ * using an ajax call to the server. It also retrieves the user details for a
+ * particular user again using an ajax call to the server.
+ *
+ * @author gunjansharma@google.com (Gunjan Sharma)
+ */
+
+$(document).ready(function() {
+ $('#get_details').attr('disabled', true);
+ $.ajax({
+ type: 'POST',
+ url: '../',
+ dataType: 'text',
+ error: function(request, textStatus) {
+ alert('There was a problem loading data from the server.');
+ },
+ success: function(data, textStatus, request) {
+ var users = jQuery.parseJSON(data);
+ for (var i = 0; i < users.length; i++) {
+ $('#users_list')
+ .append($('<option></option>')
+ .attr('value', i)
+ .text(users[i]));
+ }
+ $('#get_details').attr('disabled', false);
+ }
+ });
+
+ $('#get_details').click(function() {
+ this.disabled = true;
+ var username = $('#users_list option:selected').text();
+ request_url = '../getdetails/' + username;
+ $.ajax({
+ type: 'GET',
+ url: request_url,
+ dataType: 'text',
+ error: function(request, textStatus) {
+ alert('There was a problem loading data from the server.');
+ $('#get_details').attr('disabled', false);
+ },
+ success: function(data, textStatus, request) {
+ var details = jQuery.parseJSON(data);
+ var groups = details['groups'];
+ var html = '<tr><td>{0}</td><td>{1}</td><td>{2}</td></tr>';
+ var groups_html =
+ '<tr align="middle"><td><b>Name</b></td><td><b>ID</b></td><tr>';
+ for (var i = 0; i < groups.length; i++) {
+ group = groups[i];
+ groups_html +=
+ ('<tr><td>' + group['name'] +
+ '</td><td>' + group['id'] +
+ '</td></tr>');
+ }
+ groups_html = '<table align="center" valign="center" border="1">' +
+ groups_html + '</table>';
+
+ var orgunit = details['orgunit'];
+ var orgunit_html = '<b>Name:</b> ' + orgunit['name'] +
+ '<br /><b>Path:</b> ' + orgunit['path'];
+
+ var nicknames = details['nicknames'];
+ nicknames_html = '';
+ for (var i = 0; i < nicknames.length; i++) {
+ nicknames_html += nicknames[i] + '<br />';
+ }
+ $('#details_table > tbody:last').append(
+ html.format(groups_html, nicknames_html, orgunit_html));
+ $('#get_details').attr('disabled', false);
+ }
+ });
+ });
+});
+
+/**
+ * Formats the string by replacing with the appropriate parameter.
+ * The function replaces {i} with the i-th parameter. Here i is an integer.
+ *
+ * @return {String} the formated string.
+ */
+String.prototype.format = function() {
+ var args = arguments;
+ return this.replace(/{(\d+)}/g, function(match, number) {
+ return typeof args[number] != 'undefined' ? args[number] : match;
+ });
+};
diff --git a/samples/apps/marketplace_sample/templates/index.html b/samples/apps/marketplace_sample/templates/index.html
new file mode 100644
index 0000000..c568cb1
--- /dev/null
+++ b/samples/apps/marketplace_sample/templates/index.html
@@ -0,0 +1,35 @@
+<html>
+ <head>
+ <script type='text/javascript' src='https://www.google.com/jsapi'></script>
+ <script>
+ google.load('jquery', '1.7.1');
+ </script>
+ <script type='text/javascript' src='js/json2.js'></script>
+ <script type='text/javascript' src='js/main.js'></script>
+
+ <link rel='stylesheet' type='text/css' href='/css/style.css' />
+ <title>User Details</title>
+ </head>
+ <body>
+ <div id='kd-googlebar' class='alternate'>
+ <img style='margin-right: 20px; margin-top:4px;' src='/images/google.png'>
+ </div>
+ <br />
+ <div id='users'>
+ Choose one user <select id='users_list'></select>
+ <button type='button' id='get_details'>Get Details</button>
+ </div>
+ <hr />
+ <br />
+ <div id='details'>
+ <table id='details_table' align='center' valign='center' border='4'>
+ <tr align='middle'>
+ <td><h2>Groups</h2></td>
+ <td><h2>Nicknames</h2></td>
+ <td><h2>Organization Unit</h2></td>
+ <tbody>
+ </tbody>
+ </tr>
+ </div>
+ </body>
+</html>
diff --git a/samples/apps/migration_example.py b/samples/apps/migration_example.py
new file mode 100755
index 0000000..3ffe34e
--- /dev/null
+++ b/samples/apps/migration_example.py
@@ -0,0 +1,180 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample app for Google Apps Email Migration features.
+
+ EmailMigrationSample: Demonstrates the use of the Email Migration API
+"""
+
+
+__author__ = 'pti@google.com (Prashant Tiwari)'
+
+
+from optparse import OptionParser
+import os
+from gdata.apps.migration import service
+
+
+class EmailMigrationSample(object):
+ """Sample application demonstrating use of the Email Migration API."""
+
+ def __init__(self, domain, email, password):
+ """Constructor for the EmailMigrationSample object.
+
+ Construct an EmailMigrationSample with the given args.
+
+ Args:
+ domain: The domain name ("domain.com")
+ email: The email account of the user or the admin ("john@domain.com")
+ password: The domain admin's password
+ """
+ self.service = service.MigrationService(
+ email=email,
+ password=password,
+ domain=domain,
+ source='googlecode-migrationsample-v1')
+ self.service.ProgrammaticLogin()
+ # Sample mail properties
+ self.mail_item_properties = ['IS_INBOX', 'IS_UNREAD']
+ self.mail_labels = ['EmailMigrationSample']
+
+ def Migrate(self, path):
+ """Migrates messages at the given path.
+
+ Args:
+ path: The file or directory path where messages are stored
+ """
+ if os.path.isfile(path):
+ if os.path.splitext(path)[1] != '.txt':
+ print "The input file is not a .txt file"
+ return
+ self._MigrateOneMail(path)
+ elif os.path.isdir(path):
+ if path.endswith(os.sep):
+ path = path[0: len(path) - 1]
+ txt_file_paths = []
+ filenames = os.listdir(path)
+ for filename in filenames:
+ # Filter out the non-txt files in the directory
+ filepath = path + os.sep + filename
+ if os.path.isfile(filepath) and os.path.splitext(filepath)[1] == '.txt':
+ txt_file_paths.append(filepath)
+ if not txt_file_paths:
+ print "Found no .txt file in the directory"
+ return
+ elif len(txt_file_paths) == 1:
+ # Don't use threading if there's only one txt file in the dir
+ self._MigrateOneMail(txt_file_paths[0])
+ else:
+ self._MigrateManyMails(txt_file_paths)
+
+ def _MigrateOneMail(self, path):
+ """Imports a single message via the ImportMail service.
+
+ Args:
+ path: The path of the message file
+ """
+ print "Attempting to migrate 1 message..."
+ content = self._ReadFileAsString(path)
+ self.service.ImportMail(user_name=options.username,
+ mail_message=content,
+ mail_item_properties=self.mail_item_properties,
+ mail_labels=self.mail_labels)
+ print "Successfully migrated 1 message."
+
+ def _MigrateManyMails(self, paths):
+ """Imports several messages via the ImportMultipleMails service.
+
+ Args:
+ paths: List of paths of message files
+ """
+ print "Attempting to migrate %d messages..." % (len(paths))
+ for path in paths:
+ content = self._ReadFileAsString(path)
+ self.service.AddMailEntry(mail_message=content,
+ mail_item_properties=self.mail_item_properties,
+ mail_labels=self.mail_labels,
+ identifier=path)
+ success = self.service.ImportMultipleMails(user_name=options.username)
+ print "Successfully migrated %d of %d messages." % (success, len(paths))
+
+ def _ReadFileAsString(self, path):
+ """Reads the file found at path into a string
+
+ Args:
+ path: The path of the message file
+
+ Returns:
+ The file contents as a string
+
+ Raises:
+ IOError: An error occurred while trying to read the file
+ """
+ try:
+ input_file = open(path, 'r')
+ file_str = []
+ for eachline in input_file:
+ file_str.append(eachline)
+ input_file.close()
+ return ''.join(file_str)
+ except IOError, e:
+ raise IOError(e.args[1] + ': ' + path)
+
+
+def main():
+ """Demonstrates the Email Migration API using EmailMigrationSample."""
+
+ usage = 'usage: %prog [options]'
+ global options
+ parser = OptionParser(usage=usage)
+ parser.add_option('-d', '--domain',
+ help="the Google Apps domain, e.g. 'domain.com'")
+ parser.add_option('-e', '--email',
+ help="the email account of the user or the admin, \
+ e.g. 'john.smith@domain.com'")
+ parser.add_option('-p', '--password',
+ help="the account password")
+ parser.add_option('-u', '--username',
+ help="the user account on which to perform operations. for\
+ non-admin users this will be their own account name. \
+ e.g. 'jane.smith'")
+ parser.add_option('-f', '--file',
+ help="the system path of an RFC822 format .txt file or\
+ directory containing multiple such files to be migrated")
+ (options, args) = parser.parse_args()
+
+ if (options.domain is None
+ or options.email is None
+ or options.password is None
+ or options.username is None
+ or options.file is None):
+ parser.print_help()
+ return
+
+ options.file = options.file.strip()
+
+ if not os.path.exists(options.file):
+ print "Invalid file or directory path"
+ return
+
+ sample = EmailMigrationSample(domain=options.domain,
+ email=options.email,
+ password=options.password)
+ sample.Migrate(options.file)
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/multidomain_quick_start_example.py b/samples/apps/multidomain_quick_start_example.py
new file mode 100644
index 0000000..4f6f591
--- /dev/null
+++ b/samples/apps/multidomain_quick_start_example.py
@@ -0,0 +1,384 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+import getopt
+import getpass
+import sys
+import gdata.apps.multidomain.client
+
+SCOPE = 'https://apps-apis.google.com/a/feeds/user/'
+USER_AGENT = 'MultiDomainQuickStartExample'
+
+
+class UserData(object):
+ """Data corresponding to a single user."""
+
+ def __init__(self):
+ self.email = ''
+ self.first_name = ''
+ self.last_name = ''
+ self.password = ''
+ self.confirm_password = 'temp'
+ self.is_admin = ''
+ self.hash_function = ''
+ self.suspended = ''
+ self.change_password = ''
+ self.ip_whitelisted = ''
+ self.quota = ''
+
+
+class MultiDomainQuickStartExample(object):
+ """Demonstrates all the functions of multidomain user provisioning."""
+
+ def __init__(self, client_id, client_secret, domain):
+ """Constructor for the MultiDomainQuickStartExample object.
+
+ Takes a client_id, client_secret and domain to create an object for
+ multidomain user provisioning.
+
+ Args:
+ client_id: [string] The clientId of the developer.
+ client_secret: [string] The clientSecret of the developer.
+ domain: [string] The domain on which the functions are to be performed.
+ """
+ self.client_id = client_id
+ self.client_secret = client_secret
+ self.domain = domain
+ token = gdata.gauth.OAuth2Token(
+ client_id=self.client_id, client_secret=self.client_secret,
+ scope=SCOPE, user_agent=USER_AGENT)
+ uri = token.generate_authorize_url()
+ print 'Please visit this URL to authorize the application:'
+ print uri
+ # Get the verification code from the standard input.
+ code = raw_input('What is the verification code? ').strip()
+ token.get_access_token(code)
+ self.multidomain_client = (
+ gdata.apps.multidomain.client.MultiDomainProvisioningClient(
+ domain=self.domain, auth_token=token))
+
+ def _PrintUserDetails(self, entry):
+ """Prints all the information for a user entry.
+
+ Args:
+ entry: [UserEntry] User entry corresponding to a user
+ """
+
+ print 'First Name: %s' % (entry.first_name)
+ print 'Last Name: %s' % (entry.last_name)
+ print 'Email: %s' % (entry.email)
+ print 'Is Admin: %s' % (entry.is_admin)
+ print 'Is Suspended: %s' % (entry.suspended)
+ print 'Change password at next login: %s' % (
+ entry.change_password_at_next_login)
+ print '\n'
+
+ def _PrintAliasDetails(self, entry):
+ """Prints all the information for a user alias entry.
+
+ Args:
+ entry: [AliasEntry] Alias entry correspoding to an alias
+ """
+
+ print 'User Email: %s' % (entry.user_email)
+ print 'Alias Email: %s' % (entry.alias_email)
+ print '\n'
+
+ def _GetChoice(self, for_field):
+ """Gets a choice for a field.
+
+ Args:
+ for_field: [string] The field for which input is to be taken.
+
+ Return:
+ True/False/None: Depending on the choice made by the user.
+ """
+ choice = int(raw_input(('Enter a choice for %s\n'
+ '1-True 2-False 3-Default/Skip: ') % (for_field)))
+ if choice == 1:
+ return True
+ elif choice == 2:
+ return False
+ return None
+
+ def _TakeUserData(self, function='create'):
+ """Takes input data for _UpdateUser and _CreateUser functions.
+
+ Args:
+ function: [string] representing the kind of function (create/update)
+ from where this function was called.
+
+ Return:
+ user_data: [UserData] All data for a user.
+ """
+ extra_stmt = ''
+ if function == 'update':
+ extra_stmt = '. Press enter to not update the field'
+ user_data = UserData()
+ while not user_data.email:
+ user_data.email = raw_input('Enter a valid email address'
+ '(username@domain.com): ')
+ while not user_data.first_name:
+ user_data.first_name = raw_input(('Enter first name for the user%s: ')
+ % (extra_stmt))
+ if function == 'update':
+ break
+ while not user_data.last_name:
+ user_data.last_name = raw_input(('Enter last name for the user%s: ')
+ % (extra_stmt))
+ if function == 'update':
+ break
+ while not user_data.password == user_data.confirm_password:
+ user_data.password = ''
+ while not user_data.password:
+ sys.stdout.write(('Enter password for the user%s: ')
+ % (extra_stmt))
+ user_data.password = getpass.getpass()
+ if function == 'update' and user_data.password.__len__() == 0:
+ break
+ if user_data.password.__len__() < 8:
+ print 'Password must be at least 8 characters long'
+ user_data.password = ''
+ if function == 'update' and user_data.password.__len__() == 0:
+ break
+ sys.stdout.write('Confirm password: ')
+ user_data.confirm_password = getpass.getpass()
+
+ user_data.is_admin = self._GetChoice('is_admin')
+ user_data.hash_function = raw_input('Enter a hash function or None: ')
+ user_data.suspended = self._GetChoice('suspended')
+ user_data.change_password = self._GetChoice('change_password')
+ user_data.ip_whitelisted = self._GetChoice('ip_whitelisted')
+ user_data.quota = raw_input('Enter a quota or None: ')
+
+ if user_data.quota == 'None' or not user_data.quota.isdigit():
+ user_data.quota = None
+ if user_data.hash_function == 'None':
+ user_data.hash_function = None
+ return user_data
+
+ def _CreateUser(self):
+ """Creates a new user account."""
+
+ user_data = self._TakeUserData()
+ self.multidomain_client.CreateUser(
+ user_data.email, user_data.first_name, user_data.last_name,
+ user_data.password, user_data.is_admin,
+ hash_function=user_data.hash_function, suspended=user_data.suspended,
+ change_password=user_data.change_password,
+ ip_whitelisted=user_data.ip_whitelisted, quota=user_data.quota)
+
+ def _UpdateUser(self):
+ """Updates a user."""
+
+ user_data = self._TakeUserData('update')
+ user_entry = self.multidomain_client.RetrieveUser(user_data.email)
+ if user_data.first_name:
+ user_entry.first_name = user_data.first_name
+ if user_data.last_name:
+ user_entry.last_name = user_data.last_name
+ if user_data.password:
+ user_entry.password = user_data.password
+ if not user_data.hash_function is None:
+ user_entry.hash_function = user_data.hash_function
+ if not user_data.quota is None:
+ user_entry.quota = user_entry.quota
+ if not user_data.is_admin is None:
+ user_entry.is_admin = (str(user_data.is_admin)).lower()
+ if not user_data.suspended is None:
+ user_entry.suspended = (str(user_data.suspended)).lower()
+ if not user_data.change_password is None:
+ user_entry.change_password = (str(user_data.change_password)).lower()
+ if not user_data.ip_whitelisted is None:
+ user_entry.ip_whitelisted = (str(user_data.ip_whitelisted)).lower()
+
+ self.multidomain_client.UpdateUser(user_data.email, user_entry)
+
+ def _RenameUser(self):
+ """Renames username of a user."""
+
+ old_email = ''
+ new_email = ''
+ while not old_email:
+ old_email = raw_input('Enter old email address(username@domain.com): ')
+ while not new_email:
+ new_email = raw_input('Enter new email address(username@domain.com): ')
+
+ self.multidomain_client.RenameUser(old_email, new_email)
+
+ def _RetrieveSingleUser(self):
+ """Retrieves a single user."""
+
+ email = ''
+ while not email:
+ email = raw_input('Enter a valid email address(username@domain.com): ')
+
+ response = self.multidomain_client.RetrieveUser(email)
+ self._PrintUserDetails(response)
+
+ def _RetrieveAllUsers(self):
+ """Retrieves all users from all the domains."""
+
+ response = self.multidomain_client.RetrieveAllUsers()
+ for entry in response.entry:
+ self._PrintUserDetails(entry)
+
+ def _DeleteUser(self):
+ """Deletes a user."""
+
+ email = ''
+ while not email:
+ email = raw_input('Enter a valid email address(username@domain.com): ')
+
+ self.multidomain_client.DeleteUser(email)
+
+ def _CreateUserAlias(self):
+ """Creates a user alias."""
+
+ email = ''
+ alias = ''
+ while not email:
+ email = raw_input('Enter a valid email address(username@domain.com): ')
+ while not alias:
+ alias = raw_input('Enter a valid alias email address'
+ '(username@domain.com): ')
+ self.multidomain_client.CreateAlias(email, alias)
+
+ def _RetrieveAlias(self):
+ """Retrieves a user corresponding to an alias."""
+
+ alias = ''
+ while not alias:
+ alias = raw_input('Enter a valid alias email address'
+ '(username@domain.com): ')
+ response = self.multidomain_client.RetrieveAlias(alias)
+ self._PrintAliasDetails(response)
+
+ def _RetrieveAllAliases(self):
+ """Retrieves all user aliases for all users."""
+
+ response = self.multidomain_client.RetrieveAllAliases()
+ for entry in response.entry:
+ self._PrintAliasDetails(entry)
+
+ def _RetrieveAllUserAliases(self):
+ """Retrieves all user aliases of a user."""
+
+ email = ''
+ while not email:
+ email = raw_input('Enter a valid email address(username@domain.com): ')
+ response = self.multidomain_client.RetrieveAllUserAliases(email)
+ for entry in response.entry:
+ self._PrintAliasDetails(entry)
+
+ def _DeleteAlias(self):
+ """Deletes a user alias."""
+
+ alias = ''
+ while not alias:
+ alias = raw_input('Enter a valid alias email address'
+ '(username@domain.com): ')
+ self.multidomain_client.DeleteAlias(alias)
+
+ def Run(self):
+ """Runs the sample by getting user input and takin appropriate action."""
+
+ #List of all the function and there description
+ functions_list = [
+ {'function': self._CreateUser,
+ 'description': 'Create a user'},
+ {'function': self._UpdateUser,
+ 'description': 'Updating a user'},
+ {'function': self._RenameUser,
+ 'description': 'Renaming a user'},
+ {'function': self._RetrieveSingleUser,
+ 'description': 'Retrieve a single user'},
+ {'function': self._RetrieveAllUsers,
+ 'description': 'Retrieve all users in all domains'},
+ {'function': self._DeleteUser,
+ 'description': 'Deleting a User from a domain'},
+ {'function': self._CreateUserAlias,
+ 'description': 'Create a User Alias in a domain'},
+ {'function': self._RetrieveAlias,
+ 'description': 'Retrieve a User Alias in a domain'},
+ {'function': self._RetrieveAllAliases,
+ 'description': 'Retrieve all User Aliases in a Domain'},
+ {'function': self._RetrieveAllUserAliases,
+ 'description': 'Retrieve all User Aliases for a User'},
+ {'function': self._DeleteAlias,
+ 'description': 'Delete a user alias from a domain'}
+ ]
+
+ while True:
+ print 'Choose an option:\n0 - to exit'
+ for i in range (0, len(functions_list)):
+ print '%d - %s' % ((i+1), functions_list[i]['description'])
+ choice = int(raw_input())
+ if choice == 0:
+ break
+ if choice < 0 or choice > len(functions_list):
+ print 'Not a valid option!'
+ continue
+ functions_list[choice-1]['function']()
+
+
+def main():
+ """Runs the sample using an instance of MultiDomainQuickStartExample."""
+
+ # Parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['client_id=',
+ 'client_secret=',
+ 'domain='])
+ except getopt.error, msg:
+ print ('python multidomain_provisioning_quick_start_example.py'
+ '--client_id [clientId] --client_secret [clientSecret]'
+ '--domain [domain]')
+ sys.exit(2)
+
+ client_id = ''
+ client_secret = ''
+ domain = ''
+ # Parse options
+ for option, arg in opts:
+ if option == '--client_id':
+ client_id = arg
+ elif option == '--client_secret':
+ client_secret = arg
+ elif option == '--domain':
+ domain = arg
+
+ while not client_id:
+ client_id = raw_input('Please enter a clientId: ')
+ while not client_secret:
+ client_secret = raw_input('Please enter a clientSecret: ')
+ while not domain:
+ domain = raw_input('Please enter domain name (example.com): ')
+
+ try:
+ multidomain_quick_start_example = MultiDomainQuickStartExample(
+ client_id, client_secret, domain)
+ except gdata.service.BadAuthentication:
+ print 'Invalid user credentials given.'
+ return
+
+ multidomain_quick_start_example.Run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/org_unit_sites.py b/samples/apps/org_unit_sites.py
new file mode 100644
index 0000000..3b8a516
--- /dev/null
+++ b/samples/apps/org_unit_sites.py
@@ -0,0 +1,367 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007, 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+import getopt
+import getpass
+import sys
+import time
+import atom
+import atom.data
+import gdata.apps.multidomain.client
+import gdata.apps.organization.service
+import gdata.apps.service
+import gdata.client
+import gdata.contacts.client
+import gdata.contacts.data
+import gdata.contacts.service
+import gdata.sites.client
+import gdata.sites.data
+
+#The title for the site
+ORG_SITE_TITLE = 'Organization Hierarchy'
+#Title for the users site
+USER_SITE_TITLE = 'Users'
+#The template URI for a site
+URI = 'https://sites.google.com/a/%s/%s/'
+#Description for the sites
+DESCRIPTION = 'Under Construction'
+#Theme for the sites
+THEME = 'slate'
+#Header for the new webpages
+HTML_HEADER = ('<html:div xmlns:html="http://www.w3.org/1999/xhtml">'
+ '<html:table cellspacing="0" class='
+ '"sites-layout-name-one-column sites-layout-hbox"><html:tbody>'
+ '<html:tr><html:td class="sites-layout-tile '
+ 'sites-tile-name-content-1">')
+#Footer for the new webpages
+HTML_FOOTER = '</html:td></html:tr></html:tbody></html:table></html:div>'
+#The template string for each user's html page
+TEMPLATE_USER_HTML = ('<h2>Name:</h2><p>%s</p><h2>Gender:</h2><p> %s</p>'
+ '<h2>Address:</h2><p>%s</p><h2>Email:</h2><p>%s</p>')
+
+
+class OrgUnitAddressBook(object):
+ """Creates organization unit sites from the domain."""
+
+ def __init__(self, email, password, domain):
+ """Constructor for the OrgUnitSites object.
+
+ Takes an email, password and domain to create a site map corresponding
+ to the organization units in the domain.
+
+ Args:
+ email: [string] The email address of the admin.
+ password: [string] The password corresponding to the admin account.
+ domain: [string] The domain for which sites are to be made.
+
+ Returns:
+ A OrgUnitSites object used to run the site making.
+ """
+ source = 'Making sites corresponding to org units'
+ self.domain = domain
+ # Create sites object
+ self.sites_client = gdata.sites.client.SitesClient(source=source,
+ domain=domain)
+ self.sites_client.ClientLogin(email, password, self.sites_client.source);
+ #Get the sites feed
+ self.all_site_feed = self.sites_client.GetSiteFeed()
+
+ # Create google contacts object
+ self.profiles_client = gdata.contacts.client.ContactsClient(domain=domain)
+ self.profiles_client.client_login(email, password, 'cp', service='cp')
+
+ # Create an Organization Unit Client
+ self.org_unit_client = gdata.apps.organization.service.OrganizationService(
+ email=email, domain=domain, password=password)
+ self.org_unit_client.ProgrammaticLogin()
+ customer_id_set = self.org_unit_client.RetrieveCustomerId()
+ self.customer_id = customer_id_set['customerId']
+
+ def _GetSiteName(self, site_title):
+ """Returns the corresponding site_name. This is needed since the site name
+ isn't the same as the title.
+
+ Args:
+ site_title: [string] The title for a site.
+
+ Returns:
+ A string which is the corresponding site_name.
+ """
+ site_name = site_title.replace(' ', '-')
+ site_name = site_name.lower()
+ return site_name
+
+ def _GetSiteURI(self, site_title):
+ """Returns the corresponding uri to the site.
+ Needed to get the link to a particular user page.
+
+ Args:
+ site_title: [string] The title for a site.
+
+ Returns:
+ A string which is the corresponding site's URI.
+ """
+ uri = URI % (self.domain, self._GetSiteName(site_title))
+ return uri
+
+ def _CreateSite(self, site_title, description=DESCRIPTION, theme=THEME):
+ """Creates a site with the site_title, if it not already exists.
+
+ Args:
+ site_title: [string] The title for a site.
+ description: [string] The description for the site.
+ theme: [string] The theme that should be set for the site.
+
+ Returns:
+ A Content feed object for the created site.
+ """
+ site_entry = None
+ site_found = False
+ site_name = self._GetSiteName(site_title)
+ for site in self.all_site_feed.entry:
+ if site.site_name.text == site_name:
+ site_found = True
+ site_entry = site
+ break
+ if site_found == False:
+ try:
+ site_entry = self.sites_client.CreateSite(site_title,
+ description=description, theme=theme)
+ except gdata.client.RequestError, error:
+ print error
+ self.sites_client.site = site_name
+ return site_entry
+
+ def _DeleteAllPages(self):
+ '''Deletes all the pages in a site except home'''
+ feed_uri = self.sites_client.make_content_feed_uri()
+ while feed_uri:
+ feed = self.sites_client.GetContentFeed()
+ for entry in feed.entry:
+ if entry.page_name.text != 'home':
+ self.sites_client.Delete(entry)
+ feed_uri = feed.FindNextLink()
+
+ def _GetUsersProfileFeed(self):
+ """Retrieves all the user's profile.
+
+ Returns:
+ A Dictionary of email address to ContentEntry objects
+ """
+ profiles = []
+ feed_uri = self.profiles_client.GetFeedUri('profiles')
+ while feed_uri:
+ feed = self.profiles_client.GetProfilesFeed(uri=feed_uri)
+ profiles.extend(feed.entry)
+ feed_uri = feed.FindNextLink()
+
+ profiles_dict = {}
+ for profile in profiles:
+ for email in profile.email:
+ if email.primary and email.primary == 'true':
+ profiles_dict[email.address] = profile
+ break
+
+ return profiles_dict
+
+ def _CreateUserPageHTML(self, profile):
+ """Creates HTML for a user profile.
+
+ Args:
+ profile: [gdata.contacts.data.ProfileEntry] It is the profile of the user
+ whose HTML has to be created.
+
+ Returns:
+ A String which is the HTML code.
+ """
+ address_string = ''
+ email_string = ''
+ for address in profile.structured_postal_address:
+ address_string = '%s<li>%s</li><br />' % (address_string, address)
+ for email in profile.email:
+ if email.primary and email.primary == 'true':
+ email_string = '%s<li>%s</li><br />' % (email_string, email.address)
+
+ new_html = TEMPLATE_USER_HTML % (profile.name.full_name.text,
+ str(profile.gender), address_string, email_string)
+
+ return HTML_HEADER + new_html + HTML_FOOTER
+
+ def _GetUserPageName(self, user_email):
+ """Creates a page name for a particular user depending on the
+ email address.
+
+ Args:
+ user_email: [string] The email address of the user.
+
+ Returns:
+ A String which defines the user page name.
+ """
+ user_page_name = user_email.replace('@', '-')
+ user_page_name = user_page_name.replace('.', '_')
+ user_page_name = user_page_name.lower()
+ return user_page_name
+
+ def _CreateUserPages(self):
+ """Makes all the user pages"""
+
+ entry = self._CreateSite(USER_SITE_TITLE)
+
+ #Delete all the pages
+ self._DeleteAllPages()
+
+ users_profile = self._GetUsersProfileFeed()
+ users = self.org_unit_client.RetrieveAllOrgUsers(self.customer_id)
+ for user in users:
+ user_email = user['orgUserEmail']
+ user_profile = users_profile[user_email]
+ new_html = self._CreateUserPageHTML(user_profile)
+ user_page_name = self._GetUserPageName(user_email)
+
+ self.sites_client.CreatePage('webpage', user_profile.name.full_name.text,
+ html=new_html, page_name=user_page_name)
+
+ def _GetOrgUnitPageHTML(self, path):
+ """Creates HTML for a Org Unit Page.
+
+ Args:
+ profile: [string] Path of the Org Unit.
+
+ Returns:
+ A String which is the HTML code.
+ """
+
+ domain_users = self.org_unit_client.RetrieveOrgUnitUsers(self.customer_id,
+ path)
+ new_html = '<p>'
+ for user in domain_users:
+ user_email = user['orgUserEmail']
+ user_page_name = self._GetUserPageName(user_email)
+ site_uri = self._GetSiteURI(USER_SITE_TITLE)
+ new_html = '%s<li><a href="%s">%s</a></li><br />' % (new_html,
+ site_uri + user_page_name, user_email)
+ new_html = new_html + '</p>'
+ return HTML_HEADER + new_html + HTML_FOOTER
+
+ def _SetOrgSiteHomePage(self):
+ """Sets up the home page for Org Unit Site"""
+ new_html = self._GetOrgUnitPageHTML('/')
+ home_path = self._GetUnitPath()
+ home_feed = self.sites_client.GetContentFeed(uri=home_path)
+ home_feed.entry[0].title.text = self.domain
+ home_feed.entry[0].content.html = new_html
+ self.sites_client.Update(home_feed.entry[0])
+
+ def _GetUnitPath(self, path=None):
+ """Returns path to the parent unit
+
+ Args:
+ parent_path: [string] Path of the Parent Org Unit.
+
+ Returns:
+ A String which is the path to the parent.
+ """
+ path_uri = '%s?path=/%s'
+ if path:
+ path = path.replace('+', '-')
+ path = path.lower()
+ path = 'home/' + path
+ else:
+ path = 'home'
+
+ uri = path_uri % (self.sites_client.MakeContentFeedUri(), path)
+ return uri
+
+ def _CreateOrgUnitPages(self):
+ """Creates all the org unit pages"""
+
+ entry = self._CreateSite(ORG_SITE_TITLE)
+ #Delete all the pages
+ self._DeleteAllPages()
+
+ self._SetOrgSiteHomePage()
+
+ orgUnits = self.org_unit_client.RetrieveAllOrgUnits(self.customer_id)
+ for unit in orgUnits:
+ parent_uri = self._GetUnitPath(unit['parentOrgUnitPath'])
+ parent_feed = self.sites_client.GetContentFeed(uri=parent_uri)
+
+ new_html = self._GetOrgUnitPageHTML(unit['orgUnitPath'])
+ self.sites_client.CreatePage('webpage', unit['name'], html=new_html,
+ parent=parent_feed.entry[0])
+
+ def Run(self):
+ """Controls the entire flow of the sites making process"""
+
+ print 'Starting the process. This may take few minutes.'
+ print 'Creating user pages...'
+ self._CreateUserPages()
+ print 'User pages created'
+ print 'Creating Organization Unit Pages'
+ self._CreateOrgUnitPages()
+ print 'Your website is ready, visit it at: %s' % (self._GetSiteURI(
+ ORG_SITE_TITLE))
+
+
+def main():
+ """Runs the site making module using an instance of OrgUnitAddressBook"""
+ # Parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['email=', 'pw=', 'domain='])
+ except getopt.error, msg:
+ print ('python org_unit_sites.py --email [emailaddress] --pw [password]'
+ ' --domain [domain]')
+ sys.exit(2)
+
+ email = ''
+ password = ''
+ domain = ''
+ # Parse options
+ for option, arg in opts:
+ if option == '--email':
+ email = arg
+ elif option == '--pw':
+ password = arg
+ elif option == '--domain':
+ domain = arg
+
+ while not email:
+ email = raw_input('Please enter admin email address (admin@example.com): ')
+ while not password:
+ sys.stdout.write('Admin Password: ')
+ password = getpass.getpass()
+ if not password:
+ print 'Password cannot be blank.'
+ while not domain:
+ username, domain = email.split('@', 1)
+ choice = raw_input('You have not given us the domain name. ' +
+ 'Is it %s? (y/n)' % (domain))
+ if choice == 'n':
+ domain = raw_input('Please enter domain name (domain.com): ')
+
+ try:
+ org_unit_address_book = OrgUnitAddressBook(email, password, domain)
+ except gdata.service.BadAuthentication:
+ print 'Invalid user credentials given.'
+ return
+
+ org_unit_address_book.Run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/orgunit_quick_start_example.py b/samples/apps/orgunit_quick_start_example.py
new file mode 100644
index 0000000..3ea8c4c
--- /dev/null
+++ b/samples/apps/orgunit_quick_start_example.py
@@ -0,0 +1,473 @@
+#!/usr/bin/python
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample for the Orgunits Provisioning API to demonstrate all methods.
+
+Usage:
+ $ python orgunit_quick_start_example.py
+
+You can also specify the user credentials from the command-line
+
+ $ python orgunit_quick_start_example.py
+ --client_id [client_id] --client_secret [client_scret] --domain [domain]
+
+You can get help for command-line arguments as
+
+ $ python orgunit_quick_start_example.py --help
+"""
+
+__author__ = 'Shraddha Gupta <shraddhag@google.com>'
+
+import getopt
+import sys
+import gdata.apps.client
+from gdata.apps.organization.client import OrganizationUnitProvisioningClient
+import gdata.client
+import gdata.gauth
+
+SCOPE = 'https://apps-apis.google.com/a/feeds/policies/'
+USER_AGENT = 'OrgUnitProvisioningQuickStartExample'
+
+
+class OrgUnitProvisioning(object):
+ """Demonstrates all the functions of org units provisioning."""
+
+ def __init__(self, client_id, client_secret, domain):
+ """
+ Args:
+ client_id: [string] The clientId of the developer.
+ client_secret: [string] The clientSecret of the developer.
+ domain: [string] The domain on which the functions are to be performed.
+ """
+ self.client_id = client_id
+ self.client_secret = client_secret
+ self.domain = domain
+
+ def _AuthorizeClient(self):
+ """Authorize the client for making API requests."""
+
+ self.token = gdata.gauth.OAuth2Token(
+ client_id=self.client_id, client_secret=self.client_secret,
+ scope=SCOPE, user_agent=USER_AGENT)
+ uri = self.token.generate_authorize_url()
+ print 'Please visit this URL to authorize the application:'
+ print uri
+ # Get the verification code from the standard input.
+ code = raw_input('What is the verification code? ').strip()
+ self.token.get_access_token(code)
+ self.client = OrganizationUnitProvisioningClient(
+ domain=self.domain, auth_token=self.token)
+
+ def _PrintCustomerIdDetails(self, entry):
+ """Prints the attributes for a CustomerIdEntry.
+
+ Args:
+ entry: [gdata.apps.organization.data.CustomerIdEntry]
+ """
+ print '\nCustomer Id: %s' % (entry.customer_id)
+ print 'Org unit name: %s' % (entry.org_unit_name)
+ print 'Customer org unit name: %s' % (entry.customer_org_unit_name)
+ print 'Org unit description: %s' % (entry.org_unit_description)
+ print 'Customer org unit description: %s' % (
+ entry.customer_org_unit_description)
+
+ def _PrintOrgUnitDetails(self, entry):
+ """Prints the attributes for a OrgUnitEntry.
+
+ Args:
+ entry: [gdata.apps.organization.data.OrgUnitEntry]
+ """
+ if entry:
+ print '\nOrg unit name: %s' % (entry.org_unit_name)
+ print 'Org unit path: %s' % (entry.org_unit_path)
+ print 'Parent org unit path: %s' % (entry.parent_org_unit_path)
+ print 'organization unit description: %s' % (entry.org_unit_description)
+ print 'Block inheritance flag: %s' % (entry.org_unit_block_inheritance)
+ else:
+ print 'null entry'
+
+ def _PrintOrgUserDetails(self, entry):
+ """Prints the attributes for a OrgUserEntry.
+
+ Args:
+ entry: [gdata.apps.organization.data.OrgUserEntry]
+ """
+ if entry:
+ print 'Org user email: %s' % (entry.user_email)
+ print 'Org unit path: %s' % (entry.org_unit_path)
+ else:
+ print 'null entry'
+
+ def _GetChoice(self, for_field):
+ """Gets input for boolean fields.
+
+ Args:
+ for_value : string field for which input is required
+
+ Returns:
+ boolean input for the given field
+ """
+ choice = raw_input(('(Optional) Enter a choice for %s\n'
+ '1-True 2-False ') % (for_field))
+ if choice == '1':
+ return True
+ return False
+
+ def _GetOrgUnitPath(self):
+ """Gets org_unit_path from user.
+
+ Returns:
+ string org_unit_path entered by the user
+ """
+
+ org_unit_path = raw_input('Enter the org unit path ')
+ if org_unit_path is None:
+ print 'Organization path missing\n'
+ return
+ return org_unit_path
+
+ def _RetrieveCustomerId(self):
+ """Retrieves Groups Apps account customerId.
+
+ Returns:
+ CustomerIdEntry
+ """
+
+ response = self.client.RetrieveCustomerId()
+ self._PrintCustomerIdDetails(response)
+ return response
+
+ def _CreateOrgUnit(self, customer_id):
+ """Creates a new org unit.
+
+ Args:
+ customer_id : string customer_id of organization
+ """
+ name = raw_input('Enter a name for organization: ')
+ parent_org_unit_path = raw_input('(default "/")'
+ 'Enter full path of the parentental tree: ')
+ description = raw_input('(Optional) Enter description of organization: ')
+ block_inheritance = self._GetChoice('(default: False) block_inheritance: ')
+ if not parent_org_unit_path:
+ parent_org_unit_path = '/'
+ try:
+ orgunit_entry = self.client.CreateOrgUnit(
+ customer_id=customer_id, name=name,
+ parent_org_unit_path=parent_org_unit_path,
+ description=description, block_inheritance=block_inheritance)
+ self._PrintOrgUnitDetails(orgunit_entry)
+ print 'Org unit Created'
+ except gdata.client.RequestError, e:
+ print e.reason, e.body
+ return
+
+ def _UpdateOrgUnit(self, customer_id):
+ """Updates an org unit.
+
+ Args:
+ customer_id : string customer_id of organization
+ """
+ org_unit_path = self._GetOrgUnitPath()
+ if org_unit_path is None:
+ return
+ try:
+ org_unit_entry = self.client.RetrieveOrgUnit(customer_id=customer_id,
+ org_unit_path=org_unit_path)
+ print self._PrintOrgUnitDetails(org_unit_entry)
+ attributes = {1: 'org_name', 2: 'parent_org_unit_path', 3: 'description',
+ 4: 'block_inheritance'}
+ print attributes
+ while True:
+ attr = int(raw_input('\nEnter number(1-4) of attribute to be updated'))
+ updated_val = raw_input('Enter updated value ')
+ if attr == 1:
+ org_unit_entry.org_unit_name = updated_val
+ if attr == 2:
+ org_unit_entry.parent_org_unit_path = updated_val
+ if attr == 3:
+ org_unit_entry.org_unit_description = updated_val
+ if attr == 4:
+ org_unit_entry.login.org_unit_block_inheritance = updated_val
+ choice = raw_input('\nDo you want to update more attributes y/n')
+ if choice != 'y':
+ break
+ self.client.UpdateOrgUnit(customer_id=customer_id,
+ org_unit_path=org_unit_path, org_unit_entry=org_unit_entry)
+ print 'Updated Org unit'
+ except gdata.client.RequestError, e:
+ print e.reason, e.body
+ return
+
+ def _RetrieveOrgUnit(self, customer_id):
+ """Retrieves a single org unit.
+
+ Args:
+ customer_id : string customer_id of organization
+ """
+ org_unit_path = self._GetOrgUnitPath()
+ if org_unit_path is None:
+ return
+ try:
+ response = self.client.RetrieveOrgUnit(customer_id=customer_id,
+ org_unit_path=org_unit_path)
+ self._PrintOrgUnitDetails(response)
+ except gdata.client.RequestError, e:
+ print e.reason, e.body
+ return
+
+ def _RetrieveAllOrgUnits(self, customer_id):
+ """Retrieves all org units.
+
+ Args:
+ customer_id : string customer_id of organization
+ """
+ try:
+ response = self.client.RetrieveAllOrgUnits(customer_id=customer_id)
+ for entry in response.entry:
+ self._PrintOrgUnitDetails(entry)
+ except gdata.client.RequestError, e:
+ print e.reason, e.body
+ return
+
+ def _RetrieveSubOrgUnits(self, customer_id):
+ """Retrieves all sub org units of an org unit.
+
+ Args:
+ customer_id : string customer_id of organization
+ """
+ org_unit_path = self._GetOrgUnitPath()
+ if org_unit_path is None:
+ return
+ try:
+ response = self.client.RetrieveSubOrgUnits(customer_id=customer_id,
+ org_unit_path=org_unit_path)
+ if not response.entry:
+ print 'No Sub organization units'
+ return
+ for entry in response.entry:
+ self._PrintOrgUnitDetails(entry)
+ except gdata.client.RequestError, e:
+ print e.reason, e.body
+ return
+
+ def _MoveUsers(self, customer_id):
+ """Moves users to an org unit.
+
+ Args:
+ customer_id : string customer_id of organization
+ """
+ org_unit_path = self._GetOrgUnitPath()
+ if org_unit_path is None:
+ return
+ users = []
+ while True:
+ user = raw_input('Enter user email address ')
+ if user:
+ users.append(user)
+ else:
+ break
+ if users is None:
+ print 'No users given to move'
+ return
+ try:
+ self.client.MoveUserToOrgUnit(customer_id=customer_id,
+ org_unit_path=org_unit_path, users_to_move=users)
+ print 'Moved users'
+ print users
+ except gdata.client.RequestError, e:
+ print e.reason, e.body
+ return
+
+ def _DeleteOrgUnit(self, customer_id):
+ """Deletes an org unit.
+
+ Args:
+ customer_id : string customer_id of organization
+ """
+ org_unit_path = self._GetOrgUnitPath()
+ if org_unit_path is None:
+ return
+ try:
+ self.client.DeleteOrgUnit(customer_id=customer_id,
+ org_unit_path=org_unit_path)
+ print 'OrgUnit Deleted'
+ except gdata.client.RequestError, e:
+ print e.reason, e.body
+ return
+
+ def _UpdateOrgUser(self, customer_id):
+ """Updates the orgunit of an org user.
+
+ Args:
+ customer_id : string customer_id of organization
+ """
+ org_unit_path = self._GetOrgUnitPath()
+ user_email = raw_input('Enter the email address')
+ if None in (org_unit_path, user_email):
+ print 'Organization path and email are both required\n'
+ return
+ try:
+ org_user_entry = self.client.UpdateOrgUser(customer_id=customer_id,
+ user_email=user_email, org_unit_path=org_unit_path)
+ print 'Updated org unit for user'
+ print self._PrintOrgUserDetails(org_user_entry)
+ except gdata.client.RequestError, e:
+ print e.reason, e.body
+ return
+
+ def _RetrieveOrgUser(self, customer_id):
+ """Retrieves an organization user.
+
+ Args:
+ customer_id : string customer_id of organization
+ """
+ user_email = raw_input('Enter the email address ')
+ if user_email is None:
+ print 'Email address missing\n'
+ return
+ try:
+ response = self.client.RetrieveOrgUser(customer_id=customer_id,
+ user_email=user_email)
+ self._PrintOrgUserDetails(response)
+ except gdata.client.RequestError, e:
+ print e.reason, e.body
+ return
+
+ def _RetrieveOrgUnitUsers(self, customer_id):
+ """Retrieves all org users of an org unit.
+
+ Args:
+ customer_id : string customer_id of organization
+ """
+ org_unit_path = self._GetOrgUnitPath()
+ if org_unit_path is None:
+ return
+ try:
+ response = self.client.RetrieveOrgUnitUsers(customer_id=customer_id,
+ org_unit_path=org_unit_path)
+ if not response.entry:
+ print 'No users in this organization'
+ return
+ for entry in response.entry:
+ self._PrintOrgUserDetails(entry)
+ except gdata.client.RequestError, e:
+ print e.reason, e.body
+ return
+
+ def _RetrieveAllOrgUsers(self, customer_id):
+ """Retrieves all org users.
+
+ Args:
+ customer_id : string customer_id of organization
+ """
+ try:
+ response = self.client.RetrieveAllOrgUsers(customer_id=customer_id)
+ for entry in response.entry:
+ self._PrintOrgUserDetails(entry)
+ except gdata.client.RequestError, e:
+ print e.reason, e.body
+ return
+
+ def Run(self):
+ """Runs the sample by getting user input and taking appropriate action."""
+
+ self._AuthorizeClient()
+ # CustomerId is required to perform any opertaion on org unit
+ # Retrieve customerId beforehand.
+ customer_id_entry = self._RetrieveCustomerId()
+ customer_id = customer_id_entry.customer_id
+
+ # List of all the functions and their descriptions
+ functions_list = [
+ {'function': self._CreateOrgUnit,
+ 'description': 'Create an org unit'},
+ {'function': self._UpdateOrgUnit,
+ 'description': 'Update an org unit'},
+ {'function': self._RetrieveOrgUnit,
+ 'description': 'Retrieve an org unit'},
+ {'function': self._RetrieveAllOrgUnits,
+ 'description': 'Retrieve all org units'},
+ {'function': self._RetrieveSubOrgUnits,
+ 'description': 'Retrieve sub org unit of a given org unit'},
+ {'function': self._MoveUsers,
+ 'description': 'Move users to an org unit'},
+ {'function': self._DeleteOrgUnit,
+ 'description': 'Delete an org unit'},
+ {'function': self._UpdateOrgUser,
+ 'description': 'Update org unit of a user'},
+ {'function': self._RetrieveOrgUser,
+ 'description': 'Retrieve an org user '},
+ {'function': self._RetrieveOrgUnitUsers,
+ 'description': 'Retrieve users of an org unit'},
+ {'function': self._RetrieveAllOrgUsers,
+ 'description': 'Retrieve all org users'}
+ ]
+ while True:
+ print '\nChoose an option:\n0 - to exit'
+ for i in range (0, len(functions_list)):
+ print '%d - %s' % ((i+1), functions_list[i]['description'])
+ choice = int(raw_input())
+ if choice == 0:
+ break
+ if choice < 0 or choice > 11:
+ print 'Not a valid option!'
+ continue
+ functions_list[choice-1]['function'](customer_id=customer_id)
+
+
+def main():
+ """A menu driven application to demo all methods of org unit provisioning."""
+
+ usage = ('python orgunit_quick_start_example.py '
+ '--client_id [clientId] --client_secret [clientSecret] '
+ '--domain [domain]')
+ # Parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['client_id=',
+ 'client_secret=',
+ 'domain='])
+ except getopt.error:
+ print 'Usage: %s' % usage
+ return
+
+ client_id = None
+ client_secret = None
+ domain = None
+ # Parse options
+ for option, arg in opts:
+ if option == '--client_id':
+ client_id = arg
+ elif option == '--client_secret':
+ client_secret = arg
+ elif option == '--domain':
+ domain = arg
+
+ if None in (client_id, client_secret, domain):
+ print 'Usage: %s' % usage
+ return
+
+ try:
+ orgunit_provisioning = OrgUnitProvisioning(
+ client_id, client_secret, domain)
+ except gdata.service.BadAuthentication:
+ print 'Invalid user credentials given.'
+ return
+
+ orgunit_provisioning.Run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/provisioning_oauth2_example.py b/samples/apps/provisioning_oauth2_example.py
new file mode 100644
index 0000000..6b35e96
--- /dev/null
+++ b/samples/apps/provisioning_oauth2_example.py
@@ -0,0 +1,121 @@
+#!/usr/bin/python
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample for the Provisioning API and the Email Settings API with OAuth 2.0."""
+
+__author__ = 'Shraddha Gupta <shraddhag@google.com>'
+
+from optparse import OptionParser
+import gdata.apps
+import gdata.apps.emailsettings.client
+import gdata.apps.groups.client
+import gdata.client
+import gdata.gauth
+
+
+API_VERSION = '2.0'
+BASE_URL = '/a/feeds/group/%s' % API_VERSION
+SCOPE = ('https://apps-apis.google.com/a/feeds/groups/ '
+ 'https://apps-apis.google.com/a/feeds/emailsettings/2.0/')
+HOST = 'apps-apis.google.com'
+
+
+class OAuth2ClientSample(object):
+ """OAuth2ClientSample object demos the use of OAuth2Token for retrieving
+ Members of a Group and updating Email Settings for them."""
+
+ def __init__(self, domain, client_id, client_secret):
+ """
+ Args:
+ domain: string Domain name (e.g. domain.com)
+ client_id: string Client_id of domain admin account.
+ client_secret: string Client_secret of domain admin account.
+ """
+ try:
+ self.token = gdata.gauth.OAuth2Token(client_id=client_id,
+ client_secret=client_secret,
+ scope=SCOPE,
+ user_agent='oauth2-provisioningv2')
+ self.uri = self.token.generate_authorize_url()
+ print 'Please visit this URL to authorize the application:'
+ print self.uri
+ # Get the verification code from the standard input.
+ code = raw_input('What is the verification code? ').strip()
+ self.token.get_access_token(code)
+ except gdata.gauth.OAuth2AccessTokenError, e:
+ print 'Invalid Access token, Check your credentials %s' % e
+ exit(0)
+ self.domain = domain
+ self.baseuri = '%s/%s' % (BASE_URL, domain)
+ self.client = gdata.apps.groups.client.GroupsProvisioningClient(
+ domain=self.domain, auth_token=self.token)
+ # Authorize the client.
+ # This will add the Authorization header to all future requests.
+ self.token.authorize(self.client)
+ self.email_client = gdata.apps.emailsettings.client.EmailSettingsClient(
+ domain=self.domain, auth_token=self.token)
+ self.token.authorize(self.email_client)
+
+ def create_filter(self, feed):
+ """Creates a mail filter that marks as read all messages not containing
+ Domain name as one of their words for each member of the group.
+
+ Args:
+ feed: GroupMemberFeed members whose emailsettings need to updated
+ """
+ for entry in feed.entry:
+ user_name, domain = entry.member_id.split('@', 1)
+ if entry.member_type == 'User' and domain == self.domain:
+ print 'creating filter for %s' % entry.member_id
+ self.email_client.CreateFilter(user_name,
+ does_not_have_the_word=self.domain,
+ mark_as_read=True)
+ elif entry.member_type == 'User':
+ print 'User belongs to other Domain %s' %entry.member_id
+ else:
+ print 'Member is a group %s' %entry.member_id
+
+ def run(self, group):
+ feed = self.client.RetrieveAllMembers(group)
+ self.create_filter(feed)
+
+
+def main():
+ """Demos the Provisioning API and the Email Settings API with OAuth 2.0."""
+ usage = 'usage: %prog [options]'
+ parser = OptionParser(usage=usage)
+ parser.add_option('--DOMAIN',
+ help='Google Apps Domain, e.g. "domain.com".')
+ parser.add_option('--CLIENT_ID',
+ help='Registered CLIENT_ID of Domain.')
+ parser.add_option('--CLIENT_SECRET',
+ help='Registered CLIENT_SECRET of Domain.')
+ parser.add_option('--GROUP',
+ help='Group identifier')
+ (options, args) = parser.parse_args()
+
+ if None in (options.DOMAIN, options.CLIENT_ID, options.CLIENT_SECRET,
+ options.GROUP):
+ parser.print_help()
+ return
+
+ sample = OAuth2ClientSample(options.DOMAIN,
+ options.CLIENT_ID, options.CLIENT_SECRET)
+ sample.run(options.GROUP)
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/provisioning_oauth_example/app.yaml b/samples/apps/provisioning_oauth_example/app.yaml
new file mode 100644
index 0000000..4018a61
--- /dev/null
+++ b/samples/apps/provisioning_oauth_example/app.yaml
@@ -0,0 +1,17 @@
+application: provisioning-oauth-example
+version: 1
+runtime: python
+api_version: 1
+
+handlers:
+- url: /css
+ static_dir: css
+
+- url: /js
+ static_dir: js
+
+- url: /images
+ static_dir: images
+
+- url: /.*
+ script: main.py
diff --git a/samples/apps/provisioning_oauth_example/css/index.css b/samples/apps/provisioning_oauth_example/css/index.css
new file mode 100644
index 0000000..af3f9d5
--- /dev/null
+++ b/samples/apps/provisioning_oauth_example/css/index.css
@@ -0,0 +1,106 @@
+/**
+ * Copyright 2011, Google Inc. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the 'License');
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http: *www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an 'AS IS' BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+ /**
+ * author pti@google.com (Prashant Tiwari)
+ */
+
+body {
+ font-family: 'Verdana', sans-serif;
+ font-size: 11px;
+}
+
+#users table {
+ width: 100%;
+ border: dotted 1px #000000;
+ font-family: 'Verdana', sans-serif;
+ font-size: 11px;
+}
+
+#navigator #prev {
+ cursor: pointer;
+}
+
+#navigator #next {
+ cursor: pointer;
+}
+
+#users table .odd {
+ background-color: #E5F2FB;
+}
+
+#users table .even {
+ background-color: #FFFFFF;
+}
+
+#users td {
+ padding: 3px;
+}
+
+#footer {
+ text-align: center;
+ padding: 10px 10px 10px 10px;
+}
+
+#header {
+ padding: 5px 5px 0px 0px;
+}
+
+#titleholder {
+ float: left;
+ padding-top: 0px;
+ margin-top: 0px;
+ margin-left: 10px;
+ color: #133BC1;
+}
+
+#titleholder h1 {
+ font-family: Arial;
+ font-weight: normal;
+ font-size: 24px;
+}
+
+#titlecrumb {
+ float: right;
+}
+
+#main {
+ width: 100%;
+ text-align: left;
+}
+
+.outer {
+ margin-left: 25%;
+ margin-right: 25%;
+}
+
+.serialno {
+ text-align: center;
+}
+
+.username {
+ font-style: italic;
+ font-weight: bold;
+}
+
+.accountname {
+ font-weight: bold;
+}
+
+.isadmin {
+ font-weight: bold;
+ text-align: center;
+}
diff --git a/samples/apps/provisioning_oauth_example/footer.html b/samples/apps/provisioning_oauth_example/footer.html
new file mode 100644
index 0000000..7fc3c50
--- /dev/null
+++ b/samples/apps/provisioning_oauth_example/footer.html
@@ -0,0 +1,10 @@
+ <div id="footer">
+ <p>Copyright © 2011
+ <a href="http://www.google.com">
+ <img src="/images/google-small.png" style="vertical-align: middle" />
+ </a>
+ </p>
+ </div>
+ </div>
+ </body>
+</html>
\ No newline at end of file
diff --git a/samples/apps/provisioning_oauth_example/header.html b/samples/apps/provisioning_oauth_example/header.html
new file mode 100644
index 0000000..38aa7cd
--- /dev/null
+++ b/samples/apps/provisioning_oauth_example/header.html
@@ -0,0 +1,38 @@
+<html>
+ <!--
+ Copyright 2011, Google Inc. All Rights Reserved.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+ author: pti@google.com (Prashant Tiwari)
+ -->
+ <head>
+ <link type="text/css" rel="stylesheet" href="/css/index.css"></link>
+ <script src="/js/index.js" type="text/javascript"></script>
+ </head>
+ <body onload="onload();" style="text-align: center">
+ <div class="outer">
+ <div id="header">
+ <div id="titleholder">
+ <h1 style="text-align: center">{{ app_title }}</h1>
+ </div>
+ <div id="titlecrumb">
+ {% if oauth_token %}
+ <div>
+ <a href="/start_over?two_legged_oauth={{ two_legged_oauth }}">
+ {{ start_over_text }}</a>
+ </div>
+ {% endif %}
+ </div>
+ <div style="clear: both;"></div>
+ </div>
\ No newline at end of file
diff --git a/samples/apps/provisioning_oauth_example/images/google-small.png b/samples/apps/provisioning_oauth_example/images/google-small.png
new file mode 100644
index 0000000..e62b8b8
--- /dev/null
+++ b/samples/apps/provisioning_oauth_example/images/google-small.png
Binary files differ
diff --git a/samples/apps/provisioning_oauth_example/index.html b/samples/apps/provisioning_oauth_example/index.html
new file mode 100644
index 0000000..6308b3a
--- /dev/null
+++ b/samples/apps/provisioning_oauth_example/index.html
@@ -0,0 +1,15 @@
+{% include "header.html" %}
+<script>
+ var user_entries = {{ json }};
+</script>
+<div id="main">
+ <div id="accounts">
+ <div id="users"></div>
+ <div id="navigator" style="float: right">
+ <span id="prev"><Prev</span> |
+ <span id="next">Next ></span>
+ </div>
+ <div style="clear: both;"></div>
+ </div>
+</div>
+{% include "footer.html" %}
diff --git a/samples/apps/provisioning_oauth_example/js/index.js b/samples/apps/provisioning_oauth_example/js/index.js
new file mode 100644
index 0000000..21b2d4f
--- /dev/null
+++ b/samples/apps/provisioning_oauth_example/js/index.js
@@ -0,0 +1,114 @@
+// Copyright 2011, Google Inc. All Rights Reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+/**
+ * @author pti@google.com (Prashant Tiwari)
+ */
+
+/**
+ * @fileoverview Contains JS methods for index.html
+ */
+
+/**
+ * Tracks the start index for the prev and next links
+ */
+var startIndex = 0;
+
+/**
+ * Creates the users' table on each page.
+ *
+ * @param {Array}
+ * entries The user entries to be displayed on the table.
+ * @param {Int}
+ * start The start index for items displayed in the table.
+ * @param {Int}
+ * size The table size.
+ * @returns The table html.
+ */
+buildUserTable = function(entries, start, size) {
+ var html = [];
+ html.push('<table>');
+ html.push('<tr>', '<th width=\'10%\'>#</th>',
+ '<th width=\'35%\'>Account Name</th>',
+ '<th width=\'45%\'>User Name</th>',
+ '<th width=\'10%\'>Is Admin</th>', '</tr>');
+ for ( var i = 0; i < size; i++) {
+ if (start + i < entries.length) {
+ var className = ((i % 2) == 0) ? 'odd' : 'even';
+ html.push('<tr class=\'' + className + '\'>');
+ html.push('<td class=\'serialno\'>' + (start + i + 1) + '</td>');
+ html.push('<td class=\'accountname\'>' + entries[start + i].username + '</td>');
+ html.push('<td class=\'username\'>' + entries[start + i].given_name + ' '
+ + entries[start + i].family_name + '</td>');
+ if (entries[start + i].admin == 'true') {
+ html.push('<td class=\'isadmin\'>Yes</td>');
+ } else {
+ html.push('<td></td>');
+ }
+ html.push('</tr>');
+ }
+ }
+ html.push('</table>');
+ return html.join('\n');
+};
+
+/**
+ * Creates the back and forth navigator links.
+ *
+ * @param {String}
+ * pagingElements The element that holds the paged content.
+ * @param {Int}
+ * pagesize The page size.
+ */
+createNavigator = function(pagingElements, pagesize) {
+ var paging_elements = pagingElements;
+ var page_size = pagesize;
+
+ return function() {
+ var prev_link = document.getElementById('prev');
+ prev_link.onclick = function() {
+ if (startIndex - page_size >= 0) {
+ startIndex = startIndex - page_size;
+ var user_div = document.getElementById('users')
+ user_div.innerHTML = buildUserTable(user_entries, startIndex,
+ page_size);
+ }
+ };
+
+ var next_link = document.getElementById('next');
+ next_link.onclick = function() {
+ if (startIndex == 0 && startIndex - page_size > 0) {
+ startIndex = startIndex - page_size;
+ var user_div = document.getElementById('users')
+ user_div.innerHTML = buildUserTable(user_entries, startIndex,
+ page_size);
+ } else if (startIndex + page_size + 1 <= paging_elements.length) {
+ startIndex = startIndex + page_size;
+ var user_div = document.getElementById('users')
+ user_div.innerHTML = buildUserTable(user_entries, startIndex,
+ page_size);
+ }
+ };
+ };
+};
+
+/**
+ * Called when index.html loads
+ */
+function onload() {
+ var user_div = document.getElementById('users')
+ var entries_per_page = 25
+ user_div.innerHTML = buildUserTable(user_entries, 0, entries_per_page);
+ new createNavigator(user_entries, entries_per_page)();
+}
diff --git a/samples/apps/provisioning_oauth_example/login.html b/samples/apps/provisioning_oauth_example/login.html
new file mode 100644
index 0000000..8096a7e
--- /dev/null
+++ b/samples/apps/provisioning_oauth_example/login.html
@@ -0,0 +1,76 @@
+<html>
+<!--
+ Copyright 2011, Google Inc. All Rights Reserved.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+ author: pti@google.com (Prashant Tiwari)
+ -->
+ <head>
+ <script type="text/javascript">
+ /**
+ * Validates form input before submit
+ *
+ * @returns true if the form data is valid
+ */
+ function validateInput() {
+ key = document.getElementById('key').value
+ secret = document.getElementById('secret').value
+ if (key.trim() == "" || secret.trim() == "") {
+ alert("Missing consumer key or secret");
+ return false;
+ } else {
+ return true;
+ }
+ }
+
+ /**
+ * Extends String class to define whitespace trimming
+ *
+ * @returns The trimmed string
+ */
+ String.prototype.trim = function() {
+ return this.replace(/^\s+|\s+$/g,"");
+ }
+</script>
+ </head>
+ <body>
+ <center>
+ <fieldset style="width: 400; height: 200; border: solid 3px;">
+ <legend>Authentication</legend>
+ <form name="post" method="post" action="/do_auth" onsubmit="return validateInput();">
+ <table style="align: center" cellspacing="10" cellpadding="3">
+ <tr>
+ <td><label for="key">Consumer key:</label></td>
+ <td><input type="text" id="key" name="key" value="" size="35" /></td>
+ </tr>
+ <tr>
+ <td><label for="secret">Consumer secret:</label></td>
+ <td><input type="password" id="secret" name="secret" value="" size="35" /></td>
+ </tr>
+ <tr>
+ <td colspan="2"><input type="radio" id="two_lo" value="two_legged_oauth" name="oauth"> 2-legged OAuth</td>
+ </tr>
+ <tr>
+ <td colspan="2"><input type="radio" id="three_lo" value="three_legged_oauth" name="oauth" checked> 3-legged OAuth</td>
+ </tr>
+ <tr>
+ <td style="text-align: center" colspan="2"><input type="submit"
+ value="Authorize" /><input type="reset" value="Cancel" /></td>
+ </tr>
+ </table>
+ </form>
+ </fieldset>
+ </center>
+ </body>
+</html>
\ No newline at end of file
diff --git a/samples/apps/provisioning_oauth_example/main.py b/samples/apps/provisioning_oauth_example/main.py
new file mode 100644
index 0000000..b21cea1
--- /dev/null
+++ b/samples/apps/provisioning_oauth_example/main.py
@@ -0,0 +1,201 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample app for Google Apps Provisioning API using OAuth.
+
+ ProvisioningOAuthSample: Demonstrates the use of the Provisioning API with
+ OAuth in a Google App Engine app.
+"""
+
+
+__author__ = 'pti@google.com (Prashant Tiwari)'
+
+
+import json
+import os
+import atom.http_interface
+import gdata.apps.service
+import gdata.auth
+from django.utils import simplejson
+from google.appengine.ext import webapp
+from google.appengine.ext.webapp import template
+from google.appengine.ext.webapp.util import run_wsgi_app
+from gdata.apps.service import AppsForYourDomainException
+
+
+INIT = {
+ 'APP_NAME': 'googlecode-provisioningtester-v1',
+ 'SCOPES': ['https://apps-apis.google.com/a/feeds']
+}
+
+secret = None
+
+class MainPage(webapp.RequestHandler):
+ """Defines the entry point for the App Engine app"""
+ def get(self):
+ global service
+ try:
+ service
+ except:
+ self.redirect('/login')
+ return
+
+ oauth_token = None
+ json = None
+ if self.request.get('two_legged_oauth'):
+ two_legged_oauth = True
+ app_title = 'Provisioning API Sample (2-legged OAuth)'
+ start_over_text = 'Start over'
+ else:
+ two_legged_oauth = False
+ app_title = 'Provisioning API Sample (3-legged OAuth)'
+ start_over_text = 'Revoke token'
+
+ try:
+ if service:
+ oauth_token = service.token_store.find_token('%20'.join(INIT['SCOPES']))
+ if isinstance(oauth_token, gdata.auth.OAuthToken) or isinstance(
+ oauth_token, atom.http_interface.GenericToken):
+ user_feed = service.RetrieveAllUsers()
+ json = get_json_from_feed(user_feed)
+ else:
+ self.redirect('/login')
+ return
+ except AppsForYourDomainException, e:
+ # Usually a Forbidden (403) when signed-in user isn't the admin.
+ self.response.out.write(e.args[0].get('body'))
+ else:
+ template_values = {
+ 'oauth_token': oauth_token,
+ 'json': json,
+ 'two_legged_oauth': two_legged_oauth,
+ 'start_over_text': start_over_text,
+ 'app_title': app_title
+ }
+
+ path = os.path.join(os.path.dirname(__file__), 'index.html')
+ self.response.out.write(template.render(path, template_values))
+
+
+def get_json_from_feed(user_feed):
+ """Constructs and returns a JSON object from the given feed object
+
+ Args:
+ user_feed: A gdata.apps.UserFeed object
+
+ Returns:
+ A JSON object containing the first and last names of the domain users
+ """
+ json = []
+ for entry in user_feed.entry:
+ json.append({'given_name': entry.name.given_name,
+ 'family_name': entry.name.family_name,
+ 'username': entry.login.user_name,
+ 'admin': entry.login.admin
+ })
+ return simplejson.dumps(json)
+
+
+class DoLogin(webapp.RequestHandler):
+ """Brings up the app's login page"""
+ def get(self):
+ path = os.path.join(os.path.dirname(__file__), 'login.html')
+ self.response.out.write(template.render(path, None))
+
+
+class DoAuth(webapp.RequestHandler):
+ """Handles the entire OAuth flow for the app"""
+ def post(self):
+ global service
+ global secret
+ # Get instance of the AppsService for the given consumer_key (domain)
+ service = gdata.apps.service.AppsService(source=INIT['APP_NAME'],
+ domain=self.request.get('key'))
+ two_legged_oauth = False
+ if self.request.get('oauth') == 'two_legged_oauth':
+ two_legged_oauth = True
+ service.SetOAuthInputParameters(
+ signature_method=gdata.auth.OAuthSignatureMethod.HMAC_SHA1,
+ consumer_key=self.request.get('key'),
+ consumer_secret=self.request.get('secret'),
+ two_legged_oauth=two_legged_oauth)
+
+ if two_legged_oauth:
+ # Redirect to MainPage if 2-legged OAuth is requested
+ self.redirect('/?two_legged_oauth=true')
+ return
+
+ request_token = service.FetchOAuthRequestToken(
+ scopes=INIT['SCOPES'], oauth_callback=self.request.uri)
+ secret = request_token.secret
+ service.SetOAuthToken(request_token)
+ # Send user to Google authorization page
+ google_auth_page_url = service.GenerateOAuthAuthorizationURL()
+ self.redirect(google_auth_page_url)
+
+ def get(self):
+ global service
+ global secret
+ # Extract the OAuth request token from the URL
+ oauth_token = gdata.auth.OAuthTokenFromUrl(self.request.uri)
+ if oauth_token:
+ oauth_token.secret = secret
+ oauth_token.oauth_input_params = service.GetOAuthInputParameters()
+ service.SetOAuthToken(oauth_token)
+ # Exchange the request token for an access token
+ oauth_verifier = self.request.get('oauth_verifier', default_value='')
+ access_token = service.UpgradeToOAuthAccessToken(
+ oauth_verifier=oauth_verifier)
+ # Store access_token to the service token_store for later access
+ if access_token:
+ service.current_token = access_token
+ service.SetOAuthToken(access_token)
+
+ self.redirect('/')
+
+
+class DoStartOver(webapp.RequestHandler):
+ """Revokes the OAuth token if needed and starts over"""
+ def get(self):
+ global service
+ two_legged_oauth = self.request.get('two_legged_oauth')
+ # Revoke the token for 3-legged OAuth
+ if two_legged_oauth != 'True':
+ try:
+ service.RevokeOAuthToken()
+ except gdata.service.RevokingOAuthTokenFailed:
+ pass
+ except gdata.service.NonOAuthToken:
+ pass
+ finally:
+ service.token_store.remove_all_tokens()
+
+ service = None
+ self.redirect('/')
+
+
+application = webapp.WSGIApplication([('/', MainPage),
+ ('/do_auth', DoAuth),
+ ('/start_over', DoStartOver),
+ ('/login', DoLogin)],
+ debug=True)
+
+
+def main():
+ run_wsgi_app(application)
+
+if __name__ == "__main__":
+ main()
diff --git a/samples/apps/search_organize_users.py b/samples/apps/search_organize_users.py
new file mode 100644
index 0000000..3c00043
--- /dev/null
+++ b/samples/apps/search_organize_users.py
@@ -0,0 +1,130 @@
+#!/usr/bin/python
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Search users with a given pattern and move to a new organization.
+
+Sample to move users to a new organization based on a pattern using
+the User Provisioning and Organization Provisioning APIs.
+
+Usage:
+ $ python search_organize_users.py
+"""
+
+__author__ = 'Shraddha Gupta <shraddhag@google.com>'
+
+from optparse import OptionParser
+import re
+from gdata.apps.client import AppsClient
+from gdata.apps.organization.client import OrganizationUnitProvisioningClient
+import gdata.gauth
+
+BATCH_SIZE = 25
+SCOPES = ('https://apps-apis.google.com/a/feeds/user/ '
+ 'https://apps-apis.google.com/a/feeds/policies/')
+USER_AGENT = 'SearchAndOrganizeUsers'
+
+
+class SearchAndOrganizeUsers(object):
+ """Search users with a pattern and move them to organization."""
+
+ def __init__(self, client_id, client_secret, domain):
+ """Create a new SearchAndOrganizeUsers object configured for a domain.
+
+ Args:
+ client_id: [string] The clientId of the developer.
+ client_secret: [string] The clientSecret of the developer.
+ domain: [string] The domain on which the functions are to be performed.
+ """
+ self.client_id = client_id
+ self.client_secret = client_secret
+ self.domain = domain
+
+ def AuthorizeClient(self):
+ """Authorize the clients for making API requests."""
+ self.token = gdata.gauth.OAuth2Token(
+ client_id=self.client_id, client_secret=self.client_secret,
+ scope=SCOPES, user_agent=USER_AGENT)
+ uri = self.token.generate_authorize_url()
+ print 'Please visit this URL to authorize the application:'
+ print uri
+ # Get the verification code from the standard input.
+ code = raw_input('What is the verification code? ').strip()
+ self.token.get_access_token(code)
+ self.user_client = AppsClient(domain=self.domain, auth_token=self.token)
+ self.org_client = OrganizationUnitProvisioningClient(
+ domain=self.domain, auth_token=self.token)
+
+ def OrganizeUsers(self, customer_id, org_unit_path, pattern):
+ """Find users with given pattern and move to an organization in batches.
+
+ Args:
+ customer_id: [string] customer_id to make calls to Organization API.
+ org_unit_path: [string] path of organization unit where users are moved
+ pattern: [regex object] regex to match with users
+ """
+ users = self.user_client.RetrieveAllUsers()
+ matched_users = []
+ # Search the users that match given pattern
+ for user in users.entry:
+ if (pattern.search(user.login.user_name) or
+ pattern.search(user.name.given_name) or
+ pattern.search(user.name.family_name)):
+ user_email = '%s@%s' % (user.login.user_name, self.domain)
+ matched_users.append(user_email)
+ # Maximum BATCH_SIZE users can be moved at one time
+ # Split users into batches of BATCH_SIZE and move in batches
+ for i in xrange(0, len(matched_users), BATCH_SIZE):
+ batch_to_move = matched_users[i: i + BATCH_SIZE]
+ self.org_client.MoveUserToOrgUnit(customer_id,
+ org_unit_path, batch_to_move)
+ print 'Number of users moved = %d' % len(matched_users)
+
+ def Run(self, org_unit_path, regex):
+ self.AuthorizeClient()
+ customer_id_entry = self.org_client.RetrieveCustomerId()
+ customer_id = customer_id_entry.customer_id
+ pattern = re.compile(regex)
+ print 'Moving Users with the pattern %s' % regex
+ self.OrganizeUsers(customer_id, org_unit_path, pattern)
+
+
+def main():
+ usage = 'Usage: %prog [options]'
+ parser = OptionParser(usage=usage)
+ parser.add_option('--DOMAIN',
+ help='Google Apps Domain, e.g. "domain.com".')
+ parser.add_option('--CLIENT_ID',
+ help='Registered CLIENT_ID of Domain.')
+ parser.add_option('--CLIENT_SECRET',
+ help='Registered CLIENT_SECRET of Domain.')
+ parser.add_option('--ORG_UNIT_PATH',
+ help='Orgunit path of organization where to move users.')
+ parser.add_option('--PATTERN',
+ help='Pattern to search in users')
+ (options, args) = parser.parse_args()
+
+ if not (options.DOMAIN and options.CLIENT_ID and options.CLIENT_SECRET
+ and options.ORG_UNIT_PATH and options.PATTERN):
+ parser.print_help()
+ return
+
+ sample = SearchAndOrganizeUsers(options.CLIENT_ID, options.CLIENT_SECRET,
+ options.DOMAIN)
+ sample.Run(options.ORG_UNIT_PATH, options.PATTERN)
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/suspended_users_cleanup.py b/samples/apps/suspended_users_cleanup.py
new file mode 100644
index 0000000..5582cf4
--- /dev/null
+++ b/samples/apps/suspended_users_cleanup.py
@@ -0,0 +1,115 @@
+#!/usr/bin/python
+#
+# Copyright 2012 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample to delete suspended users whose last login date is 6 months old.
+
+Sample to obtain the suspended users and their last login date from the
+Reporting API and delete the user if the last login date is older than
+6 months using the Provisioning API.
+"""
+
+__author__ = 'Shraddha Gupta <shraddhag@google.com>'
+
+import datetime
+import getopt
+import sys
+import gdata.apps.client
+import gdata.client
+import google.apps.reporting
+
+
+def Usage():
+ print ('Usage: suspended_users_cleanup.py --email=<email> '
+ '--password=<password> --domain=<domain> ')
+
+
+def GetAccountsReport(report_runner):
+ """Gets the account report from the Reporting API for current date.
+
+ Args:
+ report_runner: An instance of google.apps.reporting.ReportRunner.
+
+ Returns:
+ response: String containing accounts report.
+ """
+ if report_runner.token is None:
+ report_runner.Login()
+ request = google.apps.reporting.ReportRequest()
+ request.token = report_runner.token
+ request.domain = report_runner.domain
+ request.report_name = 'accounts'
+ request.date = report_runner.GetLatestReportDate()
+ response = report_runner.GetReportData(request)
+ return response
+
+
+def main():
+ """Gets accounts report and deletes old suspended users."""
+ try:
+ (opts, args) = getopt.getopt(sys.argv[1:], '', ['email=', 'password=',
+ 'domain='])
+ except getopt.GetoptError:
+ print 'Error'
+ Usage()
+ sys.exit(1)
+ opts = dict(opts)
+
+ report_runner = google.apps.reporting.ReportRunner()
+ email = opts.get('--email')
+ report_runner.admin_email = email
+ password = opts.get('--password')
+ report_runner.admin_password = password
+ domain = opts.get('--domain')
+ report_runner.domain = domain
+ if not email or not password or not domain:
+ Usage()
+ sys.exit(1)
+
+ # Instantiate a client for Provisioning API
+ client = gdata.apps.client.AppsClient(domain=domain)
+ client.ClientLogin(email=email, password=password,
+ source='DeleteOldSuspendedUsers')
+
+ # Get accounts report from the Reporting API
+ response = GetAccountsReport(report_runner)
+ accounts = response.splitlines()
+ current_date = datetime.datetime.now()
+
+ # accounts[0] contains the headings for fields, read data starting at index 1
+ for i in range(1, len(accounts)):
+ account_fields = accounts[i].split(',')
+ # Find the suspended users and check if last login date is 180 days old
+ if account_fields[3] != 'ACTIVE':
+ last_login_date_str = account_fields[10]
+ last_login_date = datetime.datetime.strptime(last_login_date_str,
+ '%Y%m%d')
+ duration = current_date - last_login_date
+ days = duration.days
+ if days > 180:
+ account_id = account_fields[2]
+ print 'This user is obsolete: %s' % account_id
+ user_name = account_id.split('@')
+ delete_flag = raw_input('Do you want to delete the user (y/n)? ')
+ if delete_flag == 'y':
+ try:
+ client.DeleteUser(user_name[0])
+ print 'Deleted %s ' % account_id
+ except gdata.client.RequestError, e:
+ print 'Request Error %s %s %s' % (e.status, e.reason, e.body)
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/user_profile_contacts_2lo.py b/samples/apps/user_profile_contacts_2lo.py
new file mode 100644
index 0000000..368d57f
--- /dev/null
+++ b/samples/apps/user_profile_contacts_2lo.py
@@ -0,0 +1,170 @@
+#!/usr/bin/python
+#
+# Copyright 2012 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample to retrieve profile and contacts of a domain user.
+
+The sample uses 2-legged OAuth to authorize clients of User Provisioning
+and Contacts API and retrieves user's profile and contacts.
+"""
+
+__author__ = 'Shraddha Gupta <shraddhag@google.com>'
+
+from optparse import OptionParser
+import gdata.apps.client
+import gdata.contacts.client
+import gdata.gauth
+
+
+class UserProfileAndContactsSample(object):
+ """Class to demonstrate retrieval of domain user's profile and contacts."""
+
+ def __init__(self, consumer_key, consumer_secret):
+ """Creates a new UserProfileAndContactsSample object for a domain.
+
+ Args:
+ consumer_key: String, consumer key of the domain.
+ consumer_secret: String, consumer secret of the domain.
+ """
+ self.consumer_key = consumer_key
+ self.consumer_secret = consumer_secret
+ self.domain = consumer_key
+
+ def TwoLOAuthorize(self, admin_id):
+ """Authorize clients of User Provisioning and Contacts API using 2LO.
+
+ Args:
+ admin_id: String, admin username for 2LO with the Provisioning API.
+ """
+ requestor_id = '%s@%s' % (admin_id, self.consumer_key)
+ two_legged_oauth_token = gdata.gauth.TwoLeggedOAuthHmacToken(
+ self.consumer_key, self.consumer_secret, requestor_id)
+
+ self.apps_client = gdata.apps.client.AppsClient(domain=self.domain)
+ self.apps_client.auth_token = two_legged_oauth_token
+
+ self.contacts_client = gdata.contacts.client.ContactsClient(
+ domain=self.domain)
+ self.contacts_client.auth_token = two_legged_oauth_token
+
+ def PrintProfile(self, profile):
+ """Prints the contents of a profile entry.
+
+ Args:
+ profile: gdata.contacts.data.ProfileEntry.
+ """
+ for email in profile.email:
+ if email.primary == 'true':
+ print 'Email: %s (primary)' % email.address
+ else:
+ print 'Email: %s' % email.address
+ if profile.name:
+ print 'Name: %s' % profile.name.full_name.text
+ if profile.nickname:
+ print 'Nickname: %s' % profile.nickname.text
+ if profile.occupation:
+ print 'Occupation: %s' % profile.occupation.text
+ if profile.gender:
+ print 'Gender: %s' % profile.gender.value
+ if profile.birthday:
+ print 'Birthday: %s' % profile.birthday.when
+ for phone_number in profile.phone_number:
+ print 'Phone Number: %s' % phone_number.text
+
+ def GetProfile(self, admin_id, user_id):
+ """Retrieves the profile of a user.
+
+ Args:
+ admin_id: String, admin username.
+ user_id: String, user whose profile is retrieved.
+
+ Returns:
+ profile_entry: gdata.contacts.data.ProfileEntry.
+ """
+ requestor_id = '%s@%s' % (admin_id, self.domain)
+ self.contacts_client.auth_token.requestor_id = requestor_id
+ entry_uri = '%s/%s' % (self.contacts_client.GetFeedUri('profiles'),
+ user_id)
+ profile_entry = self.contacts_client.GetProfile(entry_uri)
+ return profile_entry
+
+ def GetContacts(self, user_id):
+ """Retrieves the contacts of a user.
+
+ Args:
+ user_id: String, user whose contacts are retrieved.
+
+ Returns:
+ contacts: List of strings containing user contacts.
+ """
+ requestor_id = '%s@%s' % (user_id, self.domain)
+ self.contacts_client.auth_token.requestor_id = requestor_id
+ contacts = []
+ try:
+ contact_feed = self.contacts_client.GetContacts()
+ for contact_entry in contact_feed.entry:
+ contacts.append(contact_entry.title.text)
+ except gdata.client.Unauthorized, e:
+ print 'Error: %s %s' % (e.status, e.reason)
+ return contacts
+
+ def Run(self, admin_id, user_id):
+ """Retrieves profile and contacts of a user.
+
+ Args:
+ admin_id: String, admin username.
+ user_id: String, user whose information is retrieved.
+ """
+ self.TwoLOAuthorize(admin_id)
+ print 'Profile of user: %s' % user_id
+ profile = self.GetProfile(admin_id, user_id)
+ self.PrintProfile(profile)
+ user = self.apps_client.RetrieveUser(user_id)
+ print 'Is admin: %s' % user.login.admin
+ print 'Suspended: %s' % user.login.suspended
+ contacts = self.GetContacts(user_id)
+ print '\nContacts of user '
+ for contact in contacts:
+ print contact
+
+
+def main():
+ """Demonstrates retrieval of domain user's profile and contacts using 2LO."""
+
+ usage = ('Usage: %prog --consumer_key <consumer_key> '
+ '--consumer_secret <consumer_secret> --admin_id <admin_id> '
+ '--user_id=<user_id> ')
+ parser = OptionParser(usage=usage)
+ parser.add_option('--consumer_key',
+ help='Domain name is also consumer key.')
+ parser.add_option('--consumer_secret',
+ help='Consumer secret of the domain.')
+ parser.add_option('--admin_id',
+ help='Username of admin.')
+ parser.add_option('--user_id',
+ help='Username of domain user.')
+ (options, args) = parser.parse_args()
+
+ if (not options.consumer_key or not options.consumer_secret
+ or not options.admin_id or not options.user_id):
+ parser.print_help()
+ return 1
+ sample = UserProfileAndContactsSample(options.consumer_key,
+ options.consumer_secret)
+ sample.Run(options.admin_id, options.user_id)
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/apps/userprovisioning_quick_start_example.py b/samples/apps/userprovisioning_quick_start_example.py
new file mode 100644
index 0000000..9ff7398
--- /dev/null
+++ b/samples/apps/userprovisioning_quick_start_example.py
@@ -0,0 +1,323 @@
+#!/usr/bin/python
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample for the User Provisioning API to demonstrate all methods.
+
+Usage:
+ $ python userprovisioning_quick_start_example.py
+
+You can also specify the user credentials from the command-line
+
+ $ python userprovisioning_quick_start_example.py
+ --client_id [client_id] --client_secret [client_scret] --domain [domain]
+
+You can get help for command-line arguments as
+
+ $ python userprovisioning_quick_start_example.py --help
+"""
+
+__author__ = 'Shraddha Gupta <shraddhag@google.com>'
+
+import getopt
+import getpass
+import sys
+import gdata.apps.client
+
+SCOPE = 'https://apps-apis.google.com/a/feeds/user/'
+USER_AGENT = 'UserProvisioningQuickStartExample'
+
+
+class UserProvisioning(object):
+ """Demonstrates all the functions of user provisioning."""
+
+ def __init__(self, client_id, client_secret, domain):
+ """
+ Args:
+ client_id: [string] The clientId of the developer.
+ client_secret: [string] The clientSecret of the developer.
+ domain: [string] The domain on which the functions are to be performed.
+ """
+ self.client_id = client_id
+ self.client_secret = client_secret
+ self.domain = domain
+
+ def _AuthorizeClient(self):
+ """Authorize the client for making API requests."""
+
+ self.token = gdata.gauth.OAuth2Token(
+ client_id=self.client_id, client_secret=self.client_secret,
+ scope=SCOPE, user_agent=USER_AGENT)
+ uri = self.token.generate_authorize_url()
+ print 'Please visit this URL to authorize the application:'
+ print uri
+ # Get the verification code from the standard input.
+ code = raw_input('What is the verification code? ').strip()
+ self.token.get_access_token(code)
+ self.client = gdata.apps.client.AppsClient(
+ domain=self.domain, auth_token=self.token)
+
+ def _PrintUserDetails(self, entry):
+ """Prints the attributes for a user entry.
+
+ Args:
+ entry: [UserEntry] User entry corresponding to a user
+ """
+ print '\nGiven Name: %s' % (entry.name.given_name)
+ print 'Family Name: %s' % (entry.name.family_name)
+ print 'Username: %s' % (entry.login.user_name)
+ print 'Is Admin: %s' % (entry.login.admin)
+ print 'Is Suspended: %s' % (entry.login.suspended)
+ print 'Change password at next login: %s\n' % (
+ entry.login.change_password)
+
+ def _PrintNicknameDetails(self, entry):
+ """Prints the attributes for a user nickname entry.
+
+ Args:
+ entry: [NicknameEntry]
+ """
+ print 'Username: %s' % (entry.login.user_name)
+ print 'Nickname: %s\n' % (entry.nickname.name)
+
+ def _GetChoice(self, for_value):
+ choice = raw_input(('(Optional) Enter a choice for %s\n'
+ '1-True 2-False ') % (for_value))
+ if choice == '1':
+ return True
+ return False
+
+ def _CreateUser(self):
+ """Creates a new user account."""
+
+ user_name = given_name = family_name = password = None
+ confirm_password = ''
+ while not user_name:
+ user_name = raw_input('Enter a new username: ')
+ while not given_name:
+ given_name = raw_input('Enter given name for the user: ')
+ while not family_name:
+ family_name = raw_input('Enter family name for the user: ')
+ while not password == confirm_password:
+ password = ''
+ while not password:
+ sys.stdout.write('Enter password for the user: ')
+ password = getpass.getpass()
+ if password.__len__() == 0:
+ break
+ if password.__len__() < 8:
+ print 'Password must be at least 8 characters long'
+ password = ''
+ sys.stdout.write('Confirm password: ')
+ confirm_password = getpass.getpass()
+
+ is_admin = self._GetChoice('is_admin ')
+ hash_function = raw_input('(Optional) Enter a hash function ')
+ suspended = self._GetChoice('suspended ')
+ change_password = self._GetChoice('change_password ')
+ quota = raw_input('(Optional) Enter a quota ')
+
+ if quota == 'None' or not quota.isdigit():
+ quota = None
+ user_entry = self.client.CreateUser(
+ user_name=user_name, given_name=given_name, family_name=family_name,
+ password=password, admin=is_admin, suspended=suspended,
+ password_hash_function=hash_function,
+ change_password=change_password)
+ self._PrintUserDetails(user_entry)
+ print 'User Created'
+
+ def _UpdateUser(self):
+ """Updates a user."""
+
+ user_name = raw_input('Enter the username ')
+ if user_name is None:
+ print 'Username missing\n'
+ return
+ user_entry = self.client.RetrieveUser(user_name=user_name)
+ print self._PrintUserDetails(user_entry)
+
+ attributes = {1: 'given_name', 2: 'family_name', 3: 'user_name',
+ 4: 'suspended', 5: 'is_admin'}
+ print attributes
+ attr = int(raw_input('\nEnter number(1-5) of attribute to be updated '))
+
+ updated_val = raw_input('Enter updated value ')
+ if attr == 1:
+ user_entry.name.given_name = updated_val
+ if attr == 2:
+ user_entry.name.family_name = updated_val
+ if attr == 3:
+ user_entry.login.user_name = updated_val
+ if attr == 4:
+ user_entry.login.suspended = updated_val
+ if attr == 5:
+ user_entry.login.admin = updated_val
+
+ updated = self.client.UpdateUser(user_entry.login.user_name, user_entry)
+ self._PrintUserDetails(updated)
+
+ def _RetrieveSingleUser(self):
+ """Retrieves a single user."""
+
+ user_name = raw_input('Enter the username ')
+ if user_name is None:
+ print 'Username missing\n'
+ return
+ response = self.client.RetrieveUser(user_name=user_name)
+ self._PrintUserDetails(response)
+
+ def _RetrieveAllUsers(self):
+ """Retrieves all users from all the domains."""
+
+ response = self.client.RetrieveAllUsers()
+ for entry in response.entry:
+ self._PrintUserDetails(entry)
+
+ def _DeleteUser(self):
+ """Deletes a user."""
+
+ user_name = raw_input('Enter the username ')
+ if user_name is None:
+ print 'Username missing\n'
+ return
+
+ self.client.DeleteUser(user_name=user_name)
+ print 'User Deleted'
+
+ def _CreateNickname(self):
+ """Creates a user alias."""
+
+ user_name = raw_input('Enter the username ')
+ nickname = raw_input('Enter a nickname for user ')
+ if None in (user_name, nickname):
+ print 'Username/Nickname missing\n'
+ return
+ nickname = self.client.CreateNickname(
+ user_name=user_name, nickname=nickname)
+ print nickname
+ print 'Nickname Created'
+
+ def _RetrieveNickname(self):
+ """Retrieves a nickname entry."""
+
+ nickname = raw_input('Enter the username ')
+ if nickname is None:
+ print 'Nickname missing\n'
+ return
+ response = self.client.RetrieveNickname(nickname=nickname)
+ self._PrintNicknameDetails(response)
+
+ def _RetrieveUserNicknames(self):
+ """Retrieves all nicknames of a user."""
+
+ user_name = raw_input('Enter the username ')
+ if user_name is None:
+ print 'Username missing\n'
+ return
+ response = self.client.RetrieveNicknames(user_name=user_name)
+ for entry in response.entry:
+ self._PrintNicknameDetails(entry)
+
+ def _DeleteNickname(self):
+ """Deletes a nickname."""
+
+ nickname = raw_input('Enter the username ')
+ if nickname is None:
+ print 'Nickname missing\n'
+ return
+ self.client.DeleteNickname(nickname=nickname)
+ print 'Nickname deleted'
+
+ def Run(self):
+ """Runs the sample by getting user input and taking appropriate action."""
+
+ # List of all the functions and their descriptions
+ functions_list = [
+ {'function': self._CreateUser,
+ 'description': 'Create a user'},
+ {'function': self._UpdateUser,
+ 'description': 'Update a user'},
+ {'function': self._RetrieveSingleUser,
+ 'description': 'Retrieve a single user'},
+ {'function': self._RetrieveAllUsers,
+ 'description': 'Retrieve all users'},
+ {'function': self._DeleteUser,
+ 'description': 'Delete a user'},
+ {'function': self._CreateNickname,
+ 'description': 'Create a nickname'},
+ {'function': self._RetrieveNickname,
+ 'description': 'Retrieve a nickname'},
+ {'function': self._RetrieveUserNicknames,
+ 'description': 'Retrieve all nicknames for a user'},
+ {'function': self._DeleteNickname,
+ 'description': 'Delete a nickname'}
+ ]
+ self._AuthorizeClient()
+ while True:
+ print '\nChoose an option:\n0 - to exit'
+ for i in range (0, len(functions_list)):
+ print '%d - %s' % ((i+1), functions_list[i]['description'])
+ choice = int(raw_input())
+ if choice == 0:
+ break
+ if choice < 0 or choice > 11:
+ print 'Not a valid option!'
+ continue
+ functions_list[choice-1]['function']()
+
+
+def main():
+ """A menu driven application to demo all methods of user provisioning."""
+
+ usage = ('python userprovisioning_quick_start_example.py '
+ '--client_id [clientId] --client_secret [clientSecret] '
+ '--domain [domain]')
+ # Parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['client_id=',
+ 'client_secret=',
+ 'domain='])
+ except getopt.error, msg:
+ print 'Usage: %s' % usage
+ return
+
+ client_id = None
+ client_secret = None
+ domain = None
+ # Parse options
+ for option, arg in opts:
+ if option == '--client_id':
+ client_id = arg
+ elif option == '--client_secret':
+ client_secret = arg
+ elif option == '--domain':
+ domain = arg
+
+ if None in (client_id, client_secret, domain):
+ print 'Usage: %s' % usage
+ return
+
+ try:
+ user_provisioning = UserProvisioning(client_id, client_secret, domain)
+ except gdata.service.BadAuthentication:
+ print 'Invalid user credentials given.'
+ return
+
+ user_provisioning.Run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/authsub/secure_authsub.py b/samples/authsub/secure_authsub.py
new file mode 100755
index 0000000..7efb196
--- /dev/null
+++ b/samples/authsub/secure_authsub.py
@@ -0,0 +1,187 @@
+#!/usr/bin/python
+#
+# Copyright 2008 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample to demonstrate using secure AuthSub in the Google Data Python client.
+
+This sample focuses on the Google Health Data API because it requires the use
+of secure tokens. This samples makes queries against the H9 Developer's
+Sandbox (https://www.google.com/h9). To run this sample:
+ 1.) Use Apache's mod_python
+ 2.) Run from your local webserver (e.g. http://localhost/...)
+ 3.) You need to have entered medication data into H9
+
+ HealthAubSubHelper: Class to handle secure AuthSub tokens.
+ GetMedicationHTML: Returns the user's medication formatted in HTML.
+ index: Main entry point for the web app.
+"""
+
+__author__ = 'e.bidelman@google.com (Eric Bidelman)'
+
+
+import os
+import sys
+import urllib
+import gdata.auth
+import gdata.service
+
+H9_PROFILE_FEED_URL = 'https://www.google.com/h9/feeds/profile/default'
+
+class HealthAuthSubHelper(object):
+ """A secure AuthSub helper to interact with the Google Health Data API"""
+
+ H9_AUTHSUB_HANDLER = 'https://www.google.com/h9/authsub'
+ H9_SCOPE = 'https://www.google.com/h9/feeds/'
+
+ def GetNextUrl(self, req):
+ """Computes the current URL the web app is running from.
+
+ Args:
+ req: mod_python mp_request instance to build the URL from.
+
+ Returns:
+ A string representing the web app's URL.
+ """
+ if req.is_https():
+ next_url = 'https://'
+ else:
+ next_url = 'http://'
+ next_url += req.hostname + req.unparsed_uri
+ return next_url
+
+ def GenerateAuthSubRequestUrl(self, next, scopes=[H9_SCOPE],
+ secure=True, session=True, extra_params=None,
+ include_scopes_in_next=True):
+ """Constructs the URL to the AuthSub token handler.
+
+ Args:
+ next: string The URL AuthSub will redirect back to.
+ Use self.GetNextUrl() to return that URL.
+ scopes: (optional) string or list of scopes the token will be valid for.
+ secure: (optional) boolean True if the token should be a secure one
+ session: (optional) boolean True if the token will be exchanged for a
+ session token.
+ extra_params: (optional) dict of additional parameters to pass to AuthSub.
+ include_scopes_in_next: (optional) boolean True if the scopes in the
+ scopes should be passed to AuthSub.
+
+ Returns:
+ A string (as a URL) to use for the AuthSubRequest endpoint.
+ """
+ auth_sub_url = gdata.service.GenerateAuthSubRequestUrl(
+ next, scopes, hd='default', secure=secure, session=session,
+ request_url=self.H9_AUTHSUB_HANDLER,
+ include_scopes_in_next=include_scopes_in_next)
+ if extra_params:
+ auth_sub_url = '%s&%s' % (auth_sub_url, urllib.urlencode(extra_params))
+ return auth_sub_url
+
+ def SetPrivateKey(self, filename):
+ """Reads the private key from the specified file.
+
+ See http://code.google.com/apis/gdata/authsub.html#Registered for\
+ information on how to create a RSA private key/public cert pair.
+
+ Args:
+ filename: string .pem file the key is stored in.
+
+ Returns:
+ The private key as a string.
+
+ Raises:
+ IOError: The file could not be read or does not exist.
+ """
+ try:
+ f = open(filename)
+ rsa_private_key = f.read()
+ f.close()
+ except IOError, (errno, strerror):
+ raise 'I/O error(%s): %s' % (errno, strerror)
+ self.rsa_key = rsa_private_key
+ return rsa_private_key
+
+
+
+def GetMedicationHTML(feed):
+ """Prints out the user's medication to the console.
+
+ Args:
+ feed: A gdata.GDataFeed instance.
+
+ Returns:
+ An HTML formatted string containing the user's medication data.
+ """
+ if not feed.entry:
+ return '<b>No entries in feed</b><br>'
+
+ html = []
+ for entry in feed.entry:
+ try:
+ ccr = entry.FindExtensions('ContinuityOfCareRecord')[0]
+ body = ccr.FindChildren('Body')[0]
+ meds = body.FindChildren('Medications')[0].FindChildren('Medication')
+ for med in meds:
+ name = med.FindChildren('Product')[0].FindChildren('ProductName')[0]
+ html.append('<li>%s</li>' % name.FindChildren('Text')[0].text)
+ except:
+ html.append('<b>No medication data in this profile</b><br>')
+ return '<ul>%s</ul>' % ''.join(html)
+
+def index(req):
+ req.content_type = 'text/html'
+
+ authsub = HealthAuthSubHelper()
+ client = gdata.service.GDataService(service='weaver')
+
+ current_url = authsub.GetNextUrl(req)
+ rsa_key = authsub.SetPrivateKey('/path/to/yourRSAPrivateKey.pem')
+
+ # Strip token query parameter's value from URL if it exists
+ token = gdata.auth.extract_auth_sub_token_from_url(current_url,
+ rsa_key=rsa_key)
+
+ if not token:
+ """STEP 1: No single use token in the URL or a saved session token.
+ Generate the AuthSub URL to fetch a single use token."""
+
+ params = {'permission': 1}
+ authsub_url = authsub.GenerateAuthSubRequestUrl(current_url,
+ extra_params=params)
+ req.write('<a href="%s">Link your Google Health Profile</a>' % authsub_url)
+ else:
+ """STEP 2: A single use token was extracted from the URL.
+ Upgrade the one time token to a session token."""
+
+ req.write('<b>Single use token</b>: %s<br>' % str(token))
+
+ client.UpgradeToSessionToken(token) # calls gdata.service.SetAuthSubToken()
+
+ """STEP 3: Done with AuthSub :) Save the token for subsequent requests.
+ Query the Health Data API"""
+ req.write('<b>Token info</b>: %s<br>' % client.AuthSubTokenInfo())
+
+ req.write('<b>Session token</b>: %s<br>' % client.GetAuthSubToken())
+
+ # Query the Health Data API
+ params = {'digest': 'true', 'strict': 'true'}
+ uri = '%s?%s' % (H9_PROFILE_FEED_URL, urllib.urlencode(params))
+ feed = client.GetFeed(uri)
+
+ req.write('<h4>Listing medications</h4>')
+ req.write(GetMedicationHTML(feed))
+
+ """STEP 4: Revoke the session token."""
+ req.write('Revoked session token')
+ client.RevokeAuthSubToken()
diff --git a/samples/blogger/BloggerExample.py b/samples/blogger/BloggerExample.py
new file mode 100755
index 0000000..39cd87c
--- /dev/null
+++ b/samples/blogger/BloggerExample.py
@@ -0,0 +1,261 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This file demonstrates how to use the Google Data API's Python client library
+# to interface with the Blogger service. There are examples for the following
+# operations:
+#
+# * Retrieving the list of all the user's blogs
+# * Retrieving all posts on a single blog
+# * Performing a date-range query for posts on a blog
+# * Creating draft posts and publishing posts
+# * Updating posts
+# * Retrieving comments
+# * Creating comments
+# * Deleting comments
+# * Deleting posts
+
+
+__author__ = 'lkeppler@google.com (Luke Keppler)'
+
+
+import gdata.blogger.client
+import gdata.client
+import gdata.sample_util
+import gdata.data
+import atom.data
+
+
+class BloggerExample:
+
+ def __init__(self):
+ """Creates a GDataService and provides ClientLogin auth details to it.
+ The email and password are required arguments for ClientLogin. The
+ 'source' defined below is an arbitrary string, but should be used to
+ reference your name or the name of your organization, the app name and
+ version, with '-' between each of the three values."""
+
+ # Authenticate using ClientLogin, AuthSub, or OAuth.
+ self.client = gdata.blogger.client.BloggerClient()
+ gdata.sample_util.authorize_client(
+ self.client, service='blogger', source='Blogger_Python_Sample-2.0',
+ scopes=['http://www.blogger.com/feeds/'])
+
+ # Get the blog ID for the first blog.
+ feed = self.client.get_blogs()
+ self.blog_id = feed.entry[0].get_blog_id()
+
+ def PrintUserBlogTitles(self):
+ """Prints a list of all the user's blogs."""
+
+ # Request the feed.
+ feed = self.client.get_blogs()
+
+ # Print the results.
+ print feed.title.text
+ for entry in feed.entry:
+ print "\t" + entry.title.text
+ print
+
+ def CreatePost(self, title, content, is_draft):
+ """This method creates a new post on a blog. The new post can be stored as
+ a draft or published based on the value of the is_draft parameter. The
+ method creates an GDataEntry for the new post using the title, content,
+ author_name and is_draft parameters. With is_draft, True saves the post as
+ a draft, while False publishes the post. Then it uses the given
+ GDataService to insert the new post. If the insertion is successful, the
+ added post (GDataEntry) will be returned.
+ """
+ return self.client.add_post(self.blog_id, title, content, draft=is_draft)
+
+ def PrintAllPosts(self):
+ """This method displays the titles of all the posts in a blog. First it
+ requests the posts feed for the blogs and then it prints the results.
+ """
+
+ # Request the feed.
+ feed = self.client.get_posts(self.blog_id)
+
+ # Print the results.
+ print feed.title.text
+ for entry in feed.entry:
+ if not entry.title.text:
+ print "\tNo Title"
+ else:
+ print "\t" + entry.title.text.encode('utf-8')
+ print
+
+ def PrintPostsInDateRange(self, start_time, end_time):
+ """This method displays the title and modification time for any posts that
+ have been created or updated in the period between the start_time and
+ end_time parameters. The method creates the query, submits it to the
+ GDataService, and then displays the results.
+
+ Note that while the start_time is inclusive, the end_time is exclusive, so
+ specifying an end_time of '2007-07-01' will include those posts up until
+ 2007-6-30 11:59:59PM.
+
+ The start_time specifies the beginning of the search period (inclusive),
+ while end_time specifies the end of the search period (exclusive).
+ """
+
+ # Create query and submit a request.
+ query = gdata.blogger.client.Query(updated_min=start_time,
+ updated_max=end_time,
+ order_by='updated')
+ print query.updated_min
+ print query.order_by
+ feed = self.client.get_posts(self.blog_id, query=query)
+
+ # Print the results.
+ print feed.title.text + " posts between " + start_time + " and " + end_time
+ print feed.title.text
+ for entry in feed.entry:
+ if not entry.title.text:
+ print "\tNo Title"
+ else:
+ print "\t" + entry.title.text
+ print
+
+ def UpdatePostTitle(self, entry_to_update, new_title):
+ """This method updates the title of the given post. The GDataEntry object
+ is updated with the new title, then a request is sent to the GDataService.
+ If the insertion is successful, the updated post will be returned.
+
+ Note that other characteristics of the post can also be modified by
+ updating the values of the entry object before submitting the request.
+
+ The entry_to_update is a GDatEntry containing the post to update.
+ The new_title is the text to use for the post's new title. Returns: a
+ GDataEntry containing the newly-updated post.
+ """
+
+ # Set the new title in the Entry object
+ entry_to_update.title = atom.data.Title(type='xhtml', text=new_title)
+ return self.client.update(entry_to_update)
+
+ def CreateComment(self, post_id, comment_text):
+ """This method adds a comment to the specified post. First the comment
+ feed's URI is built using the given post ID. Then a GDataEntry is created
+ for the comment and submitted to the GDataService. The post_id is the ID
+ of the post on which to post comments. The comment_text is the text of the
+ comment to store. Returns: an entry containing the newly-created comment
+
+ NOTE: This functionality is not officially supported yet.
+ """
+ return self.client.add_comment(self.blog_id, post_id, comment_text)
+
+ def PrintAllComments(self, post_id):
+ """This method displays all the comments for the given post. First the
+ comment feed's URI is built using the given post ID. Then the method
+ requests the comments feed and displays the results. Takes the post_id
+ of the post on which to view comments.
+ """
+
+ feed = self.client.get_post_comments(self.blog_id, post_id)
+
+ # Display the results
+ print feed.title.text
+ for entry in feed.entry:
+ print "\t" + entry.title.text
+ print "\t" + entry.updated.text
+ print
+
+ def DeleteComment(self, comment_entry):
+ """This method removes the comment specified by the given edit_link_href, the
+ URI for editing the comment.
+ """
+ self.client.delete(comment_entry)
+
+ def DeletePost(self, post_entry):
+ """This method removes the post specified by the given edit_link_href, the
+ URI for editing the post.
+ """
+
+ self.client.delete(post_entry)
+
+ def run(self):
+ """Runs each of the example methods defined above, demonstrating how to
+ interface with the Blogger service.
+ """
+
+ # Demonstrate retrieving a list of the user's blogs.
+ self.PrintUserBlogTitles()
+
+ # Demonstrate how to create a draft post.
+ draft_post = self.CreatePost('Snorkling in Aruba',
+ '<p>We had <b>so</b> much fun snorkling in Aruba<p>',
+ True)
+ print 'Successfully created draft post: "' + draft_post.title.text + '".\n'
+
+ # Delete the draft blog post.
+ self.client.delete(draft_post)
+
+ # Demonstrate how to publish a public post.
+ public_post = self.CreatePost("Back from vacation",
+ "<p>I didn't want to leave Aruba, but I ran out of money :(<p>",
+ False)
+ print "Successfully created public post: \"" + public_post.title.text + "\".\n"
+
+ # Demonstrate various feed queries.
+ print "Now listing all posts."
+ self.PrintAllPosts()
+ print "Now listing all posts between 2007-04-04 and 2007-04-23."
+ self.PrintPostsInDateRange("2007-04-04", "2007-04-23")
+
+ # Demonstrate updating a post's title.
+ print "Now updating the title of the post we just created:"
+ public_post = self.UpdatePostTitle(public_post, "The party's over")
+ print "Successfully changed the post's title to \"" + public_post.title.text + "\".\n"
+
+ # Demonstrate how to retrieve the comments for a post.
+
+ # Get the post ID and build the comments feed URI for the specified post
+ post_id = public_post.get_post_id()
+
+ print "Now posting a comment on the post titled: \"" + public_post.title.text + "\"."
+ comment = self.CreateComment(post_id, "Did you see any sharks?")
+ print "Successfully posted \"" + comment.content.text + "\" on the post titled: \"" + public_post.title.text + "\".\n"
+
+ comment_id = comment.GetCommentId()
+
+ print "Now printing all comments"
+ self.PrintAllComments(post_id)
+
+ # Delete the comment we just posted
+ print "Now deleting the comment we just posted"
+ self.DeleteComment(comment)
+ print "Successfully deleted comment."
+ self.PrintAllComments(post_id)
+
+ # Demonstrate deleting posts.
+ print "Now deleting the post titled: \"" + public_post.title.text + "\"."
+ self.DeletePost(public_post)
+ print "Successfully deleted post."
+ self.PrintAllPosts()
+
+
+def main():
+ """The main function runs the BloggerExample application.
+
+ NOTE: It is recommended that you run this sample using a test account.
+ """
+ sample = BloggerExample()
+ sample.run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/blogger/BloggerExampleV1.py b/samples/blogger/BloggerExampleV1.py
new file mode 100755
index 0000000..1f0361d
--- /dev/null
+++ b/samples/blogger/BloggerExampleV1.py
@@ -0,0 +1,317 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This file demonstrates how to use the Google Data API's Python client library
+# to interface with the Blogger service. There are examples for the following
+# operations:
+#
+# * Retrieving the list of all the user's blogs
+# * Retrieving all posts on a single blog
+# * Performing a date-range query for posts on a blog
+# * Creating draft posts and publishing posts
+# * Updating posts
+# * Retrieving comments
+# * Creating comments
+# * Deleting comments
+# * Deleting posts
+
+
+__author__ = 'lkeppler@google.com (Luke Keppler)'
+
+
+from gdata import service
+import gdata
+import atom
+import getopt
+import sys
+
+
+class BloggerExample:
+
+ def __init__(self, email, password):
+ """Creates a GDataService and provides ClientLogin auth details to it.
+ The email and password are required arguments for ClientLogin. The
+ 'source' defined below is an arbitrary string, but should be used to
+ reference your name or the name of your organization, the app name and
+ version, with '-' between each of the three values."""
+
+ # Authenticate using ClientLogin.
+ self.service = service.GDataService(email, password)
+ self.service.source = 'Blogger_Python_Sample-1.0'
+ self.service.service = 'blogger'
+ self.service.server = 'www.blogger.com'
+ self.service.ProgrammaticLogin()
+
+ # Get the blog ID for the first blog.
+ feed = self.service.Get('/feeds/default/blogs')
+ self_link = feed.entry[0].GetSelfLink()
+ if self_link:
+ self.blog_id = self_link.href.split('/')[-1]
+
+ def PrintUserBlogTitles(self):
+ """Prints a list of all the user's blogs."""
+
+ # Request the feed.
+ query = service.Query()
+ query.feed = '/feeds/default/blogs'
+ feed = self.service.Get(query.ToUri())
+
+ # Print the results.
+ print feed.title.text
+ for entry in feed.entry:
+ print "\t" + entry.title.text
+ print
+
+ def CreatePost(self, title, content, author_name, is_draft):
+ """This method creates a new post on a blog. The new post can be stored as
+ a draft or published based on the value of the is_draft parameter. The
+ method creates an GDataEntry for the new post using the title, content,
+ author_name and is_draft parameters. With is_draft, True saves the post as
+ a draft, while False publishes the post. Then it uses the given
+ GDataService to insert the new post. If the insertion is successful, the
+ added post (GDataEntry) will be returned.
+ """
+
+ # Create the entry to insert.
+ entry = gdata.GDataEntry()
+ entry.author.append(atom.Author(atom.Name(text=author_name)))
+ entry.title = atom.Title(title_type='xhtml', text=title)
+ entry.content = atom.Content(content_type='html', text=content)
+ if is_draft:
+ control = atom.Control()
+ control.draft = atom.Draft(text='yes')
+ entry.control = control
+
+ # Ask the service to insert the new entry.
+ return self.service.Post(entry,
+ '/feeds/' + self.blog_id + '/posts/default')
+
+ def PrintAllPosts(self):
+ """This method displays the titles of all the posts in a blog. First it
+ requests the posts feed for the blogs and then it prints the results.
+ """
+
+ # Request the feed.
+ feed = self.service.GetFeed('/feeds/' + self.blog_id + '/posts/default')
+
+ # Print the results.
+ print feed.title.text
+ for entry in feed.entry:
+ if not entry.title.text:
+ print "\tNo Title"
+ else:
+ print "\t" + entry.title.text
+ print
+
+ def PrintPostsInDateRange(self, start_time, end_time):
+ """This method displays the title and modification time for any posts that
+ have been created or updated in the period between the start_time and
+ end_time parameters. The method creates the query, submits it to the
+ GDataService, and then displays the results.
+
+ Note that while the start_time is inclusive, the end_time is exclusive, so
+ specifying an end_time of '2007-07-01' will include those posts up until
+ 2007-6-30 11:59:59PM.
+
+ The start_time specifies the beginning of the search period (inclusive),
+ while end_time specifies the end of the search period (exclusive).
+ """
+
+ # Create query and submit a request.
+ query = service.Query()
+ query.feed = '/feeds/' + self.blog_id + '/posts/default'
+ query.updated_min = start_time
+ query.updated_max = end_time
+ query.orderby = 'updated'
+ feed = self.service.Get(query.ToUri())
+
+ # Print the results.
+ print feed.title.text + " posts between " + start_time + " and " + end_time
+ print feed.title.text
+ for entry in feed.entry:
+ if not entry.title.text:
+ print "\tNo Title"
+ else:
+ print "\t" + entry.title.text
+ print
+
+ def UpdatePostTitle(self, entry_to_update, new_title):
+ """This method updates the title of the given post. The GDataEntry object
+ is updated with the new title, then a request is sent to the GDataService.
+ If the insertion is successful, the updated post will be returned.
+
+ Note that other characteristics of the post can also be modified by
+ updating the values of the entry object before submitting the request.
+
+ The entry_to_update is a GDatEntry containing the post to update.
+ The new_title is the text to use for the post's new title. Returns: a
+ GDataEntry containing the newly-updated post.
+ """
+
+ # Set the new title in the Entry object
+ entry_to_update.title = atom.Title('xhtml', new_title)
+
+ # Grab the edit URI
+ edit_uri = entry_to_update.GetEditLink().href
+
+ return self.service.Put(entry_to_update, edit_uri)
+
+ def CreateComment(self, post_id, comment_text):
+ """This method adds a comment to the specified post. First the comment
+ feed's URI is built using the given post ID. Then a GDataEntry is created
+ for the comment and submitted to the GDataService. The post_id is the ID
+ of the post on which to post comments. The comment_text is the text of the
+ comment to store. Returns: an entry containing the newly-created comment
+
+ NOTE: This functionality is not officially supported yet.
+ """
+
+ # Build the comment feed URI
+ feed_uri = '/feeds/' + self.blog_id + '/' + post_id + '/comments/default'
+
+ # Create a new entry for the comment and submit it to the GDataService
+ entry = gdata.GDataEntry()
+ entry.content = atom.Content(content_type='xhtml', text=comment_text)
+ return self.service.Post(entry, feed_uri)
+
+ def PrintAllComments(self, post_id):
+ """This method displays all the comments for the given post. First the
+ comment feed's URI is built using the given post ID. Then the method
+ requests the comments feed and displays the results. Takes the post_id
+ of the post on which to view comments.
+ """
+
+ # Build comment feed URI and request comments on the specified post
+ feed_url = '/feeds/' + self.blog_id + '/comments/default'
+ feed = self.service.Get(feed_url)
+
+ # Display the results
+ print feed.title.text
+ for entry in feed.entry:
+ print "\t" + entry.title.text
+ print "\t" + entry.updated.text
+ print
+
+ def DeleteComment(self, post_id, comment_id):
+ """This method removes the comment specified by the given edit_link_href, the
+ URI for editing the comment.
+ """
+
+ feed_uri = '/feeds/' + self.blog_id + '/' + post_id + '/comments/default/' + comment_id
+ self.service.Delete(feed_uri)
+
+ def DeletePost(self, edit_link_href):
+ """This method removes the post specified by the given edit_link_href, the
+ URI for editing the post.
+ """
+
+ self.service.Delete(edit_link_href)
+
+ def run(self):
+ """Runs each of the example methods defined above, demonstrating how to
+ interface with the Blogger service.
+ """
+
+ # Demonstrate retrieving a list of the user's blogs.
+ self.PrintUserBlogTitles()
+
+ # Demonstrate how to create a draft post.
+ draft_post = self.CreatePost("Snorkling in Aruba",
+ "<p>We had <b>so</b> much fun snorkling in Aruba<p>",
+ "Post author", True)
+ print "Successfully created draft post: \"" + draft_post.title.text + "\".\n"
+
+ # Demonstrate how to publish a public post.
+ public_post = self.CreatePost("Back from vacation",
+ "<p>I didn't want to leave Aruba, but I ran out of money :(<p>",
+ "Post author", False)
+ print "Successfully created public post: \"" + public_post.title.text + "\".\n"
+
+ # Demonstrate various feed queries.
+ print "Now listing all posts."
+ self.PrintAllPosts()
+ print "Now listing all posts between 2007-04-04 and 2007-04-23."
+ self.PrintPostsInDateRange("2007-04-04", "2007-04-23")
+
+ # Demonstrate updating a post's title.
+ print "Now updating the title of the post we just created:"
+ public_post = self.UpdatePostTitle(public_post, "The party's over")
+ print "Successfully changed the post's title to \"" + public_post.title.text + "\".\n"
+
+ # Demonstrate how to retrieve the comments for a post.
+
+ # Get the post ID and build the comments feed URI for the specified post
+ self_id = public_post.id.text
+ tokens = self_id.split("-")
+ post_id = tokens[-1]
+
+ print "Now posting a comment on the post titled: \"" + public_post.title.text + "\"."
+ comment = self.CreateComment(post_id, "Did you see any sharks?")
+ print "Successfully posted \"" + comment.content.text + "\" on the post titled: \"" + public_post.title.text + "\".\n"
+
+ comment_id = comment.GetEditLink().href.split("/")[-1]
+
+ print "Now printing all comments"
+ self.PrintAllComments(post_id)
+
+ # Delete the comment we just posted
+ print "Now deleting the comment we just posted"
+ self.DeleteComment(post_id, comment_id)
+ print "Successfully deleted comment."
+ self.PrintAllComments(post_id)
+
+ # Get the post's edit URI
+ edit_uri = public_post.GetEditLink().href
+
+ # Demonstrate deleting posts.
+ print "Now deleting the post titled: \"" + public_post.title.text + "\"."
+ self.DeletePost(edit_uri)
+ print "Successfully deleted post."
+ self.PrintAllPosts()
+
+
+def main():
+ """The main function runs the BloggerExample application with the provided
+ username and password values. Authentication credentials are required.
+ NOTE: It is recommended that you run this sample using a test account."""
+
+ # parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], "", ["email=", "password="])
+ except getopt.error, msg:
+ print ('python BloggerExample.py --email [email] --password [password] ')
+ sys.exit(2)
+
+ email = ''
+ password = ''
+
+ # Process options
+ for o, a in opts:
+ if o == "--email":
+ email = a
+ elif o == "--password":
+ password = a
+
+ if email == '' or password == '':
+ print ('python BloggerExample.py --email [email] --password [password]')
+ sys.exit(2)
+
+ sample = BloggerExample(email, password)
+ sample.run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/blogger/app/app.yaml b/samples/blogger/app/app.yaml
new file mode 100644
index 0000000..bb0889f
--- /dev/null
+++ b/samples/blogger/app/app.yaml
@@ -0,0 +1,14 @@
+application: your-app-id-here
+version: 1
+runtime: python
+api_version: 1
+
+handlers:
+- url: /
+ static_files: welcome.html
+ upload: welcome.html
+
+
+- url: /.*
+ login: required
+ script: blogapp.py
diff --git a/samples/blogger/app/auth_required.html b/samples/blogger/app/auth_required.html
new file mode 100644
index 0000000..ff9bb43
--- /dev/null
+++ b/samples/blogger/app/auth_required.html
@@ -0,0 +1,10 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <title>Authorization Required</title>
+ </head>
+ <body>
+ <p>Before this application can see your available blogs or post on a blog, you must allow this app to access your Blogger data. Please <a href="{{ auth_url }}">click here to authorize</a> this application.</p>
+ <p>If you don't want to grant permission to this app, please <a href="{{ sign_out }}">sign out</a>.</p>
+ </body>
+</html>
diff --git a/samples/blogger/app/blogapp.py b/samples/blogger/app/blogapp.py
new file mode 100755
index 0000000..0d28276
--- /dev/null
+++ b/samples/blogger/app/blogapp.py
@@ -0,0 +1,137 @@
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import os
+import wsgiref.handlers
+from google.appengine.api import users
+from google.appengine.ext import webapp
+from google.appengine.ext.webapp import template
+from google.appengine.ext.webapp.util import run_wsgi_app
+import gdata.gauth
+import gdata.data
+import gdata.blogger.client
+
+
+def get_auth_token(request):
+ """Retrieves the AuthSub token for the current user.
+
+ Will first check the request URL for a token request parameter
+ indicating that the user has been sent to this page after
+ authorizing the app. Auto-upgrades to a session token.
+
+ If the token was not in the URL, which will usually be the case,
+ looks for the token in the datastore.
+
+ Returns:
+ The token object if one was found for the current user. If there
+ is no current user, it returns False, if there is a current user
+ but no AuthSub token, it returns None.
+ """
+ current_user = users.get_current_user()
+ if current_user is None or current_user.user_id() is None:
+ return False
+ # Look for the token string in the current page's URL.
+ token_string, token_scopes = gdata.gauth.auth_sub_string_from_url(
+ request.url)
+ if token_string is None:
+ # Try to find a previously obtained session token.
+ return gdata.gauth.ae_load('blogger' + current_user.user_id())
+ # If there was a new token in the current page's URL, convert it to
+ # to a long lived session token and persist it to be used in future
+ # requests.
+ single_use_token = gdata.gauth.AuthSubToken(token_string, token_scopes)
+ # Create a client to make the HTTP request to upgrade the single use token
+ # to a long lived session token.
+ client = gdata.client.GDClient()
+ session_token = client.upgrade_token(single_use_token)
+ gdata.gauth.ae_save(session_token, 'blogger' + current_user.user_id())
+ return session_token
+
+
+class ListBlogs(webapp.RequestHandler):
+ """Requests the list of the user's blogs from the Blogger API."""
+
+ def get(self):
+ template_values = { 'sign_out': users.create_logout_url('/') }
+ # See if we have an auth token for this user.
+ token = get_auth_token(self.request)
+ if token is None:
+ template_values['auth_url'] = gdata.gauth.generate_auth_sub_url(
+ self.request.url, ['http://www.blogger.com/feeds/'])
+ path = os.path.join(os.path.dirname(__file__), 'auth_required.html')
+ self.response.out.write(template.render(path, template_values))
+ return
+
+ elif token == False:
+ self.response.out.write(
+ '<html><body><a href="%s">You must sign in first</a>'
+ '</body></html>' % users.create_login_url('/blogs'))
+ return
+
+ client = gdata.blogger.client.BloggerClient()
+ feed = client.get_blogs(auth_token=token)
+ template_values['feed'] = feed
+ path = os.path.join(os.path.dirname(__file__), 'list_blogs.html')
+ self.response.out.write(template.render(path, template_values))
+
+
+class WritePost(webapp.RequestHandler):
+
+ def get(self):
+ template_values = { 'sign_out': users.create_logout_url('/'),
+ 'blog_id': self.request.get('id') }
+ # We should have an auth token for this user.
+ token = get_auth_token(self.request)
+ if not token:
+ self.redirect('/blogs')
+ return
+ path = os.path.join(os.path.dirname(__file__), 'post_editor.html')
+ self.response.out.write(template.render(path, template_values))
+
+ def post(self):
+ token = get_auth_token(self.request)
+ if not token:
+ self.redirect('/blogs')
+ return
+ draft = False
+ if self.request.get('draft') == 'true':
+ draft = True
+ client = gdata.blogger.client.BloggerClient()
+ new_post = client.add_post(
+ self.request.get('blog_id'), self.request.get('title'),
+ self.request.get('body'), draft=draft, auth_token=token)
+ if not draft:
+ self.response.out.write(
+ 'See your new post <a href="%s">here</a>.' % (
+ new_post.find_alternate_link()))
+ else:
+ self.response.out.write(
+ 'This was a draft blog post, visit '
+ '<a href="http://blogger.com/">blogger.com</a> to publish')
+
+
+def main():
+ application = webapp.WSGIApplication([('/blogs', ListBlogs),
+ ('/write_post', WritePost)],
+ debug=True)
+ wsgiref.handlers.CGIHandler().run(application)
+
+
+if __name__ == '__main__':
+ main()
+
diff --git a/samples/blogger/app/list_blogs.html b/samples/blogger/app/list_blogs.html
new file mode 100644
index 0000000..36b31c0
--- /dev/null
+++ b/samples/blogger/app/list_blogs.html
@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <title>List of Your Blogs</title>
+ </head>
+ <body>
+ <p>Here are the blogs you can post on. Click a link to bring up a blog post form to add a new post to the blog.</p>
+ <ul>
+ {% for entry in feed.entry %}
+ <li><a href="/write_post?id={{ entry.get_blog_id }}">{{ entry.title.text }}</a></li>
+ {% endfor %}
+ </ul>
+ <p>Done? <a href="{{ sign_out }}">Sign Out</a></p>
+ </body>
+</html>
diff --git a/samples/blogger/app/post_editor.html b/samples/blogger/app/post_editor.html
new file mode 100644
index 0000000..849905b
--- /dev/null
+++ b/samples/blogger/app/post_editor.html
@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <title>List of Your Blogs</title>
+ </head>
+ <body>
+ <h1>Write a new post for your blog</h1>
+ <form action="/write_post" method="post">
+ <input type="hidden" name="blog_id" value="{{ blog_id }}"></input>
+ <input type="text" name="title"></input><br/>
+ <textarea name="body"></textarea><br/>
+ Draft: <input type="checkbox" value="true" name="draft"></input><br/>
+ <input type="submit" value="Post on my blog"></input><br/>
+ </form>
+ <p>Done? <a href="{{ sign_out }}">Sign Out</a></p>
+ </body>
+</html>
diff --git a/samples/blogger/app/welcome.html b/samples/blogger/app/welcome.html
new file mode 100644
index 0000000..665d63f
--- /dev/null
+++ b/samples/blogger/app/welcome.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+ <head>
+ <title>Simple Blogger API sample.</title>
+ </head>
+ <body>
+ <p>This simple example illustrates how to build an App Engine app which uses
+ the Blogger API to post on a user's blog.</p>
+
+ <p>To begin, <a href="/blogs">view the list of your available blogs</a>.</p>
+ </body>
+</html>
diff --git a/samples/blogger/oauth-appengine/app.yaml b/samples/blogger/oauth-appengine/app.yaml
new file mode 100644
index 0000000..cbbc572
--- /dev/null
+++ b/samples/blogger/oauth-appengine/app.yaml
@@ -0,0 +1,13 @@
+application: blogger-oauth-example
+version: 1
+runtime: python
+api_version: 1
+
+handlers:
+- url: /css
+ static_dir: css
+
+- url: /.*
+ script: main.py
+ login: required
+
diff --git a/samples/blogger/oauth-appengine/css/index.css b/samples/blogger/oauth-appengine/css/index.css
new file mode 100644
index 0000000..2a02602
--- /dev/null
+++ b/samples/blogger/oauth-appengine/css/index.css
@@ -0,0 +1,65 @@
+* {
+ font-family: "HelveticaNeue-Light", "Helvetica Neue Light",
+ "Helvetica Neue", sans-serif;
+}
+
+body {
+ padding-left:15px;
+ padding-right:15px;
+}
+a {
+ color:#6699ff;
+ text-decoration:none;
+}
+a:hover {
+ color:#666666;
+ text-decoration:underline;
+}
+#header {
+ color:#666666;
+ padding-bottom:10px;
+ margin-bottom:1em;
+ border-bottom:1px solid #666666;
+ height:25px;
+ text-align: center;
+}
+.left {
+ float: left;
+}
+.right {
+ float: right;
+}
+
+div#status span.text {
+ background-color: #FFEEAA;
+ text-align: center;
+ padding: 5px;
+ font-size: 0.8em;
+ font-weight: bold;
+ -moz-border-radius: 6px;
+ -webkit-border-radius: 6px;
+ color: black;
+}
+
+div.blog {
+ padding:10px 10px 10px 20px;
+ border-bottom:1px solid #eee;
+ float: left;
+ width: 90%;
+}
+div.blog:hover {
+ background-color:#fffccc;
+}
+
+div.blog span.date {
+ font-size: 0.7em;
+}
+
+.hidden {
+ display: none;
+}
+
+.post-editor-wrapper {
+ text-align: right;
+}
+
diff --git a/samples/blogger/oauth-appengine/index.html b/samples/blogger/oauth-appengine/index.html
new file mode 100644
index 0000000..ee4ba64
--- /dev/null
+++ b/samples/blogger/oauth-appengine/index.html
@@ -0,0 +1,88 @@
+<html>
+<head>
+ <title>Blogger OAuth example</title>
+ <link type="text/css" rel="stylesheet" href="/css/index.css"/>
+ <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.3.2/jquery.min.js"></script>
+</head>
+<body>
+
+{% if logged %}
+
+<div id="header">
+ <div class="right"><a href="/oauth/revoke_token">logout</a></div>
+ <div class="left">Blogger OAuth example</div>
+ <div id="status" class="hidden"><span class="text">blah blah</span></div>
+</div>
+
+<p>Your blogs:</p>
+{% for blog in blogs %}
+ <div class="blog">
+ <div class="left">
+ <span class="title">
+ <a href="{{blog.link}}">{{ blog.title }}</a>
+ </span><br/>
+ <span class="date">created: {{ blog.published }}</span><br/>
+ <span class="date">last updated: {{ blog.updated }}</span>
+ </div>
+ <div class="right post-editor-wrapper">
+ <a href="#" class="new-post-link">Write a post</a>
+ <div class="hidden post-editor">
+ <span class="hidden id">{{ blog.id }}</span>
+ <textarea>Type new post</textarea><br/>
+ <input type="button" value="Publish"/>
+ </div>
+ </div>
+ </div>
+ <div class="clear"/>
+{% endfor %}
+
+{% else %}
+
+I could do automatic redirect but we all love welcome screens :). <br/>
+
+Ok, <a href="/oauth/request_token">allow this app to access Blogger</a>.
+
+{% endif %}
+
+<script type="text/javascript" charset="utf-8">
+$(document).ready(function() {
+
+ $('a.new-post-link').click(function() {
+ $(this).next().slideToggle();
+ });
+
+ $('input').click(function() {
+ showStatus('Creating post...');
+ var body = $(this).prevAll('textarea')[0].value;
+ var id = $(this).prevAll('span.id').text();
+ $.post('/new_post', {
+ 'body': body,
+ 'id': id
+ }, function(data) {
+ showStatusAndHideAfterFiveSecs('Post created.');
+ });
+ });
+
+ $(document).ajaxError(function(event, xhr) {
+ alert('Something went wrong. Code: ' + xhr.status);
+ hideStatus();
+ });
+});
+
+function showStatus(msg) {
+ $('#status span.text').text(msg);
+ $('#status').fadeIn();
+}
+
+function hideStatus() {
+ $('#status').fadeOut();
+}
+
+function showStatusAndHideAfterFiveSecs(msg) {
+ showStatus(msg);
+ setTimeout(hideStatus, 5000);
+}
+
+</script>
+</body>
+</html>
diff --git a/samples/blogger/oauth-appengine/index.yaml b/samples/blogger/oauth-appengine/index.yaml
new file mode 100644
index 0000000..a3b9e05
--- /dev/null
+++ b/samples/blogger/oauth-appengine/index.yaml
@@ -0,0 +1,11 @@
+indexes:
+
+# AUTOGENERATED
+
+# This index.yaml is automatically updated whenever the dev_appserver
+# detects that a new type of query is run. If you want to manage the
+# index.yaml file manually, remove the above marker line (the line
+# saying "# AUTOGENERATED"). If you want to manage some indexes
+# manually, move them above the marker line. The index.yaml file is
+# automatically uploaded to the admin console when you next deploy
+# your application using appcfg.py.
diff --git a/samples/blogger/oauth-appengine/main.py b/samples/blogger/oauth-appengine/main.py
new file mode 100755
index 0000000..1f97012
--- /dev/null
+++ b/samples/blogger/oauth-appengine/main.py
@@ -0,0 +1,59 @@
+__author__ = 'wiktorgworek@google.com (Wiktor Gworek)'
+
+import wsgiref.handlers
+
+import atom
+import os
+import cgi
+import gdata.blogger.service
+
+from oauth import OAuthDanceHandler, OAuthHandler, requiresOAuth
+from google.appengine.ext import webapp
+from google.appengine.ext.webapp import template
+
+
+class MainHandler(OAuthHandler):
+ """Main handler. If user is not logged in via OAuth it will display welcome
+ page. In other case user's blogs on Blogger will be displayed."""
+
+ def get(self):
+ try:
+ template_values = {'logged': self.client.has_access_token()}
+
+ if template_values['logged']:
+ feed = self.client.blogger.GetBlogFeed()
+ blogs = []
+ for entry in feed.entry:
+ blogs.append({
+ 'id': entry.GetBlogId(),
+ 'title': entry.title.text,
+ 'link': entry.GetHtmlLink().href,
+ 'published': entry.published.text,
+ 'updated': entry.updated.text
+ })
+ template_values['blogs'] = blogs
+ except gdata.service.RequestError, error:
+ template_values['logged'] = False
+
+ path = os.path.join(os.path.dirname(__file__), 'index.html')
+ self.response.out.write(template.render(path, template_values))
+
+
+class NewPostHandler(OAuthHandler):
+ """Handles AJAX POST request to create a new post on a blog."""
+
+ @requiresOAuth
+ def post(self):
+ entry = atom.Entry(content=atom.Content(text=self.request.get('body')))
+ self.client.blogger.AddPost(entry, blog_id=self.request.get('id'))
+
+def main():
+ application = webapp.WSGIApplication([
+ (r'/oauth/(.*)', OAuthDanceHandler),
+ ('/new_post', NewPostHandler),
+ ('/', MainHandler),
+ ], debug=True)
+ wsgiref.handlers.CGIHandler().run(application)
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/blogger/oauth-appengine/oauth.py b/samples/blogger/oauth-appengine/oauth.py
new file mode 100755
index 0000000..c34b250
--- /dev/null
+++ b/samples/blogger/oauth-appengine/oauth.py
@@ -0,0 +1,174 @@
+"""Provides OAuth authorization. Main components are:
+ * OAuthClient - provides logic for 3-legged OAuth protocol,
+ * OAuthDanceHandler - wrapper for OAuthClient for handling OAuth requests,
+ * OAuthHandler - from this handler should inherit all other handlers that want
+ to be authenticated and have access to BloggerService. Be sure that you
+ added @requiredOAuth on top of your request method (i.e. post, get).
+
+Request tokens are stored in OAuthRequestToken (explicite) and access tokens are
+stored in TokenCollection (implicit) provided by gdata.alt.appengine.
+
+Heavily used resources and ideas from:
+ * http://github.com/tav/tweetapp,
+ * Examples of OAuth from GData Python Client written by Eric Bidelman.
+"""
+
+__author__ = ('wiktorgworek (Wiktor Gworek), '
+ 'e.bidelman (Eric Bidelman)')
+
+import os
+import gdata.auth
+import gdata.client
+import gdata.alt.appengine
+import gdata.blogger.service
+
+from google.appengine.api import users
+from google.appengine.ext import db
+from google.appengine.ext import webapp
+from google.appengine.ext.webapp import template
+
+SETTINGS = {
+ 'APP_NAME': 'YOUR_APPLICATION_NAME',
+ 'CONSUMER_KEY': 'YOUR_CONSUMER_KEY',
+ 'CONSUMER_SECRET': 'YOUR_CONSUMER_SECRET',
+ 'SIG_METHOD': gdata.auth.OAuthSignatureMethod.HMAC_SHA1,
+ 'SCOPES': gdata.service.CLIENT_LOGIN_SCOPES['blogger']
+}
+
+# ------------------------------------------------------------------------------
+# Data store models.
+# ------------------------------------------------------------------------------
+
+class OAuthRequestToken(db.Model):
+ """Stores OAuth request token."""
+
+ token_key = db.StringProperty(required=True)
+ token_secret = db.StringProperty(required=True)
+ created = db.DateTimeProperty(auto_now_add=True)
+
+# ------------------------------------------------------------------------------
+# OAuth client.
+# ------------------------------------------------------------------------------
+
+class OAuthClient(object):
+
+ __public__ = ('request_token', 'callback', 'revoke_token')
+
+ def __init__(self, handler):
+ self.handler = handler
+ self.blogger = gdata.blogger.service.BloggerService(
+ source=SETTINGS['APP_NAME'])
+ self.blogger.SetOAuthInputParameters(SETTINGS['SIG_METHOD'],
+ SETTINGS['CONSUMER_KEY'], consumer_secret=SETTINGS['CONSUMER_SECRET'])
+ gdata.alt.appengine.run_on_appengine(self.blogger)
+
+ def has_access_token(self):
+ """Checks if there is an access token in token store."""
+ access_token = self.blogger.token_store.find_token(
+ '%20'.join(SETTINGS['SCOPES']))
+ return isinstance(access_token, gdata.auth.OAuthToken)
+
+ def request_token(self):
+ """Fetches a request token and redirects the user to the approval page."""
+
+ if users.get_current_user():
+ # 1.) REQUEST TOKEN STEP. Provide the data scope(s) and the page we'll
+ # be redirected back to after the user grants access on the approval page.
+ req_token = self.blogger.FetchOAuthRequestToken(
+ scopes=SETTINGS['SCOPES'],
+ oauth_callback=self.handler.request.uri.replace(
+ 'request_token', 'callback'))
+
+ # When using HMAC, persist the token secret in order to re-create an
+ # OAuthToken object coming back from the approval page.
+ db_token = OAuthRequestToken(token_key = req_token.key,
+ token_secret=req_token.secret)
+ db_token.put()
+
+ # 2.) APPROVAL STEP. Redirect to user to Google's OAuth approval page.
+ self.handler.redirect(self.blogger.GenerateOAuthAuthorizationURL())
+
+ def callback(self):
+ """Invoked after we're redirected back from the approval page."""
+
+ oauth_token = gdata.auth.OAuthTokenFromUrl(self.handler.request.uri)
+ if oauth_token:
+ # Find request token saved by put() method.
+ db_token = OAuthRequestToken.all().filter(
+ 'token_key =', oauth_token.key).fetch(1)[0]
+ oauth_token.secret = db_token.token_secret
+ oauth_token.oauth_input_params = self.blogger.GetOAuthInputParameters()
+ self.blogger.SetOAuthToken(oauth_token)
+
+ # 3.) Exchange the authorized request token for an access token
+ oauth_verifier = self.handler.request.get(
+ 'oauth_verifier', default_value='')
+ access_token = self.blogger.UpgradeToOAuthAccessToken(
+ oauth_verifier=oauth_verifier)
+
+ # Remember the access token in the current user's token store
+ if access_token and users.get_current_user():
+ self.blogger.token_store.add_token(access_token)
+ elif access_token:
+ self.blogger.current_token = access_token
+ self.blogger.SetOAuthToken(access_token)
+
+ self.handler.redirect('/')
+
+ def revoke_token(self):
+ """Revokes the current user's OAuth access token."""
+
+ try:
+ self.blogger.RevokeOAuthToken()
+ except gdata.service.RevokingOAuthTokenFailed:
+ pass
+ except gdata.service.NonOAuthToken:
+ pass
+
+ self.blogger.token_store.remove_all_tokens()
+ self.handler.redirect('/')
+
+# ------------------------------------------------------------------------------
+# Request handlers.
+# ------------------------------------------------------------------------------
+
+class OAuthDanceHandler(webapp.RequestHandler):
+ """Handler for the 3 legged OAuth dance.
+
+ This handler is responsible for fetching an initial OAuth request token,
+ redirecting the user to the approval page. When the user grants access, they
+ will be redirected back to this GET handler and their authorized request token
+ will be exchanged for a long-lived access token."""
+
+ def __init__(self):
+ super(OAuthDanceHandler, self).__init__()
+ self.client = OAuthClient(self)
+
+ def get(self, action=''):
+ if action in self.client.__public__:
+ self.response.out.write(getattr(self.client, action)())
+ else:
+ self.response.out.write(self.client.request_token())
+
+class OAuthHandler(webapp.RequestHandler):
+ """All handlers requiring OAuth should inherit from this class."""
+
+ def __init__(self):
+ super(OAuthHandler, self).__init__()
+ self.client = OAuthClient(self)
+
+def requiresOAuth(fun):
+ """Decorator for request handlers to gain authentication via OAuth.
+ Must be used in a handler that inherits from OAuthHandler."""
+ def decorate(self, *args, **kwargs):
+ if self.client.has_access_token():
+ try:
+ fun(self, *args, **kwargs)
+ except gdata.service.RequestError, error:
+ if error.code in [401, 403]:
+ self.redirect('/oauth/request_token')
+ else:
+ raise
+ else:
+ self.redirect('/oauth/request_token')
+ return decorate
diff --git a/samples/calendar/calendarExample.py b/samples/calendar/calendarExample.py
new file mode 100755
index 0000000..b565748
--- /dev/null
+++ b/samples/calendar/calendarExample.py
@@ -0,0 +1,617 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.rboyd@gmail.com (Ryan Boyd)'
+
+
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import gdata.calendar.data
+import gdata.calendar.client
+import gdata.acl.data
+import atom
+import getopt
+import sys
+import string
+import time
+
+
+class CalendarExample:
+
+ def __init__(self, email, password):
+ """Creates a CalendarService and provides ClientLogin auth details to it.
+ The email and password are required arguments for ClientLogin. The
+ CalendarService automatically sets the service to be 'cl', as is
+ appropriate for calendar. The 'source' defined below is an arbitrary
+ string, but should be used to reference your name or the name of your
+ organization, the app name and version, with '-' between each of the three
+ values. The account_type is specified to authenticate either
+ Google Accounts or Google Apps accounts. See gdata.service or
+ http://code.google.com/apis/accounts/AuthForInstalledApps.html for more
+ info on ClientLogin. NOTE: ClientLogin should only be used for installed
+ applications and not for multi-user web applications."""
+
+ self.cal_client = gdata.calendar.client.CalendarClient(source='Google-Calendar_Python_Sample-1.0')
+ self.cal_client.ClientLogin(email, password, self.cal_client.source);
+
+ def _PrintUserCalendars(self):
+ """Retrieves the list of calendars to which the authenticated user either
+ owns or subscribes to. This is the same list as is represented in the
+ Google Calendar GUI. Although we are only printing the title of the
+ calendar in this case, other information, including the color of the
+ calendar, the timezone, and more. See CalendarListEntry for more details
+ on available attributes."""
+
+ feed = self.cal_client.GetAllCalendarsFeed()
+ print 'Printing allcalendars: %s' % feed.title.text
+ for i, a_calendar in zip(xrange(len(feed.entry)), feed.entry):
+ print '\t%s. %s' % (i, a_calendar.title.text,)
+
+ def _PrintOwnCalendars(self):
+ """Retrieves the list of calendars to which the authenticated user
+ owns --
+ Although we are only printing the title of the
+ calendar in this case, other information, including the color of the
+ calendar, the timezone, and more. See CalendarListEntry for more details
+ on available attributes."""
+
+ feed = self.cal_client.GetOwnCalendarsFeed()
+ print 'Printing owncalendars: %s' % feed.title.text
+ for i, a_calendar in zip(xrange(len(feed.entry)), feed.entry):
+ print '\t%s. %s' % (i, a_calendar.title.text,)
+
+ def _PrintAllEventsOnDefaultCalendar(self):
+ """Retrieves all events on the primary calendar for the authenticated user.
+ In reality, the server limits the result set intially returned. You can
+ use the max_results query parameter to allow the server to send additional
+ results back (see query parameter use in DateRangeQuery for more info).
+ Additionally, you can page through the results returned by using the
+ feed.GetNextLink().href value to get the location of the next set of
+ results."""
+
+ feed = self.cal_client.GetCalendarEventFeed()
+ print 'Events on Primary Calendar: %s' % (feed.title.text,)
+ for i, an_event in zip(xrange(len(feed.entry)), feed.entry):
+ print '\t%s. %s' % (i, an_event.title.text,)
+ for p, a_participant in zip(xrange(len(an_event.who)), an_event.who):
+ print '\t\t%s. %s' % (p, a_participant.email,)
+ print '\t\t\t%s' % (a_participant.value,)
+ if a_participant.attendee_status:
+ print '\t\t\t%s' % (a_participant.attendee_status.value,)
+
+ def _FullTextQuery(self, text_query='Tennis'):
+ """Retrieves events from the calendar which match the specified full-text
+ query. The full-text query searches the title and content of an event,
+ but it does not search the value of extended properties at the time of
+ this writing. It uses the default (primary) calendar of the authenticated
+ user and uses the private visibility/full projection feed. Please see:
+ http://code.google.com/apis/calendar/reference.html#Feeds
+ for more information on the feed types. Note: as we're not specifying
+ any query parameters other than the full-text query, recurring events
+ returned will not have gd:when elements in the response. Please see
+ the Google Calendar API query paramters reference for more info:
+ http://code.google.com/apis/calendar/reference.html#Parameters"""
+
+ print 'Full text query for events on Primary Calendar: \'%s\'' % (
+ text_query,)
+ query = gdata.calendar.client.CalendarEventQuery(text_query=text_query)
+ feed = self.cal_client.GetCalendarEventFeed(q=query)
+ for i, an_event in zip(xrange(len(feed.entry)), feed.entry):
+ print '\t%s. %s' % (i, an_event.title.text,)
+ print '\t\t%s. %s' % (i, an_event.content.text,)
+ for a_when in an_event.when:
+ print '\t\tStart time: %s' % (a_when.start,)
+ print '\t\tEnd time: %s' % (a_when.end,)
+
+ def _DateRangeQuery(self, start_date='2007-01-01', end_date='2007-07-01'):
+ """Retrieves events from the server which occur during the specified date
+ range. This uses the CalendarEventQuery class to generate the URL which is
+ used to retrieve the feed. For more information on valid query parameters,
+ see: http://code.google.com/apis/calendar/reference.html#Parameters"""
+
+ print 'Date range query for events on Primary Calendar: %s to %s' % (
+ start_date, end_date,)
+ query = gdata.calendar.client.CalendarEventQuery(start_min=start_date, start_max=end_date)
+ feed = self.cal_client.GetCalendarEventFeed(q=query)
+ for i, an_event in zip(xrange(len(feed.entry)), feed.entry):
+ print '\t%s. %s' % (i, an_event.title.text,)
+ for a_when in an_event.when:
+ print '\t\tStart time: %s' % (a_when.start,)
+ print '\t\tEnd time: %s' % (a_when.end,)
+
+ def _InsertCalendar(self, title='Little League Schedule',
+ description='This calendar contains practice and game times',
+ time_zone='America/Los_Angeles', hidden=False, location='Oakland',
+ color='#2952A3'):
+ """Creates a new calendar using the specified data."""
+ print 'Creating new calendar with title "%s"' % title
+ calendar = gdata.calendar.data.CalendarEntry()
+ calendar.title = atom.data.Title(text=title)
+ calendar.summary = atom.data.Summary(text=description)
+ calendar.where.append(gdata.calendar.data.CalendarWhere(value=location))
+ calendar.color = gdata.calendar.data.ColorProperty(value=color)
+ calendar.timezone = gdata.calendar.data.TimeZoneProperty(value=time_zone)
+
+ if hidden:
+ calendar.hidden = gdata.calendar.data.HiddenProperty(value='true')
+ else:
+ calendar.hidden = gdata.calendar.data.HiddenProperty(value='false')
+
+ new_calendar = self.cal_client.InsertCalendar(new_calendar=calendar)
+ return new_calendar
+
+ def _UpdateCalendar(self, calendar, title='New Title', color=None):
+ """Updates the title and, optionally, the color of the supplied calendar"""
+ print 'Updating the calendar titled "%s" with the title "%s"' % (
+ calendar.title.text, title)
+ calendar.title = atom.data.Title(text=title)
+ if color is not None:
+ calendar.color = gdata.calendar.data.ColorProperty(value=color)
+
+ updated_calendar = self.cal_client.Update(calendar)
+ return updated_calendar
+
+ def _DeleteAllCalendars(self):
+ """Deletes all calendars. Note: the primary calendar cannot be deleted"""
+ feed = self.cal_client.GetOwnCalendarsFeed()
+ for entry in feed.entry:
+ print 'Deleting calendar: %s' % entry.title.text
+ try:
+ self.cal_client.Delete(entry.GetEditLink().href)
+ except gdata.client.RequestError, msg:
+ if msg.body.startswith('Cannot remove primary calendar'):
+ print '\t%s' % msg.body
+ else:
+ print '\tUnexpected Error: %s' % msg.body
+
+ def _InsertSubscription(self,
+ id='python.gcal.test%40gmail.com'):
+ """Subscribes to the calendar with the specified ID."""
+ print 'Subscribing to the calendar with ID: %s' % id
+ calendar = gdata.calendar.data.CalendarEntry()
+ calendar.id = atom.data.Id(text=id)
+ returned_calendar = self.cal_client.InsertCalendarSubscription(calendar)
+ return returned_calendar
+
+ def _UpdateCalendarSubscription(self,
+ id='python.gcal.test%40gmail.com',
+ color=None, hidden=None, selected=None):
+ """Updates the subscription to the calendar with the specified ID."""
+ print 'Updating the calendar subscription with ID: %s' % id
+ calendar_url = (
+ 'http://www.google.com/calendar/feeds/default/allcalendars/full/%s' % id)
+ calendar_entry = self.cal_client.GetCalendarEntry(calendar_url)
+
+ if color is not None:
+ calendar_entry.color = gdata.calendar.data.ColorProperty(value=color)
+ if hidden is not None:
+ if hidden:
+ calendar_entry.hidden = gdata.calendar.data.HiddenProperty(value='true')
+ else:
+ calendar_entry.hidden = gdata.calendar.data.HiddenProperty(value='false')
+ if selected is not None:
+ if selected:
+ calendar_entry.selected = gdata.calendar.data.SelectedProperty(value='true')
+ else:
+ calendar_entry.selected = gdata.calendar.data.SelectedProperty(value='false')
+
+ updated_calendar = self.cal_client.Update(calendar_entry)
+ return updated_calendar
+
+ def _DeleteCalendarSubscription(self,
+ id='python.gcal.test%40gmail.com'):
+ """Deletes the subscription to the calendar with the specified ID."""
+ print 'Deleting the calendar subscription with ID: %s' % id
+ calendar_url = (
+ 'http://www.google.com/calendar/feeds/default/allcalendars/full/%s' % id)
+ calendar_entry = self.cal_client.GetCalendarEntry(calendar_url)
+ self.cal_client.Delete(calendar_entry.GetEditLink().href)
+
+ def _InsertEvent(self, title='Tennis with Beth',
+ content='Meet for a quick lesson', where='On the courts',
+ start_time=None, end_time=None, recurrence_data=None):
+ """Inserts a basic event using either start_time/end_time definitions
+ or gd:recurrence RFC2445 icalendar syntax. Specifying both types of
+ dates is not valid. Note how some members of the CalendarEventEntry
+ class use arrays and others do not. Members which are allowed to occur
+ more than once in the calendar or GData "kinds" specifications are stored
+ as arrays. Even for these elements, Google Calendar may limit the number
+ stored to 1. The general motto to use when working with the Calendar data
+ API is that functionality not available through the GUI will not be
+ available through the API. Please see the GData Event "kind" document:
+ http://code.google.com/apis/gdata/elements.html#gdEventKind
+ for more information"""
+
+ event = gdata.calendar.data.CalendarEventEntry()
+ event.title = atom.data.Title(text=title)
+ event.content = atom.data.Content(text=content)
+ event.where.append(gdata.data.Where(value=where))
+
+ if recurrence_data is not None:
+ # Set a recurring event
+ event.recurrence = gdata.data.Recurrence(text=recurrence_data)
+ else:
+ if start_time is None:
+ # Use current time for the start_time and have the event last 1 hour
+ start_time = time.strftime('%Y-%m-%dT%H:%M:%S.000Z', time.gmtime())
+ end_time = time.strftime('%Y-%m-%dT%H:%M:%S.000Z',
+ time.gmtime(time.time() + 3600))
+ event.when.append(gdata.data.When(start=start_time,
+ end=end_time))
+
+ new_event = self.cal_client.InsertEvent(event)
+
+ return new_event
+
+ def _InsertSingleEvent(self, title='One-time Tennis with Beth',
+ content='Meet for a quick lesson', where='On the courts',
+ start_time=None, end_time=None):
+ """Uses the _InsertEvent helper method to insert a single event which
+ does not have any recurrence syntax specified."""
+
+ new_event = self._InsertEvent(title, content, where, start_time, end_time,
+ recurrence_data=None)
+
+ print 'New single event inserted: %s' % (new_event.id.text,)
+ print '\tEvent edit URL: %s' % (new_event.GetEditLink().href,)
+ print '\tEvent HTML URL: %s' % (new_event.GetHtmlLink().href,)
+
+ return new_event
+
+ def _InsertRecurringEvent(self, title='Weekly Tennis with Beth',
+ content='Meet for a quick lesson', where='On the courts',
+ recurrence_data=None):
+ """Uses the _InsertEvent helper method to insert a recurring event which
+ has only RFC2445 icalendar recurrence syntax specified. Note the use of
+ carriage return/newline pairs at the end of each line in the syntax. Even
+ when specifying times (as opposed to only dates), VTIMEZONE syntax is not
+ required if you use a standard Java timezone ID. Please see the docs for
+ more information on gd:recurrence syntax:
+ http://code.google.com/apis/gdata/elements.html#gdRecurrence
+ """
+
+ if recurrence_data is None:
+ recurrence_data = ('DTSTART;VALUE=DATE:20070501\r\n'
+ + 'DTEND;VALUE=DATE:20070502\r\n'
+ + 'RRULE:FREQ=WEEKLY;BYDAY=Tu;UNTIL=20070904\r\n')
+
+ new_event = self._InsertEvent(title, content, where,
+ recurrence_data=recurrence_data, start_time=None, end_time=None)
+
+ print 'New recurring event inserted: %s' % (new_event.id.text,)
+ print '\tEvent edit URL: %s' % (new_event.GetEditLink().href,)
+ print '\tEvent HTML URL: %s' % (new_event.GetHtmlLink().href,)
+
+ return new_event
+
+ def _InsertQuickAddEvent(self,
+ content="Tennis with John today 3pm-3:30pm"):
+ """Creates an event with the quick_add property set to true so the content
+ is processed as quick add content instead of as an event description."""
+ event = gdata.calendar.data.CalendarEventEntry()
+ event.content = atom.data.Content(text=content)
+ event.quick_add = gdata.calendar.data.QuickAddProperty(value='true')
+
+ new_event = self.cal_client.InsertEvent(event)
+ return new_event
+
+ def _InsertSimpleWebContentEvent(self):
+ """Creates a WebContent object and embeds it in a WebContentLink.
+ The WebContentLink is appended to the existing list of links in the event
+ entry. Finally, the calendar client inserts the event."""
+
+ # Create a WebContent object
+ url = 'http://www.google.com/logos/worldcup06.gif'
+ web_content = gdata.calendar.data.WebContent(url=url, width='276', height='120')
+
+ # Create a WebContentLink object that contains the WebContent object
+ title = 'World Cup'
+ href = 'http://www.google.com/calendar/images/google-holiday.gif'
+ type = 'image/gif'
+ web_content_link = gdata.calendar.data.WebContentLink(title=title, href=href,
+ link_type=type, web_content=web_content)
+
+ # Create an event that contains this web content
+ event = gdata.calendar.data.CalendarEventEntry()
+ event.link.append(web_content_link)
+
+ print 'Inserting Simple Web Content Event'
+ new_event = self.cal_client.InsertEvent(event)
+ return new_event
+
+ def _InsertWebContentGadgetEvent(self):
+ """Creates a WebContent object and embeds it in a WebContentLink.
+ The WebContentLink is appended to the existing list of links in the event
+ entry. Finally, the calendar client inserts the event. Web content
+ gadget events display Calendar Gadgets inside Google Calendar."""
+
+ # Create a WebContent object
+ url = 'http://google.com/ig/modules/datetime.xml'
+ web_content = gdata.calendar.data.WebContent(url=url, width='300', height='136')
+ web_content.web_content_gadget_pref.append(
+ gdata.calendar.data.WebContentGadgetPref(name='color', value='green'))
+
+ # Create a WebContentLink object that contains the WebContent object
+ title = 'Date and Time Gadget'
+ href = 'http://gdata.ops.demo.googlepages.com/birthdayicon.gif'
+ type = 'application/x-google-gadgets+xml'
+ web_content_link = gdata.calendar.data.WebContentLink(title=title, href=href,
+ link_type=type, web_content=web_content)
+
+ # Create an event that contains this web content
+ event = gdata.calendar.data.CalendarEventEntry()
+ event.link.append(web_content_link)
+
+ print 'Inserting Web Content Gadget Event'
+ new_event = self.cal_client.InsertEvent(event)
+ return new_event
+
+ def _UpdateTitle(self, event, new_title='Updated event title'):
+ """Updates the title of the specified event with the specified new_title.
+ Note that the UpdateEvent method (like InsertEvent) returns the
+ CalendarEventEntry object based upon the data returned from the server
+ after the event is inserted. This represents the 'official' state of
+ the event on the server. The 'edit' link returned in this event can
+ be used for future updates. Due to the use of the 'optimistic concurrency'
+ method of version control, most GData services do not allow you to send
+ multiple update requests using the same edit URL. Please see the docs:
+ http://code.google.com/apis/gdata/reference.html#Optimistic-concurrency
+ """
+
+ previous_title = event.title.text
+ event.title.text = new_title
+ print 'Updating title of event from:\'%s\' to:\'%s\'' % (
+ previous_title, event.title.text,)
+ return self.cal_client.Update(event)
+
+ def _AddReminder(self, event, minutes=10):
+ """Adds a reminder to the event. This uses the default reminder settings
+ for the user to determine what type of notifications are sent (email, sms,
+ popup, etc.) and sets the reminder for 'minutes' number of minutes before
+ the event. Note: you can only use values for minutes as specified in the
+ Calendar GUI."""
+
+ for a_when in event.when:
+ if len(a_when.reminder) > 0:
+ a_when.reminder[0].minutes = minutes
+ else:
+ a_when.reminder.append(gdata.data.Reminder(minutes=str(minutes)))
+
+ print 'Adding %d minute reminder to event' % (minutes,)
+ return self.cal_client.Update(event)
+
+ def _AddExtendedProperty(self, event,
+ name='http://www.example.com/schemas/2005#mycal.id', value='1234'):
+ """Adds an arbitrary name/value pair to the event. This value is only
+ exposed through the API. Extended properties can be used to store extra
+ information needed by your application. The recommended format is used as
+ the default arguments above. The use of the URL format is to specify a
+ namespace prefix to avoid collisions between different applications."""
+
+ event.extended_property.append(
+ gdata.calendar.data.CalendarExtendedProperty(name=name, value=value))
+ print 'Adding extended property to event: \'%s\'=\'%s\'' % (name, value,)
+ return self.cal_client.Update(event)
+
+ def _DeleteEvent(self, event):
+ """Given an event object returned for the calendar server, this method
+ deletes the event. The edit link present in the event is the URL used
+ in the HTTP DELETE request."""
+
+ self.cal_client.Delete(event.GetEditLink().href)
+
+ def _PrintAclFeed(self):
+ """Sends a HTTP GET to the default ACL URL
+ (http://www.google.com/calendar/feeds/default/acl/full) and displays the
+ feed returned in the response."""
+
+ feed = self.cal_client.GetCalendarAclFeed()
+ print feed.title.text
+ for i, a_rule in zip(xrange(len(feed.entry)), feed.entry):
+ print '\t%s. %s' % (i, a_rule.title.text,)
+ print '\t\t Role: %s' % (a_rule.role.value,)
+ print '\t\t Scope %s - %s' % (a_rule.scope.type, a_rule.scope.value)
+
+ def _CreateAclRule(self, username):
+ """Creates a ACL rule that grants the given user permission to view
+ free/busy information on the default calendar. Note: It is not necessary
+ to specify a title for the ACL entry. The server will set this to be the
+ value of the role specified (in this case "freebusy")."""
+
+ print 'Creating Acl rule for user: %s' % username
+ rule = gdata.calendar.data.CalendarAclEntry()
+ rule.scope = gdata.acl.data.AclScope(value=username, type="user")
+ roleValue = "http://schemas.google.com/gCal/2005#%s" % ("freebusy")
+ rule.role = gdata.acl.data.AclRole(value=roleValue)
+ aclUrl = "https://www.google.com/calendar/feeds/default/acl/full"
+ returned_rule = self.cal_client.InsertAclEntry(rule, aclUrl)
+
+ def _RetrieveAclRule(self, username):
+ """Builds the aclEntryUri or the entry created in the previous example.
+ The sends a HTTP GET message and displays the entry returned in the
+ response."""
+
+ aclEntryUri = "http://www.google.com/calendar/feeds/"
+ aclEntryUri += "default/acl/full/user:%s" % (username)
+ entry = self.cal_client.GetCalendarAclEntry(aclEntryUri)
+ print '\t%s' % (entry.title.text,)
+ print '\t\t Role: %s' % (entry.role.value,)
+ print '\t\t Scope %s - %s' % (entry.scope.type, entry.scope.value)
+ return entry
+
+ def _UpdateAclRule(self, entry):
+ """Modifies the value of the role in the given entry and POSTs the updated
+ entry. Note that while the role of an ACL entry can be updated, the
+ scope can not be modified."""
+
+ print 'Update Acl rule: %s' % (entry.GetEditLink().href)
+ roleValue = "http://schemas.google.com/gCal/2005#%s" % ("read")
+ entry.role = gdata.acl.data.AclRole(value=roleValue)
+ returned_rule = self.cal_client.Update(entry)
+
+ def _DeleteAclRule(self, entry):
+ """Given an ACL entry returned for the calendar server, this method
+ deletes the entry. The edit link present in the entry is the URL used
+ in the HTTP DELETE request."""
+
+ self.cal_client.Delete(entry.GetEditLink().href)
+
+ def _batchRequest(self, updateEntry, deleteEntry):
+ """Execute a batch request to create, update and delete an entry."""
+
+ print 'Executing batch request to insert, update and delete entries.'
+ # feed that holds all the batch rquest entries
+ request_feed = gdata.calendar.data.CalendarEventFeed()
+
+ # creating an event entry to insert
+ insertEntry = gdata.calendar.data.CalendarEventEntry()
+ insertEntry.title = atom.data.Title(text='Python: batch insert')
+ insertEntry.content = atom.data.Content(text='my content')
+ start_time = time.strftime('%Y-%m-%dT%H:%M:%S.000Z', time.gmtime())
+ end_time = time.strftime('%Y-%m-%dT%H:%M:%S.000Z',
+ time.gmtime(time.time() + 3600))
+ insertEntry.when.append(gdata.calendar.data.When(start=start_time,
+ end=end_time))
+ insertEntry.batch_id = gdata.data.BatchId(text='insert-request')
+
+ # add the insert entry to the batch feed
+ request_feed.AddInsert(entry=insertEntry)
+
+ if updateEntry:
+ updateEntry.batch_id = gdata.data.BatchId(text='update-request')
+ updateEntry.title = atom.data.Title(text='Python: batch update')
+ # add the update entry to the batch feed
+ request_feed.AddUpdate(entry=updateEntry)
+
+ if deleteEntry:
+ deleteEntry.batch_id = gdata.data.BatchId(text='delete-request')
+ # add the delete entry to the batch feed
+ request_feed.AddDelete(entry=deleteEntry)
+
+ # submit the batch request to the server
+ response_feed = self.cal_client.ExecuteBatch(request_feed, gdata.calendar.client.DEFAULT_BATCH_URL)
+
+ # iterate the response feed to get the operation status
+ for entry in response_feed.entry:
+ print '\tbatch id: %s' % (entry.batch_id.text,)
+ print '\tstatus: %s' % (entry.batch_status.code,)
+ print '\treason: %s' % (entry.batch_status.reason,)
+ if entry.batch_id.text == 'insert-request':
+ insertEntry = entry
+ elif entry.batch_id.text == 'update-request':
+ updateEntry = entry
+
+ return (insertEntry, updateEntry)
+
+ def Run(self, delete='false'):
+ """Runs each of the example methods defined above. Note how the result
+ of the _InsertSingleEvent call is used for updating the title and the
+ result of updating the title is used for inserting the reminder and
+ again with the insertion of the extended property. This is due to the
+ Calendar's use of GData's optimistic concurrency versioning control system:
+ http://code.google.com/apis/gdata/reference.html#Optimistic-concurrency
+ """
+
+ # Getting feeds and query results
+ self._PrintUserCalendars()
+ self._PrintOwnCalendars()
+ self._PrintAllEventsOnDefaultCalendar()
+ self._FullTextQuery()
+ self._DateRangeQuery()
+
+ # Inserting and updating events
+ see = self._InsertSingleEvent()
+ see_u_title = self._UpdateTitle(see, 'New title for single event')
+ see_u_reminder = self._AddReminder(see_u_title, minutes=30)
+ see_u_ext_prop = self._AddExtendedProperty(see_u_reminder,
+ name='propname', value='propvalue')
+ ree = self._InsertRecurringEvent()
+ simple_web_content_event = self._InsertSimpleWebContentEvent()
+ web_content_gadget_event = self._InsertWebContentGadgetEvent()
+ quick_add_event = self._InsertQuickAddEvent()
+
+ # Access Control List examples
+ self._PrintAclFeed()
+ self._CreateAclRule("user@gmail.com")
+ entry = self._RetrieveAclRule("user@gmail.com")
+ self._UpdateAclRule(entry)
+ self._DeleteAclRule(entry)
+
+ # Creating, updating and deleting calendars
+ inserted_calendar = self._InsertCalendar()
+ updated_calendar = self._UpdateCalendar(calendar=inserted_calendar)
+
+ # Insert Subscription
+ inserted_subscription = self._InsertSubscription()
+ updated_subscription = self._UpdateCalendarSubscription(selected=False)
+
+ # Execute a batch request
+ (quick_add_event, see_u_ext_prop) = self._batchRequest(see_u_ext_prop,
+ quick_add_event)
+
+ # Delete entries if delete argument='true'
+ if delete == 'true':
+ print 'Deleting created events'
+ self.cal_client.Delete(see_u_ext_prop)
+ self.cal_client.Delete(ree)
+ self.cal_client.Delete(simple_web_content_event)
+ self.cal_client.Delete(web_content_gadget_event)
+ self.cal_client.Delete(quick_add_event)
+ print 'Deleting subscriptions'
+ self._DeleteCalendarSubscription()
+ print 'Deleting all calendars'
+ self._DeleteAllCalendars()
+
+
+def main():
+ """Runs the CalendarExample application with the provided username and
+ and password values. Authentication credentials are required.
+ NOTE: It is recommended that you run this sample using a test account."""
+
+ # parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], "", ["user=", "pw=", "delete="])
+ except getopt.error, msg:
+ print ('python calendarExample.py --user [username] --pw [password] ' +
+ '--delete [true|false] ')
+ sys.exit(2)
+
+ user = ''
+ pw = ''
+ delete = 'false'
+
+ # Process options
+ for o, a in opts:
+ if o == "--user":
+ user = a
+ elif o == "--pw":
+ pw = a
+ elif o == "--delete":
+ delete = a
+
+ if user == '' or pw == '':
+ print ('python calendarExample.py --user [username] --pw [password] ' +
+ '--delete [true|false] ')
+ sys.exit(2)
+
+ sample = CalendarExample(user, pw)
+ sample.Run(delete)
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/calendar_resource/calendar_resource_example.py b/samples/calendar_resource/calendar_resource_example.py
new file mode 100644
index 0000000..a82e63f
--- /dev/null
+++ b/samples/calendar_resource/calendar_resource_example.py
@@ -0,0 +1,184 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample app for Google Apps Calendar Resource features.
+
+ CalendarResourceSample: Demonstrates the use of the Calendar Resource API
+"""
+
+
+__author__ = 'pti@google.com (Prashant Tiwari)'
+
+
+import getpass
+from gdata.calendar_resource.client import CalendarResourceClient
+
+
+class CalendarResourceSample(object):
+ def __init__(self, domain, email, password):
+ """Constructor for the CalendarResourceSample object.
+
+ Construct a CalendarResourceSample with the given args.
+
+ Args:
+ domain: The domain name ("domain.com")
+ email: The email account of the user or the admin ("john@domain.com")
+ password: The domain admin's password
+ """
+ self.client = CalendarResourceClient(domain=domain)
+ self.client.ClientLogin(email=email, password=password,
+ source='googlecode-calendarresourcesample-v1')
+
+
+ def create(self, resource_properties):
+ """Creates a calendar resource with the given resource_properties
+
+ Args:
+ resource_properties: A dictionary of calendar resource properties
+ """
+ print 'Creating a new calendar resource with id %s...' % (
+ resource_properties['resource_id'])
+ print self.client.CreateResource(
+ resource_id=resource_properties['resource_id'],
+ resource_common_name=resource_properties['resource_name'],
+ resource_description=resource_properties['resource_description'],
+ resource_type=resource_properties['resource_type'])
+
+ def get(self, resource_id=None):
+ """Retrieves the calendar resource with the given resource_id
+
+ Args:
+ resource_id: The optional calendar resource identifier
+ """
+ if resource_id:
+ print 'Retrieving the calendar resource with id %s...' % (resource_id)
+ print self.client.GetResource(resource_id=resource_id)
+ else:
+ print 'Retrieving all calendar resources...'
+ print self.client.GetResourceFeed()
+
+ def update(self, resource_properties):
+ """Updates the calendar resource with the given resource_properties
+
+ Args:
+ resource_properties: A dictionary of calendar resource properties
+ """
+ print 'Updating the calendar resource with id %s...' % (
+ resource_properties['resource_id'])
+ print self.client.UpdateResource(
+ resource_id=resource_properties['resource_id'],
+ resource_common_name=resource_properties['resource_name'],
+ resource_description=resource_properties['resource_description'],
+ resource_type=resource_properties['resource_type'])
+
+ def delete(self, resource_id):
+ """Deletes the calendar resource with the given resource_id
+
+ Args:
+ resource_id: The unique calendar resource identifier
+ """
+ print 'Deleting the calendar resource with id %s...' % (resource_id)
+ self.client.DeleteResource(resource_id)
+ print 'Calendar resource successfully deleted.'
+
+
+def main():
+ """Demonstrates the Calendar Resource API using CalendarResourceSample."""
+ domain = None
+ admin_email = None
+ admin_password = None
+ do_continue = 'y'
+ print("Google Apps Calendar Resource API Sample\n\n")
+ while not domain:
+ domain = raw_input('Google Apps domain: ')
+ while not admin_email:
+ admin_email = '%s@%s' % (raw_input('Administrator username: '), domain)
+ while not admin_password:
+ admin_password = getpass.getpass('Administrator password: ')
+
+ sample = CalendarResourceSample(domain=domain, email=admin_email,
+ password=admin_password)
+
+ while do_continue.lower() != 'n':
+ do_continue = call_service(sample)
+
+
+def call_service(sample):
+ """Calls the service methods on the user input"""
+ operation = None
+
+ while operation not in ['c', 'C', 'g', 'G', 'u', 'U', 'd', 'D', 'q', 'Q']:
+ operation = raw_input('Do [c=create|g=get|u=update|d=delete|q=quit]: ')
+
+ operation = operation.lower()
+
+ if operation == 'q':
+ return 'n'
+
+ resource_properties = get_input(operation)
+
+ if operation == 'c':
+ sample.create(resource_properties)
+ elif operation == 'g':
+ sample.get(resource_properties['resource_id'])
+ elif operation == 'u':
+ sample.update(resource_properties)
+ elif operation == 'd':
+ sample.delete(resource_properties['resource_id'])
+
+ do_continue = None
+ while do_continue not in ['', 'y', 'Y', 'n', 'N']:
+ do_continue = raw_input('Want to continue (Y/n): ')
+
+ if do_continue == '':
+ do_continue = 'y'
+
+ return do_continue.lower()
+
+
+def get_input(operation):
+ """Gets user input from console"""
+ resource_id = None
+ resource_name = None
+ resource_description = None
+ resource_type = None
+
+ if operation == 'g':
+ resource_id = raw_input('Resource id (leave blank to get all resources): ')
+ else:
+ while not resource_id:
+ resource_id = raw_input('Resource id: ')
+
+ if operation == 'c':
+ resource_name = raw_input('Resource common name (recommended): ')
+ resource_description = raw_input('Resource description (recommended): ')
+ resource_type = raw_input('Resource type (recommended): ')
+ elif operation == 'u':
+ resource_name = raw_input(
+ 'New resource common name (leave blank if no change): ')
+ resource_description = raw_input(
+ 'New resource description (leave blank if no change): ')
+ resource_type = raw_input('New resource type (leave blank if no change): ')
+
+ resource_properties = {'resource_id': resource_id,
+ 'resource_name': resource_name,
+ 'resource_description': resource_description,
+ 'resource_type': resource_type}
+ return resource_properties
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/codesearch/CodesearchExample.py b/samples/codesearch/CodesearchExample.py
new file mode 100755
index 0000000..61ada99
--- /dev/null
+++ b/samples/codesearch/CodesearchExample.py
@@ -0,0 +1,78 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This file demonstrates how to use the Google Data API's Python client library
+# to interface with the Codesearch service.
+
+
+__author__ = 'vbarathan@gmail.com (Prakash Barathan)'
+
+
+from gdata import service
+import gdata.codesearch.service
+import gdata
+import atom
+import getopt
+import sys
+
+
+class CodesearchExample:
+
+ def __init__(self):
+ """Creates a GData service instance to talk to Codesearch service."""
+ self.service = gdata.codesearch.service.CodesearchService(
+ source='Codesearch_Python_Sample-1.0')
+
+ def PrintCodeSnippets(self, query):
+ """Prints the codesearch results for given query."""
+ feed = self.service.GetSnippetsFeed(query)
+ print feed.title.text + " Results for '" + query + "'"
+ print '============================================'
+ for entry in feed.entry:
+ print "" + entry.title.text
+ for match in entry.match:
+ print "\tline#" + match.line_number + ":" + match.text.replace('\n', '')
+ print
+
+
+def main():
+ """The main function runs the CodesearchExample application with user
+ specified query."""
+
+ # parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], "", ["query="])
+ except getopt.error, msg:
+ print ('python CodesearchExample.py --query [query_text]')
+ sys.exit(2)
+
+ query = ''
+
+ # Process options
+ for o, a in opts:
+ if o == "--query":
+ query = a
+
+ if query == '':
+ print ('python CodesearchExample.py --query [query]')
+ sys.exit(2)
+
+ sample = CodesearchExample()
+ sample.PrintCodeSnippets(query)
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/contacts/contacts_example.py b/samples/contacts/contacts_example.py
new file mode 100755
index 0000000..13b6072
--- /dev/null
+++ b/samples/contacts/contacts_example.py
@@ -0,0 +1,352 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+
+import sys
+import getopt
+import getpass
+import atom
+import gdata.contacts.data
+import gdata.contacts.client
+
+
+class ContactsSample(object):
+ """ContactsSample object demonstrates operations with the Contacts feed."""
+
+ def __init__(self, email, password):
+ """Constructor for the ContactsSample object.
+
+ Takes an email and password corresponding to a gmail account to
+ demonstrate the functionality of the Contacts feed.
+
+ Args:
+ email: [string] The e-mail address of the account to use for the sample.
+ password: [string] The password corresponding to the account specified by
+ the email parameter.
+
+ Yields:
+ A ContactsSample object used to run the sample demonstrating the
+ functionality of the Contacts feed.
+ """
+ self.gd_client = gdata.contacts.client.ContactsClient(source='GoogleInc-ContactsPythonSample-1')
+ self.gd_client.ClientLogin(email, password, self.gd_client.source)
+
+ def PrintFeed(self, feed, ctr=0):
+ """Prints out the contents of a feed to the console.
+
+ Args:
+ feed: A gdata.contacts.ContactsFeed instance.
+ ctr: [int] The number of entries in this feed previously printed. This
+ allows continuous entry numbers when paging through a feed.
+
+ Returns:
+ The number of entries printed, including those previously printed as
+ specified in ctr. This is for passing as an argument to ctr on
+ successive calls to this method.
+
+ """
+ if not feed.entry:
+ print '\nNo entries in feed.\n'
+ return 0
+ for i, entry in enumerate(feed.entry):
+ print '\n%s %s' % (ctr+i+1, entry.title.text)
+ if entry.content:
+ print ' %s' % (entry.content.text)
+ for email in entry.email:
+ if email.primary and email.primary == 'true':
+ print ' %s' % (email.address)
+ # Show the contact groups that this contact is a member of.
+ for group in entry.group_membership_info:
+ print ' Member of group: %s' % (group.href)
+ # Display extended properties.
+ for extended_property in entry.extended_property:
+ if extended_property.value:
+ value = extended_property.value
+ else:
+ value = extended_property.GetXmlBlob()
+ print ' Extended Property %s: %s' % (extended_property.name, value)
+ return len(feed.entry) + ctr
+
+ def PrintPaginatedFeed(self, feed, print_method):
+ """ Print all pages of a paginated feed.
+
+ This will iterate through a paginated feed, requesting each page and
+ printing the entries contained therein.
+
+ Args:
+ feed: A gdata.contacts.ContactsFeed instance.
+ print_method: The method which will be used to print each page of the
+ feed. Must accept these two named arguments:
+ feed: A gdata.contacts.ContactsFeed instance.
+ ctr: [int] The number of entries in this feed previously
+ printed. This allows continuous entry numbers when paging
+ through a feed.
+ """
+ ctr = 0
+ while feed:
+ # Print contents of current feed
+ ctr = print_method(feed=feed, ctr=ctr)
+ # Prepare for next feed iteration
+ next = feed.GetNextLink()
+ feed = None
+ if next:
+ if self.PromptOperationShouldContinue():
+ # Another feed is available, and the user has given us permission
+ # to fetch it
+ feed = self.gd_client.GetContacts(uri=next.href)
+ else:
+ # User has asked us to terminate
+ feed = None
+
+ def PromptOperationShouldContinue(self):
+ """ Display a "Continue" prompt.
+
+ This give is used to give users a chance to break out of a loop, just in
+ case they have too many contacts/groups.
+
+ Returns:
+ A boolean value, True if the current operation should continue, False if
+ the current operation should terminate.
+ """
+ while True:
+ input = raw_input("Continue [Y/n]? ")
+ if input is 'N' or input is 'n':
+ return False
+ elif input is 'Y' or input is 'y' or input is '':
+ return True
+
+ def ListAllContacts(self):
+ """Retrieves a list of contacts and displays name and primary email."""
+ feed = self.gd_client.GetContacts()
+ self.PrintPaginatedFeed(feed, self.PrintContactsFeed)
+
+ def PrintGroupsFeed(self, feed, ctr):
+ if not feed.entry:
+ print '\nNo groups in feed.\n'
+ return 0
+ for i, entry in enumerate(feed.entry):
+ print '\n%s %s' % (ctr+i+1, entry.title.text)
+ if entry.content:
+ print ' %s' % (entry.content.text)
+ # Display the group id which can be used to query the contacts feed.
+ print ' Group ID: %s' % entry.id.text
+ # Display extended properties.
+ for extended_property in entry.extended_property:
+ if extended_property.value:
+ value = extended_property.value
+ else:
+ value = extended_property.GetXmlBlob()
+ print ' Extended Property %s: %s' % (extended_property.name, value)
+ return len(feed.entry) + ctr
+
+ def PrintContactsFeed(self, feed, ctr):
+ if not feed.entry:
+ print '\nNo contacts in feed.\n'
+ return 0
+ for i, entry in enumerate(feed.entry):
+ if not entry.name is None:
+ family_name = entry.name.family_name is None and " " or entry.name.family_name.text
+ full_name = entry.name.full_name is None and " " or entry.name.full_name.text
+ given_name = entry.name.given_name is None and " " or entry.name.given_name.text
+ print '\n%s %s: %s - %s' % (ctr+i+1, full_name, given_name, family_name)
+ else:
+ print '\n%s %s (title)' % (ctr+i+1, entry.title.text)
+ if entry.content:
+ print ' %s' % (entry.content.text)
+ for p in entry.structured_postal_address:
+ print ' %s' % (p.formatted_address.text)
+ # Display the group id which can be used to query the contacts feed.
+ print ' Group ID: %s' % entry.id.text
+ # Display extended properties.
+ for extended_property in entry.extended_property:
+ if extended_property.value:
+ value = extended_property.value
+ else:
+ value = extended_property.GetXmlBlob()
+ print ' Extended Property %s: %s' % (extended_property.name, value)
+ for user_defined_field in entry.user_defined_field:
+ print ' User Defined Field %s: %s' % (user_defined_field.key, user_defined_field.value)
+ return len(feed.entry) + ctr
+
+ def ListAllGroups(self):
+ feed = self.gd_client.GetGroups()
+ self.PrintPaginatedFeed(feed, self.PrintGroupsFeed)
+
+ def CreateMenu(self):
+ """Prompts that enable a user to create a contact."""
+ name = raw_input('Enter contact\'s name: ')
+ notes = raw_input('Enter notes for contact: ')
+ primary_email = raw_input('Enter primary email address: ')
+
+ new_contact = gdata.contacts.data.ContactEntry(name=gdata.data.Name(full_name=gdata.data.FullName(text=name)))
+ new_contact.content = atom.data.Content(text=notes)
+ # Create a work email address for the contact and use as primary.
+ new_contact.email.append(gdata.data.Email(address=primary_email,
+ primary='true', rel=gdata.data.WORK_REL))
+ entry = self.gd_client.CreateContact(new_contact)
+
+ if entry:
+ print 'Creation successful!'
+ print 'ID for the new contact:', entry.id.text
+ else:
+ print 'Upload error.'
+
+ def QueryMenu(self):
+ """Prompts for updated-min query parameters and displays results."""
+ updated_min = raw_input(
+ 'Enter updated min (example: 2007-03-16T00:00:00): ')
+ query = gdata.contacts.client.ContactsQuery()
+ query.updated_min = updated_min
+ feed = self.gd_client.GetContacts(q=query)
+ self.PrintFeed(feed)
+
+ def QueryGroupsMenu(self):
+ """Prompts for updated-min query parameters and displays results."""
+ updated_min = raw_input(
+ 'Enter updated min (example: 2007-03-16T00:00:00): ')
+ query = gdata.contacts.client.ContactsQuery(feed='/m8/feeds/groups/default/full')
+ query.updated_min = updated_min
+ feed = self.gd_client.GetGroups(q=query)
+ self.PrintGroupsFeed(feed, 0)
+
+ def _SelectContact(self):
+ feed = self.gd_client.GetContacts()
+ self.PrintFeed(feed)
+ selection = 5000
+ while selection > len(feed.entry)+1 or selection < 1:
+ selection = int(raw_input(
+ 'Enter the number for the contact you would like to modify: '))
+ return feed.entry[selection-1]
+
+ def UpdateContactMenu(self):
+ selected_entry = self._SelectContact()
+ new_name = raw_input('Enter a new name for the contact: ')
+ if not selected_entry.name:
+ selected_entry.name = gdata.data.Name()
+ selected_entry.name.full_name = gdata.data.FullName(text=new_name)
+ self.gd_client.Update(selected_entry)
+
+ def DeleteContactMenu(self):
+ selected_entry = self._SelectContact()
+ self.gd_client.Delete(selected_entry)
+
+ def PrintMenu(self):
+ """Displays a menu of options for the user to choose from."""
+ print ('\nContacts Sample\n'
+ '1) List all of your contacts.\n'
+ '2) Create a contact.\n'
+ '3) Query contacts on updated time.\n'
+ '4) Modify a contact.\n'
+ '5) Delete a contact.\n'
+ '6) List all of your contact groups.\n'
+ '7) Query your groups on updated time.\n'
+ '8) Exit.\n')
+
+ def GetMenuChoice(self, max):
+ """Retrieves the menu selection from the user.
+
+ Args:
+ max: [int] The maximum number of allowed choices (inclusive)
+
+ Returns:
+ The integer of the menu item chosen by the user.
+ """
+ while True:
+ input = raw_input('> ')
+
+ try:
+ num = int(input)
+ except ValueError:
+ print 'Invalid choice. Please choose a value between 1 and', max
+ continue
+
+ if num > max or num < 1:
+ print 'Invalid choice. Please choose a value between 1 and', max
+ else:
+ return num
+
+ def Run(self):
+ """Prompts the user to choose funtionality to be demonstrated."""
+ try:
+ while True:
+
+ self.PrintMenu()
+
+ choice = self.GetMenuChoice(8)
+
+ if choice == 1:
+ self.ListAllContacts()
+ elif choice == 2:
+ self.CreateMenu()
+ elif choice == 3:
+ self.QueryMenu()
+ elif choice == 4:
+ self.UpdateContactMenu()
+ elif choice == 5:
+ self.DeleteContactMenu()
+ elif choice == 6:
+ self.ListAllGroups()
+ elif choice == 7:
+ self.QueryGroupsMenu()
+ elif choice == 8:
+ return
+
+ except KeyboardInterrupt:
+ print '\nGoodbye.'
+ return
+
+
+def main():
+ """Demonstrates use of the Contacts extension using the ContactsSample object."""
+ # Parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['user=', 'pw='])
+ except getopt.error, msg:
+ print 'python contacts_example.py --user [username] --pw [password]'
+ sys.exit(2)
+
+ user = ''
+ pw = ''
+ # Process options
+ for option, arg in opts:
+ if option == '--user':
+ user = arg
+ elif option == '--pw':
+ pw = arg
+
+ while not user:
+ print 'NOTE: Please run these tests only with a test account.'
+ user = raw_input('Please enter your username: ')
+ while not pw:
+ pw = getpass.getpass()
+ if not pw:
+ print 'Password cannot be blank.'
+
+
+ try:
+ sample = ContactsSample(user, pw)
+ except gdata.client.BadAuthentication:
+ print 'Invalid user credentials given.'
+ return
+
+ sample.Run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/contacts/profiles_example.py b/samples/contacts/profiles_example.py
new file mode 100755
index 0000000..21d9f5a
--- /dev/null
+++ b/samples/contacts/profiles_example.py
@@ -0,0 +1,262 @@
+#!/usr/bin/env python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains a Sample for Google Profiles.
+
+ ProfilesSample: demonstrates operations with the Profiles feed.
+"""
+
+__author__ = 'jtoledo (Julian Toledo)'
+
+
+import getopt
+import getpass
+import sys
+
+import gdata.contacts
+import gdata.contacts.service
+
+
+class ProfilesSample(object):
+ """ProfilesSample object demonstrates operations with the Profiles feed."""
+
+ def __init__(self, email, password, domain):
+ """Constructor for the ProfilesSample object.
+
+ Takes an email and password corresponding to a gmail account to
+ demonstrate the functionality of the Profiles feed.
+
+ Args:
+ email: [string] The e-mail address of the account to use for the sample.
+ password: [string] The password corresponding to the account specified by
+ the email parameter.
+ domain: [string] The domain for the Profiles feed
+ """
+ self.gd_client = gdata.contacts.service.ContactsService(
+ contact_list=domain)
+ self.gd_client.email = email
+ self.gd_client.password = password
+ self.gd_client.source = 'GoogleInc-ProfilesPythonSample-1'
+ self.gd_client.ProgrammaticLogin()
+
+ def PrintFeed(self, feed, ctr=0):
+ """Prints out the contents of a feed to the console.
+
+ Args:
+ feed: A gdata.profiles.ProfilesFeed instance.
+ ctr: [int] The number of entries in this feed previously printed. This
+ allows continuous entry numbers when paging through a feed.
+
+ Returns:
+ The number of entries printed, including those previously printed as
+ specified in ctr. This is for passing as an ar1gument to ctr on
+ successive calls to this method.
+ """
+ if not feed.entry:
+ print '\nNo entries in feed.\n'
+ return 0
+ for entry in feed.entry:
+ self.PrintEntry(entry)
+ return len(feed.entry) + ctr
+
+ def PrintEntry(self, entry):
+ """Prints out the contents of a single Entry to the console.
+
+ Args:
+ entry: A gdata.contacts.ProfilesEntry
+ """
+ print '\n%s' % (entry.title.text)
+ for email in entry.email:
+ if email.primary == 'true':
+ print 'Email: %s (primary)' % (email.address)
+ else:
+ print 'Email: %s' % (email.address)
+ if entry.nickname:
+ print 'Nickname: %s' % (entry.nickname.text)
+ if entry.occupation:
+ print 'Occupation: %s' % (entry.occupation.text)
+ if entry.gender:
+ print 'Gender: %s' % (entry.gender.value)
+ if entry.birthday:
+ print 'Birthday: %s' % (entry.birthday.when)
+ for relation in entry.relation:
+ print 'Relation: %s %s' % (relation.rel, relation.text)
+ for user_defined_field in entry.user_defined_field:
+ print 'UserDefinedField: %s %s' % (user_defined_field.key,
+ user_defined_field.value)
+ for website in entry.website:
+ print 'Website: %s %s' % (website.href, website.rel)
+ for phone_number in entry.phone_number:
+ print 'Phone Number: %s' % phone_number.text
+ for organization in entry.organization:
+ print 'Organization:'
+ if organization.org_name:
+ print ' Name: %s' % (organization.org_name.text)
+ if organization.org_title:
+ print ' Title: %s' % (organization.org_title.text)
+ if organization.org_department:
+ print ' Department: %s' % (organization.org_department.text)
+ if organization.org_job_description:
+ print ' Job Desc: %s' % (organization.org_job_description.text)
+
+ def PrintPaginatedFeed(self, feed, print_method):
+ """Print all pages of a paginated feed.
+
+ This will iterate through a paginated feed, requesting each page and
+ printing the entries contained therein.
+
+ Args:
+ feed: A gdata.contacts.ProfilesFeed instance.
+ print_method: The method which will be used to print each page of the
+ """
+ ctr = 0
+ while feed:
+ # Print contents of current feed
+ ctr = print_method(feed=feed, ctr=ctr)
+ # Prepare for next feed iteration
+ next = feed.GetNextLink()
+ feed = None
+ if next:
+ if self.PromptOperationShouldContinue():
+ # Another feed is available, and the user has given us permission
+ # to fetch it
+ feed = self.gd_client.GetProfilesFeed(next.href)
+ else:
+ # User has asked us to terminate
+ feed = None
+
+ def PromptOperationShouldContinue(self):
+ """Display a "Continue" prompt.
+
+ This give is used to give users a chance to break out of a loop, just in
+ case they have too many profiles/groups.
+
+ Returns:
+ A boolean value, True if the current operation should continue, False if
+ the current operation should terminate.
+ """
+ while True:
+ key_input = raw_input('Continue [Y/n]? ')
+ if key_input is 'N' or key_input is 'n':
+ return False
+ elif key_input is 'Y' or key_input is 'y' or key_input is '':
+ return True
+
+ def ListAllProfiles(self):
+ """Retrieves a list of profiles and displays name and primary email."""
+ feed = self.gd_client.GetProfilesFeed()
+ self.PrintPaginatedFeed(feed, self.PrintFeed)
+
+ def SelectProfile(self):
+ username = raw_input('Please enter your username for the profile: ')
+ entry_uri = self.gd_client.GetFeedUri('profiles')+'/'+username
+ try:
+ entry = self.gd_client.GetProfile(entry_uri)
+ self.PrintEntry(entry)
+ except gdata.service.RequestError:
+ print 'Invalid username for the profile.'
+
+ def PrintMenu(self):
+ """Displays a menu of options for the user to choose from."""
+ print ('\nProfiles Sample\n'
+ '1) List all of your Profiles.\n'
+ '2) Get a single Profile.\n'
+ '3) Exit.\n')
+
+ def GetMenuChoice(self, maximum):
+ """Retrieves the menu selection from the user.
+
+ Args:
+ maximum: [int] The maximum number of allowed choices (inclusive)
+
+ Returns:
+ The integer of the menu item chosen by the user.
+ """
+ while True:
+ key_input = raw_input('> ')
+
+ try:
+ num = int(key_input)
+ except ValueError:
+ print 'Invalid choice. Please choose a value between 1 and', maximum
+ continue
+
+ if num > maximum or num < 1:
+ print 'Invalid choice. Please choose a value between 1 and', maximum
+ else:
+ return num
+
+ def Run(self):
+ """Prompts the user to choose funtionality to be demonstrated."""
+ try:
+ while True:
+ self.PrintMenu()
+ choice = self.GetMenuChoice(3)
+ if choice == 1:
+ self.ListAllProfiles()
+ elif choice == 2:
+ self.SelectProfile()
+ elif choice == 3:
+ return
+
+ except KeyboardInterrupt:
+ print '\nGoodbye.'
+ return
+
+
+def main():
+ """Demonstrates use of the Profiles using the ProfilesSample object."""
+ # Parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['user=', 'pw=', 'domain='])
+ except getopt.error, msg:
+ print 'python profiles_example.py --user [username] --pw [password]'
+ print ' --domain [domain]'
+ sys.exit(2)
+
+ user = ''
+ pw = ''
+ domain = ''
+
+ # Process options
+ for option, arg in opts:
+ if option == '--user':
+ user = arg
+ elif option == '--pw':
+ pw = arg
+ elif option == '--domain':
+ domain = arg
+
+ while not user:
+ print 'NOTE: Please run these tests only with a test account.'
+ user = raw_input('Please enter your email: ')
+ while not pw:
+ pw = getpass.getpass('Please enter password: ')
+ if not pw:
+ print 'Password cannot be blank.'
+ while not domain:
+ domain = raw_input('Please enter your Apps domain: ')
+
+ try:
+ sample = ProfilesSample(user, pw, domain)
+ except gdata.service.BadAuthentication:
+ print 'Invalid user credentials given.'
+ return
+
+ sample.Run()
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/contacts/unshare_profiles.py b/samples/contacts/unshare_profiles.py
new file mode 100755
index 0000000..79b892b
--- /dev/null
+++ b/samples/contacts/unshare_profiles.py
@@ -0,0 +1,136 @@
+#!/usr/bin/env python
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unshare domain users contact information when contact sharing is enabled."""
+
+__author__ = 'alainv@google.com (Alain Vongsouvanh)'
+
+
+import sys
+
+import gdata.contacts.client
+import gdata.contacts.data
+import gdata.gauth
+
+
+class BatchResult(object):
+ """Hold batch processing results.
+
+ Attributes:
+ success_count: Number of successful operations.
+ error_count: Number of failed operations.
+ error_entries: List of failed entries.
+ """
+ success_count = 0
+ error_count = 0
+ error_entries = []
+
+
+class ProfilesManager(object):
+ """ProfilesManager object used to unshare domain users contact information.
+
+ Basic usage is:
+ >>> manager = ProfilesManager(CONSUMER_KEY, CONSUMER_SECRET, ADMIN_EMAIL)
+ >>> result = manager.UnshareProfiles()
+ >>> print 'Success: %s - Error: %s' % (result.success, result.error_count)
+
+ Attributes:
+ profiles: List of ProfilesEntry.
+ batch_size: Number of operations per batch request (default to 100).
+ """
+
+ def __init__(self, consumer_key, consumer_secret, admin_email):
+ domain = admin_email[admin_email.index('@') + 1:]
+ self._gd_client = gdata.contacts.client.ContactsClient(
+ source='GoogleInc-UnshareProfiles-1', domain=domain)
+ self._gd_client.auth_token = gdata.gauth.TwoLeggedOAuthHmacToken(
+ consumer_key, consumer_secret, admin_email)
+ self._profiles = None
+ self.batch_size = 100
+
+ @property
+ def profiles(self):
+ """Get the list of profiles for the domain.
+
+ Returns:
+ List of ProfilesEntry.
+ """
+ if not self._profiles:
+ self.GetAllProfiles()
+ return self._profiles
+
+ def GetAllProfiles(self):
+ """Retrieve the list of user profiles for the domain."""
+ profiles = []
+ feed_uri = self._gd_client.GetFeedUri('profiles')
+ while feed_uri:
+ feed = self._gd_client.GetProfilesFeed(uri=feed_uri)
+ profiles.extend(feed.entry)
+ feed_uri = feed.FindNextLink()
+ self._profiles = profiles
+
+ def UnshareProfiles(self):
+ """Unshare users' contact information.
+
+ Uses batch request to optimize the resources.
+
+ Returns:
+ BatchResult object.
+ """
+ if not self._profiles:
+ self.GetAllProfiles()
+ batch_size = max(self.batch_size, 100)
+ index = 0
+ result = BatchResult()
+ while index < len(self._profiles):
+ request_feed = gdata.contacts.data.ProfilesFeed()
+ for entry in self._profiles[index:index + batch_size]:
+ entry.status = gdata.contacts.data.Status(indexed='false')
+ request_feed.AddUpdate(entry=entry)
+ result_feed = self._gd_client.ExecuteBatchProfiles(request_feed)
+ for entry in result_feed.entry:
+ if entry.batch_status.code == '200':
+ self._profiles[index] = entry
+ result.success_count += 1
+ else:
+ result.error_entries.append(entry)
+ result.error_count += 1
+ index += 1
+ return result
+
+
+def main():
+ """Demonstrates the use of the Profiles API to unshare profiles."""
+ if len(sys.argv) > 3:
+ consumer_key = sys.argv[1]
+ consumer_secret = sys.argv[2]
+ admin_email = sys.argv[3]
+ else:
+ print ('python unshare_profiles.py [consumer_key] [consumer_secret]'
+ ' [admin_email]')
+ sys.exit(2)
+
+ manager = ProfilesManager(consumer_key, consumer_secret, admin_email)
+ result = manager.UnshareProfiles()
+ print 'Success: %s - Error: %s' % (result.success_count, result.error_count)
+ for entry in result.error_entries:
+ print ' > Failed to update %s: (%s) %s' % (
+ entry.id.text, entry.batch_status.code, entry.batch_status.reason)
+ sys.exit(result.error_count)
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/contentforshopping/add_batch_products.py b/samples/contentforshopping/add_batch_products.py
new file mode 100644
index 0000000..c04c953
--- /dev/null
+++ b/samples/contentforshopping/add_batch_products.py
@@ -0,0 +1,56 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import getpass
+
+from gdata.contentforshopping.data import build_entry
+from gdata.contentforshopping.client import ContentForShoppingClient
+
+# Gather merchant information
+account_id = raw_input('Merchant Account ID? ').strip()
+email = raw_input('Google Email Address? ').strip()
+
+# Create a client
+client = ContentForShoppingClient(account_id)
+
+# Perform programmatic login
+client.client_login(email, getpass.getpass('Google Password? '),
+ 'Shopping API for Content sample', 'structuredcontent')
+
+products = []
+
+for color in ['red', 'green', 'white', 'black', 'purple', 'brown', 'yellow',
+ 'orange', 'magenta']:
+ # Generate a product entry
+ product_entry = build_entry(
+ product_id='ipod%s' % color,
+ target_country = 'US',
+ content_language = 'EN',
+ title='iPod Nano 8GB, %s' % color,
+ content='A nice small mp3 player, in %s' % color,
+ price='149',
+ price_unit='USD',
+ shipping_price = '5',
+ shipping_price_unit = 'USD',
+ tax_rate='17.5',
+ condition = 'new',
+ link = 'http://pseudoscience.co.uk/google4e823e35f032f011.html',
+ color = color,
+ )
+ products.append(product_entry)
+
+# Post it to the service
+client.insert_products(products)
diff --git a/samples/contentforshopping/add_product.py b/samples/contentforshopping/add_product.py
new file mode 100644
index 0000000..c348033
--- /dev/null
+++ b/samples/contentforshopping/add_product.py
@@ -0,0 +1,51 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import getpass
+
+from gdata.contentforshopping.data import build_entry
+from gdata.contentforshopping.client import ContentForShoppingClient
+
+# Gather merchant information
+account_id = raw_input('Merchant Account ID? ').strip()
+email = raw_input('Google Email Address? ').strip()
+
+# Create a client
+client = ContentForShoppingClient(account_id)
+
+# Perform programmatic login
+client.client_login(email, getpass.getpass('Google Password? '),
+ 'Shopping API for Content sample', 'structuredcontent')
+
+# Generate a product entry
+product_entry = build_entry(
+ product_id='ipod2',
+ target_country = 'US',
+ content_language = 'EN',
+ title='iPod Nano 8GB',
+ content='A nice small mp3 player',
+ price='149',
+ price_unit='USD',
+ shipping_price = '5',
+ shipping_price_unit = 'USD',
+ tax_rate='17.5',
+ condition = 'new',
+ link = 'http://pseudoscience.co.uk/google4e823e35f032f011.html',
+ identifier_exists='hello'
+)
+
+# Post it to the service
+client.insert_product(product_entry)
diff --git a/samples/contentforshopping/ca_insert.py b/samples/contentforshopping/ca_insert.py
new file mode 100644
index 0000000..3b35de7
--- /dev/null
+++ b/samples/contentforshopping/ca_insert.py
@@ -0,0 +1,41 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import getpass
+from atom.data import Title
+from gdata.contentforshopping.client import ContentForShoppingClient
+from gdata.contentforshopping.data import ClientAccount, AdultContent
+
+# Gather merchant information
+account_id = raw_input('Merchant Account ID? ').strip()
+email = raw_input('Google Email Address? ').strip()
+
+# Create a client
+client = ContentForShoppingClient(account_id)
+
+# Perform programmatic login
+client.client_login(email, getpass.getpass('Google Password? '),
+ 'Shopping API for Content sample', 'structuredcontent')
+
+# Create 10 accounts
+for i in range(10):
+ client_account = ClientAccount()
+ client_account.title = Title('Test Account %s' % (i + 1))
+ client_account.adult_content = AdultContent('no')
+ # Insert the client account
+ client.insert_client_account(client_account)
+ # Display something to the user
+ print i + 1, '/', 10
diff --git a/samples/contentforshopping/ca_list.py b/samples/contentforshopping/ca_list.py
new file mode 100644
index 0000000..b185fa8
--- /dev/null
+++ b/samples/contentforshopping/ca_list.py
@@ -0,0 +1,37 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import getpass
+
+from gdata.contentforshopping.client import ContentForShoppingClient
+
+# Gather merchant information
+account_id = raw_input('Merchant Account ID? ').strip()
+email = raw_input('Google Email Address? ').strip()
+
+# Create a client
+client = ContentForShoppingClient(account_id)
+
+# Perform programmatic login
+client.client_login(email, getpass.getpass('Google Password? '),
+ 'Shopping API for Content sample', 'structuredcontent')
+
+# Get the feed of client accounts
+client_account_feed = client.get_client_accounts()
+
+# Display the title and self link for each client account
+for client_account in client_account_feed.entry:
+ print client_account.title.text, client_account.GetSelfLink().href
diff --git a/samples/contentforshopping/list_products.py b/samples/contentforshopping/list_products.py
new file mode 100644
index 0000000..c610214
--- /dev/null
+++ b/samples/contentforshopping/list_products.py
@@ -0,0 +1,39 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import getpass
+
+from gdata.contentforshopping.client import ContentForShoppingClient
+
+# Gather merchant information
+account_id = raw_input('Merchant Account ID? ').strip()
+email = raw_input('Google Email Address? ').strip()
+
+# Create a client
+client = ContentForShoppingClient(account_id)
+
+# Perform programmatic login
+client.client_login(email, getpass.getpass('Google Password? '),
+ 'Shopping API for Content sample', 'structuredcontent')
+
+# Get the products list from the products feed
+product_feed = client.get_products()
+
+print 'Listing: %s result(s)' % product_feed.total_results.text
+
+# Each product is an element in the feed's entry (a list)
+for product in product_feed.entry:
+ print '- %s: %s' % (product.title.text, product.content.text)
diff --git a/samples/docs/docs_example.py b/samples/docs/docs_example.py
new file mode 100755
index 0000000..218174e
--- /dev/null
+++ b/samples/docs/docs_example.py
@@ -0,0 +1,347 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007, 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = ('api.jfisher (Jeff Fisher), '
+ 'e.bidelman (Eric Bidelman)')
+
+
+import sys
+import re
+import os.path
+import getopt
+import getpass
+import gdata.docs.service
+import gdata.spreadsheet.service
+
+
+def truncate(content, length=15, suffix='...'):
+ if len(content) <= length:
+ return content
+ else:
+ return content[:length] + suffix
+
+
+class DocsSample(object):
+ """A DocsSample object demonstrates the Document List feed."""
+
+ def __init__(self, email, password):
+ """Constructor for the DocsSample object.
+
+ Takes an email and password corresponding to a gmail account to
+ demonstrate the functionality of the Document List feed.
+
+ Args:
+ email: [string] The e-mail address of the account to use for the sample.
+ password: [string] The password corresponding to the account specified by
+ the email parameter.
+
+ Returns:
+ A DocsSample object used to run the sample demonstrating the
+ functionality of the Document List feed.
+ """
+ source = 'Document List Python Sample'
+ self.gd_client = gdata.docs.service.DocsService()
+ self.gd_client.ClientLogin(email, password, source=source)
+
+ # Setup a spreadsheets service for downloading spreadsheets
+ self.gs_client = gdata.spreadsheet.service.SpreadsheetsService()
+ self.gs_client.ClientLogin(email, password, source=source)
+
+ def _PrintFeed(self, feed):
+ """Prints out the contents of a feed to the console.
+
+ Args:
+ feed: A gdata.docs.DocumentListFeed instance.
+ """
+ print '\n'
+ if not feed.entry:
+ print 'No entries in feed.\n'
+ print '%-18s %-12s %s' % ('TITLE', 'TYPE', 'RESOURCE ID')
+ for entry in feed.entry:
+ print '%-18s %-12s %s' % (truncate(entry.title.text.encode('UTF-8')),
+ entry.GetDocumentType(),
+ entry.resourceId.text)
+
+ def _GetFileExtension(self, file_name):
+ """Returns the uppercase file extension for a file.
+
+ Args:
+ file_name: [string] The basename of a filename.
+
+ Returns:
+ A string containing the file extension of the file.
+ """
+ match = re.search('.*\.([a-zA-Z]{3,}$)', file_name)
+ if match:
+ return match.group(1).upper()
+ return False
+
+ def _UploadMenu(self):
+ """Prompts that enable a user to upload a file to the Document List feed."""
+ file_path = ''
+ file_path = raw_input('Enter path to file: ')
+
+ if not file_path:
+ return
+ elif not os.path.isfile(file_path):
+ print 'Not a valid file.'
+ return
+
+ file_name = os.path.basename(file_path)
+ ext = self._GetFileExtension(file_name)
+
+ if not ext or ext not in gdata.docs.service.SUPPORTED_FILETYPES:
+ print 'File type not supported. Check the file extension.'
+ return
+ else:
+ content_type = gdata.docs.service.SUPPORTED_FILETYPES[ext]
+
+ title = ''
+ while not title:
+ title = raw_input('Enter name for document: ')
+
+ try:
+ ms = gdata.MediaSource(file_path=file_path, content_type=content_type)
+ except IOError:
+ print 'Problems reading file. Check permissions.'
+ return
+
+ if ext in ['CSV', 'ODS', 'XLS', 'XLSX']:
+ print 'Uploading spreadsheet...'
+ elif ext in ['PPT', 'PPS']:
+ print 'Uploading presentation...'
+ else:
+ print 'Uploading word processor document...'
+
+ entry = self.gd_client.Upload(ms, title)
+
+ if entry:
+ print 'Upload successful!'
+ print 'Document now accessible at:', entry.GetAlternateLink().href
+ else:
+ print 'Upload error.'
+
+ def _DownloadMenu(self):
+ """Prompts that enable a user to download a local copy of a document."""
+ resource_id = ''
+ resource_id = raw_input('Enter an resource id: ')
+ file_path = ''
+ file_path = raw_input('Save file to: ')
+
+ if not file_path or not resource_id:
+ return
+
+ file_name = os.path.basename(file_path)
+ ext = self._GetFileExtension(file_name)
+
+ if not ext or ext not in gdata.docs.service.SUPPORTED_FILETYPES:
+ print 'File type not supported. Check the file extension.'
+ return
+ else:
+ content_type = gdata.docs.service.SUPPORTED_FILETYPES[ext]
+
+ doc_type = resource_id[:resource_id.find(':')]
+
+ # When downloading a spreadsheet, the authenticated request needs to be
+ # sent with the spreadsheet service's auth token.
+ if doc_type == 'spreadsheet':
+ print 'Downloading spreadsheet to %s...' % (file_path,)
+ docs_token = self.gd_client.GetClientLoginToken()
+ self.gd_client.SetClientLoginToken(self.gs_client.GetClientLoginToken())
+ self.gd_client.Export(resource_id, file_path, gid=0)
+ self.gd_client.SetClientLoginToken(docs_token)
+ else:
+ print 'Downloading document to %s...' % (file_path,)
+ self.gd_client.Export(resource_id, file_path)
+
+ def _ListDocuments(self):
+ """Retrieves and displays a list of documents based on the user's choice."""
+ print 'Retrieve (all/document/folder/presentation/spreadsheet/pdf): '
+ category = raw_input('Enter a category: ')
+
+ if category == 'all':
+ feed = self.gd_client.GetDocumentListFeed()
+ elif category == 'folder':
+ query = gdata.docs.service.DocumentQuery(categories=['folder'],
+ params={'showfolders': 'true'})
+ feed = self.gd_client.Query(query.ToUri())
+ else:
+ query = gdata.docs.service.DocumentQuery(categories=[category])
+ feed = self.gd_client.Query(query.ToUri())
+
+ self._PrintFeed(feed)
+
+ def _ListAclPermissions(self):
+ """Retrieves a list of a user's folders and displays them."""
+ resource_id = raw_input('Enter an resource id: ')
+ query = gdata.docs.service.DocumentAclQuery(resource_id)
+ print '\nListing document permissions:'
+ feed = self.gd_client.GetDocumentListAclFeed(query.ToUri())
+ for acl_entry in feed.entry:
+ print '%s - %s (%s)' % (acl_entry.role.value, acl_entry.scope.value,
+ acl_entry.scope.type)
+
+ def _ModifyAclPermissions(self):
+ """Create or updates the ACL entry on an existing document."""
+ resource_id = raw_input('Enter an resource id: ')
+ email = raw_input('Enter an email address: ')
+ role_value = raw_input('Enter a permission (reader/writer/owner/remove): ')
+
+ uri = gdata.docs.service.DocumentAclQuery(resource_id).ToUri()
+ acl_feed = self.gd_client.GetDocumentListAclFeed(uri)
+
+ found_acl_entry = None
+ for acl_entry in acl_feed.entry:
+ if acl_entry.scope.value == email:
+ found_acl_entry = acl_entry
+ break
+
+ if found_acl_entry:
+ if role_value == 'remove':
+ # delete ACL entry
+ self.gd_client.Delete(found_acl_entry.GetEditLink().href)
+ else:
+ # update ACL entry
+ found_acl_entry.role.value = role_value
+ updated_entry = self.gd_client.Put(
+ found_acl_entry, found_acl_entry.GetEditLink().href,
+ converter=gdata.docs.DocumentListAclEntryFromString)
+ else:
+ scope = gdata.docs.Scope(value=email, type='user')
+ role = gdata.docs.Role(value=role_value)
+ acl_entry = gdata.docs.DocumentListAclEntry(scope=scope, role=role)
+ inserted_entry = self.gd_client.Post(
+ acl_entry, uri, converter=gdata.docs.DocumentListAclEntryFromString)
+
+ print '\nListing document permissions:'
+ acl_feed = self.gd_client.GetDocumentListAclFeed(uri)
+ for acl_entry in acl_feed.entry:
+ print '%s - %s (%s)' % (acl_entry.role.value, acl_entry.scope.value,
+ acl_entry.scope.type)
+
+ def _FullTextSearch(self):
+ """Searches a user's documents for a text string.
+
+ Provides prompts to search a user's documents and displays the results
+ of such a search. The text_query parameter of the DocumentListQuery object
+ corresponds to the contents of the q parameter in the feed. Note that this
+ parameter searches the content of documents, not just their titles.
+ """
+ input = raw_input('Enter search term: ')
+ query = gdata.docs.service.DocumentQuery(text_query=input)
+ feed = self.gd_client.Query(query.ToUri())
+ self._PrintFeed(feed)
+
+ def _PrintMenu(self):
+ """Displays a menu of options for the user to choose from."""
+ print ('\nDocument List Sample\n'
+ '1) List your documents.\n'
+ '2) Search your documents.\n'
+ '3) Upload a document.\n'
+ '4) Download a document.\n'
+ "5) List a document's permissions.\n"
+ "6) Add/change a document's permissions.\n"
+ '7) Exit.\n')
+
+ def _GetMenuChoice(self, max):
+ """Retrieves the menu selection from the user.
+
+ Args:
+ max: [int] The maximum number of allowed choices (inclusive)
+
+ Returns:
+ The integer of the menu item chosen by the user.
+ """
+ while True:
+ input = raw_input('> ')
+
+ try:
+ num = int(input)
+ except ValueError:
+ print 'Invalid choice. Please choose a value between 1 and', max
+ continue
+
+ if num > max or num < 1:
+ print 'Invalid choice. Please choose a value between 1 and', max
+ else:
+ return num
+
+ def Run(self):
+ """Prompts the user to choose funtionality to be demonstrated."""
+ try:
+ while True:
+ self._PrintMenu()
+ choice = self._GetMenuChoice(7)
+
+ if choice == 1:
+ self._ListDocuments()
+ elif choice == 2:
+ self._FullTextSearch()
+ elif choice == 3:
+ self._UploadMenu()
+ elif choice == 4:
+ self._DownloadMenu()
+ elif choice == 5:
+ self._ListAclPermissions()
+ elif choice == 6:
+ self._ModifyAclPermissions()
+ elif choice == 7:
+ print '\nGoodbye.'
+ return
+ except KeyboardInterrupt:
+ print '\nGoodbye.'
+ return
+
+
+def main():
+ """Demonstrates use of the Docs extension using the DocsSample object."""
+ # Parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['user=', 'pw='])
+ except getopt.error, msg:
+ print 'python docs_example.py --user [username] --pw [password] '
+ sys.exit(2)
+
+ user = ''
+ pw = ''
+ key = ''
+ # Process options
+ for option, arg in opts:
+ if option == '--user':
+ user = arg
+ elif option == '--pw':
+ pw = arg
+
+ while not user:
+ print 'NOTE: Please run these tests only with a test account.'
+ user = raw_input('Please enter your username: ')
+ while not pw:
+ pw = getpass.getpass()
+ if not pw:
+ print 'Password cannot be blank.'
+
+ try:
+ sample = DocsSample(user, pw)
+ except gdata.service.BadAuthentication:
+ print 'Invalid user credentials given.'
+ return
+
+ sample.Run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/docs/docs_v3_example.py b/samples/docs/docs_v3_example.py
new file mode 100755
index 0000000..f86227b
--- /dev/null
+++ b/samples/docs/docs_v3_example.py
@@ -0,0 +1,259 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Samples for the Documents List API v3."""
+
+__author__ = 'afshar@google.com (Ali Afshar)'
+
+import os.path
+import gdata.data
+import gdata.acl.data
+import gdata.docs.client
+import gdata.docs.data
+import gdata.sample_util
+
+
+class SampleConfig(object):
+ APP_NAME = 'GDataDocumentsListAPISample-v1.0'
+ DEBUG = False
+
+
+def CreateClient():
+ """Create a Documents List Client."""
+ client = gdata.docs.client.DocsClient(source=SampleConfig.APP_NAME)
+ client.http_client.debug = SampleConfig.DEBUG
+ # Authenticate the user with CLientLogin, OAuth, or AuthSub.
+ try:
+ gdata.sample_util.authorize_client(
+ client,
+ service=client.auth_service,
+ source=client.source,
+ scopes=client.auth_scopes
+ )
+ except gdata.client.BadAuthentication:
+ exit('Invalid user credentials given.')
+ except gdata.client.Error:
+ exit('Login Error')
+ return client
+
+
+def PrintResource(resource):
+ """Display a resource to Standard Out."""
+ print resource.resource_id.text, resource.GetResourceType()
+
+
+def PrintFeed(feed):
+ """Display a feed to Standard Out."""
+ for entry in feed.entry:
+ PrintResource(entry)
+
+
+def _GetDataFilePath(name):
+ return os.path.join(
+ os.path.dirname(
+ os.path.dirname(
+ os.path.dirname(__file__))),
+ 'tests', 'gdata_tests', 'docs', 'data', name)
+
+
+def GetResourcesSample():
+ """Get and display first page of resources."""
+ client = CreateClient()
+ # Get a feed and print it
+ feed = client.GetResources()
+ PrintFeed(feed)
+
+
+def GetAllResourcesSample():
+ """Get and display all resources, using pagination."""
+ client = CreateClient()
+ # Unlike client.GetResources, this returns a list of resources
+ for resource in client.GetAllResources():
+ PrintResource(resource)
+
+
+def GetResourceSample():
+ """Fetch 5 resources from a feed, then again individually."""
+ client = CreateClient()
+ for e1 in client.GetResources(limit=5).entry:
+ e2 = client.GetResource(e1)
+ print 'Refetched: ', e2.title.text, e2.resource_id.text
+
+
+def GetMetadataSample():
+ """Get and display the Metadata for the current user."""
+ client = CreateClient()
+ # Fetch the metadata entry and display bits of it
+ metadata = client.GetMetadata()
+ print 'Quota'
+ print ' Total:', metadata.quota_bytes_total.text
+ print ' Used:', metadata.quota_bytes_used.text
+ print ' Trashed:', metadata.quota_bytes_used_in_trash.text
+ print 'Import / Export'
+ for input_format in metadata.import_formats:
+ print ' Import:', input_format.source, 'to', input_format.target
+ for export_format in metadata.export_formats:
+ print ' Export:', export_format.source, 'to', export_format.target
+ print 'Features'
+ for feature in metadata.features:
+ print ' Feature:', feature.name.text
+ print 'Upload Sizes'
+ for upload_size in metadata.max_upload_sizes:
+ print ' Kind:', upload_size.kind, upload_size.text
+
+
+def GetChangesSample():
+ """Get and display the Changes for the user."""
+ client = CreateClient()
+ changes = client.GetChanges()
+ for change in changes.entry:
+ print change.title.text, change.changestamp.value
+
+
+def GetResourceAclSample():
+ """Get and display the ACL for a resource."""
+ client = CreateClient()
+ for resource in client.GetResources(limit=5).entry:
+ acl_feed = client.GetResourceAcl(resource)
+ for acl in acl_feed.entry:
+ print acl.role.value, acl.scope.type, acl.scope.value
+
+
+def CreateEmptyResourceSample():
+ """Create an empty resource of type document."""
+ client = CreateClient()
+ document = gdata.docs.data.Resource(type='document', title='My Sample Doc')
+ document = client.CreateResource(document)
+ print 'Created:', document.title.text, document.resource_id.text
+
+
+def CreateCollectionSample():
+ """Create an empty collection."""
+ client = CreateClient()
+ col = gdata.docs.data.Resource(type='folder', title='My Sample Folder')
+ col = client.CreateResource(col)
+ print 'Created collection:', col.title.text, col.resource_id.text
+
+
+def CreateResourceInCollectionSample():
+ """Create a collection, then create a document in it."""
+ client = CreateClient()
+ col = gdata.docs.data.Resource(type='folder', title='My Sample Folder')
+ col = client.CreateResource(col)
+ print 'Created collection:', col.title.text, col.resource_id.text
+ doc = gdata.docs.data.Resource(type='document', title='My Sample Doc')
+ doc = client.CreateResource(doc, collection=col)
+ print 'Created:', doc.title.text, doc.resource_id.text
+
+
+def UploadResourceSample():
+ """Upload a document, and convert to Google Docs."""
+ client = CreateClient()
+ doc = gdata.docs.data.Resource(type='document', title='My Sample Doc')
+ # Set the description
+ doc.description = gdata.docs.data.Description(
+ 'This is a simple Word document.')
+ # This is a convenient MS Word doc that we know exists
+ path = _GetDataFilePath('test.0.doc')
+ print 'Selected file at: %s' % path
+ # Create a MediaSource, pointing to the file
+ media = gdata.data.MediaSource()
+ media.SetFileHandle(path, 'application/msword')
+ # Pass the MediaSource when creating the new Resource
+ doc = client.CreateResource(doc, media=media)
+ print 'Created, and uploaded:', doc.title.text, doc.resource_id.text
+
+
+def UploadUnconvertedFileSample():
+ """Upload a document, unconverted."""
+ client = CreateClient()
+ doc = gdata.docs.data.Resource(type='document', title='My Sample Raw Doc')
+ path = _GetDataFilePath('test.0.doc')
+ media = gdata.data.MediaSource()
+ media.SetFileHandle(path, 'application/msword')
+ # Pass the convert=false parameter
+ create_uri = gdata.docs.client.RESOURCE_UPLOAD_URI + '?convert=false'
+ doc = client.CreateResource(doc, create_uri=create_uri, media=media)
+ print 'Created, and uploaded:', doc.title.text, doc.resource_id.text
+
+
+def DeleteResourceSample():
+ """Delete a resource (after creating it)."""
+ client = CreateClient()
+ doc = gdata.docs.data.Resource(type='document', title='My Sample Doc')
+ doc = client.CreateResource(doc)
+ # Delete the resource we just created.
+ client.DeleteResource(doc)
+
+
+def AddAclSample():
+ """Create a resource and an ACL."""
+ client = CreateClient()
+ doc = gdata.docs.data.Resource(type='document', title='My Sample Doc')
+ doc = client.CreateResource(doc)
+ acl_entry = gdata.docs.data.AclEntry(
+ scope=gdata.acl.data.AclScope(value='user@example.com', type='user'),
+ role=gdata.acl.data.AclRole(value='reader'),
+ )
+ client.AddAclEntry(doc, acl_entry, send_notifications=False)
+
+
+def DeleteAclSample():
+ """Create an ACL entry, and delete it."""
+ client = CreateClient()
+ doc = gdata.docs.data.Resource(type='document', title='My Sample Doc')
+ doc = client.CreateResource(doc)
+ acl_entry = gdata.docs.data.AclEntry(
+ scope=gdata.acl.data.AclScope(value='user@example.com', type='user'),
+ role=gdata.acl.data.AclRole(value='reader'),
+ )
+ acl_entry = client.AddAclEntry(doc, acl_entry)
+ client.DeleteAclEntry(acl_entry)
+
+
+def AddAclBatchSample():
+ """Add a list of ACLs as a batch."""
+ client = CreateClient()
+ doc = gdata.docs.data.Resource(type='document', title='My Sample Doc')
+ doc = client.CreateResource(doc)
+ acl1 = gdata.docs.data.AclEntry(
+ scope=gdata.acl.data.AclScope(value='user1@example.com', type='user'),
+ role=gdata.acl.data.AclRole(value='reader'),
+ batch_operation=gdata.data.BatchOperation(type='insert'),
+ )
+ acl2 = gdata.docs.data.AclEntry(
+ scope=gdata.acl.data.AclScope(value='user2@example.com', type='user'),
+ role=gdata.acl.data.AclRole(value='reader'),
+ batch_operation=gdata.data.BatchOperation(type='insert'),
+ )
+ # Create a list of operations to perform together.
+ acl_operations = [acl1, acl2]
+ # Perform the operations.
+ client.BatchProcessAclEntries(doc, acl_operations)
+
+
+def GetRevisionsSample():
+ """Get the revision history for resources."""
+ client = CreateClient()
+ for entry in client.GetResources(limit=55).entry:
+ revisions = client.GetRevisions(entry)
+ for revision in revisions.entry:
+ print revision.publish, revision.GetPublishLink()
+
+
+if __name__ == '__main__':
+ import samplerunner
+ samplerunner.Run(__file__)
diff --git a/samples/docs/samplerunner.py b/samples/docs/samplerunner.py
new file mode 100644
index 0000000..5b18d20
--- /dev/null
+++ b/samples/docs/samplerunner.py
@@ -0,0 +1,44 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Sample running boilerplate."""
+
+__author__ = 'afshar@google.com (Ali Afshar)'
+
+
+def Run(source_file):
+ """Load a source file and run a sample from it."""
+ source = open(source_file).read()
+ global_dict = {'__file__': source_file}
+ exec source in global_dict
+ samples = [global_dict[k] for k in global_dict if k.endswith('Sample')]
+ lines = source.splitlines()
+ for i, sample in enumerate(samples):
+ print str(i).rjust(2), sample.__name__, '-', sample.__doc__
+ try:
+ i = int(raw_input('Select sample: ').strip())
+ sample = samples[i]
+ print '-' * 80
+ print 'def', '%s():' % sample.__name__
+ # print each line until a blank one (or eof).
+ for line in lines[sample.func_code.co_firstlineno:]:
+ if not line:
+ break
+ print line
+ print '-' * 80
+ sample()
+ except (ValueError, IndexError):
+ print 'Bad selection.'
diff --git a/samples/finance/test_finance.py b/samples/finance/test_finance.py
new file mode 100755
index 0000000..9347aa5
--- /dev/null
+++ b/samples/finance/test_finance.py
@@ -0,0 +1,301 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Tan Swee Heng
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'thesweeheng@gmail.com'
+
+
+from gdata.finance.service import \
+ FinanceService, PortfolioQuery, PositionQuery
+from gdata.finance import \
+ PortfolioEntry, PortfolioData, TransactionEntry, TransactionData, \
+ Price, Commission, Money
+import datetime
+import sys
+
+
+def PrintReturns(pfx, d):
+ """Print returns."""
+ print pfx, '%1.5f(1w) %1.5f(4w) %1.5f(3m) %1.5f(YTD)' % tuple(
+ float(i) for i in (d.return1w, d.return4w, d.return3m, d.returnYTD))
+ pfx = ' ' * len(pfx)
+ print pfx, '%1.5f(1y) %1.5f(3y) %1.5f(5y) %1.5f(overall)' % tuple(
+ float(i) for i in (d.return1y, d.return3y, d.return5y, d.return_overall))
+
+
+PrRtn = PrintReturns
+
+
+def PrintTransactions(transactions):
+ """Print transactions."""
+ print " Transactions:"
+ fmt = ' %4s %-23s %-10s %6s %-11s %-11s'
+ print fmt % ('ID','Date','Type','Shares','Price','Commission')
+ for txn in transactions:
+ d = txn.transaction_data
+ print fmt % (txn.transaction_id, d.date or '----', d.type,
+ d.shares, d.price.money[0], d.commission.money[0])
+ if d.notes:
+ print " Notes:", d.notes
+ print
+
+
+def PrintPosition(pos, with_returns=False):
+ """Print single position."""
+ print ' Position :', pos.position_title
+ print ' Ticker ID :', pos.ticker_id
+ print ' Symbol :', pos.symbol
+ print ' Last updated :', pos.updated.text
+ d = pos.position_data
+ print ' Shares :', d.shares
+ if with_returns:
+ print ' Gain % :', d.gain_percentage
+ PrRtn(' Returns :', d)
+ print ' Cost basis :', d.cost_basis
+ print ' Days gain :', d.days_gain
+ print ' Gain :', d.gain
+ print ' Market value :', d.market_value
+ print
+ if pos.transactions:
+ print " <inlined transactions>\n"
+ PrintTransactions(pos.transactions)
+ print " </inlined transactions>\n"
+
+
+def PrintPositions(positions, with_returns=False):
+ for pos in positions:
+ PrintPosition(pos, with_returns)
+
+
+def PrintPortfolio(pfl, with_returns=False):
+ """Print single portfolio."""
+ print 'Portfolio Title :', pfl.portfolio_title
+ print 'Portfolio ID :', pfl.portfolio_id
+ print ' Last updated :', pfl.updated.text
+ d = pfl.portfolio_data
+ print ' Currency :', d.currency_code
+ if with_returns:
+ print ' Gain % :', d.gain_percentage
+ PrRtn(' Returns :', d)
+ print ' Cost basis :', d.cost_basis
+ print ' Days gain :', d.days_gain
+ print ' Gain :', d.gain
+ print ' Market value :', d.market_value
+ print
+ if pfl.positions:
+ print " <inlined positions>\n"
+ PrintPositions(pfl.positions, with_returns)
+ print " </inlined positions>\n"
+
+
+def PrintPortfolios(portfolios, with_returns=False):
+ for pfl in portfolios:
+ PrintPortfolio(pfl, with_returns)
+
+
+def ShowCallDetails(meth):
+ def wrap(*args, **kwargs):
+ print '@', meth.__name__, args[1:], kwargs
+ meth(*args, **kwargs)
+ return wrap
+
+
+class FinanceTester(object):
+
+ def __init__(self, email, password):
+ self.client = FinanceService(source='gdata-finance-test')
+ self.client.ClientLogin(email, password)
+
+ def GetPortfolios(self, with_returns=False, inline_positions=False):
+ query = PortfolioQuery()
+ query.returns = with_returns
+ query.positions = inline_positions
+ return self.client.GetPortfolioFeed(query=query).entry
+
+ def GetPositions(self, portfolio, with_returns=False, inline_transactions=False):
+ query = PositionQuery()
+ query.returns = with_returns
+ query.transactions = inline_transactions
+ return self.client.GetPositionFeed(portfolio, query=query).entry
+
+ def GetTransactions(self, position=None, portfolio=None, ticker=None):
+ if position:
+ feed = self.client.GetTransactionFeed(position)
+ elif portfolio and ticker:
+ feed = self.client.GetTransactionFeed(
+ portfolio_id=portfolio.portfolio_id, ticker_id=ticker)
+ return feed.entry
+
+ @ShowCallDetails
+ def TestShowDetails(self, with_returns=False, inline_positions=False,
+ inline_transactions=False):
+ portfolios = self.GetPortfolios(with_returns, inline_positions)
+ for pfl in portfolios:
+ PrintPortfolio(pfl, with_returns)
+ positions = self.GetPositions(pfl, with_returns, inline_transactions)
+ for pos in positions:
+ PrintPosition(pos, with_returns)
+ PrintTransactions(self.GetTransactions(pos))
+
+ def DeletePortfoliosByName(self, portfolio_titles):
+ for pfl in self.GetPortfolios():
+ if pfl.portfolio_title in portfolio_titles:
+ self.client.DeletePortfolio(pfl)
+
+ def AddPortfolio(self, portfolio_title, currency_code):
+ pfl = PortfolioEntry(portfolio_data=PortfolioData(
+ currency_code=currency_code))
+ pfl.portfolio_title = portfolio_title
+ return self.client.AddPortfolio(pfl)
+
+ def UpdatePortfolio(self, portfolio,
+ portfolio_title=None, currency_code=None):
+ if portfolio_title:
+ portfolio.portfolio_title = portfolio_title
+ if currency_code:
+ portfolio.portfolio_data.currency_code = currency_code
+ return self.client.UpdatePortfolio(portfolio)
+
+ def DeletePortfolio(self, portfolio):
+ self.client.DeletePortfolio(portfolio)
+
+ @ShowCallDetails
+ def TestManagePortfolios(self):
+ pfl_one = 'Portfolio Test: Emerging Markets 12345'
+ pfl_two = 'Portfolio Test: Renewable Energy 31415'
+
+ print '---- Deleting portfolios ----'
+ self.DeletePortfoliosByName([pfl_one, pfl_two])
+ PrintPortfolios(self.GetPortfolios())
+ print '---- Adding new portfolio ----'
+ pfl = self.AddPortfolio(pfl_one, 'SGD')
+ PrintPortfolios(self.GetPortfolios())
+ print '---- Changing portfolio title and currency code ----'
+ pfl = self.UpdatePortfolio(pfl, pfl_two, 'USD')
+ PrintPortfolios(self.GetPortfolios())
+ print '---- Deleting portfolio ----'
+ self.DeletePortfolio(pfl)
+ PrintPortfolios(self.GetPortfolios())
+
+ def Transact(self, type, portfolio, ticker, date=None, shares=None,
+ notes=None, price=None, commission=None, currency_code=None):
+ if price is not None:
+ price = Price(money=[Money(amount=str(price),
+ currency_code=currency_code or
+ portfolio.portfolio_data.currency_code)])
+ if commission is not None:
+ commission = Commission(money=[Money(amount=str(comission),
+ currency_code=currency_code or
+ portfolio.portfolio_data.currency_code)])
+ if date is not None and isinstance(date, datetime.datetime):
+ date = date.isoformat()
+ if shares is not None:
+ shares = str(shares)
+ txn = TransactionEntry(transaction_data=TransactionData(type=type,
+ date=date, shares=shares, notes=notes, price=price,
+ commission=commission))
+ return self.client.AddTransaction(txn,
+ portfolio_id=portfolio.portfolio_id, ticker_id=ticker)
+
+ def Buy(self, portfolio, ticker, **kwargs):
+ return self.Transact('Buy', portfolio, ticker, **kwargs)
+
+ def Sell(self, portfolio, ticker, **kwargs):
+ return self.Transact('Sell', portfolio, ticker, **kwargs)
+
+ def GetPosition(self, portfolio, ticker, with_returns=False, inline_transactions=False):
+ query = PositionQuery()
+ query.returns = with_returns
+ query.transactions = inline_transactions
+ return self.client.GetPosition(
+ portfolio_id=portfolio.portfolio_id, ticker_id=ticker, query=query)
+
+ def DeletePosition(self, position):
+ self.client.DeletePosition(position_entry=position)
+
+ def UpdateTransaction(self, transaction):
+ self.client.UpdateTransaction(transaction)
+
+ def DeleteTransaction(self, transaction):
+ self.client.DeleteTransaction(transaction)
+
+ @ShowCallDetails
+ def TestManageTransactions(self):
+ pfl_title = 'Transaction Test: Technology 27182'
+ self.DeletePortfoliosByName([pfl_title])
+
+ print '---- Adding new portfolio ----'
+ pfl = self.AddPortfolio(pfl_title, 'USD')
+ PrintPortfolios(self.GetPortfolios())
+
+ print '---- Adding buy transactions ----'
+ tkr1 = 'NASDAQ:GOOG'
+ date = datetime.datetime(2009,04,01)
+ days = datetime.timedelta(1)
+ txn1 = self.Buy(pfl, tkr1, shares=500, price=321.00, date=date)
+ txn2 = self.Buy(pfl, tkr1, shares=150, price=312.00, date=date+15*days)
+ pos = self.GetPosition(portfolio=pfl, ticker=tkr1, with_returns=True)
+ PrintPosition(pos, with_returns=True)
+ PrintTransactions(self.GetTransactions(pos))
+
+ print '---- Adding sell transactions ----'
+ txn3 = self.Sell(pfl, tkr1, shares=400, price=322.00, date=date+30*days)
+ txn4 = self.Sell(pfl, tkr1, shares=200, price=330.00, date=date+45*days)
+ pos = self.GetPosition(portfolio=pfl, ticker=tkr1, with_returns=True)
+ PrintPosition(pos, with_returns=True)
+ PrintTransactions(self.GetTransactions(pos))
+
+ print "---- Modifying first and deleting third ----"
+ txn1.transaction_data.shares = '400.0'
+ self.UpdateTransaction(txn1)
+ self.DeleteTransaction(txn3)
+ pos = self.GetPosition(portfolio=pfl, ticker=tkr1, with_returns=True)
+ PrintPosition(pos, with_returns=True)
+ PrintTransactions(self.GetTransactions(pos))
+
+ print "---- Deleting position ----"
+ print "Number of positions (before):", len(self.GetPositions(pfl))
+ self.DeletePosition(pos)
+ print "Number of positions (after) :", len(self.GetPositions(pfl))
+
+ print '---- Deleting portfolio ----'
+ self.DeletePortfolio(pfl)
+ PrintPortfolios(self.GetPortfolios())
+
+
+if __name__ == '__main__':
+ try:
+ email = sys.argv[1]
+ password = sys.argv[2]
+ cases = sys.argv[3:]
+ except IndexError:
+ print "Usage: test_finance account@google.com password [0 1 2...]"
+ sys.exit(1)
+
+ tester = FinanceTester(email, password)
+ tests = [
+ tester.TestShowDetails,
+ lambda: tester.TestShowDetails(with_returns=True),
+ tester.TestManagePortfolios,
+ tester.TestManageTransactions,
+ lambda: tester.TestShowDetails(with_returns=True, inline_positions=True),
+ lambda: tester.TestShowDetails(with_returns=True, inline_positions=True,
+ inline_transactions=True),]
+ if not cases:
+ cases = range(len(tests))
+ for i in cases:
+ print "===== TEST CASE", i, "="*50
+ tests[int(i)]()
diff --git a/samples/mashups/birthdaySample.py b/samples/mashups/birthdaySample.py
new file mode 100755
index 0000000..79f40df
--- /dev/null
+++ b/samples/mashups/birthdaySample.py
@@ -0,0 +1,343 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+#
+# This sample uses the Google Spreadsheets data API and the Google
+# Calendar data API. The script pulls a list of birthdays from a
+# Google Spreadsheet and inserts them as webContent events in the
+# user's Google Calendar.
+#
+# The script expects a certain format in the spreadsheet: Name,
+# Birthday, Photo URL, and Edit URL as headers. Expected format
+# of the birthday is: MM/DD. Edit URL is to be left blank by the
+# user - the script uses this column to determine whether to insert
+# a new event or to update an event at the URL.
+#
+# See the spreadsheet below for an example:
+# http://spreadsheets.google.com/pub?key=pfMX-JDVnx47J0DxqssIQHg
+#
+
+
+__author__ = 'api.stephaniel@google.com (Stephanie Liu)'
+
+try:
+ from xml.etree import ElementTree # for Python 2.5 users
+except:
+ from elementtree import ElementTree
+
+import gdata.spreadsheet.service
+import gdata.calendar.service
+import gdata.calendar
+import gdata.service
+import atom.service
+import gdata.spreadsheet
+import atom
+import string
+import time
+import datetime
+import getopt
+import getpass
+import sys
+
+
+class BirthdaySample:
+ # CONSTANTS: Expected column headers: name, birthday, photourl, editurl &
+ # default calendar reminder set to 2 days
+ NAME = "name"
+ BIRTHDAY = "birthday"
+ PHOTO_URL = "photourl"
+ EDIT_URL = "editurl"
+ REMINDER = 60 * 24 * 2 # minutes
+
+ def __init__(self, email, password):
+ """ Initializes spreadsheet and calendar clients.
+
+ Creates SpreadsheetsService and CalendarService objects and
+ authenticates to each with ClientLogin. For more information
+ about ClientLogin authentication:
+ http://code.google.com/apis/accounts/AuthForInstalledApps.html
+
+ Args:
+ email: string
+ password: string
+ """
+
+ self.s_client = gdata.spreadsheet.service.SpreadsheetsService()
+ self.s_client.email = email
+ self.s_client.password = password
+ self.s_client.source = 'exampleCo-birthdaySample-1'
+ self.s_client.ProgrammaticLogin()
+
+ self.c_client = gdata.calendar.service.CalendarService()
+ self.c_client.email = email
+ self.c_client.password = password
+ self.c_client.source = 'exampleCo-birthdaySample-1'
+ self.c_client.ProgrammaticLogin()
+
+ def _PrintFeed(self, feed):
+ """ Prints out Spreadsheet feeds in human readable format.
+
+ Generic function taken from spreadsheetsExample.py.
+
+ Args:
+ feed: SpreadsheetsCellsFeed, SpreadsheetsListFeed,
+ SpreadsheetsWorksheetsFeed, or SpreadsheetsSpreadsheetsFeed
+ """
+ for i, entry in enumerate(feed.entry):
+ if isinstance(feed, gdata.spreadsheet.SpreadsheetsCellsFeed):
+ print '%s %s\n' % (entry.title.text, entry.content.text)
+ elif isinstance(feed, gdata.spreadsheet.SpreadsheetsListFeed):
+ print '%s %s %s\n' % (i, entry.title.text, entry.content.text)
+ else:
+ print '%s %s\n' % (i, entry.title.text)
+
+ def _PromptForSpreadsheet(self):
+ """ Prompts user to select spreadsheet.
+
+ Gets and displays titles of all spreadsheets for user to
+ select. Generic function taken from spreadsheetsExample.py.
+
+ Args:
+ none
+
+ Returns:
+ spreadsheet ID that the user selected: string
+ """
+
+ feed = self.s_client.GetSpreadsheetsFeed()
+ self._PrintFeed(feed)
+ input = raw_input('\nSelection: ')
+
+ # extract and return the spreadsheet ID
+ return feed.entry[string.atoi(input)].id.text.rsplit('/', 1)[1]
+
+ def _PromptForWorksheet(self, key):
+ """ Prompts user to select desired worksheet.
+
+ Gets and displays titles of all worksheets for user to
+ select. Generic function taken from spreadsheetsExample.py.
+
+ Args:
+ key: string
+
+ Returns:
+ the worksheet ID that the user selected: string
+ """
+
+ feed = self.s_client.GetWorksheetsFeed(key)
+ self._PrintFeed(feed)
+ input = raw_input('\nSelection: ')
+
+ # extract and return the worksheet ID
+ return feed.entry[string.atoi(input)].id.text.rsplit('/', 1)[1]
+
+ def _AddReminder(self, event, minutes):
+ """ Adds a reminder to a calendar event.
+
+ This function sets the reminder attribute of the CalendarEventEntry.
+ The script sets it to 2 days by default, and this value is not
+ settable by the user. However, it can easily be changed to take this
+ option.
+
+ Args:
+ event: CalendarEventEntry
+ minutes: int
+
+ Returns:
+ the updated event: CalendarEventEntry
+ """
+
+ for a_when in event.when:
+ if len(a_when.reminder) > 0:
+ a_when.reminder[0].minutes = minutes
+ else:
+ a_when.reminder.append(gdata.calendar.Reminder(minutes=minutes))
+
+ return self.c_client.UpdateEvent(event.GetEditLink().href, event)
+
+ def _CreateBirthdayWebContentEvent(self, name, birthday, photo_url):
+ """ Create the birthday web content event.
+
+ This function creates and populates a CalendarEventEntry. webContent
+ specific attributes are set. To learn more about the webContent
+ format:
+
+ http://www.google.com/support/calendar/bin/answer.py?answer=48528
+
+ Args:
+ name: string
+ birthday: string - expected format (MM/DD)
+ photo_url: string
+
+ Returns:
+ the webContent CalendarEventEntry
+ """
+
+ title = "%s's Birthday!" % name
+ content = "It's %s's Birthday!" % name
+ month = string.atoi(birthday.split("/")[0])
+ day = string.atoi(birthday.split("/")[1])
+
+ # Get current year
+ year = time.ctime()[-4:]
+ year = string.atoi(year)
+
+ # Calculate the "end date" for the all day event
+ start_time = datetime.date(year, month, day)
+ one_day = datetime.timedelta(days=1)
+ end_time = start_time + one_day
+
+ start_time_str = start_time.strftime("%Y-%m-%d")
+ end_time_str = end_time.strftime("%Y-%m-%d")
+
+ # Create yearly recurrence rule
+ recurrence_data = ("DTSTART;VALUE=DATE:%s\r\n"
+ "DTEND;VALUE=DATE:%s\r\n"
+ "RRULE:FREQ=YEARLY;WKST=SU\r\n" %
+ (start_time.strftime("%Y%m%d"), end_time.strftime("%Y%m%d")))
+
+ web_rel = "http://schemas.google.com/gCal/2005/webContent"
+ icon_href = "http://www.perstephanie.com/images/birthdayicon.gif"
+ icon_type = "image/gif"
+ extension_text = (
+ 'gCal:webContent xmlns:gCal="http://schemas.google.com/gCal/2005"'
+ ' url="%s" width="300" height="225"' % (photo_url))
+
+ event = gdata.calendar.CalendarEventEntry()
+ event.title = atom.Title(text=title)
+ event.content = atom.Content(text=content)
+ event.recurrence = gdata.calendar.Recurrence(text=recurrence_data)
+ event.when.append(gdata.calendar.When(start_time=start_time_str,
+ end_time=end_time_str))
+
+ # Adding the webContent specific XML
+ event.link.append(atom.Link(rel=web_rel, title=title, href=icon_href,
+ link_type=icon_type))
+ event.link[0].extension_elements.append(
+ atom.ExtensionElement(extension_text))
+
+ return event
+
+ def _InsertBirthdayWebContentEvent(self, event):
+ """ Insert event into the authenticated user's calendar.
+
+ Args:
+ event: CalendarEventEntry
+
+ Returns:
+ the newly created CalendarEventEntry
+ """
+
+ edit_uri = '/calendar/feeds/default/private/full'
+ return self.c_client.InsertEvent(event, edit_uri)
+
+ def Run(self):
+ """ Run sample.
+
+ TODO: add exception handling
+
+ Args:
+ none
+ """
+
+ key_id = self._PromptForSpreadsheet()
+ wksht_id = self._PromptForWorksheet(key_id)
+
+ feed = self.s_client.GetListFeed(key_id, wksht_id)
+
+ found_name = False
+ found_birthday = False
+ found_photourl = False
+ found_editurl = False
+
+ # Check to make sure all headers are present
+ # Need to find at least one instance of name, birthday, photourl
+ # editurl
+ if len(feed.entry) > 0:
+ for name, custom in feed.entry[0].custom.iteritems():
+ if custom.column == self.NAME:
+ found_name = True
+ elif custom.column == self.BIRTHDAY:
+ found_birthday = True
+ elif custom.column == self.PHOTO_URL:
+ found_photourl = True
+ elif custom.column == self.EDIT_URL:
+ found_editurl = True
+
+ if not found_name and found_birthday and found_photourl and found_editurl:
+ print ("ERROR - Unexpected number of column headers. Should have: %s,"
+ " %s, %s, and %s." % (self.NAME, self.BIRTHDAY, self.PHOTO_URL,
+ self.EDIT_URL))
+ sys.exit(1)
+
+ # For every row in the spreadsheet, grab all the data and either insert
+ # a new event into the calendar, or update the existing event
+
+ # Create dict to represent the row data to update edit link back to
+ # Spreadsheet
+
+ for entry in feed.entry:
+ d = {}
+ input_valid = True
+
+ for name, custom in entry.custom.iteritems():
+ d[custom.column] = custom.text
+
+ month = int(d[self.BIRTHDAY].split("/")[0])
+ day = int(d[self.BIRTHDAY].split("/")[1])
+
+ # Some input checking. Script will allow the insert to continue with
+ # a missing name value.
+ if d[self.NAME] is None:
+ d[self.NAME] = " "
+ if d[self.PHOTO_URL] is None:
+ input_valid = False
+ if d[self.BIRTHDAY] is None:
+ input_valid = False
+ elif not 1 <= month <= 12 or not 1 <= day <= 31:
+ input_valid = False
+
+ if d[self.EDIT_URL] is None and input_valid:
+ event = self._CreateBirthdayWebContentEvent(d[self.NAME],
+ d[self.BIRTHDAY], d[self.PHOTO_URL])
+ event = self._InsertBirthdayWebContentEvent(event)
+ event = self._AddReminder(event, self.REMINDER)
+ print "Added %s's birthday!" % d[self.NAME]
+ elif input_valid: # Event already exists
+ edit_link = d[self.EDIT_URL]
+ event = self._CreateBirthdayWebContentEvent(d[self.NAME],
+ d[self.BIRTHDAY], d[self.PHOTO_URL])
+ event = self.c_client.UpdateEvent(edit_link, event)
+ event = self._AddReminder(event, self.REMINDER)
+ print "Updated %s's birthday!" % d[self.NAME]
+
+ if input_valid:
+ d[self.EDIT_URL] = event.GetEditLink().href
+ self.s_client.UpdateRow(entry, d)
+ else:
+ print "Warning - Skipping row, missing valid input."
+
+def main():
+ email = raw_input("Please enter your email: ")
+ password = getpass.getpass("Please enter your password: ")
+
+ sample = BirthdaySample(email, password)
+ sample.Run()
+
+
+if __name__ == '__main__':
+ main()
+
diff --git a/samples/oauth/2_legged_oauth.py b/samples/oauth/2_legged_oauth.py
new file mode 100755
index 0000000..0147ea1
--- /dev/null
+++ b/samples/oauth/2_legged_oauth.py
@@ -0,0 +1,72 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'e.bidelman (Eric Bidelman)'
+
+import gdata.contacts
+import gdata.contacts.service
+import gdata.docs
+import gdata.docs.service
+
+
+CONSUMER_KEY = 'yourdomain.com'
+CONSUMER_SECRET = 'YOUR_CONSUMER_KEY'
+SIG_METHOD = gdata.auth.OAuthSignatureMethod.HMAC_SHA1
+
+requestor_id = 'any.user@yourdomain.com'
+
+# Contacts Data API ============================================================
+contacts = gdata.contacts.service.ContactsService()
+contacts.SetOAuthInputParameters(
+ SIG_METHOD, CONSUMER_KEY, consumer_secret=CONSUMER_SECRET,
+ two_legged_oauth=True, requestor_id=requestor_id)
+
+# GET - fetch user's contact list
+print "\nList of contacts for %s:" % (requestor_id,)
+feed = contacts.GetContactsFeed()
+for entry in feed.entry:
+ print entry.title.text
+
+# GET - fetch another user's contact list
+requestor_id = 'another_user@yourdomain.com'
+print "\nList of contacts for %s:" % (requestor_id,)
+contacts.GetOAuthInputParameters().requestor_id = requestor_id
+feed = contacts.GetContactsFeed()
+for entry in feed.entry:
+ print entry.title.text
+
+
+# Google Documents List Data API ===============================================
+docs = gdata.docs.service.DocsService()
+docs.SetOAuthInputParameters(
+ SIG_METHOD, CONSUMER_KEY, consumer_secret=CONSUMER_SECRET,
+ two_legged_oauth=True, requestor_id=requestor_id)
+
+# POST - upload a document
+print "\nUploading document to %s's Google Documents account:" % (requestor_id,)
+ms = gdata.MediaSource(
+ file_path='/path/to/test.txt',
+ content_type=gdata.docs.service.SUPPORTED_FILETYPES['TXT'])
+
+# GET - fetch user's document list
+entry = docs.UploadDocument(ms, 'Company Perks')
+print 'Document now accessible online at:', entry.GetAlternateLink().href
+
+print "\nList of Google Documents for %s" % (requestor_id,)
+feed = docs.GetDocumentListFeed()
+for entry in feed.entry:
+ print entry.title.text
diff --git a/samples/oauth/TwoLeggedOAuthExample.py b/samples/oauth/TwoLeggedOAuthExample.py
new file mode 100755
index 0000000..0334425
--- /dev/null
+++ b/samples/oauth/TwoLeggedOAuthExample.py
@@ -0,0 +1,69 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Note:
+# This sample demonstrates 2 Legged OAuth using v2 of the Google Data APIs.
+# See 2_legged_oauth.py for an example of using 2LO with v1.0 of the APIs.
+
+__author__ = 'e.bidelman (Eric Bidelman)'
+
+import gdata.gauth
+import gdata.contacts.client
+import gdata.docs.client
+
+SOURCE_APP_NAME = 'google-PyClient2LOSample-v2.0'
+
+CONSUMER_KEY = 'yourdomain.com'
+CONSUMER_SECRET = 'YOUR_CONSUMER_KEY'
+
+def PrintContacts(client):
+ print '\nListing contacts for %s...' % client.auth_token.requestor_id
+ feed = client.GetContacts()
+ for entry in feed.entry:
+ print entry.title.text
+
+
+# Contacts Data API Example ====================================================
+requestor_id = 'any.user@' + CONSUMER_KEY
+two_legged_oauth_token = gdata.gauth.TwoLeggedOAuthHmacToken(
+ CONSUMER_KEY, CONSUMER_SECRET, requestor_id)
+
+contacts_client = gdata.contacts.client.ContactsClient(source=SOURCE_APP_NAME)
+contacts_client.auth_token = two_legged_oauth_token
+
+# GET - fetch user's contact list
+PrintContacts(contacts_client)
+
+# GET - fetch another user's contact list
+contacts_client.auth_token.requestor_id = 'different.user' + CONSUMER_KEY
+PrintContacts(contacts_client)
+
+
+# Documents List Data API Example ==============================================
+docs_client = gdata.docs.client.DocsClient(source=SOURCE_APP_NAME)
+docs_client.auth_token = two_legged_oauth_token
+docs_client.ssl = True
+
+# POST - upload a document
+print "\nUploading doc to %s's account..." % docs_client.auth_token.requestor_id
+entry = docs_client.Upload('test.txt', 'MyDocTitle', content_type='text/plain')
+print 'Document now accessible online at:', entry.GetAlternateLink().href
+
+# GET - fetch the user's document list
+print '\nListing Google Docs for %s...' % docs_client.auth_token.requestor_id
+feed = docs_client.GetDocList()
+for entry in feed.entry:
+ print entry.title.text
diff --git a/samples/oauth/oauth_example.py b/samples/oauth/oauth_example.py
new file mode 100755
index 0000000..c5884b0
--- /dev/null
+++ b/samples/oauth/oauth_example.py
@@ -0,0 +1,125 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'kunalmshah.userid (Kunal Shah)'
+
+import sys
+import os.path
+import getopt
+import gdata.auth
+import gdata.docs.service
+
+
+class OAuthSample(object):
+ """Sample class demonstrating the three-legged OAuth process."""
+
+ def __init__(self, consumer_key, consumer_secret):
+ """Constructor for the OAuthSample object.
+
+ Takes a consumer key and consumer secret, store them in class variables,
+ creates a DocsService client to be used to make calls to
+ the Documents List Data API.
+
+ Args:
+ consumer_key: string Domain identifying third_party web application.
+ consumer_secret: string Secret generated during registration.
+ """
+ self.consumer_key = consumer_key
+ self.consumer_secret = consumer_secret
+ self.gd_client = gdata.docs.service.DocsService()
+
+ def _PrintFeed(self, feed):
+ """Prints out the contents of a feed to the console.
+
+ Args:
+ feed: A gdata.docs.DocumentListFeed instance.
+ """
+ if not feed.entry:
+ print 'No entries in feed.\n'
+
+ docs_list = list(enumerate(feed.entry, start = 1))
+ for i, entry in docs_list:
+ print '%d. %s\n' % (i, entry.title.text.encode('UTF-8'))
+
+ def _ListAllDocuments(self):
+ """Retrieves a list of all of a user's documents and displays them."""
+ feed = self.gd_client.GetDocumentListFeed()
+ self._PrintFeed(feed)
+
+ def Run(self):
+ """Demonstrates usage of OAuth authentication mode and retrieves a list of
+ documents using the Document List Data API."""
+ print '\nSTEP 1: Set OAuth input parameters.'
+ self.gd_client.SetOAuthInputParameters(
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1,
+ self.consumer_key, consumer_secret=self.consumer_secret)
+ print '\nSTEP 2: Fetch OAuth Request token.'
+ request_token = self.gd_client.FetchOAuthRequestToken()
+ print 'Request Token fetched: %s' % request_token
+ print '\nSTEP 3: Set the fetched OAuth token.'
+ self.gd_client.SetOAuthToken(request_token)
+ print 'OAuth request token set.'
+ print '\nSTEP 4: Generate OAuth authorization URL.'
+ auth_url = self.gd_client.GenerateOAuthAuthorizationURL()
+ print 'Authorization URL: %s' % auth_url
+ raw_input('Manually go to the above URL and authenticate.'
+ 'Press a key after authorization.')
+ print '\nSTEP 5: Upgrade to an OAuth access token.'
+ self.gd_client.UpgradeToOAuthAccessToken()
+ print 'Access Token: %s' % (
+ self.gd_client.token_store.find_token(request_token.scopes[0]))
+ print '\nYour Documents:\n'
+ self._ListAllDocuments()
+ print 'STEP 6: Revoke the OAuth access token after use.'
+ self.gd_client.RevokeOAuthToken()
+ print 'OAuth access token revoked.'
+
+
+def main():
+ """Demonstrates usage of OAuth authentication mode.
+
+ Prints a list of documents. This demo uses HMAC-SHA1 signature method.
+ """
+ # Parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['consumer_key=',
+ 'consumer_secret='])
+ except getopt.error, msg:
+ print ('python oauth_example.py --consumer_key [consumer_key] '
+ '--consumer_secret [consumer_secret] ')
+ sys.exit(2)
+
+ consumer_key = ''
+ consumer_secret = ''
+ # Process options
+ for option, arg in opts:
+ if option == '--consumer_key':
+ consumer_key = arg
+ elif option == '--consumer_secret':
+ consumer_secret = arg
+
+ while not consumer_key:
+ consumer_key = raw_input('Please enter consumer key: ')
+ while not consumer_secret:
+ consumer_secret = raw_input('Please enter consumer secret: ')
+
+ sample = OAuthSample(consumer_key, consumer_secret)
+ sample.Run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/oauth/oauth_on_appengine/README.txt b/samples/oauth/oauth_on_appengine/README.txt
new file mode 100644
index 0000000..041304e
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/README.txt
@@ -0,0 +1,32 @@
+NOTE:
+main_hmac.py and main_rsa.py are the same sample. The difference is the signature method used.
+Both samples require that you register your web application to obtain a consumer key/secret.
+
+
+To run main_hmac.py:
+
+ - Register your web application as described here:
+ http://code.google.com/apis/accounts/docs/RegistrationForWebAppsAuto.html
+
+ - In main_hmac.py, change SETTINGs['CONSUMER_KEY'] and SETTINGs['CONSUMER_SECRET']
+ to your own values provided in https://www.google.com/accounts/ManageDomains
+
+
+To run main_rsa.py:
+
+ - change 'main_hmac.py' to 'main_rsa.py' in app.yaml
+
+ - Generate a self signing private key/certificate pair as described here:
+ http://code.google.com/apis/gdata/oauth.html#GeneratingKeyCert
+
+ - Register your web application as described here:
+ http://code.google.com/apis/accounts/docs/RegistrationForWebAppsAuto.html
+
+ Use https://www.google.com/accounts/ManageDomains to upload your certicate file.
+
+ - In main_rsa.py, change the f = open('/path/to/your/rsa_private_key.pem') line
+ to point to your .pem generated from the previous step. Make sure the file is
+ readable by your webserver.
+
+ Also change SETTINGs['CONSUMER_KEY'] to your own value found in
+ https://www.google.com/accounts/ManageDomains. This value is typically your domain.
diff --git a/samples/oauth/oauth_on_appengine/app.yaml b/samples/oauth/oauth_on_appengine/app.yaml
new file mode 100644
index 0000000..660de5d
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/app.yaml
@@ -0,0 +1,17 @@
+application: oauth
+version: 1
+runtime: python
+api_version: 1
+
+handlers:
+- url: /css
+ static_dir: css
+
+- url: /images
+ static_dir: images
+
+- url: /js
+ static_dir: js
+
+- url: /.*
+ script: main_hmac.py
diff --git a/samples/oauth/oauth_on_appengine/appengine_utilities/__init__.py b/samples/oauth/oauth_on_appengine/appengine_utilities/__init__.py
new file mode 100755
index 0000000..e69de29
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/appengine_utilities/__init__.py
diff --git a/samples/oauth/oauth_on_appengine/appengine_utilities/cache.py b/samples/oauth/oauth_on_appengine/appengine_utilities/cache.py
new file mode 100755
index 0000000..f8ec04f
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/appengine_utilities/cache.py
@@ -0,0 +1,277 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+# main python imports
+import datetime
+import pickle
+import random
+import __main__
+
+# google appengine import
+from google.appengine.ext import db
+from google.appengine.api import memcache
+
+# settings
+DEFAULT_TIMEOUT = 3600 # cache expires after one hour (3600 sec)
+CLEAN_CHECK_PERCENT = 50 # 15% of all requests will clean the database
+MAX_HITS_TO_CLEAN = 100 # the maximum number of cache hits to clean on attempt
+
+
+class _AppEngineUtilities_Cache(db.Model):
+ # It's up to the application to determine the format of their keys
+ cachekey = db.StringProperty()
+ createTime = db.DateTimeProperty(auto_now_add=True)
+ timeout = db.DateTimeProperty()
+ value = db.BlobProperty()
+
+
+class Cache(object):
+ """
+ Cache is used for storing pregenerated output and/or objects in the Big
+ Table datastore to minimize the amount of queries needed for page
+ displays. The idea is that complex queries that generate the same
+ results really should only be run once. Cache can be used to store
+ pregenerated value made from queries (or other calls such as
+ urlFetch()), or the query objects themselves.
+ """
+
+ def __init__(self, clean_check_percent = CLEAN_CHECK_PERCENT,
+ max_hits_to_clean = MAX_HITS_TO_CLEAN,
+ default_timeout = DEFAULT_TIMEOUT):
+ """
+ Initializer
+
+ Args:
+ clean_check_percent: how often cache initialization should
+ run the cache cleanup
+ max_hits_to_clean: maximum number of stale hits to clean
+ default_timeout: default length a cache item is good for
+ """
+ self.clean_check_percent = clean_check_percent
+ self.max_hits_to_clean = max_hits_to_clean
+ self.default_timeout = default_timeout
+
+ if random.randint(1, 100) < self.clean_check_percent:
+ self._clean_cache()
+
+ if 'AEU_Events' in __main__.__dict__:
+ __main__.AEU_Events.fire_event('cacheInitialized')
+
+ def _clean_cache(self):
+ """
+ _clean_cache is a routine that is run to find and delete cache
+ items that are old. This helps keep the size of your over all
+ datastore down.
+ """
+ query = _AppEngineUtilities_Cache.all()
+ query.filter('timeout < ', datetime.datetime.now())
+ results = query.fetch(self.max_hits_to_clean)
+ db.delete(results)
+ #for result in results:
+ # result.delete()
+
+ def _validate_key(self, key):
+ if key == None:
+ raise KeyError
+
+ def _validate_value(self, value):
+ if value == None:
+ raise ValueError
+
+ def _validate_timeout(self, timeout):
+ if timeout == None:
+ timeout = datetime.datetime.now() +\
+ datetime.timedelta(seconds=DEFAULT_TIMEOUT)
+ if type(timeout) == type(1):
+ timeout = datetime.datetime.now() + \
+ datetime.timedelta(seconds = timeout)
+ if type(timeout) != datetime.datetime:
+ raise TypeError
+ if timeout < datetime.datetime.now():
+ raise ValueError
+
+ return timeout
+
+ def add(self, key = None, value = None, timeout = None):
+ """
+ add adds an entry to the cache, if one does not already
+ exist.
+ """
+ self._validate_key(key)
+ self._validate_value(value)
+ timeout = self._validate_timeout(timeout)
+
+ if key in self:
+ raise KeyError
+
+ cacheEntry = _AppEngineUtilities_Cache()
+ cacheEntry.cachekey = key
+ cacheEntry.value = pickle.dumps(value)
+ cacheEntry.timeout = timeout
+
+ # try to put the entry, if it fails silently pass
+ # failures may happen due to timeouts, the datastore being read
+ # only for maintenance or other applications. However, cache
+ # not being able to write to the datastore should not
+ # break the application
+ try:
+ cacheEntry.put()
+ except:
+ pass
+
+ memcache_timeout = timeout - datetime.datetime.now()
+ memcache.set('cache-'+key, value, int(memcache_timeout.seconds))
+
+ if 'AEU_Events' in __main__.__dict__:
+ __main__.AEU_Events.fire_event('cacheAdded')
+
+ def set(self, key = None, value = None, timeout = None):
+ """
+ add adds an entry to the cache, overwriting an existing value
+ if one already exists.
+ """
+ self._validate_key(key)
+ self._validate_value(value)
+ timeout = self._validate_timeout(timeout)
+
+ cacheEntry = self._read(key)
+ if not cacheEntry:
+ cacheEntry = _AppEngineUtilities_Cache()
+ cacheEntry.cachekey = key
+ cacheEntry.value = pickle.dumps(value)
+ cacheEntry.timeout = timeout
+
+ try:
+ cacheEntry.put()
+ except:
+ pass
+
+ memcache_timeout = timeout - datetime.datetime.now()
+ memcache.set('cache-'+key, value, int(memcache_timeout.seconds))
+
+ if 'AEU_Events' in __main__.__dict__:
+ __main__.AEU_Events.fire_event('cacheSet')
+
+ def _read(self, key = None):
+ """
+ _read returns a cache object determined by the key. It's set
+ to private because it returns a db.Model object, and also
+ does not handle the unpickling of objects making it not the
+ best candidate for use. The special method __getitem__ is the
+ preferred access method for cache data.
+ """
+ query = _AppEngineUtilities_Cache.all()
+ query.filter('cachekey', key)
+ query.filter('timeout > ', datetime.datetime.now())
+ results = query.fetch(1)
+ if len(results) is 0:
+ return None
+ return results[0]
+
+ if 'AEU_Events' in __main__.__dict__:
+ __main__.AEU_Events.fire_event('cacheReadFromDatastore')
+ if 'AEU_Events' in __main__.__dict__:
+ __main__.AEU_Events.fire_event('cacheRead')
+
+ def delete(self, key = None):
+ """
+ Deletes a cache object determined by the key.
+ """
+ memcache.delete('cache-'+key)
+ result = self._read(key)
+ if result:
+ if 'AEU_Events' in __main__.__dict__:
+ __main__.AEU_Events.fire_event('cacheDeleted')
+ result.delete()
+
+ def get(self, key):
+ """
+ get is used to return the cache value associated with the key passed.
+ """
+ mc = memcache.get('cache-'+key)
+ if mc:
+ if 'AEU_Events' in __main__.__dict__:
+ __main__.AEU_Events.fire_event('cacheReadFromMemcache')
+ if 'AEU_Events' in __main__.__dict__:
+ __main__.AEU_Events.fire_event('cacheRead')
+ return mc
+ result = self._read(key)
+ if result:
+ timeout = result.timeout - datetime.datetime.now()
+ # print timeout.seconds
+ memcache.set('cache-'+key, pickle.loads(result.value),
+ int(timeout.seconds))
+ return pickle.loads(result.value)
+ else:
+ raise KeyError
+
+ def get_many(self, keys):
+ """
+ Returns a dict mapping each key in keys to its value. If the given
+ key is missing, it will be missing from the response dict.
+ """
+ dict = {}
+ for key in keys:
+ value = self.get(key)
+ if value is not None:
+ dict[key] = val
+ return dict
+
+ def __getitem__(self, key):
+ """
+ __getitem__ is necessary for this object to emulate a container.
+ """
+ return self.get(key)
+
+ def __setitem__(self, key, value):
+ """
+ __setitem__ is necessary for this object to emulate a container.
+ """
+ return self.set(key, value)
+
+ def __delitem__(self, key):
+ """
+ Implement the 'del' keyword
+ """
+ return self.delete(key)
+
+ def __contains__(self, key):
+ """
+ Implements "in" operator
+ """
+ try:
+ r = self.__getitem__(key)
+ except KeyError:
+ return False
+ return True
+
+ def has_key(self, keyname):
+ """
+ Equivalent to k in a, use that form in new code
+ """
+ return self.__contains__(keyname)
diff --git a/samples/oauth/oauth_on_appengine/appengine_utilities/cron.py b/samples/oauth/oauth_on_appengine/appengine_utilities/cron.py
new file mode 100755
index 0000000..a32835b
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/appengine_utilities/cron.py
@@ -0,0 +1,498 @@
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+import os
+import cgi
+import re
+import datetime
+import pickle
+from google.appengine.ext import db
+from google.appengine.api import urlfetch
+from google.appengine.api import memcache
+
+APPLICATION_PORT = '8080'
+CRON_PORT = '8081'
+
+class _AppEngineUtilities_Cron(db.Model):
+ """
+ Model for the tasks in the datastore. This contains the scheduling and
+ url information, as well as a field that sets the next time the instance
+ should run.
+ """
+
+ cron_entry = db.StringProperty()
+ next_run = db.DateTimeProperty()
+ cron_compiled = db.BlobProperty()
+ url = db.LinkProperty()
+
+class Cron(object):
+ """
+ Cron is a scheduling utility built for appengine, modeled after
+ crontab for unix systems. While true scheduled tasks are not
+ possible within the Appengine environment currently, this
+ is an attmempt to provide a request based alternate. You
+ configure the tasks in an included interface, and the import
+ the class on any request you want capable of running tasks.
+
+ On each request where Cron is imported, the list of tasks
+ that need to be run will be pulled and run. A task is a url
+ within your application. It's important to make sure that these
+ requests fun quickly, or you could risk timing out the actual
+ request.
+
+ See the documentation for more information on configuring
+ your application to support Cron and setting up tasks.
+ """
+
+ def __init__(self):
+ # Check if any tasks need to be run
+ query = _AppEngineUtilities_Cron.all()
+ query.filter('next_run <= ', datetime.datetime.now())
+ results = query.fetch(1000)
+ if len(results) > 0:
+ one_second = datetime.timedelta(seconds = 1)
+ before = datetime.datetime.now()
+ for r in results:
+ if re.search(':' + APPLICATION_PORT, r.url):
+ r.url = re.sub(':' + APPLICATION_PORT, ':' + CRON_PORT, r.url)
+ #result = urlfetch.fetch(r.url)
+ diff = datetime.datetime.now() - before
+ if int(diff.seconds) < 1:
+ if memcache.add(str(r.key), "running"):
+ result = urlfetch.fetch(r.url)
+ r.next_run = self._get_next_run(pickle.loads(r.cron_compiled))
+ r.put()
+ memcache.delete(str(r.key))
+ else:
+ break
+
+ def add_cron(self, cron_string):
+ cron = cron_string.split(" ")
+ if len(cron) is not 6:
+ raise ValueError, 'Invalid cron string. Format: * * * * * url'
+ cron = {
+ 'min': cron[0],
+ 'hour': cron[1],
+ 'day': cron[2],
+ 'mon': cron[3],
+ 'dow': cron[4],
+ 'url': cron[5],
+ }
+ cron_compiled = self._validate_cron(cron)
+ next_run = self._get_next_run(cron_compiled)
+ cron_entry = _AppEngineUtilities_Cron()
+ cron_entry.cron_entry = cron_string
+ cron_entry.next_run = next_run
+ cron_entry.cron_compiled = pickle.dumps(cron_compiled)
+ cron_entry.url = cron["url"]
+ cron_entry.put()
+
+ def _validate_cron(self, cron):
+ """
+ Parse the field to determine whether it is an integer or lists,
+ also converting strings to integers where necessary. If passed bad
+ values, raises a ValueError.
+ """
+ parsers = {
+ 'dow': self._validate_dow,
+ 'mon': self._validate_mon,
+ 'day': self._validate_day,
+ 'hour': self._validate_hour,
+ 'min': self._validate_min,
+ 'url': self. _validate_url,
+ }
+ for el in cron:
+ parse = parsers[el]
+ cron[el] = parse(cron[el])
+ return cron
+
+ def _validate_type(self, v, t):
+ """
+ Validates that the number (v) passed is in the correct range for the
+ type (t). Raise ValueError, if validation fails.
+
+ Valid ranges:
+ day of week = 0-7
+ month = 1-12
+ day = 1-31
+ hour = 0-23
+ minute = 0-59
+
+ All can * which will then return the range for that entire type.
+ """
+ if t == "dow":
+ if v >= 0 and v <= 7:
+ return [v]
+ elif v == "*":
+ return "*"
+ else:
+ raise ValueError, "Invalid day of week."
+ elif t == "mon":
+ if v >= 1 and v <= 12:
+ return [v]
+ elif v == "*":
+ return range(1, 12)
+ else:
+ raise ValueError, "Invalid month."
+ elif t == "day":
+ if v >= 1 and v <= 31:
+ return [v]
+ elif v == "*":
+ return range(1, 31)
+ else:
+ raise ValueError, "Invalid day."
+ elif t == "hour":
+ if v >= 0 and v <= 23:
+ return [v]
+ elif v == "*":
+ return range(0, 23)
+ else:
+ raise ValueError, "Invalid hour."
+ elif t == "min":
+ if v >= 0 and v <= 59:
+ return [v]
+ elif v == "*":
+ return range(0, 59)
+ else:
+ raise ValueError, "Invalid minute."
+
+ def _validate_list(self, l, t):
+ """
+ Validates a crontab list. Lists are numerical values seperated
+ by a comma with no spaces. Ex: 0,5,10,15
+
+ Arguments:
+ l: comma seperated list of numbers
+ t: type used for validation, valid values are
+ dow, mon, day, hour, min
+ """
+ elements = l.split(",")
+ return_list = []
+ # we have a list, validate all of them
+ for e in elements:
+ if "-" in e:
+ return_list.extend(self._validate_range(e, t))
+ else:
+ try:
+ v = int(e)
+ self._validate_type(v, t)
+ return_list.append(v)
+ except:
+ raise ValueError, "Names are not allowed in lists."
+ # return a list of integers
+ return return_list
+
+ def _validate_range(self, r, t):
+ """
+ Validates a crontab range. Ranges are 2 numerical values seperated
+ by a dash with no spaces. Ex: 0-10
+
+ Arguments:
+ r: dash seperated list of 2 numbers
+ t: type used for validation, valid values are
+ dow, mon, day, hour, min
+ """
+ elements = r.split('-')
+ # a range should be 2 elements
+ if len(elements) is not 2:
+ raise ValueError, "Invalid range passed: " + str(r)
+ # validate the minimum and maximum are valid for the type
+ for e in elements:
+ self._validate_type(int(e), t)
+ # return a list of the numbers in the range.
+ # +1 makes sure the end point is included in the return value
+ return range(int(elements[0]), int(elements[1]) + 1)
+
+ def _validate_step(self, s, t):
+ """
+ Validates a crontab step. Steps are complicated. They can
+ be based on a range 1-10/2 or just step through all valid
+ */2. When parsing times you should always check for step first
+ and see if it has a range or not, before checking for ranges because
+ this will handle steps of ranges returning the final list. Steps
+ of lists is not supported.
+
+ Arguments:
+ s: slash seperated string
+ t: type used for validation, valid values are
+ dow, mon, day, hour, min
+ """
+ elements = s.split('/')
+ # a range should be 2 elements
+ if len(elements) is not 2:
+ raise ValueError, "Invalid step passed: " + str(s)
+ try:
+ step = int(elements[1])
+ except:
+ raise ValueError, "Invalid step provided " + str(s)
+ r_list = []
+ # if the first element is *, use all valid numbers
+ if elements[0] is "*" or elements[0] is "":
+ r_list.extend(self._validate_type('*', t))
+ # check and see if there is a list of ranges
+ elif "," in elements[0]:
+ ranges = elements[0].split(",")
+ for r in ranges:
+ # if it's a range, we need to manage that
+ if "-" in r:
+ r_list.extend(self._validate_range(r, t))
+ else:
+ try:
+ r_list.extend(int(r))
+ except:
+ raise ValueError, "Invalid step provided " + str(s)
+ elif "-" in elements[0]:
+ r_list.extend(self._validate_range(elements[0], t))
+ return range(r_list[0], r_list[-1] + 1, step)
+
+ def _validate_dow(self, dow):
+ """
+ """
+ # if dow is * return it. This is for date parsing where * does not mean
+ # every day for crontab entries.
+ if dow is "*":
+ return dow
+ days = {
+ 'mon': 1,
+ 'tue': 2,
+ 'wed': 3,
+ 'thu': 4,
+ 'fri': 5,
+ 'sat': 6,
+ # per man crontab sunday can be 0 or 7.
+ 'sun': [0, 7],
+ }
+ if dow in days:
+ dow = days[dow]
+ return [dow]
+ # if dow is * return it. This is for date parsing where * does not mean
+ # every day for crontab entries.
+ elif dow is "*":
+ return dow
+ elif "/" in dow:
+ return(self._validate_step(dow, "dow"))
+ elif "," in dow:
+ return(self._validate_list(dow, "dow"))
+ elif "-" in dow:
+ return(self._validate_range(dow, "dow"))
+ else:
+ valid_numbers = range(0, 8)
+ if not int(dow) in valid_numbers:
+ raise ValueError, "Invalid day of week " + str(dow)
+ else:
+ return [int(dow)]
+
+ def _validate_mon(self, mon):
+ months = {
+ 'jan': 1,
+ 'feb': 2,
+ 'mar': 3,
+ 'apr': 4,
+ 'may': 5,
+ 'jun': 6,
+ 'jul': 7,
+ 'aug': 8,
+ 'sep': 9,
+ 'oct': 10,
+ 'nov': 11,
+ 'dec': 12,
+ }
+ if mon in months:
+ mon = months[mon]
+ return [mon]
+ elif mon is "*":
+ return range(1, 13)
+ elif "/" in mon:
+ return(self._validate_step(mon, "mon"))
+ elif "," in mon:
+ return(self._validate_list(mon, "mon"))
+ elif "-" in mon:
+ return(self._validate_range(mon, "mon"))
+ else:
+ valid_numbers = range(1, 13)
+ if not int(mon) in valid_numbers:
+ raise ValueError, "Invalid month " + str(mon)
+ else:
+ return [int(mon)]
+
+ def _validate_day(self, day):
+ if day is "*":
+ return range(1, 32)
+ elif "/" in day:
+ return(self._validate_step(day, "day"))
+ elif "," in day:
+ return(self._validate_list(day, "day"))
+ elif "-" in day:
+ return(self._validate_range(day, "day"))
+ else:
+ valid_numbers = range(1, 31)
+ if not int(day) in valid_numbers:
+ raise ValueError, "Invalid day " + str(day)
+ else:
+ return [int(day)]
+
+ def _validate_hour(self, hour):
+ if hour is "*":
+ return range(0, 24)
+ elif "/" in hour:
+ return(self._validate_step(hour, "hour"))
+ elif "," in hour:
+ return(self._validate_list(hour, "hour"))
+ elif "-" in hour:
+ return(self._validate_range(hour, "hour"))
+ else:
+ valid_numbers = range(0, 23)
+ if not int(hour) in valid_numbers:
+ raise ValueError, "Invalid hour " + str(hour)
+ else:
+ return [int(hour)]
+
+ def _validate_min(self, min):
+ if min is "*":
+ return range(0, 60)
+ elif "/" in min:
+ return(self._validate_step(min, "min"))
+ elif "," in min:
+ return(self._validate_list(min, "min"))
+ elif "-" in min:
+ return(self._validate_range(min, "min"))
+ else:
+ valid_numbers = range(0, 59)
+ if not int(min) in valid_numbers:
+ raise ValueError, "Invalid min " + str(min)
+ else:
+ return [int(min)]
+
+ def _validate_url(self, url):
+ # kludge for issue 842, right now we use request headers
+ # to set the host.
+ if url[0] is not "/":
+ url = "/" + url
+ url = 'http://' + str(os.environ['HTTP_HOST']) + url
+ return url
+ # content below is for when that issue gets fixed
+ #regex = re.compile("^(http|https):\/\/([a-z0-9-]\.+)*", re.IGNORECASE)
+ #if regex.match(url) is not None:
+ # return url
+ #else:
+ # raise ValueError, "Invalid url " + url
+
+ def _calc_month(self, next_run, cron):
+ while True:
+ if cron["mon"][-1] < next_run.month:
+ next_run = next_run.replace(year=next_run.year+1, \
+ month=cron["mon"][0], \
+ day=1,hour=0,minute=0)
+ else:
+ if next_run.month in cron["mon"]:
+ return next_run
+ else:
+ one_month = datetime.timedelta(months=1)
+ next_run = next_run + one_month
+
+ def _calc_day(self, next_run, cron):
+ # start with dow as per cron if dow and day are set
+ # then dow is used if it comes before day. If dow
+ # is *, then ignore it.
+ if str(cron["dow"]) != str("*"):
+ # convert any integers to lists in order to easily compare values
+ m = next_run.month
+ while True:
+ if next_run.month is not m:
+ next_run = next_run.replace(hour=0, minute=0)
+ next_run = self._calc_month(next_run, cron)
+ if next_run.weekday() in cron["dow"] or next_run.day in cron["day"]:
+ return next_run
+ else:
+ one_day = datetime.timedelta(days=1)
+ next_run = next_run + one_day
+ else:
+ m = next_run.month
+ while True:
+ if next_run.month is not m:
+ next_run = next_run.replace(hour=0, minute=0)
+ next_run = self._calc_month(next_run, cron)
+ # if cron["dow"] is next_run.weekday() or cron["day"] is next_run.day:
+ if next_run.day in cron["day"]:
+ return next_run
+ else:
+ one_day = datetime.timedelta(days=1)
+ next_run = next_run + one_day
+
+ def _calc_hour(self, next_run, cron):
+ m = next_run.month
+ d = next_run.day
+ while True:
+ if next_run.month is not m:
+ next_run = next_run.replace(hour=0, minute=0)
+ next_run = self._calc_month(next_run, cron)
+ if next_run.day is not d:
+ next_run = next_run.replace(hour=0)
+ next_run = self._calc_day(next_run, cron)
+ if next_run.hour in cron["hour"]:
+ return next_run
+ else:
+ m = next_run.month
+ d = next_run.day
+ one_hour = datetime.timedelta(hours=1)
+ next_run = next_run + one_hour
+
+ def _calc_minute(self, next_run, cron):
+ one_minute = datetime.timedelta(minutes=1)
+
+ m = next_run.month
+ d = next_run.day
+ h = next_run.hour
+ while True:
+ if next_run.month is not m:
+ next_run = next_run.replace(minute=0)
+ next_run = self._calc_month(next_run, cron)
+ if next_run.day is not d:
+ next_run = next_run.replace(minute=0)
+ next_run = self._calc_day(next_run, cron)
+ if next_run.hour is not h:
+ next_run = next_run.replace(minute=0)
+ next_run = self._calc_day(next_run, cron)
+ if next_run.minute in cron["min"]:
+ return next_run
+ else:
+ m = next_run.month
+ d = next_run.day
+ h = next_run.hour
+ next_run = next_run + one_minute
+
+ def _get_next_run(self, cron):
+ one_minute = datetime.timedelta(minutes=1)
+ # go up 1 minute because it shouldn't happen right when added
+ now = datetime.datetime.now() + one_minute
+ next_run = now.replace(second=0, microsecond=0)
+
+ # start with month, which will also help calculate year
+ next_run = self._calc_month(next_run, cron)
+ next_run = self._calc_day(next_run, cron)
+ next_run = self._calc_hour(next_run, cron)
+ next_run = self._calc_minute(next_run, cron)
+ return next_run
diff --git a/samples/oauth/oauth_on_appengine/appengine_utilities/event.py b/samples/oauth/oauth_on_appengine/appengine_utilities/event.py
new file mode 100755
index 0000000..51d1424
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/appengine_utilities/event.py
@@ -0,0 +1,76 @@
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+import __main__
+
+
+class Event(object):
+ """
+ Event is a simple publish/subscribe based event dispatcher
+ It sets itself to the __main__ function. In order to use it,
+ you must import it and __main__
+ """
+
+ def __init__(self):
+ self.events = []
+
+ def subscribe(self, event, callback, args = None):
+ """
+ This method will subscribe a callback function to an event name.
+ """
+ if not {"event": event, "callback": callback, "args": args, } \
+ in self.events:
+ self.events.append({"event": event, "callback": callback, \
+ "args": args, })
+
+ def unsubscribe(self, event, callback, args = None):
+ """
+ This method will unsubscribe a callback from an event.
+ """
+ if {"event": event, "callback": callback, "args": args, }\
+ in self.events:
+ self.events.remove({"event": event, "callback": callback,\
+ "args": args, })
+
+ def fire_event(self, event = None):
+ """
+ This method is what a method uses to fire an event,
+ initiating all registered callbacks
+ """
+ for e in self.events:
+ if e["event"] == event:
+ if type(e["args"]) == type([]):
+ e["callback"](*e["args"])
+ elif type(e["args"]) == type({}):
+ e["callback"](**e["args"])
+ elif e["args"] == None:
+ e["callback"]()
+ else:
+ e["callback"](e["args"])
+"""
+Assign to the event class to __main__
+"""
+__main__.AEU_Events = Event()
diff --git a/samples/oauth/oauth_on_appengine/appengine_utilities/flash.py b/samples/oauth/oauth_on_appengine/appengine_utilities/flash.py
new file mode 100755
index 0000000..7952068
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/appengine_utilities/flash.py
@@ -0,0 +1,119 @@
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+import os
+import sys
+import Cookie
+import pickle
+from time import strftime
+
+from django.utils import simplejson
+
+COOKIE_NAME = 'appengine-utilities-flash'
+
+
+class Flash(object):
+ """
+ Send messages to the user between pages.
+
+ When you instantiate the class, the attribute 'msg' will be set from the
+ cookie, and the cookie will be deleted. If there is no flash cookie, 'msg'
+ will default to None.
+
+ To set a flash message for the next page, simply set the 'msg' attribute.
+
+ Example psuedocode:
+
+ if new_entity.put():
+ flash = Flash()
+ flash.msg = 'Your new entity has been created!'
+ return redirect_to_entity_list()
+
+ Then in the template on the next page:
+
+ {% if flash.msg %}
+ <div class="flash-msg">{{ flash.msg }}</div>
+ {% endif %}
+ """
+
+ def __init__(self, cookie=None):
+ """
+ Load the flash message and clear the cookie.
+ """
+ self.no_cache_headers()
+ # load cookie
+ if cookie is None:
+ browser_cookie = os.environ.get('HTTP_COOKIE', '')
+ self.cookie = Cookie.SimpleCookie()
+ self.cookie.load(browser_cookie)
+ else:
+ self.cookie = cookie
+ # check for flash data
+ if self.cookie.get(COOKIE_NAME):
+ # set 'msg' attribute
+ cookie_val = self.cookie[COOKIE_NAME].value
+ # we don't want to trigger __setattr__(), which creates a cookie
+ try:
+ self.__dict__['msg'] = simplejson.loads(cookie_val)
+ except:
+ # not able to load the json, so do not set message. This should
+ # catch for when the browser doesn't delete the cookie in time for
+ # the next request, and only blanks out the content.
+ pass
+ # clear the cookie
+ self.cookie[COOKIE_NAME] = ''
+ self.cookie[COOKIE_NAME]['path'] = '/'
+ self.cookie[COOKIE_NAME]['expires'] = 0
+ print self.cookie[COOKIE_NAME]
+ else:
+ # default 'msg' attribute to None
+ self.__dict__['msg'] = None
+
+ def __setattr__(self, name, value):
+ """
+ Create a cookie when setting the 'msg' attribute.
+ """
+ if name == 'cookie':
+ self.__dict__['cookie'] = value
+ elif name == 'msg':
+ self.__dict__['msg'] = value
+ self.__dict__['cookie'][COOKIE_NAME] = simplejson.dumps(value)
+ self.__dict__['cookie'][COOKIE_NAME]['path'] = '/'
+ print self.cookie
+ else:
+ raise ValueError('You can only set the "msg" attribute.')
+
+ def no_cache_headers(self):
+ """
+ Adds headers, avoiding any page caching in the browser. Useful for highly
+ dynamic sites.
+ """
+ print "Expires: Tue, 03 Jul 2001 06:00:00 GMT"
+ print strftime("Last-Modified: %a, %d %b %y %H:%M:%S %Z")
+ print "Cache-Control: no-store, no-cache, must-revalidate, max-age=0"
+ print "Cache-Control: post-check=0, pre-check=0"
+ print "Pragma: no-cache"
diff --git a/samples/oauth/oauth_on_appengine/appengine_utilities/paginator.py b/samples/oauth/oauth_on_appengine/appengine_utilities/paginator.py
new file mode 100755
index 0000000..090ef3b
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/appengine_utilities/paginator.py
@@ -0,0 +1,121 @@
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+from google.appengine.ext import db
+from cache import Cache
+
+class Paginator(object):
+ """
+ This class is used for maintaining pagination objects.
+ """
+
+ @classmethod
+ def get(cls, count=10, q_filters={}, search=None, start=None, model=None, \
+ order='ASC', order_by='__key__'):
+ """
+ get queries the database on model, starting with key, ordered by
+ order. It receives count + 1 items, returning count and setting a
+ next field to the count + 1 item key. It then reverses the sort, and
+ grabs count objects, returning the last as a the previous.
+
+ Arguments:
+ count: The amount of entries to pull on query
+ q_filter: The filter value (optional)
+ search: Search is used for SearchableModel searches
+ start: The key to start the page from
+ model: The Model object to query against. This is not a
+ string, it must be a Model derived object.
+ order: The order in which to pull the values.
+ order_by: The attribute to order results by. This defaults to
+ __key__
+
+ Returns a dict:
+ {
+ 'next': next_key,
+ 'prev': prev_key,
+ 'items': entities_pulled
+ }
+ """
+
+ # argument validation
+ if model == None:
+ raise ValueError('You must pass a model to query')
+
+ # a valid model object will have a gql method.
+ if callable(model.gql) == False:
+ raise TypeError('model must be a valid model object.')
+
+ # cache check
+ cache_string = "gae_paginator_"
+ for q_filter in q_filters:
+ cache_string = cache_string + q_filter + "_" + q_filters[q_filter] + "_"
+ cache_string = cache_string + "index"
+ c = Cache()
+ if c.has_key(cache_string):
+ return c[cache_string]
+
+ # build query
+ query = model.all()
+ if len(q_filters) > 0:
+ for q_filter in q_filters:
+ query.filter(q_filter + " = ", q_filters[q_filter])
+ if start:
+ if order.lower() == "DESC".lower():
+ query.filter(order_by + " <", start)
+ else:
+ query.filter(order_by + " >", start)
+ if search:
+ query.search(search)
+ if order.lower() == "DESC".lower():
+ query.order("-" + order_by)
+ else:
+ query.order(order_by)
+ results = query.fetch(count + 1)
+ if len(results) == count + 1:
+ next = getattr(results[count - 1], order_by)
+ # reverse the query to get the value for previous
+ if start is not None:
+ rquery = model.all()
+ for q_filter in q_filters:
+ rquery.filter(q_filter + " = ", q_filters[q_filter])
+ if search:
+ query.search(search)
+ if order.lower() == "DESC".lower():
+ rquery.order(order_by)
+ else:
+ rquery.order("-" + order_by)
+ rresults = rquery.fetch(count)
+ previous = getattr(results[0], order_by)
+ else:
+ previous = None
+ else:
+ next = None
+ return {
+ "results": results,
+ "next": next,
+ "previous": previous
+ }
diff --git a/samples/oauth/oauth_on_appengine/appengine_utilities/rotmodel.py b/samples/oauth/oauth_on_appengine/appengine_utilities/rotmodel.py
new file mode 100755
index 0000000..23ec091
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/appengine_utilities/rotmodel.py
@@ -0,0 +1,46 @@
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+from google.appengine.ext import db
+
+class ROTModel(db.Model):
+ """
+ ROTModel overrides the db.Model put function, having it retry
+ up to 3 times when it encounters a datastore timeout. This is
+ to try an maximize the chance the data makes it into the datastore
+ when attempted. If it fails, it raises the db.Timeout error and the
+ calling application will need to handle that.
+ """
+ def put(self):
+ count = 0
+ while count < 3:
+ try:
+ return db.Model.put(self)
+ except db.Timeout:
+ count += 1
+ else:
+ raise db.Timeout()
diff --git a/samples/oauth/oauth_on_appengine/appengine_utilities/sessions.py b/samples/oauth/oauth_on_appengine/appengine_utilities/sessions.py
new file mode 100755
index 0000000..dbb101b
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/appengine_utilities/sessions.py
@@ -0,0 +1,1000 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2008, appengine-utilities project
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+- Redistributions of source code must retain the above copyright notice, this
+ list of conditions and the following disclaimer.
+- Redistributions in binary form must reproduce the above copyright notice,
+ this list of conditions and the following disclaimer in the documentation
+ and/or other materials provided with the distribution.
+- Neither the name of the appengine-utilities project nor the names of its
+ contributors may be used to endorse or promote products derived from this
+ software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+# main python imports
+import os
+import time
+import datetime
+import random
+import md5
+import Cookie
+import pickle
+import __main__
+from time import strftime
+import logging
+
+# google appengine imports
+from google.appengine.ext import db
+from google.appengine.api import memcache
+
+#django simplejson import, used for flash
+from django.utils import simplejson
+
+from rotmodel import ROTModel
+
+# settings, if you have these set elsewhere, such as your django settings file,
+# you'll need to adjust the values to pull from there.
+
+
+class _AppEngineUtilities_Session(db.Model):
+ """
+ Model for the sessions in the datastore. This contains the identifier and
+ validation information for the session.
+ """
+
+ sid = db.StringListProperty()
+ session_key = db.FloatProperty()
+ ip = db.StringProperty()
+ ua = db.StringProperty()
+ last_activity = db.DateTimeProperty()
+ dirty = db.BooleanProperty(default=False)
+ working = db.BooleanProperty(default=False)
+ deleted = db.BooleanProperty(default=False) # used for cases where
+ # datastore delete doesn't
+ # work
+
+ def put(self):
+ """
+ Extend put so that it writes vaules to memcache as well as the datastore,
+ and keeps them in sync, even when datastore writes fails.
+ """
+ if self.session_key:
+ memcache.set("_AppEngineUtilities_Session_" + str(self.session_key), self)
+ else:
+ # new session, generate a new key, which will handle the put and set the memcache
+ self.create_key()
+
+ self.last_activity = datetime.datetime.now()
+
+ try:
+ self.dirty = False
+ logging.info("doing a put")
+ db.put(self)
+ memcache.set("_AppEngineUtilities_Session_" + str(self.session_key), self)
+ except:
+ self.dirty = True
+ memcache.set("_AppEngineUtilities_Session_" + str(self.session_key), self)
+
+ return self
+
+ @classmethod
+ def get_session(cls, session_obj=None):
+ """
+ Uses the passed sid to get a session object from memcache, or datastore
+ if a valid one exists.
+ """
+ if session_obj.sid == None:
+ return None
+ session_key = session_obj.sid.split('_')[0]
+ session = memcache.get("_AppEngineUtilities_Session_" + str(session_key))
+ if session:
+ if session.deleted == True:
+ session.delete()
+ return None
+ if session.dirty == True and session.working != False:
+ # the working bit is used to make sure multiple requests, which can happen
+ # with ajax oriented sites, don't try to put at the same time
+ session.working = True
+ memcache.set("_AppEngineUtilities_Session_" + str(session_key), session)
+ session.put()
+ if session_obj.sid in session.sid:
+ logging.info('grabbed session from memcache')
+ sessionAge = datetime.datetime.now() - session.last_activity
+ if sessionAge.seconds > session_obj.session_expire_time:
+ session.delete()
+ return None
+ return session
+ else:
+ return None
+
+ # Not in memcache, check datastore
+ query = _AppEngineUtilities_Session.all()
+ query.filter("sid = ", session_obj.sid)
+ results = query.fetch(1)
+ if len(results) > 0:
+ sessionAge = datetime.datetime.now() - results[0].last_activity
+ if sessionAge.seconds > self.session_expire_time:
+ results[0].delete()
+ return None
+ memcache.set("_AppEngineUtilities_Session_" + str(session_key), results[0])
+ memcache.set("_AppEngineUtilities_SessionData_" + str(session_key), results[0].get_items_ds())
+ logging.info('grabbed session from datastore')
+ return results[0]
+ else:
+ return None
+
+ def get_items(self):
+ """
+ Returns all the items stored in a session
+ """
+ items = memcache.get("_AppEngineUtilities_SessionData_" + str(self.session_key))
+ if items:
+ for item in items:
+ if item.deleted == True:
+ item.delete()
+ items.remove(item)
+ return items
+
+ query = _AppEngineUtilities_SessionData.all()
+ query.filter('session_key', self.session_key)
+ results = query.fetch(1000)
+ return results
+
+ def get_item(self, keyname = None):
+ """
+ Returns a single item from the memcache or datastore
+ """
+ mc = memcache.get("_AppEngineUtilities_SessionData_" + str(self.session_key))
+ if mc:
+ for item in mc:
+ if item.keyname == keyname:
+ if item.deleted == True:
+ item.delete()
+ return None
+ return item
+ query = _AppEngineUtilities_SessionData.all()
+ query.filter("session_key = ", self.session_key)
+ query.filter("keyname = ", keyname)
+ results = query.fetch(1)
+ if len(results) > 0:
+ memcache.set("_AppEngineUtilities_SessionData_" + str(self.session_key), self.get_items_ds())
+ return results[0]
+ return None
+
+ def get_items_ds(self):
+ """
+ This gets all the items straight from the datastore, does not
+ interact with the memcache.
+ """
+ query = _AppEngineUtilities_SessionData.all()
+ query.filter('session_key', self.session_key)
+ results = query.fetch(1000)
+ return results
+
+ def delete(self):
+ try:
+ query = _AppEngineUtilities_SessionData.all()
+ query.filter("session_key = ", self.session_key)
+ results = query.fetch(1000)
+ db.delete(results)
+ db.delete(self)
+ memcache.delete_multi(["_AppEngineUtilities_Session_" + str(self.session_key), "_AppEngineUtilities_SessionData_" + str(self.session_key)])
+ except:
+ mc = memcache.get("_AppEngineUtilities_Session_" + str(self.session_key))
+ mc.deleted = True
+ memcache.set("_AppEngineUtilities_Session_" + str(self.session_key), mc)
+
+ def create_key(self):
+ """
+ Creates a unique key for the session.
+ """
+ self.session_key = time.time()
+ valid = False
+ while valid == False:
+ # verify session_key is unique
+ if memcache.get("_AppEngineUtilities_Session_" + str(self.session_key)):
+ self.session_key = self.session_key + 0.001
+ else:
+ query = _AppEngineUtilities_Session.all()
+ query.filter("session_key = ", self.session_key)
+ results = query.fetch(1)
+ if len(results) > 0:
+ self.session_key = self.session_key + 0.001
+ else:
+ try:
+ self.put()
+ memcache.set("_AppEngineUtilities_Session_" + str(self.session_key), self)
+ except:
+ self.dirty = True
+ memcache.set("_AppEngineUtilities_Session_" + str(self.session_key), self)
+ valid = True
+
+class _AppEngineUtilities_SessionData(db.Model):
+ """
+ Model for the session data in the datastore.
+ """
+
+ session_key = db.FloatProperty()
+ keyname = db.StringProperty()
+ content = db.BlobProperty()
+ dirty = db.BooleanProperty(default=False)
+ deleted = db.BooleanProperty(default=False)
+
+ def put(self):
+ """
+ Adds a keyname/value for session to the datastore and memcache
+ """
+ # update or insert in datastore
+ try:
+ db.put(self)
+ self.dirty = False
+ except:
+ self.dirty = True
+
+ # update or insert in memcache
+ mc_items = memcache.get("_AppEngineUtilities_SessionData_" + str(self.session_key))
+ if mc_items:
+ value_updated = False
+ for item in mc_items:
+ if value_updated == True:
+ break
+ if item.keyname == self.keyname:
+ logging.info("updating " + self.keyname)
+ item.content = self.content
+ memcache.set("_AppEngineUtilities_SessionData_" + str(self.session_key), mc_items)
+ value_updated = True
+ break
+ if value_updated == False:
+ #logging.info("adding " + self.keyname)
+ mc_items.append(self)
+ memcache.set("_AppEngineUtilities_SessionData_" + str(self.session_key), mc_items)
+
+ def delete(self):
+ """
+ Deletes an entity from the session in memcache and the datastore
+ """
+ try:
+ db.delete(self)
+ except:
+ self.deleted = True
+ mc_items = memcache.get("_AppEngineUtilities_SessionData_" + str(self.session_key))
+ value_handled = False
+ for item in mc_items:
+ if value_handled == True:
+ break
+ if item.keyname == self.keyname:
+ if self.deleted == True:
+ item.deleted = True
+ else:
+ mc_items.remove(item)
+ memcache.set("_AppEngineUtilities_SessionData_" + str(self.session_key), mc_items)
+
+
+class _DatastoreWriter(object):
+
+ def put(self, keyname, value, session):
+ """
+ Insert a keyname/value pair into the datastore for the session.
+
+ Args:
+ keyname: The keyname of the mapping.
+ value: The value of the mapping.
+ """
+ keyname = session._validate_key(keyname)
+ if value is None:
+ raise ValueError('You must pass a value to put.')
+
+ # datestore write trumps cookie. If there is a cookie value
+ # with this keyname, delete it so we don't have conflicting
+ # entries.
+ if session.cookie_vals.has_key(keyname):
+ del(session.cookie_vals[keyname])
+ session.output_cookie[session.cookie_name + '_data'] = \
+ simplejson.dumps(session.cookie_vals)
+ print session.output_cookie.output()
+
+ sessdata = session._get(keyname=keyname)
+ if sessdata is None:
+ sessdata = _AppEngineUtilities_SessionData()
+ sessdata.session_key = session.session.session_key
+ sessdata.keyname = keyname
+ sessdata.content = pickle.dumps(value)
+ # UNPICKLING CACHE session.cache[keyname] = pickle.dumps(value)
+ session.cache[keyname] = value
+ sessdata.put()
+ # todo _set_memcache() should be going away when this is done
+ # session._set_memcache()
+
+
+class _CookieWriter(object):
+ def put(self, keyname, value, session):
+ """
+ Insert a keyname/value pair into the datastore for the session.
+
+ Args:
+ keyname: The keyname of the mapping.
+ value: The value of the mapping.
+ """
+ keyname = session._validate_key(keyname)
+ if value is None:
+ raise ValueError('You must pass a value to put.')
+
+ # Use simplejson for cookies instead of pickle.
+ session.cookie_vals[keyname] = value
+ # update the requests session cache as well.
+ session.cache[keyname] = value
+ session.output_cookie[session.cookie_name + '_data'] = \
+ simplejson.dumps(session.cookie_vals)
+ print session.output_cookie.output()
+
+class Session(object):
+ """
+ Sessions used to maintain user presence between requests.
+
+ Sessions store a unique id as a cookie in the browser and
+ referenced in a datastore object. This maintains user presence
+ by validating requests as visits from the same browser.
+
+ You can add extra data to the session object by using it
+ as a dictionary object. Values can be any python object that
+ can be pickled.
+
+ For extra performance, session objects are also store in
+ memcache and kept consistent with the datastore. This
+ increases the performance of read requests to session
+ data.
+ """
+
+ COOKIE_NAME = 'appengine-utilities-session-sid' # session token
+ DEFAULT_COOKIE_PATH = '/'
+ SESSION_EXPIRE_TIME = 7200 # sessions are valid for 7200 seconds (2 hours)
+ CLEAN_CHECK_PERCENT = 50 # By default, 50% of all requests will clean the database
+ INTEGRATE_FLASH = True # integrate functionality from flash module?
+ CHECK_IP = True # validate sessions by IP
+ CHECK_USER_AGENT = True # validate sessions by user agent
+ SET_COOKIE_EXPIRES = True # Set to True to add expiration field to cookie
+ SESSION_TOKEN_TTL = 5 # Number of seconds a session token is valid for.
+ UPDATE_LAST_ACTIVITY = 60 # Number of seconds that may pass before
+ # last_activity is updated
+ WRITER = "datastore" # Use the datastore writer by default. cookie is the
+ # other option.
+
+
+ def __init__(self, cookie_path=DEFAULT_COOKIE_PATH,
+ cookie_name=COOKIE_NAME,
+ session_expire_time=SESSION_EXPIRE_TIME,
+ clean_check_percent=CLEAN_CHECK_PERCENT,
+ integrate_flash=INTEGRATE_FLASH, check_ip=CHECK_IP,
+ check_user_agent=CHECK_USER_AGENT,
+ set_cookie_expires=SET_COOKIE_EXPIRES,
+ session_token_ttl=SESSION_TOKEN_TTL,
+ last_activity_update=UPDATE_LAST_ACTIVITY,
+ writer=WRITER):
+ """
+ Initializer
+
+ Args:
+ cookie_name: The name for the session cookie stored in the browser.
+ session_expire_time: The amount of time between requests before the
+ session expires.
+ clean_check_percent: The percentage of requests the will fire off a
+ cleaning routine that deletes stale session data.
+ integrate_flash: If appengine-utilities flash utility should be
+ integrated into the session object.
+ check_ip: If browser IP should be used for session validation
+ check_user_agent: If the browser user agent should be used for
+ sessoin validation.
+ set_cookie_expires: True adds an expires field to the cookie so
+ it saves even if the browser is closed.
+ session_token_ttl: Number of sessions a session token is valid
+ for before it should be regenerated.
+ """
+
+ self.cookie_path = cookie_path
+ self.cookie_name = cookie_name
+ self.session_expire_time = session_expire_time
+ self.integrate_flash = integrate_flash
+ self.check_user_agent = check_user_agent
+ self.check_ip = check_ip
+ self.set_cookie_expires = set_cookie_expires
+ self.session_token_ttl = session_token_ttl
+ self.last_activity_update = last_activity_update
+ self.writer = writer
+
+ # make sure the page is not cached in the browser
+ self.no_cache_headers()
+ # Check the cookie and, if necessary, create a new one.
+ self.cache = {}
+ string_cookie = os.environ.get('HTTP_COOKIE', '')
+ self.cookie = Cookie.SimpleCookie()
+ self.output_cookie = Cookie.SimpleCookie()
+ self.cookie.load(string_cookie)
+ try:
+ self.cookie_vals = \
+ simplejson.loads(self.cookie[self.cookie_name + '_data'].value)
+ # sync self.cache and self.cookie_vals which will make those
+ # values available for all gets immediately.
+ for k in self.cookie_vals:
+ self.cache[k] = self.cookie_vals[k]
+ self.output_cookie[self.cookie_name + '_data'] = self.cookie[self.cookie_name + '_data']
+ # sync the input cookie with the output cookie
+ except:
+ self.cookie_vals = {}
+
+
+ if writer == "cookie":
+ pass
+ else:
+ self.sid = None
+ new_session = True
+
+ # do_put is used to determine if a datastore write should
+ # happen on this request.
+ do_put = False
+
+ # check for existing cookie
+ if self.cookie.get(cookie_name):
+ self.sid = self.cookie[cookie_name].value
+ self.session = _AppEngineUtilities_Session.get_session(self) # will return None if
+ # sid expired
+ if self.session:
+ new_session = False
+
+ if new_session:
+ # start a new session
+ self.session = _AppEngineUtilities_Session()
+ self.session.put()
+ self.sid = self.new_sid()
+ if 'HTTP_USER_AGENT' in os.environ:
+ self.session.ua = os.environ['HTTP_USER_AGENT']
+ else:
+ self.session.ua = None
+ if 'REMOTE_ADDR' in os.environ:
+ self.session.ip = os.environ['REMOTE_ADDR']
+ else:
+ self.session.ip = None
+ self.session.sid = [self.sid]
+ # do put() here to get the session key
+ self.session.put()
+ else:
+ # check the age of the token to determine if a new one
+ # is required
+ duration = datetime.timedelta(seconds=self.session_token_ttl)
+ session_age_limit = datetime.datetime.now() - duration
+ if self.session.last_activity < session_age_limit:
+ logging.info("UPDATING SID LA = " + str(self.session.last_activity) + " - TL = " + str(session_age_limit))
+ self.sid = self.new_sid()
+ if len(self.session.sid) > 2:
+ self.session.sid.remove(self.session.sid[0])
+ self.session.sid.append(self.sid)
+ do_put = True
+ else:
+ self.sid = self.session.sid[-1]
+ # check if last_activity needs updated
+ ula = datetime.timedelta(seconds=self.last_activity_update)
+ if datetime.datetime.now() > self.session.last_activity + ula:
+ do_put = True
+
+ self.output_cookie[cookie_name] = self.sid
+ self.output_cookie[cookie_name]['path'] = cookie_path
+
+ # UNPICKLING CACHE self.cache['sid'] = pickle.dumps(self.sid)
+ self.cache['sid'] = self.sid
+
+ if do_put:
+ if self.sid != None or self.sid != "":
+ logging.info("doing put")
+ self.session.put()
+
+ if self.set_cookie_expires:
+ if not self.output_cookie.has_key(cookie_name + '_data'):
+ self.output_cookie[cookie_name + '_data'] = ""
+ self.output_cookie[cookie_name + '_data']['expires'] = \
+ self.session_expire_time
+ print self.output_cookie.output()
+
+ # fire up a Flash object if integration is enabled
+ if self.integrate_flash:
+ import flash
+ self.flash = flash.Flash(cookie=self.cookie)
+
+ # randomly delete old stale sessions in the datastore (see
+ # CLEAN_CHECK_PERCENT variable)
+ if random.randint(1, 100) < clean_check_percent:
+ self._clean_old_sessions()
+
+ def new_sid(self):
+ """
+ Create a new session id.
+ """
+ sid = str(self.session.session_key) + "_" +md5.new(repr(time.time()) + \
+ str(random.random())).hexdigest()
+ return sid
+
+ '''
+ # removed as model now has get_session classmethod
+ def _get_session(self):
+ """
+ Get the user's session from the datastore
+ """
+ query = _AppEngineUtilities_Session.all()
+ query.filter('sid', self.sid)
+ if self.check_user_agent:
+ query.filter('ua', os.environ['HTTP_USER_AGENT'])
+ if self.check_ip:
+ query.filter('ip', os.environ['REMOTE_ADDR'])
+ results = query.fetch(1)
+ if len(results) is 0:
+ return None
+ else:
+ sessionAge = datetime.datetime.now() - results[0].last_activity
+ if sessionAge.seconds > self.session_expire_time:
+ results[0].delete()
+ return None
+ return results[0]
+ '''
+ def _get(self, keyname=None):
+ """
+ Return all of the SessionData object data from the datastore onlye,
+ unless keyname is specified, in which case only that instance of
+ SessionData is returned.
+ Important: This does not interact with memcache and pulls directly
+ from the datastore. This also does not get items from the cookie
+ store.
+
+ Args:
+ keyname: The keyname of the value you are trying to retrieve.
+ """
+ if keyname != None:
+ return self.session.get_item(keyname)
+ return self.session.get_items()
+ """
+ OLD
+ query = _AppEngineUtilities_SessionData.all()
+ query.filter('session', self.session)
+ if keyname != None:
+ query.filter('keyname =', keyname)
+ results = query.fetch(1000)
+
+ if len(results) is 0:
+ return None
+ if keyname != None:
+ return results[0]
+ return results
+ """
+
+ def _validate_key(self, keyname):
+ """
+ Validate the keyname, making sure it is set and not a reserved name.
+ """
+ if keyname is None:
+ raise ValueError('You must pass a keyname for the session' + \
+ ' data content.')
+ elif keyname in ('sid', 'flash'):
+ raise ValueError(keyname + ' is a reserved keyname.')
+
+ if type(keyname) != type([str, unicode]):
+ return str(keyname)
+ return keyname
+
+ def _put(self, keyname, value):
+ """
+ Insert a keyname/value pair into the datastore for the session.
+
+ Args:
+ keyname: The keyname of the mapping.
+ value: The value of the mapping.
+ """
+ if self.writer == "datastore":
+ writer = _DatastoreWriter()
+ else:
+ writer = _CookieWriter()
+
+ writer.put(keyname, value, self)
+
+ def _delete_session(self):
+ """
+ Delete the session and all session data.
+ """
+ if hasattr(self, "session"):
+ self.session.delete()
+ self.cookie_vals = {}
+ self.cache = {}
+ self.output_cookie[self.cookie_name + '_data'] = \
+ simplejson.dumps(self.cookie_vals)
+ print self.output_cookie.output()
+ """
+ OLD
+ if hasattr(self, "session"):
+ sessiondata = self._get()
+ # delete from datastore
+ if sessiondata is not None:
+ for sd in sessiondata:
+ sd.delete()
+ # delete from memcache
+ memcache.delete('sid-'+str(self.session.key()))
+ # delete the session now that all items that reference it are deleted.
+ self.session.delete()
+ # unset any cookie values that may exist
+ self.cookie_vals = {}
+ self.cache = {}
+ self.output_cookie[self.cookie_name + '_data'] = \
+ simplejson.dumps(self.cookie_vals)
+ print self.output_cookie.output()
+ """
+ # if the event class has been loaded, fire off the sessionDeleted event
+ if 'AEU_Events' in __main__.__dict__:
+ __main__.AEU_Events.fire_event('sessionDelete')
+
+ def delete(self):
+ """
+ Delete the current session and start a new one.
+
+ This is useful for when you need to get rid of all data tied to a
+ current session, such as when you are logging out a user.
+ """
+ self._delete_session()
+
+ @classmethod
+ def delete_all_sessions(cls):
+ """
+ Deletes all sessions and session data from the data store and memcache:
+
+ NOTE: This is not fully developed. It also will not delete any cookie
+ data as this does not work for each incoming request. Keep this in mind
+ if you are using the cookie writer.
+ """
+ all_sessions_deleted = False
+ all_data_deleted = False
+
+ while not all_sessions_deleted:
+ query = _AppEngineUtilities_Session.all()
+ results = query.fetch(75)
+ if len(results) is 0:
+ all_sessions_deleted = True
+ else:
+ for result in results:
+ result.delete()
+
+
+ def _clean_old_sessions(self):
+ """
+ Delete expired sessions from the datastore.
+
+ This is only called for CLEAN_CHECK_PERCENT percent of requests because
+ it could be rather intensive.
+ """
+ duration = datetime.timedelta(seconds=self.session_expire_time)
+ session_age = datetime.datetime.now() - duration
+ query = _AppEngineUtilities_Session.all()
+ query.filter('last_activity <', session_age)
+ results = query.fetch(50)
+ for result in results:
+ """
+ OLD
+ data_query = _AppEngineUtilities_SessionData.all()
+ data_query.filter('session', result)
+ data_results = data_query.fetch(1000)
+ for data_result in data_results:
+ data_result.delete()
+ memcache.delete('sid-'+str(result.key()))
+ """
+ result.delete()
+
+ # Implement Python container methods
+
+ def __getitem__(self, keyname):
+ """
+ Get item from session data.
+
+ keyname: The keyname of the mapping.
+ """
+ # flash messages don't go in the datastore
+
+ if self.integrate_flash and (keyname == 'flash'):
+ return self.flash.msg
+ if keyname in self.cache:
+ # UNPICKLING CACHE return pickle.loads(str(self.cache[keyname]))
+ return self.cache[keyname]
+ if keyname in self.cookie_vals:
+ return self.cookie_vals[keyname]
+ if hasattr(self, "session"):
+ data = self._get(keyname)
+ if data:
+ #UNPICKLING CACHE self.cache[keyname] = data.content
+ self.cache[keyname] = pickle.loads(data.content)
+ return pickle.loads(data.content)
+ else:
+ raise KeyError(str(keyname))
+ raise KeyError(str(keyname))
+
+ def __setitem__(self, keyname, value):
+ """
+ Set item in session data.
+
+ Args:
+ keyname: They keyname of the mapping.
+ value: The value of mapping.
+ """
+
+ if self.integrate_flash and (keyname == 'flash'):
+ self.flash.msg = value
+ else:
+ keyname = self._validate_key(keyname)
+ self.cache[keyname] = value
+ # self._set_memcache() # commented out because this is done in the datestore put
+ return self._put(keyname, value)
+
+ def delete_item(self, keyname, throw_exception=False):
+ """
+ Delete item from session data, ignoring exceptions if
+ necessary.
+
+ Args:
+ keyname: The keyname of the object to delete.
+ throw_exception: false if exceptions are to be ignored.
+ Returns:
+ Nothing.
+ """
+ if throw_exception:
+ self.__delitem__(keyname)
+ return None
+ else:
+ try:
+ self.__delitem__(keyname)
+ except KeyError:
+ return None
+
+ def __delitem__(self, keyname):
+ """
+ Delete item from session data.
+
+ Args:
+ keyname: The keyname of the object to delete.
+ """
+ bad_key = False
+ sessdata = self._get(keyname = keyname)
+ if sessdata is None:
+ bad_key = True
+ else:
+ sessdata.delete()
+ if keyname in self.cookie_vals:
+ del self.cookie_vals[keyname]
+ bad_key = False
+ self.output_cookie[self.cookie_name + '_data'] = \
+ simplejson.dumps(self.cookie_vals)
+ print self.output_cookie.output()
+ if bad_key:
+ raise KeyError(str(keyname))
+ if keyname in self.cache:
+ del self.cache[keyname]
+
+ def __len__(self):
+ """
+ Return size of session.
+ """
+ # check memcache first
+ if hasattr(self, "session"):
+ results = self._get()
+ if results is not None:
+ return len(results) + len(self.cookie_vals)
+ else:
+ return 0
+ return len(self.cookie_vals)
+
+ def __contains__(self, keyname):
+ """
+ Check if an item is in the session data.
+
+ Args:
+ keyname: The keyname being searched.
+ """
+ try:
+ r = self.__getitem__(keyname)
+ except KeyError:
+ return False
+ return True
+
+ def __iter__(self):
+ """
+ Iterate over the keys in the session data.
+ """
+ # try memcache first
+ if hasattr(self, "session"):
+ for k in self._get():
+ yield k.keyname
+ for k in self.cookie_vals:
+ yield k
+
+ def __str__(self):
+ """
+ Return string representation.
+ """
+
+ #if self._get():
+ return '{' + ', '.join(['"%s" = "%s"' % (k, self[k]) for k in self]) + '}'
+ #else:
+ # return []
+
+ '''
+ OLD
+ def _set_memcache(self):
+ """
+ Set a memcache object with all the session data. Optionally you can
+ add a key and value to the memcache for put operations.
+ """
+ # Pull directly from the datastore in order to ensure that the
+ # information is as up to date as possible.
+ if self.writer == "datastore":
+ data = {}
+ sessiondata = self._get()
+ if sessiondata is not None:
+ for sd in sessiondata:
+ data[sd.keyname] = pickle.loads(sd.content)
+
+ memcache.set('sid-'+str(self.session.key()), data, \
+ self.session_expire_time)
+ '''
+
+ def cycle_key(self):
+ """
+ Changes the session id.
+ """
+ self.sid = self.new_sid()
+ if len(self.session.sid) > 2:
+ self.session.sid.remove(self.session.sid[0])
+ self.session.sid.append(self.sid)
+
+ def flush(self):
+ """
+ Delete's the current session, creating a new one.
+ """
+ self._delete_session()
+ self.__init__()
+
+ def no_cache_headers(self):
+ """
+ Adds headers, avoiding any page caching in the browser. Useful for highly
+ dynamic sites.
+ """
+ print "Expires: Tue, 03 Jul 2001 06:00:00 GMT"
+ print strftime("Last-Modified: %a, %d %b %y %H:%M:%S %Z")
+ print "Cache-Control: no-store, no-cache, must-revalidate, max-age=0"
+ print "Cache-Control: post-check=0, pre-check=0"
+ print "Pragma: no-cache"
+
+ def clear(self):
+ """
+ Remove all items
+ """
+ sessiondata = self._get()
+ # delete from datastore
+ if sessiondata is not None:
+ for sd in sessiondata:
+ sd.delete()
+ # delete from memcache
+ self.cache = {}
+ self.cookie_vals = {}
+ self.output_cookie[self.cookie_name + '_data'] = \
+ simplejson.dumps(self.cookie_vals)
+ print self.output_cookie.output()
+
+ def has_key(self, keyname):
+ """
+ Equivalent to k in a, use that form in new code
+ """
+ return self.__contains__(keyname)
+
+ def items(self):
+ """
+ A copy of list of (key, value) pairs
+ """
+ op = {}
+ for k in self:
+ op[k] = self[k]
+ return op
+
+ def keys(self):
+ """
+ List of keys.
+ """
+ l = []
+ for k in self:
+ l.append(k)
+ return l
+
+ def update(*dicts):
+ """
+ Updates with key/value pairs from b, overwriting existing keys, returns None
+ """
+ for dict in dicts:
+ for k in dict:
+ self._put(k, dict[k])
+ return None
+
+ def values(self):
+ """
+ A copy list of values.
+ """
+ v = []
+ for k in self:
+ v.append(self[k])
+ return v
+
+ def get(self, keyname, default = None):
+ """
+ a[k] if k in a, else x
+ """
+ try:
+ return self.__getitem__(keyname)
+ except KeyError:
+ if default is not None:
+ return default
+ return None
+
+ def setdefault(self, keyname, default = None):
+ """
+ a[k] if k in a, else x (also setting it)
+ """
+ try:
+ return self.__getitem__(keyname)
+ except KeyError:
+ if default is not None:
+ self.__setitem__(keyname, default)
+ return default
+ return None
+
+ @classmethod
+ def check_token(cls, cookie_name=COOKIE_NAME, delete_invalid=True):
+ """
+ Retrieves the token from a cookie and validates that it is
+ a valid token for an existing cookie. Cookie validation is based
+ on the token existing on a session that has not expired.
+
+ This is useful for determining if datastore or cookie writer
+ should be used in hybrid implementations.
+
+ Args:
+ cookie_name: Name of the cookie to check for a token.
+ delete_invalid: If the token is not valid, delete the session
+ cookie, to avoid datastore queries on future
+ requests.
+
+ Returns True/False
+
+ NOTE: TODO This currently only works when the datastore is working, which of course
+ is pointless for applications using the django middleware. This needs to be resolved
+ before merging back into the main project.
+ """
+
+ string_cookie = os.environ.get('HTTP_COOKIE', '')
+ cookie = Cookie.SimpleCookie()
+ cookie.load(string_cookie)
+ if cookie.has_key(cookie_name):
+ query = _AppEngineUtilities_Session.all()
+ query.filter('sid', cookie[cookie_name].value)
+ results = query.fetch(1)
+ if len(results) > 0:
+ return True
+ else:
+ if delete_invalid:
+ output_cookie = Cookie.SimpleCookie()
+ output_cookie[cookie_name] = cookie[cookie_name]
+ output_cookie[cookie_name]['expires'] = 0
+ print output_cookie.output()
+ return False
diff --git a/samples/oauth/oauth_on_appengine/css/index.css b/samples/oauth/oauth_on_appengine/css/index.css
new file mode 100644
index 0000000..210ec18
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/css/index.css
@@ -0,0 +1,91 @@
+* {
+ margin:0;
+ padding:0;
+ font-family:'Myriad Pro', 'Tw Cen MT', Arial, Verdana;
+}
+body {
+ padding-left:15px;
+ padding-right:15px;
+}
+a {
+ color:#6699ff;
+ text-decoration:none;
+}
+a:hover {
+ color:#666666;
+ text-decoration:underline;
+}
+table#fill {
+ width:100%;
+ height:100%;
+ text-align:center;
+}
+.button {
+ outline: none;
+ cursor: pointer;
+ white-space: nowrap;
+ vertical-align: middle; /* or top */
+ display: -moz-inline-box;
+ display: inline-block;
+ overflow: visible; /* IE6 form button fix */
+ font-weight:bold;
+ font-size:20px;
+ background-color:#a3c2ff;
+ padding:2.5em 1em;
+ /*height:125px;*/
+}
+.button:hover {
+ /*background-color:#6699ff;*/
+ text-decoration:none;
+}
+#loading {
+ font-weight:bold;
+ text-align:center;
+ color:#fff;
+ background-color:red;
+ width:150px;
+ padding:5px 10px 5px 10px;
+ display:none;
+}
+#header {
+ color:#666666;
+ padding-bottom:10px;
+ margin-bottom:1em;
+ border-bottom:1px solid #666666;
+ height:35px;
+}
+#header table {
+ width:100%;
+}
+#oauth_stats {
+ margin-bottom:1em;
+}
+#oauth_stats table td {
+ vertical-align:top;
+}
+#data {
+ clear:both;
+ border:1px solid #ccc;
+ width:600px;
+ height:500px;
+ margin-bottom:1em;
+ overflow:auto;
+ text-align:left;
+}
+#data li {
+ padding:10px 10px 10px 20px;
+ border-bottom:1px solid #eee;
+ cursor:hand;
+}
+#data li:hover {
+ background-color:#fffccc;
+}
+.info_box {
+ display:none;
+ margin-top:10px;
+}
+.right_margin {
+ clear:both;
+ width:125px;
+ float:left;
+}
\ No newline at end of file
diff --git a/samples/oauth/oauth_on_appengine/images/icon_document.gif b/samples/oauth/oauth_on_appengine/images/icon_document.gif
new file mode 100644
index 0000000..f202ab1
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/images/icon_document.gif
Binary files differ
diff --git a/samples/oauth/oauth_on_appengine/images/icon_folder.gif b/samples/oauth/oauth_on_appengine/images/icon_folder.gif
new file mode 100644
index 0000000..f6bc4f1
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/images/icon_folder.gif
Binary files differ
diff --git a/samples/oauth/oauth_on_appengine/images/icon_pdf.gif b/samples/oauth/oauth_on_appengine/images/icon_pdf.gif
new file mode 100644
index 0000000..136eb0b
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/images/icon_pdf.gif
Binary files differ
diff --git a/samples/oauth/oauth_on_appengine/images/icon_presentation.gif b/samples/oauth/oauth_on_appengine/images/icon_presentation.gif
new file mode 100644
index 0000000..cede720
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/images/icon_presentation.gif
Binary files differ
diff --git a/samples/oauth/oauth_on_appengine/images/icon_spreadsheet.gif b/samples/oauth/oauth_on_appengine/images/icon_spreadsheet.gif
new file mode 100644
index 0000000..ec3954f
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/images/icon_spreadsheet.gif
Binary files differ
diff --git a/samples/oauth/oauth_on_appengine/images/icon_starred.png b/samples/oauth/oauth_on_appengine/images/icon_starred.png
new file mode 100644
index 0000000..13fc1c2
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/images/icon_starred.png
Binary files differ
diff --git a/samples/oauth/oauth_on_appengine/images/icon_trashed.png b/samples/oauth/oauth_on_appengine/images/icon_trashed.png
new file mode 100644
index 0000000..7afd3fb
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/images/icon_trashed.png
Binary files differ
diff --git a/samples/oauth/oauth_on_appengine/index.html b/samples/oauth/oauth_on_appengine/index.html
new file mode 100644
index 0000000..22d66b9
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/index.html
@@ -0,0 +1,131 @@
+<html>
+<head>
+
+<link type="text/css" rel="stylesheet" href="/css/index.css"/>
+<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.3.2/jquery.min.js"></script>
+<script type="text/javascript" src="/js/jquery.corners.min.js"></script>
+
+<script type="text/javascript">
+$(document).ready(function() {
+ $('.rounded').corners('40px');
+ $('li').live('click', function (event) {
+ var el = event.target || event.srcElement;
+ if (el.tagName != 'A') {
+ $(this).find('div').slideToggle();
+ }
+ });
+});
+
+function expandAllInfoBoxes() {
+ $('#data').find('div').each(function(i, el) {
+ $(this).slideToggle();
+ });
+}
+
+function setLoadingUI(params) {
+ var loadingText = params['loading'] || null;
+ var data = params['data'] || null;
+ if (loadingText) {
+ $('#loading').text(loadingText).show();
+ } else {
+ $('#loading').empty().fadeOut('slow');
+ }
+ if(data) {
+ $('#data').html(data);
+ $('#loading').fadeOut('slow');
+ } else {
+ $('#data').empty();
+ }
+}
+
+function fetchData(url) {
+ setLoadingUI({'loading': "gettin' some data..."});
+ $.post(url, {}, function(data) {
+ html = [];
+ for(var i = 0, entry; entry = data[i]; ++i) {
+ html.push('<li>');
+ html.push('<img src="/images/icon_' + entry.type + '.gif">');
+ html.push('<span style="margin-left:15px;margin-right:15px;">' +
+ entry.title + '</span>');
+
+ var infoBoxHtml = [];
+ infoBoxHtml.push('<a href="' + entry.links['alternate'] +
+ '" target="nw">Open in Google Docs »</a><br>');
+ infoBoxHtml.push('<span class="right_margin">resource id:</span>' +
+ entry.resourceId + '<br>');
+ infoBoxHtml.push('<span class="right_margin">created:</span>' +
+ entry.published + '<br>');
+ infoBoxHtml.push('<span class="right_margin">updated:</span>' +
+ entry.updated + '<br>');
+ if (entry.lastModifiedBy) {
+ infoBoxHtml.push('<span class="right_margin">modified by:</span>' +
+ entry.lastModifiedBy + '<br>');
+ }
+ if (entry.lastViewed) {
+ infoBoxHtml.push('<span class="right_margin">last viewed:</span>' +
+ entry.lastViewed + '<br>');
+ }
+ infoBoxHtml = '<div class="info_box">' + infoBoxHtml.join('') + '</div>';
+ html.push(infoBoxHtml);
+
+ html.push('</li>');
+ }
+ setLoadingUI({'loading': 'Done!',
+ 'data': '<ul>' + html.join('') + '</ul>'});
+ }, 'json');
+}
+</script>
+
+</head>
+<body>
+
+<div id="header">
+
+<table height="100%" cellspacing="0" cellpadding="0">
+<tr>
+<td width="25%" valign="bottom">
+{% if user %}
+ <span style="color:red;margin-right:8px;">logged in:</span> {{ user }}
+{% endif %}
+</td>
+<td width="50%" align="center" valign="bottom">
+ <div id="loading"></div>
+</td>
+<td width="25%" valign="bottom" align="right">
+{% if revoke_token_link %}
+ <a href="/revoke_token">revoke oauth token</a>
+{% endif %}
+</td>
+</tr>
+</table>
+
+</div>
+
+{% if revoke_token_link %}
+<div id="oauth_stats">
+ <h4>OAuth Stats:</h4>
+ <table>
+ <tr><td width="200">oauth_signature_method:</td><td>{{ sig_method }}</td></tr>
+ <tr><td>oauth_consumer_key:</td><td>{{ consumer.key }}</td></tr>
+ <tr><td>oauth_token:</td><td>{{ oauth_token.key }}<br>( oauth_token_secret: {{ oauth_token.secret }} )</td></tr>
+ </table>
+</div>
+
+<center>
+<a href="#" onclick="expandAllInfoBoxes();">toggle all</a>
+<div id="data"><!-- dynamically filled --></div>
+
+<input type="button" value="{{ form_value }}" class="rounded button" onclick="fetchData('{{ form_action }}');">
+</center>
+
+{% else %}
+<table id="fill"><tr><td>
+<form action="{{ form_action }}" method="post">
+ <input type="submit" value="{{ form_value }}" class="rounded button"><br><br>
+ Use my Google Apps domain: <input type="text" name="domain" value="default">
+</form>
+</td></tr></table>
+{% endif %}
+
+</body>
+</html>
\ No newline at end of file
diff --git a/samples/oauth/oauth_on_appengine/index.yaml b/samples/oauth/oauth_on_appengine/index.yaml
new file mode 100644
index 0000000..a3b9e05
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/index.yaml
@@ -0,0 +1,11 @@
+indexes:
+
+# AUTOGENERATED
+
+# This index.yaml is automatically updated whenever the dev_appserver
+# detects that a new type of query is run. If you want to manage the
+# index.yaml file manually, remove the above marker line (the line
+# saying "# AUTOGENERATED"). If you want to manage some indexes
+# manually, move them above the marker line. The index.yaml file is
+# automatically uploaded to the admin console when you next deploy
+# your application using appcfg.py.
diff --git a/samples/oauth/oauth_on_appengine/js/jquery.corners.min.js b/samples/oauth/oauth_on_appengine/js/jquery.corners.min.js
new file mode 100644
index 0000000..0b2f979
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/js/jquery.corners.min.js
@@ -0,0 +1,7 @@
+/*
+ * jQuery Corners 0.3
+ * Copyright (c) 2008 David Turnbull, Steven Wittens
+ * Dual licensed under the MIT (MIT-LICENSE.txt)
+ * and GPL (GPL-LICENSE.txt) licenses.
+ */
+jQuery.fn.corners=function(C){var N="rounded_by_jQuery_corners";var V=B(C);var F=false;try{F=(document.body.style.WebkitBorderRadius!==undefined);var Y=navigator.userAgent.indexOf("Chrome");if(Y>=0){F=false}}catch(E){}var W=false;try{W=(document.body.style.MozBorderRadius!==undefined);var Y=navigator.userAgent.indexOf("Firefox");if(Y>=0&&parseInt(navigator.userAgent.substring(Y+8))<3){W=false}}catch(E){}return this.each(function(b,h){$e=jQuery(h);if($e.hasClass(N)){return }$e.addClass(N);var a=/{(.*)}/.exec(h.className);var c=a?B(a[1],V):V;var j=h.nodeName.toLowerCase();if(j=="input"){h=O(h)}if(F&&c.webkit){K(h,c)}else{if(W&&c.mozilla&&(c.sizex==c.sizey)){M(h,c)}else{var d=D(h.parentNode);var f=D(h);switch(j){case"a":case"input":Z(h,c,d,f);break;default:R(h,c,d,f);break}}}});function K(d,c){var a=""+c.sizex+"px "+c.sizey+"px";var b=jQuery(d);if(c.tl){b.css("WebkitBorderTopLeftRadius",a)}if(c.tr){b.css("WebkitBorderTopRightRadius",a)}if(c.bl){b.css("WebkitBorderBottomLeftRadius",a)}if(c.br){b.css("WebkitBorderBottomRightRadius",a)}}function M(d,c){var a=""+c.sizex+"px";var b=jQuery(d);if(c.tl){b.css("-moz-border-radius-topleft",a)}if(c.tr){b.css("-moz-border-radius-topright",a)}if(c.bl){b.css("-moz-border-radius-bottomleft",a)}if(c.br){b.css("-moz-border-radius-bottomright",a)}}function Z(k,n,l,a){var m=S("table");var i=S("tbody");m.appendChild(i);var j=S("tr");var d=S("td","top");j.appendChild(d);var h=S("tr");var c=T(k,n,S("td"));h.appendChild(c);var f=S("tr");var b=S("td","bottom");f.appendChild(b);if(n.tl||n.tr){i.appendChild(j);X(d,n,l,a,true)}i.appendChild(h);if(n.bl||n.br){i.appendChild(f);X(b,n,l,a,false)}k.appendChild(m);if(jQuery.browser.msie){m.onclick=Q}k.style.overflow="hidden"}function Q(){if(!this.parentNode.onclick){this.parentNode.click()}}function O(c){var b=document.createElement("a");b.id=c.id;b.className=c.className;if(c.onclick){b.href="javascript:";b.onclick=c.onclick}else{jQuery(c).parent("form").each(function(){b.href=this.action});b.onclick=I}var a=document.createTextNode(c.value);b.appendChild(a);c.parentNode.replaceChild(b,c);return b}function I(){jQuery(this).parent("form").each(function(){this.submit()});return false}function R(d,a,b,c){var f=T(d,a,document.createElement("div"));d.appendChild(f);if(a.tl||a.tr){X(d,a,b,c,true)}if(a.bl||a.br){X(d,a,b,c,false)}}function T(j,i,k){var b=jQuery(j);var l;while(l=j.firstChild){k.appendChild(l)}if(j.style.height){var f=parseInt(b.css("height"));k.style.height=f+"px";f+=parseInt(b.css("padding-top"))+parseInt(b.css("padding-bottom"));j.style.height=f+"px"}if(j.style.width){var a=parseInt(b.css("width"));k.style.width=a+"px";a+=parseInt(b.css("padding-left"))+parseInt(b.css("padding-right"));j.style.width=a+"px"}k.style.paddingLeft=b.css("padding-left");k.style.paddingRight=b.css("padding-right");if(i.tl||i.tr){k.style.paddingTop=U(j,i,b.css("padding-top"),true)}else{k.style.paddingTop=b.css("padding-top")}if(i.bl||i.br){k.style.paddingBottom=U(j,i,b.css("padding-bottom"),false)}else{k.style.paddingBottom=b.css("padding-bottom")}j.style.padding=0;return k}function U(f,a,d,c){if(d.indexOf("px")<0){try{console.error("%s padding not in pixels",(c?"top":"bottom"),f)}catch(b){}d=a.sizey+"px"}d=parseInt(d);if(d-a.sizey<0){try{console.error("%s padding is %ipx for %ipx corner:",(c?"top":"bottom"),d,a.sizey,f)}catch(b){}d=a.sizey}return d-a.sizey+"px"}function S(b,a){var c=document.createElement(b);c.style.border="none";c.style.borderCollapse="collapse";c.style.borderSpacing=0;c.style.padding=0;c.style.margin=0;if(a){c.style.verticalAlign=a}return c}function D(b){try{var d=jQuery.css(b,"background-color");if(d.match(/^(transparent|rgba\(0,\s*0,\s*0,\s*0\))$/i)&&b.parentNode){return D(b.parentNode)}if(d==null){return"#ffffff"}if(d.indexOf("rgb")>-1){d=A(d)}if(d.length==4){d=L(d)}return d}catch(a){return"#ffffff"}}function L(a){return"#"+a.substring(1,2)+a.substring(1,2)+a.substring(2,3)+a.substring(2,3)+a.substring(3,4)+a.substring(3,4)}function A(h){var a=255;var d="";var b;var e=/([0-9]+)[, ]+([0-9]+)[, ]+([0-9]+)/;var f=e.exec(h);for(b=1;b<4;b++){d+=("0"+parseInt(f[b]).toString(16)).slice(-2)}return"#"+d}function B(b,d){var b=b||"";var c={sizex:5,sizey:5,tl:false,tr:false,bl:false,br:false,webkit:true,mozilla:true,transparent:false};if(d){c.sizex=d.sizex;c.sizey=d.sizey;c.webkit=d.webkit;c.transparent=d.transparent;c.mozilla=d.mozilla}var a=false;var e=false;jQuery.each(b.split(" "),function(f,j){j=j.toLowerCase();var h=parseInt(j);if(h>0&&j==h+"px"){c.sizey=h;if(!a){c.sizex=h}a=true}else{switch(j){case"no-native":c.webkit=c.mozilla=false;break;case"webkit":c.webkit=true;break;case"no-webkit":c.webkit=false;break;case"mozilla":c.mozilla=true;break;case"no-mozilla":c.mozilla=false;break;case"anti-alias":c.transparent=false;break;case"transparent":c.transparent=true;break;case"top":e=c.tl=c.tr=true;break;case"right":e=c.tr=c.br=true;break;case"bottom":e=c.bl=c.br=true;break;case"left":e=c.tl=c.bl=true;break;case"top-left":e=c.tl=true;break;case"top-right":e=c.tr=true;break;case"bottom-left":e=c.bl=true;break;case"bottom-right":e=c.br=true;break}}});if(!e){if(!d){c.tl=c.tr=c.bl=c.br=true}else{c.tl=d.tl;c.tr=d.tr;c.bl=d.bl;c.br=d.br}}return c}function P(f,d,h){var e=Array(parseInt("0x"+f.substring(1,3)),parseInt("0x"+f.substring(3,5)),parseInt("0x"+f.substring(5,7)));var c=Array(parseInt("0x"+d.substring(1,3)),parseInt("0x"+d.substring(3,5)),parseInt("0x"+d.substring(5,7)));r="0"+Math.round(e[0]+(c[0]-e[0])*h).toString(16);g="0"+Math.round(e[1]+(c[1]-e[1])*h).toString(16);d="0"+Math.round(e[2]+(c[2]-e[2])*h).toString(16);return"#"+r.substring(r.length-2)+g.substring(g.length-2)+d.substring(d.length-2)}function X(f,a,b,d,c){if(a.transparent){G(f,a,b,c)}else{J(f,a,b,d,c)}}function J(k,z,p,a,n){var h,f;var l=document.createElement("div");l.style.fontSize="1px";l.style.backgroundColor=p;var b=0;for(h=1;h<=z.sizey;h++){var u,t,q;arc=Math.sqrt(1-Math.pow(1-h/z.sizey,2))*z.sizex;var c=z.sizex-Math.ceil(arc);var w=Math.floor(b);var v=z.sizex-c-w;var o=document.createElement("div");var m=l;o.style.margin="0px "+c+"px";o.style.height="1px";o.style.overflow="hidden";for(f=1;f<=v;f++){if(f==1){if(f==v){u=((arc+b)*0.5)-w}else{t=Math.sqrt(1-Math.pow(1-(c+1)/z.sizex,2))*z.sizey;u=(t-(z.sizey-h))*(arc-w-v+1)*0.5}}else{if(f==v){t=Math.sqrt(1-Math.pow((z.sizex-c-f+1)/z.sizex,2))*z.sizey;u=1-(1-(t-(z.sizey-h)))*(1-(b-w))*0.5}else{q=Math.sqrt(1-Math.pow((z.sizex-c-f)/z.sizex,2))*z.sizey;t=Math.sqrt(1-Math.pow((z.sizex-c-f+1)/z.sizex,2))*z.sizey;u=((t+q)*0.5)-(z.sizey-h)}}H(z,o,m,n,P(p,a,u));m=o;var o=m.cloneNode(false);o.style.margin="0px 1px"}H(z,o,m,n,a);b=arc}if(n){k.insertBefore(l,k.firstChild)}else{k.appendChild(l)}}function H(c,a,e,d,b){if(d&&!c.tl){a.style.marginLeft=0}if(d&&!c.tr){a.style.marginRight=0}if(!d&&!c.bl){a.style.marginLeft=0}if(!d&&!c.br){a.style.marginRight=0}a.style.backgroundColor=b;if(d){e.appendChild(a)}else{e.insertBefore(a,e.firstChild)}}function G(c,o,l,h){var f=document.createElement("div");f.style.fontSize="1px";var a=document.createElement("div");a.style.overflow="hidden";a.style.height="1px";a.style.borderColor=l;a.style.borderStyle="none solid";var m=o.sizex-1;var j=o.sizey-1;if(!j){j=1}for(var b=0;b<o.sizey;b++){var n=m-Math.floor(Math.sqrt(1-Math.pow(1-b/j,2))*m);if(b==2&&o.sizex==6&&o.sizey==6){n=2}var k=a.cloneNode(false);k.style.borderWidth="0 "+n+"px";if(h){k.style.borderWidth="0 "+(o.tr?n:0)+"px 0 "+(o.tl?n:0)+"px"}else{k.style.borderWidth="0 "+(o.br?n:0)+"px 0 "+(o.bl?n:0)+"px"}h?f.appendChild(k):f.insertBefore(k,f.firstChild)}if(h){c.insertBefore(f,c.firstChild)}else{c.appendChild(f)}}};
\ No newline at end of file
diff --git a/samples/oauth/oauth_on_appengine/main_hmac.py b/samples/oauth/oauth_on_appengine/main_hmac.py
new file mode 100755
index 0000000..aaf0549
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/main_hmac.py
@@ -0,0 +1,201 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'e.bidelman (Eric Bidelman)'
+
+import cgi
+import os
+import gdata.auth
+import gdata.docs
+import gdata.docs.service
+import gdata.alt.appengine
+
+from appengine_utilities.sessions import Session
+from django.utils import simplejson
+from google.appengine.api import users
+from google.appengine.ext import webapp
+from google.appengine.ext.webapp import template
+from google.appengine.ext.webapp.util import run_wsgi_app
+
+SETTINGS = {
+ 'APP_NAME': 'google-GDataOAuthAppEngine-v1',
+ 'CONSUMER_KEY': 'YOUR_CONSUMER_KEY',
+ 'CONSUMER_SECRET': 'YOUR_CONSUMER_SECRET',
+ 'SIG_METHOD': gdata.auth.OAuthSignatureMethod.HMAC_SHA1,
+ 'SCOPES': ['http://docs.google.com/feeds/',
+ 'https://docs.google.com/feeds/']
+ }
+
+gdocs = gdata.docs.service.DocsService(source=SETTINGS['APP_NAME'])
+gdocs.SetOAuthInputParameters(SETTINGS['SIG_METHOD'], SETTINGS['CONSUMER_KEY'],
+ consumer_secret=SETTINGS['CONSUMER_SECRET'])
+gdata.alt.appengine.run_on_appengine(gdocs)
+
+class MainPage(webapp.RequestHandler):
+ """Main page displayed to user."""
+
+ # GET /
+ def get(self):
+ if not users.get_current_user():
+ self.redirect(users.create_login_url(self.request.uri))
+
+ access_token = gdocs.token_store.find_token('%20'.join(SETTINGS['SCOPES']))
+ if isinstance(access_token, gdata.auth.OAuthToken):
+ form_action = '/fetch_data'
+ form_value = 'Now fetch my docs!'
+ revoke_token_link = True
+ else:
+ form_action = '/get_oauth_token'
+ form_value = 'Give this website access to my Google Docs'
+ revoke_token_link = None
+
+ template_values = {
+ 'form_action': form_action,
+ 'form_value': form_value,
+ 'user': users.get_current_user(),
+ 'revoke_token_link': revoke_token_link,
+ 'oauth_token': access_token,
+ 'consumer': gdocs.GetOAuthInputParameters().GetConsumer(),
+ 'sig_method': gdocs.GetOAuthInputParameters().GetSignatureMethod().get_name()
+ }
+
+ path = os.path.join(os.path.dirname(__file__), 'index.html')
+ self.response.out.write(template.render(path, template_values))
+
+
+class OAuthDance(webapp.RequestHandler):
+ """Handler for the 3 legged OAuth dance, v1.0a."""
+
+ """This handler is responsible for fetching an initial OAuth request token,
+ redirecting the user to the approval page. When the user grants access, they
+ will be redirected back to this GET handler and their authorized request token
+ will be exchanged for a long-lived access token."""
+
+ # GET /get_oauth_token
+ def get(self):
+ """Invoked after we're redirected back from the approval page."""
+
+ self.session = Session()
+ oauth_token = gdata.auth.OAuthTokenFromUrl(self.request.uri)
+ if oauth_token:
+ oauth_token.secret = self.session['oauth_token_secret']
+ oauth_token.oauth_input_params = gdocs.GetOAuthInputParameters()
+ gdocs.SetOAuthToken(oauth_token)
+
+ # 3.) Exchange the authorized request token for an access token
+ oauth_verifier = self.request.get('oauth_verifier', default_value='')
+ access_token = gdocs.UpgradeToOAuthAccessToken(
+ oauth_verifier=oauth_verifier)
+
+ # Remember the access token in the current user's token store
+ if access_token and users.get_current_user():
+ gdocs.token_store.add_token(access_token)
+ elif access_token:
+ gdocs.current_token = access_token
+ gdocs.SetOAuthToken(access_token)
+
+ self.redirect('/')
+
+ # POST /get_oauth_token
+ def post(self):
+ """Fetches a request token and redirects the user to the approval page."""
+
+ self.session = Session()
+
+ if users.get_current_user():
+ # 1.) REQUEST TOKEN STEP. Provide the data scope(s) and the page we'll
+ # be redirected back to after the user grants access on the approval page.
+ req_token = gdocs.FetchOAuthRequestToken(
+ scopes=SETTINGS['SCOPES'], oauth_callback=self.request.uri)
+
+ # When using HMAC, persist the token secret in order to re-create an
+ # OAuthToken object coming back from the approval page.
+ self.session['oauth_token_secret'] = req_token.secret
+
+ # Generate the URL to redirect the user to. Add the hd paramter for a
+ # better user experience. Leaving it off will give the user the choice
+ # of what account (Google vs. Google Apps) to login with.
+ domain = self.request.get('domain', default_value='default')
+ approval_page_url = gdocs.GenerateOAuthAuthorizationURL(
+ extra_params={'hd': domain})
+
+ # 2.) APPROVAL STEP. Redirect to user to Google's OAuth approval page.
+ self.redirect(approval_page_url)
+
+
+class FetchData(OAuthDance):
+ """Fetches the user's data."""
+
+ """This class inherits from OAuthDance in order to utilize OAuthDance.post()
+ in case of a request error (e.g. the user has a bad token)."""
+
+ # GET /fetch_data
+ def get(self):
+ self.redirect('/')
+
+ # POST /fetch_data
+ def post(self):
+ """Fetches the user's data."""
+
+ try:
+ feed = gdocs.GetDocumentListFeed()
+ json = []
+ for entry in feed.entry:
+ if entry.lastModifiedBy is not None:
+ last_modified_by = entry.lastModifiedBy.email.text
+ else:
+ last_modified_by = ''
+ if entry.lastViewed is not None:
+ last_viewed = entry.lastViewed.text
+ else:
+ last_viewed = ''
+ json.append({'title': entry.title.text,
+ 'links': {'alternate': entry.GetHtmlLink().href},
+ 'published': entry.published.text,
+ 'updated': entry.updated.text,
+ 'resourceId': entry.resourceId.text,
+ 'type': entry.GetDocumentType(),
+ 'lastModifiedBy': last_modified_by,
+ 'lastViewed': last_viewed
+ })
+ self.response.out.write(simplejson.dumps(json))
+ except gdata.service.RequestError, error:
+ OAuthDance.post(self)
+
+class RevokeToken(webapp.RequestHandler):
+
+ # GET /revoke_token
+ def get(self):
+ """Revokes the current user's OAuth access token."""
+
+ try:
+ gdocs.RevokeOAuthToken()
+ except gdata.service.RevokingOAuthTokenFailed:
+ pass
+
+ gdocs.token_store.remove_all_tokens()
+ self.redirect('/')
+
+
+def main():
+ application = webapp.WSGIApplication([('/', MainPage),
+ ('/get_oauth_token', OAuthDance),
+ ('/fetch_data', FetchData),
+ ('/revoke_token', RevokeToken)],
+ debug=True)
+ run_wsgi_app(application)
+
diff --git a/samples/oauth/oauth_on_appengine/main_rsa.py b/samples/oauth/oauth_on_appengine/main_rsa.py
new file mode 100755
index 0000000..e7c6840
--- /dev/null
+++ b/samples/oauth/oauth_on_appengine/main_rsa.py
@@ -0,0 +1,199 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'e.bidelman (Eric Bidelman)'
+
+import cgi
+import os
+import gdata.auth
+import gdata.docs
+import gdata.docs.service
+import gdata.alt.appengine
+
+from appengine_utilities.sessions import Session
+from django.utils import simplejson
+from google.appengine.api import users
+from google.appengine.ext import webapp
+from google.appengine.ext.webapp import template
+from google.appengine.ext.webapp.util import run_wsgi_app
+
+SETTINGS = {
+ 'APP_NAME': 'google-GDataOAuthAppEngine-v1',
+ 'CONSUMER_KEY': 'YOUR_CONSUMER_KEY',
+ 'SIG_METHOD': gdata.auth.OAuthSignatureMethod.RSA_SHA1,
+ 'SCOPES': ['http://docs.google.com/feeds/',
+ 'https://docs.google.com/feeds/']
+ }
+
+f = open('/path/to/your/rsa_private_key.pem')
+RSA_KEY = f.read()
+f.close()
+
+gdocs = gdata.docs.service.DocsService(source=SETTINGS['APP_NAME'])
+gdocs.SetOAuthInputParameters(SETTINGS['SIG_METHOD'], SETTINGS['CONSUMER_KEY'],
+ rsa_key=RSA_KEY)
+gdata.alt.appengine.run_on_appengine(gdocs)
+
+class MainPage(webapp.RequestHandler):
+ """Main page displayed to user."""
+
+ # GET /
+ def get(self):
+ if not users.get_current_user():
+ self.redirect(users.create_login_url(self.request.uri))
+
+ access_token = gdocs.token_store.find_token('%20'.join(SETTINGS['SCOPES']))
+ if isinstance(access_token, gdata.auth.OAuthToken):
+ form_action = '/fetch_data'
+ form_value = 'Now fetch my docs!'
+ revoke_token_link = True
+ else:
+ form_action = '/get_oauth_token'
+ form_value = 'Give this website access to my Google Docs'
+ revoke_token_link = None
+
+ template_values = {
+ 'form_action': form_action,
+ 'form_value': form_value,
+ 'user': users.get_current_user(),
+ 'revoke_token_link': revoke_token_link,
+ 'oauth_token': access_token,
+ 'consumer': gdocs.GetOAuthInputParameters().GetConsumer(),
+ 'sig_method': gdocs.GetOAuthInputParameters().GetSignatureMethod().get_name()
+ }
+
+ path = os.path.join(os.path.dirname(__file__), 'index.html')
+ self.response.out.write(template.render(path, template_values))
+
+
+class OAuthDance(webapp.RequestHandler):
+ """Handler for the 3 legged OAuth dance, v1.0a."""
+
+ """This handler is responsible for fetching an initial OAuth request token,
+ redirecting the user to the approval page. When the user grants access, they
+ will be redirected back to this GET handler and their authorized request token
+ will be exchanged for a long-lived access token."""
+
+ # GET /get_oauth_token
+ def get(self):
+ """Invoked after we're redirected back from the approval page."""
+
+ self.session = Session()
+ oauth_token = gdata.auth.OAuthTokenFromUrl(self.request.uri)
+ if oauth_token:
+ oauth_token.oauth_input_params = gdocs.GetOAuthInputParameters()
+ gdocs.SetOAuthToken(oauth_token)
+
+ # 3.) Exchange the authorized request token for an access token
+ oauth_verifier = self.request.get('oauth_verifier', default_value='')
+ access_token = gdocs.UpgradeToOAuthAccessToken(
+ oauth_verifier=oauth_verifier)
+
+ # Remember the access token in the current user's token store
+ if access_token and users.get_current_user():
+ gdocs.token_store.add_token(access_token)
+ elif access_token:
+ gdocs.current_token = access_token
+ gdocs.SetOAuthToken(access_token)
+
+ self.redirect('/')
+
+ # POST /get_oauth_token
+ def post(self):
+ """Fetches a request token and redirects the user to the approval page."""
+
+ self.session = Session()
+
+ if users.get_current_user():
+ # 1.) REQUEST TOKEN STEP. Provide the data scope(s) and the page we'll
+ # be redirected back to after the user grants access on the approval page.
+ req_token = gdocs.FetchOAuthRequestToken(
+ scopes=SETTINGS['SCOPES'], oauth_callback=self.request.uri)
+
+ # Generate the URL to redirect the user to. Add the hd paramter for a
+ # better user experience. Leaving it off will give the user the choice
+ # of what account (Google vs. Google Apps) to login with.
+ domain = self.request.get('domain', default_value='default')
+ approval_page_url = gdocs.GenerateOAuthAuthorizationURL(
+ extra_params={'hd': domain})
+
+ # 2.) APPROVAL STEP. Redirect to user to Google's OAuth approval page.
+ self.redirect(approval_page_url)
+
+
+class FetchData(OAuthDance):
+ """Fetches the user's data."""
+
+ """This class inherits from OAuthDance in order to utilize OAuthDance.post()
+ in case of a request error (e.g. the user has a bad token)."""
+
+ # GET /fetch_data
+ def get(self):
+ self.redirect('/')
+
+ # POST /fetch_data
+ def post(self):
+ """Fetches the user's data."""
+
+ try:
+ feed = gdocs.GetDocumentListFeed()
+ json = []
+ for entry in feed.entry:
+ if entry.lastModifiedBy is not None:
+ last_modified_by = entry.lastModifiedBy.email.text
+ else:
+ last_modified_by = ''
+ if entry.lastViewed is not None:
+ last_viewed = entry.lastViewed.text
+ else:
+ last_viewed = ''
+ json.append({'title': entry.title.text,
+ 'links': {'alternate': entry.GetHtmlLink().href},
+ 'published': entry.published.text,
+ 'updated': entry.updated.text,
+ 'resourceId': entry.resourceId.text,
+ 'type': entry.GetDocumentType(),
+ 'lastModifiedBy': last_modified_by,
+ 'lastViewed': last_viewed
+ })
+ self.response.out.write(simplejson.dumps(json))
+ except gdata.service.RequestError, error:
+ OAuthDance.post(self)
+
+class RevokeToken(webapp.RequestHandler):
+
+ # GET /revoke_token
+ def get(self):
+ """Revokes the current user's OAuth access token."""
+
+ try:
+ gdocs.RevokeOAuthToken()
+ except gdata.service.RevokingOAuthTokenFailed:
+ pass
+
+ gdocs.token_store.remove_all_tokens()
+ self.redirect('/')
+
+
+def main():
+ application = webapp.WSGIApplication([('/', MainPage),
+ ('/get_oauth_token', OAuthDance),
+ ('/fetch_data', FetchData),
+ ('/revoke_token', RevokeToken)],
+ debug=True)
+ run_wsgi_app(application)
+
diff --git a/samples/sites/sites_example.py b/samples/sites/sites_example.py
new file mode 100755
index 0000000..34158f9
--- /dev/null
+++ b/samples/sites/sites_example.py
@@ -0,0 +1,438 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'e.bidelman (Eric Bidelman)'
+
+import getopt
+import mimetypes
+import os.path
+import sys
+
+import gdata.sample_util
+import gdata.sites.client
+import gdata.sites.data
+
+
+SOURCE_APP_NAME = 'googleInc-GoogleSitesAPIPythonLibSample-v1.1'
+MAIN_MENU = ['1) List site content',
+ '2) List recent activity',
+ '3) List revision history',
+ '4) Create webpage',
+ '5) Create web attachment',
+ '6) Upload attachment',
+ '7) Download attachment',
+ '8) Delete item',
+ '9) List sites',
+ '10) Create a new site',
+ "11) List site's sharing permissions",
+ '12) Change settings',
+ '13) Exit']
+SETTINGS_MENU = ['1) Change current site.',
+ '2) Change domain.']
+
+
+class SitesExample(object):
+ """Wrapper around the Sites API functionality."""
+
+ def __init__(self, site_name=None, site_domain=None, debug=False):
+ if site_domain is None:
+ site_domain = self.PromptDomain()
+
+ if site_name is None:
+ site_name = self.PromptSiteName()
+
+ mimetypes.init()
+
+ self.client = gdata.sites.client.SitesClient(
+ source=SOURCE_APP_NAME, site=site_name, domain=site_domain)
+ self.client.http_client.debug = debug
+
+ try:
+ gdata.sample_util.authorize_client(
+ self.client, service=self.client.auth_service, source=SOURCE_APP_NAME,
+ scopes=['http://sites.google.com/feeds/',
+ 'https://sites.google.com/feeds/'])
+ except gdata.client.BadAuthentication:
+ exit('Invalid user credentials given.')
+ except gdata.client.Error:
+ exit('Login Error')
+
+ def PrintMainMenu(self):
+ """Displays a menu of options for the user to choose from."""
+ print '\nSites API Sample'
+ print '================================'
+ print '\n'.join(MAIN_MENU)
+ print '================================\n'
+
+ def PrintSettingsMenu(self):
+ """Displays a menu of settings for the user change."""
+ print '\nSites API Sample > Settings'
+ print '================================'
+ print '\n'.join(SETTINGS_MENU)
+ print '================================\n'
+
+ def GetMenuChoice(self, menu):
+ """Retrieves the menu selection from the user.
+
+ Args:
+ menu: list The menu to get a selection from.
+
+ Returns:
+ The integer of the menu item chosen by the user.
+ """
+ max_choice = len(menu)
+ while True:
+ user_input = raw_input(': ')
+
+ try:
+ num = int(user_input)
+ except ValueError:
+ continue
+
+ if num <= max_choice and num > 0:
+ return num
+
+ def PromptSiteName(self):
+ site_name = ''
+ while not site_name:
+ site_name = raw_input('site name: ')
+ if not site_name:
+ print 'Please enter the name of your Google Site.'
+ return site_name
+
+ def PromptDomain(self):
+ return raw_input(('If your Site is hosted on a Google Apps domain, '
+ 'enter it (e.g. example.com): ')) or 'site'
+
+ def GetChoiceSelection(self, feed, message):
+ for i, entry in enumerate(feed.entry):
+ print '%d.) %s' % (i + 1, entry.title.text)
+ choice = 0
+ while not choice or not 0 <= choice <= len(feed.entry):
+ choice = int(raw_input(message))
+ print
+ return choice
+
+ def PrintEntry(self, entry):
+ print '%s [%s]' % (entry.title.text, entry.Kind())
+ if entry.page_name:
+ print ' page name:\t%s' % entry.page_name.text
+ if entry.content:
+ print ' content\t%s...' % str(entry.content.html)[0:100]
+
+ def PrintListItem(self, entry):
+ print '%s [%s]' % (entry.title.text, entry.Kind())
+ for col in entry.field:
+ print ' %s %s\t%s' % (col.index, col.name, col.text)
+
+ def PrintListPage(self, entry):
+ print '%s [%s]' % (entry.title.text, entry.Kind())
+ for col in entry.data.column:
+ print ' %s %s' % (col.index, col.name)
+
+ def PrintFileCabinetPage(self, entry):
+ print '%s [%s]' % (entry.title.text, entry.Kind())
+ print ' page name:\t%s' % entry.page_name.text
+ print ' content\t%s...' % str(entry.content.html)[0:100]
+
+ def PrintAttachment(self, entry):
+ print '%s [%s]' % (entry.title.text, entry.Kind())
+ if entry.summary is not None:
+ print ' description:\t%s' % entry.summary.text
+ print ' content\t%s, %s' % (entry.content.type, entry.content.src)
+
+ def PrintWebAttachment(self, entry):
+ print '%s [%s]' % (entry.title.text, entry.Kind())
+ if entry.summary.text is not None:
+ print ' description:\t%s' % entry.summary.text
+ print ' content src\t%s' % entry.content.src
+
+ def Run(self):
+ """Executes the demo application."""
+
+ try:
+ while True:
+ self.PrintMainMenu()
+ choice = self.GetMenuChoice(MAIN_MENU)
+
+ if choice == 1:
+ kind_choice = raw_input('What kind (all|%s)?: ' % '|'.join(
+ gdata.sites.data.SUPPORT_KINDS))
+ if kind_choice in gdata.sites.data.SUPPORT_KINDS:
+ uri = '%s?kind=%s' % (self.client.make_content_feed_uri(),
+ kind_choice)
+ feed = self.client.GetContentFeed(uri=uri)
+ else:
+ feed = self.client.GetContentFeed()
+
+ print "\nFetching content feed of '%s'...\n" % self.client.site
+
+ for entry in feed.entry:
+ kind = entry.Kind()
+
+ if kind == 'attachment':
+ self.PrintAttachment(entry)
+ elif kind == 'webattachment':
+ self.PrintWebAttachment(entry)
+ elif kind == 'filecabinet':
+ self.PrintFileCabinetPage(entry)
+ elif kind == 'listitem':
+ self.PrintListItem(entry)
+ elif kind == 'listpage':
+ self.PrintListPage(entry)
+ else:
+ self.PrintEntry(entry)
+
+ print ' revision:\t%s' % entry.revision.text
+ print ' updated:\t%s' % entry.updated.text
+
+ parent_link = entry.FindParentLink()
+ if parent_link:
+ print ' parent link:\t%s' % parent_link
+
+ if entry.GetAlternateLink():
+ print ' view in Sites:\t%s' % entry.GetAlternateLink().href
+
+ if entry.feed_link:
+ print ' feed of items:\t%s' % entry.feed_link.href
+
+ if entry.IsDeleted():
+ print ' deleted:\t%s' % entry.IsDeleted()
+
+ if entry.in_reply_to:
+ print ' in reply to:\t%s' % entry.in_reply_to.href
+
+ print
+
+ elif choice == 2:
+ print "\nFetching activity feed of '%s'..." % self.client.site
+ feed = self.client.GetActivityFeed()
+ for entry in feed.entry:
+ print ' %s [%s on %s]' % (entry.title.text, entry.Kind(),
+ entry.updated.text)
+
+ elif choice == 3:
+ print "\nFetching content feed of '%s'...\n" % self.client.site
+
+ feed = self.client.GetContentFeed()
+ try:
+ selection = self.GetChoiceSelection(
+ feed, 'Select a page to fetch revisions for: ')
+ except TypeError:
+ continue
+ except ValueError:
+ continue
+
+ feed = self.client.GetRevisionFeed(
+ feed.entry[selection - 1].GetNodeId())
+ for entry in feed.entry:
+ print entry.title.text
+ print ' new version on:\t%s' % entry.updated.text
+ print ' view changes:\t%s' % entry.GetAlternateLink().href
+ print ' current version:\t%s...' % str(entry.content.html)[0:100]
+ print
+
+ elif choice == 4:
+ print "\nFetching content feed of '%s'...\n" % self.client.site
+
+ feed = self.client.GetContentFeed()
+ try:
+ selection = self.GetChoiceSelection(
+ feed, 'Select a parent to upload to (or hit ENTER for none): ')
+ except ValueError:
+ selection = None
+
+ page_title = raw_input('Enter a page title: ')
+
+ parent = None
+ if selection is not None:
+ parent = feed.entry[selection - 1]
+
+ new_entry = self.client.CreatePage(
+ 'webpage', page_title, '<b>Your html content</b>',
+ parent=parent)
+ if new_entry.GetAlternateLink():
+ print 'Created. View it at: %s' % new_entry.GetAlternateLink().href
+
+ elif choice == 5:
+ print "\nFetching filecabinets on '%s'...\n" % self.client.site
+
+ uri = '%s?kind=%s' % (self.client.make_content_feed_uri(),
+ 'filecabinet')
+ feed = self.client.GetContentFeed(uri=uri)
+
+ selection = self.GetChoiceSelection(
+ feed, 'Select a filecabinet to create the web attachment on: ')
+
+ url = raw_input('Enter the URL of the attachment: ')
+ content_type = raw_input("Enter the attachment's mime type: ")
+ title = raw_input('Enter a title for the web attachment: ')
+ description = raw_input('Enter a description: ')
+
+ parent_entry = None
+ if selection is not None:
+ parent_entry = feed.entry[selection - 1]
+
+ self.client.CreateWebAttachment(url, content_type, title,
+ parent_entry, description=description)
+ print 'Created!'
+
+ elif choice == 6:
+ print "\nFetching filecainets on '%s'...\n" % self.client.site
+
+ uri = '%s?kind=%s' % (self.client.make_content_feed_uri(),
+ 'filecabinet')
+ feed = self.client.GetContentFeed(uri=uri)
+
+ selection = self.GetChoiceSelection(
+ feed, 'Select a filecabinet to upload to: ')
+
+ filepath = raw_input('Enter a filename: ')
+ page_title = raw_input('Enter a title for the file: ')
+ description = raw_input('Enter a description: ')
+
+ filename = os.path.basename(filepath)
+ file_ex = filename[filename.rfind('.'):]
+ if not file_ex in mimetypes.types_map:
+ content_type = raw_input(
+ 'Unrecognized file extension. Please enter the mime type: ')
+ else:
+ content_type = mimetypes.types_map[file_ex]
+
+ entry = None
+ if selection is not None:
+ entry = feed.entry[selection - 1]
+
+ new_entry = self.client.UploadAttachment(
+ filepath, entry, content_type=content_type, title=page_title,
+ description=description)
+ print 'Uploaded. View it at: %s' % new_entry.GetAlternateLink().href
+
+ elif choice == 7:
+ print "\nFetching all attachments on '%s'...\n" % self.client.site
+
+ uri = '%s?kind=%s' % (self.client.make_content_feed_uri(),
+ 'attachment')
+ feed = self.client.GetContentFeed(uri=uri)
+
+ selection = self.GetChoiceSelection(
+ feed, 'Select an attachment to download: ')
+
+ filepath = raw_input('Save as: ')
+
+ entry = None
+ if selection is not None:
+ entry = feed.entry[selection - 1]
+
+ self.client.DownloadAttachment(entry, filepath)
+ print 'Downloaded.'
+
+ elif choice == 8:
+ print "\nFetching content feed of '%s'...\n" % self.client.site
+
+ feed = self.client.GetContentFeed()
+ selection = self.GetChoiceSelection(feed, 'Select a page to delete: ')
+
+ entry = None
+ if selection is not None:
+ entry = feed.entry[selection - 1]
+
+ self.client.Delete(entry)
+ print 'Removed!'
+
+ elif choice == 9:
+ print ('\nFetching your list of sites for domain: %s...\n'
+ % self.client.domain)
+
+ feed = self.client.GetSiteFeed()
+ for entry in feed.entry:
+ print entry.title.text
+ print ' site name: ' + entry.site_name.text
+ if entry.summary.text:
+ print ' summary: ' + entry.summary.text
+ if entry.FindSourceLink():
+ print ' copied from site: ' + entry.FindSourceLink()
+ print ' acl feed: %s\n' % entry.FindAclLink()
+
+ elif choice == 10:
+ title = raw_input('Enter a title: ')
+ summary = raw_input('Enter a description: ')
+ theme = raw_input('Theme name (ex. "default"): ')
+
+ new_entry = self.client.CreateSite(
+ title, description=summary, theme=theme)
+ print 'Site created! View it at: ' + new_entry.GetAlternateLink().href
+
+ elif choice == 11:
+ print "\nFetching acl permissions of '%s'...\n" % self.client.site
+
+ feed = self.client.GetAclFeed()
+ for entry in feed.entry:
+ print '%s (%s) - %s' % (entry.scope.value, entry.scope.type,
+ entry.role.value)
+
+ elif choice == 12:
+ self.PrintSettingsMenu()
+ settings_choice = self.GetMenuChoice(SETTINGS_MENU)
+
+ if settings_choice == 1:
+ self.client.site = self.PromptSiteName()
+ elif settings_choice == 2:
+ self.client.domain = self.PromptDomain()
+
+ elif choice == 13:
+ print 'Later!\n'
+ return
+
+ except gdata.client.RequestError, error:
+ print error
+ except KeyboardInterrupt:
+ return
+
+
+def main():
+ """The main function runs the SitesExample application."""
+
+ print 'NOTE: Please run these tests only with a test account.\n'
+
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '',
+ ['site=', 'domain=', 'debug'])
+ except getopt.error, msg:
+ print """python sites_sample.py --site [sitename]
+ --domain [domain or "site"]
+ --debug [prints debug info if set]"""
+ sys.exit(2)
+
+ site = None
+ domain = None
+ debug = False
+
+ for option, arg in opts:
+ if option == '--site':
+ site = arg
+ elif option == '--domain':
+ domain = arg
+ elif option == '--debug':
+ debug = True
+
+ sample = SitesExample(site, domain, debug=debug)
+ sample.Run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/spreadsheets/spreadsheetExample.py b/samples/spreadsheets/spreadsheetExample.py
new file mode 100755
index 0000000..f1a59c6
--- /dev/null
+++ b/samples/spreadsheets/spreadsheetExample.py
@@ -0,0 +1,200 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.laurabeth@gmail.com (Laura Beth Lincoln)'
+
+
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import gdata.spreadsheet.service
+import gdata.service
+import atom.service
+import gdata.spreadsheet
+import atom
+import getopt
+import sys
+import string
+
+
+class SimpleCRUD:
+
+ def __init__(self, email, password):
+ self.gd_client = gdata.spreadsheet.service.SpreadsheetsService()
+ self.gd_client.email = email
+ self.gd_client.password = password
+ self.gd_client.source = 'Spreadsheets GData Sample'
+ self.gd_client.ProgrammaticLogin()
+ self.curr_key = ''
+ self.curr_wksht_id = ''
+ self.list_feed = None
+
+ def _PromptForSpreadsheet(self):
+ # Get the list of spreadsheets
+ feed = self.gd_client.GetSpreadsheetsFeed()
+ self._PrintFeed(feed)
+ input = raw_input('\nSelection: ')
+ id_parts = feed.entry[string.atoi(input)].id.text.split('/')
+ self.curr_key = id_parts[len(id_parts) - 1]
+
+ def _PromptForWorksheet(self):
+ # Get the list of worksheets
+ feed = self.gd_client.GetWorksheetsFeed(self.curr_key)
+ self._PrintFeed(feed)
+ input = raw_input('\nSelection: ')
+ id_parts = feed.entry[string.atoi(input)].id.text.split('/')
+ self.curr_wksht_id = id_parts[len(id_parts) - 1]
+
+ def _PromptForCellsAction(self):
+ print ('dump\n'
+ 'update {row} {col} {input_value}\n'
+ '\n')
+ input = raw_input('Command: ')
+ command = input.split(' ', 1)
+ if command[0] == 'dump':
+ self._CellsGetAction()
+ elif command[0] == 'update':
+ parsed = command[1].split(' ', 2)
+ if len(parsed) == 3:
+ self._CellsUpdateAction(parsed[0], parsed[1], parsed[2])
+ else:
+ self._CellsUpdateAction(parsed[0], parsed[1], '')
+ else:
+ self._InvalidCommandError(input)
+
+ def _PromptForListAction(self):
+ print ('dump\n'
+ 'insert {row_data} (example: insert label=content)\n'
+ 'update {row_index} {row_data}\n'
+ 'delete {row_index}\n'
+ 'Note: No uppercase letters in column names!\n'
+ '\n')
+ input = raw_input('Command: ')
+ command = input.split(' ' , 1)
+ if command[0] == 'dump':
+ self._ListGetAction()
+ elif command[0] == 'insert':
+ self._ListInsertAction(command[1])
+ elif command[0] == 'update':
+ parsed = command[1].split(' ', 1)
+ self._ListUpdateAction(parsed[0], parsed[1])
+ elif command[0] == 'delete':
+ self._ListDeleteAction(command[1])
+ else:
+ self._InvalidCommandError(input)
+
+ def _CellsGetAction(self):
+ # Get the feed of cells
+ feed = self.gd_client.GetCellsFeed(self.curr_key, self.curr_wksht_id)
+ self._PrintFeed(feed)
+
+ def _CellsUpdateAction(self, row, col, inputValue):
+ entry = self.gd_client.UpdateCell(row=row, col=col, inputValue=inputValue,
+ key=self.curr_key, wksht_id=self.curr_wksht_id)
+ if isinstance(entry, gdata.spreadsheet.SpreadsheetsCell):
+ print 'Updated!'
+
+ def _ListGetAction(self):
+ # Get the list feed
+ self.list_feed = self.gd_client.GetListFeed(self.curr_key, self.curr_wksht_id)
+ self._PrintFeed(self.list_feed)
+
+ def _ListInsertAction(self, row_data):
+ entry = self.gd_client.InsertRow(self._StringToDictionary(row_data),
+ self.curr_key, self.curr_wksht_id)
+ if isinstance(entry, gdata.spreadsheet.SpreadsheetsList):
+ print 'Inserted!'
+
+ def _ListUpdateAction(self, index, row_data):
+ self.list_feed = self.gd_client.GetListFeed(self.curr_key, self.curr_wksht_id)
+ entry = self.gd_client.UpdateRow(
+ self.list_feed.entry[string.atoi(index)],
+ self._StringToDictionary(row_data))
+ if isinstance(entry, gdata.spreadsheet.SpreadsheetsList):
+ print 'Updated!'
+
+ def _ListDeleteAction(self, index):
+ self.list_feed = self.gd_client.GetListFeed(self.curr_key, self.curr_wksht_id)
+ self.gd_client.DeleteRow(self.list_feed.entry[string.atoi(index)])
+ print 'Deleted!'
+
+ def _StringToDictionary(self, row_data):
+ dict = {}
+ for param in row_data.split():
+ temp = param.split('=')
+ dict[temp[0]] = temp[1]
+ return dict
+
+ def _PrintFeed(self, feed):
+ for i, entry in enumerate(feed.entry):
+ if isinstance(feed, gdata.spreadsheet.SpreadsheetsCellsFeed):
+ print '%s %s\n' % (entry.title.text, entry.content.text)
+ elif isinstance(feed, gdata.spreadsheet.SpreadsheetsListFeed):
+ print '%s %s %s' % (i, entry.title.text, entry.content.text)
+ # Print this row's value for each column (the custom dictionary is
+ # built using the gsx: elements in the entry.)
+ print 'Contents:'
+ for key in entry.custom:
+ print ' %s: %s' % (key, entry.custom[key].text)
+ print '\n',
+ else:
+ print '%s %s\n' % (i, entry.title.text)
+
+ def _InvalidCommandError(self, input):
+ print 'Invalid input: %s\n' % (input)
+
+ def Run(self):
+ self._PromptForSpreadsheet()
+ self._PromptForWorksheet()
+ input = raw_input('cells or list? ')
+ if input == 'cells':
+ while True:
+ self._PromptForCellsAction()
+ elif input == 'list':
+ while True:
+ self._PromptForListAction()
+
+
+def main():
+ # parse command line options
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], "", ["user=", "pw="])
+ except getopt.error, msg:
+ print 'python spreadsheetExample.py --user [username] --pw [password] '
+ sys.exit(2)
+
+ user = ''
+ pw = ''
+ key = ''
+ # Process options
+ for o, a in opts:
+ if o == "--user":
+ user = a
+ elif o == "--pw":
+ pw = a
+
+ if user == '' or pw == '':
+ print 'python spreadsheetExample.py --user [username] --pw [password] '
+ sys.exit(2)
+
+ sample = SimpleCRUD(user, pw)
+ sample.Run()
+
+
+if __name__ == '__main__':
+ main()
diff --git a/samples/webmastertools/AddDeleteExampleDotCom.py b/samples/webmastertools/AddDeleteExampleDotCom.py
new file mode 100755
index 0000000..c56413d
--- /dev/null
+++ b/samples/webmastertools/AddDeleteExampleDotCom.py
@@ -0,0 +1,103 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Yu-Jie Lin
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import urllib
+
+import gdata.webmastertools.service
+import gdata.service
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom
+import getpass
+
+
+username = ''
+password = ''
+
+username = raw_input('Please enter your username: ')
+password = getpass.getpass()
+
+client = gdata.webmastertools.service.GWebmasterToolsService(
+ email=username,
+ password=password, source='PythonWebmasterToolsSample-1')
+
+EXAMPLE_SITE = 'http://www.example.com/'
+EXAMPLE_SITEMAP = 'http://www.example.com/sitemap-index.xml'
+
+
+def safeElementText(element):
+ if hasattr(element, 'text'):
+ return element.text
+ return ''
+
+
+print 'Logging in'
+client.ProgrammaticLogin()
+
+print
+print 'Adding site: %s' % EXAMPLE_SITE
+entry = client.AddSite(EXAMPLE_SITE)
+
+print
+print "%-25s %25s %25s" % ('Site', 'Last Updated', 'Last Crawled')
+print '='*80
+print "%-25s %25s %25s" % (
+ entry.title.text.replace('http://', '')[:25], entry.updated.text[:25],
+ safeElementText(entry.crawled)[:25])
+print " Preferred: %-23s Indexed: %5s GeoLoc: %10s" % (
+ safeElementText(entry.preferred_domain)[:30], entry.indexed.text[:5],
+ safeElementText(entry.geolocation)[:10])
+print " Crawl rate: %-10s Verified: %5s" % (
+ safeElementText(entry.crawl_rate)[:10], entry.verified.text[:5])
+
+# Verifying a site. This sample won't do this since we don't own example.com
+#client.VerifySite(EXAMPLE_SITE, 'htmlpage')
+
+# The following needs the ownership of the site
+#client.UpdateGeoLocation(EXAMPLE_SITE, 'US')
+#client.UpdateCrawlRate(EXAMPLE_SITE, 'normal')
+#client.UpdatePreferredDomain(EXAMPLE_SITE, 'preferwww')
+#client.UpdateEnhancedImageSearch(EXAMPLE_SITE, 'true')
+
+print
+print 'Adding sitemap: %s' % EXAMPLE_SITEMAP
+entry = client.AddSitemap(EXAMPLE_SITE, EXAMPLE_SITEMAP)
+
+print entry.title.text.replace('http://', '')[:80]
+print " Last Updated : %29s Status: %10s" % (
+ entry.updated.text[:29], entry.sitemap_status.text[:10])
+print " Last Downloaded: %29s URL Count: %10s" % (
+ safeElementText(entry.sitemap_last_downloaded)[:29],
+ safeElementText(entry.sitemap_url_count)[:10])
+
+# Add a mobile sitemap
+#entry = client.AddMobileSitemap(EXAMPLE_SITE, 'http://.../sitemap-mobile-example.xml', 'XHTML')
+
+# Add a news sitemap, your site must be included in Google News.
+# See also http://google.com/support/webmasters/bin/answer.py?answer=42738
+#entry = client.AddNewsSitemap(EXAMPLE_SITE, 'http://.../sitemap-news-example.xml', 'Label')
+
+print
+print 'Deleting sitemap: %s' % EXAMPLE_SITEMAP
+client.DeleteSitemap(EXAMPLE_SITE, EXAMPLE_SITEMAP)
+
+print
+print 'Deleting site: %s' % EXAMPLE_SITE
+client.DeleteSite(EXAMPLE_SITE)
+print
diff --git a/samples/webmastertools/SitemapsFeedSummary.py b/samples/webmastertools/SitemapsFeedSummary.py
new file mode 100755
index 0000000..7c4d246
--- /dev/null
+++ b/samples/webmastertools/SitemapsFeedSummary.py
@@ -0,0 +1,68 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Yu-Jie Lin
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import gdata.webmastertools.service
+import gdata.service
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom
+import getpass
+
+
+username = ''
+password = ''
+site_uri = ''
+
+username = raw_input('Please enter your username: ')
+password = getpass.getpass()
+site_uri = raw_input('Please enter your site url: ')
+
+client = gdata.webmastertools.service.GWebmasterToolsService(
+ email=username,
+ password=password, source='PythonWebmasterToolsSample-1')
+
+print 'Logging in'
+client.ProgrammaticLogin()
+
+print 'Retrieving Sitemaps feed'
+feed = client.GetSitemapsFeed(site_uri)
+
+# Format the feed
+print
+print 'You have %d sitemap(s), last updated at %s' % (
+ len(feed.entry), feed.updated.text)
+print
+print '='*80
+
+
+def safeElementText(element):
+ if hasattr(element, 'text'):
+ return element.text
+ return ''
+
+
+# Format each site
+for entry in feed.entry:
+ print entry.title.text.replace('http://', '')[:80]
+ print " Last Updated : %29s Status: %10s" % (
+ entry.updated.text[:29], entry.sitemap_status.text[:10])
+ print " Last Downloaded: %29s URL Count: %10s" % (
+ safeElementText(entry.sitemap_last_downloaded)[:29],
+ safeElementText(entry.sitemap_url_count)[:10])
+print
diff --git a/samples/webmastertools/SitesFeedSummary.py b/samples/webmastertools/SitesFeedSummary.py
new file mode 100755
index 0000000..62827ad
--- /dev/null
+++ b/samples/webmastertools/SitesFeedSummary.py
@@ -0,0 +1,70 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Yu-Jie Lin
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import gdata.webmastertools.service
+import gdata.service
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom
+import getpass
+
+
+username = ''
+password = ''
+
+username = raw_input('Please enter your username: ')
+password = getpass.getpass()
+
+client = gdata.webmastertools.service.GWebmasterToolsService(
+ email=username,
+ password=password, source='PythonWebmasterToolsSample-1')
+
+print 'Logging in'
+client.ProgrammaticLogin()
+
+print 'Retrieving Sites feed'
+feed = client.GetSitesFeed()
+
+# Format the feed
+print
+print 'You have %d site(s), last updated at %s' % (
+ len(feed.entry), feed.updated.text)
+print
+print "%-25s %25s %25s" % ('Site', 'Last Updated', 'Last Crawled')
+print '='*80
+
+
+def safeElementText(element):
+ if hasattr(element, 'text'):
+ return element.text
+ return ''
+
+
+# Format each site
+for entry in feed.entry:
+ print "%-25s %25s %25s" % (
+ entry.title.text.replace('http://', '')[:25], entry.updated.text[:25],
+ safeElementText(entry.crawled)[:25])
+ print " Preferred: %-23s Indexed: %5s GeoLoc: %10s" % (
+ safeElementText(entry.preferred_domain)[:30], entry.indexed.text[:5],
+ safeElementText(entry.geolocation)[:10])
+ print " Crawl rate: %-10s Verified: %5s" % (
+ safeElementText(entry.crawl_rate)[:10], entry.verified.text[:5])
+
+print
diff --git a/setup.py b/setup.py
new file mode 100644
index 0000000..633e516
--- /dev/null
+++ b/setup.py
@@ -0,0 +1,115 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import sys
+from distutils.core import setup
+
+required = []
+
+if sys.version_info[:3] < (2, 5, 0):
+ required.append('elementtree')
+
+setup(
+ name='gdata',
+ version='2.0.18',
+ description='Python client library for Google data APIs',
+ long_description = """\
+The Google data Python client library makes it easy to interact with
+Google services through the Google Data APIs. This library provides data
+models and service modules for the the following Google data services:
+- Google Calendar data API
+- Google Contacts data API
+- Google Spreadsheets data API
+- Google Document List data APIs
+- Google Base data API
+- Google Apps Provisioning API
+- Google Apps Email Migration API
+- Google Apps Email Settings API
+- Picasa Web Albums Data API
+- Google Code Search Data API
+- YouTube Data API
+- Google Webmaster Tools Data API
+- Blogger Data API
+- Google Health API
+- Google Book Search API
+- Google Analytics API
+- Google Finance API
+- Google Sites Data API
+- Google Content API For Shopping
+- Google App Marketplace API
+- Google Content API for Shopping
+- core Google data API functionality
+The core Google data code provides sufficient functionality to use this
+library with any Google data API (even if a module hasn't been written for
+it yet). For example, this client can be used with the Notebook API. This
+library may also be used with any Atom Publishing Protocol service (AtomPub).
+""",
+ author='Jeffrey Scudder',
+ author_email='j.s@google.com',
+ license='Apache 2.0',
+ url='http://code.google.com/p/gdata-python-client/',
+ packages=[
+ 'atom',
+ 'gdata',
+ 'gdata.Crypto',
+ 'gdata.Crypto.Cipher',
+ 'gdata.Crypto.Hash',
+ 'gdata.Crypto.Protocol',
+ 'gdata.Crypto.PublicKey',
+ 'gdata.Crypto.Util',
+ 'gdata.acl',
+ 'gdata.alt',
+ 'gdata.analytics',
+ 'gdata.apps',
+ 'gdata.apps.adminsettings',
+ 'gdata.apps.audit',
+ 'gdata.apps.emailsettings',
+ 'gdata.apps.groups',
+ 'gdata.apps.migration',
+ 'gdata.apps.multidomain',
+ 'gdata.apps.organization',
+ 'gdata.blogger',
+ 'gdata.books',
+ 'gdata.calendar',
+ 'gdata.calendar_resource',
+ 'gdata.codesearch',
+ 'gdata.contacts',
+ 'gdata.contentforshopping',
+ 'gdata.docs',
+ 'gdata.dublincore',
+ 'gdata.exif',
+ 'gdata.finance',
+ 'gdata.geo',
+ 'gdata.health',
+ 'gdata.media',
+ 'gdata.notebook',
+ 'gdata.oauth',
+ 'gdata.opensearch',
+ 'gdata.photos',
+ 'gdata.projecthosting',
+ 'gdata.sites',
+ 'gdata.spreadsheet',
+ 'gdata.spreadsheets',
+ 'gdata.tlslite',
+ 'gdata.tlslite.integration',
+ 'gdata.tlslite.utils',
+ 'gdata.webmastertools',
+ 'gdata.youtube',
+ ],
+ package_dir = {'gdata':'src/gdata', 'atom':'src/atom'},
+ install_requires=required
+)
diff --git a/src/atom/__init__.py b/src/atom/__init__.py
new file mode 100755
index 0000000..6aa96c1
--- /dev/null
+++ b/src/atom/__init__.py
@@ -0,0 +1,1484 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains classes representing Atom elements.
+
+ Module objective: provide data classes for Atom constructs. These classes hide
+ the XML-ness of Atom and provide a set of native Python classes to interact
+ with.
+
+ Conversions to and from XML should only be necessary when the Atom classes
+ "touch the wire" and are sent over HTTP. For this reason this module
+ provides methods and functions to convert Atom classes to and from strings.
+
+ For more information on the Atom data model, see RFC 4287
+ (http://www.ietf.org/rfc/rfc4287.txt)
+
+ AtomBase: A foundation class on which Atom classes are built. It
+ handles the parsing of attributes and children which are common to all
+ Atom classes. By default, the AtomBase class translates all XML child
+ nodes into ExtensionElements.
+
+ ExtensionElement: Atom allows Atom objects to contain XML which is not part
+ of the Atom specification, these are called extension elements. If a
+ classes parser encounters an unexpected XML construct, it is translated
+ into an ExtensionElement instance. ExtensionElement is designed to fully
+ capture the information in the XML. Child nodes in an XML extension are
+ turned into ExtensionElements as well.
+"""
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import warnings
+
+
+# XML namespaces which are often used in Atom entities.
+ATOM_NAMESPACE = 'http://www.w3.org/2005/Atom'
+ELEMENT_TEMPLATE = '{http://www.w3.org/2005/Atom}%s'
+APP_NAMESPACE = 'http://purl.org/atom/app#'
+APP_TEMPLATE = '{http://purl.org/atom/app#}%s'
+
+# This encoding is used for converting strings before translating the XML
+# into an object.
+XML_STRING_ENCODING = 'utf-8'
+# The desired string encoding for object members. set or monkey-patch to
+# unicode if you want object members to be Python unicode strings, instead of
+# encoded strings
+MEMBER_STRING_ENCODING = 'utf-8'
+#MEMBER_STRING_ENCODING = unicode
+
+# If True, all methods which are exclusive to v1 will raise a
+# DeprecationWarning
+ENABLE_V1_WARNINGS = False
+
+
+def v1_deprecated(warning=None):
+ """Shows a warning if ENABLE_V1_WARNINGS is True.
+
+ Function decorator used to mark methods used in v1 classes which
+ may be removed in future versions of the library.
+ """
+ warning = warning or ''
+ # This closure is what is returned from the deprecated function.
+ def mark_deprecated(f):
+ # The deprecated_function wraps the actual call to f.
+ def optional_warn_function(*args, **kwargs):
+ if ENABLE_V1_WARNINGS:
+ warnings.warn(warning, DeprecationWarning, stacklevel=2)
+ return f(*args, **kwargs)
+ # Preserve the original name to avoid masking all decorated functions as
+ # 'deprecated_function'
+ try:
+ optional_warn_function.func_name = f.func_name
+ except TypeError:
+ pass # In Python2.3 we can't set the func_name
+ return optional_warn_function
+ return mark_deprecated
+
+
+def CreateClassFromXMLString(target_class, xml_string, string_encoding=None):
+ """Creates an instance of the target class from the string contents.
+
+ Args:
+ target_class: class The class which will be instantiated and populated
+ with the contents of the XML. This class must have a _tag and a
+ _namespace class variable.
+ xml_string: str A string which contains valid XML. The root element
+ of the XML string should match the tag and namespace of the desired
+ class.
+ string_encoding: str The character encoding which the xml_string should
+ be converted to before it is interpreted and translated into
+ objects. The default is None in which case the string encoding
+ is not changed.
+
+ Returns:
+ An instance of the target class with members assigned according to the
+ contents of the XML - or None if the root XML tag and namespace did not
+ match those of the target class.
+ """
+ encoding = string_encoding or XML_STRING_ENCODING
+ if encoding and isinstance(xml_string, unicode):
+ xml_string = xml_string.encode(encoding)
+ tree = ElementTree.fromstring(xml_string)
+ return _CreateClassFromElementTree(target_class, tree)
+
+
+CreateClassFromXMLString = v1_deprecated(
+ 'Please use atom.core.parse with atom.data classes instead.')(
+ CreateClassFromXMLString)
+
+
+def _CreateClassFromElementTree(target_class, tree, namespace=None, tag=None):
+ """Instantiates the class and populates members according to the tree.
+
+ Note: Only use this function with classes that have _namespace and _tag
+ class members.
+
+ Args:
+ target_class: class The class which will be instantiated and populated
+ with the contents of the XML.
+ tree: ElementTree An element tree whose contents will be converted into
+ members of the new target_class instance.
+ namespace: str (optional) The namespace which the XML tree's root node must
+ match. If omitted, the namespace defaults to the _namespace of the
+ target class.
+ tag: str (optional) The tag which the XML tree's root node must match. If
+ omitted, the tag defaults to the _tag class member of the target
+ class.
+
+ Returns:
+ An instance of the target class - or None if the tag and namespace of
+ the XML tree's root node did not match the desired namespace and tag.
+ """
+ if namespace is None:
+ namespace = target_class._namespace
+ if tag is None:
+ tag = target_class._tag
+ if tree.tag == '{%s}%s' % (namespace, tag):
+ target = target_class()
+ target._HarvestElementTree(tree)
+ return target
+ else:
+ return None
+
+
+class ExtensionContainer(object):
+
+ def __init__(self, extension_elements=None, extension_attributes=None,
+ text=None):
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ self.text = text
+
+ __init__ = v1_deprecated(
+ 'Please use data model classes in atom.data instead.')(
+ __init__)
+
+ # Three methods to create an object from an ElementTree
+ def _HarvestElementTree(self, tree):
+ # Fill in the instance members from the contents of the XML tree.
+ for child in tree:
+ self._ConvertElementTreeToMember(child)
+ for attribute, value in tree.attrib.iteritems():
+ self._ConvertElementAttributeToMember(attribute, value)
+ # Encode the text string according to the desired encoding type. (UTF-8)
+ if tree.text:
+ if MEMBER_STRING_ENCODING is unicode:
+ self.text = tree.text
+ else:
+ self.text = tree.text.encode(MEMBER_STRING_ENCODING)
+
+ def _ConvertElementTreeToMember(self, child_tree, current_class=None):
+ self.extension_elements.append(_ExtensionElementFromElementTree(
+ child_tree))
+
+ def _ConvertElementAttributeToMember(self, attribute, value):
+ # Encode the attribute value's string with the desired type Default UTF-8
+ if value:
+ if MEMBER_STRING_ENCODING is unicode:
+ self.extension_attributes[attribute] = value
+ else:
+ self.extension_attributes[attribute] = value.encode(
+ MEMBER_STRING_ENCODING)
+
+ # One method to create an ElementTree from an object
+ def _AddMembersToElementTree(self, tree):
+ for child in self.extension_elements:
+ child._BecomeChildElement(tree)
+ for attribute, value in self.extension_attributes.iteritems():
+ if value:
+ if isinstance(value, unicode) or MEMBER_STRING_ENCODING is unicode:
+ tree.attrib[attribute] = value
+ else:
+ # Decode the value from the desired encoding (default UTF-8).
+ tree.attrib[attribute] = value.decode(MEMBER_STRING_ENCODING)
+ if self.text:
+ if isinstance(self.text, unicode) or MEMBER_STRING_ENCODING is unicode:
+ tree.text = self.text
+ else:
+ tree.text = self.text.decode(MEMBER_STRING_ENCODING)
+
+ def FindExtensions(self, tag=None, namespace=None):
+ """Searches extension elements for child nodes with the desired name.
+
+ Returns a list of extension elements within this object whose tag
+ and/or namespace match those passed in. To find all extensions in
+ a particular namespace, specify the namespace but not the tag name.
+ If you specify only the tag, the result list may contain extension
+ elements in multiple namespaces.
+
+ Args:
+ tag: str (optional) The desired tag
+ namespace: str (optional) The desired namespace
+
+ Returns:
+ A list of elements whose tag and/or namespace match the parameters
+ values
+ """
+
+ results = []
+
+ if tag and namespace:
+ for element in self.extension_elements:
+ if element.tag == tag and element.namespace == namespace:
+ results.append(element)
+ elif tag and not namespace:
+ for element in self.extension_elements:
+ if element.tag == tag:
+ results.append(element)
+ elif namespace and not tag:
+ for element in self.extension_elements:
+ if element.namespace == namespace:
+ results.append(element)
+ else:
+ for element in self.extension_elements:
+ results.append(element)
+
+ return results
+
+
+class AtomBase(ExtensionContainer):
+
+ _children = {}
+ _attributes = {}
+
+ def __init__(self, extension_elements=None, extension_attributes=None,
+ text=None):
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ self.text = text
+
+ __init__ = v1_deprecated(
+ 'Please use data model classes in atom.data instead.')(
+ __init__)
+
+ def _ConvertElementTreeToMember(self, child_tree):
+ # Find the element's tag in this class's list of child members
+ if self.__class__._children.has_key(child_tree.tag):
+ member_name = self.__class__._children[child_tree.tag][0]
+ member_class = self.__class__._children[child_tree.tag][1]
+ # If the class member is supposed to contain a list, make sure the
+ # matching member is set to a list, then append the new member
+ # instance to the list.
+ if isinstance(member_class, list):
+ if getattr(self, member_name) is None:
+ setattr(self, member_name, [])
+ getattr(self, member_name).append(_CreateClassFromElementTree(
+ member_class[0], child_tree))
+ else:
+ setattr(self, member_name,
+ _CreateClassFromElementTree(member_class, child_tree))
+ else:
+ ExtensionContainer._ConvertElementTreeToMember(self, child_tree)
+
+ def _ConvertElementAttributeToMember(self, attribute, value):
+ # Find the attribute in this class's list of attributes.
+ if self.__class__._attributes.has_key(attribute):
+ # Find the member of this class which corresponds to the XML attribute
+ # (lookup in current_class._attributes) and set this member to the
+ # desired value (using self.__dict__).
+ if value:
+ # Encode the string to capture non-ascii characters (default UTF-8)
+ if MEMBER_STRING_ENCODING is unicode:
+ setattr(self, self.__class__._attributes[attribute], value)
+ else:
+ setattr(self, self.__class__._attributes[attribute],
+ value.encode(MEMBER_STRING_ENCODING))
+ else:
+ ExtensionContainer._ConvertElementAttributeToMember(
+ self, attribute, value)
+
+ # Three methods to create an ElementTree from an object
+ def _AddMembersToElementTree(self, tree):
+ # Convert the members of this class which are XML child nodes.
+ # This uses the class's _children dictionary to find the members which
+ # should become XML child nodes.
+ member_node_names = [values[0] for tag, values in
+ self.__class__._children.iteritems()]
+ for member_name in member_node_names:
+ member = getattr(self, member_name)
+ if member is None:
+ pass
+ elif isinstance(member, list):
+ for instance in member:
+ instance._BecomeChildElement(tree)
+ else:
+ member._BecomeChildElement(tree)
+ # Convert the members of this class which are XML attributes.
+ for xml_attribute, member_name in self.__class__._attributes.iteritems():
+ member = getattr(self, member_name)
+ if member is not None:
+ if isinstance(member, unicode) or MEMBER_STRING_ENCODING is unicode:
+ tree.attrib[xml_attribute] = member
+ else:
+ tree.attrib[xml_attribute] = member.decode(MEMBER_STRING_ENCODING)
+ # Lastly, call the ExtensionContainers's _AddMembersToElementTree to
+ # convert any extension attributes.
+ ExtensionContainer._AddMembersToElementTree(self, tree)
+
+
+ def _BecomeChildElement(self, tree):
+ """
+
+ Note: Only for use with classes that have a _tag and _namespace class
+ member. It is in AtomBase so that it can be inherited but it should
+ not be called on instances of AtomBase.
+
+ """
+ new_child = ElementTree.Element('')
+ tree.append(new_child)
+ new_child.tag = '{%s}%s' % (self.__class__._namespace,
+ self.__class__._tag)
+ self._AddMembersToElementTree(new_child)
+
+ def _ToElementTree(self):
+ """
+
+ Note, this method is designed to be used only with classes that have a
+ _tag and _namespace. It is placed in AtomBase for inheritance but should
+ not be called on this class.
+
+ """
+ new_tree = ElementTree.Element('{%s}%s' % (self.__class__._namespace,
+ self.__class__._tag))
+ self._AddMembersToElementTree(new_tree)
+ return new_tree
+
+ def ToString(self, string_encoding='UTF-8'):
+ """Converts the Atom object to a string containing XML."""
+ return ElementTree.tostring(self._ToElementTree(), encoding=string_encoding)
+
+ def __str__(self):
+ return self.ToString()
+
+
+class Name(AtomBase):
+ """The atom:name element"""
+
+ _tag = 'name'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Name
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def NameFromString(xml_string):
+ return CreateClassFromXMLString(Name, xml_string)
+
+
+class Email(AtomBase):
+ """The atom:email element"""
+
+ _tag = 'email'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Email
+
+ Args:
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ text: str The text data in the this element
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def EmailFromString(xml_string):
+ return CreateClassFromXMLString(Email, xml_string)
+
+
+class Uri(AtomBase):
+ """The atom:uri element"""
+
+ _tag = 'uri'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Uri
+
+ Args:
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ text: str The text data in the this element
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def UriFromString(xml_string):
+ return CreateClassFromXMLString(Uri, xml_string)
+
+
+class Person(AtomBase):
+ """A foundation class from which atom:author and atom:contributor extend.
+
+ A person contains information like name, email address, and web page URI for
+ an author or contributor to an Atom feed.
+ """
+
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _children['{%s}name' % (ATOM_NAMESPACE)] = ('name', Name)
+ _children['{%s}email' % (ATOM_NAMESPACE)] = ('email', Email)
+ _children['{%s}uri' % (ATOM_NAMESPACE)] = ('uri', Uri)
+
+ def __init__(self, name=None, email=None, uri=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ """Foundation from which author and contributor are derived.
+
+ The constructor is provided for illustrative purposes, you should not
+ need to instantiate a Person.
+
+ Args:
+ name: Name The person's name
+ email: Email The person's email address
+ uri: Uri The URI of the person's webpage
+ extension_elements: list A list of ExtensionElement instances which are
+ children of this element.
+ extension_attributes: dict A dictionary of strings which are the values
+ for additional XML attributes of this element.
+ text: String The text contents of the element. This is the contents
+ of the Entry's XML text node. (Example: <foo>This is the text</foo>)
+ """
+
+ self.name = name
+ self.email = email
+ self.uri = uri
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ self.text = text
+
+
+class Author(Person):
+ """The atom:author element
+
+ An author is a required element in Feed.
+ """
+
+ _tag = 'author'
+ _namespace = ATOM_NAMESPACE
+ _children = Person._children.copy()
+ _attributes = Person._attributes.copy()
+ #_children = {}
+ #_attributes = {}
+
+ def __init__(self, name=None, email=None, uri=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ """Constructor for Author
+
+ Args:
+ name: Name
+ email: Email
+ uri: Uri
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ text: str The text data in the this element
+ """
+
+ self.name = name
+ self.email = email
+ self.uri = uri
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ self.text = text
+
+
+def AuthorFromString(xml_string):
+ return CreateClassFromXMLString(Author, xml_string)
+
+
+class Contributor(Person):
+ """The atom:contributor element"""
+
+ _tag = 'contributor'
+ _namespace = ATOM_NAMESPACE
+ _children = Person._children.copy()
+ _attributes = Person._attributes.copy()
+
+ def __init__(self, name=None, email=None, uri=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ """Constructor for Contributor
+
+ Args:
+ name: Name
+ email: Email
+ uri: Uri
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ text: str The text data in the this element
+ """
+
+ self.name = name
+ self.email = email
+ self.uri = uri
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ self.text = text
+
+
+def ContributorFromString(xml_string):
+ return CreateClassFromXMLString(Contributor, xml_string)
+
+
+class Link(AtomBase):
+ """The atom:link element"""
+
+ _tag = 'link'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _attributes['rel'] = 'rel'
+ _attributes['href'] = 'href'
+ _attributes['type'] = 'type'
+ _attributes['title'] = 'title'
+ _attributes['length'] = 'length'
+ _attributes['hreflang'] = 'hreflang'
+
+ def __init__(self, href=None, rel=None, link_type=None, hreflang=None,
+ title=None, length=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Link
+
+ Args:
+ href: string The href attribute of the link
+ rel: string
+ type: string
+ hreflang: string The language for the href
+ title: string
+ length: string The length of the href's destination
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ text: str The text data in the this element
+ """
+
+ self.href = href
+ self.rel = rel
+ self.type = link_type
+ self.hreflang = hreflang
+ self.title = title
+ self.length = length
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def LinkFromString(xml_string):
+ return CreateClassFromXMLString(Link, xml_string)
+
+
+class Generator(AtomBase):
+ """The atom:generator element"""
+
+ _tag = 'generator'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _attributes['uri'] = 'uri'
+ _attributes['version'] = 'version'
+
+ def __init__(self, uri=None, version=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ """Constructor for Generator
+
+ Args:
+ uri: string
+ version: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.uri = uri
+ self.version = version
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+def GeneratorFromString(xml_string):
+ return CreateClassFromXMLString(Generator, xml_string)
+
+
+class Text(AtomBase):
+ """A foundation class from which atom:title, summary, etc. extend.
+
+ This class should never be instantiated.
+ """
+
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _attributes['type'] = 'type'
+
+ def __init__(self, text_type=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Text
+
+ Args:
+ text_type: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = text_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Title(Text):
+ """The atom:title element"""
+
+ _tag = 'title'
+ _namespace = ATOM_NAMESPACE
+ _children = Text._children.copy()
+ _attributes = Text._attributes.copy()
+
+ def __init__(self, title_type=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Title
+
+ Args:
+ title_type: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = title_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def TitleFromString(xml_string):
+ return CreateClassFromXMLString(Title, xml_string)
+
+
+class Subtitle(Text):
+ """The atom:subtitle element"""
+
+ _tag = 'subtitle'
+ _namespace = ATOM_NAMESPACE
+ _children = Text._children.copy()
+ _attributes = Text._attributes.copy()
+
+ def __init__(self, subtitle_type=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Subtitle
+
+ Args:
+ subtitle_type: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = subtitle_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SubtitleFromString(xml_string):
+ return CreateClassFromXMLString(Subtitle, xml_string)
+
+
+class Rights(Text):
+ """The atom:rights element"""
+
+ _tag = 'rights'
+ _namespace = ATOM_NAMESPACE
+ _children = Text._children.copy()
+ _attributes = Text._attributes.copy()
+
+ def __init__(self, rights_type=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Rights
+
+ Args:
+ rights_type: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = rights_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def RightsFromString(xml_string):
+ return CreateClassFromXMLString(Rights, xml_string)
+
+
+class Summary(Text):
+ """The atom:summary element"""
+
+ _tag = 'summary'
+ _namespace = ATOM_NAMESPACE
+ _children = Text._children.copy()
+ _attributes = Text._attributes.copy()
+
+ def __init__(self, summary_type=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Summary
+
+ Args:
+ summary_type: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = summary_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SummaryFromString(xml_string):
+ return CreateClassFromXMLString(Summary, xml_string)
+
+
+class Content(Text):
+ """The atom:content element"""
+
+ _tag = 'content'
+ _namespace = ATOM_NAMESPACE
+ _children = Text._children.copy()
+ _attributes = Text._attributes.copy()
+ _attributes['src'] = 'src'
+
+ def __init__(self, content_type=None, src=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ """Constructor for Content
+
+ Args:
+ content_type: string
+ src: string
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.type = content_type
+ self.src = src
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+def ContentFromString(xml_string):
+ return CreateClassFromXMLString(Content, xml_string)
+
+
+class Category(AtomBase):
+ """The atom:category element"""
+
+ _tag = 'category'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _attributes['term'] = 'term'
+ _attributes['scheme'] = 'scheme'
+ _attributes['label'] = 'label'
+
+ def __init__(self, term=None, scheme=None, label=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ """Constructor for Category
+
+ Args:
+ term: str
+ scheme: str
+ label: str
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.term = term
+ self.scheme = scheme
+ self.label = label
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def CategoryFromString(xml_string):
+ return CreateClassFromXMLString(Category, xml_string)
+
+
+class Id(AtomBase):
+ """The atom:id element."""
+
+ _tag = 'id'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Id
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def IdFromString(xml_string):
+ return CreateClassFromXMLString(Id, xml_string)
+
+
+class Icon(AtomBase):
+ """The atom:icon element."""
+
+ _tag = 'icon'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Icon
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def IconFromString(xml_string):
+ return CreateClassFromXMLString(Icon, xml_string)
+
+
+class Logo(AtomBase):
+ """The atom:logo element."""
+
+ _tag = 'logo'
+ _namespace = ATOM_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Logo
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def LogoFromString(xml_string):
+ return CreateClassFromXMLString(Logo, xml_string)
+
+
+class Draft(AtomBase):
+ """The app:draft element which indicates if this entry should be public."""
+
+ _tag = 'draft'
+ _namespace = APP_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for app:draft
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def DraftFromString(xml_string):
+ return CreateClassFromXMLString(Draft, xml_string)
+
+
+class Control(AtomBase):
+ """The app:control element indicating restrictions on publication.
+
+ The APP control element may contain a draft element indicating whether or
+ not this entry should be publicly available.
+ """
+
+ _tag = 'control'
+ _namespace = APP_NAMESPACE
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _children['{%s}draft' % APP_NAMESPACE] = ('draft', Draft)
+
+ def __init__(self, draft=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for app:control"""
+
+ self.draft = draft
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def ControlFromString(xml_string):
+ return CreateClassFromXMLString(Control, xml_string)
+
+
+class Date(AtomBase):
+ """A parent class for atom:updated, published, etc."""
+
+ #TODO Add text to and from time conversion methods to allow users to set
+ # the contents of a Date to a python DateTime object.
+
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Updated(Date):
+ """The atom:updated element."""
+
+ _tag = 'updated'
+ _namespace = ATOM_NAMESPACE
+ _children = Date._children.copy()
+ _attributes = Date._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Updated
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def UpdatedFromString(xml_string):
+ return CreateClassFromXMLString(Updated, xml_string)
+
+
+class Published(Date):
+ """The atom:published element."""
+
+ _tag = 'published'
+ _namespace = ATOM_NAMESPACE
+ _children = Date._children.copy()
+ _attributes = Date._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ """Constructor for Published
+
+ Args:
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def PublishedFromString(xml_string):
+ return CreateClassFromXMLString(Published, xml_string)
+
+
+class LinkFinder(object):
+ """An "interface" providing methods to find link elements
+
+ Entry elements often contain multiple links which differ in the rel
+ attribute or content type. Often, developers are interested in a specific
+ type of link so this class provides methods to find specific classes of
+ links.
+
+ This class is used as a mixin in Atom entries and feeds.
+ """
+
+ def GetSelfLink(self):
+ """Find the first link with rel set to 'self'
+
+ Returns:
+ An atom.Link or none if none of the links had rel equal to 'self'
+ """
+
+ for a_link in self.link:
+ if a_link.rel == 'self':
+ return a_link
+ return None
+
+ def GetEditLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'edit':
+ return a_link
+ return None
+
+ def GetEditMediaLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'edit-media':
+ return a_link
+ return None
+
+ def GetNextLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'next':
+ return a_link
+ return None
+
+ def GetLicenseLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'license':
+ return a_link
+ return None
+
+ def GetAlternateLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'alternate':
+ return a_link
+ return None
+
+
+class FeedEntryParent(AtomBase, LinkFinder):
+ """A super class for atom:feed and entry, contains shared attributes"""
+
+ _children = AtomBase._children.copy()
+ _attributes = AtomBase._attributes.copy()
+ _children['{%s}author' % ATOM_NAMESPACE] = ('author', [Author])
+ _children['{%s}category' % ATOM_NAMESPACE] = ('category', [Category])
+ _children['{%s}contributor' % ATOM_NAMESPACE] = ('contributor', [Contributor])
+ _children['{%s}id' % ATOM_NAMESPACE] = ('id', Id)
+ _children['{%s}link' % ATOM_NAMESPACE] = ('link', [Link])
+ _children['{%s}rights' % ATOM_NAMESPACE] = ('rights', Rights)
+ _children['{%s}title' % ATOM_NAMESPACE] = ('title', Title)
+ _children['{%s}updated' % ATOM_NAMESPACE] = ('updated', Updated)
+
+ def __init__(self, author=None, category=None, contributor=None,
+ atom_id=None, link=None, rights=None, title=None, updated=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ self.author = author or []
+ self.category = category or []
+ self.contributor = contributor or []
+ self.id = atom_id
+ self.link = link or []
+ self.rights = rights
+ self.title = title
+ self.updated = updated
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Source(FeedEntryParent):
+ """The atom:source element"""
+
+ _tag = 'source'
+ _namespace = ATOM_NAMESPACE
+ _children = FeedEntryParent._children.copy()
+ _attributes = FeedEntryParent._attributes.copy()
+ _children['{%s}generator' % ATOM_NAMESPACE] = ('generator', Generator)
+ _children['{%s}icon' % ATOM_NAMESPACE] = ('icon', Icon)
+ _children['{%s}logo' % ATOM_NAMESPACE] = ('logo', Logo)
+ _children['{%s}subtitle' % ATOM_NAMESPACE] = ('subtitle', Subtitle)
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ """Constructor for Source
+
+ Args:
+ author: list (optional) A list of Author instances which belong to this
+ class.
+ category: list (optional) A list of Category instances
+ contributor: list (optional) A list on Contributor instances
+ generator: Generator (optional)
+ icon: Icon (optional)
+ id: Id (optional) The entry's Id element
+ link: list (optional) A list of Link instances
+ logo: Logo (optional)
+ rights: Rights (optional) The entry's Rights element
+ subtitle: Subtitle (optional) The entry's subtitle element
+ title: Title (optional) the entry's title element
+ updated: Updated (optional) the entry's updated element
+ text: String (optional) The text contents of the element. This is the
+ contents of the Entry's XML text node.
+ (Example: <foo>This is the text</foo>)
+ extension_elements: list (optional) A list of ExtensionElement instances
+ which are children of this element.
+ extension_attributes: dict (optional) A dictionary of strings which are
+ the values for additional XML attributes of this element.
+ """
+
+ self.author = author or []
+ self.category = category or []
+ self.contributor = contributor or []
+ self.generator = generator
+ self.icon = icon
+ self.id = atom_id
+ self.link = link or []
+ self.logo = logo
+ self.rights = rights
+ self.subtitle = subtitle
+ self.title = title
+ self.updated = updated
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SourceFromString(xml_string):
+ return CreateClassFromXMLString(Source, xml_string)
+
+
+class Entry(FeedEntryParent):
+ """The atom:entry element"""
+
+ _tag = 'entry'
+ _namespace = ATOM_NAMESPACE
+ _children = FeedEntryParent._children.copy()
+ _attributes = FeedEntryParent._attributes.copy()
+ _children['{%s}content' % ATOM_NAMESPACE] = ('content', Content)
+ _children['{%s}published' % ATOM_NAMESPACE] = ('published', Published)
+ _children['{%s}source' % ATOM_NAMESPACE] = ('source', Source)
+ _children['{%s}summary' % ATOM_NAMESPACE] = ('summary', Summary)
+ _children['{%s}control' % APP_NAMESPACE] = ('control', Control)
+
+ def __init__(self, author=None, category=None, content=None,
+ contributor=None, atom_id=None, link=None, published=None, rights=None,
+ source=None, summary=None, control=None, title=None, updated=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ """Constructor for atom:entry
+
+ Args:
+ author: list A list of Author instances which belong to this class.
+ category: list A list of Category instances
+ content: Content The entry's Content
+ contributor: list A list on Contributor instances
+ id: Id The entry's Id element
+ link: list A list of Link instances
+ published: Published The entry's Published element
+ rights: Rights The entry's Rights element
+ source: Source the entry's source element
+ summary: Summary the entry's summary element
+ title: Title the entry's title element
+ updated: Updated the entry's updated element
+ control: The entry's app:control element which can be used to mark an
+ entry as a draft which should not be publicly viewable.
+ text: String The text contents of the element. This is the contents
+ of the Entry's XML text node. (Example: <foo>This is the text</foo>)
+ extension_elements: list A list of ExtensionElement instances which are
+ children of this element.
+ extension_attributes: dict A dictionary of strings which are the values
+ for additional XML attributes of this element.
+ """
+
+ self.author = author or []
+ self.category = category or []
+ self.content = content
+ self.contributor = contributor or []
+ self.id = atom_id
+ self.link = link or []
+ self.published = published
+ self.rights = rights
+ self.source = source
+ self.summary = summary
+ self.title = title
+ self.updated = updated
+ self.control = control
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ __init__ = v1_deprecated('Please use atom.data.Entry instead.')(__init__)
+
+
+def EntryFromString(xml_string):
+ return CreateClassFromXMLString(Entry, xml_string)
+
+
+class Feed(Source):
+ """The atom:feed element"""
+
+ _tag = 'feed'
+ _namespace = ATOM_NAMESPACE
+ _children = Source._children.copy()
+ _attributes = Source._attributes.copy()
+ _children['{%s}entry' % ATOM_NAMESPACE] = ('entry', [Entry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None, entry=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ """Constructor for Source
+
+ Args:
+ author: list (optional) A list of Author instances which belong to this
+ class.
+ category: list (optional) A list of Category instances
+ contributor: list (optional) A list on Contributor instances
+ generator: Generator (optional)
+ icon: Icon (optional)
+ id: Id (optional) The entry's Id element
+ link: list (optional) A list of Link instances
+ logo: Logo (optional)
+ rights: Rights (optional) The entry's Rights element
+ subtitle: Subtitle (optional) The entry's subtitle element
+ title: Title (optional) the entry's title element
+ updated: Updated (optional) the entry's updated element
+ entry: list (optional) A list of the Entry instances contained in the
+ feed.
+ text: String (optional) The text contents of the element. This is the
+ contents of the Entry's XML text node.
+ (Example: <foo>This is the text</foo>)
+ extension_elements: list (optional) A list of ExtensionElement instances
+ which are children of this element.
+ extension_attributes: dict (optional) A dictionary of strings which are
+ the values for additional XML attributes of this element.
+ """
+
+ self.author = author or []
+ self.category = category or []
+ self.contributor = contributor or []
+ self.generator = generator
+ self.icon = icon
+ self.id = atom_id
+ self.link = link or []
+ self.logo = logo
+ self.rights = rights
+ self.subtitle = subtitle
+ self.title = title
+ self.updated = updated
+ self.entry = entry or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ __init__ = v1_deprecated('Please use atom.data.Feed instead.')(__init__)
+
+
+def FeedFromString(xml_string):
+ return CreateClassFromXMLString(Feed, xml_string)
+
+
+class ExtensionElement(object):
+ """Represents extra XML elements contained in Atom classes."""
+
+ def __init__(self, tag, namespace=None, attributes=None,
+ children=None, text=None):
+ """Constructor for EtensionElement
+
+ Args:
+ namespace: string (optional) The XML namespace for this element.
+ tag: string (optional) The tag (without the namespace qualifier) for
+ this element. To reconstruct the full qualified name of the element,
+ combine this tag with the namespace.
+ attributes: dict (optinal) The attribute value string pairs for the XML
+ attributes of this element.
+ children: list (optional) A list of ExtensionElements which represent
+ the XML child nodes of this element.
+ """
+
+ self.namespace = namespace
+ self.tag = tag
+ self.attributes = attributes or {}
+ self.children = children or []
+ self.text = text
+
+ def ToString(self):
+ element_tree = self._TransferToElementTree(ElementTree.Element(''))
+ return ElementTree.tostring(element_tree, encoding="UTF-8")
+
+ def _TransferToElementTree(self, element_tree):
+ if self.tag is None:
+ return None
+
+ if self.namespace is not None:
+ element_tree.tag = '{%s}%s' % (self.namespace, self.tag)
+ else:
+ element_tree.tag = self.tag
+
+ for key, value in self.attributes.iteritems():
+ element_tree.attrib[key] = value
+
+ for child in self.children:
+ child._BecomeChildElement(element_tree)
+
+ element_tree.text = self.text
+
+ return element_tree
+
+ def _BecomeChildElement(self, element_tree):
+ """Converts this object into an etree element and adds it as a child node.
+
+ Adds self to the ElementTree. This method is required to avoid verbose XML
+ which constantly redefines the namespace.
+
+ Args:
+ element_tree: ElementTree._Element The element to which this object's XML
+ will be added.
+ """
+ new_element = ElementTree.Element('')
+ element_tree.append(new_element)
+ self._TransferToElementTree(new_element)
+
+ def FindChildren(self, tag=None, namespace=None):
+ """Searches child nodes for objects with the desired tag/namespace.
+
+ Returns a list of extension elements within this object whose tag
+ and/or namespace match those passed in. To find all children in
+ a particular namespace, specify the namespace but not the tag name.
+ If you specify only the tag, the result list may contain extension
+ elements in multiple namespaces.
+
+ Args:
+ tag: str (optional) The desired tag
+ namespace: str (optional) The desired namespace
+
+ Returns:
+ A list of elements whose tag and/or namespace match the parameters
+ values
+ """
+
+ results = []
+
+ if tag and namespace:
+ for element in self.children:
+ if element.tag == tag and element.namespace == namespace:
+ results.append(element)
+ elif tag and not namespace:
+ for element in self.children:
+ if element.tag == tag:
+ results.append(element)
+ elif namespace and not tag:
+ for element in self.children:
+ if element.namespace == namespace:
+ results.append(element)
+ else:
+ for element in self.children:
+ results.append(element)
+
+ return results
+
+
+def ExtensionElementFromString(xml_string):
+ element_tree = ElementTree.fromstring(xml_string)
+ return _ExtensionElementFromElementTree(element_tree)
+
+
+def _ExtensionElementFromElementTree(element_tree):
+ element_tag = element_tree.tag
+ if '}' in element_tag:
+ namespace = element_tag[1:element_tag.index('}')]
+ tag = element_tag[element_tag.index('}')+1:]
+ else:
+ namespace = None
+ tag = element_tag
+ extension = ExtensionElement(namespace=namespace, tag=tag)
+ for key, value in element_tree.attrib.iteritems():
+ extension.attributes[key] = value
+ for child in element_tree:
+ extension.children.append(_ExtensionElementFromElementTree(child))
+ extension.text = element_tree.text
+ return extension
+
+
+def deprecated(warning=None):
+ """Decorator to raise warning each time the function is called.
+
+ Args:
+ warning: The warning message to be displayed as a string (optinoal).
+ """
+ warning = warning or ''
+ # This closure is what is returned from the deprecated function.
+ def mark_deprecated(f):
+ # The deprecated_function wraps the actual call to f.
+ def deprecated_function(*args, **kwargs):
+ warnings.warn(warning, DeprecationWarning, stacklevel=2)
+ return f(*args, **kwargs)
+ # Preserve the original name to avoid masking all decorated functions as
+ # 'deprecated_function'
+ try:
+ deprecated_function.func_name = f.func_name
+ except TypeError:
+ # Setting the func_name is not allowed in Python2.3.
+ pass
+ return deprecated_function
+ return mark_deprecated
diff --git a/src/atom/auth.py b/src/atom/auth.py
new file mode 100644
index 0000000..1d84175
--- /dev/null
+++ b/src/atom/auth.py
@@ -0,0 +1,43 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import base64
+
+
+class BasicAuth(object):
+ """Sets the Authorization header as defined in RFC1945"""
+
+ def __init__(self, user_id, password):
+ self.basic_cookie = base64.encodestring(
+ '%s:%s' % (user_id, password)).strip()
+
+ def modify_request(self, http_request):
+ http_request.headers['Authorization'] = 'Basic %s' % self.basic_cookie
+
+ ModifyRequest = modify_request
+
+
+class NoAuth(object):
+
+ def modify_request(self, http_request):
+ pass
diff --git a/src/atom/client.py b/src/atom/client.py
new file mode 100755
index 0000000..6d2aadf
--- /dev/null
+++ b/src/atom/client.py
@@ -0,0 +1,224 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""AtomPubClient provides CRUD ops. in line with the Atom Publishing Protocol.
+
+"""
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.http_core
+
+
+class Error(Exception):
+ pass
+
+
+class MissingHost(Error):
+ pass
+
+
+class AtomPubClient(object):
+ host = None
+ auth_token = None
+ ssl = False # Whether to force all requests over https
+ xoauth_requestor_id = None
+
+ def __init__(self, http_client=None, host=None, auth_token=None, source=None,
+ xoauth_requestor_id=None, **kwargs):
+ """Creates a new AtomPubClient instance.
+
+ Args:
+ source: The name of your application.
+ http_client: An object capable of performing HTTP requests through a
+ request method. This object is used to perform the request
+ when the AtomPubClient's request method is called. Used to
+ allow HTTP requests to be directed to a mock server, or use
+ an alternate library instead of the default of httplib to
+ make HTTP requests.
+ host: str The default host name to use if a host is not specified in the
+ requested URI.
+ auth_token: An object which sets the HTTP Authorization header when its
+ modify_request method is called.
+ """
+ self.http_client = http_client or atom.http_core.ProxiedHttpClient()
+ if host is not None:
+ self.host = host
+ if auth_token is not None:
+ self.auth_token = auth_token
+ self.xoauth_requestor_id = xoauth_requestor_id
+ self.source = source
+
+ def request(self, method=None, uri=None, auth_token=None,
+ http_request=None, **kwargs):
+ """Performs an HTTP request to the server indicated.
+
+ Uses the http_client instance to make the request.
+
+ Args:
+ method: The HTTP method as a string, usually one of 'GET', 'POST',
+ 'PUT', or 'DELETE'
+ uri: The URI desired as a string or atom.http_core.Uri.
+ http_request:
+ auth_token: An authorization token object whose modify_request method
+ sets the HTTP Authorization header.
+
+ Returns:
+ The results of calling self.http_client.request. With the default
+ http_client, this is an HTTP response object.
+ """
+ # Modify the request based on the AtomPubClient settings and parameters
+ # passed in to the request.
+ http_request = self.modify_request(http_request)
+ if isinstance(uri, (str, unicode)):
+ uri = atom.http_core.Uri.parse_uri(uri)
+ if uri is not None:
+ uri.modify_request(http_request)
+ if isinstance(method, (str, unicode)):
+ http_request.method = method
+ # Any unrecognized arguments are assumed to be capable of modifying the
+ # HTTP request.
+ for name, value in kwargs.iteritems():
+ if value is not None:
+ if hasattr(value, 'modify_request'):
+ value.modify_request(http_request)
+ else:
+ http_request.uri.query[name] = str(value)
+ # Default to an http request if the protocol scheme is not set.
+ if http_request.uri.scheme is None:
+ http_request.uri.scheme = 'http'
+ # Override scheme. Force requests over https.
+ if self.ssl:
+ http_request.uri.scheme = 'https'
+ if http_request.uri.path is None:
+ http_request.uri.path = '/'
+ # Add the Authorization header at the very end. The Authorization header
+ # value may need to be calculated using information in the request.
+ if auth_token:
+ auth_token.modify_request(http_request)
+ elif self.auth_token:
+ self.auth_token.modify_request(http_request)
+ # Check to make sure there is a host in the http_request.
+ if http_request.uri.host is None:
+ raise MissingHost('No host provided in request %s %s' % (
+ http_request.method, str(http_request.uri)))
+ # Perform the fully specified request using the http_client instance.
+ # Sends the request to the server and returns the server's response.
+ return self.http_client.request(http_request)
+
+ Request = request
+
+ def get(self, uri=None, auth_token=None, http_request=None, **kwargs):
+ """Performs a request using the GET method, returns an HTTP response."""
+ return self.request(method='GET', uri=uri, auth_token=auth_token,
+ http_request=http_request, **kwargs)
+
+ Get = get
+
+ def post(self, uri=None, data=None, auth_token=None, http_request=None,
+ **kwargs):
+ """Sends data using the POST method, returns an HTTP response."""
+ return self.request(method='POST', uri=uri, auth_token=auth_token,
+ http_request=http_request, data=data, **kwargs)
+
+ Post = post
+
+ def put(self, uri=None, data=None, auth_token=None, http_request=None,
+ **kwargs):
+ """Sends data using the PUT method, returns an HTTP response."""
+ return self.request(method='PUT', uri=uri, auth_token=auth_token,
+ http_request=http_request, data=data, **kwargs)
+
+ Put = put
+
+ def delete(self, uri=None, auth_token=None, http_request=None, **kwargs):
+ """Performs a request using the DELETE method, returns an HTTP response."""
+ return self.request(method='DELETE', uri=uri, auth_token=auth_token,
+ http_request=http_request, **kwargs)
+
+ Delete = delete
+
+ def modify_request(self, http_request):
+ """Changes the HTTP request before sending it to the server.
+
+ Sets the User-Agent HTTP header and fills in the HTTP host portion
+ of the URL if one was not included in the request (for this it uses
+ the self.host member if one is set). This method is called in
+ self.request.
+
+ Args:
+ http_request: An atom.http_core.HttpRequest() (optional) If one is
+ not provided, a new HttpRequest is instantiated.
+
+ Returns:
+ An atom.http_core.HttpRequest() with the User-Agent header set and
+ if this client has a value in its host member, the host in the request
+ URL is set.
+ """
+ if http_request is None:
+ http_request = atom.http_core.HttpRequest()
+
+ if self.host is not None and http_request.uri.host is None:
+ http_request.uri.host = self.host
+
+ if self.xoauth_requestor_id is not None:
+ http_request.uri.query['xoauth_requestor_id'] = self.xoauth_requestor_id
+
+ # Set the user agent header for logging purposes.
+ if self.source:
+ http_request.headers['User-Agent'] = '%s gdata-py/2.0.18' % self.source
+ else:
+ http_request.headers['User-Agent'] = 'gdata-py/2.0.17'
+
+ return http_request
+
+ ModifyRequest = modify_request
+
+
+class CustomHeaders(object):
+ """Add custom headers to an http_request.
+
+ Usage:
+ >>> custom_headers = atom.client.CustomHeaders(header1='value1',
+ header2='value2')
+ >>> client.get(uri, custom_headers=custom_headers)
+ """
+
+ def __init__(self, **kwargs):
+ """Creates a CustomHeaders instance.
+
+ Initialize the headers dictionary with the arguments list.
+ """
+ self.headers = kwargs
+
+ def modify_request(self, http_request):
+ """Changes the HTTP request before sending it to the server.
+
+ Adds the custom headers to the HTTP request.
+
+ Args:
+ http_request: An atom.http_core.HttpRequest().
+
+ Returns:
+ An atom.http_core.HttpRequest() with the added custom headers.
+ """
+
+ for name, value in self.headers.iteritems():
+ if value is not None:
+ http_request.headers[name] = value
+ return http_request
diff --git a/src/atom/core.py b/src/atom/core.py
new file mode 100644
index 0000000..a19a70d
--- /dev/null
+++ b/src/atom/core.py
@@ -0,0 +1,550 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import inspect
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+
+
+try:
+ from xml.dom.minidom import parseString as xmlString
+except ImportError:
+ xmlString = None
+
+STRING_ENCODING = 'utf-8'
+
+
+class XmlElement(object):
+ """Represents an element node in an XML document.
+
+ The text member is a UTF-8 encoded str or unicode.
+ """
+ _qname = None
+ _other_elements = None
+ _other_attributes = None
+ # The rule set contains mappings for XML qnames to child members and the
+ # appropriate member classes.
+ _rule_set = None
+ _members = None
+ text = None
+
+ def __init__(self, text=None, *args, **kwargs):
+ if ('_members' not in self.__class__.__dict__
+ or self.__class__._members is None):
+ self.__class__._members = tuple(self.__class__._list_xml_members())
+ for member_name, member_type in self.__class__._members:
+ if member_name in kwargs:
+ setattr(self, member_name, kwargs[member_name])
+ else:
+ if isinstance(member_type, list):
+ setattr(self, member_name, [])
+ else:
+ setattr(self, member_name, None)
+ self._other_elements = []
+ self._other_attributes = {}
+ if text is not None:
+ self.text = text
+
+ def _list_xml_members(cls):
+ """Generator listing all members which are XML elements or attributes.
+
+ The following members would be considered XML members:
+ foo = 'abc' - indicates an XML attribute with the qname abc
+ foo = SomeElement - indicates an XML child element
+ foo = [AnElement] - indicates a repeating XML child element, each instance
+ will be stored in a list in this member
+ foo = ('att1', '{http://example.com/namespace}att2') - indicates an XML
+ attribute which has different parsing rules in different versions of
+ the protocol. Version 1 of the XML parsing rules will look for an
+ attribute with the qname 'att1' but verion 2 of the parsing rules will
+ look for a namespaced attribute with the local name of 'att2' and an
+ XML namespace of 'http://example.com/namespace'.
+ """
+ members = []
+ for pair in inspect.getmembers(cls):
+ if not pair[0].startswith('_') and pair[0] != 'text':
+ member_type = pair[1]
+ if (isinstance(member_type, tuple) or isinstance(member_type, list)
+ or isinstance(member_type, (str, unicode))
+ or (inspect.isclass(member_type)
+ and issubclass(member_type, XmlElement))):
+ members.append(pair)
+ return members
+
+ _list_xml_members = classmethod(_list_xml_members)
+
+ def _get_rules(cls, version):
+ """Initializes the _rule_set for the class which is used when parsing XML.
+
+ This method is used internally for parsing and generating XML for an
+ XmlElement. It is not recommended that you call this method directly.
+
+ Returns:
+ A tuple containing the XML parsing rules for the appropriate version.
+
+ The tuple looks like:
+ (qname, {sub_element_qname: (member_name, member_class, repeating), ..},
+ {attribute_qname: member_name})
+
+ To give a couple of concrete example, the atom.data.Control _get_rules
+ with version of 2 will return:
+ ('{http://www.w3.org/2007/app}control',
+ {'{http://www.w3.org/2007/app}draft': ('draft',
+ <class 'atom.data.Draft'>,
+ False)},
+ {})
+ Calling _get_rules with version 1 on gdata.data.FeedLink will produce:
+ ('{http://schemas.google.com/g/2005}feedLink',
+ {'{http://www.w3.org/2005/Atom}feed': ('feed',
+ <class 'gdata.data.GDFeed'>,
+ False)},
+ {'href': 'href', 'readOnly': 'read_only', 'countHint': 'count_hint',
+ 'rel': 'rel'})
+ """
+ # Initialize the _rule_set to make sure there is a slot available to store
+ # the parsing rules for this version of the XML schema.
+ # Look for rule set in the class __dict__ proxy so that only the
+ # _rule_set for this class will be found. By using the dict proxy
+ # we avoid finding rule_sets defined in superclasses.
+ # The four lines below provide support for any number of versions, but it
+ # runs a bit slower then hard coding slots for two versions, so I'm using
+ # the below two lines.
+ #if '_rule_set' not in cls.__dict__ or cls._rule_set is None:
+ # cls._rule_set = []
+ #while len(cls.__dict__['_rule_set']) < version:
+ # cls._rule_set.append(None)
+ # If there is no rule set cache in the class, provide slots for two XML
+ # versions. If and when there is a version 3, this list will need to be
+ # expanded.
+ if '_rule_set' not in cls.__dict__ or cls._rule_set is None:
+ cls._rule_set = [None, None]
+ # If a version higher than 2 is requested, fall back to version 2 because
+ # 2 is currently the highest supported version.
+ if version > 2:
+ return cls._get_rules(2)
+ # Check the dict proxy for the rule set to avoid finding any rule sets
+ # which belong to the superclass. We only want rule sets for this class.
+ if cls._rule_set[version-1] is None:
+ # The rule set for each version consists of the qname for this element
+ # ('{namespace}tag'), a dictionary (elements) for looking up the
+ # corresponding class member when given a child element's qname, and a
+ # dictionary (attributes) for looking up the corresponding class member
+ # when given an XML attribute's qname.
+ elements = {}
+ attributes = {}
+ if ('_members' not in cls.__dict__ or cls._members is None):
+ cls._members = tuple(cls._list_xml_members())
+ for member_name, target in cls._members:
+ if isinstance(target, list):
+ # This member points to a repeating element.
+ elements[_get_qname(target[0], version)] = (member_name, target[0],
+ True)
+ elif isinstance(target, tuple):
+ # This member points to a versioned XML attribute.
+ if version <= len(target):
+ attributes[target[version-1]] = member_name
+ else:
+ attributes[target[-1]] = member_name
+ elif isinstance(target, (str, unicode)):
+ # This member points to an XML attribute.
+ attributes[target] = member_name
+ elif issubclass(target, XmlElement):
+ # This member points to a single occurance element.
+ elements[_get_qname(target, version)] = (member_name, target, False)
+ version_rules = (_get_qname(cls, version), elements, attributes)
+ cls._rule_set[version-1] = version_rules
+ return version_rules
+ else:
+ return cls._rule_set[version-1]
+
+ _get_rules = classmethod(_get_rules)
+
+ def get_elements(self, tag=None, namespace=None, version=1):
+ """Find all sub elements which match the tag and namespace.
+
+ To find all elements in this object, call get_elements with the tag and
+ namespace both set to None (the default). This method searches through
+ the object's members and the elements stored in _other_elements which
+ did not match any of the XML parsing rules for this class.
+
+ Args:
+ tag: str
+ namespace: str
+ version: int Specifies the version of the XML rules to be used when
+ searching for matching elements.
+
+ Returns:
+ A list of the matching XmlElements.
+ """
+ matches = []
+ ignored1, elements, ignored2 = self.__class__._get_rules(version)
+ if elements:
+ for qname, element_def in elements.iteritems():
+ member = getattr(self, element_def[0])
+ if member:
+ if _qname_matches(tag, namespace, qname):
+ if element_def[2]:
+ # If this is a repeating element, copy all instances into the
+ # result list.
+ matches.extend(member)
+ else:
+ matches.append(member)
+ for element in self._other_elements:
+ if _qname_matches(tag, namespace, element._qname):
+ matches.append(element)
+ return matches
+
+ GetElements = get_elements
+ # FindExtensions and FindChildren are provided for backwards compatibility
+ # to the atom.AtomBase class.
+ # However, FindExtensions may return more results than the v1 atom.AtomBase
+ # method does, because get_elements searches both the expected children
+ # and the unexpected "other elements". The old AtomBase.FindExtensions
+ # method searched only "other elements" AKA extension_elements.
+ FindExtensions = get_elements
+ FindChildren = get_elements
+
+ def get_attributes(self, tag=None, namespace=None, version=1):
+ """Find all attributes which match the tag and namespace.
+
+ To find all attributes in this object, call get_attributes with the tag
+ and namespace both set to None (the default). This method searches
+ through the object's members and the attributes stored in
+ _other_attributes which did not fit any of the XML parsing rules for this
+ class.
+
+ Args:
+ tag: str
+ namespace: str
+ version: int Specifies the version of the XML rules to be used when
+ searching for matching attributes.
+
+ Returns:
+ A list of XmlAttribute objects for the matching attributes.
+ """
+ matches = []
+ ignored1, ignored2, attributes = self.__class__._get_rules(version)
+ if attributes:
+ for qname, attribute_def in attributes.iteritems():
+ if isinstance(attribute_def, (list, tuple)):
+ attribute_def = attribute_def[0]
+ member = getattr(self, attribute_def)
+ # TODO: ensure this hasn't broken existing behavior.
+ #member = getattr(self, attribute_def[0])
+ if member:
+ if _qname_matches(tag, namespace, qname):
+ matches.append(XmlAttribute(qname, member))
+ for qname, value in self._other_attributes.iteritems():
+ if _qname_matches(tag, namespace, qname):
+ matches.append(XmlAttribute(qname, value))
+ return matches
+
+ GetAttributes = get_attributes
+
+ def _harvest_tree(self, tree, version=1):
+ """Populates object members from the data in the tree Element."""
+ qname, elements, attributes = self.__class__._get_rules(version)
+ for element in tree:
+ if elements and element.tag in elements:
+ definition = elements[element.tag]
+ # If this is a repeating element, make sure the member is set to a
+ # list.
+ if definition[2]:
+ if getattr(self, definition[0]) is None:
+ setattr(self, definition[0], [])
+ getattr(self, definition[0]).append(_xml_element_from_tree(element,
+ definition[1], version))
+ else:
+ setattr(self, definition[0], _xml_element_from_tree(element,
+ definition[1], version))
+ else:
+ self._other_elements.append(_xml_element_from_tree(element, XmlElement,
+ version))
+ for attrib, value in tree.attrib.iteritems():
+ if attributes and attrib in attributes:
+ setattr(self, attributes[attrib], value)
+ else:
+ self._other_attributes[attrib] = value
+ if tree.text:
+ self.text = tree.text
+
+ def _to_tree(self, version=1, encoding=None):
+ new_tree = ElementTree.Element(_get_qname(self, version))
+ self._attach_members(new_tree, version, encoding)
+ return new_tree
+
+ def _attach_members(self, tree, version=1, encoding=None):
+ """Convert members to XML elements/attributes and add them to the tree.
+
+ Args:
+ tree: An ElementTree.Element which will be modified. The members of
+ this object will be added as child elements or attributes
+ according to the rules described in _expected_elements and
+ _expected_attributes. The elements and attributes stored in
+ other_attributes and other_elements are also added a children
+ of this tree.
+ version: int Ingnored in this method but used by VersionedElement.
+ encoding: str (optional)
+ """
+ qname, elements, attributes = self.__class__._get_rules(version)
+ encoding = encoding or STRING_ENCODING
+ # Add the expected elements and attributes to the tree.
+ if elements:
+ for tag, element_def in elements.iteritems():
+ member = getattr(self, element_def[0])
+ # If this is a repeating element and there are members in the list.
+ if member and element_def[2]:
+ for instance in member:
+ instance._become_child(tree, version)
+ elif member:
+ member._become_child(tree, version)
+ if attributes:
+ for attribute_tag, member_name in attributes.iteritems():
+ value = getattr(self, member_name)
+ if value:
+ tree.attrib[attribute_tag] = value
+ # Add the unexpected (other) elements and attributes to the tree.
+ for element in self._other_elements:
+ element._become_child(tree, version)
+ for key, value in self._other_attributes.iteritems():
+ # I'm not sure if unicode can be used in the attribute name, so for now
+ # we assume the encoding is correct for the attribute name.
+ if not isinstance(value, unicode):
+ value = value.decode(encoding)
+ tree.attrib[key] = value
+ if self.text:
+ if isinstance(self.text, unicode):
+ tree.text = self.text
+ else:
+ tree.text = self.text.decode(encoding)
+
+ def to_string(self, version=1, encoding=None, pretty_print=None):
+ """Converts this object to XML."""
+
+ tree_string = ElementTree.tostring(self._to_tree(version, encoding))
+
+ if pretty_print and xmlString is not None:
+ return xmlString(tree_string).toprettyxml()
+
+ return tree_string
+
+ ToString = to_string
+
+ def __str__(self):
+ return self.to_string()
+
+ def _become_child(self, tree, version=1):
+ """Adds a child element to tree with the XML data in self."""
+ new_child = ElementTree.Element('')
+ tree.append(new_child)
+ new_child.tag = _get_qname(self, version)
+ self._attach_members(new_child, version)
+
+ def __get_extension_elements(self):
+ return self._other_elements
+
+ def __set_extension_elements(self, elements):
+ self._other_elements = elements
+
+ extension_elements = property(__get_extension_elements,
+ __set_extension_elements,
+ """Provides backwards compatibility for v1 atom.AtomBase classes.""")
+
+ def __get_extension_attributes(self):
+ return self._other_attributes
+
+ def __set_extension_attributes(self, attributes):
+ self._other_attributes = attributes
+
+ extension_attributes = property(__get_extension_attributes,
+ __set_extension_attributes,
+ """Provides backwards compatibility for v1 atom.AtomBase classes.""")
+
+ def _get_tag(self, version=1):
+ qname = _get_qname(self, version)
+ if qname:
+ return qname[qname.find('}')+1:]
+ return None
+
+ def _get_namespace(self, version=1):
+ qname = _get_qname(self, version)
+ if qname.startswith('{'):
+ return qname[1:qname.find('}')]
+ else:
+ return None
+
+ def _set_tag(self, tag):
+ if isinstance(self._qname, tuple):
+ self._qname = self._qname.copy()
+ if self._qname[0].startswith('{'):
+ self._qname[0] = '{%s}%s' % (self._get_namespace(1), tag)
+ else:
+ self._qname[0] = tag
+ else:
+ if self._qname is not None and self._qname.startswith('{'):
+ self._qname = '{%s}%s' % (self._get_namespace(), tag)
+ else:
+ self._qname = tag
+
+ def _set_namespace(self, namespace):
+ tag = self._get_tag(1)
+ if tag is None:
+ tag = ''
+ if isinstance(self._qname, tuple):
+ self._qname = self._qname.copy()
+ if namespace:
+ self._qname[0] = '{%s}%s' % (namespace, tag)
+ else:
+ self._qname[0] = tag
+ else:
+ if namespace:
+ self._qname = '{%s}%s' % (namespace, tag)
+ else:
+ self._qname = tag
+
+ tag = property(_get_tag, _set_tag,
+ """Provides backwards compatibility for v1 atom.AtomBase classes.""")
+
+ namespace = property(_get_namespace, _set_namespace,
+ """Provides backwards compatibility for v1 atom.AtomBase classes.""")
+
+ # Provided for backwards compatibility to atom.ExtensionElement
+ children = extension_elements
+ attributes = extension_attributes
+
+
+def _get_qname(element, version):
+ if isinstance(element._qname, tuple):
+ if version <= len(element._qname):
+ return element._qname[version-1]
+ else:
+ return element._qname[-1]
+ else:
+ return element._qname
+
+
+def _qname_matches(tag, namespace, qname):
+ """Logic determines if a QName matches the desired local tag and namespace.
+
+ This is used in XmlElement.get_elements and XmlElement.get_attributes to
+ find matches in the element's members (among all expected-and-unexpected
+ elements-and-attributes).
+
+ Args:
+ expected_tag: string
+ expected_namespace: string
+ qname: string in the form '{xml_namespace}localtag' or 'tag' if there is
+ no namespace.
+
+ Returns:
+ boolean True if the member's tag and namespace fit the expected tag and
+ namespace.
+ """
+ # If there is no expected namespace or tag, then everything will match.
+ if qname is None:
+ member_tag = None
+ member_namespace = None
+ else:
+ if qname.startswith('{'):
+ member_namespace = qname[1:qname.index('}')]
+ member_tag = qname[qname.index('}') + 1:]
+ else:
+ member_namespace = None
+ member_tag = qname
+ return ((tag is None and namespace is None)
+ # If there is a tag, but no namespace, see if the local tag matches.
+ or (namespace is None and member_tag == tag)
+ # There was no tag, but there was a namespace so see if the namespaces
+ # match.
+ or (tag is None and member_namespace == namespace)
+ # There was no tag, and the desired elements have no namespace, so check
+ # to see that the member's namespace is None.
+ or (tag is None and namespace == ''
+ and member_namespace is None)
+ # The tag and the namespace both match.
+ or (tag == member_tag
+ and namespace == member_namespace)
+ # The tag matches, and the expected namespace is the empty namespace,
+ # check to make sure the member's namespace is None.
+ or (tag == member_tag and namespace == ''
+ and member_namespace is None))
+
+
+def parse(xml_string, target_class=None, version=1, encoding=None):
+ """Parses the XML string according to the rules for the target_class.
+
+ Args:
+ xml_string: str or unicode
+ target_class: XmlElement or a subclass. If None is specified, the
+ XmlElement class is used.
+ version: int (optional) The version of the schema which should be used when
+ converting the XML into an object. The default is 1.
+ encoding: str (optional) The character encoding of the bytes in the
+ xml_string. Default is 'UTF-8'.
+ """
+ if target_class is None:
+ target_class = XmlElement
+ if isinstance(xml_string, unicode):
+ if encoding is None:
+ xml_string = xml_string.encode(STRING_ENCODING)
+ else:
+ xml_string = xml_string.encode(encoding)
+ tree = ElementTree.fromstring(xml_string)
+ return _xml_element_from_tree(tree, target_class, version)
+
+
+Parse = parse
+xml_element_from_string = parse
+XmlElementFromString = xml_element_from_string
+
+
+def _xml_element_from_tree(tree, target_class, version=1):
+ if target_class._qname is None:
+ instance = target_class()
+ instance._qname = tree.tag
+ instance._harvest_tree(tree, version)
+ return instance
+ # TODO handle the namespace-only case
+ # Namespace only will be used with Google Spreadsheets rows and
+ # Google Base item attributes.
+ elif tree.tag == _get_qname(target_class, version):
+ instance = target_class()
+ instance._harvest_tree(tree, version)
+ return instance
+ return None
+
+
+class XmlAttribute(object):
+
+ def __init__(self, qname, value):
+ self._qname = qname
+ self.value = value
+
diff --git a/src/atom/data.py b/src/atom/data.py
new file mode 100644
index 0000000..38017ce
--- /dev/null
+++ b/src/atom/data.py
@@ -0,0 +1,338 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+
+
+XML_TEMPLATE = '{http://www.w3.org/XML/1998/namespace}%s'
+ATOM_TEMPLATE = '{http://www.w3.org/2005/Atom}%s'
+APP_TEMPLATE_V1 = '{http://purl.org/atom/app#}%s'
+APP_TEMPLATE_V2 = '{http://www.w3.org/2007/app}%s'
+
+
+class Name(atom.core.XmlElement):
+ """The atom:name element."""
+ _qname = ATOM_TEMPLATE % 'name'
+
+
+class Email(atom.core.XmlElement):
+ """The atom:email element."""
+ _qname = ATOM_TEMPLATE % 'email'
+
+
+class Uri(atom.core.XmlElement):
+ """The atom:uri element."""
+ _qname = ATOM_TEMPLATE % 'uri'
+
+
+class Person(atom.core.XmlElement):
+ """A foundation class which atom:author and atom:contributor extend.
+
+ A person contains information like name, email address, and web page URI for
+ an author or contributor to an Atom feed.
+ """
+ name = Name
+ email = Email
+ uri = Uri
+
+
+class Author(Person):
+ """The atom:author element.
+
+ An author is a required element in Feed unless each Entry contains an Author.
+ """
+ _qname = ATOM_TEMPLATE % 'author'
+
+
+class Contributor(Person):
+ """The atom:contributor element."""
+ _qname = ATOM_TEMPLATE % 'contributor'
+
+
+class Link(atom.core.XmlElement):
+ """The atom:link element."""
+ _qname = ATOM_TEMPLATE % 'link'
+ href = 'href'
+ rel = 'rel'
+ type = 'type'
+ hreflang = 'hreflang'
+ title = 'title'
+ length = 'length'
+
+
+class Generator(atom.core.XmlElement):
+ """The atom:generator element."""
+ _qname = ATOM_TEMPLATE % 'generator'
+ uri = 'uri'
+ version = 'version'
+
+
+class Text(atom.core.XmlElement):
+ """A foundation class from which atom:title, summary, etc. extend.
+
+ This class should never be instantiated.
+ """
+ type = 'type'
+
+
+class Title(Text):
+ """The atom:title element."""
+ _qname = ATOM_TEMPLATE % 'title'
+
+
+class Subtitle(Text):
+ """The atom:subtitle element."""
+ _qname = ATOM_TEMPLATE % 'subtitle'
+
+
+class Rights(Text):
+ """The atom:rights element."""
+ _qname = ATOM_TEMPLATE % 'rights'
+
+
+class Summary(Text):
+ """The atom:summary element."""
+ _qname = ATOM_TEMPLATE % 'summary'
+
+
+class Content(Text):
+ """The atom:content element."""
+ _qname = ATOM_TEMPLATE % 'content'
+ src = 'src'
+
+
+class Category(atom.core.XmlElement):
+ """The atom:category element."""
+ _qname = ATOM_TEMPLATE % 'category'
+ term = 'term'
+ scheme = 'scheme'
+ label = 'label'
+
+
+class Id(atom.core.XmlElement):
+ """The atom:id element."""
+ _qname = ATOM_TEMPLATE % 'id'
+
+
+class Icon(atom.core.XmlElement):
+ """The atom:icon element."""
+ _qname = ATOM_TEMPLATE % 'icon'
+
+
+class Logo(atom.core.XmlElement):
+ """The atom:logo element."""
+ _qname = ATOM_TEMPLATE % 'logo'
+
+
+class Draft(atom.core.XmlElement):
+ """The app:draft element which indicates if this entry should be public."""
+ _qname = (APP_TEMPLATE_V1 % 'draft', APP_TEMPLATE_V2 % 'draft')
+
+
+class Control(atom.core.XmlElement):
+ """The app:control element indicating restrictions on publication.
+
+ The APP control element may contain a draft element indicating whether or
+ not this entry should be publicly available.
+ """
+ _qname = (APP_TEMPLATE_V1 % 'control', APP_TEMPLATE_V2 % 'control')
+ draft = Draft
+
+
+class Date(atom.core.XmlElement):
+ """A parent class for atom:updated, published, etc."""
+
+
+class Updated(Date):
+ """The atom:updated element."""
+ _qname = ATOM_TEMPLATE % 'updated'
+
+
+class Published(Date):
+ """The atom:published element."""
+ _qname = ATOM_TEMPLATE % 'published'
+
+
+class LinkFinder(object):
+ """An "interface" providing methods to find link elements
+
+ Entry elements often contain multiple links which differ in the rel
+ attribute or content type. Often, developers are interested in a specific
+ type of link so this class provides methods to find specific classes of
+ links.
+
+ This class is used as a mixin in Atom entries and feeds.
+ """
+
+ def find_url(self, rel):
+ """Returns the URL (as a string) in a link with the desired rel value."""
+ for link in self.link:
+ if link.rel == rel and link.href:
+ return link.href
+ return None
+
+ FindUrl = find_url
+
+ def get_link(self, rel):
+ """Returns a link object which has the desired rel value.
+
+ If you are interested in the URL instead of the link object,
+ consider using find_url instead.
+ """
+ for link in self.link:
+ if link.rel == rel and link.href:
+ return link
+ return None
+
+ GetLink = get_link
+
+ def find_self_link(self):
+ """Find the first link with rel set to 'self'
+
+ Returns:
+ A str containing the link's href or None if none of the links had rel
+ equal to 'self'
+ """
+ return self.find_url('self')
+
+ FindSelfLink = find_self_link
+
+ def get_self_link(self):
+ return self.get_link('self')
+
+ GetSelfLink = get_self_link
+
+ def find_edit_link(self):
+ return self.find_url('edit')
+
+ FindEditLink = find_edit_link
+
+ def get_edit_link(self):
+ return self.get_link('edit')
+
+ GetEditLink = get_edit_link
+
+ def find_edit_media_link(self):
+ link = self.find_url('edit-media')
+ # Search for media-edit as well since Picasa API used media-edit instead.
+ if link is None:
+ return self.find_url('media-edit')
+ return link
+
+ FindEditMediaLink = find_edit_media_link
+
+ def get_edit_media_link(self):
+ link = self.get_link('edit-media')
+ if link is None:
+ return self.get_link('media-edit')
+ return link
+
+ GetEditMediaLink = get_edit_media_link
+
+ def find_next_link(self):
+ return self.find_url('next')
+
+ FindNextLink = find_next_link
+
+ def get_next_link(self):
+ return self.get_link('next')
+
+ GetNextLink = get_next_link
+
+ def find_license_link(self):
+ return self.find_url('license')
+
+ FindLicenseLink = find_license_link
+
+ def get_license_link(self):
+ return self.get_link('license')
+
+ GetLicenseLink = get_license_link
+
+ def find_alternate_link(self):
+ return self.find_url('alternate')
+
+ FindAlternateLink = find_alternate_link
+
+ def get_alternate_link(self):
+ return self.get_link('alternate')
+
+ GetAlternateLink = get_alternate_link
+
+
+class FeedEntryParent(atom.core.XmlElement, LinkFinder):
+ """A super class for atom:feed and entry, contains shared attributes"""
+ author = [Author]
+ category = [Category]
+ contributor = [Contributor]
+ id = Id
+ link = [Link]
+ rights = Rights
+ title = Title
+ updated = Updated
+
+ def __init__(self, atom_id=None, text=None, *args, **kwargs):
+ if atom_id is not None:
+ self.id = atom_id
+ atom.core.XmlElement.__init__(self, text=text, *args, **kwargs)
+
+
+class Source(FeedEntryParent):
+ """The atom:source element."""
+ _qname = ATOM_TEMPLATE % 'source'
+ generator = Generator
+ icon = Icon
+ logo = Logo
+ subtitle = Subtitle
+
+
+class Entry(FeedEntryParent):
+ """The atom:entry element."""
+ _qname = ATOM_TEMPLATE % 'entry'
+ content = Content
+ published = Published
+ source = Source
+ summary = Summary
+ control = Control
+
+
+class Feed(Source):
+ """The atom:feed element which contains entries."""
+ _qname = ATOM_TEMPLATE % 'feed'
+ entry = [Entry]
+
+
+class ExtensionElement(atom.core.XmlElement):
+ """Provided for backwards compatibility to the v1 atom.ExtensionElement."""
+
+ def __init__(self, tag=None, namespace=None, attributes=None,
+ children=None, text=None, *args, **kwargs):
+ if namespace:
+ self._qname = '{%s}%s' % (namespace, tag)
+ else:
+ self._qname = tag
+ self.children = children or []
+ self.attributes = attributes or {}
+ self.text = text
+
+ _BecomeChildElement = atom.core.XmlElement._become_child
diff --git a/src/atom/http.py b/src/atom/http.py
new file mode 100644
index 0000000..ee62bd0
--- /dev/null
+++ b/src/atom/http.py
@@ -0,0 +1,361 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""HttpClients in this module use httplib to make HTTP requests.
+
+This module make HTTP requests based on httplib, but there are environments
+in which an httplib based approach will not work (if running in Google App
+Engine for example). In those cases, higher level classes (like AtomService
+and GDataService) can swap out the HttpClient to transparently use a
+different mechanism for making HTTP requests.
+
+ HttpClient: Contains a request method which performs an HTTP call to the
+ server.
+
+ ProxiedHttpClient: Contains a request method which connects to a proxy using
+ settings stored in operating system environment variables then
+ performs an HTTP call to the endpoint server.
+"""
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import types
+import os
+import httplib
+import atom.url
+import atom.http_interface
+import socket
+import base64
+import atom.http_core
+ssl_imported = False
+ssl = None
+try:
+ import ssl
+ ssl_imported = True
+except ImportError:
+ pass
+
+
+
+class ProxyError(atom.http_interface.Error):
+ pass
+
+
+class TestConfigurationError(Exception):
+ pass
+
+
+DEFAULT_CONTENT_TYPE = 'application/atom+xml'
+
+
+class HttpClient(atom.http_interface.GenericHttpClient):
+ # Added to allow old v1 HttpClient objects to use the new
+ # http_code.HttpClient. Used in unit tests to inject a mock client.
+ v2_http_client = None
+
+ def __init__(self, headers=None):
+ self.debug = False
+ self.headers = headers or {}
+
+ def request(self, operation, url, data=None, headers=None):
+ """Performs an HTTP call to the server, supports GET, POST, PUT, and
+ DELETE.
+
+ Usage example, perform and HTTP GET on http://www.google.com/:
+ import atom.http
+ client = atom.http.HttpClient()
+ http_response = client.request('GET', 'http://www.google.com/')
+
+ Args:
+ operation: str The HTTP operation to be performed. This is usually one
+ of 'GET', 'POST', 'PUT', or 'DELETE'
+ data: filestream, list of parts, or other object which can be converted
+ to a string. Should be set to None when performing a GET or DELETE.
+ If data is a file-like object which can be read, this method will
+ read a chunk of 100K bytes at a time and send them.
+ If the data is a list of parts to be sent, each part will be
+ evaluated and sent.
+ url: The full URL to which the request should be sent. Can be a string
+ or atom.url.Url.
+ headers: dict of strings. HTTP headers which should be sent
+ in the request.
+ """
+ all_headers = self.headers.copy()
+ if headers:
+ all_headers.update(headers)
+
+ # If the list of headers does not include a Content-Length, attempt to
+ # calculate it based on the data object.
+ if data and 'Content-Length' not in all_headers:
+ if isinstance(data, types.StringTypes):
+ all_headers['Content-Length'] = str(len(data))
+ else:
+ raise atom.http_interface.ContentLengthRequired('Unable to calculate '
+ 'the length of the data parameter. Specify a value for '
+ 'Content-Length')
+
+ # Set the content type to the default value if none was set.
+ if 'Content-Type' not in all_headers:
+ all_headers['Content-Type'] = DEFAULT_CONTENT_TYPE
+
+ if self.v2_http_client is not None:
+ http_request = atom.http_core.HttpRequest(method=operation)
+ atom.http_core.Uri.parse_uri(str(url)).modify_request(http_request)
+ http_request.headers = all_headers
+ if data:
+ http_request._body_parts.append(data)
+ return self.v2_http_client.request(http_request=http_request)
+
+ if not isinstance(url, atom.url.Url):
+ if isinstance(url, types.StringTypes):
+ url = atom.url.parse_url(url)
+ else:
+ raise atom.http_interface.UnparsableUrlObject('Unable to parse url '
+ 'parameter because it was not a string or atom.url.Url')
+
+ connection = self._prepare_connection(url, all_headers)
+
+ if self.debug:
+ connection.debuglevel = 1
+
+ connection.putrequest(operation, self._get_access_url(url),
+ skip_host=True)
+ if url.port is not None:
+ connection.putheader('Host', '%s:%s' % (url.host, url.port))
+ else:
+ connection.putheader('Host', url.host)
+
+ # Overcome a bug in Python 2.4 and 2.5
+ # httplib.HTTPConnection.putrequest adding
+ # HTTP request header 'Host: www.google.com:443' instead of
+ # 'Host: www.google.com', and thus resulting the error message
+ # 'Token invalid - AuthSub token has wrong scope' in the HTTP response.
+ if (url.protocol == 'https' and int(url.port or 443) == 443 and
+ hasattr(connection, '_buffer') and
+ isinstance(connection._buffer, list)):
+ header_line = 'Host: %s:443' % url.host
+ replacement_header_line = 'Host: %s' % url.host
+ try:
+ connection._buffer[connection._buffer.index(header_line)] = (
+ replacement_header_line)
+ except ValueError: # header_line missing from connection._buffer
+ pass
+
+ # Send the HTTP headers.
+ for header_name in all_headers:
+ connection.putheader(header_name, all_headers[header_name])
+ connection.endheaders()
+
+ # If there is data, send it in the request.
+ if data:
+ if isinstance(data, list):
+ for data_part in data:
+ _send_data_part(data_part, connection)
+ else:
+ _send_data_part(data, connection)
+
+ # Return the HTTP Response from the server.
+ return connection.getresponse()
+
+ def _prepare_connection(self, url, headers):
+ if not isinstance(url, atom.url.Url):
+ if isinstance(url, types.StringTypes):
+ url = atom.url.parse_url(url)
+ else:
+ raise atom.http_interface.UnparsableUrlObject('Unable to parse url '
+ 'parameter because it was not a string or atom.url.Url')
+ if url.protocol == 'https':
+ if not url.port:
+ return httplib.HTTPSConnection(url.host)
+ return httplib.HTTPSConnection(url.host, int(url.port))
+ else:
+ if not url.port:
+ return httplib.HTTPConnection(url.host)
+ return httplib.HTTPConnection(url.host, int(url.port))
+
+ def _get_access_url(self, url):
+ return url.to_string()
+
+
+class ProxiedHttpClient(HttpClient):
+ """Performs an HTTP request through a proxy.
+
+ The proxy settings are obtained from enviroment variables. The URL of the
+ proxy server is assumed to be stored in the environment variables
+ 'https_proxy' and 'http_proxy' respectively. If the proxy server requires
+ a Basic Auth authorization header, the username and password are expected to
+ be in the 'proxy-username' or 'proxy_username' variable and the
+ 'proxy-password' or 'proxy_password' variable, or in 'http_proxy' or
+ 'https_proxy' as "protocol://[username:password@]host:port".
+
+ After connecting to the proxy server, the request is completed as in
+ HttpClient.request.
+ """
+ def _prepare_connection(self, url, headers):
+ proxy_settings = os.environ.get('%s_proxy' % url.protocol)
+ if not proxy_settings:
+ # The request was HTTP or HTTPS, but there was no appropriate proxy set.
+ return HttpClient._prepare_connection(self, url, headers)
+ else:
+ proxy_auth = _get_proxy_auth(proxy_settings)
+ proxy_netloc = _get_proxy_net_location(proxy_settings)
+ if url.protocol == 'https':
+ # Set any proxy auth headers
+ if proxy_auth:
+ proxy_auth = 'Proxy-authorization: %s' % proxy_auth
+
+ # Construct the proxy connect command.
+ port = url.port
+ if not port:
+ port = '443'
+ proxy_connect = 'CONNECT %s:%s HTTP/1.0\r\n' % (url.host, port)
+
+ # Set the user agent to send to the proxy
+ if headers and 'User-Agent' in headers:
+ user_agent = 'User-Agent: %s\r\n' % (headers['User-Agent'])
+ else:
+ user_agent = 'User-Agent: python\r\n'
+
+ proxy_pieces = '%s%s%s\r\n' % (proxy_connect, proxy_auth, user_agent)
+
+ # Find the proxy host and port.
+ proxy_url = atom.url.parse_url(proxy_netloc)
+ if not proxy_url.port:
+ proxy_url.port = '80'
+
+ # Connect to the proxy server, very simple recv and error checking
+ p_sock = socket.socket(socket.AF_INET,socket.SOCK_STREAM)
+ p_sock.connect((proxy_url.host, int(proxy_url.port)))
+ p_sock.sendall(proxy_pieces)
+ response = ''
+
+ # Wait for the full response.
+ while response.find("\r\n\r\n") == -1:
+ response += p_sock.recv(8192)
+
+ p_status = response.split()[1]
+ if p_status != str(200):
+ raise ProxyError('Error status=%s' % str(p_status))
+
+ # Trivial setup for ssl socket.
+ sslobj = None
+ if ssl_imported:
+ sslobj = ssl.wrap_socket(p_sock, None, None)
+ else:
+ sock_ssl = socket.ssl(p_sock, None, None)
+ sslobj = httplib.FakeSocket(p_sock, sock_ssl)
+
+ # Initalize httplib and replace with the proxy socket.
+ connection = httplib.HTTPConnection(proxy_url.host)
+ connection.sock = sslobj
+ return connection
+ else:
+ # If protocol was not https.
+ # Find the proxy host and port.
+ proxy_url = atom.url.parse_url(proxy_netloc)
+ if not proxy_url.port:
+ proxy_url.port = '80'
+
+ if proxy_auth:
+ headers['Proxy-Authorization'] = proxy_auth.strip()
+
+ return httplib.HTTPConnection(proxy_url.host, int(proxy_url.port))
+
+ def _get_access_url(self, url):
+ return url.to_string()
+
+
+def _get_proxy_auth(proxy_settings):
+ """Returns proxy authentication string for header.
+
+ Will check environment variables for proxy authentication info, starting with
+ proxy(_/-)username and proxy(_/-)password before checking the given
+ proxy_settings for a [protocol://]username:password@host[:port] string.
+
+ Args:
+ proxy_settings: String from http_proxy or https_proxy environment variable.
+
+ Returns:
+ Authentication string for proxy, or empty string if no proxy username was
+ found.
+ """
+ proxy_username = None
+ proxy_password = None
+
+ proxy_username = os.environ.get('proxy-username')
+ if not proxy_username:
+ proxy_username = os.environ.get('proxy_username')
+ proxy_password = os.environ.get('proxy-password')
+ if not proxy_password:
+ proxy_password = os.environ.get('proxy_password')
+
+ if not proxy_username:
+ if '@' in proxy_settings:
+ protocol_and_proxy_auth = proxy_settings.split('@')[0].split(':')
+ if len(protocol_and_proxy_auth) == 3:
+ # 3 elements means we have [<protocol>, //<user>, <password>]
+ proxy_username = protocol_and_proxy_auth[1].lstrip('/')
+ proxy_password = protocol_and_proxy_auth[2]
+ elif len(protocol_and_proxy_auth) == 2:
+ # 2 elements means we have [<user>, <password>]
+ proxy_username = protocol_and_proxy_auth[0]
+ proxy_password = protocol_and_proxy_auth[1]
+ if proxy_username:
+ user_auth = base64.encodestring('%s:%s' % (proxy_username,
+ proxy_password))
+ return 'Basic %s\r\n' % (user_auth.strip())
+ else:
+ return ''
+
+
+def _get_proxy_net_location(proxy_settings):
+ """Returns proxy host and port.
+
+ Args:
+ proxy_settings: String from http_proxy or https_proxy environment variable.
+ Must be in the form of protocol://[username:password@]host:port
+
+ Returns:
+ String in the form of protocol://host:port
+ """
+ if '@' in proxy_settings:
+ protocol = proxy_settings.split(':')[0]
+ netloc = proxy_settings.split('@')[1]
+ return '%s://%s' % (protocol, netloc)
+ else:
+ return proxy_settings
+
+
+def _send_data_part(data, connection):
+ if isinstance(data, types.StringTypes):
+ connection.send(data)
+ return
+ # Check to see if data is a file-like object that has a read method.
+ elif hasattr(data, 'read'):
+ # Read the file and send it a chunk at a time.
+ while 1:
+ binarydata = data.read(100000)
+ if binarydata == '': break
+ connection.send(binarydata)
+ return
+ else:
+ # The data object was not a file.
+ # Try to convert to a string and send the data.
+ connection.send(str(data))
+ return
diff --git a/src/atom/http_core.py b/src/atom/http_core.py
new file mode 100644
index 0000000..8d2b888
--- /dev/null
+++ b/src/atom/http_core.py
@@ -0,0 +1,601 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+# TODO: add proxy handling.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import os
+import StringIO
+import urlparse
+import urllib
+import httplib
+ssl = None
+try:
+ import ssl
+except ImportError:
+ pass
+
+
+
+class Error(Exception):
+ pass
+
+
+class UnknownSize(Error):
+ pass
+
+
+class ProxyError(Error):
+ pass
+
+
+MIME_BOUNDARY = 'END_OF_PART'
+
+
+def get_headers(http_response):
+ """Retrieves all HTTP headers from an HTTP response from the server.
+
+ This method is provided for backwards compatibility for Python2.2 and 2.3.
+ The httplib.HTTPResponse object in 2.2 and 2.3 does not have a getheaders
+ method so this function will use getheaders if available, but if not it
+ will retrieve a few using getheader.
+ """
+ if hasattr(http_response, 'getheaders'):
+ return http_response.getheaders()
+ else:
+ headers = []
+ for header in (
+ 'location', 'content-type', 'content-length', 'age', 'allow',
+ 'cache-control', 'content-location', 'content-encoding', 'date',
+ 'etag', 'expires', 'last-modified', 'pragma', 'server',
+ 'set-cookie', 'transfer-encoding', 'vary', 'via', 'warning',
+ 'www-authenticate', 'gdata-version'):
+ value = http_response.getheader(header, None)
+ if value is not None:
+ headers.append((header, value))
+ return headers
+
+
+class HttpRequest(object):
+ """Contains all of the parameters for an HTTP 1.1 request.
+
+ The HTTP headers are represented by a dictionary, and it is the
+ responsibility of the user to ensure that duplicate field names are combined
+ into one header value according to the rules in section 4.2 of RFC 2616.
+ """
+ method = None
+ uri = None
+
+ def __init__(self, uri=None, method=None, headers=None):
+ """Construct an HTTP request.
+
+ Args:
+ uri: The full path or partial path as a Uri object or a string.
+ method: The HTTP method for the request, examples include 'GET', 'POST',
+ etc.
+ headers: dict of strings The HTTP headers to include in the request.
+ """
+ self.headers = headers or {}
+ self._body_parts = []
+ if method is not None:
+ self.method = method
+ if isinstance(uri, (str, unicode)):
+ uri = Uri.parse_uri(uri)
+ self.uri = uri or Uri()
+
+
+ def add_body_part(self, data, mime_type, size=None):
+ """Adds data to the HTTP request body.
+
+ If more than one part is added, this is assumed to be a mime-multipart
+ request. This method is designed to create MIME 1.0 requests as specified
+ in RFC 1341.
+
+ Args:
+ data: str or a file-like object containing a part of the request body.
+ mime_type: str The MIME type describing the data
+ size: int Required if the data is a file like object. If the data is a
+ string, the size is calculated so this parameter is ignored.
+ """
+ if isinstance(data, str):
+ size = len(data)
+ if size is None:
+ # TODO: support chunked transfer if some of the body is of unknown size.
+ raise UnknownSize('Each part of the body must have a known size.')
+ if 'Content-Length' in self.headers:
+ content_length = int(self.headers['Content-Length'])
+ else:
+ content_length = 0
+ # If this is the first part added to the body, then this is not a multipart
+ # request.
+ if len(self._body_parts) == 0:
+ self.headers['Content-Type'] = mime_type
+ content_length = size
+ self._body_parts.append(data)
+ elif len(self._body_parts) == 1:
+ # This is the first member in a mime-multipart request, so change the
+ # _body_parts list to indicate a multipart payload.
+ self._body_parts.insert(0, 'Media multipart posting')
+ boundary_string = '\r\n--%s\r\n' % (MIME_BOUNDARY,)
+ content_length += len(boundary_string) + size
+ self._body_parts.insert(1, boundary_string)
+ content_length += len('Media multipart posting')
+ # Put the content type of the first part of the body into the multipart
+ # payload.
+ original_type_string = 'Content-Type: %s\r\n\r\n' % (
+ self.headers['Content-Type'],)
+ self._body_parts.insert(2, original_type_string)
+ content_length += len(original_type_string)
+ boundary_string = '\r\n--%s\r\n' % (MIME_BOUNDARY,)
+ self._body_parts.append(boundary_string)
+ content_length += len(boundary_string)
+ # Change the headers to indicate this is now a mime multipart request.
+ self.headers['Content-Type'] = 'multipart/related; boundary="%s"' % (
+ MIME_BOUNDARY,)
+ self.headers['MIME-version'] = '1.0'
+ # Include the mime type of this part.
+ type_string = 'Content-Type: %s\r\n\r\n' % (mime_type)
+ self._body_parts.append(type_string)
+ content_length += len(type_string)
+ self._body_parts.append(data)
+ ending_boundary_string = '\r\n--%s--' % (MIME_BOUNDARY,)
+ self._body_parts.append(ending_boundary_string)
+ content_length += len(ending_boundary_string)
+ else:
+ # This is a mime multipart request.
+ boundary_string = '\r\n--%s\r\n' % (MIME_BOUNDARY,)
+ self._body_parts.insert(-1, boundary_string)
+ content_length += len(boundary_string) + size
+ # Include the mime type of this part.
+ type_string = 'Content-Type: %s\r\n\r\n' % (mime_type)
+ self._body_parts.insert(-1, type_string)
+ content_length += len(type_string)
+ self._body_parts.insert(-1, data)
+ self.headers['Content-Length'] = str(content_length)
+ # I could add an "append_to_body_part" method as well.
+
+ AddBodyPart = add_body_part
+
+ def add_form_inputs(self, form_data,
+ mime_type='application/x-www-form-urlencoded'):
+ """Form-encodes and adds data to the request body.
+
+ Args:
+ form_data: dict or sequnce or two member tuples which contains the
+ form keys and values.
+ mime_type: str The MIME type of the form data being sent. Defaults
+ to 'application/x-www-form-urlencoded'.
+ """
+ body = urllib.urlencode(form_data)
+ self.add_body_part(body, mime_type)
+
+ AddFormInputs = add_form_inputs
+
+ def _copy(self):
+ """Creates a deep copy of this request."""
+ copied_uri = Uri(self.uri.scheme, self.uri.host, self.uri.port,
+ self.uri.path, self.uri.query.copy())
+ new_request = HttpRequest(uri=copied_uri, method=self.method,
+ headers=self.headers.copy())
+ new_request._body_parts = self._body_parts[:]
+ return new_request
+
+ def _dump(self):
+ """Converts to a printable string for debugging purposes.
+
+ In order to preserve the request, it does not read from file-like objects
+ in the body.
+ """
+ output = 'HTTP Request\n method: %s\n url: %s\n headers:\n' % (
+ self.method, str(self.uri))
+ for header, value in self.headers.iteritems():
+ output += ' %s: %s\n' % (header, value)
+ output += ' body sections:\n'
+ i = 0
+ for part in self._body_parts:
+ if isinstance(part, (str, unicode)):
+ output += ' %s: %s\n' % (i, part)
+ else:
+ output += ' %s: <file like object>\n' % i
+ i += 1
+ return output
+
+
+def _apply_defaults(http_request):
+ if http_request.uri.scheme is None:
+ if http_request.uri.port == 443:
+ http_request.uri.scheme = 'https'
+ else:
+ http_request.uri.scheme = 'http'
+
+
+class Uri(object):
+ """A URI as used in HTTP 1.1"""
+ scheme = None
+ host = None
+ port = None
+ path = None
+
+ def __init__(self, scheme=None, host=None, port=None, path=None, query=None):
+ """Constructor for a URI.
+
+ Args:
+ scheme: str This is usually 'http' or 'https'.
+ host: str The host name or IP address of the desired server.
+ post: int The server's port number.
+ path: str The path of the resource following the host. This begins with
+ a /, example: '/calendar/feeds/default/allcalendars/full'
+ query: dict of strings The URL query parameters. The keys and values are
+ both escaped so this dict should contain the unescaped values.
+ For example {'my key': 'val', 'second': '!!!'} will become
+ '?my+key=val&second=%21%21%21' which is appended to the path.
+ """
+ self.query = query or {}
+ if scheme is not None:
+ self.scheme = scheme
+ if host is not None:
+ self.host = host
+ if port is not None:
+ self.port = port
+ if path:
+ self.path = path
+
+ def _get_query_string(self):
+ param_pairs = []
+ for key, value in self.query.iteritems():
+ quoted_key = urllib.quote_plus(str(key))
+ if value is None:
+ param_pairs.append(quoted_key)
+ else:
+ quoted_value = urllib.quote_plus(str(value))
+ param_pairs.append('%s=%s' % (quoted_key, quoted_value))
+ return '&'.join(param_pairs)
+
+ def _get_relative_path(self):
+ """Returns the path with the query parameters escaped and appended."""
+ param_string = self._get_query_string()
+ if self.path is None:
+ path = '/'
+ else:
+ path = self.path
+ if param_string:
+ return '?'.join([path, param_string])
+ else:
+ return path
+
+ def _to_string(self):
+ if self.scheme is None and self.port == 443:
+ scheme = 'https'
+ elif self.scheme is None:
+ scheme = 'http'
+ else:
+ scheme = self.scheme
+ if self.path is None:
+ path = '/'
+ else:
+ path = self.path
+ if self.port is None:
+ return '%s://%s%s' % (scheme, self.host, self._get_relative_path())
+ else:
+ return '%s://%s:%s%s' % (scheme, self.host, str(self.port),
+ self._get_relative_path())
+
+ def __str__(self):
+ return self._to_string()
+
+ def modify_request(self, http_request=None):
+ """Sets HTTP request components based on the URI."""
+ if http_request is None:
+ http_request = HttpRequest()
+ if http_request.uri is None:
+ http_request.uri = Uri()
+ # Determine the correct scheme.
+ if self.scheme:
+ http_request.uri.scheme = self.scheme
+ if self.port:
+ http_request.uri.port = self.port
+ if self.host:
+ http_request.uri.host = self.host
+ # Set the relative uri path
+ if self.path:
+ http_request.uri.path = self.path
+ if self.query:
+ http_request.uri.query = self.query.copy()
+ return http_request
+
+ ModifyRequest = modify_request
+
+ def parse_uri(uri_string):
+ """Creates a Uri object which corresponds to the URI string.
+
+ This method can accept partial URIs, but it will leave missing
+ members of the Uri unset.
+ """
+ parts = urlparse.urlparse(uri_string)
+ uri = Uri()
+ if parts[0]:
+ uri.scheme = parts[0]
+ if parts[1]:
+ host_parts = parts[1].split(':')
+ if host_parts[0]:
+ uri.host = host_parts[0]
+ if len(host_parts) > 1:
+ uri.port = int(host_parts[1])
+ if parts[2]:
+ uri.path = parts[2]
+ if parts[4]:
+ param_pairs = parts[4].split('&')
+ for pair in param_pairs:
+ pair_parts = pair.split('=')
+ if len(pair_parts) > 1:
+ uri.query[urllib.unquote_plus(pair_parts[0])] = (
+ urllib.unquote_plus(pair_parts[1]))
+ elif len(pair_parts) == 1:
+ uri.query[urllib.unquote_plus(pair_parts[0])] = None
+ return uri
+
+ parse_uri = staticmethod(parse_uri)
+
+ ParseUri = parse_uri
+
+
+parse_uri = Uri.parse_uri
+
+
+ParseUri = Uri.parse_uri
+
+
+class HttpResponse(object):
+ status = None
+ reason = None
+ _body = None
+
+ def __init__(self, status=None, reason=None, headers=None, body=None):
+ self._headers = headers or {}
+ if status is not None:
+ self.status = status
+ if reason is not None:
+ self.reason = reason
+ if body is not None:
+ if hasattr(body, 'read'):
+ self._body = body
+ else:
+ self._body = StringIO.StringIO(body)
+
+ def getheader(self, name, default=None):
+ if name in self._headers:
+ return self._headers[name]
+ else:
+ return default
+
+ def getheaders(self):
+ return self._headers
+
+ def read(self, amt=None):
+ if self._body is None:
+ return None
+ if not amt:
+ return self._body.read()
+ else:
+ return self._body.read(amt)
+
+
+def _dump_response(http_response):
+ """Converts to a string for printing debug messages.
+
+ Does not read the body since that may consume the content.
+ """
+ output = 'HttpResponse\n status: %s\n reason: %s\n headers:' % (
+ http_response.status, http_response.reason)
+ headers = get_headers(http_response)
+ if isinstance(headers, dict):
+ for header, value in headers.iteritems():
+ output += ' %s: %s\n' % (header, value)
+ else:
+ for pair in headers:
+ output += ' %s: %s\n' % (pair[0], pair[1])
+ return output
+
+
+class HttpClient(object):
+ """Performs HTTP requests using httplib."""
+ debug = None
+
+ def request(self, http_request):
+ return self._http_request(http_request.method, http_request.uri,
+ http_request.headers, http_request._body_parts)
+
+ Request = request
+
+ def _get_connection(self, uri, headers=None):
+ """Opens a socket connection to the server to set up an HTTP request.
+
+ Args:
+ uri: The full URL for the request as a Uri object.
+ headers: A dict of string pairs containing the HTTP headers for the
+ request.
+ """
+ connection = None
+ if uri.scheme == 'https':
+ if not uri.port:
+ connection = httplib.HTTPSConnection(uri.host)
+ else:
+ connection = httplib.HTTPSConnection(uri.host, int(uri.port))
+ else:
+ if not uri.port:
+ connection = httplib.HTTPConnection(uri.host)
+ else:
+ connection = httplib.HTTPConnection(uri.host, int(uri.port))
+ return connection
+
+ def _http_request(self, method, uri, headers=None, body_parts=None):
+ """Makes an HTTP request using httplib.
+
+ Args:
+ method: str example: 'GET', 'POST', 'PUT', 'DELETE', etc.
+ uri: str or atom.http_core.Uri
+ headers: dict of strings mapping to strings which will be sent as HTTP
+ headers in the request.
+ body_parts: list of strings, objects with a read method, or objects
+ which can be converted to strings using str. Each of these
+ will be sent in order as the body of the HTTP request.
+ """
+ if isinstance(uri, (str, unicode)):
+ uri = Uri.parse_uri(uri)
+
+ connection = self._get_connection(uri, headers=headers)
+
+ if self.debug:
+ connection.debuglevel = 1
+
+ if connection.host != uri.host:
+ connection.putrequest(method, str(uri))
+ else:
+ connection.putrequest(method, uri._get_relative_path())
+
+ # Overcome a bug in Python 2.4 and 2.5
+ # httplib.HTTPConnection.putrequest adding
+ # HTTP request header 'Host: www.google.com:443' instead of
+ # 'Host: www.google.com', and thus resulting the error message
+ # 'Token invalid - AuthSub token has wrong scope' in the HTTP response.
+ if (uri.scheme == 'https' and int(uri.port or 443) == 443 and
+ hasattr(connection, '_buffer') and
+ isinstance(connection._buffer, list)):
+ header_line = 'Host: %s:443' % uri.host
+ replacement_header_line = 'Host: %s' % uri.host
+ try:
+ connection._buffer[connection._buffer.index(header_line)] = (
+ replacement_header_line)
+ except ValueError: # header_line missing from connection._buffer
+ pass
+
+ # Send the HTTP headers.
+ for header_name, value in headers.iteritems():
+ connection.putheader(header_name, value)
+ connection.endheaders()
+
+ # If there is data, send it in the request.
+ if body_parts and filter(lambda x: x != '', body_parts):
+ for part in body_parts:
+ _send_data_part(part, connection)
+
+ # Return the HTTP Response from the server.
+ return connection.getresponse()
+
+
+def _send_data_part(data, connection):
+ if isinstance(data, (str, unicode)):
+ # I might want to just allow str, not unicode.
+ connection.send(data)
+ return
+ # Check to see if data is a file-like object that has a read method.
+ elif hasattr(data, 'read'):
+ # Read the file and send it a chunk at a time.
+ while 1:
+ binarydata = data.read(100000)
+ if binarydata == '': break
+ connection.send(binarydata)
+ return
+ else:
+ # The data object was not a file.
+ # Try to convert to a string and send the data.
+ connection.send(str(data))
+ return
+
+
+class ProxiedHttpClient(HttpClient):
+
+ def _get_connection(self, uri, headers=None):
+ # Check to see if there are proxy settings required for this request.
+ proxy = None
+ if uri.scheme == 'https':
+ proxy = os.environ.get('https_proxy')
+ elif uri.scheme == 'http':
+ proxy = os.environ.get('http_proxy')
+ if not proxy:
+ return HttpClient._get_connection(self, uri, headers=headers)
+ # Now we have the URL of the appropriate proxy server.
+ # Get a username and password for the proxy if required.
+ proxy_auth = _get_proxy_auth()
+ if uri.scheme == 'https':
+ import socket
+ if proxy_auth:
+ proxy_auth = 'Proxy-authorization: %s' % proxy_auth
+ # Construct the proxy connect command.
+ port = uri.port
+ if not port:
+ port = 443
+ proxy_connect = 'CONNECT %s:%s HTTP/1.0\r\n' % (uri.host, port)
+ # Set the user agent to send to the proxy
+ user_agent = ''
+ if headers and 'User-Agent' in headers:
+ user_agent = 'User-Agent: %s\r\n' % (headers['User-Agent'])
+ proxy_pieces = '%s%s%s\r\n' % (proxy_connect, proxy_auth, user_agent)
+ # Find the proxy host and port.
+ proxy_uri = Uri.parse_uri(proxy)
+ if not proxy_uri.port:
+ proxy_uri.port = '80'
+ # Connect to the proxy server, very simple recv and error checking
+ p_sock = socket.socket(socket.AF_INET,socket.SOCK_STREAM)
+ p_sock.connect((proxy_uri.host, int(proxy_uri.port)))
+ p_sock.sendall(proxy_pieces)
+ response = ''
+ # Wait for the full response.
+ while response.find("\r\n\r\n") == -1:
+ response += p_sock.recv(8192)
+ p_status = response.split()[1]
+ if p_status != str(200):
+ raise ProxyError('Error status=%s' % str(p_status))
+ # Trivial setup for ssl socket.
+ sslobj = None
+ if ssl is not None:
+ sslobj = ssl.wrap_socket(p_sock, None, None)
+ else:
+ sock_ssl = socket.ssl(p_sock, None, Nonesock_)
+ sslobj = httplib.FakeSocket(p_sock, sock_ssl)
+ # Initalize httplib and replace with the proxy socket.
+ connection = httplib.HTTPConnection(proxy_uri.host)
+ connection.sock = sslobj
+ return connection
+ elif uri.scheme == 'http':
+ proxy_uri = Uri.parse_uri(proxy)
+ if not proxy_uri.port:
+ proxy_uri.port = '80'
+ if proxy_auth:
+ headers['Proxy-Authorization'] = proxy_auth.strip()
+ return httplib.HTTPConnection(proxy_uri.host, int(proxy_uri.port))
+ return None
+
+
+def _get_proxy_auth():
+ import base64
+ proxy_username = os.environ.get('proxy-username')
+ if not proxy_username:
+ proxy_username = os.environ.get('proxy_username')
+ proxy_password = os.environ.get('proxy-password')
+ if not proxy_password:
+ proxy_password = os.environ.get('proxy_password')
+ if proxy_username:
+ user_auth = base64.b64encode('%s:%s' % (proxy_username,
+ proxy_password))
+ return 'Basic %s\r\n' % (user_auth.strip())
+ else:
+ return ''
diff --git a/src/atom/http_interface.py b/src/atom/http_interface.py
new file mode 100644
index 0000000..d8e8495
--- /dev/null
+++ b/src/atom/http_interface.py
@@ -0,0 +1,156 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""This module provides a common interface for all HTTP requests.
+
+ HttpResponse: Represents the server's response to an HTTP request. Provides
+ an interface identical to httplib.HTTPResponse which is the response
+ expected from higher level classes which use HttpClient.request.
+
+ GenericHttpClient: Provides an interface (superclass) for an object
+ responsible for making HTTP requests. Subclasses of this object are
+ used in AtomService and GDataService to make requests to the server. By
+ changing the http_client member object, the AtomService is able to make
+ HTTP requests using different logic (for example, when running on
+ Google App Engine, the http_client makes requests using the App Engine
+ urlfetch API).
+"""
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import StringIO
+
+
+USER_AGENT = '%s GData-Python/2.0.18'
+
+
+class Error(Exception):
+ pass
+
+
+class UnparsableUrlObject(Error):
+ pass
+
+
+class ContentLengthRequired(Error):
+ pass
+
+
+class HttpResponse(object):
+ def __init__(self, body=None, status=None, reason=None, headers=None):
+ """Constructor for an HttpResponse object.
+
+ HttpResponse represents the server's response to an HTTP request from
+ the client. The HttpClient.request method returns a httplib.HTTPResponse
+ object and this HttpResponse class is designed to mirror the interface
+ exposed by httplib.HTTPResponse.
+
+ Args:
+ body: A file like object, with a read() method. The body could also
+ be a string, and the constructor will wrap it so that
+ HttpResponse.read(self) will return the full string.
+ status: The HTTP status code as an int. Example: 200, 201, 404.
+ reason: The HTTP status message which follows the code. Example:
+ OK, Created, Not Found
+ headers: A dictionary containing the HTTP headers in the server's
+ response. A common header in the response is Content-Length.
+ """
+ if body:
+ if hasattr(body, 'read'):
+ self._body = body
+ else:
+ self._body = StringIO.StringIO(body)
+ else:
+ self._body = None
+ if status is not None:
+ self.status = int(status)
+ else:
+ self.status = None
+ self.reason = reason
+ self._headers = headers or {}
+
+ def getheader(self, name, default=None):
+ if name in self._headers:
+ return self._headers[name]
+ else:
+ return default
+
+ def read(self, amt=None):
+ if not amt:
+ return self._body.read()
+ else:
+ return self._body.read(amt)
+
+
+class GenericHttpClient(object):
+ debug = False
+
+ def __init__(self, http_client, headers=None):
+ """
+
+ Args:
+ http_client: An object which provides a request method to make an HTTP
+ request. The request method in GenericHttpClient performs a
+ call-through to the contained HTTP client object.
+ headers: A dictionary containing HTTP headers which should be included
+ in every HTTP request. Common persistent headers include
+ 'User-Agent'.
+ """
+ self.http_client = http_client
+ self.headers = headers or {}
+
+ def request(self, operation, url, data=None, headers=None):
+ all_headers = self.headers.copy()
+ if headers:
+ all_headers.update(headers)
+ return self.http_client.request(operation, url, data=data,
+ headers=all_headers)
+
+ def get(self, url, headers=None):
+ return self.request('GET', url, headers=headers)
+
+ def post(self, url, data, headers=None):
+ return self.request('POST', url, data=data, headers=headers)
+
+ def put(self, url, data, headers=None):
+ return self.request('PUT', url, data=data, headers=headers)
+
+ def delete(self, url, headers=None):
+ return self.request('DELETE', url, headers=headers)
+
+
+class GenericToken(object):
+ """Represents an Authorization token to be added to HTTP requests.
+
+ Some Authorization headers included calculated fields (digital
+ signatures for example) which are based on the parameters of the HTTP
+ request. Therefore the token is responsible for signing the request
+ and adding the Authorization header.
+ """
+ def perform_request(self, http_client, operation, url, data=None,
+ headers=None):
+ """For the GenericToken, no Authorization token is set."""
+ return http_client.request(operation, url, data=data, headers=headers)
+
+ def valid_for_scope(self, url):
+ """Tells the caller if the token authorizes access to the desired URL.
+
+ Since the generic token doesn't add an auth header, it is not valid for
+ any scope.
+ """
+ return False
diff --git a/src/atom/mock_http.py b/src/atom/mock_http.py
new file mode 100644
index 0000000..c420f37
--- /dev/null
+++ b/src/atom/mock_http.py
@@ -0,0 +1,132 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import atom.http_interface
+import atom.url
+
+
+class Error(Exception):
+ pass
+
+
+class NoRecordingFound(Error):
+ pass
+
+
+class MockRequest(object):
+ """Holds parameters of an HTTP request for matching against future requests.
+ """
+ def __init__(self, operation, url, data=None, headers=None):
+ self.operation = operation
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ self.url = url
+ self.data = data
+ self.headers = headers
+
+
+class MockResponse(atom.http_interface.HttpResponse):
+ """Simulates an httplib.HTTPResponse object."""
+ def __init__(self, body=None, status=None, reason=None, headers=None):
+ if body and hasattr(body, 'read'):
+ self.body = body.read()
+ else:
+ self.body = body
+ if status is not None:
+ self.status = int(status)
+ else:
+ self.status = None
+ self.reason = reason
+ self._headers = headers or {}
+
+ def read(self):
+ return self.body
+
+
+class MockHttpClient(atom.http_interface.GenericHttpClient):
+ def __init__(self, headers=None, recordings=None, real_client=None):
+ """An HttpClient which responds to request with stored data.
+
+ The request-response pairs are stored as tuples in a member list named
+ recordings.
+
+ The MockHttpClient can be switched from replay mode to record mode by
+ setting the real_client member to an instance of an HttpClient which will
+ make real HTTP requests and store the server's response in list of
+ recordings.
+
+ Args:
+ headers: dict containing HTTP headers which should be included in all
+ HTTP requests.
+ recordings: The initial recordings to be used for responses. This list
+ contains tuples in the form: (MockRequest, MockResponse)
+ real_client: An HttpClient which will make a real HTTP request. The
+ response will be converted into a MockResponse and stored in
+ recordings.
+ """
+ self.recordings = recordings or []
+ self.real_client = real_client
+ self.headers = headers or {}
+
+ def add_response(self, response, operation, url, data=None, headers=None):
+ """Adds a request-response pair to the recordings list.
+
+ After the recording is added, future matching requests will receive the
+ response.
+
+ Args:
+ response: MockResponse
+ operation: str
+ url: str
+ data: str, Currently the data is ignored when looking for matching
+ requests.
+ headers: dict of strings: Currently the headers are ignored when
+ looking for matching requests.
+ """
+ request = MockRequest(operation, url, data=data, headers=headers)
+ self.recordings.append((request, response))
+
+ def request(self, operation, url, data=None, headers=None):
+ """Returns a matching MockResponse from the recordings.
+
+ If the real_client is set, the request will be passed along and the
+ server's response will be added to the recordings and also returned.
+
+ If there is no match, a NoRecordingFound error will be raised.
+ """
+ if self.real_client is None:
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ for recording in self.recordings:
+ if recording[0].operation == operation and recording[0].url == url:
+ return recording[1]
+ raise NoRecordingFound('No recodings found for %s %s' % (
+ operation, url))
+ else:
+ # There is a real HTTP client, so make the request, and record the
+ # response.
+ response = self.real_client.request(operation, url, data=data,
+ headers=headers)
+ # TODO: copy the headers
+ stored_response = MockResponse(body=response, status=response.status,
+ reason=response.reason)
+ self.add_response(stored_response, operation, url, data=data,
+ headers=headers)
+ return stored_response
diff --git a/src/atom/mock_http_core.py b/src/atom/mock_http_core.py
new file mode 100644
index 0000000..f55cdc5
--- /dev/null
+++ b/src/atom/mock_http_core.py
@@ -0,0 +1,323 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import StringIO
+import pickle
+import os.path
+import tempfile
+import atom.http_core
+
+
+class Error(Exception):
+ pass
+
+
+class NoRecordingFound(Error):
+ pass
+
+
+class MockHttpClient(object):
+ debug = None
+ real_client = None
+ last_request_was_live = False
+
+ # The following members are used to construct the session cache temp file
+ # name.
+ # These are combined to form the file name
+ # /tmp/cache_prefix.cache_case_name.cache_test_name
+ cache_name_prefix = 'gdata_live_test'
+ cache_case_name = ''
+ cache_test_name = ''
+
+ def __init__(self, recordings=None, real_client=None):
+ self._recordings = recordings or []
+ if real_client is not None:
+ self.real_client = real_client
+
+ def add_response(self, http_request, status, reason, headers=None,
+ body=None):
+ response = MockHttpResponse(status, reason, headers, body)
+ # TODO Scrub the request and the response.
+ self._recordings.append((http_request._copy(), response))
+
+ AddResponse = add_response
+
+ def request(self, http_request):
+ """Provide a recorded response, or record a response for replay.
+
+ If the real_client is set, the request will be made using the
+ real_client, and the response from the server will be recorded.
+ If the real_client is None (the default), this method will examine
+ the recordings and find the first which matches.
+ """
+ request = http_request._copy()
+ _scrub_request(request)
+ if self.real_client is None:
+ self.last_request_was_live = False
+ for recording in self._recordings:
+ if _match_request(recording[0], request):
+ return recording[1]
+ else:
+ # Pass along the debug settings to the real client.
+ self.real_client.debug = self.debug
+ # Make an actual request since we can use the real HTTP client.
+ self.last_request_was_live = True
+ response = self.real_client.request(http_request)
+ scrubbed_response = _scrub_response(response)
+ self.add_response(request, scrubbed_response.status,
+ scrubbed_response.reason,
+ dict(atom.http_core.get_headers(scrubbed_response)),
+ scrubbed_response.read())
+ # Return the recording which we just added.
+ return self._recordings[-1][1]
+ raise NoRecordingFound('No recoding was found for request: %s %s' % (
+ request.method, str(request.uri)))
+
+ Request = request
+
+ def _save_recordings(self, filename):
+ recording_file = open(os.path.join(tempfile.gettempdir(), filename),
+ 'wb')
+ pickle.dump(self._recordings, recording_file)
+ recording_file.close()
+
+ def _load_recordings(self, filename):
+ recording_file = open(os.path.join(tempfile.gettempdir(), filename),
+ 'rb')
+ self._recordings = pickle.load(recording_file)
+ recording_file.close()
+
+ def _delete_recordings(self, filename):
+ full_path = os.path.join(tempfile.gettempdir(), filename)
+ if os.path.exists(full_path):
+ os.remove(full_path)
+
+ def _load_or_use_client(self, filename, http_client):
+ if os.path.exists(os.path.join(tempfile.gettempdir(), filename)):
+ self._load_recordings(filename)
+ else:
+ self.real_client = http_client
+
+ def use_cached_session(self, name=None, real_http_client=None):
+ """Attempts to load recordings from a previous live request.
+
+ If a temp file with the recordings exists, then it is used to fulfill
+ requests. If the file does not exist, then a real client is used to
+ actually make the desired HTTP requests. Requests and responses are
+ recorded and will be written to the desired temprary cache file when
+ close_session is called.
+
+ Args:
+ name: str (optional) The file name of session file to be used. The file
+ is loaded from the temporary directory of this machine. If no name
+ is passed in, a default name will be constructed using the
+ cache_name_prefix, cache_case_name, and cache_test_name of this
+ object.
+ real_http_client: atom.http_core.HttpClient the real client to be used
+ if the cached recordings are not found. If the default
+ value is used, this will be an
+ atom.http_core.HttpClient.
+ """
+ if real_http_client is None:
+ real_http_client = atom.http_core.HttpClient()
+ if name is None:
+ self._recordings_cache_name = self.get_cache_file_name()
+ else:
+ self._recordings_cache_name = name
+ self._load_or_use_client(self._recordings_cache_name, real_http_client)
+
+ def close_session(self):
+ """Saves recordings in the temporary file named in use_cached_session."""
+ if self.real_client is not None:
+ self._save_recordings(self._recordings_cache_name)
+
+ def delete_session(self, name=None):
+ """Removes recordings from a previous live request."""
+ if name is None:
+ self._delete_recordings(self._recordings_cache_name)
+ else:
+ self._delete_recordings(name)
+
+ def get_cache_file_name(self):
+ return '%s.%s.%s' % (self.cache_name_prefix, self.cache_case_name,
+ self.cache_test_name)
+
+ def _dump(self):
+ """Provides debug information in a string."""
+ output = 'MockHttpClient\n real_client: %s\n cache file name: %s\n' % (
+ self.real_client, self.get_cache_file_name())
+ output += ' recordings:\n'
+ i = 0
+ for recording in self._recordings:
+ output += ' recording %i is for: %s %s\n' % (
+ i, recording[0].method, str(recording[0].uri))
+ i += 1
+ return output
+
+
+def _match_request(http_request, stored_request):
+ """Determines whether a request is similar enough to a stored request
+ to cause the stored response to be returned."""
+ # Check to see if the host names match.
+ if (http_request.uri.host is not None
+ and http_request.uri.host != stored_request.uri.host):
+ return False
+ # Check the request path in the URL (/feeds/private/full/x)
+ elif http_request.uri.path != stored_request.uri.path:
+ return False
+ # Check the method used in the request (GET, POST, etc.)
+ elif http_request.method != stored_request.method:
+ return False
+ # If there is a gsession ID in either request, make sure that it is matched
+ # exactly.
+ elif ('gsessionid' in http_request.uri.query
+ or 'gsessionid' in stored_request.uri.query):
+ if 'gsessionid' not in stored_request.uri.query:
+ return False
+ elif 'gsessionid' not in http_request.uri.query:
+ return False
+ elif (http_request.uri.query['gsessionid']
+ != stored_request.uri.query['gsessionid']):
+ return False
+ # Ignores differences in the query params (?start-index=5&max-results=20),
+ # the body of the request, the port number, HTTP headers, just to name a
+ # few.
+ return True
+
+
+def _scrub_request(http_request):
+ """ Removes email address and password from a client login request.
+
+ Since the mock server saves the request and response in plantext, sensitive
+ information like the password should be removed before saving the
+ recordings. At the moment only requests sent to a ClientLogin url are
+ scrubbed.
+ """
+ if (http_request and http_request.uri and http_request.uri.path and
+ http_request.uri.path.endswith('ClientLogin')):
+ # Remove the email and password from a ClientLogin request.
+ http_request._body_parts = []
+ http_request.add_form_inputs(
+ {'form_data': 'client login request has been scrubbed'})
+ else:
+ # We can remove the body of the post from the recorded request, since
+ # the request body is not used when finding a matching recording.
+ http_request._body_parts = []
+ return http_request
+
+
+def _scrub_response(http_response):
+ return http_response
+
+
+class EchoHttpClient(object):
+ """Sends the request data back in the response.
+
+ Used to check the formatting of the request as it was sent. Always responds
+ with a 200 OK, and some information from the HTTP request is returned in
+ special Echo-X headers in the response. The following headers are added
+ in the response:
+ 'Echo-Host': The host name and port number to which the HTTP connection is
+ made. If no port was passed in, the header will contain
+ host:None.
+ 'Echo-Uri': The path portion of the URL being requested. /example?x=1&y=2
+ 'Echo-Scheme': The beginning of the URL, usually 'http' or 'https'
+ 'Echo-Method': The HTTP method being used, 'GET', 'POST', 'PUT', etc.
+ """
+
+ def request(self, http_request):
+ return self._http_request(http_request.uri, http_request.method,
+ http_request.headers, http_request._body_parts)
+
+ def _http_request(self, uri, method, headers=None, body_parts=None):
+ body = StringIO.StringIO()
+ response = atom.http_core.HttpResponse(status=200, reason='OK', body=body)
+ if headers is None:
+ response._headers = {}
+ else:
+ # Copy headers from the request to the response but convert values to
+ # strings. Server response headers always come in as strings, so an int
+ # should be converted to a corresponding string when echoing.
+ for header, value in headers.iteritems():
+ response._headers[header] = str(value)
+ response._headers['Echo-Host'] = '%s:%s' % (uri.host, str(uri.port))
+ response._headers['Echo-Uri'] = uri._get_relative_path()
+ response._headers['Echo-Scheme'] = uri.scheme
+ response._headers['Echo-Method'] = method
+ for part in body_parts:
+ if isinstance(part, str):
+ body.write(part)
+ elif hasattr(part, 'read'):
+ body.write(part.read())
+ body.seek(0)
+ return response
+
+
+class SettableHttpClient(object):
+ """An HTTP Client which responds with the data given in set_response."""
+
+ def __init__(self, status, reason, body, headers):
+ """Configures the response for the server.
+
+ See set_response for details on the arguments to the constructor.
+ """
+ self.set_response(status, reason, body, headers)
+ self.last_request = None
+
+ def set_response(self, status, reason, body, headers):
+ """Determines the response which will be sent for each request.
+
+ Args:
+ status: An int for the HTTP status code, example: 200, 404, etc.
+ reason: String for the HTTP reason, example: OK, NOT FOUND, etc.
+ body: The body of the HTTP response as a string or a file-like
+ object (something with a read method).
+ headers: dict of strings containing the HTTP headers in the response.
+ """
+ self.response = atom.http_core.HttpResponse(status=status, reason=reason,
+ body=body)
+ self.response._headers = headers.copy()
+
+ def request(self, http_request):
+ self.last_request = http_request
+ return self.response
+
+
+class MockHttpResponse(atom.http_core.HttpResponse):
+
+ def __init__(self, status=None, reason=None, headers=None, body=None):
+ self._headers = headers or {}
+ if status is not None:
+ self.status = status
+ if reason is not None:
+ self.reason = reason
+ if body is not None:
+ # Instead of using a file-like object for the body, store as a string
+ # so that reads can be repeated.
+ if hasattr(body, 'read'):
+ self._body = body.read()
+ else:
+ self._body = body
+
+ def read(self):
+ return self._body
diff --git a/src/atom/mock_service.py b/src/atom/mock_service.py
new file mode 100755
index 0000000..601b68a
--- /dev/null
+++ b/src/atom/mock_service.py
@@ -0,0 +1,243 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""MockService provides CRUD ops. for mocking calls to AtomPub services.
+
+ MockService: Exposes the publicly used methods of AtomService to provide
+ a mock interface which can be used in unit tests.
+"""
+
+import atom.service
+import pickle
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+
+# Recordings contains pairings of HTTP MockRequest objects with MockHttpResponse objects.
+recordings = []
+# If set, the mock service HttpRequest are actually made through this object.
+real_request_handler = None
+
+def ConcealValueWithSha(source):
+ import sha
+ return sha.new(source[:-5]).hexdigest()
+
+def DumpRecordings(conceal_func=ConcealValueWithSha):
+ if conceal_func:
+ for recording_pair in recordings:
+ recording_pair[0].ConcealSecrets(conceal_func)
+ return pickle.dumps(recordings)
+
+def LoadRecordings(recordings_file_or_string):
+ if isinstance(recordings_file_or_string, str):
+ atom.mock_service.recordings = pickle.loads(recordings_file_or_string)
+ elif hasattr(recordings_file_or_string, 'read'):
+ atom.mock_service.recordings = pickle.loads(
+ recordings_file_or_string.read())
+
+def HttpRequest(service, operation, data, uri, extra_headers=None,
+ url_params=None, escape_params=True, content_type='application/atom+xml'):
+ """Simulates an HTTP call to the server, makes an actual HTTP request if
+ real_request_handler is set.
+
+ This function operates in two different modes depending on if
+ real_request_handler is set or not. If real_request_handler is not set,
+ HttpRequest will look in this module's recordings list to find a response
+ which matches the parameters in the function call. If real_request_handler
+ is set, this function will call real_request_handler.HttpRequest, add the
+ response to the recordings list, and respond with the actual response.
+
+ Args:
+ service: atom.AtomService object which contains some of the parameters
+ needed to make the request. The following members are used to
+ construct the HTTP call: server (str), additional_headers (dict),
+ port (int), and ssl (bool).
+ operation: str The HTTP operation to be performed. This is usually one of
+ 'GET', 'POST', 'PUT', or 'DELETE'
+ data: ElementTree, filestream, list of parts, or other object which can be
+ converted to a string.
+ Should be set to None when performing a GET or PUT.
+ If data is a file-like object which can be read, this method will read
+ a chunk of 100K bytes at a time and send them.
+ If the data is a list of parts to be sent, each part will be evaluated
+ and sent.
+ uri: The beginning of the URL to which the request should be sent.
+ Examples: '/', '/base/feeds/snippets',
+ '/m8/feeds/contacts/default/base'
+ extra_headers: dict of strings. HTTP headers which should be sent
+ in the request. These headers are in addition to those stored in
+ service.additional_headers.
+ url_params: dict of strings. Key value pairs to be added to the URL as
+ URL parameters. For example {'foo':'bar', 'test':'param'} will
+ become ?foo=bar&test=param.
+ escape_params: bool default True. If true, the keys and values in
+ url_params will be URL escaped when the form is constructed
+ (Special characters converted to %XX form.)
+ content_type: str The MIME type for the data being sent. Defaults to
+ 'application/atom+xml', this is only used if data is set.
+ """
+ full_uri = atom.service.BuildUri(uri, url_params, escape_params)
+ (server, port, ssl, uri) = atom.service.ProcessUrl(service, uri)
+ current_request = MockRequest(operation, full_uri, host=server, ssl=ssl,
+ data=data, extra_headers=extra_headers, url_params=url_params,
+ escape_params=escape_params, content_type=content_type)
+ # If the request handler is set, we should actually make the request using
+ # the request handler and record the response to replay later.
+ if real_request_handler:
+ response = real_request_handler.HttpRequest(service, operation, data, uri,
+ extra_headers=extra_headers, url_params=url_params,
+ escape_params=escape_params, content_type=content_type)
+ # TODO: need to copy the HTTP headers from the real response into the
+ # recorded_response.
+ recorded_response = MockHttpResponse(body=response.read(),
+ status=response.status, reason=response.reason)
+ # Insert a tuple which maps the request to the response object returned
+ # when making an HTTP call using the real_request_handler.
+ recordings.append((current_request, recorded_response))
+ return recorded_response
+ else:
+ # Look through available recordings to see if one matches the current
+ # request.
+ for request_response_pair in recordings:
+ if request_response_pair[0].IsMatch(current_request):
+ return request_response_pair[1]
+ return None
+
+
+class MockRequest(object):
+ """Represents a request made to an AtomPub server.
+
+ These objects are used to determine if a client request matches a recorded
+ HTTP request to determine what the mock server's response will be.
+ """
+
+ def __init__(self, operation, uri, host=None, ssl=False, port=None,
+ data=None, extra_headers=None, url_params=None, escape_params=True,
+ content_type='application/atom+xml'):
+ """Constructor for a MockRequest
+
+ Args:
+ operation: str One of 'GET', 'POST', 'PUT', or 'DELETE' this is the
+ HTTP operation requested on the resource.
+ uri: str The URL describing the resource to be modified or feed to be
+ retrieved. This should include the protocol (http/https) and the host
+ (aka domain). For example, these are some valud full_uris:
+ 'http://example.com', 'https://www.google.com/accounts/ClientLogin'
+ host: str (optional) The server name which will be placed at the
+ beginning of the URL if the uri parameter does not begin with 'http'.
+ Examples include 'example.com', 'www.google.com', 'www.blogger.com'.
+ ssl: boolean (optional) If true, the request URL will begin with https
+ instead of http.
+ data: ElementTree, filestream, list of parts, or other object which can be
+ converted to a string. (optional)
+ Should be set to None when performing a GET or PUT.
+ If data is a file-like object which can be read, the constructor
+ will read the entire file into memory. If the data is a list of
+ parts to be sent, each part will be evaluated and stored.
+ extra_headers: dict (optional) HTTP headers included in the request.
+ url_params: dict (optional) Key value pairs which should be added to
+ the URL as URL parameters in the request. For example uri='/',
+ url_parameters={'foo':'1','bar':'2'} could become '/?foo=1&bar=2'.
+ escape_params: boolean (optional) Perform URL escaping on the keys and
+ values specified in url_params. Defaults to True.
+ content_type: str (optional) Provides the MIME type of the data being
+ sent.
+ """
+ self.operation = operation
+ self.uri = _ConstructFullUrlBase(uri, host=host, ssl=ssl)
+ self.data = data
+ self.extra_headers = extra_headers
+ self.url_params = url_params or {}
+ self.escape_params = escape_params
+ self.content_type = content_type
+
+ def ConcealSecrets(self, conceal_func):
+ """Conceal secret data in this request."""
+ if self.extra_headers.has_key('Authorization'):
+ self.extra_headers['Authorization'] = conceal_func(
+ self.extra_headers['Authorization'])
+
+ def IsMatch(self, other_request):
+ """Check to see if the other_request is equivalent to this request.
+
+ Used to determine if a recording matches an incoming request so that a
+ recorded response should be sent to the client.
+
+ The matching is not exact, only the operation and URL are examined
+ currently.
+
+ Args:
+ other_request: MockRequest The request which we want to check this
+ (self) MockRequest against to see if they are equivalent.
+ """
+ # More accurate matching logic will likely be required.
+ return (self.operation == other_request.operation and self.uri ==
+ other_request.uri)
+
+
+def _ConstructFullUrlBase(uri, host=None, ssl=False):
+ """Puts URL components into the form http(s)://full.host.strinf/uri/path
+
+ Used to construct a roughly canonical URL so that URLs which begin with
+ 'http://example.com/' can be compared to a uri of '/' when the host is
+ set to 'example.com'
+
+ If the uri contains 'http://host' already, the host and ssl parameters
+ are ignored.
+
+ Args:
+ uri: str The path component of the URL, examples include '/'
+ host: str (optional) The host name which should prepend the URL. Example:
+ 'example.com'
+ ssl: boolean (optional) If true, the returned URL will begin with https
+ instead of http.
+
+ Returns:
+ String which has the form http(s)://example.com/uri/string/contents
+ """
+ if uri.startswith('http'):
+ return uri
+ if ssl:
+ return 'https://%s%s' % (host, uri)
+ else:
+ return 'http://%s%s' % (host, uri)
+
+
+class MockHttpResponse(object):
+ """Returned from MockService crud methods as the server's response."""
+
+ def __init__(self, body=None, status=None, reason=None, headers=None):
+ """Construct a mock HTTPResponse and set members.
+
+ Args:
+ body: str (optional) The HTTP body of the server's response.
+ status: int (optional)
+ reason: str (optional)
+ headers: dict (optional)
+ """
+ self.body = body
+ self.status = status
+ self.reason = reason
+ self.headers = headers or {}
+
+ def read(self):
+ return self.body
+
+ def getheader(self, header_name):
+ return self.headers[header_name]
+
diff --git a/src/atom/service.py b/src/atom/service.py
new file mode 100755
index 0000000..00f6637
--- /dev/null
+++ b/src/atom/service.py
@@ -0,0 +1,740 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006, 2007, 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""AtomService provides CRUD ops. in line with the Atom Publishing Protocol.
+
+ AtomService: Encapsulates the ability to perform insert, update and delete
+ operations with the Atom Publishing Protocol on which GData is
+ based. An instance can perform query, insertion, deletion, and
+ update.
+
+ HttpRequest: Function that performs a GET, POST, PUT, or DELETE HTTP request
+ to the specified end point. An AtomService object or a subclass can be
+ used to specify information about the request.
+"""
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import atom.http_interface
+import atom.url
+import atom.http
+import atom.token_store
+
+import os
+import httplib
+import urllib
+import re
+import base64
+import socket
+import warnings
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import atom
+
+
+class AtomService(object):
+ """Performs Atom Publishing Protocol CRUD operations.
+
+ The AtomService contains methods to perform HTTP CRUD operations.
+ """
+
+ # Default values for members
+ port = 80
+ ssl = False
+ # Set the current_token to force the AtomService to use this token
+ # instead of searching for an appropriate token in the token_store.
+ current_token = None
+ auto_store_tokens = True
+ auto_set_current_token = True
+
+ def _get_override_token(self):
+ return self.current_token
+
+ def _set_override_token(self, token):
+ self.current_token = token
+
+ override_token = property(_get_override_token, _set_override_token)
+
+ #@atom.v1_deprecated('Please use atom.client.AtomPubClient instead.')
+ def __init__(self, server=None, additional_headers=None,
+ application_name='', http_client=None, token_store=None):
+ """Creates a new AtomService client.
+
+ Args:
+ server: string (optional) The start of a URL for the server
+ to which all operations should be directed. Example:
+ 'www.google.com'
+ additional_headers: dict (optional) Any additional HTTP headers which
+ should be included with CRUD operations.
+ http_client: An object responsible for making HTTP requests using a
+ request method. If none is provided, a new instance of
+ atom.http.ProxiedHttpClient will be used.
+ token_store: Keeps a collection of authorization tokens which can be
+ applied to requests for a specific URLs. Critical methods are
+ find_token based on a URL (atom.url.Url or a string), add_token,
+ and remove_token.
+ """
+ self.http_client = http_client or atom.http.ProxiedHttpClient()
+ self.token_store = token_store or atom.token_store.TokenStore()
+ self.server = server
+ self.additional_headers = additional_headers or {}
+ self.additional_headers['User-Agent'] = atom.http_interface.USER_AGENT % (
+ application_name,)
+ # If debug is True, the HTTPConnection will display debug information
+ self._set_debug(False)
+
+ __init__ = atom.v1_deprecated(
+ 'Please use atom.client.AtomPubClient instead.')(
+ __init__)
+
+ def _get_debug(self):
+ return self.http_client.debug
+
+ def _set_debug(self, value):
+ self.http_client.debug = value
+
+ debug = property(_get_debug, _set_debug,
+ doc='If True, HTTP debug information is printed.')
+
+ def use_basic_auth(self, username, password, scopes=None):
+ if username is not None and password is not None:
+ if scopes is None:
+ scopes = [atom.token_store.SCOPE_ALL]
+ base_64_string = base64.encodestring('%s:%s' % (username, password))
+ token = BasicAuthToken('Basic %s' % base_64_string.strip(),
+ scopes=[atom.token_store.SCOPE_ALL])
+ if self.auto_set_current_token:
+ self.current_token = token
+ if self.auto_store_tokens:
+ return self.token_store.add_token(token)
+ return True
+ return False
+
+ def UseBasicAuth(self, username, password, for_proxy=False):
+ """Sets an Authenticaiton: Basic HTTP header containing plaintext.
+
+ Deprecated, use use_basic_auth instead.
+
+ The username and password are base64 encoded and added to an HTTP header
+ which will be included in each request. Note that your username and
+ password are sent in plaintext.
+
+ Args:
+ username: str
+ password: str
+ """
+ self.use_basic_auth(username, password)
+
+ #@atom.v1_deprecated('Please use atom.client.AtomPubClient for requests.')
+ def request(self, operation, url, data=None, headers=None,
+ url_params=None):
+ if isinstance(url, (str, unicode)):
+ if url.startswith('http:') and self.ssl:
+ # Force all requests to be https if self.ssl is True.
+ url = atom.url.parse_url('https:' + url[5:])
+ elif not url.startswith('http') and self.ssl:
+ url = atom.url.parse_url('https://%s%s' % (self.server, url))
+ elif not url.startswith('http'):
+ url = atom.url.parse_url('http://%s%s' % (self.server, url))
+ else:
+ url = atom.url.parse_url(url)
+
+ if url_params:
+ for name, value in url_params.iteritems():
+ url.params[name] = value
+
+ all_headers = self.additional_headers.copy()
+ if headers:
+ all_headers.update(headers)
+
+ # If the list of headers does not include a Content-Length, attempt to
+ # calculate it based on the data object.
+ if data and 'Content-Length' not in all_headers:
+ content_length = CalculateDataLength(data)
+ if content_length:
+ all_headers['Content-Length'] = str(content_length)
+
+ # Find an Authorization token for this URL if one is available.
+ if self.override_token:
+ auth_token = self.override_token
+ else:
+ auth_token = self.token_store.find_token(url)
+ return auth_token.perform_request(self.http_client, operation, url,
+ data=data, headers=all_headers)
+
+ request = atom.v1_deprecated(
+ 'Please use atom.client.AtomPubClient for requests.')(
+ request)
+
+ # CRUD operations
+ def Get(self, uri, extra_headers=None, url_params=None, escape_params=True):
+ """Query the APP server with the given URI
+
+ The uri is the portion of the URI after the server value
+ (server example: 'www.google.com').
+
+ Example use:
+ To perform a query against Google Base, set the server to
+ 'base.google.com' and set the uri to '/base/feeds/...', where ... is
+ your query. For example, to find snippets for all digital cameras uri
+ should be set to: '/base/feeds/snippets?bq=digital+camera'
+
+ Args:
+ uri: string The query in the form of a URI. Example:
+ '/base/feeds/snippets?bq=digital+camera'.
+ extra_headers: dicty (optional) Extra HTTP headers to be included
+ in the GET request. These headers are in addition to
+ those stored in the client's additional_headers property.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the query. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ httplib.HTTPResponse The server's response to the GET request.
+ """
+ return self.request('GET', uri, data=None, headers=extra_headers,
+ url_params=url_params)
+
+ def Post(self, data, uri, extra_headers=None, url_params=None,
+ escape_params=True, content_type='application/atom+xml'):
+ """Insert data into an APP server at the given URI.
+
+ Args:
+ data: string, ElementTree._Element, or something with a __str__ method
+ The XML to be sent to the uri.
+ uri: string The location (feed) to which the data should be inserted.
+ Example: '/base/feeds/items'.
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type,
+ Authorization, and Content-Length headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ httplib.HTTPResponse Server's response to the POST request.
+ """
+ if extra_headers is None:
+ extra_headers = {}
+ if content_type:
+ extra_headers['Content-Type'] = content_type
+ return self.request('POST', uri, data=data, headers=extra_headers,
+ url_params=url_params)
+
+ def Put(self, data, uri, extra_headers=None, url_params=None,
+ escape_params=True, content_type='application/atom+xml'):
+ """Updates an entry at the given URI.
+
+ Args:
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The
+ XML containing the updated data.
+ uri: string A URI indicating entry to which the update will be applied.
+ Example: '/base/feeds/items/ITEM-ID'
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type,
+ Authorization, and Content-Length headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ httplib.HTTPResponse Server's response to the PUT request.
+ """
+ if extra_headers is None:
+ extra_headers = {}
+ if content_type:
+ extra_headers['Content-Type'] = content_type
+ return self.request('PUT', uri, data=data, headers=extra_headers,
+ url_params=url_params)
+
+ def Delete(self, uri, extra_headers=None, url_params=None,
+ escape_params=True):
+ """Deletes the entry at the given URI.
+
+ Args:
+ uri: string The URI of the entry to be deleted. Example:
+ '/base/feeds/items/ITEM-ID'
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ httplib.HTTPResponse Server's response to the DELETE request.
+ """
+ return self.request('DELETE', uri, data=None, headers=extra_headers,
+ url_params=url_params)
+
+
+class BasicAuthToken(atom.http_interface.GenericToken):
+ def __init__(self, auth_header, scopes=None):
+ """Creates a token used to add Basic Auth headers to HTTP requests.
+
+ Args:
+ auth_header: str The value for the Authorization header.
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs
+ for which this token can be used. For example, if scopes contains
+ 'http://example.com/foo', then this token can be used for a request to
+ 'http://example.com/foo/bar' but it cannot be used for a request to
+ 'http://example.com/baz'
+ """
+ self.auth_header = auth_header
+ self.scopes = scopes or []
+
+ def perform_request(self, http_client, operation, url, data=None,
+ headers=None):
+ """Sets the Authorization header to the basic auth string."""
+ if headers is None:
+ headers = {'Authorization':self.auth_header}
+ else:
+ headers['Authorization'] = self.auth_header
+ return http_client.request(operation, url, data=data, headers=headers)
+
+ def __str__(self):
+ return self.auth_header
+
+ def valid_for_scope(self, url):
+ """Tells the caller if the token authorizes access to the desired URL.
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ for scope in self.scopes:
+ if scope == atom.token_store.SCOPE_ALL:
+ return True
+ if isinstance(scope, (str, unicode)):
+ scope = atom.url.parse_url(scope)
+ if scope == url:
+ return True
+ # Check the host and the path, but ignore the port and protocol.
+ elif scope.host == url.host and not scope.path:
+ return True
+ elif scope.host == url.host and scope.path and not url.path:
+ continue
+ elif scope.host == url.host and url.path.startswith(scope.path):
+ return True
+ return False
+
+
+def PrepareConnection(service, full_uri):
+ """Opens a connection to the server based on the full URI.
+
+ This method is deprecated, instead use atom.http.HttpClient.request.
+
+ Examines the target URI and the proxy settings, which are set as
+ environment variables, to open a connection with the server. This
+ connection is used to make an HTTP request.
+
+ Args:
+ service: atom.AtomService or a subclass. It must have a server string which
+ represents the server host to which the request should be made. It may also
+ have a dictionary of additional_headers to send in the HTTP request.
+ full_uri: str Which is the target relative (lacks protocol and host) or
+ absolute URL to be opened. Example:
+ 'https://www.google.com/accounts/ClientLogin' or
+ 'base/feeds/snippets' where the server is set to www.google.com.
+
+ Returns:
+ A tuple containing the httplib.HTTPConnection and the full_uri for the
+ request.
+ """
+ deprecation('calling deprecated function PrepareConnection')
+ (server, port, ssl, partial_uri) = ProcessUrl(service, full_uri)
+ if ssl:
+ # destination is https
+ proxy = os.environ.get('https_proxy')
+ if proxy:
+ (p_server, p_port, p_ssl, p_uri) = ProcessUrl(service, proxy, True)
+ proxy_username = os.environ.get('proxy-username')
+ if not proxy_username:
+ proxy_username = os.environ.get('proxy_username')
+ proxy_password = os.environ.get('proxy-password')
+ if not proxy_password:
+ proxy_password = os.environ.get('proxy_password')
+ if proxy_username:
+ user_auth = base64.encodestring('%s:%s' % (proxy_username,
+ proxy_password))
+ proxy_authorization = ('Proxy-authorization: Basic %s\r\n' % (
+ user_auth.strip()))
+ else:
+ proxy_authorization = ''
+ proxy_connect = 'CONNECT %s:%s HTTP/1.0\r\n' % (server, port)
+ user_agent = 'User-Agent: %s\r\n' % (
+ service.additional_headers['User-Agent'])
+ proxy_pieces = (proxy_connect + proxy_authorization + user_agent
+ + '\r\n')
+
+ #now connect, very simple recv and error checking
+ p_sock = socket.socket(socket.AF_INET,socket.SOCK_STREAM)
+ p_sock.connect((p_server,p_port))
+ p_sock.sendall(proxy_pieces)
+ response = ''
+
+ # Wait for the full response.
+ while response.find("\r\n\r\n") == -1:
+ response += p_sock.recv(8192)
+
+ p_status=response.split()[1]
+ if p_status!=str(200):
+ raise atom.http.ProxyError('Error status=%s' % p_status)
+
+ # Trivial setup for ssl socket.
+ ssl = socket.ssl(p_sock, None, None)
+ fake_sock = httplib.FakeSocket(p_sock, ssl)
+
+ # Initalize httplib and replace with the proxy socket.
+ connection = httplib.HTTPConnection(server)
+ connection.sock=fake_sock
+ full_uri = partial_uri
+
+ else:
+ connection = httplib.HTTPSConnection(server, port)
+ full_uri = partial_uri
+
+ else:
+ # destination is http
+ proxy = os.environ.get('http_proxy')
+ if proxy:
+ (p_server, p_port, p_ssl, p_uri) = ProcessUrl(service.server, proxy, True)
+ proxy_username = os.environ.get('proxy-username')
+ if not proxy_username:
+ proxy_username = os.environ.get('proxy_username')
+ proxy_password = os.environ.get('proxy-password')
+ if not proxy_password:
+ proxy_password = os.environ.get('proxy_password')
+ if proxy_username:
+ UseBasicAuth(service, proxy_username, proxy_password, True)
+ connection = httplib.HTTPConnection(p_server, p_port)
+ if not full_uri.startswith("http://"):
+ if full_uri.startswith("/"):
+ full_uri = "http://%s%s" % (service.server, full_uri)
+ else:
+ full_uri = "http://%s/%s" % (service.server, full_uri)
+ else:
+ connection = httplib.HTTPConnection(server, port)
+ full_uri = partial_uri
+
+ return (connection, full_uri)
+
+
+def UseBasicAuth(service, username, password, for_proxy=False):
+ """Sets an Authenticaiton: Basic HTTP header containing plaintext.
+
+ Deprecated, use AtomService.use_basic_auth insread.
+
+ The username and password are base64 encoded and added to an HTTP header
+ which will be included in each request. Note that your username and
+ password are sent in plaintext. The auth header is added to the
+ additional_headers dictionary in the service object.
+
+ Args:
+ service: atom.AtomService or a subclass which has an
+ additional_headers dict as a member.
+ username: str
+ password: str
+ """
+ deprecation('calling deprecated function UseBasicAuth')
+ base_64_string = base64.encodestring('%s:%s' % (username, password))
+ base_64_string = base_64_string.strip()
+ if for_proxy:
+ header_name = 'Proxy-Authorization'
+ else:
+ header_name = 'Authorization'
+ service.additional_headers[header_name] = 'Basic %s' % (base_64_string,)
+
+
+def ProcessUrl(service, url, for_proxy=False):
+ """Processes a passed URL. If the URL does not begin with https?, then
+ the default value for server is used
+
+ This method is deprecated, use atom.url.parse_url instead.
+ """
+ if not isinstance(url, atom.url.Url):
+ url = atom.url.parse_url(url)
+
+ server = url.host
+ ssl = False
+ port = 80
+
+ if not server:
+ if hasattr(service, 'server'):
+ server = service.server
+ else:
+ server = service
+ if not url.protocol and hasattr(service, 'ssl'):
+ ssl = service.ssl
+ if hasattr(service, 'port'):
+ port = service.port
+ else:
+ if url.protocol == 'https':
+ ssl = True
+ elif url.protocol == 'http':
+ ssl = False
+ if url.port:
+ port = int(url.port)
+ elif port == 80 and ssl:
+ port = 443
+
+ return (server, port, ssl, url.get_request_uri())
+
+def DictionaryToParamList(url_parameters, escape_params=True):
+ """Convert a dictionary of URL arguments into a URL parameter string.
+
+ This function is deprcated, use atom.url.Url instead.
+
+ Args:
+ url_parameters: The dictionaty of key-value pairs which will be converted
+ into URL parameters. For example,
+ {'dry-run': 'true', 'foo': 'bar'}
+ will become ['dry-run=true', 'foo=bar'].
+
+ Returns:
+ A list which contains a string for each key-value pair. The strings are
+ ready to be incorporated into a URL by using '&'.join([] + parameter_list)
+ """
+ # Choose which function to use when modifying the query and parameters.
+ # Use quote_plus when escape_params is true.
+ transform_op = [str, urllib.quote_plus][bool(escape_params)]
+ # Create a list of tuples containing the escaped version of the
+ # parameter-value pairs.
+ parameter_tuples = [(transform_op(param), transform_op(value))
+ for param, value in (url_parameters or {}).items()]
+ # Turn parameter-value tuples into a list of strings in the form
+ # 'PARAMETER=VALUE'.
+ return ['='.join(x) for x in parameter_tuples]
+
+
+def BuildUri(uri, url_params=None, escape_params=True):
+ """Converts a uri string and a collection of parameters into a URI.
+
+ This function is deprcated, use atom.url.Url instead.
+
+ Args:
+ uri: string
+ url_params: dict (optional)
+ escape_params: boolean (optional)
+ uri: string The start of the desired URI. This string can alrady contain
+ URL parameters. Examples: '/base/feeds/snippets',
+ '/base/feeds/snippets?bq=digital+camera'
+ url_parameters: dict (optional) Additional URL parameters to be included
+ in the query. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ string The URI consisting of the escaped URL parameters appended to the
+ initial uri string.
+ """
+ # Prepare URL parameters for inclusion into the GET request.
+ parameter_list = DictionaryToParamList(url_params, escape_params)
+
+ # Append the URL parameters to the URL.
+ if parameter_list:
+ if uri.find('?') != -1:
+ # If there are already URL parameters in the uri string, add the
+ # parameters after a new & character.
+ full_uri = '&'.join([uri] + parameter_list)
+ else:
+ # The uri string did not have any URL parameters (no ? character)
+ # so put a ? between the uri and URL parameters.
+ full_uri = '%s%s' % (uri, '?%s' % ('&'.join([] + parameter_list)))
+ else:
+ full_uri = uri
+
+ return full_uri
+
+
+def HttpRequest(service, operation, data, uri, extra_headers=None,
+ url_params=None, escape_params=True, content_type='application/atom+xml'):
+ """Performs an HTTP call to the server, supports GET, POST, PUT, and DELETE.
+
+ This method is deprecated, use atom.http.HttpClient.request instead.
+
+ Usage example, perform and HTTP GET on http://www.google.com/:
+ import atom.service
+ client = atom.service.AtomService()
+ http_response = client.Get('http://www.google.com/')
+ or you could set the client.server to 'www.google.com' and use the
+ following:
+ client.server = 'www.google.com'
+ http_response = client.Get('/')
+
+ Args:
+ service: atom.AtomService object which contains some of the parameters
+ needed to make the request. The following members are used to
+ construct the HTTP call: server (str), additional_headers (dict),
+ port (int), and ssl (bool).
+ operation: str The HTTP operation to be performed. This is usually one of
+ 'GET', 'POST', 'PUT', or 'DELETE'
+ data: ElementTree, filestream, list of parts, or other object which can be
+ converted to a string.
+ Should be set to None when performing a GET or PUT.
+ If data is a file-like object which can be read, this method will read
+ a chunk of 100K bytes at a time and send them.
+ If the data is a list of parts to be sent, each part will be evaluated
+ and sent.
+ uri: The beginning of the URL to which the request should be sent.
+ Examples: '/', '/base/feeds/snippets',
+ '/m8/feeds/contacts/default/base'
+ extra_headers: dict of strings. HTTP headers which should be sent
+ in the request. These headers are in addition to those stored in
+ service.additional_headers.
+ url_params: dict of strings. Key value pairs to be added to the URL as
+ URL parameters. For example {'foo':'bar', 'test':'param'} will
+ become ?foo=bar&test=param.
+ escape_params: bool default True. If true, the keys and values in
+ url_params will be URL escaped when the form is constructed
+ (Special characters converted to %XX form.)
+ content_type: str The MIME type for the data being sent. Defaults to
+ 'application/atom+xml', this is only used if data is set.
+ """
+ deprecation('call to deprecated function HttpRequest')
+ full_uri = BuildUri(uri, url_params, escape_params)
+ (connection, full_uri) = PrepareConnection(service, full_uri)
+
+ if extra_headers is None:
+ extra_headers = {}
+
+ # Turn on debug mode if the debug member is set.
+ if service.debug:
+ connection.debuglevel = 1
+
+ connection.putrequest(operation, full_uri)
+
+ # If the list of headers does not include a Content-Length, attempt to
+ # calculate it based on the data object.
+ if (data and not service.additional_headers.has_key('Content-Length') and
+ not extra_headers.has_key('Content-Length')):
+ content_length = CalculateDataLength(data)
+ if content_length:
+ extra_headers['Content-Length'] = str(content_length)
+
+ if content_type:
+ extra_headers['Content-Type'] = content_type
+
+ # Send the HTTP headers.
+ if isinstance(service.additional_headers, dict):
+ for header in service.additional_headers:
+ connection.putheader(header, service.additional_headers[header])
+ if isinstance(extra_headers, dict):
+ for header in extra_headers:
+ connection.putheader(header, extra_headers[header])
+ connection.endheaders()
+
+ # If there is data, send it in the request.
+ if data:
+ if isinstance(data, list):
+ for data_part in data:
+ __SendDataPart(data_part, connection)
+ else:
+ __SendDataPart(data, connection)
+
+ # Return the HTTP Response from the server.
+ return connection.getresponse()
+
+
+def __SendDataPart(data, connection):
+ """This method is deprecated, use atom.http._send_data_part"""
+ deprecated('call to deprecated function __SendDataPart')
+ if isinstance(data, str):
+ #TODO add handling for unicode.
+ connection.send(data)
+ return
+ elif ElementTree.iselement(data):
+ connection.send(ElementTree.tostring(data))
+ return
+ # Check to see if data is a file-like object that has a read method.
+ elif hasattr(data, 'read'):
+ # Read the file and send it a chunk at a time.
+ while 1:
+ binarydata = data.read(100000)
+ if binarydata == '': break
+ connection.send(binarydata)
+ return
+ else:
+ # The data object was not a file.
+ # Try to convert to a string and send the data.
+ connection.send(str(data))
+ return
+
+
+def CalculateDataLength(data):
+ """Attempts to determine the length of the data to send.
+
+ This method will respond with a length only if the data is a string or
+ and ElementTree element.
+
+ Args:
+ data: object If this is not a string or ElementTree element this funtion
+ will return None.
+ """
+ if isinstance(data, str):
+ return len(data)
+ elif isinstance(data, list):
+ return None
+ elif ElementTree.iselement(data):
+ return len(ElementTree.tostring(data))
+ elif hasattr(data, 'read'):
+ # If this is a file-like object, don't try to guess the length.
+ return None
+ else:
+ return len(str(data))
+
+
+def deprecation(message):
+ warnings.warn(message, DeprecationWarning, stacklevel=2)
diff --git a/src/atom/token_store.py b/src/atom/token_store.py
new file mode 100644
index 0000000..d618965
--- /dev/null
+++ b/src/atom/token_store.py
@@ -0,0 +1,117 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""This module provides a TokenStore class which is designed to manage
+auth tokens required for different services.
+
+Each token is valid for a set of scopes which is the start of a URL. An HTTP
+client will use a token store to find a valid Authorization header to send
+in requests to the specified URL. If the HTTP client determines that a token
+has expired or been revoked, it can remove the token from the store so that
+it will not be used in future requests.
+"""
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import atom.http_interface
+import atom.url
+
+
+SCOPE_ALL = 'http'
+
+
+class TokenStore(object):
+ """Manages Authorization tokens which will be sent in HTTP headers."""
+ def __init__(self, scoped_tokens=None):
+ self._tokens = scoped_tokens or {}
+
+ def add_token(self, token):
+ """Adds a new token to the store (replaces tokens with the same scope).
+
+ Args:
+ token: A subclass of http_interface.GenericToken. The token object is
+ responsible for adding the Authorization header to the HTTP request.
+ The scopes defined in the token are used to determine if the token
+ is valid for a requested scope when find_token is called.
+
+ Returns:
+ True if the token was added, False if the token was not added becase
+ no scopes were provided.
+ """
+ if not hasattr(token, 'scopes') or not token.scopes:
+ return False
+
+ for scope in token.scopes:
+ self._tokens[str(scope)] = token
+ return True
+
+ def find_token(self, url):
+ """Selects an Authorization header token which can be used for the URL.
+
+ Args:
+ url: str or atom.url.Url or a list containing the same.
+ The URL which is going to be requested. All
+ tokens are examined to see if any scopes begin match the beginning
+ of the URL. The first match found is returned.
+
+ Returns:
+ The token object which should execute the HTTP request. If there was
+ no token for the url (the url did not begin with any of the token
+ scopes available), then the atom.http_interface.GenericToken will be
+ returned because the GenericToken calls through to the http client
+ without adding an Authorization header.
+ """
+ if url is None:
+ return None
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ if url in self._tokens:
+ token = self._tokens[url]
+ if token.valid_for_scope(url):
+ return token
+ else:
+ del self._tokens[url]
+ for scope, token in self._tokens.iteritems():
+ if token.valid_for_scope(url):
+ return token
+ return atom.http_interface.GenericToken()
+
+ def remove_token(self, token):
+ """Removes the token from the token_store.
+
+ This method is used when a token is determined to be invalid. If the
+ token was found by find_token, but resulted in a 401 or 403 error stating
+ that the token was invlid, then the token should be removed to prevent
+ future use.
+
+ Returns:
+ True if a token was found and then removed from the token
+ store. False if the token was not in the TokenStore.
+ """
+ token_found = False
+ scopes_to_delete = []
+ for scope, stored_token in self._tokens.iteritems():
+ if stored_token == token:
+ scopes_to_delete.append(scope)
+ token_found = True
+ for scope in scopes_to_delete:
+ del self._tokens[scope]
+ return token_found
+
+ def remove_all_tokens(self):
+ self._tokens = {}
diff --git a/src/atom/url.py b/src/atom/url.py
new file mode 100644
index 0000000..0effa10
--- /dev/null
+++ b/src/atom/url.py
@@ -0,0 +1,139 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import urlparse
+import urllib
+
+
+DEFAULT_PROTOCOL = 'http'
+DEFAULT_PORT = 80
+
+
+def parse_url(url_string):
+ """Creates a Url object which corresponds to the URL string.
+
+ This method can accept partial URLs, but it will leave missing
+ members of the Url unset.
+ """
+ parts = urlparse.urlparse(url_string)
+ url = Url()
+ if parts[0]:
+ url.protocol = parts[0]
+ if parts[1]:
+ host_parts = parts[1].split(':')
+ if host_parts[0]:
+ url.host = host_parts[0]
+ if len(host_parts) > 1:
+ url.port = host_parts[1]
+ if parts[2]:
+ url.path = parts[2]
+ if parts[4]:
+ param_pairs = parts[4].split('&')
+ for pair in param_pairs:
+ pair_parts = pair.split('=')
+ if len(pair_parts) > 1:
+ url.params[urllib.unquote_plus(pair_parts[0])] = (
+ urllib.unquote_plus(pair_parts[1]))
+ elif len(pair_parts) == 1:
+ url.params[urllib.unquote_plus(pair_parts[0])] = None
+ return url
+
+class Url(object):
+ """Represents a URL and implements comparison logic.
+
+ URL strings which are not identical can still be equivalent, so this object
+ provides a better interface for comparing and manipulating URLs than
+ strings. URL parameters are represented as a dictionary of strings, and
+ defaults are used for the protocol (http) and port (80) if not provided.
+ """
+ def __init__(self, protocol=None, host=None, port=None, path=None,
+ params=None):
+ self.protocol = protocol
+ self.host = host
+ self.port = port
+ self.path = path
+ self.params = params or {}
+
+ def to_string(self):
+ url_parts = ['', '', '', '', '', '']
+ if self.protocol:
+ url_parts[0] = self.protocol
+ if self.host:
+ if self.port:
+ url_parts[1] = ':'.join((self.host, str(self.port)))
+ else:
+ url_parts[1] = self.host
+ if self.path:
+ url_parts[2] = self.path
+ if self.params:
+ url_parts[4] = self.get_param_string()
+ return urlparse.urlunparse(url_parts)
+
+ def get_param_string(self):
+ param_pairs = []
+ for key, value in self.params.iteritems():
+ param_pairs.append('='.join((urllib.quote_plus(key),
+ urllib.quote_plus(str(value)))))
+ return '&'.join(param_pairs)
+
+ def get_request_uri(self):
+ """Returns the path with the parameters escaped and appended."""
+ param_string = self.get_param_string()
+ if param_string:
+ return '?'.join([self.path, param_string])
+ else:
+ return self.path
+
+ def __cmp__(self, other):
+ if not isinstance(other, Url):
+ return cmp(self.to_string(), str(other))
+ difference = 0
+ # Compare the protocol
+ if self.protocol and other.protocol:
+ difference = cmp(self.protocol, other.protocol)
+ elif self.protocol and not other.protocol:
+ difference = cmp(self.protocol, DEFAULT_PROTOCOL)
+ elif not self.protocol and other.protocol:
+ difference = cmp(DEFAULT_PROTOCOL, other.protocol)
+ if difference != 0:
+ return difference
+ # Compare the host
+ difference = cmp(self.host, other.host)
+ if difference != 0:
+ return difference
+ # Compare the port
+ if self.port and other.port:
+ difference = cmp(self.port, other.port)
+ elif self.port and not other.port:
+ difference = cmp(self.port, DEFAULT_PORT)
+ elif not self.port and other.port:
+ difference = cmp(DEFAULT_PORT, other.port)
+ if difference != 0:
+ return difference
+ # Compare the path
+ difference = cmp(self.path, other.path)
+ if difference != 0:
+ return difference
+ # Compare the parameters
+ return cmp(self.params, other.params)
+
+ def __str__(self):
+ return self.to_string()
+
diff --git a/src/gdata/Crypto/Cipher/AES.pyd b/src/gdata/Crypto/Cipher/AES.pyd
new file mode 100755
index 0000000..707b36f
--- /dev/null
+++ b/src/gdata/Crypto/Cipher/AES.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Cipher/ARC2.pyd b/src/gdata/Crypto/Cipher/ARC2.pyd
new file mode 100755
index 0000000..a9dfbf6
--- /dev/null
+++ b/src/gdata/Crypto/Cipher/ARC2.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Cipher/ARC4.pyd b/src/gdata/Crypto/Cipher/ARC4.pyd
new file mode 100755
index 0000000..4cd51f2
--- /dev/null
+++ b/src/gdata/Crypto/Cipher/ARC4.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Cipher/Blowfish.pyd b/src/gdata/Crypto/Cipher/Blowfish.pyd
new file mode 100755
index 0000000..cbdc881
--- /dev/null
+++ b/src/gdata/Crypto/Cipher/Blowfish.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Cipher/CAST.pyd b/src/gdata/Crypto/Cipher/CAST.pyd
new file mode 100755
index 0000000..c3e1fa6
--- /dev/null
+++ b/src/gdata/Crypto/Cipher/CAST.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Cipher/DES.pyd b/src/gdata/Crypto/Cipher/DES.pyd
new file mode 100755
index 0000000..b9967dc
--- /dev/null
+++ b/src/gdata/Crypto/Cipher/DES.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Cipher/DES3.pyd b/src/gdata/Crypto/Cipher/DES3.pyd
new file mode 100755
index 0000000..6768126
--- /dev/null
+++ b/src/gdata/Crypto/Cipher/DES3.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Cipher/IDEA.pyd b/src/gdata/Crypto/Cipher/IDEA.pyd
new file mode 100755
index 0000000..860c121
--- /dev/null
+++ b/src/gdata/Crypto/Cipher/IDEA.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Cipher/RC5.pyd b/src/gdata/Crypto/Cipher/RC5.pyd
new file mode 100755
index 0000000..ef39b3e
--- /dev/null
+++ b/src/gdata/Crypto/Cipher/RC5.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Cipher/XOR.pyd b/src/gdata/Crypto/Cipher/XOR.pyd
new file mode 100755
index 0000000..fb53d53
--- /dev/null
+++ b/src/gdata/Crypto/Cipher/XOR.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Cipher/__init__.py b/src/gdata/Crypto/Cipher/__init__.py
new file mode 100755
index 0000000..3b2f855
--- /dev/null
+++ b/src/gdata/Crypto/Cipher/__init__.py
@@ -0,0 +1,33 @@
+"""Secret-key encryption algorithms.
+
+Secret-key encryption algorithms transform plaintext in some way that
+is dependent on a key, producing ciphertext. This transformation can
+easily be reversed, if (and, hopefully, only if) one knows the key.
+
+The encryption modules here all support the interface described in PEP
+272, "API for Block Encryption Algorithms".
+
+If you don't know which algorithm to choose, use AES because it's
+standard and has undergone a fair bit of examination.
+
+Crypto.Cipher.AES Advanced Encryption Standard
+Crypto.Cipher.ARC2 Alleged RC2
+Crypto.Cipher.ARC4 Alleged RC4
+Crypto.Cipher.Blowfish
+Crypto.Cipher.CAST
+Crypto.Cipher.DES The Data Encryption Standard. Very commonly used
+ in the past, but today its 56-bit keys are too small.
+Crypto.Cipher.DES3 Triple DES.
+Crypto.Cipher.IDEA
+Crypto.Cipher.RC5
+Crypto.Cipher.XOR The simple XOR cipher.
+"""
+
+__all__ = ['AES', 'ARC2', 'ARC4',
+ 'Blowfish', 'CAST', 'DES', 'DES3', 'IDEA', 'RC5',
+ 'XOR'
+ ]
+
+__revision__ = "$Id: __init__.py,v 1.7 2003/02/28 15:28:35 akuchling Exp $"
+
+
diff --git a/src/gdata/Crypto/Hash/HMAC.py b/src/gdata/Crypto/Hash/HMAC.py
new file mode 100755
index 0000000..eeb5782
--- /dev/null
+++ b/src/gdata/Crypto/Hash/HMAC.py
@@ -0,0 +1,108 @@
+"""HMAC (Keyed-Hashing for Message Authentication) Python module.
+
+Implements the HMAC algorithm as described by RFC 2104.
+
+This is just a copy of the Python 2.2 HMAC module, modified to work when
+used on versions of Python before 2.2.
+"""
+
+__revision__ = "$Id: HMAC.py,v 1.5 2002/07/25 17:19:02 z3p Exp $"
+
+import string
+
+def _strxor(s1, s2):
+ """Utility method. XOR the two strings s1 and s2 (must have same length).
+ """
+ return "".join(map(lambda x, y: chr(ord(x) ^ ord(y)), s1, s2))
+
+# The size of the digests returned by HMAC depends on the underlying
+# hashing module used.
+digest_size = None
+
+class HMAC:
+ """RFC2104 HMAC class.
+
+ This supports the API for Cryptographic Hash Functions (PEP 247).
+ """
+
+ def __init__(self, key, msg = None, digestmod = None):
+ """Create a new HMAC object.
+
+ key: key for the keyed hash object.
+ msg: Initial input for the hash, if provided.
+ digestmod: A module supporting PEP 247. Defaults to the md5 module.
+ """
+ if digestmod == None:
+ import md5
+ digestmod = md5
+
+ self.digestmod = digestmod
+ self.outer = digestmod.new()
+ self.inner = digestmod.new()
+ try:
+ self.digest_size = digestmod.digest_size
+ except AttributeError:
+ self.digest_size = len(self.outer.digest())
+
+ blocksize = 64
+ ipad = "\x36" * blocksize
+ opad = "\x5C" * blocksize
+
+ if len(key) > blocksize:
+ key = digestmod.new(key).digest()
+
+ key = key + chr(0) * (blocksize - len(key))
+ self.outer.update(_strxor(key, opad))
+ self.inner.update(_strxor(key, ipad))
+ if (msg):
+ self.update(msg)
+
+## def clear(self):
+## raise NotImplementedError, "clear() method not available in HMAC."
+
+ def update(self, msg):
+ """Update this hashing object with the string msg.
+ """
+ self.inner.update(msg)
+
+ def copy(self):
+ """Return a separate copy of this hashing object.
+
+ An update to this copy won't affect the original object.
+ """
+ other = HMAC("")
+ other.digestmod = self.digestmod
+ other.inner = self.inner.copy()
+ other.outer = self.outer.copy()
+ return other
+
+ def digest(self):
+ """Return the hash value of this hashing object.
+
+ This returns a string containing 8-bit data. The object is
+ not altered in any way by this function; you can continue
+ updating the object after calling this function.
+ """
+ h = self.outer.copy()
+ h.update(self.inner.digest())
+ return h.digest()
+
+ def hexdigest(self):
+ """Like digest(), but returns a string of hexadecimal digits instead.
+ """
+ return "".join([string.zfill(hex(ord(x))[2:], 2)
+ for x in tuple(self.digest())])
+
+def new(key, msg = None, digestmod = None):
+ """Create a new hashing object and return it.
+
+ key: The starting key for the hash.
+ msg: if available, will immediately be hashed into the object's starting
+ state.
+
+ You can now feed arbitrary strings into the object using its update()
+ method, and can ask for the hash value at any time by calling its digest()
+ method.
+ """
+ return HMAC(key, msg, digestmod)
+
diff --git a/src/gdata/Crypto/Hash/MD2.pyd b/src/gdata/Crypto/Hash/MD2.pyd
new file mode 100755
index 0000000..d117062
--- /dev/null
+++ b/src/gdata/Crypto/Hash/MD2.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Hash/MD4.pyd b/src/gdata/Crypto/Hash/MD4.pyd
new file mode 100755
index 0000000..4ba243e
--- /dev/null
+++ b/src/gdata/Crypto/Hash/MD4.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Hash/MD5.py b/src/gdata/Crypto/Hash/MD5.py
new file mode 100755
index 0000000..b0eba39
--- /dev/null
+++ b/src/gdata/Crypto/Hash/MD5.py
@@ -0,0 +1,13 @@
+
+# Just use the MD5 module from the Python standard library
+
+__revision__ = "$Id: MD5.py,v 1.4 2002/07/11 14:31:19 akuchling Exp $"
+
+from md5 import *
+
+import md5
+if hasattr(md5, 'digestsize'):
+ digest_size = digestsize
+ del digestsize
+del md5
+
diff --git a/src/gdata/Crypto/Hash/RIPEMD.pyd b/src/gdata/Crypto/Hash/RIPEMD.pyd
new file mode 100755
index 0000000..a418e75
--- /dev/null
+++ b/src/gdata/Crypto/Hash/RIPEMD.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Hash/SHA.py b/src/gdata/Crypto/Hash/SHA.py
new file mode 100755
index 0000000..ea3c6a3
--- /dev/null
+++ b/src/gdata/Crypto/Hash/SHA.py
@@ -0,0 +1,11 @@
+
+# Just use the SHA module from the Python standard library
+
+__revision__ = "$Id: SHA.py,v 1.4 2002/07/11 14:31:19 akuchling Exp $"
+
+from sha import *
+import sha
+if hasattr(sha, 'digestsize'):
+ digest_size = digestsize
+ del digestsize
+del sha
diff --git a/src/gdata/Crypto/Hash/SHA256.pyd b/src/gdata/Crypto/Hash/SHA256.pyd
new file mode 100755
index 0000000..865a16c
--- /dev/null
+++ b/src/gdata/Crypto/Hash/SHA256.pyd
Binary files differ
diff --git a/src/gdata/Crypto/Hash/__init__.py b/src/gdata/Crypto/Hash/__init__.py
new file mode 100755
index 0000000..920fe74
--- /dev/null
+++ b/src/gdata/Crypto/Hash/__init__.py
@@ -0,0 +1,24 @@
+"""Hashing algorithms
+
+Hash functions take arbitrary strings as input, and produce an output
+of fixed size that is dependent on the input; it should never be
+possible to derive the input data given only the hash function's
+output. Hash functions can be used simply as a checksum, or, in
+association with a public-key algorithm, can be used to implement
+digital signatures.
+
+The hashing modules here all support the interface described in PEP
+247, "API for Cryptographic Hash Functions".
+
+Submodules:
+Crypto.Hash.HMAC RFC 2104: Keyed-Hashing for Message Authentication
+Crypto.Hash.MD2
+Crypto.Hash.MD4
+Crypto.Hash.MD5
+Crypto.Hash.RIPEMD
+Crypto.Hash.SHA
+"""
+
+__all__ = ['HMAC', 'MD2', 'MD4', 'MD5', 'RIPEMD', 'SHA', 'SHA256']
+__revision__ = "$Id: __init__.py,v 1.6 2003/12/19 14:24:25 akuchling Exp $"
+
diff --git a/src/gdata/Crypto/Protocol/AllOrNothing.py b/src/gdata/Crypto/Protocol/AllOrNothing.py
new file mode 100755
index 0000000..6f3505d
--- /dev/null
+++ b/src/gdata/Crypto/Protocol/AllOrNothing.py
@@ -0,0 +1,295 @@
+"""This file implements all-or-nothing package transformations.
+
+An all-or-nothing package transformation is one in which some text is
+transformed into message blocks, such that all blocks must be obtained before
+the reverse transformation can be applied. Thus, if any blocks are corrupted
+or lost, the original message cannot be reproduced.
+
+An all-or-nothing package transformation is not encryption, although a block
+cipher algorithm is used. The encryption key is randomly generated and is
+extractable from the message blocks.
+
+This class implements the All-Or-Nothing package transformation algorithm
+described in:
+
+Ronald L. Rivest. "All-Or-Nothing Encryption and The Package Transform"
+http://theory.lcs.mit.edu/~rivest/fusion.pdf
+
+"""
+
+__revision__ = "$Id: AllOrNothing.py,v 1.8 2003/02/28 15:23:20 akuchling Exp $"
+
+import operator
+import string
+from Crypto.Util.number import bytes_to_long, long_to_bytes
+
+
+
+class AllOrNothing:
+ """Class implementing the All-or-Nothing package transform.
+
+ Methods for subclassing:
+
+ _inventkey(key_size):
+ Returns a randomly generated key. Subclasses can use this to
+ implement better random key generating algorithms. The default
+ algorithm is probably not very cryptographically secure.
+
+ """
+
+ def __init__(self, ciphermodule, mode=None, IV=None):
+ """AllOrNothing(ciphermodule, mode=None, IV=None)
+
+ ciphermodule is a module implementing the cipher algorithm to
+ use. It must provide the PEP272 interface.
+
+ Note that the encryption key is randomly generated
+ automatically when needed. Optional arguments mode and IV are
+ passed directly through to the ciphermodule.new() method; they
+ are the feedback mode and initialization vector to use. All
+ three arguments must be the same for the object used to create
+ the digest, and to undigest'ify the message blocks.
+ """
+
+ self.__ciphermodule = ciphermodule
+ self.__mode = mode
+ self.__IV = IV
+ self.__key_size = ciphermodule.key_size
+ if self.__key_size == 0:
+ self.__key_size = 16
+
+ __K0digit = chr(0x69)
+
+ def digest(self, text):
+ """digest(text:string) : [string]
+
+ Perform the All-or-Nothing package transform on the given
+ string. Output is a list of message blocks describing the
+ transformed text, where each block is a string of bit length equal
+ to the ciphermodule's block_size.
+ """
+
+ # generate a random session key and K0, the key used to encrypt the
+ # hash blocks. Rivest calls this a fixed, publically-known encryption
+ # key, but says nothing about the security implications of this key or
+ # how to choose it.
+ key = self._inventkey(self.__key_size)
+ K0 = self.__K0digit * self.__key_size
+
+ # we need two cipher objects here, one that is used to encrypt the
+ # message blocks and one that is used to encrypt the hashes. The
+ # former uses the randomly generated key, while the latter uses the
+ # well-known key.
+ mcipher = self.__newcipher(key)
+ hcipher = self.__newcipher(K0)
+
+ # Pad the text so that its length is a multiple of the cipher's
+ # block_size. Pad with trailing spaces, which will be eliminated in
+ # the undigest() step.
+ block_size = self.__ciphermodule.block_size
+ padbytes = block_size - (len(text) % block_size)
+ text = text + ' ' * padbytes
+
+ # Run through the algorithm:
+ # s: number of message blocks (size of text / block_size)
+ # input sequence: m1, m2, ... ms
+ # random key K' (`key' in the code)
+ # Compute output sequence: m'1, m'2, ... m's' for s' = s + 1
+ # Let m'i = mi ^ E(K', i) for i = 1, 2, 3, ..., s
+ # Let m's' = K' ^ h1 ^ h2 ^ ... hs
+ # where hi = E(K0, m'i ^ i) for i = 1, 2, ... s
+ #
+ # The one complication I add is that the last message block is hard
+ # coded to the number of padbytes added, so that these can be stripped
+ # during the undigest() step
+ s = len(text) / block_size
+ blocks = []
+ hashes = []
+ for i in range(1, s+1):
+ start = (i-1) * block_size
+ end = start + block_size
+ mi = text[start:end]
+ assert len(mi) == block_size
+ cipherblock = mcipher.encrypt(long_to_bytes(i, block_size))
+ mticki = bytes_to_long(mi) ^ bytes_to_long(cipherblock)
+ blocks.append(mticki)
+ # calculate the hash block for this block
+ hi = hcipher.encrypt(long_to_bytes(mticki ^ i, block_size))
+ hashes.append(bytes_to_long(hi))
+
+ # Add the padbytes length as a message block
+ i = i + 1
+ cipherblock = mcipher.encrypt(long_to_bytes(i, block_size))
+ mticki = padbytes ^ bytes_to_long(cipherblock)
+ blocks.append(mticki)
+
+ # calculate this block's hash
+ hi = hcipher.encrypt(long_to_bytes(mticki ^ i, block_size))
+ hashes.append(bytes_to_long(hi))
+
+ # Now calculate the last message block of the sequence 1..s'. This
+ # will contain the random session key XOR'd with all the hash blocks,
+ # so that for undigest(), once all the hash blocks are calculated, the
+ # session key can be trivially extracted. Calculating all the hash
+ # blocks requires that all the message blocks be received, thus the
+ # All-or-Nothing algorithm succeeds.
+ mtick_stick = bytes_to_long(key) ^ reduce(operator.xor, hashes)
+ blocks.append(mtick_stick)
+
+ # we convert the blocks to strings since in Python, byte sequences are
+ # always represented as strings. This is more consistent with the
+ # model that encryption and hash algorithms always operate on strings.
+ return map(long_to_bytes, blocks)
+
+
+ def undigest(self, blocks):
+ """undigest(blocks : [string]) : string
+
+ Perform the reverse package transformation on a list of message
+ blocks. Note that the ciphermodule used for both transformations
+ must be the same. blocks is a list of strings of bit length
+ equal to the ciphermodule's block_size.
+ """
+
+ # better have at least 2 blocks, for the padbytes package and the hash
+ # block accumulator
+ if len(blocks) < 2:
+ raise ValueError, "List must be at least length 2."
+
+ # blocks is a list of strings. We need to deal with them as long
+ # integers
+ blocks = map(bytes_to_long, blocks)
+
+ # Calculate the well-known key, to which the hash blocks are
+ # encrypted, and create the hash cipher.
+ K0 = self.__K0digit * self.__key_size
+ hcipher = self.__newcipher(K0)
+
+ # Since we have all the blocks (or this method would have been called
+ # prematurely), we can calcualte all the hash blocks.
+ hashes = []
+ for i in range(1, len(blocks)):
+ mticki = blocks[i-1] ^ i
+ hi = hcipher.encrypt(long_to_bytes(mticki))
+ hashes.append(bytes_to_long(hi))
+
+ # now we can calculate K' (key). remember the last block contains
+ # m's' which we don't include here
+ key = blocks[-1] ^ reduce(operator.xor, hashes)
+
+ # and now we can create the cipher object
+ mcipher = self.__newcipher(long_to_bytes(key))
+ block_size = self.__ciphermodule.block_size
+
+ # And we can now decode the original message blocks
+ parts = []
+ for i in range(1, len(blocks)):
+ cipherblock = mcipher.encrypt(long_to_bytes(i, block_size))
+ mi = blocks[i-1] ^ bytes_to_long(cipherblock)
+ parts.append(mi)
+
+ # The last message block contains the number of pad bytes appended to
+ # the original text string, such that its length was an even multiple
+ # of the cipher's block_size. This number should be small enough that
+ # the conversion from long integer to integer should never overflow
+ padbytes = int(parts[-1])
+ text = string.join(map(long_to_bytes, parts[:-1]), '')
+ return text[:-padbytes]
+
+ def _inventkey(self, key_size):
+ # TBD: Not a very secure algorithm. Eventually, I'd like to use JHy's
+ # kernelrand module
+ import time
+ from Crypto.Util import randpool
+ # TBD: key_size * 2 to work around possible bug in RandomPool?
+ pool = randpool.RandomPool(key_size * 2)
+ while key_size > pool.entropy:
+ pool.add_event()
+
+ # we now have enough entropy in the pool to get a key_size'd key
+ return pool.get_bytes(key_size)
+
+ def __newcipher(self, key):
+ if self.__mode is None and self.__IV is None:
+ return self.__ciphermodule.new(key)
+ elif self.__IV is None:
+ return self.__ciphermodule.new(key, self.__mode)
+ else:
+ return self.__ciphermodule.new(key, self.__mode, self.__IV)
+
+
+
+if __name__ == '__main__':
+ import sys
+ import getopt
+ import base64
+
+ usagemsg = '''\
+Test module usage: %(program)s [-c cipher] [-l] [-h]
+
+Where:
+ --cipher module
+ -c module
+ Cipher module to use. Default: %(ciphermodule)s
+
+ --aslong
+ -l
+ Print the encoded message blocks as long integers instead of base64
+ encoded strings
+
+ --help
+ -h
+ Print this help message
+'''
+
+ ciphermodule = 'AES'
+ aslong = 0
+
+ def usage(code, msg=None):
+ if msg:
+ print msg
+ print usagemsg % {'program': sys.argv[0],
+ 'ciphermodule': ciphermodule}
+ sys.exit(code)
+
+ try:
+ opts, args = getopt.getopt(sys.argv[1:],
+ 'c:l', ['cipher=', 'aslong'])
+ except getopt.error, msg:
+ usage(1, msg)
+
+ if args:
+ usage(1, 'Too many arguments')
+
+ for opt, arg in opts:
+ if opt in ('-h', '--help'):
+ usage(0)
+ elif opt in ('-c', '--cipher'):
+ ciphermodule = arg
+ elif opt in ('-l', '--aslong'):
+ aslong = 1
+
+ # ugly hack to force __import__ to give us the end-path module
+ module = __import__('Crypto.Cipher.'+ciphermodule, None, None, ['new'])
+
+ a = AllOrNothing(module)
+ print 'Original text:\n=========='
+ print __doc__
+ print '=========='
+ msgblocks = a.digest(__doc__)
+ print 'message blocks:'
+ for i, blk in map(None, range(len(msgblocks)), msgblocks):
+ # base64 adds a trailing newline
+ print ' %3d' % i,
+ if aslong:
+ print bytes_to_long(blk)
+ else:
+ print base64.encodestring(blk)[:-1]
+ #
+ # get a new undigest-only object so there's no leakage
+ b = AllOrNothing(module)
+ text = b.undigest(msgblocks)
+ if text == __doc__:
+ print 'They match!'
+ else:
+ print 'They differ!'
diff --git a/src/gdata/Crypto/Protocol/Chaffing.py b/src/gdata/Crypto/Protocol/Chaffing.py
new file mode 100755
index 0000000..fdfb82d
--- /dev/null
+++ b/src/gdata/Crypto/Protocol/Chaffing.py
@@ -0,0 +1,229 @@
+"""This file implements the chaffing algorithm.
+
+Winnowing and chaffing is a technique for enhancing privacy without requiring
+strong encryption. In short, the technique takes a set of authenticated
+message blocks (the wheat) and adds a number of chaff blocks which have
+randomly chosen data and MAC fields. This means that to an adversary, the
+chaff blocks look as valid as the wheat blocks, and so the authentication
+would have to be performed on every block. By tailoring the number of chaff
+blocks added to the message, the sender can make breaking the message
+computationally infeasible. There are many other interesting properties of
+the winnow/chaff technique.
+
+For example, say Alice is sending a message to Bob. She packetizes the
+message and performs an all-or-nothing transformation on the packets. Then
+she authenticates each packet with a message authentication code (MAC). The
+MAC is a hash of the data packet, and there is a secret key which she must
+share with Bob (key distribution is an exercise left to the reader). She then
+adds a serial number to each packet, and sends the packets to Bob.
+
+Bob receives the packets, and using the shared secret authentication key,
+authenticates the MACs for each packet. Those packets that have bad MACs are
+simply discarded. The remainder are sorted by serial number, and passed
+through the reverse all-or-nothing transform. The transform means that an
+eavesdropper (say Eve) must acquire all the packets before any of the data can
+be read. If even one packet is missing, the data is useless.
+
+There's one twist: by adding chaff packets, Alice and Bob can make Eve's job
+much harder, since Eve now has to break the shared secret key, or try every
+combination of wheat and chaff packet to read any of the message. The cool
+thing is that Bob doesn't need to add any additional code; the chaff packets
+are already filtered out because their MACs don't match (in all likelihood --
+since the data and MACs for the chaff packets are randomly chosen it is
+possible, but very unlikely that a chaff MAC will match the chaff data). And
+Alice need not even be the party adding the chaff! She could be completely
+unaware that a third party, say Charles, is adding chaff packets to her
+messages as they are transmitted.
+
+For more information on winnowing and chaffing see this paper:
+
+Ronald L. Rivest, "Chaffing and Winnowing: Confidentiality without Encryption"
+http://theory.lcs.mit.edu/~rivest/chaffing.txt
+
+"""
+
+__revision__ = "$Id: Chaffing.py,v 1.7 2003/02/28 15:23:21 akuchling Exp $"
+
+from Crypto.Util.number import bytes_to_long
+
+class Chaff:
+ """Class implementing the chaff adding algorithm.
+
+ Methods for subclasses:
+
+ _randnum(size):
+ Returns a randomly generated number with a byte-length equal
+ to size. Subclasses can use this to implement better random
+ data and MAC generating algorithms. The default algorithm is
+ probably not very cryptographically secure. It is most
+ important that the chaff data does not contain any patterns
+ that can be used to discern it from wheat data without running
+ the MAC.
+
+ """
+
+ def __init__(self, factor=1.0, blocksper=1):
+ """Chaff(factor:float, blocksper:int)
+
+ factor is the number of message blocks to add chaff to,
+ expressed as a percentage between 0.0 and 1.0. blocksper is
+ the number of chaff blocks to include for each block being
+ chaffed. Thus the defaults add one chaff block to every
+ message block. By changing the defaults, you can adjust how
+ computationally difficult it could be for an adversary to
+ brute-force crack the message. The difficulty is expressed
+ as:
+
+ pow(blocksper, int(factor * number-of-blocks))
+
+ For ease of implementation, when factor < 1.0, only the first
+ int(factor*number-of-blocks) message blocks are chaffed.
+ """
+
+ if not (0.0<=factor<=1.0):
+ raise ValueError, "'factor' must be between 0.0 and 1.0"
+ if blocksper < 0:
+ raise ValueError, "'blocksper' must be zero or more"
+
+ self.__factor = factor
+ self.__blocksper = blocksper
+
+
+ def chaff(self, blocks):
+ """chaff( [(serial-number:int, data:string, MAC:string)] )
+ : [(int, string, string)]
+
+ Add chaff to message blocks. blocks is a list of 3-tuples of the
+ form (serial-number, data, MAC).
+
+ Chaff is created by choosing a random number of the same
+ byte-length as data, and another random number of the same
+ byte-length as MAC. The message block's serial number is
+ placed on the chaff block and all the packet's chaff blocks
+ are randomly interspersed with the single wheat block. This
+ method then returns a list of 3-tuples of the same form.
+ Chaffed blocks will contain multiple instances of 3-tuples
+ with the same serial number, but the only way to figure out
+ which blocks are wheat and which are chaff is to perform the
+ MAC hash and compare values.
+ """
+
+ chaffedblocks = []
+
+ # count is the number of blocks to add chaff to. blocksper is the
+ # number of chaff blocks to add per message block that is being
+ # chaffed.
+ count = len(blocks) * self.__factor
+ blocksper = range(self.__blocksper)
+ for i, wheat in map(None, range(len(blocks)), blocks):
+ # it shouldn't matter which of the n blocks we add chaff to, so for
+ # ease of implementation, we'll just add them to the first count
+ # blocks
+ if i < count:
+ serial, data, mac = wheat
+ datasize = len(data)
+ macsize = len(mac)
+ addwheat = 1
+ # add chaff to this block
+ for j in blocksper:
+ import sys
+ chaffdata = self._randnum(datasize)
+ chaffmac = self._randnum(macsize)
+ chaff = (serial, chaffdata, chaffmac)
+ # mix up the order, if the 5th bit is on then put the
+ # wheat on the list
+ if addwheat and bytes_to_long(self._randnum(16)) & 0x40:
+ chaffedblocks.append(wheat)
+ addwheat = 0
+ chaffedblocks.append(chaff)
+ if addwheat:
+ chaffedblocks.append(wheat)
+ else:
+ # just add the wheat
+ chaffedblocks.append(wheat)
+ return chaffedblocks
+
+ def _randnum(self, size):
+ # TBD: Not a very secure algorithm.
+ # TBD: size * 2 to work around possible bug in RandomPool
+ from Crypto.Util import randpool
+ import time
+ pool = randpool.RandomPool(size * 2)
+ while size > pool.entropy:
+ pass
+
+ # we now have enough entropy in the pool to get size bytes of random
+ # data... well, probably
+ return pool.get_bytes(size)
+
+
+
+if __name__ == '__main__':
+ text = """\
+We hold these truths to be self-evident, that all men are created equal, that
+they are endowed by their Creator with certain unalienable Rights, that among
+these are Life, Liberty, and the pursuit of Happiness. That to secure these
+rights, Governments are instituted among Men, deriving their just powers from
+the consent of the governed. That whenever any Form of Government becomes
+destructive of these ends, it is the Right of the People to alter or to
+abolish it, and to institute new Government, laying its foundation on such
+principles and organizing its powers in such form, as to them shall seem most
+likely to effect their Safety and Happiness.
+"""
+ print 'Original text:\n=========='
+ print text
+ print '=========='
+
+ # first transform the text into packets
+ blocks = [] ; size = 40
+ for i in range(0, len(text), size):
+ blocks.append( text[i:i+size] )
+
+ # now get MACs for all the text blocks. The key is obvious...
+ print 'Calculating MACs...'
+ from Crypto.Hash import HMAC, SHA
+ key = 'Jefferson'
+ macs = [HMAC.new(key, block, digestmod=SHA).digest()
+ for block in blocks]
+
+ assert len(blocks) == len(macs)
+
+ # put these into a form acceptable as input to the chaffing procedure
+ source = []
+ m = map(None, range(len(blocks)), blocks, macs)
+ print m
+ for i, data, mac in m:
+ source.append((i, data, mac))
+
+ # now chaff these
+ print 'Adding chaff...'
+ c = Chaff(factor=0.5, blocksper=2)
+ chaffed = c.chaff(source)
+
+ from base64 import encodestring
+
+ # print the chaffed message blocks. meanwhile, separate the wheat from
+ # the chaff
+
+ wheat = []
+ print 'chaffed message blocks:'
+ for i, data, mac in chaffed:
+ # do the authentication
+ h = HMAC.new(key, data, digestmod=SHA)
+ pmac = h.digest()
+ if pmac == mac:
+ tag = '-->'
+ wheat.append(data)
+ else:
+ tag = ' '
+ # base64 adds a trailing newline
+ print tag, '%3d' % i, \
+ repr(data), encodestring(mac)[:-1]
+
+ # now decode the message packets and check it against the original text
+ print 'Undigesting wheat...'
+ newtext = "".join(wheat)
+ if newtext == text:
+ print 'They match!'
+ else:
+ print 'They differ!'
diff --git a/src/gdata/Crypto/Protocol/__init__.py b/src/gdata/Crypto/Protocol/__init__.py
new file mode 100755
index 0000000..a6d68bc
--- /dev/null
+++ b/src/gdata/Crypto/Protocol/__init__.py
@@ -0,0 +1,17 @@
+
+"""Cryptographic protocols
+
+Implements various cryptographic protocols. (Don't expect to find
+network protocols here.)
+
+Crypto.Protocol.AllOrNothing Transforms a message into a set of message
+ blocks, such that the blocks can be
+ recombined to get the message back.
+
+Crypto.Protocol.Chaffing Takes a set of authenticated message blocks
+ (the wheat) and adds a number of
+ randomly generated blocks (the chaff).
+"""
+
+__all__ = ['AllOrNothing', 'Chaffing']
+__revision__ = "$Id: __init__.py,v 1.4 2003/02/28 15:23:21 akuchling Exp $"
diff --git a/src/gdata/Crypto/PublicKey/DSA.py b/src/gdata/Crypto/PublicKey/DSA.py
new file mode 100755
index 0000000..7947b6f
--- /dev/null
+++ b/src/gdata/Crypto/PublicKey/DSA.py
@@ -0,0 +1,238 @@
+
+#
+# DSA.py : Digital Signature Algorithm
+#
+# Part of the Python Cryptography Toolkit
+#
+# Distribute and use freely; there are no restrictions on further
+# dissemination and usage except those imposed by the laws of your
+# country of residence. This software is provided "as is" without
+# warranty of fitness for use or suitability for any purpose, express
+# or implied. Use at your own risk or not at all.
+#
+
+__revision__ = "$Id: DSA.py,v 1.16 2004/05/06 12:52:54 akuchling Exp $"
+
+from Crypto.PublicKey.pubkey import *
+from Crypto.Util import number
+from Crypto.Util.number import bytes_to_long, long_to_bytes
+from Crypto.Hash import SHA
+
+try:
+ from Crypto.PublicKey import _fastmath
+except ImportError:
+ _fastmath = None
+
+class error (Exception):
+ pass
+
+def generateQ(randfunc):
+ S=randfunc(20)
+ hash1=SHA.new(S).digest()
+ hash2=SHA.new(long_to_bytes(bytes_to_long(S)+1)).digest()
+ q = bignum(0)
+ for i in range(0,20):
+ c=ord(hash1[i])^ord(hash2[i])
+ if i==0:
+ c=c | 128
+ if i==19:
+ c= c | 1
+ q=q*256+c
+ while (not isPrime(q)):
+ q=q+2
+ if pow(2,159L) < q < pow(2,160L):
+ return S, q
+ raise error, 'Bad q value generated'
+
+def generate(bits, randfunc, progress_func=None):
+ """generate(bits:int, randfunc:callable, progress_func:callable)
+
+ Generate a DSA key of length 'bits', using 'randfunc' to get
+ random data and 'progress_func', if present, to display
+ the progress of the key generation.
+ """
+
+ if bits<160:
+ raise error, 'Key length <160 bits'
+ obj=DSAobj()
+ # Generate string S and prime q
+ if progress_func:
+ progress_func('p,q\n')
+ while (1):
+ S, obj.q = generateQ(randfunc)
+ n=(bits-1)/160
+ C, N, V = 0, 2, {}
+ b=(obj.q >> 5) & 15
+ powb=pow(bignum(2), b)
+ powL1=pow(bignum(2), bits-1)
+ while C<4096:
+ for k in range(0, n+1):
+ V[k]=bytes_to_long(SHA.new(S+str(N)+str(k)).digest())
+ W=V[n] % powb
+ for k in range(n-1, -1, -1):
+ W=(W<<160L)+V[k]
+ X=W+powL1
+ p=X-(X%(2*obj.q)-1)
+ if powL1<=p and isPrime(p):
+ break
+ C, N = C+1, N+n+1
+ if C<4096:
+ break
+ if progress_func:
+ progress_func('4096 multiples failed\n')
+
+ obj.p = p
+ power=(p-1)/obj.q
+ if progress_func:
+ progress_func('h,g\n')
+ while (1):
+ h=bytes_to_long(randfunc(bits)) % (p-1)
+ g=pow(h, power, p)
+ if 1<h<p-1 and g>1:
+ break
+ obj.g=g
+ if progress_func:
+ progress_func('x,y\n')
+ while (1):
+ x=bytes_to_long(randfunc(20))
+ if 0 < x < obj.q:
+ break
+ obj.x, obj.y = x, pow(g, x, p)
+ return obj
+
+def construct(tuple):
+ """construct(tuple:(long,long,long,long)|(long,long,long,long,long)):DSAobj
+ Construct a DSA object from a 4- or 5-tuple of numbers.
+ """
+ obj=DSAobj()
+ if len(tuple) not in [4,5]:
+ raise error, 'argument for construct() wrong length'
+ for i in range(len(tuple)):
+ field = obj.keydata[i]
+ setattr(obj, field, tuple[i])
+ return obj
+
+class DSAobj(pubkey):
+ keydata=['y', 'g', 'p', 'q', 'x']
+
+ def _encrypt(self, s, Kstr):
+ raise error, 'DSA algorithm cannot encrypt data'
+
+ def _decrypt(self, s):
+ raise error, 'DSA algorithm cannot decrypt data'
+
+ def _sign(self, M, K):
+ if (K<2 or self.q<=K):
+ raise error, 'K is not between 2 and q'
+ r=pow(self.g, K, self.p) % self.q
+ s=(inverse(K, self.q)*(M+self.x*r)) % self.q
+ return (r,s)
+
+ def _verify(self, M, sig):
+ r, s = sig
+ if r<=0 or r>=self.q or s<=0 or s>=self.q:
+ return 0
+ w=inverse(s, self.q)
+ u1, u2 = (M*w) % self.q, (r*w) % self.q
+ v1 = pow(self.g, u1, self.p)
+ v2 = pow(self.y, u2, self.p)
+ v = ((v1*v2) % self.p)
+ v = v % self.q
+ if v==r:
+ return 1
+ return 0
+
+ def size(self):
+ "Return the maximum number of bits that can be handled by this key."
+ return number.size(self.p) - 1
+
+ def has_private(self):
+ """Return a Boolean denoting whether the object contains
+ private components."""
+ if hasattr(self, 'x'):
+ return 1
+ else:
+ return 0
+
+ def can_sign(self):
+ """Return a Boolean value recording whether this algorithm can generate signatures."""
+ return 1
+
+ def can_encrypt(self):
+ """Return a Boolean value recording whether this algorithm can encrypt data."""
+ return 0
+
+ def publickey(self):
+ """Return a new key object containing only the public information."""
+ return construct((self.y, self.g, self.p, self.q))
+
+object=DSAobj
+
+generate_py = generate
+construct_py = construct
+
+class DSAobj_c(pubkey):
+ keydata = ['y', 'g', 'p', 'q', 'x']
+
+ def __init__(self, key):
+ self.key = key
+
+ def __getattr__(self, attr):
+ if attr in self.keydata:
+ return getattr(self.key, attr)
+ else:
+ if self.__dict__.has_key(attr):
+ self.__dict__[attr]
+ else:
+ raise AttributeError, '%s instance has no attribute %s' % (self.__class__, attr)
+
+ def __getstate__(self):
+ d = {}
+ for k in self.keydata:
+ if hasattr(self.key, k):
+ d[k]=getattr(self.key, k)
+ return d
+
+ def __setstate__(self, state):
+ y,g,p,q = state['y'], state['g'], state['p'], state['q']
+ if not state.has_key('x'):
+ self.key = _fastmath.dsa_construct(y,g,p,q)
+ else:
+ x = state['x']
+ self.key = _fastmath.dsa_construct(y,g,p,q,x)
+
+ def _sign(self, M, K):
+ return self.key._sign(M, K)
+
+ def _verify(self, M, (r, s)):
+ return self.key._verify(M, r, s)
+
+ def size(self):
+ return self.key.size()
+
+ def has_private(self):
+ return self.key.has_private()
+
+ def publickey(self):
+ return construct_c((self.key.y, self.key.g, self.key.p, self.key.q))
+
+ def can_sign(self):
+ return 1
+
+ def can_encrypt(self):
+ return 0
+
+def generate_c(bits, randfunc, progress_func=None):
+ obj = generate_py(bits, randfunc, progress_func)
+ y,g,p,q,x = obj.y, obj.g, obj.p, obj.q, obj.x
+ return construct_c((y,g,p,q,x))
+
+def construct_c(tuple):
+ key = apply(_fastmath.dsa_construct, tuple)
+ return DSAobj_c(key)
+
+if _fastmath:
+ #print "using C version of DSA"
+ generate = generate_c
+ construct = construct_c
+ error = _fastmath.error
diff --git a/src/gdata/Crypto/PublicKey/ElGamal.py b/src/gdata/Crypto/PublicKey/ElGamal.py
new file mode 100755
index 0000000..026881c
--- /dev/null
+++ b/src/gdata/Crypto/PublicKey/ElGamal.py
@@ -0,0 +1,132 @@
+#
+# ElGamal.py : ElGamal encryption/decryption and signatures
+#
+# Part of the Python Cryptography Toolkit
+#
+# Distribute and use freely; there are no restrictions on further
+# dissemination and usage except those imposed by the laws of your
+# country of residence. This software is provided "as is" without
+# warranty of fitness for use or suitability for any purpose, express
+# or implied. Use at your own risk or not at all.
+#
+
+__revision__ = "$Id: ElGamal.py,v 1.9 2003/04/04 19:44:26 akuchling Exp $"
+
+from Crypto.PublicKey.pubkey import *
+from Crypto.Util import number
+
+class error (Exception):
+ pass
+
+# Generate an ElGamal key with N bits
+def generate(bits, randfunc, progress_func=None):
+ """generate(bits:int, randfunc:callable, progress_func:callable)
+
+ Generate an ElGamal key of length 'bits', using 'randfunc' to get
+ random data and 'progress_func', if present, to display
+ the progress of the key generation.
+ """
+ obj=ElGamalobj()
+ # Generate prime p
+ if progress_func:
+ progress_func('p\n')
+ obj.p=bignum(getPrime(bits, randfunc))
+ # Generate random number g
+ if progress_func:
+ progress_func('g\n')
+ size=bits-1-(ord(randfunc(1)) & 63) # g will be from 1--64 bits smaller than p
+ if size<1:
+ size=bits-1
+ while (1):
+ obj.g=bignum(getPrime(size, randfunc))
+ if obj.g < obj.p:
+ break
+ size=(size+1) % bits
+ if size==0:
+ size=4
+ # Generate random number x
+ if progress_func:
+ progress_func('x\n')
+ while (1):
+ size=bits-1-ord(randfunc(1)) # x will be from 1 to 256 bits smaller than p
+ if size>2:
+ break
+ while (1):
+ obj.x=bignum(getPrime(size, randfunc))
+ if obj.x < obj.p:
+ break
+ size = (size+1) % bits
+ if size==0:
+ size=4
+ if progress_func:
+ progress_func('y\n')
+ obj.y = pow(obj.g, obj.x, obj.p)
+ return obj
+
+def construct(tuple):
+ """construct(tuple:(long,long,long,long)|(long,long,long,long,long)))
+ : ElGamalobj
+ Construct an ElGamal key from a 3- or 4-tuple of numbers.
+ """
+
+ obj=ElGamalobj()
+ if len(tuple) not in [3,4]:
+ raise error, 'argument for construct() wrong length'
+ for i in range(len(tuple)):
+ field = obj.keydata[i]
+ setattr(obj, field, tuple[i])
+ return obj
+
+class ElGamalobj(pubkey):
+ keydata=['p', 'g', 'y', 'x']
+
+ def _encrypt(self, M, K):
+ a=pow(self.g, K, self.p)
+ b=( M*pow(self.y, K, self.p) ) % self.p
+ return ( a,b )
+
+ def _decrypt(self, M):
+ if (not hasattr(self, 'x')):
+ raise error, 'Private key not available in this object'
+ ax=pow(M[0], self.x, self.p)
+ plaintext=(M[1] * inverse(ax, self.p ) ) % self.p
+ return plaintext
+
+ def _sign(self, M, K):
+ if (not hasattr(self, 'x')):
+ raise error, 'Private key not available in this object'
+ p1=self.p-1
+ if (GCD(K, p1)!=1):
+ raise error, 'Bad K value: GCD(K,p-1)!=1'
+ a=pow(self.g, K, self.p)
+ t=(M-self.x*a) % p1
+ while t<0: t=t+p1
+ b=(t*inverse(K, p1)) % p1
+ return (a, b)
+
+ def _verify(self, M, sig):
+ v1=pow(self.y, sig[0], self.p)
+ v1=(v1*pow(sig[0], sig[1], self.p)) % self.p
+ v2=pow(self.g, M, self.p)
+ if v1==v2:
+ return 1
+ return 0
+
+ def size(self):
+ "Return the maximum number of bits that can be handled by this key."
+ return number.size(self.p) - 1
+
+ def has_private(self):
+ """Return a Boolean denoting whether the object contains
+ private components."""
+ if hasattr(self, 'x'):
+ return 1
+ else:
+ return 0
+
+ def publickey(self):
+ """Return a new key object containing only the public information."""
+ return construct((self.p, self.g, self.y))
+
+
+object=ElGamalobj
diff --git a/src/gdata/Crypto/PublicKey/RSA.py b/src/gdata/Crypto/PublicKey/RSA.py
new file mode 100755
index 0000000..e0e877e
--- /dev/null
+++ b/src/gdata/Crypto/PublicKey/RSA.py
@@ -0,0 +1,256 @@
+#
+# RSA.py : RSA encryption/decryption
+#
+# Part of the Python Cryptography Toolkit
+#
+# Distribute and use freely; there are no restrictions on further
+# dissemination and usage except those imposed by the laws of your
+# country of residence. This software is provided "as is" without
+# warranty of fitness for use or suitability for any purpose, express
+# or implied. Use at your own risk or not at all.
+#
+
+__revision__ = "$Id: RSA.py,v 1.20 2004/05/06 12:52:54 akuchling Exp $"
+
+from Crypto.PublicKey import pubkey
+from Crypto.Util import number
+
+try:
+ from Crypto.PublicKey import _fastmath
+except ImportError:
+ _fastmath = None
+
+class error (Exception):
+ pass
+
+def generate(bits, randfunc, progress_func=None):
+ """generate(bits:int, randfunc:callable, progress_func:callable)
+
+ Generate an RSA key of length 'bits', using 'randfunc' to get
+ random data and 'progress_func', if present, to display
+ the progress of the key generation.
+ """
+ obj=RSAobj()
+
+ # Generate the prime factors of n
+ if progress_func:
+ progress_func('p,q\n')
+ p = q = 1L
+ while number.size(p*q) < bits:
+ p = pubkey.getPrime(bits/2, randfunc)
+ q = pubkey.getPrime(bits/2, randfunc)
+
+ # p shall be smaller than q (for calc of u)
+ if p > q:
+ (p, q)=(q, p)
+ obj.p = p
+ obj.q = q
+
+ if progress_func:
+ progress_func('u\n')
+ obj.u = pubkey.inverse(obj.p, obj.q)
+ obj.n = obj.p*obj.q
+
+ obj.e = 65537L
+ if progress_func:
+ progress_func('d\n')
+ obj.d=pubkey.inverse(obj.e, (obj.p-1)*(obj.q-1))
+
+ assert bits <= 1+obj.size(), "Generated key is too small"
+
+ return obj
+
+def construct(tuple):
+ """construct(tuple:(long,) : RSAobj
+ Construct an RSA object from a 2-, 3-, 5-, or 6-tuple of numbers.
+ """
+
+ obj=RSAobj()
+ if len(tuple) not in [2,3,5,6]:
+ raise error, 'argument for construct() wrong length'
+ for i in range(len(tuple)):
+ field = obj.keydata[i]
+ setattr(obj, field, tuple[i])
+ if len(tuple) >= 5:
+ # Ensure p is smaller than q
+ if obj.p>obj.q:
+ (obj.p, obj.q)=(obj.q, obj.p)
+
+ if len(tuple) == 5:
+ # u not supplied, so we're going to have to compute it.
+ obj.u=pubkey.inverse(obj.p, obj.q)
+
+ return obj
+
+class RSAobj(pubkey.pubkey):
+ keydata = ['n', 'e', 'd', 'p', 'q', 'u']
+ def _encrypt(self, plaintext, K=''):
+ if self.n<=plaintext:
+ raise error, 'Plaintext too large'
+ return (pow(plaintext, self.e, self.n),)
+
+ def _decrypt(self, ciphertext):
+ if (not hasattr(self, 'd')):
+ raise error, 'Private key not available in this object'
+ if self.n<=ciphertext[0]:
+ raise error, 'Ciphertext too large'
+ return pow(ciphertext[0], self.d, self.n)
+
+ def _sign(self, M, K=''):
+ return (self._decrypt((M,)),)
+
+ def _verify(self, M, sig):
+ m2=self._encrypt(sig[0])
+ if m2[0]==M:
+ return 1
+ else: return 0
+
+ def _blind(self, M, B):
+ tmp = pow(B, self.e, self.n)
+ return (M * tmp) % self.n
+
+ def _unblind(self, M, B):
+ tmp = pubkey.inverse(B, self.n)
+ return (M * tmp) % self.n
+
+ def can_blind (self):
+ """can_blind() : bool
+ Return a Boolean value recording whether this algorithm can
+ blind data. (This does not imply that this
+ particular key object has the private information required to
+ to blind a message.)
+ """
+ return 1
+
+ def size(self):
+ """size() : int
+ Return the maximum number of bits that can be handled by this key.
+ """
+ return number.size(self.n) - 1
+
+ def has_private(self):
+ """has_private() : bool
+ Return a Boolean denoting whether the object contains
+ private components.
+ """
+ if hasattr(self, 'd'):
+ return 1
+ else: return 0
+
+ def publickey(self):
+ """publickey(): RSAobj
+ Return a new key object containing only the public key information.
+ """
+ return construct((self.n, self.e))
+
+class RSAobj_c(pubkey.pubkey):
+ keydata = ['n', 'e', 'd', 'p', 'q', 'u']
+
+ def __init__(self, key):
+ self.key = key
+
+ def __getattr__(self, attr):
+ if attr in self.keydata:
+ return getattr(self.key, attr)
+ else:
+ if self.__dict__.has_key(attr):
+ self.__dict__[attr]
+ else:
+ raise AttributeError, '%s instance has no attribute %s' % (self.__class__, attr)
+
+ def __getstate__(self):
+ d = {}
+ for k in self.keydata:
+ if hasattr(self.key, k):
+ d[k]=getattr(self.key, k)
+ return d
+
+ def __setstate__(self, state):
+ n,e = state['n'], state['e']
+ if not state.has_key('d'):
+ self.key = _fastmath.rsa_construct(n,e)
+ else:
+ d = state['d']
+ if not state.has_key('q'):
+ self.key = _fastmath.rsa_construct(n,e,d)
+ else:
+ p, q, u = state['p'], state['q'], state['u']
+ self.key = _fastmath.rsa_construct(n,e,d,p,q,u)
+
+ def _encrypt(self, plain, K):
+ return (self.key._encrypt(plain),)
+
+ def _decrypt(self, cipher):
+ return self.key._decrypt(cipher[0])
+
+ def _sign(self, M, K):
+ return (self.key._sign(M),)
+
+ def _verify(self, M, sig):
+ return self.key._verify(M, sig[0])
+
+ def _blind(self, M, B):
+ return self.key._blind(M, B)
+
+ def _unblind(self, M, B):
+ return self.key._unblind(M, B)
+
+ def can_blind (self):
+ return 1
+
+ def size(self):
+ return self.key.size()
+
+ def has_private(self):
+ return self.key.has_private()
+
+ def publickey(self):
+ return construct_c((self.key.n, self.key.e))
+
+def generate_c(bits, randfunc, progress_func = None):
+ # Generate the prime factors of n
+ if progress_func:
+ progress_func('p,q\n')
+
+ p = q = 1L
+ while number.size(p*q) < bits:
+ p = pubkey.getPrime(bits/2, randfunc)
+ q = pubkey.getPrime(bits/2, randfunc)
+
+ # p shall be smaller than q (for calc of u)
+ if p > q:
+ (p, q)=(q, p)
+ if progress_func:
+ progress_func('u\n')
+ u=pubkey.inverse(p, q)
+ n=p*q
+
+ e = 65537L
+ if progress_func:
+ progress_func('d\n')
+ d=pubkey.inverse(e, (p-1)*(q-1))
+ key = _fastmath.rsa_construct(n,e,d,p,q,u)
+ obj = RSAobj_c(key)
+
+## print p
+## print q
+## print number.size(p), number.size(q), number.size(q*p),
+## print obj.size(), bits
+ assert bits <= 1+obj.size(), "Generated key is too small"
+ return obj
+
+
+def construct_c(tuple):
+ key = apply(_fastmath.rsa_construct, tuple)
+ return RSAobj_c(key)
+
+object = RSAobj
+
+generate_py = generate
+construct_py = construct
+
+if _fastmath:
+ #print "using C version of RSA"
+ generate = generate_c
+ construct = construct_c
+ error = _fastmath.error
diff --git a/src/gdata/Crypto/PublicKey/__init__.py b/src/gdata/Crypto/PublicKey/__init__.py
new file mode 100755
index 0000000..ad1c80c
--- /dev/null
+++ b/src/gdata/Crypto/PublicKey/__init__.py
@@ -0,0 +1,17 @@
+"""Public-key encryption and signature algorithms.
+
+Public-key encryption uses two different keys, one for encryption and
+one for decryption. The encryption key can be made public, and the
+decryption key is kept private. Many public-key algorithms can also
+be used to sign messages, and some can *only* be used for signatures.
+
+Crypto.PublicKey.DSA Digital Signature Algorithm. (Signature only)
+Crypto.PublicKey.ElGamal (Signing and encryption)
+Crypto.PublicKey.RSA (Signing, encryption, and blinding)
+Crypto.PublicKey.qNEW (Signature only)
+
+"""
+
+__all__ = ['RSA', 'DSA', 'ElGamal', 'qNEW']
+__revision__ = "$Id: __init__.py,v 1.4 2003/04/03 20:27:13 akuchling Exp $"
+
diff --git a/src/gdata/Crypto/PublicKey/pubkey.py b/src/gdata/Crypto/PublicKey/pubkey.py
new file mode 100755
index 0000000..5c75c3e
--- /dev/null
+++ b/src/gdata/Crypto/PublicKey/pubkey.py
@@ -0,0 +1,172 @@
+#
+# pubkey.py : Internal functions for public key operations
+#
+# Part of the Python Cryptography Toolkit
+#
+# Distribute and use freely; there are no restrictions on further
+# dissemination and usage except those imposed by the laws of your
+# country of residence. This software is provided "as is" without
+# warranty of fitness for use or suitability for any purpose, express
+# or implied. Use at your own risk or not at all.
+#
+
+__revision__ = "$Id: pubkey.py,v 1.11 2003/04/03 20:36:14 akuchling Exp $"
+
+import types, warnings
+from Crypto.Util.number import *
+
+# Basic public key class
+class pubkey:
+ def __init__(self):
+ pass
+
+ def __getstate__(self):
+ """To keep key objects platform-independent, the key data is
+ converted to standard Python long integers before being
+ written out. It will then be reconverted as necessary on
+ restoration."""
+ d=self.__dict__
+ for key in self.keydata:
+ if d.has_key(key): d[key]=long(d[key])
+ return d
+
+ def __setstate__(self, d):
+ """On unpickling a key object, the key data is converted to the big
+number representation being used, whether that is Python long
+integers, MPZ objects, or whatever."""
+ for key in self.keydata:
+ if d.has_key(key): self.__dict__[key]=bignum(d[key])
+
+ def encrypt(self, plaintext, K):
+ """encrypt(plaintext:string|long, K:string|long) : tuple
+ Encrypt the string or integer plaintext. K is a random
+ parameter required by some algorithms.
+ """
+ wasString=0
+ if isinstance(plaintext, types.StringType):
+ plaintext=bytes_to_long(plaintext) ; wasString=1
+ if isinstance(K, types.StringType):
+ K=bytes_to_long(K)
+ ciphertext=self._encrypt(plaintext, K)
+ if wasString: return tuple(map(long_to_bytes, ciphertext))
+ else: return ciphertext
+
+ def decrypt(self, ciphertext):
+ """decrypt(ciphertext:tuple|string|long): string
+ Decrypt 'ciphertext' using this key.
+ """
+ wasString=0
+ if not isinstance(ciphertext, types.TupleType):
+ ciphertext=(ciphertext,)
+ if isinstance(ciphertext[0], types.StringType):
+ ciphertext=tuple(map(bytes_to_long, ciphertext)) ; wasString=1
+ plaintext=self._decrypt(ciphertext)
+ if wasString: return long_to_bytes(plaintext)
+ else: return plaintext
+
+ def sign(self, M, K):
+ """sign(M : string|long, K:string|long) : tuple
+ Return a tuple containing the signature for the message M.
+ K is a random parameter required by some algorithms.
+ """
+ if (not self.has_private()):
+ raise error, 'Private key not available in this object'
+ if isinstance(M, types.StringType): M=bytes_to_long(M)
+ if isinstance(K, types.StringType): K=bytes_to_long(K)
+ return self._sign(M, K)
+
+ def verify (self, M, signature):
+ """verify(M:string|long, signature:tuple) : bool
+ Verify that the signature is valid for the message M;
+ returns true if the signature checks out.
+ """
+ if isinstance(M, types.StringType): M=bytes_to_long(M)
+ return self._verify(M, signature)
+
+ # alias to compensate for the old validate() name
+ def validate (self, M, signature):
+ warnings.warn("validate() method name is obsolete; use verify()",
+ DeprecationWarning)
+
+ def blind(self, M, B):
+ """blind(M : string|long, B : string|long) : string|long
+ Blind message M using blinding factor B.
+ """
+ wasString=0
+ if isinstance(M, types.StringType):
+ M=bytes_to_long(M) ; wasString=1
+ if isinstance(B, types.StringType): B=bytes_to_long(B)
+ blindedmessage=self._blind(M, B)
+ if wasString: return long_to_bytes(blindedmessage)
+ else: return blindedmessage
+
+ def unblind(self, M, B):
+ """unblind(M : string|long, B : string|long) : string|long
+ Unblind message M using blinding factor B.
+ """
+ wasString=0
+ if isinstance(M, types.StringType):
+ M=bytes_to_long(M) ; wasString=1
+ if isinstance(B, types.StringType): B=bytes_to_long(B)
+ unblindedmessage=self._unblind(M, B)
+ if wasString: return long_to_bytes(unblindedmessage)
+ else: return unblindedmessage
+
+
+ # The following methods will usually be left alone, except for
+ # signature-only algorithms. They both return Boolean values
+ # recording whether this key's algorithm can sign and encrypt.
+ def can_sign (self):
+ """can_sign() : bool
+ Return a Boolean value recording whether this algorithm can
+ generate signatures. (This does not imply that this
+ particular key object has the private information required to
+ to generate a signature.)
+ """
+ return 1
+
+ def can_encrypt (self):
+ """can_encrypt() : bool
+ Return a Boolean value recording whether this algorithm can
+ encrypt data. (This does not imply that this
+ particular key object has the private information required to
+ to decrypt a message.)
+ """
+ return 1
+
+ def can_blind (self):
+ """can_blind() : bool
+ Return a Boolean value recording whether this algorithm can
+ blind data. (This does not imply that this
+ particular key object has the private information required to
+ to blind a message.)
+ """
+ return 0
+
+ # The following methods will certainly be overridden by
+ # subclasses.
+
+ def size (self):
+ """size() : int
+ Return the maximum number of bits that can be handled by this key.
+ """
+ return 0
+
+ def has_private (self):
+ """has_private() : bool
+ Return a Boolean denoting whether the object contains
+ private components.
+ """
+ return 0
+
+ def publickey (self):
+ """publickey(): object
+ Return a new key object containing only the public information.
+ """
+ return self
+
+ def __eq__ (self, other):
+ """__eq__(other): 0, 1
+ Compare us to other for equality.
+ """
+ return self.__getstate__() == other.__getstate__()
diff --git a/src/gdata/Crypto/PublicKey/qNEW.py b/src/gdata/Crypto/PublicKey/qNEW.py
new file mode 100755
index 0000000..65f8ae3
--- /dev/null
+++ b/src/gdata/Crypto/PublicKey/qNEW.py
@@ -0,0 +1,170 @@
+#
+# qNEW.py : The q-NEW signature algorithm.
+#
+# Part of the Python Cryptography Toolkit
+#
+# Distribute and use freely; there are no restrictions on further
+# dissemination and usage except those imposed by the laws of your
+# country of residence. This software is provided "as is" without
+# warranty of fitness for use or suitability for any purpose, express
+# or implied. Use at your own risk or not at all.
+#
+
+__revision__ = "$Id: qNEW.py,v 1.8 2003/04/04 15:13:35 akuchling Exp $"
+
+from Crypto.PublicKey import pubkey
+from Crypto.Util.number import *
+from Crypto.Hash import SHA
+
+class error (Exception):
+ pass
+
+HASHBITS = 160 # Size of SHA digests
+
+def generate(bits, randfunc, progress_func=None):
+ """generate(bits:int, randfunc:callable, progress_func:callable)
+
+ Generate a qNEW key of length 'bits', using 'randfunc' to get
+ random data and 'progress_func', if present, to display
+ the progress of the key generation.
+ """
+ obj=qNEWobj()
+
+ # Generate prime numbers p and q. q is a 160-bit prime
+ # number. p is another prime number (the modulus) whose bit
+ # size is chosen by the caller, and is generated so that p-1
+ # is a multiple of q.
+ #
+ # Note that only a single seed is used to
+ # generate p and q; if someone generates a key for you, you can
+ # use the seed to duplicate the key generation. This can
+ # protect you from someone generating values of p,q that have
+ # some special form that's easy to break.
+ if progress_func:
+ progress_func('p,q\n')
+ while (1):
+ obj.q = getPrime(160, randfunc)
+ # assert pow(2, 159L)<obj.q<pow(2, 160L)
+ obj.seed = S = long_to_bytes(obj.q)
+ C, N, V = 0, 2, {}
+ # Compute b and n such that bits-1 = b + n*HASHBITS
+ n= (bits-1) / HASHBITS
+ b= (bits-1) % HASHBITS ; powb=2L << b
+ powL1=pow(long(2), bits-1)
+ while C<4096:
+ # The V array will contain (bits-1) bits of random
+ # data, that are assembled to produce a candidate
+ # value for p.
+ for k in range(0, n+1):
+ V[k]=bytes_to_long(SHA.new(S+str(N)+str(k)).digest())
+ p = V[n] % powb
+ for k in range(n-1, -1, -1):
+ p= (p << long(HASHBITS) )+V[k]
+ p = p+powL1 # Ensure the high bit is set
+
+ # Ensure that p-1 is a multiple of q
+ p = p - (p % (2*obj.q)-1)
+
+ # If p is still the right size, and it's prime, we're done!
+ if powL1<=p and isPrime(p):
+ break
+
+ # Otherwise, increment the counter and try again
+ C, N = C+1, N+n+1
+ if C<4096:
+ break # Ended early, so exit the while loop
+ if progress_func:
+ progress_func('4096 values of p tried\n')
+
+ obj.p = p
+ power=(p-1)/obj.q
+
+ # Next parameter: g = h**((p-1)/q) mod p, such that h is any
+ # number <p-1, and g>1. g is kept; h can be discarded.
+ if progress_func:
+ progress_func('h,g\n')
+ while (1):
+ h=bytes_to_long(randfunc(bits)) % (p-1)
+ g=pow(h, power, p)
+ if 1<h<p-1 and g>1:
+ break
+ obj.g=g
+
+ # x is the private key information, and is
+ # just a random number between 0 and q.
+ # y=g**x mod p, and is part of the public information.
+ if progress_func:
+ progress_func('x,y\n')
+ while (1):
+ x=bytes_to_long(randfunc(20))
+ if 0 < x < obj.q:
+ break
+ obj.x, obj.y=x, pow(g, x, p)
+
+ return obj
+
+# Construct a qNEW object
+def construct(tuple):
+ """construct(tuple:(long,long,long,long)|(long,long,long,long,long)
+ Construct a qNEW object from a 4- or 5-tuple of numbers.
+ """
+ obj=qNEWobj()
+ if len(tuple) not in [4,5]:
+ raise error, 'argument for construct() wrong length'
+ for i in range(len(tuple)):
+ field = obj.keydata[i]
+ setattr(obj, field, tuple[i])
+ return obj
+
+class qNEWobj(pubkey.pubkey):
+ keydata=['p', 'q', 'g', 'y', 'x']
+
+ def _sign(self, M, K=''):
+ if (self.q<=K):
+ raise error, 'K is greater than q'
+ if M<0:
+ raise error, 'Illegal value of M (<0)'
+ if M>=pow(2,161L):
+ raise error, 'Illegal value of M (too large)'
+ r=pow(self.g, K, self.p) % self.q
+ s=(K- (r*M*self.x % self.q)) % self.q
+ return (r,s)
+ def _verify(self, M, sig):
+ r, s = sig
+ if r<=0 or r>=self.q or s<=0 or s>=self.q:
+ return 0
+ if M<0:
+ raise error, 'Illegal value of M (<0)'
+ if M<=0 or M>=pow(2,161L):
+ return 0
+ v1 = pow(self.g, s, self.p)
+ v2 = pow(self.y, M*r, self.p)
+ v = ((v1*v2) % self.p)
+ v = v % self.q
+ if v==r:
+ return 1
+ return 0
+
+ def size(self):
+ "Return the maximum number of bits that can be handled by this key."
+ return 160
+
+ def has_private(self):
+ """Return a Boolean denoting whether the object contains
+ private components."""
+ return hasattr(self, 'x')
+
+ def can_sign(self):
+ """Return a Boolean value recording whether this algorithm can generate signatures."""
+ return 1
+
+ def can_encrypt(self):
+ """Return a Boolean value recording whether this algorithm can encrypt data."""
+ return 0
+
+ def publickey(self):
+ """Return a new key object containing only the public information."""
+ return construct((self.p, self.q, self.g, self.y))
+
+object = qNEWobj
+
diff --git a/src/gdata/Crypto/Util/RFC1751.py b/src/gdata/Crypto/Util/RFC1751.py
new file mode 100755
index 0000000..0a47952
--- /dev/null
+++ b/src/gdata/Crypto/Util/RFC1751.py
@@ -0,0 +1,342 @@
+#!/usr/local/bin/python
+# rfc1751.py : Converts between 128-bit strings and a human-readable
+# sequence of words, as defined in RFC1751: "A Convention for
+# Human-Readable 128-bit Keys", by Daniel L. McDonald.
+
+__revision__ = "$Id: RFC1751.py,v 1.6 2003/04/04 15:15:10 akuchling Exp $"
+
+
+import string, binascii
+
+binary={0:'0000', 1:'0001', 2:'0010', 3:'0011', 4:'0100', 5:'0101',
+ 6:'0110', 7:'0111', 8:'1000', 9:'1001', 10:'1010', 11:'1011',
+ 12:'1100', 13:'1101', 14:'1110', 15:'1111'}
+
+def _key2bin(s):
+ "Convert a key into a string of binary digits"
+ kl=map(lambda x: ord(x), s)
+ kl=map(lambda x: binary[x/16]+binary[x&15], kl)
+ return ''.join(kl)
+
+def _extract(key, start, length):
+ """Extract a bitstring from a string of binary digits, and return its
+ numeric value."""
+ k=key[start:start+length]
+ return reduce(lambda x,y: x*2+ord(y)-48, k, 0)
+
+def key_to_english (key):
+ """key_to_english(key:string) : string
+ Transform an arbitrary key into a string containing English words.
+ The key length must be a multiple of 8.
+ """
+ english=''
+ for index in range(0, len(key), 8): # Loop over 8-byte subkeys
+ subkey=key[index:index+8]
+ # Compute the parity of the key
+ skbin=_key2bin(subkey) ; p=0
+ for i in range(0, 64, 2): p=p+_extract(skbin, i, 2)
+ # Append parity bits to the subkey
+ skbin=_key2bin(subkey+chr((p<<6) & 255))
+ for i in range(0, 64, 11):
+ english=english+wordlist[_extract(skbin, i, 11)]+' '
+
+ return english[:-1] # Remove the trailing space
+
+def english_to_key (str):
+ """english_to_key(string):string
+ Transform a string into a corresponding key.
+ The string must contain words separated by whitespace; the number
+ of words must be a multiple of 6.
+ """
+
+ L=string.split(string.upper(str)) ; key=''
+ for index in range(0, len(L), 6):
+ sublist=L[index:index+6] ; char=9*[0] ; bits=0
+ for i in sublist:
+ index = wordlist.index(i)
+ shift = (8-(bits+11)%8) %8
+ y = index << shift
+ cl, cc, cr = (y>>16), (y>>8)&0xff, y & 0xff
+ if (shift>5):
+ char[bits/8] = char[bits/8] | cl
+ char[bits/8+1] = char[bits/8+1] | cc
+ char[bits/8+2] = char[bits/8+2] | cr
+ elif shift>-3:
+ char[bits/8] = char[bits/8] | cc
+ char[bits/8+1] = char[bits/8+1] | cr
+ else: char[bits/8] = char[bits/8] | cr
+ bits=bits+11
+ subkey=reduce(lambda x,y:x+chr(y), char, '')
+
+ # Check the parity of the resulting key
+ skbin=_key2bin(subkey)
+ p=0
+ for i in range(0, 64, 2): p=p+_extract(skbin, i, 2)
+ if (p&3) != _extract(skbin, 64, 2):
+ raise ValueError, "Parity error in resulting key"
+ key=key+subkey[0:8]
+ return key
+
+wordlist=[ "A", "ABE", "ACE", "ACT", "AD", "ADA", "ADD",
+ "AGO", "AID", "AIM", "AIR", "ALL", "ALP", "AM", "AMY", "AN", "ANA",
+ "AND", "ANN", "ANT", "ANY", "APE", "APS", "APT", "ARC", "ARE", "ARK",
+ "ARM", "ART", "AS", "ASH", "ASK", "AT", "ATE", "AUG", "AUK", "AVE",
+ "AWE", "AWK", "AWL", "AWN", "AX", "AYE", "BAD", "BAG", "BAH", "BAM",
+ "BAN", "BAR", "BAT", "BAY", "BE", "BED", "BEE", "BEG", "BEN", "BET",
+ "BEY", "BIB", "BID", "BIG", "BIN", "BIT", "BOB", "BOG", "BON", "BOO",
+ "BOP", "BOW", "BOY", "BUB", "BUD", "BUG", "BUM", "BUN", "BUS", "BUT",
+ "BUY", "BY", "BYE", "CAB", "CAL", "CAM", "CAN", "CAP", "CAR", "CAT",
+ "CAW", "COD", "COG", "COL", "CON", "COO", "COP", "COT", "COW", "COY",
+ "CRY", "CUB", "CUE", "CUP", "CUR", "CUT", "DAB", "DAD", "DAM", "DAN",
+ "DAR", "DAY", "DEE", "DEL", "DEN", "DES", "DEW", "DID", "DIE", "DIG",
+ "DIN", "DIP", "DO", "DOE", "DOG", "DON", "DOT", "DOW", "DRY", "DUB",
+ "DUD", "DUE", "DUG", "DUN", "EAR", "EAT", "ED", "EEL", "EGG", "EGO",
+ "ELI", "ELK", "ELM", "ELY", "EM", "END", "EST", "ETC", "EVA", "EVE",
+ "EWE", "EYE", "FAD", "FAN", "FAR", "FAT", "FAY", "FED", "FEE", "FEW",
+ "FIB", "FIG", "FIN", "FIR", "FIT", "FLO", "FLY", "FOE", "FOG", "FOR",
+ "FRY", "FUM", "FUN", "FUR", "GAB", "GAD", "GAG", "GAL", "GAM", "GAP",
+ "GAS", "GAY", "GEE", "GEL", "GEM", "GET", "GIG", "GIL", "GIN", "GO",
+ "GOT", "GUM", "GUN", "GUS", "GUT", "GUY", "GYM", "GYP", "HA", "HAD",
+ "HAL", "HAM", "HAN", "HAP", "HAS", "HAT", "HAW", "HAY", "HE", "HEM",
+ "HEN", "HER", "HEW", "HEY", "HI", "HID", "HIM", "HIP", "HIS", "HIT",
+ "HO", "HOB", "HOC", "HOE", "HOG", "HOP", "HOT", "HOW", "HUB", "HUE",
+ "HUG", "HUH", "HUM", "HUT", "I", "ICY", "IDA", "IF", "IKE", "ILL",
+ "INK", "INN", "IO", "ION", "IQ", "IRA", "IRE", "IRK", "IS", "IT",
+ "ITS", "IVY", "JAB", "JAG", "JAM", "JAN", "JAR", "JAW", "JAY", "JET",
+ "JIG", "JIM", "JO", "JOB", "JOE", "JOG", "JOT", "JOY", "JUG", "JUT",
+ "KAY", "KEG", "KEN", "KEY", "KID", "KIM", "KIN", "KIT", "LA", "LAB",
+ "LAC", "LAD", "LAG", "LAM", "LAP", "LAW", "LAY", "LEA", "LED", "LEE",
+ "LEG", "LEN", "LEO", "LET", "LEW", "LID", "LIE", "LIN", "LIP", "LIT",
+ "LO", "LOB", "LOG", "LOP", "LOS", "LOT", "LOU", "LOW", "LOY", "LUG",
+ "LYE", "MA", "MAC", "MAD", "MAE", "MAN", "MAO", "MAP", "MAT", "MAW",
+ "MAY", "ME", "MEG", "MEL", "MEN", "MET", "MEW", "MID", "MIN", "MIT",
+ "MOB", "MOD", "MOE", "MOO", "MOP", "MOS", "MOT", "MOW", "MUD", "MUG",
+ "MUM", "MY", "NAB", "NAG", "NAN", "NAP", "NAT", "NAY", "NE", "NED",
+ "NEE", "NET", "NEW", "NIB", "NIL", "NIP", "NIT", "NO", "NOB", "NOD",
+ "NON", "NOR", "NOT", "NOV", "NOW", "NU", "NUN", "NUT", "O", "OAF",
+ "OAK", "OAR", "OAT", "ODD", "ODE", "OF", "OFF", "OFT", "OH", "OIL",
+ "OK", "OLD", "ON", "ONE", "OR", "ORB", "ORE", "ORR", "OS", "OTT",
+ "OUR", "OUT", "OVA", "OW", "OWE", "OWL", "OWN", "OX", "PA", "PAD",
+ "PAL", "PAM", "PAN", "PAP", "PAR", "PAT", "PAW", "PAY", "PEA", "PEG",
+ "PEN", "PEP", "PER", "PET", "PEW", "PHI", "PI", "PIE", "PIN", "PIT",
+ "PLY", "PO", "POD", "POE", "POP", "POT", "POW", "PRO", "PRY", "PUB",
+ "PUG", "PUN", "PUP", "PUT", "QUO", "RAG", "RAM", "RAN", "RAP", "RAT",
+ "RAW", "RAY", "REB", "RED", "REP", "RET", "RIB", "RID", "RIG", "RIM",
+ "RIO", "RIP", "ROB", "ROD", "ROE", "RON", "ROT", "ROW", "ROY", "RUB",
+ "RUE", "RUG", "RUM", "RUN", "RYE", "SAC", "SAD", "SAG", "SAL", "SAM",
+ "SAN", "SAP", "SAT", "SAW", "SAY", "SEA", "SEC", "SEE", "SEN", "SET",
+ "SEW", "SHE", "SHY", "SIN", "SIP", "SIR", "SIS", "SIT", "SKI", "SKY",
+ "SLY", "SO", "SOB", "SOD", "SON", "SOP", "SOW", "SOY", "SPA", "SPY",
+ "SUB", "SUD", "SUE", "SUM", "SUN", "SUP", "TAB", "TAD", "TAG", "TAN",
+ "TAP", "TAR", "TEA", "TED", "TEE", "TEN", "THE", "THY", "TIC", "TIE",
+ "TIM", "TIN", "TIP", "TO", "TOE", "TOG", "TOM", "TON", "TOO", "TOP",
+ "TOW", "TOY", "TRY", "TUB", "TUG", "TUM", "TUN", "TWO", "UN", "UP",
+ "US", "USE", "VAN", "VAT", "VET", "VIE", "WAD", "WAG", "WAR", "WAS",
+ "WAY", "WE", "WEB", "WED", "WEE", "WET", "WHO", "WHY", "WIN", "WIT",
+ "WOK", "WON", "WOO", "WOW", "WRY", "WU", "YAM", "YAP", "YAW", "YE",
+ "YEA", "YES", "YET", "YOU", "ABED", "ABEL", "ABET", "ABLE", "ABUT",
+ "ACHE", "ACID", "ACME", "ACRE", "ACTA", "ACTS", "ADAM", "ADDS",
+ "ADEN", "AFAR", "AFRO", "AGEE", "AHEM", "AHOY", "AIDA", "AIDE",
+ "AIDS", "AIRY", "AJAR", "AKIN", "ALAN", "ALEC", "ALGA", "ALIA",
+ "ALLY", "ALMA", "ALOE", "ALSO", "ALTO", "ALUM", "ALVA", "AMEN",
+ "AMES", "AMID", "AMMO", "AMOK", "AMOS", "AMRA", "ANDY", "ANEW",
+ "ANNA", "ANNE", "ANTE", "ANTI", "AQUA", "ARAB", "ARCH", "AREA",
+ "ARGO", "ARID", "ARMY", "ARTS", "ARTY", "ASIA", "ASKS", "ATOM",
+ "AUNT", "AURA", "AUTO", "AVER", "AVID", "AVIS", "AVON", "AVOW",
+ "AWAY", "AWRY", "BABE", "BABY", "BACH", "BACK", "BADE", "BAIL",
+ "BAIT", "BAKE", "BALD", "BALE", "BALI", "BALK", "BALL", "BALM",
+ "BAND", "BANE", "BANG", "BANK", "BARB", "BARD", "BARE", "BARK",
+ "BARN", "BARR", "BASE", "BASH", "BASK", "BASS", "BATE", "BATH",
+ "BAWD", "BAWL", "BEAD", "BEAK", "BEAM", "BEAN", "BEAR", "BEAT",
+ "BEAU", "BECK", "BEEF", "BEEN", "BEER",
+ "BEET", "BELA", "BELL", "BELT", "BEND", "BENT", "BERG", "BERN",
+ "BERT", "BESS", "BEST", "BETA", "BETH", "BHOY", "BIAS", "BIDE",
+ "BIEN", "BILE", "BILK", "BILL", "BIND", "BING", "BIRD", "BITE",
+ "BITS", "BLAB", "BLAT", "BLED", "BLEW", "BLOB", "BLOC", "BLOT",
+ "BLOW", "BLUE", "BLUM", "BLUR", "BOAR", "BOAT", "BOCA", "BOCK",
+ "BODE", "BODY", "BOGY", "BOHR", "BOIL", "BOLD", "BOLO", "BOLT",
+ "BOMB", "BONA", "BOND", "BONE", "BONG", "BONN", "BONY", "BOOK",
+ "BOOM", "BOON", "BOOT", "BORE", "BORG", "BORN", "BOSE", "BOSS",
+ "BOTH", "BOUT", "BOWL", "BOYD", "BRAD", "BRAE", "BRAG", "BRAN",
+ "BRAY", "BRED", "BREW", "BRIG", "BRIM", "BROW", "BUCK", "BUDD",
+ "BUFF", "BULB", "BULK", "BULL", "BUNK", "BUNT", "BUOY", "BURG",
+ "BURL", "BURN", "BURR", "BURT", "BURY", "BUSH", "BUSS", "BUST",
+ "BUSY", "BYTE", "CADY", "CAFE", "CAGE", "CAIN", "CAKE", "CALF",
+ "CALL", "CALM", "CAME", "CANE", "CANT", "CARD", "CARE", "CARL",
+ "CARR", "CART", "CASE", "CASH", "CASK", "CAST", "CAVE", "CEIL",
+ "CELL", "CENT", "CERN", "CHAD", "CHAR", "CHAT", "CHAW", "CHEF",
+ "CHEN", "CHEW", "CHIC", "CHIN", "CHOU", "CHOW", "CHUB", "CHUG",
+ "CHUM", "CITE", "CITY", "CLAD", "CLAM", "CLAN", "CLAW", "CLAY",
+ "CLOD", "CLOG", "CLOT", "CLUB", "CLUE", "COAL", "COAT", "COCA",
+ "COCK", "COCO", "CODA", "CODE", "CODY", "COED", "COIL", "COIN",
+ "COKE", "COLA", "COLD", "COLT", "COMA", "COMB", "COME", "COOK",
+ "COOL", "COON", "COOT", "CORD", "CORE", "CORK", "CORN", "COST",
+ "COVE", "COWL", "CRAB", "CRAG", "CRAM", "CRAY", "CREW", "CRIB",
+ "CROW", "CRUD", "CUBA", "CUBE", "CUFF", "CULL", "CULT", "CUNY",
+ "CURB", "CURD", "CURE", "CURL", "CURT", "CUTS", "DADE", "DALE",
+ "DAME", "DANA", "DANE", "DANG", "DANK", "DARE", "DARK", "DARN",
+ "DART", "DASH", "DATA", "DATE", "DAVE", "DAVY", "DAWN", "DAYS",
+ "DEAD", "DEAF", "DEAL", "DEAN", "DEAR", "DEBT", "DECK", "DEED",
+ "DEEM", "DEER", "DEFT", "DEFY", "DELL", "DENT", "DENY", "DESK",
+ "DIAL", "DICE", "DIED", "DIET", "DIME", "DINE", "DING", "DINT",
+ "DIRE", "DIRT", "DISC", "DISH", "DISK", "DIVE", "DOCK", "DOES",
+ "DOLE", "DOLL", "DOLT", "DOME", "DONE", "DOOM", "DOOR", "DORA",
+ "DOSE", "DOTE", "DOUG", "DOUR", "DOVE", "DOWN", "DRAB", "DRAG",
+ "DRAM", "DRAW", "DREW", "DRUB", "DRUG", "DRUM", "DUAL", "DUCK",
+ "DUCT", "DUEL", "DUET", "DUKE", "DULL", "DUMB", "DUNE", "DUNK",
+ "DUSK", "DUST", "DUTY", "EACH", "EARL", "EARN", "EASE", "EAST",
+ "EASY", "EBEN", "ECHO", "EDDY", "EDEN", "EDGE", "EDGY", "EDIT",
+ "EDNA", "EGAN", "ELAN", "ELBA", "ELLA", "ELSE", "EMIL", "EMIT",
+ "EMMA", "ENDS", "ERIC", "EROS", "EVEN", "EVER", "EVIL", "EYED",
+ "FACE", "FACT", "FADE", "FAIL", "FAIN", "FAIR", "FAKE", "FALL",
+ "FAME", "FANG", "FARM", "FAST", "FATE", "FAWN", "FEAR", "FEAT",
+ "FEED", "FEEL", "FEET", "FELL", "FELT", "FEND", "FERN", "FEST",
+ "FEUD", "FIEF", "FIGS", "FILE", "FILL", "FILM", "FIND", "FINE",
+ "FINK", "FIRE", "FIRM", "FISH", "FISK", "FIST", "FITS", "FIVE",
+ "FLAG", "FLAK", "FLAM", "FLAT", "FLAW", "FLEA", "FLED", "FLEW",
+ "FLIT", "FLOC", "FLOG", "FLOW", "FLUB", "FLUE", "FOAL", "FOAM",
+ "FOGY", "FOIL", "FOLD", "FOLK", "FOND", "FONT", "FOOD", "FOOL",
+ "FOOT", "FORD", "FORE", "FORK", "FORM", "FORT", "FOSS", "FOUL",
+ "FOUR", "FOWL", "FRAU", "FRAY", "FRED", "FREE", "FRET", "FREY",
+ "FROG", "FROM", "FUEL", "FULL", "FUME", "FUND", "FUNK", "FURY",
+ "FUSE", "FUSS", "GAFF", "GAGE", "GAIL", "GAIN", "GAIT", "GALA",
+ "GALE", "GALL", "GALT", "GAME", "GANG", "GARB", "GARY", "GASH",
+ "GATE", "GAUL", "GAUR", "GAVE", "GAWK", "GEAR", "GELD", "GENE",
+ "GENT", "GERM", "GETS", "GIBE", "GIFT", "GILD", "GILL", "GILT",
+ "GINA", "GIRD", "GIRL", "GIST", "GIVE", "GLAD", "GLEE", "GLEN",
+ "GLIB", "GLOB", "GLOM", "GLOW", "GLUE", "GLUM", "GLUT", "GOAD",
+ "GOAL", "GOAT", "GOER", "GOES", "GOLD", "GOLF", "GONE", "GONG",
+ "GOOD", "GOOF", "GORE", "GORY", "GOSH", "GOUT", "GOWN", "GRAB",
+ "GRAD", "GRAY", "GREG", "GREW", "GREY", "GRID", "GRIM", "GRIN",
+ "GRIT", "GROW", "GRUB", "GULF", "GULL", "GUNK", "GURU", "GUSH",
+ "GUST", "GWEN", "GWYN", "HAAG", "HAAS", "HACK", "HAIL", "HAIR",
+ "HALE", "HALF", "HALL", "HALO", "HALT", "HAND", "HANG", "HANK",
+ "HANS", "HARD", "HARK", "HARM", "HART", "HASH", "HAST", "HATE",
+ "HATH", "HAUL", "HAVE", "HAWK", "HAYS", "HEAD", "HEAL", "HEAR",
+ "HEAT", "HEBE", "HECK", "HEED", "HEEL", "HEFT", "HELD", "HELL",
+ "HELM", "HERB", "HERD", "HERE", "HERO", "HERS", "HESS", "HEWN",
+ "HICK", "HIDE", "HIGH", "HIKE", "HILL", "HILT", "HIND", "HINT",
+ "HIRE", "HISS", "HIVE", "HOBO", "HOCK", "HOFF", "HOLD", "HOLE",
+ "HOLM", "HOLT", "HOME", "HONE", "HONK", "HOOD", "HOOF", "HOOK",
+ "HOOT", "HORN", "HOSE", "HOST", "HOUR", "HOVE", "HOWE", "HOWL",
+ "HOYT", "HUCK", "HUED", "HUFF", "HUGE", "HUGH", "HUGO", "HULK",
+ "HULL", "HUNK", "HUNT", "HURD", "HURL", "HURT", "HUSH", "HYDE",
+ "HYMN", "IBIS", "ICON", "IDEA", "IDLE", "IFFY", "INCA", "INCH",
+ "INTO", "IONS", "IOTA", "IOWA", "IRIS", "IRMA", "IRON", "ISLE",
+ "ITCH", "ITEM", "IVAN", "JACK", "JADE", "JAIL", "JAKE", "JANE",
+ "JAVA", "JEAN", "JEFF", "JERK", "JESS", "JEST", "JIBE", "JILL",
+ "JILT", "JIVE", "JOAN", "JOBS", "JOCK", "JOEL", "JOEY", "JOHN",
+ "JOIN", "JOKE", "JOLT", "JOVE", "JUDD", "JUDE", "JUDO", "JUDY",
+ "JUJU", "JUKE", "JULY", "JUNE", "JUNK", "JUNO", "JURY", "JUST",
+ "JUTE", "KAHN", "KALE", "KANE", "KANT", "KARL", "KATE", "KEEL",
+ "KEEN", "KENO", "KENT", "KERN", "KERR", "KEYS", "KICK", "KILL",
+ "KIND", "KING", "KIRK", "KISS", "KITE", "KLAN", "KNEE", "KNEW",
+ "KNIT", "KNOB", "KNOT", "KNOW", "KOCH", "KONG", "KUDO", "KURD",
+ "KURT", "KYLE", "LACE", "LACK", "LACY", "LADY", "LAID", "LAIN",
+ "LAIR", "LAKE", "LAMB", "LAME", "LAND", "LANE", "LANG", "LARD",
+ "LARK", "LASS", "LAST", "LATE", "LAUD", "LAVA", "LAWN", "LAWS",
+ "LAYS", "LEAD", "LEAF", "LEAK", "LEAN", "LEAR", "LEEK", "LEER",
+ "LEFT", "LEND", "LENS", "LENT", "LEON", "LESK", "LESS", "LEST",
+ "LETS", "LIAR", "LICE", "LICK", "LIED", "LIEN", "LIES", "LIEU",
+ "LIFE", "LIFT", "LIKE", "LILA", "LILT", "LILY", "LIMA", "LIMB",
+ "LIME", "LIND", "LINE", "LINK", "LINT", "LION", "LISA", "LIST",
+ "LIVE", "LOAD", "LOAF", "LOAM", "LOAN", "LOCK", "LOFT", "LOGE",
+ "LOIS", "LOLA", "LONE", "LONG", "LOOK", "LOON", "LOOT", "LORD",
+ "LORE", "LOSE", "LOSS", "LOST", "LOUD", "LOVE", "LOWE", "LUCK",
+ "LUCY", "LUGE", "LUKE", "LULU", "LUND", "LUNG", "LURA", "LURE",
+ "LURK", "LUSH", "LUST", "LYLE", "LYNN", "LYON", "LYRA", "MACE",
+ "MADE", "MAGI", "MAID", "MAIL", "MAIN", "MAKE", "MALE", "MALI",
+ "MALL", "MALT", "MANA", "MANN", "MANY", "MARC", "MARE", "MARK",
+ "MARS", "MART", "MARY", "MASH", "MASK", "MASS", "MAST", "MATE",
+ "MATH", "MAUL", "MAYO", "MEAD", "MEAL", "MEAN", "MEAT", "MEEK",
+ "MEET", "MELD", "MELT", "MEMO", "MEND", "MENU", "MERT", "MESH",
+ "MESS", "MICE", "MIKE", "MILD", "MILE", "MILK", "MILL", "MILT",
+ "MIMI", "MIND", "MINE", "MINI", "MINK", "MINT", "MIRE", "MISS",
+ "MIST", "MITE", "MITT", "MOAN", "MOAT", "MOCK", "MODE", "MOLD",
+ "MOLE", "MOLL", "MOLT", "MONA", "MONK", "MONT", "MOOD", "MOON",
+ "MOOR", "MOOT", "MORE", "MORN", "MORT", "MOSS", "MOST", "MOTH",
+ "MOVE", "MUCH", "MUCK", "MUDD", "MUFF", "MULE", "MULL", "MURK",
+ "MUSH", "MUST", "MUTE", "MUTT", "MYRA", "MYTH", "NAGY", "NAIL",
+ "NAIR", "NAME", "NARY", "NASH", "NAVE", "NAVY", "NEAL", "NEAR",
+ "NEAT", "NECK", "NEED", "NEIL", "NELL", "NEON", "NERO", "NESS",
+ "NEST", "NEWS", "NEWT", "NIBS", "NICE", "NICK", "NILE", "NINA",
+ "NINE", "NOAH", "NODE", "NOEL", "NOLL", "NONE", "NOOK", "NOON",
+ "NORM", "NOSE", "NOTE", "NOUN", "NOVA", "NUDE", "NULL", "NUMB",
+ "OATH", "OBEY", "OBOE", "ODIN", "OHIO", "OILY", "OINT", "OKAY",
+ "OLAF", "OLDY", "OLGA", "OLIN", "OMAN", "OMEN", "OMIT", "ONCE",
+ "ONES", "ONLY", "ONTO", "ONUS", "ORAL", "ORGY", "OSLO", "OTIS",
+ "OTTO", "OUCH", "OUST", "OUTS", "OVAL", "OVEN", "OVER", "OWLY",
+ "OWNS", "QUAD", "QUIT", "QUOD", "RACE", "RACK", "RACY", "RAFT",
+ "RAGE", "RAID", "RAIL", "RAIN", "RAKE", "RANK", "RANT", "RARE",
+ "RASH", "RATE", "RAVE", "RAYS", "READ", "REAL", "REAM", "REAR",
+ "RECK", "REED", "REEF", "REEK", "REEL", "REID", "REIN", "RENA",
+ "REND", "RENT", "REST", "RICE", "RICH", "RICK", "RIDE", "RIFT",
+ "RILL", "RIME", "RING", "RINK", "RISE", "RISK", "RITE", "ROAD",
+ "ROAM", "ROAR", "ROBE", "ROCK", "RODE", "ROIL", "ROLL", "ROME",
+ "ROOD", "ROOF", "ROOK", "ROOM", "ROOT", "ROSA", "ROSE", "ROSS",
+ "ROSY", "ROTH", "ROUT", "ROVE", "ROWE", "ROWS", "RUBE", "RUBY",
+ "RUDE", "RUDY", "RUIN", "RULE", "RUNG", "RUNS", "RUNT", "RUSE",
+ "RUSH", "RUSK", "RUSS", "RUST", "RUTH", "SACK", "SAFE", "SAGE",
+ "SAID", "SAIL", "SALE", "SALK", "SALT", "SAME", "SAND", "SANE",
+ "SANG", "SANK", "SARA", "SAUL", "SAVE", "SAYS", "SCAN", "SCAR",
+ "SCAT", "SCOT", "SEAL", "SEAM", "SEAR", "SEAT", "SEED", "SEEK",
+ "SEEM", "SEEN", "SEES", "SELF", "SELL", "SEND", "SENT", "SETS",
+ "SEWN", "SHAG", "SHAM", "SHAW", "SHAY", "SHED", "SHIM", "SHIN",
+ "SHOD", "SHOE", "SHOT", "SHOW", "SHUN", "SHUT", "SICK", "SIDE",
+ "SIFT", "SIGH", "SIGN", "SILK", "SILL", "SILO", "SILT", "SINE",
+ "SING", "SINK", "SIRE", "SITE", "SITS", "SITU", "SKAT", "SKEW",
+ "SKID", "SKIM", "SKIN", "SKIT", "SLAB", "SLAM", "SLAT", "SLAY",
+ "SLED", "SLEW", "SLID", "SLIM", "SLIT", "SLOB", "SLOG", "SLOT",
+ "SLOW", "SLUG", "SLUM", "SLUR", "SMOG", "SMUG", "SNAG", "SNOB",
+ "SNOW", "SNUB", "SNUG", "SOAK", "SOAR", "SOCK", "SODA", "SOFA",
+ "SOFT", "SOIL", "SOLD", "SOME", "SONG", "SOON", "SOOT", "SORE",
+ "SORT", "SOUL", "SOUR", "SOWN", "STAB", "STAG", "STAN", "STAR",
+ "STAY", "STEM", "STEW", "STIR", "STOW", "STUB", "STUN", "SUCH",
+ "SUDS", "SUIT", "SULK", "SUMS", "SUNG", "SUNK", "SURE", "SURF",
+ "SWAB", "SWAG", "SWAM", "SWAN", "SWAT", "SWAY", "SWIM", "SWUM",
+ "TACK", "TACT", "TAIL", "TAKE", "TALE", "TALK", "TALL", "TANK",
+ "TASK", "TATE", "TAUT", "TEAL", "TEAM", "TEAR", "TECH", "TEEM",
+ "TEEN", "TEET", "TELL", "TEND", "TENT", "TERM", "TERN", "TESS",
+ "TEST", "THAN", "THAT", "THEE", "THEM", "THEN", "THEY", "THIN",
+ "THIS", "THUD", "THUG", "TICK", "TIDE", "TIDY", "TIED", "TIER",
+ "TILE", "TILL", "TILT", "TIME", "TINA", "TINE", "TINT", "TINY",
+ "TIRE", "TOAD", "TOGO", "TOIL", "TOLD", "TOLL", "TONE", "TONG",
+ "TONY", "TOOK", "TOOL", "TOOT", "TORE", "TORN", "TOTE", "TOUR",
+ "TOUT", "TOWN", "TRAG", "TRAM", "TRAY", "TREE", "TREK", "TRIG",
+ "TRIM", "TRIO", "TROD", "TROT", "TROY", "TRUE", "TUBA", "TUBE",
+ "TUCK", "TUFT", "TUNA", "TUNE", "TUNG", "TURF", "TURN", "TUSK",
+ "TWIG", "TWIN", "TWIT", "ULAN", "UNIT", "URGE", "USED", "USER",
+ "USES", "UTAH", "VAIL", "VAIN", "VALE", "VARY", "VASE", "VAST",
+ "VEAL", "VEDA", "VEIL", "VEIN", "VEND", "VENT", "VERB", "VERY",
+ "VETO", "VICE", "VIEW", "VINE", "VISE", "VOID", "VOLT", "VOTE",
+ "WACK", "WADE", "WAGE", "WAIL", "WAIT", "WAKE", "WALE", "WALK",
+ "WALL", "WALT", "WAND", "WANE", "WANG", "WANT", "WARD", "WARM",
+ "WARN", "WART", "WASH", "WAST", "WATS", "WATT", "WAVE", "WAVY",
+ "WAYS", "WEAK", "WEAL", "WEAN", "WEAR", "WEED", "WEEK", "WEIR",
+ "WELD", "WELL", "WELT", "WENT", "WERE", "WERT", "WEST", "WHAM",
+ "WHAT", "WHEE", "WHEN", "WHET", "WHOA", "WHOM", "WICK", "WIFE",
+ "WILD", "WILL", "WIND", "WINE", "WING", "WINK", "WINO", "WIRE",
+ "WISE", "WISH", "WITH", "WOLF", "WONT", "WOOD", "WOOL", "WORD",
+ "WORE", "WORK", "WORM", "WORN", "WOVE", "WRIT", "WYNN", "YALE",
+ "YANG", "YANK", "YARD", "YARN", "YAWL", "YAWN", "YEAH", "YEAR",
+ "YELL", "YOGA", "YOKE" ]
+
+if __name__=='__main__':
+ data = [('EB33F77EE73D4053', 'TIDE ITCH SLOW REIN RULE MOT'),
+ ('CCAC2AED591056BE4F90FD441C534766',
+ 'RASH BUSH MILK LOOK BAD BRIM AVID GAFF BAIT ROT POD LOVE'),
+ ('EFF81F9BFBC65350920CDD7416DE8009',
+ 'TROD MUTE TAIL WARM CHAR KONG HAAG CITY BORE O TEAL AWL')
+ ]
+
+ for key, words in data:
+ print 'Trying key', key
+ key=binascii.a2b_hex(key)
+ w2=key_to_english(key)
+ if w2!=words:
+ print 'key_to_english fails on key', repr(key), ', producing', str(w2)
+ k2=english_to_key(words)
+ if k2!=key:
+ print 'english_to_key fails on key', repr(key), ', producing', repr(k2)
+
+
diff --git a/src/gdata/Crypto/Util/__init__.py b/src/gdata/Crypto/Util/__init__.py
new file mode 100755
index 0000000..0d14768
--- /dev/null
+++ b/src/gdata/Crypto/Util/__init__.py
@@ -0,0 +1,16 @@
+"""Miscellaneous modules
+
+Contains useful modules that don't belong into any of the
+other Crypto.* subpackages.
+
+Crypto.Util.number Number-theoretic functions (primality testing, etc.)
+Crypto.Util.randpool Random number generation
+Crypto.Util.RFC1751 Converts between 128-bit keys and human-readable
+ strings of words.
+
+"""
+
+__all__ = ['randpool', 'RFC1751', 'number']
+
+__revision__ = "$Id: __init__.py,v 1.4 2003/02/28 15:26:00 akuchling Exp $"
+
diff --git a/src/gdata/Crypto/Util/number.py b/src/gdata/Crypto/Util/number.py
new file mode 100755
index 0000000..9d50563
--- /dev/null
+++ b/src/gdata/Crypto/Util/number.py
@@ -0,0 +1,201 @@
+#
+# number.py : Number-theoretic functions
+#
+# Part of the Python Cryptography Toolkit
+#
+# Distribute and use freely; there are no restrictions on further
+# dissemination and usage except those imposed by the laws of your
+# country of residence. This software is provided "as is" without
+# warranty of fitness for use or suitability for any purpose, express
+# or implied. Use at your own risk or not at all.
+#
+
+__revision__ = "$Id: number.py,v 1.13 2003/04/04 18:21:07 akuchling Exp $"
+
+bignum = long
+try:
+ from Crypto.PublicKey import _fastmath
+except ImportError:
+ _fastmath = None
+
+# Commented out and replaced with faster versions below
+## def long2str(n):
+## s=''
+## while n>0:
+## s=chr(n & 255)+s
+## n=n>>8
+## return s
+
+## import types
+## def str2long(s):
+## if type(s)!=types.StringType: return s # Integers will be left alone
+## return reduce(lambda x,y : x*256+ord(y), s, 0L)
+
+def size (N):
+ """size(N:long) : int
+ Returns the size of the number N in bits.
+ """
+ bits, power = 0,1L
+ while N >= power:
+ bits += 1
+ power = power << 1
+ return bits
+
+def getRandomNumber(N, randfunc):
+ """getRandomNumber(N:int, randfunc:callable):long
+ Return an N-bit random number."""
+
+ S = randfunc(N/8)
+ odd_bits = N % 8
+ if odd_bits != 0:
+ char = ord(randfunc(1)) >> (8-odd_bits)
+ S = chr(char) + S
+ value = bytes_to_long(S)
+ value |= 2L ** (N-1) # Ensure high bit is set
+ assert size(value) >= N
+ return value
+
+def GCD(x,y):
+ """GCD(x:long, y:long): long
+ Return the GCD of x and y.
+ """
+ x = abs(x) ; y = abs(y)
+ while x > 0:
+ x, y = y % x, x
+ return y
+
+def inverse(u, v):
+ """inverse(u:long, u:long):long
+ Return the inverse of u mod v.
+ """
+ u3, v3 = long(u), long(v)
+ u1, v1 = 1L, 0L
+ while v3 > 0:
+ q=u3 / v3
+ u1, v1 = v1, u1 - v1*q
+ u3, v3 = v3, u3 - v3*q
+ while u1<0:
+ u1 = u1 + v
+ return u1
+
+# Given a number of bits to generate and a random generation function,
+# find a prime number of the appropriate size.
+
+def getPrime(N, randfunc):
+ """getPrime(N:int, randfunc:callable):long
+ Return a random N-bit prime number.
+ """
+
+ number=getRandomNumber(N, randfunc) | 1
+ while (not isPrime(number)):
+ number=number+2
+ return number
+
+def isPrime(N):
+ """isPrime(N:long):bool
+ Return true if N is prime.
+ """
+ if N == 1:
+ return 0
+ if N in sieve:
+ return 1
+ for i in sieve:
+ if (N % i)==0:
+ return 0
+
+ # Use the accelerator if available
+ if _fastmath is not None:
+ return _fastmath.isPrime(N)
+
+ # Compute the highest bit that's set in N
+ N1 = N - 1L
+ n = 1L
+ while (n<N):
+ n=n<<1L
+ n = n >> 1L
+
+ # Rabin-Miller test
+ for c in sieve[:7]:
+ a=long(c) ; d=1L ; t=n
+ while (t): # Iterate over the bits in N1
+ x=(d*d) % N
+ if x==1L and d!=1L and d!=N1:
+ return 0 # Square root of 1 found
+ if N1 & t:
+ d=(x*a) % N
+ else:
+ d=x
+ t = t >> 1L
+ if d!=1L:
+ return 0
+ return 1
+
+# Small primes used for checking primality; these are all the primes
+# less than 256. This should be enough to eliminate most of the odd
+# numbers before needing to do a Rabin-Miller test at all.
+
+sieve=[2, 3, 5, 7, 11, 13, 17, 19, 23, 29, 31, 37, 41, 43, 47, 53, 59,
+ 61, 67, 71, 73, 79, 83, 89, 97, 101, 103, 107, 109, 113, 127,
+ 131, 137, 139, 149, 151, 157, 163, 167, 173, 179, 181, 191, 193,
+ 197, 199, 211, 223, 227, 229, 233, 239, 241, 251]
+
+# Improved conversion functions contributed by Barry Warsaw, after
+# careful benchmarking
+
+import struct
+
+def long_to_bytes(n, blocksize=0):
+ """long_to_bytes(n:long, blocksize:int) : string
+ Convert a long integer to a byte string.
+
+ If optional blocksize is given and greater than zero, pad the front of the
+ byte string with binary zeros so that the length is a multiple of
+ blocksize.
+ """
+ # after much testing, this algorithm was deemed to be the fastest
+ s = ''
+ n = long(n)
+ pack = struct.pack
+ while n > 0:
+ s = pack('>I', n & 0xffffffffL) + s
+ n = n >> 32
+ # strip off leading zeros
+ for i in range(len(s)):
+ if s[i] != '\000':
+ break
+ else:
+ # only happens when n == 0
+ s = '\000'
+ i = 0
+ s = s[i:]
+ # add back some pad bytes. this could be done more efficiently w.r.t. the
+ # de-padding being done above, but sigh...
+ if blocksize > 0 and len(s) % blocksize:
+ s = (blocksize - len(s) % blocksize) * '\000' + s
+ return s
+
+def bytes_to_long(s):
+ """bytes_to_long(string) : long
+ Convert a byte string to a long integer.
+
+ This is (essentially) the inverse of long_to_bytes().
+ """
+ acc = 0L
+ unpack = struct.unpack
+ length = len(s)
+ if length % 4:
+ extra = (4 - length % 4)
+ s = '\000' * extra + s
+ length = length + extra
+ for i in range(0, length, 4):
+ acc = (acc << 32) + unpack('>I', s[i:i+4])[0]
+ return acc
+
+# For backwards compatibility...
+import warnings
+def long2str(n, blocksize=0):
+ warnings.warn("long2str() has been replaced by long_to_bytes()")
+ return long_to_bytes(n, blocksize)
+def str2long(s):
+ warnings.warn("str2long() has been replaced by bytes_to_long()")
+ return bytes_to_long(s)
diff --git a/src/gdata/Crypto/Util/randpool.py b/src/gdata/Crypto/Util/randpool.py
new file mode 100755
index 0000000..467501c
--- /dev/null
+++ b/src/gdata/Crypto/Util/randpool.py
@@ -0,0 +1,421 @@
+#
+# randpool.py : Cryptographically strong random number generation
+#
+# Part of the Python Cryptography Toolkit
+#
+# Distribute and use freely; there are no restrictions on further
+# dissemination and usage except those imposed by the laws of your
+# country of residence. This software is provided "as is" without
+# warranty of fitness for use or suitability for any purpose, express
+# or implied. Use at your own risk or not at all.
+#
+
+__revision__ = "$Id: randpool.py,v 1.14 2004/05/06 12:56:54 akuchling Exp $"
+
+import time, array, types, warnings, os.path
+from Crypto.Util.number import long_to_bytes
+try:
+ import Crypto.Util.winrandom as winrandom
+except:
+ winrandom = None
+
+STIRNUM = 3
+
+class RandomPool:
+ """randpool.py : Cryptographically strong random number generation.
+
+ The implementation here is similar to the one in PGP. To be
+ cryptographically strong, it must be difficult to determine the RNG's
+ output, whether in the future or the past. This is done by using
+ a cryptographic hash function to "stir" the random data.
+
+ Entropy is gathered in the same fashion as PGP; the highest-resolution
+ clock around is read and the data is added to the random number pool.
+ A conservative estimate of the entropy is then kept.
+
+ If a cryptographically secure random source is available (/dev/urandom
+ on many Unixes, Windows CryptGenRandom on most Windows), then use
+ it.
+
+ Instance Attributes:
+ bits : int
+ Maximum size of pool in bits
+ bytes : int
+ Maximum size of pool in bytes
+ entropy : int
+ Number of bits of entropy in this pool.
+
+ Methods:
+ add_event([s]) : add some entropy to the pool
+ get_bytes(int) : get N bytes of random data
+ randomize([N]) : get N bytes of randomness from external source
+ """
+
+
+ def __init__(self, numbytes = 160, cipher=None, hash=None):
+ if hash is None:
+ from Crypto.Hash import SHA as hash
+
+ # The cipher argument is vestigial; it was removed from
+ # version 1.1 so RandomPool would work even in the limited
+ # exportable subset of the code
+ if cipher is not None:
+ warnings.warn("'cipher' parameter is no longer used")
+
+ if isinstance(hash, types.StringType):
+ # ugly hack to force __import__ to give us the end-path module
+ hash = __import__('Crypto.Hash.'+hash,
+ None, None, ['new'])
+ warnings.warn("'hash' parameter should now be a hashing module")
+
+ self.bytes = numbytes
+ self.bits = self.bytes*8
+ self.entropy = 0
+ self._hash = hash
+
+ # Construct an array to hold the random pool,
+ # initializing it to 0.
+ self._randpool = array.array('B', [0]*self.bytes)
+
+ self._event1 = self._event2 = 0
+ self._addPos = 0
+ self._getPos = hash.digest_size
+ self._lastcounter=time.time()
+ self.__counter = 0
+
+ self._measureTickSize() # Estimate timer resolution
+ self._randomize()
+
+ def _updateEntropyEstimate(self, nbits):
+ self.entropy += nbits
+ if self.entropy < 0:
+ self.entropy = 0
+ elif self.entropy > self.bits:
+ self.entropy = self.bits
+
+ def _randomize(self, N = 0, devname = '/dev/urandom'):
+ """_randomize(N, DEVNAME:device-filepath)
+ collects N bits of randomness from some entropy source (e.g.,
+ /dev/urandom on Unixes that have it, Windows CryptoAPI
+ CryptGenRandom, etc)
+ DEVNAME is optional, defaults to /dev/urandom. You can change it
+ to /dev/random if you want to block till you get enough
+ entropy.
+ """
+ data = ''
+ if N <= 0:
+ nbytes = int((self.bits - self.entropy)/8+0.5)
+ else:
+ nbytes = int(N/8+0.5)
+ if winrandom:
+ # Windows CryptGenRandom provides random data.
+ data = winrandom.new().get_bytes(nbytes)
+ elif os.path.exists(devname):
+ # Many OSes support a /dev/urandom device
+ try:
+ f=open(devname)
+ data=f.read(nbytes)
+ f.close()
+ except IOError, (num, msg):
+ if num!=2: raise IOError, (num, msg)
+ # If the file wasn't found, ignore the error
+ if data:
+ self._addBytes(data)
+ # Entropy estimate: The number of bits of
+ # data obtained from the random source.
+ self._updateEntropyEstimate(8*len(data))
+ self.stir_n() # Wash the random pool
+
+ def randomize(self, N=0):
+ """randomize(N:int)
+ use the class entropy source to get some entropy data.
+ This is overridden by KeyboardRandomize().
+ """
+ return self._randomize(N)
+
+ def stir_n(self, N = STIRNUM):
+ """stir_n(N)
+ stirs the random pool N times
+ """
+ for i in xrange(N):
+ self.stir()
+
+ def stir (self, s = ''):
+ """stir(s:string)
+ Mix up the randomness pool. This will call add_event() twice,
+ but out of paranoia the entropy attribute will not be
+ increased. The optional 's' parameter is a string that will
+ be hashed with the randomness pool.
+ """
+
+ entropy=self.entropy # Save inital entropy value
+ self.add_event()
+
+ # Loop over the randomness pool: hash its contents
+ # along with a counter, and add the resulting digest
+ # back into the pool.
+ for i in range(self.bytes / self._hash.digest_size):
+ h = self._hash.new(self._randpool)
+ h.update(str(self.__counter) + str(i) + str(self._addPos) + s)
+ self._addBytes( h.digest() )
+ self.__counter = (self.__counter + 1) & 0xFFFFffffL
+
+ self._addPos, self._getPos = 0, self._hash.digest_size
+ self.add_event()
+
+ # Restore the old value of the entropy.
+ self.entropy=entropy
+
+
+ def get_bytes (self, N):
+ """get_bytes(N:int) : string
+ Return N bytes of random data.
+ """
+
+ s=''
+ i, pool = self._getPos, self._randpool
+ h=self._hash.new()
+ dsize = self._hash.digest_size
+ num = N
+ while num > 0:
+ h.update( self._randpool[i:i+dsize] )
+ s = s + h.digest()
+ num = num - dsize
+ i = (i + dsize) % self.bytes
+ if i<dsize:
+ self.stir()
+ i=self._getPos
+
+ self._getPos = i
+ self._updateEntropyEstimate(- 8*N)
+ return s[:N]
+
+
+ def add_event(self, s=''):
+ """add_event(s:string)
+ Add an event to the random pool. The current time is stored
+ between calls and used to estimate the entropy. The optional
+ 's' parameter is a string that will also be XORed into the pool.
+ Returns the estimated number of additional bits of entropy gain.
+ """
+ event = time.time()*1000
+ delta = self._noise()
+ s = (s + long_to_bytes(event) +
+ 4*chr(0xaa) + long_to_bytes(delta) )
+ self._addBytes(s)
+ if event==self._event1 and event==self._event2:
+ # If events are coming too closely together, assume there's
+ # no effective entropy being added.
+ bits=0
+ else:
+ # Count the number of bits in delta, and assume that's the entropy.
+ bits=0
+ while delta:
+ delta, bits = delta>>1, bits+1
+ if bits>8: bits=8
+
+ self._event1, self._event2 = event, self._event1
+
+ self._updateEntropyEstimate(bits)
+ return bits
+
+ # Private functions
+ def _noise(self):
+ # Adds a bit of noise to the random pool, by adding in the
+ # current time and CPU usage of this process.
+ # The difference from the previous call to _noise() is taken
+ # in an effort to estimate the entropy.
+ t=time.time()
+ delta = (t - self._lastcounter)/self._ticksize*1e6
+ self._lastcounter = t
+ self._addBytes(long_to_bytes(long(1000*time.time())))
+ self._addBytes(long_to_bytes(long(1000*time.clock())))
+ self._addBytes(long_to_bytes(long(1000*time.time())))
+ self._addBytes(long_to_bytes(long(delta)))
+
+ # Reduce delta to a maximum of 8 bits so we don't add too much
+ # entropy as a result of this call.
+ delta=delta % 0xff
+ return int(delta)
+
+
+ def _measureTickSize(self):
+ # _measureTickSize() tries to estimate a rough average of the
+ # resolution of time that you can see from Python. It does
+ # this by measuring the time 100 times, computing the delay
+ # between measurements, and taking the median of the resulting
+ # list. (We also hash all the times and add them to the pool)
+ interval = [None] * 100
+ h = self._hash.new(`(id(self),id(interval))`)
+
+ # Compute 100 differences
+ t=time.time()
+ h.update(`t`)
+ i = 0
+ j = 0
+ while i < 100:
+ t2=time.time()
+ h.update(`(i,j,t2)`)
+ j += 1
+ delta=int((t2-t)*1e6)
+ if delta:
+ interval[i] = delta
+ i += 1
+ t=t2
+
+ # Take the median of the array of intervals
+ interval.sort()
+ self._ticksize=interval[len(interval)/2]
+ h.update(`(interval,self._ticksize)`)
+ # mix in the measurement times and wash the random pool
+ self.stir(h.digest())
+
+ def _addBytes(self, s):
+ "XOR the contents of the string S into the random pool"
+ i, pool = self._addPos, self._randpool
+ for j in range(0, len(s)):
+ pool[i]=pool[i] ^ ord(s[j])
+ i=(i+1) % self.bytes
+ self._addPos = i
+
+ # Deprecated method names: remove in PCT 2.1 or later.
+ def getBytes(self, N):
+ warnings.warn("getBytes() method replaced by get_bytes()",
+ DeprecationWarning)
+ return self.get_bytes(N)
+
+ def addEvent (self, event, s=""):
+ warnings.warn("addEvent() method replaced by add_event()",
+ DeprecationWarning)
+ return self.add_event(s + str(event))
+
+class PersistentRandomPool (RandomPool):
+ def __init__ (self, filename=None, *args, **kwargs):
+ RandomPool.__init__(self, *args, **kwargs)
+ self.filename = filename
+ if filename:
+ try:
+ # the time taken to open and read the file might have
+ # a little disk variability, modulo disk/kernel caching...
+ f=open(filename, 'rb')
+ self.add_event()
+ data = f.read()
+ self.add_event()
+ # mix in the data from the file and wash the random pool
+ self.stir(data)
+ f.close()
+ except IOError:
+ # Oh, well; the file doesn't exist or is unreadable, so
+ # we'll just ignore it.
+ pass
+
+ def save(self):
+ if self.filename == "":
+ raise ValueError, "No filename set for this object"
+ # wash the random pool before save, provides some forward secrecy for
+ # old values of the pool.
+ self.stir_n()
+ f=open(self.filename, 'wb')
+ self.add_event()
+ f.write(self._randpool.tostring())
+ f.close()
+ self.add_event()
+ # wash the pool again, provide some protection for future values
+ self.stir()
+
+# non-echoing Windows keyboard entry
+_kb = 0
+if not _kb:
+ try:
+ import msvcrt
+ class KeyboardEntry:
+ def getch(self):
+ c = msvcrt.getch()
+ if c in ('\000', '\xe0'):
+ # function key
+ c += msvcrt.getch()
+ return c
+ def close(self, delay = 0):
+ if delay:
+ time.sleep(delay)
+ while msvcrt.kbhit():
+ msvcrt.getch()
+ _kb = 1
+ except:
+ pass
+
+# non-echoing Posix keyboard entry
+if not _kb:
+ try:
+ import termios
+ class KeyboardEntry:
+ def __init__(self, fd = 0):
+ self._fd = fd
+ self._old = termios.tcgetattr(fd)
+ new = termios.tcgetattr(fd)
+ new[3]=new[3] & ~termios.ICANON & ~termios.ECHO
+ termios.tcsetattr(fd, termios.TCSANOW, new)
+ def getch(self):
+ termios.tcflush(0, termios.TCIFLUSH) # XXX Leave this in?
+ return os.read(self._fd, 1)
+ def close(self, delay = 0):
+ if delay:
+ time.sleep(delay)
+ termios.tcflush(self._fd, termios.TCIFLUSH)
+ termios.tcsetattr(self._fd, termios.TCSAFLUSH, self._old)
+ _kb = 1
+ except:
+ pass
+
+class KeyboardRandomPool (PersistentRandomPool):
+ def __init__(self, *args, **kwargs):
+ PersistentRandomPool.__init__(self, *args, **kwargs)
+
+ def randomize(self, N = 0):
+ "Adds N bits of entropy to random pool. If N is 0, fill up pool."
+ import os, string, time
+ if N <= 0:
+ bits = self.bits - self.entropy
+ else:
+ bits = N*8
+ if bits == 0:
+ return
+ print bits,'bits of entropy are now required. Please type on the keyboard'
+ print 'until enough randomness has been accumulated.'
+ kb = KeyboardEntry()
+ s='' # We'll save the characters typed and add them to the pool.
+ hash = self._hash
+ e = 0
+ try:
+ while e < bits:
+ temp=str(bits-e).rjust(6)
+ os.write(1, temp)
+ s=s+kb.getch()
+ e += self.add_event(s)
+ os.write(1, 6*chr(8))
+ self.add_event(s+hash.new(s).digest() )
+ finally:
+ kb.close()
+ print '\n\007 Enough. Please wait a moment.\n'
+ self.stir_n() # wash the random pool.
+ kb.close(4)
+
+if __name__ == '__main__':
+ pool = RandomPool()
+ print 'random pool entropy', pool.entropy, 'bits'
+ pool.add_event('something')
+ print `pool.get_bytes(100)`
+ import tempfile, os
+ fname = tempfile.mktemp()
+ pool = KeyboardRandomPool(filename=fname)
+ print 'keyboard random pool entropy', pool.entropy, 'bits'
+ pool.randomize()
+ print 'keyboard random pool entropy', pool.entropy, 'bits'
+ pool.randomize(128)
+ pool.save()
+ saved = open(fname, 'rb').read()
+ print 'saved', `saved`
+ print 'pool ', `pool._randpool.tostring()`
+ newpool = PersistentRandomPool(fname)
+ print 'persistent random pool entropy', pool.entropy, 'bits'
+ os.remove(fname)
diff --git a/src/gdata/Crypto/Util/test.py b/src/gdata/Crypto/Util/test.py
new file mode 100755
index 0000000..7b23e9f
--- /dev/null
+++ b/src/gdata/Crypto/Util/test.py
@@ -0,0 +1,453 @@
+#
+# test.py : Functions used for testing the modules
+#
+# Part of the Python Cryptography Toolkit
+#
+# Distribute and use freely; there are no restrictions on further
+# dissemination and usage except those imposed by the laws of your
+# country of residence. This software is provided "as is" without
+# warranty of fitness for use or suitability for any purpose, express
+# or implied. Use at your own risk or not at all.
+#
+
+__revision__ = "$Id: test.py,v 1.16 2004/08/13 22:24:18 akuchling Exp $"
+
+import binascii
+import string
+import testdata
+
+from Crypto.Cipher import *
+
+def die(string):
+ import sys
+ print '***ERROR: ', string
+# sys.exit(0) # Will default to continuing onward...
+
+def print_timing (size, delta, verbose):
+ if verbose:
+ if delta == 0:
+ print 'Unable to measure time -- elapsed time too small'
+ else:
+ print '%.2f K/sec' % (size/delta)
+
+def exerciseBlockCipher(cipher, verbose):
+ import string, time
+ try:
+ ciph = eval(cipher)
+ except NameError:
+ print cipher, 'module not available'
+ return None
+ print cipher+ ':'
+ str='1' # Build 128K of test data
+ for i in xrange(0, 17):
+ str=str+str
+ if ciph.key_size==0: ciph.key_size=16
+ password = 'password12345678Extra text for password'[0:ciph.key_size]
+ IV = 'Test IV Test IV Test IV Test'[0:ciph.block_size]
+
+ if verbose: print ' ECB mode:',
+ obj=ciph.new(password, ciph.MODE_ECB)
+ if obj.block_size != ciph.block_size:
+ die("Module and cipher object block_size don't match")
+
+ text='1234567812345678'[0:ciph.block_size]
+ c=obj.encrypt(text)
+ if (obj.decrypt(c)!=text): die('Error encrypting "'+text+'"')
+ text='KuchlingKuchling'[0:ciph.block_size]
+ c=obj.encrypt(text)
+ if (obj.decrypt(c)!=text): die('Error encrypting "'+text+'"')
+ text='NotTodayNotEver!'[0:ciph.block_size]
+ c=obj.encrypt(text)
+ if (obj.decrypt(c)!=text): die('Error encrypting "'+text+'"')
+
+ start=time.time()
+ s=obj.encrypt(str)
+ s2=obj.decrypt(s)
+ end=time.time()
+ if (str!=s2):
+ die('Error in resulting plaintext from ECB mode')
+ print_timing(256, end-start, verbose)
+ del obj
+
+ if verbose: print ' CFB mode:',
+ obj1=ciph.new(password, ciph.MODE_CFB, IV)
+ obj2=ciph.new(password, ciph.MODE_CFB, IV)
+ start=time.time()
+ ciphertext=obj1.encrypt(str[0:65536])
+ plaintext=obj2.decrypt(ciphertext)
+ end=time.time()
+ if (plaintext!=str[0:65536]):
+ die('Error in resulting plaintext from CFB mode')
+ print_timing(64, end-start, verbose)
+ del obj1, obj2
+
+ if verbose: print ' CBC mode:',
+ obj1=ciph.new(password, ciph.MODE_CBC, IV)
+ obj2=ciph.new(password, ciph.MODE_CBC, IV)
+ start=time.time()
+ ciphertext=obj1.encrypt(str)
+ plaintext=obj2.decrypt(ciphertext)
+ end=time.time()
+ if (plaintext!=str):
+ die('Error in resulting plaintext from CBC mode')
+ print_timing(256, end-start, verbose)
+ del obj1, obj2
+
+ if verbose: print ' PGP mode:',
+ obj1=ciph.new(password, ciph.MODE_PGP, IV)
+ obj2=ciph.new(password, ciph.MODE_PGP, IV)
+ start=time.time()
+ ciphertext=obj1.encrypt(str)
+ plaintext=obj2.decrypt(ciphertext)
+ end=time.time()
+ if (plaintext!=str):
+ die('Error in resulting plaintext from PGP mode')
+ print_timing(256, end-start, verbose)
+ del obj1, obj2
+
+ if verbose: print ' OFB mode:',
+ obj1=ciph.new(password, ciph.MODE_OFB, IV)
+ obj2=ciph.new(password, ciph.MODE_OFB, IV)
+ start=time.time()
+ ciphertext=obj1.encrypt(str)
+ plaintext=obj2.decrypt(ciphertext)
+ end=time.time()
+ if (plaintext!=str):
+ die('Error in resulting plaintext from OFB mode')
+ print_timing(256, end-start, verbose)
+ del obj1, obj2
+
+ def counter(length=ciph.block_size):
+ return length * 'a'
+
+ if verbose: print ' CTR mode:',
+ obj1=ciph.new(password, ciph.MODE_CTR, counter=counter)
+ obj2=ciph.new(password, ciph.MODE_CTR, counter=counter)
+ start=time.time()
+ ciphertext=obj1.encrypt(str)
+ plaintext=obj2.decrypt(ciphertext)
+ end=time.time()
+ if (plaintext!=str):
+ die('Error in resulting plaintext from CTR mode')
+ print_timing(256, end-start, verbose)
+ del obj1, obj2
+
+ # Test the IV handling
+ if verbose: print ' Testing IV handling'
+ obj1=ciph.new(password, ciph.MODE_CBC, IV)
+ plaintext='Test'*(ciph.block_size/4)*3
+ ciphertext1=obj1.encrypt(plaintext)
+ obj1.IV=IV
+ ciphertext2=obj1.encrypt(plaintext)
+ if ciphertext1!=ciphertext2:
+ die('Error in setting IV')
+
+ # Test keyword arguments
+ obj1=ciph.new(key=password)
+ obj1=ciph.new(password, mode=ciph.MODE_CBC)
+ obj1=ciph.new(mode=ciph.MODE_CBC, key=password)
+ obj1=ciph.new(IV=IV, mode=ciph.MODE_CBC, key=password)
+
+ return ciph
+
+def exerciseStreamCipher(cipher, verbose):
+ import string, time
+ try:
+ ciph = eval(cipher)
+ except (NameError):
+ print cipher, 'module not available'
+ return None
+ print cipher + ':',
+ str='1' # Build 128K of test data
+ for i in xrange(0, 17):
+ str=str+str
+ key_size = ciph.key_size or 16
+ password = 'password12345678Extra text for password'[0:key_size]
+
+ obj1=ciph.new(password)
+ obj2=ciph.new(password)
+ if obj1.block_size != ciph.block_size:
+ die("Module and cipher object block_size don't match")
+ if obj1.key_size != ciph.key_size:
+ die("Module and cipher object key_size don't match")
+
+ text='1234567812345678Python'
+ c=obj1.encrypt(text)
+ if (obj2.decrypt(c)!=text): die('Error encrypting "'+text+'"')
+ text='B1FF I2 A R3A11Y |<00L D00D!!!!!'
+ c=obj1.encrypt(text)
+ if (obj2.decrypt(c)!=text): die('Error encrypting "'+text+'"')
+ text='SpamSpamSpamSpamSpamSpamSpamSpamSpam'
+ c=obj1.encrypt(text)
+ if (obj2.decrypt(c)!=text): die('Error encrypting "'+text+'"')
+
+ start=time.time()
+ s=obj1.encrypt(str)
+ str=obj2.decrypt(s)
+ end=time.time()
+ print_timing(256, end-start, verbose)
+ del obj1, obj2
+
+ return ciph
+
+def TestStreamModules(args=['arc4', 'XOR'], verbose=1):
+ import sys, string
+ args=map(string.lower, args)
+
+ if 'arc4' in args:
+ # Test ARC4 stream cipher
+ arc4=exerciseStreamCipher('ARC4', verbose)
+ if (arc4!=None):
+ for entry in testdata.arc4:
+ key,plain,cipher=entry
+ key=binascii.a2b_hex(key)
+ plain=binascii.a2b_hex(plain)
+ cipher=binascii.a2b_hex(cipher)
+ obj=arc4.new(key)
+ ciphertext=obj.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('ARC4 failed on entry '+`entry`)
+
+ if 'xor' in args:
+ # Test XOR stream cipher
+ XOR=exerciseStreamCipher('XOR', verbose)
+ if (XOR!=None):
+ for entry in testdata.xor:
+ key,plain,cipher=entry
+ key=binascii.a2b_hex(key)
+ plain=binascii.a2b_hex(plain)
+ cipher=binascii.a2b_hex(cipher)
+ obj=XOR.new(key)
+ ciphertext=obj.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('XOR failed on entry '+`entry`)
+
+
+def TestBlockModules(args=['aes', 'arc2', 'des', 'blowfish', 'cast', 'des3',
+ 'idea', 'rc5'],
+ verbose=1):
+ import string
+ args=map(string.lower, args)
+ if 'aes' in args:
+ ciph=exerciseBlockCipher('AES', verbose) # AES
+ if (ciph!=None):
+ if verbose: print ' Verifying against test suite...'
+ for entry in testdata.aes:
+ key,plain,cipher=entry
+ key=binascii.a2b_hex(key)
+ plain=binascii.a2b_hex(plain)
+ cipher=binascii.a2b_hex(cipher)
+ obj=ciph.new(key, ciph.MODE_ECB)
+ ciphertext=obj.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('AES failed on entry '+`entry`)
+ for i in ciphertext:
+ if verbose: print hex(ord(i)),
+ if verbose: print
+
+ for entry in testdata.aes_modes:
+ mode, key, plain, cipher, kw = entry
+ key=binascii.a2b_hex(key)
+ plain=binascii.a2b_hex(plain)
+ cipher=binascii.a2b_hex(cipher)
+ obj=ciph.new(key, mode, **kw)
+ obj2=ciph.new(key, mode, **kw)
+ ciphertext=obj.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('AES encrypt failed on entry '+`entry`)
+ for i in ciphertext:
+ if verbose: print hex(ord(i)),
+ if verbose: print
+
+ plain2=obj2.decrypt(ciphertext)
+ if plain2!=plain:
+ die('AES decrypt failed on entry '+`entry`)
+ for i in plain2:
+ if verbose: print hex(ord(i)),
+ if verbose: print
+
+
+ if 'arc2' in args:
+ ciph=exerciseBlockCipher('ARC2', verbose) # Alleged RC2
+ if (ciph!=None):
+ if verbose: print ' Verifying against test suite...'
+ for entry in testdata.arc2:
+ key,plain,cipher=entry
+ key=binascii.a2b_hex(key)
+ plain=binascii.a2b_hex(plain)
+ cipher=binascii.a2b_hex(cipher)
+ obj=ciph.new(key, ciph.MODE_ECB)
+ ciphertext=obj.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('ARC2 failed on entry '+`entry`)
+ for i in ciphertext:
+ if verbose: print hex(ord(i)),
+ print
+
+ if 'blowfish' in args:
+ ciph=exerciseBlockCipher('Blowfish',verbose)# Bruce Schneier's Blowfish cipher
+ if (ciph!=None):
+ if verbose: print ' Verifying against test suite...'
+ for entry in testdata.blowfish:
+ key,plain,cipher=entry
+ key=binascii.a2b_hex(key)
+ plain=binascii.a2b_hex(plain)
+ cipher=binascii.a2b_hex(cipher)
+ obj=ciph.new(key, ciph.MODE_ECB)
+ ciphertext=obj.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('Blowfish failed on entry '+`entry`)
+ for i in ciphertext:
+ if verbose: print hex(ord(i)),
+ if verbose: print
+
+ if 'cast' in args:
+ ciph=exerciseBlockCipher('CAST', verbose) # CAST-128
+ if (ciph!=None):
+ if verbose: print ' Verifying against test suite...'
+ for entry in testdata.cast:
+ key,plain,cipher=entry
+ key=binascii.a2b_hex(key)
+ plain=binascii.a2b_hex(plain)
+ cipher=binascii.a2b_hex(cipher)
+ obj=ciph.new(key, ciph.MODE_ECB)
+ ciphertext=obj.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('CAST failed on entry '+`entry`)
+ for i in ciphertext:
+ if verbose: print hex(ord(i)),
+ if verbose: print
+
+ if 0:
+ # The full-maintenance test; it requires 4 million encryptions,
+ # and correspondingly is quite time-consuming. I've disabled
+ # it; it's faster to compile block/cast.c with -DTEST and run
+ # the resulting program.
+ a = b = '\x01\x23\x45\x67\x12\x34\x56\x78\x23\x45\x67\x89\x34\x56\x78\x9A'
+
+ for i in range(0, 1000000):
+ obj = cast.new(b, cast.MODE_ECB)
+ a = obj.encrypt(a[:8]) + obj.encrypt(a[-8:])
+ obj = cast.new(a, cast.MODE_ECB)
+ b = obj.encrypt(b[:8]) + obj.encrypt(b[-8:])
+
+ if a!="\xEE\xA9\xD0\xA2\x49\xFD\x3B\xA6\xB3\x43\x6F\xB8\x9D\x6D\xCA\x92":
+ if verbose: print 'CAST test failed: value of "a" doesn\'t match'
+ if b!="\xB2\xC9\x5E\xB0\x0C\x31\xAD\x71\x80\xAC\x05\xB8\xE8\x3D\x69\x6E":
+ if verbose: print 'CAST test failed: value of "b" doesn\'t match'
+
+ if 'des' in args:
+ # Test/benchmark DES block cipher
+ des=exerciseBlockCipher('DES', verbose)
+ if (des!=None):
+ # Various tests taken from the DES library packaged with Kerberos V4
+ obj=des.new(binascii.a2b_hex('0123456789abcdef'), des.MODE_ECB)
+ s=obj.encrypt('Now is t')
+ if (s!=binascii.a2b_hex('3fa40e8a984d4815')):
+ die('DES fails test 1')
+ obj=des.new(binascii.a2b_hex('08192a3b4c5d6e7f'), des.MODE_ECB)
+ s=obj.encrypt('\000\000\000\000\000\000\000\000')
+ if (s!=binascii.a2b_hex('25ddac3e96176467')):
+ die('DES fails test 2')
+ obj=des.new(binascii.a2b_hex('0123456789abcdef'), des.MODE_CBC,
+ binascii.a2b_hex('1234567890abcdef'))
+ s=obj.encrypt("Now is the time for all ")
+ if (s!=binascii.a2b_hex('e5c7cdde872bf27c43e934008c389c0f683788499a7c05f6')):
+ die('DES fails test 3')
+ obj=des.new(binascii.a2b_hex('0123456789abcdef'), des.MODE_CBC,
+ binascii.a2b_hex('fedcba9876543210'))
+ s=obj.encrypt("7654321 Now is the time for \000\000\000\000")
+ if (s!=binascii.a2b_hex("ccd173ffab2039f4acd8aefddfd8a1eb468e91157888ba681d269397f7fe62b4")):
+ die('DES fails test 4')
+ del obj,s
+
+ # R. Rivest's test: see http://theory.lcs.mit.edu/~rivest/destest.txt
+ x=binascii.a2b_hex('9474B8E8C73BCA7D')
+ for i in range(0, 16):
+ obj=des.new(x, des.MODE_ECB)
+ if (i & 1): x=obj.decrypt(x)
+ else: x=obj.encrypt(x)
+ if x!=binascii.a2b_hex('1B1A2DDB4C642438'):
+ die("DES fails Rivest's test")
+
+ if verbose: print ' Verifying against test suite...'
+ for entry in testdata.des:
+ key,plain,cipher=entry
+ key=binascii.a2b_hex(key)
+ plain=binascii.a2b_hex(plain)
+ cipher=binascii.a2b_hex(cipher)
+ obj=des.new(key, des.MODE_ECB)
+ ciphertext=obj.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('DES failed on entry '+`entry`)
+ for entry in testdata.des_cbc:
+ key, iv, plain, cipher=entry
+ key, iv, cipher=binascii.a2b_hex(key),binascii.a2b_hex(iv),binascii.a2b_hex(cipher)
+ obj1=des.new(key, des.MODE_CBC, iv)
+ obj2=des.new(key, des.MODE_CBC, iv)
+ ciphertext=obj1.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('DES CBC mode failed on entry '+`entry`)
+
+ if 'des3' in args:
+ ciph=exerciseBlockCipher('DES3', verbose) # Triple DES
+ if (ciph!=None):
+ if verbose: print ' Verifying against test suite...'
+ for entry in testdata.des3:
+ key,plain,cipher=entry
+ key=binascii.a2b_hex(key)
+ plain=binascii.a2b_hex(plain)
+ cipher=binascii.a2b_hex(cipher)
+ obj=ciph.new(key, ciph.MODE_ECB)
+ ciphertext=obj.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('DES3 failed on entry '+`entry`)
+ for i in ciphertext:
+ if verbose: print hex(ord(i)),
+ if verbose: print
+ for entry in testdata.des3_cbc:
+ key, iv, plain, cipher=entry
+ key, iv, cipher=binascii.a2b_hex(key),binascii.a2b_hex(iv),binascii.a2b_hex(cipher)
+ obj1=ciph.new(key, ciph.MODE_CBC, iv)
+ obj2=ciph.new(key, ciph.MODE_CBC, iv)
+ ciphertext=obj1.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('DES3 CBC mode failed on entry '+`entry`)
+
+ if 'idea' in args:
+ ciph=exerciseBlockCipher('IDEA', verbose) # IDEA block cipher
+ if (ciph!=None):
+ if verbose: print ' Verifying against test suite...'
+ for entry in testdata.idea:
+ key,plain,cipher=entry
+ key=binascii.a2b_hex(key)
+ plain=binascii.a2b_hex(plain)
+ cipher=binascii.a2b_hex(cipher)
+ obj=ciph.new(key, ciph.MODE_ECB)
+ ciphertext=obj.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('IDEA failed on entry '+`entry`)
+
+ if 'rc5' in args:
+ # Ronald Rivest's RC5 algorithm
+ ciph=exerciseBlockCipher('RC5', verbose)
+ if (ciph!=None):
+ if verbose: print ' Verifying against test suite...'
+ for entry in testdata.rc5:
+ key,plain,cipher=entry
+ key=binascii.a2b_hex(key)
+ plain=binascii.a2b_hex(plain)
+ cipher=binascii.a2b_hex(cipher)
+ obj=ciph.new(key[4:], ciph.MODE_ECB,
+ version =ord(key[0]),
+ word_size=ord(key[1]),
+ rounds =ord(key[2]) )
+ ciphertext=obj.encrypt(plain)
+ if (ciphertext!=cipher):
+ die('RC5 failed on entry '+`entry`)
+ for i in ciphertext:
+ if verbose: print hex(ord(i)),
+ if verbose: print
+
+
+
diff --git a/src/gdata/Crypto/__init__.py b/src/gdata/Crypto/__init__.py
new file mode 100755
index 0000000..2324ae8
--- /dev/null
+++ b/src/gdata/Crypto/__init__.py
@@ -0,0 +1,25 @@
+
+"""Python Cryptography Toolkit
+
+A collection of cryptographic modules implementing various algorithms
+and protocols.
+
+Subpackages:
+Crypto.Cipher Secret-key encryption algorithms (AES, DES, ARC4)
+Crypto.Hash Hashing algorithms (MD5, SHA, HMAC)
+Crypto.Protocol Cryptographic protocols (Chaffing, all-or-nothing
+ transform). This package does not contain any
+ network protocols.
+Crypto.PublicKey Public-key encryption and signature algorithms
+ (RSA, DSA)
+Crypto.Util Various useful modules and functions (long-to-string
+ conversion, random number generation, number
+ theoretic functions)
+"""
+
+__all__ = ['Cipher', 'Hash', 'Protocol', 'PublicKey', 'Util']
+
+__version__ = '2.0.1'
+__revision__ = "$Id: __init__.py,v 1.12 2005/06/14 01:20:22 akuchling Exp $"
+
+
diff --git a/src/gdata/Crypto/test.py b/src/gdata/Crypto/test.py
new file mode 100755
index 0000000..c5ed061
--- /dev/null
+++ b/src/gdata/Crypto/test.py
@@ -0,0 +1,38 @@
+#
+# Test script for the Python Cryptography Toolkit.
+#
+
+__revision__ = "$Id: test.py,v 1.7 2002/07/11 14:31:19 akuchling Exp $"
+
+import os, sys
+
+
+# Add the build directory to the front of sys.path
+from distutils.util import get_platform
+s = "build/lib.%s-%.3s" % (get_platform(), sys.version)
+s = os.path.join(os.getcwd(), s)
+sys.path.insert(0, s)
+s = os.path.join(os.getcwd(), 'test')
+sys.path.insert(0, s)
+
+from Crypto.Util import test
+
+args = sys.argv[1:]
+quiet = "--quiet" in args
+if quiet: args.remove('--quiet')
+
+if not quiet:
+ print '\nStream Ciphers:'
+ print '==============='
+
+if args: test.TestStreamModules(args, verbose= not quiet)
+else: test.TestStreamModules(verbose= not quiet)
+
+if not quiet:
+ print '\nBlock Ciphers:'
+ print '=============='
+
+if args: test.TestBlockModules(args, verbose= not quiet)
+else: test.TestBlockModules(verbose= not quiet)
+
+
diff --git a/src/gdata/__init__.py b/src/gdata/__init__.py
new file mode 100755
index 0000000..634889b
--- /dev/null
+++ b/src/gdata/__init__.py
@@ -0,0 +1,835 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains classes representing Google Data elements.
+
+ Extends Atom classes to add Google Data specific elements.
+"""
+
+
+__author__ = 'j.s@google.com (Jeffrey Scudder)'
+
+import os
+import atom
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+
+
+# XML namespaces which are often used in GData entities.
+GDATA_NAMESPACE = 'http://schemas.google.com/g/2005'
+GDATA_TEMPLATE = '{http://schemas.google.com/g/2005}%s'
+OPENSEARCH_NAMESPACE = 'http://a9.com/-/spec/opensearchrss/1.0/'
+OPENSEARCH_TEMPLATE = '{http://a9.com/-/spec/opensearchrss/1.0/}%s'
+BATCH_NAMESPACE = 'http://schemas.google.com/gdata/batch'
+GACL_NAMESPACE = 'http://schemas.google.com/acl/2007'
+GACL_TEMPLATE = '{http://schemas.google.com/acl/2007}%s'
+
+
+# Labels used in batch request entries to specify the desired CRUD operation.
+BATCH_INSERT = 'insert'
+BATCH_UPDATE = 'update'
+BATCH_DELETE = 'delete'
+BATCH_QUERY = 'query'
+
+class Error(Exception):
+ pass
+
+
+class MissingRequiredParameters(Error):
+ pass
+
+
+class MediaSource(object):
+ """GData Entries can refer to media sources, so this class provides a
+ place to store references to these objects along with some metadata.
+ """
+
+ def __init__(self, file_handle=None, content_type=None, content_length=None,
+ file_path=None, file_name=None):
+ """Creates an object of type MediaSource.
+
+ Args:
+ file_handle: A file handle pointing to the file to be encapsulated in the
+ MediaSource
+ content_type: string The MIME type of the file. Required if a file_handle
+ is given.
+ content_length: int The size of the file. Required if a file_handle is
+ given.
+ file_path: string (optional) A full path name to the file. Used in
+ place of a file_handle.
+ file_name: string The name of the file without any path information.
+ Required if a file_handle is given.
+ """
+ self.file_handle = file_handle
+ self.content_type = content_type
+ self.content_length = content_length
+ self.file_name = file_name
+
+ if (file_handle is None and content_type is not None and
+ file_path is not None):
+ self.setFile(file_path, content_type)
+
+ def setFile(self, file_name, content_type):
+ """A helper function which can create a file handle from a given filename
+ and set the content type and length all at once.
+
+ Args:
+ file_name: string The path and file name to the file containing the media
+ content_type: string A MIME type representing the type of the media
+ """
+
+ self.file_handle = open(file_name, 'rb')
+ self.content_type = content_type
+ self.content_length = os.path.getsize(file_name)
+ self.file_name = os.path.basename(file_name)
+
+
+class LinkFinder(atom.LinkFinder):
+ """An "interface" providing methods to find link elements
+
+ GData Entry elements often contain multiple links which differ in the rel
+ attribute or content type. Often, developers are interested in a specific
+ type of link so this class provides methods to find specific classes of
+ links.
+
+ This class is used as a mixin in GData entries.
+ """
+
+ def GetSelfLink(self):
+ """Find the first link with rel set to 'self'
+
+ Returns:
+ An atom.Link or none if none of the links had rel equal to 'self'
+ """
+
+ for a_link in self.link:
+ if a_link.rel == 'self':
+ return a_link
+ return None
+
+ def GetEditLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'edit':
+ return a_link
+ return None
+
+ def GetEditMediaLink(self):
+ """The Picasa API mistakenly returns media-edit rather than edit-media, but
+ this may change soon.
+ """
+ for a_link in self.link:
+ if a_link.rel == 'edit-media':
+ return a_link
+ if a_link.rel == 'media-edit':
+ return a_link
+ return None
+
+ def GetHtmlLink(self):
+ """Find the first link with rel of alternate and type of text/html
+
+ Returns:
+ An atom.Link or None if no links matched
+ """
+ for a_link in self.link:
+ if a_link.rel == 'alternate' and a_link.type == 'text/html':
+ return a_link
+ return None
+
+ def GetPostLink(self):
+ """Get a link containing the POST target URL.
+
+ The POST target URL is used to insert new entries.
+
+ Returns:
+ A link object with a rel matching the POST type.
+ """
+ for a_link in self.link:
+ if a_link.rel == 'http://schemas.google.com/g/2005#post':
+ return a_link
+ return None
+
+ def GetAclLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'http://schemas.google.com/acl/2007#accessControlList':
+ return a_link
+ return None
+
+ def GetFeedLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'http://schemas.google.com/g/2005#feed':
+ return a_link
+ return None
+
+ def GetNextLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'next':
+ return a_link
+ return None
+
+ def GetPrevLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'previous':
+ return a_link
+ return None
+
+
+class TotalResults(atom.AtomBase):
+ """opensearch:TotalResults for a GData feed"""
+
+ _tag = 'totalResults'
+ _namespace = OPENSEARCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def TotalResultsFromString(xml_string):
+ return atom.CreateClassFromXMLString(TotalResults, xml_string)
+
+
+class StartIndex(atom.AtomBase):
+ """The opensearch:startIndex element in GData feed"""
+
+ _tag = 'startIndex'
+ _namespace = OPENSEARCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def StartIndexFromString(xml_string):
+ return atom.CreateClassFromXMLString(StartIndex, xml_string)
+
+
+class ItemsPerPage(atom.AtomBase):
+ """The opensearch:itemsPerPage element in GData feed"""
+
+ _tag = 'itemsPerPage'
+ _namespace = OPENSEARCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def ItemsPerPageFromString(xml_string):
+ return atom.CreateClassFromXMLString(ItemsPerPage, xml_string)
+
+
+class ExtendedProperty(atom.AtomBase):
+ """The Google Data extendedProperty element.
+
+ Used to store arbitrary key-value information specific to your
+ application. The value can either be a text string stored as an XML
+ attribute (.value), or an XML node (XmlBlob) as a child element.
+
+ This element is used in the Google Calendar data API and the Google
+ Contacts data API.
+ """
+
+ _tag = 'extendedProperty'
+ _namespace = GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+ _attributes['value'] = 'value'
+
+ def __init__(self, name=None, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ def GetXmlBlobExtensionElement(self):
+ """Returns the XML blob as an atom.ExtensionElement.
+
+ Returns:
+ An atom.ExtensionElement representing the blob's XML, or None if no
+ blob was set.
+ """
+ if len(self.extension_elements) < 1:
+ return None
+ else:
+ return self.extension_elements[0]
+
+ def GetXmlBlobString(self):
+ """Returns the XML blob as a string.
+
+ Returns:
+ A string containing the blob's XML, or None if no blob was set.
+ """
+ blob = self.GetXmlBlobExtensionElement()
+ if blob:
+ return blob.ToString()
+ return None
+
+ def SetXmlBlob(self, blob):
+ """Sets the contents of the extendedProperty to XML as a child node.
+
+ Since the extendedProperty is only allowed one child element as an XML
+ blob, setting the XML blob will erase any preexisting extension elements
+ in this object.
+
+ Args:
+ blob: str, ElementTree Element or atom.ExtensionElement representing
+ the XML blob stored in the extendedProperty.
+ """
+ # Erase any existing extension_elements, clears the child nodes from the
+ # extendedProperty.
+ self.extension_elements = []
+ if isinstance(blob, atom.ExtensionElement):
+ self.extension_elements.append(blob)
+ elif ElementTree.iselement(blob):
+ self.extension_elements.append(atom._ExtensionElementFromElementTree(
+ blob))
+ else:
+ self.extension_elements.append(atom.ExtensionElementFromString(blob))
+
+
+def ExtendedPropertyFromString(xml_string):
+ return atom.CreateClassFromXMLString(ExtendedProperty, xml_string)
+
+
+class GDataEntry(atom.Entry, LinkFinder):
+ """Extends Atom Entry to provide data processing"""
+
+ _tag = atom.Entry._tag
+ _namespace = atom.Entry._namespace
+ _children = atom.Entry._children.copy()
+ _attributes = atom.Entry._attributes.copy()
+
+ def __GetId(self):
+ return self.__id
+
+ # This method was created to strip the unwanted whitespace from the id's
+ # text node.
+ def __SetId(self, id):
+ self.__id = id
+ if id is not None and id.text is not None:
+ self.__id.text = id.text.strip()
+
+ id = property(__GetId, __SetId)
+
+ def IsMedia(self):
+ """Determines whether or not an entry is a GData Media entry.
+ """
+ if (self.GetEditMediaLink()):
+ return True
+ else:
+ return False
+
+ def GetMediaURL(self):
+ """Returns the URL to the media content, if the entry is a media entry.
+ Otherwise returns None.
+ """
+ if not self.IsMedia():
+ return None
+ else:
+ return self.content.src
+
+
+def GDataEntryFromString(xml_string):
+ """Creates a new GDataEntry instance given a string of XML."""
+ return atom.CreateClassFromXMLString(GDataEntry, xml_string)
+
+
+class GDataFeed(atom.Feed, LinkFinder):
+ """A Feed from a GData service"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = atom.Feed._children.copy()
+ _attributes = atom.Feed._attributes.copy()
+ _children['{%s}totalResults' % OPENSEARCH_NAMESPACE] = ('total_results',
+ TotalResults)
+ _children['{%s}startIndex' % OPENSEARCH_NAMESPACE] = ('start_index',
+ StartIndex)
+ _children['{%s}itemsPerPage' % OPENSEARCH_NAMESPACE] = ('items_per_page',
+ ItemsPerPage)
+ # Add a conversion rule for atom:entry to make it into a GData
+ # Entry.
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [GDataEntry])
+
+ def __GetId(self):
+ return self.__id
+
+ def __SetId(self, id):
+ self.__id = id
+ if id is not None and id.text is not None:
+ self.__id.text = id.text.strip()
+
+ id = property(__GetId, __SetId)
+
+ def __GetGenerator(self):
+ return self.__generator
+
+ def __SetGenerator(self, generator):
+ self.__generator = generator
+ if generator is not None:
+ self.__generator.text = generator.text.strip()
+
+ generator = property(__GetGenerator, __SetGenerator)
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None, entry=None,
+ total_results=None, start_index=None, items_per_page=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ """Constructor for Source
+
+ Args:
+ author: list (optional) A list of Author instances which belong to this
+ class.
+ category: list (optional) A list of Category instances
+ contributor: list (optional) A list on Contributor instances
+ generator: Generator (optional)
+ icon: Icon (optional)
+ id: Id (optional) The entry's Id element
+ link: list (optional) A list of Link instances
+ logo: Logo (optional)
+ rights: Rights (optional) The entry's Rights element
+ subtitle: Subtitle (optional) The entry's subtitle element
+ title: Title (optional) the entry's title element
+ updated: Updated (optional) the entry's updated element
+ entry: list (optional) A list of the Entry instances contained in the
+ feed.
+ text: String (optional) The text contents of the element. This is the
+ contents of the Entry's XML text node.
+ (Example: <foo>This is the text</foo>)
+ extension_elements: list (optional) A list of ExtensionElement instances
+ which are children of this element.
+ extension_attributes: dict (optional) A dictionary of strings which are
+ the values for additional XML attributes of this element.
+ """
+
+ self.author = author or []
+ self.category = category or []
+ self.contributor = contributor or []
+ self.generator = generator
+ self.icon = icon
+ self.id = atom_id
+ self.link = link or []
+ self.logo = logo
+ self.rights = rights
+ self.subtitle = subtitle
+ self.title = title
+ self.updated = updated
+ self.entry = entry or []
+ self.total_results = total_results
+ self.start_index = start_index
+ self.items_per_page = items_per_page
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def GDataFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(GDataFeed, xml_string)
+
+
+class BatchId(atom.AtomBase):
+ _tag = 'id'
+ _namespace = BATCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+
+def BatchIdFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchId, xml_string)
+
+
+class BatchOperation(atom.AtomBase):
+ _tag = 'operation'
+ _namespace = BATCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['type'] = 'type'
+
+ def __init__(self, op_type=None, extension_elements=None,
+ extension_attributes=None,
+ text=None):
+ self.type = op_type
+ atom.AtomBase.__init__(self,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def BatchOperationFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchOperation, xml_string)
+
+
+class BatchStatus(atom.AtomBase):
+ """The batch:status element present in a batch response entry.
+
+ A status element contains the code (HTTP response code) and
+ reason as elements. In a single request these fields would
+ be part of the HTTP response, but in a batch request each
+ Entry operation has a corresponding Entry in the response
+ feed which includes status information.
+
+ See http://code.google.com/apis/gdata/batch.html#Handling_Errors
+ """
+
+ _tag = 'status'
+ _namespace = BATCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['code'] = 'code'
+ _attributes['reason'] = 'reason'
+ _attributes['content-type'] = 'content_type'
+
+ def __init__(self, code=None, reason=None, content_type=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.code = code
+ self.reason = reason
+ self.content_type = content_type
+ atom.AtomBase.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def BatchStatusFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchStatus, xml_string)
+
+
+class BatchEntry(GDataEntry):
+ """An atom:entry for use in batch requests.
+
+ The BatchEntry contains additional members to specify the operation to be
+ performed on this entry and a batch ID so that the server can reference
+ individual operations in the response feed. For more information, see:
+ http://code.google.com/apis/gdata/batch.html
+ """
+
+ _tag = GDataEntry._tag
+ _namespace = GDataEntry._namespace
+ _children = GDataEntry._children.copy()
+ _children['{%s}operation' % BATCH_NAMESPACE] = ('batch_operation', BatchOperation)
+ _children['{%s}id' % BATCH_NAMESPACE] = ('batch_id', BatchId)
+ _children['{%s}status' % BATCH_NAMESPACE] = ('batch_status', BatchStatus)
+ _attributes = GDataEntry._attributes.copy()
+
+ def __init__(self, author=None, category=None, content=None,
+ contributor=None, atom_id=None, link=None, published=None, rights=None,
+ source=None, summary=None, control=None, title=None, updated=None,
+ batch_operation=None, batch_id=None, batch_status=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.batch_operation = batch_operation
+ self.batch_id = batch_id
+ self.batch_status = batch_status
+ GDataEntry.__init__(self, author=author, category=category,
+ content=content, contributor=contributor, atom_id=atom_id, link=link,
+ published=published, rights=rights, source=source, summary=summary,
+ control=control, title=title, updated=updated,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+
+def BatchEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchEntry, xml_string)
+
+
+class BatchInterrupted(atom.AtomBase):
+ """The batch:interrupted element sent if batch request was interrupted.
+
+ Only appears in a feed if some of the batch entries could not be processed.
+ See: http://code.google.com/apis/gdata/batch.html#Handling_Errors
+ """
+
+ _tag = 'interrupted'
+ _namespace = BATCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['reason'] = 'reason'
+ _attributes['success'] = 'success'
+ _attributes['failures'] = 'failures'
+ _attributes['parsed'] = 'parsed'
+
+ def __init__(self, reason=None, success=None, failures=None, parsed=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.reason = reason
+ self.success = success
+ self.failures = failures
+ self.parsed = parsed
+ atom.AtomBase.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def BatchInterruptedFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchInterrupted, xml_string)
+
+
+class BatchFeed(GDataFeed):
+ """A feed containing a list of batch request entries."""
+
+ _tag = GDataFeed._tag
+ _namespace = GDataFeed._namespace
+ _children = GDataFeed._children.copy()
+ _attributes = GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [BatchEntry])
+ _children['{%s}interrupted' % BATCH_NAMESPACE] = ('interrupted', BatchInterrupted)
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None, entry=None,
+ total_results=None, start_index=None, items_per_page=None,
+ interrupted=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.interrupted = interrupted
+ GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results, start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+ def AddBatchEntry(self, entry=None, id_url_string=None,
+ batch_id_string=None, operation_string=None):
+ """Logic for populating members of a BatchEntry and adding to the feed.
+
+
+ If the entry is not a BatchEntry, it is converted to a BatchEntry so
+ that the batch specific members will be present.
+
+ The id_url_string can be used in place of an entry if the batch operation
+ applies to a URL. For example query and delete operations require just
+ the URL of an entry, no body is sent in the HTTP request. If an
+ id_url_string is sent instead of an entry, a BatchEntry is created and
+ added to the feed.
+
+ This method also assigns the desired batch id to the entry so that it
+ can be referenced in the server's response. If the batch_id_string is
+ None, this method will assign a batch_id to be the index at which this
+ entry will be in the feed's entry list.
+
+ Args:
+ entry: BatchEntry, atom.Entry, or another Entry flavor (optional) The
+ entry which will be sent to the server as part of the batch request.
+ The item must have a valid atom id so that the server knows which
+ entry this request references.
+ id_url_string: str (optional) The URL of the entry to be acted on. You
+ can find this URL in the text member of the atom id for an entry.
+ If an entry is not sent, this id will be used to construct a new
+ BatchEntry which will be added to the request feed.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. Note that batch_ids should either always be specified or
+ never, mixing could potentially result in duplicate batch ids.
+ operation_string: str (optional) The desired batch operation which will
+ set the batch_operation.type member of the entry. Options are
+ 'insert', 'update', 'delete', and 'query'
+
+ Raises:
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an
+ entry are provided in the request.
+
+ Returns:
+ The added entry.
+ """
+ if entry is None and id_url_string is None:
+ raise MissingRequiredParameters('supply either an entry or URL string')
+ if entry is None and id_url_string is not None:
+ entry = BatchEntry(atom_id=atom.Id(text=id_url_string))
+ # TODO: handle cases in which the entry lacks batch_... members.
+ #if not isinstance(entry, BatchEntry):
+ # Convert the entry to a batch entry.
+ if batch_id_string is not None:
+ entry.batch_id = BatchId(text=batch_id_string)
+ elif entry.batch_id is None or entry.batch_id.text is None:
+ entry.batch_id = BatchId(text=str(len(self.entry)))
+ if operation_string is not None:
+ entry.batch_operation = BatchOperation(op_type=operation_string)
+ self.entry.append(entry)
+ return entry
+
+ def AddInsert(self, entry, batch_id_string=None):
+ """Add an insert request to the operations in this batch request feed.
+
+ If the entry doesn't yet have an operation or a batch id, these will
+ be set to the insert operation and a batch_id specified as a parameter.
+
+ Args:
+ entry: BatchEntry The entry which will be sent in the batch feed as an
+ insert request.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. Note that batch_ids should either always be specified or
+ never, mixing could potentially result in duplicate batch ids.
+ """
+ entry = self.AddBatchEntry(entry=entry, batch_id_string=batch_id_string,
+ operation_string=BATCH_INSERT)
+
+ def AddUpdate(self, entry, batch_id_string=None):
+ """Add an update request to the list of batch operations in this feed.
+
+ Sets the operation type of the entry to insert if it is not already set
+ and assigns the desired batch id to the entry so that it can be
+ referenced in the server's response.
+
+ Args:
+ entry: BatchEntry The entry which will be sent to the server as an
+ update (HTTP PUT) request. The item must have a valid atom id
+ so that the server knows which entry to replace.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. See also comments for AddInsert.
+ """
+ entry = self.AddBatchEntry(entry=entry, batch_id_string=batch_id_string,
+ operation_string=BATCH_UPDATE)
+
+ def AddDelete(self, url_string=None, entry=None, batch_id_string=None):
+ """Adds a delete request to the batch request feed.
+
+ This method takes either the url_string which is the atom id of the item
+ to be deleted, or the entry itself. The atom id of the entry must be
+ present so that the server knows which entry should be deleted.
+
+ Args:
+ url_string: str (optional) The URL of the entry to be deleted. You can
+ find this URL in the text member of the atom id for an entry.
+ entry: BatchEntry (optional) The entry to be deleted.
+ batch_id_string: str (optional)
+
+ Raises:
+ MissingRequiredParameters: Raised if neither a url_string nor an entry
+ are provided in the request.
+ """
+ entry = self.AddBatchEntry(entry=entry, id_url_string=url_string,
+ batch_id_string=batch_id_string,
+ operation_string=BATCH_DELETE)
+
+ def AddQuery(self, url_string=None, entry=None, batch_id_string=None):
+ """Adds a query request to the batch request feed.
+
+ This method takes either the url_string which is the query URL
+ whose results will be added to the result feed. The query URL will
+ be encapsulated in a BatchEntry, and you may pass in the BatchEntry
+ with a query URL instead of sending a url_string.
+
+ Args:
+ url_string: str (optional)
+ entry: BatchEntry (optional)
+ batch_id_string: str (optional)
+
+ Raises:
+ MissingRequiredParameters
+ """
+ entry = self.AddBatchEntry(entry=entry, id_url_string=url_string,
+ batch_id_string=batch_id_string,
+ operation_string=BATCH_QUERY)
+
+ def GetBatchLink(self):
+ for link in self.link:
+ if link.rel == 'http://schemas.google.com/g/2005#batch':
+ return link
+ return None
+
+
+def BatchFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(BatchFeed, xml_string)
+
+
+class EntryLink(atom.AtomBase):
+ """The gd:entryLink element"""
+
+ _tag = 'entryLink'
+ _namespace = GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ # The entry used to be an atom.Entry, now it is a GDataEntry.
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', GDataEntry)
+ _attributes['rel'] = 'rel'
+ _attributes['readOnly'] = 'read_only'
+ _attributes['href'] = 'href'
+
+ def __init__(self, href=None, read_only=None, rel=None,
+ entry=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.href = href
+ self.read_only = read_only
+ self.rel = rel
+ self.entry = entry
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def EntryLinkFromString(xml_string):
+ return atom.CreateClassFromXMLString(EntryLink, xml_string)
+
+
+class FeedLink(atom.AtomBase):
+ """The gd:feedLink element"""
+
+ _tag = 'feedLink'
+ _namespace = GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}feed' % atom.ATOM_NAMESPACE] = ('feed', GDataFeed)
+ _attributes['rel'] = 'rel'
+ _attributes['readOnly'] = 'read_only'
+ _attributes['countHint'] = 'count_hint'
+ _attributes['href'] = 'href'
+
+ def __init__(self, count_hint=None, href=None, read_only=None, rel=None,
+ feed=None, extension_elements=None, extension_attributes=None,
+ text=None):
+ self.count_hint = count_hint
+ self.href = href
+ self.read_only = read_only
+ self.rel = rel
+ self.feed = feed
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def FeedLinkFromString(xml_string):
+ return atom.CreateClassFromXMLString(FeedLink, xml_string)
diff --git a/src/gdata/acl/__init__.py b/src/gdata/acl/__init__.py
new file mode 100644
index 0000000..22071f7
--- /dev/null
+++ b/src/gdata/acl/__init__.py
@@ -0,0 +1,15 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/src/gdata/acl/data.py b/src/gdata/acl/data.py
new file mode 100644
index 0000000..3b5019b
--- /dev/null
+++ b/src/gdata/acl/data.py
@@ -0,0 +1,69 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains the data classes of the Google Access Control List (ACL) Extension"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+import atom.data
+import gdata.data
+import gdata.opensearch.data
+
+
+GACL_TEMPLATE = '{http://schemas.google.com/acl/2007}%s'
+
+
+class AclRole(atom.core.XmlElement):
+ """Describes the role of an entry in an access control list."""
+ _qname = GACL_TEMPLATE % 'role'
+ value = 'value'
+
+
+class AclAdditionalRole(atom.core.XmlElement):
+ """Describes an additionalRole element."""
+ _qname = GACL_TEMPLATE % 'additionalRole'
+ value = 'value'
+
+
+class AclScope(atom.core.XmlElement):
+ """Describes the scope of an entry in an access control list."""
+ _qname = GACL_TEMPLATE % 'scope'
+ type = 'type'
+ value = 'value'
+
+
+class AclWithKey(atom.core.XmlElement):
+ """Describes a key that can be used to access a document."""
+ _qname = GACL_TEMPLATE % 'withKey'
+ key = 'key'
+ role = AclRole
+ additional_role = AclAdditionalRole
+
+
+class AclEntry(gdata.data.GDEntry):
+ """Describes an entry in a feed of an access control list (ACL)."""
+ scope = AclScope
+ role = AclRole
+ with_key = AclWithKey
+ additional_role = AclAdditionalRole
+
+
+class AclFeed(gdata.data.GDFeed):
+ """Describes a feed of an access control list (ACL)."""
+ entry = [AclEntry]
diff --git a/src/gdata/alt/__init__.py b/src/gdata/alt/__init__.py
new file mode 100644
index 0000000..742980e
--- /dev/null
+++ b/src/gdata/alt/__init__.py
@@ -0,0 +1,20 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""This package's modules adapt the gdata library to run in other environments
+
+The first example is the appengine module which contains functions and
+classes which modify a GDataService object to run on Google App Engine.
+"""
diff --git a/src/gdata/alt/app_engine.py b/src/gdata/alt/app_engine.py
new file mode 100644
index 0000000..afa412d
--- /dev/null
+++ b/src/gdata/alt/app_engine.py
@@ -0,0 +1,101 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Provides functions to persist serialized auth tokens in the datastore.
+
+The get_token and set_token functions should be used in conjunction with
+gdata.gauth's token_from_blob and token_to_blob to allow auth token objects
+to be reused across requests. It is up to your own code to ensure that the
+token key's are unique.
+"""
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+from google.appengine.ext import db
+from google.appengine.api import memcache
+
+
+class Token(db.Model):
+ """Datastore Model which stores a serialized auth token."""
+ t = db.BlobProperty()
+
+
+def get_token(unique_key):
+ """Searches for a stored token with the desired key.
+
+ Checks memcache and then the datastore if required.
+
+ Args:
+ unique_key: str which uniquely identifies the desired auth token.
+
+ Returns:
+ A string encoding the auth token data. Use gdata.gauth.token_from_blob to
+ convert back into a usable token object. None if the token was not found
+ in memcache or the datastore.
+ """
+ token_string = memcache.get(unique_key)
+ if token_string is None:
+ # The token wasn't in memcache, so look in the datastore.
+ token = Token.get_by_key_name(unique_key)
+ if token is None:
+ return None
+ return token.t
+ return token_string
+
+
+def set_token(unique_key, token_str):
+ """Saves the serialized auth token in the datastore.
+
+ The token is also stored in memcache to speed up retrieval on a cache hit.
+
+ Args:
+ unique_key: The unique name for this token as a string. It is up to your
+ code to ensure that this token value is unique in your application.
+ Previous values will be silently overwitten.
+ token_str: A serialized auth token as a string. I expect that this string
+ will be generated by gdata.gauth.token_to_blob.
+
+ Returns:
+ True if the token was stored sucessfully, False if the token could not be
+ safely cached (if an old value could not be cleared). If the token was
+ set in memcache, but not in the datastore, this function will return None.
+ However, in that situation an exception will likely be raised.
+
+ Raises:
+ Datastore exceptions may be raised from the App Engine SDK in the event of
+ failure.
+ """
+ # First try to save in memcache.
+ result = memcache.set(unique_key, token_str)
+ # If memcache fails to save the value, clear the cached value.
+ if not result:
+ result = memcache.delete(unique_key)
+ # If we could not clear the cached value for this token, refuse to save.
+ if result == 0:
+ return False
+ # Save to the datastore.
+ if Token(key_name=unique_key, t=token_str).put():
+ return True
+ return None
+
+
+def delete_token(unique_key):
+ # Clear from memcache.
+ memcache.delete(unique_key)
+ # Clear from the datastore.
+ Token(key_name=unique_key).delete()
diff --git a/src/gdata/alt/appengine.py b/src/gdata/alt/appengine.py
new file mode 100644
index 0000000..2251621
--- /dev/null
+++ b/src/gdata/alt/appengine.py
@@ -0,0 +1,321 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Provides HTTP functions for gdata.service to use on Google App Engine
+
+AppEngineHttpClient: Provides an HTTP request method which uses App Engine's
+ urlfetch API. Set the http_client member of a GDataService object to an
+ instance of an AppEngineHttpClient to allow the gdata library to run on
+ Google App Engine.
+
+run_on_appengine: Function which will modify an existing GDataService object
+ to allow it to run on App Engine. It works by creating a new instance of
+ the AppEngineHttpClient and replacing the GDataService object's
+ http_client.
+"""
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import StringIO
+import pickle
+import atom.http_interface
+import atom.token_store
+from google.appengine.api import urlfetch
+from google.appengine.ext import db
+from google.appengine.api import users
+from google.appengine.api import memcache
+
+
+def run_on_appengine(gdata_service, store_tokens=True,
+ single_user_mode=False, deadline=None):
+ """Modifies a GDataService object to allow it to run on App Engine.
+
+ Args:
+ gdata_service: An instance of AtomService, GDataService, or any
+ of their subclasses which has an http_client member and a
+ token_store member.
+ store_tokens: Boolean, defaults to True. If True, the gdata_service
+ will attempt to add each token to it's token_store when
+ SetClientLoginToken or SetAuthSubToken is called. If False
+ the tokens will not automatically be added to the
+ token_store.
+ single_user_mode: Boolean, defaults to False. If True, the current_token
+ member of gdata_service will be set when
+ SetClientLoginToken or SetAuthTubToken is called. If set
+ to True, the current_token is set in the gdata_service
+ and anyone who accesses the object will use the same
+ token.
+
+ Note: If store_tokens is set to False and
+ single_user_mode is set to False, all tokens will be
+ ignored, since the library assumes: the tokens should not
+ be stored in the datastore and they should not be stored
+ in the gdata_service object. This will make it
+ impossible to make requests which require authorization.
+ deadline: int (optional) The number of seconds to wait for a response
+ before timing out on the HTTP request. If no deadline is
+ specified, the deafault deadline for HTTP requests from App
+ Engine is used. The maximum is currently 10 (for 10 seconds).
+ The default deadline for App Engine is 5 seconds.
+ """
+ gdata_service.http_client = AppEngineHttpClient(deadline=deadline)
+ gdata_service.token_store = AppEngineTokenStore()
+ gdata_service.auto_store_tokens = store_tokens
+ gdata_service.auto_set_current_token = single_user_mode
+ return gdata_service
+
+
+class AppEngineHttpClient(atom.http_interface.GenericHttpClient):
+ def __init__(self, headers=None, deadline=None):
+ self.debug = False
+ self.headers = headers or {}
+ self.deadline = deadline
+
+ def request(self, operation, url, data=None, headers=None):
+ """Performs an HTTP call to the server, supports GET, POST, PUT, and
+ DELETE.
+
+ Usage example, perform and HTTP GET on http://www.google.com/:
+ import atom.http
+ client = atom.http.HttpClient()
+ http_response = client.request('GET', 'http://www.google.com/')
+
+ Args:
+ operation: str The HTTP operation to be performed. This is usually one
+ of 'GET', 'POST', 'PUT', or 'DELETE'
+ data: filestream, list of parts, or other object which can be converted
+ to a string. Should be set to None when performing a GET or DELETE.
+ If data is a file-like object which can be read, this method will
+ read a chunk of 100K bytes at a time and send them.
+ If the data is a list of parts to be sent, each part will be
+ evaluated and sent.
+ url: The full URL to which the request should be sent. Can be a string
+ or atom.url.Url.
+ headers: dict of strings. HTTP headers which should be sent
+ in the request.
+ """
+ all_headers = self.headers.copy()
+ if headers:
+ all_headers.update(headers)
+
+ # Construct the full payload.
+ # Assume that data is None or a string.
+ data_str = data
+ if data:
+ if isinstance(data, list):
+ # If data is a list of different objects, convert them all to strings
+ # and join them together.
+ converted_parts = [_convert_data_part(x) for x in data]
+ data_str = ''.join(converted_parts)
+ else:
+ data_str = _convert_data_part(data)
+
+ # If the list of headers does not include a Content-Length, attempt to
+ # calculate it based on the data object.
+ if data and 'Content-Length' not in all_headers:
+ all_headers['Content-Length'] = str(len(data_str))
+
+ # Set the content type to the default value if none was set.
+ if 'Content-Type' not in all_headers:
+ all_headers['Content-Type'] = 'application/atom+xml'
+
+ # Lookup the urlfetch operation which corresponds to the desired HTTP verb.
+ if operation == 'GET':
+ method = urlfetch.GET
+ elif operation == 'POST':
+ method = urlfetch.POST
+ elif operation == 'PUT':
+ method = urlfetch.PUT
+ elif operation == 'DELETE':
+ method = urlfetch.DELETE
+ else:
+ method = None
+ if self.deadline is None:
+ return HttpResponse(urlfetch.Fetch(url=str(url), payload=data_str,
+ method=method, headers=all_headers, follow_redirects=False))
+ return HttpResponse(urlfetch.Fetch(url=str(url), payload=data_str,
+ method=method, headers=all_headers, follow_redirects=False,
+ deadline=self.deadline))
+
+
+def _convert_data_part(data):
+ if not data or isinstance(data, str):
+ return data
+ elif hasattr(data, 'read'):
+ # data is a file like object, so read it completely.
+ return data.read()
+ # The data object was not a file.
+ # Try to convert to a string and send the data.
+ return str(data)
+
+
+class HttpResponse(object):
+ """Translates a urlfetch resoinse to look like an hhtplib resoinse.
+
+ Used to allow the resoinse from HttpRequest to be usable by gdata.service
+ methods.
+ """
+
+ def __init__(self, urlfetch_response):
+ self.body = StringIO.StringIO(urlfetch_response.content)
+ self.headers = urlfetch_response.headers
+ self.status = urlfetch_response.status_code
+ self.reason = ''
+
+ def read(self, length=None):
+ if not length:
+ return self.body.read()
+ else:
+ return self.body.read(length)
+
+ def getheader(self, name):
+ if not self.headers.has_key(name):
+ return self.headers[name.lower()]
+ return self.headers[name]
+
+
+class TokenCollection(db.Model):
+ """Datastore Model which associates auth tokens with the current user."""
+ user = db.UserProperty()
+ pickled_tokens = db.BlobProperty()
+
+
+class AppEngineTokenStore(atom.token_store.TokenStore):
+ """Stores the user's auth tokens in the App Engine datastore.
+
+ Tokens are only written to the datastore if a user is signed in (if
+ users.get_current_user() returns a user object).
+ """
+ def __init__(self):
+ self.user = None
+
+ def add_token(self, token):
+ """Associates the token with the current user and stores it.
+
+ If there is no current user, the token will not be stored.
+
+ Returns:
+ False if the token was not stored.
+ """
+ tokens = load_auth_tokens(self.user)
+ if not hasattr(token, 'scopes') or not token.scopes:
+ return False
+ for scope in token.scopes:
+ tokens[str(scope)] = token
+ key = save_auth_tokens(tokens, self.user)
+ if key:
+ return True
+ return False
+
+ def find_token(self, url):
+ """Searches the current user's collection of token for a token which can
+ be used for a request to the url.
+
+ Returns:
+ The stored token which belongs to the current user and is valid for the
+ desired URL. If there is no current user, or there is no valid user
+ token in the datastore, a atom.http_interface.GenericToken is returned.
+ """
+ if url is None:
+ return None
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ tokens = load_auth_tokens(self.user)
+ if url in tokens:
+ token = tokens[url]
+ if token.valid_for_scope(url):
+ return token
+ else:
+ del tokens[url]
+ save_auth_tokens(tokens, self.user)
+ for scope, token in tokens.iteritems():
+ if token.valid_for_scope(url):
+ return token
+ return atom.http_interface.GenericToken()
+
+ def remove_token(self, token):
+ """Removes the token from the current user's collection in the datastore.
+
+ Returns:
+ False if the token was not removed, this could be because the token was
+ not in the datastore, or because there is no current user.
+ """
+ token_found = False
+ scopes_to_delete = []
+ tokens = load_auth_tokens(self.user)
+ for scope, stored_token in tokens.iteritems():
+ if stored_token == token:
+ scopes_to_delete.append(scope)
+ token_found = True
+ for scope in scopes_to_delete:
+ del tokens[scope]
+ if token_found:
+ save_auth_tokens(tokens, self.user)
+ return token_found
+
+ def remove_all_tokens(self):
+ """Removes all of the current user's tokens from the datastore."""
+ save_auth_tokens({}, self.user)
+
+
+def save_auth_tokens(token_dict, user=None):
+ """Associates the tokens with the current user and writes to the datastore.
+
+ If there us no current user, the tokens are not written and this function
+ returns None.
+
+ Returns:
+ The key of the datastore entity containing the user's tokens, or None if
+ there was no current user.
+ """
+ if user is None:
+ user = users.get_current_user()
+ if user is None:
+ return None
+ memcache.set('gdata_pickled_tokens:%s' % user, pickle.dumps(token_dict))
+ user_tokens = TokenCollection.all().filter('user =', user).get()
+ if user_tokens:
+ user_tokens.pickled_tokens = pickle.dumps(token_dict)
+ return user_tokens.put()
+ else:
+ user_tokens = TokenCollection(
+ user=user,
+ pickled_tokens=pickle.dumps(token_dict))
+ return user_tokens.put()
+
+
+def load_auth_tokens(user=None):
+ """Reads a dictionary of the current user's tokens from the datastore.
+
+ If there is no current user (a user is not signed in to the app) or the user
+ does not have any tokens, an empty dictionary is returned.
+ """
+ if user is None:
+ user = users.get_current_user()
+ if user is None:
+ return {}
+ pickled_tokens = memcache.get('gdata_pickled_tokens:%s' % user)
+ if pickled_tokens:
+ return pickle.loads(pickled_tokens)
+ user_tokens = TokenCollection.all().filter('user =', user).get()
+ if user_tokens:
+ memcache.set('gdata_pickled_tokens:%s' % user, user_tokens.pickled_tokens)
+ return pickle.loads(user_tokens.pickled_tokens)
+ return {}
+
diff --git a/src/gdata/analytics/__init__.py b/src/gdata/analytics/__init__.py
new file mode 100644
index 0000000..8dfa20b
--- /dev/null
+++ b/src/gdata/analytics/__init__.py
@@ -0,0 +1,223 @@
+#!/usr/bin/python
+#
+# Original Copyright (C) 2006 Google Inc.
+# Refactored in 2009 to work for Google Analytics by Sal Uryasev at Juice Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Note that this module will not function without specifically adding
+# 'analytics': [ #Google Analytics
+# 'https://www.google.com/analytics/feeds/'],
+# to CLIENT_LOGIN_SCOPES in the gdata/service.py file
+
+"""Contains extensions to Atom objects used with Google Analytics."""
+
+__author__ = 'api.suryasev (Sal Uryasev)'
+
+import atom
+import gdata
+
+GAN_NAMESPACE = 'http://schemas.google.com/analytics/2009'
+
+class TableId(gdata.GDataEntry):
+ """tableId element."""
+ _tag = 'tableId'
+ _namespace = GAN_NAMESPACE
+
+class Property(gdata.GDataEntry):
+ _tag = 'property'
+ _namespace = GAN_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+ _attributes['name'] = 'name'
+ _attributes['value'] = 'value'
+
+ def __init__(self, name=None, value=None, *args, **kwargs):
+ self.name = name
+ self.value = value
+ super(Property, self).__init__(*args, **kwargs)
+
+ def __str__(self):
+ return self.value
+
+ def __repr__(self):
+ return self.value
+
+class AccountListEntry(gdata.GDataEntry):
+ """The Google Documents version of an Atom Entry"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}tableId' % GAN_NAMESPACE] = ('tableId',
+ [TableId])
+ _children['{%s}property' % GAN_NAMESPACE] = ('property',
+ [Property])
+
+ def __init__(self, tableId=None, property=None,
+ *args, **kwargs):
+ self.tableId = tableId
+ self.property = property
+ super(AccountListEntry, self).__init__(*args, **kwargs)
+
+
+def AccountListEntryFromString(xml_string):
+ """Converts an XML string into an AccountListEntry object.
+
+ Args:
+ xml_string: string The XML describing a Document List feed entry.
+
+ Returns:
+ A AccountListEntry object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(AccountListEntry, xml_string)
+
+
+class AccountListFeed(gdata.GDataFeed):
+ """A feed containing a list of Google Documents Items"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [AccountListEntry])
+
+
+def AccountListFeedFromString(xml_string):
+ """Converts an XML string into an AccountListFeed object.
+
+ Args:
+ xml_string: string The XML describing an AccountList feed.
+
+ Returns:
+ An AccountListFeed object corresponding to the given XML.
+ All properties are also linked to with a direct reference
+ from each entry object for convenience. (e.g. entry.AccountName)
+ """
+ feed = atom.CreateClassFromXMLString(AccountListFeed, xml_string)
+ for entry in feed.entry:
+ for pro in entry.property:
+ entry.__dict__[pro.name.replace('ga:','')] = pro
+ for td in entry.tableId:
+ td.__dict__['value'] = td.text
+ return feed
+
+class Dimension(gdata.GDataEntry):
+ _tag = 'dimension'
+ _namespace = GAN_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+ _attributes['name'] = 'name'
+ _attributes['value'] = 'value'
+ _attributes['type'] = 'type'
+ _attributes['confidenceInterval'] = 'confidence_interval'
+
+ def __init__(self, name=None, value=None, type=None,
+ confidence_interval = None, *args, **kwargs):
+ self.name = name
+ self.value = value
+ self.type = type
+ self.confidence_interval = confidence_interval
+ super(Dimension, self).__init__(*args, **kwargs)
+
+ def __str__(self):
+ return self.value
+
+ def __repr__(self):
+ return self.value
+
+class Metric(gdata.GDataEntry):
+ _tag = 'metric'
+ _namespace = GAN_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+ _attributes['name'] = 'name'
+ _attributes['value'] = 'value'
+ _attributes['type'] = 'type'
+ _attributes['confidenceInterval'] = 'confidence_interval'
+
+ def __init__(self, name=None, value=None, type=None,
+ confidence_interval = None, *args, **kwargs):
+ self.name = name
+ self.value = value
+ self.type = type
+ self.confidence_interval = confidence_interval
+ super(Metric, self).__init__(*args, **kwargs)
+
+ def __str__(self):
+ return self.value
+
+ def __repr__(self):
+ return self.value
+
+class AnalyticsDataEntry(gdata.GDataEntry):
+ """The Google Analytics version of an Atom Entry"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+ _children['{%s}dimension' % GAN_NAMESPACE] = ('dimension',
+ [Dimension])
+
+ _children['{%s}metric' % GAN_NAMESPACE] = ('metric',
+ [Metric])
+
+ def __init__(self, dimension=None, metric=None, *args, **kwargs):
+ self.dimension = dimension
+ self.metric = metric
+
+ super(AnalyticsDataEntry, self).__init__(*args, **kwargs)
+
+class AnalyticsDataFeed(gdata.GDataFeed):
+ """A feed containing a list of Google Analytics Data Feed"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [AnalyticsDataEntry])
+
+
+"""
+Data Feed
+"""
+
+def AnalyticsDataFeedFromString(xml_string):
+ """Converts an XML string into an AccountListFeed object.
+
+ Args:
+ xml_string: string The XML describing an AccountList feed.
+
+ Returns:
+ An AccountListFeed object corresponding to the given XML.
+ Each metric and dimension is also referenced directly from
+ the entry for easier access. (e.g. entry.keyword.value)
+ """
+ feed = atom.CreateClassFromXMLString(AnalyticsDataFeed, xml_string)
+ if feed.entry:
+ for entry in feed.entry:
+ for met in entry.metric:
+ entry.__dict__[met.name.replace('ga:','')] = met
+ if entry.dimension is not None:
+ for dim in entry.dimension:
+ entry.__dict__[dim.name.replace('ga:','')] = dim
+
+ return feed
diff --git a/src/gdata/analytics/client.py b/src/gdata/analytics/client.py
new file mode 100755
index 0000000..dbfc5f7
--- /dev/null
+++ b/src/gdata/analytics/client.py
@@ -0,0 +1,313 @@
+#!/usr/bin/python
+#
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Streamlines requests to the Google Analytics APIs."""
+
+__author__ = 'api.nickm@google.com (Nick Mihailovski)'
+
+
+import atom.data
+import gdata.client
+import gdata.analytics.data
+import gdata.gauth
+
+
+class AnalyticsClient(gdata.client.GDClient):
+ """Client extension for the Google Analytics API service."""
+
+ api_version = '2'
+ auth_service = 'analytics'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['analytics']
+ account_type = 'GOOGLE'
+ ssl = True
+
+ def __init__(self, auth_token=None, **kwargs):
+ """Initializes a new client for the Google Analytics Data Export API.
+
+ Args:
+ auth_token: gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken (optional) Authorizes this client to edit the user's data.
+ kwargs: The other parameters to pass to gdata.client.GDClient
+ constructor.
+ """
+
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+
+ def get_account_feed(self, feed_uri, auth_token=None, **kwargs):
+ """Makes a request to the Analytics API Account Feed.
+
+ Args:
+ feed_uri: str or gdata.analytics.AccountFeedQuery The Analytics Account
+ Feed uri to define what data to retrieve from the API. Can also be
+ used with a gdata.analytics.AccountFeedQuery object.
+ """
+
+ return self.get_feed(feed_uri,
+ desired_class=gdata.analytics.data.AccountFeed,
+ auth_token=auth_token,
+ **kwargs)
+
+ GetAccountFeed = get_account_feed
+
+ def get_data_feed(self, feed_uri, auth_token=None, **kwargs):
+ """Makes a request to the Analytics API Data Feed.
+
+ Args:
+ feed_uri: str or gdata.analytics.AccountFeedQuery The Analytics Data
+ Feed uri to define what data to retrieve from the API. Can also be
+ used with a gdata.analytics.AccountFeedQuery object.
+ """
+
+ return self.get_feed(feed_uri,
+ desired_class=gdata.analytics.data.DataFeed,
+ auth_token=auth_token,
+ **kwargs)
+
+ GetDataFeed = get_data_feed
+
+ def get_management_feed(self, feed_uri, auth_token=None, **kwargs):
+ """Makes a request to the Google Analytics Management API.
+
+ The Management API provides read-only access to configuration data for
+ Google Analytics and supercedes the Data Export API Account Feed.
+ The Management API supports 5 feeds: account, web property, profile,
+ goal, advanced segment.
+
+ You can access each feed through the respective management query class
+ below. All requests return the same data object.
+
+ Args:
+ feed_uri: str or AccountQuery, WebPropertyQuery,
+ ProfileQuery, GoalQuery, MgmtAdvSegFeedQuery
+ The Management API Feed uri to define which feed to retrieve.
+ Either use a string or one of the wrapper classes.
+ """
+
+ return self.get_feed(feed_uri,
+ desired_class=gdata.analytics.data.ManagementFeed,
+ auth_token=auth_token,
+ **kwargs)
+
+ GetMgmtFeed = GetManagementFeed = get_management_feed
+
+
+class AnalyticsBaseQuery(gdata.client.GDQuery):
+ """Abstracts common configuration across all query objects.
+
+ Attributes:
+ scheme: string The default scheme. Should always be https.
+ host: string The default host.
+ """
+
+ scheme = 'https'
+ host = 'www.google.com'
+
+
+class AccountFeedQuery(AnalyticsBaseQuery):
+ """Account Feed query class to simplify constructing Account Feed Urls.
+
+ To use this class, you can either pass a dict in the constructor that has
+ all the data feed query parameters as keys:
+ queryUrl = AccountFeedQuery({'max-results': '10000'})
+
+ Alternatively you can add new parameters directly to the query object:
+ queryUrl = AccountFeedQuery()
+ queryUrl.query['max-results'] = '10000'
+
+ Args:
+ query: dict (optional) Contains all the GA Data Feed query parameters
+ as keys.
+ """
+
+ path = '/analytics/feeds/accounts/default'
+
+ def __init__(self, query={}, **kwargs):
+ self.query = query
+ gdata.client.GDQuery(self, **kwargs)
+
+
+class DataFeedQuery(AnalyticsBaseQuery):
+ """Data Feed query class to simplify constructing Data Feed Urls.
+
+ To use this class, you can either pass a dict in the constructor that has
+ all the data feed query parameters as keys:
+ queryUrl = DataFeedQuery({'start-date': '2008-10-01'})
+
+ Alternatively you can add new parameters directly to the query object:
+ queryUrl = DataFeedQuery()
+ queryUrl.query['start-date'] = '2008-10-01'
+
+ Args:
+ query: dict (optional) Contains all the GA Data Feed query parameters
+ as keys.
+ """
+
+ path = '/analytics/feeds/data'
+
+ def __init__(self, query={}, **kwargs):
+ self.query = query
+ gdata.client.GDQuery(self, **kwargs)
+
+
+class AccountQuery(AnalyticsBaseQuery):
+ """Management API Account Feed query class.
+
+ Example Usage:
+ queryUrl = AccountQuery()
+ queryUrl = AccountQuery({'max-results': 100})
+
+ queryUrl2 = AccountQuery()
+ queryUrl2.query['max-results'] = 100
+
+ Args:
+ query: dict (optional) A dictionary of query parameters.
+ """
+
+ path = '/analytics/feeds/datasources/ga/accounts'
+
+ def __init__(self, query={}, **kwargs):
+ self.query = query
+ gdata.client.GDQuery(self, **kwargs)
+
+class WebPropertyQuery(AnalyticsBaseQuery):
+ """Management API Web Property Feed query class.
+
+ Example Usage:
+ queryUrl = WebPropertyQuery()
+ queryUrl = WebPropertyQuery('123', {'max-results': 100})
+ queryUrl = WebPropertyQuery(acct_id='123',
+ query={'max-results': 100})
+
+ queryUrl2 = WebPropertyQuery()
+ queryUrl2.acct_id = '1234'
+ queryUrl2.query['max-results'] = 100
+
+ Args:
+ acct_id: string (optional) The account ID to filter results.
+ Default is ~all.
+ query: dict (optional) A dictionary of query parameters.
+ """
+
+ def __init__(self, acct_id='~all', query={}, **kwargs):
+ self.acct_id = acct_id
+ self.query = query
+ gdata.client.GDQuery(self, **kwargs)
+
+ @property
+ def path(self):
+ """Wrapper for path attribute."""
+ return ('/analytics/feeds/datasources/ga/accounts/%s/webproperties' %
+ self.acct_id)
+
+
+class ProfileQuery(AnalyticsBaseQuery):
+ """Management API Profile Feed query class.
+
+ Example Usage:
+ queryUrl = ProfileQuery()
+ queryUrl = ProfileQuery('123', 'UA-123-1', {'max-results': 100})
+ queryUrl = ProfileQuery(acct_id='123',
+ web_prop_id='UA-123-1',
+ query={'max-results': 100})
+
+ queryUrl2 = ProfileQuery()
+ queryUrl2.acct_id = '123'
+ queryUrl2.web_prop_id = 'UA-123-1'
+ queryUrl2.query['max-results'] = 100
+
+ Args:
+ acct_id: string (optional) The account ID to filter results.
+ Default is ~all.
+ web_prop_id: string (optional) The web property ID to filter results.
+ Default is ~all.
+ query: dict (optional) A dictionary of query parameters.
+ """
+
+ def __init__(self, acct_id='~all', web_prop_id='~all', query={}, **kwargs):
+ self.acct_id = acct_id
+ self.web_prop_id = web_prop_id
+ self.query = query
+ gdata.client.GDQuery(self, **kwargs)
+
+ @property
+ def path(self):
+ """Wrapper for path attribute."""
+ return ('/analytics/feeds/datasources/ga/accounts/%s/webproperties'
+ '/%s/profiles' % (self.acct_id, self.web_prop_id))
+
+
+class GoalQuery(AnalyticsBaseQuery):
+ """Management API Goal Feed query class.
+
+ Example Usage:
+ queryUrl = GoalQuery()
+ queryUrl = GoalQuery('123', 'UA-123-1', '555',
+ {'max-results': 100})
+ queryUrl = GoalQuery(acct_id='123',
+ web_prop_id='UA-123-1',
+ profile_id='555',
+ query={'max-results': 100})
+
+ queryUrl2 = GoalQuery()
+ queryUrl2.acct_id = '123'
+ queryUrl2.web_prop_id = 'UA-123-1'
+ queryUrl2.query['max-results'] = 100
+
+ Args:
+ acct_id: string (optional) The account ID to filter results.
+ Default is ~all.
+ web_prop_id: string (optional) The web property ID to filter results.
+ Default is ~all.
+ profile_id: string (optional) The profile ID to filter results.
+ Default is ~all.
+ query: dict (optional) A dictionary of query parameters.
+ """
+
+ def __init__(self, acct_id='~all', web_prop_id='~all', profile_id='~all',
+ query={}, **kwargs):
+ self.acct_id = acct_id
+ self.web_prop_id = web_prop_id
+ self.profile_id = profile_id
+ self.query = query or {}
+ gdata.client.GDQuery(self, **kwargs)
+
+ @property
+ def path(self):
+ """Wrapper for path attribute."""
+ return ('/analytics/feeds/datasources/ga/accounts/%s/webproperties'
+ '/%s/profiles/%s/goals' % (self.acct_id, self.web_prop_id,
+ self.profile_id))
+
+
+class AdvSegQuery(AnalyticsBaseQuery):
+ """Management API Goal Feed query class.
+
+ Example Usage:
+ queryUrl = AdvSegQuery()
+ queryUrl = AdvSegQuery({'max-results': 100})
+
+ queryUrl1 = AdvSegQuery()
+ queryUrl1.query['max-results'] = 100
+
+ Args:
+ query: dict (optional) A dictionary of query parameters.
+ """
+
+ path = '/analytics/feeds/datasources/ga/segments'
+
+ def __init__(self, query={}, **kwargs):
+ self.query = query
+ gdata.client.GDQuery(self, **kwargs)
diff --git a/src/gdata/analytics/data.py b/src/gdata/analytics/data.py
new file mode 100755
index 0000000..6b17ef6
--- /dev/null
+++ b/src/gdata/analytics/data.py
@@ -0,0 +1,379 @@
+#!/usr/bin/python
+#
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for parsing and generating XML for both the
+Google Analytics Data Export and Management APIs. Although both APIs
+operate on different parts of Google Analytics, they share common XML
+elements and are released in the same module.
+
+The Management API supports 5 feeds all using the same ManagementFeed
+data class.
+"""
+
+__author__ = 'api.nickm@google.com (Nick Mihailovski)'
+
+
+import gdata.data
+import atom.core
+import atom.data
+
+
+# XML Namespace used in Google Analytics API entities.
+DXP_NS = '{http://schemas.google.com/analytics/2009}%s'
+GA_NS = '{http://schemas.google.com/ga/2009}%s'
+GD_NS = '{http://schemas.google.com/g/2005}%s'
+
+
+class GetProperty(object):
+ """Utility class to simplify retrieving Property objects."""
+
+ def get_property(self, name):
+ """Helper method to return a propery object by its name attribute.
+
+ Args:
+ name: string The name of the <dxp:property> element to retrieve.
+
+ Returns:
+ A property object corresponding to the matching <dxp:property> element.
+ if no property is found, None is returned.
+ """
+
+ for prop in self.property:
+ if prop.name == name:
+ return prop
+
+ return None
+
+ GetProperty = get_property
+
+
+class GetMetric(object):
+ """Utility class to simplify retrieving Metric objects."""
+
+ def get_metric(self, name):
+ """Helper method to return a propery value by its name attribute
+
+ Args:
+ name: string The name of the <dxp:metric> element to retrieve.
+
+ Returns:
+ A property object corresponding to the matching <dxp:metric> element.
+ if no property is found, None is returned.
+ """
+
+ for met in self.metric:
+ if met.name == name:
+ return met
+
+ return None
+
+ GetMetric = get_metric
+
+
+class GetDimension(object):
+ """Utility class to simplify retrieving Dimension objects."""
+
+ def get_dimension(self, name):
+ """Helper method to return a dimention object by its name attribute
+
+ Args:
+ name: string The name of the <dxp:dimension> element to retrieve.
+
+ Returns:
+ A dimension object corresponding to the matching <dxp:dimension> element.
+ if no dimension is found, None is returned.
+ """
+
+ for dim in self.dimension:
+ if dim.name == name:
+ return dim
+
+ return None
+
+ GetDimension = get_dimension
+
+
+class GaLinkFinder(object):
+ """Utility class to return specific links in Google Analytics feeds."""
+
+ def get_parent_links(self):
+ """Returns a list of all the parent links in an entry."""
+
+ links = []
+ for link in self.link:
+ if link.rel == link.parent():
+ links.append(link)
+
+ return links
+
+ GetParentLinks = get_parent_links
+
+ def get_child_links(self):
+ """Returns a list of all the child links in an entry."""
+
+ links = []
+ for link in self.link:
+ if link.rel == link.child():
+ links.append(link)
+
+ return links
+
+ GetChildLinks = get_child_links
+
+ def get_child_link(self, target_kind):
+ """Utility method to return one child link.
+
+ Returns:
+ A child link with the given target_kind. None if the target_kind was
+ not found.
+ """
+
+ for link in self.link:
+ if link.rel == link.child() and link.target_kind == target_kind:
+ return link
+
+ return None
+
+ GetChildLink = get_child_link
+
+
+class StartDate(atom.core.XmlElement):
+ """Analytics Feed <dxp:startDate>"""
+ _qname = DXP_NS % 'startDate'
+
+
+class EndDate(atom.core.XmlElement):
+ """Analytics Feed <dxp:endDate>"""
+ _qname = DXP_NS % 'endDate'
+
+
+class Metric(atom.core.XmlElement):
+ """Analytics Feed <dxp:metric>"""
+ _qname = DXP_NS % 'metric'
+ name = 'name'
+ type = 'type'
+ value = 'value'
+ confidence_interval = 'confidenceInterval'
+
+
+class Aggregates(atom.core.XmlElement, GetMetric):
+ """Analytics Data Feed <dxp:aggregates>"""
+ _qname = DXP_NS % 'aggregates'
+ metric = [Metric]
+
+
+class ContainsSampledData(atom.core.XmlElement):
+ """Analytics Data Feed <dxp:containsSampledData>"""
+ _qname = DXP_NS % 'containsSampledData'
+
+
+class TableId(atom.core.XmlElement):
+ """Analytics Feed <dxp:tableId>"""
+ _qname = DXP_NS % 'tableId'
+
+
+class TableName(atom.core.XmlElement):
+ """Analytics Feed <dxp:tableName>"""
+ _qname = DXP_NS % 'tableName'
+
+
+class Property(atom.core.XmlElement):
+ """Analytics Feed <dxp:property>"""
+ _qname = DXP_NS % 'property'
+ name = 'name'
+ value = 'value'
+
+
+class Definition(atom.core.XmlElement):
+ """Analytics Feed <dxp:definition>"""
+ _qname = DXP_NS % 'definition'
+
+
+class Segment(atom.core.XmlElement):
+ """Analytics Feed <dxp:segment>"""
+ _qname = DXP_NS % 'segment'
+ id = 'id'
+ name = 'name'
+ definition = Definition
+
+
+class Engagement(atom.core.XmlElement):
+ """Analytics Feed <dxp:engagement>"""
+ _qname = GA_NS % 'engagement'
+ type = 'type'
+ comparison = 'comparison'
+ threshold_value = 'thresholdValue'
+
+
+class Step(atom.core.XmlElement):
+ """Analytics Feed <dxp:step>"""
+ _qname = GA_NS % 'step'
+ number = 'number'
+ name = 'name'
+ path = 'path'
+
+
+class Destination(atom.core.XmlElement):
+ """Analytics Feed <dxp:destination>"""
+ _qname = GA_NS % 'destination'
+ step = [Step]
+ expression = 'expression'
+ case_sensitive = 'caseSensitive'
+ match_type = 'matchType'
+ step1_required = 'step1Required'
+
+
+class Goal(atom.core.XmlElement):
+ """Analytics Feed <dxp:goal>"""
+ _qname = GA_NS % 'goal'
+ destination = Destination
+ engagement = Engagement
+ number = 'number'
+ name = 'name'
+ value = 'value'
+ active = 'active'
+
+
+class CustomVariable(atom.core.XmlElement):
+ """Analytics Data Feed <dxp:customVariable>"""
+ _qname = GA_NS % 'customVariable'
+ index = 'index'
+ name = 'name'
+ scope = 'scope'
+
+
+class DataSource(atom.core.XmlElement, GetProperty):
+ """Analytics Data Feed <dxp:dataSource>"""
+ _qname = DXP_NS % 'dataSource'
+ table_id = TableId
+ table_name = TableName
+ property = [Property]
+
+
+class Dimension(atom.core.XmlElement):
+ """Analytics Feed <dxp:dimension>"""
+ _qname = DXP_NS % 'dimension'
+ name = 'name'
+ value = 'value'
+
+
+class AnalyticsLink(atom.data.Link):
+ """Subclass of link <link>"""
+ target_kind = GD_NS % 'targetKind'
+
+ @classmethod
+ def parent(cls):
+ """Parent target_kind"""
+ return '%s#parent' % GA_NS[1:-3]
+
+ @classmethod
+ def child(cls):
+ """Child target_kind"""
+ return '%s#child' % GA_NS[1:-3]
+
+
+# Account Feed.
+class AccountEntry(gdata.data.GDEntry, GetProperty):
+ """Analytics Account Feed <entry>"""
+ _qname = atom.data.ATOM_TEMPLATE % 'entry'
+ table_id = TableId
+ property = [Property]
+ goal = [Goal]
+ custom_variable = [CustomVariable]
+
+
+class AccountFeed(gdata.data.GDFeed):
+ """Analytics Account Feed <feed>"""
+ _qname = atom.data.ATOM_TEMPLATE % 'feed'
+ segment = [Segment]
+ entry = [AccountEntry]
+
+
+# Data Feed.
+class DataEntry(gdata.data.GDEntry, GetMetric, GetDimension):
+ """Analytics Data Feed <entry>"""
+ _qname = atom.data.ATOM_TEMPLATE % 'entry'
+ dimension = [Dimension]
+ metric = [Metric]
+
+ def get_object(self, name):
+ """Returns either a Dimension or Metric object with the same name as the
+ name parameter.
+
+ Args:
+ name: string The name of the object to retrieve.
+
+ Returns:
+ Either a Dimension or Object that has the same as the name parameter.
+ """
+
+ output = self.GetDimension(name)
+ if not output:
+ output = self.GetMetric(name)
+
+ return output
+
+ GetObject = get_object
+
+
+class DataFeed(gdata.data.GDFeed):
+ """Analytics Data Feed <feed>.
+
+ Although there is only one datasource, it is stored in an array to replicate
+ the design of the Java client library and ensure backwards compatibility if
+ new data sources are added in the future.
+ """
+
+ _qname = atom.data.ATOM_TEMPLATE % 'feed'
+ start_date = StartDate
+ end_date = EndDate
+ aggregates = Aggregates
+ contains_sampled_data = ContainsSampledData
+ data_source = [DataSource]
+ entry = [DataEntry]
+ segment = Segment
+
+ def has_sampled_data(self):
+ """Returns whether this feed has sampled data."""
+ if (self.contains_sampled_data.text == 'true'):
+ return True
+ return False
+
+ HasSampledData = has_sampled_data
+
+
+# Management Feed.
+class ManagementEntry(gdata.data.GDEntry, GetProperty, GaLinkFinder):
+ """Analytics Managememt Entry <entry>."""
+
+ _qname = atom.data.ATOM_TEMPLATE % 'entry'
+ kind = GD_NS % 'kind'
+ property = [Property]
+ goal = Goal
+ segment = Segment
+ link = [AnalyticsLink]
+
+
+class ManagementFeed(gdata.data.GDFeed):
+ """Analytics Management Feed <feed>.
+
+ This class holds the data for all 5 Management API feeds: Account,
+ Web Property, Profile, Goal, and Advanced Segment Feeds.
+ """
+
+ _qname = atom.data.ATOM_TEMPLATE % 'feed'
+ entry = [ManagementEntry]
+ kind = GD_NS % 'kind'
diff --git a/src/gdata/analytics/service.py b/src/gdata/analytics/service.py
new file mode 100644
index 0000000..0638b48
--- /dev/null
+++ b/src/gdata/analytics/service.py
@@ -0,0 +1,331 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+# Refactored in 2009 to work for Google Analytics by Sal Uryasev at Juice Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+ AccountsService extends the GDataService to streamline Google Analytics
+ account information operations.
+
+ AnalyticsDataService: Provides methods to query google analytics data feeds.
+ Extends GDataService.
+
+ DataQuery: Queries a Google Analytics Data list feed.
+
+ AccountQuery: Queries a Google Analytics Account list feed.
+"""
+
+
+__author__ = 'api.suryasev (Sal Uryasev)'
+
+
+import urllib
+import atom
+import gdata.service
+import gdata.analytics
+
+
+class AccountsService(gdata.service.GDataService):
+
+ """Client extension for the Google Analytics Account List feed."""
+
+ def __init__(self, email="", password=None, source=None,
+ server='www.google.com/analytics', additional_headers=None,
+ **kwargs):
+ """Creates a client for the Google Analytics service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='analytics',
+ source=source, server=server, additional_headers=additional_headers,
+ **kwargs)
+
+ def QueryAccountListFeed(self, uri):
+ """Retrieves an AccountListFeed by retrieving a URI based off the Document
+ List feed, including any query parameters. An AccountListFeed object
+ can be used to construct these parameters.
+
+ Args:
+ uri: string The URI of the feed being retrieved possibly with query
+ parameters.
+
+ Returns:
+ An AccountListFeed object representing the feed returned by the server.
+ """
+ return self.Get(uri, converter=gdata.analytics.AccountListFeedFromString)
+
+ def GetAccountListEntry(self, uri):
+ """Retrieves a particular AccountListEntry by its unique URI.
+
+ Args:
+ uri: string The unique URI of an entry in an Account List feed.
+
+ Returns:
+ An AccountLisFeed object representing the retrieved entry.
+ """
+ return self.Get(uri, converter=gdata.analytics.AccountListEntryFromString)
+
+ def GetAccountList(self, max_results=1000, text_query=None,
+ params=None, categories=None):
+ """Retrieves a feed containing all of a user's accounts and profiles."""
+ q = gdata.analytics.service.AccountQuery(max_results=max_results,
+ text_query=text_query,
+ params=params,
+ categories=categories);
+ return self.QueryAccountListFeed(q.ToUri())
+
+
+
+
+class AnalyticsDataService(gdata.service.GDataService):
+
+ """Client extension for the Google Analytics service Data List feed."""
+
+ def __init__(self, email=None, password=None, source=None,
+ server='www.google.com/analytics', additional_headers=None,
+ **kwargs):
+ """Creates a client for the Google Analytics service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'docs.google.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+
+ gdata.service.GDataService.__init__(self,
+ email=email, password=password, service='analytics', source=source,
+ server=server, additional_headers=additional_headers, **kwargs)
+
+ def GetData(self, ids='', dimensions='', metrics='',
+ sort='', filters='', start_date='',
+ end_date='', start_index='',
+ max_results=''):
+ """Retrieves a feed containing a user's data
+
+ ids: comma-separated string of analytics accounts.
+ dimensions: comma-separated string of dimensions.
+ metrics: comma-separated string of metrics.
+ sort: comma-separated string of dimensions and metrics for sorting.
+ This may be previxed with a minus to sort in reverse order.
+ (e.g. '-ga:keyword')
+ If ommited, the first dimension passed in will be used.
+ filters: comma-separated string of filter parameters.
+ (e.g. 'ga:keyword==google')
+ start_date: start date for data pull.
+ end_date: end date for data pull.
+ start_index: used in combination with max_results to pull more than 1000
+ entries. This defaults to 1.
+ max_results: maximum results that the pull will return. This defaults
+ to, and maxes out at 1000.
+ """
+ q = gdata.analytics.service.DataQuery(ids=ids,
+ dimensions=dimensions,
+ metrics=metrics,
+ filters=filters,
+ sort=sort,
+ start_date=start_date,
+ end_date=end_date,
+ start_index=start_index,
+ max_results=max_results);
+ return self.AnalyticsDataFeed(q.ToUri())
+
+ def AnalyticsDataFeed(self, uri):
+ """Retrieves an AnalyticsListFeed by retrieving a URI based off the
+ Document List feed, including any query parameters. An
+ AnalyticsListFeed object can be used to construct these parameters.
+
+ Args:
+ uri: string The URI of the feed being retrieved possibly with query
+ parameters.
+
+ Returns:
+ An AnalyticsListFeed object representing the feed returned by the
+ server.
+ """
+ return self.Get(uri,
+ converter=gdata.analytics.AnalyticsDataFeedFromString)
+
+ """
+ Account Fetching
+ """
+
+ def QueryAccountListFeed(self, uri):
+ """Retrieves an Account ListFeed by retrieving a URI based off the Account
+ List feed, including any query parameters. A AccountQuery object can
+ be used to construct these parameters.
+
+ Args:
+ uri: string The URI of the feed being retrieved possibly with query
+ parameters.
+
+ Returns:
+ An AccountListFeed object representing the feed returned by the server.
+ """
+ return self.Get(uri, converter=gdata.analytics.AccountListFeedFromString)
+
+ def GetAccountListEntry(self, uri):
+ """Retrieves a particular AccountListEntry by its unique URI.
+
+ Args:
+ uri: string The unique URI of an entry in an Account List feed.
+
+ Returns:
+ An AccountListEntry object representing the retrieved entry.
+ """
+ return self.Get(uri, converter=gdata.analytics.AccountListEntryFromString)
+
+ def GetAccountList(self, username="default", max_results=1000,
+ start_index=1):
+ """Retrieves a feed containing all of a user's accounts and profiles.
+ The username parameter is soon to be deprecated, with 'default'
+ becoming the only allowed parameter.
+ """
+ if not username:
+ raise Exception("username is a required parameter")
+ q = gdata.analytics.service.AccountQuery(username=username,
+ max_results=max_results,
+ start_index=start_index);
+ return self.QueryAccountListFeed(q.ToUri())
+
+class DataQuery(gdata.service.Query):
+ """Object used to construct a URI to a data feed"""
+ def __init__(self, feed='/feeds/data', text_query=None,
+ params=None, categories=None, ids="",
+ dimensions="", metrics="", sort="", filters="",
+ start_date="", end_date="", start_index="",
+ max_results=""):
+ """Constructor for Analytics List Query
+
+ Args:
+ feed: string (optional) The path for the feed. (e.g. '/feeds/data')
+
+ text_query: string (optional) The contents of the q query parameter.
+ This string is URL escaped upon conversion to a URI.
+ params: dict (optional) Parameter value string pairs which become URL
+ params when translated to a URI. These parameters are added to
+ the query's items.
+ categories: list (optional) List of category strings which should be
+ included as query categories. See gdata.service.Query for
+ additional documentation.
+ ids: comma-separated string of analytics accounts.
+ dimensions: comma-separated string of dimensions.
+ metrics: comma-separated string of metrics.
+ sort: comma-separated string of dimensions and metrics.
+ This may be previxed with a minus to sort in reverse order
+ (e.g. '-ga:keyword').
+ If ommited, the first dimension passed in will be used.
+ filters: comma-separated string of filter parameters
+ (e.g. 'ga:keyword==google').
+ start_date: start date for data pull.
+ end_date: end date for data pull.
+ start_index: used in combination with max_results to pull more than 1000
+ entries. This defaults to 1.
+ max_results: maximum results that the pull will return. This defaults
+ to, and maxes out at 1000.
+
+ Yields:
+ A DocumentQuery object used to construct a URI based on the Document
+ List feed.
+ """
+ self.elements = {'ids': ids,
+ 'dimensions': dimensions,
+ 'metrics': metrics,
+ 'sort': sort,
+ 'filters': filters,
+ 'start-date': start_date,
+ 'end-date': end_date,
+ 'start-index': start_index,
+ 'max-results': max_results}
+
+ gdata.service.Query.__init__(self, feed, text_query, params, categories)
+
+ def ToUri(self):
+ """Generates a URI from the query parameters set in the object.
+
+ Returns:
+ A string containing the URI used to retrieve entries from the Analytics
+ List feed.
+ """
+ old_feed = self.feed
+ self.feed = '/'.join([old_feed]) + '?' + \
+ urllib.urlencode(dict([(key, value) for key, value in \
+ self.elements.iteritems() if value]))
+ new_feed = gdata.service.Query.ToUri(self)
+ self.feed = old_feed
+ return new_feed
+
+
+class AccountQuery(gdata.service.Query):
+ """Object used to construct a URI to query the Google Account List feed"""
+ def __init__(self, feed='/feeds/accounts', start_index=1,
+ max_results=1000, username='default', text_query=None,
+ params=None, categories=None):
+ """Constructor for Account List Query
+
+ Args:
+ feed: string (optional) The path for the feed. (e.g. '/feeds/documents')
+ visibility: string (optional) The visibility chosen for the current
+ feed.
+ projection: string (optional) The projection chosen for the current
+ feed.
+ text_query: string (optional) The contents of the q query parameter.
+ This string is URL escaped upon conversion to a URI.
+ params: dict (optional) Parameter value string pairs which become URL
+ params when translated to a URI. These parameters are added to
+ the query's items.
+ categories: list (optional) List of category strings which should be
+ included as query categories. See gdata.service.Query for
+ additional documentation.
+ username: string (deprecated) This value should now always be passed as
+ 'default'.
+
+ Yields:
+ A DocumentQuery object used to construct a URI based on the Document
+ List feed.
+ """
+ self.max_results = max_results
+ self.start_index = start_index
+ self.username = username
+ gdata.service.Query.__init__(self, feed, text_query, params, categories)
+
+ def ToUri(self):
+ """Generates a URI from the query parameters set in the object.
+
+ Returns:
+ A string containing the URI used to retrieve entries from the Account
+ List feed.
+ """
+ old_feed = self.feed
+ self.feed = '/'.join([old_feed, self.username]) + '?' + \
+ '&'.join(['max-results=' + str(self.max_results),
+ 'start-index=' + str(self.start_index)])
+ new_feed = self.feed
+ self.feed = old_feed
+ return new_feed
diff --git a/src/gdata/apps/__init__.py b/src/gdata/apps/__init__.py
new file mode 100644
index 0000000..ebdf98e
--- /dev/null
+++ b/src/gdata/apps/__init__.py
@@ -0,0 +1,526 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 SIOS Technology, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains objects used with Google Apps."""
+
+__author__ = 'tmatsuo@sios.com (Takashi MATSUO)'
+
+
+import atom
+import gdata
+
+
+# XML namespaces which are often used in Google Apps entity.
+APPS_NAMESPACE = 'http://schemas.google.com/apps/2006'
+APPS_TEMPLATE = '{http://schemas.google.com/apps/2006}%s'
+
+
+class EmailList(atom.AtomBase):
+ """The Google Apps EmailList element"""
+
+ _tag = 'emailList'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+
+ def __init__(self, name=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+def EmailListFromString(xml_string):
+ return atom.CreateClassFromXMLString(EmailList, xml_string)
+
+
+class Who(atom.AtomBase):
+ """The Google Apps Who element"""
+
+ _tag = 'who'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['rel'] = 'rel'
+ _attributes['email'] = 'email'
+
+ def __init__(self, rel=None, email=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.rel = rel
+ self.email = email
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+def WhoFromString(xml_string):
+ return atom.CreateClassFromXMLString(Who, xml_string)
+
+
+class Login(atom.AtomBase):
+ """The Google Apps Login element"""
+
+ _tag = 'login'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['userName'] = 'user_name'
+ _attributes['password'] = 'password'
+ _attributes['suspended'] = 'suspended'
+ _attributes['admin'] = 'admin'
+ _attributes['changePasswordAtNextLogin'] = 'change_password'
+ _attributes['agreedToTerms'] = 'agreed_to_terms'
+ _attributes['ipWhitelisted'] = 'ip_whitelisted'
+ _attributes['hashFunctionName'] = 'hash_function_name'
+
+ def __init__(self, user_name=None, password=None, suspended=None,
+ ip_whitelisted=None, hash_function_name=None,
+ admin=None, change_password=None, agreed_to_terms=None,
+ extension_elements=None, extension_attributes=None,
+ text=None):
+ self.user_name = user_name
+ self.password = password
+ self.suspended = suspended
+ self.admin = admin
+ self.change_password = change_password
+ self.agreed_to_terms = agreed_to_terms
+ self.ip_whitelisted = ip_whitelisted
+ self.hash_function_name = hash_function_name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def LoginFromString(xml_string):
+ return atom.CreateClassFromXMLString(Login, xml_string)
+
+
+class Quota(atom.AtomBase):
+ """The Google Apps Quota element"""
+
+ _tag = 'quota'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['limit'] = 'limit'
+
+ def __init__(self, limit=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.limit = limit
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def QuotaFromString(xml_string):
+ return atom.CreateClassFromXMLString(Quota, xml_string)
+
+
+class Name(atom.AtomBase):
+ """The Google Apps Name element"""
+
+ _tag = 'name'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['familyName'] = 'family_name'
+ _attributes['givenName'] = 'given_name'
+
+ def __init__(self, family_name=None, given_name=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.family_name = family_name
+ self.given_name = given_name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def NameFromString(xml_string):
+ return atom.CreateClassFromXMLString(Name, xml_string)
+
+
+class Nickname(atom.AtomBase):
+ """The Google Apps Nickname element"""
+
+ _tag = 'nickname'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+
+ def __init__(self, name=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.name = name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def NicknameFromString(xml_string):
+ return atom.CreateClassFromXMLString(Nickname, xml_string)
+
+
+class NicknameEntry(gdata.GDataEntry):
+ """A Google Apps flavor of an Atom Entry for Nickname"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}login' % APPS_NAMESPACE] = ('login', Login)
+ _children['{%s}nickname' % APPS_NAMESPACE] = ('nickname', Nickname)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ login=None, nickname=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.login = login
+ self.nickname = nickname
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def NicknameEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(NicknameEntry, xml_string)
+
+
+class NicknameFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Apps Nickname feed flavor of an Atom Feed"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [NicknameEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def NicknameFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(NicknameFeed, xml_string)
+
+
+class UserEntry(gdata.GDataEntry):
+ """A Google Apps flavor of an Atom Entry"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}login' % APPS_NAMESPACE] = ('login', Login)
+ _children['{%s}name' % APPS_NAMESPACE] = ('name', Name)
+ _children['{%s}quota' % APPS_NAMESPACE] = ('quota', Quota)
+ # This child may already be defined in GDataEntry, confirm before removing.
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feed_link',
+ [gdata.FeedLink])
+ _children['{%s}who' % gdata.GDATA_NAMESPACE] = ('who', Who)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ login=None, name=None, quota=None, who=None, feed_link=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.login = login
+ self.name = name
+ self.quota = quota
+ self.who = who
+ self.feed_link = feed_link or []
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def UserEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(UserEntry, xml_string)
+
+
+class UserFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Apps User feed flavor of an Atom Feed"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [UserEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def UserFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(UserFeed, xml_string)
+
+
+class EmailListEntry(gdata.GDataEntry):
+ """A Google Apps EmailList flavor of an Atom Entry"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}emailList' % APPS_NAMESPACE] = ('email_list', EmailList)
+ # Might be able to remove this _children entry.
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feed_link',
+ [gdata.FeedLink])
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ email_list=None, feed_link=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.email_list = email_list
+ self.feed_link = feed_link or []
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def EmailListEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(EmailListEntry, xml_string)
+
+
+class EmailListFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Apps EmailList feed flavor of an Atom Feed"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [EmailListEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def EmailListFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(EmailListFeed, xml_string)
+
+
+class EmailListRecipientEntry(gdata.GDataEntry):
+ """A Google Apps EmailListRecipient flavor of an Atom Entry"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}who' % gdata.GDATA_NAMESPACE] = ('who', Who)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ who=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.who = who
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def EmailListRecipientEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(EmailListRecipientEntry, xml_string)
+
+
+class EmailListRecipientFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Apps EmailListRecipient feed flavor of an Atom Feed"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [EmailListRecipientEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def EmailListRecipientFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(EmailListRecipientFeed, xml_string)
+
+
+class Property(atom.AtomBase):
+ """The Google Apps Property element"""
+
+ _tag = 'property'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+ _attributes['value'] = 'value'
+
+ def __init__(self, name=None, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def PropertyFromString(xml_string):
+ return atom.CreateClassFromXMLString(Property, xml_string)
+
+
+class PropertyEntry(gdata.GDataEntry):
+ """A Google Apps Property flavor of an Atom Entry"""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}property' % APPS_NAMESPACE] = ('property', [Property])
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ property=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.property = property
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def PropertyEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(PropertyEntry, xml_string)
+
+class PropertyFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Apps Property feed flavor of an Atom Feed"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [PropertyEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+def PropertyFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(PropertyFeed, xml_string)
diff --git a/src/gdata/apps/adminsettings/__init__.py b/src/gdata/apps/adminsettings/__init__.py
new file mode 100644
index 0000000..d284c7c
--- /dev/null
+++ b/src/gdata/apps/adminsettings/__init__.py
@@ -0,0 +1,16 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
diff --git a/src/gdata/apps/adminsettings/service.py b/src/gdata/apps/adminsettings/service.py
new file mode 100644
index 0000000..a15b54e
--- /dev/null
+++ b/src/gdata/apps/adminsettings/service.py
@@ -0,0 +1,471 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Allow Google Apps domain administrators to set domain admin settings.
+
+ AdminSettingsService: Set admin settings."""
+
+__author__ = 'jlee@pbu.edu'
+
+
+import gdata.apps
+import gdata.apps.service
+import gdata.service
+
+
+API_VER='2.0'
+
+class AdminSettingsService(gdata.apps.service.PropertyService):
+ """Client for the Google Apps Admin Settings service."""
+
+ def _serviceUrl(self, setting_id, domain=None):
+ if domain is None:
+ domain = self.domain
+ return '/a/feeds/domain/%s/%s/%s' % (API_VER, domain, setting_id)
+
+ def genericGet(self, location):
+ """Generic HTTP Get Wrapper
+
+ Args:
+ location: relative uri to Get
+
+ Returns:
+ A dict containing the result of the get operation."""
+
+ uri = self._serviceUrl(location)
+ try:
+ return self._GetProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def GetDefaultLanguage(self):
+ """Gets Domain Default Language
+
+ Args:
+ None
+
+ Returns:
+ Default Language as a string. All possible values are listed at:
+ http://code.google.com/apis/apps/email_settings/developers_guide_protocol.html#GA_email_language_tags"""
+
+ result = self.genericGet('general/defaultLanguage')
+ return result['defaultLanguage']
+
+ def UpdateDefaultLanguage(self, defaultLanguage):
+ """Updates Domain Default Language
+
+ Args:
+ defaultLanguage: Domain Language to set
+ possible values are at:
+ http://code.google.com/apis/apps/email_settings/developers_guide_protocol.html#GA_email_language_tags
+
+ Returns:
+ A dict containing the result of the put operation"""
+
+ uri = self._serviceUrl('general/defaultLanguage')
+ properties = {'defaultLanguage': defaultLanguage}
+ return self._PutProperties(uri, properties)
+
+ def GetOrganizationName(self):
+ """Gets Domain Default Language
+
+ Args:
+ None
+
+ Returns:
+ Organization Name as a string."""
+
+ result = self.genericGet('general/organizationName')
+ return result['organizationName']
+
+
+ def UpdateOrganizationName(self, organizationName):
+ """Updates Organization Name
+
+ Args:
+ organizationName: Name of organization
+
+ Returns:
+ A dict containing the result of the put operation"""
+
+ uri = self._serviceUrl('general/organizationName')
+ properties = {'organizationName': organizationName}
+ return self._PutProperties(uri, properties)
+
+ def GetMaximumNumberOfUsers(self):
+ """Gets Maximum Number of Users Allowed
+
+ Args:
+ None
+
+ Returns: An integer, the maximum number of users"""
+
+ result = self.genericGet('general/maximumNumberOfUsers')
+ return int(result['maximumNumberOfUsers'])
+
+ def GetCurrentNumberOfUsers(self):
+ """Gets Current Number of Users
+
+ Args:
+ None
+
+ Returns: An integer, the current number of users"""
+
+ result = self.genericGet('general/currentNumberOfUsers')
+ return int(result['currentNumberOfUsers'])
+
+ def IsDomainVerified(self):
+ """Is the domain verified
+
+ Args:
+ None
+
+ Returns: Boolean, is domain verified"""
+
+ result = self.genericGet('accountInformation/isVerified')
+ if result['isVerified'] == 'true':
+ return True
+ else:
+ return False
+
+ def GetSupportPIN(self):
+ """Gets Support PIN
+
+ Args:
+ None
+
+ Returns: A string, the Support PIN"""
+
+ result = self.genericGet('accountInformation/supportPIN')
+ return result['supportPIN']
+
+ def GetEdition(self):
+ """Gets Google Apps Domain Edition
+
+ Args:
+ None
+
+ Returns: A string, the domain's edition (premier, education, partner)"""
+
+ result = self.genericGet('accountInformation/edition')
+ return result['edition']
+
+ def GetCustomerPIN(self):
+ """Gets Customer PIN
+
+ Args:
+ None
+
+ Returns: A string, the customer PIN"""
+
+ result = self.genericGet('accountInformation/customerPIN')
+ return result['customerPIN']
+
+ def GetCreationTime(self):
+ """Gets Domain Creation Time
+
+ Args:
+ None
+
+ Returns: A string, the domain's creation time"""
+
+ result = self.genericGet('accountInformation/creationTime')
+ return result['creationTime']
+
+ def GetCountryCode(self):
+ """Gets Domain Country Code
+
+ Args:
+ None
+
+ Returns: A string, the domain's country code. Possible values at:
+ http://www.iso.org/iso/country_codes/iso_3166_code_lists/english_country_names_and_code_elements.htm"""
+
+ result = self.genericGet('accountInformation/countryCode')
+ return result['countryCode']
+
+ def GetAdminSecondaryEmail(self):
+ """Gets Domain Admin Secondary Email Address
+
+ Args:
+ None
+
+ Returns: A string, the secondary email address for domain admin"""
+
+ result = self.genericGet('accountInformation/adminSecondaryEmail')
+ return result['adminSecondaryEmail']
+
+ def UpdateAdminSecondaryEmail(self, adminSecondaryEmail):
+ """Gets Domain Creation Time
+
+ Args:
+ adminSecondaryEmail: string, secondary email address of admin
+
+ Returns: A dict containing the result of the put operation"""
+
+ uri = self._serviceUrl('accountInformation/adminSecondaryEmail')
+ properties = {'adminSecondaryEmail': adminSecondaryEmail}
+ return self._PutProperties(uri, properties)
+
+ def GetDomainLogo(self):
+ """Gets Domain Logo
+
+ This function does not make use of the Google Apps Admin Settings API,
+ it does an HTTP Get of a url specific to the Google Apps domain. It is
+ included for completeness sake.
+
+ Args:
+ None
+
+ Returns: binary image file"""
+
+ import urllib
+ url = 'http://www.google.com/a/cpanel/'+self.domain+'/images/logo.gif'
+ response = urllib.urlopen(url)
+ return response.read()
+
+ def UpdateDomainLogo(self, logoImage):
+ """Update Domain's Custom Logo
+
+ Args:
+ logoImage: binary image data
+
+ Returns: A dict containing the result of the put operation"""
+
+ from base64 import b64encode
+ uri = self._serviceUrl('appearance/customLogo')
+ properties = {'logoImage': b64encode(logoImage)}
+ return self._PutProperties(uri, properties)
+
+ def GetCNAMEVerificationStatus(self):
+ """Gets Domain CNAME Verification Status
+
+ Args:
+ None
+
+ Returns: A dict {recordName, verified, verifiedMethod}"""
+
+ return self.genericGet('verification/cname')
+
+ def UpdateCNAMEVerificationStatus(self, verified):
+ """Updates CNAME Verification Status
+
+ Args:
+ verified: boolean, True will retry verification process
+
+ Returns: A dict containing the result of the put operation"""
+
+ uri = self._serviceUrl('verification/cname')
+ properties = self.GetCNAMEVerificationStatus()
+ properties['verified'] = verified
+ return self._PutProperties(uri, properties)
+
+ def GetMXVerificationStatus(self):
+ """Gets Domain MX Verification Status
+
+ Args:
+ None
+
+ Returns: A dict {verified, verifiedMethod}"""
+
+ return self.genericGet('verification/mx')
+
+ def UpdateMXVerificationStatus(self, verified):
+ """Updates MX Verification Status
+
+ Args:
+ verified: boolean, True will retry verification process
+
+ Returns: A dict containing the result of the put operation"""
+
+ uri = self._serviceUrl('verification/mx')
+ properties = self.GetMXVerificationStatus()
+ properties['verified'] = verified
+ return self._PutProperties(uri, properties)
+
+ def GetSSOSettings(self):
+ """Gets Domain Single Sign-On Settings
+
+ Args:
+ None
+
+ Returns: A dict {samlSignonUri, samlLogoutUri, changePasswordUri, enableSSO, ssoWhitelist, useDomainSpecificIssuer}"""
+
+ return self.genericGet('sso/general')
+
+ def UpdateSSOSettings(self, enableSSO=None, samlSignonUri=None,
+ samlLogoutUri=None, changePasswordUri=None,
+ ssoWhitelist=None, useDomainSpecificIssuer=None):
+ """Update SSO Settings.
+
+ Args:
+ enableSSO: boolean, SSO Master on/off switch
+ samlSignonUri: string, SSO Login Page
+ samlLogoutUri: string, SSO Logout Page
+ samlPasswordUri: string, SSO Password Change Page
+ ssoWhitelist: string, Range of IP Addresses which will see SSO
+ useDomainSpecificIssuer: boolean, Include Google Apps Domain in Issuer
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('sso/general')
+
+ #Get current settings, replace Nones with ''
+ properties = self.GetSSOSettings()
+ if properties['samlSignonUri'] == None:
+ properties['samlSignonUri'] = ''
+ if properties['samlLogoutUri'] == None:
+ properties['samlLogoutUri'] = ''
+ if properties['changePasswordUri'] == None:
+ properties['changePasswordUri'] = ''
+ if properties['ssoWhitelist'] == None:
+ properties['ssoWhitelist'] = ''
+
+ #update only the values we were passed
+ if enableSSO != None:
+ properties['enableSSO'] = gdata.apps.service._bool2str(enableSSO)
+ if samlSignonUri != None:
+ properties['samlSignonUri'] = samlSignonUri
+ if samlLogoutUri != None:
+ properties['samlLogoutUri'] = samlLogoutUri
+ if changePasswordUri != None:
+ properties['changePasswordUri'] = changePasswordUri
+ if ssoWhitelist != None:
+ properties['ssoWhitelist'] = ssoWhitelist
+ if useDomainSpecificIssuer != None:
+ properties['useDomainSpecificIssuer'] = gdata.apps.service._bool2str(useDomainSpecificIssuer)
+
+ return self._PutProperties(uri, properties)
+
+ def GetSSOKey(self):
+ """Gets Domain Single Sign-On Signing Key
+
+ Args:
+ None
+
+ Returns: A dict {modulus, exponent, algorithm, format}"""
+
+ return self.genericGet('sso/signingkey')
+
+ def UpdateSSOKey(self, signingKey):
+ """Update SSO Settings.
+
+ Args:
+ signingKey: string, public key to be uploaded
+
+ Returns:
+ A dict containing the result of the update operation."""
+
+ uri = self._serviceUrl('sso/signingkey')
+ properties = {'signingKey': signingKey}
+ return self._PutProperties(uri, properties)
+
+ def IsUserMigrationEnabled(self):
+ """Is User Migration Enabled
+
+ Args:
+ None
+
+ Returns:
+ boolean, is user migration enabled"""
+
+ result = self.genericGet('email/migration')
+ if result['enableUserMigration'] == 'true':
+ return True
+ else:
+ return False
+
+ def UpdateUserMigrationStatus(self, enableUserMigration):
+ """Update User Migration Status
+
+ Args:
+ enableUserMigration: boolean, user migration enable/disable
+
+ Returns:
+ A dict containing the result of the update operation."""
+
+ uri = self._serviceUrl('email/migration')
+ properties = {'enableUserMigration': enableUserMigration}
+ return self._PutProperties(uri, properties)
+
+ def GetOutboundGatewaySettings(self):
+ """Get Outbound Gateway Settings
+
+ Args:
+ None
+
+ Returns:
+ A dict {smartHost, smtpMode}"""
+
+ uri = self._serviceUrl('email/gateway')
+ try:
+ return self._GetProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+ except TypeError:
+ #if no outbound gateway is set, we get a TypeError,
+ #catch it and return nothing...
+ return {'smartHost': None, 'smtpMode': None}
+
+ def UpdateOutboundGatewaySettings(self, smartHost=None, smtpMode=None):
+ """Update Outbound Gateway Settings
+
+ Args:
+ smartHost: string, ip address or hostname of outbound gateway
+ smtpMode: string, SMTP or SMTP_TLS
+
+ Returns:
+ A dict containing the result of the update operation."""
+
+ uri = self._serviceUrl('email/gateway')
+
+ #Get current settings, replace Nones with ''
+ properties = GetOutboundGatewaySettings()
+ if properties['smartHost'] == None:
+ properties['smartHost'] = ''
+ if properties['smtpMode'] == None:
+ properties['smtpMode'] = ''
+
+ #If we were passed new values for smartHost or smtpMode, update them
+ if smartHost != None:
+ properties['smartHost'] = smartHost
+ if smtpMode != None:
+ properties['smtpMode'] = smtpMode
+
+ return self._PutProperties(uri, properties)
+
+ def AddEmailRoute(self, routeDestination, routeRewriteTo, routeEnabled, bounceNotifications, accountHandling):
+ """Adds Domain Email Route
+
+ Args:
+ routeDestination: string, destination ip address or hostname
+ routeRewriteTo: boolean, rewrite smtp envelop To:
+ routeEnabled: boolean, enable disable email routing
+ bounceNotifications: boolean, send bound notificiations to sender
+ accountHandling: string, which to route, "allAccounts", "provisionedAccounts", "unknownAccounts"
+
+ Returns:
+ A dict containing the result of the update operation."""
+
+ uri = self._serviceUrl('emailrouting')
+ properties = {}
+ properties['routeDestination'] = routeDestination
+ properties['routeRewriteTo'] = gdata.apps.service._bool2str(routeRewriteTo)
+ properties['routeEnabled'] = gdata.apps.service._bool2str(routeEnabled)
+ properties['bounceNotifications'] = gdata.apps.service._bool2str(bounceNotifications)
+ properties['accountHandling'] = accountHandling
+ return self._PostProperties(uri, properties)
diff --git a/src/gdata/apps/apps_property_entry.py b/src/gdata/apps/apps_property_entry.py
new file mode 100644
index 0000000..3177fb8
--- /dev/null
+++ b/src/gdata/apps/apps_property_entry.py
@@ -0,0 +1,65 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Generic class for Set/Get properties of GData Provisioning clients."""
+
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+
+import gdata.apps
+import gdata.apps_property
+import gdata.data
+
+
+class AppsPropertyEntry(gdata.data.GDEntry):
+ """Represents a generic entry in object form."""
+
+ property = [gdata.apps_property.AppsProperty]
+
+ def _GetProperty(self, name):
+ """Get the apps:property value with the given name.
+
+ Args:
+ name: string Name of the apps:property value to get.
+
+ Returns:
+ The apps:property value with the given name, or None if the name was
+ invalid.
+ """
+ value = None
+ for p in self.property:
+ if p.name == name:
+ value = p.value
+ break
+ return value
+
+ def _SetProperty(self, name, value):
+ """Set the apps:property value with the given name to the given value.
+
+ Args:
+ name: string Name of the apps:property value to set.
+ value: string Value to give the apps:property value with the given name.
+ """
+ found = False
+ for i in range(len(self.property)):
+ if self.property[i].name == name:
+ self.property[i].value = value
+ found = True
+ break
+ if not found:
+ self.property.append(
+ gdata.apps_property.AppsProperty(name=name, value=value))
diff --git a/src/gdata/apps/audit/__init__.py b/src/gdata/apps/audit/__init__.py
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/src/gdata/apps/audit/__init__.py
@@ -0,0 +1 @@
+
diff --git a/src/gdata/apps/audit/service.py b/src/gdata/apps/audit/service.py
new file mode 100644
index 0000000..d8cf72c
--- /dev/null
+++ b/src/gdata/apps/audit/service.py
@@ -0,0 +1,277 @@
+# Copyright (C) 2008 Google, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Allow Google Apps domain administrators to audit user data.
+
+ AuditService: Set auditing."""
+
+__author__ = 'jlee@pbu.edu'
+
+from base64 import b64encode
+
+import gdata.apps
+import gdata.apps.service
+import gdata.service
+
+class AuditService(gdata.apps.service.PropertyService):
+ """Client for the Google Apps Audit service."""
+
+ def _serviceUrl(self, setting_id, domain=None, user=None):
+ if domain is None:
+ domain = self.domain
+ if user is None:
+ return '/a/feeds/compliance/audit/%s/%s' % (setting_id, domain)
+ else:
+ return '/a/feeds/compliance/audit/%s/%s/%s' % (setting_id, domain, user)
+
+ def updatePGPKey(self, pgpkey):
+ """Updates Public PGP Key Google uses to encrypt audit data
+
+ Args:
+ pgpkey: string, ASCII text of PGP Public Key to be used
+
+ Returns:
+ A dict containing the result of the POST operation."""
+
+ uri = self._serviceUrl('publickey')
+ b64pgpkey = b64encode(pgpkey)
+ properties = {}
+ properties['publicKey'] = b64pgpkey
+ return self._PostProperties(uri, properties)
+
+ def createEmailMonitor(self, source_user, destination_user, end_date,
+ begin_date=None, incoming_headers_only=False,
+ outgoing_headers_only=False, drafts=False,
+ drafts_headers_only=False, chats=False,
+ chats_headers_only=False):
+ """Creates a email monitor, forwarding the source_users emails/chats
+
+ Args:
+ source_user: string, the user whose email will be audited
+ destination_user: string, the user to receive the audited email
+ end_date: string, the date the audit will end in
+ "yyyy-MM-dd HH:mm" format, required
+ begin_date: string, the date the audit will start in
+ "yyyy-MM-dd HH:mm" format, leave blank to use current time
+ incoming_headers_only: boolean, whether to audit only the headers of
+ mail delivered to source user
+ outgoing_headers_only: boolean, whether to audit only the headers of
+ mail sent from the source user
+ drafts: boolean, whether to audit draft messages of the source user
+ drafts_headers_only: boolean, whether to audit only the headers of
+ mail drafts saved by the user
+ chats: boolean, whether to audit archived chats of the source user
+ chats_headers_only: boolean, whether to audit only the headers of
+ archived chats of the source user
+
+ Returns:
+ A dict containing the result of the POST operation."""
+
+ uri = self._serviceUrl('mail/monitor', user=source_user)
+ properties = {}
+ properties['destUserName'] = destination_user
+ if begin_date is not None:
+ properties['beginDate'] = begin_date
+ properties['endDate'] = end_date
+ if incoming_headers_only:
+ properties['incomingEmailMonitorLevel'] = 'HEADER_ONLY'
+ else:
+ properties['incomingEmailMonitorLevel'] = 'FULL_MESSAGE'
+ if outgoing_headers_only:
+ properties['outgoingEmailMonitorLevel'] = 'HEADER_ONLY'
+ else:
+ properties['outgoingEmailMonitorLevel'] = 'FULL_MESSAGE'
+ if drafts:
+ if drafts_headers_only:
+ properties['draftMonitorLevel'] = 'HEADER_ONLY'
+ else:
+ properties['draftMonitorLevel'] = 'FULL_MESSAGE'
+ if chats:
+ if chats_headers_only:
+ properties['chatMonitorLevel'] = 'HEADER_ONLY'
+ else:
+ properties['chatMonitorLevel'] = 'FULL_MESSAGE'
+ return self._PostProperties(uri, properties)
+
+ def getEmailMonitors(self, user):
+ """"Gets the email monitors for the given user
+
+ Args:
+ user: string, the user to retrieve email monitors for
+
+ Returns:
+ list results of the POST operation
+
+ """
+ uri = self._serviceUrl('mail/monitor', user=user)
+ return self._GetPropertiesList(uri)
+
+ def deleteEmailMonitor(self, source_user, destination_user):
+ """Deletes the email monitor for the given user
+
+ Args:
+ source_user: string, the user who is being monitored
+ destination_user: string, theuser who recieves the monitored emails
+
+ Returns:
+ Nothing
+ """
+
+ uri = self._serviceUrl('mail/monitor', user=source_user+'/'+destination_user)
+ try:
+ return self._DeleteProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def createAccountInformationRequest(self, user):
+ """Creates a request for account auditing details
+
+ Args:
+ user: string, the user to request account information for
+
+ Returns:
+ A dict containing the result of the post operation."""
+
+ uri = self._serviceUrl('account', user=user)
+ properties = {}
+ #XML Body is left empty
+ try:
+ return self._PostProperties(uri, properties)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def getAccountInformationRequestStatus(self, user, request_id):
+ """Gets the status of an account auditing request
+
+ Args:
+ user: string, the user whose account auditing details were requested
+ request_id: string, the request_id
+
+ Returns:
+ A dict containing the result of the get operation."""
+
+ uri = self._serviceUrl('account', user=user+'/'+request_id)
+ try:
+ return self._GetProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def getAllAccountInformationRequestsStatus(self):
+ """Gets the status of all account auditing requests for the domain
+
+ Args:
+ None
+
+ Returns:
+ list results of the POST operation
+ """
+
+ uri = self._serviceUrl('account')
+ return self._GetPropertiesList(uri)
+
+
+ def deleteAccountInformationRequest(self, user, request_id):
+ """Deletes the request for account auditing information
+
+ Args:
+ user: string, the user whose account auditing details were requested
+ request_id: string, the request_id
+
+ Returns:
+ Nothing
+ """
+
+ uri = self._serviceUrl('account', user=user+'/'+request_id)
+ try:
+ return self._DeleteProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def createMailboxExportRequest(self, user, begin_date=None, end_date=None, include_deleted=False, search_query=None, headers_only=False):
+ """Creates a mailbox export request
+
+ Args:
+ user: string, the user whose mailbox export is being requested
+ begin_date: string, date of earliest emails to export, optional, defaults to date of account creation
+ format is 'yyyy-MM-dd HH:mm'
+ end_date: string, date of latest emails to export, optional, defaults to current date
+ format is 'yyyy-MM-dd HH:mm'
+ include_deleted: boolean, whether to include deleted emails in export, mutually exclusive with search_query
+ search_query: string, gmail style search query, matched emails will be exported, mutually exclusive with include_deleted
+
+ Returns:
+ A dict containing the result of the post operation."""
+
+ uri = self._serviceUrl('mail/export', user=user)
+ properties = {}
+ if begin_date is not None:
+ properties['beginDate'] = begin_date
+ if end_date is not None:
+ properties['endDate'] = end_date
+ if include_deleted is not None:
+ properties['includeDeleted'] = gdata.apps.service._bool2str(include_deleted)
+ if search_query is not None:
+ properties['searchQuery'] = search_query
+ if headers_only is True:
+ properties['packageContent'] = 'HEADER_ONLY'
+ else:
+ properties['packageContent'] = 'FULL_MESSAGE'
+ return self._PostProperties(uri, properties)
+
+ def getMailboxExportRequestStatus(self, user, request_id):
+ """Gets the status of an mailbox export request
+
+ Args:
+ user: string, the user whose mailbox were requested
+ request_id: string, the request_id
+
+ Returns:
+ A dict containing the result of the get operation."""
+
+ uri = self._serviceUrl('mail/export', user=user+'/'+request_id)
+ try:
+ return self._GetProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def getAllMailboxExportRequestsStatus(self):
+ """Gets the status of all mailbox export requests for the domain
+
+ Args:
+ None
+
+ Returns:
+ list results of the POST operation
+ """
+
+ uri = self._serviceUrl('mail/export')
+ return self._GetPropertiesList(uri)
+
+
+ def deleteMailboxExportRequest(self, user, request_id):
+ """Deletes the request for mailbox export
+
+ Args:
+ user: string, the user whose mailbox were requested
+ request_id: string, the request_id
+
+ Returns:
+ Nothing
+ """
+
+ uri = self._serviceUrl('mail/export', user=user+'/'+request_id)
+ try:
+ return self._DeleteProperties(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
diff --git a/src/gdata/apps/client.py b/src/gdata/apps/client.py
new file mode 100755
index 0000000..7845988
--- /dev/null
+++ b/src/gdata/apps/client.py
@@ -0,0 +1,203 @@
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""AppsClient adds Client Architecture to Provisioning API."""
+
+
+__author__ = '<Shraddha Gupta shraddhag@google.com>'
+
+
+import gdata.apps.data
+import gdata.client
+import gdata.service
+
+
+class AppsClient(gdata.client.GDClient):
+ """Client extension for the Google Provisioning API service.
+
+ Attributes:
+ host: string The hostname for the Provisioning API service.
+ api_version: string The version of the Provisioning API.
+ """
+
+ host = 'apps-apis.google.com'
+ api_version = '2.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the Provisioning API.
+
+ Args:
+ domain: string Google Apps domain name.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes client to make calls to Provisioning API.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def _baseURL(self):
+ return '/a/feeds/%s' % self.domain
+
+ def _userURL(self):
+ return '%s/user/%s' % (self._baseURL(), self.api_version)
+
+ def _nicknameURL(self):
+ return '%s/nickname/%s' % (self._baseURL(), self.api_version)
+
+ def RetrieveAllPages(self, feed, desired_class=gdata.data.GDFeed):
+ """Retrieve all pages and add all elements.
+
+ Args:
+ feed: gdata.data.GDFeed object with linked elements.
+ desired_class: type of feed to be returned.
+
+ Returns:
+ desired_class: subclass of gdata.data.GDFeed.
+ """
+
+ next = feed.GetNextLink()
+ while next is not None:
+ next_feed = self.GetFeed(next.href, desired_class=desired_class)
+ for a_entry in next_feed.entry:
+ feed.entry.append(a_entry)
+ next = next_feed.GetNextLink()
+ return feed
+
+ def CreateUser(self, user_name, family_name, given_name, password,
+ suspended=False, admin=None, quota_limit=None,
+ password_hash_function=None,
+ agreed_to_terms=None, change_password=None):
+ """Create a user account."""
+
+ uri = self._userURL()
+ user_entry = gdata.apps.data.UserEntry()
+ user_entry.login = gdata.apps.data.Login(user_name=user_name,
+ password=password, suspended=suspended, admin=admin,
+ hash_function_name=password_hash_function,
+ agreed_to_terms=agreed_to_terms,
+ change_password=change_password)
+ user_entry.name = gdata.apps.data.Name(family_name=family_name,
+ given_name=given_name)
+ return self.Post(user_entry, uri)
+
+ def RetrieveUser(self, user_name):
+ """Retrieve a user account.
+
+ Args:
+ user_name: string user_name to be retrieved.
+
+ Returns:
+ gdata.apps.data.UserEntry
+ """
+
+ uri = '%s/%s' % (self._userURL(), user_name)
+ return self.GetEntry(uri, desired_class=gdata.apps.data.UserEntry)
+
+ def RetrievePageOfUsers(self, start_username=None):
+ """Retrieve one page of users in this domain.
+
+ Args:
+ start_username: string user to start from for retrieving a page of users.
+
+ Returns:
+ gdata.apps.data.UserFeed
+ """
+
+ uri = self._userURL()
+ if start_username is not None:
+ uri += '?startUsername=%s' % start_username
+ return self.GetFeed(uri, desired_class=gdata.apps.data.UserFeed)
+
+ def RetrieveAllUsers(self):
+ """Retrieve all users in this domain.
+
+ Returns:
+ gdata.apps.data.UserFeed
+ """
+
+ ret = self.RetrievePageOfUsers()
+ # pagination
+ return self.RetrieveAllPages(ret, gdata.apps.data.UserFeed)
+
+ def UpdateUser(self, user_name, user_entry):
+ """Update a user account.
+
+ Args:
+ user_name: string user_name to be updated.
+ user_entry: gdata.apps.data.UserEntry updated user entry.
+
+ Returns:
+ gdata.apps.data.UserEntry
+ """
+
+ uri = '%s/%s' % (self._userURL(), user_name)
+ return self.Update(entry=user_entry, uri=uri)
+
+ def DeleteUser(self, user_name):
+ """Delete a user account."""
+
+ uri = '%s/%s' % (self._userURL(), user_name)
+ self.Delete(uri)
+
+ def CreateNickname(self, user_name, nickname):
+ """Create a nickname for a user.
+
+ Args:
+ user_name: string user whose nickname is being created.
+ nickname: string nickname.
+
+ Returns:
+ gdata.apps.data.NicknameEntry
+ """
+
+ uri = self._nicknameURL()
+ nickname_entry = gdata.apps.data.NicknameEntry()
+ nickname_entry.login = gdata.apps.data.Login(user_name=user_name)
+ nickname_entry.nickname = gdata.apps.data.Nickname(name=nickname)
+ return self.Post(nickname_entry, uri)
+
+ def RetrieveNickname(self, nickname):
+ """Retrieve a nickname.
+
+ Args:
+ nickname: string nickname to be retrieved.
+
+ Returns:
+ gdata.apps.data.NicknameEntry
+ """
+
+ uri = '%s/%s' % (self._nicknameURL(), nickname)
+ return self.GetEntry(uri, desired_class=gdata.apps.data.NicknameEntry)
+
+ def RetrieveNicknames(self, user_name):
+ """Retrieve nicknames of the user.
+
+ Args:
+ user_name: string user whose nicknames are retrieved.
+
+ Returns:
+ gdata.apps.data.NicknameFeed
+ """
+
+ uri = '%s?username=%s' % (self._nicknameURL(), user_name)
+ ret = self.GetFeed(uri, desired_class=gdata.apps.data.NicknameFeed)
+ # pagination
+ return self.RetrieveAllPages(ret, gdata.apps.data.NicknameFeed)
+
+ def DeleteNickname(self, nickname):
+ """Delete a nickname."""
+
+ uri = '%s/%s' % (self._nicknameURL(), nickname)
+ self.Delete(uri)
diff --git a/src/gdata/apps/data.py b/src/gdata/apps/data.py
new file mode 100644
index 0000000..5ba57a6
--- /dev/null
+++ b/src/gdata/apps/data.py
@@ -0,0 +1,83 @@
+#!/usr/bin/python
+#
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for the Provisioning API."""
+
+
+__author__ = 'Shraddha Gupta shraddhag@google.com>'
+
+
+import atom.core
+import atom.data
+import gdata.apps
+import gdata.data
+
+
+class Login(atom.core.XmlElement):
+
+ _qname = gdata.apps.APPS_TEMPLATE % 'login'
+ user_name = 'userName'
+ password = 'password'
+ hash_function_name = 'hashFunctionName'
+ suspended = 'suspended'
+ admin = 'admin'
+ agreed_to_terms = 'agreedToTerms'
+ change_password = 'changePasswordAtNextLogin'
+ ip_whitelisted = 'ipWhitelisted'
+
+
+class Name(atom.core.XmlElement):
+
+ _qname = gdata.apps.APPS_TEMPLATE % 'name'
+ given_name = 'givenName'
+ family_name = 'familyName'
+
+
+class Quota(atom.core.XmlElement):
+
+ _qname = gdata.apps.APPS_TEMPLATE % 'quota'
+ limit = 'limit'
+
+
+class UserEntry(gdata.data.GDEntry):
+
+ _qname = atom.data.ATOM_TEMPLATE % 'entry'
+ login = Login
+ name = Name
+ quota = Quota
+
+
+class UserFeed(gdata.data.GDFeed):
+
+ entry = [UserEntry]
+
+
+class Nickname(atom.core.XmlElement):
+
+ _qname = gdata.apps.APPS_TEMPLATE % 'nickname'
+ name = 'name'
+
+
+class NicknameEntry(gdata.data.GDEntry):
+
+ _qname = atom.data.ATOM_TEMPLATE % 'entry'
+ nickname = Nickname
+ login = Login
+
+
+class NicknameFeed(gdata.data.GDFeed):
+
+ entry = [NicknameEntry]
diff --git a/src/gdata/apps/emailsettings/__init__.py b/src/gdata/apps/emailsettings/__init__.py
new file mode 100644
index 0000000..275c6a0
--- /dev/null
+++ b/src/gdata/apps/emailsettings/__init__.py
@@ -0,0 +1,15 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/src/gdata/apps/emailsettings/client.py b/src/gdata/apps/emailsettings/client.py
new file mode 100644
index 0000000..c8aa1a9
--- /dev/null
+++ b/src/gdata/apps/emailsettings/client.py
@@ -0,0 +1,625 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""EmailSettingsClient simplifies Email Settings API calls.
+
+EmailSettingsClient extends gdata.client.GDClient to ease interaction with
+the Google Apps Email Settings API. These interactions include the ability
+to create labels, filters, aliases, and update web-clip, forwarding, POP,
+IMAP, vacation-responder, signature, language, and general settings, and
+retrieve labels, send-as, forwarding, pop, imap, vacation and signature
+settings.
+"""
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import urllib
+
+import gdata.apps.emailsettings.data
+import gdata.client
+
+
+# Email Settings URI template
+# The strings in this template are eventually replaced with the API version,
+# Google Apps domain name, username, and settingID, respectively.
+EMAIL_SETTINGS_URI_TEMPLATE = '/a/feeds/emailsettings/%s/%s/%s/%s'
+
+
+# The settingID value for the label requests
+SETTING_ID_LABEL = 'label'
+# The settingID value for the filter requests
+SETTING_ID_FILTER = 'filter'
+# The settingID value for the send-as requests
+SETTING_ID_SENDAS = 'sendas'
+# The settingID value for the webclip requests
+SETTING_ID_WEBCLIP = 'webclip'
+# The settingID value for the forwarding requests
+SETTING_ID_FORWARDING = 'forwarding'
+# The settingID value for the POP requests
+SETTING_ID_POP = 'pop'
+# The settingID value for the IMAP requests
+SETTING_ID_IMAP = 'imap'
+# The settingID value for the vacation responder requests
+SETTING_ID_VACATION_RESPONDER = 'vacation'
+# The settingID value for the signature requests
+SETTING_ID_SIGNATURE = 'signature'
+# The settingID value for the language requests
+SETTING_ID_LANGUAGE = 'language'
+# The settingID value for the general requests
+SETTING_ID_GENERAL = 'general'
+# The settingID value for the delegation requests
+SETTING_ID_DELEGATION = 'delegation'
+
+# The KEEP action for the email settings
+ACTION_KEEP = 'KEEP'
+# The ARCHIVE action for the email settings
+ACTION_ARCHIVE = 'ARCHIVE'
+# The DELETE action for the email settings
+ACTION_DELETE = 'DELETE'
+
+# The ALL_MAIL setting for POP enable_for property
+POP_ENABLE_FOR_ALL_MAIL = 'ALL_MAIL'
+# The MAIL_FROM_NOW_ON setting for POP enable_for property
+POP_ENABLE_FOR_MAIL_FROM_NOW_ON = 'MAIL_FROM_NOW_ON'
+
+
+class EmailSettingsClient(gdata.client.GDClient):
+ """Client extension for the Google Email Settings API service.
+
+ Attributes:
+ host: string The hostname for the Email Settings API service.
+ api_version: string The version of the Email Settings API.
+ """
+
+ host = 'apps-apis.google.com'
+ api_version = '2.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+ ssl = True
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the Email Settings API.
+
+ Args:
+ domain: string The Google Apps domain with Email Settings.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the email settings.
+ kwargs: The other parameters to pass to the gdata.client.GDClient
+ constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def make_email_settings_uri(self, username, setting_id):
+ """Creates the URI for the Email Settings API call.
+
+ Using this client's Google Apps domain, create the URI to setup
+ email settings for the given user in that domain. If params are provided,
+ append them as GET params.
+
+ Args:
+ username: string The name of the user affected by this setting.
+ setting_id: string The key of the setting to be configured.
+
+ Returns:
+ A string giving the URI for Email Settings API calls for this client's
+ Google Apps domain.
+ """
+ if '@' in username:
+ username, domain = username.split('@', 1)
+ else:
+ domain = self.domain
+ uri = EMAIL_SETTINGS_URI_TEMPLATE % (self.api_version, domain,
+ username, setting_id)
+ return uri
+
+ MakeEmailSettingsUri = make_email_settings_uri
+
+ def create_label(self, username, name, **kwargs):
+ """Creates a label with the given properties.
+
+ Args:
+ username: string The name of the user.
+ name: string The name of the label.
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsLabel of the new resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_LABEL)
+ new_label = gdata.apps.emailsettings.data.EmailSettingsLabel(
+ uri=uri, name=name)
+ return self.post(new_label, uri, **kwargs)
+
+ CreateLabel = create_label
+
+ def retrieve_labels(self, username, **kwargs):
+ """Retrieves email labels for the specified username
+
+ Args:
+ username: string The name of the user to get the labels for
+
+ Returns:
+ A gdata.data.GDFeed of the user's email labels
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_LABEL)
+ return self.GetFeed(
+ uri,
+ auth_token=None,
+ query=None,
+ desired_class=gdata.apps.emailsettings.data.EmailSettingsLabelFeed,
+ **kwargs)
+
+ RetrieveLabels = retrieve_labels
+
+ def delete_label(self, username, label, **kwargs):
+ """Delete a label from the specified account.
+
+ Args:
+ username: string Name of the user
+ label: string Name of the label to be deleted
+
+ Returns:
+ An atom.http_core.HttpResponse() with the result of the request
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_LABEL)
+ uri = '/'.join([uri, urllib.quote_plus(label)])
+ return self.delete(uri, **kwargs)
+
+ DeleteLabel = delete_label
+
+ def create_filter(self, username, from_address=None,
+ to_address=None, subject=None, has_the_word=None,
+ does_not_have_the_word=None, has_attachments=None,
+ label=None, mark_as_read=None, archive=None, **kwargs):
+ """Creates a filter with the given properties.
+
+ Args:
+ username: string The name of the user.
+ from_address: string The source email address for the filter.
+ to_address: string (optional) The destination email address for
+ the filter.
+ subject: string (optional) The value the email must have in its
+ subject to be filtered.
+ has_the_word: string (optional) The value the email must have
+ in its subject or body to be filtered.
+ does_not_have_the_word: string (optional) The value the email
+ cannot have in its subject or body to be filtered.
+ has_attachments: string (optional) A boolean string representing
+ whether the email must have an attachment to be filtered.
+ label: string (optional) The name of the label to apply to
+ messages matching the filter criteria.
+ mark_as_read: Boolean (optional) Whether or not to mark
+ messages matching the filter criteria as read.
+ archive: Boolean (optional) Whether or not to move messages
+ matching to Archived state.
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsFilter of the new resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_FILTER)
+ new_filter = gdata.apps.emailsettings.data.EmailSettingsFilter(
+ uri=uri, from_address=from_address,
+ to_address=to_address, subject=subject,
+ has_the_word=has_the_word,
+ does_not_have_the_word=does_not_have_the_word,
+ has_attachments=has_attachments, label=label,
+ mark_as_read=mark_as_read, archive=archive)
+ return self.post(new_filter, uri, **kwargs)
+
+ CreateFilter = create_filter
+
+ def create_send_as(self, username, name, address, reply_to=None,
+ make_default=None, **kwargs):
+ """Creates a send-as alias with the given properties.
+
+ Args:
+ username: string The name of the user.
+ name: string The name that will appear in the "From" field.
+ address: string The email address that appears as the
+ origination address for emails sent by this user.
+ reply_to: string (optional) The address to be used as the reply-to
+ address in email sent using the alias.
+ make_default: Boolean (optional) Whether or not this alias should
+ become the default alias for this user.
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsSendAsAlias of the
+ new resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_SENDAS)
+ new_alias = gdata.apps.emailsettings.data.EmailSettingsSendAsAlias(
+ uri=uri, name=name, address=address,
+ reply_to=reply_to, make_default=make_default)
+ return self.post(new_alias, uri, **kwargs)
+
+ CreateSendAs = create_send_as
+
+ def retrieve_send_as(self, username, **kwargs):
+ """Retrieves send-as aliases for the specified username
+
+ Args:
+ username: string The name of the user to get the send-as for
+
+ Returns:
+ A gdata.data.GDFeed of the user's send-as alias settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_SENDAS)
+ return self.GetFeed(
+ uri,
+ auth_token=None,
+ query=None,
+ desired_class=gdata.apps.emailsettings.data.EmailSettingsSendAsAliasFeed,
+ **kwargs)
+
+ RetrieveSendAs = retrieve_send_as
+
+ def update_webclip(self, username, enable, **kwargs):
+ """Enable/Disable Google Mail web clip.
+
+ Args:
+ username: string The name of the user.
+ enable: Boolean Whether to enable showing Web clips.
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsWebClip of the
+ updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_WEBCLIP)
+ new_webclip = gdata.apps.emailsettings.data.EmailSettingsWebClip(
+ uri=uri, enable=enable)
+ return self.update(new_webclip, **kwargs)
+
+ UpdateWebclip = update_webclip
+
+ def update_forwarding(self, username, enable, forward_to=None,
+ action=None, **kwargs):
+ """Update Google Mail Forwarding settings.
+
+ Args:
+ username: string The name of the user.
+ enable: Boolean Whether to enable incoming email forwarding.
+ forward_to: (optional) string The address email will be forwarded to.
+ action: string (optional) The action to perform after forwarding
+ an email (ACTION_KEEP, ACTION_ARCHIVE, ACTION_DELETE).
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsForwarding of the
+ updated resource
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_FORWARDING)
+ new_forwarding = gdata.apps.emailsettings.data.EmailSettingsForwarding(
+ uri=uri, enable=enable, forward_to=forward_to, action=action)
+ return self.update(new_forwarding, **kwargs)
+
+ UpdateForwarding = update_forwarding
+
+ def retrieve_forwarding(self, username, **kwargs):
+ """Retrieves forwarding settings for the specified username
+
+ Args:
+ username: string The name of the user to get the forwarding settings for
+
+ Returns:
+ A gdata.data.GDEntry of the user's email forwarding settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_FORWARDING)
+ return self.GetEntry(
+ uri,
+ auth_token=None,
+ query=None,
+ desired_class=gdata.apps.emailsettings.data.EmailSettingsForwarding,
+ **kwargs)
+
+ RetrieveForwarding = retrieve_forwarding
+
+ def update_pop(self, username, enable, enable_for=None, action=None,
+ **kwargs):
+ """Update Google Mail POP settings.
+
+ Args:
+ username: string The name of the user.
+ enable: Boolean Whether to enable incoming POP3 access.
+ enable_for: string (optional) Whether to enable POP3 for all mail
+ (POP_ENABLE_FOR_ALL_MAIL), or mail from now on
+ (POP_ENABLE_FOR_MAIL_FROM_NOW_ON).
+ action: string (optional) What Google Mail should do with its copy
+ of the email after it is retrieved using POP (ACTION_KEEP,
+ ACTION_ARCHIVE, ACTION_DELETE).
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsPop of the updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_POP)
+ new_pop = gdata.apps.emailsettings.data.EmailSettingsPop(
+ uri=uri, enable=enable,
+ enable_for=enable_for, action=action)
+ return self.update(new_pop, **kwargs)
+
+ UpdatePop = update_pop
+
+ def retrieve_pop(self, username, **kwargs):
+ """Retrieves POP settings for the specified username
+
+ Args:
+ username: string The name of the user to get the POP settings for
+
+ Returns:
+ A gdata.data.GDEntry of the user's POP settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_POP)
+ return self.GetEntry(
+ uri,
+ auth_token=None,
+ query=None,
+ desired_class=gdata.apps.emailsettings.data.EmailSettingsPop,
+ **kwargs)
+
+ RetrievePop = retrieve_pop
+
+ def update_imap(self, username, enable, **kwargs):
+ """Update Google Mail IMAP settings.
+
+ Args:
+ username: string The name of the user.
+ enable: Boolean Whether to enable IMAP access.language
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsImap of the updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_IMAP)
+ new_imap = gdata.apps.emailsettings.data.EmailSettingsImap(
+ uri=uri, enable=enable)
+ return self.update(new_imap, **kwargs)
+
+ UpdateImap = update_imap
+
+ def retrieve_imap(self, username, **kwargs):
+ """Retrieves imap settings for the specified username
+
+ Args:
+ username: string The name of the user to get the imap settings for
+
+ Returns:
+ A gdata.data.GDEntry of the user's IMAP settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_IMAP)
+ return self.GetEntry(
+ uri,
+ auth_token=None,
+ query=None,
+ desired_class=gdata.apps.emailsettings.data.EmailSettingsImap,
+ **kwargs)
+
+ RetrieveImap = retrieve_imap
+
+ def update_vacation(self, username, enable, subject=None, message=None,
+ start_date=None, end_date=None, contacts_only=None,
+ domain_only=None, **kwargs):
+ """Update Google Mail vacation-responder settings.
+
+ Args:
+ username: string The name of the user.
+ enable: Boolean Whether to enable the vacation responder.
+ subject: string (optional) The subject line of the vacation responder
+ autoresponse.
+ message: string (optional) The message body of the vacation responder
+ autoresponse.
+ startDate: string (optional) The start date of the vacation responder
+ autoresponse.
+ endDate: string (optional) The end date of the vacation responder
+ autoresponse.
+ contacts_only: Boolean (optional) Whether to only send autoresponses
+ to known contacts.
+ domain_only: Boolean (optional) Whether to only send autoresponses
+ to users in the primary domain.
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsVacationResponder of the
+ updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_VACATION_RESPONDER)
+ new_vacation = gdata.apps.emailsettings.data.EmailSettingsVacationResponder(
+ uri=uri, enable=enable, subject=subject,
+ message=message, start_date=start_date, end_date=end_date,
+ contacts_only=contacts_only, domain_only=domain_only)
+ return self.update(new_vacation, **kwargs)
+
+ UpdateVacation = update_vacation
+
+ def retrieve_vacation(self, username, **kwargs):
+ """Retrieves vacation settings for the specified username
+
+ Args:
+ username: string The name of the user to get the vacation settings for
+
+ Returns:
+ A gdata.data.GDEntry of the user's vacation auto-responder settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_VACATION_RESPONDER)
+ return self.GetEntry(
+ uri,
+ auth_token=None,
+ query=None,
+ desired_class=
+ gdata.apps.emailsettings.data.EmailSettingsVacationResponder,
+ **kwargs)
+
+ RetrieveVacation = retrieve_vacation
+
+ def update_signature(self, username, signature, **kwargs):
+ """Update Google Mail signature.
+
+ Args:
+ username: string The name of the user.
+ signature: string The signature to be appended to outgoing messages.
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsSignature of the
+ updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_SIGNATURE)
+ new_signature = gdata.apps.emailsettings.data.EmailSettingsSignature(
+ uri=uri, signature=signature)
+ return self.update(new_signature, **kwargs)
+
+ UpdateSignature = update_signature
+
+ def retrieve_signature(self, username, **kwargs):
+ """Retrieves signature settings for the specified username
+
+ Args:
+ username: string The name of the user to get the signature settings for
+
+ Returns:
+ A gdata.data.GDEntry of the user's signature settings
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_SIGNATURE)
+ return self.GetEntry(
+ uri,
+ auth_token=None,
+ query=None,
+ desired_class=gdata.apps.emailsettings.data.EmailSettingsSignature,
+ **kwargs)
+
+ RetrieveSignature = retrieve_signature
+
+ def update_language(self, username, language, **kwargs):
+ """Update Google Mail language settings.
+
+ Args:
+ username: string The name of the user.
+ language: string The language tag for Google Mail's display language.
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsLanguage of the
+ updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_LANGUAGE)
+ new_language = gdata.apps.emailsettings.data.EmailSettingsLanguage(
+ uri=uri, language=language)
+ return self.update(new_language, **kwargs)
+
+ UpdateLanguage = update_language
+
+ def update_general_settings(self, username, page_size=None, shortcuts=None,
+ arrows=None, snippets=None, use_unicode=None,
+ **kwargs):
+ """Update Google Mail general settings.
+
+ Args:
+ username: string The name of the user.
+ page_size: int (optional) The number of conversations to be shown per
+ page.
+ shortcuts: Boolean (optional) Whether to enable keyboard shortcuts.
+ arrows: Boolean (optional) Whether to display arrow-shaped personal
+ indicators next to email sent specifically to the user.
+ snippets: Boolean (optional) Whether to display snippets of the messages
+ in the inbox and when searching.
+ use_unicode: Boolean (optional) Whether to use UTF-8 (unicode) encoding
+ for all outgoing messages.
+ kwargs: The other parameters to pass to the update method.
+
+ Returns:
+ gdata.apps.emailsettings.data.EmailSettingsGeneral of the
+ updated resource.
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_GENERAL)
+ new_general = gdata.apps.emailsettings.data.EmailSettingsGeneral(
+ uri=uri, page_size=page_size, shortcuts=shortcuts,
+ arrows=arrows, snippets=snippets, use_unicode=use_unicode)
+ return self.update(new_general, **kwargs)
+
+ UpdateGeneralSettings = update_general_settings
+
+ def add_email_delegate(self, username, address, **kwargs):
+ """Add an email delegate to the mail account
+
+ Args:
+ username: string The name of the user
+ address: string The email address of the delegated account
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_DELEGATION)
+ new_delegation = gdata.apps.emailsettings.data.EmailSettingsDelegation(
+ uri=uri, address=address)
+ return self.post(new_delegation, uri, **kwargs)
+
+ AddEmailDelegate = add_email_delegate
+
+ def retrieve_email_delegates(self, username, **kwargs):
+ """Retrieve a feed of the email delegates for the specified username
+
+ Args:
+ username: string The name of the user to get the email delegates for
+
+ Returns:
+ A gdata.data.GDFeed of the user's email delegates
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_DELEGATION)
+ return self.GetFeed(
+ uri,
+ auth_token=None,
+ query=None,
+ desired_class=gdata.apps.emailsettings.data.EmailSettingsDelegationFeed,
+ **kwargs)
+
+ RetrieveEmailDelegates = retrieve_email_delegates
+
+ def delete_email_delegate(self, username, address, **kwargs):
+ """Delete an email delegate from the specified account
+
+ Args:
+ username: string The name of the user
+ address: string The email address of the delegated account
+ """
+ uri = self.MakeEmailSettingsUri(username=username,
+ setting_id=SETTING_ID_DELEGATION)
+ uri = uri + '/' + address
+ return self.delete(uri, **kwargs)
+
+ DeleteEmailDelegate = delete_email_delegate
diff --git a/src/gdata/apps/emailsettings/data.py b/src/gdata/apps/emailsettings/data.py
new file mode 100644
index 0000000..fea9886
--- /dev/null
+++ b/src/gdata/apps/emailsettings/data.py
@@ -0,0 +1,1273 @@
+#!/usr/bin/python
+#
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for the Email Settings API."""
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import atom.data
+import gdata.apps
+import gdata.apps_property
+import gdata.data
+
+
+# This is required to work around a naming conflict between the Google
+# Spreadsheets API and Python's built-in property function
+pyproperty = property
+
+
+# The apps:property label of the label property
+LABEL_NAME = 'label'
+
+# The apps:property from of the filter property
+FILTER_FROM_NAME = 'from'
+# The apps:property to of the filter property
+FILTER_TO_NAME = 'to'
+# The apps:property subject of the filter property
+FILTER_SUBJECT_NAME = 'subject'
+# The apps:property hasTheWord of the filter property
+FILTER_HAS_THE_WORD_NAME = 'hasTheWord'
+# The apps:property doesNotHaveTheWord of the filter property
+FILTER_DOES_NOT_HAVE_THE_WORD_NAME = 'doesNotHaveTheWord'
+# The apps:property hasAttachment of the filter property
+FILTER_HAS_ATTACHMENTS_NAME = 'hasAttachment'
+# The apps:property label of the filter action property
+FILTER_LABEL = 'label'
+# The apps:property shouldMarkAsRead of the filter action property
+FILTER_MARK_AS_READ = 'shouldMarkAsRead'
+# The apps:property shouldArchive of the filter action property
+FILTER_ARCHIVE = 'shouldArchive'
+
+# The apps:property name of the send-as alias property
+SENDAS_ALIAS_NAME = 'name'
+# The apps:property address of the send-as alias property
+SENDAS_ALIAS_ADDRESS = 'address'
+# The apps:property replyTo of the send-as alias property
+SENDAS_ALIAS_REPLY_TO = 'replyTo'
+# The apps:property makeDefault of the send-as alias property
+SENDAS_ALIAS_MAKE_DEFAULT = 'makeDefault'
+
+# The apps:property enable of the webclip property
+WEBCLIP_ENABLE = 'enable'
+
+# The apps:property enable of the forwarding property
+FORWARDING_ENABLE = 'enable'
+# The apps:property forwardTo of the forwarding property
+FORWARDING_TO = 'forwardTo'
+# The apps:property action of the forwarding property
+FORWARDING_ACTION = 'action'
+
+# The apps:property enable of the POP property
+POP_ENABLE = 'enable'
+# The apps:property enableFor of the POP property
+POP_ENABLE_FOR = 'enableFor'
+# The apps:property action of the POP property
+POP_ACTION = 'action'
+
+# The apps:property enable of the IMAP property
+IMAP_ENABLE = 'enable'
+
+# The apps:property enable of the vacation responder property
+VACATION_RESPONDER_ENABLE = 'enable'
+# The apps:property subject of the vacation responder property
+VACATION_RESPONDER_SUBJECT = 'subject'
+# The apps:property message of the vacation responder property
+VACATION_RESPONDER_MESSAGE = 'message'
+# The apps:property startDate of the vacation responder property
+VACATION_RESPONDER_STARTDATE = 'startDate'
+# The apps:property endDate of the vacation responder property
+VACATION_RESPONDER_ENDDATE = 'endDate'
+# The apps:property contactsOnly of the vacation responder property
+VACATION_RESPONDER_CONTACTS_ONLY = 'contactsOnly'
+# The apps:property domainOnly of the vacation responder property
+VACATION_RESPONDER_DOMAIN_ONLY = 'domainOnly'
+
+# The apps:property signature of the signature property
+SIGNATURE_VALUE = 'signature'
+
+# The apps:property language of the language property
+LANGUAGE_TAG = 'language'
+
+# The apps:property pageSize of the general settings property
+GENERAL_PAGE_SIZE = 'pageSize'
+# The apps:property shortcuts of the general settings property
+GENERAL_SHORTCUTS = 'shortcuts'
+# The apps:property arrows of the general settings property
+GENERAL_ARROWS = 'arrows'
+# The apps:prgdata.appsoperty snippets of the general settings property
+GENERAL_SNIPPETS = 'snippets'
+# The apps:property uniAppsProcode of the general settings property
+GENERAL_UNICODE = 'unicode'
+
+# The apps:property delegationId of the email delegation property
+DELEGATION_ID = 'delegationId'
+# The apps:property address of the email delegation property
+DELEGATION_ADDRESS = 'address'
+# The apps:property delegate of the email delegation property
+DELEGATION_DELEGATE = 'delegate'
+# The apps:property status of the email delegation property
+DELEGATION_STATUS = 'status'
+
+
+class EmailSettingsEntry(gdata.data.GDEntry):
+ """Represents an Email Settings entry in object form."""
+
+ property = [gdata.apps_property.AppsProperty]
+
+ def _GetProperty(self, name):
+ """Get the apps:property value with the given name.
+
+ Args:
+ name: string Name of the apps:property value to get.
+
+ Returns:
+ The apps:property value with the given name, or None if the name was
+ invalid.
+ """
+
+ value = None
+ for p in self.property:
+ if p.name == name:
+ value = p.value
+ break
+ return value
+
+ def _SetProperty(self, name, value):
+ """Set the apps:property value with the given name to the given value.
+
+ Args:
+ name: string Name of the apps:property value to set.
+ value: string Value to give the apps:property value with the given name.
+ """
+ found = False
+ for i in range(len(self.property)):
+ if self.property[i].name == name:
+ self.property[i].value = value
+ found = True
+ break
+ if not found:
+ self.property.append(
+ gdata.apps_property.AppsProperty(name=name, value=value))
+
+ def find_edit_link(self):
+ return self.uri
+
+
+class EmailSettingsLabel(EmailSettingsEntry):
+ """Represents a Label in object form."""
+
+ def GetName(self):
+ """Get the name of the Label object.
+
+ Returns:
+ The name of this Label object as a string or None.
+ """
+
+ return self._GetProperty(LABEL_NAME)
+
+ def SetName(self, value):
+ """Set the name of this Label object.
+
+ Args:
+ value: string The new label name to give this object.
+ """
+
+ self._SetProperty(LABEL_NAME, value)
+
+ name = pyproperty(GetName, SetName)
+
+ def __init__(self, uri=None, name=None, *args, **kwargs):
+ """Constructs a new EmailSettingsLabel object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of this object for HTTP requests.
+ name: string (optional) The name to give this new object.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsLabel, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if name:
+ self.name = name
+
+
+class EmailSettingsFilter(EmailSettingsEntry):
+ """Represents an Email Settings Filter in object form."""
+
+ def GetFrom(self):
+ """Get the From value of the Filter object.
+
+ Returns:
+ The From value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_FROM_NAME)
+
+ def SetFrom(self, value):
+ """Set the From value of this Filter object.
+
+ Args:
+ value: string The new From value to give this object.
+ """
+
+ self._SetProperty(FILTER_FROM_NAME, value)
+
+ from_address = pyproperty(GetFrom, SetFrom)
+
+ def GetTo(self):
+ """Get the To value of the Filter object.
+
+ Returns:
+ The To value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_TO_NAME)
+
+ def SetTo(self, value):
+ """Set the To value of this Filter object.
+
+ Args:
+ value: string The new To value to give this object.
+ """
+
+ self._SetProperty(FILTER_TO_NAME, value)
+
+ to_address = pyproperty(GetTo, SetTo)
+
+ def GetSubject(self):
+ """Get the Subject value of the Filter object.
+
+ Returns:
+ The Subject value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_SUBJECT_NAME)
+
+ def SetSubject(self, value):
+ """Set the Subject value of this Filter object.
+
+ Args:
+ value: string The new Subject value to give this object.
+ """
+
+ self._SetProperty(FILTER_SUBJECT_NAME, value)
+
+ subject = pyproperty(GetSubject, SetSubject)
+
+ def GetHasTheWord(self):
+ """Get the HasTheWord value of the Filter object.
+
+ Returns:
+ The HasTheWord value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_HAS_THE_WORD_NAME)
+
+ def SetHasTheWord(self, value):
+ """Set the HasTheWord value of this Filter object.
+
+ Args:
+ value: string The new HasTheWord value to give this object.
+ """
+
+ self._SetProperty(FILTER_HAS_THE_WORD_NAME, value)
+
+ has_the_word = pyproperty(GetHasTheWord, SetHasTheWord)
+
+ def GetDoesNotHaveTheWord(self):
+ """Get the DoesNotHaveTheWord value of the Filter object.
+
+ Returns:
+ The DoesNotHaveTheWord value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_DOES_NOT_HAVE_THE_WORD_NAME)
+
+ def SetDoesNotHaveTheWord(self, value):
+ """Set the DoesNotHaveTheWord value of this Filter object.
+
+ Args:
+ value: string The new DoesNotHaveTheWord value to give this object.
+ """
+
+ self._SetProperty(FILTER_DOES_NOT_HAVE_THE_WORD_NAME, value)
+
+ does_not_have_the_word = pyproperty(GetDoesNotHaveTheWord,
+ SetDoesNotHaveTheWord)
+
+ def GetHasAttachments(self):
+ """Get the HasAttachments value of the Filter object.
+
+ Returns:
+ The HasAttachments value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_HAS_ATTACHMENTS_NAME)
+
+ def SetHasAttachments(self, value):
+ """Set the HasAttachments value of this Filter object.
+
+ Args:
+ value: string The new HasAttachments value to give this object.
+ """
+
+ self._SetProperty(FILTER_HAS_ATTACHMENTS_NAME, value)
+
+ has_attachments = pyproperty(GetHasAttachments,
+ SetHasAttachments)
+
+ def GetLabel(self):
+ """Get the Label value of the Filter object.
+
+ Returns:
+ The Label value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_LABEL)
+
+ def SetLabel(self, value):
+ """Set the Label value of this Filter object.
+
+ Args:
+ value: string The new Label value to give this object.
+ """
+
+ self._SetProperty(FILTER_LABEL, value)
+
+ label = pyproperty(GetLabel, SetLabel)
+
+ def GetMarkAsRead(self):
+ """Get the MarkAsRead value of the Filter object.
+
+ Returns:
+ The MarkAsRead value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_MARK_AS_READ)
+
+ def SetMarkAsRead(self, value):
+ """Set the MarkAsRead value of this Filter object.
+
+ Args:
+ value: string The new MarkAsRead value to give this object.
+ """
+
+ self._SetProperty(FILTER_MARK_AS_READ, value)
+
+ mark_as_read = pyproperty(GetMarkAsRead, SetMarkAsRead)
+
+ def GetArchive(self):
+ """Get the Archive value of the Filter object.
+
+ Returns:
+ The Archive value of this Filter object as a string or None.
+ """
+
+ return self._GetProperty(FILTER_ARCHIVE)
+
+ def SetArchive(self, value):
+ """Set the Archive value of this Filter object.
+
+ Args:
+ value: string The new Archive value to give this object.
+ """
+
+ self._SetProperty(FILTER_ARCHIVE, value)
+
+ archive = pyproperty(GetArchive, SetArchive)
+
+ def __init__(self, uri=None, from_address=None, to_address=None,
+ subject=None, has_the_word=None, does_not_have_the_word=None,
+ has_attachments=None, label=None, mark_as_read=None,
+ archive=None, *args, **kwargs):
+ """Constructs a new EmailSettingsFilter object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of this object for HTTP requests.
+ from_address: string (optional) The source email address for the filter.
+ to_address: string (optional) The destination email address for
+ the filter.
+ subject: string (optional) The value the email must have in its
+ subject to be filtered.
+ has_the_word: string (optional) The value the email must have in its
+ subject or body to be filtered.
+ does_not_have_the_word: string (optional) The value the email cannot
+ have in its subject or body to be filtered.
+ has_attachments: Boolean (optional) Whether or not the email must
+ have an attachment to be filtered.
+ label: string (optional) The name of the label to apply to
+ messages matching the filter criteria.
+ mark_as_read: Boolean (optional) Whether or not to mark messages
+ matching the filter criteria as read.
+ archive: Boolean (optional) Whether or not to move messages
+ matching to Archived state.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsFilter, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if from_address:
+ self.from_address = from_address
+ if to_address:
+ self.to_address = to_address
+ if subject:
+ self.subject = subject
+ if has_the_word:
+ self.has_the_word = has_the_word
+ if does_not_have_the_word:
+ self.does_not_have_the_word = does_not_have_the_word
+ if has_attachments is not None:
+ self.has_attachments = str(has_attachments)
+ if label:
+ self.label = label
+ if mark_as_read is not None:
+ self.mark_as_read = str(mark_as_read)
+ if archive is not None:
+ self.archive = str(archive)
+
+
+class EmailSettingsSendAsAlias(EmailSettingsEntry):
+ """Represents an Email Settings send-as Alias in object form."""
+
+ def GetName(self):
+ """Get the Name of the send-as Alias object.
+
+ Returns:
+ The Name of this send-as Alias object as a string or None.
+ """
+
+ return self._GetProperty(SENDAS_ALIAS_NAME)
+
+ def SetName(self, value):
+ """Set the Name of this send-as Alias object.
+
+ Args:
+ value: string The new Name to give this object.
+ """
+
+ self._SetProperty(SENDAS_ALIAS_NAME, value)
+
+ name = pyproperty(GetName, SetName)
+
+ def GetAddress(self):
+ """Get the Address of the send-as Alias object.
+
+ Returns:
+ The Address of this send-as Alias object as a string or None.
+ """
+
+ return self._GetProperty(SENDAS_ALIAS_ADDRESS)
+
+ def SetAddress(self, value):
+ """Set the Address of this send-as Alias object.
+
+ Args:
+ value: string The new Address to give this object.
+ """
+
+ self._SetProperty(SENDAS_ALIAS_ADDRESS, value)
+
+ address = pyproperty(GetAddress, SetAddress)
+
+ def GetReplyTo(self):
+ """Get the ReplyTo address of the send-as Alias object.
+
+ Returns:
+ The ReplyTo address of this send-as Alias object as a string or None.
+ """
+
+ return self._GetProperty(SENDAS_ALIAS_REPLY_TO)
+
+ def SetReplyTo(self, value):
+ """Set the ReplyTo address of this send-as Alias object.
+
+ Args:
+ value: string The new ReplyTo address to give this object.
+ """
+
+ self._SetProperty(SENDAS_ALIAS_REPLY_TO, value)
+
+ reply_to = pyproperty(GetReplyTo, SetReplyTo)
+
+ def GetMakeDefault(self):
+ """Get the MakeDefault value of the send-as Alias object.
+
+ Returns:
+ The MakeDefault value of this send-as Alias object as a string or None.
+ """
+
+ return self._GetProperty(SENDAS_ALIAS_MAKE_DEFAULT)
+
+ def SetMakeDefault(self, value):
+ """Set the MakeDefault value of this send-as Alias object.
+
+ Args:
+ value: string The new MakeDefault value to give this object.
+ """
+
+ self._SetProperty(SENDAS_ALIAS_MAKE_DEFAULT, value)
+
+ make_default = pyproperty(GetMakeDefault, SetMakeDefault)
+
+ def __init__(self, uri=None, name=None, address=None, reply_to=None,
+ make_default=None, *args, **kwargs):
+ """Constructs a new EmailSettingsSendAsAlias object with the given
+ arguments.
+
+ Args:
+ uri: string (optional) The uri f this object for HTTP requests.
+ name: string (optional) The name that will appear in the "From" field
+ for this user.
+ address: string (optional) The email address that appears as the
+ origination address for emails sent by this user.
+ reply_to: string (optional) The address to be used as the reply-to
+ address in email sent using the alias.
+ make_default: Boolean (optional) Whether or not this alias should
+ become the default alias for this user.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsSendAsAlias, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if name:
+ self.name = name
+ if address:
+ self.address = address
+ if reply_to:
+ self.reply_to = reply_to
+ if make_default is not None:
+ self.make_default = str(make_default)
+
+
+class EmailSettingsWebClip(EmailSettingsEntry):
+ """Represents a WebClip in object form."""
+
+ def GetEnable(self):
+ """Get the Enable value of the WebClip object.
+
+ Returns:
+ The Enable value of this WebClip object as a string or None.
+ """
+
+ return self._GetProperty(WEBCLIP_ENABLE)
+
+ def SetEnable(self, value):
+ """Set the Enable value of this WebClip object.
+
+ Args:
+ value: string The new Enable value to give this object.
+ """
+
+ self._SetProperty(WEBCLIP_ENABLE, value)
+
+ enable = pyproperty(GetEnable, SetEnable)
+
+ def __init__(self, uri=None, enable=None, *args, **kwargs):
+ """Constructs a new EmailSettingsWebClip object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of this object for HTTP requests.
+ enable: Boolean (optional) Whether to enable showing Web clips.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsWebClip, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if enable is not None:
+ self.enable = str(enable)
+
+
+class EmailSettingsForwarding(EmailSettingsEntry):
+ """Represents Forwarding settings in object form."""
+
+ def GetEnable(self):
+ """Get the Enable value of the Forwarding object.
+
+ Returns:
+ The Enable value of this Forwarding object as a string or None.
+ """
+
+ return self._GetProperty(FORWARDING_ENABLE)
+
+ def SetEnable(self, value):
+ """Set the Enable value of this Forwarding object.
+
+ Args:
+ value: string The new Enable value to give this object.
+ """
+
+ self._SetProperty(FORWARDING_ENABLE, value)
+
+ enable = pyproperty(GetEnable, SetEnable)
+
+ def GetForwardTo(self):
+ """Get the ForwardTo value of the Forwarding object.
+
+ Returns:
+ The ForwardTo value of this Forwarding object as a string or None.
+ """
+
+ return self._GetProperty(FORWARDING_TO)
+
+ def SetForwardTo(self, value):
+ """Set the ForwardTo value of this Forwarding object.
+
+ Args:
+ value: string The new ForwardTo value to give this object.
+ """
+
+ self._SetProperty(FORWARDING_TO, value)
+
+ forward_to = pyproperty(GetForwardTo, SetForwardTo)
+
+ def GetAction(self):
+ """Get the Action value of the Forwarding object.
+
+ Returns:
+ The Action value of this Forwarding object as a string or None.
+ """
+
+ return self._GetProperty(FORWARDING_ACTION)
+
+ def SetAction(self, value):
+ """Set the Action value of this Forwarding object.
+
+ Args:
+ value: string The new Action value to give this object.
+ """
+
+ self._SetProperty(FORWARDING_ACTION, value)
+
+ action = pyproperty(GetAction, SetAction)
+
+ def __init__(self, uri=None, enable=None, forward_to=None, action=None,
+ *args, **kwargs):
+ """Constructs a new EmailSettingsForwarding object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of this object for HTTP requests.
+ enable: Boolean (optional) Whether to enable incoming email forwarding.
+ forward_to: string (optional) The address email will be forwarded to.
+ action: string (optional) The action to perform after forwarding an
+ email ("KEEP", "ARCHIVE", "DELETE").
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsForwarding, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if enable is not None:
+ self.enable = str(enable)
+ if forward_to:
+ self.forward_to = forward_to
+ if action:
+ self.action = action
+
+
+class EmailSettingsPop(EmailSettingsEntry):
+ """Represents POP settings in object form."""
+
+ def GetEnable(self):
+ """Get the Enable value of the POP object.
+
+ Returns:
+ The Enable value of this POP object as a string or None.
+ """
+
+ return self._GetProperty(POP_ENABLE)
+
+ def SetEnable(self, value):
+ """Set the Enable value of this POP object.
+
+ Args:
+ value: string The new Enable value to give this object.
+ """
+
+ self._SetProperty(POP_ENABLE, value)
+
+ enable = pyproperty(GetEnable, SetEnable)
+
+ def GetEnableFor(self):
+ """Get the EnableFor value of the POP object.
+
+ Returns:
+ The EnableFor value of this POP object as a string or None.
+ """
+
+ return self._GetProperty(POP_ENABLE_FOR)
+
+ def SetEnableFor(self, value):
+ """Set the EnableFor value of this POP object.
+
+ Args:
+ value: string The new EnableFor value to give this object.
+ """
+
+ self._SetProperty(POP_ENABLE_FOR, value)
+
+ enable_for = pyproperty(GetEnableFor, SetEnableFor)
+
+ def GetPopAction(self):
+ """Get the Action value of the POP object.
+
+ Returns:
+ The Action value of this POP object as a string or None.
+ """
+
+ return self._GetProperty(POP_ACTION)
+
+ def SetPopAction(self, value):
+ """Set the Action value of this POP object.
+
+ Args:
+ value: string The new Action value to give this object.
+ """
+
+ self._SetProperty(POP_ACTION, value)
+
+ action = pyproperty(GetPopAction, SetPopAction)
+
+ def __init__(self, uri=None, enable=None, enable_for=None,
+ action=None, *args, **kwargs):
+ """Constructs a new EmailSettingsPOP object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of this object for HTTP requests.
+ enable: Boolean (optional) Whether to enable incoming POP3 access.
+ enable_for: string (optional) Whether to enable POP3 for all mail
+ ("ALL_MAIL"), or mail from now on ("MAIL_FROM_NOW_ON").
+ action: string (optional) What Google Mail should do with its copy
+ of the email after it is retrieved using POP
+ ("KEEP", "ARCHIVE", or "DELETE").
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsPop, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if enable is not None:
+ self.enable = str(enable)
+ if enable_for:
+ self.enable_for = enable_for
+ if action:
+ self.action = action
+
+
+class EmailSettingsImap(EmailSettingsEntry):
+ """Represents IMAP settings in object form."""
+
+ def GetEnable(self):
+ """Get the Enable value of the IMAP object.
+
+ Returns:
+ The Enable value of this IMAP object as a string or None.
+ """
+
+ return self._GetProperty(IMAP_ENABLE)
+
+ def SetEnable(self, value):
+ """Set the Enable value of this IMAP object.
+
+ Args:
+ value: string The new Enable value to give this object.
+ """
+
+ self._SetProperty(IMAP_ENABLE, value)
+
+ enable = pyproperty(GetEnable, SetEnable)
+
+ def __init__(self, uri=None, enable=None, *args, **kwargs):
+ """Constructs a new EmailSettingsImap object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of this object for HTTP requests.
+ enable: Boolean (optional) Whether to enable IMAP access.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsImap, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if enable is not None:
+ self.enable = str(enable)
+
+
+class EmailSettingsVacationResponder(EmailSettingsEntry):
+ """Represents Vacation Responder settings in object form."""
+
+ def GetEnable(self):
+ """Get the Enable value of the Vacation Responder object.
+
+ Returns:
+ The Enable value of this Vacation Responder object as a string or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_ENABLE)
+
+ def SetEnable(self, value):
+ """Set the Enable value of this Vacation Responder object.
+
+ Args:
+ value: string The new Enable value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_ENABLE, value)
+
+ enable = pyproperty(GetEnable, SetEnable)
+
+ def GetSubject(self):
+ """Get the Subject value of the Vacation Responder object.
+
+ Returns:
+ The Subject value of this Vacation Responder object as a string or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_SUBJECT)
+
+ def SetSubject(self, value):
+ """Set the Subject value of this Vacation Responder object.
+
+ Args:
+ value: string The new Subject value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_SUBJECT, value)
+
+ subject = pyproperty(GetSubject, SetSubject)
+
+ def GetMessage(self):
+ """Get the Message value of the Vacation Responder object.
+
+ Returns:
+ The Message value of this Vacation Responder object as a string or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_MESSAGE)
+
+ def SetMessage(self, value):
+ """Set the Message value of this Vacation Responder object.
+
+ Args:
+ value: string The new Message value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_MESSAGE, value)
+
+ message = pyproperty(GetMessage, SetMessage)
+
+ def GetStartDate(self):
+ """Get the StartDate value of the Vacation Responder object.
+
+ Returns:
+ The StartDate value of this Vacation Responder object as a
+ string(YYYY-MM-DD) or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_STARTDATE)
+
+ def SetStartDate(self, value):
+ """Set the StartDate value of this Vacation Responder object.
+
+ Args:
+ value: string The new StartDate value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_STARTDATE, value)
+
+ start_date = pyproperty(GetStartDate, SetStartDate)
+
+ def GetEndDate(self):
+ """Get the EndDate value of the Vacation Responder object.
+
+ Returns:
+ The EndDate value of this Vacation Responder object as a
+ string(YYYY-MM-DD) or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_ENDDATE)
+
+ def SetEndDate(self, value):
+ """Set the EndDate value of this Vacation Responder object.
+
+ Args:
+ value: string The new EndDate value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_ENDDATE, value)
+
+ end_date = pyproperty(GetEndDate, SetEndDate)
+
+ def GetContactsOnly(self):
+ """Get the ContactsOnly value of the Vacation Responder object.
+
+ Returns:
+ The ContactsOnly value of this Vacation Responder object as a
+ string or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_CONTACTS_ONLY)
+
+ def SetContactsOnly(self, value):
+ """Set the ContactsOnly value of this Vacation Responder object.
+
+ Args:
+ value: string The new ContactsOnly value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_CONTACTS_ONLY, value)
+
+ contacts_only = pyproperty(GetContactsOnly, SetContactsOnly)
+
+ def GetDomainOnly(self):
+ """Get the DomainOnly value of the Vacation Responder object.
+
+ Returns:
+ The DomainOnly value of this Vacation Responder object as a
+ string or None.
+ """
+
+ return self._GetProperty(VACATION_RESPONDER_DOMAIN_ONLY)
+
+ def SetDomainOnly(self, value):
+ """Set the DomainOnly value of this Vacation Responder object.
+
+ Args:
+ value: string The new DomainOnly value to give this object.
+ """
+
+ self._SetProperty(VACATION_RESPONDER_DOMAIN_ONLY, value)
+
+ domain_only = pyproperty(GetDomainOnly, SetDomainOnly)
+
+ def __init__(self, uri=None, enable=None, subject=None,
+ message=None, start_date=None, end_date=None, contacts_only=None,
+ domain_only=None, *args, **kwargs):
+ """Constructs a new EmailSettingsVacationResponder object with the
+ given arguments.
+
+ Args:
+ uri: string (optional) The uri of this object for HTTP requests.
+ enable: Boolean (optional) Whether to enable the vacation responder.
+ subject: string (optional) The subject line of the vacation responder
+ autoresponse.
+ message: string (optional) The message body of the vacation responder
+ autoresponse.
+ start_date: string (optional) The start date of the vacation responder
+ autoresponse
+ end_date: string (optional) The end date of the vacation responder
+ autoresponse
+ contacts_only: Boolean (optional) Whether to only send autoresponses
+ to known contacts.
+ domain_only: Boolean (optional) Whether to only send autoresponses
+ to users in the same primary domain .
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsVacationResponder, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if enable is not None:
+ self.enable = str(enable)
+ if subject:
+ self.subject = subject
+ if message:
+ self.message = message
+ if start_date:
+ self.start_date = start_date
+ if end_date:
+ self.end_date = end_date
+ if contacts_only is not None:
+ self.contacts_only = str(contacts_only)
+ if domain_only is not None:
+ self.domain_only = str(domain_only)
+
+
+class EmailSettingsSignature(EmailSettingsEntry):
+ """Represents a Signature in object form."""
+
+ def GetValue(self):
+ """Get the value of the Signature object.
+
+ Returns:
+ The value of this Signature object as a string or None.
+ """
+
+ value = self._GetProperty(SIGNATURE_VALUE)
+ if value == ' ': # hack to support empty signature
+ return ''
+ else:
+ return value
+
+ def SetValue(self, value):
+ """Set the name of this Signature object.
+
+ Args:
+ value: string The new signature value to give this object.
+ """
+
+ if value == '': # hack to support empty signature
+ value = ' '
+ self._SetProperty(SIGNATURE_VALUE, value)
+
+ signature_value = pyproperty(GetValue, SetValue)
+
+ def __init__(self, uri=None, signature=None, *args, **kwargs):
+ """Constructs a new EmailSettingsSignature object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of this object for HTTP requests.
+ signature: string (optional) The signature to be appended to outgoing
+ messages.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsSignature, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if signature is not None:
+ self.signature_value = signature
+
+
+class EmailSettingsLanguage(EmailSettingsEntry):
+ """Represents Language Settings in object form."""
+
+ def GetLanguage(self):
+ """Get the tag of the Language object.
+
+ Returns:
+ The tag of this Language object as a string or None.
+ """
+
+ return self._GetProperty(LANGUAGE_TAG)
+
+ def SetLanguage(self, value):
+ """Set the tag of this Language object.
+
+ Args:
+ value: string The new tag value to give this object.
+ """
+
+ self._SetProperty(LANGUAGE_TAG, value)
+
+ language_tag = pyproperty(GetLanguage, SetLanguage)
+
+ def __init__(self, uri=None, language=None, *args, **kwargs):
+ """Constructs a new EmailSettingsLanguage object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of this object for HTTP requests.
+ language: string (optional) The language tag for Google Mail's display
+ language.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsLanguage, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if language:
+ self.language_tag = language
+
+
+class EmailSettingsGeneral(EmailSettingsEntry):
+ """Represents General Settings in object form."""
+
+ def GetPageSize(self):
+ """Get the Page Size value of the General Settings object.
+
+ Returns:
+ The Page Size value of this General Settings object as a string or None.
+ """
+
+ return self._GetProperty(GENERAL_PAGE_SIZE)
+
+ def SetPageSize(self, value):
+ """Set the Page Size value of this General Settings object.
+
+ Args:
+ value: string The new Page Size value to give this object.
+ """
+
+ self._SetProperty(GENERAL_PAGE_SIZE, value)
+
+ page_size = pyproperty(GetPageSize, SetPageSize)
+
+ def GetShortcuts(self):
+ """Get the Shortcuts value of the General Settings object.
+
+ Returns:
+ The Shortcuts value of this General Settings object as a string or None.
+ """
+
+ return self._GetProperty(GENERAL_SHORTCUTS)
+
+ def SetShortcuts(self, value):
+ """Set the Shortcuts value of this General Settings object.
+
+ Args:
+ value: string The new Shortcuts value to give this object.
+ """
+
+ self._SetProperty(GENERAL_SHORTCUTS, value)
+
+ shortcuts = pyproperty(GetShortcuts, SetShortcuts)
+
+ def GetArrows(self):
+ """Get the Arrows value of the General Settings object.
+
+ Returns:
+ The Arrows value of this General Settings object as a string or None.
+ """
+
+ return self._GetProperty(GENERAL_ARROWS)
+
+ def SetArrows(self, value):
+ """Set the Arrows value of this General Settings object.
+
+ Args:
+ value: string The new Arrows value to give this object.
+ """
+
+ self._SetProperty(GENERAL_ARROWS, value)
+
+ arrows = pyproperty(GetArrows, SetArrows)
+
+ def GetSnippets(self):
+ """Get the Snippets value of the General Settings object.
+
+ Returns:
+ The Snippets value of this General Settings object as a string or None.
+ """
+
+ return self._GetProperty(GENERAL_SNIPPETS)
+
+ def SetSnippets(self, value):
+ """Set the Snippets value of this General Settings object.
+
+ Args:
+ value: string The new Snippets value to give this object.
+ """
+
+ self._SetProperty(GENERAL_SNIPPETS, value)
+
+ snippets = pyproperty(GetSnippets, SetSnippets)
+
+ def GetUnicode(self):
+ """Get the Unicode value of the General Settings object.
+
+ Returns:
+ The Unicode value of this General Settings object as a string or None.
+ """
+
+ return self._GetProperty(GENERAL_UNICODE)
+
+ def SetUnicode(self, value):
+ """Set the Unicode value of this General Settings object.
+
+ Args:
+ value: string The new Unicode value to give this object.
+ """
+
+ self._SetProperty(GENERAL_UNICODE, value)
+
+ use_unicode = pyproperty(GetUnicode, SetUnicode)
+
+ def __init__(self, uri=None, page_size=None, shortcuts=None,
+ arrows=None, snippets=None, use_unicode=None, *args, **kwargs):
+ """Constructs a new EmailSettingsGeneral object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of this object for HTTP requests.
+ page_size: int (optional) The number of conversations to be shown per page.
+ shortcuts: Boolean (optional) Whether to enable keyboard shortcuts.
+ arrows: Boolean (optional) Whether to display arrow-shaped personal
+ indicators next to email sent specifically to the user.
+ snippets: Boolean (optional) Whether to display snippets of the messages
+ in the inbox and when searching.
+ use_unicode: Boolean (optional) Whether to use UTF-8 (unicode) encoding
+ for all outgoing messages.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(EmailSettingsGeneral, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if page_size is not None:
+ self.page_size = str(page_size)
+ if shortcuts is not None:
+ self.shortcuts = str(shortcuts)
+ if arrows is not None:
+ self.arrows = str(arrows)
+ if snippets is not None:
+ self.snippets = str(snippets)
+ if use_unicode is not None:
+ self.use_unicode = str(use_unicode)
+
+
+class EmailSettingsDelegation(EmailSettingsEntry):
+ """Represents an Email Settings delegation entry in object form."""
+
+ def GetAddress(self):
+ """Get the email address of the delegated user.
+
+ Returns:
+ The email address of the delegated user as a string or None.
+ """
+ return self._GetProperty(DELEGATION_ADDRESS)
+
+ def SetAddress(self, value):
+ """Set the email address of the delegated user.
+
+ Args:
+ value: string The email address of another user on the same domain
+ """
+ self._SetProperty(DELEGATION_ADDRESS, value)
+
+ address = pyproperty(GetAddress, SetAddress)
+
+ def __init__(self, uri=None, address=None, *args, **kwargs):
+ """Constructs a new EmailSettingsDelegation object with the given
+ arguments.
+
+ Args:
+ uri: string (optional) The uri of this object for HTTP requests.
+ address: string The email address of the delegated user.
+ """
+ super(EmailSettingsDelegation, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if address:
+ self.address = address
+
+
+class EmailSettingsLabelFeed(gdata.data.GDFeed):
+ """Main feed containing a list of labels."""
+ entry = [EmailSettingsLabel]
+
+
+class EmailSettingsSendAsAliasFeed(gdata.data.GDFeed):
+ """Main feed containing a list of send-as aliases."""
+ entry = [EmailSettingsSendAsAlias]
+
+
+class EmailSettingsDelegationFeed(gdata.data.GDFeed):
+ """Main feed containing a list of email delegation entries."""
+ entry = [EmailSettingsDelegation]
\ No newline at end of file
diff --git a/src/gdata/apps/emailsettings/service.py b/src/gdata/apps/emailsettings/service.py
new file mode 100644
index 0000000..cab61ea
--- /dev/null
+++ b/src/gdata/apps/emailsettings/service.py
@@ -0,0 +1,264 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Allow Google Apps domain administrators to set users' email settings.
+
+ EmailSettingsService: Set various email settings.
+"""
+
+__author__ = 'google-apps-apis@googlegroups.com'
+
+
+import gdata.apps
+import gdata.apps.service
+import gdata.service
+
+
+API_VER='2.0'
+# Forwarding and POP3 options
+KEEP='KEEP'
+ARCHIVE='ARCHIVE'
+DELETE='DELETE'
+ALL_MAIL='ALL_MAIL'
+MAIL_FROM_NOW_ON='MAIL_FROM_NOW_ON'
+
+
+class EmailSettingsService(gdata.apps.service.PropertyService):
+ """Client for the Google Apps Email Settings service."""
+
+ def _serviceUrl(self, setting_id, username, domain=None):
+ if domain is None:
+ domain = self.domain
+ return '/a/feeds/emailsettings/%s/%s/%s/%s' % (API_VER, domain, username,
+ setting_id)
+
+ def CreateLabel(self, username, label):
+ """Create a label.
+
+ Args:
+ username: User to create label for.
+ label: Label to create.
+
+ Returns:
+ A dict containing the result of the create operation.
+ """
+ uri = self._serviceUrl('label', username)
+ properties = {'label': label}
+ return self._PostProperties(uri, properties)
+
+ def CreateFilter(self, username, from_=None, to=None, subject=None,
+ has_the_word=None, does_not_have_the_word=None,
+ has_attachment=None, label=None, should_mark_as_read=None,
+ should_archive=None):
+ """Create a filter.
+
+ Args:
+ username: User to create filter for.
+ from_: Filter from string.
+ to: Filter to string.
+ subject: Filter subject.
+ has_the_word: Words to filter in.
+ does_not_have_the_word: Words to filter out.
+ has_attachment: Boolean for message having attachment.
+ label: Label to apply.
+ should_mark_as_read: Boolean for marking message as read.
+ should_archive: Boolean for archiving message.
+
+ Returns:
+ A dict containing the result of the create operation.
+ """
+ uri = self._serviceUrl('filter', username)
+ properties = {}
+ properties['from'] = from_
+ properties['to'] = to
+ properties['subject'] = subject
+ properties['hasTheWord'] = has_the_word
+ properties['doesNotHaveTheWord'] = does_not_have_the_word
+ properties['hasAttachment'] = gdata.apps.service._bool2str(has_attachment)
+ properties['label'] = label
+ properties['shouldMarkAsRead'] = gdata.apps.service._bool2str(should_mark_as_read)
+ properties['shouldArchive'] = gdata.apps.service._bool2str(should_archive)
+ return self._PostProperties(uri, properties)
+
+ def CreateSendAsAlias(self, username, name, address, reply_to=None,
+ make_default=None):
+ """Create alias to send mail as.
+
+ Args:
+ username: User to create alias for.
+ name: Name of alias.
+ address: Email address to send from.
+ reply_to: Email address to reply to.
+ make_default: Boolean for whether this is the new default sending alias.
+
+ Returns:
+ A dict containing the result of the create operation.
+ """
+ uri = self._serviceUrl('sendas', username)
+ properties = {}
+ properties['name'] = name
+ properties['address'] = address
+ properties['replyTo'] = reply_to
+ properties['makeDefault'] = gdata.apps.service._bool2str(make_default)
+ return self._PostProperties(uri, properties)
+
+ def UpdateWebClipSettings(self, username, enable):
+ """Update WebClip Settings
+
+ Args:
+ username: User to update forwarding for.
+ enable: Boolean whether to enable Web Clip.
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('webclip', username)
+ properties = {}
+ properties['enable'] = gdata.apps.service._bool2str(enable)
+ return self._PutProperties(uri, properties)
+
+ def UpdateForwarding(self, username, enable, forward_to=None, action=None):
+ """Update forwarding settings.
+
+ Args:
+ username: User to update forwarding for.
+ enable: Boolean whether to enable this forwarding rule.
+ forward_to: Email address to forward to.
+ action: Action to take after forwarding.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('forwarding', username)
+ properties = {}
+ properties['enable'] = gdata.apps.service._bool2str(enable)
+ if enable is True:
+ properties['forwardTo'] = forward_to
+ properties['action'] = action
+ return self._PutProperties(uri, properties)
+
+ def UpdatePop(self, username, enable, enable_for=None, action=None):
+ """Update POP3 settings.
+
+ Args:
+ username: User to update POP3 settings for.
+ enable: Boolean whether to enable POP3.
+ enable_for: Which messages to make available via POP3.
+ action: Action to take after user retrieves email via POP3.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('pop', username)
+ properties = {}
+ properties['enable'] = gdata.apps.service._bool2str(enable)
+ if enable is True:
+ properties['enableFor'] = enable_for
+ properties['action'] = action
+ return self._PutProperties(uri, properties)
+
+ def UpdateImap(self, username, enable):
+ """Update IMAP settings.
+
+ Args:
+ username: User to update IMAP settings for.
+ enable: Boolean whether to enable IMAP.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('imap', username)
+ properties = {'enable': gdata.apps.service._bool2str(enable)}
+ return self._PutProperties(uri, properties)
+
+ def UpdateVacation(self, username, enable, subject=None, message=None,
+ contacts_only=None):
+ """Update vacation settings.
+
+ Args:
+ username: User to update vacation settings for.
+ enable: Boolean whether to enable vacation responses.
+ subject: Vacation message subject.
+ message: Vacation message body.
+ contacts_only: Boolean whether to send message only to contacts.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('vacation', username)
+ properties = {}
+ properties['enable'] = gdata.apps.service._bool2str(enable)
+ if enable is True:
+ properties['subject'] = subject
+ properties['message'] = message
+ properties['contactsOnly'] = gdata.apps.service._bool2str(contacts_only)
+ return self._PutProperties(uri, properties)
+
+ def UpdateSignature(self, username, signature):
+ """Update signature.
+
+ Args:
+ username: User to update signature for.
+ signature: Signature string.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('signature', username)
+ properties = {'signature': signature}
+ return self._PutProperties(uri, properties)
+
+ def UpdateLanguage(self, username, language):
+ """Update user interface language.
+
+ Args:
+ username: User to update language for.
+ language: Language code.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('language', username)
+ properties = {'language': language}
+ return self._PutProperties(uri, properties)
+
+ def UpdateGeneral(self, username, page_size=None, shortcuts=None, arrows=None,
+ snippets=None, unicode=None):
+ """Update general settings.
+
+ Args:
+ username: User to update general settings for.
+ page_size: Number of messages to show.
+ shortcuts: Boolean whether shortcuts are enabled.
+ arrows: Boolean whether arrows are enabled.
+ snippets: Boolean whether snippets are enabled.
+ unicode: Wheter unicode is enabled.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._serviceUrl('general', username)
+ properties = {}
+ if page_size != None:
+ properties['pageSize'] = str(page_size)
+ if shortcuts != None:
+ properties['shortcuts'] = gdata.apps.service._bool2str(shortcuts)
+ if arrows != None:
+ properties['arrows'] = gdata.apps.service._bool2str(arrows)
+ if snippets != None:
+ properties['snippets'] = gdata.apps.service._bool2str(snippets)
+ if unicode != None:
+ properties['unicode'] = gdata.apps.service._bool2str(unicode)
+ return self._PutProperties(uri, properties)
diff --git a/src/gdata/apps/groups/__init__.py b/src/gdata/apps/groups/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/src/gdata/apps/groups/__init__.py
diff --git a/src/gdata/apps/groups/client.py b/src/gdata/apps/groups/client.py
new file mode 100644
index 0000000..fabec14
--- /dev/null
+++ b/src/gdata/apps/groups/client.py
@@ -0,0 +1,341 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""GroupsClient simplifies Groups Provisioning API calls.
+
+GroupsClient extends gdata.client.GDClient to ease interaction
+with the Group Provisioning API. These interactions include the
+ability to create, retrieve, update and delete groups.
+"""
+
+
+__author__ = 'Shraddha gupta <shraddhag@google.com>'
+
+
+import urllib
+import gdata.apps.groups.data
+import gdata.client
+
+
+# Multidomain URI templates
+# The strings in this template are eventually replaced with the API version,
+# and Google Apps domain name respectively.
+GROUP_URI_TEMPLATE = '/a/feeds/group/%s/%s'
+GROUP_MEMBER = 'member'
+
+
+class GroupsProvisioningClient(gdata.client.GDClient):
+ """Client extension for the Google Group Provisioning API service.
+
+ Attributes:
+ host: string The hostname for the Group Provisioning API service.
+ api_version: string The version of the MultiDomain Provisioning API.
+ """
+
+ host = 'apps-apis.google.com'
+ api_version = '2.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+ ssl = True
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the Groups Provisioning API.
+
+ Args:
+ domain: string The Google Apps domain with Group Provisioning.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the email settings.
+ kwargs: The other parameters to pass to the gdata.client.GDClient
+ constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def make_group_provisioning_uri(
+ self, feed_type=None, group_id=None, member_id=None, params=None):
+
+ """Creates a resource feed URI for the Groups Provisioning API.
+
+ Using this client's Google Apps domain, create a feed URI for group
+ provisioning in that domain. If an email address is provided, return a
+ URI for that specific resource. If params are provided, append them as GET
+ params.
+
+ Args:
+ feed_type: string groupmember for groupmember feed else None
+ group_id: string (optional) The identifier of group for which to
+ make a feed URI.
+ member_id: string (optional) The identifier of group member for which to
+ make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for group provisioning for this client's
+ Google Apps domain.
+ """
+ uri = GROUP_URI_TEMPLATE % (self.api_version, self.domain)
+ if group_id:
+ uri += '/' + group_id
+ if feed_type is GROUP_MEMBER:
+ uri += '/' + feed_type
+ if member_id:
+ uri += '/' + member_id
+ if params:
+ uri += '?' + urllib.urlencode(params)
+ return uri
+
+ MakeGroupProvisioningUri = make_group_provisioning_uri
+
+ def make_group_member_uri(self, group_id, member_id=None, params=None):
+ """Creates a resource feed URI for the Group Member Provisioning API."""
+
+ return self.make_group_provisioning_uri(GROUP_MEMBER, group_id=group_id,
+ member_id=member_id, params=params)
+
+ MakeGroupMembersUri = make_group_member_uri
+
+ def RetrieveAllPages(self, feed, desired_class=gdata.data.GDFeed):
+ """Retrieve all pages and add all elements.
+
+ Args:
+ feed: gdata.data.GDFeed object with linked elements.
+ desired_class: type of Feed to be returned.
+
+ Returns:
+ desired_class: subclass of gdata.data.GDFeed.
+ """
+
+ next = feed.GetNextLink()
+ while next is not None:
+ next_feed = self.GetFeed(next.href, desired_class=desired_class)
+ for a_entry in next_feed.entry:
+ feed.entry.append(a_entry)
+ next = next_feed.GetNextLink()
+ return feed
+
+ def retrieve_page_of_groups(self, **kwargs):
+ """Retrieves first page of groups for the given domain.
+
+ Args:
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A gdata.apps.groups.data.GroupFeed of the groups
+ """
+ uri = self.MakeGroupProvisioningUri()
+ return self.GetFeed(uri,
+ desired_class=gdata.apps.groups.data.GroupFeed, **kwargs)
+
+ RetrievePageOfGroups = retrieve_page_of_groups
+
+ def retrieve_all_groups(self):
+ """Retrieve all groups in this domain.
+
+ Returns:
+ gdata.apps.groups.data.GroupFeed of the groups
+ """
+
+ groups_feed = self.RetrievePageOfGroups()
+ # pagination
+ return self.RetrieveAllPages(groups_feed, gdata.apps.groups.data.GroupFeed)
+
+ RetrieveAllGroups = retrieve_all_groups
+
+ def retrieve_group(self, group_id, **kwargs):
+ """Retrieves a single group in the domain.
+
+ Args:
+ group_id: string groupId of the group to be retrieved
+ kwargs: other parameters to pass to gdata.client.GDClient.GetEntry()
+
+ Returns:
+ A gdata.apps.groups.data.GroupEntry representing the group
+ """
+ uri = self.MakeGroupProvisioningUri(group_id=group_id)
+ return self.GetEntry(uri,
+ desired_class=gdata.apps.groups.data.GroupEntry, **kwargs)
+
+ RetrieveGroup = retrieve_group
+
+ def retrieve_page_of_member_groups(self, member_id, direct_only=False,
+ **kwargs):
+ """Retrieve one page of groups that belong to the given member_id.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ direct_only: Boolean whether only return groups that this member
+ directly belongs to.
+
+ Returns:
+ gdata.apps.groups.data.GroupFeed of the groups.
+ """
+ uri = self.MakeGroupProvisioningUri(params={'member':member_id,
+ 'directOnly':direct_only})
+ return self.GetFeed(uri,
+ desired_class=gdata.apps.groups.data.GroupFeed, **kwargs)
+
+ RetrievePageOfMemberGroups = retrieve_page_of_member_groups
+
+ def retrieve_groups(self, member_id, direct_only=False, **kwargs):
+ """Retrieve all groups that belong to the given member_id.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ direct_only: Boolean whether only return groups that this member
+ directly belongs to.
+
+ Returns:
+ gdata.apps.groups.data.GroupFeed of the groups
+ """
+ groups_feed = self.RetrievePageOfMemberGroups(member_id=member_id,
+ direct_only=direct_only)
+ # pagination
+ return self.RetrieveAllPages(groups_feed, gdata.apps.groups.data.GroupFeed)
+
+ RetrieveGroups = retrieve_groups
+
+ def create_group(self, group_id, group_name,
+ description=None, email_permission=None, **kwargs):
+ """Creates a group in the domain with the given properties.
+
+ Args:
+ group_id: string identifier of the group.
+ group_name: string name of the group.
+ description: string (optional) description of the group.
+ email_permission: string (optional) email permission level for the group.
+ kwargs: other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ A gdata.apps.groups.data.GroupEntry of the new group
+ """
+ new_group = gdata.apps.groups.data.GroupEntry(group_id=group_id,
+ group_name=group_name, description=description,
+ email_permission=email_permission)
+ return self.post(new_group, self.MakeGroupProvisioningUri(),
+ **kwargs)
+
+ CreateGroup = create_group
+
+ def update_group(self, group_id, group_entry, **kwargs):
+ """Updates the group with the given groupID.
+
+ Args:
+ group_id: string identifier of the group.
+ group_entry: GroupEntry The group entry with updated values.
+ kwargs: The other parameters to pass to gdata.client.GDClient.put()
+
+ Returns:
+ A gdata.apps.groups.data.GroupEntry representing the group
+ """
+ return self.update(group_entry,
+ uri=self.MakeGroupProvisioningUri(group_id=group_id),
+ **kwargs)
+
+ UpdateGroup = update_group
+
+ def delete_group(self, group_id, **kwargs):
+ """Deletes the group with the given groupId.
+
+ Args:
+ group_id: string groupId of the group to delete.
+ kwargs: The other parameters to pass to gdata.client.GDClient.delete()
+ """
+ self.delete(self.MakeGroupProvisioningUri(group_id=group_id), **kwargs)
+
+ DeleteGroup = delete_group
+
+ def retrieve_page_of_members(self, group_id, **kwargs):
+ """Retrieves first page of group members of the group.
+
+ Args:
+ group_id: string groupId of the group whose members are retrieved
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A gdata.apps.groups.data.GroupMemberFeed of the GroupMember entries
+ """
+ uri = self.MakeGroupMembersUri(group_id=group_id)
+ return self.GetFeed(uri,
+ desired_class=gdata.apps.groups.data.GroupMemberFeed, **kwargs)
+
+ RetrievePageOfMembers = retrieve_page_of_members
+
+ def retrieve_all_members(self, group_id, **kwargs):
+ """Retrieve all members of the group.
+
+ Returns:
+ gdata.apps.groups.data.GroupMemberFeed
+ """
+
+ group_member_feed = self.RetrievePageOfMembers(group_id=group_id)
+ # pagination
+ return self.RetrieveAllPages(group_member_feed,
+ gdata.apps.groups.data.GroupMemberFeed)
+
+ RetrieveAllMembers = retrieve_all_members
+
+ def retrieve_group_member(self, group_id, member_id, **kwargs):
+ """Retrieves a group member with the given id from given group.
+
+ Args:
+ group_id: string groupId of the group whose member is retrieved
+ member_id: string memberId of the group member retrieved
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetEntry()
+
+ Returns:
+ A gdata.apps.groups.data.GroupEntry representing the group member
+ """
+ uri = self.MakeGroupMembersUri(group_id=group_id, member_id=member_id)
+ return self.GetEntry(uri,
+ desired_class=gdata.apps.groups.data.GroupMemberEntry, **kwargs)
+
+ RetrieveGroupMember = retrieve_group_member
+
+ def add_member_to_group(self, group_id, member_id, member_type=None,
+ direct_member=None, **kwargs):
+ """Adds a member with the given id to the group.
+
+ Args:
+ group_id: string groupId of the group where member is added
+ member_id: string memberId of the member added
+ member_type: string (optional) type of member(user or group)
+ direct_member: bool (optional) if member is a direct member
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ A gdata.apps.groups.data.GroupMemberEntry of the group member
+ """
+ member = gdata.apps.groups.data.GroupMemberEntry(member_id=member_id,
+ member_type=member_type, direct_member=direct_member)
+ return self.post(member, self.MakeGroupMembersUri(group_id=group_id),
+ **kwargs)
+
+ AddMemberToGroup = add_member_to_group
+
+ def remove_member_from_group(self, group_id, member_id, **kwargs):
+ """Remove member from the given group.
+
+ Args:
+ group_id: string groupId of the group
+ member_id: string memberId of the member to be removed
+ kwargs: The other parameters to pass to gdata.client.GDClient.delete()
+ """
+ self.delete(
+ self.MakeGroupMembersUri(group_id=group_id, member_id=member_id),
+ **kwargs)
+
+ RemoveMemberFromGroup = remove_member_from_group
diff --git a/src/gdata/apps/groups/data.py b/src/gdata/apps/groups/data.py
new file mode 100644
index 0000000..1f83477
--- /dev/null
+++ b/src/gdata/apps/groups/data.py
@@ -0,0 +1,236 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for the Groups Provisioning API."""
+
+
+__author__ = 'Shraddha gupta <shraddhag@google.com>'
+
+
+import atom.data
+import gdata.apps
+import gdata.apps.apps_property_entry
+import gdata.apps_property
+import gdata.data
+
+
+# This is required to work around a naming conflict between the Google
+# Spreadsheets API and Python's built-in property function
+pyproperty = property
+
+
+# The apps:property groupId of a group entry
+GROUP_ID = 'groupId'
+# The apps:property groupName of a group entry
+GROUP_NAME = 'groupName'
+# The apps:property description of a group entry
+DESCRIPTION = 'description'
+# The apps:property emailPermission of a group entry
+EMAIL_PERMISSION = 'emailPermission'
+# The apps:property memberId of a group member entry
+MEMBER_ID = 'memberId'
+# The apps:property memberType of a group member entry
+MEMBER_TYPE = 'memberType'
+# The apps:property directMember of a group member entry
+DIRECT_MEMBER = 'directMember'
+
+
+class GroupEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents a group entry in object form."""
+
+ def GetGroupId(self):
+ """Get groupId of the GroupEntry object.
+
+ Returns:
+ The groupId this GroupEntry object as a string or None.
+ """
+ return self._GetProperty(GROUP_ID)
+
+ def SetGroupId(self, value):
+ """Set the groupId of this GroupEntry object.
+
+ Args:
+ value: string The new groupId to give this object.
+ """
+ self._SetProperty(GROUP_ID, value)
+
+ group_id = pyproperty(GetGroupId, SetGroupId)
+
+ def GetGroupName(self):
+ """Get the groupName of the GroupEntry object.
+
+ Returns:
+ The groupName of this GroupEntry object as a string or None.
+ """
+ return self._GetProperty(GROUP_NAME)
+
+ def SetGroupName(self, value):
+ """Set the groupName of this GroupEntry object.
+
+ Args:
+ value: string The new groupName to give this object.
+ """
+ self._SetProperty(GROUP_NAME, value)
+
+ group_name = pyproperty(GetGroupName, SetGroupName)
+
+ def GetDescription(self):
+ """Get the description of the GroupEntry object.
+
+ Returns:
+ The description of this GroupEntry object as a string or None.
+ """
+ return self._GetProperty(DESCRIPTION)
+
+ def SetDescription(self, value):
+ """Set the description of this GroupEntry object.
+
+ Args:
+ value: string The new description to give this object.
+ """
+ self._SetProperty(DESCRIPTION, value)
+
+ description = pyproperty(GetDescription, SetDescription)
+
+ def GetEmailPermission(self):
+ """Get the emailPermission of the GroupEntry object.
+
+ Returns:
+ The emailPermission of this GroupEntry object as a string or None.
+ """
+ return self._GetProperty(EMAIL_PERMISSION)
+
+ def SetEmailPermission(self, value):
+ """Set the emailPermission of this GroupEntry object.
+
+ Args:
+ value: string The new emailPermission to give this object.
+ """
+ self._SetProperty(EMAIL_PERMISSION, value)
+
+ email_permission = pyproperty(GetEmailPermission, SetEmailPermission)
+
+ def __init__(self, group_id=None, group_name=None, description=None,
+ email_permission=None, *args, **kwargs):
+ """Constructs a new GroupEntry object with the given arguments.
+
+ Args:
+ group_id: string identifier of the group.
+ group_name: string name of the group.
+ description: string (optional) the group description.
+ email_permisison: string (optional) permission level of the group.
+ """
+ super(GroupEntry, self).__init__(*args, **kwargs)
+ if group_id:
+ self.group_id = group_id
+ if group_name:
+ self.group_name = group_name
+ if description:
+ self.description = description
+ if email_permission:
+ self.email_permission = email_permission
+
+
+class GroupFeed(gdata.data.GDFeed):
+ """Represents a feed of GroupEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [GroupEntry]
+
+
+class GroupMemberEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents a group member in object form."""
+
+ def GetMemberId(self):
+ """Get the memberId of the GroupMember object.
+
+ Returns:
+ The memberId of this GroupMember object as a string.
+ """
+ return self._GetProperty(MEMBER_ID)
+
+ def SetMemberId(self, value):
+ """Set the memberId of this GroupMember object.
+
+ Args:
+ value: string The new memberId to give this object.
+ """
+ self._SetProperty(MEMBER_ID, value)
+
+ member_id = pyproperty(GetMemberId, SetMemberId)
+
+ def GetMemberType(self):
+ """Get the memberType(User, Group) of the GroupMember object.
+
+ Returns:
+ The memberType of this GroupMember object as a string or None.
+ """
+ return self._GetProperty(MEMBER_TYPE)
+
+ def SetMemberType(self, value):
+ """Set the memberType of this GroupMember object.
+
+ Args:
+ value: string The new memberType to give this object.
+ """
+ self._SetProperty(MEMBER_TYPE, value)
+
+ member_type = pyproperty(GetMemberType, SetMemberType)
+
+ def GetDirectMember(self):
+ """Get the directMember of the GroupMember object.
+
+ Returns:
+ The directMember of this GroupMember object as a bool or None.
+ """
+ return self._GetProperty(DIRECT_MEMBER)
+
+ def SetDirectMember(self, value):
+ """Set the memberType of this GroupMember object.
+
+ Args:
+ value: string The new memberType to give this object.
+ """
+ self._SetProperty(DIRECT_MEMBER, value)
+
+ direct_member = pyproperty(GetDirectMember, SetDirectMember)
+
+ def __init__(self, member_id=None, member_type=None,
+ direct_member=None, *args, **kwargs):
+ """Constructs a new GroupMemberEntry object with the given arguments.
+
+ Args:
+ member_id: string identifier of group member object.
+ member_type: string (optional) member type of group member object.
+ direct_member: bool (optional) if group member object is direct member.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(GroupMemberEntry, self).__init__(*args, **kwargs)
+ if member_id:
+ self.member_id = member_id
+ if member_type:
+ self.member_type = member_type
+ if direct_member:
+ self.direct_member = direct_member
+
+
+class GroupMemberFeed(gdata.data.GDFeed):
+ """Represents a feed of GroupMemberEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [GroupMemberEntry]
+
diff --git a/src/gdata/apps/groups/service.py b/src/gdata/apps/groups/service.py
new file mode 100644
index 0000000..80df417
--- /dev/null
+++ b/src/gdata/apps/groups/service.py
@@ -0,0 +1,387 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Allow Google Apps domain administrators to manage groups, group members and group owners.
+
+ GroupsService: Provides methods to manage groups, members and owners.
+"""
+
+__author__ = 'google-apps-apis@googlegroups.com'
+
+
+import urllib
+import gdata.apps
+import gdata.apps.service
+import gdata.service
+
+
+API_VER = '2.0'
+BASE_URL = '/a/feeds/group/' + API_VER + '/%s'
+GROUP_MEMBER_URL = BASE_URL + '?member=%s'
+GROUP_MEMBER_DIRECT_URL = GROUP_MEMBER_URL + '&directOnly=%s'
+GROUP_ID_URL = BASE_URL + '/%s'
+MEMBER_URL = BASE_URL + '/%s/member'
+MEMBER_WITH_SUSPENDED_URL = MEMBER_URL + '?includeSuspendedUsers=%s'
+MEMBER_ID_URL = MEMBER_URL + '/%s'
+OWNER_URL = BASE_URL + '/%s/owner'
+OWNER_WITH_SUSPENDED_URL = OWNER_URL + '?includeSuspendedUsers=%s'
+OWNER_ID_URL = OWNER_URL + '/%s'
+
+PERMISSION_OWNER = 'Owner'
+PERMISSION_MEMBER = 'Member'
+PERMISSION_DOMAIN = 'Domain'
+PERMISSION_ANYONE = 'Anyone'
+
+
+class GroupsService(gdata.apps.service.PropertyService):
+ """Client for the Google Apps Groups service."""
+
+ def _ServiceUrl(self, service_type, is_existed, group_id, member_id, owner_email,
+ direct_only=False, domain=None, suspended_users=False):
+ if domain is None:
+ domain = self.domain
+
+ if service_type == 'group':
+ if group_id != '' and is_existed:
+ return GROUP_ID_URL % (domain, group_id)
+ elif member_id != '':
+ if direct_only:
+ return GROUP_MEMBER_DIRECT_URL % (domain, urllib.quote_plus(member_id),
+ self._Bool2Str(direct_only))
+ else:
+ return GROUP_MEMBER_URL % (domain, urllib.quote_plus(member_id))
+ else:
+ return BASE_URL % (domain)
+
+ if service_type == 'member':
+ if member_id != '' and is_existed:
+ return MEMBER_ID_URL % (domain, group_id, urllib.quote_plus(member_id))
+ elif suspended_users:
+ return MEMBER_WITH_SUSPENDED_URL % (domain, group_id,
+ self._Bool2Str(suspended_users))
+ else:
+ return MEMBER_URL % (domain, group_id)
+
+ if service_type == 'owner':
+ if owner_email != '' and is_existed:
+ return OWNER_ID_URL % (domain, group_id, urllib.quote_plus(owner_email))
+ elif suspended_users:
+ return OWNER_WITH_SUSPENDED_URL % (domain, group_id,
+ self._Bool2Str(suspended_users))
+ else:
+ return OWNER_URL % (domain, group_id)
+
+ def _Bool2Str(self, b):
+ if b is None:
+ return None
+ return str(b is True).lower()
+
+ def _IsExisted(self, uri):
+ try:
+ self._GetProperties(uri)
+ return True
+ except gdata.apps.service.AppsForYourDomainException, e:
+ if e.error_code == gdata.apps.service.ENTITY_DOES_NOT_EXIST:
+ return False
+ else:
+ raise e
+
+ def CreateGroup(self, group_id, group_name, description, email_permission):
+ """Create a group.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ group_name: The name of the group.
+ description: A description of the group
+ email_permission: The subscription permission of the group.
+
+ Returns:
+ A dict containing the result of the create operation.
+ """
+ uri = self._ServiceUrl('group', False, group_id, '', '')
+ properties = {}
+ properties['groupId'] = group_id
+ properties['groupName'] = group_name
+ properties['description'] = description
+ properties['emailPermission'] = email_permission
+ return self._PostProperties(uri, properties)
+
+ def UpdateGroup(self, group_id, group_name, description, email_permission):
+ """Update a group's name, description and/or permission.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ group_name: The name of the group.
+ description: A description of the group
+ email_permission: The subscription permission of the group.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+ uri = self._ServiceUrl('group', True, group_id, '', '')
+ properties = {}
+ properties['groupId'] = group_id
+ properties['groupName'] = group_name
+ properties['description'] = description
+ properties['emailPermission'] = email_permission
+ return self._PutProperties(uri, properties)
+
+ def RetrieveGroup(self, group_id):
+ """Retrieve a group based on its ID.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('group', True, group_id, '', '')
+ return self._GetProperties(uri)
+
+ def RetrieveAllGroups(self):
+ """Retrieve all groups in the domain.
+
+ Args:
+ None
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('group', True, '', '', '')
+ return self._GetPropertiesList(uri)
+
+ def RetrievePageOfGroups(self, start_group=None):
+ """Retrieve one page of groups in the domain.
+
+ Args:
+ start_group: The key to continue for pagination through all groups.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('group', True, '', '', '')
+ if start_group is not None:
+ uri += "?start="+start_group
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
+
+ def RetrieveGroups(self, member_id, direct_only=False):
+ """Retrieve all groups that belong to the given member_id.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ direct_only: Boolean whether only return groups that this member directly belongs to.
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('group', True, '', member_id, '', direct_only=direct_only)
+ return self._GetPropertiesList(uri)
+
+ def DeleteGroup(self, group_id):
+ """Delete a group based on its ID.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the delete operation.
+ """
+ uri = self._ServiceUrl('group', True, group_id, '', '')
+ return self._DeleteProperties(uri)
+
+ def AddMemberToGroup(self, member_id, group_id):
+ """Add a member to a group.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the add operation.
+ """
+ uri = self._ServiceUrl('member', False, group_id, member_id, '')
+ properties = {}
+ properties['memberId'] = member_id
+ return self._PostProperties(uri, properties)
+
+ def IsMember(self, member_id, group_id):
+ """Check whether the given member already exists in the given group.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ True if the member exists in the group. False otherwise.
+ """
+ uri = self._ServiceUrl('member', True, group_id, member_id, '')
+ return self._IsExisted(uri)
+
+ def RetrieveMember(self, member_id, group_id):
+ """Retrieve the given member in the given group.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('member', True, group_id, member_id, '')
+ return self._GetProperties(uri)
+
+ def RetrieveAllMembers(self, group_id, suspended_users=False):
+ """Retrieve all members in the given group.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ suspended_users: A boolean; should we include any suspended users in
+ the membership list returned?
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('member', True, group_id, '', '',
+ suspended_users=suspended_users)
+ return self._GetPropertiesList(uri)
+
+ def RetrievePageOfMembers(self, group_id, suspended_users=False, start=None):
+ """Retrieve one page of members of a given group.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ suspended_users: A boolean; should we include any suspended users in
+ the membership list returned?
+ start: The key to continue for pagination through all members.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+
+ uri = self._ServiceUrl('member', True, group_id, '', '',
+ suspended_users=suspended_users)
+ if start is not None:
+ if suspended_users:
+ uri += "&start="+start
+ else:
+ uri += "?start="+start
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
+
+ def RemoveMemberFromGroup(self, member_id, group_id):
+ """Remove the given member from the given group.
+
+ Args:
+ member_id: The member's email address (e.g. member@example.com).
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the remove operation.
+ """
+ uri = self._ServiceUrl('member', True, group_id, member_id, '')
+ return self._DeleteProperties(uri)
+
+ def AddOwnerToGroup(self, owner_email, group_id):
+ """Add an owner to a group.
+
+ Args:
+ owner_email: The email address of a group owner.
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the add operation.
+ """
+ uri = self._ServiceUrl('owner', False, group_id, '', owner_email)
+ properties = {}
+ properties['email'] = owner_email
+ return self._PostProperties(uri, properties)
+
+ def IsOwner(self, owner_email, group_id):
+ """Check whether the given member an owner of the given group.
+
+ Args:
+ owner_email: The email address of a group owner.
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ True if the member is an owner of the given group. False otherwise.
+ """
+ uri = self._ServiceUrl('owner', True, group_id, '', owner_email)
+ return self._IsExisted(uri)
+
+ def RetrieveOwner(self, owner_email, group_id):
+ """Retrieve the given owner in the given group.
+
+ Args:
+ owner_email: The email address of a group owner.
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('owner', True, group_id, '', owner_email)
+ return self._GetProperties(uri)
+
+ def RetrieveAllOwners(self, group_id, suspended_users=False):
+ """Retrieve all owners of the given group.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ suspended_users: A boolean; should we include any suspended users in
+ the ownership list returned?
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('owner', True, group_id, '', '',
+ suspended_users=suspended_users)
+ return self._GetPropertiesList(uri)
+
+ def RetrievePageOfOwners(self, group_id, suspended_users=False, start=None):
+ """Retrieve one page of owners of the given group.
+
+ Args:
+ group_id: The ID of the group (e.g. us-sales).
+ suspended_users: A boolean; should we include any suspended users in
+ the ownership list returned?
+ start: The key to continue for pagination through all owners.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+ uri = self._ServiceUrl('owner', True, group_id, '', '',
+ suspended_users=suspended_users)
+ if start is not None:
+ if suspended_users:
+ uri += "&start="+start
+ else:
+ uri += "?start="+start
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
+
+ def RemoveOwnerFromGroup(self, owner_email, group_id):
+ """Remove the given owner from the given group.
+
+ Args:
+ owner_email: The email address of a group owner.
+ group_id: The ID of the group (e.g. us-sales).
+
+ Returns:
+ A dict containing the result of the remove operation.
+ """
+ uri = self._ServiceUrl('owner', True, group_id, '', owner_email)
+ return self._DeleteProperties(uri)
diff --git a/src/gdata/apps/migration/__init__.py b/src/gdata/apps/migration/__init__.py
new file mode 100644
index 0000000..0a7df6c
--- /dev/null
+++ b/src/gdata/apps/migration/__init__.py
@@ -0,0 +1,223 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2008 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains objects used with Google Apps."""
+
+__author__ = 'google-apps-apis@googlegroups.com'
+
+
+import atom
+import gdata
+
+
+# XML namespaces which are often used in Google Apps entity.
+APPS_NAMESPACE = 'http://schemas.google.com/apps/2006'
+APPS_TEMPLATE = '{http://schemas.google.com/apps/2006}%s'
+
+
+class Rfc822Msg(atom.AtomBase):
+ """The Migration rfc822Msg element."""
+
+ _tag = 'rfc822Msg'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['encoding'] = 'encoding'
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.text = text
+ self.encoding = 'base64'
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def Rfc822MsgFromString(xml_string):
+ """Parse in the Rrc822 message from the XML definition."""
+
+ return atom.CreateClassFromXMLString(Rfc822Msg, xml_string)
+
+
+class MailItemProperty(atom.AtomBase):
+ """The Migration mailItemProperty element."""
+
+ _tag = 'mailItemProperty'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def MailItemPropertyFromString(xml_string):
+ """Parse in the MailItemProperiy from the XML definition."""
+
+ return atom.CreateClassFromXMLString(MailItemProperty, xml_string)
+
+
+class Label(atom.AtomBase):
+ """The Migration label element."""
+
+ _tag = 'label'
+ _namespace = APPS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['labelName'] = 'label_name'
+
+ def __init__(self, label_name=None,
+ extension_elements=None, extension_attributes=None,
+ text=None):
+ self.label_name = label_name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def LabelFromString(xml_string):
+ """Parse in the mailItemProperty from the XML definition."""
+
+ return atom.CreateClassFromXMLString(Label, xml_string)
+
+
+class MailEntry(gdata.GDataEntry):
+ """A Google Migration flavor of an Atom Entry."""
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}rfc822Msg' % APPS_NAMESPACE] = ('rfc822_msg', Rfc822Msg)
+ _children['{%s}mailItemProperty' % APPS_NAMESPACE] = ('mail_item_property',
+ [MailItemProperty])
+ _children['{%s}label' % APPS_NAMESPACE] = ('label', [Label])
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ rfc822_msg=None, mail_item_property=None, label=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated)
+ self.rfc822_msg = rfc822_msg
+ self.mail_item_property = mail_item_property
+ self.label = label
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def MailEntryFromString(xml_string):
+ """Parse in the MailEntry from the XML definition."""
+
+ return atom.CreateClassFromXMLString(MailEntry, xml_string)
+
+
+class BatchMailEntry(gdata.BatchEntry):
+ """A Google Migration flavor of an Atom Entry."""
+
+ _tag = gdata.BatchEntry._tag
+ _namespace = gdata.BatchEntry._namespace
+ _children = gdata.BatchEntry._children.copy()
+ _attributes = gdata.BatchEntry._attributes.copy()
+ _children['{%s}rfc822Msg' % APPS_NAMESPACE] = ('rfc822_msg', Rfc822Msg)
+ _children['{%s}mailItemProperty' % APPS_NAMESPACE] = ('mail_item_property',
+ [MailItemProperty])
+ _children['{%s}label' % APPS_NAMESPACE] = ('label', [Label])
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ rfc822_msg=None, mail_item_property=None, label=None,
+ batch_operation=None, batch_id=None, batch_status=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.BatchEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ batch_operation=batch_operation,
+ batch_id=batch_id, batch_status=batch_status,
+ title=title, updated=updated)
+ self.rfc822_msg = rfc822_msg or None
+ self.mail_item_property = mail_item_property or []
+ self.label = label or []
+ self.extended_property = extended_property or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def BatchMailEntryFromString(xml_string):
+ """Parse in the BatchMailEntry from the XML definition."""
+
+ return atom.CreateClassFromXMLString(BatchMailEntry, xml_string)
+
+
+class BatchMailEventFeed(gdata.BatchFeed):
+ """A Migration event feed flavor of an Atom Feed."""
+
+ _tag = gdata.BatchFeed._tag
+ _namespace = gdata.BatchFeed._namespace
+ _children = gdata.BatchFeed._children.copy()
+ _attributes = gdata.BatchFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [BatchMailEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, interrupted=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.BatchFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ interrupted=interrupted,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+class MailEntryProperties(object):
+ """Represents a mail message and its attributes."""
+
+ def __init__(self, mail_message=None, mail_item_properties=None,
+ mail_labels=None, identifier=None):
+ self.mail_message = mail_message
+ self.mail_item_properties = mail_item_properties or []
+ self.mail_labels = mail_labels or []
+ self.identifier = identifier
+
+
+def BatchMailEventFeedFromString(xml_string):
+ """Parse in the BatchMailEventFeed from the XML definition."""
+
+ return atom.CreateClassFromXMLString(BatchMailEventFeed, xml_string)
diff --git a/src/gdata/apps/migration/service.py b/src/gdata/apps/migration/service.py
new file mode 100644
index 0000000..5a89eff
--- /dev/null
+++ b/src/gdata/apps/migration/service.py
@@ -0,0 +1,218 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2008 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains the methods to import mail via Google Apps Email Migration API.
+
+ MigrationService: Provides methods to import mail.
+"""
+
+__author__ = ('google-apps-apis@googlegroups.com',
+ 'pti@google.com (Prashant Tiwari)')
+
+
+import base64
+import threading
+import time
+from atom.service import deprecation
+from gdata.apps import migration
+from gdata.apps.migration import MailEntryProperties
+import gdata.apps.service
+import gdata.service
+
+
+API_VER = '2.0'
+
+
+class MigrationService(gdata.apps.service.AppsService):
+ """Client for the EMAPI migration service. Use either ImportMail to import
+ one message at a time, or AddMailEntry and ImportMultipleMails to import a
+ bunch of messages at a time.
+ """
+
+ def __init__(self, email=None, password=None, domain=None, source=None,
+ server='apps-apis.google.com', additional_headers=None):
+ gdata.apps.service.AppsService.__init__(
+ self, email=email, password=password, domain=domain, source=source,
+ server=server, additional_headers=additional_headers)
+ self.mail_batch = migration.BatchMailEventFeed()
+ self.mail_entries = []
+ self.exceptions = 0
+
+ def _BaseURL(self):
+ return '/a/feeds/migration/%s/%s' % (API_VER, self.domain)
+
+ def ImportMail(self, user_name, mail_message, mail_item_properties,
+ mail_labels):
+ """Imports a single mail message.
+
+ Args:
+ user_name: The username to import messages to.
+ mail_message: An RFC822 format email message.
+ mail_item_properties: A list of Gmail properties to apply to the message.
+ mail_labels: A list of labels to apply to the message.
+
+ Returns:
+ A MailEntry representing the successfully imported message.
+
+ Raises:
+ AppsForYourDomainException: An error occurred importing the message.
+ """
+ uri = '%s/%s/mail' % (self._BaseURL(), user_name)
+
+ mail_entry = migration.MailEntry()
+ mail_entry.rfc822_msg = migration.Rfc822Msg(text=(base64.b64encode(
+ mail_message)))
+ mail_entry.rfc822_msg.encoding = 'base64'
+ mail_entry.mail_item_property = map(
+ lambda x: migration.MailItemProperty(value=x), mail_item_properties)
+ mail_entry.label = map(lambda x: migration.Label(label_name=x),
+ mail_labels)
+
+ try:
+ return migration.MailEntryFromString(str(self.Post(mail_entry, uri)))
+ except gdata.service.RequestError, e:
+ # Store the number of failed imports when importing several at a time
+ self.exceptions += 1
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ def AddBatchEntry(self, mail_message, mail_item_properties,
+ mail_labels):
+ """Adds a message to the current batch that you later will submit.
+
+ Deprecated, use AddMailEntry instead
+
+ Args:
+ mail_message: An RFC822 format email message.
+ mail_item_properties: A list of Gmail properties to apply to the message.
+ mail_labels: A list of labels to apply to the message.
+
+ Returns:
+ The length of the MailEntry representing the message.
+ """
+ deprecation("calling deprecated method AddBatchEntry")
+ mail_entry = migration.BatchMailEntry()
+ mail_entry.rfc822_msg = migration.Rfc822Msg(text=(base64.b64encode(
+ mail_message)))
+ mail_entry.rfc822_msg.encoding = 'base64'
+ mail_entry.mail_item_property = map(
+ lambda x: migration.MailItemProperty(value=x), mail_item_properties)
+ mail_entry.label = map(lambda x: migration.Label(label_name=x),
+ mail_labels)
+
+ self.mail_batch.AddBatchEntry(mail_entry)
+
+ return len(str(mail_entry))
+
+ def SubmitBatch(self, user_name):
+ """Sends all the mail items you have added to the batch to the server.
+
+ Deprecated, use ImportMultipleMails instead
+
+ Args:
+ user_name: The username to import messages to.
+
+ Returns:
+ An HTTPResponse from the web service call.
+
+ Raises:
+ AppsForYourDomainException: An error occurred importing the batch.
+ """
+ deprecation("calling deprecated method SubmitBatch")
+ uri = '%s/%s/mail/batch' % (self._BaseURL(), user_name)
+
+ try:
+ self.result = self.Post(self.mail_batch, uri,
+ converter=migration.BatchMailEventFeedFromString)
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ self.mail_batch = migration.BatchMailEventFeed()
+
+ return self.result
+
+ def AddMailEntry(self, mail_message, mail_item_properties=None,
+ mail_labels=None, identifier=None):
+ """Prepares a list of mail messages to import using ImportMultipleMails.
+
+ Args:
+ mail_message: An RFC822 format email message as a string.
+ mail_item_properties: List of Gmail properties to apply to the
+ message.
+ mail_labels: List of Gmail labels to apply to the message.
+ identifier: The optional file identifier string
+
+ Returns:
+ The number of email messages to be imported.
+ """
+ mail_entry_properties = MailEntryProperties(
+ mail_message=mail_message,
+ mail_item_properties=mail_item_properties,
+ mail_labels=mail_labels,
+ identifier=identifier)
+
+ self.mail_entries.append(mail_entry_properties)
+ return len(self.mail_entries)
+
+ def ImportMultipleMails(self, user_name, threads_per_batch=20):
+ """Launches separate threads to import every message added by AddMailEntry.
+
+ Args:
+ user_name: The user account name to import messages to.
+ threads_per_batch: Number of messages to import at a time.
+
+ Returns:
+ The number of email messages that were successfully migrated.
+
+ Raises:
+ Exception: An error occurred while importing mails.
+ """
+ num_entries = len(self.mail_entries)
+
+ if not num_entries:
+ return 0
+
+ threads = []
+ for mail_entry_properties in self.mail_entries:
+ t = threading.Thread(name=mail_entry_properties.identifier,
+ target=self.ImportMail,
+ args=(user_name, mail_entry_properties.mail_message,
+ mail_entry_properties.mail_item_properties,
+ mail_entry_properties.mail_labels))
+ threads.append(t)
+ try:
+ # Determine the number of batches needed with threads_per_batch in each
+ batches = num_entries / threads_per_batch + (
+ 0 if num_entries % threads_per_batch == 0 else 1)
+ batch_min = 0
+ # Start the threads, one batch at a time
+ for batch in range(batches):
+ batch_max = ((batch + 1) * threads_per_batch
+ if (batch + 1) * threads_per_batch < num_entries
+ else num_entries)
+ for i in range(batch_min, batch_max):
+ threads[i].start()
+ time.sleep(1)
+
+ for i in range(batch_min, batch_max):
+ threads[i].join()
+
+ batch_min = batch_max
+
+ self.mail_entries = []
+ except Exception, e:
+ raise Exception(e.args[0])
+ else:
+ return num_entries - self.exceptions
diff --git a/src/gdata/apps/multidomain/__init__.py b/src/gdata/apps/multidomain/__init__.py
new file mode 100755
index 0000000..e69de29
--- /dev/null
+++ b/src/gdata/apps/multidomain/__init__.py
diff --git a/src/gdata/apps/multidomain/client.py b/src/gdata/apps/multidomain/client.py
new file mode 100755
index 0000000..711794f
--- /dev/null
+++ b/src/gdata/apps/multidomain/client.py
@@ -0,0 +1,382 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""MultiDomainProvisioningClient simplifies Multidomain Provisioning API calls.
+
+MultiDomainProvisioningClient extends gdata.client.GDClient to ease interaction
+with the Google Multidomain Provisioning API. These interactions include the
+ability to create, retrieve, update and delete users and aliases in multiple
+domains.
+"""
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import urllib
+import gdata.apps.multidomain.data
+import gdata.client
+
+
+# Multidomain URI templates
+# The strings in this template are eventually replaced with the feed type
+# (user/alias), API version and Google Apps domain name, respectively.
+MULTIDOMAIN_URI_TEMPLATE = '/a/feeds/%s/%s/%s'
+# The strings in this template are eventually replaced with the API version,
+# Google Apps domain name and old email address, respectively.
+MULTIDOMAIN_USER_RENAME_URI_TEMPLATE = '/a/feeds/user/userEmail/%s/%s/%s'
+
+# The value for user requests
+MULTIDOMAIN_USER_FEED = 'user'
+# The value for alias requests
+MULTIDOMAIN_ALIAS_FEED = 'alias'
+
+
+class MultiDomainProvisioningClient(gdata.client.GDClient):
+ """Client extension for the Google MultiDomain Provisioning API service.
+
+ Attributes:
+ host: string The hostname for the MultiDomain Provisioning API service.
+ api_version: string The version of the MultiDomain Provisioning API.
+ """
+
+ host = 'apps-apis.google.com'
+ api_version = '2.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+ ssl = True
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the MultiDomain Provisioning API.
+
+ Args:
+ domain: string The Google Apps domain with MultiDomain Provisioning.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the email settings.
+ kwargs: The other parameters to pass to the gdata.client.GDClient
+ constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def make_multidomain_provisioning_uri(
+ self, feed_type, email=None, params=None):
+
+ """Creates a resource feed URI for the MultiDomain Provisioning API.
+
+ Using this client's Google Apps domain, create a feed URI for multidomain
+ provisioning in that domain. If an email address is provided, return a
+ URI for that specific resource. If params are provided, append them as GET
+ params.
+
+ Args:
+ feed_type: string The type of feed (user/alias)
+ email: string (optional) The email address of multidomain resource for
+ which to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for multidomain provisioning for this client's
+ Google Apps domain.
+ """
+ uri = MULTIDOMAIN_URI_TEMPLATE % (feed_type, self.api_version, self.domain)
+ if email:
+ uri += '/' + email
+ if params:
+ uri += '?' + urllib.urlencode(params)
+ return uri
+
+ MakeMultidomainProvisioningUri = make_multidomain_provisioning_uri
+
+ def make_multidomain_user_provisioning_uri(self, email=None, params=None):
+ """Creates a resource feed URI for the MultiDomain User Provisioning API.
+
+ Using this client's Google Apps domain, create a feed URI for multidomain
+ user provisioning in that domain. If an email address is provided, return a
+ URI for that specific resource. If params are provided, append them as GET
+ params.
+
+ Args:
+ email: string (optional) The email address of multidomain user for which
+ to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for multidomain user provisioning for thisis that
+ client's Google Apps domain.
+ """
+ return self.make_multidomain_provisioning_uri(
+ MULTIDOMAIN_USER_FEED, email, params)
+
+ MakeMultidomainUserProvisioningUri = make_multidomain_user_provisioning_uri
+
+ def make_multidomain_alias_provisioning_uri(self, email=None, params=None):
+ """Creates a resource feed URI for the MultiDomain Alias Provisioning API.
+
+ Using this client's Google Apps domain, create a feed URI for multidomain
+ alias provisioning in that domain. If an email address is provided, return a
+ URI for that specific resource. If params are provided, append them as GET
+ params.
+
+ Args:
+ email: string (optional) The email address of multidomain alias for which
+ to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for multidomain alias provisioning for this
+ client's Google Apps domain.
+ """
+ return self.make_multidomain_provisioning_uri(
+ MULTIDOMAIN_ALIAS_FEED, email, params)
+
+ MakeMultidomainAliasProvisioningUri = make_multidomain_alias_provisioning_uri
+
+ def retrieve_all_pages(self, uri, desired_class=gdata.data.GDFeed, **kwargs):
+ """Retrieves all pages from uri.
+
+ Args:
+ uri: The uri where the first page is.
+ desired_class: Type of feed that is retrieved.
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A desired_class feed object.
+ """
+ feed = self.GetFeed(
+ uri,
+ desired_class=desired_class,
+ **kwargs)
+ next_link = feed.GetNextLink()
+ while next_link is not None:
+ uri = next_link.href
+ temp_feed = self.GetFeed(
+ uri, desired_class=desired_class, **kwargs)
+ feed.entry = feed.entry + temp_feed.entry
+ next_link = temp_feed.GetNextLink()
+ return feed
+
+ RetrieveAllPages = retrieve_all_pages
+
+ def retrieve_all_users(self, **kwargs):
+ """Retrieves all users in all domains.
+
+ Args:
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A gdata.data.GDFeed of the domain users
+ """
+ uri = self.MakeMultidomainUserProvisioningUri()
+ return self.RetrieveAllPages(
+ uri,
+ desired_class=gdata.apps.multidomain.data.UserFeed,
+ **kwargs)
+
+ RetrieveAllUsers = retrieve_all_users
+
+ def retrieve_user(self, email, **kwargs):
+ """Retrieves a single user in the domain.
+
+ Args:
+ email: string The email address of the user to be retrieved
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetEntry()
+
+ Returns:
+ A gdata.apps.multidomain.data.UserEntry representing the user
+ """
+ uri = self.MakeMultidomainUserProvisioningUri(email=email)
+ return self.GetEntry(
+ uri,
+ desired_class=gdata.apps.multidomain.data.UserEntry,
+ **kwargs)
+
+ RetrieveUser = retrieve_user
+
+ def create_user(self, email, first_name, last_name, password, is_admin,
+ hash_function=None, suspended=None, change_password=None,
+ ip_whitelisted=None, quota=None, **kwargs):
+ """Creates an user in the domain with the given properties.
+
+ Args:
+ email: string The email address of the user.
+ first_name: string The first name of the user.
+ last_name: string The last name of the user.
+ password: string The password of the user.
+ is_admin: Boolean Whether or not the user has administrator privileges.
+ hash_function: string (optional) The name of the function used to hash the
+ password.
+ suspended: Boolean (optional) Whether or not the user is suspended.
+ change_password: Boolean (optional) Whether or not the user must change
+ password at first login.
+ ip_whitelisted: Boolean (optional) Whether or not the user's ip is
+ whitelisted.
+ quota: string (optional) The value (in GB) of the user's quota.
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ A gdata.apps.multidomain.data.UserEntry of the new user
+ """
+ new_user = gdata.apps.multidomain.data.UserEntry(
+ email=email, first_name=first_name, last_name=last_name,
+ password=password, is_admin=is_admin, hash_function=hash_function,
+ suspended=suspended, change_password=change_password,
+ ip_whitelisted=ip_whitelisted, quota=quota)
+ return self.post(new_user, self.MakeMultidomainUserProvisioningUri(),
+ **kwargs)
+
+ CreateUser = create_user
+
+ def update_user(self, email, user_entry, **kwargs):
+ """Deletes the user with the given email address.
+
+ Args:
+ email: string The email address of the user to be updated.
+ user_entry: UserEntry The user entry with updated values.
+ kwargs: The other parameters to pass to gdata.client.GDClient.put()
+
+ Returns:
+ A gdata.apps.multidomain.data.UserEntry representing the user
+ """
+ return self.update(user_entry,
+ uri=self.MakeMultidomainUserProvisioningUri(email),
+ **kwargs)
+
+ UpdateUser = update_user
+
+ def delete_user(self, email, **kwargs):
+ """Deletes the user with the given email address.
+
+ Args:
+ email: string The email address of the user to delete.
+ kwargs: The other parameters to pass to gdata.client.GDClient.delete()
+
+ Returns:
+ An HTTP response object. See gdata.client.request().
+ """
+ return self.delete(self.MakeMultidomainUserProvisioningUri(email), **kwargs)
+
+ DeleteUser = delete_user
+
+ def rename_user(self, old_email, new_email, **kwargs):
+ """Renames an user's account to a different domain.
+
+ Args:
+ old_email: string The old email address of the user to rename.
+ new_email: string The new email address for the user to be renamed.
+ kwargs: The other parameters to pass to gdata.client.GDClient.put()
+
+ Returns:
+ A gdata.apps.multidomain.data.UserRenameRequest representing the request.
+ """
+ rename_uri = MULTIDOMAIN_USER_RENAME_URI_TEMPLATE % (self.api_version,
+ self.domain,
+ old_email)
+ entry = gdata.apps.multidomain.data.UserRenameRequest(new_email)
+ return self.update(entry, uri=rename_uri, **kwargs)
+
+ RenameUser = rename_user
+
+ def retrieve_all_aliases(self, **kwargs):
+ """Retrieves all aliases in the domain.
+
+ Args:
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A gdata.data.GDFeed of the domain aliases
+ """
+ uri = self.MakeMultidomainAliasProvisioningUri()
+ return self.RetrieveAllPages(
+ uri,
+ desired_class=gdata.apps.multidomain.data.AliasFeed,
+ **kwargs)
+
+ RetrieveAllAliases = retrieve_all_aliases
+
+ def retrieve_alias(self, email, **kwargs):
+ """Retrieves a single alias in the domain.
+
+ Args:
+ email: string The email address of the alias to be retrieved
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetEntry()
+
+ Returns:
+ A gdata.apps.multidomain.data.AliasEntry representing the alias
+ """
+ uri = self.MakeMultidomainAliasProvisioningUri(email=email)
+ return self.GetEntry(
+ uri,
+ desired_class=gdata.apps.multidomain.data.AliasEntry,
+ **kwargs)
+
+ RetrieveAlias = retrieve_alias
+
+ def retrieve_all_user_aliases(self, user_email, **kwargs):
+ """Retrieves all aliases for a given user in the domain.
+
+ Args:
+ user_email: string Email address of the user whose aliases
+ are to be retrieved
+ kwargs: The other parameters to pass to gdata.client.GDClient.GetFeed()
+
+ Returns:
+ A gdata.data.GDFeed of the user aliases
+ """
+ uri = self.MakeMultidomainAliasProvisioningUri(
+ params = {'userEmail' : user_email})
+ return self.RetrieveAllPages(
+ uri,
+ desired_class=gdata.apps.multidomain.data.AliasFeed,
+ **kwargs)
+
+ RetrieveAllUserAliases = retrieve_all_user_aliases
+
+ def create_alias(self, user_email, alias_email, **kwargs):
+ """Creates an alias in the domain with the given properties.
+
+ Args:
+ user_email: string The email address of the user.
+ alias_email: string The first name of the user.
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ A gdata.apps.multidomain.data.AliasEntry of the new alias
+ """
+ new_alias = gdata.apps.multidomain.data.AliasEntry(
+ user_email=user_email, alias_email=alias_email)
+ return self.post(new_alias, self.MakeMultidomainAliasProvisioningUri(),
+ **kwargs)
+
+ CreateAlias = create_alias
+
+ def delete_alias(self, email, **kwargs):
+ """Deletes the alias with the given email address.
+
+ Args:
+ email: string The email address of the alias to delete.
+ kwargs: The other parameters to pass to gdata.client.GDClient.delete()
+
+ Returns:
+ An HTTP response object. See gdata.client.request().
+ """
+ return self.delete(self.MakeMultidomainAliasProvisioningUri(email),
+ **kwargs)
+
+ DeleteAlias = delete_alias
diff --git a/src/gdata/apps/multidomain/data.py b/src/gdata/apps/multidomain/data.py
new file mode 100755
index 0000000..9bc467a
--- /dev/null
+++ b/src/gdata/apps/multidomain/data.py
@@ -0,0 +1,414 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for the Multidomain Provisioning API."""
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import gdata.apps
+import gdata.apps.apps_property_entry
+import gdata.apps_property
+import gdata.data
+
+
+# This is required to work around a naming conflict between the Google
+# Spreadsheets API and Python's built-in property function
+pyproperty = property
+
+
+# The apps:property firstName of a user entry
+USER_FIRST_NAME = 'firstName'
+# The apps:property lastName of a user entry
+USER_LAST_NAME = 'lastName'
+# The apps:property userEmail of a user entry
+USER_EMAIL = 'userEmail'
+# The apps:property password of a user entry
+USER_PASSWORD = 'password'
+# The apps:property hashFunction of a user entry
+USER_HASH_FUNCTION = 'hashFunction'
+# The apps:property isChangePasswordAtNextLogin of a user entry
+USER_CHANGE_PASSWORD = 'isChangePasswordAtNextLogin'
+# The apps:property agreedToTerms of a user entry
+USER_AGREED_TO_TERMS = 'agreedToTerms'
+# The apps:property isSuspended of a user entry
+USER_SUSPENDED = 'isSuspended'
+# The apps:property isAdmin of a user entry
+USER_ADMIN = 'isAdmin'
+# The apps:property ipWhitelisted of a user entry
+USER_IP_WHITELISTED = 'ipWhitelisted'
+# The apps:property quotaInGb of a user entry
+USER_QUOTA = 'quotaInGb'
+
+# The apps:property newEmail of a user rename request entry
+USER_NEW_EMAIL = 'newEmail'
+
+# The apps:property aliasEmail of an alias entry
+ALIAS_EMAIL = 'aliasEmail'
+
+
+class UserEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents an User in object form."""
+
+ def GetFirstName(self):
+ """Get the first name of the User object.
+
+ Returns:
+ The first name of this User object as a string or None.
+ """
+ return self._GetProperty(USER_FIRST_NAME)
+
+ def SetFirstName(self, value):
+ """Set the first name of this User object.
+
+ Args:
+ value: string The new first name to give this object.
+ """
+ self._SetProperty(USER_FIRST_NAME, value)
+
+ first_name = pyproperty(GetFirstName, SetFirstName)
+
+ def GetLastName(self):
+ """Get the last name of the User object.
+
+ Returns:
+ The last name of this User object as a string or None.
+ """
+ return self._GetProperty(USER_LAST_NAME)
+
+ def SetLastName(self, value):
+ """Set the last name of this User object.
+
+ Args:
+ value: string The new last name to give this object.
+ """
+ self._SetProperty(USER_LAST_NAME, value)
+
+ last_name = pyproperty(GetLastName, SetLastName)
+
+ def GetEmail(self):
+ """Get the email address of the User object.
+
+ Returns:
+ The email address of this User object as a string or None.
+ """
+ return self._GetProperty(USER_EMAIL)
+
+ def SetEmail(self, value):
+ """Set the email address of this User object.
+
+ Args:
+ value: string The new email address to give this object.
+ """
+ self._SetProperty(USER_EMAIL, value)
+
+ email = pyproperty(GetEmail, SetEmail)
+
+ def GetPassword(self):
+ """Get the password of the User object.
+
+ Returns:
+ The password of this User object as a string or None.
+ """
+ return self._GetProperty(USER_PASSWORD)
+
+ def SetPassword(self, value):
+ """Set the password of this User object.
+
+ Args:
+ value: string The new password to give this object.
+ """
+ self._SetProperty(USER_PASSWORD, value)
+
+ password = pyproperty(GetPassword, SetPassword)
+
+ def GetHashFunction(self):
+ """Get the hash function of the User object.
+
+ Returns:
+ The hash function of this User object as a string or None.
+ """
+ return self._GetProperty(USER_HASH_FUNCTION)
+
+ def SetHashFunction(self, value):
+ """Set the hash function of this User object.
+
+ Args:
+ value: string The new hash function to give this object.
+ """
+ self._SetProperty(USER_HASH_FUNCTION, value)
+
+ hash_function = pyproperty(GetHashFunction, SetHashFunction)
+
+ def GetChangePasswordAtNextLogin(self):
+ """Get the change password at next login flag of the User object.
+
+ Returns:
+ The change password at next login flag of this User object as a string or
+ None.
+ """
+ return self._GetProperty(USER_CHANGE_PASSWORD)
+
+ def SetChangePasswordAtNextLogin(self, value):
+ """Set the change password at next login flag of this User object.
+
+ Args:
+ value: string The new change password at next login flag to give this
+ object.
+ """
+ self._SetProperty(USER_CHANGE_PASSWORD, value)
+
+ change_password_at_next_login = pyproperty(GetChangePasswordAtNextLogin,
+ SetChangePasswordAtNextLogin)
+
+ def GetAgreedToTerms(self):
+ """Get the agreed to terms flag of the User object.
+
+ Returns:
+ The agreed to terms flag of this User object as a string or None.
+ """
+ return self._GetProperty(USER_AGREED_TO_TERMS)
+
+ agreed_to_terms = pyproperty(GetAgreedToTerms)
+
+ def GetSuspended(self):
+ """Get the suspended flag of the User object.
+
+ Returns:
+ The suspended flag of this User object as a string or None.
+ """
+ return self._GetProperty(USER_SUSPENDED)
+
+ def SetSuspended(self, value):
+ """Set the suspended flag of this User object.
+
+ Args:
+ value: string The new suspended flag to give this object.
+ """
+ self._SetProperty(USER_SUSPENDED, value)
+
+ suspended = pyproperty(GetSuspended, SetSuspended)
+
+ def GetIsAdmin(self):
+ """Get the isAdmin flag of the User object.
+
+ Returns:
+ The isAdmin flag of this User object as a string or None.
+ """
+ return self._GetProperty(USER_ADMIN)
+
+ def SetIsAdmin(self, value):
+ """Set the isAdmin flag of this User object.
+
+ Args:
+ value: string The new isAdmin flag to give this object.
+ """
+ self._SetProperty(USER_ADMIN, value)
+
+ is_admin = pyproperty(GetIsAdmin, SetIsAdmin)
+
+ def GetIpWhitelisted(self):
+ """Get the ipWhitelisted flag of the User object.
+
+ Returns:
+ The ipWhitelisted flag of this User object as a string or None.
+ """
+ return self._GetProperty(USER_IP_WHITELISTED)
+
+ def SetIpWhitelisted(self, value):
+ """Set the ipWhitelisted flag of this User object.
+
+ Args:
+ value: string The new ipWhitelisted flag to give this object.
+ """
+ self._SetProperty(USER_IP_WHITELISTED, value)
+
+ ip_whitelisted = pyproperty(GetIpWhitelisted, SetIpWhitelisted)
+
+ def GetQuota(self):
+ """Get the quota of the User object.
+
+ Returns:
+ The quota of this User object as a string or None.
+ """
+ return self._GetProperty(USER_QUOTA)
+
+ def SetQuota(self, value):
+ """Set the quota of this User object.
+
+ Args:
+ value: string The new quota to give this object.
+ """
+ self._SetProperty(USER_QUOTA, value)
+
+ quota = pyproperty(GetQuota, GetQuota)
+
+ def __init__(self, uri=None, email=None, first_name=None, last_name=None,
+ password=None, hash_function=None, change_password=None,
+ agreed_to_terms=None, suspended=None, is_admin=None,
+ ip_whitelisted=None, quota=None, *args, **kwargs):
+ """Constructs a new UserEntry object with the given arguments.
+
+ Args:
+ uri: string (optional) The uri of of this object for HTTP requests.
+ email: string (optional) The email address of the user.
+ first_name: string (optional) The first name of the user.
+ last_name: string (optional) The last name of the user.
+ password: string (optional) The password of the user.
+ hash_function: string (optional) The name of the function used to hash the
+ password.
+ change_password: Boolean (optional) Whether or not the user must change
+ password at first login.
+ agreed_to_terms: Boolean (optional) Whether or not the user has agreed to
+ the Terms of Service.
+ suspended: Boolean (optional) Whether or not the user is suspended.
+ is_admin: Boolean (optional) Whether or not the user has administrator
+ privileges.
+ ip_whitelisted: Boolean (optional) Whether or not the user's ip is
+ whitelisted.
+ quota: string (optional) The value (in GB) of the user's quota.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(UserEntry, self).__init__(*args, **kwargs)
+ if uri:
+ self.uri = uri
+ if email:
+ self.email = email
+ if first_name:
+ self.first_name = first_name
+ if last_name:
+ self.last_name = last_name
+ if password:
+ self.password = password
+ if hash_function:
+ self.hash_function = hash_function
+ if change_password is not None:
+ self.change_password_at_next_login = str(change_password)
+ if agreed_to_terms is not None:
+ self.agreed_to_terms = str(agreed_to_terms)
+ if suspended is not None:
+ self.suspended = str(suspended)
+ if is_admin is not None:
+ self.is_admin = str(is_admin)
+ if ip_whitelisted is not None:
+ self.ip_whitelisted = str(ip_whitelisted)
+ if quota:
+ self.quota = quota
+
+
+class UserFeed(gdata.data.GDFeed):
+ """Represents a feed of UserEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [UserEntry]
+
+
+class UserRenameRequest(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents an User rename request in object form."""
+
+ def GetNewEmail(self):
+ """Get the new email address for the User object.
+
+ Returns:
+ The new email address for the User object as a string or None.
+ """
+ return self._GetProperty(USER_NEW_EMAIL)
+
+ def SetNewEmail(self, value):
+ """Set the new email address for the User object.
+
+ Args:
+ value: string The new email address to give this object.
+ """
+ self._SetProperty(USER_NEW_EMAIL, value)
+
+ new_email = pyproperty(GetNewEmail, SetNewEmail)
+
+ def __init__(self, new_email=None, *args, **kwargs):
+ """Constructs a new UserRenameRequest object with the given arguments.
+
+ Args:
+ new_email: string (optional) The new email address for the target user.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(UserRenameRequest, self).__init__(*args, **kwargs)
+ if new_email:
+ self.new_email = new_email
+
+
+class AliasEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents an Alias in object form."""
+
+ def GetUserEmail(self):
+ """Get the user email address of the Alias object.
+
+ Returns:
+ The user email address of this Alias object as a string or None.
+ """
+ return self._GetProperty(USER_EMAIL)
+
+ def SetUserEmail(self, value):
+ """Set the user email address of this Alias object.
+
+ Args:
+ value: string The new user email address to give this object.
+ """
+ self._SetProperty(USER_EMAIL, value)
+
+ user_email = pyproperty(GetUserEmail, SetUserEmail)
+
+ def GetAliasEmail(self):
+ """Get the alias email address of the Alias object.
+
+ Returns:
+ The alias email address of this Alias object as a string or None.
+ """
+ return self._GetProperty(ALIAS_EMAIL)
+
+ def SetAliasEmail(self, value):
+ """Set the alias email address of this Alias object.
+
+ Args:
+ value: string The new alias email address to give this object.
+ """
+ self._SetProperty(ALIAS_EMAIL, value)
+
+ alias_email = pyproperty(GetAliasEmail, SetAliasEmail)
+
+ def __init__(self, user_email=None, alias_email=None, *args, **kwargs):
+ """Constructs a new AliasEntry object with the given arguments.
+
+ Args:
+ user_email: string (optional) The user email address for the object.
+ alias_email: string (optional) The alias email address for the object.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(AliasEntry, self).__init__(*args, **kwargs)
+ if user_email:
+ self.user_email = user_email
+ if alias_email:
+ self.alias_email = alias_email
+
+
+class AliasFeed(gdata.data.GDFeed):
+ """Represents a feed of AliasEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [AliasEntry]
diff --git a/src/gdata/apps/organization/__init__.py b/src/gdata/apps/organization/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/src/gdata/apps/organization/__init__.py
diff --git a/src/gdata/apps/organization/client.py b/src/gdata/apps/organization/client.py
new file mode 100644
index 0000000..b94e767
--- /dev/null
+++ b/src/gdata/apps/organization/client.py
@@ -0,0 +1,519 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""OrganizationUnitProvisioningClient simplifies OrgUnit Provisioning API calls.
+
+OrganizationUnitProvisioningClient extends gdata.client.GDClient to ease
+interaction with the Google Organization Unit Provisioning API.
+These interactions include the ability to create, retrieve, update and delete
+organization units, move users within organization units, retrieve customerId
+and update and retrieve users in organization units.
+"""
+
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+
+import urllib
+import gdata.apps.organization.data
+import gdata.client
+
+CUSTOMER_ID_URI_TEMPLATE = '/a/feeds/customer/%s/customerId'
+
+# OrganizationUnit URI templates
+# The strings in this template are eventually replaced with the feed type
+# (orgunit/orguser), API version and Google Apps domain name, respectively.
+ORGANIZATION_UNIT_URI_TEMPLATE = '/a/feeds/%s/%s/%s'
+
+# The value for orgunit requests
+ORGANIZATION_UNIT_FEED = 'orgunit'
+# The value for orguser requests
+ORGANIZATION_USER_FEED = 'orguser'
+
+
+class OrganizationUnitProvisioningClient(gdata.client.GDClient):
+ """Client extension for the Google Org Unit Provisioning API service.
+
+ Attributes:
+ host: string The hostname for the MultiDomain Provisioning API service.
+ api_version: string The version of the MultiDomain Provisioning API.
+ """
+
+ host = 'apps-apis.google.com'
+ api_version = '2.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+ ssl = True
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the Organization Unit Provisioning API.
+
+ Args:
+ domain: string The Google Apps domain with Organization Unit
+ Provisioning.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the Organization
+ Units.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def make_organization_unit_provisioning_uri(
+ self, feed_type, customer_id, org_unit_path_or_user_email=None,
+ params=None):
+
+ """Creates a resource feed URI for the Organization Unit Provisioning API.
+
+ Using this client's Google Apps domain, create a feed URI for organization
+ unit provisioning in that domain. If an org unit path or org user email
+ address is provided, return a URI for that specific resource.
+ If params are provided, append them as GET params.
+
+ Args:
+ feed_type: string The type of feed (orgunit/orguser)
+ customer_id: string The customerId of the user.
+ org_unit_path_or_user_email: string (optional) The org unit path or
+ org user email address for which to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for organization unit provisioning for this
+ client's Google Apps domain.
+ """
+ uri = ORGANIZATION_UNIT_URI_TEMPLATE % (feed_type, self.api_version,
+ customer_id)
+ if org_unit_path_or_user_email:
+ uri += '/' + org_unit_path_or_user_email
+ if params:
+ uri += '?' + urllib.urlencode(params)
+ return uri
+
+ MakeOrganizationUnitProvisioningUri = make_organization_unit_provisioning_uri
+
+ def make_organization_unit_orgunit_provisioning_uri(self, customer_id,
+ org_unit_path=None,
+ params=None):
+ """Creates a resource feed URI for the orgunit's Provisioning API calls.
+
+ Using this client's Google Apps domain, create a feed URI for organization
+ unit orgunit's provisioning in that domain. If an org_unit_path is
+ provided, return a URI for that specific resource.
+ If params are provided, append them as GET params.
+
+ Args:
+ customer_id: string The customerId of the user.
+ org_unit_path: string (optional) The organization unit's path for which
+ to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for organization unit provisioning for
+ given org_unit_path
+ """
+ return self.make_organization_unit_provisioning_uri(
+ ORGANIZATION_UNIT_FEED, customer_id, org_unit_path, params)
+
+ MakeOrganizationUnitOrgunitProvisioningUri = make_organization_unit_orgunit_provisioning_uri
+
+ def make_organization_unit_orguser_provisioning_uri(self, customer_id,
+ org_user_email=None,
+ params=None):
+ """Creates a resource feed URI for the orguser's Provisioning API calls.
+
+ Using this client's Google Apps domain, create a feed URI for organization
+ unit orguser's provisioning in that domain. If an org_user_email is
+ provided, return a URI for that specific resource.
+ If params are provided, append them as GET params.
+
+ Args:
+ customer_id: string The customerId of the user.
+ org_user_email: string (optional) The organization unit's path for which
+ to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+
+ Returns:
+ A string giving the URI for organization user provisioning for
+ given org_user_email
+ """
+ return self.make_organization_unit_provisioning_uri(
+ ORGANIZATION_USER_FEED, customer_id, org_user_email, params)
+
+ MakeOrganizationUnitOrguserProvisioningUri = make_organization_unit_orguser_provisioning_uri
+
+ def make_customer_id_feed_uri(self):
+ """Creates a feed uri for retrieving customerId of the user.
+
+ Returns:
+ A string giving the URI for retrieving customerId of the user.
+ """
+ uri = CUSTOMER_ID_URI_TEMPLATE % (self.api_version)
+ return uri
+
+ MakeCustomerIdFeedUri = make_customer_id_feed_uri
+
+ def retrieve_customer_id(self, **kwargs):
+ """Retrieve the Customer ID for the customer domain.
+
+ Returns:
+ A gdata.apps.organization.data.CustomerIdEntry.
+ """
+ uri = self.MakeCustomerIdFeedUri()
+ return self.GetEntry(
+ uri,
+ desired_class=gdata.apps.organization.data.CustomerIdEntry,
+ **kwargs)
+
+ RetrieveCustomerId = retrieve_customer_id
+
+ def create_org_unit(self, customer_id, name, parent_org_unit_path='/',
+ description='', block_inheritance=False, **kwargs):
+ """Create a Organization Unit.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ name: string The simple organization unit text name, not the full path
+ name.
+ parent_org_unit_path: string The full path of the parental tree to this
+ organization unit (default: '/').
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+ description: string The human readable text description of the
+ organization unit (optional).
+ block_inheritance: boolean This parameter blocks policy setting
+ inheritance from organization units higher in
+ the organization tree (default: False).
+
+ Returns:
+ A gdata.apps.organization.data.OrgUnitEntry representing an organization
+ unit.
+ """
+ new_org_unit = gdata.apps.organization.data.OrgUnitEntry(
+ org_unit_name=name, parent_org_unit_path=parent_org_unit_path,
+ org_unit_description=description,
+ org_unit_block_inheritance=block_inheritance)
+ return self.post(
+ new_org_unit,
+ self.MakeOrganizationUnitOrgunitProvisioningUri(customer_id), **kwargs)
+
+ CreateOrgUnit = create_org_unit
+
+ def update_org_unit(self, customer_id, org_unit_path, org_unit_entry,
+ **kwargs):
+ """Update a Organization Unit.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+ org_unit_entry: gdata.apps.organization.data.OrgUnitEntry
+ The updated organization unit entry.
+
+ Returns:
+ A gdata.apps.organization.data.OrgUnitEntry representing an organization
+ unit.
+ """
+ if not org_unit_entry.GetParentOrgUnitPath():
+ org_unit_entry.SetParentOrgUnitPath('/')
+ return self.update(org_unit_entry,
+ uri=self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, org_unit_path=org_unit_path), **kwargs)
+
+ UpdateOrgUnit = update_org_unit
+
+ def move_users_to_org_unit(self, customer_id, org_unit_path, users_to_move,
+ **kwargs):
+ """Move a user to an Organization Unit.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+ users_to_move: list Email addresses of users to move in list format.
+ [Note: You can move a maximum of 25 users at one time.]
+
+ Returns:
+ A gdata.apps.organization.data.OrgUnitEntry representing
+ an organization unit.
+ """
+ org_unit_entry = self.retrieve_org_unit(customer_id, org_unit_path)
+ org_unit_entry.SetUsersToMove(', '.join(users_to_move))
+ if not org_unit_entry.GetParentOrgUnitPath():
+ org_unit_entry.SetParentOrgUnitPath('/')
+ return self.update(org_unit_entry,
+ uri=self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, org_unit_path=org_unit_path), **kwargs)
+
+ MoveUserToOrgUnit = move_users_to_org_unit
+
+ def retrieve_org_unit(self, customer_id, org_unit_path, **kwargs):
+ """Retrieve a Orgunit based on its path.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+
+ Returns:
+ A gdata.apps.organization.data.OrgUnitEntry representing
+ an organization unit.
+ """
+ uri = self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, org_unit_path=org_unit_path)
+ return self.GetEntry(
+ uri, desired_class=gdata.apps.organization.data.OrgUnitEntry, **kwargs)
+
+ RetrieveOrgUnit = retrieve_org_unit
+
+ def retrieve_feed_from_uri(self, uri, desired_class, **kwargs):
+ """Retrieve feed from given uri.
+
+ Args:
+ uri: string The uri from where to get the feed.
+ desired_class: Feed The type of feed that if to be retrieved.
+
+ Returns:
+ Feed of type desired class.
+ """
+ return self.GetFeed(uri, desired_class=desired_class, **kwargs)
+
+ RetrieveFeedFromUri = retrieve_feed_from_uri
+
+ def retrieve_all_org_units_from_uri(self, uri, **kwargs):
+ """Retrieve all OrgUnits from given uri.
+
+ Args:
+ uri: string The uri from where to get the orgunits.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUnitFeed object
+ """
+ orgunit_feed = gdata.apps.organization.data.OrgUnitFeed()
+ temp_feed = self.RetrieveFeedFromUri(
+ uri, gdata.apps.organization.data.OrgUnitFeed)
+ orgunit_feed.entry = temp_feed.entry
+ next_link = temp_feed.GetNextLink()
+ while next_link is not None:
+ uri = next_link.GetAttributes()[0].value
+ temp_feed = self.GetFeed(
+ uri, desired_class=gdata.apps.organization.data.OrgUnitFeed, **kwargs)
+ orgunit_feed.entry[0:0] = temp_feed.entry
+ next_link = temp_feed.GetNextLink()
+ return orgunit_feed
+
+ RetrieveAllOrgUnitsFromUri = retrieve_all_org_units_from_uri
+
+ def retrieve_all_org_units(self, customer_id, **kwargs):
+ """Retrieve all OrgUnits in the customer's domain.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUnitFeed object
+ """
+ uri = self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, params={'get': 'all'}, **kwargs)
+ return self.RetrieveAllOrgUnitsFromUri(uri)
+
+ RetrieveAllOrgUnits = retrieve_all_org_units
+
+ def retrieve_page_of_org_units(self, customer_id, startKey=None, **kwargs):
+ """Retrieve one page of OrgUnits in the customer's domain.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ startKey: string The key to continue for pagination through all OrgUnits.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUnitFeed object
+ """
+ uri = ''
+ if startKey is not None:
+ uri = self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, params={'get': 'all', 'startKey': startKey}, **kwargs)
+ else:
+ uri = self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, params={'get': 'all'}, **kwargs)
+ return self.GetFeed(
+ uri, desired_class=gdata.apps.organization.data.OrgUnitFeed, **kwargs)
+
+ RetrievePageOfOrgUnits = retrieve_page_of_org_units
+
+ def retrieve_sub_org_units(self, customer_id, org_unit_path, **kwargs):
+ """Retrieve all Sub-OrgUnits of the provided OrgUnit.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+
+ Returns:
+ gdata.apps.organisation.data.OrgUnitFeed object
+ """
+ uri = self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id,
+ params={'get': 'children', 'orgUnitPath': org_unit_path}, **kwargs)
+ return self.RetrieveAllOrgUnitsFromUri(uri)
+
+ RetrieveSubOrgUnits = retrieve_sub_org_units
+
+ def delete_org_unit(self, customer_id, org_unit_path, **kwargs):
+ """Delete a Orgunit based on its path.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+
+ Returns:
+ An HTTP response object. See gdata.client.request().
+ """
+ return self.delete(self.MakeOrganizationUnitOrgunitProvisioningUri(
+ customer_id, org_unit_path=org_unit_path), **kwargs)
+
+ DeleteOrgUnit = delete_org_unit
+
+ def update_org_user(self, customer_id, user_email, org_unit_path, **kwargs):
+ """Update the OrgUnit of a OrgUser.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ user_email: string The email address of the user.
+ org_unit_path: string The new organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+
+ Returns:
+ A gdata.apps.organization.data.OrgUserEntry representing
+ an organization user.
+ """
+ old_user_entry = self.RetrieveOrgUser(customer_id, user_email)
+ old_org_unit_path = old_user_entry.GetOrgUnitPath()
+ if not old_org_unit_path:
+ old_org_unit_path = '/'
+ old_user_entry.SetOldOrgUnitPath(old_org_unit_path)
+ old_user_entry.SetOrgUnitPath(org_unit_path)
+ return self.update(old_user_entry,
+ uri=self.MakeOrganizationUnitOrguserProvisioningUri(
+ customer_id, user_email), **kwargs)
+
+ UpdateOrgUser = update_org_user
+
+ def retrieve_org_user(self, customer_id, user_email, **kwargs):
+ """Retrieve an organization user.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ user_email: string The email address of the user.
+
+ Returns:
+ A gdata.apps.organization.data.OrgUserEntry representing
+ an organization user.
+ """
+ uri = self.MakeOrganizationUnitOrguserProvisioningUri(customer_id,
+ user_email)
+ return self.GetEntry(
+ uri, desired_class=gdata.apps.organization.data.OrgUserEntry, **kwargs)
+
+ RetrieveOrgUser = retrieve_org_user
+
+ def retrieve_all_org_users_from_uri(self, uri, **kwargs):
+ """Retrieve all OrgUsers from given uri.
+
+ Args:
+ uri: string The uri from where to get the orgusers.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUserFeed object
+ """
+ orguser_feed = gdata.apps.organization.data.OrgUserFeed()
+ temp_feed = self.RetrieveFeedFromUri(
+ uri, gdata.apps.organization.data.OrgUserFeed)
+ orguser_feed.entry = temp_feed.entry
+ next_link = temp_feed.GetNextLink()
+ while next_link is not None:
+ uri = next_link.GetAttributes()[0].value
+ temp_feed = self.GetFeed(
+ uri, desired_class=gdata.apps.organization.data.OrgUserFeed, **kwargs)
+ orguser_feed.entry[0:0] = temp_feed.entry
+ next_link = temp_feed.GetNextLink()
+ return orguser_feed
+
+ RetrieveAllOrgUsersFromUri = retrieve_all_org_users_from_uri
+
+ def retrieve_all_org_users(self, customer_id, **kwargs):
+ """Retrieve all OrgUsers in the customer's domain.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUserFeed object
+ """
+ uri = self.MakeOrganizationUnitOrguserProvisioningUri(
+ customer_id, params={'get': 'all'}, **kwargs)
+ return self.RetrieveAllOrgUsersFromUri(uri)
+
+ RetrieveAllOrgUsers = retrieve_all_org_users
+
+ def retrieve_page_of_org_users(self, customer_id, startKey=None, **kwargs):
+ """Retrieve one page of OrgUsers in the customer's domain.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ startKey: The string key to continue for pagination through all OrgUnits.
+
+ Returns:
+ gdata.apps.organisation.data.OrgUserFeed object
+ """
+ uri = ''
+ if startKey is not None:
+ uri = self.MakeOrganizationUnitOrguserProvisioningUri(
+ customer_id, params={'get': 'all', 'startKey': startKey}, **kwargs)
+ else:
+ uri = self.MakeOrganizationUnitOrguserProvisioningUri(
+ customer_id, params={'get': 'all'})
+ return self.GetFeed(
+ uri, desired_class=gdata.apps.organization.data.OrgUserFeed, **kwargs)
+
+ RetrievePageOfOrgUsers = retrieve_page_of_org_users
+
+ def retrieve_org_unit_users(self, customer_id, org_unit_path, **kwargs):
+ """Retrieve all OrgUsers of the provided OrgUnit.
+
+ Args:
+ customer_id: string The ID of the Google Apps customer.
+ org_unit_path: string The organization's full path name.
+ [Note: Each element of the path MUST be URL encoded
+ (example: finance%2Forganization/suborganization)]
+
+ Returns:
+ gdata.apps.organisation.data.OrgUserFeed object
+ """
+ uri = self.MakeOrganizationUnitOrguserProvisioningUri(
+ customer_id,
+ params={'get': 'children', 'orgUnitPath': org_unit_path})
+ return self.RetrieveAllOrgUsersFromUri(uri, **kwargs)
+
+ RetrieveOrgUnitUsers = retrieve_org_unit_users
diff --git a/src/gdata/apps/organization/data.py b/src/gdata/apps/organization/data.py
new file mode 100644
index 0000000..e750fe6
--- /dev/null
+++ b/src/gdata/apps/organization/data.py
@@ -0,0 +1,366 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for the Organization Unit Provisioning API."""
+
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+
+import gdata.apps
+import gdata.apps.apps_property_entry
+import gdata.apps_property
+import gdata.data
+
+
+# This is required to work around a naming conflict between the Google
+# Spreadsheets API and Python's built-in property function
+pyproperty = property
+
+
+# The apps:property name of an organization unit
+ORG_UNIT_NAME = 'name'
+# The apps:property orgUnitPath of an organization unit
+ORG_UNIT_PATH = 'orgUnitPath'
+# The apps:property parentOrgUnitPath of an organization unit
+PARENT_ORG_UNIT_PATH = 'parentOrgUnitPath'
+# The apps:property description of an organization unit
+ORG_UNIT_DESCRIPTION = 'description'
+# The apps:property blockInheritance of an organization unit
+ORG_UNIT_BLOCK_INHERITANCE = 'blockInheritance'
+# The apps:property userEmail of a user entry
+USER_EMAIL = 'orgUserEmail'
+# The apps:property list of users to move
+USERS_TO_MOVE = 'usersToMove'
+# The apps:property list of moved users
+MOVED_USERS = 'usersMoved'
+# The apps:property customerId for the domain
+CUSTOMER_ID = 'customerId'
+# The apps:property name of the customer org unit
+CUSTOMER_ORG_UNIT_NAME = 'customerOrgUnitName'
+# The apps:property description of the customer org unit
+CUSTOMER_ORG_UNIT_DESCRIPTION = 'customerOrgUnitDescription'
+# The apps:property old organization unit's path for a user
+OLD_ORG_UNIT_PATH = 'oldOrgUnitPath'
+
+
+class CustomerIdEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents a customerId entry in object form."""
+
+ def GetCustomerId(self):
+ """Get the customer ID of the customerId object.
+
+ Returns:
+ The customer ID of this customerId object as a string or None.
+ """
+ return self._GetProperty(CUSTOMER_ID)
+
+ customer_id = pyproperty(GetCustomerId)
+
+ def GetOrgUnitName(self):
+ """Get the Organization Unit name of the customerId object.
+
+ Returns:
+ The Organization unit name of this customerId object as a string or None.
+ """
+ return self._GetProperty(ORG_UNIT_NAME)
+
+ org_unit_name = pyproperty(GetOrgUnitName)
+
+ def GetCustomerOrgUnitName(self):
+ """Get the Customer Organization Unit name of the customerId object.
+
+ Returns:
+ The Customer Organization unit name of this customerId object as a string
+ or None.
+ """
+ return self._GetProperty(CUSTOMER_ORG_UNIT_NAME)
+
+ customer_org_unit_name = pyproperty(GetCustomerOrgUnitName)
+
+ def GetOrgUnitDescription(self):
+ """Get the Organization Unit Description of the customerId object.
+
+ Returns:
+ The Organization Unit Description of this customerId object as a string
+ or None.
+ """
+ return self._GetProperty(ORG_UNIT_DESCRIPTION)
+
+ org_unit_description = pyproperty(GetOrgUnitDescription)
+
+ def GetCustomerOrgUnitDescription(self):
+ """Get the Customer Organization Unit Description of the customerId object.
+
+ Returns:
+ The Customer Organization Unit Description of this customerId object
+ as a string or None.
+ """
+ return self._GetProperty(CUSTOMER_ORG_UNIT_DESCRIPTION)
+
+ customer_org_unit_description = pyproperty(GetCustomerOrgUnitDescription)
+
+
+class OrgUnitEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents an OrganizationUnit in object form."""
+
+ def GetOrgUnitName(self):
+ """Get the Organization Unit name of the OrganizationUnit object.
+
+ Returns:
+ The Organization unit name of this OrganizationUnit object as a string
+ or None.
+ """
+ return self._GetProperty(ORG_UNIT_NAME)
+
+ def SetOrgUnitName(self, value):
+ """Set the Organization Unit name of the OrganizationUnit object.
+
+ Args:
+ value: [string] The new Organization Unit name to give this object.
+ """
+ self._SetProperty(ORG_UNIT_NAME, value)
+
+ org_unit_name = pyproperty(GetOrgUnitName, SetOrgUnitName)
+
+ def GetOrgUnitPath(self):
+ """Get the Organization Unit Path of the OrganizationUnit object.
+
+ Returns:
+ The Organization Unit Path of this OrganizationUnit object as a string
+ or None.
+ """
+ return self._GetProperty(ORG_UNIT_PATH)
+
+ def SetOrgUnitPath(self, value):
+ """Set the Organization Unit path of the OrganizationUnit object.
+
+ Args:
+ value: [string] The new Organization Unit path to give this object.
+ """
+ self._SetProperty(ORG_UNIT_PATH, value)
+
+ org_unit_path = pyproperty(GetOrgUnitPath, SetOrgUnitPath)
+
+ def GetParentOrgUnitPath(self):
+ """Get the Parent Organization Unit Path of the OrganizationUnit object.
+
+ Returns:
+ The Parent Organization Unit Path of this OrganizationUnit object
+ as a string or None.
+ """
+ return self._GetProperty(PARENT_ORG_UNIT_PATH)
+
+ def SetParentOrgUnitPath(self, value):
+ """Set the Parent Organization Unit path of the OrganizationUnit object.
+
+ Args:
+ value: [string] The new Parent Organization Unit path
+ to give this object.
+ """
+ self._SetProperty(PARENT_ORG_UNIT_PATH, value)
+
+ parent_org_unit_path = pyproperty(GetParentOrgUnitPath, SetParentOrgUnitPath)
+
+ def GetOrgUnitDescription(self):
+ """Get the Organization Unit Description of the OrganizationUnit object.
+
+ Returns:
+ The Organization Unit Description of this OrganizationUnit object
+ as a string or None.
+ """
+ return self._GetProperty(ORG_UNIT_DESCRIPTION)
+
+ def SetOrgUnitDescription(self, value):
+ """Set the Organization Unit Description of the OrganizationUnit object.
+
+ Args:
+ value: [string] The new Organization Unit Description
+ to give this object.
+ """
+ self._SetProperty(ORG_UNIT_DESCRIPTION, value)
+
+ org_unit_description = pyproperty(GetOrgUnitDescription,
+ SetOrgUnitDescription)
+
+ def GetOrgUnitBlockInheritance(self):
+ """Get the block_inheritance flag of the OrganizationUnit object.
+
+ Returns:
+ The the block_inheritance flag of this OrganizationUnit object
+ as a string or None.
+ """
+ return self._GetProperty(ORG_UNIT_BLOCK_INHERITANCE)
+
+ def SetOrgUnitBlockInheritance(self, value):
+ """Set the block_inheritance flag of the OrganizationUnit object.
+
+ Args:
+ value: [string] The new block_inheritance flag to give this object.
+ """
+ self._SetProperty(ORG_UNIT_BLOCK_INHERITANCE, value)
+
+ org_unit_block_inheritance = pyproperty(GetOrgUnitBlockInheritance,
+ SetOrgUnitBlockInheritance)
+
+ def GetMovedUsers(self):
+ """Get the moved users of the OrganizationUnit object.
+
+ Returns:
+ The the moved users of this OrganizationUnit object as a string or None.
+ """
+ return self._GetProperty(MOVED_USERS)
+
+ def SetUsersToMove(self, value):
+ """Set the Users to Move of the OrganizationUnit object.
+
+ Args:
+ value: [string] The comma seperated list of users to move
+ to give this object.
+ """
+ self._SetProperty(USERS_TO_MOVE, value)
+
+ move_users = pyproperty(GetMovedUsers, SetUsersToMove)
+
+ def __init__(
+ self, org_unit_name=None, org_unit_path=None,
+ parent_org_unit_path=None, org_unit_description=None,
+ org_unit_block_inheritance=None, move_users=None, *args, **kwargs):
+ """Constructs a new OrganizationUnit object with the given arguments.
+
+ Args:
+ org_unit_name: string (optional) The organization unit name
+ for the object.
+ org_unit_path: string (optional) The organization unit path
+ for the object.
+ parent_org_unit_path: string (optional) The parent organization unit path
+ for the object.
+ org_unit_description: string (optional) The organization unit description
+ for the object.
+ org_unit_block_inheritance: boolean (optional) weather or not inheritance
+ from the organization unit is blocked.
+ move_users: string (optional) comma seperated list of users to move.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(OrgUnitEntry, self).__init__(*args, **kwargs)
+ if org_unit_name:
+ self.org_unit_name = org_unit_name
+ if org_unit_path:
+ self.org_unit_path = org_unit_path
+ if parent_org_unit_path:
+ self.parent_org_unit_path = parent_org_unit_path
+ if org_unit_description:
+ self.org_unit_description = org_unit_description
+ if org_unit_block_inheritance is not None:
+ self.org_unit_block_inheritance = str(org_unit_block_inheritance)
+ if move_users:
+ self.move_users = move_users
+
+
+class OrgUnitFeed(gdata.data.GDFeed):
+ """Represents a feed of OrgUnitEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [OrgUnitEntry]
+
+
+class OrgUserEntry(gdata.apps.apps_property_entry.AppsPropertyEntry):
+ """Represents an OrgUser in object form."""
+
+ def GetUserEmail(self):
+ """Get the user email address of the OrgUser object.
+
+ Returns:
+ The user email address of this OrgUser object as a string or None.
+ """
+ return self._GetProperty(USER_EMAIL)
+
+ def SetUserEmail(self, value):
+ """Set the user email address of this OrgUser object.
+
+ Args:
+ value: string The new user email address to give this object.
+ """
+ self._SetProperty(USER_EMAIL, value)
+
+ user_email = pyproperty(GetUserEmail, SetUserEmail)
+
+ def GetOrgUnitPath(self):
+ """Get the Organization Unit Path of the OrgUser object.
+
+ Returns:
+ The Organization Unit Path of this OrgUser object as a string or None.
+ """
+ return self._GetProperty(ORG_UNIT_PATH)
+
+ def SetOrgUnitPath(self, value):
+ """Set the Organization Unit path of the OrgUser object.
+
+ Args:
+ value: [string] The new Organization Unit path to give this object.
+ """
+ self._SetProperty(ORG_UNIT_PATH, value)
+
+ org_unit_path = pyproperty(GetOrgUnitPath, SetOrgUnitPath)
+
+ def GetOldOrgUnitPath(self):
+ """Get the Old Organization Unit Path of the OrgUser object.
+
+ Returns:
+ The Old Organization Unit Path of this OrgUser object as a string
+ or None.
+ """
+ return self._GetProperty(OLD_ORG_UNIT_PATH)
+
+ def SetOldOrgUnitPath(self, value):
+ """Set the Old Organization Unit path of the OrgUser object.
+
+ Args:
+ value: [string] The new Old Organization Unit path to give this object.
+ """
+ self._SetProperty(OLD_ORG_UNIT_PATH, value)
+
+ old_org_unit_path = pyproperty(GetOldOrgUnitPath, SetOldOrgUnitPath)
+
+ def __init__(
+ self, user_email=None, org_unit_path=None,
+ old_org_unit_path=None, *args, **kwargs):
+ """Constructs a new OrgUser object with the given arguments.
+
+ Args:
+ user_email: string (optional) The user email address for the object.
+ org_unit_path: string (optional) The organization unit path
+ for the object.
+ old_org_unit_path: string (optional) The old organization unit path
+ for the object.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(OrgUserEntry, self).__init__(*args, **kwargs)
+ if user_email:
+ self.user_email = user_email
+ if org_unit_path:
+ self.org_unit_path = org_unit_path
+ if old_org_unit_path:
+ self.old_org_unit_path = old_org_unit_path
+
+
+class OrgUserFeed(gdata.data.GDFeed):
+ """Represents a feed of OrgUserEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [OrgUserEntry]
diff --git a/src/gdata/apps/organization/service.py b/src/gdata/apps/organization/service.py
new file mode 100644
index 0000000..763a6bc
--- /dev/null
+++ b/src/gdata/apps/organization/service.py
@@ -0,0 +1,297 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Allow Google Apps domain administrators to manage organization unit and organization user.
+
+ OrganizationService: Provides methods to manage organization unit and organization user.
+"""
+
+__author__ = 'Alexandre Vivien (alex@simplecode.fr)'
+
+
+import gdata.apps
+import gdata.apps.service
+import gdata.service
+
+
+API_VER = '2.0'
+CUSTOMER_BASE_URL = '/a/feeds/customer/2.0/customerId'
+BASE_UNIT_URL = '/a/feeds/orgunit/' + API_VER + '/%s'
+UNIT_URL = BASE_UNIT_URL + '/%s'
+UNIT_ALL_URL = BASE_UNIT_URL + '?get=all'
+UNIT_CHILD_URL = BASE_UNIT_URL + '?get=children&orgUnitPath=%s'
+BASE_USER_URL = '/a/feeds/orguser/' + API_VER + '/%s'
+USER_URL = BASE_USER_URL + '/%s'
+USER_ALL_URL = BASE_USER_URL + '?get=all'
+USER_CHILD_URL = BASE_USER_URL + '?get=children&orgUnitPath=%s'
+
+
+class OrganizationService(gdata.apps.service.PropertyService):
+ """Client for the Google Apps Organizations service."""
+
+ def _Bool2Str(self, b):
+ if b is None:
+ return None
+ return str(b is True).lower()
+
+ def RetrieveCustomerId(self):
+ """Retrieve the Customer ID for the account of the authenticated administrator making this request.
+
+ Args:
+ None.
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+
+ uri = CUSTOMER_BASE_URL
+ return self._GetProperties(uri)
+
+ def CreateOrgUnit(self, customer_id, name, parent_org_unit_path='/', description='', block_inheritance=False):
+ """Create a Organization Unit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ name: The simple organization unit text name, not the full path name.
+ parent_org_unit_path: The full path of the parental tree to this organization unit (default: '/').
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+ description: The human readable text description of the organization unit (optional).
+ block_inheritance: This parameter blocks policy setting inheritance
+ from organization units higher in the organization tree (default: False).
+
+ Returns:
+ A dict containing the result of the create operation.
+ """
+
+ uri = BASE_UNIT_URL % (customer_id)
+ properties = {}
+ properties['name'] = name
+ properties['parentOrgUnitPath'] = parent_org_unit_path
+ properties['description'] = description
+ properties['blockInheritance'] = self._Bool2Str(block_inheritance)
+ return self._PostProperties(uri, properties)
+
+ def UpdateOrgUnit(self, customer_id, org_unit_path, name=None, parent_org_unit_path=None,
+ description=None, block_inheritance=None):
+ """Update a Organization Unit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+ name: The simple organization unit text name, not the full path name.
+ parent_org_unit_path: The full path of the parental tree to this organization unit.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+ description: The human readable text description of the organization unit.
+ block_inheritance: This parameter blocks policy setting inheritance
+ from organization units higher in the organization tree.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+
+ uri = UNIT_URL % (customer_id, org_unit_path)
+ properties = {}
+ if name:
+ properties['name'] = name
+ if parent_org_unit_path:
+ properties['parentOrgUnitPath'] = parent_org_unit_path
+ if description:
+ properties['description'] = description
+ if block_inheritance:
+ properties['blockInheritance'] = self._Bool2Str(block_inheritance)
+ return self._PutProperties(uri, properties)
+
+ def MoveUserToOrgUnit(self, customer_id, org_unit_path, users_to_move):
+ """Move a user to an Organization Unit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+ users_to_move: Email addresses list of users to move. Note: You can move a maximum of 25 users at one time.
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+
+ uri = UNIT_URL % (customer_id, org_unit_path)
+ properties = {}
+ if users_to_move and isinstance(users_to_move, list):
+ properties['usersToMove'] = ', '.join(users_to_move)
+ return self._PutProperties(uri, properties)
+
+ def RetrieveOrgUnit(self, customer_id, org_unit_path):
+ """Retrieve a Orgunit based on its path.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+ uri = UNIT_URL % (customer_id, org_unit_path)
+ return self._GetProperties(uri)
+
+ def DeleteOrgUnit(self, customer_id, org_unit_path):
+ """Delete a Orgunit based on its path.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+
+ Returns:
+ A dict containing the result of the delete operation.
+ """
+ uri = UNIT_URL % (customer_id, org_unit_path)
+ return self._DeleteProperties(uri)
+
+ def RetrieveAllOrgUnits(self, customer_id):
+ """Retrieve all OrgUnits in the customer's domain.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = UNIT_ALL_URL % (customer_id)
+ return self._GetPropertiesList(uri)
+
+ def RetrievePageOfOrgUnits(self, customer_id, startKey=None):
+ """Retrieve one page of OrgUnits in the customer's domain.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ startKey: The key to continue for pagination through all OrgUnits.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+ uri = UNIT_ALL_URL % (customer_id)
+ if startKey is not None:
+ uri += "&startKey=" + startKey
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
+
+ def RetrieveSubOrgUnits(self, customer_id, org_unit_path):
+ """Retrieve all Sub-OrgUnits of the provided OrgUnit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = UNIT_CHILD_URL % (customer_id, org_unit_path)
+ return self._GetPropertiesList(uri)
+
+ def RetrieveOrgUser(self, customer_id, user_email):
+ """Retrieve the OrgUnit of the user.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ user_email: The email address of the user.
+
+ Returns:
+ A dict containing the result of the retrieve operation.
+ """
+ uri = USER_URL % (customer_id, user_email)
+ return self._GetProperties(uri)
+
+ def UpdateOrgUser(self, customer_id, user_email, org_unit_path):
+ """Update the OrgUnit of a OrgUser.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ user_email: The email address of the user.
+ org_unit_path: The new organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+
+ Returns:
+ A dict containing the result of the update operation.
+ """
+
+ uri = USER_URL % (customer_id, user_email)
+ properties = {}
+ if org_unit_path:
+ properties['orgUnitPath'] = org_unit_path
+ return self._PutProperties(uri, properties)
+
+ def RetrieveAllOrgUsers(self, customer_id):
+ """Retrieve all OrgUsers in the customer's domain.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = USER_ALL_URL % (customer_id)
+ return self._GetPropertiesList(uri)
+
+ def RetrievePageOfOrgUsers(self, customer_id, startKey=None):
+ """Retrieve one page of OrgUsers in the customer's domain.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ startKey: The key to continue for pagination through all OrgUnits.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+ uri = USER_ALL_URL % (customer_id)
+ if startKey is not None:
+ uri += "&startKey=" + startKey
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
+
+ def RetrieveOrgUnitUsers(self, customer_id, org_unit_path):
+ """Retrieve all OrgUsers of the provided OrgUnit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+
+ Returns:
+ A list containing the result of the retrieve operation.
+ """
+ uri = USER_CHILD_URL % (customer_id, org_unit_path)
+ return self._GetPropertiesList(uri)
+
+ def RetrieveOrgUnitPageOfUsers(self, customer_id, org_unit_path, startKey=None):
+ """Retrieve one page of OrgUsers of the provided OrgUnit.
+
+ Args:
+ customer_id: The ID of the Google Apps customer.
+ org_unit_path: The organization's full path name.
+ Note: Each element of the path MUST be URL encoded (example: finance%2Forganization/suborganization)
+ startKey: The key to continue for pagination through all OrgUsers.
+
+ Returns:
+ A feed object containing the result of the retrieve operation.
+ """
+ uri = USER_CHILD_URL % (customer_id, org_unit_path)
+ if startKey is not None:
+ uri += "&startKey=" + startKey
+ property_feed = self._GetPropertyFeed(uri)
+ return property_feed
diff --git a/src/gdata/apps/service.py b/src/gdata/apps/service.py
new file mode 100644
index 0000000..bc97484
--- /dev/null
+++ b/src/gdata/apps/service.py
@@ -0,0 +1,552 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 SIOS Technology, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'tmatsuo@sios.com (Takashi MATSUO)'
+
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import urllib
+import gdata
+import atom.service
+import gdata.service
+import gdata.apps
+import atom
+
+API_VER="2.0"
+HTTP_OK=200
+
+UNKOWN_ERROR=1000
+USER_DELETED_RECENTLY=1100
+USER_SUSPENDED=1101
+DOMAIN_USER_LIMIT_EXCEEDED=1200
+DOMAIN_ALIAS_LIMIT_EXCEEDED=1201
+DOMAIN_SUSPENDED=1202
+DOMAIN_FEATURE_UNAVAILABLE=1203
+ENTITY_EXISTS=1300
+ENTITY_DOES_NOT_EXIST=1301
+ENTITY_NAME_IS_RESERVED=1302
+ENTITY_NAME_NOT_VALID=1303
+INVALID_GIVEN_NAME=1400
+INVALID_FAMILY_NAME=1401
+INVALID_PASSWORD=1402
+INVALID_USERNAME=1403
+INVALID_HASH_FUNCTION_NAME=1404
+INVALID_HASH_DIGGEST_LENGTH=1405
+INVALID_EMAIL_ADDRESS=1406
+INVALID_QUERY_PARAMETER_VALUE=1407
+TOO_MANY_RECIPIENTS_ON_EMAIL_LIST=1500
+
+DEFAULT_QUOTA_LIMIT='2048'
+
+
+class Error(Exception):
+ pass
+
+
+class AppsForYourDomainException(Error):
+
+ def __init__(self, response):
+
+ Error.__init__(self, response)
+ try:
+ self.element_tree = ElementTree.fromstring(response['body'])
+ self.error_code = int(self.element_tree[0].attrib['errorCode'])
+ self.reason = self.element_tree[0].attrib['reason']
+ self.invalidInput = self.element_tree[0].attrib['invalidInput']
+ except:
+ self.error_code = UNKOWN_ERROR
+
+
+class AppsService(gdata.service.GDataService):
+ """Client for the Google Apps Provisioning service."""
+
+ def __init__(self, email=None, password=None, domain=None, source=None,
+ server='apps-apis.google.com', additional_headers=None,
+ **kwargs):
+ """Creates a client for the Google Apps Provisioning service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ domain: string (optional) The Google Apps domain name.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'apps-apis.google.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='apps', source=source,
+ server=server, additional_headers=additional_headers, **kwargs)
+ self.ssl = True
+ self.port = 443
+ self.domain = domain
+
+ def _baseURL(self):
+ return "/a/feeds/%s" % self.domain
+
+ def AddAllElementsFromAllPages(self, link_finder, func):
+ """retrieve all pages and add all elements"""
+ next = link_finder.GetNextLink()
+ while next is not None:
+ next_feed = self.Get(next.href, converter=func)
+ for a_entry in next_feed.entry:
+ link_finder.entry.append(a_entry)
+ next = next_feed.GetNextLink()
+ return link_finder
+
+ def RetrievePageOfEmailLists(self, start_email_list_name=None,
+ num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY,
+ backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve one page of email list"""
+ uri = "%s/emailList/%s" % (self._baseURL(), API_VER)
+ if start_email_list_name is not None:
+ uri += "?startEmailListName=%s" % start_email_list_name
+ try:
+ return gdata.apps.EmailListFeedFromString(str(self.GetWithRetries(
+ uri, num_retries=num_retries, delay=delay, backoff=backoff)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def GetGeneratorForAllEmailLists(
+ self, num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY, backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve a generator for all emaillists in this domain."""
+ first_page = self.RetrievePageOfEmailLists(num_retries=num_retries,
+ delay=delay,
+ backoff=backoff)
+ return self.GetGeneratorFromLinkFinder(
+ first_page, gdata.apps.EmailListRecipientFeedFromString,
+ num_retries=num_retries, delay=delay, backoff=backoff)
+
+ def RetrieveAllEmailLists(self):
+ """Retrieve all email list of a domain."""
+
+ ret = self.RetrievePageOfEmailLists()
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.EmailListFeedFromString)
+
+ def RetrieveEmailList(self, list_name):
+ """Retreive a single email list by the list's name."""
+
+ uri = "%s/emailList/%s/%s" % (
+ self._baseURL(), API_VER, list_name)
+ try:
+ return self.Get(uri, converter=gdata.apps.EmailListEntryFromString)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def RetrieveEmailLists(self, recipient):
+ """Retrieve All Email List Subscriptions for an Email Address."""
+
+ uri = "%s/emailList/%s?recipient=%s" % (
+ self._baseURL(), API_VER, recipient)
+ try:
+ ret = gdata.apps.EmailListFeedFromString(str(self.Get(uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.EmailListFeedFromString)
+
+ def RemoveRecipientFromEmailList(self, recipient, list_name):
+ """Remove recipient from email list."""
+
+ uri = "%s/emailList/%s/%s/recipient/%s" % (
+ self._baseURL(), API_VER, list_name, recipient)
+ try:
+ self.Delete(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def RetrievePageOfRecipients(self, list_name, start_recipient=None,
+ num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY,
+ backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve one page of recipient of an email list. """
+
+ uri = "%s/emailList/%s/%s/recipient" % (
+ self._baseURL(), API_VER, list_name)
+
+ if start_recipient is not None:
+ uri += "?startRecipient=%s" % start_recipient
+ try:
+ return gdata.apps.EmailListRecipientFeedFromString(str(
+ self.GetWithRetries(
+ uri, num_retries=num_retries, delay=delay, backoff=backoff)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def GetGeneratorForAllRecipients(
+ self, list_name, num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY, backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve a generator for all recipients of a particular emaillist."""
+ first_page = self.RetrievePageOfRecipients(list_name,
+ num_retries=num_retries,
+ delay=delay,
+ backoff=backoff)
+ return self.GetGeneratorFromLinkFinder(
+ first_page, gdata.apps.EmailListRecipientFeedFromString,
+ num_retries=num_retries, delay=delay, backoff=backoff)
+
+ def RetrieveAllRecipients(self, list_name):
+ """Retrieve all recipient of an email list."""
+
+ ret = self.RetrievePageOfRecipients(list_name)
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.EmailListRecipientFeedFromString)
+
+ def AddRecipientToEmailList(self, recipient, list_name):
+ """Add a recipient to a email list."""
+
+ uri = "%s/emailList/%s/%s/recipient" % (
+ self._baseURL(), API_VER, list_name)
+ recipient_entry = gdata.apps.EmailListRecipientEntry()
+ recipient_entry.who = gdata.apps.Who(email=recipient)
+
+ try:
+ return gdata.apps.EmailListRecipientEntryFromString(
+ str(self.Post(recipient_entry, uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def DeleteEmailList(self, list_name):
+ """Delete a email list"""
+
+ uri = "%s/emailList/%s/%s" % (self._baseURL(), API_VER, list_name)
+ try:
+ self.Delete(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def CreateEmailList(self, list_name):
+ """Create a email list. """
+
+ uri = "%s/emailList/%s" % (self._baseURL(), API_VER)
+ email_list_entry = gdata.apps.EmailListEntry()
+ email_list_entry.email_list = gdata.apps.EmailList(name=list_name)
+ try:
+ return gdata.apps.EmailListEntryFromString(
+ str(self.Post(email_list_entry, uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def DeleteNickname(self, nickname):
+ """Delete a nickname"""
+
+ uri = "%s/nickname/%s/%s" % (self._baseURL(), API_VER, nickname)
+ try:
+ self.Delete(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def RetrievePageOfNicknames(self, start_nickname=None,
+ num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY,
+ backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve one page of nicknames in the domain"""
+
+ uri = "%s/nickname/%s" % (self._baseURL(), API_VER)
+ if start_nickname is not None:
+ uri += "?startNickname=%s" % start_nickname
+ try:
+ return gdata.apps.NicknameFeedFromString(str(self.GetWithRetries(
+ uri, num_retries=num_retries, delay=delay, backoff=backoff)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def GetGeneratorForAllNicknames(
+ self, num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY, backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve a generator for all nicknames in this domain."""
+ first_page = self.RetrievePageOfNicknames(num_retries=num_retries,
+ delay=delay,
+ backoff=backoff)
+ return self.GetGeneratorFromLinkFinder(
+ first_page, gdata.apps.NicknameFeedFromString, num_retries=num_retries,
+ delay=delay, backoff=backoff)
+
+ def RetrieveAllNicknames(self):
+ """Retrieve all nicknames in the domain"""
+
+ ret = self.RetrievePageOfNicknames()
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.NicknameFeedFromString)
+
+ def GetGeneratorForAllNicknamesOfAUser(
+ self, user_name, num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY, backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve a generator for all nicknames of a particular user."""
+ uri = "%s/nickname/%s?username=%s" % (self._baseURL(), API_VER, user_name)
+ try:
+ first_page = gdata.apps.NicknameFeedFromString(str(self.GetWithRetries(
+ uri, num_retries=num_retries, delay=delay, backoff=backoff)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+ return self.GetGeneratorFromLinkFinder(
+ first_page, gdata.apps.NicknameFeedFromString, num_retries=num_retries,
+ delay=delay, backoff=backoff)
+
+ def RetrieveNicknames(self, user_name):
+ """Retrieve nicknames of the user"""
+
+ uri = "%s/nickname/%s?username=%s" % (self._baseURL(), API_VER, user_name)
+ try:
+ ret = gdata.apps.NicknameFeedFromString(str(self.Get(uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.NicknameFeedFromString)
+
+ def RetrieveNickname(self, nickname):
+ """Retrieve a nickname.
+
+ Args:
+ nickname: string The nickname to retrieve
+
+ Returns:
+ gdata.apps.NicknameEntry
+ """
+
+ uri = "%s/nickname/%s/%s" % (self._baseURL(), API_VER, nickname)
+ try:
+ return gdata.apps.NicknameEntryFromString(str(self.Get(uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def CreateNickname(self, user_name, nickname):
+ """Create a nickname"""
+
+ uri = "%s/nickname/%s" % (self._baseURL(), API_VER)
+ nickname_entry = gdata.apps.NicknameEntry()
+ nickname_entry.login = gdata.apps.Login(user_name=user_name)
+ nickname_entry.nickname = gdata.apps.Nickname(name=nickname)
+
+ try:
+ return gdata.apps.NicknameEntryFromString(
+ str(self.Post(nickname_entry, uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def DeleteUser(self, user_name):
+ """Delete a user account"""
+
+ uri = "%s/user/%s/%s" % (self._baseURL(), API_VER, user_name)
+ try:
+ return self.Delete(uri)
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def UpdateUser(self, user_name, user_entry):
+ """Update a user account."""
+
+ uri = "%s/user/%s/%s" % (self._baseURL(), API_VER, user_name)
+ try:
+ return gdata.apps.UserEntryFromString(str(self.Put(user_entry, uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def CreateUser(self, user_name, family_name, given_name, password,
+ suspended='false', quota_limit=None,
+ password_hash_function=None,
+ change_password=None):
+ """Create a user account. """
+
+ uri = "%s/user/%s" % (self._baseURL(), API_VER)
+ user_entry = gdata.apps.UserEntry()
+ user_entry.login = gdata.apps.Login(
+ user_name=user_name, password=password, suspended=suspended,
+ hash_function_name=password_hash_function,
+ change_password=change_password)
+ user_entry.name = gdata.apps.Name(family_name=family_name,
+ given_name=given_name)
+ if quota_limit is not None:
+ user_entry.quota = gdata.apps.Quota(limit=str(quota_limit))
+
+ try:
+ return gdata.apps.UserEntryFromString(str(self.Post(user_entry, uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def SuspendUser(self, user_name):
+ user_entry = self.RetrieveUser(user_name)
+ if user_entry.login.suspended != 'true':
+ user_entry.login.suspended = 'true'
+ user_entry = self.UpdateUser(user_name, user_entry)
+ return user_entry
+
+ def RestoreUser(self, user_name):
+ user_entry = self.RetrieveUser(user_name)
+ if user_entry.login.suspended != 'false':
+ user_entry.login.suspended = 'false'
+ user_entry = self.UpdateUser(user_name, user_entry)
+ return user_entry
+
+ def RetrieveUser(self, user_name):
+ """Retrieve an user account.
+
+ Args:
+ user_name: string The user name to retrieve
+
+ Returns:
+ gdata.apps.UserEntry
+ """
+
+ uri = "%s/user/%s/%s" % (self._baseURL(), API_VER, user_name)
+ try:
+ return gdata.apps.UserEntryFromString(str(self.Get(uri)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def RetrievePageOfUsers(self, start_username=None,
+ num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY,
+ backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve one page of users in this domain."""
+
+ uri = "%s/user/%s" % (self._baseURL(), API_VER)
+ if start_username is not None:
+ uri += "?startUsername=%s" % start_username
+ try:
+ return gdata.apps.UserFeedFromString(str(self.GetWithRetries(
+ uri, num_retries=num_retries, delay=delay, backoff=backoff)))
+ except gdata.service.RequestError, e:
+ raise AppsForYourDomainException(e.args[0])
+
+ def GetGeneratorForAllUsers(self,
+ num_retries=gdata.service.DEFAULT_NUM_RETRIES,
+ delay=gdata.service.DEFAULT_DELAY,
+ backoff=gdata.service.DEFAULT_BACKOFF):
+ """Retrieve a generator for all users in this domain."""
+ first_page = self.RetrievePageOfUsers(num_retries=num_retries, delay=delay,
+ backoff=backoff)
+ return self.GetGeneratorFromLinkFinder(
+ first_page, gdata.apps.UserFeedFromString, num_retries=num_retries,
+ delay=delay, backoff=backoff)
+
+ def RetrieveAllUsers(self):
+ """Retrieve all users in this domain. OBSOLETE"""
+
+ ret = self.RetrievePageOfUsers()
+ # pagination
+ return self.AddAllElementsFromAllPages(
+ ret, gdata.apps.UserFeedFromString)
+
+
+class PropertyService(gdata.service.GDataService):
+ """Client for the Google Apps Property service."""
+
+ def __init__(self, email=None, password=None, domain=None, source=None,
+ server='apps-apis.google.com', additional_headers=None):
+ gdata.service.GDataService.__init__(self, email=email, password=password,
+ service='apps', source=source,
+ server=server,
+ additional_headers=additional_headers)
+ self.ssl = True
+ self.port = 443
+ self.domain = domain
+
+ def AddAllElementsFromAllPages(self, link_finder, func):
+ """retrieve all pages and add all elements"""
+ next = link_finder.GetNextLink()
+ while next is not None:
+ next_feed = self.Get(next.href, converter=func)
+ for a_entry in next_feed.entry:
+ link_finder.entry.append(a_entry)
+ next = next_feed.GetNextLink()
+ return link_finder
+
+ def _GetPropertyEntry(self, properties):
+ property_entry = gdata.apps.PropertyEntry()
+ property = []
+ for name, value in properties.iteritems():
+ if name is not None and value is not None:
+ property.append(gdata.apps.Property(name=name, value=value))
+ property_entry.property = property
+ return property_entry
+
+ def _PropertyEntry2Dict(self, property_entry):
+ properties = {}
+ for i, property in enumerate(property_entry.property):
+ properties[property.name] = property.value
+ return properties
+
+ def _GetPropertyFeed(self, uri):
+ try:
+ return gdata.apps.PropertyFeedFromString(str(self.Get(uri)))
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ def _GetPropertiesList(self, uri):
+ property_feed = self._GetPropertyFeed(uri)
+ # pagination
+ property_feed = self.AddAllElementsFromAllPages(
+ property_feed, gdata.apps.PropertyFeedFromString)
+ properties_list = []
+ for property_entry in property_feed.entry:
+ properties_list.append(self._PropertyEntry2Dict(property_entry))
+ return properties_list
+
+ def _GetProperties(self, uri):
+ try:
+ return self._PropertyEntry2Dict(gdata.apps.PropertyEntryFromString(
+ str(self.Get(uri))))
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ def _PostProperties(self, uri, properties):
+ property_entry = self._GetPropertyEntry(properties)
+ try:
+ return self._PropertyEntry2Dict(gdata.apps.PropertyEntryFromString(
+ str(self.Post(property_entry, uri))))
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ def _PutProperties(self, uri, properties):
+ property_entry = self._GetPropertyEntry(properties)
+ try:
+ return self._PropertyEntry2Dict(gdata.apps.PropertyEntryFromString(
+ str(self.Put(property_entry, uri))))
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+ def _DeleteProperties(self, uri):
+ try:
+ self.Delete(uri)
+ except gdata.service.RequestError, e:
+ raise gdata.apps.service.AppsForYourDomainException(e.args[0])
+
+
+def _bool2str(b):
+ if b is None:
+ return None
+ return str(b is True).lower()
diff --git a/src/gdata/apps_property.py b/src/gdata/apps_property.py
new file mode 100644
index 0000000..5afa1f3
--- /dev/null
+++ b/src/gdata/apps_property.py
@@ -0,0 +1,39 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2010 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+"""Provides a base class to represent property elements in feeds.
+
+This module is used for version 2 of the Google Data APIs. The primary class
+in this module is AppsProperty.
+"""
+
+
+__author__ = 'Vic Fryzel <vicfryzel@google.com>'
+
+
+import atom.core
+import gdata.apps
+
+
+class AppsProperty(atom.core.XmlElement):
+ """Represents an <apps:property> element in a feed."""
+ _qname = gdata.apps.APPS_TEMPLATE % 'property'
+ name = 'name'
+ value = 'value'
diff --git a/src/gdata/auth.py b/src/gdata/auth.py
new file mode 100644
index 0000000..1d7c2af
--- /dev/null
+++ b/src/gdata/auth.py
@@ -0,0 +1,958 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 - 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import cgi
+import math
+import random
+import re
+import time
+import types
+import urllib
+import atom.http_interface
+import atom.token_store
+import atom.url
+import gdata.oauth as oauth
+import gdata.oauth.rsa as oauth_rsa
+try:
+ import gdata.tlslite.utils.keyfactory as keyfactory
+except ImportError:
+ from tlslite.tlslite.utils import keyfactory
+try:
+ import gdata.tlslite.utils.cryptomath as cryptomath
+except ImportError:
+ from tlslite.tlslite.utils import cryptomath
+
+import gdata.gauth
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+PROGRAMMATIC_AUTH_LABEL = 'GoogleLogin auth='
+AUTHSUB_AUTH_LABEL = 'AuthSub token='
+
+
+"""This module provides functions and objects used with Google authentication.
+
+Details on Google authorization mechanisms used with the Google Data APIs can
+be found here:
+http://code.google.com/apis/gdata/auth.html
+http://code.google.com/apis/accounts/
+
+The essential functions are the following.
+Related to ClientLogin:
+ generate_client_login_request_body: Constructs the body of an HTTP request to
+ obtain a ClientLogin token for a specific
+ service.
+ extract_client_login_token: Creates a ClientLoginToken with the token from a
+ success response to a ClientLogin request.
+ get_captcha_challenge: If the server responded to the ClientLogin request
+ with a CAPTCHA challenge, this method extracts the
+ CAPTCHA URL and identifying CAPTCHA token.
+
+Related to AuthSub:
+ generate_auth_sub_url: Constructs a full URL for a AuthSub request. The
+ user's browser must be sent to this Google Accounts
+ URL and redirected back to the app to obtain the
+ AuthSub token.
+ extract_auth_sub_token_from_url: Once the user's browser has been
+ redirected back to the web app, use this
+ function to create an AuthSubToken with
+ the correct authorization token and scope.
+ token_from_http_body: Extracts the AuthSubToken value string from the
+ server's response to an AuthSub session token upgrade
+ request.
+"""
+
+def generate_client_login_request_body(email, password, service, source,
+ account_type='HOSTED_OR_GOOGLE', captcha_token=None,
+ captcha_response=None):
+ """Creates the body of the autentication request
+
+ See http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request
+ for more details.
+
+ Args:
+ email: str
+ password: str
+ service: str
+ source: str
+ account_type: str (optional) Defaul is 'HOSTED_OR_GOOGLE', other valid
+ values are 'GOOGLE' and 'HOSTED'
+ captcha_token: str (optional)
+ captcha_response: str (optional)
+
+ Returns:
+ The HTTP body to send in a request for a client login token.
+ """
+ return gdata.gauth.generate_client_login_request_body(email, password,
+ service, source, account_type, captcha_token, captcha_response)
+
+
+GenerateClientLoginRequestBody = generate_client_login_request_body
+
+
+def GenerateClientLoginAuthToken(http_body):
+ """Returns the token value to use in Authorization headers.
+
+ Reads the token from the server's response to a Client Login request and
+ creates header value to use in requests.
+
+ Args:
+ http_body: str The body of the server's HTTP response to a Client Login
+ request
+
+ Returns:
+ The value half of an Authorization header.
+ """
+ token = get_client_login_token(http_body)
+ if token:
+ return 'GoogleLogin auth=%s' % token
+ return None
+
+
+def get_client_login_token(http_body):
+ """Returns the token value for a ClientLoginToken.
+
+ Reads the token from the server's response to a Client Login request and
+ creates the token value string to use in requests.
+
+ Args:
+ http_body: str The body of the server's HTTP response to a Client Login
+ request
+
+ Returns:
+ The token value string for a ClientLoginToken.
+ """
+ return gdata.gauth.get_client_login_token_string(http_body)
+
+
+def extract_client_login_token(http_body, scopes):
+ """Parses the server's response and returns a ClientLoginToken.
+
+ Args:
+ http_body: str The body of the server's HTTP response to a Client Login
+ request. It is assumed that the login request was successful.
+ scopes: list containing atom.url.Urls or strs. The scopes list contains
+ all of the partial URLs under which the client login token is
+ valid. For example, if scopes contains ['http://example.com/foo']
+ then the client login token would be valid for
+ http://example.com/foo/bar/baz
+
+ Returns:
+ A ClientLoginToken which is valid for the specified scopes.
+ """
+ token_string = get_client_login_token(http_body)
+ token = ClientLoginToken(scopes=scopes)
+ token.set_token_string(token_string)
+ return token
+
+
+def get_captcha_challenge(http_body,
+ captcha_base_url='http://www.google.com/accounts/'):
+ """Returns the URL and token for a CAPTCHA challenge issued by the server.
+
+ Args:
+ http_body: str The body of the HTTP response from the server which
+ contains the CAPTCHA challenge.
+ captcha_base_url: str This function returns a full URL for viewing the
+ challenge image which is built from the server's response. This
+ base_url is used as the beginning of the URL because the server
+ only provides the end of the URL. For example the server provides
+ 'Captcha?ctoken=Hi...N' and the URL for the image is
+ 'http://www.google.com/accounts/Captcha?ctoken=Hi...N'
+
+ Returns:
+ A dictionary containing the information needed to repond to the CAPTCHA
+ challenge, the image URL and the ID token of the challenge. The
+ dictionary is in the form:
+ {'token': string identifying the CAPTCHA image,
+ 'url': string containing the URL of the image}
+ Returns None if there was no CAPTCHA challenge in the response.
+ """
+ return gdata.gauth.get_captcha_challenge(http_body, captcha_base_url)
+
+
+GetCaptchaChallenge = get_captcha_challenge
+
+
+def GenerateOAuthRequestTokenUrl(
+ oauth_input_params, scopes,
+ request_token_url='https://www.google.com/accounts/OAuthGetRequestToken',
+ extra_parameters=None):
+ """Generate a URL at which a request for OAuth request token is to be sent.
+
+ Args:
+ oauth_input_params: OAuthInputParams OAuth input parameters.
+ scopes: list of strings The URLs of the services to be accessed.
+ request_token_url: string The beginning of the request token URL. This is
+ normally 'https://www.google.com/accounts/OAuthGetRequestToken' or
+ '/accounts/OAuthGetRequestToken'
+ extra_parameters: dict (optional) key-value pairs as any additional
+ parameters to be included in the URL and signature while making a
+ request for fetching an OAuth request token. All the OAuth parameters
+ are added by default. But if provided through this argument, any
+ default parameters will be overwritten. For e.g. a default parameter
+ oauth_version 1.0 can be overwritten if
+ extra_parameters = {'oauth_version': '2.0'}
+
+ Returns:
+ atom.url.Url OAuth request token URL.
+ """
+ scopes_string = ' '.join([str(scope) for scope in scopes])
+ parameters = {'scope': scopes_string}
+ if extra_parameters:
+ parameters.update(extra_parameters)
+ oauth_request = oauth.OAuthRequest.from_consumer_and_token(
+ oauth_input_params.GetConsumer(), http_url=request_token_url,
+ parameters=parameters)
+ oauth_request.sign_request(oauth_input_params.GetSignatureMethod(),
+ oauth_input_params.GetConsumer(), None)
+ return atom.url.parse_url(oauth_request.to_url())
+
+
+def GenerateOAuthAuthorizationUrl(
+ request_token,
+ authorization_url='https://www.google.com/accounts/OAuthAuthorizeToken',
+ callback_url=None, extra_params=None,
+ include_scopes_in_callback=False, scopes_param_prefix='oauth_token_scope'):
+ """Generates URL at which user will login to authorize the request token.
+
+ Args:
+ request_token: gdata.auth.OAuthToken OAuth request token.
+ authorization_url: string The beginning of the authorization URL. This is
+ normally 'https://www.google.com/accounts/OAuthAuthorizeToken' or
+ '/accounts/OAuthAuthorizeToken'
+ callback_url: string (optional) The URL user will be sent to after
+ logging in and granting access.
+ extra_params: dict (optional) Additional parameters to be sent.
+ include_scopes_in_callback: Boolean (default=False) if set to True, and
+ if 'callback_url' is present, the 'callback_url' will be modified to
+ include the scope(s) from the request token as a URL parameter. The
+ key for the 'callback' URL's scope parameter will be
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as
+ a parameter to the 'callback' URL, is that the page which receives
+ the OAuth token will be able to tell which URLs the token grants
+ access to.
+ scopes_param_prefix: string (default='oauth_token_scope') The URL
+ parameter key which maps to the list of valid scopes for the token.
+ This URL parameter will be included in the callback URL along with
+ the scopes of the token as value if include_scopes_in_callback=True.
+
+ Returns:
+ atom.url.Url OAuth authorization URL.
+ """
+ scopes = request_token.scopes
+ if isinstance(scopes, list):
+ scopes = ' '.join(scopes)
+ if include_scopes_in_callback and callback_url:
+ if callback_url.find('?') > -1:
+ callback_url += '&'
+ else:
+ callback_url += '?'
+ callback_url += urllib.urlencode({scopes_param_prefix:scopes})
+ oauth_token = oauth.OAuthToken(request_token.key, request_token.secret)
+ oauth_request = oauth.OAuthRequest.from_token_and_callback(
+ token=oauth_token, callback=callback_url,
+ http_url=authorization_url, parameters=extra_params)
+ return atom.url.parse_url(oauth_request.to_url())
+
+
+def GenerateOAuthAccessTokenUrl(
+ authorized_request_token,
+ oauth_input_params,
+ access_token_url='https://www.google.com/accounts/OAuthGetAccessToken',
+ oauth_version='1.0',
+ oauth_verifier=None):
+ """Generates URL at which user will login to authorize the request token.
+
+ Args:
+ authorized_request_token: gdata.auth.OAuthToken OAuth authorized request
+ token.
+ oauth_input_params: OAuthInputParams OAuth input parameters.
+ access_token_url: string The beginning of the authorization URL. This is
+ normally 'https://www.google.com/accounts/OAuthGetAccessToken' or
+ '/accounts/OAuthGetAccessToken'
+ oauth_version: str (default='1.0') oauth_version parameter.
+ oauth_verifier: str (optional) If present, it is assumed that the client
+ will use the OAuth v1.0a protocol which includes passing the
+ oauth_verifier (as returned by the SP) in the access token step.
+
+ Returns:
+ atom.url.Url OAuth access token URL.
+ """
+ oauth_token = oauth.OAuthToken(authorized_request_token.key,
+ authorized_request_token.secret)
+ parameters = {'oauth_version': oauth_version}
+ if oauth_verifier is not None:
+ parameters['oauth_verifier'] = oauth_verifier
+ oauth_request = oauth.OAuthRequest.from_consumer_and_token(
+ oauth_input_params.GetConsumer(), token=oauth_token,
+ http_url=access_token_url, parameters=parameters)
+ oauth_request.sign_request(oauth_input_params.GetSignatureMethod(),
+ oauth_input_params.GetConsumer(), oauth_token)
+ return atom.url.parse_url(oauth_request.to_url())
+
+
+def GenerateAuthSubUrl(next, scope, secure=False, session=True,
+ request_url='https://www.google.com/accounts/AuthSubRequest',
+ domain='default'):
+ """Generate a URL at which the user will login and be redirected back.
+
+ Users enter their credentials on a Google login page and a token is sent
+ to the URL specified in next. See documentation for AuthSub login at:
+ http://code.google.com/apis/accounts/AuthForWebApps.html
+
+ Args:
+ request_url: str The beginning of the request URL. This is normally
+ 'http://www.google.com/accounts/AuthSubRequest' or
+ '/accounts/AuthSubRequest'
+ next: string The URL user will be sent to after logging in.
+ scope: string The URL of the service to be accessed.
+ secure: boolean (optional) Determines whether or not the issued token
+ is a secure token.
+ session: boolean (optional) Determines whether or not the issued token
+ can be upgraded to a session token.
+ domain: str (optional) The Google Apps domain for this account. If this
+ is not a Google Apps account, use 'default' which is the default
+ value.
+ """
+ # Translate True/False values for parameters into numeric values acceoted
+ # by the AuthSub service.
+ if secure:
+ secure = 1
+ else:
+ secure = 0
+
+ if session:
+ session = 1
+ else:
+ session = 0
+
+ request_params = urllib.urlencode({'next': next, 'scope': scope,
+ 'secure': secure, 'session': session,
+ 'hd': domain})
+ if request_url.find('?') == -1:
+ return '%s?%s' % (request_url, request_params)
+ else:
+ # The request URL already contained url parameters so we should add
+ # the parameters using the & seperator
+ return '%s&%s' % (request_url, request_params)
+
+
+def generate_auth_sub_url(next, scopes, secure=False, session=True,
+ request_url='https://www.google.com/accounts/AuthSubRequest',
+ domain='default', scopes_param_prefix='auth_sub_scopes'):
+ """Constructs a URL string for requesting a multiscope AuthSub token.
+
+ The generated token will contain a URL parameter to pass along the
+ requested scopes to the next URL. When the Google Accounts page
+ redirects the broswser to the 'next' URL, it appends the single use
+ AuthSub token value to the URL as a URL parameter with the key 'token'.
+ However, the information about which scopes were requested is not
+ included by Google Accounts. This method adds the scopes to the next
+ URL before making the request so that the redirect will be sent to
+ a page, and both the token value and the list of scopes can be
+ extracted from the request URL.
+
+ Args:
+ next: atom.url.URL or string The URL user will be sent to after
+ authorizing this web application to access their data.
+ scopes: list containint strings The URLs of the services to be accessed.
+ secure: boolean (optional) Determines whether or not the issued token
+ is a secure token.
+ session: boolean (optional) Determines whether or not the issued token
+ can be upgraded to a session token.
+ request_url: atom.url.Url or str The beginning of the request URL. This
+ is normally 'http://www.google.com/accounts/AuthSubRequest' or
+ '/accounts/AuthSubRequest'
+ domain: The domain which the account is part of. This is used for Google
+ Apps accounts, the default value is 'default' which means that the
+ requested account is a Google Account (@gmail.com for example)
+ scopes_param_prefix: str (optional) The requested scopes are added as a
+ URL parameter to the next URL so that the page at the 'next' URL can
+ extract the token value and the valid scopes from the URL. The key
+ for the URL parameter defaults to 'auth_sub_scopes'
+
+ Returns:
+ An atom.url.Url which the user's browser should be directed to in order
+ to authorize this application to access their information.
+ """
+ if isinstance(next, (str, unicode)):
+ next = atom.url.parse_url(next)
+ scopes_string = ' '.join([str(scope) for scope in scopes])
+ next.params[scopes_param_prefix] = scopes_string
+
+ if isinstance(request_url, (str, unicode)):
+ request_url = atom.url.parse_url(request_url)
+ request_url.params['next'] = str(next)
+ request_url.params['scope'] = scopes_string
+ if session:
+ request_url.params['session'] = 1
+ else:
+ request_url.params['session'] = 0
+ if secure:
+ request_url.params['secure'] = 1
+ else:
+ request_url.params['secure'] = 0
+ request_url.params['hd'] = domain
+ return request_url
+
+
+def AuthSubTokenFromUrl(url):
+ """Extracts the AuthSub token from the URL.
+
+ Used after the AuthSub redirect has sent the user to the 'next' page and
+ appended the token to the URL. This function returns the value to be used
+ in the Authorization header.
+
+ Args:
+ url: str The URL of the current page which contains the AuthSub token as
+ a URL parameter.
+ """
+ token = TokenFromUrl(url)
+ if token:
+ return 'AuthSub token=%s' % token
+ return None
+
+
+def TokenFromUrl(url):
+ """Extracts the AuthSub token from the URL.
+
+ Returns the raw token value.
+
+ Args:
+ url: str The URL or the query portion of the URL string (after the ?) of
+ the current page which contains the AuthSub token as a URL parameter.
+ """
+ if url.find('?') > -1:
+ query_params = url.split('?')[1]
+ else:
+ query_params = url
+ for pair in query_params.split('&'):
+ if pair.startswith('token='):
+ return pair[6:]
+ return None
+
+
+def extract_auth_sub_token_from_url(url,
+ scopes_param_prefix='auth_sub_scopes', rsa_key=None):
+ """Creates an AuthSubToken and sets the token value and scopes from the URL.
+
+ After the Google Accounts AuthSub pages redirect the user's broswer back to
+ the web application (using the 'next' URL from the request) the web app must
+ extract the token from the current page's URL. The token is provided as a
+ URL parameter named 'token' and if generate_auth_sub_url was used to create
+ the request, the token's valid scopes are included in a URL parameter whose
+ name is specified in scopes_param_prefix.
+
+ Args:
+ url: atom.url.Url or str representing the current URL. The token value
+ and valid scopes should be included as URL parameters.
+ scopes_param_prefix: str (optional) The URL parameter key which maps to
+ the list of valid scopes for the token.
+
+ Returns:
+ An AuthSubToken with the token value from the URL and set to be valid for
+ the scopes passed in on the URL. If no scopes were included in the URL,
+ the AuthSubToken defaults to being valid for no scopes. If there was no
+ 'token' parameter in the URL, this function returns None.
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ if 'token' not in url.params:
+ return None
+ scopes = []
+ if scopes_param_prefix in url.params:
+ scopes = url.params[scopes_param_prefix].split(' ')
+ token_value = url.params['token']
+ if rsa_key:
+ token = SecureAuthSubToken(rsa_key, scopes=scopes)
+ else:
+ token = AuthSubToken(scopes=scopes)
+ token.set_token_string(token_value)
+ return token
+
+
+def AuthSubTokenFromHttpBody(http_body):
+ """Extracts the AuthSub token from an HTTP body string.
+
+ Used to find the new session token after making a request to upgrade a
+ single use AuthSub token.
+
+ Args:
+ http_body: str The repsonse from the server which contains the AuthSub
+ key. For example, this function would find the new session token
+ from the server's response to an upgrade token request.
+
+ Returns:
+ The header value to use for Authorization which contains the AuthSub
+ token.
+ """
+ token_value = token_from_http_body(http_body)
+ if token_value:
+ return '%s%s' % (AUTHSUB_AUTH_LABEL, token_value)
+ return None
+
+
+def token_from_http_body(http_body):
+ """Extracts the AuthSub token from an HTTP body string.
+
+ Used to find the new session token after making a request to upgrade a
+ single use AuthSub token.
+
+ Args:
+ http_body: str The repsonse from the server which contains the AuthSub
+ key. For example, this function would find the new session token
+ from the server's response to an upgrade token request.
+
+ Returns:
+ The raw token value to use in an AuthSubToken object.
+ """
+ for response_line in http_body.splitlines():
+ if response_line.startswith('Token='):
+ # Strip off Token= and return the token value string.
+ return response_line[6:]
+ return None
+
+
+TokenFromHttpBody = token_from_http_body
+
+
+def OAuthTokenFromUrl(url, scopes_param_prefix='oauth_token_scope'):
+ """Creates an OAuthToken and sets token key and scopes (if present) from URL.
+
+ After the Google Accounts OAuth pages redirect the user's broswer back to
+ the web application (using the 'callback' URL from the request) the web app
+ can extract the token from the current page's URL. The token is same as the
+ request token, but it is either authorized (if user grants access) or
+ unauthorized (if user denies access). The token is provided as a
+ URL parameter named 'oauth_token' and if it was chosen to use
+ GenerateOAuthAuthorizationUrl with include_scopes_in_param=True, the token's
+ valid scopes are included in a URL parameter whose name is specified in
+ scopes_param_prefix.
+
+ Args:
+ url: atom.url.Url or str representing the current URL. The token value
+ and valid scopes should be included as URL parameters.
+ scopes_param_prefix: str (optional) The URL parameter key which maps to
+ the list of valid scopes for the token.
+
+ Returns:
+ An OAuthToken with the token key from the URL and set to be valid for
+ the scopes passed in on the URL. If no scopes were included in the URL,
+ the OAuthToken defaults to being valid for no scopes. If there was no
+ 'oauth_token' parameter in the URL, this function returns None.
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ if 'oauth_token' not in url.params:
+ return None
+ scopes = []
+ if scopes_param_prefix in url.params:
+ scopes = url.params[scopes_param_prefix].split(' ')
+ token_key = url.params['oauth_token']
+ token = OAuthToken(key=token_key, scopes=scopes)
+ return token
+
+
+def OAuthTokenFromHttpBody(http_body):
+ """Parses the HTTP response body and returns an OAuth token.
+
+ The returned OAuth token will just have key and secret parameters set.
+ It won't have any knowledge about the scopes or oauth_input_params. It is
+ your responsibility to make it aware of the remaining parameters.
+
+ Returns:
+ OAuthToken OAuth token.
+ """
+ token = oauth.OAuthToken.from_string(http_body)
+ oauth_token = OAuthToken(key=token.key, secret=token.secret)
+ return oauth_token
+
+
+class OAuthSignatureMethod(object):
+ """Holds valid OAuth signature methods.
+
+ RSA_SHA1: Class to build signature according to RSA-SHA1 algorithm.
+ HMAC_SHA1: Class to build signature according to HMAC-SHA1 algorithm.
+ """
+
+ HMAC_SHA1 = oauth.OAuthSignatureMethod_HMAC_SHA1
+
+ class RSA_SHA1(oauth_rsa.OAuthSignatureMethod_RSA_SHA1):
+ """Provides implementation for abstract methods to return RSA certs."""
+
+ def __init__(self, private_key, public_cert):
+ self.private_key = private_key
+ self.public_cert = public_cert
+
+ def _fetch_public_cert(self, unused_oauth_request):
+ return self.public_cert
+
+ def _fetch_private_cert(self, unused_oauth_request):
+ return self.private_key
+
+
+class OAuthInputParams(object):
+ """Stores OAuth input parameters.
+
+ This class is a store for OAuth input parameters viz. consumer key and secret,
+ signature method and RSA key.
+ """
+
+ def __init__(self, signature_method, consumer_key, consumer_secret=None,
+ rsa_key=None, requestor_id=None):
+ """Initializes object with parameters required for using OAuth mechanism.
+
+ NOTE: Though consumer_secret and rsa_key are optional, either of the two
+ is required depending on the value of the signature_method.
+
+ Args:
+ signature_method: class which provides implementation for strategy class
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for
+ signing each request. Valid implementations are provided as the
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1. Instead of passing in
+ the strategy class, you may pass in a string for 'RSA_SHA1' or
+ 'HMAC_SHA1'. If you plan to use OAuth on App Engine (or another
+ WSGI environment) I recommend specifying signature method using a
+ string (the only options are 'RSA_SHA1' and 'HMAC_SHA1'). In these
+ environments there are sometimes issues with pickling an object in
+ which a member references a class or function. Storing a string to
+ refer to the signature method mitigates complications when
+ pickling.
+ consumer_key: string Domain identifying third_party web application.
+ consumer_secret: string (optional) Secret generated during registration.
+ Required only for HMAC_SHA1 signature method.
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature
+ method.
+ requestor_id: string (optional) User email adress to make requests on
+ their behalf. This parameter should only be set when performing
+ 2 legged OAuth requests.
+ """
+ if (signature_method == OAuthSignatureMethod.RSA_SHA1
+ or signature_method == 'RSA_SHA1'):
+ self.__signature_strategy = 'RSA_SHA1'
+ elif (signature_method == OAuthSignatureMethod.HMAC_SHA1
+ or signature_method == 'HMAC_SHA1'):
+ self.__signature_strategy = 'HMAC_SHA1'
+ else:
+ self.__signature_strategy = signature_method
+ self.rsa_key = rsa_key
+ self._consumer = oauth.OAuthConsumer(consumer_key, consumer_secret)
+ self.requestor_id = requestor_id
+
+ def __get_signature_method(self):
+ if self.__signature_strategy == 'RSA_SHA1':
+ return OAuthSignatureMethod.RSA_SHA1(self.rsa_key, None)
+ elif self.__signature_strategy == 'HMAC_SHA1':
+ return OAuthSignatureMethod.HMAC_SHA1()
+ else:
+ return self.__signature_strategy()
+
+ def __set_signature_method(self, signature_method):
+ if (signature_method == OAuthSignatureMethod.RSA_SHA1
+ or signature_method == 'RSA_SHA1'):
+ self.__signature_strategy = 'RSA_SHA1'
+ elif (signature_method == OAuthSignatureMethod.HMAC_SHA1
+ or signature_method == 'HMAC_SHA1'):
+ self.__signature_strategy = 'HMAC_SHA1'
+ else:
+ self.__signature_strategy = signature_method
+
+ _signature_method = property(__get_signature_method, __set_signature_method,
+ doc="""Returns object capable of signing the request using RSA of HMAC.
+
+ Replaces the _signature_method member to avoid pickle errors.""")
+
+ def GetSignatureMethod(self):
+ """Gets the OAuth signature method.
+
+ Returns:
+ object of supertype <oauth.oauth.OAuthSignatureMethod>
+ """
+ return self._signature_method
+
+ def GetConsumer(self):
+ """Gets the OAuth consumer.
+
+ Returns:
+ object of type <oauth.oauth.Consumer>
+ """
+ return self._consumer
+
+
+class ClientLoginToken(atom.http_interface.GenericToken):
+ """Stores the Authorization header in auth_header and adds to requests.
+
+ This token will add it's Authorization header to an HTTP request
+ as it is made. Ths token class is simple but
+ some Token classes must calculate portions of the Authorization header
+ based on the request being made, which is why the token is responsible
+ for making requests via an http_client parameter.
+
+ Args:
+ auth_header: str The value for the Authorization header.
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs
+ for which this token can be used. For example, if scopes contains
+ 'http://example.com/foo', then this token can be used for a request to
+ 'http://example.com/foo/bar' but it cannot be used for a request to
+ 'http://example.com/baz'
+ """
+ def __init__(self, auth_header=None, scopes=None):
+ self.auth_header = auth_header
+ self.scopes = scopes or []
+
+ def __str__(self):
+ return self.auth_header
+
+ def perform_request(self, http_client, operation, url, data=None,
+ headers=None):
+ """Sets the Authorization header and makes the HTTP request."""
+ if headers is None:
+ headers = {'Authorization':self.auth_header}
+ else:
+ headers['Authorization'] = self.auth_header
+ return http_client.request(operation, url, data=data, headers=headers)
+
+ def get_token_string(self):
+ """Removes PROGRAMMATIC_AUTH_LABEL to give just the token value."""
+ return self.auth_header[len(PROGRAMMATIC_AUTH_LABEL):]
+
+ def set_token_string(self, token_string):
+ self.auth_header = '%s%s' % (PROGRAMMATIC_AUTH_LABEL, token_string)
+
+ def valid_for_scope(self, url):
+ """Tells the caller if the token authorizes access to the desired URL.
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ for scope in self.scopes:
+ if scope == atom.token_store.SCOPE_ALL:
+ return True
+ if isinstance(scope, (str, unicode)):
+ scope = atom.url.parse_url(scope)
+ if scope == url:
+ return True
+ # Check the host and the path, but ignore the port and protocol.
+ elif scope.host == url.host and not scope.path:
+ return True
+ elif scope.host == url.host and scope.path and not url.path:
+ continue
+ elif scope.host == url.host and url.path.startswith(scope.path):
+ return True
+ return False
+
+
+class AuthSubToken(ClientLoginToken):
+ def get_token_string(self):
+ """Removes AUTHSUB_AUTH_LABEL to give just the token value."""
+ return self.auth_header[len(AUTHSUB_AUTH_LABEL):]
+
+ def set_token_string(self, token_string):
+ self.auth_header = '%s%s' % (AUTHSUB_AUTH_LABEL, token_string)
+
+
+class OAuthToken(atom.http_interface.GenericToken):
+ """Stores the token key, token secret and scopes for which token is valid.
+
+ This token adds the authorization header to each request made. It
+ re-calculates authorization header for every request since the OAuth
+ signature to be added to the authorization header is dependent on the
+ request parameters.
+
+ Attributes:
+ key: str The value for the OAuth token i.e. token key.
+ secret: str The value for the OAuth token secret.
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs
+ for which this token can be used. For example, if scopes contains
+ 'http://example.com/foo', then this token can be used for a request to
+ 'http://example.com/foo/bar' but it cannot be used for a request to
+ 'http://example.com/baz'
+ oauth_input_params: OAuthInputParams OAuth input parameters.
+ """
+
+ def __init__(self, key=None, secret=None, scopes=None,
+ oauth_input_params=None):
+ self.key = key
+ self.secret = secret
+ self.scopes = scopes or []
+ self.oauth_input_params = oauth_input_params
+
+ def __str__(self):
+ return self.get_token_string()
+
+ def get_token_string(self):
+ """Returns the token string.
+
+ The token string returned is of format
+ oauth_token=[0]&oauth_token_secret=[1], where [0] and [1] are some strings.
+
+ Returns:
+ A token string of format oauth_token=[0]&oauth_token_secret=[1],
+ where [0] and [1] are some strings. If self.secret is absent, it just
+ returns oauth_token=[0]. If self.key is absent, it just returns
+ oauth_token_secret=[1]. If both are absent, it returns None.
+ """
+ if self.key and self.secret:
+ return urllib.urlencode({'oauth_token': self.key,
+ 'oauth_token_secret': self.secret})
+ elif self.key:
+ return 'oauth_token=%s' % self.key
+ elif self.secret:
+ return 'oauth_token_secret=%s' % self.secret
+ else:
+ return None
+
+ def set_token_string(self, token_string):
+ """Sets the token key and secret from the token string.
+
+ Args:
+ token_string: str Token string of form
+ oauth_token=[0]&oauth_token_secret=[1]. If oauth_token is not present,
+ self.key will be None. If oauth_token_secret is not present,
+ self.secret will be None.
+ """
+ token_params = cgi.parse_qs(token_string, keep_blank_values=False)
+ if 'oauth_token' in token_params:
+ self.key = token_params['oauth_token'][0]
+ if 'oauth_token_secret' in token_params:
+ self.secret = token_params['oauth_token_secret'][0]
+
+ def GetAuthHeader(self, http_method, http_url, realm=''):
+ """Get the authentication header.
+
+ Args:
+ http_method: string HTTP method i.e. operation e.g. GET, POST, PUT, etc.
+ http_url: string or atom.url.Url HTTP URL to which request is made.
+ realm: string (default='') realm parameter to be included in the
+ authorization header.
+
+ Returns:
+ dict Header to be sent with every subsequent request after
+ authentication.
+ """
+ if isinstance(http_url, types.StringTypes):
+ http_url = atom.url.parse_url(http_url)
+ header = None
+ token = None
+ if self.key or self.secret:
+ token = oauth.OAuthToken(self.key, self.secret)
+ oauth_request = oauth.OAuthRequest.from_consumer_and_token(
+ self.oauth_input_params.GetConsumer(), token=token,
+ http_url=str(http_url), http_method=http_method,
+ parameters=http_url.params)
+ oauth_request.sign_request(self.oauth_input_params.GetSignatureMethod(),
+ self.oauth_input_params.GetConsumer(), token)
+ header = oauth_request.to_header(realm=realm)
+ header['Authorization'] = header['Authorization'].replace('+', '%2B')
+ return header
+
+ def perform_request(self, http_client, operation, url, data=None,
+ headers=None):
+ """Sets the Authorization header and makes the HTTP request."""
+ if not headers:
+ headers = {}
+ if self.oauth_input_params.requestor_id:
+ url.params['xoauth_requestor_id'] = self.oauth_input_params.requestor_id
+ headers.update(self.GetAuthHeader(operation, url))
+ return http_client.request(operation, url, data=data, headers=headers)
+
+ def valid_for_scope(self, url):
+ if isinstance(url, (str, unicode)):
+ url = atom.url.parse_url(url)
+ for scope in self.scopes:
+ if scope == atom.token_store.SCOPE_ALL:
+ return True
+ if isinstance(scope, (str, unicode)):
+ scope = atom.url.parse_url(scope)
+ if scope == url:
+ return True
+ # Check the host and the path, but ignore the port and protocol.
+ elif scope.host == url.host and not scope.path:
+ return True
+ elif scope.host == url.host and scope.path and not url.path:
+ continue
+ elif scope.host == url.host and url.path.startswith(scope.path):
+ return True
+ return False
+
+
+class SecureAuthSubToken(AuthSubToken):
+ """Stores the rsa private key, token, and scopes for the secure AuthSub token.
+
+ This token adds the authorization header to each request made. It
+ re-calculates authorization header for every request since the secure AuthSub
+ signature to be added to the authorization header is dependent on the
+ request parameters.
+
+ Attributes:
+ rsa_key: string The RSA private key in PEM format that the token will
+ use to sign requests
+ token_string: string (optional) The value for the AuthSub token.
+ scopes: list of str or atom.url.Url specifying the beginnings of URLs
+ for which this token can be used. For example, if scopes contains
+ 'http://example.com/foo', then this token can be used for a request to
+ 'http://example.com/foo/bar' but it cannot be used for a request to
+ 'http://example.com/baz'
+ """
+
+ def __init__(self, rsa_key, token_string=None, scopes=None):
+ self.rsa_key = keyfactory.parsePEMKey(rsa_key)
+ self.token_string = token_string or ''
+ self.scopes = scopes or []
+
+ def __str__(self):
+ return self.get_token_string()
+
+ def get_token_string(self):
+ return str(self.token_string)
+
+ def set_token_string(self, token_string):
+ self.token_string = token_string
+
+ def GetAuthHeader(self, http_method, http_url):
+ """Generates the Authorization header.
+
+ The form of the secure AuthSub Authorization header is
+ Authorization: AuthSub token="token" sigalg="sigalg" data="data" sig="sig"
+ and data represents a string in the form
+ data = http_method http_url timestamp nonce
+
+ Args:
+ http_method: string HTTP method i.e. operation e.g. GET, POST, PUT, etc.
+ http_url: string or atom.url.Url HTTP URL to which request is made.
+
+ Returns:
+ dict Header to be sent with every subsequent request after authentication.
+ """
+ timestamp = int(math.floor(time.time()))
+ nonce = '%lu' % random.randrange(1, 2**64)
+ data = '%s %s %d %s' % (http_method, str(http_url), timestamp, nonce)
+ sig = cryptomath.bytesToBase64(self.rsa_key.hashAndSign(data))
+ header = {'Authorization': '%s"%s" data="%s" sig="%s" sigalg="rsa-sha1"' %
+ (AUTHSUB_AUTH_LABEL, self.token_string, data, sig)}
+ return header
+
+ def perform_request(self, http_client, operation, url, data=None,
+ headers=None):
+ """Sets the Authorization header and makes the HTTP request."""
+ if not headers:
+ headers = {}
+ headers.update(self.GetAuthHeader(operation, url))
+ return http_client.request(operation, url, data=data, headers=headers)
diff --git a/src/gdata/blogger/__init__.py b/src/gdata/blogger/__init__.py
new file mode 100644
index 0000000..156f25c
--- /dev/null
+++ b/src/gdata/blogger/__init__.py
@@ -0,0 +1,202 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007, 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains extensions to Atom objects used with Blogger."""
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+
+import atom
+import gdata
+import re
+
+
+LABEL_SCHEME = 'http://www.blogger.com/atom/ns#'
+THR_NAMESPACE = 'http://purl.org/syndication/thread/1.0'
+
+
+class BloggerEntry(gdata.GDataEntry):
+ """Adds convenience methods inherited by all Blogger entries."""
+
+ blog_name_pattern = re.compile('(http://)(\w*)')
+ blog_id_pattern = re.compile('(tag:blogger.com,1999:blog-)(\w*)')
+ blog_id2_pattern = re.compile('tag:blogger.com,1999:user-(\d+)\.blog-(\d+)')
+
+ def GetBlogId(self):
+ """Extracts the Blogger id of this blog.
+ This method is useful when contructing URLs by hand. The blog id is
+ often used in blogger operation URLs. This should not be confused with
+ the id member of a BloggerBlog. The id element is the Atom id XML element.
+ The blog id which this method returns is a part of the Atom id.
+
+ Returns:
+ The blog's unique id as a string.
+ """
+ if self.id.text:
+ match = self.blog_id_pattern.match(self.id.text)
+ if match:
+ return match.group(2)
+ else:
+ return self.blog_id2_pattern.match(self.id.text).group(2)
+ return None
+
+ def GetBlogName(self):
+ """Finds the name of this blog as used in the 'alternate' URL.
+ An alternate URL is in the form 'http://blogName.blogspot.com/'. For an
+ entry representing the above example, this method would return 'blogName'.
+
+ Returns:
+ The blog's URL name component as a string.
+ """
+ for link in self.link:
+ if link.rel == 'alternate':
+ return self.blog_name_pattern.match(link.href).group(2)
+ return None
+
+
+class BlogEntry(BloggerEntry):
+ """Describes a blog entry in the feed listing a user's blogs."""
+
+
+def BlogEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(BlogEntry, xml_string)
+
+
+class BlogFeed(gdata.GDataFeed):
+ """Describes a feed of a user's blogs."""
+
+ _children = gdata.GDataFeed._children.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [BlogEntry])
+
+
+def BlogFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(BlogFeed, xml_string)
+
+
+class BlogPostEntry(BloggerEntry):
+ """Describes a blog post entry in the feed of a blog's posts."""
+
+ post_id_pattern = re.compile('(tag:blogger.com,1999:blog-)(\w*)(.post-)(\w*)')
+
+ def AddLabel(self, label):
+ """Adds a label to the blog post.
+
+ The label is represented by an Atom category element, so this method
+ is shorthand for appending a new atom.Category object.
+
+ Args:
+ label: str
+ """
+ self.category.append(atom.Category(scheme=LABEL_SCHEME, term=label))
+
+ def GetPostId(self):
+ """Extracts the postID string from the entry's Atom id.
+
+ Returns: A string of digits which identify this post within the blog.
+ """
+ if self.id.text:
+ return self.post_id_pattern.match(self.id.text).group(4)
+ return None
+
+
+def BlogPostEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(BlogPostEntry, xml_string)
+
+
+class BlogPostFeed(gdata.GDataFeed):
+ """Describes a feed of a blog's posts."""
+
+ _children = gdata.GDataFeed._children.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [BlogPostEntry])
+
+
+def BlogPostFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(BlogPostFeed, xml_string)
+
+
+class InReplyTo(atom.AtomBase):
+ _tag = 'in-reply-to'
+ _namespace = THR_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['href'] = 'href'
+ _attributes['ref'] = 'ref'
+ _attributes['source'] = 'source'
+ _attributes['type'] = 'type'
+
+ def __init__(self, href=None, ref=None, source=None, type=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.href = href
+ self.ref = ref
+ self.source = source
+ self.type = type
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ self.text = text
+
+
+def InReplyToFromString(xml_string):
+ return atom.CreateClassFromXMLString(InReplyTo, xml_string)
+
+
+class CommentEntry(BloggerEntry):
+ """Describes a blog post comment entry in the feed of a blog post's
+ comments."""
+
+ _children = BloggerEntry._children.copy()
+ _children['{%s}in-reply-to' % THR_NAMESPACE] = ('in_reply_to', InReplyTo)
+
+ comment_id_pattern = re.compile('.*-(\w*)$')
+
+ def __init__(self, author=None, category=None, content=None,
+ contributor=None, atom_id=None, link=None, published=None, rights=None,
+ source=None, summary=None, control=None, title=None, updated=None,
+ in_reply_to=None, extension_elements=None, extension_attributes=None,
+ text=None):
+ BloggerEntry.__init__(self, author=author, category=category,
+ content=content, contributor=contributor, atom_id=atom_id, link=link,
+ published=published, rights=rights, source=source, summary=summary,
+ control=control, title=title, updated=updated,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+ self.in_reply_to = in_reply_to
+
+ def GetCommentId(self):
+ """Extracts the commentID string from the entry's Atom id.
+
+ Returns: A string of digits which identify this post within the blog.
+ """
+ if self.id.text:
+ return self.comment_id_pattern.match(self.id.text).group(1)
+ return None
+
+
+def CommentEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(CommentEntry, xml_string)
+
+
+class CommentFeed(gdata.GDataFeed):
+ """Describes a feed of a blog post's comments."""
+
+ _children = gdata.GDataFeed._children.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [CommentEntry])
+
+
+def CommentFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(CommentFeed, xml_string)
+
+
diff --git a/src/gdata/blogger/client.py b/src/gdata/blogger/client.py
new file mode 100644
index 0000000..a0bad63
--- /dev/null
+++ b/src/gdata/blogger/client.py
@@ -0,0 +1,175 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains a client to communicate with the Blogger servers.
+
+For documentation on the Blogger API, see:
+http://code.google.com/apis/blogger/
+"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import gdata.client
+import gdata.gauth
+import gdata.blogger.data
+import atom.data
+import atom.http_core
+
+
+# List user's blogs, takes a user ID, or 'default'.
+BLOGS_URL = 'http://www.blogger.com/feeds/%s/blogs'
+# Takes a blog ID.
+BLOG_POST_URL = 'http://www.blogger.com/feeds/%s/posts/default'
+# Takes a blog ID.
+BLOG_PAGE_URL = 'http://www.blogger.com/feeds/%s/pages/default'
+# Takes a blog ID and post ID.
+BLOG_POST_COMMENTS_URL = 'http://www.blogger.com/feeds/%s/%s/comments/default'
+# Takes a blog ID.
+BLOG_COMMENTS_URL = 'http://www.blogger.com/feeds/%s/comments/default'
+# Takes a blog ID.
+BLOG_ARCHIVE_URL = 'http://www.blogger.com/feeds/%s/archive/full'
+
+
+class BloggerClient(gdata.client.GDClient):
+ api_version = '2'
+ auth_service = 'blogger'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['blogger']
+
+ def get_blogs(self, user_id='default', auth_token=None,
+ desired_class=gdata.blogger.data.BlogFeed, **kwargs):
+ return self.get_feed(BLOGS_URL % user_id, auth_token=auth_token,
+ desired_class=desired_class, **kwargs)
+
+ GetBlogs = get_blogs
+
+ def get_posts(self, blog_id, auth_token=None,
+ desired_class=gdata.blogger.data.BlogPostFeed, query=None,
+ **kwargs):
+ return self.get_feed(BLOG_POST_URL % blog_id, auth_token=auth_token,
+ desired_class=desired_class, query=query, **kwargs)
+
+ GetPosts = get_posts
+
+ def get_pages(self, blog_id, auth_token=None,
+ desired_class=gdata.blogger.data.BlogPageFeed, query=None,
+ **kwargs):
+ return self.get_feed(BLOG_PAGE_URL % blog_id, auth_token=auth_token,
+ desired_class=desired_class, query=query, **kwargs)
+
+ GetPages = get_pages
+
+ def get_post_comments(self, blog_id, post_id, auth_token=None,
+ desired_class=gdata.blogger.data.CommentFeed,
+ query=None, **kwargs):
+ return self.get_feed(BLOG_POST_COMMENTS_URL % (blog_id, post_id),
+ auth_token=auth_token, desired_class=desired_class,
+ query=query, **kwargs)
+
+ GetPostComments = get_post_comments
+
+ def get_blog_comments(self, blog_id, auth_token=None,
+ desired_class=gdata.blogger.data.CommentFeed,
+ query=None, **kwargs):
+ return self.get_feed(BLOG_COMMENTS_URL % blog_id, auth_token=auth_token,
+ desired_class=desired_class, query=query, **kwargs)
+
+ GetBlogComments = get_blog_comments
+
+ def get_blog_archive(self, blog_id, auth_token=None, **kwargs):
+ return self.get_feed(BLOG_ARCHIVE_URL % blog_id, auth_token=auth_token,
+ **kwargs)
+
+ GetBlogArchive = get_blog_archive
+
+ def add_post(self, blog_id, title, body, labels=None, draft=False,
+ auth_token=None, title_type='text', body_type='html', **kwargs):
+ # Construct an atom Entry for the blog post to be sent to the server.
+ new_entry = gdata.blogger.data.BlogPost(
+ title=atom.data.Title(text=title, type=title_type),
+ content=atom.data.Content(text=body, type=body_type))
+ if labels:
+ for label in labels:
+ new_entry.add_label(label)
+ if draft:
+ new_entry.control = atom.data.Control(draft=atom.data.Draft(text='yes'))
+ return self.post(new_entry, BLOG_POST_URL % blog_id, auth_token=auth_token, **kwargs)
+
+ AddPost = add_post
+
+ def add_page(self, blog_id, title, body, draft=False, auth_token=None,
+ title_type='text', body_type='html', **kwargs):
+ new_entry = gdata.blogger.data.BlogPage(
+ title=atom.data.Title(text=title, type=title_type),
+ content=atom.data.Content(text=body, type=body_type))
+ if draft:
+ new_entry.control = atom.data.Control(draft=atom.data.Draft(text='yes'))
+ return self.post(new_entry, BLOG_PAGE_URL % blog_id, auth_token=auth_token, **kwargs)
+
+ AddPage = add_page
+
+ def add_comment(self, blog_id, post_id, body, auth_token=None,
+ title_type='text', body_type='html', **kwargs):
+ new_entry = gdata.blogger.data.Comment(
+ content=atom.data.Content(text=body, type=body_type))
+ return self.post(new_entry, BLOG_POST_COMMENTS_URL % (blog_id, post_id),
+ auth_token=auth_token, **kwargs)
+
+ AddComment = add_comment
+
+ def update(self, entry, auth_token=None, **kwargs):
+ # The Blogger API does not currently support ETags, so for now remove
+ # the ETag before performing an update.
+ old_etag = entry.etag
+ entry.etag = None
+ response = gdata.client.GDClient.update(self, entry,
+ auth_token=auth_token, **kwargs)
+ entry.etag = old_etag
+ return response
+
+ Update = update
+
+ def delete(self, entry_or_uri, auth_token=None, **kwargs):
+ if isinstance(entry_or_uri, (str, unicode, atom.http_core.Uri)):
+ return gdata.client.GDClient.delete(self, entry_or_uri,
+ auth_token=auth_token, **kwargs)
+ # The Blogger API does not currently support ETags, so for now remove
+ # the ETag before performing a delete.
+ old_etag = entry_or_uri.etag
+ entry_or_uri.etag = None
+ response = gdata.client.GDClient.delete(self, entry_or_uri,
+ auth_token=auth_token, **kwargs)
+ # TODO: if GDClient.delete raises and exception, the entry's etag may be
+ # left as None. Should revisit this logic.
+ entry_or_uri.etag = old_etag
+ return response
+
+ Delete = delete
+
+
+class Query(gdata.client.Query):
+
+ def __init__(self, order_by=None, **kwargs):
+ gdata.client.Query.__init__(self, **kwargs)
+ self.order_by = order_by
+
+ def modify_request(self, http_request):
+ gdata.client._add_query_param('orderby', self.order_by, http_request)
+ gdata.client.Query.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
diff --git a/src/gdata/blogger/data.py b/src/gdata/blogger/data.py
new file mode 100644
index 0000000..3cdaa73
--- /dev/null
+++ b/src/gdata/blogger/data.py
@@ -0,0 +1,168 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Data model classes for parsing and generating XML for the Blogger API."""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import re
+import urlparse
+import atom.core
+import gdata.data
+
+
+LABEL_SCHEME = 'http://www.blogger.com/atom/ns#'
+THR_TEMPLATE = '{http://purl.org/syndication/thread/1.0}%s'
+
+BLOG_NAME_PATTERN = re.compile('(http://)(\w*)')
+BLOG_ID_PATTERN = re.compile('(tag:blogger.com,1999:blog-)(\w*)')
+BLOG_ID2_PATTERN = re.compile('tag:blogger.com,1999:user-(\d+)\.blog-(\d+)')
+POST_ID_PATTERN = re.compile(
+ '(tag:blogger.com,1999:blog-)(\w*)(.post-)(\w*)')
+PAGE_ID_PATTERN = re.compile(
+ '(tag:blogger.com,1999:blog-)(\w*)(.page-)(\w*)')
+COMMENT_ID_PATTERN = re.compile('.*-(\w*)$')
+
+
+class BloggerEntry(gdata.data.GDEntry):
+ """Adds convenience methods inherited by all Blogger entries."""
+
+ def get_blog_id(self):
+ """Extracts the Blogger id of this blog.
+
+ This method is useful when contructing URLs by hand. The blog id is
+ often used in blogger operation URLs. This should not be confused with
+ the id member of a BloggerBlog. The id element is the Atom id XML element.
+ The blog id which this method returns is a part of the Atom id.
+
+ Returns:
+ The blog's unique id as a string.
+ """
+ if self.id.text:
+ match = BLOG_ID_PATTERN.match(self.id.text)
+ if match:
+ return match.group(2)
+ else:
+ return BLOG_ID2_PATTERN.match(self.id.text).group(2)
+ return None
+
+ GetBlogId = get_blog_id
+
+ def get_blog_name(self):
+ """Finds the name of this blog as used in the 'alternate' URL.
+
+ An alternate URL is in the form 'http://blogName.blogspot.com/'. For an
+ entry representing the above example, this method would return 'blogName'.
+
+ Returns:
+ The blog's URL name component as a string.
+ """
+ for link in self.link:
+ if link.rel == 'alternate':
+ return urlparse.urlparse(link.href)[1].split(".", 1)[0]
+ return None
+
+ GetBlogName = get_blog_name
+
+
+class Blog(BloggerEntry):
+ """Represents a blog which belongs to the user."""
+
+
+class BlogFeed(gdata.data.GDFeed):
+ entry = [Blog]
+
+
+class BlogPost(BloggerEntry):
+ """Represents a single post on a blog."""
+
+ def add_label(self, label):
+ """Adds a label to the blog post.
+
+ The label is represented by an Atom category element, so this method
+ is shorthand for appending a new atom.Category object.
+
+ Args:
+ label: str
+ """
+ self.category.append(atom.data.Category(scheme=LABEL_SCHEME, term=label))
+
+ AddLabel = add_label
+
+ def get_post_id(self):
+ """Extracts the postID string from the entry's Atom id.
+
+ Returns: A string of digits which identify this post within the blog.
+ """
+ if self.id.text:
+ return POST_ID_PATTERN.match(self.id.text).group(4)
+ return None
+
+ GetPostId = get_post_id
+
+
+class BlogPostFeed(gdata.data.GDFeed):
+ entry = [BlogPost]
+
+
+class BlogPage(BloggerEntry):
+ """Represents a single page on a blog."""
+
+ def get_page_id(self):
+ """Extracts the pageID string from entry's Atom id.
+
+ Returns: A string of digits which identify this post within the blog.
+ """
+ if self.id.text:
+ return PAGE_ID_PATTERN.match(self.id.text).group(4)
+ return None
+
+ GetPageId = get_page_id
+
+
+class BlogPageFeed(gdata.data.GDFeed):
+ entry = [BlogPage]
+
+
+class InReplyTo(atom.core.XmlElement):
+ _qname = THR_TEMPLATE % 'in-reply-to'
+ href = 'href'
+ ref = 'ref'
+ source = 'source'
+ type = 'type'
+
+
+class Comment(BloggerEntry):
+ """Blog post comment entry in a feed listing comments on a post or blog."""
+ in_reply_to = InReplyTo
+
+ def get_comment_id(self):
+ """Extracts the commentID string from the entry's Atom id.
+
+ Returns: A string of digits which identify this post within the blog.
+ """
+ if self.id.text:
+ return COMMENT_ID_PATTERN.match(self.id.text).group(1)
+ return None
+
+ GetCommentId = get_comment_id
+
+
+class CommentFeed(gdata.data.GDFeed):
+ entry = [Comment]
diff --git a/src/gdata/blogger/service.py b/src/gdata/blogger/service.py
new file mode 100644
index 0000000..ad74d63
--- /dev/null
+++ b/src/gdata/blogger/service.py
@@ -0,0 +1,142 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Classes to interact with the Blogger server."""
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+import gdata.service
+import gdata.blogger
+
+
+class BloggerService(gdata.service.GDataService):
+
+ def __init__(self, email=None, password=None, source=None,
+ server='www.blogger.com', **kwargs):
+ """Creates a client for the Blogger service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'www.blogger.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='blogger', source=source,
+ server=server, **kwargs)
+
+ def GetBlogFeed(self, uri=None):
+ """Retrieve a list of the blogs to which the current user may manage."""
+ if not uri:
+ uri = '/feeds/default/blogs'
+ return self.Get(uri, converter=gdata.blogger.BlogFeedFromString)
+
+ def GetBlogCommentFeed(self, blog_id=None, uri=None):
+ """Retrieve a list of the comments for this blog."""
+ if blog_id:
+ uri = '/feeds/%s/comments/default' % blog_id
+ return self.Get(uri, converter=gdata.blogger.CommentFeedFromString)
+
+ def GetBlogPostFeed(self, blog_id=None, uri=None):
+ if blog_id:
+ uri = '/feeds/%s/posts/default' % blog_id
+ return self.Get(uri, converter=gdata.blogger.BlogPostFeedFromString)
+
+ def GetPostCommentFeed(self, blog_id=None, post_id=None, uri=None):
+ """Retrieve a list of the comments for this particular blog post."""
+ if blog_id and post_id:
+ uri = '/feeds/%s/%s/comments/default' % (blog_id, post_id)
+ return self.Get(uri, converter=gdata.blogger.CommentFeedFromString)
+
+ def AddPost(self, entry, blog_id=None, uri=None):
+ if blog_id:
+ uri = '/feeds/%s/posts/default' % blog_id
+ return self.Post(entry, uri,
+ converter=gdata.blogger.BlogPostEntryFromString)
+
+ def UpdatePost(self, entry, uri=None):
+ if not uri:
+ uri = entry.GetEditLink().href
+ return self.Put(entry, uri,
+ converter=gdata.blogger.BlogPostEntryFromString)
+
+ def DeletePost(self, entry=None, uri=None):
+ if not uri:
+ uri = entry.GetEditLink().href
+ return self.Delete(uri)
+
+ def AddComment(self, comment_entry, blog_id=None, post_id=None, uri=None):
+ """Adds a new comment to the specified blog post."""
+ if blog_id and post_id:
+ uri = '/feeds/%s/%s/comments/default' % (blog_id, post_id)
+ return self.Post(comment_entry, uri,
+ converter=gdata.blogger.CommentEntryFromString)
+
+ def DeleteComment(self, entry=None, uri=None):
+ if not uri:
+ uri = entry.GetEditLink().href
+ return self.Delete(uri)
+
+
+class BlogQuery(gdata.service.Query):
+
+ def __init__(self, feed=None, params=None, categories=None, blog_id=None):
+ """Constructs a query object for the list of a user's Blogger blogs.
+
+ Args:
+ feed: str (optional) The beginning of the URL to be queried. If the
+ feed is not set, and there is no blog_id passed in, the default
+ value is used ('/feeds/default/blogs').
+ params: dict (optional)
+ categories: list (optional)
+ blog_id: str (optional)
+ """
+ if not feed and blog_id:
+ feed = '/feeds/default/blogs/%s' % blog_id
+ elif not feed:
+ feed = '/feeds/default/blogs'
+ gdata.service.Query.__init__(self, feed=feed, params=params,
+ categories=categories)
+
+
+class BlogPostQuery(gdata.service.Query):
+
+ def __init__(self, feed=None, params=None, categories=None, blog_id=None,
+ post_id=None):
+ if not feed and blog_id and post_id:
+ feed = '/feeds/%s/posts/default/%s' % (blog_id, post_id)
+ elif not feed and blog_id:
+ feed = '/feeds/%s/posts/default' % blog_id
+ gdata.service.Query.__init__(self, feed=feed, params=params,
+ categories=categories)
+
+
+class BlogCommentQuery(gdata.service.Query):
+
+ def __init__(self, feed=None, params=None, categories=None, blog_id=None,
+ post_id=None, comment_id=None):
+ if not feed and blog_id and comment_id:
+ feed = '/feeds/%s/comments/default/%s' % (blog_id, comment_id)
+ elif not feed and blog_id and post_id:
+ feed = '/feeds/%s/%s/comments/default' % (blog_id, post_id)
+ elif not feed and blog_id:
+ feed = '/feeds/%s/comments/default' % blog_id
+ gdata.service.Query.__init__(self, feed=feed, params=params,
+ categories=categories)
diff --git a/src/gdata/books/__init__.py b/src/gdata/books/__init__.py
new file mode 100644
index 0000000..1a961ab
--- /dev/null
+++ b/src/gdata/books/__init__.py
@@ -0,0 +1,473 @@
+#!/usr/bin/python
+
+"""
+ Data Models for books.service
+
+ All classes can be instantiated from an xml string using their FromString
+ class method.
+
+ Notes:
+ * Book.title displays the first dc:title because the returned XML
+ repeats that datum as atom:title.
+ There is an undocumented gbs:openAccess element that is not parsed.
+"""
+
+__author__ = "James Sams <sams.james@gmail.com>"
+__copyright__ = "Apache License v2.0"
+
+import atom
+import gdata
+
+
+BOOK_SEARCH_NAMESPACE = 'http://schemas.google.com/books/2008'
+DC_NAMESPACE = 'http://purl.org/dc/terms'
+ANNOTATION_REL = "http://schemas.google.com/books/2008/annotation"
+INFO_REL = "http://schemas.google.com/books/2008/info"
+LABEL_SCHEME = "http://schemas.google.com/books/2008/labels"
+PREVIEW_REL = "http://schemas.google.com/books/2008/preview"
+THUMBNAIL_REL = "http://schemas.google.com/books/2008/thumbnail"
+FULL_VIEW = "http://schemas.google.com/books/2008#view_all_pages"
+PARTIAL_VIEW = "http://schemas.google.com/books/2008#view_partial"
+NO_VIEW = "http://schemas.google.com/books/2008#view_no_pages"
+UNKNOWN_VIEW = "http://schemas.google.com/books/2008#view_unknown"
+EMBEDDABLE = "http://schemas.google.com/books/2008#embeddable"
+NOT_EMBEDDABLE = "http://schemas.google.com/books/2008#not_embeddable"
+
+
+
+class _AtomFromString(atom.AtomBase):
+
+ #@classmethod
+ def FromString(cls, s):
+ return atom.CreateClassFromXMLString(cls, s)
+
+ FromString = classmethod(FromString)
+
+
+class Creator(_AtomFromString):
+ """
+ The <dc:creator> element identifies an author-or more generally, an entity
+ responsible for creating the volume in question. Examples of a creator
+ include a person, an organization, or a service. In the case of
+ anthologies, proceedings, or other edited works, this field may be used to
+ indicate editors or other entities responsible for collecting the volume's
+ contents.
+
+ This element appears as a child of <entry>. If there are multiple authors or
+ contributors to the book, there may be multiple <dc:creator> elements in the
+ volume entry (one for each creator or contributor).
+ """
+
+ _tag = 'creator'
+ _namespace = DC_NAMESPACE
+
+
+class Date(_AtomFromString): #iso 8601 / W3CDTF profile
+ """
+ The <dc:date> element indicates the publication date of the specific volume
+ in question. If the book is a reprint, this is the reprint date, not the
+ original publication date. The date is encoded according to the ISO-8601
+ standard (and more specifically, the W3CDTF profile).
+
+ The <dc:date> element can appear only as a child of <entry>.
+
+ Usually only the year or the year and the month are given.
+
+ YYYY-MM-DDThh:mm:ssTZD TZD = -hh:mm or +hh:mm
+ """
+
+ _tag = 'date'
+ _namespace = DC_NAMESPACE
+
+
+class Description(_AtomFromString):
+ """
+ The <dc:description> element includes text that describes a book or book
+ result. In a search result feed, this may be a search result "snippet" that
+ contains the words around the user's search term. For a single volume feed,
+ this element may contain a synopsis of the book.
+
+ The <dc:description> element can appear only as a child of <entry>
+ """
+
+ _tag = 'description'
+ _namespace = DC_NAMESPACE
+
+
+class Format(_AtomFromString):
+ """
+ The <dc:format> element describes the physical properties of the volume.
+ Currently, it indicates the number of pages in the book, but more
+ information may be added to this field in the future.
+
+ This element can appear only as a child of <entry>.
+ """
+
+ _tag = 'format'
+ _namespace = DC_NAMESPACE
+
+
+class Identifier(_AtomFromString):
+ """
+ The <dc:identifier> element provides an unambiguous reference to a
+ particular book.
+ * Every <entry> contains at least one <dc:identifier> child.
+ * The first identifier is always the unique string Book Search has assigned
+ to the volume (such as s1gVAAAAYAAJ). This is the ID that appears in the
+ book's URL in the Book Search GUI, as well as in the URL of that book's
+ single item feed.
+ * Many books contain additional <dc:identifier> elements. These provide
+ alternate, external identifiers to the volume. Such identifiers may
+ include the ISBNs, ISSNs, Library of Congress Control Numbers (LCCNs),
+ and OCLC numbers; they are prepended with a corresponding namespace
+ prefix (such as "ISBN:").
+ * Any <dc:identifier> can be passed to the Dynamic Links, used to
+ instantiate an Embedded Viewer, or even used to construct static links to
+ Book Search.
+ The <dc:identifier> element can appear only as a child of <entry>.
+ """
+
+ _tag = 'identifier'
+ _namespace = DC_NAMESPACE
+
+
+class Publisher(_AtomFromString):
+ """
+ The <dc:publisher> element contains the name of the entity responsible for
+ producing and distributing the volume (usually the specific edition of this
+ book). Examples of a publisher include a person, an organization, or a
+ service.
+
+ This element can appear only as a child of <entry>. If there is more than
+ one publisher, multiple <dc:publisher> elements may appear.
+ """
+
+ _tag = 'publisher'
+ _namespace = DC_NAMESPACE
+
+
+class Subject(_AtomFromString):
+ """
+ The <dc:subject> element identifies the topic of the book. Usually this is
+ a Library of Congress Subject Heading (LCSH) or Book Industry Standards
+ and Communications Subject Heading (BISAC).
+
+ The <dc:subject> element can appear only as a child of <entry>. There may
+ be multiple <dc:subject> elements per entry.
+ """
+
+ _tag = 'subject'
+ _namespace = DC_NAMESPACE
+
+
+class Title(_AtomFromString):
+ """
+ The <dc:title> element contains the title of a book as it was published. If
+ a book has a subtitle, it appears as a second <dc:title> element in the book
+ result's <entry>.
+ """
+
+ _tag = 'title'
+ _namespace = DC_NAMESPACE
+
+
+class Viewability(_AtomFromString):
+ """
+ Google Book Search respects the user's local copyright restrictions. As a
+ result, previews or full views of some books are not available in all
+ locations. The <gbs:viewability> element indicates whether a book is fully
+ viewable, can be previewed, or only has "about the book" information. These
+ three "viewability modes" are the same ones returned by the Dynamic Links
+ API.
+
+ The <gbs:viewability> element can appear only as a child of <entry>.
+
+ The value attribute will take the form of the following URIs to represent
+ the relevant viewing capability:
+
+ Full View: http://schemas.google.com/books/2008#view_all_pages
+ Limited Preview: http://schemas.google.com/books/2008#view_partial
+ Snippet View/No Preview: http://schemas.google.com/books/2008#view_no_pages
+ Unknown view: http://schemas.google.com/books/2008#view_unknown
+ """
+
+ _tag = 'viewability'
+ _namespace = BOOK_SEARCH_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ self.value = value
+ _AtomFromString.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+
+class Embeddability(_AtomFromString):
+ """
+ Many of the books found on Google Book Search can be embedded on third-party
+ sites using the Embedded Viewer. The <gbs:embeddability> element indicates
+ whether a particular book result is available for embedding. By definition,
+ a book that cannot be previewed on Book Search cannot be embedded on third-
+ party sites.
+
+ The <gbs:embeddability> element can appear only as a child of <entry>.
+
+ The value attribute will take on one of the following URIs:
+ embeddable: http://schemas.google.com/books/2008#embeddable
+ not embeddable: http://schemas.google.com/books/2008#not_embeddable
+ """
+
+ _tag = 'embeddability'
+ _namespace = BOOK_SEARCH_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ self.value = value
+ _AtomFromString.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+
+class Review(_AtomFromString):
+ """
+ When present, the <gbs:review> element contains a user-generated review for
+ a given book. This element currently appears only in the user library and
+ user annotation feeds, as a child of <entry>.
+
+ type: text, html, xhtml
+ xml:lang: id of the language, a guess, (always two letters?)
+ """
+
+ _tag = 'review'
+ _namespace = BOOK_SEARCH_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['type'] = 'type'
+ _attributes['{http://www.w3.org/XML/1998/namespace}lang'] = 'lang'
+
+ def __init__(self, type=None, lang=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ self.type = type
+ self.lang = lang
+ _AtomFromString.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+
+class Rating(_AtomFromString):
+ """All attributes must take an integral string between 1 and 5.
+ The min, max, and average attributes represent 'community' ratings. The
+ value attribute is the user's (of the feed from which the item is fetched,
+ not necessarily the authenticated user) rating of the book.
+ """
+
+ _tag = 'rating'
+ _namespace = gdata.GDATA_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['min'] = 'min'
+ _attributes['max'] = 'max'
+ _attributes['average'] = 'average'
+ _attributes['value'] = 'value'
+
+ def __init__(self, min=None, max=None, average=None, value=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ self.min = min
+ self.max = max
+ self.average = average
+ self.value = value
+ _AtomFromString.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+
+class Book(_AtomFromString, gdata.GDataEntry):
+ """
+ Represents an <entry> from either a search, annotation, library, or single
+ item feed. Note that dc_title attribute is the proper title of the volume,
+ title is an atom element and may not represent the full title.
+ """
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ for i in (Creator, Identifier, Publisher, Subject,):
+ _children['{%s}%s' % (i._namespace, i._tag)] = (i._tag, [i])
+ for i in (Date, Description, Format, Viewability, Embeddability,
+ Review, Rating): # Review, Rating maybe only in anno/lib entrys
+ _children['{%s}%s' % (i._namespace, i._tag)] = (i._tag, i)
+ # there is an atom title as well, should we clobber that?
+ del(i)
+ _children['{%s}%s' % (Title._namespace, Title._tag)] = ('dc_title', [Title])
+
+ def to_dict(self):
+ """Returns a dictionary of the book's available metadata. If the data
+ cannot be discovered, it is not included as a key in the returned dict.
+ The possible keys are: authors, embeddability, date, description,
+ format, identifiers, publishers, rating, review, subjects, title, and
+ viewability.
+
+ Notes:
+ * Plural keys will be lists
+ * Singular keys will be strings
+ * Title, despite usually being a list, joins the title and subtitle
+ with a space as a single string.
+ * embeddability and viewability only return the portion of the URI
+ after #
+ * identifiers is a list of tuples, where the first item of each tuple
+ is the type of identifier and the second item is the identifying
+ string. Note that while doing dict() on this tuple may be possible,
+ some items may have multiple of the same identifier and converting
+ to a dict may resulted in collisions/dropped data.
+ * Rating returns only the user's rating. See Rating class for precise
+ definition.
+ """
+ d = {}
+ if self.GetAnnotationLink():
+ d['annotation'] = self.GetAnnotationLink().href
+ if self.creator:
+ d['authors'] = [x.text for x in self.creator]
+ if self.embeddability:
+ d['embeddability'] = self.embeddability.value.split('#')[-1]
+ if self.date:
+ d['date'] = self.date.text
+ if self.description:
+ d['description'] = self.description.text
+ if self.format:
+ d['format'] = self.format.text
+ if self.identifier:
+ d['identifiers'] = [('google_id', self.identifier[0].text)]
+ for x in self.identifier[1:]:
+ l = x.text.split(':') # should we lower the case of the ids?
+ d['identifiers'].append((l[0], ':'.join(l[1:])))
+ if self.GetInfoLink():
+ d['info'] = self.GetInfoLink().href
+ if self.GetPreviewLink():
+ d['preview'] = self.GetPreviewLink().href
+ if self.publisher:
+ d['publishers'] = [x.text for x in self.publisher]
+ if self.rating:
+ d['rating'] = self.rating.value
+ if self.review:
+ d['review'] = self.review.text
+ if self.subject:
+ d['subjects'] = [x.text for x in self.subject]
+ if self.GetThumbnailLink():
+ d['thumbnail'] = self.GetThumbnailLink().href
+ if self.dc_title:
+ d['title'] = ' '.join([x.text for x in self.dc_title])
+ if self.viewability:
+ d['viewability'] = self.viewability.value.split('#')[-1]
+ return d
+
+ def __init__(self, creator=None, date=None,
+ description=None, format=None, author=None, identifier=None,
+ publisher=None, subject=None, dc_title=None, viewability=None,
+ embeddability=None, review=None, rating=None, category=None,
+ content=None, contributor=None, atom_id=None, link=None,
+ published=None, rights=None, source=None, summary=None,
+ title=None, control=None, updated=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ self.creator = creator
+ self.date = date
+ self.description = description
+ self.format = format
+ self.identifier = identifier
+ self.publisher = publisher
+ self.subject = subject
+ self.dc_title = dc_title or []
+ self.viewability = viewability
+ self.embeddability = embeddability
+ self.review = review
+ self.rating = rating
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, contributor=contributor, atom_id=atom_id,
+ link=link, published=published, rights=rights, source=source,
+ summary=summary, title=title, control=control, updated=updated,
+ text=text, extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+
+ def GetThumbnailLink(self):
+ """Returns the atom.Link object representing the thumbnail URI."""
+ for i in self.link:
+ if i.rel == THUMBNAIL_REL:
+ return i
+
+ def GetInfoLink(self):
+ """
+ Returns the atom.Link object representing the human-readable info URI.
+ """
+ for i in self.link:
+ if i.rel == INFO_REL:
+ return i
+
+ def GetPreviewLink(self):
+ """Returns the atom.Link object representing the preview URI."""
+ for i in self.link:
+ if i.rel == PREVIEW_REL:
+ return i
+
+ def GetAnnotationLink(self):
+ """
+ Returns the atom.Link object representing the Annotation URI.
+ Note that the use of www.books in the href of this link seems to make
+ this information useless. Using books.service.ANNOTATION_FEED and
+ BOOK_SERVER to construct your URI seems to work better.
+ """
+ for i in self.link:
+ if i.rel == ANNOTATION_REL:
+ return i
+
+ def set_rating(self, value):
+ """Set user's rating. Must be an integral string between 1 nad 5"""
+ assert (value in ('1','2','3','4','5'))
+ if not isinstance(self.rating, Rating):
+ self.rating = Rating()
+ self.rating.value = value
+
+ def set_review(self, text, type='text', lang='en'):
+ """Set user's review text"""
+ self.review = Review(text=text, type=type, lang=lang)
+
+ def get_label(self):
+ """Get users label for the item as a string"""
+ for i in self.category:
+ if i.scheme == LABEL_SCHEME:
+ return i.term
+
+ def set_label(self, term):
+ """Clear pre-existing label for the item and set term as the label."""
+ self.remove_label()
+ self.category.append(atom.Category(term=term, scheme=LABEL_SCHEME))
+
+ def remove_label(self):
+ """Clear the user's label for the item"""
+ ln = len(self.category)
+ for i, j in enumerate(self.category[::-1]):
+ if j.scheme == LABEL_SCHEME:
+ del(self.category[ln-1-i])
+
+ def clean_annotations(self):
+ """Clear all annotations from an item. Useful for taking an item from
+ another user's library/annotation feed and adding it to the
+ authenticated user's library without adopting annotations."""
+ self.remove_label()
+ self.review = None
+ self.rating = None
+
+
+ def get_google_id(self):
+ """Get Google's ID of the item."""
+ return self.id.text.split('/')[-1]
+
+
+class BookFeed(_AtomFromString, gdata.GDataFeed):
+ """Represents a feed of entries from a search."""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _children['{%s}%s' % (Book._namespace, Book._tag)] = (Book._tag, [Book])
+
+
+if __name__ == '__main__':
+ import doctest
+ doctest.testfile('datamodels.txt')
diff --git a/src/gdata/books/data.py b/src/gdata/books/data.py
new file mode 100644
index 0000000..3f7f978
--- /dev/null
+++ b/src/gdata/books/data.py
@@ -0,0 +1,90 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains the data classes of the Google Book Search Data API"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+import atom.data
+import gdata.data
+import gdata.dublincore.data
+import gdata.opensearch.data
+
+
+GBS_TEMPLATE = '{http://schemas.google.com/books/2008/}%s'
+
+
+class CollectionEntry(gdata.data.GDEntry):
+ """Describes an entry in a feed of collections."""
+
+
+class CollectionFeed(gdata.data.BatchFeed):
+ """Describes a Book Search collection feed."""
+ entry = [CollectionEntry]
+
+
+class Embeddability(atom.core.XmlElement):
+ """Describes an embeddability."""
+ _qname = GBS_TEMPLATE % 'embeddability'
+ value = 'value'
+
+
+class OpenAccess(atom.core.XmlElement):
+ """Describes an open access."""
+ _qname = GBS_TEMPLATE % 'openAccess'
+ value = 'value'
+
+
+class Review(atom.core.XmlElement):
+ """User-provided review."""
+ _qname = GBS_TEMPLATE % 'review'
+ lang = 'lang'
+ type = 'type'
+
+
+class Viewability(atom.core.XmlElement):
+ """Describes a viewability."""
+ _qname = GBS_TEMPLATE % 'viewability'
+ value = 'value'
+
+
+class VolumeEntry(gdata.data.GDEntry):
+ """Describes an entry in a feed of Book Search volumes."""
+ comments = gdata.data.Comments
+ language = [gdata.dublincore.data.Language]
+ open_access = OpenAccess
+ format = [gdata.dublincore.data.Format]
+ dc_title = [gdata.dublincore.data.Title]
+ viewability = Viewability
+ embeddability = Embeddability
+ creator = [gdata.dublincore.data.Creator]
+ rating = gdata.data.Rating
+ description = [gdata.dublincore.data.Description]
+ publisher = [gdata.dublincore.data.Publisher]
+ date = [gdata.dublincore.data.Date]
+ subject = [gdata.dublincore.data.Subject]
+ identifier = [gdata.dublincore.data.Identifier]
+ review = Review
+
+
+class VolumeFeed(gdata.data.BatchFeed):
+ """Describes a Book Search volume feed."""
+ entry = [VolumeEntry]
+
+
diff --git a/src/gdata/books/service.py b/src/gdata/books/service.py
new file mode 100644
index 0000000..cbb846f
--- /dev/null
+++ b/src/gdata/books/service.py
@@ -0,0 +1,266 @@
+#!/usr/bin/python
+
+"""
+ Extend gdata.service.GDataService to support authenticated CRUD ops on
+ Books API
+
+ http://code.google.com/apis/books/docs/getting-started.html
+ http://code.google.com/apis/books/docs/gdata/developers_guide_protocol.html
+
+ TODO: (here and __init__)
+ * search based on label, review, or other annotations (possible?)
+ * edit (specifically, Put requests) seem to fail effect a change
+
+ Problems With API:
+ * Adding a book with a review to the library adds a note, not a review.
+ This does not get included in the returned item. You see this by
+ looking at My Library through the website.
+ * Editing a review never edits a review (unless it is freshly added, but
+ see above). More generally,
+ * a Put request with changed annotations (label/rating/review) does NOT
+ change the data. Note: Put requests only work on the href from
+ GetEditLink (as per the spec). Do not try to PUT to the annotate or
+ library feeds, this will cause a 400 Invalid URI Bad Request response.
+ Attempting to Post to one of the feeds with the updated annotations
+ does not update them. See the following for (hopefully) a follow up:
+ google.com/support/forum/p/booksearch-apis/thread?tid=27fd7f68de438fc8
+ * Attempts to workaround the edit problem continue to fail. For example,
+ removing the item, editing the data, readding the item, gives us only
+ our originally added data (annotations). This occurs even if we
+ completely shut python down, refetch the book from the public feed,
+ and re-add it. There is some kind of persistence going on that I
+ cannot change. This is likely due to the annotations being cached in
+ the annotation feed and the inability to edit (see Put, above)
+ * GetAnnotationLink has www.books.... as the server, but hitting www...
+ results in a bad URI error.
+ * Spec indicates there may be multiple labels, but there does not seem
+ to be a way to get the server to accept multiple labels, nor does the
+ web interface have an obvious way to have multiple labels. Multiple
+ labels are never returned.
+"""
+
+__author__ = "James Sams <sams.james@gmail.com>"
+__copyright__ = "Apache License v2.0"
+
+from shlex import split
+
+import gdata.service
+try:
+ import books
+except ImportError:
+ import gdata.books as books
+
+
+BOOK_SERVER = "books.google.com"
+GENERAL_FEED = "/books/feeds/volumes"
+ITEM_FEED = "/books/feeds/volumes/"
+LIBRARY_FEED = "/books/feeds/users/%s/collections/library/volumes"
+ANNOTATION_FEED = "/books/feeds/users/%s/volumes"
+PARTNER_FEED = "/books/feeds/p/%s/volumes"
+BOOK_SERVICE = "print"
+ACCOUNT_TYPE = "HOSTED_OR_GOOGLE"
+
+
+class BookService(gdata.service.GDataService):
+
+ def __init__(self, email=None, password=None, source=None,
+ server=BOOK_SERVER, account_type=ACCOUNT_TYPE,
+ exception_handlers=tuple(), **kwargs):
+ """source should be of form 'ProgramCompany - ProgramName - Version'"""
+
+ gdata.service.GDataService.__init__(self, email=email,
+ password=password, service=BOOK_SERVICE, source=source,
+ server=server, **kwargs)
+ self.exception_handlers = exception_handlers
+
+ def search(self, q, start_index="1", max_results="10",
+ min_viewability="none", feed=GENERAL_FEED,
+ converter=books.BookFeed.FromString):
+ """
+ Query the Public search feed. q is either a search string or a
+ gdata.service.Query instance with a query set.
+
+ min_viewability must be "none", "partial", or "full".
+
+ If you change the feed to a single item feed, note that you will
+ probably need to change the converter to be Book.FromString
+ """
+
+ if not isinstance(q, gdata.service.Query):
+ q = gdata.service.Query(text_query=q)
+ if feed:
+ q.feed = feed
+ q['start-index'] = start_index
+ q['max-results'] = max_results
+ q['min-viewability'] = min_viewability
+ return self.Get(uri=q.ToUri(),converter=converter)
+
+ def search_by_keyword(self, q='', feed=GENERAL_FEED, start_index="1",
+ max_results="10", min_viewability="none", **kwargs):
+ """
+ Query the Public Search Feed by keyword. Non-keyword strings can be
+ set in q. This is quite fragile. Is there a function somewhere in
+ the Google library that will parse a query the same way that Google
+ does?
+
+ Legal Identifiers are listed below and correspond to their meaning
+ at http://books.google.com/advanced_book_search:
+ all_words
+ exact_phrase
+ at_least_one
+ without_words
+ title
+ author
+ publisher
+ subject
+ isbn
+ lccn
+ oclc
+ seemingly unsupported:
+ publication_date: a sequence of two, two tuples:
+ ((min_month,min_year),(max_month,max_year))
+ where month is one/two digit month, year is 4 digit, eg:
+ (('1','2000'),('10','2003')). Lower bound is inclusive,
+ upper bound is exclusive
+ """
+
+ for k, v in kwargs.items():
+ if not v:
+ continue
+ k = k.lower()
+ if k == 'all_words':
+ q = "%s %s" % (q, v)
+ elif k == 'exact_phrase':
+ q = '%s "%s"' % (q, v.strip('"'))
+ elif k == 'at_least_one':
+ q = '%s %s' % (q, ' '.join(['OR "%s"' % x for x in split(v)]))
+ elif k == 'without_words':
+ q = '%s %s' % (q, ' '.join(['-"%s"' % x for x in split(v)]))
+ elif k in ('author','title', 'publisher'):
+ q = '%s %s' % (q, ' '.join(['in%s:"%s"'%(k,x) for x in split(v)]))
+ elif k == 'subject':
+ q = '%s %s' % (q, ' '.join(['%s:"%s"' % (k,x) for x in split(v)]))
+ elif k == 'isbn':
+ q = '%s ISBN%s' % (q, v)
+ elif k == 'issn':
+ q = '%s ISSN%s' % (q,v)
+ elif k == 'oclc':
+ q = '%s OCLC%s' % (q,v)
+ else:
+ raise ValueError("Unsupported search keyword")
+ return self.search(q.strip(),start_index=start_index, feed=feed,
+ max_results=max_results,
+ min_viewability=min_viewability)
+
+ def search_library(self, q, id='me', **kwargs):
+ """Like search, but in a library feed. Default is the authenticated
+ user's feed. Change by setting id."""
+
+ if 'feed' in kwargs:
+ raise ValueError("kwarg 'feed' conflicts with library_id")
+ feed = LIBRARY_FEED % id
+ return self.search(q, feed=feed, **kwargs)
+
+ def search_library_by_keyword(self, id='me', **kwargs):
+ """Hybrid of search_by_keyword and search_library
+ """
+
+ if 'feed' in kwargs:
+ raise ValueError("kwarg 'feed' conflicts with library_id")
+ feed = LIBRARY_FEED % id
+ return self.search_by_keyword(feed=feed,**kwargs)
+
+ def search_annotations(self, q, id='me', **kwargs):
+ """Like search, but in an annotation feed. Default is the authenticated
+ user's feed. Change by setting id."""
+
+ if 'feed' in kwargs:
+ raise ValueError("kwarg 'feed' conflicts with library_id")
+ feed = ANNOTATION_FEED % id
+ return self.search(q, feed=feed, **kwargs)
+
+ def search_annotations_by_keyword(self, id='me', **kwargs):
+ """Hybrid of search_by_keyword and search_annotations
+ """
+
+ if 'feed' in kwargs:
+ raise ValueError("kwarg 'feed' conflicts with library_id")
+ feed = ANNOTATION_FEED % id
+ return self.search_by_keyword(feed=feed,**kwargs)
+
+ def add_item_to_library(self, item):
+ """Add the item, either an XML string or books.Book instance, to the
+ user's library feed"""
+
+ feed = LIBRARY_FEED % 'me'
+ return self.Post(data=item, uri=feed, converter=books.Book.FromString)
+
+ def remove_item_from_library(self, item):
+ """
+ Remove the item, a books.Book instance, from the authenticated user's
+ library feed. Using an item retrieved from a public search will fail.
+ """
+
+ return self.Delete(item.GetEditLink().href)
+
+ def add_annotation(self, item):
+ """
+ Add the item, either an XML string or books.Book instance, to the
+ user's annotation feed.
+ """
+ # do not use GetAnnotationLink, results in 400 Bad URI due to www
+ return self.Post(data=item, uri=ANNOTATION_FEED % 'me',
+ converter=books.Book.FromString)
+
+ def edit_annotation(self, item):
+ """
+ Send an edited item, a books.Book instance, to the user's annotation
+ feed. Note that whereas extra annotations in add_annotations, minus
+ ratings which are immutable once set, are simply added to the item in
+ the annotation feed, if an annotation has been removed from the item,
+ sending an edit request will remove that annotation. This should not
+ happen with add_annotation.
+ """
+
+ return self.Put(data=item, uri=item.GetEditLink().href,
+ converter=books.Book.FromString)
+
+ def get_by_google_id(self, id):
+ return self.Get(ITEM_FEED + id, converter=books.Book.FromString)
+
+ def get_library(self, id='me',feed=LIBRARY_FEED, start_index="1",
+ max_results="100", min_viewability="none",
+ converter=books.BookFeed.FromString):
+ """
+ Return a generator object that will return gbook.Book instances until
+ the search feed no longer returns an item from the GetNextLink method.
+ Thus max_results is not the maximum number of items that will be
+ returned, but rather the number of items per page of searches. This has
+ been set high to reduce the required number of network requests.
+ """
+
+ q = gdata.service.Query()
+ q.feed = feed % id
+ q['start-index'] = start_index
+ q['max-results'] = max_results
+ q['min-viewability'] = min_viewability
+ x = self.Get(uri=q.ToUri(), converter=converter)
+ while 1:
+ for entry in x.entry:
+ yield entry
+ else:
+ l = x.GetNextLink()
+ if l: # hope the server preserves our preferences
+ x = self.Get(uri=l.href, converter=converter)
+ else:
+ break
+
+ def get_annotations(self, id='me', start_index="1", max_results="100",
+ min_viewability="none", converter=books.BookFeed.FromString):
+ """
+ Like get_library, but for the annotation feed
+ """
+
+ return self.get_library(id=id, feed=ANNOTATION_FEED,
+ max_results=max_results, min_viewability = min_viewability,
+ converter=converter)
diff --git a/src/gdata/calendar/__init__.py b/src/gdata/calendar/__init__.py
new file mode 100755
index 0000000..06c0410
--- /dev/null
+++ b/src/gdata/calendar/__init__.py
@@ -0,0 +1,1044 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains extensions to ElementWrapper objects used with Google Calendar."""
+
+
+__author__ = 'api.vli (Vivian Li), api.rboyd (Ryan Boyd)'
+
+
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import atom
+import gdata
+
+
+# XML namespaces which are often used in Google Calendar entities.
+GCAL_NAMESPACE = 'http://schemas.google.com/gCal/2005'
+GCAL_TEMPLATE = '{http://schemas.google.com/gCal/2005}%s'
+WEB_CONTENT_LINK_REL = '%s/%s' % (GCAL_NAMESPACE, 'webContent')
+GACL_NAMESPACE = gdata.GACL_NAMESPACE
+GACL_TEMPLATE = gdata.GACL_TEMPLATE
+
+
+
+class ValueAttributeContainer(atom.AtomBase):
+ """A parent class for all Calendar classes which have a value attribute.
+
+ Children include Color, AccessLevel, Hidden
+ """
+
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+class Color(ValueAttributeContainer):
+ """The Google Calendar color element"""
+
+ _tag = 'color'
+ _namespace = GCAL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+
+class AccessLevel(ValueAttributeContainer):
+ """The Google Calendar accesslevel element"""
+
+ _tag = 'accesslevel'
+ _namespace = GCAL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+class Hidden(ValueAttributeContainer):
+ """The Google Calendar hidden element"""
+
+ _tag = 'hidden'
+ _namespace = GCAL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+class Selected(ValueAttributeContainer):
+ """The Google Calendar selected element"""
+
+ _tag = 'selected'
+ _namespace = GCAL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+class Timezone(ValueAttributeContainer):
+ """The Google Calendar timezone element"""
+
+ _tag = 'timezone'
+ _namespace = GCAL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+class Where(atom.AtomBase):
+ """The Google Calendar Where element"""
+
+ _tag = 'where'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['valueString'] = 'value_string'
+
+ def __init__(self, value_string=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value_string = value_string
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class CalendarListEntry(gdata.GDataEntry, gdata.LinkFinder):
+ """A Google Calendar meta Entry flavor of an Atom Entry """
+
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}color' % GCAL_NAMESPACE] = ('color', Color)
+ _children['{%s}accesslevel' % GCAL_NAMESPACE] = ('access_level',
+ AccessLevel)
+ _children['{%s}hidden' % GCAL_NAMESPACE] = ('hidden', Hidden)
+ _children['{%s}selected' % GCAL_NAMESPACE] = ('selected', Selected)
+ _children['{%s}timezone' % GCAL_NAMESPACE] = ('timezone', Timezone)
+ _children['{%s}where' % gdata.GDATA_NAMESPACE] = ('where', Where)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ color=None, access_level=None, hidden=None, timezone=None,
+ selected=None,
+ where=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title,
+ updated=updated, text=None)
+
+ self.color = color
+ self.access_level = access_level
+ self.hidden = hidden
+ self.selected = selected
+ self.timezone = timezone
+ self.where = where
+
+
+class CalendarListFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Calendar meta feed flavor of an Atom Feed"""
+
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [CalendarListEntry])
+
+
+class Scope(atom.AtomBase):
+ """The Google ACL scope element"""
+
+ _tag = 'scope'
+ _namespace = GACL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+ _attributes['type'] = 'type'
+
+ def __init__(self, extension_elements=None, value=None, scope_type=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.type = scope_type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Role(ValueAttributeContainer):
+ """The Google Calendar timezone element"""
+
+ _tag = 'role'
+ _namespace = GACL_NAMESPACE
+ _children = ValueAttributeContainer._children.copy()
+ _attributes = ValueAttributeContainer._attributes.copy()
+
+
+class CalendarAclEntry(gdata.GDataEntry, gdata.LinkFinder):
+ """A Google Calendar ACL Entry flavor of an Atom Entry """
+
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}scope' % GACL_NAMESPACE] = ('scope', Scope)
+ _children['{%s}role' % GACL_NAMESPACE] = ('role', Role)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ scope=None, role=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title,
+ updated=updated, text=None)
+ self.scope = scope
+ self.role = role
+
+
+class CalendarAclFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Calendar ACL feed flavor of an Atom Feed"""
+
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [CalendarAclEntry])
+
+
+class CalendarEventCommentEntry(gdata.GDataEntry, gdata.LinkFinder):
+ """A Google Calendar event comments entry flavor of an Atom Entry"""
+
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+
+class CalendarEventCommentFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """A Google Calendar event comments feed flavor of an Atom Feed"""
+
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [CalendarEventCommentEntry])
+
+
+class ExtendedProperty(gdata.ExtendedProperty):
+ """A transparent subclass of gdata.ExtendedProperty added to this module
+ for backwards compatibility."""
+
+
+class Reminder(atom.AtomBase):
+ """The Google Calendar reminder element"""
+
+ _tag = 'reminder'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['absoluteTime'] = 'absolute_time'
+ _attributes['days'] = 'days'
+ _attributes['hours'] = 'hours'
+ _attributes['minutes'] = 'minutes'
+ _attributes['method'] = 'method'
+
+ def __init__(self, absolute_time=None,
+ days=None, hours=None, minutes=None, method=None,
+ extension_elements=None,
+ extension_attributes=None, text=None):
+ self.absolute_time = absolute_time
+ if days is not None:
+ self.days = str(days)
+ else:
+ self.days = None
+ if hours is not None:
+ self.hours = str(hours)
+ else:
+ self.hours = None
+ if minutes is not None:
+ self.minutes = str(minutes)
+ else:
+ self.minutes = None
+ self.method = method
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class When(atom.AtomBase):
+ """The Google Calendar When element"""
+
+ _tag = 'when'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}reminder' % gdata.GDATA_NAMESPACE] = ('reminder', [Reminder])
+ _attributes['startTime'] = 'start_time'
+ _attributes['endTime'] = 'end_time'
+
+ def __init__(self, start_time=None, end_time=None, reminder=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.start_time = start_time
+ self.end_time = end_time
+ self.reminder = reminder or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Recurrence(atom.AtomBase):
+ """The Google Calendar Recurrence element"""
+
+ _tag = 'recurrence'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+
+class UriEnumElement(atom.AtomBase):
+
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, tag, enum_map, attrib_name='value',
+ extension_elements=None, extension_attributes=None, text=None):
+ self.tag=tag
+ self.enum_map=enum_map
+ self.attrib_name=attrib_name
+ self.value=None
+ self.text=text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ def findKey(self, value):
+ res=[item[0] for item in self.enum_map.items() if item[1] == value]
+ if res is None or len(res) == 0:
+ return None
+ return res[0]
+
+ def _ConvertElementAttributeToMember(self, attribute, value):
+ # Special logic to use the enum_map to set the value of the object's value member.
+ if attribute == self.attrib_name and value != '':
+ self.value = self.enum_map[value]
+ return
+ # Find the attribute in this class's list of attributes.
+ if self.__class__._attributes.has_key(attribute):
+ # Find the member of this class which corresponds to the XML attribute
+ # (lookup in current_class._attributes) and set this member to the
+ # desired value (using self.__dict__).
+ setattr(self, self.__class__._attributes[attribute], value)
+ else:
+ # The current class doesn't map this attribute, so try to parent class.
+ atom.ExtensionContainer._ConvertElementAttributeToMember(self,
+ attribute,
+ value)
+
+ def _AddMembersToElementTree(self, tree):
+ # Convert the members of this class which are XML child nodes.
+ # This uses the class's _children dictionary to find the members which
+ # should become XML child nodes.
+ member_node_names = [values[0] for tag, values in
+ self.__class__._children.iteritems()]
+ for member_name in member_node_names:
+ member = getattr(self, member_name)
+ if member is None:
+ pass
+ elif isinstance(member, list):
+ for instance in member:
+ instance._BecomeChildElement(tree)
+ else:
+ member._BecomeChildElement(tree)
+ # Special logic to set the desired XML attribute.
+ key = self.findKey(self.value)
+ if key is not None:
+ tree.attrib[self.attrib_name]=key
+ # Convert the members of this class which are XML attributes.
+ for xml_attribute, member_name in self.__class__._attributes.iteritems():
+ member = getattr(self, member_name)
+ if member is not None:
+ tree.attrib[xml_attribute] = member
+ # Lastly, call the parent's _AddMembersToElementTree to get any
+ # extension elements.
+ atom.ExtensionContainer._AddMembersToElementTree(self, tree)
+
+
+
+class AttendeeStatus(UriEnumElement):
+ """The Google Calendar attendeeStatus element"""
+
+ _tag = 'attendeeStatus'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+
+ attendee_enum = {
+ 'http://schemas.google.com/g/2005#event.accepted' : 'ACCEPTED',
+ 'http://schemas.google.com/g/2005#event.declined' : 'DECLINED',
+ 'http://schemas.google.com/g/2005#event.invited' : 'INVITED',
+ 'http://schemas.google.com/g/2005#event.tentative' : 'TENTATIVE'}
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, 'attendeeStatus', AttendeeStatus.attendee_enum,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+class AttendeeType(UriEnumElement):
+ """The Google Calendar attendeeType element"""
+
+ _tag = 'attendeeType'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+
+ attendee_type_enum = {
+ 'http://schemas.google.com/g/2005#event.optional' : 'OPTIONAL',
+ 'http://schemas.google.com/g/2005#event.required' : 'REQUIRED' }
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, 'attendeeType',
+ AttendeeType.attendee_type_enum,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,text=text)
+
+
+class Visibility(UriEnumElement):
+ """The Google Calendar Visibility element"""
+
+ _tag = 'visibility'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+
+ visibility_enum = {
+ 'http://schemas.google.com/g/2005#event.confidential' : 'CONFIDENTIAL',
+ 'http://schemas.google.com/g/2005#event.default' : 'DEFAULT',
+ 'http://schemas.google.com/g/2005#event.private' : 'PRIVATE',
+ 'http://schemas.google.com/g/2005#event.public' : 'PUBLIC' }
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, 'visibility', Visibility.visibility_enum,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+class Transparency(UriEnumElement):
+ """The Google Calendar Transparency element"""
+
+ _tag = 'transparency'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+
+ transparency_enum = {
+ 'http://schemas.google.com/g/2005#event.opaque' : 'OPAQUE',
+ 'http://schemas.google.com/g/2005#event.transparent' : 'TRANSPARENT' }
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, tag='transparency',
+ enum_map=Transparency.transparency_enum,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+class Comments(atom.AtomBase):
+ """The Google Calendar comments element"""
+
+ _tag = 'comments'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feed_link',
+ gdata.FeedLink)
+ _attributes['rel'] = 'rel'
+
+ def __init__(self, rel=None, feed_link=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.rel = rel
+ self.feed_link = feed_link
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class EventStatus(UriEnumElement):
+ """The Google Calendar eventStatus element"""
+
+ _tag = 'eventStatus'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+
+ status_enum = { 'http://schemas.google.com/g/2005#event.canceled' : 'CANCELED',
+ 'http://schemas.google.com/g/2005#event.confirmed' : 'CONFIRMED',
+ 'http://schemas.google.com/g/2005#event.tentative' : 'TENTATIVE'}
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, tag='eventStatus',
+ enum_map=EventStatus.status_enum,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+class Who(UriEnumElement):
+ """The Google Calendar Who element"""
+
+ _tag = 'who'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = UriEnumElement._children.copy()
+ _attributes = UriEnumElement._attributes.copy()
+ _children['{%s}attendeeStatus' % gdata.GDATA_NAMESPACE] = (
+ 'attendee_status', AttendeeStatus)
+ _children['{%s}attendeeType' % gdata.GDATA_NAMESPACE] = ('attendee_type',
+ AttendeeType)
+ _attributes['valueString'] = 'name'
+ _attributes['email'] = 'email'
+
+ relEnum = { 'http://schemas.google.com/g/2005#event.attendee' : 'ATTENDEE',
+ 'http://schemas.google.com/g/2005#event.organizer' : 'ORGANIZER',
+ 'http://schemas.google.com/g/2005#event.performer' : 'PERFORMER',
+ 'http://schemas.google.com/g/2005#event.speaker' : 'SPEAKER',
+ 'http://schemas.google.com/g/2005#message.bcc' : 'BCC',
+ 'http://schemas.google.com/g/2005#message.cc' : 'CC',
+ 'http://schemas.google.com/g/2005#message.from' : 'FROM',
+ 'http://schemas.google.com/g/2005#message.reply-to' : 'REPLY_TO',
+ 'http://schemas.google.com/g/2005#message.to' : 'TO' }
+
+ def __init__(self, name=None, email=None, attendee_status=None,
+ attendee_type=None, rel=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ UriEnumElement.__init__(self, 'who', Who.relEnum, attrib_name='rel',
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+ self.name = name
+ self.email = email
+ self.attendee_status = attendee_status
+ self.attendee_type = attendee_type
+ self.rel = rel
+
+
+class OriginalEvent(atom.AtomBase):
+ """The Google Calendar OriginalEvent element"""
+
+ _tag = 'originalEvent'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ # TODO: The when tag used to map to a EntryLink, make sure it should really be a When.
+ _children['{%s}when' % gdata.GDATA_NAMESPACE] = ('when', When)
+ _attributes['id'] = 'id'
+ _attributes['href'] = 'href'
+
+ def __init__(self, id=None, href=None, when=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ self.id = id
+ self.href = href
+ self.when = when
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def GetCalendarEventEntryClass():
+ return CalendarEventEntry
+
+
+# This class is not completely defined here, because of a circular reference
+# in which CalendarEventEntryLink and CalendarEventEntry refer to one another.
+class CalendarEventEntryLink(gdata.EntryLink):
+ """An entryLink which contains a calendar event entry
+
+ Within an event's recurranceExceptions, an entry link
+ points to a calendar event entry. This class exists
+ to capture the calendar specific extensions in the entry.
+ """
+
+ _tag = 'entryLink'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = gdata.EntryLink._children.copy()
+ _attributes = gdata.EntryLink._attributes.copy()
+ # The CalendarEventEntryLink should like CalendarEventEntry as a child but
+ # that class hasn't been defined yet, so we will wait until after defining
+ # CalendarEventEntry to list it in _children.
+
+
+class RecurrenceException(atom.AtomBase):
+ """The Google Calendar RecurrenceException element"""
+
+ _tag = 'recurrenceException'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}entryLink' % gdata.GDATA_NAMESPACE] = ('entry_link',
+ CalendarEventEntryLink)
+ _children['{%s}originalEvent' % gdata.GDATA_NAMESPACE] = ('original_event',
+ OriginalEvent)
+ _attributes['specialized'] = 'specialized'
+
+ def __init__(self, specialized=None, entry_link=None,
+ original_event=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.specialized = specialized
+ self.entry_link = entry_link
+ self.original_event = original_event
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class SendEventNotifications(atom.AtomBase):
+ """The Google Calendar sendEventNotifications element"""
+
+ _tag = 'sendEventNotifications'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, extension_elements=None,
+ value=None, extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class QuickAdd(atom.AtomBase):
+ """The Google Calendar quickadd element"""
+
+ _tag = 'quickadd'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, extension_elements=None,
+ value=None, extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ def _TransferToElementTree(self, element_tree):
+ if self.value:
+ element_tree.attrib['value'] = self.value
+ element_tree.tag = GCAL_TEMPLATE % 'quickadd'
+ atom.AtomBase._TransferToElementTree(self, element_tree)
+ return element_tree
+
+ def _TakeAttributeFromElementTree(self, attribute, element_tree):
+ if attribute == 'value':
+ self.value = element_tree.attrib[attribute]
+ del element_tree.attrib[attribute]
+ else:
+ atom.AtomBase._TakeAttributeFromElementTree(self, attribute,
+ element_tree)
+
+
+class SyncEvent(atom.AtomBase):
+ _tag = 'syncEvent'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value='false', extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class UID(atom.AtomBase):
+ _tag = 'uid'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Sequence(atom.AtomBase):
+ _tag = 'sequence'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class WebContentGadgetPref(atom.AtomBase):
+
+ _tag = 'webContentGadgetPref'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+ _attributes['value'] = 'value'
+
+ """The Google Calendar Web Content Gadget Preferences element"""
+
+ def __init__(self, name=None, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class WebContent(atom.AtomBase):
+
+ _tag = 'webContent'
+ _namespace = GCAL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}webContentGadgetPref' % GCAL_NAMESPACE] = ('gadget_pref',
+ [WebContentGadgetPref])
+ _attributes['url'] = 'url'
+ _attributes['width'] = 'width'
+ _attributes['height'] = 'height'
+
+ def __init__(self, url=None, width=None, height=None, text=None,
+ gadget_pref=None, extension_elements=None, extension_attributes=None):
+ self.url = url
+ self.width = width
+ self.height = height
+ self.text = text
+ self.gadget_pref = gadget_pref or []
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class WebContentLink(atom.Link):
+
+ _tag = 'link'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = atom.Link._children.copy()
+ _attributes = atom.Link._attributes.copy()
+ _children['{%s}webContent' % GCAL_NAMESPACE] = ('web_content', WebContent)
+
+ def __init__(self, title=None, href=None, link_type=None,
+ web_content=None):
+ atom.Link.__init__(self, rel=WEB_CONTENT_LINK_REL, title=title, href=href,
+ link_type=link_type)
+ self.web_content = web_content
+
+
+class GuestsCanInviteOthers(atom.AtomBase):
+ """Indicates whether event attendees may invite others to the event.
+
+ This element may only be changed by the organizer of the event. If not
+ included as part of the event entry, this element will default to true
+ during a POST request, and will inherit its previous value during a PUT
+ request.
+ """
+ _tag = 'guestsCanInviteOthers'
+ _namespace = GCAL_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value='true', *args, **kwargs):
+ atom.AtomBase.__init__(self, *args, **kwargs)
+ self.value = value
+
+
+class GuestsCanSeeGuests(atom.AtomBase):
+ """Indicates whether attendees can see other people invited to the event.
+
+ The organizer always sees all attendees. Guests always see themselves. This
+ property affects what attendees see in the event's guest list via both the
+ Calendar UI and API feeds.
+
+ This element may only be changed by the organizer of the event.
+
+ If not included as part of the event entry, this element will default to
+ true during a POST request, and will inherit its previous value during a
+ PUT request.
+ """
+ _tag = 'guestsCanSeeGuests'
+ _namespace = GCAL_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value='true', *args, **kwargs):
+ atom.AtomBase.__init__(self, *args, **kwargs)
+ self.value = value
+
+
+class GuestsCanModify(atom.AtomBase):
+ """Indicates whether event attendees may modify the original event.
+
+ If yes, changes are visible to organizer and other attendees. Otherwise,
+ any changes made by attendees will be restricted to that attendee's
+ calendar.
+
+ This element may only be changed by the organizer of the event, and may
+ be set to 'true' only if both gCal:guestsCanInviteOthers and
+ gCal:guestsCanSeeGuests are set to true in the same PUT/POST request.
+ Otherwise, request fails with HTTP error code 400 (Bad Request).
+
+ If not included as part of the event entry, this element will default to
+ false during a POST request, and will inherit its previous value during a
+ PUT request."""
+ _tag = 'guestsCanModify'
+ _namespace = GCAL_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value='false', *args, **kwargs):
+ atom.AtomBase.__init__(self, *args, **kwargs)
+ self.value = value
+
+
+
+class CalendarEventEntry(gdata.BatchEntry):
+ """A Google Calendar flavor of an Atom Entry """
+
+ _tag = gdata.BatchEntry._tag
+ _namespace = gdata.BatchEntry._namespace
+ _children = gdata.BatchEntry._children.copy()
+ _attributes = gdata.BatchEntry._attributes.copy()
+ # This class also contains WebContentLinks but converting those members
+ # is handled in a special version of _ConvertElementTreeToMember.
+ _children['{%s}where' % gdata.GDATA_NAMESPACE] = ('where', [Where])
+ _children['{%s}when' % gdata.GDATA_NAMESPACE] = ('when', [When])
+ _children['{%s}who' % gdata.GDATA_NAMESPACE] = ('who', [Who])
+ _children['{%s}extendedProperty' % gdata.GDATA_NAMESPACE] = (
+ 'extended_property', [ExtendedProperty])
+ _children['{%s}visibility' % gdata.GDATA_NAMESPACE] = ('visibility',
+ Visibility)
+ _children['{%s}transparency' % gdata.GDATA_NAMESPACE] = ('transparency',
+ Transparency)
+ _children['{%s}eventStatus' % gdata.GDATA_NAMESPACE] = ('event_status',
+ EventStatus)
+ _children['{%s}recurrence' % gdata.GDATA_NAMESPACE] = ('recurrence',
+ Recurrence)
+ _children['{%s}recurrenceException' % gdata.GDATA_NAMESPACE] = (
+ 'recurrence_exception', [RecurrenceException])
+ _children['{%s}sendEventNotifications' % GCAL_NAMESPACE] = (
+ 'send_event_notifications', SendEventNotifications)
+ _children['{%s}quickadd' % GCAL_NAMESPACE] = ('quick_add', QuickAdd)
+ _children['{%s}comments' % gdata.GDATA_NAMESPACE] = ('comments', Comments)
+ _children['{%s}originalEvent' % gdata.GDATA_NAMESPACE] = ('original_event',
+ OriginalEvent)
+ _children['{%s}sequence' % GCAL_NAMESPACE] = ('sequence', Sequence)
+ _children['{%s}reminder' % gdata.GDATA_NAMESPACE] = ('reminder', [Reminder])
+ _children['{%s}syncEvent' % GCAL_NAMESPACE] = ('sync_event', SyncEvent)
+ _children['{%s}uid' % GCAL_NAMESPACE] = ('uid', UID)
+ _children['{%s}guestsCanInviteOthers' % GCAL_NAMESPACE] = (
+ 'guests_can_invite_others', GuestsCanInviteOthers)
+ _children['{%s}guestsCanModify' % GCAL_NAMESPACE] = (
+ 'guests_can_modify', GuestsCanModify)
+ _children['{%s}guestsCanSeeGuests' % GCAL_NAMESPACE] = (
+ 'guests_can_see_guests', GuestsCanSeeGuests)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ transparency=None, comments=None, event_status=None,
+ send_event_notifications=None, visibility=None,
+ recurrence=None, recurrence_exception=None,
+ where=None, when=None, who=None, quick_add=None,
+ extended_property=None, original_event=None,
+ batch_operation=None, batch_id=None, batch_status=None,
+ sequence=None, reminder=None, sync_event=None, uid=None,
+ guests_can_invite_others=None, guests_can_modify=None,
+ guests_can_see_guests=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.BatchEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ batch_operation=batch_operation, batch_id=batch_id,
+ batch_status=batch_status,
+ title=title, updated=updated)
+
+ self.transparency = transparency
+ self.comments = comments
+ self.event_status = event_status
+ self.send_event_notifications = send_event_notifications
+ self.visibility = visibility
+ self.recurrence = recurrence
+ self.recurrence_exception = recurrence_exception or []
+ self.where = where or []
+ self.when = when or []
+ self.who = who or []
+ self.quick_add = quick_add
+ self.extended_property = extended_property or []
+ self.original_event = original_event
+ self.sequence = sequence
+ self.reminder = reminder or []
+ self.sync_event = sync_event
+ self.uid = uid
+ self.text = text
+ self.guests_can_invite_others = guests_can_invite_others
+ self.guests_can_modify = guests_can_modify
+ self.guests_can_see_guests = guests_can_see_guests
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ # We needed to add special logic to _ConvertElementTreeToMember because we
+ # want to make links with a rel of WEB_CONTENT_LINK_REL into a
+ # WebContentLink
+ def _ConvertElementTreeToMember(self, child_tree):
+ # Special logic to handle Web Content links
+ if (child_tree.tag == '{%s}link' % atom.ATOM_NAMESPACE and
+ child_tree.attrib['rel'] == WEB_CONTENT_LINK_REL):
+ if self.link is None:
+ self.link = []
+ self.link.append(atom._CreateClassFromElementTree(WebContentLink,
+ child_tree))
+ return
+ # Find the element's tag in this class's list of child members
+ if self.__class__._children.has_key(child_tree.tag):
+ member_name = self.__class__._children[child_tree.tag][0]
+ member_class = self.__class__._children[child_tree.tag][1]
+ # If the class member is supposed to contain a list, make sure the
+ # matching member is set to a list, then append the new member
+ # instance to the list.
+ if isinstance(member_class, list):
+ if getattr(self, member_name) is None:
+ setattr(self, member_name, [])
+ getattr(self, member_name).append(atom._CreateClassFromElementTree(
+ member_class[0], child_tree))
+ else:
+ setattr(self, member_name,
+ atom._CreateClassFromElementTree(member_class, child_tree))
+ else:
+ atom.ExtensionContainer._ConvertElementTreeToMember(self, child_tree)
+
+
+ def GetWebContentLink(self):
+ """Finds the first link with rel set to WEB_CONTENT_REL
+
+ Returns:
+ A gdata.calendar.WebContentLink or none if none of the links had rel
+ equal to WEB_CONTENT_REL
+ """
+
+ for a_link in self.link:
+ if a_link.rel == WEB_CONTENT_LINK_REL:
+ return a_link
+ return None
+
+
+def CalendarEventEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarEventEntry, xml_string)
+
+
+def CalendarEventCommentEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarEventCommentEntry, xml_string)
+
+
+CalendarEventEntryLink._children = {'{%s}entry' % atom.ATOM_NAMESPACE:
+ ('entry', CalendarEventEntry)}
+
+
+def CalendarEventEntryLinkFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarEventEntryLink, xml_string)
+
+
+class CalendarEventFeed(gdata.BatchFeed, gdata.LinkFinder):
+ """A Google Calendar event feed flavor of an Atom Feed"""
+
+ _tag = gdata.BatchFeed._tag
+ _namespace = gdata.BatchFeed._namespace
+ _children = gdata.BatchFeed._children.copy()
+ _attributes = gdata.BatchFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [CalendarEventEntry])
+ _children['{%s}timezone' % GCAL_NAMESPACE] = ('timezone', Timezone)
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None, entry=None,
+ total_results=None, start_index=None, items_per_page=None,
+ interrupted=None, timezone=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ gdata.BatchFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ interrupted=interrupted,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+ self.timezone = timezone
+
+
+def CalendarListEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarListEntry, xml_string)
+
+
+def CalendarAclEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarAclEntry, xml_string)
+
+
+def CalendarListFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarListFeed, xml_string)
+
+
+def CalendarAclFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarAclFeed, xml_string)
+
+
+def CalendarEventFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarEventFeed, xml_string)
+
+
+def CalendarEventCommentFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(CalendarEventCommentFeed, xml_string)
diff --git a/src/gdata/calendar/client.py b/src/gdata/calendar/client.py
new file mode 100755
index 0000000..414338d
--- /dev/null
+++ b/src/gdata/calendar/client.py
@@ -0,0 +1,538 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2011 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""CalendarClient extends the GDataService to streamline Google Calendar operations.
+
+ CalendarService: Provides methods to query feeds and manipulate items. Extends
+ GDataService.
+
+ DictionaryToParamList: Function which converts a dictionary into a list of
+ URL arguments (represented as strings). This is a
+ utility function used in CRUD operations.
+"""
+
+
+__author__ = 'alainv (Alain Vongsouvanh)'
+
+
+import urllib
+import gdata.client
+import gdata.calendar.data
+import atom.data
+import atom.http_core
+import gdata.gauth
+
+
+DEFAULT_BATCH_URL = ('https://www.google.com/calendar/feeds/default/private'
+ '/full/batch')
+
+
+class CalendarClient(gdata.client.GDClient):
+ """Client for the Google Calendar service."""
+ api_version = '2'
+ auth_service = 'cl'
+ server = "www.google.com"
+ contact_list = "default"
+ auth_scopes = gdata.gauth.AUTH_SCOPES['cl']
+
+ def __init__(self, domain=None, auth_token=None, **kwargs):
+ """Constructs a new client for the Calendar API.
+
+ Args:
+ domain: string The Google Apps domain (if any).
+ kwargs: The other parameters to pass to the gdata.client.GDClient
+ constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def get_calendar_feed_uri(self, feed='', projection='full', scheme="https"):
+ """Builds a feed URI.
+
+ Args:
+ projection: The projection to apply to the feed contents, for example
+ 'full', 'base', 'base/12345', 'full/batch'. Default value: 'full'.
+ scheme: The URL scheme such as 'http' or 'https', None to return a
+ relative URI without hostname.
+
+ Returns:
+ A feed URI using the given scheme and projection.
+ Example: '/calendar/feeds/default/owncalendars/full'.
+ """
+ prefix = scheme and '%s://%s' % (scheme, self.server) or ''
+ suffix = feed and '/%s/%s' % (feed, projection) or ''
+ return '%s/calendar/feeds/default%s' % (prefix, suffix)
+
+ GetCalendarFeedUri = get_calendar_feed_uri
+
+ def get_calendar_event_feed_uri(self, calendar='default', visibility='private',
+ projection='full', scheme="https"):
+ """Builds a feed URI.
+
+ Args:
+ projection: The projection to apply to the feed contents, for example
+ 'full', 'base', 'base/12345', 'full/batch'. Default value: 'full'.
+ scheme: The URL scheme such as 'http' or 'https', None to return a
+ relative URI without hostname.
+
+ Returns:
+ A feed URI using the given scheme and projection.
+ Example: '/calendar/feeds/default/private/full'.
+ """
+ prefix = scheme and '%s://%s' % (scheme, self.server) or ''
+ return '%s/calendar/feeds/%s/%s/%s' % (prefix, calendar,
+ visibility, projection)
+
+ GetCalendarEventFeedUri = get_calendar_event_feed_uri
+
+ def get_calendars_feed(self, uri,
+ desired_class=gdata.calendar.data.CalendarFeed,
+ auth_token=None, **kwargs):
+ """Obtains a calendar feed.
+
+ Args:
+ uri: The uri of the calendar feed to request.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_feed(uri, auth_token=auth_token,
+ desired_class=desired_class, **kwargs)
+
+ GetCalendarsFeed = get_calendars_feed
+
+ def get_own_calendars_feed(self,
+ desired_class=gdata.calendar.data.CalendarFeed,
+ auth_token=None, **kwargs):
+ """Obtains a feed containing the calendars owned by the current user.
+
+ Args:
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.GetCalendarsFeed(uri=self.GetCalendarFeedUri(feed='owncalendars'),
+ desired_class=desired_class, auth_token=auth_token,
+ **kwargs)
+
+ GetOwnCalendarsFeed = get_own_calendars_feed
+
+ def get_all_calendars_feed(self, desired_class=gdata.calendar.data.CalendarFeed,
+ auth_token=None, **kwargs):
+ """Obtains a feed containing all the ccalendars the current user has access to.
+
+ Args:
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.GetCalendarsFeed(uri=self.GetCalendarFeedUri(feed='allcalendars'),
+ desired_class=desired_class, auth_token=auth_token,
+ **kwargs)
+
+ GetAllCalendarsFeed = get_all_calendars_feed
+
+ def get_calendar_entry(self, uri, desired_class=gdata.calendar.data.CalendarEntry,
+ auth_token=None, **kwargs):
+ """Obtains a single calendar entry.
+
+ Args:
+ uri: The uri of the desired calendar entry.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarEntry.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_entry(uri, auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetCalendarEntry = get_calendar_entry
+
+ def get_calendar_event_feed(self, uri=None,
+ desired_class=gdata.calendar.data.CalendarEventFeed,
+ auth_token=None, **kwargs):
+ """Obtains a feed of events for the desired calendar.
+
+ Args:
+ uri: The uri of the desired calendar entry.
+ Defaults to https://www.google.com/calendar/feeds/default/private/full.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarEventFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ uri = uri or self.GetCalendarEventFeedUri()
+ return self.get_feed(uri, auth_token=auth_token,
+ desired_class=desired_class, **kwargs)
+
+ GetCalendarEventFeed = get_calendar_event_feed
+
+ def get_event_entry(self, uri, desired_class=gdata.calendar.data.CalendarEventEntry,
+ auth_token=None, **kwargs):
+ """Obtains a single event entry.
+
+ Args:
+ uri: The uri of the desired calendar event entry.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarEventEntry.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_entry(uri, auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetEventEntry = get_event_entry
+
+ def get_calendar_acl_feed(self, uri='https://www.google.com/calendar/feeds/default/acl/full',
+ desired_class=gdata.calendar.data.CalendarAclFeed,
+ auth_token=None, **kwargs):
+ """Obtains an Access Control List feed.
+
+ Args:
+ uri: The uri of the desired Acl feed.
+ Defaults to https://www.google.com/calendar/feeds/default/acl/full.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarAclFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_feed(uri, auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetCalendarAclFeed = get_calendar_acl_feed
+
+ def get_calendar_acl_entry(self, uri, desired_class=gdata.calendar.data.CalendarAclEntry,
+ auth_token=None, **kwargs):
+ """Obtains a single Access Control List entry.
+
+ Args:
+ uri: The uri of the desired Acl feed.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.calendar.data.CalendarAclEntry.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_entry(uri, auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetCalendarAclEntry = get_calendar_acl_entry
+
+ def insert_calendar(self, new_calendar, insert_uri=None, auth_token=None, **kwargs):
+ """Adds an new calendar to Google Calendar.
+
+ Args:
+ new_calendar: atom.Entry or subclass A new calendar which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new contacts to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the contact created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ insert_uri = insert_uri or self.GetCalendarFeedUri(feed='owncalendars')
+ return self.Post(new_calendar, insert_uri,
+ auth_token=auth_token, **kwargs)
+
+ InsertCalendar = insert_calendar
+
+ def insert_calendar_subscription(self, calendar, insert_uri=None,
+ auth_token=None, **kwargs):
+ """Subscribes the authenticated user to the provided calendar.
+
+ Args:
+ calendar: The calendar to which the user should be subscribed.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the subscription created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ insert_uri = insert_uri or self.GetCalendarFeedUri(feed='allcalendars')
+ return self.Post(calendar, insert_uri, auth_token=auth_token, **kwargs)
+
+ InsertCalendarSubscription = insert_calendar_subscription
+
+ def insert_event(self, new_event, insert_uri=None, auth_token=None, **kwargs):
+ """Adds an new event to Google Calendar.
+
+ Args:
+ new_event: atom.Entry or subclass A new event which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new contacts to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the contact created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ insert_uri = insert_uri or self.GetCalendarEventFeedUri()
+ return self.Post(new_event, insert_uri,
+ auth_token=auth_token, **kwargs)
+
+
+ InsertEvent = insert_event
+
+ def insert_acl_entry(self, new_acl_entry,
+ insert_uri = 'https://www.google.com/calendar/feeds/default/acl/full',
+ auth_token=None, **kwargs):
+ """Adds an new Acl entry to Google Calendar.
+
+ Args:
+ new_acl_event: atom.Entry or subclass A new acl which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new contacts to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the contact created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ return self.Post(new_acl_entry, insert_uri, auth_token=auth_token, **kwargs)
+
+ InsertAclEntry = insert_acl_entry
+
+ def execute_batch(self, batch_feed, url, desired_class=None):
+ """Sends a batch request feed to the server.
+
+ Args:
+ batch_feed: gdata.contacts.CalendarEventFeed A feed containing batch
+ request entries. Each entry contains the operation to be performed
+ on the data contained in the entry. For example an entry with an
+ operation type of insert will be used as if the individual entry
+ had been inserted.
+ url: str The batch URL to which these operations should be applied.
+ converter: Function (optional) The function used to convert the server's
+ response to an object.
+
+ Returns:
+ The results of the batch request's execution on the server. If the
+ default converter is used, this is stored in a ContactsFeed.
+ """
+ return self.Post(batch_feed, url, desired_class=desired_class)
+
+ ExecuteBatch = execute_batch
+
+ def update(self, entry, auth_token=None, **kwargs):
+ """Edits the entry on the server by sending the XML for this entry.
+
+ Performs a PUT and converts the response to a new entry object with a
+ matching class to the entry passed in.
+
+ Args:
+ entry:
+ auth_token:
+
+ Returns:
+ A new Entry object of a matching type to the entry which was passed in.
+ """
+ return gdata.client.GDClient.Update(self, entry, auth_token=auth_token,
+ force=True, **kwargs)
+
+ Update = update
+
+
+class CalendarEventQuery(gdata.client.Query):
+ """
+ Create a custom Calendar Query
+
+ Full specs can be found at: U{Calendar query parameters reference
+ <http://code.google.com/apis/calendar/data/2.0/reference.html#Parameters>}
+ """
+
+ def __init__(self, feed=None, ctz=None, fields=None, futureevents=None,
+ max_attendees=None, orderby=None, recurrence_expansion_start=None,
+ recurrence_expansion_end=None, singleevents=None, showdeleted=None,
+ showhidden=None, sortorder=None, start_min=None, start_max=None,
+ updated_min=None, **kwargs):
+ """
+ @param max_results: The maximum number of entries to return. If you want
+ to receive all of the contacts, rather than only the default maximum, you
+ can specify a very large number for max-results.
+ @param start-index: The 1-based index of the first result to be retrieved.
+ @param updated-min: The lower bound on entry update dates.
+ @param group: Constrains the results to only the contacts belonging to the
+ group specified. Value of this parameter specifies group ID
+ @param orderby: Sorting criterion. The only supported value is
+ lastmodified.
+ @param showdeleted: Include deleted contacts in the returned contacts feed
+ @pram sortorder: Sorting order direction. Can be either ascending or
+ descending.
+ @param requirealldeleted: Only relevant if showdeleted and updated-min
+ are also provided. It dictates the behavior of the server in case it
+ detects that placeholders of some entries deleted since the point in
+ time specified as updated-min may have been lost.
+ """
+ gdata.client.Query.__init__(self, **kwargs)
+ self.ctz = ctz
+ self.fields = fields
+ self.futureevents = futureevents
+ self.max_attendees = max_attendees
+ self.orderby = orderby
+ self.recurrence_expansion_start = recurrence_expansion_start
+ self.recurrence_expansion_end = recurrence_expansion_end
+ self.singleevents = singleevents
+ self.showdeleted = showdeleted
+ self.showhidden = showhidden
+ self.sortorder = sortorder
+ self.start_min = start_min
+ self.start_max = start_max
+ self.updated_min = updated_min
+
+ def modify_request(self, http_request):
+ if self.ctz:
+ gdata.client._add_query_param('ctz', self.ctz, http_request)
+ if self.fields:
+ gdata.client._add_query_param('fields', self.fields, http_request)
+ if self.futureevents:
+ gdata.client._add_query_param('futureevents', self.futureevents, http_request)
+ if self.max_attendees:
+ gdata.client._add_query_param('max-attendees', self.max_attendees, http_request)
+ if self.orderby:
+ gdata.client._add_query_param('orderby', self.orderby, http_request)
+ if self.recurrence_expansion_start:
+ gdata.client._add_query_param('recurrence-expansion-start',
+ self.recurrence_expansion_start, http_request)
+ if self.recurrence_expansion_end:
+ gdata.client._add_query_param('recurrence-expansion-end',
+ self.recurrence_expansion_end, http_request)
+ if self.singleevents:
+ gdata.client._add_query_param('singleevents', self.singleevents, http_request)
+ if self.showdeleted:
+ gdata.client._add_query_param('showdeleted', self.showdeleted, http_request)
+ if self.showhidden:
+ gdata.client._add_query_param('showhidden', self.showhidden, http_request)
+ if self.sortorder:
+ gdata.client._add_query_param('sortorder', self.sortorder, http_request)
+ if self.start_min:
+ gdata.client._add_query_param('start-min', self.start_min, http_request)
+ if self.start_max:
+ gdata.client._add_query_param('start-max', self.start_max, http_request)
+ if self.updated_min:
+ gdata.client._add_query_param('updated-min', self.updated_min, http_request)
+ gdata.client.Query.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
+
+
+
diff --git a/src/gdata/calendar/data.py b/src/gdata/calendar/data.py
new file mode 100644
index 0000000..0a0235e
--- /dev/null
+++ b/src/gdata/calendar/data.py
@@ -0,0 +1,327 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains the data classes of the Google Calendar Data API"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+import atom.data
+import gdata.acl.data
+import gdata.data
+import gdata.geo.data
+import gdata.opensearch.data
+
+
+GCAL_NAMESPACE = 'http://schemas.google.com/gCal/2005'
+GCAL_TEMPLATE = '{%s}%%s' % GCAL_NAMESPACE
+WEB_CONTENT_LINK_REL = '%s/%s' % (GCAL_NAMESPACE, 'webContent')
+
+
+class AccessLevelProperty(atom.core.XmlElement):
+ """Describes how much a given user may do with an event or calendar"""
+ _qname = GCAL_TEMPLATE % 'accesslevel'
+ value = 'value'
+
+
+class AllowGSync2Property(atom.core.XmlElement):
+ """Whether the user is permitted to run Google Apps Sync"""
+ _qname = GCAL_TEMPLATE % 'allowGSync2'
+ value = 'value'
+
+
+class AllowGSyncProperty(atom.core.XmlElement):
+ """Whether the user is permitted to run Google Apps Sync"""
+ _qname = GCAL_TEMPLATE % 'allowGSync'
+ value = 'value'
+
+
+class AnyoneCanAddSelfProperty(atom.core.XmlElement):
+ """Whether anyone can add self as attendee"""
+ _qname = GCAL_TEMPLATE % 'anyoneCanAddSelf'
+ value = 'value'
+
+
+class CalendarAclRole(gdata.acl.data.AclRole):
+ """Describes the Calendar roles of an entry in the Calendar access control list"""
+ _qname = gdata.acl.data.GACL_TEMPLATE % 'role'
+
+
+class CalendarCommentEntry(gdata.data.GDEntry):
+ """Describes an entry in a feed of a Calendar event's comments"""
+
+
+class CalendarCommentFeed(gdata.data.GDFeed):
+ """Describes feed of a Calendar event's comments"""
+ entry = [CalendarCommentEntry]
+
+
+class CalendarComments(gdata.data.Comments):
+ """Describes a container of a feed link for Calendar comment entries"""
+ _qname = gdata.data.GD_TEMPLATE % 'comments'
+
+
+class CalendarExtendedProperty(gdata.data.ExtendedProperty):
+ """Defines a value for the realm attribute that is used only in the calendar API"""
+ _qname = gdata.data.GD_TEMPLATE % 'extendedProperty'
+
+
+class CalendarWhere(gdata.data.Where):
+ """Extends the base Where class with Calendar extensions"""
+ _qname = gdata.data.GD_TEMPLATE % 'where'
+
+
+class ColorProperty(atom.core.XmlElement):
+ """Describes the color of a calendar"""
+ _qname = GCAL_TEMPLATE % 'color'
+ value = 'value'
+
+
+class GuestsCanInviteOthersProperty(atom.core.XmlElement):
+ """Whether guests can invite others to the event"""
+ _qname = GCAL_TEMPLATE % 'guestsCanInviteOthers'
+ value = 'value'
+
+
+class GuestsCanModifyProperty(atom.core.XmlElement):
+ """Whether guests can modify event"""
+ _qname = GCAL_TEMPLATE % 'guestsCanModify'
+ value = 'value'
+
+
+class GuestsCanSeeGuestsProperty(atom.core.XmlElement):
+ """Whether guests can see other attendees"""
+ _qname = GCAL_TEMPLATE % 'guestsCanSeeGuests'
+ value = 'value'
+
+
+class HiddenProperty(atom.core.XmlElement):
+ """Describes whether a calendar is hidden"""
+ _qname = GCAL_TEMPLATE % 'hidden'
+ value = 'value'
+
+
+class IcalUIDProperty(atom.core.XmlElement):
+ """Describes the UID in the ical export of the event"""
+ _qname = GCAL_TEMPLATE % 'uid'
+ value = 'value'
+
+
+class OverrideNameProperty(atom.core.XmlElement):
+ """Describes the override name property of a calendar"""
+ _qname = GCAL_TEMPLATE % 'overridename'
+ value = 'value'
+
+
+class PrivateCopyProperty(atom.core.XmlElement):
+ """Indicates whether this is a private copy of the event, changes to which should not be sent to other calendars"""
+ _qname = GCAL_TEMPLATE % 'privateCopy'
+ value = 'value'
+
+
+class QuickAddProperty(atom.core.XmlElement):
+ """Describes whether gd:content is for quick-add processing"""
+ _qname = GCAL_TEMPLATE % 'quickadd'
+ value = 'value'
+
+
+class ResourceProperty(atom.core.XmlElement):
+ """Describes whether gd:who is a resource such as a conference room"""
+ _qname = GCAL_TEMPLATE % 'resource'
+ value = 'value'
+ id = 'id'
+
+
+class EventWho(gdata.data.Who):
+ """Extends the base Who class with Calendar extensions"""
+ _qname = gdata.data.GD_TEMPLATE % 'who'
+ resource = ResourceProperty
+
+
+class SelectedProperty(atom.core.XmlElement):
+ """Describes whether a calendar is selected"""
+ _qname = GCAL_TEMPLATE % 'selected'
+ value = 'value'
+
+
+class SendAclNotificationsProperty(atom.core.XmlElement):
+ """Describes whether to send ACL notifications to grantees"""
+ _qname = GCAL_TEMPLATE % 'sendAclNotifications'
+ value = 'value'
+
+
+class CalendarAclEntry(gdata.acl.data.AclEntry):
+ """Describes an entry in a feed of a Calendar access control list (ACL)"""
+ send_acl_notifications = SendAclNotificationsProperty
+
+
+class CalendarAclFeed(gdata.data.GDFeed):
+ """Describes a Calendar access contorl list (ACL) feed"""
+ entry = [CalendarAclEntry]
+
+
+class SendEventNotificationsProperty(atom.core.XmlElement):
+ """Describes whether to send event notifications to other participants of the event"""
+ _qname = GCAL_TEMPLATE % 'sendEventNotifications'
+ value = 'value'
+
+
+class SequenceNumberProperty(atom.core.XmlElement):
+ """Describes sequence number of an event"""
+ _qname = GCAL_TEMPLATE % 'sequence'
+ value = 'value'
+
+
+class CalendarRecurrenceExceptionEntry(gdata.data.GDEntry):
+ """Describes an entry used by a Calendar recurrence exception entry link"""
+ uid = IcalUIDProperty
+ sequence = SequenceNumberProperty
+
+
+class CalendarRecurrenceException(gdata.data.RecurrenceException):
+ """Describes an exception to a recurring Calendar event"""
+ _qname = gdata.data.GD_TEMPLATE % 'recurrenceException'
+
+
+class SettingsProperty(atom.core.XmlElement):
+ """User preference name-value pair"""
+ _qname = GCAL_TEMPLATE % 'settingsProperty'
+ name = 'name'
+ value = 'value'
+
+
+class SettingsEntry(gdata.data.GDEntry):
+ """Describes a Calendar Settings property entry"""
+ settings_property = SettingsProperty
+
+
+class CalendarSettingsFeed(gdata.data.GDFeed):
+ """Personal settings for Calendar application"""
+ entry = [SettingsEntry]
+
+
+class SuppressReplyNotificationsProperty(atom.core.XmlElement):
+ """Lists notification methods to be suppressed for this reply"""
+ _qname = GCAL_TEMPLATE % 'suppressReplyNotifications'
+ methods = 'methods'
+
+
+class SyncEventProperty(atom.core.XmlElement):
+ """Describes whether this is a sync scenario where the Ical UID and Sequence number are honored during inserts and updates"""
+ _qname = GCAL_TEMPLATE % 'syncEvent'
+ value = 'value'
+
+
+class When(gdata.data.When):
+ """Extends the gd:when element to add reminders"""
+ reminder = [gdata.data.Reminder]
+
+
+class CalendarEventEntry(gdata.data.BatchEntry):
+ """Describes a Calendar event entry"""
+ quick_add = QuickAddProperty
+ send_event_notifications = SendEventNotificationsProperty
+ sync_event = SyncEventProperty
+ anyone_can_add_self = AnyoneCanAddSelfProperty
+ extended_property = [CalendarExtendedProperty]
+ sequence = SequenceNumberProperty
+ guests_can_invite_others = GuestsCanInviteOthersProperty
+ guests_can_modify = GuestsCanModifyProperty
+ guests_can_see_guests = GuestsCanSeeGuestsProperty
+ georss_where = gdata.geo.data.GeoRssWhere
+ private_copy = PrivateCopyProperty
+ suppress_reply_notifications = SuppressReplyNotificationsProperty
+ uid = IcalUIDProperty
+ where = [gdata.data.Where]
+ when = [When]
+ who = [gdata.data.Who]
+ transparency = gdata.data.Transparency
+ comments = gdata.data.Comments
+ event_status = gdata.data.EventStatus
+ visibility = gdata.data.Visibility
+ recurrence = gdata.data.Recurrence
+ recurrence_exception = [gdata.data.RecurrenceException]
+ original_event = gdata.data.OriginalEvent
+ reminder = [gdata.data.Reminder]
+
+
+class TimeZoneProperty(atom.core.XmlElement):
+ """Describes the time zone of a calendar"""
+ _qname = GCAL_TEMPLATE % 'timezone'
+ value = 'value'
+
+
+class TimesCleanedProperty(atom.core.XmlElement):
+ """Describes how many times calendar was cleaned via Manage Calendars"""
+ _qname = GCAL_TEMPLATE % 'timesCleaned'
+ value = 'value'
+
+
+class CalendarEntry(gdata.data.GDEntry):
+ """Describes a Calendar entry in the feed of a user's calendars"""
+ timezone = TimeZoneProperty
+ overridename = OverrideNameProperty
+ hidden = HiddenProperty
+ selected = SelectedProperty
+ times_cleaned = TimesCleanedProperty
+ color = ColorProperty
+ where = [CalendarWhere]
+ accesslevel = AccessLevelProperty
+
+
+class CalendarEventFeed(gdata.data.BatchFeed):
+ """Describes a Calendar event feed"""
+ allow_g_sync2 = AllowGSync2Property
+ timezone = TimeZoneProperty
+ entry = [CalendarEventEntry]
+ times_cleaned = TimesCleanedProperty
+ allow_g_sync = AllowGSyncProperty
+
+
+class CalendarFeed(gdata.data.GDFeed):
+ """Describes a feed of Calendars"""
+ entry = [CalendarEntry]
+
+
+class WebContentGadgetPref(atom.core.XmlElement):
+ """Describes a single web content gadget preference"""
+ _qname = GCAL_TEMPLATE % 'webContentGadgetPref'
+ name = 'name'
+ value = 'value'
+
+
+class WebContent(atom.core.XmlElement):
+ """Describes a "web content" extension"""
+ _qname = GCAL_TEMPLATE % 'webContent'
+ height = 'height'
+ width = 'width'
+ web_content_gadget_pref = [WebContentGadgetPref]
+ url = 'url'
+ display = 'display'
+
+
+class WebContentLink(atom.data.Link):
+ """Describes a "web content" link"""
+ def __init__(self, title=None, href=None, link_type=None,
+ web_content=None):
+ atom.data.Link.__init__(self, rel=WEB_CONTENT_LINK_REL, title=title, href=href,
+ link_type=link_type)
+
+ web_content = WebContent
+
diff --git a/src/gdata/calendar/service.py b/src/gdata/calendar/service.py
new file mode 100755
index 0000000..53a94e3
--- /dev/null
+++ b/src/gdata/calendar/service.py
@@ -0,0 +1,595 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""CalendarService extends the GDataService to streamline Google Calendar operations.
+
+ CalendarService: Provides methods to query feeds and manipulate items. Extends
+ GDataService.
+
+ DictionaryToParamList: Function which converts a dictionary into a list of
+ URL arguments (represented as strings). This is a
+ utility function used in CRUD operations.
+"""
+
+
+__author__ = 'api.vli (Vivian Li)'
+
+
+import urllib
+import gdata
+import atom.service
+import gdata.service
+import gdata.calendar
+import atom
+
+
+DEFAULT_BATCH_URL = ('http://www.google.com/calendar/feeds/default/private'
+ '/full/batch')
+
+
+class Error(Exception):
+ pass
+
+
+class RequestError(Error):
+ pass
+
+
+class CalendarService(gdata.service.GDataService):
+ """Client for the Google Calendar service."""
+
+ def __init__(self, email=None, password=None, source=None,
+ server='www.google.com', additional_headers=None, **kwargs):
+ """Creates a client for the Google Calendar service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'www.google.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='cl', source=source,
+ server=server, additional_headers=additional_headers, **kwargs)
+
+ def GetCalendarEventFeed(self, uri='/calendar/feeds/default/private/full'):
+ return self.Get(uri, converter=gdata.calendar.CalendarEventFeedFromString)
+
+ def GetCalendarEventEntry(self, uri):
+ return self.Get(uri, converter=gdata.calendar.CalendarEventEntryFromString)
+
+ def GetCalendarListFeed(self, uri='/calendar/feeds/default/allcalendars/full'):
+ return self.Get(uri, converter=gdata.calendar.CalendarListFeedFromString)
+
+ def GetAllCalendarsFeed(self, uri='/calendar/feeds/default/allcalendars/full'):
+ return self.Get(uri, converter=gdata.calendar.CalendarListFeedFromString)
+
+ def GetOwnCalendarsFeed(self, uri='/calendar/feeds/default/owncalendars/full'):
+ return self.Get(uri, converter=gdata.calendar.CalendarListFeedFromString)
+
+ def GetCalendarListEntry(self, uri):
+ return self.Get(uri, converter=gdata.calendar.CalendarListEntryFromString)
+
+ def GetCalendarAclFeed(self, uri='/calendar/feeds/default/acl/full'):
+ return self.Get(uri, converter=gdata.calendar.CalendarAclFeedFromString)
+
+ def GetCalendarAclEntry(self, uri):
+ return self.Get(uri, converter=gdata.calendar.CalendarAclEntryFromString)
+
+ def GetCalendarEventCommentFeed(self, uri):
+ return self.Get(uri, converter=gdata.calendar.CalendarEventCommentFeedFromString)
+
+ def GetCalendarEventCommentEntry(self, uri):
+ return self.Get(uri, converter=gdata.calendar.CalendarEventCommentEntryFromString)
+
+ def Query(self, uri, converter=None):
+ """Performs a query and returns a resulting feed or entry.
+
+ Args:
+ feed: string The feed which is to be queried
+
+ Returns:
+ On success, a GDataFeed or Entry depending on which is sent from the
+ server.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ if converter:
+ result = self.Get(uri, converter=converter)
+ else:
+ result = self.Get(uri)
+ return result
+
+ def CalendarQuery(self, query):
+ if isinstance(query, CalendarEventQuery):
+ return self.Query(query.ToUri(),
+ converter=gdata.calendar.CalendarEventFeedFromString)
+ elif isinstance(query, CalendarListQuery):
+ return self.Query(query.ToUri(),
+ converter=gdata.calendar.CalendarListFeedFromString)
+ elif isinstance(query, CalendarEventCommentQuery):
+ return self.Query(query.ToUri(),
+ converter=gdata.calendar.CalendarEventCommentFeedFromString)
+ else:
+ return self.Query(query.ToUri())
+
+ def InsertEvent(self, new_event, insert_uri, url_params=None,
+ escape_params=True):
+ """Adds an event to Google Calendar.
+
+ Args:
+ new_event: atom.Entry or subclass A new event which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new events to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the event created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ return self.Post(new_event, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarEventEntryFromString)
+
+ def InsertCalendarSubscription(self, calendar, url_params=None,
+ escape_params=True):
+ """Subscribes the authenticated user to the provided calendar.
+
+ Args:
+ calendar: The calendar to which the user should be subscribed.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the subscription created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ insert_uri = '/calendar/feeds/default/allcalendars/full'
+ return self.Post(calendar, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarListEntryFromString)
+
+ def InsertCalendar(self, new_calendar, url_params=None,
+ escape_params=True):
+ """Creates a new calendar.
+
+ Args:
+ new_calendar: The calendar to be created
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the calendar created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ insert_uri = '/calendar/feeds/default/owncalendars/full'
+ response = self.Post(new_calendar, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarListEntryFromString)
+ return response
+
+ def UpdateCalendar(self, calendar, url_params=None,
+ escape_params=True):
+ """Updates a calendar.
+
+ Args:
+ calendar: The calendar which should be updated
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the calendar created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ update_uri = calendar.GetEditLink().href
+ response = self.Put(data=calendar, uri=update_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarListEntryFromString)
+ return response
+
+ def InsertAclEntry(self, new_entry, insert_uri, url_params=None,
+ escape_params=True):
+ """Adds an ACL entry (rule) to Google Calendar.
+
+ Args:
+ new_entry: atom.Entry or subclass A new ACL entry which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new entries to the ACL feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the ACL entry created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ return self.Post(new_entry, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarAclEntryFromString)
+
+ def InsertEventComment(self, new_entry, insert_uri, url_params=None,
+ escape_params=True):
+ """Adds an entry to Google Calendar.
+
+ Args:
+ new_entry: atom.Entry or subclass A new entry which is to be added to
+ Google Calendar.
+ insert_uri: the URL to post new entrys to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the comment created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ return self.Post(new_entry, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarEventCommentEntryFromString)
+
+ def _RemoveStandardUrlPrefix(self, url):
+ url_prefix = 'http://%s/' % self.server
+ if url.startswith(url_prefix):
+ return url[len(url_prefix) - 1:]
+ return url
+
+ def DeleteEvent(self, edit_uri, extra_headers=None,
+ url_params=None, escape_params=True):
+ """Removes an event with the specified ID from Google Calendar.
+
+ Args:
+ edit_uri: string The edit URL of the entry to be deleted. Example:
+ 'http://www.google.com/calendar/feeds/default/private/full/abx'
+ url_params: dict (optional) Additional URL parameters to be included
+ in the deletion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful delete, a httplib.HTTPResponse containing the server's
+ response to the DELETE request.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ edit_uri = self._RemoveStandardUrlPrefix(edit_uri)
+ return self.Delete('%s' % edit_uri,
+ url_params=url_params, escape_params=escape_params)
+
+ def DeleteAclEntry(self, edit_uri, extra_headers=None,
+ url_params=None, escape_params=True):
+ """Removes an ACL entry at the given edit_uri from Google Calendar.
+
+ Args:
+ edit_uri: string The edit URL of the entry to be deleted. Example:
+ 'http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/default'
+ url_params: dict (optional) Additional URL parameters to be included
+ in the deletion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful delete, a httplib.HTTPResponse containing the server's
+ response to the DELETE request.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ edit_uri = self._RemoveStandardUrlPrefix(edit_uri)
+ return self.Delete('%s' % edit_uri,
+ url_params=url_params, escape_params=escape_params)
+
+ def DeleteCalendarEntry(self, edit_uri, extra_headers=None,
+ url_params=None, escape_params=True):
+ """Removes a calendar entry at the given edit_uri from Google Calendar.
+
+ Args:
+ edit_uri: string The edit URL of the entry to be deleted. Example:
+ 'http://www.google.com/calendar/feeds/default/allcalendars/abcdef@group.calendar.google.com'
+ url_params: dict (optional) Additional URL parameters to be included
+ in the deletion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful delete, True is returned
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ return self.Delete(edit_uri, url_params=url_params,
+ escape_params=escape_params)
+
+ def UpdateEvent(self, edit_uri, updated_event, url_params=None,
+ escape_params=True):
+ """Updates an existing event.
+
+ Args:
+ edit_uri: string The edit link URI for the element being updated
+ updated_event: string, atom.Entry, or subclass containing
+ the Atom Entry which will replace the event which is
+ stored at the edit_url
+ url_params: dict (optional) Additional URL parameters to be included
+ in the update request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful update, a httplib.HTTPResponse containing the server's
+ response to the PUT request.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ edit_uri = self._RemoveStandardUrlPrefix(edit_uri)
+ return self.Put(updated_event, '%s' % edit_uri,
+ url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarEventEntryFromString)
+
+ def UpdateAclEntry(self, edit_uri, updated_rule, url_params=None,
+ escape_params=True):
+ """Updates an existing ACL rule.
+
+ Args:
+ edit_uri: string The edit link URI for the element being updated
+ updated_rule: string, atom.Entry, or subclass containing
+ the Atom Entry which will replace the event which is
+ stored at the edit_url
+ url_params: dict (optional) Additional URL parameters to be included
+ in the update request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful update, a httplib.HTTPResponse containing the server's
+ response to the PUT request.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ edit_uri = self._RemoveStandardUrlPrefix(edit_uri)
+ return self.Put(updated_rule, '%s' % edit_uri,
+ url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.calendar.CalendarAclEntryFromString)
+
+ def ExecuteBatch(self, batch_feed, url,
+ converter=gdata.calendar.CalendarEventFeedFromString):
+ """Sends a batch request feed to the server.
+
+ The batch request needs to be sent to the batch URL for a particular
+ calendar. You can find the URL by calling GetBatchLink().href on the
+ CalendarEventFeed.
+
+ Args:
+ batch_feed: gdata.calendar.CalendarEventFeed A feed containing batch
+ request entries. Each entry contains the operation to be performed
+ on the data contained in the entry. For example an entry with an
+ operation type of insert will be used as if the individual entry
+ had been inserted.
+ url: str The batch URL for the Calendar to which these operations should
+ be applied.
+ converter: Function (optional) The function used to convert the server's
+ response to an object. The default value is
+ CalendarEventFeedFromString.
+
+ Returns:
+ The results of the batch request's execution on the server. If the
+ default converter is used, this is stored in a CalendarEventFeed.
+ """
+ return self.Post(batch_feed, url, converter=converter)
+
+
+class CalendarEventQuery(gdata.service.Query):
+
+ def __init__(self, user='default', visibility='private', projection='full',
+ text_query=None, params=None, categories=None):
+ gdata.service.Query.__init__(self,
+ feed='http://www.google.com/calendar/feeds/%s/%s/%s' % (
+ urllib.quote(user),
+ urllib.quote(visibility),
+ urllib.quote(projection)),
+ text_query=text_query, params=params, categories=categories)
+
+ def _GetStartMin(self):
+ if 'start-min' in self.keys():
+ return self['start-min']
+ else:
+ return None
+
+ def _SetStartMin(self, val):
+ self['start-min'] = val
+
+ start_min = property(_GetStartMin, _SetStartMin,
+ doc="""The start-min query parameter""")
+
+ def _GetStartMax(self):
+ if 'start-max' in self.keys():
+ return self['start-max']
+ else:
+ return None
+
+ def _SetStartMax(self, val):
+ self['start-max'] = val
+
+ start_max = property(_GetStartMax, _SetStartMax,
+ doc="""The start-max query parameter""")
+
+ def _GetOrderBy(self):
+ if 'orderby' in self.keys():
+ return self['orderby']
+ else:
+ return None
+
+ def _SetOrderBy(self, val):
+ if val is not 'lastmodified' and val is not 'starttime':
+ raise Error, "Order By must be either 'lastmodified' or 'starttime'"
+ self['orderby'] = val
+
+ orderby = property(_GetOrderBy, _SetOrderBy,
+ doc="""The orderby query parameter""")
+
+ def _GetSortOrder(self):
+ if 'sortorder' in self.keys():
+ return self['sortorder']
+ else:
+ return None
+
+ def _SetSortOrder(self, val):
+ if (val is not 'ascending' and val is not 'descending'
+ and val is not 'a' and val is not 'd' and val is not 'ascend'
+ and val is not 'descend'):
+ raise Error, "Sort order must be either ascending, ascend, " + (
+ "a or descending, descend, or d")
+ self['sortorder'] = val
+
+ sortorder = property(_GetSortOrder, _SetSortOrder,
+ doc="""The sortorder query parameter""")
+
+ def _GetSingleEvents(self):
+ if 'singleevents' in self.keys():
+ return self['singleevents']
+ else:
+ return None
+
+ def _SetSingleEvents(self, val):
+ self['singleevents'] = val
+
+ singleevents = property(_GetSingleEvents, _SetSingleEvents,
+ doc="""The singleevents query parameter""")
+
+ def _GetFutureEvents(self):
+ if 'futureevents' in self.keys():
+ return self['futureevents']
+ else:
+ return None
+
+ def _SetFutureEvents(self, val):
+ self['futureevents'] = val
+
+ futureevents = property(_GetFutureEvents, _SetFutureEvents,
+ doc="""The futureevents query parameter""")
+
+ def _GetRecurrenceExpansionStart(self):
+ if 'recurrence-expansion-start' in self.keys():
+ return self['recurrence-expansion-start']
+ else:
+ return None
+
+ def _SetRecurrenceExpansionStart(self, val):
+ self['recurrence-expansion-start'] = val
+
+ recurrence_expansion_start = property(_GetRecurrenceExpansionStart,
+ _SetRecurrenceExpansionStart,
+ doc="""The recurrence-expansion-start query parameter""")
+
+ def _GetRecurrenceExpansionEnd(self):
+ if 'recurrence-expansion-end' in self.keys():
+ return self['recurrence-expansion-end']
+ else:
+ return None
+
+ def _SetRecurrenceExpansionEnd(self, val):
+ self['recurrence-expansion-end'] = val
+
+ recurrence_expansion_end = property(_GetRecurrenceExpansionEnd,
+ _SetRecurrenceExpansionEnd,
+ doc="""The recurrence-expansion-end query parameter""")
+
+ def _SetTimezone(self, val):
+ self['ctz'] = val
+
+ def _GetTimezone(self):
+ if 'ctz' in self.keys():
+ return self['ctz']
+ else:
+ return None
+
+ ctz = property(_GetTimezone, _SetTimezone,
+ doc="""The ctz query parameter which sets report time on the server.""")
+
+
+class CalendarListQuery(gdata.service.Query):
+ """Queries the Google Calendar meta feed"""
+
+ def __init__(self, userId=None, text_query=None,
+ params=None, categories=None):
+ if userId is None:
+ userId = 'default'
+
+ gdata.service.Query.__init__(self, feed='http://www.google.com/calendar/feeds/'
+ +userId,
+ text_query=text_query, params=params,
+ categories=categories)
+
+class CalendarEventCommentQuery(gdata.service.Query):
+ """Queries the Google Calendar event comments feed"""
+
+ def __init__(self, feed=None):
+ gdata.service.Query.__init__(self, feed=feed)
diff --git a/src/gdata/calendar_resource/__init__.py b/src/gdata/calendar_resource/__init__.py
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/src/gdata/calendar_resource/__init__.py
@@ -0,0 +1 @@
+
diff --git a/src/gdata/calendar_resource/client.py b/src/gdata/calendar_resource/client.py
new file mode 100644
index 0000000..73ddff8
--- /dev/null
+++ b/src/gdata/calendar_resource/client.py
@@ -0,0 +1,199 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""CalendarResourceClient simplifies Calendar Resources API calls.
+
+CalendarResourceClient extends gdata.client.GDClient to ease interaction with
+the Google Apps Calendar Resources API. These interactions include the ability
+to create, retrieve, update, and delete calendar resources in a Google Apps
+domain.
+"""
+
+
+__author__ = 'Vic Fryzel <vf@google.com>'
+
+
+import gdata.calendar_resource.data
+import gdata.client
+import urllib
+
+
+# Feed URI template. This must end with a /
+# The strings in this template are eventually replaced with the API version
+# and Google Apps domain name, respectively.
+RESOURCE_FEED_TEMPLATE = '/a/feeds/calendar/resource/%s/%s/'
+
+
+class CalendarResourceClient(gdata.client.GDClient):
+ """Client extension for the Google Calendar Resource API service.
+
+ Attributes:
+ host: string The hostname for the Calendar Resouce API service.
+ api_version: string The version of the Calendar Resource API.
+ """
+
+ host = 'apps-apis.google.com'
+ api_version = '2.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+ ssl = True
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the Calendar Resource API.
+
+ Args:
+ domain: string The Google Apps domain with Calendar Resources.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the calendar resource
+ data.
+ kwargs: The other parameters to pass to the gdata.client.GDClient
+ constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def make_resource_feed_uri(self, resource_id=None, params=None):
+ """Creates a resource feed URI for the Calendar Resource API.
+
+ Using this client's Google Apps domain, create a feed URI for calendar
+ resources in that domain. If a resource_id is provided, return a URI
+ for that specific resource. If params are provided, append them as GET
+ params.
+
+ Args:
+ resource_id: string (optional) The ID of the calendar resource for which
+ to make a feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+ Returns:
+ A string giving the URI for calendar resources for this client's Google
+ Apps domain.
+ """
+ uri = RESOURCE_FEED_TEMPLATE % (self.api_version, self.domain)
+ if resource_id:
+ uri += resource_id
+ if params:
+ uri += '?' + urllib.urlencode(params)
+ return uri
+
+ MakeResourceFeedUri = make_resource_feed_uri
+
+ def get_resource_feed(self, uri=None, **kwargs):
+ """Fetches a ResourceFeed of calendar resources at the given URI.
+
+ Args:
+ uri: string The URI of the feed to pull.
+ kwargs: The other parameters to pass to gdata.client.GDClient.get_feed().
+
+ Returns:
+ A ResourceFeed object representing the feed at the given URI.
+ """
+
+ if uri is None:
+ uri = self.MakeResourceFeedUri()
+ return self.get_feed(
+ uri,
+ desired_class=gdata.calendar_resource.data.CalendarResourceFeed,
+ **kwargs)
+
+ GetResourceFeed = get_resource_feed
+
+ def get_resource(self, uri=None, resource_id=None, **kwargs):
+ """Fetches a single calendar resource by resource ID.
+
+ Args:
+ uri: string The base URI of the feed from which to fetch the resource.
+ resource_id: string The string ID of the Resource to fetch.
+ kwargs: The other parameters to pass to gdata.client.GDClient.get_entry().
+
+ Returns:
+ A Resource object representing the calendar resource with the given
+ base URI and resource ID.
+ """
+
+ if uri is None:
+ uri = self.MakeResourceFeedUri(resource_id)
+ return self.get_entry(
+ uri,
+ desired_class=gdata.calendar_resource.data.CalendarResourceEntry,
+ **kwargs)
+
+ GetResource = get_resource
+
+ def create_resource(self, resource_id, resource_common_name=None,
+ resource_description=None, resource_type=None, **kwargs):
+ """Creates a calendar resource with the given properties.
+
+ Args:
+ resource_id: string The resource ID of the calendar resource.
+ resource_common_name: string (optional) The common name of the resource.
+ resource_description: string (optional) The description of the resource.
+ resource_type: string (optional) The type of the resource.
+ kwargs: The other parameters to pass to gdata.client.GDClient.post().
+
+ Returns:
+ gdata.calendar_resource.data.CalendarResourceEntry of the new resource.
+ """
+ new_resource = gdata.calendar_resource.data.CalendarResourceEntry(
+ resource_id=resource_id,
+ resource_common_name=resource_common_name,
+ resource_description=resource_description,
+ resource_type=resource_type)
+ return self.post(new_resource, self.MakeResourceFeedUri(), **kwargs)
+
+ CreateResource = create_resource
+
+ def update_resource(self, resource_id, resource_common_name=None,
+ resource_description=None, resource_type=None, **kwargs):
+ """Updates the calendar resource with the given resource ID.
+
+ Args:
+ resource_id: string The resource ID of the calendar resource to update.
+ resource_common_name: string (optional) The common name to give the
+ resource.
+ resource_description: string (optional) The description to give the
+ resource.
+ resource_type: string (optional) The type to give the resource.
+ kwargs: The other parameters to pass to gdata.client.GDClient.update().
+
+ Returns:
+ gdata.calendar_resource.data.CalendarResourceEntry of the updated
+ resource.
+ """
+ new_resource = gdata.calendar_resource.data.CalendarResourceEntry(
+ resource_id=resource_id,
+ resource_common_name=resource_common_name,
+ resource_description=resource_description,
+ resource_type=resource_type)
+ return self.update(new_resource, uri=self.MakeResourceFeedUri(resource_id),
+ **kwargs)
+
+ UpdateResource = update_resource
+
+ def delete_resource(self, resource_id, **kwargs):
+ """Deletes the calendar resource with the given resource ID.
+
+ Args:
+ resource_id: string The resource ID of the calendar resource to delete.
+ kwargs: The other parameters to pass to gdata.client.GDClient.delete()
+
+ Returns:
+ An HTTP response object. See gdata.client.request().
+ """
+
+ return self.delete(self.MakeResourceFeedUri(resource_id), **kwargs)
+
+ DeleteResource = delete_resource
diff --git a/src/gdata/calendar_resource/data.py b/src/gdata/calendar_resource/data.py
new file mode 100644
index 0000000..82c152a
--- /dev/null
+++ b/src/gdata/calendar_resource/data.py
@@ -0,0 +1,206 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model for parsing and generating XML for the Calendar Resource API."""
+
+
+__author__ = 'Vic Fryzel <vf@google.com>'
+
+
+import atom.core
+import atom.data
+import gdata.apps
+import gdata.apps_property
+import gdata.data
+
+
+# This is required to work around a naming conflict between the Google
+# Spreadsheets API and Python's built-in property function
+pyproperty = property
+
+
+# The apps:property name of the resourceId property
+RESOURCE_ID_NAME = 'resourceId'
+# The apps:property name of the resourceCommonName property
+RESOURCE_COMMON_NAME_NAME = 'resourceCommonName'
+# The apps:property name of the resourceDescription property
+RESOURCE_DESCRIPTION_NAME = 'resourceDescription'
+# The apps:property name of the resourceType property
+RESOURCE_TYPE_NAME = 'resourceType'
+# The apps:property name of the resourceEmail property
+RESOURCE_EMAIL_NAME = 'resourceEmail'
+
+
+class CalendarResourceEntry(gdata.data.GDEntry):
+ """Represents a Calendar Resource entry in object form."""
+
+ property = [gdata.apps_property.AppsProperty]
+
+ def _GetProperty(self, name):
+ """Get the apps:property value with the given name.
+
+ Args:
+ name: string Name of the apps:property value to get.
+
+ Returns:
+ The apps:property value with the given name, or None if the name was
+ invalid.
+ """
+
+ for p in self.property:
+ if p.name == name:
+ return p.value
+ return None
+
+ def _SetProperty(self, name, value):
+ """Set the apps:property value with the given name to the given value.
+
+ Args:
+ name: string Name of the apps:property value to set.
+ value: string Value to give the apps:property value with the given name.
+ """
+
+ for i in range(len(self.property)):
+ if self.property[i].name == name:
+ self.property[i].value = value
+ return
+ self.property.append(gdata.apps_property.AppsProperty(name=name, value=value))
+
+ def GetResourceId(self):
+ """Get the resource ID of this Calendar Resource object.
+
+ Returns:
+ The resource ID of this Calendar Resource object as a string or None.
+ """
+
+ return self._GetProperty(RESOURCE_ID_NAME)
+
+ def SetResourceId(self, value):
+ """Set the resource ID of this Calendar Resource object.
+
+ Args:
+ value: string The new resource ID value to give this object.
+ """
+
+ self._SetProperty(RESOURCE_ID_NAME, value)
+
+ resource_id = pyproperty(GetResourceId, SetResourceId)
+
+ def GetResourceCommonName(self):
+ """Get the common name of this Calendar Resource object.
+
+ Returns:
+ The common name of this Calendar Resource object as a string or None.
+ """
+
+ return self._GetProperty(RESOURCE_COMMON_NAME_NAME)
+
+ def SetResourceCommonName(self, value):
+ """Set the common name of this Calendar Resource object.
+
+ Args:
+ value: string The new common name value to give this object.
+ """
+
+ self._SetProperty(RESOURCE_COMMON_NAME_NAME, value)
+
+ resource_common_name = pyproperty(
+ GetResourceCommonName,
+ SetResourceCommonName)
+
+ def GetResourceDescription(self):
+ """Get the description of this Calendar Resource object.
+
+ Returns:
+ The description of this Calendar Resource object as a string or None.
+ """
+
+ return self._GetProperty(RESOURCE_DESCRIPTION_NAME)
+
+ def SetResourceDescription(self, value):
+ """Set the description of this Calendar Resource object.
+
+ Args:
+ value: string The new description value to give this object.
+ """
+
+ self._SetProperty(RESOURCE_DESCRIPTION_NAME, value)
+
+ resource_description = pyproperty(
+ GetResourceDescription,
+ SetResourceDescription)
+
+ def GetResourceType(self):
+ """Get the type of this Calendar Resource object.
+
+ Returns:
+ The type of this Calendar Resource object as a string or None.
+ """
+
+ return self._GetProperty(RESOURCE_TYPE_NAME)
+
+ def SetResourceType(self, value):
+ """Set the type value of this Calendar Resource object.
+
+ Args:
+ value: string The new type value to give this object.
+ """
+
+ self._SetProperty(RESOURCE_TYPE_NAME, value)
+
+ resource_type = pyproperty(GetResourceType, SetResourceType)
+
+ def GetResourceEmail(self):
+ """Get the email of this Calendar Resource object.
+
+ Returns:
+ The email of this Calendar Resource object as a string or None.
+ """
+
+ return self._GetProperty(RESOURCE_EMAIL_NAME)
+
+ resource_email = pyproperty(GetResourceEmail)
+
+ def __init__(self, resource_id=None, resource_common_name=None,
+ resource_description=None, resource_type=None, *args, **kwargs):
+ """Constructs a new CalendarResourceEntry object with the given arguments.
+
+ Args:
+ resource_id: string (optional) The resource ID to give this new object.
+ resource_common_name: string (optional) The common name to give this new
+ object.
+ resource_description: string (optional) The description to give this new
+ object.
+ resource_type: string (optional) The type to give this new object.
+ args: The other parameters to pass to gdata.entry.GDEntry constructor.
+ kwargs: The other parameters to pass to gdata.entry.GDEntry constructor.
+ """
+ super(CalendarResourceEntry, self).__init__(*args, **kwargs)
+ if resource_id:
+ self.resource_id = resource_id
+ if resource_common_name:
+ self.resource_common_name = resource_common_name
+ if resource_description:
+ self.resource_description = resource_description
+ if resource_type:
+ self.resource_type = resource_type
+
+
+class CalendarResourceFeed(gdata.data.GDFeed):
+ """Represents a feed of CalendarResourceEntry objects."""
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [CalendarResourceEntry]
diff --git a/src/gdata/client.py b/src/gdata/client.py
new file mode 100644
index 0000000..9f5afb5
--- /dev/null
+++ b/src/gdata/client.py
@@ -0,0 +1,1194 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2008, 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+"""Provides a client to interact with Google Data API servers.
+
+This module is used for version 2 of the Google Data APIs. The primary class
+in this module is GDClient.
+
+ GDClient: handles auth and CRUD operations when communicating with servers.
+ GDataClient: deprecated client for version one services. Will be removed.
+"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import re
+import atom.client
+import atom.core
+import atom.http_core
+import gdata.gauth
+import gdata.data
+
+
+class Error(Exception):
+ pass
+
+
+class RequestError(Error):
+ status = None
+ reason = None
+ body = None
+ headers = None
+
+
+class RedirectError(RequestError):
+ pass
+
+
+class CaptchaChallenge(RequestError):
+ captcha_url = None
+ captcha_token = None
+
+
+class ClientLoginTokenMissing(Error):
+ pass
+
+
+class MissingOAuthParameters(Error):
+ pass
+
+
+class ClientLoginFailed(RequestError):
+ pass
+
+
+class UnableToUpgradeToken(RequestError):
+ pass
+
+
+class Unauthorized(Error):
+ pass
+
+
+class BadAuthenticationServiceURL(RedirectError):
+ pass
+
+
+class BadAuthentication(RequestError):
+ pass
+
+
+class NotModified(RequestError):
+ pass
+
+class NotImplemented(RequestError):
+ pass
+
+
+def error_from_response(message, http_response, error_class,
+ response_body=None):
+
+ """Creates a new exception and sets the HTTP information in the error.
+
+ Args:
+ message: str human readable message to be displayed if the exception is
+ not caught.
+ http_response: The response from the server, contains error information.
+ error_class: The exception to be instantiated and populated with
+ information from the http_response
+ response_body: str (optional) specify if the response has already been read
+ from the http_response object.
+ """
+ if response_body is None:
+ body = http_response.read()
+ else:
+ body = response_body
+ error = error_class('%s: %i, %s' % (message, http_response.status, body))
+ error.status = http_response.status
+ error.reason = http_response.reason
+ error.body = body
+ error.headers = atom.http_core.get_headers(http_response)
+ return error
+
+
+def get_xml_version(version):
+ """Determines which XML schema to use based on the client API version.
+
+ Args:
+ version: string which is converted to an int. The version string is in
+ the form 'Major.Minor.x.y.z' and only the major version number
+ is considered. If None is provided assume version 1.
+ """
+ if version is None:
+ return 1
+ return int(version.split('.')[0])
+
+
+class GDClient(atom.client.AtomPubClient):
+ """Communicates with Google Data servers to perform CRUD operations.
+
+ This class is currently experimental and may change in backwards
+ incompatible ways.
+
+ This class exists to simplify the following three areas involved in using
+ the Google Data APIs.
+
+ CRUD Operations:
+
+ The client provides a generic 'request' method for making HTTP requests.
+ There are a number of convenience methods which are built on top of
+ request, which include get_feed, get_entry, get_next, post, update, and
+ delete. These methods contact the Google Data servers.
+
+ Auth:
+
+ Reading user-specific private data requires authorization from the user as
+ do any changes to user data. An auth_token object can be passed into any
+ of the HTTP requests to set the Authorization header in the request.
+
+ You may also want to set the auth_token member to a an object which can
+ use modify_request to set the Authorization header in the HTTP request.
+
+ If you are authenticating using the email address and password, you can
+ use the client_login method to obtain an auth token and set the
+ auth_token member.
+
+ If you are using browser redirects, specifically AuthSub, you will want
+ to use gdata.gauth.AuthSubToken.from_url to obtain the token after the
+ redirect, and you will probably want to updgrade this since use token
+ to a multiple use (session) token using the upgrade_token method.
+
+ API Versions:
+
+ This client is multi-version capable and can be used with Google Data API
+ version 1 and version 2. The version should be specified by setting the
+ api_version member to a string, either '1' or '2'.
+ """
+
+ # The gsessionid is used by Google Calendar to prevent redirects.
+ __gsessionid = None
+ api_version = None
+ # Name of the Google Data service when making a ClientLogin request.
+ auth_service = None
+ # URL prefixes which should be requested for AuthSub and OAuth.
+ auth_scopes = None
+ # Name of alternate auth service to use in certain cases
+ alt_auth_service = None
+
+ def request(self, method=None, uri=None, auth_token=None,
+ http_request=None, converter=None, desired_class=None,
+ redirects_remaining=4, **kwargs):
+ """Make an HTTP request to the server.
+
+ See also documentation for atom.client.AtomPubClient.request.
+
+ If a 302 redirect is sent from the server to the client, this client
+ assumes that the redirect is in the form used by the Google Calendar API.
+ The same request URI and method will be used as in the original request,
+ but a gsessionid URL parameter will be added to the request URI with
+ the value provided in the server's 302 redirect response. If the 302
+ redirect is not in the format specified by the Google Calendar API, a
+ RedirectError will be raised containing the body of the server's
+ response.
+
+ The method calls the client's modify_request method to make any changes
+ required by the client before the request is made. For example, a
+ version 2 client could add a GData-Version: 2 header to the request in
+ its modify_request method.
+
+ Args:
+ method: str The HTTP verb for this request, usually 'GET', 'POST',
+ 'PUT', or 'DELETE'
+ uri: atom.http_core.Uri, str, or unicode The URL being requested.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others.
+ http_request: (optional) atom.http_core.HttpRequest
+ converter: function which takes the body of the response as its only
+ argument and returns the desired object.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (converter=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned.
+ redirects_remaining: (optional) int, if this number is 0 and the
+ server sends a 302 redirect, the request method
+ will raise an exception. This parameter is used in
+ recursive request calls to avoid an infinite loop.
+
+ Any additional arguments are passed through to
+ atom.client.AtomPubClient.request.
+
+ Returns:
+ An HTTP response object (see atom.http_core.HttpResponse for a
+ description of the object's interface) if no converter was
+ specified and no desired_class was specified. If a converter function
+ was provided, the results of calling the converter are returned. If no
+ converter was specified but a desired_class was provided, the response
+ body will be converted to the class using
+ atom.core.parse.
+ """
+ if isinstance(uri, (str, unicode)):
+ uri = atom.http_core.Uri.parse_uri(uri)
+
+ # Add the gsession ID to the URL to prevent further redirects.
+ # TODO: If different sessions are using the same client, there will be a
+ # multitude of redirects and session ID shuffling.
+ # If the gsession ID is in the URL, adopt it as the standard location.
+ if uri is not None and uri.query is not None and 'gsessionid' in uri.query:
+ self.__gsessionid = uri.query['gsessionid']
+ # The gsession ID could also be in the HTTP request.
+ elif (http_request is not None and http_request.uri is not None
+ and http_request.uri.query is not None
+ and 'gsessionid' in http_request.uri.query):
+ self.__gsessionid = http_request.uri.query['gsessionid']
+ # If the gsession ID is stored in the client, and was not present in the
+ # URI then add it to the URI.
+ elif self.__gsessionid is not None:
+ uri.query['gsessionid'] = self.__gsessionid
+
+ # The AtomPubClient should call this class' modify_request before
+ # performing the HTTP request.
+ #http_request = self.modify_request(http_request)
+
+ response = atom.client.AtomPubClient.request(self, method=method,
+ uri=uri, auth_token=auth_token, http_request=http_request, **kwargs)
+ # On success, convert the response body using the desired converter
+ # function if present.
+ if response is None:
+ return None
+ if response.status == 200 or response.status == 201:
+ if converter is not None:
+ return converter(response)
+ elif desired_class is not None:
+ if self.api_version is not None:
+ return atom.core.parse(response.read(), desired_class,
+ version=get_xml_version(self.api_version))
+ else:
+ # No API version was specified, so allow parse to
+ # use the default version.
+ return atom.core.parse(response.read(), desired_class)
+ else:
+ return response
+ # TODO: move the redirect logic into the Google Calendar client once it
+ # exists since the redirects are only used in the calendar API.
+ elif response.status == 302:
+ if redirects_remaining > 0:
+ location = (response.getheader('Location')
+ or response.getheader('location'))
+ if location is not None:
+ # Make a recursive call with the gsession ID in the URI to follow
+ # the redirect.
+ return self.request(method=method, uri=location,
+ auth_token=auth_token, http_request=http_request,
+ converter=converter, desired_class=desired_class,
+ redirects_remaining=redirects_remaining-1,
+ **kwargs)
+ else:
+ raise error_from_response('302 received without Location header',
+ response, RedirectError)
+ else:
+ raise error_from_response('Too many redirects from server',
+ response, RedirectError)
+ elif response.status == 401:
+ raise error_from_response('Unauthorized - Server responded with',
+ response, Unauthorized)
+ elif response.status == 304:
+ raise error_from_response('Entry Not Modified - Server responded with',
+ response, NotModified)
+ elif response.status == 501:
+ raise error_from_response(
+ 'This API operation is not implemented. - Server responded with',
+ response, NotImplemented)
+ # If the server's response was not a 200, 201, 302, 304, 401, or 501, raise
+ # an exception.
+ else:
+ raise error_from_response('Server responded with', response,
+ RequestError)
+
+ Request = request
+
+ def request_client_login_token(
+ self, email, password, source, service=None,
+ account_type='HOSTED_OR_GOOGLE',
+ auth_url=atom.http_core.Uri.parse_uri(
+ 'https://www.google.com/accounts/ClientLogin'),
+ captcha_token=None, captcha_response=None):
+ service = service or self.auth_service
+ # Set the target URL.
+ http_request = atom.http_core.HttpRequest(uri=auth_url, method='POST')
+ http_request.add_body_part(
+ gdata.gauth.generate_client_login_request_body(email=email,
+ password=password, service=service, source=source,
+ account_type=account_type, captcha_token=captcha_token,
+ captcha_response=captcha_response),
+ 'application/x-www-form-urlencoded')
+
+ # Use the underlying http_client to make the request.
+ response = self.http_client.request(http_request)
+
+ response_body = response.read()
+ if response.status == 200:
+ token_string = gdata.gauth.get_client_login_token_string(response_body)
+ if token_string is not None:
+ return gdata.gauth.ClientLoginToken(token_string)
+ else:
+ raise ClientLoginTokenMissing(
+ 'Recieved a 200 response to client login request,'
+ ' but no token was present. %s' % (response_body,))
+ elif response.status == 403:
+ captcha_challenge = gdata.gauth.get_captcha_challenge(response_body)
+ if captcha_challenge:
+ challenge = CaptchaChallenge('CAPTCHA required')
+ challenge.captcha_url = captcha_challenge['url']
+ challenge.captcha_token = captcha_challenge['token']
+ raise challenge
+ elif response_body.splitlines()[0] == 'Error=BadAuthentication':
+ raise BadAuthentication('Incorrect username or password')
+ else:
+ raise error_from_response('Server responded with a 403 code',
+ response, RequestError, response_body)
+ elif response.status == 302:
+ # Google tries to redirect all bad URLs back to
+ # http://www.google.<locale>. If a redirect
+ # attempt is made, assume the user has supplied an incorrect
+ # authentication URL
+ raise error_from_response('Server responded with a redirect',
+ response, BadAuthenticationServiceURL,
+ response_body)
+ else:
+ raise error_from_response('Server responded to ClientLogin request',
+ response, ClientLoginFailed, response_body)
+
+ RequestClientLoginToken = request_client_login_token
+
+ def client_login(self, email, password, source, service=None,
+ account_type='HOSTED_OR_GOOGLE',
+ auth_url=atom.http_core.Uri.parse_uri(
+ 'https://www.google.com/accounts/ClientLogin'),
+ captcha_token=None, captcha_response=None):
+ """Performs an auth request using the user's email address and password.
+
+ In order to modify user specific data and read user private data, your
+ application must be authorized by the user. One way to demonstrage
+ authorization is by including a Client Login token in the Authorization
+ HTTP header of all requests. This method requests the Client Login token
+ by sending the user's email address, password, the name of the
+ application, and the service code for the service which will be accessed
+ by the application. If the username and password are correct, the server
+ will respond with the client login code and a new ClientLoginToken
+ object will be set in the client's auth_token member. With the auth_token
+ set, future requests from this client will include the Client Login
+ token.
+
+ For a list of service names, see
+ http://code.google.com/apis/gdata/faq.html#clientlogin
+ For more information on Client Login, see:
+ http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html
+
+ Args:
+ email: str The user's email address or username.
+ password: str The password for the user's account.
+ source: str The name of your application. This can be anything you
+ like but should should give some indication of which app is
+ making the request.
+ service: str The service code for the service you would like to access.
+ For example, 'cp' for contacts, 'cl' for calendar. For a full
+ list see
+ http://code.google.com/apis/gdata/faq.html#clientlogin
+ If you are using a subclass of the gdata.client.GDClient, the
+ service will usually be filled in for you so you do not need
+ to specify it. For example see BloggerClient,
+ SpreadsheetsClient, etc.
+ account_type: str (optional) The type of account which is being
+ authenticated. This can be either 'GOOGLE' for a Google
+ Account, 'HOSTED' for a Google Apps Account, or the
+ default 'HOSTED_OR_GOOGLE' which will select the Google
+ Apps Account if the same email address is used for both
+ a Google Account and a Google Apps Account.
+ auth_url: str (optional) The URL to which the login request should be
+ sent.
+ captcha_token: str (optional) If a previous login attempt was reponded
+ to with a CAPTCHA challenge, this is the token which
+ identifies the challenge (from the CAPTCHA's URL).
+ captcha_response: str (optional) If a previous login attempt was
+ reponded to with a CAPTCHA challenge, this is the
+ response text which was contained in the challenge.
+
+ Returns:
+ Generated token, which is also stored in this object.
+
+ Raises:
+ A RequestError or one of its suclasses: BadAuthentication,
+ BadAuthenticationServiceURL, ClientLoginFailed,
+ ClientLoginTokenMissing, or CaptchaChallenge
+ """
+ service = service or self.auth_service
+ self.auth_token = self.request_client_login_token(email, password,
+ source, service=service, account_type=account_type, auth_url=auth_url,
+ captcha_token=captcha_token, captcha_response=captcha_response)
+ if self.alt_auth_service is not None:
+ self.alt_auth_token = self.request_client_login_token(
+ email, password, source, service=self.alt_auth_service,
+ account_type=account_type, auth_url=auth_url,
+ captcha_token=captcha_token, captcha_response=captcha_response)
+ return self.auth_token
+
+ ClientLogin = client_login
+
+ def upgrade_token(self, token=None, url=atom.http_core.Uri.parse_uri(
+ 'https://www.google.com/accounts/AuthSubSessionToken')):
+ """Asks the Google auth server for a multi-use AuthSub token.
+
+ For details on AuthSub, see:
+ http://code.google.com/apis/accounts/docs/AuthSub.html
+
+ Args:
+ token: gdata.gauth.AuthSubToken or gdata.gauth.SecureAuthSubToken
+ (optional) If no token is passed in, the client's auth_token member
+ is used to request the new token. The token object will be modified
+ to contain the new session token string.
+ url: str or atom.http_core.Uri (optional) The URL to which the token
+ upgrade request should be sent. Defaults to:
+ https://www.google.com/accounts/AuthSubSessionToken
+
+ Returns:
+ The upgraded gdata.gauth.AuthSubToken object.
+ """
+ # Default to using the auth_token member if no token is provided.
+ if token is None:
+ token = self.auth_token
+ # We cannot upgrade a None token.
+ if token is None:
+ raise UnableToUpgradeToken('No token was provided.')
+ if not isinstance(token, gdata.gauth.AuthSubToken):
+ raise UnableToUpgradeToken(
+ 'Cannot upgrade the token because it is not an AuthSubToken object.')
+ http_request = atom.http_core.HttpRequest(uri=url, method='GET')
+ token.modify_request(http_request)
+ # Use the lower level HttpClient to make the request.
+ response = self.http_client.request(http_request)
+ if response.status == 200:
+ token._upgrade_token(response.read())
+ return token
+ else:
+ raise UnableToUpgradeToken(
+ 'Server responded to token upgrade request with %s: %s' % (
+ response.status, response.read()))
+
+ UpgradeToken = upgrade_token
+
+ def revoke_token(self, token=None, url=atom.http_core.Uri.parse_uri(
+ 'https://www.google.com/accounts/AuthSubRevokeToken')):
+ """Requests that the token be invalidated.
+
+ This method can be used for both AuthSub and OAuth tokens (to invalidate
+ a ClientLogin token, the user must change their password).
+
+ Returns:
+ True if the server responded with a 200.
+
+ Raises:
+ A RequestError if the server responds with a non-200 status.
+ """
+ # Default to using the auth_token member if no token is provided.
+ if token is None:
+ token = self.auth_token
+
+ http_request = atom.http_core.HttpRequest(uri=url, method='GET')
+ token.modify_request(http_request)
+ response = self.http_client.request(http_request)
+ if response.status != 200:
+ raise error_from_response('Server sent non-200 to revoke token',
+ response, RequestError, response.read())
+
+ return True
+
+ RevokeToken = revoke_token
+
+ def get_oauth_token(self, scopes, next, consumer_key, consumer_secret=None,
+ rsa_private_key=None,
+ url=gdata.gauth.REQUEST_TOKEN_URL):
+ """Obtains an OAuth request token to allow the user to authorize this app.
+
+ Once this client has a request token, the user can authorize the request
+ token by visiting the authorization URL in their browser. After being
+ redirected back to this app at the 'next' URL, this app can then exchange
+ the authorized request token for an access token.
+
+ For more information see the documentation on Google Accounts with OAuth:
+ http://code.google.com/apis/accounts/docs/OAuth.html#AuthProcess
+
+ Args:
+ scopes: list of strings or atom.http_core.Uri objects which specify the
+ URL prefixes which this app will be accessing. For example, to access
+ the Google Calendar API, you would want to use scopes:
+ ['https://www.google.com/calendar/feeds/',
+ 'http://www.google.com/calendar/feeds/']
+ next: str or atom.http_core.Uri object, The URL which the user's browser
+ should be sent to after they authorize access to their data. This
+ should be a URL in your application which will read the token
+ information from the URL and upgrade the request token to an access
+ token.
+ consumer_key: str This is the identifier for this application which you
+ should have received when you registered your application with Google
+ to use OAuth.
+ consumer_secret: str (optional) The shared secret between your app and
+ Google which provides evidence that this request is coming from you
+ application and not another app. If present, this libraries assumes
+ you want to use an HMAC signature to verify requests. Keep this data
+ a secret.
+ rsa_private_key: str (optional) The RSA private key which is used to
+ generate a digital signature which is checked by Google's server. If
+ present, this library assumes that you want to use an RSA signature
+ to verify requests. Keep this data a secret.
+ url: The URL to which a request for a token should be made. The default
+ is Google's OAuth request token provider.
+ """
+ http_request = None
+ if rsa_private_key is not None:
+ http_request = gdata.gauth.generate_request_for_request_token(
+ consumer_key, gdata.gauth.RSA_SHA1, scopes,
+ rsa_key=rsa_private_key, auth_server_url=url, next=next)
+ elif consumer_secret is not None:
+ http_request = gdata.gauth.generate_request_for_request_token(
+ consumer_key, gdata.gauth.HMAC_SHA1, scopes,
+ consumer_secret=consumer_secret, auth_server_url=url, next=next)
+ else:
+ raise MissingOAuthParameters(
+ 'To request an OAuth token, you must provide your consumer secret'
+ ' or your private RSA key.')
+
+ response = self.http_client.request(http_request)
+ response_body = response.read()
+
+ if response.status != 200:
+ raise error_from_response('Unable to obtain OAuth request token',
+ response, RequestError, response_body)
+
+ if rsa_private_key is not None:
+ return gdata.gauth.rsa_token_from_body(response_body, consumer_key,
+ rsa_private_key,
+ gdata.gauth.REQUEST_TOKEN)
+ elif consumer_secret is not None:
+ return gdata.gauth.hmac_token_from_body(response_body, consumer_key,
+ consumer_secret,
+ gdata.gauth.REQUEST_TOKEN)
+
+ GetOAuthToken = get_oauth_token
+
+ def get_access_token(self, request_token,
+ url=gdata.gauth.ACCESS_TOKEN_URL):
+ """Exchanges an authorized OAuth request token for an access token.
+
+ Contacts the Google OAuth server to upgrade a previously authorized
+ request token. Once the request token is upgraded to an access token,
+ the access token may be used to access the user's data.
+
+ For more details, see the Google Accounts OAuth documentation:
+ http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken
+
+ Args:
+ request_token: An OAuth token which has been authorized by the user.
+ url: (optional) The URL to which the upgrade request should be sent.
+ Defaults to: https://www.google.com/accounts/OAuthAuthorizeToken
+ """
+ http_request = gdata.gauth.generate_request_for_access_token(
+ request_token, auth_server_url=url)
+ response = self.http_client.request(http_request)
+ response_body = response.read()
+ if response.status != 200:
+ raise error_from_response(
+ 'Unable to upgrade OAuth request token to access token',
+ response, RequestError, response_body)
+
+ return gdata.gauth.upgrade_to_access_token(request_token, response_body)
+
+ GetAccessToken = get_access_token
+
+ def modify_request(self, http_request):
+ """Adds or changes request before making the HTTP request.
+
+ This client will add the API version if it is specified.
+ Subclasses may override this method to add their own request
+ modifications before the request is made.
+ """
+ http_request = atom.client.AtomPubClient.modify_request(self,
+ http_request)
+ if self.api_version is not None:
+ http_request.headers['GData-Version'] = self.api_version
+ return http_request
+
+ ModifyRequest = modify_request
+
+ def get_feed(self, uri, auth_token=None, converter=None,
+ desired_class=gdata.data.GDFeed, **kwargs):
+ return self.request(method='GET', uri=uri, auth_token=auth_token,
+ converter=converter, desired_class=desired_class,
+ **kwargs)
+
+ GetFeed = get_feed
+
+ def get_entry(self, uri, auth_token=None, converter=None,
+ desired_class=gdata.data.GDEntry, etag=None, **kwargs):
+ http_request = atom.http_core.HttpRequest()
+ # Conditional retrieval
+ if etag is not None:
+ http_request.headers['If-None-Match'] = etag
+ return self.request(method='GET', uri=uri, auth_token=auth_token,
+ http_request=http_request, converter=converter,
+ desired_class=desired_class, **kwargs)
+
+ GetEntry = get_entry
+
+ def get_next(self, feed, auth_token=None, converter=None,
+ desired_class=None, **kwargs):
+ """Fetches the next set of results from the feed.
+
+ When requesting a feed, the number of entries returned is capped at a
+ service specific default limit (often 25 entries). You can specify your
+ own entry-count cap using the max-results URL query parameter. If there
+ are more results than could fit under max-results, the feed will contain
+ a next link. This method performs a GET against this next results URL.
+
+ Returns:
+ A new feed object containing the next set of entries in this feed.
+ """
+ if converter is None and desired_class is None:
+ desired_class = feed.__class__
+ return self.get_feed(feed.find_next_link(), auth_token=auth_token,
+ converter=converter, desired_class=desired_class,
+ **kwargs)
+
+ GetNext = get_next
+
+ # TODO: add a refresh method to re-fetch the entry/feed from the server
+ # if it has been updated.
+
+ def post(self, entry, uri, auth_token=None, converter=None,
+ desired_class=None, **kwargs):
+ if converter is None and desired_class is None:
+ desired_class = entry.__class__
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(
+ entry.to_string(get_xml_version(self.api_version)),
+ 'application/atom+xml')
+ return self.request(method='POST', uri=uri, auth_token=auth_token,
+ http_request=http_request, converter=converter,
+ desired_class=desired_class, **kwargs)
+
+ Post = post
+
+ def update(self, entry, auth_token=None, force=False, uri=None, **kwargs):
+ """Edits the entry on the server by sending the XML for this entry.
+
+ Performs a PUT and converts the response to a new entry object with a
+ matching class to the entry passed in.
+
+ Args:
+ entry:
+ auth_token:
+ force: boolean stating whether an update should be forced. Defaults to
+ False. Normally, if a change has been made since the passed in
+ entry was obtained, the server will not overwrite the entry since
+ the changes were based on an obsolete version of the entry.
+ Setting force to True will cause the update to silently
+ overwrite whatever version is present.
+ uri: The uri to put to. If provided, this uri is PUT to rather than the
+ inferred uri from the entry's edit link.
+
+ Returns:
+ A new Entry object of a matching type to the entry which was passed in.
+ """
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(
+ entry.to_string(get_xml_version(self.api_version)),
+ 'application/atom+xml')
+ # Include the ETag in the request if present.
+ if force:
+ http_request.headers['If-Match'] = '*'
+ elif hasattr(entry, 'etag') and entry.etag:
+ http_request.headers['If-Match'] = entry.etag
+
+ if uri is None:
+ uri = entry.find_edit_link()
+
+ return self.request(method='PUT', uri=uri, auth_token=auth_token,
+ http_request=http_request,
+ desired_class=entry.__class__, **kwargs)
+
+ Update = update
+
+ def delete(self, entry_or_uri, auth_token=None, force=False, **kwargs):
+ http_request = atom.http_core.HttpRequest()
+
+ # Include the ETag in the request if present.
+ if force:
+ http_request.headers['If-Match'] = '*'
+ elif hasattr(entry_or_uri, 'etag') and entry_or_uri.etag:
+ http_request.headers['If-Match'] = entry_or_uri.etag
+
+ # If the user passes in a URL, just delete directly, may not work as
+ # the service might require an ETag.
+ if isinstance(entry_or_uri, (str, unicode, atom.http_core.Uri)):
+ return self.request(method='DELETE', uri=entry_or_uri,
+ http_request=http_request, auth_token=auth_token,
+ **kwargs)
+
+ return self.request(method='DELETE', uri=entry_or_uri.find_edit_link(),
+ http_request=http_request, auth_token=auth_token,
+ **kwargs)
+
+ Delete = delete
+
+ def batch(self, feed, uri=None, force=False, auth_token=None, **kwargs):
+ """Sends a batch request to the server to execute operation entries.
+
+ Args:
+ feed: A batch feed containing batch entries, each is an operation.
+ uri: (optional) The uri to which the batch request feed should be POSTed.
+ If none is provided, then the feed's edit link will be used.
+ force: (optional) boolean set to True if you want the batch update to
+ clobber all data. If False, the version in the information in the
+ feed object will cause the server to check to see that no changes
+ intervened between when you fetched the data and when you sent the
+ changes.
+ auth_token: (optional) An object which sets the Authorization HTTP header
+ in its modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others.
+ """
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(
+ feed.to_string(get_xml_version(self.api_version)),
+ 'application/atom+xml')
+ if force:
+ http_request.headers['If-Match'] = '*'
+ elif hasattr(feed, 'etag') and feed.etag:
+ http_request.headers['If-Match'] = feed.etag
+
+ if uri is None:
+ uri = feed.find_edit_link()
+
+ return self.request(method='POST', uri=uri, auth_token=auth_token,
+ http_request=http_request,
+ desired_class=feed.__class__, **kwargs)
+
+ Batch = batch
+
+ # TODO: add a refresh method to request a conditional update to an entry
+ # or feed.
+
+
+def _add_query_param(param_string, value, http_request):
+ if value:
+ http_request.uri.query[param_string] = value
+
+
+class Query(object):
+
+ def __init__(self, text_query=None, categories=None, author=None, alt=None,
+ updated_min=None, updated_max=None, pretty_print=False,
+ published_min=None, published_max=None, start_index=None,
+ max_results=None, strict=False, **custom_parameters):
+ """Constructs a Google Data Query to filter feed contents serverside.
+
+ Args:
+ text_query: Full text search str (optional)
+ categories: list of strings (optional). Each string is a required
+ category. To include an 'or' query, put a | in the string between
+ terms. For example, to find everything in the Fitz category and
+ the Laurie or Jane category (Fitz and (Laurie or Jane)) you would
+ set categories to ['Fitz', 'Laurie|Jane'].
+ author: str (optional) The service returns entries where the author
+ name and/or email address match your query string.
+ alt: str (optional) for the Alternative representation type you'd like
+ the feed in. If you don't specify an alt parameter, the service
+ returns an Atom feed. This is equivalent to alt='atom'.
+ alt='rss' returns an RSS 2.0 result feed.
+ alt='json' returns a JSON representation of the feed.
+ alt='json-in-script' Requests a response that wraps JSON in a script
+ tag.
+ alt='atom-in-script' Requests an Atom response that wraps an XML
+ string in a script tag.
+ alt='rss-in-script' Requests an RSS response that wraps an XML
+ string in a script tag.
+ updated_min: str (optional), RFC 3339 timestamp format, lower bounds.
+ For example: 2005-08-09T10:57:00-08:00
+ updated_max: str (optional) updated time must be earlier than timestamp.
+ pretty_print: boolean (optional) If True the server's XML response will
+ be indented to make it more human readable. Defaults to False.
+ published_min: str (optional), Similar to updated_min but for published
+ time.
+ published_max: str (optional), Similar to updated_max but for published
+ time.
+ start_index: int or str (optional) 1-based index of the first result to
+ be retrieved. Note that this isn't a general cursoring mechanism.
+ If you first send a query with ?start-index=1&max-results=10 and
+ then send another query with ?start-index=11&max-results=10, the
+ service cannot guarantee that the results are equivalent to
+ ?start-index=1&max-results=20, because insertions and deletions
+ could have taken place in between the two queries.
+ max_results: int or str (optional) Maximum number of results to be
+ retrieved. Each service has a default max (usually 25) which can
+ vary from service to service. There is also a service-specific
+ limit to the max_results you can fetch in a request.
+ strict: boolean (optional) If True, the server will return an error if
+ the server does not recognize any of the parameters in the request
+ URL. Defaults to False.
+ custom_parameters: other query parameters that are not explicitly defined.
+ """
+ self.text_query = text_query
+ self.categories = categories or []
+ self.author = author
+ self.alt = alt
+ self.updated_min = updated_min
+ self.updated_max = updated_max
+ self.pretty_print = pretty_print
+ self.published_min = published_min
+ self.published_max = published_max
+ self.start_index = start_index
+ self.max_results = max_results
+ self.strict = strict
+ self.custom_parameters = custom_parameters
+
+ def add_custom_parameter(self, key, value):
+ self.custom_parameters[key] = value
+
+ AddCustomParameter = add_custom_parameter
+
+ def modify_request(self, http_request):
+ _add_query_param('q', self.text_query, http_request)
+ if self.categories:
+ http_request.uri.query['category'] = ','.join(self.categories)
+ _add_query_param('author', self.author, http_request)
+ _add_query_param('alt', self.alt, http_request)
+ _add_query_param('updated-min', self.updated_min, http_request)
+ _add_query_param('updated-max', self.updated_max, http_request)
+ if self.pretty_print:
+ http_request.uri.query['prettyprint'] = 'true'
+ _add_query_param('published-min', self.published_min, http_request)
+ _add_query_param('published-max', self.published_max, http_request)
+ if self.start_index is not None:
+ http_request.uri.query['start-index'] = str(self.start_index)
+ if self.max_results is not None:
+ http_request.uri.query['max-results'] = str(self.max_results)
+ if self.strict:
+ http_request.uri.query['strict'] = 'true'
+ http_request.uri.query.update(self.custom_parameters)
+
+ ModifyRequest = modify_request
+
+
+class GDQuery(atom.http_core.Uri):
+
+ def _get_text_query(self):
+ return self.query['q']
+
+ def _set_text_query(self, value):
+ self.query['q'] = value
+
+ text_query = property(_get_text_query, _set_text_query,
+ doc='The q parameter for searching for an exact text match on content')
+
+
+class ResumableUploader(object):
+ """Resumable upload helper for the Google Data protocol."""
+
+ DEFAULT_CHUNK_SIZE = 5242880 # 5MB
+ # Initial chunks which are smaller than 256KB might be dropped. The last
+ # chunk for a file can be smaller tan this.
+ MIN_CHUNK_SIZE = 262144 # 256KB
+
+ def __init__(self, client, file_handle, content_type, total_file_size,
+ chunk_size=None, desired_class=None):
+ """Starts a resumable upload to a service that supports the protocol.
+
+ Args:
+ client: gdata.client.GDClient A Google Data API service.
+ file_handle: object A file-like object containing the file to upload.
+ content_type: str The mimetype of the file to upload.
+ total_file_size: int The file's total size in bytes.
+ chunk_size: int The size of each upload chunk. If None, the
+ DEFAULT_CHUNK_SIZE will be used.
+ desired_class: object (optional) The type of gdata.data.GDEntry to parse
+ the completed entry as. This should be specific to the API.
+ """
+ self.client = client
+ self.file_handle = file_handle
+ self.content_type = content_type
+ self.total_file_size = total_file_size
+ self.chunk_size = chunk_size or self.DEFAULT_CHUNK_SIZE
+ if self.chunk_size < self.MIN_CHUNK_SIZE:
+ self.chunk_size = self.MIN_CHUNK_SIZE
+ self.desired_class = desired_class or gdata.data.GDEntry
+ self.upload_uri = None
+
+ # Send the entire file if the chunk size is less than fize's total size.
+ if self.total_file_size <= self.chunk_size:
+ self.chunk_size = total_file_size
+
+ def _init_session(self, resumable_media_link, entry=None, headers=None,
+ auth_token=None, method='POST'):
+ """Starts a new resumable upload to a service that supports the protocol.
+
+ The method makes a request to initiate a new upload session. The unique
+ upload uri returned by the server (and set in this method) should be used
+ to send upload chunks to the server.
+
+ Args:
+ resumable_media_link: str The full URL for the #resumable-create-media or
+ #resumable-edit-media link for starting a resumable upload request or
+ updating media using a resumable PUT.
+ entry: A (optional) gdata.data.GDEntry containging metadata to create the
+ upload from.
+ headers: dict (optional) Additional headers to send in the initial request
+ to create the resumable upload request. These headers will override
+ any default headers sent in the request. For example:
+ headers={'Slug': 'MyTitle'}.
+ auth_token: (optional) An object which sets the Authorization HTTP header
+ in its modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others.
+ method: (optional) Type of HTTP request to start the session with.
+ Defaults to 'POST', but may also be 'PUT'.
+
+ Returns:
+ Result of HTTP request to intialize the session. See atom.client.request.
+
+ Raises:
+ RequestError if the unique upload uri is not set or the
+ server returns something other than an HTTP 308 when the upload is
+ incomplete.
+ """
+ http_request = atom.http_core.HttpRequest()
+
+ # Send empty body if Atom XML wasn't specified.
+ if entry is None:
+ http_request.add_body_part('', self.content_type, size=0)
+ else:
+ http_request.add_body_part(str(entry), 'application/atom+xml',
+ size=len(str(entry)))
+ http_request.headers['X-Upload-Content-Type'] = self.content_type
+ http_request.headers['X-Upload-Content-Length'] = str(self.total_file_size)
+
+ if headers is not None:
+ http_request.headers.update(headers)
+
+ response = self.client.request(method=method,
+ uri=resumable_media_link,
+ auth_token=auth_token,
+ http_request=http_request)
+
+ self.upload_uri = (response.getheader('location') or
+ response.getheader('Location'))
+
+ return response
+
+ _InitSession = _init_session
+
+ def upload_chunk(self, start_byte, content_bytes):
+ """Uploads a byte range (chunk) to the resumable upload server.
+
+ Args:
+ start_byte: int The byte offset of the total file where the byte range
+ passed in lives.
+ content_bytes: str The file contents of this chunk.
+
+ Returns:
+ The final Atom entry created on the server. The entry object's type will
+ be the class specified in self.desired_class.
+
+ Raises:
+ RequestError if the unique upload uri is not set or the
+ server returns something other than an HTTP 308 when the upload is
+ incomplete.
+ """
+ if self.upload_uri is None:
+ raise RequestError('Resumable upload request not initialized.')
+
+ # Adjustment if last byte range is less than defined chunk size.
+ chunk_size = self.chunk_size
+ if len(content_bytes) <= chunk_size:
+ chunk_size = len(content_bytes)
+
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(content_bytes, self.content_type,
+ size=len(content_bytes))
+ http_request.headers['Content-Range'] = ('bytes %s-%s/%s'
+ % (start_byte,
+ start_byte + chunk_size - 1,
+ self.total_file_size))
+
+ try:
+ response = self.client.request(method='PUT', uri=self.upload_uri,
+ http_request=http_request,
+ desired_class=self.desired_class)
+ return response
+ except RequestError, error:
+ if error.status == 308:
+ return None
+ else:
+ raise error
+
+ UploadChunk = upload_chunk
+
+ def upload_file(self, resumable_media_link, entry=None, headers=None,
+ auth_token=None, **kwargs):
+ """Uploads an entire file in chunks using the resumable upload protocol.
+
+ If you are interested in pausing an upload or controlling the chunking
+ yourself, use the upload_chunk() method instead.
+
+ Args:
+ resumable_media_link: str The full URL for the #resumable-create-media for
+ starting a resumable upload request.
+ entry: A (optional) gdata.data.GDEntry containging metadata to create the
+ upload from.
+ headers: dict Additional headers to send in the initial request to create
+ the resumable upload request. These headers will override any default
+ headers sent in the request. For example: headers={'Slug': 'MyTitle'}.
+ auth_token: (optional) An object which sets the Authorization HTTP header
+ in its modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others.
+ kwargs: (optional) Other args to pass to self._init_session.
+
+ Returns:
+ The final Atom entry created on the server. The entry object's type will
+ be the class specified in self.desired_class.
+
+ Raises:
+ RequestError if anything other than a HTTP 308 is returned
+ when the request raises an exception.
+ """
+ self._init_session(resumable_media_link, headers=headers,
+ auth_token=auth_token, entry=entry, **kwargs)
+
+ start_byte = 0
+ entry = None
+
+ while not entry:
+ entry = self.upload_chunk(
+ start_byte, self.file_handle.read(self.chunk_size))
+ start_byte += self.chunk_size
+
+ return entry
+
+ UploadFile = upload_file
+
+ def update_file(self, entry_or_resumable_edit_link, headers=None, force=False,
+ auth_token=None, update_metadata=False, uri_params=None):
+ """Updates the contents of an existing file using the resumable protocol.
+
+ If you are interested in pausing an upload or controlling the chunking
+ yourself, use the upload_chunk() method instead.
+
+ Args:
+ entry_or_resumable_edit_link: object or string A gdata.data.GDEntry for
+ the entry/file to update or the full uri of the link with rel
+ #resumable-edit-media.
+ headers: dict Additional headers to send in the initial request to create
+ the resumable upload request. These headers will override any default
+ headers sent in the request. For example: headers={'Slug': 'MyTitle'}.
+ force boolean (optional) True to force an update and set the If-Match
+ header to '*'. If False and entry_or_resumable_edit_link is a
+ gdata.data.GDEntry object, its etag value is used. Otherwise this
+ parameter should be set to True to force the update.
+ auth_token: (optional) An object which sets the Authorization HTTP header
+ in its modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others.
+ update_metadata: (optional) True to also update the entry's metadata
+ with that in the given GDEntry object in entry_or_resumable_edit_link.
+ uri_params: (optional) Dict of additional parameters to attach to the URI.
+ Some non-dict types are valid here, too, like list of tuple pairs.
+
+ Returns:
+ The final Atom entry created on the server. The entry object's type will
+ be the class specified in self.desired_class.
+
+ Raises:
+ RequestError if anything other than a HTTP 308 is returned when the
+ request raises an exception.
+ """
+
+ custom_headers = {}
+ if headers is not None:
+ custom_headers.update(headers)
+
+ uri = None
+ entry = None
+ if isinstance(entry_or_resumable_edit_link, gdata.data.GDEntry):
+ uri = entry_or_resumable_edit_link.find_url(
+ 'http://schemas.google.com/g/2005#resumable-edit-media')
+ custom_headers['If-Match'] = entry_or_resumable_edit_link.etag
+ if update_metadata:
+ entry = entry_or_resumable_edit_link
+ else:
+ uri = entry_or_resumable_edit_link
+
+ uri = atom.http_core.parse_uri(uri)
+ if uri_params is not None:
+ uri.query.update(uri_params)
+
+ if force:
+ custom_headers['If-Match'] = '*'
+
+ return self.upload_file(str(uri), entry=entry, headers=custom_headers,
+ auth_token=auth_token, method='PUT')
+
+ UpdateFile = update_file
+
+ def query_upload_status(self, uri=None):
+ """Queries the current status of a resumable upload request.
+
+ Args:
+ uri: str (optional) A resumable upload uri to query and override the one
+ that is set in this object.
+
+ Returns:
+ An integer representing the file position (byte) to resume the upload from
+ or True if the upload is complete.
+
+ Raises:
+ RequestError if anything other than a HTTP 308 is returned
+ when the request raises an exception.
+ """
+ # Override object's unique upload uri.
+ if uri is None:
+ uri = self.upload_uri
+
+ http_request = atom.http_core.HttpRequest()
+ http_request.headers['Content-Length'] = '0'
+ http_request.headers['Content-Range'] = 'bytes */%s' % self.total_file_size
+
+ try:
+ response = self.client.request(
+ method='POST', uri=uri, http_request=http_request)
+ if response.status == 201:
+ return True
+ else:
+ raise error_from_response(
+ '%s returned by server' % response.status, response, RequestError)
+ except RequestError, error:
+ if error.status == 308:
+ for pair in error.headers:
+ if pair[0].capitalize() == 'Range':
+ return int(pair[1].split('-')[1]) + 1
+ else:
+ raise error
+
+ QueryUploadStatus = query_upload_status
diff --git a/src/gdata/codesearch/__init__.py b/src/gdata/codesearch/__init__.py
new file mode 100644
index 0000000..fa23ef0
--- /dev/null
+++ b/src/gdata/codesearch/__init__.py
@@ -0,0 +1,136 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (c) 2007 Benoit Chesneau <benoitc@metavers.net>
+#
+# Permission to use, copy, modify, and distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+"""Contains extensions to Atom objects used by Google Codesearch"""
+
+__author__ = 'Benoit Chesneau'
+
+
+import atom
+import gdata
+
+
+CODESEARCH_NAMESPACE='http://schemas.google.com/codesearch/2006'
+CODESEARCH_TEMPLATE='{http://shema.google.com/codesearch/2006}%s'
+
+
+class Match(atom.AtomBase):
+ """ The Google Codesearch match element """
+ _tag = 'match'
+ _namespace = CODESEARCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['lineNumber'] = 'line_number'
+ _attributes['type'] = 'type'
+
+ def __init__(self, line_number=None, type=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.text = text
+ self.type = type
+ self.line_number = line_number
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class File(atom.AtomBase):
+ """ The Google Codesearch file element"""
+ _tag = 'file'
+ _namespace = CODESEARCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+
+ def __init__(self, name=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.text = text
+ self.name = name
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Package(atom.AtomBase):
+ """ The Google Codesearch package element"""
+ _tag = 'package'
+ _namespace = CODESEARCH_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+ _attributes['uri'] = 'uri'
+
+ def __init__(self, name=None, uri=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.text = text
+ self.name = name
+ self.uri = uri
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class CodesearchEntry(gdata.GDataEntry):
+ """ Google codesearch atom entry"""
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+ _children['{%s}file' % CODESEARCH_NAMESPACE] = ('file', File)
+ _children['{%s}package' % CODESEARCH_NAMESPACE] = ('package', Package)
+ _children['{%s}match' % CODESEARCH_NAMESPACE] = ('match', [Match])
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ match=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title,
+ updated=updated, text=None)
+
+ self.match = match or []
+
+
+def CodesearchEntryFromString(xml_string):
+ """Converts an XML string into a CodesearchEntry object.
+
+ Args:
+ xml_string: string The XML describing a Codesearch feed entry.
+
+ Returns:
+ A CodesearchEntry object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(CodesearchEntry, xml_string)
+
+
+class CodesearchFeed(gdata.GDataFeed):
+ """feed containing list of Google codesearch Items"""
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [CodesearchEntry])
+
+
+def CodesearchFeedFromString(xml_string):
+ """Converts an XML string into a CodesearchFeed object.
+ Args:
+ xml_string: string The XML describing a Codesearch feed.
+ Returns:
+ A CodeseartchFeed object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(CodesearchFeed, xml_string)
diff --git a/src/gdata/codesearch/service.py b/src/gdata/codesearch/service.py
new file mode 100644
index 0000000..1243d61
--- /dev/null
+++ b/src/gdata/codesearch/service.py
@@ -0,0 +1,110 @@
+# -*- coding: utf-8 -*-
+#
+# Copyright (c) 2007 Benoit Chesneau <benoitc@metavers.net>
+#
+# Permission to use, copy, modify, and distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+"""CodesearchService extends GDataService to streamline Google Codesearch
+operations"""
+
+
+__author__ = 'Benoit Chesneau'
+
+
+import atom
+import gdata.service
+import gdata.codesearch
+
+
+class CodesearchService(gdata.service.GDataService):
+ """Client extension for Google codesearch service"""
+ ssl = True
+
+ def __init__(self, email=None, password=None, source=None,
+ server='www.google.com', additional_headers=None, **kwargs):
+ """Creates a client for the Google codesearch service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'www.google.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='codesearch',
+ source=source, server=server, additional_headers=additional_headers,
+ **kwargs)
+
+ def Query(self, uri, converter=gdata.codesearch.CodesearchFeedFromString):
+ """Queries the Codesearch feed and returns the resulting feed of
+ entries.
+
+ Args:
+ uri: string The full URI to be queried. This can contain query
+ parameters, a hostname, or simply the relative path to a Document
+ List feed. The DocumentQuery object is useful when constructing
+ query parameters.
+ converter: func (optional) A function which will be executed on the
+ retrieved item, generally to render it into a Python object.
+ By default the CodesearchFeedFromString function is used to
+ return a CodesearchFeed object. This is because most feed
+ queries will result in a feed and not a single entry.
+
+ Returns :
+ A CodesearchFeed objects representing the feed returned by the server
+ """
+ return self.Get(uri, converter=converter)
+
+ def GetSnippetsFeed(self, text_query=None):
+ """Retrieve Codesearch feed for a keyword
+
+ Args:
+ text_query : string (optional) The contents of the q query parameter. This
+ string is URL escaped upon conversion to a URI.
+ Returns:
+ A CodesearchFeed objects representing the feed returned by the server
+ """
+
+ query=gdata.codesearch.service.CodesearchQuery(text_query=text_query)
+ feed = self.Query(query.ToUri())
+ return feed
+
+
+class CodesearchQuery(gdata.service.Query):
+ """Object used to construct the query to the Google Codesearch feed. here only as a shorcut"""
+
+ def __init__(self, feed='/codesearch/feeds/search', text_query=None,
+ params=None, categories=None):
+ """Constructor for Codesearch Query.
+
+ Args:
+ feed: string (optional) The path for the feed. (e.g. '/codesearch/feeds/search')
+ text_query: string (optional) The contents of the q query parameter. This
+ string is URL escaped upon conversion to a URI.
+ params: dict (optional) Parameter value string pairs which become URL
+ params when translated to a URI. These parameters are added to
+ the query's items.
+ categories: list (optional) List of category strings which should be
+ included as query categories. See gdata.service.Query for
+ additional documentation.
+
+ Yelds:
+ A CodesearchQuery object to construct a URI based on Codesearch feed
+ """
+
+ gdata.service.Query.__init__(self, feed, text_query, params, categories)
diff --git a/src/gdata/contacts/__init__.py b/src/gdata/contacts/__init__.py
new file mode 100644
index 0000000..41e7c31
--- /dev/null
+++ b/src/gdata/contacts/__init__.py
@@ -0,0 +1,740 @@
+#!/usr/bin/env python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains extensions to ElementWrapper objects used with Google Contacts."""
+
+__author__ = 'dbrattli (Dag Brattli)'
+
+
+import atom
+import gdata
+
+
+## Constants from http://code.google.com/apis/gdata/elements.html ##
+REL_HOME = 'http://schemas.google.com/g/2005#home'
+REL_WORK = 'http://schemas.google.com/g/2005#work'
+REL_OTHER = 'http://schemas.google.com/g/2005#other'
+
+# AOL Instant Messenger protocol
+IM_AIM = 'http://schemas.google.com/g/2005#AIM'
+IM_MSN = 'http://schemas.google.com/g/2005#MSN' # MSN Messenger protocol
+IM_YAHOO = 'http://schemas.google.com/g/2005#YAHOO' # Yahoo Messenger protocol
+IM_SKYPE = 'http://schemas.google.com/g/2005#SKYPE' # Skype protocol
+IM_QQ = 'http://schemas.google.com/g/2005#QQ' # QQ protocol
+# Google Talk protocol
+IM_GOOGLE_TALK = 'http://schemas.google.com/g/2005#GOOGLE_TALK'
+IM_ICQ = 'http://schemas.google.com/g/2005#ICQ' # ICQ protocol
+IM_JABBER = 'http://schemas.google.com/g/2005#JABBER' # Jabber protocol
+IM_NETMEETING = 'http://schemas.google.com/g/2005#netmeeting' # NetMeeting
+
+PHOTO_LINK_REL = 'http://schemas.google.com/contacts/2008/rel#photo'
+PHOTO_EDIT_LINK_REL = 'http://schemas.google.com/contacts/2008/rel#edit-photo'
+
+# Different phone types, for more info see:
+# http://code.google.com/apis/gdata/docs/2.0/elements.html#gdPhoneNumber
+PHONE_CAR = 'http://schemas.google.com/g/2005#car'
+PHONE_FAX = 'http://schemas.google.com/g/2005#fax'
+PHONE_GENERAL = 'http://schemas.google.com/g/2005#general'
+PHONE_HOME = REL_HOME
+PHONE_HOME_FAX = 'http://schemas.google.com/g/2005#home_fax'
+PHONE_INTERNAL = 'http://schemas.google.com/g/2005#internal-extension'
+PHONE_MOBILE = 'http://schemas.google.com/g/2005#mobile'
+PHONE_OTHER = REL_OTHER
+PHONE_PAGER = 'http://schemas.google.com/g/2005#pager'
+PHONE_SATELLITE = 'http://schemas.google.com/g/2005#satellite'
+PHONE_VOIP = 'http://schemas.google.com/g/2005#voip'
+PHONE_WORK = REL_WORK
+PHONE_WORK_FAX = 'http://schemas.google.com/g/2005#work_fax'
+PHONE_WORK_MOBILE = 'http://schemas.google.com/g/2005#work_mobile'
+PHONE_WORK_PAGER = 'http://schemas.google.com/g/2005#work_pager'
+PHONE_MAIN = 'http://schemas.google.com/g/2005#main'
+PHONE_ASSISTANT = 'http://schemas.google.com/g/2005#assistant'
+PHONE_CALLBACK = 'http://schemas.google.com/g/2005#callback'
+PHONE_COMPANY_MAIN = 'http://schemas.google.com/g/2005#company_main'
+PHONE_ISDN = 'http://schemas.google.com/g/2005#isdn'
+PHONE_OTHER_FAX = 'http://schemas.google.com/g/2005#other_fax'
+PHONE_RADIO = 'http://schemas.google.com/g/2005#radio'
+PHONE_TELEX = 'http://schemas.google.com/g/2005#telex'
+PHONE_TTY_TDD = 'http://schemas.google.com/g/2005#tty_tdd'
+
+EXTERNAL_ID_ORGANIZATION = 'organization'
+
+RELATION_MANAGER = 'manager'
+
+CONTACTS_NAMESPACE = 'http://schemas.google.com/contact/2008'
+
+
+class GDataBase(atom.AtomBase):
+ """The Google Contacts intermediate class from atom.AtomBase."""
+
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, text=None,
+ extension_elements=None, extension_attributes=None):
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class ContactsBase(GDataBase):
+ """The Google Contacts intermediate class for Contacts namespace."""
+
+ _namespace = CONTACTS_NAMESPACE
+
+
+class OrgName(GDataBase):
+ """The Google Contacts OrgName element."""
+
+ _tag = 'orgName'
+
+
+class OrgTitle(GDataBase):
+ """The Google Contacts OrgTitle element."""
+
+ _tag = 'orgTitle'
+
+
+class OrgDepartment(GDataBase):
+ """The Google Contacts OrgDepartment element."""
+
+ _tag = 'orgDepartment'
+
+
+class OrgJobDescription(GDataBase):
+ """The Google Contacts OrgJobDescription element."""
+
+ _tag = 'orgJobDescription'
+
+
+class Where(GDataBase):
+ """The Google Contacts Where element."""
+
+ _tag = 'where'
+ _children = GDataBase._children.copy()
+ _attributes = GDataBase._attributes.copy()
+ _attributes['rel'] = 'rel'
+ _attributes['label'] = 'label'
+ _attributes['valueString'] = 'value_string'
+
+ def __init__(self, value_string=None, rel=None, label=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ GDataBase.__init__(self, text=text, extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.rel = rel
+ self.label = label
+ self.value_string = value_string
+
+
+class When(GDataBase):
+ """The Google Contacts When element."""
+
+ _tag = 'when'
+ _children = GDataBase._children.copy()
+ _attributes = GDataBase._attributes.copy()
+ _attributes['startTime'] = 'start_time'
+ _attributes['endTime'] = 'end_time'
+ _attributes['label'] = 'label'
+
+ def __init__(self, start_time=None, end_time=None, label=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ GDataBase.__init__(self, text=text, extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.start_time = start_time
+ self.end_time = end_time
+ self.label = label
+
+
+class Organization(GDataBase):
+ """The Google Contacts Organization element."""
+
+ _tag = 'organization'
+ _children = GDataBase._children.copy()
+ _attributes = GDataBase._attributes.copy()
+ _attributes['label'] = 'label'
+ _attributes['rel'] = 'rel'
+ _attributes['primary'] = 'primary'
+ _children['{%s}orgName' % GDataBase._namespace] = (
+ 'org_name', OrgName)
+ _children['{%s}orgTitle' % GDataBase._namespace] = (
+ 'org_title', OrgTitle)
+ _children['{%s}orgDepartment' % GDataBase._namespace] = (
+ 'org_department', OrgDepartment)
+ _children['{%s}orgJobDescription' % GDataBase._namespace] = (
+ 'org_job_description', OrgJobDescription)
+ #_children['{%s}where' % GDataBase._namespace] = ('where', Where)
+
+ def __init__(self, label=None, rel=None, primary='false', org_name=None,
+ org_title=None, org_department=None, org_job_description=None,
+ where=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ GDataBase.__init__(self, text=text, extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.label = label
+ self.rel = rel or REL_OTHER
+ self.primary = primary
+ self.org_name = org_name
+ self.org_title = org_title
+ self.org_department = org_department
+ self.org_job_description = org_job_description
+ self.where = where
+
+
+class PostalAddress(GDataBase):
+ """The Google Contacts PostalAddress element."""
+
+ _tag = 'postalAddress'
+ _children = GDataBase._children.copy()
+ _attributes = GDataBase._attributes.copy()
+ _attributes['rel'] = 'rel'
+ _attributes['primary'] = 'primary'
+
+ def __init__(self, primary=None, rel=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ GDataBase.__init__(self, text=text, extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.rel = rel or REL_OTHER
+ self.primary = primary
+
+
+class FormattedAddress(GDataBase):
+ """The Google Contacts FormattedAddress element."""
+
+ _tag = 'formattedAddress'
+
+
+class StructuredPostalAddress(GDataBase):
+ """The Google Contacts StructuredPostalAddress element."""
+
+ _tag = 'structuredPostalAddress'
+ _children = GDataBase._children.copy()
+ _attributes = GDataBase._attributes.copy()
+ _attributes['rel'] = 'rel'
+ _attributes['primary'] = 'primary'
+ _children['{%s}formattedAddress' % GDataBase._namespace] = (
+ 'formatted_address', FormattedAddress)
+
+ def __init__(self, rel=None, primary=None,
+ formatted_address=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ GDataBase.__init__(self, text=text, extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.rel = rel or REL_OTHER
+ self.primary = primary
+ self.formatted_address = formatted_address
+
+
+class IM(GDataBase):
+ """The Google Contacts IM element."""
+
+ _tag = 'im'
+ _children = GDataBase._children.copy()
+ _attributes = GDataBase._attributes.copy()
+ _attributes['address'] = 'address'
+ _attributes['primary'] = 'primary'
+ _attributes['protocol'] = 'protocol'
+ _attributes['label'] = 'label'
+ _attributes['rel'] = 'rel'
+
+ def __init__(self, primary='false', rel=None, address=None, protocol=None,
+ label=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ GDataBase.__init__(self, text=text, extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.protocol = protocol
+ self.address = address
+ self.primary = primary
+ self.rel = rel or REL_OTHER
+ self.label = label
+
+
+class Email(GDataBase):
+ """The Google Contacts Email element."""
+
+ _tag = 'email'
+ _children = GDataBase._children.copy()
+ _attributes = GDataBase._attributes.copy()
+ _attributes['address'] = 'address'
+ _attributes['primary'] = 'primary'
+ _attributes['rel'] = 'rel'
+ _attributes['label'] = 'label'
+
+ def __init__(self, label=None, rel=None, address=None, primary='false',
+ text=None, extension_elements=None, extension_attributes=None):
+ GDataBase.__init__(self, text=text, extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.label = label
+ self.rel = rel or REL_OTHER
+ self.address = address
+ self.primary = primary
+
+
+class PhoneNumber(GDataBase):
+ """The Google Contacts PhoneNumber element."""
+
+ _tag = 'phoneNumber'
+ _children = GDataBase._children.copy()
+ _attributes = GDataBase._attributes.copy()
+ _attributes['label'] = 'label'
+ _attributes['rel'] = 'rel'
+ _attributes['uri'] = 'uri'
+ _attributes['primary'] = 'primary'
+
+ def __init__(self, label=None, rel=None, uri=None, primary='false',
+ text=None, extension_elements=None, extension_attributes=None):
+ GDataBase.__init__(self, text=text, extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.label = label
+ self.rel = rel or REL_OTHER
+ self.uri = uri
+ self.primary = primary
+
+
+class Nickname(ContactsBase):
+ """The Google Contacts Nickname element."""
+
+ _tag = 'nickname'
+
+
+class Occupation(ContactsBase):
+ """The Google Contacts Occupation element."""
+
+ _tag = 'occupation'
+
+
+class Gender(ContactsBase):
+ """The Google Contacts Gender element."""
+
+ _tag = 'gender'
+ _children = ContactsBase._children.copy()
+ _attributes = ContactsBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ ContactsBase.__init__(self, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.value = value
+
+
+class Birthday(ContactsBase):
+ """The Google Contacts Birthday element."""
+
+ _tag = 'birthday'
+ _children = ContactsBase._children.copy()
+ _attributes = ContactsBase._attributes.copy()
+ _attributes['when'] = 'when'
+
+ def __init__(self, when=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ ContactsBase.__init__(self, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.when = when
+
+
+class Relation(ContactsBase):
+ """The Google Contacts Relation element."""
+
+ _tag = 'relation'
+ _children = ContactsBase._children.copy()
+ _attributes = ContactsBase._attributes.copy()
+ _attributes['label'] = 'label'
+ _attributes['rel'] = 'rel'
+
+ def __init__(self, label=None, rel=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ ContactsBase.__init__(self, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.label = label
+ self.rel = rel
+
+
+def RelationFromString(xml_string):
+ return atom.CreateClassFromXMLString(Relation, xml_string)
+
+
+class UserDefinedField(ContactsBase):
+ """The Google Contacts UserDefinedField element."""
+
+ _tag = 'userDefinedField'
+ _children = ContactsBase._children.copy()
+ _attributes = ContactsBase._attributes.copy()
+ _attributes['key'] = 'key'
+ _attributes['value'] = 'value'
+
+ def __init__(self, key=None, value=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ ContactsBase.__init__(self, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.key = key
+ self.value = value
+
+
+def UserDefinedFieldFromString(xml_string):
+ return atom.CreateClassFromXMLString(UserDefinedField, xml_string)
+
+
+class Website(ContactsBase):
+ """The Google Contacts Website element."""
+
+ _tag = 'website'
+ _children = ContactsBase._children.copy()
+ _attributes = ContactsBase._attributes.copy()
+ _attributes['href'] = 'href'
+ _attributes['label'] = 'label'
+ _attributes['primary'] = 'primary'
+ _attributes['rel'] = 'rel'
+
+ def __init__(self, href=None, label=None, primary='false', rel=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ ContactsBase.__init__(self, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.href = href
+ self.label = label
+ self.primary = primary
+ self.rel = rel
+
+
+def WebsiteFromString(xml_string):
+ return atom.CreateClassFromXMLString(Website, xml_string)
+
+
+class ExternalId(ContactsBase):
+ """The Google Contacts ExternalId element."""
+
+ _tag = 'externalId'
+ _children = ContactsBase._children.copy()
+ _attributes = ContactsBase._attributes.copy()
+ _attributes['label'] = 'label'
+ _attributes['rel'] = 'rel'
+ _attributes['value'] = 'value'
+
+ def __init__(self, label=None, rel=None, value=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ ContactsBase.__init__(self, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.label = label
+ self.rel = rel
+ self.value = value
+
+
+def ExternalIdFromString(xml_string):
+ return atom.CreateClassFromXMLString(ExternalId, xml_string)
+
+
+class Event(ContactsBase):
+ """The Google Contacts Event element."""
+
+ _tag = 'event'
+ _children = ContactsBase._children.copy()
+ _attributes = ContactsBase._attributes.copy()
+ _attributes['label'] = 'label'
+ _attributes['rel'] = 'rel'
+ _children['{%s}when' % ContactsBase._namespace] = ('when', When)
+
+ def __init__(self, label=None, rel=None, when=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ ContactsBase.__init__(self, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.label = label
+ self.rel = rel
+ self.when = when
+
+
+def EventFromString(xml_string):
+ return atom.CreateClassFromXMLString(Event, xml_string)
+
+
+class Deleted(GDataBase):
+ """The Google Contacts Deleted element."""
+
+ _tag = 'deleted'
+
+
+class GroupMembershipInfo(ContactsBase):
+ """The Google Contacts GroupMembershipInfo element."""
+
+ _tag = 'groupMembershipInfo'
+
+ _children = ContactsBase._children.copy()
+ _attributes = ContactsBase._attributes.copy()
+ _attributes['deleted'] = 'deleted'
+ _attributes['href'] = 'href'
+
+ def __init__(self, deleted=None, href=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ ContactsBase.__init__(self, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.deleted = deleted
+ self.href = href
+
+
+class PersonEntry(gdata.BatchEntry):
+ """Base class for ContactEntry and ProfileEntry."""
+
+ _children = gdata.BatchEntry._children.copy()
+ _children['{%s}organization' % gdata.GDATA_NAMESPACE] = (
+ 'organization', [Organization])
+ _children['{%s}phoneNumber' % gdata.GDATA_NAMESPACE] = (
+ 'phone_number', [PhoneNumber])
+ _children['{%s}nickname' % CONTACTS_NAMESPACE] = ('nickname', Nickname)
+ _children['{%s}occupation' % CONTACTS_NAMESPACE] = ('occupation', Occupation)
+ _children['{%s}gender' % CONTACTS_NAMESPACE] = ('gender', Gender)
+ _children['{%s}birthday' % CONTACTS_NAMESPACE] = ('birthday', Birthday)
+ _children['{%s}postalAddress' % gdata.GDATA_NAMESPACE] = ('postal_address',
+ [PostalAddress])
+ _children['{%s}structuredPostalAddress' % gdata.GDATA_NAMESPACE] = (
+ 'structured_postal_address', [StructuredPostalAddress])
+ _children['{%s}email' % gdata.GDATA_NAMESPACE] = ('email', [Email])
+ _children['{%s}im' % gdata.GDATA_NAMESPACE] = ('im', [IM])
+ _children['{%s}relation' % CONTACTS_NAMESPACE] = ('relation', [Relation])
+ _children['{%s}userDefinedField' % CONTACTS_NAMESPACE] = (
+ 'user_defined_field', [UserDefinedField])
+ _children['{%s}website' % CONTACTS_NAMESPACE] = ('website', [Website])
+ _children['{%s}externalId' % CONTACTS_NAMESPACE] = (
+ 'external_id', [ExternalId])
+ _children['{%s}event' % CONTACTS_NAMESPACE] = ('event', [Event])
+ # The following line should be removed once the Python support
+ # for GData 2.0 is mature.
+ _attributes = gdata.BatchEntry._attributes.copy()
+ _attributes['{%s}etag' % gdata.GDATA_NAMESPACE] = 'etag'
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None, organization=None, phone_number=None,
+ nickname=None, occupation=None, gender=None, birthday=None,
+ postal_address=None, structured_postal_address=None, email=None,
+ im=None, relation=None, user_defined_field=None, website=None,
+ external_id=None, event=None, batch_operation=None,
+ batch_id=None, batch_status=None, text=None,
+ extension_elements=None, extension_attributes=None, etag=None):
+ gdata.BatchEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published,
+ batch_operation=batch_operation,
+ batch_id=batch_id, batch_status=batch_status,
+ title=title, updated=updated)
+ self.organization = organization or []
+ self.phone_number = phone_number or []
+ self.nickname = nickname
+ self.occupation = occupation
+ self.gender = gender
+ self.birthday = birthday
+ self.postal_address = postal_address or []
+ self.structured_postal_address = structured_postal_address or []
+ self.email = email or []
+ self.im = im or []
+ self.relation = relation or []
+ self.user_defined_field = user_defined_field or []
+ self.website = website or []
+ self.external_id = external_id or []
+ self.event = event or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ # The following line should be removed once the Python support
+ # for GData 2.0 is mature.
+ self.etag = etag
+
+
+class ContactEntry(PersonEntry):
+ """A Google Contact flavor of an Atom Entry."""
+
+ _children = PersonEntry._children.copy()
+
+ _children['{%s}deleted' % gdata.GDATA_NAMESPACE] = ('deleted', Deleted)
+ _children['{%s}groupMembershipInfo' % CONTACTS_NAMESPACE] = (
+ 'group_membership_info', [GroupMembershipInfo])
+ _children['{%s}extendedProperty' % gdata.GDATA_NAMESPACE] = (
+ 'extended_property', [gdata.ExtendedProperty])
+ # Overwrite the organization rule in PersonEntry so that a ContactEntry
+ # may only contain one <gd:organization> element.
+ _children['{%s}organization' % gdata.GDATA_NAMESPACE] = (
+ 'organization', Organization)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None, organization=None, phone_number=None,
+ nickname=None, occupation=None, gender=None, birthday=None,
+ postal_address=None, structured_postal_address=None, email=None,
+ im=None, relation=None, user_defined_field=None, website=None,
+ external_id=None, event=None, batch_operation=None,
+ batch_id=None, batch_status=None, text=None,
+ extension_elements=None, extension_attributes=None, etag=None,
+ deleted=None, extended_property=None,
+ group_membership_info=None):
+ PersonEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title, updated=updated,
+ organization=organization, phone_number=phone_number,
+ nickname=nickname, occupation=occupation,
+ gender=gender, birthday=birthday,
+ postal_address=postal_address,
+ structured_postal_address=structured_postal_address,
+ email=email, im=im, relation=relation,
+ user_defined_field=user_defined_field,
+ website=website, external_id=external_id, event=event,
+ batch_operation=batch_operation, batch_id=batch_id,
+ batch_status=batch_status, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes, etag=etag)
+ self.deleted = deleted
+ self.extended_property = extended_property or []
+ self.group_membership_info = group_membership_info or []
+
+ def GetPhotoLink(self):
+ for a_link in self.link:
+ if a_link.rel == PHOTO_LINK_REL:
+ return a_link
+ return None
+
+ def GetPhotoEditLink(self):
+ for a_link in self.link:
+ if a_link.rel == PHOTO_EDIT_LINK_REL:
+ return a_link
+ return None
+
+
+def ContactEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(ContactEntry, xml_string)
+
+
+class ContactsFeed(gdata.BatchFeed, gdata.LinkFinder):
+ """A Google Contacts feed flavor of an Atom Feed."""
+
+ _children = gdata.BatchFeed._children.copy()
+
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [ContactEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.BatchFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def ContactsFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(ContactsFeed, xml_string)
+
+
+class GroupEntry(gdata.BatchEntry):
+ """Represents a contact group."""
+ _children = gdata.BatchEntry._children.copy()
+ _children['{%s}extendedProperty' % gdata.GDATA_NAMESPACE] = (
+ 'extended_property', [gdata.ExtendedProperty])
+
+ def __init__(self, author=None, category=None, content=None,
+ contributor=None, atom_id=None, link=None, published=None,
+ rights=None, source=None, summary=None, control=None,
+ title=None, updated=None,
+ extended_property=None, batch_operation=None, batch_id=None,
+ batch_status=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ gdata.BatchEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ batch_operation=batch_operation,
+ batch_id=batch_id, batch_status=batch_status,
+ title=title, updated=updated)
+ self.extended_property = extended_property or []
+
+
+def GroupEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(GroupEntry, xml_string)
+
+
+class GroupsFeed(gdata.BatchFeed):
+ """A Google contact groups feed flavor of an Atom Feed."""
+ _children = gdata.BatchFeed._children.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [GroupEntry])
+
+
+def GroupsFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(GroupsFeed, xml_string)
+
+
+class ProfileEntry(PersonEntry):
+ """A Google Profiles flavor of an Atom Entry."""
+
+
+def ProfileEntryFromString(xml_string):
+ """Converts an XML string into a ProfileEntry object.
+
+ Args:
+ xml_string: string The XML describing a Profile entry.
+
+ Returns:
+ A ProfileEntry object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(ProfileEntry, xml_string)
+
+
+class ProfilesFeed(gdata.BatchFeed, gdata.LinkFinder):
+ """A Google Profiles feed flavor of an Atom Feed."""
+
+ _children = gdata.BatchFeed._children.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [ProfileEntry])
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.BatchFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+def ProfilesFeedFromString(xml_string):
+ """Converts an XML string into a ProfilesFeed object.
+
+ Args:
+ xml_string: string The XML describing a Profiles feed.
+
+ Returns:
+ A ProfilesFeed object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(ProfilesFeed, xml_string)
diff --git a/src/gdata/contacts/client.py b/src/gdata/contacts/client.py
new file mode 100644
index 0000000..9ae9cd7
--- /dev/null
+++ b/src/gdata/contacts/client.py
@@ -0,0 +1,547 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+from types import ListType, DictionaryType
+
+
+"""Contains a client to communicate with the Contacts servers.
+
+For documentation on the Contacts API, see:
+http://code.google.com/apis/contatcs/
+"""
+
+__author__ = 'vinces1979@gmail.com (Vince Spicer)'
+
+
+import gdata.client
+import gdata.contacts.data
+import atom.client
+import atom.data
+import atom.http_core
+import gdata.gauth
+
+DEFAULT_BATCH_URL = ('https://www.google.com/m8/feeds/contacts/default/full'
+ '/batch')
+DEFAULT_PROFILES_BATCH_URL = ('https://www.google.com/m8/feeds/profiles/domain/'
+ '%s/full/batch')
+
+class ContactsClient(gdata.client.GDClient):
+ api_version = '3'
+ auth_service = 'cp'
+ server = "www.google.com"
+ contact_list = "default"
+ auth_scopes = gdata.gauth.AUTH_SCOPES['cp']
+ ssl = True
+
+
+ def __init__(self, domain=None, auth_token=None, **kwargs):
+ """Constructs a new client for the Email Settings API.
+
+ Args:
+ domain: string The Google Apps domain (if any).
+ kwargs: The other parameters to pass to the gdata.client.GDClient
+ constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def get_feed_uri(self, kind='contacts', contact_list=None, projection='full',
+ scheme="https"):
+ """Builds a feed URI.
+
+ Args:
+ kind: The type of feed to return, typically 'groups' or 'contacts'.
+ Default value: 'contacts'.
+ contact_list: The contact list to return a feed for.
+ Default value: self.contact_list.
+ projection: The projection to apply to the feed contents, for example
+ 'full', 'base', 'base/12345', 'full/batch'. Default value: 'full'.
+ scheme: The URL scheme such as 'http' or 'https', None to return a
+ relative URI without hostname.
+
+ Returns:
+ A feed URI using the given kind, contact list, and projection.
+ Example: '/m8/feeds/contacts/default/full'.
+ """
+ contact_list = contact_list or self.contact_list
+ if kind == 'profiles':
+ contact_list = 'domain/%s' % self.domain
+ prefix = scheme and '%s://%s' % (scheme, self.server) or ''
+ return '%s/m8/feeds/%s/%s/%s' % (prefix, kind, contact_list, projection)
+
+ GetFeedUri = get_feed_uri
+
+ def get_contact(self, uri, desired_class=gdata.contacts.data.ContactEntry,
+ auth_token=None, **kwargs):
+ return self.get_entry(uri, auth_token=auth_token,
+ desired_class=desired_class, **kwargs)
+
+
+ GetContact = get_contact
+
+
+ def create_contact(self, new_contact, insert_uri=None, auth_token=None, **kwargs):
+ """Adds an new contact to Google Contacts.
+
+ Args:
+ new_contact: atom.Entry or subclass A new contact which is to be added to
+ Google Contacts.
+ insert_uri: the URL to post new contacts to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the contact created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ insert_uri = insert_uri or self.GetFeedUri()
+ return self.Post(new_contact, insert_uri,
+ auth_token=auth_token, **kwargs)
+
+ CreateContact = create_contact
+
+ def add_contact(self, new_contact, insert_uri=None, auth_token=None,
+ billing_information=None, birthday=None, calendar_link=None, **kwargs):
+ """Adds an new contact to Google Contacts.
+
+ Args:
+ new_contact: atom.Entry or subclass A new contact which is to be added to
+ Google Contacts.
+ insert_uri: the URL to post new contacts to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the contact created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+
+ contact = gdata.contacts.data.ContactEntry()
+
+ if billing_information is not None:
+ if not isinstance(billing_information, gdata.contacts.data.BillingInformation):
+ billing_information = gdata.contacts.data.BillingInformation(text=billing_information)
+
+ contact.billing_information = billing_information
+
+ if birthday is not None:
+ if not isinstance(birthday, gdata.contacts.data.Birthday):
+ birthday = gdata.contacts.data.Birthday(when=birthday)
+
+ contact.birthday = birthday
+
+ if calendar_link is not None:
+ if type(calendar_link) is not ListType:
+ calendar_link = [calendar_link]
+
+ for link in calendar_link:
+ if not isinstance(link, gdata.contacts.data.CalendarLink):
+ if type(link) is not DictionaryType:
+ raise TypeError, "calendar_link Requires dictionary not %s" % type(link)
+
+ link = gdata.contacts.data.CalendarLink(
+ rel=link.get("rel", None),
+ label=link.get("label", None),
+ primary=link.get("primary", None),
+ href=link.get("href", None),
+ )
+
+ contact.calendar_link.append(link)
+
+ insert_uri = insert_uri or self.GetFeedUri()
+ return self.Post(contact, insert_uri,
+ auth_token=auth_token, **kwargs)
+
+ AddContact = add_contact
+
+ def get_contacts(self, uri=None, desired_class=gdata.contacts.data.ContactsFeed,
+ auth_token=None, **kwargs):
+ """Obtains a feed with the contacts belonging to the current user.
+
+ Args:
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (desired_class=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.spreadsheets.data.SpreadsheetsFeed.
+ """
+ uri = uri or self.GetFeedUri()
+ return self.get_feed(uri, auth_token=auth_token,
+ desired_class=desired_class, **kwargs)
+
+ GetContacts = get_contacts
+
+ def get_group(self, uri=None, desired_class=gdata.contacts.data.GroupEntry,
+ auth_token=None, **kwargs):
+ """ Get a single groups details
+ Args:
+ uri: the group uri or id
+ """
+ return self.get_entry(uri, desired_class=desired_class, auth_token=auth_token, **kwargs)
+
+ GetGroup = get_group
+
+ def get_groups(self, uri=None, desired_class=gdata.contacts.data.GroupsFeed,
+ auth_token=None, **kwargs):
+ uri = uri or self.GetFeedUri('groups')
+ return self.get_feed(uri, desired_class=desired_class, auth_token=auth_token, **kwargs)
+
+ GetGroups = get_groups
+
+ def create_group(self, new_group, insert_uri=None, url_params=None,
+ desired_class=None, **kwargs):
+ insert_uri = insert_uri or self.GetFeedUri('groups')
+ return self.Post(new_group, insert_uri, url_params=url_params,
+ desired_class=desired_class, **kwargs)
+
+ CreateGroup = create_group
+
+ def update_group(self, edit_uri, updated_group, url_params=None,
+ escape_params=True, desired_class=None, auth_token=None, **kwargs):
+ return self.Put(updated_group, self._CleanUri(edit_uri),
+ url_params=url_params,
+ escape_params=escape_params,
+ desired_class=desired_class,
+ auth_token=auth_token, **kwargs)
+
+ UpdateGroup = update_group
+
+ def delete_group(self, group_object, auth_token=None, force=False, **kws):
+ return self.Delete(group_object, auth_token=auth_token, force=force, **kws)
+
+ DeleteGroup = delete_group
+
+ def change_photo(self, media, contact_entry_or_url, content_type=None,
+ content_length=None, auth_token=None, **kwargs):
+ """Change the photo for the contact by uploading a new photo.
+
+ Performs a PUT against the photo edit URL to send the binary data for the
+ photo.
+
+ Args:
+ media: filename, file-like-object, or a gdata.data.MediaSource object to send.
+ contact_entry_or_url: ContactEntry or str If it is a ContactEntry, this
+ method will search for an edit photo link URL and
+ perform a PUT to the URL.
+ content_type: str (optional) the mime type for the photo data. This is
+ necessary if media is a file or file name, but if media
+ is a MediaSource object then the media object can contain
+ the mime type. If media_type is set, it will override the
+ mime type in the media object.
+ content_length: int or str (optional) Specifying the content length is
+ only required if media is a file-like object. If media
+ is a filename, the length is determined using
+ os.path.getsize. If media is a MediaSource object, it is
+ assumed that it already contains the content length.
+ """
+ ifmatch_header = None
+ if isinstance(contact_entry_or_url, gdata.contacts.data.ContactEntry):
+ photo_link = contact_entry_or_url.GetPhotoLink()
+ uri = photo_link.href
+ ifmatch_header = atom.client.CustomHeaders(
+ **{'if-match': photo_link.etag})
+ else:
+ uri = contact_entry_or_url
+ if isinstance(media, gdata.data.MediaSource):
+ payload = media
+ # If the media object is a file-like object, then use it as the file
+ # handle in the in the MediaSource.
+ elif hasattr(media, 'read'):
+ payload = gdata.data.MediaSource(file_handle=media,
+ content_type=content_type, content_length=content_length)
+ # Assume that the media object is a file name.
+ else:
+ payload = gdata.data.MediaSource(content_type=content_type,
+ content_length=content_length, file_path=media)
+ return self.Put(uri=uri, data=payload, auth_token=auth_token,
+ ifmatch_header=ifmatch_header, **kwargs)
+
+ ChangePhoto = change_photo
+
+ def get_photo(self, contact_entry_or_url, auth_token=None, **kwargs):
+ """Retrives the binary data for the contact's profile photo as a string.
+
+ Args:
+ contact_entry_or_url: a gdata.contacts.ContactEntry object or a string
+ containing the photo link's URL. If the contact entry does not
+ contain a photo link, the image will not be fetched and this method
+ will return None.
+ """
+ # TODO: add the ability to write out the binary image data to a file,
+ # reading and writing a chunk at a time to avoid potentially using up
+ # large amounts of memory.
+ url = None
+ if isinstance(contact_entry_or_url, gdata.contacts.data.ContactEntry):
+ photo_link = contact_entry_or_url.GetPhotoLink()
+ if photo_link:
+ url = photo_link.href
+ else:
+ url = contact_entry_or_url
+ if url:
+ return self.Get(url, auth_token=auth_token, **kwargs).read()
+ else:
+ return None
+
+ GetPhoto = get_photo
+
+ def delete_photo(self, contact_entry_or_url, auth_token=None, **kwargs):
+ """Delete the contact's profile photo.
+
+ Args:
+ contact_entry_or_url: a gdata.contacts.ContactEntry object or a string
+ containing the photo link's URL.
+ """
+ uri = None
+ ifmatch_header = None
+ if isinstance(contact_entry_or_url, gdata.contacts.data.ContactEntry):
+ photo_link = contact_entry_or_url.GetPhotoLink()
+ if photo_link.etag:
+ uri = photo_link.href
+ ifmatch_header = atom.client.CustomHeaders(
+ **{'if-match': photo_link.etag})
+ else:
+ # No etag means no photo has been assigned to this contact.
+ return
+ else:
+ uri = contact_entry_or_url
+ if uri:
+ self.Delete(entry_or_uri=uri, auth_token=auth_token,
+ ifmatch_header=ifmatch_header, **kwargs)
+
+ DeletePhoto = delete_photo
+
+ def get_profiles_feed(self, uri=None, auth_token=None, **kwargs):
+ """Retrieves a feed containing all domain's profiles.
+
+ Args:
+ uri: string (optional) the URL to retrieve the profiles feed,
+ for example /m8/feeds/profiles/default/full
+
+ Returns:
+ On success, a ProfilesFeed containing the profiles.
+ On failure, raises a RequestError.
+ """
+
+ uri = uri or self.GetFeedUri('profiles')
+ return self.get_feed(uri, auth_token=auth_token,
+ desired_class=gdata.contacts.data.ProfilesFeed, **kwargs)
+
+ GetProfilesFeed = get_profiles_feed
+
+ def get_profile(self, uri, auth_token=None, **kwargs):
+ """Retrieves a domain's profile for the user.
+
+ Args:
+ uri: string the URL to retrieve the profiles feed,
+ for example /m8/feeds/profiles/default/full/username
+
+ Returns:
+ On success, a ProfileEntry containing the profile for the user.
+ On failure, raises a RequestError
+ """
+ return self.get_entry(uri,
+ desired_class=gdata.contacts.data.ProfileEntry,
+ auth_token=auth_token, **kwargs)
+
+ GetProfile = get_profile
+
+ def update_profile(self, updated_profile, auth_token=None, force=False, **kwargs):
+ """Updates an existing profile.
+
+ Args:
+ updated_profile: atom.Entry or subclass containing
+ the Atom Entry which will replace the profile which is
+ stored at the edit_url.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of ContactsClient.
+ force: boolean stating whether an update should be forced. Defaults to
+ False. Normally, if a change has been made since the passed in
+ entry was obtained, the server will not overwrite the entry since
+ the changes were based on an obsolete version of the entry.
+ Setting force to True will cause the update to silently
+ overwrite whatever version is present.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful update, a httplib.HTTPResponse containing the server's
+ response to the PUT request.
+ On failure, raises a RequestError.
+ """
+ return self.Update(updated_profile, auth_token=auth_token, force=force, **kwargs)
+
+ UpdateProfile = update_profile
+
+ def execute_batch(self, batch_feed, url=DEFAULT_BATCH_URL, desired_class=None,
+ auth_token=None, **kwargs):
+ """Sends a batch request feed to the server.
+
+ Args:
+ batch_feed: gdata.contacts.ContactFeed A feed containing batch
+ request entries. Each entry contains the operation to be performed
+ on the data contained in the entry. For example an entry with an
+ operation type of insert will be used as if the individual entry
+ had been inserted.
+ url: str The batch URL to which these operations should be applied.
+ converter: Function (optional) The function used to convert the server's
+ response to an object.
+
+ Returns:
+ The results of the batch request's execution on the server. If the
+ default converter is used, this is stored in a ContactsFeed.
+ """
+ return self.Post(batch_feed, url, desired_class=desired_class,
+ auth_token=None, **kwargs)
+
+ ExecuteBatch = execute_batch
+
+ def execute_batch_profiles(self, batch_feed, url=None,
+ desired_class=gdata.contacts.data.ProfilesFeed,
+ auth_token=None, **kwargs):
+ """Sends a batch request feed to the server.
+
+ Args:
+ batch_feed: gdata.profiles.ProfilesFeed A feed containing batch
+ request entries. Each entry contains the operation to be performed
+ on the data contained in the entry. For example an entry with an
+ operation type of insert will be used as if the individual entry
+ had been inserted.
+ url: string The batch URL to which these operations should be applied.
+ converter: Function (optional) The function used to convert the server's
+ response to an object. The default value is
+ gdata.profiles.ProfilesFeedFromString.
+
+ Returns:
+ The results of the batch request's execution on the server. If the
+ default converter is used, this is stored in a ProfilesFeed.
+ """
+ url = url or (DEFAULT_PROFILES_BATCH_URL % self.domain)
+ return self.Post(batch_feed, url, desired_class=desired_class,
+ auth_token=auth_token, **kwargs)
+
+ ExecuteBatchProfiles = execute_batch_profiles
+
+ def _CleanUri(self, uri):
+ """Sanitizes a feed URI.
+
+ Args:
+ uri: The URI to sanitize, can be relative or absolute.
+
+ Returns:
+ The given URI without its http://server prefix, if any.
+ Keeps the leading slash of the URI.
+ """
+ url_prefix = 'http://%s' % self.server
+ if uri.startswith(url_prefix):
+ uri = uri[len(url_prefix):]
+ return uri
+
+class ContactsQuery(gdata.client.Query):
+ """
+ Create a custom Contacts Query
+
+ Full specs can be found at: U{Contacts query parameters reference
+ <http://code.google.com/apis/contacts/docs/3.0/reference.html#Parameters>}
+ """
+
+ def __init__(self, feed=None, group=None, orderby=None, showdeleted=None,
+ sortorder=None, requirealldeleted=None, **kwargs):
+ """
+ @param max_results: The maximum number of entries to return. If you want
+ to receive all of the contacts, rather than only the default maximum, you
+ can specify a very large number for max-results.
+ @param start-index: The 1-based index of the first result to be retrieved.
+ @param updated-min: The lower bound on entry update dates.
+ @param group: Constrains the results to only the contacts belonging to the
+ group specified. Value of this parameter specifies group ID
+ @param orderby: Sorting criterion. The only supported value is
+ lastmodified.
+ @param showdeleted: Include deleted contacts in the returned contacts feed
+ @pram sortorder: Sorting order direction. Can be either ascending or
+ descending.
+ @param requirealldeleted: Only relevant if showdeleted and updated-min
+ are also provided. It dictates the behavior of the server in case it
+ detects that placeholders of some entries deleted since the point in
+ time specified as updated-min may have been lost.
+ """
+ gdata.client.Query.__init__(self, **kwargs)
+ self.group = group
+ self.orderby = orderby
+ self.sortorder = sortorder
+ self.showdeleted = showdeleted
+
+ def modify_request(self, http_request):
+ if self.group:
+ gdata.client._add_query_param('group', self.group, http_request)
+ if self.orderby:
+ gdata.client._add_query_param('orderby', self.orderby, http_request)
+ if self.sortorder:
+ gdata.client._add_query_param('sortorder', self.sortorder, http_request)
+ if self.showdeleted:
+ gdata.client._add_query_param('showdeleted', self.showdeleted, http_request)
+ gdata.client.Query.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
+
+
+class ProfilesQuery(gdata.client.Query):
+ """
+ Create a custom Profiles Query
+
+ Full specs can be found at: U{Profiless query parameters reference
+ <http://code.google.com/apis/apps/profiles/reference.html#Parameters>}
+ """
+
+ def __init__(self, feed=None, start_key=None, **kwargs):
+ """
+ @param start_key: Opaque key of the first element to retrieve. Present in
+ the next link of an earlier request, if further pages of response are
+ available.
+ """
+ gdata.client.Query.__init__(self, **kwargs)
+ self.feed = feed or 'https://www.google.com/m8/feeds/profiles/default/full'
+ self.start_key = start_key
+
+ def modify_request(self, http_request):
+ if self.start_key:
+ gdata.client._add_query_param('start-key', self.start_key, http_request)
+ gdata.client.Query.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
diff --git a/src/gdata/contacts/data.py b/src/gdata/contacts/data.py
new file mode 100644
index 0000000..1de540c
--- /dev/null
+++ b/src/gdata/contacts/data.py
@@ -0,0 +1,493 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for parsing and generating XML for the Contacts API."""
+
+
+__author__ = 'vinces1979@gmail.com (Vince Spicer)'
+
+
+import atom.core
+import gdata
+import gdata.data
+
+
+PHOTO_LINK_REL = 'http://schemas.google.com/contacts/2008/rel#photo'
+PHOTO_EDIT_LINK_REL = 'http://schemas.google.com/contacts/2008/rel#edit-photo'
+
+EXTERNAL_ID_ORGANIZATION = 'organization'
+
+RELATION_MANAGER = 'manager'
+
+CONTACTS_NAMESPACE = 'http://schemas.google.com/contact/2008'
+CONTACTS_TEMPLATE = '{%s}%%s' % CONTACTS_NAMESPACE
+
+
+class BillingInformation(atom.core.XmlElement):
+ """
+ gContact:billingInformation
+ Specifies billing information of the entity represented by the contact. The element cannot be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'billingInformation'
+
+
+class Birthday(atom.core.XmlElement):
+ """
+ Stores birthday date of the person represented by the contact. The element cannot be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'birthday'
+ when = 'when'
+
+
+class ContactLink(atom.data.Link):
+ """
+ Extends atom.data.Link to add gd:etag attribute for photo link.
+ """
+ etag = gdata.data.GD_TEMPLATE % 'etag'
+
+
+class CalendarLink(atom.core.XmlElement):
+ """
+ Storage for URL of the contact's calendar. The element can be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'calendarLink'
+ rel = 'rel'
+ label = 'label'
+ primary = 'primary'
+ href = 'href'
+
+
+class DirectoryServer(atom.core.XmlElement):
+ """
+ A directory server associated with this contact.
+ May not be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'directoryServer'
+
+
+class Event(atom.core.XmlElement):
+ """
+ These elements describe events associated with a contact.
+ They may be repeated
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'event'
+ label = 'label'
+ rel = 'rel'
+ when = gdata.data.When
+
+
+class ExternalId(atom.core.XmlElement):
+ """
+ Describes an ID of the contact in an external system of some kind.
+ This element may be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'externalId'
+ label = 'label'
+ rel = 'rel'
+ value = 'value'
+
+
+def ExternalIdFromString(xml_string):
+ return atom.core.parse(ExternalId, xml_string)
+
+
+class Gender(atom.core.XmlElement):
+ """
+ Specifies the gender of the person represented by the contact.
+ The element cannot be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'gender'
+ value = 'value'
+
+
+class Hobby(atom.core.XmlElement):
+ """
+ Describes an ID of the contact in an external system of some kind.
+ This element may be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'hobby'
+
+
+class Initials(atom.core.XmlElement):
+ """ Specifies the initials of the person represented by the contact. The
+ element cannot be repeated. """
+
+ _qname = CONTACTS_TEMPLATE % 'initials'
+
+
+class Jot(atom.core.XmlElement):
+ """
+ Storage for arbitrary pieces of information about the contact. Each jot
+ has a type specified by the rel attribute and a text value.
+ The element can be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'jot'
+ rel = 'rel'
+
+
+class Language(atom.core.XmlElement):
+ """
+ Specifies the preferred languages of the contact.
+ The element can be repeated.
+
+ The language must be specified using one of two mutually exclusive methods:
+ using the freeform @label attribute, or using the @code attribute, whose value
+ must conform to the IETF BCP 47 specification.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'language'
+ code = 'code'
+ label = 'label'
+
+
+class MaidenName(atom.core.XmlElement):
+ """
+ Specifies maiden name of the person represented by the contact.
+ The element cannot be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'maidenName'
+
+
+class Mileage(atom.core.XmlElement):
+ """
+ Specifies the mileage for the entity represented by the contact.
+ Can be used for example to document distance needed for reimbursement
+ purposes. The value is not interpreted. The element cannot be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'mileage'
+
+
+class NickName(atom.core.XmlElement):
+ """
+ Specifies the nickname of the person represented by the contact.
+ The element cannot be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'nickname'
+
+
+class Occupation(atom.core.XmlElement):
+ """
+ Specifies the occupation/profession of the person specified by the contact.
+ The element cannot be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'occupation'
+
+
+class Priority(atom.core.XmlElement):
+ """
+ Classifies importance of the contact into 3 categories:
+ * Low
+ * Normal
+ * High
+
+ The priority element cannot be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'priority'
+
+
+class Relation(atom.core.XmlElement):
+ """
+ This element describe another entity (usually a person) that is in a
+ relation of some kind with the contact.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'relation'
+ rel = 'rel'
+ label = 'label'
+
+
+class Sensitivity(atom.core.XmlElement):
+ """
+ Classifies sensitivity of the contact into the following categories:
+ * Confidential
+ * Normal
+ * Personal
+ * Private
+
+ The sensitivity element cannot be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'sensitivity'
+ rel = 'rel'
+
+
+class UserDefinedField(atom.core.XmlElement):
+ """
+ Represents an arbitrary key-value pair attached to the contact.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'userDefinedField'
+ key = 'key'
+ value = 'value'
+
+
+def UserDefinedFieldFromString(xml_string):
+ return atom.core.parse(UserDefinedField, xml_string)
+
+
+class Website(atom.core.XmlElement):
+ """
+ Describes websites associated with the contact, including links.
+ May be repeated.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'website'
+
+ href = 'href'
+ label = 'label'
+ primary = 'primary'
+ rel = 'rel'
+
+
+def WebsiteFromString(xml_string):
+ return atom.core.parse(Website, xml_string)
+
+
+class HouseName(atom.core.XmlElement):
+ """
+ Used in places where houses or buildings have names (and
+ not necessarily numbers), eg. "The Pillars".
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'housename'
+
+
+class Street(atom.core.XmlElement):
+ """
+ Can be street, avenue, road, etc. This element also includes the house
+ number and room/apartment/flat/floor number.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'street'
+
+
+class POBox(atom.core.XmlElement):
+ """
+ Covers actual P.O. boxes, drawers, locked bags, etc. This is usually but not
+ always mutually exclusive with street
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'pobox'
+
+
+class Neighborhood(atom.core.XmlElement):
+ """
+ This is used to disambiguate a street address when a city contains more than
+ one street with the same name, or to specify a small place whose mail is
+ routed through a larger postal town. In China it could be a county or a
+ minor city.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'neighborhood'
+
+
+class City(atom.core.XmlElement):
+ """
+ Can be city, village, town, borough, etc. This is the postal town and not
+ necessarily the place of residence or place of business.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'city'
+
+
+class SubRegion(atom.core.XmlElement):
+ """
+ Handles administrative districts such as U.S. or U.K. counties that are not
+ used for mail addressing purposes. Subregion is not intended for
+ delivery addresses.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'subregion'
+
+
+class Region(atom.core.XmlElement):
+ """
+ A state, province, county (in Ireland), Land (in Germany),
+ departement (in France), etc.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'region'
+
+
+class PostalCode(atom.core.XmlElement):
+ """
+ Postal code. Usually country-wide, but sometimes specific to the
+ city (e.g. "2" in "Dublin 2, Ireland" addresses).
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'postcode'
+
+
+class Country(atom.core.XmlElement):
+ """ The name or code of the country. """
+
+ _qname = CONTACTS_TEMPLATE % 'country'
+
+
+class Status(atom.core.XmlElement):
+ """Person's status element."""
+
+ _qname = CONTACTS_TEMPLATE % 'status'
+ indexed = 'indexed'
+
+
+class PersonEntry(gdata.data.BatchEntry):
+ """Represents a google contact"""
+
+ link = [ContactLink]
+
+ billing_information = BillingInformation
+ birthday = Birthday
+ calendar_link = [CalendarLink]
+ directory_server = DirectoryServer
+ event = [Event]
+ external_id = [ExternalId]
+ gender = Gender
+ hobby = [Hobby]
+ initials = Initials
+ jot = [Jot]
+ language= [Language]
+ maiden_name = MaidenName
+ mileage = Mileage
+ nickname = NickName
+ occupation = Occupation
+ priority = Priority
+ relation = [Relation]
+ sensitivity = Sensitivity
+ user_defined_field = [UserDefinedField]
+ website = [Website]
+
+ name = gdata.data.Name
+ phone_number = [gdata.data.PhoneNumber]
+ organization = gdata.data.Organization
+ postal_address = [gdata.data.PostalAddress]
+ email = [gdata.data.Email]
+ im = [gdata.data.Im]
+ structured_postal_address = [gdata.data.StructuredPostalAddress]
+ extended_property = [gdata.data.ExtendedProperty]
+
+ status = Status
+
+
+class Deleted(atom.core.XmlElement):
+ """If present, indicates that this contact has been deleted."""
+ _qname = gdata.GDATA_TEMPLATE % 'deleted'
+
+
+class GroupMembershipInfo(atom.core.XmlElement):
+ """
+ Identifies the group to which the contact belongs or belonged.
+ The group is referenced by its id.
+ """
+
+ _qname = CONTACTS_TEMPLATE % 'groupMembershipInfo'
+
+ href = 'href'
+ deleted = 'deleted'
+
+
+class ContactEntry(PersonEntry):
+ """A Google Contacts flavor of an Atom Entry."""
+
+ deleted = Deleted
+ group_membership_info = [GroupMembershipInfo]
+ organization = gdata.data.Organization
+
+ def GetPhotoLink(self):
+ for a_link in self.link:
+ if a_link.rel == PHOTO_LINK_REL:
+ return a_link
+ return None
+
+ def GetPhotoEditLink(self):
+ for a_link in self.link:
+ if a_link.rel == PHOTO_EDIT_LINK_REL:
+ return a_link
+ return None
+
+
+class ContactsFeed(gdata.data.BatchFeed):
+ """A collection of Contacts."""
+ entry = [ContactEntry]
+
+
+class SystemGroup(atom.core.XmlElement):
+ """The contacts systemGroup element.
+
+ When used within a contact group entry, indicates that the group in
+ question is one of the predefined system groups."""
+
+ _qname = CONTACTS_TEMPLATE % 'systemGroup'
+ id = 'id'
+
+
+class GroupEntry(gdata.data.BatchEntry):
+ """Represents a contact group."""
+ extended_property = [gdata.data.ExtendedProperty]
+ system_group = SystemGroup
+
+
+class GroupsFeed(gdata.data.BatchFeed):
+ """A Google contact groups feed flavor of an Atom Feed."""
+ entry = [GroupEntry]
+
+
+class ProfileEntry(PersonEntry):
+ """A Google Profiles flavor of an Atom Entry."""
+
+
+def ProfileEntryFromString(xml_string):
+ """Converts an XML string into a ProfileEntry object.
+
+ Args:
+ xml_string: string The XML describing a Profile entry.
+
+ Returns:
+ A ProfileEntry object corresponding to the given XML.
+ """
+ return atom.core.parse(ProfileEntry, xml_string)
+
+
+class ProfilesFeed(gdata.data.BatchFeed):
+ """A Google Profiles feed flavor of an Atom Feed."""
+ _qname = atom.data.ATOM_TEMPLATE % 'feed'
+ entry = [ProfileEntry]
+
+
+def ProfilesFeedFromString(xml_string):
+ """Converts an XML string into a ProfilesFeed object.
+
+ Args:
+ xml_string: string The XML describing a Profiles feed.
+
+ Returns:
+ A ProfilesFeed object corresponding to the given XML.
+ """
+ return atom.core.parse(ProfilesFeed, xml_string)
diff --git a/src/gdata/contacts/service.py b/src/gdata/contacts/service.py
new file mode 100644
index 0000000..4b017c0
--- /dev/null
+++ b/src/gdata/contacts/service.py
@@ -0,0 +1,427 @@
+#!/usr/bin/env python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""ContactsService extends the GDataService for Google Contacts operations.
+
+ ContactsService: Provides methods to query feeds and manipulate items.
+ Extends GDataService.
+
+ DictionaryToParamList: Function which converts a dictionary into a list of
+ URL arguments (represented as strings). This is a
+ utility function used in CRUD operations.
+"""
+
+__author__ = 'dbrattli (Dag Brattli)'
+
+
+import gdata
+import gdata.calendar
+import gdata.service
+
+
+DEFAULT_BATCH_URL = ('http://www.google.com/m8/feeds/contacts/default/full'
+ '/batch')
+DEFAULT_PROFILES_BATCH_URL = ('http://www.google.com'
+ '/m8/feeds/profiles/default/full/batch')
+
+GDATA_VER_HEADER = 'GData-Version'
+
+
+class Error(Exception):
+ pass
+
+
+class RequestError(Error):
+ pass
+
+
+class ContactsService(gdata.service.GDataService):
+ """Client for the Google Contacts service."""
+
+ def __init__(self, email=None, password=None, source=None,
+ server='www.google.com', additional_headers=None,
+ contact_list='default', **kwargs):
+ """Creates a client for the Contacts service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'www.google.com'.
+ contact_list: string (optional) The name of the default contact list to
+ use when no URI is specified to the methods of the service.
+ Default value: 'default' (the logged in user's contact list).
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+
+ self.contact_list = contact_list
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='cp', source=source,
+ server=server, additional_headers=additional_headers, **kwargs)
+
+ def GetFeedUri(self, kind='contacts', contact_list=None, projection='full',
+ scheme=None):
+ """Builds a feed URI.
+
+ Args:
+ kind: The type of feed to return, typically 'groups' or 'contacts'.
+ Default value: 'contacts'.
+ contact_list: The contact list to return a feed for.
+ Default value: self.contact_list.
+ projection: The projection to apply to the feed contents, for example
+ 'full', 'base', 'base/12345', 'full/batch'. Default value: 'full'.
+ scheme: The URL scheme such as 'http' or 'https', None to return a
+ relative URI without hostname.
+
+ Returns:
+ A feed URI using the given kind, contact list, and projection.
+ Example: '/m8/feeds/contacts/default/full'.
+ """
+ contact_list = contact_list or self.contact_list
+ if kind == 'profiles':
+ contact_list = 'domain/%s' % contact_list
+ prefix = scheme and '%s://%s' % (scheme, self.server) or ''
+ return '%s/m8/feeds/%s/%s/%s' % (prefix, kind, contact_list, projection)
+
+ def GetContactsFeed(self, uri=None):
+ uri = uri or self.GetFeedUri()
+ return self.Get(uri, converter=gdata.contacts.ContactsFeedFromString)
+
+ def GetContact(self, uri):
+ return self.Get(uri, converter=gdata.contacts.ContactEntryFromString)
+
+ def CreateContact(self, new_contact, insert_uri=None, url_params=None,
+ escape_params=True):
+ """Adds an new contact to Google Contacts.
+
+ Args:
+ new_contact: atom.Entry or subclass A new contact which is to be added to
+ Google Contacts.
+ insert_uri: the URL to post new contacts to the feed
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful insert, an entry containing the contact created
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ insert_uri = insert_uri or self.GetFeedUri()
+ return self.Post(new_contact, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.contacts.ContactEntryFromString)
+
+ def UpdateContact(self, edit_uri, updated_contact, url_params=None,
+ escape_params=True):
+ """Updates an existing contact.
+
+ Args:
+ edit_uri: string The edit link URI for the element being updated
+ updated_contact: string, atom.Entry or subclass containing
+ the Atom Entry which will replace the contact which is
+ stored at the edit_url
+ url_params: dict (optional) Additional URL parameters to be included
+ in the update request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful update, a httplib.HTTPResponse containing the server's
+ response to the PUT request.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ return self.Put(updated_contact, self._CleanUri(edit_uri),
+ url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.contacts.ContactEntryFromString)
+
+ def DeleteContact(self, edit_uri, extra_headers=None,
+ url_params=None, escape_params=True):
+ """Removes an contact with the specified ID from Google Contacts.
+
+ Args:
+ edit_uri: string The edit URL of the entry to be deleted. Example:
+ '/m8/feeds/contacts/default/full/xxx/yyy'
+ url_params: dict (optional) Additional URL parameters to be included
+ in the deletion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful delete, a httplib.HTTPResponse containing the server's
+ response to the DELETE request.
+ On failure, a RequestError is raised of the form:
+ {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response}
+ """
+ return self.Delete(self._CleanUri(edit_uri),
+ url_params=url_params, escape_params=escape_params)
+
+ def GetGroupsFeed(self, uri=None):
+ uri = uri or self.GetFeedUri('groups')
+ return self.Get(uri, converter=gdata.contacts.GroupsFeedFromString)
+
+ def CreateGroup(self, new_group, insert_uri=None, url_params=None,
+ escape_params=True):
+ insert_uri = insert_uri or self.GetFeedUri('groups')
+ return self.Post(new_group, insert_uri, url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.contacts.GroupEntryFromString)
+
+ def UpdateGroup(self, edit_uri, updated_group, url_params=None,
+ escape_params=True):
+ return self.Put(updated_group, self._CleanUri(edit_uri),
+ url_params=url_params,
+ escape_params=escape_params,
+ converter=gdata.contacts.GroupEntryFromString)
+
+ def DeleteGroup(self, edit_uri, extra_headers=None,
+ url_params=None, escape_params=True):
+ return self.Delete(self._CleanUri(edit_uri),
+ url_params=url_params, escape_params=escape_params)
+
+ def ChangePhoto(self, media, contact_entry_or_url, content_type=None,
+ content_length=None):
+ """Change the photo for the contact by uploading a new photo.
+
+ Performs a PUT against the photo edit URL to send the binary data for the
+ photo.
+
+ Args:
+ media: filename, file-like-object, or a gdata.MediaSource object to send.
+ contact_entry_or_url: ContactEntry or str If it is a ContactEntry, this
+ method will search for an edit photo link URL and
+ perform a PUT to the URL.
+ content_type: str (optional) the mime type for the photo data. This is
+ necessary if media is a file or file name, but if media
+ is a MediaSource object then the media object can contain
+ the mime type. If media_type is set, it will override the
+ mime type in the media object.
+ content_length: int or str (optional) Specifying the content length is
+ only required if media is a file-like object. If media
+ is a filename, the length is determined using
+ os.path.getsize. If media is a MediaSource object, it is
+ assumed that it already contains the content length.
+ """
+ if isinstance(contact_entry_or_url, gdata.contacts.ContactEntry):
+ url = contact_entry_or_url.GetPhotoEditLink().href
+ else:
+ url = contact_entry_or_url
+ if isinstance(media, gdata.MediaSource):
+ payload = media
+ # If the media object is a file-like object, then use it as the file
+ # handle in the in the MediaSource.
+ elif hasattr(media, 'read'):
+ payload = gdata.MediaSource(file_handle=media,
+ content_type=content_type, content_length=content_length)
+ # Assume that the media object is a file name.
+ else:
+ payload = gdata.MediaSource(content_type=content_type,
+ content_length=content_length, file_path=media)
+ return self.Put(payload, url)
+
+ def GetPhoto(self, contact_entry_or_url):
+ """Retrives the binary data for the contact's profile photo as a string.
+
+ Args:
+ contact_entry_or_url: a gdata.contacts.ContactEntry objecr or a string
+ containing the photo link's URL. If the contact entry does not
+ contain a photo link, the image will not be fetched and this method
+ will return None.
+ """
+ # TODO: add the ability to write out the binary image data to a file,
+ # reading and writing a chunk at a time to avoid potentially using up
+ # large amounts of memory.
+ url = None
+ if isinstance(contact_entry_or_url, gdata.contacts.ContactEntry):
+ photo_link = contact_entry_or_url.GetPhotoLink()
+ if photo_link:
+ url = photo_link.href
+ else:
+ url = contact_entry_or_url
+ if url:
+ return self.Get(url, converter=str)
+ else:
+ return None
+
+ def DeletePhoto(self, contact_entry_or_url):
+ url = None
+ if isinstance(contact_entry_or_url, gdata.contacts.ContactEntry):
+ url = contact_entry_or_url.GetPhotoEditLink().href
+ else:
+ url = contact_entry_or_url
+ if url:
+ self.Delete(url)
+
+ def GetProfilesFeed(self, uri=None):
+ """Retrieves a feed containing all domain's profiles.
+
+ Args:
+ uri: string (optional) the URL to retrieve the profiles feed,
+ for example /m8/feeds/profiles/default/full
+
+ Returns:
+ On success, a ProfilesFeed containing the profiles.
+ On failure, raises a RequestError.
+ """
+
+ uri = uri or self.GetFeedUri('profiles')
+ return self.Get(uri,
+ converter=gdata.contacts.ProfilesFeedFromString)
+
+ def GetProfile(self, uri):
+ """Retrieves a domain's profile for the user.
+
+ Args:
+ uri: string the URL to retrieve the profiles feed,
+ for example /m8/feeds/profiles/default/full/username
+
+ Returns:
+ On success, a ProfileEntry containing the profile for the user.
+ On failure, raises a RequestError
+ """
+ return self.Get(uri,
+ converter=gdata.contacts.ProfileEntryFromString)
+
+ def UpdateProfile(self, edit_uri, updated_profile, url_params=None,
+ escape_params=True):
+ """Updates an existing profile.
+
+ Args:
+ edit_uri: string The edit link URI for the element being updated
+ updated_profile: string atom.Entry or subclass containing
+ the Atom Entry which will replace the profile which is
+ stored at the edit_url.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the update request.
+ escape_params: boolean (optional) If true, the url_params will be
+ escaped before they are included in the request.
+
+ Returns:
+ On successful update, a httplib.HTTPResponse containing the server's
+ response to the PUT request.
+ On failure, raises a RequestError.
+ """
+ return self.Put(updated_profile, self._CleanUri(edit_uri),
+ url_params=url_params, escape_params=escape_params,
+ converter=gdata.contacts.ProfileEntryFromString)
+
+ def ExecuteBatch(self, batch_feed, url,
+ converter=gdata.contacts.ContactsFeedFromString):
+ """Sends a batch request feed to the server.
+
+ Args:
+ batch_feed: gdata.contacts.ContactFeed A feed containing batch
+ request entries. Each entry contains the operation to be performed
+ on the data contained in the entry. For example an entry with an
+ operation type of insert will be used as if the individual entry
+ had been inserted.
+ url: str The batch URL to which these operations should be applied.
+ converter: Function (optional) The function used to convert the server's
+ response to an object. The default value is ContactsFeedFromString.
+
+ Returns:
+ The results of the batch request's execution on the server. If the
+ default converter is used, this is stored in a ContactsFeed.
+ """
+ return self.Post(batch_feed, url, converter=converter)
+
+ def ExecuteBatchProfiles(self, batch_feed, url,
+ converter=gdata.contacts.ProfilesFeedFromString):
+ """Sends a batch request feed to the server.
+
+ Args:
+ batch_feed: gdata.profiles.ProfilesFeed A feed containing batch
+ request entries. Each entry contains the operation to be performed
+ on the data contained in the entry. For example an entry with an
+ operation type of insert will be used as if the individual entry
+ had been inserted.
+ url: string The batch URL to which these operations should be applied.
+ converter: Function (optional) The function used to convert the server's
+ response to an object. The default value is
+ gdata.profiles.ProfilesFeedFromString.
+
+ Returns:
+ The results of the batch request's execution on the server. If the
+ default converter is used, this is stored in a ProfilesFeed.
+ """
+ return self.Post(batch_feed, url, converter=converter)
+
+ def _CleanUri(self, uri):
+ """Sanitizes a feed URI.
+
+ Args:
+ uri: The URI to sanitize, can be relative or absolute.
+
+ Returns:
+ The given URI without its http://server prefix, if any.
+ Keeps the leading slash of the URI.
+ """
+ url_prefix = 'http://%s' % self.server
+ if uri.startswith(url_prefix):
+ uri = uri[len(url_prefix):]
+ return uri
+
+class ContactsQuery(gdata.service.Query):
+
+ def __init__(self, feed=None, text_query=None, params=None,
+ categories=None, group=None):
+ self.feed = feed or '/m8/feeds/contacts/default/full'
+ if group:
+ self._SetGroup(group)
+ gdata.service.Query.__init__(self, feed=self.feed, text_query=text_query,
+ params=params, categories=categories)
+
+ def _GetGroup(self):
+ if 'group' in self:
+ return self['group']
+ else:
+ return None
+
+ def _SetGroup(self, group_id):
+ self['group'] = group_id
+
+ group = property(_GetGroup, _SetGroup,
+ doc='The group query parameter to find only contacts in this group')
+
+class GroupsQuery(gdata.service.Query):
+
+ def __init__(self, feed=None, text_query=None, params=None,
+ categories=None):
+ self.feed = feed or '/m8/feeds/groups/default/full'
+ gdata.service.Query.__init__(self, feed=self.feed, text_query=text_query,
+ params=params, categories=categories)
+
+
+class ProfilesQuery(gdata.service.Query):
+ """Constructs a query object for the profiles feed."""
+
+ def __init__(self, feed=None, text_query=None, params=None,
+ categories=None):
+ self.feed = feed or '/m8/feeds/profiles/default/full'
+ gdata.service.Query.__init__(self, feed=self.feed, text_query=text_query,
+ params=params, categories=categories)
diff --git a/src/gdata/contentforshopping/__init__.py b/src/gdata/contentforshopping/__init__.py
new file mode 100644
index 0000000..5a5ed8e
--- /dev/null
+++ b/src/gdata/contentforshopping/__init__.py
@@ -0,0 +1,21 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2010-2011 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Support for the Content API for Shopping
+
+See: http://code.google.com/apis/shopping/content/index.html
+"""
diff --git a/src/gdata/contentforshopping/client.py b/src/gdata/contentforshopping/client.py
new file mode 100644
index 0000000..09d7315
--- /dev/null
+++ b/src/gdata/contentforshopping/client.py
@@ -0,0 +1,705 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2010-2011 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Extend the gdata client for the Content API for Shopping."""
+
+
+__author__ = 'afshar (Ali Afshar), dhermes (Daniel Hermes)'
+
+
+import urllib
+
+import atom.data
+import gdata.client
+from gdata.contentforshopping.data import ClientAccount
+from gdata.contentforshopping.data import ClientAccountFeed
+from gdata.contentforshopping.data import DatafeedEntry
+from gdata.contentforshopping.data import DatafeedFeed
+from gdata.contentforshopping.data import DataQualityEntry
+from gdata.contentforshopping.data import DataQualityFeed
+from gdata.contentforshopping.data import InventoryFeed
+from gdata.contentforshopping.data import ProductEntry
+from gdata.contentforshopping.data import ProductFeed
+from gdata.contentforshopping.data import UsersEntry
+from gdata.contentforshopping.data import UsersFeed
+
+
+CFS_VERSION = 'v1'
+CFS_HOST = 'content.googleapis.com'
+CFS_URI = 'https://%s/content' % CFS_HOST
+CFS_PROJECTION = 'schema'
+
+
+class ContentForShoppingClient(gdata.client.GDClient):
+ """Client for Content for Shopping API.
+
+ :param account_id: Merchant account ID. This value will be used by default
+ for all requests, but may be overridden on a
+ request-by-request basis.
+ :param api_version: The version of the API to target. Default value: 'v1'.
+ :param **kwargs: Pass all addtional keywords to the GDClient constructor.
+ """
+
+ api_version = '1.0'
+
+ def __init__(self, account_id=None, api_version=CFS_VERSION,
+ cfs_uri=CFS_URI, **kwargs):
+ self.cfs_account_id = account_id
+ self.cfs_api_version = api_version
+ self.cfs_uri = cfs_uri
+ gdata.client.GDClient.__init__(self, **kwargs)
+
+ def _create_uri(self, account_id, resource, path=(), use_projection=True,
+ dry_run=False, warnings=False, max_results=None,
+ start_token=None, start_index=None,
+ performance_start=None, performance_end=None):
+ """Create a request uri from the given arguments.
+
+ If arguments are None, use the default client attributes.
+ """
+ account_id = account_id or self.cfs_account_id
+ if account_id is None:
+ raise ValueError('No Account ID set. '
+ 'Either set for the client, or per request')
+ segments = [self.cfs_uri, self.cfs_api_version, account_id, resource]
+ if use_projection:
+ segments.append(CFS_PROJECTION)
+ segments.extend(urllib.quote(value) for value in path)
+ result = '/'.join(segments)
+
+ request_params = []
+ if dry_run:
+ request_params.append('dry-run')
+ if warnings:
+ request_params.append('warnings')
+ if max_results is not None:
+ request_params.append('max-results=%s' % max_results)
+ if start_token is not None:
+ request_params.append('start-token=%s' % start_token)
+ if start_index is not None:
+ request_params.append('start-index=%s' % start_index)
+ if performance_start is not None:
+ request_params.append('performance.start=%s' % performance_start)
+ if performance_end is not None:
+ request_params.append('performance.end=%s' % performance_end)
+ request_params = '&'.join(request_params)
+
+ if request_params:
+ result = '%s?%s' % (result, request_params)
+
+ return result
+
+ def _create_product_id(self, id, country, language, channel='online'):
+ return '%s:%s:%s:%s' % (channel, language, country, id)
+
+ def _create_batch_feed(self, entries, operation, feed=None,
+ feed_class=ProductFeed):
+ if feed is None:
+ feed = feed_class()
+ for entry in entries:
+ entry.batch_operation = gdata.data.BatchOperation(type=operation)
+ feed.entry.append(entry)
+ return feed
+
+ # Operations on a single product
+
+ def get_product(self, id, country, language, account_id=None,
+ auth_token=None):
+ """Get a product by id, country and language.
+
+ :param id: The product ID
+ :param country: The country (target_country)
+ :param language: The language (content_language)
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ pid = self._create_product_id(id, country, language)
+ uri = self._create_uri(account_id, 'items/products', path=[pid])
+ return self.get_entry(uri, desired_class=ProductEntry,
+ auth_token=auth_token)
+
+ GetProduct = get_product
+
+ def insert_product(self, product, account_id=None, auth_token=None,
+ dry_run=False, warnings=False):
+ """Create a new product, by posting the product entry feed.
+
+ :param product: A :class:`gdata.contentforshopping.data.ProductEntry` with
+ the required product data.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False by default.
+ """
+ uri = self._create_uri(account_id, 'items/products',
+ dry_run=dry_run, warnings=warnings)
+ return self.post(product, uri=uri, auth_token=auth_token)
+
+ InsertProduct = insert_product
+
+ def update_product(self, product, account_id=None, auth_token=None,
+ dry_run=False, warnings=False):
+ """Update a product, by putting the product entry feed.
+
+ :param product: A :class:`gdata.contentforshopping.data.ProductEntry` with
+ the required product data.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False
+ by default.
+ """
+ pid = self._create_product_id(product.product_id.text,
+ product.target_country.text,
+ product.content_language.text)
+ uri = self._create_uri(account_id, 'items/products', path=[pid],
+ dry_run=dry_run, warnings=warnings)
+ return self.update(product, uri=uri, auth_token=auth_token)
+
+ UpdateProduct = update_product
+
+ def delete_product(self, product, account_id=None, auth_token=None,
+ dry_run=False, warnings=False):
+ """Delete a product
+
+ :param product: A :class:`gdata.contentforshopping.data.ProductEntry` with
+ the required product data.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False by default.
+ """
+ pid = self._create_product_id(product.product_id.text,
+ product.target_country.text,
+ product.content_language.text)
+ uri = self._create_uri(account_id, 'items/products', path=[pid],
+ dry_run=dry_run, warnings=warnings)
+ return self.delete(uri, auth_token=auth_token)
+
+ DeleteProduct = delete_product
+
+ # Operations on multiple products
+
+ def get_products(self, max_results=None, start_token=None, start_index=None,
+ performance_start=None, performance_end=None,
+ account_id=None, auth_token=None):
+ """Get a feed of products for the account.
+
+ :param max_results: The maximum number of results to return (default 25,
+ maximum 250).
+ :param start_token: The start token of the feed provided by the API.
+ :param start_index: The starting index of the feed to return (default 1,
+ maximum 10000)
+ :param performance_start: The start date (inclusive) of click data returned.
+ Should be represented as YYYY-MM-DD; not appended
+ if left as None.
+ :param performance_end: The end date (inclusive) of click data returned.
+ Should be represented as YYYY-MM-DD; not appended
+ if left as None.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ uri = self._create_uri(account_id, 'items/products',
+ max_results=max_results,
+ start_token=start_token,
+ start_index=start_index,
+ performance_start=performance_start,
+ performance_end=performance_end)
+ return self.get_feed(uri, auth_token=auth_token,
+ desired_class=ProductFeed)
+
+ GetProducts = get_products
+
+ def batch(self, feed, account_id=None, auth_token=None,
+ dry_run=False, warnings=False):
+ """Send a batch request.
+
+ :param feed: The feed of batch entries to send.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False by default.
+ """
+ uri = self._create_uri(account_id, 'items/products', path=['batch'],
+ dry_run=dry_run, warnings=warnings)
+ return self.post(feed, uri=uri, auth_token=auth_token,
+ desired_class=ProductFeed)
+
+ Batch = batch
+
+ def insert_products(self, products, account_id=None, auth_token=None,
+ dry_run=False, warnings=False):
+ """Insert the products using a batch request
+
+ :param products: A list of product entries
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False by default.
+ """
+ feed = self._create_batch_feed(products, 'insert')
+ return self.batch(feed, account_id=account_id, auth_token=auth_token,
+ dry_run=dry_run, warnings=warnings)
+
+ InsertProducts = insert_products
+
+ def update_products(self, products, account_id=None, auth_token=None,
+ dry_run=False, warnings=False):
+ """Update the products using a batch request
+
+ :param products: A list of product entries
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False by default.
+
+ .. note:: Entries must have the atom:id element set.
+ """
+ feed = self._create_batch_feed(products, 'update')
+ return self.batch(feed, account_id=account_id, auth_token=auth_token,
+ dry_run=dry_run, warnings=warnings)
+
+ UpdateProducts = update_products
+
+ def delete_products(self, products, account_id=None, auth_token=None,
+ dry_run=False, warnings=False):
+ """Delete the products using a batch request.
+
+ :param products: A list of product entries
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False by default.
+
+ .. note:: Entries must have the atom:id element set.
+ """
+ feed = self._create_batch_feed(products, 'delete')
+ return self.batch(feed, account_id=account_id, auth_token=auth_token,
+ dry_run=dry_run, warnings=warnings)
+
+ DeleteProducts = delete_products
+
+ # Operations on datafeeds
+
+ def get_datafeeds(self, account_id=None):
+ """Get the feed of datafeeds.
+
+ :param account_id: The Sub-Account ID. If ommitted the default
+ Account ID will be used for this client.
+ """
+ uri = self._create_uri(account_id, 'datafeeds/products',
+ use_projection=False)
+ return self.get_feed(uri, desired_class=DatafeedFeed)
+
+ GetDatafeeds = get_datafeeds
+
+ # Operations on a single datafeed
+
+ def get_datafeed(self, feed_id, account_id=None, auth_token=None):
+ """Get the feed of a single datafeed.
+
+ :param feed_id: The ID of the desired datafeed.
+ :param account_id: The Sub-Account ID. If ommitted the default
+ Account ID will be used for this client.
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ uri = self._create_uri(account_id, 'datafeeds/products', path=[feed_id],
+ use_projection=False)
+ return self.get_feed(uri, auth_token=auth_token,
+ desired_class=DatafeedEntry)
+
+ GetDatafeed = get_datafeed
+
+ def insert_datafeed(self, entry, account_id=None, auth_token=None,
+ dry_run=False, warnings=False):
+ """Insert a datafeed.
+
+ :param entry: XML Content of post request required for registering a
+ datafeed.
+ :param account_id: The Sub-Account ID. If ommitted the default
+ Account ID will be used for this client.
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False by default.
+ """
+ uri = self._create_uri(account_id, 'datafeeds/products',
+ use_projection=False, dry_run=dry_run,
+ warnings=warnings)
+ return self.post(entry, uri=uri, auth_token=auth_token)
+
+ InsertDatafeed = insert_datafeed
+
+ def update_datafeed(self, entry, feed_id, account_id=None, auth_token=None,
+ dry_run=False, warnings=False):
+ """Update the feed of a single datafeed.
+
+ :param entry: XML Content of put request required for updating a
+ datafeed.
+ :param feed_id: The ID of the desired datafeed.
+ :param account_id: The Sub-Account ID. If ommitted the default
+ Account ID will be used for this client.
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False by default.
+ """
+ uri = self._create_uri(account_id, 'datafeeds/products', path=[feed_id],
+ use_projection=False, dry_run=dry_run,
+ warnings=warnings)
+ return self.update(entry, auth_token=auth_token, uri=uri)
+
+ UpdateDatafeed = update_datafeed
+
+ def delete_datafeed(self, feed_id, account_id=None, auth_token=None):
+ """Delete a single datafeed.
+
+ :param feed_id: The ID of the desired datafeed.
+ :param account_id: The Sub-Account ID. If ommitted the default
+ Account ID will be used for this client.
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ uri = self._create_uri(account_id, 'datafeeds/products', path=[feed_id],
+ use_projection=False)
+ return self.delete(uri, auth_token=auth_token)
+
+ DeleteDatafeed = delete_datafeed
+
+ # Operations on client accounts
+
+ def get_client_accounts(self, max_results=None, start_index=None,
+ account_id=None, auth_token=None):
+ """Get the feed of managed accounts
+
+ :param max_results: The maximum number of results to return (default 25,
+ maximum 250).
+ :param start_index: The starting index of the feed to return (default 1,
+ maximum 10000)
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ uri = self._create_uri(account_id, 'managedaccounts',
+ max_results=max_results, start_index=start_index,
+ use_projection=False)
+ return self.get_feed(uri, desired_class=ClientAccountFeed,
+ auth_token=auth_token)
+
+ GetClientAccounts = get_client_accounts
+
+ def get_client_account(self, client_account_id,
+ account_id=None, auth_token=None):
+ """Get a managed account.
+
+ :param client_account_id: The Account ID of the subaccount being retrieved.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ uri = self._create_uri(account_id, 'managedaccounts',
+ path=[client_account_id], use_projection=False)
+ return self.get_entry(uri, desired_class=ClientAccount,
+ auth_token=auth_token)
+
+ GetClientAccount = get_client_account
+
+ def insert_client_account(self, entry, account_id=None, auth_token=None,
+ dry_run=False, warnings=False):
+ """Insert a client account entry
+
+ :param entry: An entry of type ClientAccount
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False by default.
+ """
+ uri = self._create_uri(account_id, 'managedaccounts',
+ use_projection=False, dry_run=dry_run,
+ warnings=warnings)
+ return self.post(entry, uri=uri, auth_token=auth_token)
+
+ InsertClientAccount = insert_client_account
+
+ def update_client_account(self, entry, client_account_id, account_id=None,
+ auth_token=None, dry_run=False, warnings=False):
+ """Update a client account
+
+ :param entry: An entry of type ClientAccount to update to
+ :param client_account_id: The client account ID
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False by default.
+ """
+ uri = self._create_uri(account_id, 'managedaccounts',
+ path=[client_account_id], use_projection=False,
+ dry_run=dry_run, warnings=warnings)
+ return self.update(entry, uri=uri, auth_token=auth_token)
+
+ UpdateClientAccount = update_client_account
+
+ def delete_client_account(self, client_account_id, account_id=None,
+ auth_token=None, dry_run=False, warnings=False):
+ """Delete a client account
+
+ :param client_account_id: The client account ID
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ :param dry_run: Flag to run all requests that modify persistent data in
+ dry-run mode. False by default.
+ :param warnings: Flag to include warnings in response. False by default.
+ """
+
+ uri = self._create_uri(account_id, 'managedaccounts',
+ path=[client_account_id], use_projection=False,
+ dry_run=dry_run, warnings=warnings)
+ return self.delete(uri, auth_token=auth_token)
+
+ DeleteClientAccount = delete_client_account
+
+ def get_users_feed(self, account_id=None, auth_token=None):
+ """Get the users feed for an account.
+
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+
+ uri = self._create_uri(account_id, 'users', use_projection=False)
+ return self.get_feed(uri, auth_token=auth_token, desired_class=UsersFeed)
+
+ GetUsersFeed = get_users_feed
+
+ def get_users_entry(self, user_email, account_id=None, auth_token=None):
+ """Get a users feed entry for an account.
+
+ :param user_email: Email of the user entry to be retrieved.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ uri = self._create_uri(
+ account_id, 'users', path=[user_email], use_projection=False)
+ return self.get_entry(uri, auth_token=auth_token, desired_class=UsersEntry)
+
+ GetUsersEntry = get_users_entry
+
+ def insert_users_entry(self, entry, account_id=None, auth_token=None):
+ """Insert a users feed entry for an account.
+
+ :param entry: A :class:`gdata.contentforshopping.data.UsersEntry` with
+ the required user data.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ uri = self._create_uri(account_id, 'users', use_projection=False)
+ return self.post(entry, uri=uri, auth_token=auth_token)
+
+ InsertUsersEntry = insert_users_entry
+
+ def update_users_entry(self, entry, account_id=None, auth_token=None):
+ """Update a users feed entry for an account.
+
+ :param entry: A :class:`gdata.contentforshopping.data.UsersEntry` with
+ the required user data.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ # Could also use entry.find_edit_link() but that is inconsistent
+ # with the rest of the module
+ user_email = entry.title.text
+ uri = self._create_uri(
+ account_id, 'users', path=[user_email], use_projection=False)
+ return self.update(entry, uri=uri, auth_token=auth_token)
+
+ UpdateUsersEntry = update_users_entry
+
+ def delete_users_entry(self, entry, account_id=None, auth_token=None):
+ """Delete a users feed entry for an account.
+
+ :param entry: A :class:`gdata.contentforshopping.data.UsersEntry` with
+ the required user data.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ # Could also use entry.find_edit_link() but that is inconsistent
+ # with the rest of the module
+ user_email = entry.title.text
+ uri = self._create_uri(
+ account_id, 'users', path=[user_email], use_projection=False)
+ return self.delete(uri, auth_token=auth_token)
+
+ DeleteUsersEntry = delete_users_entry
+
+ def get_data_quality_feed(self, account_id=None, auth_token=None,
+ max_results=None, start_index=None):
+ """Get the data quality feed for an account.
+
+ :param max_results: The maximum number of results to return (default 25,
+ max 100).
+ :param start_index: The starting index of the feed to return.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+
+ uri = self._create_uri(account_id, 'dataquality', use_projection=False,
+ max_results=max_results, start_index=start_index)
+ return self.get_feed(uri, auth_token=auth_token,
+ desired_class=DataQualityFeed)
+
+ GetDataQualityFeed = get_data_quality_feed
+
+ def get_data_quality_entry(self, secondary_account_id=None,
+ account_id=None, auth_token=None):
+ """Get the data quality feed entry for an account.
+
+ :param secondary_account_id: The Account ID of the secondary account. If
+ ommitted the value of account_id is used.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ if secondary_account_id is None:
+ secondary_account_id = account_id or self.cfs_account_id
+
+ uri = self._create_uri(account_id, 'dataquality',
+ path=[secondary_account_id],
+ use_projection=False)
+ return self.get_entry(uri, auth_token=auth_token,
+ desired_class=DataQualityEntry)
+
+ GetDataQualityEntry = get_data_quality_entry
+
+ def update_inventory_entry(self, product, id, country, language, store_code,
+ account_id=None, auth_token=None):
+ """Make a local product update, by putting the inventory entry.
+
+ :param product: A :class:`gdata.contentforshopping.data.InventoryEntry`
+ with the required product data.
+ :param id: The product ID
+ :param country: The country (target_country)
+ :param language: The language (content_language)
+ :param store_code: The code for the store where this local product will
+ be updated.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+ """
+ pid = self._create_product_id(id, country, language, channel='local')
+ uri = self._create_uri(account_id, 'inventory',
+ path=[store_code, 'items', pid],
+ use_projection=False)
+ return self.update(product, uri=uri, auth_token=auth_token)
+
+ UpdateInventoryEntry = update_inventory_entry
+
+ def add_local_id(self, product, id, country, language,
+ store_code, account_id=None):
+ """Add an atom id to a local product with a local store specific URI.
+
+ :param product: A :class:`gdata.contentforshopping.data.InventoryEntry`
+ with the required product data.
+ :param id: The product ID
+ :param country: The country (target_country)
+ :param language: The language (content_language)
+ :param store_code: The code for the store where this local product will
+ be updated.
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ """
+ pid = self._create_product_id(id, country, language, channel='local')
+ uri = self._create_uri(account_id, 'inventory',
+ path=[store_code, 'items', pid],
+ use_projection=False)
+ product.id = atom.data.Id(uri)
+ return product
+
+ AddLocalId = add_local_id
+
+ def update_inventory_feed(self, products, account_id=None, auth_token=None):
+ """Update a batch of local products, by putting the product entry feed.
+
+ :param products: A list containing entries of
+ :class:`gdata.contentforshopping.data.InventoryEntry`
+ with the required product data
+ :param account_id: The Merchant Center Account ID. If ommitted the default
+ Account ID will be used for this client
+ :param auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method.
+
+ .. note:: Entries must have the atom:id element set. You can use
+ add_local_id to set this attribute using the store_code, product
+ id, country and language.
+ """
+ feed = self._create_batch_feed(products, 'update',
+ feed_class=InventoryFeed)
+ uri = self._create_uri(account_id, 'inventory', path=['batch'],
+ use_projection=False)
+ return self.post(feed, uri=uri, auth_token=auth_token)
+
+ UpdateInventoryFeed = update_inventory_feed
diff --git a/src/gdata/contentforshopping/data.py b/src/gdata/contentforshopping/data.py
new file mode 100644
index 0000000..a437937
--- /dev/null
+++ b/src/gdata/contentforshopping/data.py
@@ -0,0 +1,1544 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2010-2011 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""GData definitions for Content API for Shopping"""
+
+
+__author__ = 'afshar (Ali Afshar), dhermes (Daniel Hermes)'
+
+
+import atom.core
+import atom.data
+import atom.http_core
+import gdata.data
+
+
+ATOM_NAMESPACE = 'http://www.w3.org/2005/Atom'
+GD_NAMESPACE = 'http://schemas.google.com/g/2005'
+GD_NAMESPACE_TEMPLATE = '{http://schemas.google.com/g/2005}%s'
+SC_NAMESPACE_TEMPLATE = ('{http://schemas.google.com/'
+ 'structuredcontent/2009}%s')
+SCP_NAMESPACE_TEMPLATE = ('{http://schemas.google.com/'
+ 'structuredcontent/2009/products}%s')
+
+# Content API for Shopping, general (sc) attributes
+
+class ProductId(atom.core.XmlElement):
+ """sc:id element
+
+ It is required that all inserted products are provided with a unique
+ alphanumeric ID, in this element.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'id'
+
+
+class ImageLink(atom.core.XmlElement):
+ """sc:image_link element
+
+ This is the URL of an associated image for a product. Please use full size
+ images (400x400 pixels or larger), not thumbnails.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'image_link'
+
+
+class AdditionalImageLink(atom.core.XmlElement):
+ """sc:additional_image_link element
+
+ The URLs of any additional images for the product. This tag may be repeated.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'additional_image_link'
+
+
+class Channel(atom.core.XmlElement):
+ """
+ sc:channel element
+
+ The channel for the product. Supported values are: 'online', 'local'
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'channel'
+
+
+class ContentLanguage(atom.core.XmlElement):
+ """
+ sc:content_language element
+
+ Language used in the item content for the product
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'content_language'
+
+
+class TargetCountry(atom.core.XmlElement):
+ """
+ sc:target_country element
+
+ The target country of the product
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'target_country'
+
+
+class ExpirationDate(atom.core.XmlElement):
+ """sc:expiration_date
+
+ This is the date when the product listing will expire. If omitted, this will
+ default to 30 days after the product was created.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'expiration_date'
+
+
+class Adult(atom.core.XmlElement):
+ """sc:adult element
+
+ Indicates whether the content is targeted towards adults, with possible
+ values of "true" or "false". Defaults to "false".
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'adult'
+
+
+class Attribute(atom.core.XmlElement):
+ """sc:attribute element
+
+ Generic attribute used for generic projection and to define
+ custom elements.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'attribute'
+ name = 'name'
+ type = 'type'
+ unit = 'unit'
+
+
+class Group(atom.core.XmlElement):
+ """sc:group element
+
+ Generic group used for generic projection and to define
+ custom elements groups.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'group'
+ name = 'name'
+ attribute = [Attribute]
+
+
+# Destination Attributes (to be used with app:control element)
+
+class RequiredDestination(atom.core.XmlElement):
+ """sc:required_destination element
+
+ This element defines the required destination for a product, namely
+ "ProductSearch", "ProductAds" or "CommerceSearch". It should be added to the
+ app:control element (ProductEntry's "control" attribute) to specify where the
+ product should appear in search APIs.
+
+ By default, when omitted, the api attempts to upload to as many destinations
+ as possible.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'required_destination'
+ dest = 'dest'
+
+
+class ValidateDestination(atom.core.XmlElement):
+ """sc:validate_destination element
+
+ This element defines the validate destination for a product, namely
+ "ProductSearch", "ProductAds" or "CommerceSearch". It should be added to the
+ app:control element (ProductEntry's "control" attribute) to specify which the
+ destinations you would like error info for.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'validate_destination'
+ dest = 'dest'
+
+
+class ExcludedDestination(atom.core.XmlElement):
+ """sc:excluded_destination element
+
+ This element defines the required destination for a product, namely
+ "ProductSearch", "ProductAds" or "CommerceSearch". It should be added to the
+ app:control element (ProductEntry's "control" attribute) to specify where the
+ product should not appear in search APIs.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'excluded_destination'
+ dest = 'dest'
+
+
+class Status(atom.core.XmlElement):
+ """sc:status element
+
+ This element defines the status of an element in a particular destination. It
+ has a destination and an actual status such as enlisted, review, or
+ disapproved.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'status'
+ dest = 'dest'
+ status = 'status'
+
+
+# Warning Attributes (to be used with app:control element)
+
+class Code(atom.core.XmlElement):
+ """sc:code element
+
+ The warning code. Currently validation/missing_recommended is the
+ only code used.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'code'
+
+
+class Domain(atom.core.XmlElement):
+ """sc:domain element
+
+ The scope of the warning. A comma-separated list of destinations,
+ for example: ProductSearch.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'domain'
+
+
+class Location(atom.core.XmlElement):
+ """sc:location element
+
+ The name of the product element that has raised the warning. This may be
+ any valid product element.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'location'
+
+
+class Message(atom.core.XmlElement):
+ """sc:message element
+
+ A plain text description of the warning.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'message'
+
+
+class WarningElement(atom.core.XmlElement):
+ """sc:warning element
+
+ Container element for an individual warning.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'warning'
+ code = Code
+ domain = Domain
+ location = Location
+ message = Message
+
+
+class Warnings(atom.core.XmlElement):
+ """sc:warnings element
+
+ Container element for the list of warnings.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'warnings'
+ warnings = [WarningElement]
+
+
+class Datapoint(atom.core.XmlElement):
+ """sc:datapoint element
+
+ Datapoint representing click data for an item on
+ a given day.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'datapoint'
+ clicks = 'clicks'
+ date = 'date'
+ paid_clicks = 'paid_clicks'
+
+
+class Performance(atom.core.XmlElement):
+ """sc:performance element
+
+ Container element for daily click data.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'performance'
+ datapoint = [Datapoint]
+
+
+class ProductControl(atom.data.Control):
+ """
+ app:control element
+
+ overridden to provide additional elements in the sc namespace.
+ """
+ _qname = atom.data.Control._qname[1]
+ required_destination = [RequiredDestination]
+ validate_destination = [ValidateDestination]
+ excluded_destination = [ExcludedDestination]
+ status = [Status]
+ warnings = Warnings
+
+# Content API for Shopping, product (scp) attributes
+
+class Author(atom.core.XmlElement):
+ """
+ scp:author element
+
+ Defines the author of the information, recommended for books.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'author'
+
+
+class Availability(atom.core.XmlElement):
+ """
+ scp:availability element
+
+ The retailer's suggested label for product availability. Supported values
+ include: 'in stock', 'out of stock', 'limited availability',
+ 'available for order', and 'preorder'.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'availability'
+
+
+class Brand(atom.core.XmlElement):
+ """
+ scp:brand element
+
+ The brand of the product
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'brand'
+
+
+class Color(atom.core.XmlElement):
+ """scp:color element
+
+ The color of the product.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'color'
+
+
+class Condition(atom.core.XmlElement):
+ """scp:condition element
+
+ The condition of the product, one of "new", "used", "refurbished"
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'condition'
+
+
+class Edition(atom.core.XmlElement):
+ """scp:edition element
+
+ The edition of the product. Recommended for products with multiple editions
+ such as collectors' editions etc, such as books.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'edition'
+
+
+class Feature(atom.core.XmlElement):
+ """scp:feature element
+
+ A product feature. A product may have multiple features, each being text, for
+ example a smartphone may have features: "wifi", "gps" etc.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'feature'
+
+
+class FeaturedProduct(atom.core.XmlElement):
+ """scp:featured_product element
+
+ Used to indicate that this item is a special, featured product; Supported
+ values are: "true", "false".
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'featured_product'
+
+
+class Gender(atom.core.XmlElement):
+ """scp:gender element
+
+ The gender for the item. Supported values are: 'unisex', 'female', 'male'
+
+ Note: This tag is required if the google product type is part of
+ Apparel & Accessories.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'gender'
+
+
+class Genre(atom.core.XmlElement):
+ """scp:genre element
+
+ Describes the genre of a product, eg "comedy". Strongly recommended for media.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'genre'
+
+
+class GoogleProductCategory(atom.core.XmlElement):
+ """scp:google_product_category element
+
+ The product's google category. The value must be one of the categories listed
+ in the Product type taxonomy, which can be found at
+ http://www.google.com/support/merchants/bin/answer.py?answer=160081.
+
+ Note that & and > characters must be encoded as & and >
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'google_product_category'
+
+
+class Gtin(atom.core.XmlElement):
+ """scp:gtin element
+
+ GTIN of the product (isbn/upc/ean)
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'gtin'
+
+
+class ItemGroupID(atom.core.XmlElement):
+ """scp:item_group_id element
+
+ The identifier for products with variants. This id is used to link items which
+ have different values for the fields:
+
+ 'color', 'material', 'pattern', 'size'
+
+ but are the same item, for example a shirt with different sizes.
+
+ Note: This tag is required for all product variants.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'item_group_id'
+
+
+class Manufacturer(atom.core.XmlElement):
+ """scp:manufacturer element
+
+ Manufacturer of the product.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'manufacturer'
+
+
+class Material(atom.core.XmlElement):
+ """scp:material element
+
+ The material the product is made of.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'material'
+
+
+class Mpn(atom.core.XmlElement):
+ """scp:mpn element
+
+ Manufacturer's Part Number. A unique code determined by the manufacturer for
+ the product.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'mpn'
+
+
+class Pattern(atom.core.XmlElement):
+ """scp:pattern element
+
+ The pattern of the product. (e.g. polka dots)
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'pattern'
+
+
+class Price(atom.core.XmlElement):
+ """scp:price element
+
+ The price of the product. The unit attribute must be set, and should represent
+ the currency.
+
+ Note: Required Element
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'price'
+ unit = 'unit'
+
+
+class ProductType(atom.core.XmlElement):
+ """scp:product_type element
+
+ Describes the type of product. A taxonomy of available product types is
+ listed at http://www.google.com/basepages/producttype/taxonomy.txt and the
+ entire line in the taxonomy should be included, for example "Electronics >
+ Video > Projectors".
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'product_type'
+
+
+class Quantity(atom.core.XmlElement):
+ """scp:quantity element
+
+ The number of items available. A value of 0 indicates items that are
+ currently out of stock.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'quantity'
+
+
+class ShippingPrice(atom.core.XmlElement):
+ """scp:shipping_price element
+
+ Fixed shipping price, represented as a number. Specify the currency as the
+ "unit" attribute".
+
+ This element should be placed inside the scp:shipping element.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'shipping_price'
+ unit = 'unit'
+
+
+class ShippingCountry(atom.core.XmlElement):
+ """scp:shipping_country element
+
+ The two-letter ISO 3166 country code for the country to which an item will
+ ship.
+
+ This element should be placed inside the scp:shipping element.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'shipping_country'
+
+
+class ShippingRegion(atom.core.XmlElement):
+ """scp:shipping_region element
+
+ The geographic region to which a shipping rate applies, e.g., in the US, the
+ two-letter state abbreviation, ZIP code, or ZIP code range using * wildcard.
+
+ This element should be placed inside the scp:shipping element.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'shipping_region'
+
+
+class ShippingService(atom.core.XmlElement):
+ """scp:shipping_service element
+
+ A free-form description of the service class or delivery speed.
+
+ This element should be placed inside the scp:shipping element.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'shipping_service'
+
+
+class Shipping(atom.core.XmlElement):
+ """scp:shipping element
+
+ Container for the shipping rules as provided by the shipping_country,
+ shipping_price, shipping_region and shipping_service tags.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'shipping'
+ shipping_price = ShippingPrice
+ shipping_country = ShippingCountry
+ shipping_service = ShippingService
+ shipping_region = ShippingRegion
+
+
+class ShippingWeight(atom.core.XmlElement):
+ """scp:shipping_weight element
+
+ The shipping weight of a product. Requires a value and a unit using the unit
+ attribute. Valid units include lb, pound, oz, ounce, g, gram, kg, kilogram.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'shipping_weight'
+ unit = 'unit'
+
+
+class Size(atom.core.XmlElement):
+ """scp:size element
+
+ Available sizes of an item. Appropriate values include: "small", "medium",
+ "large", etc. The product enttry may contain multiple sizes, to indicate the
+ available sizes.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'size'
+
+
+class TaxRate(atom.core.XmlElement):
+ """scp:tax_rate element
+
+ The tax rate as a percent of the item price, i.e., number, as a percentage.
+
+ This element should be placed inside the scp:tax (Tax class) element.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'tax_rate'
+
+
+class TaxCountry(atom.core.XmlElement):
+ """scp:tax_country element
+
+ The country an item is taxed in (as a two-letter ISO 3166 country code).
+
+ This element should be placed inside the scp:tax (Tax class) element.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'tax_country'
+
+
+class TaxRegion(atom.core.XmlElement):
+ """scp:tax_region element
+
+ The geographic region that a tax rate applies to, e.g., in the US, the
+ two-letter state abbreviation, ZIP code, or ZIP code range using * wildcard.
+
+ This element should be placed inside the scp:tax (Tax class) element.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'tax_region'
+
+
+class TaxShip(atom.core.XmlElement):
+ """scp:tax_ship element
+
+ Whether tax is charged on shipping for this product. The default value is
+ "false".
+
+ This element should be placed inside the scp:tax (Tax class) element.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'tax_ship'
+
+
+class Tax(atom.core.XmlElement):
+ """scp:tax element
+
+ Container for the tax rules for this product. Containing the tax_rate,
+ tax_country, tax_region, and tax_ship elements
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'tax'
+ tax_rate = TaxRate
+ tax_country = TaxCountry
+ tax_region = TaxRegion
+ tax_ship = TaxShip
+
+
+class Year(atom.core.XmlElement):
+ """scp:year element
+
+ The year the product was produced. Expects four digits
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'year'
+
+
+class IdentifierExists(atom.core.XmlElement):
+ """scp:identifier_exists element
+
+ Specify as true if the item has no manufacturer part number or
+ any other industry standard product identifier.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'identifier_exists'
+
+
+class UnitPricingMeasure(atom.core.XmlElement):
+ """scp:unit_pricing_measure element
+
+ The dimension by which the item is sold.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'unit_pricing_measure'
+ unit = 'unit'
+
+
+class UnitPricingBaseMeasure(atom.core.XmlElement):
+ """scp:unit_pricing_base_measure element
+
+ Your preference of the denominator of the unit price.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'unit_pricing_base_measure'
+ unit = 'unit'
+
+
+class EnergyEfficiencyClass(atom.core.XmlElement):
+ """scp:energy_efficiency_class element
+
+ The item's energy efficiency class.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'energy_efficiency_class'
+
+
+class Multipack(atom.core.XmlElement):
+ """scp:ultipack element
+
+ The number of products in a merchant-defined custom multipack
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'multipack'
+
+
+class ProductEntry(gdata.data.BatchEntry):
+ """Product entry containing product information
+
+ The elements of this entry that are used are made up of five different
+ namespaces. They are:
+
+ atom: - Atom
+ app: - Atom Publishing Protocol
+ gd: - Google Data API
+ sc: - Content API for Shopping, general attributes
+ scp: - Content API for Shopping, product attributes
+
+ Only the sc and scp namespace elements are defined here, but additional useful
+ elements are defined in superclasses.
+
+ The following attributes are encoded as XML elements in the Atomn (atom:)
+ namespace: title, link, entry, id, category, content, author, created
+ updated. Among these, the title, content and link tags are part of the
+ required Content for Shopping API so we document them here.
+
+ .. attribute:: title
+
+ The title of the product.
+
+ This should be a :class:`atom.data.Title` element, for example::
+
+ entry = ProductEntry()
+ entry.title = atom.data.Title(u'32GB MP3 Player')
+
+ .. attribute:: content
+
+ The description of the item.
+
+ This should be a :class:`atom.data.Content` element, for example::
+
+ entry = ProductEntry()
+ entry.content = atom.data.Content('My item description')
+
+ .. attribute:: link
+
+ A link to a page where the item can be purchased.
+
+ This should be a :class:`atom.data.Link` element, for example::
+
+ link = atom.data.Link(rel='alternate', type='text/html',
+ href='http://www.somehost.com/123456jsh9')
+ entry = ProductEntry()
+ entry.link.append(link)
+
+ .. attribute:: additional_image_link
+
+ A list of additional links to images of the product. Each link should be an
+ :class:`AdditionalImageLink` element, for example::
+
+ entry = ProductEntry()
+ entry.additional_image_link.append(
+ AdditionalImageLink('http://myshop/cdplayer.jpg'))
+
+ .. attribute:: author
+
+ The author of the product.
+
+ This should be a :class:`Author` element, for example::
+
+ entry = ProductEntry()
+ entry.author = atom.data.Author(u'Isaac Asimov')
+
+ .. attribute:: attribute
+
+ List of generic attributes.
+
+ This should be a list of :class:`Attribute` elements, for example::
+
+ attribute = Attribute('foo')
+ attribute.name = 'bar'
+ attribute.type = 'baz'
+ attribute.unit = 'kg'
+ entry = ProductEntry()
+ entry.attributes.append(attribute)
+
+ .. attribute:: availability
+
+ The avilability of a product.
+
+ This should be an :class:`Availability` instance, for example::
+
+ entry = ProductEntry()
+ entry.availability = Availability('in stock')
+
+ .. attribute:: brand
+
+ The brand of a product.
+
+ This should be a :class:`Brand` element, for example::
+
+ entry = ProductEntry()
+ entry.brand = Brand(u'Sony')
+
+ .. attribute:: channel
+
+ The channel for the product. Supported values are: 'online', 'local'
+
+ This should be a :class:`Channel` element, for example::
+
+ entry = ProductEntry()
+ entry.channel = Channel('online')
+
+ .. attribute:: color
+
+ The color of a product.
+
+ This should be a :class:`Color` element, for example::
+
+ entry = ProductEntry()
+ entry.color = Color(u'purple')
+
+ .. attribute:: condition
+
+ The condition of a product.
+
+ This should be a :class:`Condition` element, for example::
+
+ entry = ProductEntry()
+ entry.condition = Condition(u'new')
+
+ .. attribute:: content_language
+
+ The language for the product.
+
+ This should be a :class:`ContentLanguage` element, for example::
+
+ entry = ProductEntry()
+ entry.content_language = ContentLanguage('EN')
+
+ .. attribute:: control
+
+ Overrides :class:`atom.data.Control` to provide additional elements
+ required_destination and excluded_destination in the sc namespace
+
+ This should be a :class:`ProductControl` element.
+
+ .. attribute:: edition
+
+ The edition of the product.
+
+ This should be a :class:`Edition` element, for example::
+
+ entry = ProductEntry()
+ entry.edition = Edition('1')
+
+ .. attribute:: expiration_date
+
+ The expiration date of this product listing.
+
+ This should be a :class:`ExpirationDate` element, for example::
+
+ entry = ProductEntry()
+ entry.expiration_date = ExpirationDate('2011-22-03')
+
+ .. attribute:: feature
+
+ A list of features for this product.
+
+ Each feature should be a :class:`Feature` element, for example::
+
+ entry = ProductEntry()
+ entry.feature.append(Feature(u'wifi'))
+ entry.feature.append(Feature(u'gps'))
+
+ .. attribute:: featured_product
+
+ Whether the product is featured.
+
+ This should be a :class:`FeaturedProduct` element, for example::
+
+ entry = ProductEntry()
+ entry.featured_product = FeaturedProduct('true')
+
+ .. attribute:: gender
+
+ The gender for the item. Supported values are: 'unisex', 'female', 'male'
+
+ This should be a :class:`Gender` element, for example::
+
+ entry = ProductEntry()
+ entry.gender = Gender('female')
+
+ .. attribute:: genre
+
+ The genre of the product.
+
+ This should be a :class:`Genre` element, for example::
+
+ entry = ProductEntry()
+ entry.genre = Genre(u'comedy')
+
+ .. attribute:: google_product_category
+
+ The product's google category. Value must come from taxonomy listed at
+
+ http://www.google.com/support/merchants/bin/answer.py?answer=160081
+
+ This should be a :class:`GoogleProductCategory` element, for example::
+
+ entry = ProductEntry()
+ entry.google_product_category = GoogleProductCategory(
+ 'Animals > Live Animals')
+
+ .. attribute:: gtin
+
+ The gtin for this product.
+
+ This should be a :class:`Gtin` element, for example::
+
+ entry = ProductEntry()
+ entry.gtin = Gtin('A888998877997')
+
+ .. attribute:: image_link
+
+ A link to the product image. This link should be an
+ :class:`ImageLink` element, for example::
+
+ entry = ProductEntry()
+ entry.image_link = ImageLink('http://myshop/cdplayer.jpg')
+
+ .. attribute:: item_group_id
+
+ The identifier for products with variants. This id is used to link items
+ which have different values for the fields:
+
+ 'color', 'material', 'pattern', 'size'
+
+ but are the same item, for example a shirt with different sizes.
+
+ This should be a :class:`ItemGroupID` element, for example::
+
+ entry = ProductEntry()
+ entry.item_group_id = ItemGroupID('R1726122')
+
+ .. attribute:: manufacturer
+
+ The manufacturer of the product.
+
+ This should be a :class:`Manufacturer` element, for example::
+
+ entry = ProductEntry()
+ entry.manufacturer = Manufacturer('Sony')
+
+ .. attribute:: material
+
+ The material the product is made of.
+
+ This should be a :class:`Material` element, for example::
+
+ entry = ProductEntry()
+ entry.material = Material('cotton')
+
+ .. attribute:: mpn
+
+ The manufacturer's part number for this product.
+
+ This should be a :class:`Mpn` element, for example::
+
+ entry = ProductEntry()
+ entry.mpn = Mpn('cd700199US')
+
+ .. attribute:: pattern
+
+ The pattern of the product.
+
+ This should be a :class:`Pattern` element, for example::
+
+ entry = ProductEntry()
+ entry.pattern = Pattern('polka dots')
+
+ .. attribute:: performance
+
+ The performance of the product.
+
+ This should be a :class:`Performance` element.
+
+ .. attribute:: price
+
+ The price for this product.
+
+ This should be a :class:`Price` element, including a unit argument to
+ indicate the currency, for example::
+
+ entry = ProductEntry()
+ entry.price = Price('20.00', unit='USD')
+
+ .. attribute:: product_id
+
+ A link to the product image. This link should be an
+ :class:`ProductId` element, for example::
+
+ entry = ProductEntry()
+ entry.product_id = ProductId('ABC1234')
+
+ .. attribute:: product_type
+
+ The type of product.
+
+ This should be a :class:`ProductType` element, for example::
+
+ entry = ProductEntry()
+ entry.product_type = ProductType("Electronics > Video > Projectors")
+
+ .. attribute:: quantity
+
+ The quantity of product available in stock.
+
+ This should be a :class:`Quantity` element, for example::
+
+ entry = ProductEntry()
+ entry.quantity = Quantity('100')
+
+ .. attribute:: shipping
+
+ The shipping rules for the product.
+
+ This should be a :class:`Shipping` with the necessary rules embedded as
+ elements, for example::
+
+ shipping = Shipping()
+ shipping.shipping_price = ShippingPrice('10.00', unit='USD')
+ entry = ProductEntry()
+ entry.shipping.append(shipping)
+
+ .. attribute:: shipping_weight
+
+ The shipping weight for this product.
+
+ This should be a :class:`ShippingWeight` element, including a unit parameter
+ for the unit of weight, for example::
+
+ entry = ProductEntry()
+ entry.shipping_weight = ShippingWeight('10.45', unit='kg')
+
+ .. attribute:: size
+
+ A list of the available sizes for this product.
+
+ Each item in this list should be a :class:`Size` element, for example::
+
+ entry = ProductEntry()
+ entry.size.append(Size('Small'))
+ entry.size.append(Size('Medium'))
+ entry.size.append(Size('Large'))
+
+ .. attribute:: target_country
+
+ The target country for the product.
+
+ This should be a :class:`TargetCountry` element, for example::
+
+ entry = ProductEntry()
+ entry.target_country = TargetCountry('US')
+
+ .. attribute:: tax
+
+ The tax rules for this product.
+
+ This should be a :class:`Tax` element, with the tax rule elements embedded
+ within, for example::
+
+ tax = Tax()
+ tax.tax_rate = TaxRate('17.5')
+ entry = ProductEntry()
+ entry.tax.append(tax)
+
+ .. attribute:: year
+
+ The year the product was created.
+
+ This should be a :class:`Year` element, for example::
+
+ entry = ProductEntry()
+ entry.year = Year('2001')
+ """
+
+ additional_image_link = [AdditionalImageLink]
+ author = Author
+ attribute = [Attribute]
+ availability = Availability
+ brand = Brand
+ channel = Channel
+ color = Color
+ condition = Condition
+ content_language = ContentLanguage
+ control = ProductControl
+ edition = Edition
+ expiration_date = ExpirationDate
+ feature = [Feature]
+ featured_product = FeaturedProduct
+ gender = Gender
+ genre = Genre
+ google_product_category = GoogleProductCategory
+ group = [Group]
+ gtin = Gtin
+ image_link = ImageLink
+ item_group_id = ItemGroupID
+ manufacturer = Manufacturer
+ material = Material
+ mpn = Mpn
+ pattern = Pattern
+ performance = Performance
+ price = Price
+ product_id = ProductId
+ product_type = ProductType
+ quantity = Quantity
+ shipping = [Shipping]
+ shipping_weight = ShippingWeight
+ size = [Size]
+ target_country = TargetCountry
+ tax = [Tax]
+ year = Year
+ identifier_exists = IdentifierExists
+ unit_pricing_measure = UnitPricingMeasure
+ unit_pricing_base_measure = UnitPricingBaseMeasure
+ energy_efficiency_class = EnergyEfficiencyClass
+ multipack = Multipack
+
+ def get_batch_errors(self):
+ """Attempts to parse errors from atom:content element.
+
+ If the atom:content element is type application/vnd.google.gdata.error+xml,
+ then it will contain a gd:errors block.
+
+ Returns:
+ If the type of the content element is not
+ 'application/vnd.google.gdata.error+xml', or 0 or more than 1
+ gd:errors elements are found within the <content type='app...'> block,
+ then None is returned. Other wise, the gd:errors element parsed
+ as a ContentForShoppingErrors object is returned.
+ """
+ if self.content.type == 'application/vnd.google.gdata.error+xml':
+ errors_elements = self.content.get_elements(tag='errors',
+ namespace=GD_NAMESPACE)
+ if len(errors_elements) == 1:
+ errors_block = errors_elements[0]
+ return atom.core.parse(errors_block.to_string(),
+ ContentForShoppingErrors)
+ return None
+
+ GetBatchErrors = get_batch_errors
+
+
+class ErrorDomain(atom.core.XmlElement):
+ """gd:domain element
+
+ The scope of the error. If the error is global (e.g. missing title) then sc
+ value is returned. Otherwise a comma-separated list of destinations is
+ returned.
+
+ This element should be placed inside the gd:error (ContentForShoppingError)
+ element.
+ """
+ _qname = GD_NAMESPACE_TEMPLATE % 'domain'
+
+
+class ErrorCode(atom.core.XmlElement):
+ """gd:code element
+
+ A code to categorize the errors.
+
+ This element should be placed inside the gd:error (ContentForShoppingError)
+ element.
+ """
+ _qname = GD_NAMESPACE_TEMPLATE % 'code'
+
+
+class ErrorLocation(atom.core.XmlElement):
+ """gd:location element
+
+ The name of the attribute that failed validation.
+
+ This element should be placed inside the gd:error (ContentForShoppingError)
+ element.
+ """
+ _qname = GD_NAMESPACE_TEMPLATE % 'location'
+ type = 'type'
+
+
+class InternalReason(atom.core.XmlElement):
+ """gd:internalReason element
+
+ A more detailed message to explain the cause of the error.
+
+ This element should be placed inside the gd:error (ContentForShoppingError)
+ element.
+ """
+ _qname = GD_NAMESPACE_TEMPLATE % 'internalReason'
+
+
+class ContentForShoppingError(atom.core.XmlElement):
+ """gd:error element
+
+ This element should be placed inside the gd:errors (ContentForShoppingErrors)
+ element.
+ """
+ _qname = GD_NAMESPACE_TEMPLATE % 'error'
+ domain = ErrorDomain
+ code = ErrorCode
+ location = ErrorLocation
+ internal_reason = InternalReason
+
+ @property
+ def id(self):
+ """Id for error element.
+
+ The namespace for the id element is different in batch requests than in
+ individual requests, so we need to consider either case.
+ """
+ for element in self.GetElements():
+ if element.tag == 'id':
+ if element.namespace in (GD_NAMESPACE, ATOM_NAMESPACE):
+ return element.text
+
+ return None
+
+
+class ContentForShoppingErrors(atom.core.XmlElement):
+ """The gd:errors element."""
+ _qname = GD_NAMESPACE_TEMPLATE % 'errors'
+ errors = [ContentForShoppingError]
+
+
+# opensearch needs overriding for wrong version
+# see http://code.google.com/p/gdata-python-client/issues/detail?id=483
+class TotalResults(gdata.data.TotalResults):
+
+ _qname = gdata.data.TotalResults._qname[1]
+
+
+class ItemsPerPage(gdata.data.ItemsPerPage):
+
+ _qname = gdata.data.ItemsPerPage._qname[1]
+
+
+class StartIndex(gdata.data.StartIndex):
+
+ _qname = gdata.data.StartIndex._qname[1]
+
+
+class ProductFeed(gdata.data.BatchFeed):
+ """Represents a feed of a merchant's products."""
+ entry = [ProductEntry]
+ total_results = TotalResults
+ items_per_page = ItemsPerPage
+ start_index = StartIndex
+
+ def get_start_token(self):
+ """Attempts to parse start-token from rel="next" link.
+
+ A products feed may contain a rel="next" atom:link and the
+ href contained in the link may have a start-token query parameter.
+
+ Returns:
+ If there is no rel="next" link or the rel="next" link doesn't contain
+ the start-token query parameter, None is returned. Otherwise, the
+ string value of the start-token query parameter is returned.
+ """
+ next_link = self.get_next_link()
+ if next_link is not None:
+ uri = atom.http_core.parse_uri(next_link.href)
+ if 'start-token' in uri.query:
+ return uri.query['start-token']
+ return None
+
+ GetStartToken = get_start_token
+
+
+class Edited(atom.core.XmlElement):
+ """sc:edited element
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'edited'
+
+
+class AttributeLanguage(atom.core.XmlElement):
+ """sc:attribute_language element
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'attribute_language'
+
+
+class FeedFileName(atom.core.XmlElement):
+ """sc:feed_file_name element
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'feed_file_name'
+
+
+class FeedType(atom.core.XmlElement):
+ """sc:feed_type element
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'feed_type'
+
+
+class UseQuotedFields(atom.core.XmlElement):
+ """sc:use_quoted_fields element
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'use_quoted_fields'
+
+
+class FileFormat(atom.core.XmlElement):
+ """sc:file_format element
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'file_format'
+ use_quoted_fields = UseQuotedFields
+ format = 'format'
+
+
+class ProcessingStatus(atom.core.XmlElement):
+ """sc:processing_status element
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'processing_status'
+
+
+class DatafeedEntry(gdata.data.GDEntry):
+ """An entry for a Datafeed."""
+ content_language = ContentLanguage
+ target_country = TargetCountry
+ feed_file_name = FeedFileName
+ file_format = FileFormat
+ attribute_language = AttributeLanguage
+ processing_status = ProcessingStatus
+ edited = Edited
+ feed_type = FeedType
+
+
+class DatafeedFeed(gdata.data.GDFeed):
+ """A datafeed feed."""
+ entry = [DatafeedEntry]
+ total_results = TotalResults
+ items_per_page = ItemsPerPage
+ start_index = StartIndex
+
+
+class AdultContent(atom.core.XmlElement):
+ """sc:adult_content element
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'adult_content'
+
+
+class InternalId(atom.core.XmlElement):
+ """sc:internal_id element
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'internal_id'
+
+
+class ReviewsUrl(atom.core.XmlElement):
+ """sc:reviews_url element
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'reviews_url'
+
+
+class AdwordsAccount(atom.core.XmlElement):
+ """sc:adwords_account element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'adwords_account'
+ status = 'status'
+
+
+class AdwordsAccounts(atom.core.XmlElement):
+ """sc:adwords_accounts element
+
+ Container element for adwords accounts settings.
+ """
+ _qname = SC_NAMESPACE_TEMPLATE % 'adwords_accounts'
+ adwords_account = [AdwordsAccount]
+
+
+class ClientAccount(gdata.data.GDEntry):
+ """A multiclient account entry."""
+ adult_content = AdultContent
+ internal_id = InternalId
+ reviews_url = ReviewsUrl
+ adwords_accounts = AdwordsAccounts
+
+
+class ClientAccountFeed(gdata.data.GDFeed):
+ """A multiclient account feed."""
+ entry = [ClientAccount]
+ total_results = TotalResults
+ items_per_page = ItemsPerPage
+ start_index = StartIndex
+
+
+# Users Feed Classes
+class Admin(atom.core.XmlElement):
+ """sc:admin element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'admin'
+
+
+class Permission(atom.core.XmlElement):
+ """sc:permission element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'permission'
+ scope = 'scope'
+
+
+class UsersEntry(gdata.data.GDEntry):
+ """A User Management Feed entry."""
+ admin = Admin
+ permission = [Permission]
+
+
+class UsersFeed(gdata.data.GDFeed):
+ """A User Management Feed."""
+ entry = [UsersEntry]
+ total_results = TotalResults
+ items_per_page = ItemsPerPage
+ start_index = StartIndex
+
+
+# Data Quality Feed Classes
+class ExampleItemLink(atom.core.XmlElement):
+ """sc:link element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'link'
+
+
+class ExampleItemTitle(atom.core.XmlElement):
+ """sc:title element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'title'
+
+
+class ItemId(atom.core.XmlElement):
+ """sc:item_id element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'item_id'
+
+
+class SubmittedValue(atom.core.XmlElement):
+ """sc:submitted_value element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'submitted_value'
+
+
+class ValueOnLandingPage(atom.core.XmlElement):
+ """sc:value_on_landing_page element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'value_on_landing_page'
+
+
+class ExampleItem(atom.core.XmlElement):
+ """sc:example_item element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'example_item'
+ item_id = ItemId
+ link = ExampleItemLink
+ title = ExampleItemTitle
+ submitted_value = SubmittedValue
+ value_on_landing_page = ValueOnLandingPage
+
+
+class Issue(atom.core.XmlElement):
+ """sc:issue element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'issue'
+ id = 'id'
+ last_checked = 'last_checked'
+ num_items = 'num_items'
+ offending_term = 'offending_term'
+ example_item = [ExampleItem]
+
+
+class IssueGroup(atom.core.XmlElement):
+ """sc:issue_group element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'issue_group'
+ issue = [Issue]
+ country = 'country'
+ id = 'id'
+
+
+class IssueGroups(atom.core.XmlElement):
+ """sc:issue_groups element"""
+ _qname = SC_NAMESPACE_TEMPLATE % 'issue_groups'
+ issue_group = [IssueGroup]
+
+
+class DataQualityEntry(gdata.data.GDEntry):
+ """A Data Quality Feed entry."""
+ issue_groups = IssueGroups
+
+
+class DataQualityFeed(gdata.data.GDFeed):
+ """A Data Quality Feed."""
+ entry = [DataQualityEntry]
+ total_results = TotalResults
+ items_per_page = ItemsPerPage
+ start_index = StartIndex
+
+
+# Local Products Feed Classes
+class SalePrice(atom.core.XmlElement):
+ """scp:sale_price element
+
+ The sale price of the product. The unit attribute must be set, and should
+ represent the currency.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'sale_price'
+ unit = 'unit'
+
+
+class SalePriceEffectiveDate(atom.core.XmlElement):
+ """scp:sale_price_effective_date element
+
+ The effective date of the sale price of the product.
+ """
+ _qname = SCP_NAMESPACE_TEMPLATE % 'sale_price_effective_date'
+
+
+class InventoryEntry(gdata.data.BatchEntry):
+ """Product entry containing local product information.
+
+ The elements of this entry that are used are made up of five different
+ namespaces. They are:
+
+ atom: - Atom
+ app: - Atom Publishing Protocol
+ gd: - Google Data API
+ sc: - Content API for Shopping, general attributes
+ scp: - Content API for Shopping, product attributes
+
+ Only the sc and scp namespace elements are defined here, but additional useful
+ elements are defined in superclasses.
+
+ To remove the value of an attribute of a local product, set the value of the
+ attribute to the empty string. For example:
+
+ entry.availability = Availability('')
+
+ The following attributes are encoded as XML elements in the Atom (atom:)
+ namespace: title, link, entry, id, category, content, author, created
+ updated. Among these, the title, content and link tags are part of the
+ required Content for Shopping API so we document them here.
+
+ .. attribute:: availability
+
+ The avilability of a local product.
+
+ This should be an :class:`Availability` instance, for example::
+
+ entry = InventoryEntry()
+ entry.availability = Availability('in stock')
+
+ .. attribute:: price
+
+ The price for this local product.
+
+ This should be a :class:`Price` element, including a unit argument to
+ indicate the currency, for example::
+
+ entry = InventoryEntry()
+ entry.price = Price('20.00', unit='USD')
+
+ .. attribute:: quantity
+
+ The quantity of local product available in stock.
+
+ This should be a :class:`Quantity` element, for example::
+
+ entry = InventoryEntry()
+ entry.quantity = Quantity('100')
+
+ .. attribute:: sale_price
+
+ The sale price for this local product.
+
+ This should be a :class:`SalePrice` element, including a unit argument to
+ indicate the currency, for example::
+
+ entry = InventoryEntry()
+ entry.sale_price = SalePrice('20.00', unit='USD')
+
+ .. attribute:: sale_price_effective_date
+
+ The effective data of the sale price for this local product.
+
+ This should be a :class:`SalePriceEffectiveDate` element, for example::
+
+ entry = InventoryEntry()
+ entry.sale_price_effective_date = SalePriceEffectiveDate(
+ '2012-01-09 2012-01-13')
+ """
+ availability = Availability
+ price = Price
+ quantity = Quantity
+ sale_price = SalePrice
+ sale_price_effective_date = SalePriceEffectiveDate
+
+
+class InventoryFeed(gdata.data.BatchFeed):
+ """Represents a feed of a merchant's local products."""
+ entry = [InventoryEntry]
+ total_results = TotalResults
+ items_per_page = ItemsPerPage
+ start_index = StartIndex
diff --git a/src/gdata/core.py b/src/gdata/core.py
new file mode 100644
index 0000000..0661ec6
--- /dev/null
+++ b/src/gdata/core.py
@@ -0,0 +1,279 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2010 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+"""Provides classes and methods for working with JSON-C.
+
+This module is experimental and subject to backwards incompatible changes.
+
+ Jsonc: Class which represents JSON-C data and provides pythonic member
+ access which is a bit cleaner than working with plain old dicts.
+ parse_json: Converts a JSON-C string into a Jsonc object.
+ jsonc_to_string: Converts a Jsonc object into a string of JSON-C.
+"""
+
+
+try:
+ import simplejson
+except ImportError:
+ try:
+ # Try to import from django, should work on App Engine
+ from django.utils import simplejson
+ except ImportError:
+ # Should work for Python2.6 and higher.
+ import json as simplejson
+
+
+def _convert_to_jsonc(x):
+ """Builds a Jsonc objects which wraps the argument's members."""
+
+ if isinstance(x, dict):
+ jsonc_obj = Jsonc()
+ # Recursively transform all members of the dict.
+ # When converting a dict, we do not convert _name items into private
+ # Jsonc members.
+ for key, value in x.iteritems():
+ jsonc_obj._dict[key] = _convert_to_jsonc(value)
+ return jsonc_obj
+ elif isinstance(x, list):
+ # Recursively transform all members of the list.
+ members = []
+ for item in x:
+ members.append(_convert_to_jsonc(item))
+ return members
+ else:
+ # Return the base object.
+ return x
+
+
+def parse_json(json_string):
+ """Converts a JSON-C string into a Jsonc object.
+
+ Args:
+ json_string: str or unicode The JSON to be parsed.
+
+ Returns:
+ A new Jsonc object.
+ """
+
+ return _convert_to_jsonc(simplejson.loads(json_string))
+
+
+def parse_json_file(json_file):
+ return _convert_to_jsonc(simplejson.load(json_file))
+
+
+def jsonc_to_string(jsonc_obj):
+ """Converts a Jsonc object into a string of JSON-C."""
+
+ return simplejson.dumps(_convert_to_object(jsonc_obj))
+
+
+def prettify_jsonc(jsonc_obj, indentation=2):
+ """Converts a Jsonc object to a pretified (intented) JSON string."""
+
+ return simplejson.dumps(_convert_to_object(jsonc_obj), indent=indentation)
+
+
+
+def _convert_to_object(jsonc_obj):
+ """Creates a new dict or list which has the data in the Jsonc object.
+
+ Used to convert the Jsonc object to a plain old Python object to simplify
+ conversion to a JSON-C string.
+
+ Args:
+ jsonc_obj: A Jsonc object to be converted into simple Python objects
+ (dicts, lists, etc.)
+
+ Returns:
+ Either a dict, list, or other object with members converted from Jsonc
+ objects to the corresponding simple Python object.
+ """
+
+ if isinstance(jsonc_obj, Jsonc):
+ plain = {}
+ for key, value in jsonc_obj._dict.iteritems():
+ plain[key] = _convert_to_object(value)
+ return plain
+ elif isinstance(jsonc_obj, list):
+ plain = []
+ for item in jsonc_obj:
+ plain.append(_convert_to_object(item))
+ return plain
+ else:
+ return jsonc_obj
+
+
+def _to_jsonc_name(member_name):
+ """Converts a Python style member name to a JSON-C style name.
+
+ JSON-C uses camelCaseWithLower while Python tends to use
+ lower_with_underscores so this method converts as follows:
+
+ spam becomes spam
+ spam_and_eggs becomes spamAndEggs
+
+ Args:
+ member_name: str or unicode The Python syle name which should be
+ converted to JSON-C style.
+
+ Returns:
+ The JSON-C style name as a str or unicode.
+ """
+
+ characters = []
+ uppercase_next = False
+ for character in member_name:
+ if character == '_':
+ uppercase_next = True
+ elif uppercase_next:
+ characters.append(character.upper())
+ uppercase_next = False
+ else:
+ characters.append(character)
+ return ''.join(characters)
+
+
+class Jsonc(object):
+ """Represents JSON-C data in an easy to access object format.
+
+ To access the members of a JSON structure which looks like this:
+ {
+ "data": {
+ "totalItems": 800,
+ "items": [
+ {
+ "content": {
+ "1": "rtsp://v5.cache3.c.youtube.com/CiILENy.../0/0/0/video.3gp"
+ },
+ "viewCount": 220101,
+ "commentCount": 22,
+ "favoriteCount": 201
+ }
+ ]
+ },
+ "apiVersion": "2.0"
+ }
+
+ You would do the following:
+ x = gdata.core.parse_json(the_above_string)
+ # Gives you 800
+ x.data.total_items
+ # Should be 22
+ x.data.items[0].comment_count
+ # The apiVersion is '2.0'
+ x.api_version
+
+ To create a Jsonc object which would produce the above JSON, you would do:
+ gdata.core.Jsonc(
+ api_version='2.0',
+ data=gdata.core.Jsonc(
+ total_items=800,
+ items=[
+ gdata.core.Jsonc(
+ view_count=220101,
+ comment_count=22,
+ favorite_count=201,
+ content={
+ '1': ('rtsp://v5.cache3.c.youtube.com'
+ '/CiILENy.../0/0/0/video.3gp')})]))
+ or
+ x = gdata.core.Jsonc()
+ x.api_version = '2.0'
+ x.data = gdata.core.Jsonc()
+ x.data.total_items = 800
+ x.data.items = []
+ # etc.
+
+ How it works:
+ The JSON-C data is stored in an internal dictionary (._dict) and the
+ getattr, setattr, and delattr methods rewrite the name which you provide
+ to mirror the expected format in JSON-C. (For more details on name
+ conversion see _to_jsonc_name.) You may also access members using
+ getitem, setitem, delitem as you would for a dictionary. For example
+ x.data.total_items is equivalent to x['data']['totalItems']
+ (Not all dict methods are supported so if you need something other than
+ the item operations, then you will want to use the ._dict member).
+
+ You may need to use getitem or the _dict member to access certain
+ properties in cases where the JSON-C syntax does not map neatly to Python
+ objects. For example the YouTube Video feed has some JSON like this:
+ "content": {"1": "rtsp://v5.cache3.c.youtube.com..."...}
+ You cannot do x.content.1 in Python, so you would use the getitem as
+ follows:
+ x.content['1']
+ or you could use the _dict member as follows:
+ x.content._dict['1']
+
+ If you need to create a new object with such a mapping you could use.
+
+ x.content = gdata.core.Jsonc(_dict={'1': 'rtsp://cache3.c.youtube.com...'})
+ """
+
+ def __init__(self, _dict=None, **kwargs):
+ json = _dict or {}
+ for key, value in kwargs.iteritems():
+ if key.startswith('_'):
+ object.__setattr__(self, key, value)
+ else:
+ json[_to_jsonc_name(key)] = _convert_to_jsonc(value)
+
+ object.__setattr__(self, '_dict', json)
+
+ def __setattr__(self, name, value):
+ if name.startswith('_'):
+ object.__setattr__(self, name, value)
+ else:
+ object.__getattribute__(
+ self, '_dict')[_to_jsonc_name(name)] = _convert_to_jsonc(value)
+
+ def __getattr__(self, name):
+ if name.startswith('_'):
+ object.__getattribute__(self, name)
+ else:
+ try:
+ return object.__getattribute__(self, '_dict')[_to_jsonc_name(name)]
+ except KeyError:
+ raise AttributeError(
+ 'No member for %s or [\'%s\']' % (name, _to_jsonc_name(name)))
+
+
+ def __delattr__(self, name):
+ if name.startswith('_'):
+ object.__delattr__(self, name)
+ else:
+ try:
+ del object.__getattribute__(self, '_dict')[_to_jsonc_name(name)]
+ except KeyError:
+ raise AttributeError(
+ 'No member for %s (or [\'%s\'])' % (name, _to_jsonc_name(name)))
+
+ # For container methods pass-through to the underlying dict.
+ def __getitem__(self, key):
+ return self._dict[key]
+
+ def __setitem__(self, key, value):
+ self._dict[key] = value
+
+ def __delitem__(self, key):
+ del self._dict[key]
diff --git a/src/gdata/data.py b/src/gdata/data.py
new file mode 100644
index 0000000..3bf1850
--- /dev/null
+++ b/src/gdata/data.py
@@ -0,0 +1,1219 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+"""Provides classes and constants for the XML in the Google Data namespace.
+
+Documentation for the raw XML which these classes represent can be found here:
+http://code.google.com/apis/gdata/docs/2.0/elements.html
+"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import os
+import atom.core
+import atom.data
+
+
+GDATA_TEMPLATE = '{http://schemas.google.com/g/2005}%s'
+GD_TEMPLATE = GDATA_TEMPLATE
+OPENSEARCH_TEMPLATE_V1 = '{http://a9.com/-/spec/opensearchrss/1.0/}%s'
+OPENSEARCH_TEMPLATE_V2 = '{http://a9.com/-/spec/opensearch/1.1/}%s'
+BATCH_TEMPLATE = '{http://schemas.google.com/gdata/batch}%s'
+
+
+# Labels used in batch request entries to specify the desired CRUD operation.
+BATCH_INSERT = 'insert'
+BATCH_UPDATE = 'update'
+BATCH_DELETE = 'delete'
+BATCH_QUERY = 'query'
+
+EVENT_LOCATION = 'http://schemas.google.com/g/2005#event'
+ALTERNATE_LOCATION = 'http://schemas.google.com/g/2005#event.alternate'
+PARKING_LOCATION = 'http://schemas.google.com/g/2005#event.parking'
+
+CANCELED_EVENT = 'http://schemas.google.com/g/2005#event.canceled'
+CONFIRMED_EVENT = 'http://schemas.google.com/g/2005#event.confirmed'
+TENTATIVE_EVENT = 'http://schemas.google.com/g/2005#event.tentative'
+
+CONFIDENTIAL_EVENT = 'http://schemas.google.com/g/2005#event.confidential'
+DEFAULT_EVENT = 'http://schemas.google.com/g/2005#event.default'
+PRIVATE_EVENT = 'http://schemas.google.com/g/2005#event.private'
+PUBLIC_EVENT = 'http://schemas.google.com/g/2005#event.public'
+
+OPAQUE_EVENT = 'http://schemas.google.com/g/2005#event.opaque'
+TRANSPARENT_EVENT = 'http://schemas.google.com/g/2005#event.transparent'
+
+CHAT_MESSAGE = 'http://schemas.google.com/g/2005#message.chat'
+INBOX_MESSAGE = 'http://schemas.google.com/g/2005#message.inbox'
+SENT_MESSAGE = 'http://schemas.google.com/g/2005#message.sent'
+SPAM_MESSAGE = 'http://schemas.google.com/g/2005#message.spam'
+STARRED_MESSAGE = 'http://schemas.google.com/g/2005#message.starred'
+UNREAD_MESSAGE = 'http://schemas.google.com/g/2005#message.unread'
+
+BCC_RECIPIENT = 'http://schemas.google.com/g/2005#message.bcc'
+CC_RECIPIENT = 'http://schemas.google.com/g/2005#message.cc'
+SENDER = 'http://schemas.google.com/g/2005#message.from'
+REPLY_TO = 'http://schemas.google.com/g/2005#message.reply-to'
+TO_RECIPIENT = 'http://schemas.google.com/g/2005#message.to'
+
+ASSISTANT_REL = 'http://schemas.google.com/g/2005#assistant'
+CALLBACK_REL = 'http://schemas.google.com/g/2005#callback'
+CAR_REL = 'http://schemas.google.com/g/2005#car'
+COMPANY_MAIN_REL = 'http://schemas.google.com/g/2005#company_main'
+FAX_REL = 'http://schemas.google.com/g/2005#fax'
+HOME_REL = 'http://schemas.google.com/g/2005#home'
+HOME_FAX_REL = 'http://schemas.google.com/g/2005#home_fax'
+ISDN_REL = 'http://schemas.google.com/g/2005#isdn'
+MAIN_REL = 'http://schemas.google.com/g/2005#main'
+MOBILE_REL = 'http://schemas.google.com/g/2005#mobile'
+OTHER_REL = 'http://schemas.google.com/g/2005#other'
+OTHER_FAX_REL = 'http://schemas.google.com/g/2005#other_fax'
+PAGER_REL = 'http://schemas.google.com/g/2005#pager'
+RADIO_REL = 'http://schemas.google.com/g/2005#radio'
+TELEX_REL = 'http://schemas.google.com/g/2005#telex'
+TTL_TDD_REL = 'http://schemas.google.com/g/2005#tty_tdd'
+WORK_REL = 'http://schemas.google.com/g/2005#work'
+WORK_FAX_REL = 'http://schemas.google.com/g/2005#work_fax'
+WORK_MOBILE_REL = 'http://schemas.google.com/g/2005#work_mobile'
+WORK_PAGER_REL = 'http://schemas.google.com/g/2005#work_pager'
+NETMEETING_REL = 'http://schemas.google.com/g/2005#netmeeting'
+OVERALL_REL = 'http://schemas.google.com/g/2005#overall'
+PRICE_REL = 'http://schemas.google.com/g/2005#price'
+QUALITY_REL = 'http://schemas.google.com/g/2005#quality'
+EVENT_REL = 'http://schemas.google.com/g/2005#event'
+EVENT_ALTERNATE_REL = 'http://schemas.google.com/g/2005#event.alternate'
+EVENT_PARKING_REL = 'http://schemas.google.com/g/2005#event.parking'
+
+AIM_PROTOCOL = 'http://schemas.google.com/g/2005#AIM'
+MSN_PROTOCOL = 'http://schemas.google.com/g/2005#MSN'
+YAHOO_MESSENGER_PROTOCOL = 'http://schemas.google.com/g/2005#YAHOO'
+SKYPE_PROTOCOL = 'http://schemas.google.com/g/2005#SKYPE'
+QQ_PROTOCOL = 'http://schemas.google.com/g/2005#QQ'
+GOOGLE_TALK_PROTOCOL = 'http://schemas.google.com/g/2005#GOOGLE_TALK'
+ICQ_PROTOCOL = 'http://schemas.google.com/g/2005#ICQ'
+JABBER_PROTOCOL = 'http://schemas.google.com/g/2005#JABBER'
+
+REGULAR_COMMENTS = 'http://schemas.google.com/g/2005#regular'
+REVIEW_COMMENTS = 'http://schemas.google.com/g/2005#reviews'
+
+MAIL_BOTH = 'http://schemas.google.com/g/2005#both'
+MAIL_LETTERS = 'http://schemas.google.com/g/2005#letters'
+MAIL_PARCELS = 'http://schemas.google.com/g/2005#parcels'
+MAIL_NEITHER = 'http://schemas.google.com/g/2005#neither'
+
+GENERAL_ADDRESS = 'http://schemas.google.com/g/2005#general'
+LOCAL_ADDRESS = 'http://schemas.google.com/g/2005#local'
+
+OPTIONAL_ATENDEE = 'http://schemas.google.com/g/2005#event.optional'
+REQUIRED_ATENDEE = 'http://schemas.google.com/g/2005#event.required'
+
+ATTENDEE_ACCEPTED = 'http://schemas.google.com/g/2005#event.accepted'
+ATTENDEE_DECLINED = 'http://schemas.google.com/g/2005#event.declined'
+ATTENDEE_INVITED = 'http://schemas.google.com/g/2005#event.invited'
+ATTENDEE_TENTATIVE = 'http://schemas.google.com/g/2005#event.tentative'
+
+FULL_PROJECTION = 'full'
+VALUES_PROJECTION = 'values'
+BASIC_PROJECTION = 'basic'
+
+PRIVATE_VISIBILITY = 'private'
+PUBLIC_VISIBILITY = 'public'
+
+OPAQUE_TRANSPARENCY = 'http://schemas.google.com/g/2005#event.opaque'
+TRANSPARENT_TRANSPARENCY = 'http://schemas.google.com/g/2005#event.transparent'
+
+CONFIDENTIAL_EVENT_VISIBILITY = 'http://schemas.google.com/g/2005#event.confidential'
+DEFAULT_EVENT_VISIBILITY = 'http://schemas.google.com/g/2005#event.default'
+PRIVATE_EVENT_VISIBILITY = 'http://schemas.google.com/g/2005#event.private'
+PUBLIC_EVENT_VISIBILITY = 'http://schemas.google.com/g/2005#event.public'
+
+CANCELED_EVENT_STATUS = 'http://schemas.google.com/g/2005#event.canceled'
+CONFIRMED_EVENT_STATUS = 'http://schemas.google.com/g/2005#event.confirmed'
+TENTATIVE_EVENT_STATUS = 'http://schemas.google.com/g/2005#event.tentative'
+
+ACL_REL = 'http://schemas.google.com/acl/2007#accessControlList'
+
+
+class Error(Exception):
+ pass
+
+
+class MissingRequiredParameters(Error):
+ pass
+
+
+class LinkFinder(atom.data.LinkFinder):
+ """Mixin used in Feed and Entry classes to simplify link lookups by type.
+
+ Provides lookup methods for edit, edit-media, post, ACL and other special
+ links which are common across Google Data APIs.
+ """
+
+ def find_html_link(self):
+ """Finds the first link with rel of alternate and type of text/html."""
+ for link in self.link:
+ if link.rel == 'alternate' and link.type == 'text/html':
+ return link.href
+ return None
+
+ FindHtmlLink = find_html_link
+
+ def get_html_link(self):
+ for a_link in self.link:
+ if a_link.rel == 'alternate' and a_link.type == 'text/html':
+ return a_link
+ return None
+
+ GetHtmlLink = get_html_link
+
+ def find_post_link(self):
+ """Get the URL to which new entries should be POSTed.
+
+ The POST target URL is used to insert new entries.
+
+ Returns:
+ A str for the URL in the link with a rel matching the POST type.
+ """
+ return self.find_url('http://schemas.google.com/g/2005#post')
+
+ FindPostLink = find_post_link
+
+ def get_post_link(self):
+ return self.get_link('http://schemas.google.com/g/2005#post')
+
+ GetPostLink = get_post_link
+
+ def find_acl_link(self):
+ acl_link = self.get_acl_link()
+ if acl_link:
+ return acl_link.href
+
+ return None
+
+ FindAclLink = find_acl_link
+
+ def get_acl_link(self):
+ """Searches for a link or feed_link (if present) with the rel for ACL."""
+
+ acl_link = self.get_link(ACL_REL)
+ if acl_link:
+ return acl_link
+ elif hasattr(self, 'feed_link'):
+ for a_feed_link in self.feed_link:
+ if a_feed_link.rel == ACL_REL:
+ return a_feed_link
+
+ return None
+
+ GetAclLink = get_acl_link
+
+ def find_feed_link(self):
+ return self.find_url('http://schemas.google.com/g/2005#feed')
+
+ FindFeedLink = find_feed_link
+
+ def get_feed_link(self):
+ return self.get_link('http://schemas.google.com/g/2005#feed')
+
+ GetFeedLink = get_feed_link
+
+ def find_previous_link(self):
+ return self.find_url('previous')
+
+ FindPreviousLink = find_previous_link
+
+ def get_previous_link(self):
+ return self.get_link('previous')
+
+ GetPreviousLink = get_previous_link
+
+
+class TotalResults(atom.core.XmlElement):
+ """opensearch:TotalResults for a GData feed."""
+ _qname = (OPENSEARCH_TEMPLATE_V1 % 'totalResults',
+ OPENSEARCH_TEMPLATE_V2 % 'totalResults')
+
+
+class StartIndex(atom.core.XmlElement):
+ """The opensearch:startIndex element in GData feed."""
+ _qname = (OPENSEARCH_TEMPLATE_V1 % 'startIndex',
+ OPENSEARCH_TEMPLATE_V2 % 'startIndex')
+
+
+class ItemsPerPage(atom.core.XmlElement):
+ """The opensearch:itemsPerPage element in GData feed."""
+ _qname = (OPENSEARCH_TEMPLATE_V1 % 'itemsPerPage',
+ OPENSEARCH_TEMPLATE_V2 % 'itemsPerPage')
+
+
+class ExtendedProperty(atom.core.XmlElement):
+ """The Google Data extendedProperty element.
+
+ Used to store arbitrary key-value information specific to your
+ application. The value can either be a text string stored as an XML
+ attribute (.value), or an XML node (XmlBlob) as a child element.
+
+ This element is used in the Google Calendar data API and the Google
+ Contacts data API.
+ """
+ _qname = GDATA_TEMPLATE % 'extendedProperty'
+ name = 'name'
+ value = 'value'
+
+ def get_xml_blob(self):
+ """Returns the XML blob as an atom.core.XmlElement.
+
+ Returns:
+ An XmlElement representing the blob's XML, or None if no
+ blob was set.
+ """
+ if self._other_elements:
+ return self._other_elements[0]
+ else:
+ return None
+
+ GetXmlBlob = get_xml_blob
+
+ def set_xml_blob(self, blob):
+ """Sets the contents of the extendedProperty to XML as a child node.
+
+ Since the extendedProperty is only allowed one child element as an XML
+ blob, setting the XML blob will erase any preexisting member elements
+ in this object.
+
+ Args:
+ blob: str or atom.core.XmlElement representing the XML blob stored in
+ the extendedProperty.
+ """
+ # Erase any existing extension_elements, clears the child nodes from the
+ # extendedProperty.
+ if isinstance(blob, atom.core.XmlElement):
+ self._other_elements = [blob]
+ else:
+ self._other_elements = [atom.core.parse(str(blob))]
+
+ SetXmlBlob = set_xml_blob
+
+
+class GDEntry(atom.data.Entry, LinkFinder):
+ """Extends Atom Entry to provide data processing"""
+ etag = '{http://schemas.google.com/g/2005}etag'
+
+ def get_id(self):
+ if self.id is not None and self.id.text is not None:
+ return self.id.text.strip()
+ return None
+
+ GetId = get_id
+
+ def is_media(self):
+ if self.find_edit_media_link():
+ return True
+ return False
+
+ IsMedia = is_media
+
+ def find_media_link(self):
+ """Returns the URL to the media content, if the entry is a media entry.
+ Otherwise returns None.
+ """
+ if self.is_media():
+ return self.content.src
+ return None
+
+ FindMediaLink = find_media_link
+
+
+class GDFeed(atom.data.Feed, LinkFinder):
+ """A Feed from a GData service."""
+ etag = '{http://schemas.google.com/g/2005}etag'
+ total_results = TotalResults
+ start_index = StartIndex
+ items_per_page = ItemsPerPage
+ entry = [GDEntry]
+
+ def get_id(self):
+ if self.id is not None and self.id.text is not None:
+ return self.id.text.strip()
+ return None
+
+ GetId = get_id
+
+ def get_generator(self):
+ if self.generator and self.generator.text:
+ return self.generator.text.strip()
+ return None
+
+
+class BatchId(atom.core.XmlElement):
+ """Identifies a single operation in a batch request."""
+ _qname = BATCH_TEMPLATE % 'id'
+
+
+class BatchOperation(atom.core.XmlElement):
+ """The CRUD operation which this batch entry represents."""
+ _qname = BATCH_TEMPLATE % 'operation'
+ type = 'type'
+
+
+class BatchStatus(atom.core.XmlElement):
+ """The batch:status element present in a batch response entry.
+
+ A status element contains the code (HTTP response code) and
+ reason as elements. In a single request these fields would
+ be part of the HTTP response, but in a batch request each
+ Entry operation has a corresponding Entry in the response
+ feed which includes status information.
+
+ See http://code.google.com/apis/gdata/batch.html#Handling_Errors
+ """
+ _qname = BATCH_TEMPLATE % 'status'
+ code = 'code'
+ reason = 'reason'
+ content_type = 'content-type'
+
+
+class BatchEntry(GDEntry):
+ """An atom:entry for use in batch requests.
+
+ The BatchEntry contains additional members to specify the operation to be
+ performed on this entry and a batch ID so that the server can reference
+ individual operations in the response feed. For more information, see:
+ http://code.google.com/apis/gdata/batch.html
+ """
+ batch_operation = BatchOperation
+ batch_id = BatchId
+ batch_status = BatchStatus
+
+
+class BatchInterrupted(atom.core.XmlElement):
+ """The batch:interrupted element sent if batch request was interrupted.
+
+ Only appears in a feed if some of the batch entries could not be processed.
+ See: http://code.google.com/apis/gdata/batch.html#Handling_Errors
+ """
+ _qname = BATCH_TEMPLATE % 'interrupted'
+ reason = 'reason'
+ success = 'success'
+ failures = 'failures'
+ parsed = 'parsed'
+
+
+class BatchFeed(GDFeed):
+ """A feed containing a list of batch request entries."""
+ interrupted = BatchInterrupted
+ entry = [BatchEntry]
+
+ def add_batch_entry(self, entry=None, id_url_string=None,
+ batch_id_string=None, operation_string=None):
+ """Logic for populating members of a BatchEntry and adding to the feed.
+
+ If the entry is not a BatchEntry, it is converted to a BatchEntry so
+ that the batch specific members will be present.
+
+ The id_url_string can be used in place of an entry if the batch operation
+ applies to a URL. For example query and delete operations require just
+ the URL of an entry, no body is sent in the HTTP request. If an
+ id_url_string is sent instead of an entry, a BatchEntry is created and
+ added to the feed.
+
+ This method also assigns the desired batch id to the entry so that it
+ can be referenced in the server's response. If the batch_id_string is
+ None, this method will assign a batch_id to be the index at which this
+ entry will be in the feed's entry list.
+
+ Args:
+ entry: BatchEntry, atom.data.Entry, or another Entry flavor (optional)
+ The entry which will be sent to the server as part of the batch
+ request. The item must have a valid atom id so that the server
+ knows which entry this request references.
+ id_url_string: str (optional) The URL of the entry to be acted on. You
+ can find this URL in the text member of the atom id for an entry.
+ If an entry is not sent, this id will be used to construct a new
+ BatchEntry which will be added to the request feed.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. Note that batch_ids should either always be specified or
+ never, mixing could potentially result in duplicate batch ids.
+ operation_string: str (optional) The desired batch operation which will
+ set the batch_operation.type member of the entry. Options are
+ 'insert', 'update', 'delete', and 'query'
+
+ Raises:
+ MissingRequiredParameters: Raised if neither an id_ url_string nor an
+ entry are provided in the request.
+
+ Returns:
+ The added entry.
+ """
+ if entry is None and id_url_string is None:
+ raise MissingRequiredParameters('supply either an entry or URL string')
+ if entry is None and id_url_string is not None:
+ entry = BatchEntry(id=atom.data.Id(text=id_url_string))
+ if batch_id_string is not None:
+ entry.batch_id = BatchId(text=batch_id_string)
+ elif entry.batch_id is None or entry.batch_id.text is None:
+ entry.batch_id = BatchId(text=str(len(self.entry)))
+ if operation_string is not None:
+ entry.batch_operation = BatchOperation(type=operation_string)
+ self.entry.append(entry)
+ return entry
+
+ AddBatchEntry = add_batch_entry
+
+ def add_insert(self, entry, batch_id_string=None):
+ """Add an insert request to the operations in this batch request feed.
+
+ If the entry doesn't yet have an operation or a batch id, these will
+ be set to the insert operation and a batch_id specified as a parameter.
+
+ Args:
+ entry: BatchEntry The entry which will be sent in the batch feed as an
+ insert request.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. Note that batch_ids should either always be specified or
+ never, mixing could potentially result in duplicate batch ids.
+ """
+ self.add_batch_entry(entry=entry, batch_id_string=batch_id_string,
+ operation_string=BATCH_INSERT)
+
+ AddInsert = add_insert
+
+ def add_update(self, entry, batch_id_string=None):
+ """Add an update request to the list of batch operations in this feed.
+
+ Sets the operation type of the entry to insert if it is not already set
+ and assigns the desired batch id to the entry so that it can be
+ referenced in the server's response.
+
+ Args:
+ entry: BatchEntry The entry which will be sent to the server as an
+ update (HTTP PUT) request. The item must have a valid atom id
+ so that the server knows which entry to replace.
+ batch_id_string: str (optional) The batch ID to be used to reference
+ this batch operation in the results feed. If this parameter is None,
+ the current length of the feed's entry array will be used as a
+ count. See also comments for AddInsert.
+ """
+ self.add_batch_entry(entry=entry, batch_id_string=batch_id_string,
+ operation_string=BATCH_UPDATE)
+
+ AddUpdate = add_update
+
+ def add_delete(self, url_string=None, entry=None, batch_id_string=None):
+ """Adds a delete request to the batch request feed.
+
+ This method takes either the url_string which is the atom id of the item
+ to be deleted, or the entry itself. The atom id of the entry must be
+ present so that the server knows which entry should be deleted.
+
+ Args:
+ url_string: str (optional) The URL of the entry to be deleted. You can
+ find this URL in the text member of the atom id for an entry.
+ entry: BatchEntry (optional) The entry to be deleted.
+ batch_id_string: str (optional)
+
+ Raises:
+ MissingRequiredParameters: Raised if neither a url_string nor an entry
+ are provided in the request.
+ """
+ self.add_batch_entry(entry=entry, id_url_string=url_string,
+ batch_id_string=batch_id_string, operation_string=BATCH_DELETE)
+
+ AddDelete = add_delete
+
+ def add_query(self, url_string=None, entry=None, batch_id_string=None):
+ """Adds a query request to the batch request feed.
+
+ This method takes either the url_string which is the query URL
+ whose results will be added to the result feed. The query URL will
+ be encapsulated in a BatchEntry, and you may pass in the BatchEntry
+ with a query URL instead of sending a url_string.
+
+ Args:
+ url_string: str (optional)
+ entry: BatchEntry (optional)
+ batch_id_string: str (optional)
+
+ Raises:
+ MissingRequiredParameters
+ """
+ self.add_batch_entry(entry=entry, id_url_string=url_string,
+ batch_id_string=batch_id_string, operation_string=BATCH_QUERY)
+
+ AddQuery = add_query
+
+ def find_batch_link(self):
+ return self.find_url('http://schemas.google.com/g/2005#batch')
+
+ FindBatchLink = find_batch_link
+
+
+class EntryLink(atom.core.XmlElement):
+ """The gd:entryLink element.
+
+ Represents a logically nested entry. For example, a <gd:who>
+ representing a contact might have a nested entry from a contact feed.
+ """
+ _qname = GDATA_TEMPLATE % 'entryLink'
+ entry = GDEntry
+ rel = 'rel'
+ read_only = 'readOnly'
+ href = 'href'
+
+
+class FeedLink(atom.core.XmlElement):
+ """The gd:feedLink element.
+
+ Represents a logically nested feed. For example, a calendar feed might
+ have a nested feed representing all comments on entries.
+ """
+ _qname = GDATA_TEMPLATE % 'feedLink'
+ feed = GDFeed
+ rel = 'rel'
+ read_only = 'readOnly'
+ count_hint = 'countHint'
+ href = 'href'
+
+
+class AdditionalName(atom.core.XmlElement):
+ """The gd:additionalName element.
+
+ Specifies additional (eg. middle) name of the person.
+ Contains an attribute for the phonetic representaton of the name.
+ """
+ _qname = GDATA_TEMPLATE % 'additionalName'
+ yomi = 'yomi'
+
+
+class Comments(atom.core.XmlElement):
+ """The gd:comments element.
+
+ Contains a comments feed for the enclosing entry (such as a calendar event).
+ """
+ _qname = GDATA_TEMPLATE % 'comments'
+ rel = 'rel'
+ feed_link = FeedLink
+
+
+class Country(atom.core.XmlElement):
+ """The gd:country element.
+
+ Country name along with optional country code. The country code is
+ given in accordance with ISO 3166-1 alpha-2:
+ http://www.iso.org/iso/iso-3166-1_decoding_table
+ """
+ _qname = GDATA_TEMPLATE % 'country'
+ code = 'code'
+
+
+class EmailImParent(atom.core.XmlElement):
+ address = 'address'
+ label = 'label'
+ rel = 'rel'
+ primary = 'primary'
+
+
+class Email(EmailImParent):
+ """The gd:email element.
+
+ An email address associated with the containing entity (which is
+ usually an entity representing a person or a location).
+ """
+ _qname = GDATA_TEMPLATE % 'email'
+ display_name = 'displayName'
+
+
+class FamilyName(atom.core.XmlElement):
+ """The gd:familyName element.
+
+ Specifies family name of the person, eg. "Smith".
+ """
+ _qname = GDATA_TEMPLATE % 'familyName'
+ yomi = 'yomi'
+
+
+class Im(EmailImParent):
+ """The gd:im element.
+
+ An instant messaging address associated with the containing entity.
+ """
+ _qname = GDATA_TEMPLATE % 'im'
+ protocol = 'protocol'
+
+
+class GivenName(atom.core.XmlElement):
+ """The gd:givenName element.
+
+ Specifies given name of the person, eg. "John".
+ """
+ _qname = GDATA_TEMPLATE % 'givenName'
+ yomi = 'yomi'
+
+
+class NamePrefix(atom.core.XmlElement):
+ """The gd:namePrefix element.
+
+ Honorific prefix, eg. 'Mr' or 'Mrs'.
+ """
+ _qname = GDATA_TEMPLATE % 'namePrefix'
+
+
+class NameSuffix(atom.core.XmlElement):
+ """The gd:nameSuffix element.
+
+ Honorific suffix, eg. 'san' or 'III'.
+ """
+ _qname = GDATA_TEMPLATE % 'nameSuffix'
+
+
+class FullName(atom.core.XmlElement):
+ """The gd:fullName element.
+
+ Unstructured representation of the name.
+ """
+ _qname = GDATA_TEMPLATE % 'fullName'
+
+
+class Name(atom.core.XmlElement):
+ """The gd:name element.
+
+ Allows storing person's name in a structured way. Consists of
+ given name, additional name, family name, prefix, suffix and full name.
+ """
+ _qname = GDATA_TEMPLATE % 'name'
+ given_name = GivenName
+ additional_name = AdditionalName
+ family_name = FamilyName
+ name_prefix = NamePrefix
+ name_suffix = NameSuffix
+ full_name = FullName
+
+
+class OrgDepartment(atom.core.XmlElement):
+ """The gd:orgDepartment element.
+
+ Describes a department within an organization. Must appear within a
+ gd:organization element.
+ """
+ _qname = GDATA_TEMPLATE % 'orgDepartment'
+
+
+class OrgJobDescription(atom.core.XmlElement):
+ """The gd:orgJobDescription element.
+
+ Describes a job within an organization. Must appear within a
+ gd:organization element.
+ """
+ _qname = GDATA_TEMPLATE % 'orgJobDescription'
+
+
+class OrgName(atom.core.XmlElement):
+ """The gd:orgName element.
+
+ The name of the organization. Must appear within a gd:organization
+ element.
+
+ Contains a Yomigana attribute (Japanese reading aid) for the
+ organization name.
+ """
+ _qname = GDATA_TEMPLATE % 'orgName'
+ yomi = 'yomi'
+
+
+class OrgSymbol(atom.core.XmlElement):
+ """The gd:orgSymbol element.
+
+ Provides a symbol of an organization. Must appear within a
+ gd:organization element.
+ """
+ _qname = GDATA_TEMPLATE % 'orgSymbol'
+
+
+class OrgTitle(atom.core.XmlElement):
+ """The gd:orgTitle element.
+
+ The title of a person within an organization. Must appear within a
+ gd:organization element.
+ """
+ _qname = GDATA_TEMPLATE % 'orgTitle'
+
+
+class Organization(atom.core.XmlElement):
+ """The gd:organization element.
+
+ An organization, typically associated with a contact.
+ """
+ _qname = GDATA_TEMPLATE % 'organization'
+ label = 'label'
+ primary = 'primary'
+ rel = 'rel'
+ department = OrgDepartment
+ job_description = OrgJobDescription
+ name = OrgName
+ symbol = OrgSymbol
+ title = OrgTitle
+
+
+class When(atom.core.XmlElement):
+ """The gd:when element.
+
+ Represents a period of time or an instant.
+ """
+ _qname = GDATA_TEMPLATE % 'when'
+ end = 'endTime'
+ start = 'startTime'
+ value = 'valueString'
+
+
+class OriginalEvent(atom.core.XmlElement):
+ """The gd:originalEvent element.
+
+ Equivalent to the Recurrence ID property specified in section 4.8.4.4
+ of RFC 2445. Appears in every instance of a recurring event, to identify
+ the original event.
+
+ Contains a <gd:when> element specifying the original start time of the
+ instance that has become an exception.
+ """
+ _qname = GDATA_TEMPLATE % 'originalEvent'
+ id = 'id'
+ href = 'href'
+ when = When
+
+
+class PhoneNumber(atom.core.XmlElement):
+ """The gd:phoneNumber element.
+
+ A phone number associated with the containing entity (which is usually
+ an entity representing a person or a location).
+ """
+ _qname = GDATA_TEMPLATE % 'phoneNumber'
+ label = 'label'
+ rel = 'rel'
+ uri = 'uri'
+ primary = 'primary'
+
+
+class PostalAddress(atom.core.XmlElement):
+ """The gd:postalAddress element."""
+ _qname = GDATA_TEMPLATE % 'postalAddress'
+ label = 'label'
+ rel = 'rel'
+ uri = 'uri'
+ primary = 'primary'
+
+
+class Rating(atom.core.XmlElement):
+ """The gd:rating element.
+
+ Represents a numeric rating of the enclosing entity, such as a
+ comment. Each rating supplies its own scale, although it may be
+ normalized by a service; for example, some services might convert all
+ ratings to a scale from 1 to 5.
+ """
+ _qname = GDATA_TEMPLATE % 'rating'
+ average = 'average'
+ max = 'max'
+ min = 'min'
+ num_raters = 'numRaters'
+ rel = 'rel'
+ value = 'value'
+
+
+class Recurrence(atom.core.XmlElement):
+ """The gd:recurrence element.
+
+ Represents the dates and times when a recurring event takes place.
+
+ The string that defines the recurrence consists of a set of properties,
+ each of which is defined in the iCalendar standard (RFC 2445).
+
+ Specifically, the string usually begins with a DTSTART property that
+ indicates the starting time of the first instance of the event, and
+ often a DTEND property or a DURATION property to indicate when the
+ first instance ends. Next come RRULE, RDATE, EXRULE, and/or EXDATE
+ properties, which collectively define a recurring event and its
+ exceptions (but see below). (See section 4.8.5 of RFC 2445 for more
+ information about these recurrence component properties.) Last comes a
+ VTIMEZONE component, providing detailed timezone rules for any timezone
+ ID mentioned in the preceding properties.
+
+ Google services like Google Calendar don't generally generate EXRULE
+ and EXDATE properties to represent exceptions to recurring events;
+ instead, they generate <gd:recurrenceException> elements. However,
+ Google services may include EXRULE and/or EXDATE properties anyway;
+ for example, users can import events and exceptions into Calendar, and
+ if those imported events contain EXRULE or EXDATE properties, then
+ Calendar will provide those properties when it sends a <gd:recurrence>
+ element.
+
+ Note the the use of <gd:recurrenceException> means that you can't be
+ sure just from examining a <gd:recurrence> element whether there are
+ any exceptions to the recurrence description. To ensure that you find
+ all exceptions, look for <gd:recurrenceException> elements in the feed,
+ and use their <gd:originalEvent> elements to match them up with
+ <gd:recurrence> elements.
+ """
+ _qname = GDATA_TEMPLATE % 'recurrence'
+
+
+class RecurrenceException(atom.core.XmlElement):
+ """The gd:recurrenceException element.
+
+ Represents an event that's an exception to a recurring event-that is,
+ an instance of a recurring event in which one or more aspects of the
+ recurring event (such as attendance list, time, or location) have been
+ changed.
+
+ Contains a <gd:originalEvent> element that specifies the original
+ recurring event that this event is an exception to.
+
+ When you change an instance of a recurring event, that instance becomes
+ an exception. Depending on what change you made to it, the exception
+ behaves in either of two different ways when the original recurring
+ event is changed:
+
+ - If you add, change, or remove comments, attendees, or attendee
+ responses, then the exception remains tied to the original event, and
+ changes to the original event also change the exception.
+ - If you make any other changes to the exception (such as changing the
+ time or location) then the instance becomes "specialized," which means
+ that it's no longer as tightly tied to the original event. If you
+ change the original event, specialized exceptions don't change. But
+ see below.
+
+ For example, say you have a meeting every Tuesday and Thursday at
+ 2:00 p.m. If you change the attendance list for this Thursday's meeting
+ (but not for the regularly scheduled meeting), then it becomes an
+ exception. If you change the time for this Thursday's meeting (but not
+ for the regularly scheduled meeting), then it becomes specialized.
+
+ Regardless of whether an exception is specialized or not, if you do
+ something that deletes the instance that the exception was derived from,
+ then the exception is deleted. Note that changing the day or time of a
+ recurring event deletes all instances, and creates new ones.
+
+ For example, after you've specialized this Thursday's meeting, say you
+ change the recurring meeting to happen on Monday, Wednesday, and Friday.
+ That change deletes all of the recurring instances of the
+ Tuesday/Thursday meeting, including the specialized one.
+
+ If a particular instance of a recurring event is deleted, then that
+ instance appears as a <gd:recurrenceException> containing a
+ <gd:entryLink> that has its <gd:eventStatus> set to
+ "http://schemas.google.com/g/2005#event.canceled". (For more
+ information about canceled events, see RFC 2445.)
+ """
+ _qname = GDATA_TEMPLATE % 'recurrenceException'
+ specialized = 'specialized'
+ entry_link = EntryLink
+ original_event = OriginalEvent
+
+
+class Reminder(atom.core.XmlElement):
+ """The gd:reminder element.
+
+ A time interval, indicating how long before the containing entity's start
+ time or due time attribute a reminder should be issued. Alternatively,
+ may specify an absolute time at which a reminder should be issued. Also
+ specifies a notification method, indicating what medium the system
+ should use to remind the user.
+ """
+ _qname = GDATA_TEMPLATE % 'reminder'
+ absolute_time = 'absoluteTime'
+ method = 'method'
+ days = 'days'
+ hours = 'hours'
+ minutes = 'minutes'
+
+
+class Transparency(atom.core.XmlElement):
+ """The gd:transparency element:
+
+ Extensible enum corresponding to the TRANSP property defined in RFC 244.
+ """
+ _qname = GDATA_TEMPLATE % 'transparency'
+ value = 'value'
+
+
+class Agent(atom.core.XmlElement):
+ """The gd:agent element.
+
+ The agent who actually receives the mail. Used in work addresses.
+ Also for 'in care of' or 'c/o'.
+ """
+ _qname = GDATA_TEMPLATE % 'agent'
+
+
+class HouseName(atom.core.XmlElement):
+ """The gd:housename element.
+
+ Used in places where houses or buildings have names (and not
+ necessarily numbers), eg. "The Pillars".
+ """
+ _qname = GDATA_TEMPLATE % 'housename'
+
+
+class Street(atom.core.XmlElement):
+ """The gd:street element.
+
+ Can be street, avenue, road, etc. This element also includes the
+ house number and room/apartment/flat/floor number.
+ """
+ _qname = GDATA_TEMPLATE % 'street'
+
+
+class PoBox(atom.core.XmlElement):
+ """The gd:pobox element.
+
+ Covers actual P.O. boxes, drawers, locked bags, etc. This is usually
+ but not always mutually exclusive with street.
+ """
+ _qname = GDATA_TEMPLATE % 'pobox'
+
+
+class Neighborhood(atom.core.XmlElement):
+ """The gd:neighborhood element.
+
+ This is used to disambiguate a street address when a city contains more
+ than one street with the same name, or to specify a small place whose
+ mail is routed through a larger postal town. In China it could be a
+ county or a minor city.
+ """
+ _qname = GDATA_TEMPLATE % 'neighborhood'
+
+
+class City(atom.core.XmlElement):
+ """The gd:city element.
+
+ Can be city, village, town, borough, etc. This is the postal town and
+ not necessarily the place of residence or place of business.
+ """
+ _qname = GDATA_TEMPLATE % 'city'
+
+
+class Subregion(atom.core.XmlElement):
+ """The gd:subregion element.
+
+ Handles administrative districts such as U.S. or U.K. counties that are
+ not used for mail addressing purposes. Subregion is not intended for
+ delivery addresses.
+ """
+ _qname = GDATA_TEMPLATE % 'subregion'
+
+
+class Region(atom.core.XmlElement):
+ """The gd:region element.
+
+ A state, province, county (in Ireland), Land (in Germany),
+ departement (in France), etc.
+ """
+ _qname = GDATA_TEMPLATE % 'region'
+
+
+class Postcode(atom.core.XmlElement):
+ """The gd:postcode element.
+
+ Postal code. Usually country-wide, but sometimes specific to the
+ city (e.g. "2" in "Dublin 2, Ireland" addresses).
+ """
+ _qname = GDATA_TEMPLATE % 'postcode'
+
+
+class Country(atom.core.XmlElement):
+ """The gd:country element.
+
+ The name or code of the country.
+ """
+ _qname = GDATA_TEMPLATE % 'country'
+
+
+class FormattedAddress(atom.core.XmlElement):
+ """The gd:formattedAddress element.
+
+ The full, unstructured postal address.
+ """
+ _qname = GDATA_TEMPLATE % 'formattedAddress'
+
+
+class StructuredPostalAddress(atom.core.XmlElement):
+ """The gd:structuredPostalAddress element.
+
+ Postal address split into components. It allows to store the address
+ in locale independent format. The fields can be interpreted and used
+ to generate formatted, locale dependent address. The following elements
+ reperesent parts of the address: agent, house name, street, P.O. box,
+ neighborhood, city, subregion, region, postal code, country. The
+ subregion element is not used for postal addresses, it is provided for
+ extended uses of addresses only. In order to store postal address in an
+ unstructured form formatted address field is provided.
+ """
+ _qname = GDATA_TEMPLATE % 'structuredPostalAddress'
+ rel = 'rel'
+ mail_class = 'mailClass'
+ usage = 'usage'
+ label = 'label'
+ primary = 'primary'
+ agent = Agent
+ house_name = HouseName
+ street = Street
+ po_box = PoBox
+ neighborhood = Neighborhood
+ city = City
+ subregion = Subregion
+ region = Region
+ postcode = Postcode
+ country = Country
+ formatted_address = FormattedAddress
+
+
+class Where(atom.core.XmlElement):
+ """The gd:where element.
+
+ A place (such as an event location) associated with the containing
+ entity. The type of the association is determined by the rel attribute;
+ the details of the location are contained in an embedded or linked-to
+ Contact entry.
+
+ A <gd:where> element is more general than a <gd:geoPt> element. The
+ former identifies a place using a text description and/or a Contact
+ entry, while the latter identifies a place using a specific geographic
+ location.
+ """
+ _qname = GDATA_TEMPLATE % 'where'
+ label = 'label'
+ rel = 'rel'
+ value = 'valueString'
+ entry_link = EntryLink
+
+
+class AttendeeType(atom.core.XmlElement):
+ """The gd:attendeeType element."""
+ _qname = GDATA_TEMPLATE % 'attendeeType'
+ value = 'value'
+
+
+class AttendeeStatus(atom.core.XmlElement):
+ """The gd:attendeeStatus element."""
+ _qname = GDATA_TEMPLATE % 'attendeeStatus'
+ value = 'value'
+
+
+class EventStatus(atom.core.XmlElement):
+ """The gd:eventStatus element."""
+ _qname = GDATA_TEMPLATE % 'eventStatus'
+ value = 'value'
+
+
+class Visibility(atom.core.XmlElement):
+ """The gd:visibility element."""
+ _qname = GDATA_TEMPLATE % 'visibility'
+ value = 'value'
+
+
+class Who(atom.core.XmlElement):
+ """The gd:who element.
+
+ A person associated with the containing entity. The type of the
+ association is determined by the rel attribute; the details about the
+ person are contained in an embedded or linked-to Contact entry.
+
+ The <gd:who> element can be used to specify email senders and
+ recipients, calendar event organizers, and so on.
+ """
+ _qname = GDATA_TEMPLATE % 'who'
+ email = 'email'
+ rel = 'rel'
+ value = 'valueString'
+ attendee_status = AttendeeStatus
+ attendee_type = AttendeeType
+ entry_link = EntryLink
+
+
+class Deleted(atom.core.XmlElement):
+ """gd:deleted when present, indicates the containing entry is deleted."""
+ _qname = GD_TEMPLATE % 'deleted'
+
+
+class Money(atom.core.XmlElement):
+ """Describes money"""
+ _qname = GD_TEMPLATE % 'money'
+ amount = 'amount'
+ currency_code = 'currencyCode'
+
+
+class MediaSource(object):
+ """GData Entries can refer to media sources, so this class provides a
+ place to store references to these objects along with some metadata.
+ """
+
+ def __init__(self, file_handle=None, content_type=None, content_length=None,
+ file_path=None, file_name=None):
+ """Creates an object of type MediaSource.
+
+ Args:
+ file_handle: A file handle pointing to the file to be encapsulated in the
+ MediaSource.
+ content_type: string The MIME type of the file. Required if a file_handle
+ is given.
+ content_length: int The size of the file. Required if a file_handle is
+ given.
+ file_path: string (optional) A full path name to the file. Used in
+ place of a file_handle.
+ file_name: string The name of the file without any path information.
+ Required if a file_handle is given.
+ """
+ self.file_handle = file_handle
+ self.content_type = content_type
+ self.content_length = content_length
+ self.file_name = file_name
+
+ if (file_handle is None and content_type is not None and
+ file_path is not None):
+ self.set_file_handle(file_path, content_type)
+
+ def set_file_handle(self, file_name, content_type):
+ """A helper function which can create a file handle from a given filename
+ and set the content type and length all at once.
+
+ Args:
+ file_name: string The path and file name to the file containing the media
+ content_type: string A MIME type representing the type of the media
+ """
+
+ self.file_handle = open(file_name, 'rb')
+ self.content_type = content_type
+ self.content_length = os.path.getsize(file_name)
+ self.file_name = os.path.basename(file_name)
+
+ SetFileHandle = set_file_handle
+
+ def modify_request(self, http_request):
+ http_request.add_body_part(self.file_handle, self.content_type,
+ self.content_length)
+ return http_request
+
+ ModifyRequest = modify_request
diff --git a/src/gdata/docs/__init__.py b/src/gdata/docs/__init__.py
new file mode 100644
index 0000000..8031bc9
--- /dev/null
+++ b/src/gdata/docs/__init__.py
@@ -0,0 +1,269 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains extensions to Atom objects used with Google Documents."""
+
+__author__ = ('api.jfisher (Jeff Fisher), '
+ 'api.eric@google.com (Eric Bidelman)')
+
+import atom
+import gdata
+
+
+DOCUMENTS_NAMESPACE = 'http://schemas.google.com/docs/2007'
+
+
+class Scope(atom.AtomBase):
+ """The DocList ACL scope element"""
+
+ _tag = 'scope'
+ _namespace = gdata.GACL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+ _attributes['type'] = 'type'
+
+ def __init__(self, value=None, type=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.type = type
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Role(atom.AtomBase):
+ """The DocList ACL role element"""
+
+ _tag = 'role'
+ _namespace = gdata.GACL_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class FeedLink(atom.AtomBase):
+ """The DocList gd:feedLink element"""
+
+ _tag = 'feedLink'
+ _namespace = gdata.GDATA_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['rel'] = 'rel'
+ _attributes['href'] = 'href'
+
+ def __init__(self, href=None, rel=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ self.href = href
+ self.rel = rel
+ atom.AtomBase.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+
+class ResourceId(atom.AtomBase):
+ """The DocList gd:resourceId element"""
+
+ _tag = 'resourceId'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+ def __init__(self, value=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.value = value
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class LastModifiedBy(atom.Person):
+ """The DocList gd:lastModifiedBy element"""
+
+ _tag = 'lastModifiedBy'
+ _namespace = gdata.GDATA_NAMESPACE
+
+
+class LastViewed(atom.Person):
+ """The DocList gd:lastViewed element"""
+
+ _tag = 'lastViewed'
+ _namespace = gdata.GDATA_NAMESPACE
+
+
+class WritersCanInvite(atom.AtomBase):
+ """The DocList docs:writersCanInvite element"""
+
+ _tag = 'writersCanInvite'
+ _namespace = DOCUMENTS_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['value'] = 'value'
+
+
+class DocumentListEntry(gdata.GDataEntry):
+ """The Google Documents version of an Atom Entry"""
+
+ _tag = gdata.GDataEntry._tag
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feedLink', FeedLink)
+ _children['{%s}resourceId' % gdata.GDATA_NAMESPACE] = ('resourceId',
+ ResourceId)
+ _children['{%s}lastModifiedBy' % gdata.GDATA_NAMESPACE] = ('lastModifiedBy',
+ LastModifiedBy)
+ _children['{%s}lastViewed' % gdata.GDATA_NAMESPACE] = ('lastViewed',
+ LastViewed)
+ _children['{%s}writersCanInvite' % DOCUMENTS_NAMESPACE] = (
+ 'writersCanInvite', WritersCanInvite)
+
+ def __init__(self, resourceId=None, feedLink=None, lastViewed=None,
+ lastModifiedBy=None, writersCanInvite=None, author=None,
+ category=None, content=None, atom_id=None, link=None,
+ published=None, title=None, updated=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ self.feedLink = feedLink
+ self.lastViewed = lastViewed
+ self.lastModifiedBy = lastModifiedBy
+ self.resourceId = resourceId
+ self.writersCanInvite = writersCanInvite
+ gdata.GDataEntry.__init__(
+ self, author=author, category=category, content=content,
+ atom_id=atom_id, link=link, published=published, title=title,
+ updated=updated, extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+ def GetAclLink(self):
+ """Extracts the DocListEntry's <gd:feedLink>.
+
+ Returns:
+ A FeedLink object.
+ """
+ return self.feedLink
+
+ def GetDocumentType(self):
+ """Extracts the type of document from the DocListEntry.
+
+ This method returns the type of document the DocListEntry
+ represents. Possible values are document, presentation,
+ spreadsheet, folder, or pdf.
+
+ Returns:
+ A string representing the type of document.
+ """
+ if self.category:
+ for category in self.category:
+ if category.scheme == gdata.GDATA_NAMESPACE + '#kind':
+ return category.label
+ else:
+ return None
+
+
+def DocumentListEntryFromString(xml_string):
+ """Converts an XML string into a DocumentListEntry object.
+
+ Args:
+ xml_string: string The XML describing a Document List feed entry.
+
+ Returns:
+ A DocumentListEntry object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(DocumentListEntry, xml_string)
+
+
+class DocumentListAclEntry(gdata.GDataEntry):
+ """A DocList ACL Entry flavor of an Atom Entry"""
+
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}scope' % gdata.GACL_NAMESPACE] = ('scope', Scope)
+ _children['{%s}role' % gdata.GACL_NAMESPACE] = ('role', Role)
+
+ def __init__(self, category=None, atom_id=None, link=None,
+ title=None, updated=None, scope=None, role=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ gdata.GDataEntry.__init__(self, author=None, category=category,
+ content=None, atom_id=atom_id, link=link,
+ published=None, title=title,
+ updated=updated, text=None)
+ self.scope = scope
+ self.role = role
+
+
+def DocumentListAclEntryFromString(xml_string):
+ """Converts an XML string into a DocumentListAclEntry object.
+
+ Args:
+ xml_string: string The XML describing a Document List ACL feed entry.
+
+ Returns:
+ A DocumentListAclEntry object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(DocumentListAclEntry, xml_string)
+
+
+class DocumentListFeed(gdata.GDataFeed):
+ """A feed containing a list of Google Documents Items"""
+
+ _tag = gdata.GDataFeed._tag
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [DocumentListEntry])
+
+
+def DocumentListFeedFromString(xml_string):
+ """Converts an XML string into a DocumentListFeed object.
+
+ Args:
+ xml_string: string The XML describing a DocumentList feed.
+
+ Returns:
+ A DocumentListFeed object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(DocumentListFeed, xml_string)
+
+
+class DocumentListAclFeed(gdata.GDataFeed):
+ """A DocList ACL feed flavor of a Atom feed"""
+
+ _tag = gdata.GDataFeed._tag
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [DocumentListAclEntry])
+
+
+def DocumentListAclFeedFromString(xml_string):
+ """Converts an XML string into a DocumentListAclFeed object.
+
+ Args:
+ xml_string: string The XML describing a DocumentList feed.
+
+ Returns:
+ A DocumentListFeed object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(DocumentListAclFeed, xml_string)
diff --git a/src/gdata/docs/client.py b/src/gdata/docs/client.py
new file mode 100755
index 0000000..59fae02
--- /dev/null
+++ b/src/gdata/docs/client.py
@@ -0,0 +1,1093 @@
+#!/usr/bin/python
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""DocsClient simplifies interactions with the Documents List API."""
+
+__author__ = 'vicfryzel@google.com (Vic Fryzel)'
+
+import copy
+import mimetypes
+import re
+import urllib
+import atom.data
+import atom.http_core
+import gdata.client
+import gdata.docs.data
+import gdata.gauth
+
+
+# Feed URIs that are given by the API, but cannot be obtained without
+# making a mostly unnecessary HTTP request.
+RESOURCE_FEED_URI = '/feeds/default/private/full'
+RESOURCE_SELF_LINK_TEMPLATE = RESOURCE_FEED_URI + '/%s'
+RESOURCE_UPLOAD_URI = '/feeds/upload/create-session/default/private/full'
+ARCHIVE_FEED_URI = '/feeds/default/private/archive'
+METADATA_URI = '/feeds/metadata/default'
+CHANGE_FEED_URI = '/feeds/default/private/changes'
+
+
+class DocsClient(gdata.client.GDClient):
+ """Client for all features of the Google Documents List API."""
+
+ host = 'docs.google.com'
+ api_version = '3.0'
+ auth_service = 'writely'
+ alt_auth_service = 'wise'
+ alt_auth_token = None
+ auth_scopes = gdata.gauth.AUTH_SCOPES['writely']
+ ssl = True
+
+ def request(self, method=None, uri=None, **kwargs):
+ """Add support for imitating other users via 2-Legged OAuth.
+
+ Args:
+ uri: (optional) URI of the request in which to replace default with
+ self.xoauth_requestor_id.
+ Returns:
+ Result of super(DocsClient, self).request().
+ """
+ if self.xoauth_requestor_id is not None and uri is not None:
+ if isinstance(uri, (str, unicode)):
+ uri = atom.http_core.Uri.parse_uri(uri)
+ uri.path.replace('/default', '/%s' % self.xoauth_requestor_id)
+ return super(DocsClient, self).request(method=method, uri=uri, **kwargs)
+
+ Request = request
+
+ def get_metadata(self, **kwargs):
+ """Retrieves the metadata of a user account.
+
+ Args:
+ kwargs: Other parameters to pass to self.get_entry().
+
+ Returns:
+ gdata.docs.data.Metadata representing metadata of user's account.
+ """
+ return self.get_entry(
+ METADATA_URI, desired_class=gdata.docs.data.Metadata, **kwargs)
+
+ GetMetadata = get_metadata
+
+ def get_changes(self, changestamp=None, max_results=None, show_root=None,
+ **kwargs):
+ """Retrieves changes to a user's documents list.
+
+ Args:
+ changestamp: (optional) String changestamp value to query since.
+ If provided, returned changes will have a changestamp larger than
+ the given one.
+ max_results: (optional) Number of results to fetch. API will limit
+ this number to 100 at most.
+ show_root: (optional) True to include indications if a resource is in
+ the root collection.
+ kwargs: Other parameters to pass to self.get_feed().
+
+ Returns:
+ gdata.docs.data.ChangeFeed.
+ """
+ uri = atom.http_core.Uri.parse_uri(CHANGE_FEED_URI)
+
+ if changestamp is not None:
+ uri.query['start-index'] = changestamp
+ if max_results is not None:
+ uri.query['max-results'] = max_results
+ if show_root is not None:
+ uri.query['showroot'] = str(show_root).lower()
+
+ return self.get_feed(
+ uri, desired_class=gdata.docs.data.ChangeFeed, **kwargs)
+
+ GetChanges = get_changes
+
+ def get_resources(self, uri=None, limit=None, show_root=None, **kwargs):
+ """Retrieves the resources in a user's docslist, or the given URI.
+
+ Args:
+ uri: (optional) URI to query for resources. If None, then
+ gdata.docs.client.DocsClient.RESOURCE_FEED_URI is used, which will
+ query for all non-collections.
+ limit: int (optional) A maximum cap for the number of results to
+ return in the feed. By default, the API returns a maximum of 100
+ per page. Thus, if you set limit=5000, you will get <= 5000
+ documents (guarenteed no more than 5000), and will need to follow the
+ feed's next links (feed.GetNextLink()) to the rest. See
+ get_everything(). Similarly, if you set limit=50, only <= 50
+ documents are returned. Note: if the max-results parameter is set in
+ the uri parameter, it is chosen over a value set for limit.
+ show_root: (optional) True to include indications if a resource is in
+ the root collection.
+ kwargs: Other parameters to pass to self.get_feed().
+
+ Returns:
+ gdata.docs.data.ResourceFeed feed.
+ """
+ if uri is None:
+ uri = RESOURCE_FEED_URI
+
+ if isinstance(uri, basestring):
+ uri = atom.http_core.Uri.parse_uri(uri)
+
+ # Add max-results param if it wasn't included in the uri.
+ if limit is not None and not 'max-results' in uri.query:
+ uri.query['max-results'] = limit
+ if show_root is not None:
+ uri.query['showroot'] = str(show_root).lower()
+
+
+ return self.get_feed(uri, desired_class=gdata.docs.data.ResourceFeed,
+ **kwargs)
+
+ GetResources = get_resources
+
+ def get_all_resources(self, uri=None, show_root=None, **kwargs):
+ """Retrieves all of a user's non-collections or everything at the given URI.
+
+ Folders are not included in this by default. Pass in a custom URI to
+ include collections in your query. The DocsQuery class is an easy way to
+ generate such a URI.
+
+ This method makes multiple HTTP requests (by following the feed's next
+ links) in order to fetch the user's entire document list.
+
+ Args:
+ uri: (optional) URI to query the doclist feed with. If None, then use
+ DocsClient.RESOURCE_FEED_URI, which will retrieve all
+ non-collections.
+ show_root: (optional) True to include indications if a resource is in
+ the root collection.
+ kwargs: Other parameters to pass to self.GetResources().
+
+ Returns:
+ List of gdata.docs.data.Resource objects representing the retrieved
+ entries.
+ """
+ if uri is None:
+ uri = RESOURCE_FEED_URI
+
+ if isinstance(uri, basestring):
+ uri = atom.http_core.Uri.parse_uri(uri)
+
+ if show_root is not None:
+ uri.query['showroot'] = str(show_root).lower()
+
+ feed = self.GetResources(uri=uri, **kwargs)
+ entries = feed.entry
+
+ while feed.GetNextLink() is not None:
+ feed = self.GetResources(feed.GetNextLink().href, **kwargs)
+ entries.extend(feed.entry)
+
+ return entries
+
+ GetAllResources = get_all_resources
+
+ def get_resource(self, entry, **kwargs):
+ """Retrieves a resource again given its entry.
+
+ Args:
+ entry: gdata.docs.data.Resource to fetch and return.
+ kwargs: Other args to pass to GetResourceBySelfLink().
+ Returns:
+ gdata.docs.data.Resource representing retrieved resource.
+ """
+ return self.GetResourceBySelfLink(entry.GetSelfLink().href, **kwargs)
+
+ GetResource = get_resource
+
+ def get_resource_by_id(self, resource_id, **kwargs):
+ """Retrieves a resource again given its resource ID.
+
+ Args:
+ resource_id: Typed or untyped resource ID of a resource.
+ kwargs: Other args to pass to GetResourceBySelfLink().
+ Returns:
+ gdata.docs.data.Resource representing retrieved resource.
+ """
+ return self.GetResourceBySelfLink(
+ RESOURCE_SELF_LINK_TEMPLATE % resource_id, **kwargs)
+
+ GetResourceById = get_resource_by_id
+
+ def get_resource_by_self_link(self, uri, etag=None, show_root=None,
+ **kwargs):
+ """Retrieves a particular resource by its self link.
+
+ Args:
+ uri: str URI at which to query for given resource. This can be found
+ using entry.GetSelfLink().
+ etag: str (optional) The document/item's etag value to be used in a
+ conditional GET. See http://code.google.com/apis/documents/docs/3.0/
+ developers_guide_protocol.html#RetrievingCached.
+ show_root: (optional) True to include indications if a resource is in
+ the root collection.
+ kwargs: Other parameters to pass to self.get_entry().
+
+ Returns:
+ gdata.docs.data.Resource representing the retrieved resource.
+ """
+ if isinstance(uri, basestring):
+ uri = atom.http_core.Uri.parse_uri(uri)
+ if show_root is not None:
+ uri.query['showroot'] = str(show_root).lower()
+ return self.get_entry(
+ uri , etag=etag, desired_class=gdata.docs.data.Resource, **kwargs)
+
+ GetResourceBySelfLink = get_resource_by_self_link
+
+ def get_resource_acl(self, entry, **kwargs):
+ """Retrieves the ACL sharing permissions for the given entry.
+
+ Args:
+ entry: gdata.docs.data.Resource for which to get ACL.
+ kwargs: Other parameters to pass to self.get_feed().
+
+ Returns:
+ gdata.docs.data.AclFeed representing the resource's ACL.
+ """
+ self._check_entry_is_resource(entry)
+ return self.get_feed(entry.GetAclFeedLink().href,
+ desired_class=gdata.docs.data.AclFeed, **kwargs)
+
+ GetResourceAcl = get_resource_acl
+
+ def create_resource(self, entry, media=None, collection=None,
+ create_uri=None, **kwargs):
+ """Creates new entries in Google Docs, and uploads their contents.
+
+ Args:
+ entry: gdata.docs.data.Resource representing initial version
+ of entry being created. If media is also provided, the entry will
+ first be created with the given metadata and content.
+ media: (optional) gdata.data.MediaSource containing the file to be
+ uploaded.
+ collection: (optional) gdata.docs.data.Resource representing a collection
+ in which this new entry should be created. If provided along
+ with create_uri, create_uri will win (e.g. entry will be created at
+ create_uri, not necessarily in given collection).
+ create_uri: (optional) String URI at which to create the given entry. If
+ collection, media and create_uri are None, use
+ gdata.docs.client.RESOURCE_FEED_URI. If collection and create_uri are
+ None, use gdata.docs.client.RESOURCE_UPLOAD_URI. If collection and
+ media are not None,
+ collection.GetResumableCreateMediaLink() is used,
+ with the collection's resource ID substituted in.
+ kwargs: Other parameters to pass to self.post() and self.update().
+
+ Returns:
+ gdata.docs.data.Resource containing information about new entry.
+ """
+ if media is not None:
+ if create_uri is None and collection is not None:
+ create_uri = collection.GetResumableCreateMediaLink().href
+ elif create_uri is None:
+ create_uri = RESOURCE_UPLOAD_URI
+ uploader = gdata.client.ResumableUploader(
+ self, media.file_handle, media.content_type, media.content_length,
+ desired_class=gdata.docs.data.Resource)
+ return uploader.upload_file(create_uri, entry, **kwargs)
+ else:
+ if create_uri is None and collection is not None:
+ create_uri = collection.content.src
+ elif create_uri is None:
+ create_uri = RESOURCE_FEED_URI
+ return self.post(
+ entry, create_uri, desired_class=gdata.docs.data.Resource, **kwargs)
+
+ CreateResource = create_resource
+
+ def update_resource(self, entry, media=None, update_metadata=True,
+ new_revision=False, **kwargs):
+ """Updates an entry in Google Docs with new metadata and/or new data.
+
+ Args:
+ entry: Entry to update. Make any metadata changes to this entry.
+ media: (optional) gdata.data.MediaSource object containing the file with
+ which to replace the entry's data.
+ update_metadata: (optional) True to update the metadata from the entry
+ itself. You might set this to False to only update an entry's
+ file content, and not its metadata.
+ new_revision: (optional) True to create a new revision with this update,
+ False otherwise.
+ kwargs: Other parameters to pass to self.post().
+
+ Returns:
+ gdata.docs.data.Resource representing the updated entry.
+ """
+
+ uri_params = {}
+ if new_revision:
+ uri_params['new-revision'] = 'true'
+
+ if update_metadata and media is None:
+ uri = atom.http_core.parse_uri(entry.GetEditLink().href)
+ uri.query.update(uri_params)
+ return super(DocsClient, self).update(entry, **kwargs)
+ else:
+ uploader = gdata.client.ResumableUploader(
+ self, media.file_handle, media.content_type, media.content_length,
+ desired_class=gdata.docs.data.Resource)
+ return uploader.UpdateFile(entry_or_resumable_edit_link=entry,
+ update_metadata=update_metadata,
+ uri_params=uri_params, **kwargs)
+
+ UpdateResource = update_resource
+
+ def download_resource(self, entry, file_path, extra_params=None, **kwargs):
+ """Downloads the contents of the given entry to disk.
+
+ Note: to download a file in memory, use the DownloadResourceToMemory()
+ method.
+
+ Args:
+ entry: gdata.docs.data.Resource whose contents to fetch.
+ file_path: str Full path to which to save file.
+ extra_params: dict (optional) A map of any further parameters to control
+ how the document is downloaded/exported. For example, exporting a
+ spreadsheet as a .csv: extra_params={'gid': 0, 'exportFormat': 'csv'}
+ kwargs: Other parameters to pass to self._download_file().
+
+ Raises:
+ gdata.client.RequestError if the download URL is malformed or the server's
+ response was not successful.
+ """
+ self._check_entry_is_not_collection(entry)
+ self._check_entry_has_content(entry)
+ uri = self._get_download_uri(entry.content.src, extra_params)
+ self._download_file(uri, file_path, **kwargs)
+
+ DownloadResource = download_resource
+
+ def download_resource_to_memory(self, entry, extra_params=None, **kwargs):
+ """Returns the contents of the given entry.
+
+ Args:
+ entry: gdata.docs.data.Resource whose contents to fetch.
+ extra_params: dict (optional) A map of any further parameters to control
+ how the document is downloaded/exported. For example, exporting a
+ spreadsheet as a .csv: extra_params={'gid': 0, 'exportFormat': 'csv'}
+ kwargs: Other parameters to pass to self._get_content().
+
+ Returns:
+ Content of given resource after being downloaded.
+
+ Raises:
+ gdata.client.RequestError if the download URL is malformed or the server's
+ response was not successful.
+ """
+ self._check_entry_is_not_collection(entry)
+ self._check_entry_has_content(entry)
+ uri = self._get_download_uri(entry.content.src, extra_params)
+ return self._get_content(uri, **kwargs)
+
+ DownloadResourceToMemory = download_resource_to_memory
+
+ def _get_download_uri(self, base_uri, extra_params=None):
+ uri = base_uri.replace('&', '&')
+ if extra_params is not None:
+ if 'exportFormat' in extra_params and '/Export?' not in uri:
+ raise gdata.client.Error, ('This entry type cannot be exported '
+ 'as a different format.')
+
+ if 'gid' in extra_params and uri.find('spreadsheets') == -1:
+ raise gdata.client.Error, 'gid param is not valid for this resource type.'
+
+ uri += '&' + urllib.urlencode(extra_params)
+ return uri
+
+ def _get_content(self, uri, extra_params=None, auth_token=None, **kwargs):
+ """Fetches the given resource's content.
+
+ This method is useful for downloading/exporting a file within enviornments
+ like Google App Engine, where the user may not have the ability to write
+ the file to a local disk.
+
+ Be warned, this method will use as much memory as needed to store the
+ fetched content. This could cause issues in your environment or app. This
+ is only different from Download() in that you will probably retain an
+ open reference to the data returned from this method, where as the data
+ from Download() will be immediately written to disk and the memory
+ freed. This client library currently doesn't support reading server
+ responses into a buffer or yielding an open file pointer to responses.
+
+ Args:
+ entry: Resource to fetch.
+ extra_params: dict (optional) A map of any further parameters to control
+ how the document is downloaded/exported. For example, exporting a
+ spreadsheet as a .csv: extra_params={'gid': 0, 'exportFormat': 'csv'}
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ kwargs: Other parameters to pass to self.request().
+
+ Returns:
+ The binary file content.
+
+ Raises:
+ gdata.client.RequestError: on error response from server.
+ """
+ server_response = None
+ token = auth_token
+ if 'spreadsheets' in uri and token is None \
+ and self.alt_auth_token is not None:
+ token = self.alt_auth_token
+ server_response = self.request(
+ 'GET', uri, auth_token=token, **kwargs)
+ if server_response.status != 200:
+ raise gdata.client.RequestError, {'status': server_response.status,
+ 'reason': server_response.reason,
+ 'body': server_response.read()}
+ return server_response.read()
+
+ def _download_file(self, uri, file_path, **kwargs):
+ """Downloads a file to disk from the specified URI.
+
+ Note: to download a file in memory, use the GetContent() method.
+
+ Args:
+ uri: str The full URL to download the file from.
+ file_path: str The full path to save the file to.
+ kwargs: Other parameters to pass to self.get_content().
+
+ Raises:
+ gdata.client.RequestError: on error response from server.
+ """
+ f = open(file_path, 'wb')
+ try:
+ f.write(self._get_content(uri, **kwargs))
+ except gdata.client.RequestError, e:
+ f.close()
+ raise e
+ f.flush()
+ f.close()
+
+ _DownloadFile = _download_file
+
+ def copy_resource(self, entry, title, **kwargs):
+ """Copies the given entry to a new entry with the given title.
+
+ Note: Files do not support this feature.
+
+ Args:
+ entry: gdata.docs.data.Resource to copy.
+ title: String title for the new entry.
+ kwargs: Other parameters to pass to self.post().
+
+ Returns:
+ gdata.docs.data.Resource representing duplicated resource.
+ """
+ self._check_entry_is_resource(entry)
+ new_entry = gdata.docs.data.Resource(
+ title=atom.data.Title(text=title),
+ id=atom.data.Id(text=entry.GetSelfLink().href))
+ return self.post(new_entry, RESOURCE_FEED_URI, **kwargs)
+
+ CopyResource = copy_resource
+
+ def move_resource(self, entry, collection=None, keep_in_collections=False,
+ **kwargs):
+ """Moves an item into a different collection (or out of all collections).
+
+ Args:
+ entry: gdata.docs.data.Resource to move.
+ collection: gdata.docs.data.Resource (optional) An object representing
+ the destination collection. If None, set keep_in_collections to
+ False to remove the item from all collections.
+ keep_in_collections: boolean (optional) If True, the given entry
+ is not removed from any existing collections it is already in.
+ kwargs: Other parameters to pass to self.post().
+
+ Returns:
+ gdata.docs.data.Resource of the moved entry.
+ """
+ self._check_entry_is_resource(entry)
+
+ # Remove the item from any collections it is already in.
+ if not keep_in_collections:
+ for current_collection in entry.InCollections():
+ uri = '%s/contents/%s' % (
+ current_collection.href,
+ urllib.quote(entry.resource_id.text))
+ self.delete(uri, force=True)
+
+ if collection is not None:
+ self._check_entry_is_collection(collection)
+ entry = self.post(entry, collection.content.src, **kwargs)
+ return entry
+
+ MoveResource = move_resource
+
+ def delete_resource(self, entry, permanent=False, **kwargs):
+ """Trashes or deletes the given entry.
+
+ Args:
+ entry: gdata.docs.data.Resource to trash or delete.
+ permanent: True to skip the trash and delete the entry forever.
+ kwargs: Other args to pass to gdata.client.GDClient.Delete()
+
+ Returns:
+ Result of delete request.
+ """
+ if permanent:
+ kwargs['delete'] = 'true'
+ return gdata.client.GDClient.delete(self, entry, **kwargs)
+
+ DeleteResource = delete_resource
+
+ def _check_entry_is_resource(self, entry):
+ """Ensures given entry is a gdata.docs.data.Resource.
+
+ Args:
+ entry: Entry to test.
+ Raises:
+ ValueError: If given entry is not a resource.
+ """
+ if not isinstance(entry, gdata.docs.data.Resource):
+ raise ValueError('%s is not a gdata.docs.data.Resource' % str(entry))
+
+ def _check_entry_is_collection(self, entry):
+ """Ensures given entry is a collection.
+
+ Args:
+ entry: Entry to test.
+ Raises:
+ ValueError: If given entry is a collection.
+ """
+ self._check_entry_is_resource(entry)
+ if entry.get_resource_type() != gdata.docs.data.COLLECTION_LABEL:
+ raise ValueError('%s is not a collection' % str(entry))
+
+ def _check_entry_is_not_collection(self, entry):
+ """Ensures given entry is not a collection.
+
+ Args:
+ entry: Entry to test.
+ Raises:
+ ValueError: If given entry is a collection.
+ """
+ try:
+ self._check_entry_is_resource(entry)
+ except ValueError:
+ return
+ if entry.get_resource_type() == gdata.docs.data.COLLECTION_LABEL:
+ raise ValueError(
+ '%s is a collection, which is not valid in this method' % str(entry))
+
+ def _check_entry_has_content(self, entry):
+ """Ensures given entry has a content element with src.
+
+ Args:
+ entry: Entry to test.
+ Raises:
+ ValueError: If given entry is not an entry or has no content src.
+ """
+ # Don't use _check_entry_is_resource since could be Revision etc
+ if not (hasattr(entry, 'content') and entry.content and
+ entry.content.src):
+ raise ValueError('Entry %s has no downloadable content.' % entry)
+
+ def get_acl(self, entry, **kwargs):
+ """Retrieves an AclFeed for the given resource.
+
+ Args:
+ entry: gdata.docs.data.Resource to fetch AclFeed for.
+ kwargs: Other args to pass to GetFeed().
+ Returns:
+ gdata.docs.data.AclFeed representing retrieved entries.
+ """
+ self._check_entry_is_resource(entry)
+ return self.get_feed(
+ entry.GetAclFeedLink().href,
+ desired_class=gdata.docs.data.AclFeed, **kwargs)
+
+ GetAcl = get_acl
+
+ def get_acl_entry(self, entry, **kwargs):
+ """Retrieves an AclEntry again.
+
+ This is useful if you need to poll for an ACL changing.
+
+ Args:
+ entry: gdata.docs.data.AclEntry to fetch and return.
+ kwargs: Other args to pass to GetAclEntryBySelfLink().
+ Returns:
+ gdata.docs.data.AclEntry representing retrieved entry.
+ """
+
+ return self.GetAclEntryBySelfLink(entry.GetSelfLink().href, **kwargs)
+
+ GetAclEntry = get_acl_entry
+
+ def get_acl_entry_by_self_link(self, self_link, **kwargs):
+ """Retrieves a particular AclEntry by its self link.
+
+ Args:
+ self_link: URI at which to query for given ACL entry. This can be found
+ using entry.GetSelfLink().
+ kwargs: Other parameters to pass to self.get_entry().
+
+ Returns:
+ gdata.docs.data.AclEntry representing the retrieved entry.
+ """
+ if isinstance(self_link, atom.data.Link):
+ self_link = self_link.href
+
+ return self.get_entry(self_link, desired_class=gdata.docs.data.AclEntry,
+ **kwargs)
+
+ GetAclEntryBySelfLink = get_acl_entry_by_self_link
+
+ def add_acl_entry(self, resource, acl_entry, send_notifications=None,
+ **kwargs):
+ """Adds the given AclEntry to the given Resource.
+
+ Args:
+ resource: gdata.docs.data.Resource to which to add AclEntry.
+ acl_entry: gdata.docs.data.AclEntry representing ACL entry to add.
+ send_notifications: True if users should be notified by email when
+ this AclEntry is added.
+ kwargs: Other parameters to pass to self.post().
+
+ Returns:
+ gdata.docs.data.AclEntry containing information about new entry.
+ Raises:
+ ValueError: If given resource has no ACL link.
+ """
+ uri = resource.GetAclLink().href
+ if uri is None:
+ raise ValueError(('Given resource has no ACL link. Did you fetch this'
+ 'resource from the API?'))
+ if send_notifications is not None:
+ if not send_notifications:
+ uri += '?send-notification-emails=false'
+
+ return self.post(acl_entry, uri, desired_class=gdata.docs.data.AclEntry,
+ **kwargs)
+
+ AddAclEntry = add_acl_entry
+
+ def update_acl_entry(self, entry, send_notifications=None, **kwargs):
+ """Updates the given AclEntry with new metadata.
+
+ Args:
+ entry: AclEntry to update. Make any metadata changes to this entry.
+ send_notifications: True if users should be notified by email when
+ this AclEntry is updated.
+ kwargs: Other parameters to pass to super(DocsClient, self).update().
+
+ Returns:
+ gdata.docs.data.AclEntry representing the updated ACL entry.
+ """
+ uri = entry.GetEditLink().href
+ if not send_notifications:
+ uri += '?send-notification-emails=false'
+ return super(DocsClient, self).update(entry, uri=uri, **kwargs)
+
+ UpdateAclEntry = update_acl_entry
+
+ def delete_acl_entry(self, entry, **kwargs):
+ """Deletes the given AclEntry.
+
+ Args:
+ entry: gdata.docs.data.AclEntry to delete.
+ kwargs: Other args to pass to gdata.client.GDClient.Delete()
+
+ Returns:
+ Result of delete request.
+ """
+ return super(DocsClient, self).delete(entry.GetEditLink().href,
+ **kwargs)
+
+ DeleteAclEntry = delete_acl_entry
+
+ def batch_process_acl_entries(self, resource, entries, **kwargs):
+ """Applies the specified operation of each entry in a single request.
+
+ To use this, simply set acl_entry.batch_operation to one of
+ ['query', 'insert', 'update', 'delete'], and optionally set
+ acl_entry.batch_id to a string of your choice.
+
+ Then, put all of your modified AclEntry objects into a list and pass
+ that list as the entries parameter.
+
+ Args:
+ resource: gdata.docs.data.Resource to which the given entries belong.
+ entries: [gdata.docs.data.AclEntry] to modify in some way.
+ kwargs: Other args to pass to gdata.client.GDClient.post()
+
+ Returns:
+ Resulting gdata.docs.data.AclFeed of changes.
+ """
+ feed = gdata.docs.data.AclFeed()
+ feed.entry = entries
+ return super(DocsClient, self).post(
+ feed, uri=resource.GetAclLink().href + '/batch', **kwargs)
+
+ BatchProcessAclEntries = batch_process_acl_entries
+
+ def get_revisions(self, entry, **kwargs):
+ """Retrieves the revision history for a resource.
+
+ Args:
+ entry: gdata.docs.data.Resource for which to get revisions.
+ kwargs: Other parameters to pass to self.get_feed().
+
+ Returns:
+ gdata.docs.data.RevisionFeed representing the resource's revisions.
+ """
+ self._check_entry_is_resource(entry)
+ return self.get_feed(
+ entry.GetRevisionsFeedLink().href,
+ desired_class=gdata.docs.data.RevisionFeed, **kwargs)
+
+ GetRevisions = get_revisions
+
+ def get_revision(self, entry, **kwargs):
+ """Retrieves a revision again given its entry.
+
+ Args:
+ entry: gdata.docs.data.Revision to fetch and return.
+ kwargs: Other args to pass to GetRevisionBySelfLink().
+ Returns:
+ gdata.docs.data.Revision representing retrieved revision.
+ """
+ return self.GetRevisionBySelfLink(entry.GetSelfLink().href, **kwargs)
+
+ GetRevision = get_revision
+
+ def get_revision_by_self_link(self, self_link, **kwargs):
+ """Retrieves a particular reivision by its self link.
+
+ Args:
+ self_link: URI at which to query for given revision. This can be found
+ using entry.GetSelfLink().
+ kwargs: Other parameters to pass to self.get_entry().
+
+ Returns:
+ gdata.docs.data.Revision representing the retrieved revision.
+ """
+ if isinstance(self_link, atom.data.Link):
+ self_link = self_link.href
+
+ return self.get_entry(self_link, desired_class=gdata.docs.data.Revision,
+ **kwargs)
+
+ GetRevisionBySelfLink = get_revision_by_self_link
+
+ def download_revision(self, entry, file_path, extra_params=None, **kwargs):
+ """Downloads the contents of the given revision to disk.
+
+ Note: to download a revision in memory, use the DownloadRevisionToMemory()
+ method.
+
+ Args:
+ entry: gdata.docs.data.Revision whose contents to fetch.
+ file_path: str Full path to which to save file.
+ extra_params: dict (optional) A map of any further parameters to control
+ how the document is downloaded.
+ kwargs: Other parameters to pass to self._download_file().
+
+ Raises:
+ gdata.client.RequestError if the download URL is malformed or the server's
+ response was not successful.
+ """
+ self._check_entry_is_not_collection(entry)
+ self._check_entry_has_content(entry)
+ uri = self._get_download_uri(entry.content.src, extra_params)
+ self._download_file(uri, file_path, **kwargs)
+
+ DownloadRevision = download_revision
+
+ def download_revision_to_memory(self, entry, extra_params=None, **kwargs):
+ """Returns the contents of the given revision.
+
+ Args:
+ entry: gdata.docs.data.Revision whose contents to fetch.
+ extra_params: dict (optional) A map of any further parameters to control
+ how the document is downloaded/exported.
+ kwargs: Other parameters to pass to self._get_content().
+
+ Returns:
+ Content of given revision after being downloaded.
+
+ Raises:
+ gdata.client.RequestError if the download URL is malformed or the server's
+ response was not successful.
+ """
+ self._check_entry_is_not_collection(entry)
+ self._check_entry_has_content(entry)
+ uri = self._get_download_uri(entry.content.src, extra_params)
+ return self._get_content(uri, **kwargs)
+
+ DownloadRevisionToMemory = download_revision_to_memory
+
+ def publish_revision(self, entry, publish_auto=None,
+ publish_outside_domain=False, **kwargs):
+ """Publishes the given revision.
+
+ This method can only be used for document revisions.
+
+ Args:
+ entry: Revision to update.
+ publish_auto: True to automatically publish future revisions of the
+ document. False to not automatically publish future revisions.
+ None to take no action and use the default value.
+ publish_outside_domain: True to make the published revision available
+ outside of a Google Apps domain. False to not publish outside
+ the domain. None to use the default value.
+ kwargs: Other parameters to pass to super(DocsClient, self).update().
+
+ Returns:
+ gdata.docs.data.Revision representing the updated revision.
+ """
+ entry.publish = gdata.docs.data.Publish(value='true')
+ if publish_auto == True:
+ entry.publish_auto = gdata.docs.data.PublishAuto(value='true')
+ elif publish_auto == False:
+ entry.publish_auto = gdata.docs.data.PublishAuto(value='false')
+ if publish_outside_domain == True:
+ entry.publish_outside_domain = \
+ gdata.docs.data.PublishOutsideDomain(value='true')
+ elif publish_outside_domain == False:
+ entry.publish_outside_domain = \
+ gdata.docs.data.PublishOutsideDomain(value='false')
+ return super(DocsClient, self).update(entry, force=True, **kwargs)
+
+ PublishRevision = publish_revision
+
+ def unpublish_revision(self, entry, **kwargs):
+ """Unpublishes the given revision.
+
+ This method can only be used for document revisions.
+
+ Args:
+ entry: Revision to update.
+ kwargs: Other parameters to pass to super(DocsClient, self).update().
+
+ Returns:
+ gdata.docs.data.Revision representing the updated revision.
+ """
+ entry.publish = gdata.docs.data.Publish(value='false')
+ return super(DocsClient, self).update(entry, force=True, **kwargs)
+
+ UnpublishRevision = unpublish_revision
+
+ def delete_revision(self, entry, **kwargs):
+ """Deletes the given Revision.
+
+ Args:
+ entry: gdata.docs.data.Revision to delete.
+ kwargs: Other args to pass to gdata.client.GDClient.Delete()
+
+ Returns:
+ Result of delete request.
+ """
+ return super(DocsClient, self).delete(entry, force=True, **kwargs)
+
+ DeleteRevision = delete_revision
+
+ def get_archive(self, entry, **kwargs):
+ """Retrieves an archive again given its entry.
+
+ This is useful if you need to poll for an archive completing.
+
+ Args:
+ entry: gdata.docs.data.Archive to fetch and return.
+ kwargs: Other args to pass to GetArchiveBySelfLink().
+ Returns:
+ gdata.docs.data.Archive representing retrieved archive.
+ """
+
+ return self.GetArchiveBySelfLink(entry.GetSelfLink().href, **kwargs)
+
+ GetArchive = get_archive
+
+ def get_archive_by_self_link(self, self_link, **kwargs):
+ """Retrieves a particular archive by its self link.
+
+ Args:
+ self_link: URI at which to query for given archive. This can be found
+ using entry.GetSelfLink().
+ kwargs: Other parameters to pass to self.get_entry().
+
+ Returns:
+ gdata.docs.data.Archive representing the retrieved archive.
+ """
+ if isinstance(self_link, atom.data.Link):
+ self_link = self_link.href
+
+ return self.get_entry(self_link, desired_class=gdata.docs.data.Archive,
+ **kwargs)
+
+ GetArchiveBySelfLink = get_archive_by_self_link
+
+ def create_archive(self, entry, **kwargs):
+ """Creates a new archive of resources.
+
+ Args:
+ entry: gdata.docs.data.Archive representing metadata of archive to
+ create.
+ kwargs: Other parameters to pass to self.post().
+
+ Returns:
+ gdata.docs.data.Archive containing information about new archive.
+ """
+ return self.post(entry, ARCHIVE_FEED_URI,
+ desired_class=gdata.docs.data.Archive, **kwargs)
+
+ CreateArchive = create_archive
+
+ def update_archive(self, entry, **kwargs):
+ """Updates the given Archive with new metadata.
+
+ This method is really only useful for updating the notification email
+ address of an archive that is being processed.
+
+ Args:
+ entry: Archive to update. Make any metadata changes to this entry.
+ kwargs: Other parameters to pass to super(DocsClient, self).update().
+
+ Returns:
+ gdata.docs.data.Archive representing the updated archive.
+ """
+ return super(DocsClient, self).update(entry, **kwargs)
+
+ UpdateArchive = update_archive
+
+ download_archive = DownloadResource
+ DownloadArchive = download_archive
+ download_archive_to_memory = DownloadResourceToMemory
+ DownloadArchiveToMemory = download_archive_to_memory
+
+ def delete_archive(self, entry, **kwargs):
+ """Aborts the given Archive operation, or deletes the Archive.
+
+ Args:
+ entry: gdata.docs.data.Archive to delete.
+ kwargs: Other args to pass to gdata.client.GDClient.Delete()
+
+ Returns:
+ Result of delete request.
+ """
+ return super(DocsClient, self).delete(entry, force=True, **kwargs)
+
+ DeleteArchive = delete_archive
+
+
+class DocsQuery(gdata.client.Query):
+
+ def __init__(self, title=None, title_exact=None, opened_min=None,
+ opened_max=None, edited_min=None, edited_max=None, owner=None,
+ writer=None, reader=None, show_collections=None, show_root=None,
+ show_deleted=None, ocr=None, target_language=None,
+ source_language=None, convert=None, query=None, **kwargs):
+ """Constructs a query URL for the Google Documents List API.
+
+ Args:
+ title: str (optional) Specifies the search terms for the title of a
+ document. This parameter used without title_exact will only
+ submit partial queries, not exact queries.
+ title_exact: str (optional) Meaningless without title. Possible values
+ are 'true' and 'false'. Note: Matches are case-insensitive.
+ opened_min: str (optional) Lower bound on the last time a document was
+ opened by the current user. Use the RFC 3339 timestamp
+ format. For example: opened_min='2005-08-09T09:57:00-08:00'.
+ opened_max: str (optional) Upper bound on the last time a document was
+ opened by the current user. (See also opened_min.)
+ edited_min: str (optional) Lower bound on the last time a document was
+ edited by the current user. This value corresponds to the edited.text
+ value in the doc's entry object, which represents changes to the
+ document's content or metadata. Use the RFC 3339 timestamp format.
+ For example: edited_min='2005-08-09T09:57:00-08:00'
+ edited_max: str (optional) Upper bound on the last time a document was
+ edited by the user. (See also edited_min.)
+ owner: str (optional) Searches for documents with a specific owner. Use
+ the email address of the owner. For example: owner='user@gmail.com'
+ writer: str (optional) Searches for documents which can be written to
+ by specific users. Use a single email address or a comma separated list
+ of email addresses. For example: writer='user1@gmail.com,user@example.com'
+ reader: str (optional) Searches for documents which can be read by
+ specific users. (See also writer.)
+ show_collections: str (optional) Specifies whether the query should return
+ collections as well as documents and files. Possible values are 'true'
+ and 'false'. Default is 'false'.
+ show_root: (optional) 'true' to specify when an item is in the root
+ collection. Default is 'false'
+ show_deleted: str (optional) Specifies whether the query should return
+ documents which are in the trash as well as other documents.
+ Possible values are 'true' and 'false'. Default is false.
+ ocr: str (optional) Specifies whether to attempt OCR on a .jpg, .png, or
+ .gif upload. Possible values are 'true' and 'false'. Default is
+ false. See OCR in the Protocol Guide:
+ http://code.google.com/apis/documents/docs/3.0/developers_guide_protocol.html#OCR
+ target_language: str (optional) Specifies the language to translate a
+ document into. See Document Translation in the Protocol Guide for a
+ table of possible values:
+ http://code.google.com/apis/documents/docs/3.0/developers_guide_protocol.html#DocumentTranslation
+ source_language: str (optional) Specifies the source language of the
+ original document. Optional when using the translation service.
+ If not provided, Google will attempt to auto-detect the source
+ language. See Document Translation in the Protocol Guide for a table of
+ possible values (link in target_language).
+ convert: str (optional) Used when uploading files specify if document uploads
+ should convert to a native Google Docs format.
+ Possible values are 'true' and 'false'. The default is 'true'.
+ query: str (optional) Full-text query to use. See the 'q' parameter in
+ the documentation.
+ """
+ gdata.client.Query.__init__(self, **kwargs)
+ self.convert = convert
+ self.title = title
+ self.title_exact = title_exact
+ self.opened_min = opened_min
+ self.opened_max = opened_max
+ self.edited_min = edited_min
+ self.edited_max = edited_max
+ self.owner = owner
+ self.writer = writer
+ self.reader = reader
+ self.show_collections = show_collections
+ self.show_root = show_root
+ self.show_deleted = show_deleted
+ self.ocr = ocr
+ self.target_language = target_language
+ self.source_language = source_language
+ self.query = query
+
+ def modify_request(self, http_request):
+ gdata.client._add_query_param('convert', self.convert, http_request)
+ gdata.client._add_query_param('title', self.title, http_request)
+ gdata.client._add_query_param('title-exact', self.title_exact,
+ http_request)
+ gdata.client._add_query_param('opened-min', self.opened_min, http_request)
+ gdata.client._add_query_param('opened-max', self.opened_max, http_request)
+ gdata.client._add_query_param('edited-min', self.edited_min, http_request)
+ gdata.client._add_query_param('edited-max', self.edited_max, http_request)
+ gdata.client._add_query_param('owner', self.owner, http_request)
+ gdata.client._add_query_param('writer', self.writer, http_request)
+ gdata.client._add_query_param('reader', self.reader, http_request)
+ gdata.client._add_query_param('query', self.query, http_request)
+ gdata.client._add_query_param('showfolders', self.show_collections,
+ http_request)
+ gdata.client._add_query_param('showroot', self.show_root, http_request)
+ gdata.client._add_query_param('showdeleted', self.show_deleted,
+ http_request)
+ gdata.client._add_query_param('ocr', self.ocr, http_request)
+ gdata.client._add_query_param('targetLanguage', self.target_language,
+ http_request)
+ gdata.client._add_query_param('sourceLanguage', self.source_language,
+ http_request)
+ gdata.client.Query.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
diff --git a/src/gdata/docs/data.py b/src/gdata/docs/data.py
new file mode 100755
index 0000000..10464dc
--- /dev/null
+++ b/src/gdata/docs/data.py
@@ -0,0 +1,684 @@
+#!/usr/bin/python
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for representing elements of the Documents List API."""
+
+__author__ = 'vicfryzel@google.com (Vic Fryzel)'
+
+import atom.core
+import atom.data
+import gdata.acl.data
+import gdata.data
+
+
+DOCUMENTS_NS = 'http://schemas.google.com/docs/2007'
+LABELS_NS = 'http://schemas.google.com/g/2005/labels'
+DOCUMENTS_TEMPLATE = '{http://schemas.google.com/docs/2007}%s'
+ACL_FEEDLINK_REL = 'http://schemas.google.com/acl/2007#accessControlList'
+RESUMABLE_CREATE_MEDIA_LINK_REL = 'http://schemas.google.com/g/2005#resumable-create-media'
+RESUMABLE_EDIT_MEDIA_LINK_REL = 'http://schemas.google.com/g/2005#resumable-edit-media'
+REVISION_FEEDLINK_REL = DOCUMENTS_NS + '/revisions'
+PARENT_LINK_REL = DOCUMENTS_NS + '#parent'
+PUBLISH_LINK_REL = DOCUMENTS_NS + '#publish'
+DATA_KIND_SCHEME = 'http://schemas.google.com/g/2005#kind'
+LABELS_SCHEME = LABELS_NS
+DOCUMENT_LABEL = 'document'
+SPREADSHEET_LABEL = 'spreadsheet'
+DRAWING_LABEL = 'drawing'
+PRESENTATION_LABEL = 'presentation'
+FILE_LABEL = 'file'
+PDF_LABEL = 'pdf'
+FORM_LABEL = 'form'
+ITEM_LABEL = 'item'
+COLLECTION_LABEL = 'folder'
+STARRED_LABEL = 'starred'
+VIEWED_LABEL = 'viewed'
+HIDDEN_LABEL = 'hidden'
+TRASHED_LABEL = 'trashed'
+MINE_LABEL = 'mine'
+PRIVATE_LABEL = 'private'
+SHAREDWITHDOMAIN_LABEL = 'shared-with-domain'
+RESTRICTEDDOWNLOAD_LABEL = 'restricted-download'
+
+
+class ResourceId(atom.core.XmlElement):
+ """The DocList gd:resourceId element."""
+ _qname = gdata.data.GDATA_TEMPLATE % 'resourceId'
+
+
+class LastModifiedBy(atom.data.Person):
+ """The DocList gd:lastModifiedBy element."""
+ _qname = gdata.data.GDATA_TEMPLATE % 'lastModifiedBy'
+
+
+class LastViewed(atom.data.Person):
+ """The DocList gd:lastViewed element."""
+ _qname = gdata.data.GDATA_TEMPLATE % 'lastViewed'
+
+
+class WritersCanInvite(atom.core.XmlElement):
+ """The DocList docs:writersCanInvite element."""
+ _qname = DOCUMENTS_TEMPLATE % 'writersCanInvite'
+ value = 'value'
+
+
+class Deleted(atom.core.XmlElement):
+ """The DocList gd:deleted element."""
+ _qname = gdata.data.GDATA_TEMPLATE % 'deleted'
+
+
+class QuotaBytesUsed(atom.core.XmlElement):
+ """The DocList gd:quotaBytesUsed element."""
+ _qname = gdata.data.GDATA_TEMPLATE % 'quotaBytesUsed'
+
+
+class Publish(atom.core.XmlElement):
+ """The DocList docs:publish element."""
+ _qname = DOCUMENTS_TEMPLATE % 'publish'
+ value = 'value'
+
+
+class PublishAuto(atom.core.XmlElement):
+ """The DocList docs:publishAuto element."""
+ _qname = DOCUMENTS_TEMPLATE % 'publishAuto'
+ value = 'value'
+
+
+class PublishOutsideDomain(atom.core.XmlElement):
+ """The DocList docs:publishOutsideDomain element."""
+ _qname = DOCUMENTS_TEMPLATE % 'publishOutsideDomain'
+ value = 'value'
+
+
+class Filename(atom.core.XmlElement):
+ """The DocList docs:filename element."""
+ _qname = DOCUMENTS_TEMPLATE % 'filename'
+
+
+class SuggestedFilename(atom.core.XmlElement):
+ """The DocList docs:suggestedFilename element."""
+ _qname = DOCUMENTS_TEMPLATE % 'suggestedFilename'
+
+
+class Description(atom.core.XmlElement):
+ """The DocList docs:description element."""
+ _qname = DOCUMENTS_TEMPLATE % 'description'
+
+
+class CategoryFinder(object):
+ """Mixin to provide category finding functionality.
+
+ Analogous to atom.data.LinkFinder, but a simpler API, specialized for
+ DocList categories.
+ """
+
+ def add_category(self, scheme, term, label):
+ """Add a category for a scheme, term and label.
+
+ Args:
+ scheme: The scheme for the category.
+ term: The term for the category.
+ label: The label for the category
+
+ Returns:
+ The newly created atom.data.Category.
+ """
+ category = atom.data.Category(scheme=scheme, term=term, label=label)
+ self.category.append(category)
+ return category
+
+ AddCategory = add_category
+
+ def get_categories(self, scheme):
+ """Fetch the category elements for a scheme.
+
+ Args:
+ scheme: The scheme to fetch the elements for.
+
+ Returns:
+ Generator of atom.data.Category elements.
+ """
+ for category in self.category:
+ if category.scheme == scheme:
+ yield category
+
+ GetCategories = get_categories
+
+ def remove_categories(self, scheme):
+ """Remove category elements for a scheme.
+
+ Args:
+ scheme: The scheme of category to remove.
+ """
+ for category in list(self.get_categories(scheme)):
+ self.category.remove(category)
+
+ RemoveCategories = remove_categories
+
+ def get_first_category(self, scheme):
+ """Fetch the first category element for a scheme.
+
+ Args:
+ scheme: The scheme of category to return.
+
+ Returns:
+ atom.data.Category if found or None.
+ """
+ try:
+ return self.get_categories(scheme).next()
+ except StopIteration, e:
+ # The entry doesn't have the category
+ return None
+
+ GetFirstCategory = get_first_category
+
+ def set_resource_type(self, label):
+ """Set the document type for an entry, by building the appropriate
+ atom.data.Category
+
+ Args:
+ label: str The value for the category entry. If None is passed the
+ category is removed and not set.
+
+ Returns:
+ An atom.data.Category or None if label is None.
+ """
+ self.remove_categories(DATA_KIND_SCHEME)
+ if label is not None:
+ return self.add_category(scheme=DATA_KIND_SCHEME,
+ term='%s#%s' % (DOCUMENTS_NS, label),
+ label=label)
+ else:
+ return None
+
+ SetResourceType = set_resource_type
+
+ def get_resource_type(self):
+ """Extracts the type of document this Resource is.
+
+ This method returns the type of document the Resource represents. Possible
+ values are document, presentation, drawing, spreadsheet, file, folder,
+ form, item, or pdf.
+
+ 'folder' is a possible return value of this method because, for legacy
+ support, we have not yet renamed the folder keyword to collection in
+ the API itself.
+
+ Returns:
+ String representing the type of document.
+ """
+ category = self.get_first_category(DATA_KIND_SCHEME)
+ if category is not None:
+ return category.label
+ else:
+ return None
+
+ GetResourceType = get_resource_type
+
+ def get_labels(self):
+ """Extracts the labels for this Resource.
+
+ This method returns the labels as a set, for example: 'hidden', 'starred',
+ 'viewed'.
+
+ Returns:
+ Set of string labels.
+ """
+ return set(category.label for category in
+ self.get_categories(LABELS_SCHEME))
+
+ GetLabels = get_labels
+
+ def has_label(self, label):
+ """Whether this Resource has a label.
+
+ Args:
+ label: The str label to test for
+
+ Returns:
+ Boolean value indicating presence of label.
+ """
+ return label in self.get_labels()
+
+ HasLabel = has_label
+
+ def add_label(self, label):
+ """Add a label, if it is not present.
+
+ Args:
+ label: The str label to set
+ """
+ if not self.has_label(label):
+ self.add_category(scheme=LABELS_SCHEME,
+ term='%s#%s' % (LABELS_NS, label),
+ label=label)
+ AddLabel = add_label
+
+ def remove_label(self, label):
+ """Remove a label, if it is present.
+
+ Args:
+ label: The str label to remove
+ """
+ for category in self.get_categories(LABELS_SCHEME):
+ if category.label == label:
+ self.category.remove(category)
+
+ RemoveLabel = remove_label
+
+ def is_starred(self):
+ """Whether this Resource is starred.
+
+ Returns:
+ Boolean value indicating that the resource is starred.
+ """
+ return self.has_label(STARRED_LABEL)
+
+ IsStarred = is_starred
+
+ def is_hidden(self):
+ """Whether this Resource is hidden.
+
+ Returns:
+ Boolean value indicating that the resource is hidden.
+ """
+ return self.has_label(HIDDEN_LABEL)
+
+ IsHidden = is_hidden
+
+ def is_viewed(self):
+ """Whether this Resource is viewed.
+
+ Returns:
+ Boolean value indicating that the resource is viewed.
+ """
+ return self.has_label(VIEWED_LABEL)
+
+ IsViewed = is_viewed
+
+ def is_trashed(self):
+ """Whether this resource is trashed.
+
+ Returns:
+ Boolean value indicating that the resource is trashed.
+ """
+ return self.has_label(TRASHED_LABEL)
+
+ IsTrashed = is_trashed
+
+ def is_mine(self):
+ """Whether this resource is marked as mine.
+
+ Returns:
+ Boolean value indicating that the resource is marked as mine.
+ """
+ return self.has_label(MINE_LABEL)
+
+ IsMine = is_mine
+
+ def is_private(self):
+ """Whether this resource is private.
+
+ Returns:
+ Boolean value indicating that the resource is private.
+ """
+ return self.has_label(PRIVATE_LABEL)
+
+ IsPrivate = is_private
+
+ def is_shared_with_domain(self):
+ """Whether this resource is shared with the domain.
+
+ Returns:
+ Boolean value indicating that the resource is shared with the domain.
+ """
+ return self.has_label(SHAREDWITHDOMAIN_LABEL)
+
+ IsSharedWithDomain = is_shared_with_domain
+
+ def is_restricted_download(self):
+ """Whether this resource is restricted download.
+
+ Returns:
+ Boolean value indicating whether the resource is restricted download.
+ """
+ return self.has_label(RESTRICTEDDOWNLOAD_LABEL)
+
+ IsRestrictedDownload = is_restricted_download
+
+
+class AclEntry(gdata.acl.data.AclEntry, gdata.data.BatchEntry):
+ """Resource ACL entry."""
+ @staticmethod
+ def get_instance(role=None, scope_type=None, scope_value=None, key=False):
+ entry = AclEntry()
+
+ if role is not None:
+ if isinstance(role, basestring):
+ role = gdata.acl.data.AclRole(value=role)
+
+ if key:
+ entry.with_key = gdata.acl.data.AclWithKey(key='', role=role)
+ else:
+ entry.role = role
+
+ if scope_type is not None:
+ if scope_value is not None:
+ entry.scope = gdata.acl.data.AclScope(type=scope_type,
+ value=scope_value)
+ else:
+ entry.scope = gdata.acl.data.AclScope(type=scope_type)
+ return entry
+
+ GetInstance = get_instance
+
+
+class AclFeed(gdata.acl.data.AclFeed):
+ """Resource ACL feed."""
+ entry = [AclEntry]
+
+
+class Resource(gdata.data.BatchEntry, CategoryFinder):
+ """DocList version of an Atom Entry."""
+
+ last_viewed = LastViewed
+ last_modified_by = LastModifiedBy
+ resource_id = ResourceId
+ deleted = Deleted
+ writers_can_invite = WritersCanInvite
+ quota_bytes_used = QuotaBytesUsed
+ feed_link = [gdata.data.FeedLink]
+ filename = Filename
+ suggested_filename = SuggestedFilename
+ description = Description
+ # Only populated if you request /feeds/default/private/expandAcl
+ acl_feed = AclFeed
+
+ def __init__(self, type=None, title=None, **kwargs):
+ super(Resource, self).__init__(**kwargs)
+ if isinstance(type, basestring):
+ self.set_resource_type(type)
+
+ if title is not None:
+ if isinstance(title, basestring):
+ self.title = atom.data.Title(text=title)
+ else:
+ self.title = title
+
+ def get_acl_feed_link(self):
+ """Extracts the Resource's ACL feed <gd:feedLink>.
+
+ Returns:
+ A gdata.data.FeedLink object.
+ """
+ for feed_link in self.feed_link:
+ if feed_link.rel == ACL_FEEDLINK_REL:
+ return feed_link
+ return None
+
+ GetAclFeedLink = get_acl_feed_link
+
+ def get_revisions_feed_link(self):
+ """Extracts the Resource's revisions feed <gd:feedLink>.
+
+ Returns:
+ A gdata.data.FeedLink object.
+ """
+ for feed_link in self.feed_link:
+ if feed_link.rel == REVISION_FEEDLINK_REL:
+ return feed_link
+ return None
+
+ GetRevisionsFeedLink = get_revisions_feed_link
+
+ def get_resumable_create_media_link(self):
+ """Extracts the Resource's resumable create link.
+
+ Returns:
+ A gdata.data.FeedLink object.
+ """
+ return self.get_link(RESUMABLE_CREATE_MEDIA_LINK_REL)
+
+ GetResumableCreateMediaLink = get_resumable_create_media_link
+
+ def get_resumable_edit_media_link(self):
+ """Extracts the Resource's resumable update link.
+
+ Returns:
+ A gdata.data.FeedLink object.
+ """
+ return self.get_link(RESUMABLE_EDIT_MEDIA_LINK_REL)
+
+ GetResumableEditMediaLink = get_resumable_edit_media_link
+
+ def in_collections(self):
+ """Returns the parents link(s) (collections) of this entry."""
+ links = []
+ for link in self.link:
+ if link.rel == PARENT_LINK_REL and link.href:
+ links.append(link)
+ return links
+
+ InCollections = in_collections
+
+
+class ResourceFeed(gdata.data.BatchFeed):
+ """Main feed containing a list of resources."""
+ entry = [Resource]
+
+
+class Revision(gdata.data.GDEntry):
+ """Resource Revision entry."""
+ publish = Publish
+ publish_auto = PublishAuto
+ publish_outside_domain = PublishOutsideDomain
+
+ def find_publish_link(self):
+ """Get the link that points to the published resource on the web.
+
+ Returns:
+ A str for the URL in the link with a rel ending in #publish.
+ """
+ return self.find_url(PUBLISH_LINK_REL)
+
+ FindPublishLink = find_publish_link
+
+ def get_publish_link(self):
+ """Get the link that points to the published resource on the web.
+
+ Returns:
+ A gdata.data.Link for the link with a rel ending in #publish.
+ """
+ return self.get_link(PUBLISH_LINK_REL)
+
+ GetPublishLink = get_publish_link
+
+
+class RevisionFeed(gdata.data.GDFeed):
+ """A DocList Revision feed."""
+ entry = [Revision]
+
+
+class ArchiveResourceId(atom.core.XmlElement):
+ """The DocList docs:removed element."""
+ _qname = DOCUMENTS_TEMPLATE % 'archiveResourceId'
+
+
+class ArchiveFailure(atom.core.XmlElement):
+ """The DocList docs:archiveFailure element."""
+ _qname = DOCUMENTS_TEMPLATE % 'archiveFailure'
+
+
+class ArchiveComplete(atom.core.XmlElement):
+ """The DocList docs:archiveComplete element."""
+ _qname = DOCUMENTS_TEMPLATE % 'archiveComplete'
+
+
+class ArchiveTotal(atom.core.XmlElement):
+ """The DocList docs:archiveTotal element."""
+ _qname = DOCUMENTS_TEMPLATE % 'archiveTotal'
+
+
+class ArchiveTotalComplete(atom.core.XmlElement):
+ """The DocList docs:archiveTotalComplete element."""
+ _qname = DOCUMENTS_TEMPLATE % 'archiveTotalComplete'
+
+
+class ArchiveTotalFailure(atom.core.XmlElement):
+ """The DocList docs:archiveTotalFailure element."""
+ _qname = DOCUMENTS_TEMPLATE % 'archiveTotalFailure'
+
+
+class ArchiveConversion(atom.core.XmlElement):
+ """The DocList docs:removed element."""
+ _qname = DOCUMENTS_TEMPLATE % 'archiveConversion'
+ source = 'source'
+ target = 'target'
+
+
+class ArchiveNotify(atom.core.XmlElement):
+ """The DocList docs:archiveNotify element."""
+ _qname = DOCUMENTS_TEMPLATE % 'archiveNotify'
+
+
+class ArchiveStatus(atom.core.XmlElement):
+ """The DocList docs:archiveStatus element."""
+ _qname = DOCUMENTS_TEMPLATE % 'archiveStatus'
+
+
+class ArchiveNotifyStatus(atom.core.XmlElement):
+ """The DocList docs:archiveNotifyStatus element."""
+ _qname = DOCUMENTS_TEMPLATE % 'archiveNotifyStatus'
+
+
+class Archive(gdata.data.GDEntry):
+ """Archive entry."""
+ archive_resource_ids = [ArchiveResourceId]
+ status = ArchiveStatus
+ date_completed = ArchiveComplete
+ num_resources = ArchiveTotal
+ num_complete_resources = ArchiveTotalComplete
+ num_failed_resources = ArchiveTotalFailure
+ failed_resource_ids = [ArchiveFailure]
+ notify_status = ArchiveNotifyStatus
+ conversions = [ArchiveConversion]
+ notification_email = ArchiveNotify
+ size = QuotaBytesUsed
+
+ @staticmethod
+ def from_resource_list(resources):
+ resource_ids = []
+ for resource in resources:
+ id = ArchiveResourceId(text=resource.resource_id.text)
+ resource_ids.append(id)
+ return Archive(archive_resource_ids=resource_ids)
+
+ FromResourceList = from_resource_list
+
+
+class Removed(atom.core.XmlElement):
+ """The DocList docs:removed element."""
+ _qname = DOCUMENTS_TEMPLATE % 'removed'
+
+
+class Changestamp(atom.core.XmlElement):
+ """The DocList docs:changestamp element."""
+ _qname = DOCUMENTS_TEMPLATE % 'changestamp'
+ value = 'value'
+
+
+class Change(Resource):
+ """Change feed entry."""
+ changestamp = Changestamp
+ removed = Removed
+
+
+class ChangeFeed(gdata.data.GDFeed):
+ """DocList Changes feed."""
+ entry = [Change]
+
+
+class QuotaBytesTotal(atom.core.XmlElement):
+ """The DocList gd:quotaBytesTotal element."""
+ _qname = gdata.data.GDATA_TEMPLATE % 'quotaBytesTotal'
+
+
+class QuotaBytesUsedInTrash(atom.core.XmlElement):
+ """The DocList docs:quotaBytesUsedInTrash element."""
+ _qname = DOCUMENTS_TEMPLATE % 'quotaBytesUsedInTrash'
+
+
+class ImportFormat(atom.core.XmlElement):
+ """The DocList docs:importFormat element."""
+ _qname = DOCUMENTS_TEMPLATE % 'importFormat'
+ source = 'source'
+ target = 'target'
+
+
+class ExportFormat(atom.core.XmlElement):
+ """The DocList docs:exportFormat element."""
+ _qname = DOCUMENTS_TEMPLATE % 'exportFormat'
+ source = 'source'
+ target = 'target'
+
+
+class FeatureName(atom.core.XmlElement):
+ """The DocList docs:featureName element."""
+ _qname = DOCUMENTS_TEMPLATE % 'featureName'
+
+
+class FeatureRate(atom.core.XmlElement):
+ """The DocList docs:featureRate element."""
+ _qname = DOCUMENTS_TEMPLATE % 'featureRate'
+
+
+class Feature(atom.core.XmlElement):
+ """The DocList docs:feature element."""
+ _qname = DOCUMENTS_TEMPLATE % 'feature'
+ name = FeatureName
+ rate = FeatureRate
+
+
+class MaxUploadSize(atom.core.XmlElement):
+ """The DocList docs:maxUploadSize element."""
+ _qname = DOCUMENTS_TEMPLATE % 'maxUploadSize'
+ kind = 'kind'
+
+
+class AdditionalRoleSet(atom.core.XmlElement):
+ """The DocList docs:additionalRoleSet element."""
+ _qname = DOCUMENTS_TEMPLATE % 'additionalRoleSet'
+ primaryRole = 'primaryRole'
+ additional_role = [gdata.acl.data.AclAdditionalRole]
+
+
+class AdditionalRoleInfo(atom.core.XmlElement):
+ """The DocList docs:additionalRoleInfo element."""
+ _qname = DOCUMENTS_TEMPLATE % 'additionalRoleInfo'
+ kind = 'kind'
+ additional_role_set = [AdditionalRoleSet]
+
+
+class Metadata(gdata.data.GDEntry):
+ """Metadata entry for a user."""
+ quota_bytes_total = QuotaBytesTotal
+ quota_bytes_used = QuotaBytesUsed
+ quota_bytes_used_in_trash = QuotaBytesUsedInTrash
+ import_formats = [ImportFormat]
+ export_formats = [ExportFormat]
+ features = [Feature]
+ max_upload_sizes = [MaxUploadSize]
+ additional_role_info = [AdditionalRoleInfo]
diff --git a/src/gdata/docs/service.py b/src/gdata/docs/service.py
new file mode 100644
index 0000000..b6f39f6
--- /dev/null
+++ b/src/gdata/docs/service.py
@@ -0,0 +1,618 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""DocsService extends the GDataService to streamline Google Documents
+ operations.
+
+ DocsService: Provides methods to query feeds and manipulate items.
+ Extends GDataService.
+
+ DocumentQuery: Queries a Google Document list feed.
+
+ DocumentAclQuery: Queries a Google Document Acl feed.
+"""
+
+
+__author__ = ('api.jfisher (Jeff Fisher), '
+ 'e.bidelman (Eric Bidelman)')
+
+import re
+import atom
+import gdata.service
+import gdata.docs
+import urllib
+
+# XML Namespaces used in Google Documents entities.
+DATA_KIND_SCHEME = gdata.GDATA_NAMESPACE + '#kind'
+DOCUMENT_LABEL = 'document'
+SPREADSHEET_LABEL = 'spreadsheet'
+PRESENTATION_LABEL = 'presentation'
+FOLDER_LABEL = 'folder'
+PDF_LABEL = 'pdf'
+
+LABEL_SCHEME = gdata.GDATA_NAMESPACE + '/labels'
+STARRED_LABEL_TERM = LABEL_SCHEME + '#starred'
+TRASHED_LABEL_TERM = LABEL_SCHEME + '#trashed'
+HIDDEN_LABEL_TERM = LABEL_SCHEME + '#hidden'
+MINE_LABEL_TERM = LABEL_SCHEME + '#mine'
+PRIVATE_LABEL_TERM = LABEL_SCHEME + '#private'
+SHARED_WITH_DOMAIN_LABEL_TERM = LABEL_SCHEME + '#shared-with-domain'
+VIEWED_LABEL_TERM = LABEL_SCHEME + '#viewed'
+
+FOLDERS_SCHEME_PREFIX = gdata.docs.DOCUMENTS_NAMESPACE + '/folders/'
+
+# File extensions of documents that are permitted to be uploaded or downloaded.
+SUPPORTED_FILETYPES = {
+ 'CSV': 'text/csv',
+ 'TSV': 'text/tab-separated-values',
+ 'TAB': 'text/tab-separated-values',
+ 'DOC': 'application/msword',
+ 'DOCX': ('application/vnd.openxmlformats-officedocument.'
+ 'wordprocessingml.document'),
+ 'ODS': 'application/x-vnd.oasis.opendocument.spreadsheet',
+ 'ODT': 'application/vnd.oasis.opendocument.text',
+ 'RTF': 'application/rtf',
+ 'SXW': 'application/vnd.sun.xml.writer',
+ 'TXT': 'text/plain',
+ 'XLS': 'application/vnd.ms-excel',
+ 'XLSX': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+ 'PDF': 'application/pdf',
+ 'PNG': 'image/png',
+ 'PPT': 'application/vnd.ms-powerpoint',
+ 'PPS': 'application/vnd.ms-powerpoint',
+ 'HTM': 'text/html',
+ 'HTML': 'text/html',
+ 'ZIP': 'application/zip',
+ 'SWF': 'application/x-shockwave-flash'
+ }
+
+
+class DocsService(gdata.service.GDataService):
+
+ """Client extension for the Google Documents service Document List feed."""
+
+ __FILE_EXT_PATTERN = re.compile('.*\.([a-zA-Z]{3,}$)')
+ __RESOURCE_ID_PATTERN = re.compile('^([a-z]*)(:|%3A)([\w-]*)$')
+
+ def __init__(self, email=None, password=None, source=None,
+ server='docs.google.com', additional_headers=None, **kwargs):
+ """Creates a client for the Google Documents service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'docs.google.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='writely', source=source,
+ server=server, additional_headers=additional_headers, **kwargs)
+ self.ssl = True
+
+ def _MakeKindCategory(self, label):
+ if label is None:
+ return None
+ return atom.Category(scheme=DATA_KIND_SCHEME,
+ term=gdata.docs.DOCUMENTS_NAMESPACE + '#' + label, label=label)
+
+ def _MakeContentLinkFromId(self, resource_id):
+ match = self.__RESOURCE_ID_PATTERN.match(resource_id)
+ label = match.group(1)
+ doc_id = match.group(3)
+ if label == DOCUMENT_LABEL:
+ return '/feeds/download/documents/Export?docId=%s' % doc_id
+ if label == PRESENTATION_LABEL:
+ return '/feeds/download/presentations/Export?docId=%s' % doc_id
+ if label == SPREADSHEET_LABEL:
+ return ('https://spreadsheets.google.com/feeds/download/spreadsheets/'
+ 'Export?key=%s' % doc_id)
+ raise ValueError, 'Invalid resource id: %s' % resource_id
+
+ def _UploadFile(self, media_source, title, category, folder_or_uri=None):
+ """Uploads a file to the Document List feed.
+
+ Args:
+ media_source: A gdata.MediaSource object containing the file to be
+ uploaded.
+ title: string The title of the document on the server after being
+ uploaded.
+ category: An atom.Category object specifying the appropriate document
+ type.
+ folder_or_uri: DocumentListEntry or string (optional) An object with a
+ link to a folder or a uri to a folder to upload to.
+ Note: A valid uri for a folder is of the form:
+ /feeds/folders/private/full/folder%3Afolder_id
+
+ Returns:
+ A DocumentListEntry containing information about the document created on
+ the Google Documents service.
+ """
+ if folder_or_uri:
+ try:
+ uri = folder_or_uri.content.src
+ except AttributeError:
+ uri = folder_or_uri
+ else:
+ uri = '/feeds/documents/private/full'
+
+ entry = gdata.docs.DocumentListEntry()
+ entry.title = atom.Title(text=title)
+ if category is not None:
+ entry.category.append(category)
+ entry = self.Post(entry, uri, media_source=media_source,
+ extra_headers={'Slug': media_source.file_name},
+ converter=gdata.docs.DocumentListEntryFromString)
+ return entry
+
+ def _DownloadFile(self, uri, file_path):
+ """Downloads a file.
+
+ Args:
+ uri: string The full Export URL to download the file from.
+ file_path: string The full path to save the file to.
+
+ Raises:
+ RequestError: on error response from server.
+ """
+ server_response = self.request('GET', uri)
+ response_body = server_response.read()
+ timeout = 5
+ while server_response.status == 302 and timeout > 0:
+ server_response = self.request('GET',
+ server_response.getheader('Location'))
+ response_body = server_response.read()
+ timeout -= 1
+ if server_response.status != 200:
+ raise gdata.service.RequestError, {'status': server_response.status,
+ 'reason': server_response.reason,
+ 'body': response_body}
+ f = open(file_path, 'wb')
+ f.write(response_body)
+ f.flush()
+ f.close()
+
+ def MoveIntoFolder(self, source_entry, folder_entry):
+ """Moves a document into a folder in the Document List Feed.
+
+ Args:
+ source_entry: DocumentListEntry An object representing the source
+ document/folder.
+ folder_entry: DocumentListEntry An object with a link to the destination
+ folder.
+
+ Returns:
+ A DocumentListEntry containing information about the document created on
+ the Google Documents service.
+ """
+ entry = gdata.docs.DocumentListEntry()
+ entry.id = source_entry.id
+ entry = self.Post(entry, folder_entry.content.src,
+ converter=gdata.docs.DocumentListEntryFromString)
+ return entry
+
+ def Query(self, uri, converter=gdata.docs.DocumentListFeedFromString):
+ """Queries the Document List feed and returns the resulting feed of
+ entries.
+
+ Args:
+ uri: string The full URI to be queried. This can contain query
+ parameters, a hostname, or simply the relative path to a Document
+ List feed. The DocumentQuery object is useful when constructing
+ query parameters.
+ converter: func (optional) A function which will be executed on the
+ retrieved item, generally to render it into a Python object.
+ By default the DocumentListFeedFromString function is used to
+ return a DocumentListFeed object. This is because most feed
+ queries will result in a feed and not a single entry.
+ """
+ return self.Get(uri, converter=converter)
+
+ def QueryDocumentListFeed(self, uri):
+ """Retrieves a DocumentListFeed by retrieving a URI based off the Document
+ List feed, including any query parameters. A DocumentQuery object can
+ be used to construct these parameters.
+
+ Args:
+ uri: string The URI of the feed being retrieved possibly with query
+ parameters.
+
+ Returns:
+ A DocumentListFeed object representing the feed returned by the server.
+ """
+ return self.Get(uri, converter=gdata.docs.DocumentListFeedFromString)
+
+ def GetDocumentListEntry(self, uri):
+ """Retrieves a particular DocumentListEntry by its unique URI.
+
+ Args:
+ uri: string The unique URI of an entry in a Document List feed.
+
+ Returns:
+ A DocumentListEntry object representing the retrieved entry.
+ """
+ return self.Get(uri, converter=gdata.docs.DocumentListEntryFromString)
+
+ def GetDocumentListFeed(self, uri=None):
+ """Retrieves a feed containing all of a user's documents.
+
+ Args:
+ uri: string A full URI to query the Document List feed.
+ """
+ if not uri:
+ uri = gdata.docs.service.DocumentQuery().ToUri()
+ return self.QueryDocumentListFeed(uri)
+
+ def GetDocumentListAclEntry(self, uri):
+ """Retrieves a particular DocumentListAclEntry by its unique URI.
+
+ Args:
+ uri: string The unique URI of an entry in a Document List feed.
+
+ Returns:
+ A DocumentListAclEntry object representing the retrieved entry.
+ """
+ return self.Get(uri, converter=gdata.docs.DocumentListAclEntryFromString)
+
+ def GetDocumentListAclFeed(self, uri):
+ """Retrieves a feed containing all of a user's documents.
+
+ Args:
+ uri: string The URI of a document's Acl feed to retrieve.
+
+ Returns:
+ A DocumentListAclFeed object representing the ACL feed
+ returned by the server.
+ """
+ return self.Get(uri, converter=gdata.docs.DocumentListAclFeedFromString)
+
+ def Upload(self, media_source, title, folder_or_uri=None, label=None):
+ """Uploads a document inside of a MediaSource object to the Document List
+ feed with the given title.
+
+ Args:
+ media_source: MediaSource The gdata.MediaSource object containing a
+ document file to be uploaded.
+ title: string The title of the document on the server after being
+ uploaded.
+ folder_or_uri: DocumentListEntry or string (optional) An object with a
+ link to a folder or a uri to a folder to upload to.
+ Note: A valid uri for a folder is of the form:
+ /feeds/folders/private/full/folder%3Afolder_id
+ label: optional label describing the type of the document to be created.
+
+ Returns:
+ A DocumentListEntry containing information about the document created
+ on the Google Documents service.
+ """
+
+ return self._UploadFile(media_source, title, self._MakeKindCategory(label),
+ folder_or_uri)
+
+ def Download(self, entry_or_id_or_url, file_path, export_format=None,
+ gid=None, extra_params=None):
+ """Downloads a document from the Document List.
+
+ Args:
+ entry_or_id_or_url: a DocumentListEntry, or the resource id of an entry,
+ or a url to download from (such as the content src).
+ file_path: string The full path to save the file to.
+ export_format: the format to convert to, if conversion is required.
+ gid: grid id, for downloading a single grid of a spreadsheet
+ extra_params: a map of any further parameters to control how the document
+ is downloaded
+
+ Raises:
+ RequestError if the service does not respond with success
+ """
+
+ if isinstance(entry_or_id_or_url, gdata.docs.DocumentListEntry):
+ url = entry_or_id_or_url.content.src
+ else:
+ if self.__RESOURCE_ID_PATTERN.match(entry_or_id_or_url):
+ url = self._MakeContentLinkFromId(entry_or_id_or_url)
+ else:
+ url = entry_or_id_or_url
+
+ if export_format is not None:
+ if url.find('/Export?') == -1:
+ raise gdata.service.Error, ('This entry cannot be exported '
+ 'as a different format')
+ url += '&exportFormat=%s' % export_format
+
+ if gid is not None:
+ if url.find('spreadsheets') == -1:
+ raise gdata.service.Error, 'grid id param is not valid for this entry'
+ url += '&gid=%s' % gid
+
+ if extra_params:
+ url += '&' + urllib.urlencode(extra_params)
+
+ self._DownloadFile(url, file_path)
+
+ def Export(self, entry_or_id_or_url, file_path, gid=None, extra_params=None):
+ """Downloads a document from the Document List in a different format.
+
+ Args:
+ entry_or_id_or_url: a DocumentListEntry, or the resource id of an entry,
+ or a url to download from (such as the content src).
+ file_path: string The full path to save the file to. The export
+ format is inferred from the the file extension.
+ gid: grid id, for downloading a single grid of a spreadsheet
+ extra_params: a map of any further parameters to control how the document
+ is downloaded
+
+ Raises:
+ RequestError if the service does not respond with success
+ """
+ ext = None
+ match = self.__FILE_EXT_PATTERN.match(file_path)
+ if match:
+ ext = match.group(1)
+ self.Download(entry_or_id_or_url, file_path, ext, gid, extra_params)
+
+ def CreateFolder(self, title, folder_or_uri=None):
+ """Creates a folder in the Document List feed.
+
+ Args:
+ title: string The title of the folder on the server after being created.
+ folder_or_uri: DocumentListEntry or string (optional) An object with a
+ link to a folder or a uri to a folder to upload to.
+ Note: A valid uri for a folder is of the form:
+ /feeds/folders/private/full/folder%3Afolder_id
+
+ Returns:
+ A DocumentListEntry containing information about the folder created on
+ the Google Documents service.
+ """
+ if folder_or_uri:
+ try:
+ uri = folder_or_uri.content.src
+ except AttributeError:
+ uri = folder_or_uri
+ else:
+ uri = '/feeds/documents/private/full'
+
+ folder_entry = gdata.docs.DocumentListEntry()
+ folder_entry.title = atom.Title(text=title)
+ folder_entry.category.append(self._MakeKindCategory(FOLDER_LABEL))
+ folder_entry = self.Post(folder_entry, uri,
+ converter=gdata.docs.DocumentListEntryFromString)
+
+ return folder_entry
+
+
+ def MoveOutOfFolder(self, source_entry):
+ """Moves a document into a folder in the Document List Feed.
+
+ Args:
+ source_entry: DocumentListEntry An object representing the source
+ document/folder.
+
+ Returns:
+ True if the entry was moved out.
+ """
+ return self.Delete(source_entry.GetEditLink().href)
+
+ # Deprecated methods
+
+ #@atom.deprecated('Please use Upload instead')
+ def UploadPresentation(self, media_source, title, folder_or_uri=None):
+ """Uploads a presentation inside of a MediaSource object to the Document
+ List feed with the given title.
+
+ This method is deprecated, use Upload instead.
+
+ Args:
+ media_source: MediaSource The MediaSource object containing a
+ presentation file to be uploaded.
+ title: string The title of the presentation on the server after being
+ uploaded.
+ folder_or_uri: DocumentListEntry or string (optional) An object with a
+ link to a folder or a uri to a folder to upload to.
+ Note: A valid uri for a folder is of the form:
+ /feeds/folders/private/full/folder%3Afolder_id
+
+ Returns:
+ A DocumentListEntry containing information about the presentation created
+ on the Google Documents service.
+ """
+ return self._UploadFile(
+ media_source, title, self._MakeKindCategory(PRESENTATION_LABEL),
+ folder_or_uri=folder_or_uri)
+
+ UploadPresentation = atom.deprecated('Please use Upload instead')(
+ UploadPresentation)
+
+ #@atom.deprecated('Please use Upload instead')
+ def UploadSpreadsheet(self, media_source, title, folder_or_uri=None):
+ """Uploads a spreadsheet inside of a MediaSource object to the Document
+ List feed with the given title.
+
+ This method is deprecated, use Upload instead.
+
+ Args:
+ media_source: MediaSource The MediaSource object containing a spreadsheet
+ file to be uploaded.
+ title: string The title of the spreadsheet on the server after being
+ uploaded.
+ folder_or_uri: DocumentListEntry or string (optional) An object with a
+ link to a folder or a uri to a folder to upload to.
+ Note: A valid uri for a folder is of the form:
+ /feeds/folders/private/full/folder%3Afolder_id
+
+ Returns:
+ A DocumentListEntry containing information about the spreadsheet created
+ on the Google Documents service.
+ """
+ return self._UploadFile(
+ media_source, title, self._MakeKindCategory(SPREADSHEET_LABEL),
+ folder_or_uri=folder_or_uri)
+
+ UploadSpreadsheet = atom.deprecated('Please use Upload instead')(
+ UploadSpreadsheet)
+
+ #@atom.deprecated('Please use Upload instead')
+ def UploadDocument(self, media_source, title, folder_or_uri=None):
+ """Uploads a document inside of a MediaSource object to the Document List
+ feed with the given title.
+
+ This method is deprecated, use Upload instead.
+
+ Args:
+ media_source: MediaSource The gdata.MediaSource object containing a
+ document file to be uploaded.
+ title: string The title of the document on the server after being
+ uploaded.
+ folder_or_uri: DocumentListEntry or string (optional) An object with a
+ link to a folder or a uri to a folder to upload to.
+ Note: A valid uri for a folder is of the form:
+ /feeds/folders/private/full/folder%3Afolder_id
+
+ Returns:
+ A DocumentListEntry containing information about the document created
+ on the Google Documents service.
+ """
+ return self._UploadFile(
+ media_source, title, self._MakeKindCategory(DOCUMENT_LABEL),
+ folder_or_uri=folder_or_uri)
+
+ UploadDocument = atom.deprecated('Please use Upload instead')(
+ UploadDocument)
+
+ """Calling any of these functions is the same as calling Export"""
+ DownloadDocument = atom.deprecated('Please use Export instead')(Export)
+ DownloadPresentation = atom.deprecated('Please use Export instead')(Export)
+ DownloadSpreadsheet = atom.deprecated('Please use Export instead')(Export)
+
+ """Calling any of these functions is the same as calling MoveIntoFolder"""
+ MoveDocumentIntoFolder = atom.deprecated(
+ 'Please use MoveIntoFolder instead')(MoveIntoFolder)
+ MovePresentationIntoFolder = atom.deprecated(
+ 'Please use MoveIntoFolder instead')(MoveIntoFolder)
+ MoveSpreadsheetIntoFolder = atom.deprecated(
+ 'Please use MoveIntoFolder instead')(MoveIntoFolder)
+ MoveFolderIntoFolder = atom.deprecated(
+ 'Please use MoveIntoFolder instead')(MoveIntoFolder)
+
+
+class DocumentQuery(gdata.service.Query):
+
+ """Object used to construct a URI to query the Google Document List feed"""
+
+ def __init__(self, feed='/feeds/documents', visibility='private',
+ projection='full', text_query=None, params=None,
+ categories=None):
+ """Constructor for Document List Query
+
+ Args:
+ feed: string (optional) The path for the feed. (e.g. '/feeds/documents')
+ visibility: string (optional) The visibility chosen for the current feed.
+ projection: string (optional) The projection chosen for the current feed.
+ text_query: string (optional) The contents of the q query parameter. This
+ string is URL escaped upon conversion to a URI.
+ params: dict (optional) Parameter value string pairs which become URL
+ params when translated to a URI. These parameters are added to
+ the query's items.
+ categories: list (optional) List of category strings which should be
+ included as query categories. See gdata.service.Query for
+ additional documentation.
+
+ Yields:
+ A DocumentQuery object used to construct a URI based on the Document
+ List feed.
+ """
+ self.visibility = visibility
+ self.projection = projection
+ gdata.service.Query.__init__(self, feed, text_query, params, categories)
+
+ def ToUri(self):
+ """Generates a URI from the query parameters set in the object.
+
+ Returns:
+ A string containing the URI used to retrieve entries from the Document
+ List feed.
+ """
+ old_feed = self.feed
+ self.feed = '/'.join([old_feed, self.visibility, self.projection])
+ new_feed = gdata.service.Query.ToUri(self)
+ self.feed = old_feed
+ return new_feed
+
+ def AddNamedFolder(self, email, folder_name):
+ """Adds a named folder category, qualified by a schema.
+
+ This function lets you query for documents that are contained inside a
+ named folder without fear of collision with other categories.
+
+ Args:
+ email: string The email of the user who owns the folder.
+ folder_name: string The name of the folder.
+
+ Returns:
+ The string of the category that was added to the object.
+ """
+
+ category = '{%s%s}%s' % (FOLDERS_SCHEME_PREFIX, email, folder_name)
+ self.categories.append(category)
+ return category
+
+ def RemoveNamedFolder(self, email, folder_name):
+ """Removes a named folder category, qualified by a schema.
+
+ Args:
+ email: string The email of the user who owns the folder.
+ folder_name: string The name of the folder.
+
+ Returns:
+ The string of the category that was removed to the object.
+ """
+ category = '{%s%s}%s' % (FOLDERS_SCHEME_PREFIX, email, folder_name)
+ self.categories.remove(category)
+ return category
+
+
+class DocumentAclQuery(gdata.service.Query):
+
+ """Object used to construct a URI to query a Document's ACL feed"""
+
+ def __init__(self, resource_id, feed='/feeds/acl/private/full'):
+ """Constructor for Document ACL Query
+
+ Args:
+ resource_id: string The resource id. (e.g. 'document%3Adocument_id',
+ 'spreadsheet%3Aspreadsheet_id', etc.)
+ feed: string (optional) The path for the feed.
+ (e.g. '/feeds/acl/private/full')
+
+ Yields:
+ A DocumentAclQuery object used to construct a URI based on the Document
+ ACL feed.
+ """
+ self.resource_id = resource_id
+ gdata.service.Query.__init__(self, feed)
+
+ def ToUri(self):
+ """Generates a URI from the query parameters set in the object.
+
+ Returns:
+ A string containing the URI used to retrieve entries from the Document
+ ACL feed.
+ """
+ return '%s/%s' % (gdata.service.Query.ToUri(self), self.resource_id)
diff --git a/src/gdata/dublincore/__init__.py b/src/gdata/dublincore/__init__.py
new file mode 100644
index 0000000..22071f7
--- /dev/null
+++ b/src/gdata/dublincore/__init__.py
@@ -0,0 +1,15 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/src/gdata/dublincore/data.py b/src/gdata/dublincore/data.py
new file mode 100644
index 0000000..c6345c1
--- /dev/null
+++ b/src/gdata/dublincore/data.py
@@ -0,0 +1,78 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains the data classes of the Dublin Core Metadata Initiative (DCMI) Extension"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+
+
+DC_TEMPLATE = '{http://purl.org/dc/terms/}%s'
+
+
+class Creator(atom.core.XmlElement):
+ """Entity primarily responsible for making the resource."""
+ _qname = DC_TEMPLATE % 'creator'
+
+
+class Date(atom.core.XmlElement):
+ """Point or period of time associated with an event in the lifecycle of the resource."""
+ _qname = DC_TEMPLATE % 'date'
+
+
+class Description(atom.core.XmlElement):
+ """Account of the resource."""
+ _qname = DC_TEMPLATE % 'description'
+
+
+class Format(atom.core.XmlElement):
+ """File format, physical medium, or dimensions of the resource."""
+ _qname = DC_TEMPLATE % 'format'
+
+
+class Identifier(atom.core.XmlElement):
+ """An unambiguous reference to the resource within a given context."""
+ _qname = DC_TEMPLATE % 'identifier'
+
+
+class Language(atom.core.XmlElement):
+ """Language of the resource."""
+ _qname = DC_TEMPLATE % 'language'
+
+
+class Publisher(atom.core.XmlElement):
+ """Entity responsible for making the resource available."""
+ _qname = DC_TEMPLATE % 'publisher'
+
+
+class Rights(atom.core.XmlElement):
+ """Information about rights held in and over the resource."""
+ _qname = DC_TEMPLATE % 'rights'
+
+
+class Subject(atom.core.XmlElement):
+ """Topic of the resource."""
+ _qname = DC_TEMPLATE % 'subject'
+
+
+class Title(atom.core.XmlElement):
+ """Name given to the resource."""
+ _qname = DC_TEMPLATE % 'title'
+
+
diff --git a/src/gdata/exif/__init__.py b/src/gdata/exif/__init__.py
new file mode 100644
index 0000000..7f1f9c2
--- /dev/null
+++ b/src/gdata/exif/__init__.py
@@ -0,0 +1,217 @@
+# -*-*- encoding: utf-8 -*-*-
+#
+# This is gdata.photos.exif, implementing the exif namespace in gdata
+#
+# $Id: __init__.py 81 2007-10-03 14:41:42Z havard.gulldahl $
+#
+# Copyright 2007 Håvard Gulldahl
+# Portions copyright 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""This module maps elements from the {EXIF} namespace[1] to GData objects.
+These elements describe image data, using exif attributes[2].
+
+Picasa Web Albums uses the exif namespace to represent Exif data encoded
+in a photo [3].
+
+Picasa Web Albums uses the following exif elements:
+exif:distance
+exif:exposure
+exif:flash
+exif:focallength
+exif:fstop
+exif:imageUniqueID
+exif:iso
+exif:make
+exif:model
+exif:tags
+exif:time
+
+[1]: http://schemas.google.com/photos/exif/2007.
+[2]: http://en.wikipedia.org/wiki/Exif
+[3]: http://code.google.com/apis/picasaweb/reference.html#exif_reference
+"""
+
+
+__author__ = u'havard@gulldahl.no'# (Håvard Gulldahl)' #BUG: pydoc chokes on non-ascii chars in __author__
+__license__ = 'Apache License v2'
+
+
+import atom
+import gdata
+
+EXIF_NAMESPACE = 'http://schemas.google.com/photos/exif/2007'
+
+class ExifBaseElement(atom.AtomBase):
+ """Base class for elements in the EXIF_NAMESPACE (%s). To add new elements, you only need to add the element tag name to self._tag
+ """ % EXIF_NAMESPACE
+
+ _tag = ''
+ _namespace = EXIF_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, name=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+class Distance(ExifBaseElement):
+ "(float) The distance to the subject, e.g. 0.0"
+
+ _tag = 'distance'
+def DistanceFromString(xml_string):
+ return atom.CreateClassFromXMLString(Distance, xml_string)
+
+class Exposure(ExifBaseElement):
+ "(float) The exposure time used, e.g. 0.025 or 8.0E4"
+
+ _tag = 'exposure'
+def ExposureFromString(xml_string):
+ return atom.CreateClassFromXMLString(Exposure, xml_string)
+
+class Flash(ExifBaseElement):
+ """(string) Boolean value indicating whether the flash was used.
+ The .text attribute will either be `true' or `false'
+
+ As a convenience, this object's .bool method will return what you want,
+ so you can say:
+
+ flash_used = bool(Flash)
+
+ """
+
+ _tag = 'flash'
+ def __bool__(self):
+ if self.text.lower() in ('true','false'):
+ return self.text.lower() == 'true'
+def FlashFromString(xml_string):
+ return atom.CreateClassFromXMLString(Flash, xml_string)
+
+class Focallength(ExifBaseElement):
+ "(float) The focal length used, e.g. 23.7"
+
+ _tag = 'focallength'
+def FocallengthFromString(xml_string):
+ return atom.CreateClassFromXMLString(Focallength, xml_string)
+
+class Fstop(ExifBaseElement):
+ "(float) The fstop value used, e.g. 5.0"
+
+ _tag = 'fstop'
+def FstopFromString(xml_string):
+ return atom.CreateClassFromXMLString(Fstop, xml_string)
+
+class ImageUniqueID(ExifBaseElement):
+ "(string) The unique image ID for the photo. Generated by Google Photo servers"
+
+ _tag = 'imageUniqueID'
+def ImageUniqueIDFromString(xml_string):
+ return atom.CreateClassFromXMLString(ImageUniqueID, xml_string)
+
+class Iso(ExifBaseElement):
+ "(int) The iso equivalent value used, e.g. 200"
+
+ _tag = 'iso'
+def IsoFromString(xml_string):
+ return atom.CreateClassFromXMLString(Iso, xml_string)
+
+class Make(ExifBaseElement):
+ "(string) The make of the camera used, e.g. Fictitious Camera Company"
+
+ _tag = 'make'
+def MakeFromString(xml_string):
+ return atom.CreateClassFromXMLString(Make, xml_string)
+
+class Model(ExifBaseElement):
+ "(string) The model of the camera used,e.g AMAZING-100D"
+
+ _tag = 'model'
+def ModelFromString(xml_string):
+ return atom.CreateClassFromXMLString(Model, xml_string)
+
+class Time(ExifBaseElement):
+ """(int) The date/time the photo was taken, e.g. 1180294337000.
+ Represented as the number of milliseconds since January 1st, 1970.
+
+ The value of this element will always be identical to the value
+ of the <gphoto:timestamp>.
+
+ Look at this object's .isoformat() for a human friendly datetime string:
+
+ photo_epoch = Time.text # 1180294337000
+ photo_isostring = Time.isoformat() # '2007-05-27T19:32:17.000Z'
+
+ Alternatively:
+ photo_datetime = Time.datetime() # (requires python >= 2.3)
+ """
+
+ _tag = 'time'
+ def isoformat(self):
+ """(string) Return the timestamp as a ISO 8601 formatted string,
+ e.g. '2007-05-27T19:32:17.000Z'
+ """
+ import time
+ epoch = float(self.text)/1000
+ return time.strftime('%Y-%m-%dT%H:%M:%S.000Z', time.gmtime(epoch))
+
+ def datetime(self):
+ """(datetime.datetime) Return the timestamp as a datetime.datetime object
+
+ Requires python 2.3
+ """
+ import datetime
+ epoch = float(self.text)/1000
+ return datetime.datetime.fromtimestamp(epoch)
+
+def TimeFromString(xml_string):
+ return atom.CreateClassFromXMLString(Time, xml_string)
+
+class Tags(ExifBaseElement):
+ """The container for all exif elements.
+ The <exif:tags> element can appear as a child of a photo entry.
+ """
+
+ _tag = 'tags'
+ _children = atom.AtomBase._children.copy()
+ _children['{%s}fstop' % EXIF_NAMESPACE] = ('fstop', Fstop)
+ _children['{%s}make' % EXIF_NAMESPACE] = ('make', Make)
+ _children['{%s}model' % EXIF_NAMESPACE] = ('model', Model)
+ _children['{%s}distance' % EXIF_NAMESPACE] = ('distance', Distance)
+ _children['{%s}exposure' % EXIF_NAMESPACE] = ('exposure', Exposure)
+ _children['{%s}flash' % EXIF_NAMESPACE] = ('flash', Flash)
+ _children['{%s}focallength' % EXIF_NAMESPACE] = ('focallength', Focallength)
+ _children['{%s}iso' % EXIF_NAMESPACE] = ('iso', Iso)
+ _children['{%s}time' % EXIF_NAMESPACE] = ('time', Time)
+ _children['{%s}imageUniqueID' % EXIF_NAMESPACE] = ('imageUniqueID', ImageUniqueID)
+
+ def __init__(self, extension_elements=None, extension_attributes=None, text=None):
+ ExifBaseElement.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+ self.fstop=None
+ self.make=None
+ self.model=None
+ self.distance=None
+ self.exposure=None
+ self.flash=None
+ self.focallength=None
+ self.iso=None
+ self.time=None
+ self.imageUniqueID=None
+def TagsFromString(xml_string):
+ return atom.CreateClassFromXMLString(Tags, xml_string)
+
diff --git a/src/gdata/finance/__init__.py b/src/gdata/finance/__init__.py
new file mode 100644
index 0000000..28ab898
--- /dev/null
+++ b/src/gdata/finance/__init__.py
@@ -0,0 +1,486 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Tan Swee Heng
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains extensions to Atom objects used with Google Finance."""
+
+
+__author__ = 'thesweeheng@gmail.com'
+
+
+import atom
+import gdata
+
+
+GD_NAMESPACE = 'http://schemas.google.com/g/2005'
+GF_NAMESPACE = 'http://schemas.google.com/finance/2007'
+
+
+class Money(atom.AtomBase):
+ """The <gd:money> element."""
+ _tag = 'money'
+ _namespace = GD_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['amount'] = 'amount'
+ _attributes['currencyCode'] = 'currency_code'
+
+ def __init__(self, amount=None, currency_code=None, **kwargs):
+ self.amount = amount
+ self.currency_code = currency_code
+ atom.AtomBase.__init__(self, **kwargs)
+
+ def __str__(self):
+ return "%s %s" % (self.amount, self.currency_code)
+
+
+def MoneyFromString(xml_string):
+ return atom.CreateClassFromXMLString(Money, xml_string)
+
+
+class _Monies(atom.AtomBase):
+ """An element containing multiple <gd:money> in multiple currencies."""
+ _namespace = GF_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _children['{%s}money' % GD_NAMESPACE] = ('money', [Money])
+
+ def __init__(self, money=None, **kwargs):
+ self.money = money or []
+ atom.AtomBase.__init__(self, **kwargs)
+
+ def __str__(self):
+ return " / ".join(["%s" % i for i in self.money])
+
+
+class CostBasis(_Monies):
+ """The <gf:costBasis> element."""
+ _tag = 'costBasis'
+
+
+def CostBasisFromString(xml_string):
+ return atom.CreateClassFromXMLString(CostBasis, xml_string)
+
+
+class DaysGain(_Monies):
+ """The <gf:daysGain> element."""
+ _tag = 'daysGain'
+
+
+def DaysGainFromString(xml_string):
+ return atom.CreateClassFromXMLString(DaysGain, xml_string)
+
+
+class Gain(_Monies):
+ """The <gf:gain> element."""
+ _tag = 'gain'
+
+
+def GainFromString(xml_string):
+ return atom.CreateClassFromXMLString(Gain, xml_string)
+
+
+class MarketValue(_Monies):
+ """The <gf:marketValue> element."""
+ _tag = 'gain'
+ _tag = 'marketValue'
+
+
+def MarketValueFromString(xml_string):
+ return atom.CreateClassFromXMLString(MarketValue, xml_string)
+
+
+class Commission(_Monies):
+ """The <gf:commission> element."""
+ _tag = 'commission'
+
+
+def CommissionFromString(xml_string):
+ return atom.CreateClassFromXMLString(Commission, xml_string)
+
+
+class Price(_Monies):
+ """The <gf:price> element."""
+ _tag = 'price'
+
+
+def PriceFromString(xml_string):
+ return atom.CreateClassFromXMLString(Price, xml_string)
+
+
+class Symbol(atom.AtomBase):
+ """The <gf:symbol> element."""
+ _tag = 'symbol'
+ _namespace = GF_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['fullName'] = 'full_name'
+ _attributes['exchange'] = 'exchange'
+ _attributes['symbol'] = 'symbol'
+
+ def __init__(self, full_name=None, exchange=None, symbol=None, **kwargs):
+ self.full_name = full_name
+ self.exchange = exchange
+ self.symbol = symbol
+ atom.AtomBase.__init__(self, **kwargs)
+
+ def __str__(self):
+ return "%s:%s (%s)" % (self.exchange, self.symbol, self.full_name)
+
+
+def SymbolFromString(xml_string):
+ return atom.CreateClassFromXMLString(Symbol, xml_string)
+
+
+class TransactionData(atom.AtomBase):
+ """The <gf:transactionData> element."""
+ _tag = 'transactionData'
+ _namespace = GF_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['type'] = 'type'
+ _attributes['date'] = 'date'
+ _attributes['shares'] = 'shares'
+ _attributes['notes'] = 'notes'
+ _children = atom.AtomBase._children.copy()
+ _children['{%s}commission' % GF_NAMESPACE] = ('commission', Commission)
+ _children['{%s}price' % GF_NAMESPACE] = ('price', Price)
+
+ def __init__(self, type=None, date=None, shares=None,
+ notes=None, commission=None, price=None, **kwargs):
+ self.type = type
+ self.date = date
+ self.shares = shares
+ self.notes = notes
+ self.commission = commission
+ self.price = price
+ atom.AtomBase.__init__(self, **kwargs)
+
+
+def TransactionDataFromString(xml_string):
+ return atom.CreateClassFromXMLString(TransactionData, xml_string)
+
+
+class TransactionEntry(gdata.GDataEntry):
+ """An entry of the transaction feed.
+
+ A TransactionEntry contains TransactionData such as the transaction
+ type (Buy, Sell, Sell Short, or Buy to Cover), the number of units,
+ the date, the price, any commission, and any notes.
+ """
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _children['{%s}transactionData' % GF_NAMESPACE] = (
+ 'transaction_data', TransactionData)
+
+ def __init__(self, transaction_data=None, **kwargs):
+ self.transaction_data = transaction_data
+ gdata.GDataEntry.__init__(self, **kwargs)
+
+ def transaction_id(self):
+ return self.id.text.split("/")[-1]
+
+ transaction_id = property(transaction_id, doc='The transaction ID.')
+
+
+def TransactionEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(TransactionEntry, xml_string)
+
+
+class TransactionFeed(gdata.GDataFeed):
+ """A feed that lists all of the transactions that have been recorded for
+ a particular position.
+
+ A transaction is a collection of information about an instance of
+ buying or selling a particular security. The TransactionFeed lists all
+ of the transactions that have been recorded for a particular position
+ as a list of TransactionEntries.
+ """
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [TransactionEntry])
+
+
+def TransactionFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(TransactionFeed, xml_string)
+
+
+class TransactionFeedLink(atom.AtomBase):
+ """Link to TransactionFeed embedded in PositionEntry.
+
+ If a PositionFeed is queried with transactions='true', TransactionFeeds
+ are inlined in the returned PositionEntries. These TransactionFeeds are
+ accessible via TransactionFeedLink's feed attribute.
+ """
+ _tag = 'feedLink'
+ _namespace = GD_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['href'] = 'href'
+ _children = atom.AtomBase._children.copy()
+ _children['{%s}feed' % atom.ATOM_NAMESPACE] = (
+ 'feed', TransactionFeed)
+
+ def __init__(self, href=None, feed=None, **kwargs):
+ self.href = href
+ self.feed = feed
+ atom.AtomBase.__init__(self, **kwargs)
+
+
+class PositionData(atom.AtomBase):
+ """The <gf:positionData> element."""
+ _tag = 'positionData'
+ _namespace = GF_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['gainPercentage'] = 'gain_percentage'
+ _attributes['return1w'] = 'return1w'
+ _attributes['return4w'] = 'return4w'
+ _attributes['return3m'] = 'return3m'
+ _attributes['returnYTD'] = 'returnYTD'
+ _attributes['return1y'] = 'return1y'
+ _attributes['return3y'] = 'return3y'
+ _attributes['return5y'] = 'return5y'
+ _attributes['returnOverall'] = 'return_overall'
+ _attributes['shares'] = 'shares'
+ _children = atom.AtomBase._children.copy()
+ _children['{%s}costBasis' % GF_NAMESPACE] = ('cost_basis', CostBasis)
+ _children['{%s}daysGain' % GF_NAMESPACE] = ('days_gain', DaysGain)
+ _children['{%s}gain' % GF_NAMESPACE] = ('gain', Gain)
+ _children['{%s}marketValue' % GF_NAMESPACE] = ('market_value', MarketValue)
+
+ def __init__(self, gain_percentage=None,
+ return1w=None, return4w=None, return3m=None, returnYTD=None,
+ return1y=None, return3y=None, return5y=None, return_overall=None,
+ shares=None, cost_basis=None, days_gain=None,
+ gain=None, market_value=None, **kwargs):
+ self.gain_percentage = gain_percentage
+ self.return1w = return1w
+ self.return4w = return4w
+ self.return3m = return3m
+ self.returnYTD = returnYTD
+ self.return1y = return1y
+ self.return3y = return3y
+ self.return5y = return5y
+ self.return_overall = return_overall
+ self.shares = shares
+ self.cost_basis = cost_basis
+ self.days_gain = days_gain
+ self.gain = gain
+ self.market_value = market_value
+ atom.AtomBase.__init__(self, **kwargs)
+
+
+def PositionDataFromString(xml_string):
+ return atom.CreateClassFromXMLString(PositionData, xml_string)
+
+
+class PositionEntry(gdata.GDataEntry):
+ """An entry of the position feed.
+
+ A PositionEntry contains the ticker exchange and Symbol for a stock,
+ mutual fund, or other security, along with PositionData such as the
+ number of units of that security that the user holds, and performance
+ statistics.
+ """
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _children['{%s}positionData' % GF_NAMESPACE] = (
+ 'position_data', PositionData)
+ _children['{%s}symbol' % GF_NAMESPACE] = ('symbol', Symbol)
+ _children['{%s}feedLink' % GD_NAMESPACE] = (
+ 'feed_link', TransactionFeedLink)
+
+ def __init__(self, position_data=None, symbol=None, feed_link=None,
+ **kwargs):
+ self.position_data = position_data
+ self.symbol = symbol
+ self.feed_link = feed_link
+ gdata.GDataEntry.__init__(self, **kwargs)
+
+ def position_title(self):
+ return self.title.text
+
+ position_title = property(position_title,
+ doc='The position title as a string (i.e. position.title.text).')
+
+ def ticker_id(self):
+ return self.id.text.split("/")[-1]
+
+ ticker_id = property(ticker_id, doc='The position TICKER ID.')
+
+ def transactions(self):
+ if self.feed_link.feed:
+ return self.feed_link.feed.entry
+ else:
+ return None
+
+ transactions = property(transactions, doc="""
+ Inlined TransactionEntries are returned if PositionFeed is queried
+ with transactions='true'.""")
+
+
+def PositionEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(PositionEntry, xml_string)
+
+
+class PositionFeed(gdata.GDataFeed):
+ """A feed that lists all of the positions in a particular portfolio.
+
+ A position is a collection of information about a security that the
+ user holds. The PositionFeed lists all of the positions in a particular
+ portfolio as a list of PositionEntries.
+ """
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [PositionEntry])
+
+
+def PositionFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(PositionFeed, xml_string)
+
+
+class PositionFeedLink(atom.AtomBase):
+ """Link to PositionFeed embedded in PortfolioEntry.
+
+ If a PortfolioFeed is queried with positions='true', the PositionFeeds
+ are inlined in the returned PortfolioEntries. These PositionFeeds are
+ accessible via PositionFeedLink's feed attribute.
+ """
+ _tag = 'feedLink'
+ _namespace = GD_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['href'] = 'href'
+ _children = atom.AtomBase._children.copy()
+ _children['{%s}feed' % atom.ATOM_NAMESPACE] = (
+ 'feed', PositionFeed)
+
+ def __init__(self, href=None, feed=None, **kwargs):
+ self.href = href
+ self.feed = feed
+ atom.AtomBase.__init__(self, **kwargs)
+
+
+class PortfolioData(atom.AtomBase):
+ """The <gf:portfolioData> element."""
+ _tag = 'portfolioData'
+ _namespace = GF_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['currencyCode'] = 'currency_code'
+ _attributes['gainPercentage'] = 'gain_percentage'
+ _attributes['return1w'] = 'return1w'
+ _attributes['return4w'] = 'return4w'
+ _attributes['return3m'] = 'return3m'
+ _attributes['returnYTD'] = 'returnYTD'
+ _attributes['return1y'] = 'return1y'
+ _attributes['return3y'] = 'return3y'
+ _attributes['return5y'] = 'return5y'
+ _attributes['returnOverall'] = 'return_overall'
+ _children = atom.AtomBase._children.copy()
+ _children['{%s}costBasis' % GF_NAMESPACE] = ('cost_basis', CostBasis)
+ _children['{%s}daysGain' % GF_NAMESPACE] = ('days_gain', DaysGain)
+ _children['{%s}gain' % GF_NAMESPACE] = ('gain', Gain)
+ _children['{%s}marketValue' % GF_NAMESPACE] = ('market_value', MarketValue)
+
+ def __init__(self, currency_code=None, gain_percentage=None,
+ return1w=None, return4w=None, return3m=None, returnYTD=None,
+ return1y=None, return3y=None, return5y=None, return_overall=None,
+ cost_basis=None, days_gain=None, gain=None, market_value=None, **kwargs):
+ self.currency_code = currency_code
+ self.gain_percentage = gain_percentage
+ self.return1w = return1w
+ self.return4w = return4w
+ self.return3m = return3m
+ self.returnYTD = returnYTD
+ self.return1y = return1y
+ self.return3y = return3y
+ self.return5y = return5y
+ self.return_overall = return_overall
+ self.cost_basis = cost_basis
+ self.days_gain = days_gain
+ self.gain = gain
+ self.market_value = market_value
+ atom.AtomBase.__init__(self, **kwargs)
+
+
+def PortfolioDataFromString(xml_string):
+ return atom.CreateClassFromXMLString(PortfolioData, xml_string)
+
+
+class PortfolioEntry(gdata.GDataEntry):
+ """An entry of the PortfolioFeed.
+
+ A PortfolioEntry contains the portfolio's title along with PortfolioData
+ such as currency, total market value, and overall performance statistics.
+ """
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _children['{%s}portfolioData' % GF_NAMESPACE] = (
+ 'portfolio_data', PortfolioData)
+ _children['{%s}feedLink' % GD_NAMESPACE] = (
+ 'feed_link', PositionFeedLink)
+
+ def __init__(self, portfolio_data=None, feed_link=None, **kwargs):
+ self.portfolio_data = portfolio_data
+ self.feed_link = feed_link
+ gdata.GDataEntry.__init__(self, **kwargs)
+
+ def portfolio_title(self):
+ return self.title.text
+
+ def set_portfolio_title(self, portfolio_title):
+ self.title = atom.Title(text=portfolio_title, title_type='text')
+
+ portfolio_title = property(portfolio_title, set_portfolio_title,
+ doc='The portfolio title as a string (i.e. portfolio.title.text).')
+
+ def portfolio_id(self):
+ return self.id.text.split("/")[-1]
+
+ portfolio_id = property(portfolio_id,
+ doc='The portfolio ID. Do not confuse with portfolio.id.')
+
+ def positions(self):
+ if self.feed_link.feed:
+ return self.feed_link.feed.entry
+ else:
+ return None
+
+ positions = property(positions, doc="""
+ Inlined PositionEntries are returned if PortfolioFeed was queried
+ with positions='true'.""")
+
+
+def PortfolioEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(PortfolioEntry, xml_string)
+
+
+class PortfolioFeed(gdata.GDataFeed):
+ """A feed that lists all of the user's portfolios.
+
+ A portfolio is a collection of positions that the user holds in various
+ securities, plus metadata. The PortfolioFeed lists all of the user's
+ portfolios as a list of PortfolioEntries.
+ """
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [PortfolioEntry])
+
+
+def PortfolioFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(PortfolioFeed, xml_string)
+
+
diff --git a/src/gdata/finance/data.py b/src/gdata/finance/data.py
new file mode 100644
index 0000000..5e0caa8
--- /dev/null
+++ b/src/gdata/finance/data.py
@@ -0,0 +1,156 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains the data classes of the Google Finance Portfolio Data API"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+import atom.data
+import gdata.data
+import gdata.opensearch.data
+
+
+GF_TEMPLATE = '{http://schemas.google.com/finance/2007/}%s'
+
+
+class Commission(atom.core.XmlElement):
+ """Commission for the transaction"""
+ _qname = GF_TEMPLATE % 'commission'
+ money = [gdata.data.Money]
+
+
+class CostBasis(atom.core.XmlElement):
+ """Cost basis for the portfolio or position"""
+ _qname = GF_TEMPLATE % 'costBasis'
+ money = [gdata.data.Money]
+
+
+class DaysGain(atom.core.XmlElement):
+ """Today's gain for the portfolio or position"""
+ _qname = GF_TEMPLATE % 'daysGain'
+ money = [gdata.data.Money]
+
+
+class Gain(atom.core.XmlElement):
+ """Total gain for the portfolio or position"""
+ _qname = GF_TEMPLATE % 'gain'
+ money = [gdata.data.Money]
+
+
+class MarketValue(atom.core.XmlElement):
+ """Market value for the portfolio or position"""
+ _qname = GF_TEMPLATE % 'marketValue'
+ money = [gdata.data.Money]
+
+
+class PortfolioData(atom.core.XmlElement):
+ """Data for the portfolio"""
+ _qname = GF_TEMPLATE % 'portfolioData'
+ return_overall = 'returnOverall'
+ currency_code = 'currencyCode'
+ return3y = 'return3y'
+ return4w = 'return4w'
+ market_value = MarketValue
+ return_y_t_d = 'returnYTD'
+ cost_basis = CostBasis
+ gain_percentage = 'gainPercentage'
+ days_gain = DaysGain
+ return3m = 'return3m'
+ return5y = 'return5y'
+ return1w = 'return1w'
+ gain = Gain
+ return1y = 'return1y'
+
+
+class PortfolioEntry(gdata.data.GDEntry):
+ """Describes an entry in a feed of Finance portfolios"""
+ portfolio_data = PortfolioData
+
+
+class PortfolioFeed(gdata.data.GDFeed):
+ """Describes a Finance portfolio feed"""
+ entry = [PortfolioEntry]
+
+
+class PositionData(atom.core.XmlElement):
+ """Data for the position"""
+ _qname = GF_TEMPLATE % 'positionData'
+ return_y_t_d = 'returnYTD'
+ return5y = 'return5y'
+ return_overall = 'returnOverall'
+ cost_basis = CostBasis
+ return3y = 'return3y'
+ return1y = 'return1y'
+ return4w = 'return4w'
+ shares = 'shares'
+ days_gain = DaysGain
+ gain_percentage = 'gainPercentage'
+ market_value = MarketValue
+ gain = Gain
+ return3m = 'return3m'
+ return1w = 'return1w'
+
+
+class Price(atom.core.XmlElement):
+ """Price of the transaction"""
+ _qname = GF_TEMPLATE % 'price'
+ money = [gdata.data.Money]
+
+
+class Symbol(atom.core.XmlElement):
+ """Stock symbol for the company"""
+ _qname = GF_TEMPLATE % 'symbol'
+ symbol = 'symbol'
+ exchange = 'exchange'
+ full_name = 'fullName'
+
+
+class PositionEntry(gdata.data.GDEntry):
+ """Describes an entry in a feed of Finance positions"""
+ symbol = Symbol
+ position_data = PositionData
+
+
+class PositionFeed(gdata.data.GDFeed):
+ """Describes a Finance position feed"""
+ entry = [PositionEntry]
+
+
+class TransactionData(atom.core.XmlElement):
+ """Data for the transction"""
+ _qname = GF_TEMPLATE % 'transactionData'
+ shares = 'shares'
+ notes = 'notes'
+ date = 'date'
+ type = 'type'
+ commission = Commission
+ price = Price
+
+
+class TransactionEntry(gdata.data.GDEntry):
+ """Describes an entry in a feed of Finance transactions"""
+ transaction_data = TransactionData
+
+
+class TransactionFeed(gdata.data.GDFeed):
+ """Describes a Finance transaction feed"""
+ entry = [TransactionEntry]
+
+
diff --git a/src/gdata/finance/service.py b/src/gdata/finance/service.py
new file mode 100644
index 0000000..6e3eb86
--- /dev/null
+++ b/src/gdata/finance/service.py
@@ -0,0 +1,243 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Tan Swee Heng
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Classes to interact with the Google Finance server."""
+
+
+__author__ = 'thesweeheng@gmail.com'
+
+
+import gdata.service
+import gdata.finance
+import atom
+
+
+class PortfolioQuery(gdata.service.Query):
+ """A query object for the list of a user's portfolios."""
+
+ def returns(self):
+ return self.get('returns', False)
+
+ def set_returns(self, value):
+ if value is 'true' or value is True:
+ self['returns'] = 'true'
+
+ returns = property(returns, set_returns, doc="The returns query parameter")
+
+ def positions(self):
+ return self.get('positions', False)
+
+ def set_positions(self, value):
+ if value is 'true' or value is True:
+ self['positions'] = 'true'
+
+ positions = property(positions, set_positions,
+ doc="The positions query parameter")
+
+
+class PositionQuery(gdata.service.Query):
+ """A query object for the list of a user's positions in a portfolio."""
+
+ def returns(self):
+ return self.get('returns', False)
+
+ def set_returns(self, value):
+ if value is 'true' or value is True:
+ self['returns'] = 'true'
+
+ returns = property(returns, set_returns,
+ doc="The returns query parameter")
+
+ def transactions(self):
+ return self.get('transactions', False)
+
+ def set_transactions(self, value):
+ if value is 'true' or value is True:
+ self['transactions'] = 'true'
+
+ transactions = property(transactions, set_transactions,
+ doc="The transactions query parameter")
+
+
+class FinanceService(gdata.service.GDataService):
+
+ def __init__(self, email=None, password=None, source=None,
+ server='finance.google.com', **kwargs):
+ """Creates a client for the Finance service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'finance.google.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ gdata.service.GDataService.__init__(self,
+ email=email, password=password, service='finance', server=server,
+ **kwargs)
+
+ def GetPortfolioFeed(self, query=None):
+ uri = '/finance/feeds/default/portfolios'
+ if query:
+ uri = PortfolioQuery(feed=uri, params=query).ToUri()
+ return self.Get(uri, converter=gdata.finance.PortfolioFeedFromString)
+
+ def GetPositionFeed(self, portfolio_entry=None, portfolio_id=None,
+ query=None):
+ """
+ Args:
+ portfolio_entry: PortfolioEntry (optional; see Notes)
+ portfolio_id: string (optional; see Notes) This may be obtained
+ from a PortfolioEntry's portfolio_id attribute.
+ query: PortfolioQuery (optional)
+
+ Notes:
+ Either a PortfolioEntry OR a portfolio ID must be provided.
+ """
+ if portfolio_entry:
+ uri = portfolio_entry.GetSelfLink().href + '/positions'
+ elif portfolio_id:
+ uri = '/finance/feeds/default/portfolios/%s/positions' % portfolio_id
+ if query:
+ uri = PositionQuery(feed=uri, params=query).ToUri()
+ return self.Get(uri, converter=gdata.finance.PositionFeedFromString)
+
+ def GetTransactionFeed(self, position_entry=None,
+ portfolio_id=None, ticker_id=None):
+ """
+ Args:
+ position_entry: PositionEntry (optional; see Notes)
+ portfolio_id: string (optional; see Notes) This may be obtained
+ from a PortfolioEntry's portfolio_id attribute.
+ ticker_id: string (optional; see Notes) This may be obtained from
+ a PositionEntry's ticker_id attribute. Alternatively it can
+ be constructed using the security's exchange and symbol,
+ e.g. 'NASDAQ:GOOG'
+
+ Notes:
+ Either a PositionEntry OR (a portfolio ID AND ticker ID) must
+ be provided.
+ """
+ if position_entry:
+ uri = position_entry.GetSelfLink().href + '/transactions'
+ elif portfolio_id and ticker_id:
+ uri = '/finance/feeds/default/portfolios/%s/positions/%s/transactions' \
+ % (portfolio_id, ticker_id)
+ return self.Get(uri, converter=gdata.finance.TransactionFeedFromString)
+
+ def GetPortfolio(self, portfolio_id=None, query=None):
+ uri = '/finance/feeds/default/portfolios/%s' % portfolio_id
+ if query:
+ uri = PortfolioQuery(feed=uri, params=query).ToUri()
+ return self.Get(uri, converter=gdata.finance.PortfolioEntryFromString)
+
+ def AddPortfolio(self, portfolio_entry=None):
+ uri = '/finance/feeds/default/portfolios'
+ return self.Post(portfolio_entry, uri,
+ converter=gdata.finance.PortfolioEntryFromString)
+
+ def UpdatePortfolio(self, portfolio_entry=None):
+ uri = portfolio_entry.GetEditLink().href
+ return self.Put(portfolio_entry, uri,
+ converter=gdata.finance.PortfolioEntryFromString)
+
+ def DeletePortfolio(self, portfolio_entry=None):
+ uri = portfolio_entry.GetEditLink().href
+ return self.Delete(uri)
+
+ def GetPosition(self, portfolio_id=None, ticker_id=None, query=None):
+ uri = '/finance/feeds/default/portfolios/%s/positions/%s' \
+ % (portfolio_id, ticker_id)
+ if query:
+ uri = PositionQuery(feed=uri, params=query).ToUri()
+ return self.Get(uri, converter=gdata.finance.PositionEntryFromString)
+
+ def DeletePosition(self, position_entry=None,
+ portfolio_id=None, ticker_id=None, transaction_feed=None):
+ """A position is deleted by deleting all its transactions.
+
+ Args:
+ position_entry: PositionEntry (optional; see Notes)
+ portfolio_id: string (optional; see Notes) This may be obtained
+ from a PortfolioEntry's portfolio_id attribute.
+ ticker_id: string (optional; see Notes) This may be obtained from
+ a PositionEntry's ticker_id attribute. Alternatively it can
+ be constructed using the security's exchange and symbol,
+ e.g. 'NASDAQ:GOOG'
+ transaction_feed: TransactionFeed (optional; see Notes)
+
+ Notes:
+ Either a PositionEntry OR (a portfolio ID AND ticker ID) OR
+ a TransactionFeed must be provided.
+ """
+ if transaction_feed:
+ feed = transaction_feed
+ else:
+ if position_entry:
+ feed = self.GetTransactionFeed(position_entry=position_entry)
+ elif portfolio_id and ticker_id:
+ feed = self.GetTransactionFeed(
+ portfolio_id=portfolio_id, ticker_id=ticker_id)
+ for txn in feed.entry:
+ self.DeleteTransaction(txn)
+ return True
+
+ def GetTransaction(self, portfolio_id=None, ticker_id=None,
+ transaction_id=None):
+ uri = '/finance/feeds/default/portfolios/%s/positions/%s/transactions/%s' \
+ % (portfolio_id, ticker_id, transaction_id)
+ return self.Get(uri, converter=gdata.finance.TransactionEntryFromString)
+
+ def AddTransaction(self, transaction_entry=None, transaction_feed = None,
+ position_entry=None, portfolio_id=None, ticker_id=None):
+ """
+ Args:
+ transaction_entry: TransactionEntry (required)
+ transaction_feed: TransactionFeed (optional; see Notes)
+ position_entry: PositionEntry (optional; see Notes)
+ portfolio_id: string (optional; see Notes) This may be obtained
+ from a PortfolioEntry's portfolio_id attribute.
+ ticker_id: string (optional; see Notes) This may be obtained from
+ a PositionEntry's ticker_id attribute. Alternatively it can
+ be constructed using the security's exchange and symbol,
+ e.g. 'NASDAQ:GOOG'
+
+ Notes:
+ Either a TransactionFeed OR a PositionEntry OR (a portfolio ID AND
+ ticker ID) must be provided.
+ """
+ if transaction_feed:
+ uri = transaction_feed.GetPostLink().href
+ elif position_entry:
+ uri = position_entry.GetSelfLink().href + '/transactions'
+ elif portfolio_id and ticker_id:
+ uri = '/finance/feeds/default/portfolios/%s/positions/%s/transactions' \
+ % (portfolio_id, ticker_id)
+ return self.Post(transaction_entry, uri,
+ converter=gdata.finance.TransactionEntryFromString)
+
+ def UpdateTransaction(self, transaction_entry=None):
+ uri = transaction_entry.GetEditLink().href
+ return self.Put(transaction_entry, uri,
+ converter=gdata.finance.TransactionEntryFromString)
+
+ def DeleteTransaction(self, transaction_entry=None):
+ uri = transaction_entry.GetEditLink().href
+ return self.Delete(uri)
diff --git a/src/gdata/gauth.py b/src/gdata/gauth.py
new file mode 100644
index 0000000..01d4d13
--- /dev/null
+++ b/src/gdata/gauth.py
@@ -0,0 +1,1726 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+"""Provides auth related token classes and functions for Google Data APIs.
+
+Token classes represent a user's authorization of this app to access their
+data. Usually these are not created directly but by a GDClient object.
+
+ClientLoginToken
+AuthSubToken
+SecureAuthSubToken
+OAuthHmacToken
+OAuthRsaToken
+TwoLeggedOAuthHmacToken
+TwoLeggedOAuthRsaToken
+
+Functions which are often used in application code (as opposed to just within
+the gdata-python-client library) are the following:
+
+generate_auth_sub_url
+authorize_request_token
+
+The following are helper functions which are used to save and load auth token
+objects in the App Engine datastore. These should only be used if you are using
+this library within App Engine:
+
+ae_load
+ae_save
+"""
+
+
+import datetime
+import time
+import random
+import urllib
+import urlparse
+import atom.http_core
+
+try:
+ import simplejson
+ from simplejson.decoder import JSONDecodeError
+except ImportError:
+ JSONDecodeError = None
+ try:
+ # Try to import from django, should work on App Engine
+ from django.utils import simplejson
+ except ImportError:
+ # Should work for Python2.6 and higher.
+ import json as simplejson
+
+try:
+ from urlparse import parse_qsl
+except ImportError:
+ from cgi import parse_qsl
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+PROGRAMMATIC_AUTH_LABEL = 'GoogleLogin auth='
+AUTHSUB_AUTH_LABEL = 'AuthSub token='
+OAUTH2_AUTH_LABEL = 'Bearer '
+
+
+# This dict provides the AuthSub and OAuth scopes for all services by service
+# name. The service name (key) is used in ClientLogin requests.
+AUTH_SCOPES = {
+ 'cl': ( # Google Calendar API
+ 'https://www.google.com/calendar/feeds/',
+ 'http://www.google.com/calendar/feeds/'),
+ 'gbase': ( # Google Base API
+ 'http://base.google.com/base/feeds/',
+ 'http://www.google.com/base/feeds/'),
+ 'blogger': ( # Blogger API
+ 'http://www.blogger.com/feeds/',),
+ 'codesearch': ( # Google Code Search API
+ 'http://www.google.com/codesearch/feeds/',),
+ 'cp': ( # Contacts API
+ 'https://www.google.com/m8/feeds/',
+ 'http://www.google.com/m8/feeds/'),
+ 'finance': ( # Google Finance API
+ 'http://finance.google.com/finance/feeds/',),
+ 'health': ( # Google Health API
+ 'https://www.google.com/health/feeds/',),
+ 'writely': ( # Documents List API
+ 'https://docs.google.com/feeds/',
+ 'https://spreadsheets.google.com/feeds/',
+ 'https://docs.googleusercontent.com/'),
+ 'lh2': ( # Picasa Web Albums API
+ 'http://picasaweb.google.com/data/',),
+ 'apps': ( # Google Apps Domain Info & Management APIs
+ 'https://apps-apis.google.com/a/feeds/user/',
+ 'https://apps-apis.google.com/a/feeds/policies/',
+ 'https://apps-apis.google.com/a/feeds/alias/',
+ 'https://apps-apis.google.com/a/feeds/groups/',
+ 'https://apps-apis.google.com/a/feeds/compliance/audit/',
+ 'https://apps-apis.google.com/a/feeds/migration/',
+ 'https://apps-apis.google.com/a/feeds/emailsettings/2.0/'),
+ 'weaver': ( # Health H9 Sandbox
+ 'https://www.google.com/h9/feeds/',),
+ 'wise': ( # Spreadsheets Data API
+ 'https://spreadsheets.google.com/feeds/',),
+ 'sitemaps': ( # Google Webmaster Tools API
+ 'https://www.google.com/webmasters/tools/feeds/',),
+ 'youtube': ( # YouTube API
+ 'http://gdata.youtube.com/feeds/api/',
+ 'http://uploads.gdata.youtube.com/feeds/api',
+ 'http://gdata.youtube.com/action/GetUploadToken'),
+ 'books': ( # Google Books API
+ 'http://www.google.com/books/feeds/',),
+ 'analytics': ( # Google Analytics API
+ 'https://www.google.com/analytics/feeds/',),
+ 'jotspot': ( # Google Sites API
+ 'http://sites.google.com/feeds/',
+ 'https://sites.google.com/feeds/'),
+ 'local': ( # Google Maps Data API
+ 'http://maps.google.com/maps/feeds/',),
+ 'code': ( # Project Hosting Data API
+ 'http://code.google.com/feeds/issues',)}
+
+
+
+class Error(Exception):
+ pass
+
+
+class UnsupportedTokenType(Error):
+ """Raised when token to or from blob is unable to convert the token."""
+ pass
+
+
+class OAuth2AccessTokenError(Error):
+ """Raised when an OAuth2 error occurs."""
+ def __init__(self, error_message):
+ self.error_message = error_message
+
+
+class OAuth2RevokeError(Error):
+ """Raised when an OAuth2 token revocation was unsuccessful."""
+
+ def __init__(self, http_response, response_body=None):
+ """Sets the HTTP information in the error.
+
+ Args:
+ http_response: The response from the server, contains error information.
+ response_body: string (optional) specified if the response has already
+ been read from the http_response object.
+ """
+ body = response_body or http_response.read()
+
+ self.status = http_response.status
+ self.reason = http_response.reason
+ self.body = body
+ self.headers = atom.http_core.get_headers(http_response)
+
+ self.error_msg = 'Invalid response %s.' % self.status
+ try:
+ json_from_body = simplejson.loads(body)
+ if isinstance(json_from_body, dict):
+ self.error_msg = json_from_body.get('error', self.error_msg)
+ except (ValueError, JSONDecodeError):
+ pass
+
+ def __str__(self):
+ return 'OAuth2RevokeError(status=%i, error=%s)' % (self.status,
+ self.error_msg)
+
+
+# ClientLogin functions and classes.
+def generate_client_login_request_body(email, password, service, source,
+ account_type='HOSTED_OR_GOOGLE', captcha_token=None,
+ captcha_response=None):
+ """Creates the body of the autentication request
+
+ See http://code.google.com/apis/accounts/AuthForInstalledApps.html#Request
+ for more details.
+
+ Args:
+ email: str
+ password: str
+ service: str
+ source: str
+ account_type: str (optional) Defaul is 'HOSTED_OR_GOOGLE', other valid
+ values are 'GOOGLE' and 'HOSTED'
+ captcha_token: str (optional)
+ captcha_response: str (optional)
+
+ Returns:
+ The HTTP body to send in a request for a client login token.
+ """
+ # Create a POST body containing the user's credentials.
+ request_fields = {'Email': email,
+ 'Passwd': password,
+ 'accountType': account_type,
+ 'service': service,
+ 'source': source}
+ if captcha_token and captcha_response:
+ # Send the captcha token and response as part of the POST body if the
+ # user is responding to a captch challenge.
+ request_fields['logintoken'] = captcha_token
+ request_fields['logincaptcha'] = captcha_response
+ return urllib.urlencode(request_fields)
+
+
+GenerateClientLoginRequestBody = generate_client_login_request_body
+
+
+def get_client_login_token_string(http_body):
+ """Returns the token value for a ClientLoginToken.
+
+ Reads the token from the server's response to a Client Login request and
+ creates the token value string to use in requests.
+
+ Args:
+ http_body: str The body of the server's HTTP response to a Client Login
+ request
+
+ Returns:
+ The token value string for a ClientLoginToken.
+ """
+ for response_line in http_body.splitlines():
+ if response_line.startswith('Auth='):
+ # Strip off the leading Auth= and return the Authorization value.
+ return response_line[5:]
+ return None
+
+
+GetClientLoginTokenString = get_client_login_token_string
+
+
+def get_captcha_challenge(http_body,
+ captcha_base_url='http://www.google.com/accounts/'):
+ """Returns the URL and token for a CAPTCHA challenge issued by the server.
+
+ Args:
+ http_body: str The body of the HTTP response from the server which
+ contains the CAPTCHA challenge.
+ captcha_base_url: str This function returns a full URL for viewing the
+ challenge image which is built from the server's response. This
+ base_url is used as the beginning of the URL because the server
+ only provides the end of the URL. For example the server provides
+ 'Captcha?ctoken=Hi...N' and the URL for the image is
+ 'http://www.google.com/accounts/Captcha?ctoken=Hi...N'
+
+ Returns:
+ A dictionary containing the information needed to repond to the CAPTCHA
+ challenge, the image URL and the ID token of the challenge. The
+ dictionary is in the form:
+ {'token': string identifying the CAPTCHA image,
+ 'url': string containing the URL of the image}
+ Returns None if there was no CAPTCHA challenge in the response.
+ """
+ contains_captcha_challenge = False
+ captcha_parameters = {}
+ for response_line in http_body.splitlines():
+ if response_line.startswith('Error=CaptchaRequired'):
+ contains_captcha_challenge = True
+ elif response_line.startswith('CaptchaToken='):
+ # Strip off the leading CaptchaToken=
+ captcha_parameters['token'] = response_line[13:]
+ elif response_line.startswith('CaptchaUrl='):
+ captcha_parameters['url'] = '%s%s' % (captcha_base_url,
+ response_line[11:])
+ if contains_captcha_challenge:
+ return captcha_parameters
+ else:
+ return None
+
+
+GetCaptchaChallenge = get_captcha_challenge
+
+
+class ClientLoginToken(object):
+
+ def __init__(self, token_string):
+ self.token_string = token_string
+
+ def modify_request(self, http_request):
+ http_request.headers['Authorization'] = '%s%s' % (PROGRAMMATIC_AUTH_LABEL,
+ self.token_string)
+
+ ModifyRequest = modify_request
+
+
+# AuthSub functions and classes.
+def _to_uri(str_or_uri):
+ if isinstance(str_or_uri, (str, unicode)):
+ return atom.http_core.Uri.parse_uri(str_or_uri)
+ return str_or_uri
+
+
+def generate_auth_sub_url(next, scopes, secure=False, session=True,
+ request_url=atom.http_core.parse_uri(
+ 'https://www.google.com/accounts/AuthSubRequest'),
+ domain='default', scopes_param_prefix='auth_sub_scopes'):
+ """Constructs a URI for requesting a multiscope AuthSub token.
+
+ The generated token will contain a URL parameter to pass along the
+ requested scopes to the next URL. When the Google Accounts page
+ redirects the broswser to the 'next' URL, it appends the single use
+ AuthSub token value to the URL as a URL parameter with the key 'token'.
+ However, the information about which scopes were requested is not
+ included by Google Accounts. This method adds the scopes to the next
+ URL before making the request so that the redirect will be sent to
+ a page, and both the token value and the list of scopes for which the token
+ was requested.
+
+ Args:
+ next: atom.http_core.Uri or string The URL user will be sent to after
+ authorizing this web application to access their data.
+ scopes: list containint strings or atom.http_core.Uri objects. The URLs
+ of the services to be accessed. Could also be a single string
+ or single atom.http_core.Uri for requesting just one scope.
+ secure: boolean (optional) Determines whether or not the issued token
+ is a secure token.
+ session: boolean (optional) Determines whether or not the issued token
+ can be upgraded to a session token.
+ request_url: atom.http_core.Uri or str The beginning of the request URL.
+ This is normally
+ 'http://www.google.com/accounts/AuthSubRequest' or
+ '/accounts/AuthSubRequest'
+ domain: The domain which the account is part of. This is used for Google
+ Apps accounts, the default value is 'default' which means that
+ the requested account is a Google Account (@gmail.com for
+ example)
+ scopes_param_prefix: str (optional) The requested scopes are added as a
+ URL parameter to the next URL so that the page at
+ the 'next' URL can extract the token value and the
+ valid scopes from the URL. The key for the URL
+ parameter defaults to 'auth_sub_scopes'
+
+ Returns:
+ An atom.http_core.Uri which the user's browser should be directed to in
+ order to authorize this application to access their information.
+ """
+ if isinstance(next, (str, unicode)):
+ next = atom.http_core.Uri.parse_uri(next)
+ # If the user passed in a string instead of a list for scopes, convert to
+ # a single item tuple.
+ if isinstance(scopes, (str, unicode, atom.http_core.Uri)):
+ scopes = (scopes,)
+ scopes_string = ' '.join([str(scope) for scope in scopes])
+ next.query[scopes_param_prefix] = scopes_string
+
+ if isinstance(request_url, (str, unicode)):
+ request_url = atom.http_core.Uri.parse_uri(request_url)
+ request_url.query['next'] = str(next)
+ request_url.query['scope'] = scopes_string
+ if session:
+ request_url.query['session'] = '1'
+ else:
+ request_url.query['session'] = '0'
+ if secure:
+ request_url.query['secure'] = '1'
+ else:
+ request_url.query['secure'] = '0'
+ request_url.query['hd'] = domain
+ return request_url
+
+
+def auth_sub_string_from_url(url, scopes_param_prefix='auth_sub_scopes'):
+ """Finds the token string (and scopes) after the browser is redirected.
+
+ After the Google Accounts AuthSub pages redirect the user's broswer back to
+ the web application (using the 'next' URL from the request) the web app must
+ extract the token from the current page's URL. The token is provided as a
+ URL parameter named 'token' and if generate_auth_sub_url was used to create
+ the request, the token's valid scopes are included in a URL parameter whose
+ name is specified in scopes_param_prefix.
+
+ Args:
+ url: atom.url.Url or str representing the current URL. The token value
+ and valid scopes should be included as URL parameters.
+ scopes_param_prefix: str (optional) The URL parameter key which maps to
+ the list of valid scopes for the token.
+
+ Returns:
+ A tuple containing the token value as a string, and a tuple of scopes
+ (as atom.http_core.Uri objects) which are URL prefixes under which this
+ token grants permission to read and write user data.
+ (token_string, (scope_uri, scope_uri, scope_uri, ...))
+ If no scopes were included in the URL, the second value in the tuple is
+ None. If there was no token param in the url, the tuple returned is
+ (None, None)
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.http_core.Uri.parse_uri(url)
+ if 'token' not in url.query:
+ return (None, None)
+ token = url.query['token']
+ # TODO: decide whether no scopes should be None or ().
+ scopes = None # Default to None for no scopes.
+ if scopes_param_prefix in url.query:
+ scopes = tuple(url.query[scopes_param_prefix].split(' '))
+ return (token, scopes)
+
+
+AuthSubStringFromUrl = auth_sub_string_from_url
+
+
+def auth_sub_string_from_body(http_body):
+ """Extracts the AuthSub token from an HTTP body string.
+
+ Used to find the new session token after making a request to upgrade a
+ single use AuthSub token.
+
+ Args:
+ http_body: str The repsonse from the server which contains the AuthSub
+ key. For example, this function would find the new session token
+ from the server's response to an upgrade token request.
+
+ Returns:
+ The raw token value string to use in an AuthSubToken object.
+ """
+ for response_line in http_body.splitlines():
+ if response_line.startswith('Token='):
+ # Strip off Token= and return the token value string.
+ return response_line[6:]
+ return None
+
+
+class AuthSubToken(object):
+
+ def __init__(self, token_string, scopes=None):
+ self.token_string = token_string
+ self.scopes = scopes or []
+
+ def modify_request(self, http_request):
+ """Sets Authorization header, allows app to act on the user's behalf."""
+ http_request.headers['Authorization'] = '%s%s' % (AUTHSUB_AUTH_LABEL,
+ self.token_string)
+
+ ModifyRequest = modify_request
+
+ def from_url(str_or_uri):
+ """Creates a new AuthSubToken using information in the URL.
+
+ Uses auth_sub_string_from_url.
+
+ Args:
+ str_or_uri: The current page's URL (as a str or atom.http_core.Uri)
+ which should contain a token query parameter since the
+ Google auth server redirected the user's browser to this
+ URL.
+ """
+ token_and_scopes = auth_sub_string_from_url(str_or_uri)
+ return AuthSubToken(token_and_scopes[0], token_and_scopes[1])
+
+ from_url = staticmethod(from_url)
+ FromUrl = from_url
+
+ def _upgrade_token(self, http_body):
+ """Replaces the token value with a session token from the auth server.
+
+ Uses the response of a token upgrade request to modify this token. Uses
+ auth_sub_string_from_body.
+ """
+ self.token_string = auth_sub_string_from_body(http_body)
+
+
+# Functions and classes for Secure-mode AuthSub
+def build_auth_sub_data(http_request, timestamp, nonce):
+ """Creates the data string which must be RSA-signed in secure requests.
+
+ For more details see the documenation on secure AuthSub requests:
+ http://code.google.com/apis/accounts/docs/AuthSub.html#signingrequests
+
+ Args:
+ http_request: The request being made to the server. The Request's URL
+ must be complete before this signature is calculated as any changes
+ to the URL will invalidate the signature.
+ nonce: str Random 64-bit, unsigned number encoded as an ASCII string in
+ decimal format. The nonce/timestamp pair should always be unique to
+ prevent replay attacks.
+ timestamp: Integer representing the time the request is sent. The
+ timestamp should be expressed in number of seconds after January 1,
+ 1970 00:00:00 GMT.
+ """
+ return '%s %s %s %s' % (http_request.method, str(http_request.uri),
+ str(timestamp), nonce)
+
+
+def generate_signature(data, rsa_key):
+ """Signs the data string for a secure AuthSub request."""
+ import base64
+ try:
+ from tlslite.utils import keyfactory
+ except ImportError:
+ try:
+ from gdata.tlslite.utils import keyfactory
+ except ImportError:
+ from tlslite.tlslite.utils import keyfactory
+
+ private_key = keyfactory.parsePrivateKey(rsa_key)
+ signed = private_key.hashAndSign(data)
+ # Python2.3 and lower does not have the base64.b64encode function.
+ if hasattr(base64, 'b64encode'):
+ return base64.b64encode(signed)
+ else:
+ return base64.encodestring(signed).replace('\n', '')
+
+
+class SecureAuthSubToken(AuthSubToken):
+
+ def __init__(self, token_string, rsa_private_key, scopes=None):
+ self.token_string = token_string
+ self.scopes = scopes or []
+ self.rsa_private_key = rsa_private_key
+
+ def from_url(str_or_uri, rsa_private_key):
+ """Creates a new SecureAuthSubToken using information in the URL.
+
+ Uses auth_sub_string_from_url.
+
+ Args:
+ str_or_uri: The current page's URL (as a str or atom.http_core.Uri)
+ which should contain a token query parameter since the Google auth
+ server redirected the user's browser to this URL.
+ rsa_private_key: str the private RSA key cert used to sign all requests
+ made with this token.
+ """
+ token_and_scopes = auth_sub_string_from_url(str_or_uri)
+ return SecureAuthSubToken(token_and_scopes[0], rsa_private_key,
+ token_and_scopes[1])
+
+ from_url = staticmethod(from_url)
+ FromUrl = from_url
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header and includes a digital signature.
+
+ Calculates a digital signature using the private RSA key, a timestamp
+ (uses now at the time this method is called) and a random nonce.
+
+ Args:
+ http_request: The atom.http_core.HttpRequest which contains all of the
+ information needed to send a request to the remote server. The
+ URL and the method of the request must be already set and cannot be
+ changed after this token signs the request, or the signature will
+ not be valid.
+ """
+ timestamp = str(int(time.time()))
+ nonce = ''.join([str(random.randint(0, 9)) for i in xrange(15)])
+ data = build_auth_sub_data(http_request, timestamp, nonce)
+ signature = generate_signature(data, self.rsa_private_key)
+ http_request.headers['Authorization'] = (
+ '%s%s sigalg="rsa-sha1" data="%s" sig="%s"' % (AUTHSUB_AUTH_LABEL,
+ self.token_string, data, signature))
+
+ ModifyRequest = modify_request
+
+
+# OAuth functions and classes.
+RSA_SHA1 = 'RSA-SHA1'
+HMAC_SHA1 = 'HMAC-SHA1'
+
+
+def build_oauth_base_string(http_request, consumer_key, nonce, signaure_type,
+ timestamp, version, next='oob', token=None,
+ verifier=None):
+ """Generates the base string to be signed in the OAuth request.
+
+ Args:
+ http_request: The request being made to the server. The Request's URL
+ must be complete before this signature is calculated as any changes
+ to the URL will invalidate the signature.
+ consumer_key: Domain identifying the third-party web application. This is
+ the domain used when registering the application with Google. It
+ identifies who is making the request on behalf of the user.
+ nonce: Random 64-bit, unsigned number encoded as an ASCII string in decimal
+ format. The nonce/timestamp pair should always be unique to prevent
+ replay attacks.
+ signaure_type: either RSA_SHA1 or HMAC_SHA1
+ timestamp: Integer representing the time the request is sent. The
+ timestamp should be expressed in number of seconds after January 1,
+ 1970 00:00:00 GMT.
+ version: The OAuth version used by the requesting web application. This
+ value must be '1.0' or '1.0a'. If not provided, Google assumes version
+ 1.0 is in use.
+ next: The URL the user should be redirected to after granting access
+ to a Google service(s). It can include url-encoded query parameters.
+ The default value is 'oob'. (This is the oauth_callback.)
+ token: The string for the OAuth request token or OAuth access token.
+ verifier: str Sent as the oauth_verifier and required when upgrading a
+ request token to an access token.
+ """
+ # First we must build the canonical base string for the request.
+ params = http_request.uri.query.copy()
+ params['oauth_consumer_key'] = consumer_key
+ params['oauth_nonce'] = nonce
+ params['oauth_signature_method'] = signaure_type
+ params['oauth_timestamp'] = str(timestamp)
+ if next is not None:
+ params['oauth_callback'] = str(next)
+ if token is not None:
+ params['oauth_token'] = token
+ if version is not None:
+ params['oauth_version'] = version
+ if verifier is not None:
+ params['oauth_verifier'] = verifier
+ # We need to get the key value pairs in lexigraphically sorted order.
+ sorted_keys = None
+ try:
+ sorted_keys = sorted(params.keys())
+ # The sorted function is not available in Python2.3 and lower
+ except NameError:
+ sorted_keys = params.keys()
+ sorted_keys.sort()
+ pairs = []
+ for key in sorted_keys:
+ pairs.append('%s=%s' % (urllib.quote(key, safe='~'),
+ urllib.quote(params[key], safe='~')))
+ # We want to escape /'s too, so use safe='~'
+ all_parameters = urllib.quote('&'.join(pairs), safe='~')
+ normailzed_host = http_request.uri.host.lower()
+ normalized_scheme = (http_request.uri.scheme or 'http').lower()
+ non_default_port = None
+ if (http_request.uri.port is not None
+ and ((normalized_scheme == 'https' and http_request.uri.port != 443)
+ or (normalized_scheme == 'http' and http_request.uri.port != 80))):
+ non_default_port = http_request.uri.port
+ path = http_request.uri.path or '/'
+ request_path = None
+ if not path.startswith('/'):
+ path = '/%s' % path
+ if non_default_port is not None:
+ # Set the only safe char in url encoding to ~ since we want to escape /
+ # as well.
+ request_path = urllib.quote('%s://%s:%s%s' % (
+ normalized_scheme, normailzed_host, non_default_port, path), safe='~')
+ else:
+ # Set the only safe char in url encoding to ~ since we want to escape /
+ # as well.
+ request_path = urllib.quote('%s://%s%s' % (
+ normalized_scheme, normailzed_host, path), safe='~')
+ # TODO: ensure that token escaping logic is correct, not sure if the token
+ # value should be double escaped instead of single.
+ base_string = '&'.join((http_request.method.upper(), request_path,
+ all_parameters))
+ # Now we have the base string, we can calculate the oauth_signature.
+ return base_string
+
+
+def generate_hmac_signature(http_request, consumer_key, consumer_secret,
+ timestamp, nonce, version, next='oob',
+ token=None, token_secret=None, verifier=None):
+ import hmac
+ import base64
+ base_string = build_oauth_base_string(
+ http_request, consumer_key, nonce, HMAC_SHA1, timestamp, version,
+ next, token, verifier=verifier)
+ hash_key = None
+ hashed = None
+ if token_secret is not None:
+ hash_key = '%s&%s' % (urllib.quote(consumer_secret, safe='~'),
+ urllib.quote(token_secret, safe='~'))
+ else:
+ hash_key = '%s&' % urllib.quote(consumer_secret, safe='~')
+ try:
+ import hashlib
+ hashed = hmac.new(hash_key, base_string, hashlib.sha1)
+ except ImportError:
+ import sha
+ hashed = hmac.new(hash_key, base_string, sha)
+ # Python2.3 does not have base64.b64encode.
+ if hasattr(base64, 'b64encode'):
+ return base64.b64encode(hashed.digest())
+ else:
+ return base64.encodestring(hashed.digest()).replace('\n', '')
+
+
+def generate_rsa_signature(http_request, consumer_key, rsa_key,
+ timestamp, nonce, version, next='oob',
+ token=None, token_secret=None, verifier=None):
+ import base64
+ try:
+ from tlslite.utils import keyfactory
+ except ImportError:
+ try:
+ from gdata.tlslite.utils import keyfactory
+ except ImportError:
+ from tlslite.tlslite.utils import keyfactory
+ base_string = build_oauth_base_string(
+ http_request, consumer_key, nonce, RSA_SHA1, timestamp, version,
+ next, token, verifier=verifier)
+ private_key = keyfactory.parsePrivateKey(rsa_key)
+ # Sign using the key
+ signed = private_key.hashAndSign(base_string)
+ # Python2.3 does not have base64.b64encode.
+ if hasattr(base64, 'b64encode'):
+ return base64.b64encode(signed)
+ else:
+ return base64.encodestring(signed).replace('\n', '')
+
+
+def generate_auth_header(consumer_key, timestamp, nonce, signature_type,
+ signature, version='1.0', next=None, token=None,
+ verifier=None):
+ """Builds the Authorization header to be sent in the request.
+
+ Args:
+ consumer_key: Identifies the application making the request (str).
+ timestamp:
+ nonce:
+ signature_type: One of either HMAC_SHA1 or RSA_SHA1
+ signature: The HMAC or RSA signature for the request as a base64
+ encoded string.
+ version: The version of the OAuth protocol that this request is using.
+ Default is '1.0'
+ next: The URL of the page that the user's browser should be sent to
+ after they authorize the token. (Optional)
+ token: str The OAuth token value to be used in the oauth_token parameter
+ of the header.
+ verifier: str The OAuth verifier which must be included when you are
+ upgrading a request token to an access token.
+ """
+ params = {
+ 'oauth_consumer_key': consumer_key,
+ 'oauth_version': version,
+ 'oauth_nonce': nonce,
+ 'oauth_timestamp': str(timestamp),
+ 'oauth_signature_method': signature_type,
+ 'oauth_signature': signature}
+ if next is not None:
+ params['oauth_callback'] = str(next)
+ if token is not None:
+ params['oauth_token'] = token
+ if verifier is not None:
+ params['oauth_verifier'] = verifier
+ pairs = [
+ '%s="%s"' % (
+ k, urllib.quote(v, safe='~')) for k, v in params.iteritems()]
+ return 'OAuth %s' % (', '.join(pairs))
+
+
+REQUEST_TOKEN_URL = 'https://www.google.com/accounts/OAuthGetRequestToken'
+ACCESS_TOKEN_URL = 'https://www.google.com/accounts/OAuthGetAccessToken'
+
+
+def generate_request_for_request_token(
+ consumer_key, signature_type, scopes, rsa_key=None, consumer_secret=None,
+ auth_server_url=REQUEST_TOKEN_URL, next='oob', version='1.0'):
+ """Creates request to be sent to auth server to get an OAuth request token.
+
+ Args:
+ consumer_key:
+ signature_type: either RSA_SHA1 or HMAC_SHA1. The rsa_key must be
+ provided if the signature type is RSA but if the signature method
+ is HMAC, the consumer_secret must be used.
+ scopes: List of URL prefixes for the data which we want to access. For
+ example, to request access to the user's Blogger and Google Calendar
+ data, we would request
+ ['http://www.blogger.com/feeds/',
+ 'https://www.google.com/calendar/feeds/',
+ 'http://www.google.com/calendar/feeds/']
+ rsa_key: Only used if the signature method is RSA_SHA1.
+ consumer_secret: Only used if the signature method is HMAC_SHA1.
+ auth_server_url: The URL to which the token request should be directed.
+ Defaults to 'https://www.google.com/accounts/OAuthGetRequestToken'.
+ next: The URL of the page that the user's browser should be sent to
+ after they authorize the token. (Optional)
+ version: The OAuth version used by the requesting web application.
+ Defaults to '1.0a'
+
+ Returns:
+ An atom.http_core.HttpRequest object with the URL, Authorization header
+ and body filled in.
+ """
+ request = atom.http_core.HttpRequest(auth_server_url, 'POST')
+ # Add the requested auth scopes to the Auth request URL.
+ if scopes:
+ request.uri.query['scope'] = ' '.join(scopes)
+
+ timestamp = str(int(time.time()))
+ nonce = ''.join([str(random.randint(0, 9)) for i in xrange(15)])
+ signature = None
+ if signature_type == HMAC_SHA1:
+ signature = generate_hmac_signature(
+ request, consumer_key, consumer_secret, timestamp, nonce, version,
+ next=next)
+ elif signature_type == RSA_SHA1:
+ signature = generate_rsa_signature(
+ request, consumer_key, rsa_key, timestamp, nonce, version, next=next)
+ else:
+ return None
+
+ request.headers['Authorization'] = generate_auth_header(
+ consumer_key, timestamp, nonce, signature_type, signature, version,
+ next)
+ request.headers['Content-Length'] = '0'
+ return request
+
+
+def generate_request_for_access_token(
+ request_token, auth_server_url=ACCESS_TOKEN_URL):
+ """Creates a request to ask the OAuth server for an access token.
+
+ Requires a request token which the user has authorized. See the
+ documentation on OAuth with Google Data for more details:
+ http://code.google.com/apis/accounts/docs/OAuth.html#AccessToken
+
+ Args:
+ request_token: An OAuthHmacToken or OAuthRsaToken which the user has
+ approved using their browser.
+ auth_server_url: (optional) The URL at which the OAuth access token is
+ requested. Defaults to
+ https://www.google.com/accounts/OAuthGetAccessToken
+
+ Returns:
+ A new HttpRequest object which can be sent to the OAuth server to
+ request an OAuth Access Token.
+ """
+ http_request = atom.http_core.HttpRequest(auth_server_url, 'POST')
+ http_request.headers['Content-Length'] = '0'
+ return request_token.modify_request(http_request)
+
+
+def oauth_token_info_from_body(http_body):
+ """Exracts an OAuth request token from the server's response.
+
+ Returns:
+ A tuple of strings containing the OAuth token and token secret. If
+ neither of these are present in the body, returns (None, None)
+ """
+ token = None
+ token_secret = None
+ for pair in http_body.split('&'):
+ if pair.startswith('oauth_token='):
+ token = urllib.unquote(pair[len('oauth_token='):])
+ if pair.startswith('oauth_token_secret='):
+ token_secret = urllib.unquote(pair[len('oauth_token_secret='):])
+ return (token, token_secret)
+
+
+def hmac_token_from_body(http_body, consumer_key, consumer_secret,
+ auth_state):
+ token_value, token_secret = oauth_token_info_from_body(http_body)
+ token = OAuthHmacToken(consumer_key, consumer_secret, token_value,
+ token_secret, auth_state)
+ return token
+
+
+def rsa_token_from_body(http_body, consumer_key, rsa_private_key,
+ auth_state):
+ token_value, token_secret = oauth_token_info_from_body(http_body)
+ token = OAuthRsaToken(consumer_key, rsa_private_key, token_value,
+ token_secret, auth_state)
+ return token
+
+
+DEFAULT_DOMAIN = 'default'
+OAUTH_AUTHORIZE_URL = 'https://www.google.com/accounts/OAuthAuthorizeToken'
+
+
+def generate_oauth_authorization_url(
+ token, next=None, hd=DEFAULT_DOMAIN, hl=None, btmpl=None,
+ auth_server=OAUTH_AUTHORIZE_URL):
+ """Creates a URL for the page where the request token can be authorized.
+
+ Args:
+ token: str The request token from the OAuth server.
+ next: str (optional) URL the user should be redirected to after granting
+ access to a Google service(s). It can include url-encoded query
+ parameters.
+ hd: str (optional) Identifies a particular hosted domain account to be
+ accessed (for example, 'mycollege.edu'). Uses 'default' to specify a
+ regular Google account ('username@gmail.com').
+ hl: str (optional) An ISO 639 country code identifying what language the
+ approval page should be translated in (for example, 'hl=en' for
+ English). The default is the user's selected language.
+ btmpl: str (optional) Forces a mobile version of the approval page. The
+ only accepted value is 'mobile'.
+ auth_server: str (optional) The start of the token authorization web
+ page. Defaults to
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'
+
+ Returns:
+ An atom.http_core.Uri pointing to the token authorization page where the
+ user may allow or deny this app to access their Google data.
+ """
+ uri = atom.http_core.Uri.parse_uri(auth_server)
+ uri.query['oauth_token'] = token
+ uri.query['hd'] = hd
+ if next is not None:
+ uri.query['oauth_callback'] = str(next)
+ if hl is not None:
+ uri.query['hl'] = hl
+ if btmpl is not None:
+ uri.query['btmpl'] = btmpl
+ return uri
+
+
+def oauth_token_info_from_url(url):
+ """Exracts an OAuth access token from the redirected page's URL.
+
+ Returns:
+ A tuple of strings containing the OAuth token and the OAuth verifier which
+ need to sent when upgrading a request token to an access token.
+ """
+ if isinstance(url, (str, unicode)):
+ url = atom.http_core.Uri.parse_uri(url)
+ token = None
+ verifier = None
+ if 'oauth_token' in url.query:
+ token = urllib.unquote(url.query['oauth_token'])
+ if 'oauth_verifier' in url.query:
+ verifier = urllib.unquote(url.query['oauth_verifier'])
+ return (token, verifier)
+
+
+def authorize_request_token(request_token, url):
+ """Adds information to request token to allow it to become an access token.
+
+ Modifies the request_token object passed in by setting and unsetting the
+ necessary fields to allow this token to form a valid upgrade request.
+
+ Args:
+ request_token: The OAuth request token which has been authorized by the
+ user. In order for this token to be upgraded to an access token,
+ certain fields must be extracted from the URL and added to the token
+ so that they can be passed in an upgrade-token request.
+ url: The URL of the current page which the user's browser was redirected
+ to after they authorized access for the app. This function extracts
+ information from the URL which is needed to upgraded the token from
+ a request token to an access token.
+
+ Returns:
+ The same token object which was passed in.
+ """
+ token, verifier = oauth_token_info_from_url(url)
+ request_token.token = token
+ request_token.verifier = verifier
+ request_token.auth_state = AUTHORIZED_REQUEST_TOKEN
+ return request_token
+
+
+AuthorizeRequestToken = authorize_request_token
+
+
+def upgrade_to_access_token(request_token, server_response_body):
+ """Extracts access token information from response to an upgrade request.
+
+ Once the server has responded with the new token info for the OAuth
+ access token, this method modifies the request_token to set and unset
+ necessary fields to create valid OAuth authorization headers for requests.
+
+ Args:
+ request_token: An OAuth token which this function modifies to allow it
+ to be used as an access token.
+ server_response_body: str The server's response to an OAuthAuthorizeToken
+ request. This should contain the new token and token_secret which
+ are used to generate the signature and parameters of the Authorization
+ header in subsequent requests to Google Data APIs.
+
+ Returns:
+ The same token object which was passed in.
+ """
+ token, token_secret = oauth_token_info_from_body(server_response_body)
+ request_token.token = token
+ request_token.token_secret = token_secret
+ request_token.auth_state = ACCESS_TOKEN
+ request_token.next = None
+ request_token.verifier = None
+ return request_token
+
+
+UpgradeToAccessToken = upgrade_to_access_token
+
+
+REQUEST_TOKEN = 1
+AUTHORIZED_REQUEST_TOKEN = 2
+ACCESS_TOKEN = 3
+
+
+class OAuthHmacToken(object):
+ SIGNATURE_METHOD = HMAC_SHA1
+
+ def __init__(self, consumer_key, consumer_secret, token, token_secret,
+ auth_state, next=None, verifier=None):
+ self.consumer_key = consumer_key
+ self.consumer_secret = consumer_secret
+ self.token = token
+ self.token_secret = token_secret
+ self.auth_state = auth_state
+ self.next = next
+ self.verifier = verifier # Used to convert request token to access token.
+
+ def generate_authorization_url(
+ self, google_apps_domain=DEFAULT_DOMAIN, language=None, btmpl=None,
+ auth_server=OAUTH_AUTHORIZE_URL):
+ """Creates the URL at which the user can authorize this app to access.
+
+ Args:
+ google_apps_domain: str (optional) If the user should be signing in
+ using an account under a known Google Apps domain, provide the
+ domain name ('example.com') here. If not provided, 'default'
+ will be used, and the user will be prompted to select an account
+ if they are signed in with a Google Account and Google Apps
+ accounts.
+ language: str (optional) An ISO 639 country code identifying what
+ language the approval page should be translated in (for example,
+ 'en' for English). The default is the user's selected language.
+ btmpl: str (optional) Forces a mobile version of the approval page. The
+ only accepted value is 'mobile'.
+ auth_server: str (optional) The start of the token authorization web
+ page. Defaults to
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'
+ """
+ return generate_oauth_authorization_url(
+ self.token, hd=google_apps_domain, hl=language, btmpl=btmpl,
+ auth_server=auth_server)
+
+ GenerateAuthorizationUrl = generate_authorization_url
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header in the HTTP request using the token.
+
+ Calculates an HMAC signature using the information in the token to
+ indicate that the request came from this application and that this
+ application has permission to access a particular user's data.
+
+ Returns:
+ The same HTTP request object which was passed in.
+ """
+ timestamp = str(int(time.time()))
+ nonce = ''.join([str(random.randint(0, 9)) for i in xrange(15)])
+ signature = generate_hmac_signature(
+ http_request, self.consumer_key, self.consumer_secret, timestamp,
+ nonce, version='1.0', next=self.next, token=self.token,
+ token_secret=self.token_secret, verifier=self.verifier)
+ http_request.headers['Authorization'] = generate_auth_header(
+ self.consumer_key, timestamp, nonce, HMAC_SHA1, signature,
+ version='1.0', next=self.next, token=self.token,
+ verifier=self.verifier)
+ return http_request
+
+ ModifyRequest = modify_request
+
+
+class OAuthRsaToken(OAuthHmacToken):
+ SIGNATURE_METHOD = RSA_SHA1
+
+ def __init__(self, consumer_key, rsa_private_key, token, token_secret,
+ auth_state, next=None, verifier=None):
+ self.consumer_key = consumer_key
+ self.rsa_private_key = rsa_private_key
+ self.token = token
+ self.token_secret = token_secret
+ self.auth_state = auth_state
+ self.next = next
+ self.verifier = verifier # Used to convert request token to access token.
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header in the HTTP request using the token.
+
+ Calculates an RSA signature using the information in the token to
+ indicate that the request came from this application and that this
+ application has permission to access a particular user's data.
+
+ Returns:
+ The same HTTP request object which was passed in.
+ """
+ timestamp = str(int(time.time()))
+ nonce = ''.join([str(random.randint(0, 9)) for i in xrange(15)])
+ signature = generate_rsa_signature(
+ http_request, self.consumer_key, self.rsa_private_key, timestamp,
+ nonce, version='1.0', next=self.next, token=self.token,
+ token_secret=self.token_secret, verifier=self.verifier)
+ http_request.headers['Authorization'] = generate_auth_header(
+ self.consumer_key, timestamp, nonce, RSA_SHA1, signature,
+ version='1.0', next=self.next, token=self.token,
+ verifier=self.verifier)
+ return http_request
+
+ ModifyRequest = modify_request
+
+
+class TwoLeggedOAuthHmacToken(OAuthHmacToken):
+
+ def __init__(self, consumer_key, consumer_secret, requestor_id):
+ self.requestor_id = requestor_id
+ OAuthHmacToken.__init__(
+ self, consumer_key, consumer_secret, None, None, ACCESS_TOKEN,
+ next=None, verifier=None)
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header in the HTTP request using the token.
+
+ Calculates an HMAC signature using the information in the token to
+ indicate that the request came from this application and that this
+ application has permission to access a particular user's data using 2LO.
+
+ Returns:
+ The same HTTP request object which was passed in.
+ """
+ http_request.uri.query['xoauth_requestor_id'] = self.requestor_id
+ return OAuthHmacToken.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
+
+
+class TwoLeggedOAuthRsaToken(OAuthRsaToken):
+
+ def __init__(self, consumer_key, rsa_private_key, requestor_id):
+ self.requestor_id = requestor_id
+ OAuthRsaToken.__init__(
+ self, consumer_key, rsa_private_key, None, None, ACCESS_TOKEN,
+ next=None, verifier=None)
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header in the HTTP request using the token.
+
+ Calculates an RSA signature using the information in the token to
+ indicate that the request came from this application and that this
+ application has permission to access a particular user's data using 2LO.
+
+ Returns:
+ The same HTTP request object which was passed in.
+ """
+ http_request.uri.query['xoauth_requestor_id'] = self.requestor_id
+ return OAuthRsaToken.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
+
+
+class OAuth2Token(object):
+ """Token object for OAuth 2.0 as described on
+ <http://code.google.com/apis/accounts/docs/OAuth2.html>.
+
+ Token can be applied to a gdata.client.GDClient object using the authorize()
+ method, which then signs each request from that object with the OAuth 2.0
+ access token.
+ This class supports 3 flows of OAuth 2.0:
+ Client-side web flow: call generate_authorize_url with `response_type='token''
+ and the registered `redirect_uri'.
+ Server-side web flow: call generate_authorize_url with the registered
+ `redirect_url'.
+ Native applications flow: call generate_authorize_url as it is. You will have
+ to ask the user to go to the generated url and pass in the authorization
+ code to your application.
+ """
+
+ def __init__(self, client_id, client_secret, scope, user_agent,
+ auth_uri='https://accounts.google.com/o/oauth2/auth',
+ token_uri='https://accounts.google.com/o/oauth2/token',
+ access_token=None, refresh_token=None,
+ revoke_uri='https://accounts.google.com/o/oauth2/revoke'):
+ """Create an instance of OAuth2Token
+
+ Args:
+ client_id: string, client identifier.
+ client_secret: string client secret.
+ scope: string, scope of the credentials being requested.
+ user_agent: string, HTTP User-Agent to provide for this application.
+ auth_uri: string, URI for authorization endpoint. For convenience
+ defaults to Google's endpoints but any OAuth 2.0 provider can be used.
+ token_uri: string, URI for token endpoint. For convenience
+ defaults to Google's endpoints but any OAuth 2.0 provider can be used.
+ revoke_uri: string, URI for revoke endpoint. For convenience
+ defaults to Google's endpoints but any OAuth 2.0 provider can be used.
+ access_token: string, access token.
+ refresh_token: string, refresh token.
+ """
+ self.client_id = client_id
+ self.client_secret = client_secret
+ self.scope = scope
+ self.user_agent = user_agent
+ self.auth_uri = auth_uri
+ self.token_uri = token_uri
+ self.revoke_uri = revoke_uri
+ self.access_token = access_token
+ self.refresh_token = refresh_token
+
+ # True if the credentials have been revoked or expired and can't be
+ # refreshed.
+ self._invalid = False
+
+ @property
+ def invalid(self):
+ """True if the credentials are invalid, such as being revoked."""
+ return getattr(self, '_invalid', False)
+
+ def _refresh(self, request):
+ """Refresh the access_token using the refresh_token.
+
+ Args:
+ request: The atom.http_core.HttpRequest which contains all of the
+ information needed to send a request to the remote server.
+ """
+ body = urllib.urlencode({
+ 'grant_type': 'refresh_token',
+ 'client_id': self.client_id,
+ 'client_secret': self.client_secret,
+ 'refresh_token' : self.refresh_token
+ })
+ headers = {
+ 'user-agent': self.user_agent,
+ }
+
+ http_request = atom.http_core.HttpRequest(
+ uri=self.token_uri, method='POST', headers=headers)
+ http_request.add_body_part(
+ body, mime_type='application/x-www-form-urlencoded')
+ response = request(http_request)
+ body = response.read()
+ if response.status == 200:
+ self._extract_tokens(body)
+ else:
+ self._invalid = True
+ return response
+
+ def _extract_tokens(self, body):
+ d = simplejson.loads(body)
+ self.access_token = d['access_token']
+ self.refresh_token = d.get('refresh_token', self.refresh_token)
+ if 'expires_in' in d:
+ self.token_expiry = datetime.timedelta(
+ seconds = int(d['expires_in'])) + datetime.datetime.now()
+ else:
+ self.token_expiry = None
+
+ def generate_authorize_url(self, redirect_uri='urn:ietf:wg:oauth:2.0:oob',
+ response_type='code', access_type='offline',
+ approval_prompt='auto', **kwargs):
+ """Returns a URI to redirect to the provider.
+
+ Args:
+ redirect_uri: Either the string 'urn:ietf:wg:oauth:2.0:oob' for a
+ non-web-based application, or a URI that handles the
+ callback from the authorization server.
+ response_type: Either the string 'code' for server-side or native
+ application, or the string 'token' for client-side
+ application.
+ access_type: Either the string 'offline' to request a refresh token or
+ 'online'.
+ approval_prompt: Either the string 'auto' to let the OAuth mechanism
+ determine if the approval page is needed or 'force'
+ if the approval prompt is desired in all cases.
+
+ If redirect_uri is 'urn:ietf:wg:oauth:2.0:oob' then pass in the
+ generated verification code to get_access_token,
+ otherwise pass in the query parameters received
+ at the callback uri to get_access_token.
+ If the response_type is 'token', no need to call
+ get_access_token as the API will return it within
+ the query parameters received at the callback:
+ oauth2_token.access_token = YOUR_ACCESS_TOKEN
+ """
+ self.redirect_uri = redirect_uri
+ query = {
+ 'response_type': response_type,
+ 'client_id': self.client_id,
+ 'redirect_uri': redirect_uri,
+ 'scope': self.scope,
+ 'approval_prompt': approval_prompt,
+ 'access_type': access_type
+ }
+ query.update(kwargs)
+ parts = list(urlparse.urlparse(self.auth_uri))
+ query.update(dict(parse_qsl(parts[4]))) # 4 is the index of the query part
+ parts[4] = urllib.urlencode(query)
+ return urlparse.urlunparse(parts)
+
+ def get_access_token(self, code):
+ """Exhanges a code for an access token.
+
+ Args:
+ code: string or dict, either the code as a string, or a dictionary
+ of the query parameters to the redirect_uri, which contains
+ the code.
+ """
+
+ if not (isinstance(code, str) or isinstance(code, unicode)):
+ code = code['code']
+
+ body = urllib.urlencode({
+ 'grant_type': 'authorization_code',
+ 'client_id': self.client_id,
+ 'client_secret': self.client_secret,
+ 'code': code,
+ 'redirect_uri': self.redirect_uri,
+ 'scope': self.scope
+ })
+ headers = {
+ 'user-agent': self.user_agent,
+ }
+ http_client = atom.http_core.HttpClient()
+ http_request = atom.http_core.HttpRequest(uri=self.token_uri, method='POST',
+ headers=headers)
+ http_request.add_body_part(data=body,
+ mime_type='application/x-www-form-urlencoded')
+ response = http_client.request(http_request)
+ body = response.read()
+ if response.status == 200:
+ self._extract_tokens(body)
+ return self
+ else:
+ error_msg = 'Invalid response %s.' % response.status
+ try:
+ d = simplejson.loads(body)
+ if 'error' in d:
+ error_msg = d['error']
+ except:
+ pass
+ raise OAuth2AccessTokenError(error_msg)
+
+ def authorize(self, client):
+ """Authorize a gdata.client.GDClient instance with these credentials.
+
+ Args:
+ client: An instance of gdata.client.GDClient
+ or something that acts like it.
+
+ Returns:
+ A modified instance of client that was passed in.
+
+ Example:
+ >>> c = gdata.client.GDClient(source='user-agent')
+ >>> c = token.authorize(c)
+ """
+ client.auth_token = self
+ request_orig = client.http_client.request
+
+ def new_request(http_request):
+ response = request_orig(http_request)
+ if response.status == 401:
+ refresh_response = self._refresh(request_orig)
+ if self._invalid:
+ return refresh_response
+ else:
+ self.modify_request(http_request)
+ return request_orig(http_request)
+ else:
+ return response
+
+ client.http_client.request = new_request
+ return client
+
+ def revoke(self, revoke_uri=None, refresh_token=None):
+ """Revokes access via a refresh token.
+
+ Args:
+ revoke_uri: string, URI for revoke endpoint. If not provided, or if
+ None is provided, the revoke_uri attribute on the object is used.
+ refresh_token: string, refresh token. If not provided, or if None is
+ provided, the refresh_token attribute on the object is used.
+
+ Raises:
+ UnsupportedTokenType if the token is not one of the supported token
+ classes listed above.
+
+ Example:
+ >>> token.revoke()
+ """
+ base_revoke_uri = revoke_uri or self.revoke_uri
+ refresh_token = refresh_token or self.refresh_token
+ revoke_uri = atom.http_core.ParseUri(base_revoke_uri)
+ revoke_uri.query['token'] = refresh_token
+ http_client = atom.http_core.HttpClient()
+ http_request = atom.http_core.HttpRequest(uri=revoke_uri, method='GET')
+ response = http_client.request(http_request)
+ if response.status != 200:
+ raise OAuth2RevokeError(response)
+ else:
+ self._invalid = True
+
+ def modify_request(self, http_request):
+ """Sets the Authorization header in the HTTP request using the token.
+
+ Returns:
+ The same HTTP request object which was passed in.
+ """
+ http_request.headers['Authorization'] = '%s%s' % (OAUTH2_AUTH_LABEL,
+ self.access_token)
+ return http_request
+
+ ModifyRequest = modify_request
+
+
+def _make_credentials_property(name):
+ """Helper method which generates properties.
+
+ Used to access and set values on credentials property as if they were native
+ attributes on the current object.
+
+ Args:
+ name: A string corresponding to the attribute being accessed on the
+ credentials attribute of the object which will own the property.
+
+ Returns:
+ An instance of `property` which is a proxy for the `name` attribute on the
+ credentials attribute of the object.
+ """
+ def get_credentials_value(self):
+ return getattr(self.credentials, name)
+ def set_credentials_value(self, value):
+ setattr(self.credentials, name, value)
+ return property(get_credentials_value, set_credentials_value)
+
+
+class OAuth2TokenFromCredentials(OAuth2Token):
+ """Special subclass to be used in conjunction with google-api-python-client.
+
+ These libraries are built for different purposes. This one is used for APIs
+ that use the GData Protocol:
+ https://developers.google.com/gdata/docs/2.0/reference
+ while google-api-python-client is for APIs which are discovery-based:
+ https://developers.google.com/discovery/v1/getting_started#background
+
+ Developers using Google APIs may want to use both simultaneously, and this
+ class provides a way for them to use OAuth 2.0 credentials obtained for use
+ with google-api-python-client as credentials in gdata-python-client and to
+ ensure all token/credential refresh impacts both this object and the
+ google-api-python-client credentials object.
+
+ In addition, any manual patching of this object or the credentials object will
+ be immediately reflected since attributes such as `client_id`, `access_token`,
+ etc. are directly proxied between instances of this class and the credentials
+ objects that they own.
+ """
+
+ def __init__(self, credentials):
+ """Constructor for OAuth2TokenFromCredentials object.
+
+ The constructor for the superclass is not called because the actual values
+ are retrieved from the credentials object directly via `property` instances
+ which act as proxies.
+
+ Args:
+ credentials: An instance of oauth2client.client.Credentials or some
+ subclass.
+ """
+ self.credentials = credentials
+
+ client_id = _make_credentials_property('client_id')
+ client_secret = _make_credentials_property('client_secret')
+ user_agent = _make_credentials_property('user_agent')
+ # `scope` is not included as an attribute because the Credentials object in
+ # google-api-python-client does not handle the initial auth flow.
+ token_uri = _make_credentials_property('token_uri')
+ access_token = _make_credentials_property('access_token')
+ refresh_token = _make_credentials_property('refresh_token')
+ # Again, since Credentials don't handle the initial auth flow, `auth_uri` and
+ # `redirect_uri` are not included as attributes. In addition, revoke has not
+ # been implemented for Credentials hence `revoke_uri` is not included either.
+ token_expiry = _make_credentials_property('token_expiry')
+ _invalid = _make_credentials_property('invalid')
+
+ # Disable methods not supported by Credentials.
+ def generate_authorize_url(self, *args, **kwargs): raise NotImplementedError
+ def get_access_token(self, *args, **kwargs): raise NotImplementedError
+ def revoke(self, *args, **kwargs): raise NotImplementedError
+ def _extract_tokens(self, *args, **kwargs): raise NotImplementedError
+
+ def _refresh(self, unused_request):
+ """Refresh the access_token using the Credentials object.
+
+ Args:
+ unused_request: The atom.http_core.HttpRequest which contains all of the
+ information needed to send a request to the remote server. This won't
+ be used since we are refreshing the Credentials object directly and
+ need to use the supported HTTP mechanisms for the
+ google-api-python-client library.
+ """
+ # Import httplib2 here since we don't want it as an unnecessary dependency
+ # for users who don't integrate with google-api-python-client.
+ import httplib2
+ self.credentials._refresh(httplib2.Http().request)
+
+
+def _join_token_parts(*args):
+ """"Escapes and combines all strings passed in.
+
+ Used to convert a token object's members into a string instead of
+ using pickle.
+
+ Note: A None value will be converted to an empty string.
+
+ Returns:
+ A string in the form 1x|member1|member2|member3...
+ """
+ return '|'.join([urllib.quote_plus(a or '') for a in args])
+
+
+def _split_token_parts(blob):
+ """Extracts and unescapes fields from the provided binary string.
+
+ Reverses the packing performed by _join_token_parts. Used to extract
+ the members of a token object.
+
+ Note: An empty string from the blob will be interpreted as None.
+
+ Args:
+ blob: str A string of the form 1x|member1|member2|member3 as created
+ by _join_token_parts
+
+ Returns:
+ A list of unescaped strings.
+ """
+ return [urllib.unquote_plus(part) or None for part in blob.split('|')]
+
+
+def token_to_blob(token):
+ """Serializes the token data as a string for storage in a datastore.
+
+ Supported token classes: ClientLoginToken, AuthSubToken, SecureAuthSubToken,
+ OAuthRsaToken, and OAuthHmacToken, TwoLeggedOAuthRsaToken,
+ TwoLeggedOAuthHmacToken and OAuth2Token.
+
+ Args:
+ token: A token object which must be of one of the supported token classes.
+
+ Raises:
+ UnsupportedTokenType if the token is not one of the supported token
+ classes listed above.
+
+ Returns:
+ A string represenging this token. The string can be converted back into
+ an equivalent token object using token_from_blob. Note that any members
+ which are set to '' will be set to None when the token is deserialized
+ by token_from_blob.
+ """
+ if isinstance(token, ClientLoginToken):
+ return _join_token_parts('1c', token.token_string)
+ # Check for secure auth sub type first since it is a subclass of
+ # AuthSubToken.
+ elif isinstance(token, SecureAuthSubToken):
+ return _join_token_parts('1s', token.token_string, token.rsa_private_key,
+ *token.scopes)
+ elif isinstance(token, AuthSubToken):
+ return _join_token_parts('1a', token.token_string, *token.scopes)
+ elif isinstance(token, TwoLeggedOAuthRsaToken):
+ return _join_token_parts(
+ '1rtl', token.consumer_key, token.rsa_private_key, token.requestor_id)
+ elif isinstance(token, TwoLeggedOAuthHmacToken):
+ return _join_token_parts(
+ '1htl', token.consumer_key, token.consumer_secret, token.requestor_id)
+ # Check RSA OAuth token first since the OAuthRsaToken is a subclass of
+ # OAuthHmacToken.
+ elif isinstance(token, OAuthRsaToken):
+ return _join_token_parts(
+ '1r', token.consumer_key, token.rsa_private_key, token.token,
+ token.token_secret, str(token.auth_state), token.next,
+ token.verifier)
+ elif isinstance(token, OAuthHmacToken):
+ return _join_token_parts(
+ '1h', token.consumer_key, token.consumer_secret, token.token,
+ token.token_secret, str(token.auth_state), token.next,
+ token.verifier)
+ elif isinstance(token, OAuth2Token):
+ return _join_token_parts(
+ '2o', token.client_id, token.client_secret, token.scope,
+ token.user_agent, token.auth_uri, token.token_uri,
+ token.access_token, token.refresh_token)
+ else:
+ raise UnsupportedTokenType(
+ 'Unable to serialize token of type %s' % type(token))
+
+
+TokenToBlob = token_to_blob
+
+
+def token_from_blob(blob):
+ """Deserializes a token string from the datastore back into a token object.
+
+ Supported token classes: ClientLoginToken, AuthSubToken, SecureAuthSubToken,
+ OAuthRsaToken, and OAuthHmacToken, TwoLeggedOAuthRsaToken,
+ TwoLeggedOAuthHmacToken and OAuth2Token.
+
+ Args:
+ blob: string created by token_to_blob.
+
+ Raises:
+ UnsupportedTokenType if the token is not one of the supported token
+ classes listed above.
+
+ Returns:
+ A new token object with members set to the values serialized in the
+ blob string. Note that any members which were set to '' in the original
+ token will now be None.
+ """
+ parts = _split_token_parts(blob)
+ if parts[0] == '1c':
+ return ClientLoginToken(parts[1])
+ elif parts[0] == '1a':
+ return AuthSubToken(parts[1], parts[2:])
+ elif parts[0] == '1s':
+ return SecureAuthSubToken(parts[1], parts[2], parts[3:])
+ elif parts[0] == '1rtl':
+ return TwoLeggedOAuthRsaToken(parts[1], parts[2], parts[3])
+ elif parts[0] == '1htl':
+ return TwoLeggedOAuthHmacToken(parts[1], parts[2], parts[3])
+ elif parts[0] == '1r':
+ auth_state = int(parts[5])
+ return OAuthRsaToken(parts[1], parts[2], parts[3], parts[4], auth_state,
+ parts[6], parts[7])
+ elif parts[0] == '1h':
+ auth_state = int(parts[5])
+ return OAuthHmacToken(parts[1], parts[2], parts[3], parts[4], auth_state,
+ parts[6], parts[7])
+ elif parts[0] == '2o':
+ return OAuth2Token(parts[1], parts[2], parts[3], parts[4], parts[5],
+ parts[6], parts[7], parts[8])
+ else:
+ raise UnsupportedTokenType(
+ 'Unable to deserialize token with type marker of %s' % parts[0])
+
+
+TokenFromBlob = token_from_blob
+
+
+def dump_tokens(tokens):
+ return ','.join([token_to_blob(t) for t in tokens])
+
+
+def load_tokens(blob):
+ return [token_from_blob(s) for s in blob.split(',')]
+
+
+def find_scopes_for_services(service_names=None):
+ """Creates a combined list of scope URLs for the desired services.
+
+ This method searches the AUTH_SCOPES dictionary.
+
+ Args:
+ service_names: list of strings (optional) Each name must be a key in the
+ AUTH_SCOPES dictionary. If no list is provided (None) then
+ the resulting list will contain all scope URLs in the
+ AUTH_SCOPES dict.
+
+ Returns:
+ A list of URL strings which are the scopes needed to access these services
+ when requesting a token using AuthSub or OAuth.
+ """
+ result_scopes = []
+ if service_names is None:
+ for service_name, scopes in AUTH_SCOPES.iteritems():
+ result_scopes.extend(scopes)
+ else:
+ for service_name in service_names:
+ result_scopes.extend(AUTH_SCOPES[service_name])
+ return result_scopes
+
+
+FindScopesForServices = find_scopes_for_services
+
+
+def ae_save(token, token_key):
+ """Stores an auth token in the App Engine datastore.
+
+ This is a convenience method for using the library with App Engine.
+ Recommended usage is to associate the auth token with the current_user.
+ If a user is signed in to the app using the App Engine users API, you
+ can use
+ gdata.gauth.ae_save(some_token, users.get_current_user().user_id())
+ If you are not using the Users API you are free to choose whatever
+ string you would like for a token_string.
+
+ Args:
+ token: an auth token object. Must be one of ClientLoginToken,
+ AuthSubToken, SecureAuthSubToken, OAuthRsaToken, or OAuthHmacToken
+ (see token_to_blob).
+ token_key: str A unique identified to be used when you want to retrieve
+ the token. If the user is signed in to App Engine using the
+ users API, I recommend using the user ID for the token_key:
+ users.get_current_user().user_id()
+ """
+ import gdata.alt.app_engine
+ key_name = ''.join(('gd_auth_token', token_key))
+ return gdata.alt.app_engine.set_token(key_name, token_to_blob(token))
+
+
+AeSave = ae_save
+
+
+def ae_load(token_key):
+ """Retrieves a token object from the App Engine datastore.
+
+ This is a convenience method for using the library with App Engine.
+ See also ae_save.
+
+ Args:
+ token_key: str The unique key associated with the desired token when it
+ was saved using ae_save.
+
+ Returns:
+ A token object if there was a token associated with the token_key or None
+ if the key could not be found.
+ """
+ import gdata.alt.app_engine
+ key_name = ''.join(('gd_auth_token', token_key))
+ token_string = gdata.alt.app_engine.get_token(key_name)
+ if token_string is not None:
+ return token_from_blob(token_string)
+ else:
+ return None
+
+
+AeLoad = ae_load
+
+
+def ae_delete(token_key):
+ """Removes the token object from the App Engine datastore."""
+ import gdata.alt.app_engine
+ key_name = ''.join(('gd_auth_token', token_key))
+ gdata.alt.app_engine.delete_token(key_name)
+
+
+AeDelete = ae_delete
diff --git a/src/gdata/geo/__init__.py b/src/gdata/geo/__init__.py
new file mode 100644
index 0000000..1fcf604
--- /dev/null
+++ b/src/gdata/geo/__init__.py
@@ -0,0 +1,185 @@
+# -*-*- encoding: utf-8 -*-*-
+#
+# This is gdata.photos.geo, implementing geological positioning in gdata structures
+#
+# $Id: __init__.py 81 2007-10-03 14:41:42Z havard.gulldahl $
+#
+# Copyright 2007 Håvard Gulldahl
+# Portions copyright 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Picasa Web Albums uses the georss and gml namespaces for
+elements defined in the GeoRSS and Geography Markup Language specifications.
+
+Specifically, Picasa Web Albums uses the following elements:
+
+georss:where
+gml:Point
+gml:pos
+
+http://code.google.com/apis/picasaweb/reference.html#georss_reference
+
+
+Picasa Web Albums also accepts geographic-location data in two other formats:
+W3C format and plain-GeoRSS (without GML) format.
+"""
+#
+#Over the wire, the Picasa Web Albums only accepts and sends the
+#elements mentioned above, but this module will let you seamlessly convert
+#between the different formats (TODO 2007-10-18 hg)
+
+__author__ = u'havard@gulldahl.no'# (Håvard Gulldahl)' #BUG: api chokes on non-ascii chars in __author__
+__license__ = 'Apache License v2'
+
+
+import atom
+import gdata
+
+GEO_NAMESPACE = 'http://www.w3.org/2003/01/geo/wgs84_pos#'
+GML_NAMESPACE = 'http://www.opengis.net/gml'
+GEORSS_NAMESPACE = 'http://www.georss.org/georss'
+
+class GeoBaseElement(atom.AtomBase):
+ """Base class for elements.
+
+ To add new elements, you only need to add the element tag name to self._tag
+ and the namespace to self._namespace
+ """
+
+ _tag = ''
+ _namespace = GML_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, name=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+class Pos(GeoBaseElement):
+ """(string) Specifies a latitude and longitude, separated by a space,
+ e.g. `35.669998 139.770004'"""
+
+ _tag = 'pos'
+def PosFromString(xml_string):
+ return atom.CreateClassFromXMLString(Pos, xml_string)
+
+class Point(GeoBaseElement):
+ """(container) Specifies a particular geographical point, by means of
+ a <gml:pos> element."""
+
+ _tag = 'Point'
+ _children = atom.AtomBase._children.copy()
+ _children['{%s}pos' % GML_NAMESPACE] = ('pos', Pos)
+ def __init__(self, pos=None, extension_elements=None, extension_attributes=None, text=None):
+ GeoBaseElement.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+ if pos is None:
+ pos = Pos()
+ self.pos=pos
+def PointFromString(xml_string):
+ return atom.CreateClassFromXMLString(Point, xml_string)
+
+class Where(GeoBaseElement):
+ """(container) Specifies a geographical location or region.
+ A container element, containing a single <gml:Point> element.
+ (Not to be confused with <gd:where>.)
+
+ Note that the (only) child attribute, .Point, is title-cased.
+ This reflects the names of elements in the xml stream
+ (principle of least surprise).
+
+ As a convenience, you can get a tuple of (lat, lon) with Where.location(),
+ and set the same data with Where.setLocation( (lat, lon) ).
+
+ Similarly, there are methods to set and get only latitude and longitude.
+ """
+
+ _tag = 'where'
+ _namespace = GEORSS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _children['{%s}Point' % GML_NAMESPACE] = ('Point', Point)
+ def __init__(self, point=None, extension_elements=None, extension_attributes=None, text=None):
+ GeoBaseElement.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+ if point is None:
+ point = Point()
+ self.Point=point
+ def location(self):
+ "(float, float) Return Where.Point.pos.text as a (lat,lon) tuple"
+ try:
+ return tuple([float(z) for z in self.Point.pos.text.split(' ')])
+ except AttributeError:
+ return tuple()
+ def set_location(self, latlon):
+ """(bool) Set Where.Point.pos.text from a (lat,lon) tuple.
+
+ Arguments:
+ lat (float): The latitude in degrees, from -90.0 to 90.0
+ lon (float): The longitude in degrees, from -180.0 to 180.0
+
+ Returns True on success.
+
+ """
+
+ assert(isinstance(latlon[0], float))
+ assert(isinstance(latlon[1], float))
+ try:
+ self.Point.pos.text = "%s %s" % (latlon[0], latlon[1])
+ return True
+ except AttributeError:
+ return False
+ def latitude(self):
+ "(float) Get the latitude value of the geo-tag. See also .location()"
+ lat, lon = self.location()
+ return lat
+
+ def longitude(self):
+ "(float) Get the longtitude value of the geo-tag. See also .location()"
+ lat, lon = self.location()
+ return lon
+
+ longtitude = longitude
+
+ def set_latitude(self, lat):
+ """(bool) Set the latitude value of the geo-tag.
+
+ Args:
+ lat (float): The new latitude value
+
+ See also .set_location()
+ """
+ _lat, lon = self.location()
+ return self.set_location(lat, lon)
+
+ def set_longitude(self, lon):
+ """(bool) Set the longtitude value of the geo-tag.
+
+ Args:
+ lat (float): The new latitude value
+
+ See also .set_location()
+ """
+ lat, _lon = self.location()
+ return self.set_location(lat, lon)
+
+ set_longtitude = set_longitude
+
+def WhereFromString(xml_string):
+ return atom.CreateClassFromXMLString(Where, xml_string)
+
diff --git a/src/gdata/geo/data.py b/src/gdata/geo/data.py
new file mode 100644
index 0000000..2aec911
--- /dev/null
+++ b/src/gdata/geo/data.py
@@ -0,0 +1,92 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains the data classes of the Geography Extension"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+
+
+GEORSS_TEMPLATE = '{http://www.georss.org/georss/}%s'
+GML_TEMPLATE = '{http://www.opengis.net/gml/}%s'
+GEO_TEMPLATE = '{http://www.w3.org/2003/01/geo/wgs84_pos#/}%s'
+
+
+class GeoLat(atom.core.XmlElement):
+ """Describes a W3C latitude."""
+ _qname = GEO_TEMPLATE % 'lat'
+
+
+class GeoLong(atom.core.XmlElement):
+ """Describes a W3C longitude."""
+ _qname = GEO_TEMPLATE % 'long'
+
+
+class GeoRssBox(atom.core.XmlElement):
+ """Describes a geographical region."""
+ _qname = GEORSS_TEMPLATE % 'box'
+
+
+class GeoRssPoint(atom.core.XmlElement):
+ """Describes a geographical location."""
+ _qname = GEORSS_TEMPLATE % 'point'
+
+
+class GmlLowerCorner(atom.core.XmlElement):
+ """Describes a lower corner of a region."""
+ _qname = GML_TEMPLATE % 'lowerCorner'
+
+
+class GmlPos(atom.core.XmlElement):
+ """Describes a latitude and longitude."""
+ _qname = GML_TEMPLATE % 'pos'
+
+
+class GmlPoint(atom.core.XmlElement):
+ """Describes a particular geographical point."""
+ _qname = GML_TEMPLATE % 'Point'
+ pos = GmlPos
+
+
+class GmlUpperCorner(atom.core.XmlElement):
+ """Describes an upper corner of a region."""
+ _qname = GML_TEMPLATE % 'upperCorner'
+
+
+class GmlEnvelope(atom.core.XmlElement):
+ """Describes a Gml geographical region."""
+ _qname = GML_TEMPLATE % 'Envelope'
+ lower_corner = GmlLowerCorner
+ upper_corner = GmlUpperCorner
+
+
+class GeoRssWhere(atom.core.XmlElement):
+ """Describes a geographical location or region."""
+ _qname = GEORSS_TEMPLATE % 'where'
+ Point = GmlPoint
+ Envelope = GmlEnvelope
+
+
+class W3CPoint(atom.core.XmlElement):
+ """Describes a W3C geographical location."""
+ _qname = GEO_TEMPLATE % 'Point'
+ long = GeoLong
+ lat = GeoLat
+
+
diff --git a/src/gdata/health/__init__.py b/src/gdata/health/__init__.py
new file mode 100644
index 0000000..1904ecd
--- /dev/null
+++ b/src/gdata/health/__init__.py
@@ -0,0 +1,229 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains extensions to Atom objects used with Google Health."""
+
+__author__ = 'api.eric@google.com (Eric Bidelman)'
+
+import atom
+import gdata
+
+
+CCR_NAMESPACE = 'urn:astm-org:CCR'
+METADATA_NAMESPACE = 'http://schemas.google.com/health/metadata'
+
+
+class Ccr(atom.AtomBase):
+ """Represents a Google Health <ContinuityOfCareRecord>."""
+
+ _tag = 'ContinuityOfCareRecord'
+ _namespace = CCR_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+
+ def __init__(self, extension_elements=None,
+ extension_attributes=None, text=None):
+ atom.AtomBase.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+ def GetAlerts(self):
+ """Helper for extracting Alert/Allergy data from the CCR.
+
+ Returns:
+ A list of ExtensionElements (one for each allergy found) or None if
+ no allergies where found in this CCR.
+ """
+ try:
+ body = self.FindExtensions('Body')[0]
+ return body.FindChildren('Alerts')[0].FindChildren('Alert')
+ except:
+ return None
+
+ def GetAllergies(self):
+ """Alias for GetAlerts()."""
+ return self.GetAlerts()
+
+ def GetProblems(self):
+ """Helper for extracting Problem/Condition data from the CCR.
+
+ Returns:
+ A list of ExtensionElements (one for each problem found) or None if
+ no problems where found in this CCR.
+ """
+ try:
+ body = self.FindExtensions('Body')[0]
+ return body.FindChildren('Problems')[0].FindChildren('Problem')
+ except:
+ return None
+
+ def GetConditions(self):
+ """Alias for GetProblems()."""
+ return self.GetProblems()
+
+ def GetProcedures(self):
+ """Helper for extracting Procedure data from the CCR.
+
+ Returns:
+ A list of ExtensionElements (one for each procedure found) or None if
+ no procedures where found in this CCR.
+ """
+ try:
+ body = self.FindExtensions('Body')[0]
+ return body.FindChildren('Procedures')[0].FindChildren('Procedure')
+ except:
+ return None
+
+ def GetImmunizations(self):
+ """Helper for extracting Immunization data from the CCR.
+
+ Returns:
+ A list of ExtensionElements (one for each immunization found) or None if
+ no immunizations where found in this CCR.
+ """
+ try:
+ body = self.FindExtensions('Body')[0]
+ return body.FindChildren('Immunizations')[0].FindChildren('Immunization')
+ except:
+ return None
+
+ def GetMedications(self):
+ """Helper for extracting Medication data from the CCR.
+
+ Returns:
+ A list of ExtensionElements (one for each medication found) or None if
+ no medications where found in this CCR.
+ """
+ try:
+ body = self.FindExtensions('Body')[0]
+ return body.FindChildren('Medications')[0].FindChildren('Medication')
+ except:
+ return None
+
+ def GetResults(self):
+ """Helper for extracting Results/Labresults data from the CCR.
+
+ Returns:
+ A list of ExtensionElements (one for each result found) or None if
+ no results where found in this CCR.
+ """
+ try:
+ body = self.FindExtensions('Body')[0]
+ return body.FindChildren('Results')[0].FindChildren('Result')
+ except:
+ return None
+
+
+class ProfileEntry(gdata.GDataEntry):
+ """The Google Health version of an Atom Entry."""
+
+ _tag = gdata.GDataEntry._tag
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}ContinuityOfCareRecord' % CCR_NAMESPACE] = ('ccr', Ccr)
+
+ def __init__(self, ccr=None, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None, title=None,
+ updated=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ self.ccr = ccr
+ gdata.GDataEntry.__init__(
+ self, author=author, category=category, content=content,
+ atom_id=atom_id, link=link, published=published, title=title,
+ updated=updated, extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+
+class ProfileFeed(gdata.GDataFeed):
+ """A feed containing a list of Google Health profile entries."""
+
+ _tag = gdata.GDataFeed._tag
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [ProfileEntry])
+
+
+class ProfileListEntry(gdata.GDataEntry):
+ """The Atom Entry in the Google Health profile list feed."""
+
+ _tag = gdata.GDataEntry._tag
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+ def GetProfileId(self):
+ return self.content.text
+
+ def GetProfileName(self):
+ return self.title.text
+
+
+class ProfileListFeed(gdata.GDataFeed):
+ """A feed containing a list of Google Health profile list entries."""
+
+ _tag = gdata.GDataFeed._tag
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [ProfileListEntry])
+
+
+def ProfileEntryFromString(xml_string):
+ """Converts an XML string into a ProfileEntry object.
+
+ Args:
+ xml_string: string The XML describing a Health profile feed entry.
+
+ Returns:
+ A ProfileEntry object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(ProfileEntry, xml_string)
+
+
+def ProfileListEntryFromString(xml_string):
+ """Converts an XML string into a ProfileListEntry object.
+
+ Args:
+ xml_string: string The XML describing a Health profile list feed entry.
+
+ Returns:
+ A ProfileListEntry object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(ProfileListEntry, xml_string)
+
+
+def ProfileFeedFromString(xml_string):
+ """Converts an XML string into a ProfileFeed object.
+
+ Args:
+ xml_string: string The XML describing a ProfileFeed feed.
+
+ Returns:
+ A ProfileFeed object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(ProfileFeed, xml_string)
+
+
+def ProfileListFeedFromString(xml_string):
+ """Converts an XML string into a ProfileListFeed object.
+
+ Args:
+ xml_string: string The XML describing a ProfileListFeed feed.
+
+ Returns:
+ A ProfileListFeed object corresponding to the given XML.
+ """
+ return atom.CreateClassFromXMLString(ProfileListFeed, xml_string)
diff --git a/src/gdata/health/service.py b/src/gdata/health/service.py
new file mode 100644
index 0000000..3d38411
--- /dev/null
+++ b/src/gdata/health/service.py
@@ -0,0 +1,263 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""HealthService extends GDataService to streamline Google Health API access.
+
+ HealthService: Provides methods to interact with the profile, profile list,
+ and register/notices feeds. Extends GDataService.
+
+ HealthProfileQuery: Queries the Google Health Profile feed.
+
+ HealthProfileListQuery: Queries the Google Health Profile list feed.
+"""
+
+__author__ = 'api.eric@google.com (Eric Bidelman)'
+
+
+import atom
+import gdata.health
+import gdata.service
+
+
+class HealthService(gdata.service.GDataService):
+
+ """Client extension for the Google Health service Document List feed."""
+
+ def __init__(self, email=None, password=None, source=None,
+ use_h9_sandbox=False, server='www.google.com',
+ additional_headers=None, **kwargs):
+ """Creates a client for the Google Health service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ use_h9_sandbox: boolean (optional) True to issue requests against the
+ /h9 developer's sandbox.
+ server: string (optional) The name of the server to which a connection
+ will be opened.
+ additional_headers: dictionary (optional) Any additional headers which
+ should be included with CRUD operations.
+ kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ service = use_h9_sandbox and 'weaver' or 'health'
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service=service, source=source,
+ server=server, additional_headers=additional_headers, **kwargs)
+ self.ssl = True
+ self.use_h9_sandbox = use_h9_sandbox
+
+ def __get_service(self):
+ return self.use_h9_sandbox and 'h9' or 'health'
+
+ def GetProfileFeed(self, query=None, profile_id=None):
+ """Fetches the users Google Health profile feed.
+
+ Args:
+ query: HealthProfileQuery or string (optional) A query to use on the
+ profile feed. If None, a HealthProfileQuery is constructed.
+ profile_id: string (optional) The profile id to query the profile feed
+ with when using ClientLogin. Note: this parameter is ignored if
+ query is set.
+
+ Returns:
+ A gdata.health.ProfileFeed object containing the user's Health profile.
+ """
+ if query is None:
+ projection = profile_id and 'ui' or 'default'
+ uri = HealthProfileQuery(
+ service=self.__get_service(), projection=projection,
+ profile_id=profile_id).ToUri()
+ elif isinstance(query, HealthProfileQuery):
+ uri = query.ToUri()
+ else:
+ uri = query
+
+ return self.GetFeed(uri, converter=gdata.health.ProfileFeedFromString)
+
+ def GetProfileListFeed(self, query=None):
+ """Fetches the users Google Health profile feed.
+
+ Args:
+ query: HealthProfileListQuery or string (optional) A query to use
+ on the profile list feed. If None, a HealthProfileListQuery is
+ constructed to /health/feeds/profile/list or /h9/feeds/profile/list.
+
+ Returns:
+ A gdata.health.ProfileListFeed object containing the user's list
+ of profiles.
+ """
+ if not query:
+ uri = HealthProfileListQuery(service=self.__get_service()).ToUri()
+ elif isinstance(query, HealthProfileListQuery):
+ uri = query.ToUri()
+ else:
+ uri = query
+
+ return self.GetFeed(uri, converter=gdata.health.ProfileListFeedFromString)
+
+ def SendNotice(self, subject, body=None, content_type='html',
+ ccr=None, profile_id=None):
+ """Sends (posts) a notice to the user's Google Health profile.
+
+ Args:
+ subject: A string representing the message's subject line.
+ body: string (optional) The message body.
+ content_type: string (optional) The content type of the notice message
+ body. This parameter is only honored when a message body is
+ specified.
+ ccr: string (optional) The CCR XML document to reconcile into the
+ user's profile.
+ profile_id: string (optional) The profile id to work with when using
+ ClientLogin. Note: this parameter is ignored if query is set.
+
+ Returns:
+ A gdata.health.ProfileEntry object of the posted entry.
+ """
+ if body:
+ content = atom.Content(content_type=content_type, text=body)
+ else:
+ content = body
+
+ entry = gdata.GDataEntry(
+ title=atom.Title(text=subject), content=content,
+ extension_elements=[atom.ExtensionElementFromString(ccr)])
+
+ projection = profile_id and 'ui' or 'default'
+ query = HealthRegisterQuery(service=self.__get_service(),
+ projection=projection, profile_id=profile_id)
+ return self.Post(entry, query.ToUri(),
+ converter=gdata.health.ProfileEntryFromString)
+
+
+class HealthProfileQuery(gdata.service.Query):
+
+ """Object used to construct a URI to query the Google Health profile feed."""
+
+ def __init__(self, service='health', feed='feeds/profile',
+ projection='default', profile_id=None, text_query=None,
+ params=None, categories=None):
+ """Constructor for Health profile feed query.
+
+ Args:
+ service: string (optional) The service to query. Either 'health' or 'h9'.
+ feed: string (optional) The path for the feed. The default value is
+ 'feeds/profile'.
+ projection: string (optional) The visibility of the data. Possible values
+ are 'default' for AuthSub and 'ui' for ClientLogin. If this value
+ is set to 'ui', the profile_id parameter should also be set.
+ profile_id: string (optional) The profile id to query. This should only
+ be used when using ClientLogin.
+ text_query: str (optional) The contents of the q query parameter. The
+ contents of the text_query are URL escaped upon conversion to a URI.
+ Note: this parameter can only be used on the register feed using
+ ClientLogin.
+ params: dict (optional) Parameter value string pairs which become URL
+ params when translated to a URI. These parameters are added to
+ the query's items.
+ categories: list (optional) List of category strings which should be
+ included as query categories. See gdata.service.Query for
+ additional documentation.
+ """
+ self.service = service
+ self.profile_id = profile_id
+ self.projection = projection
+ gdata.service.Query.__init__(self, feed=feed, text_query=text_query,
+ params=params, categories=categories)
+
+ def ToUri(self):
+ """Generates a URI from the query parameters set in the object.
+
+ Returns:
+ A string containing the URI used to retrieve entries from the Health
+ profile feed.
+ """
+ old_feed = self.feed
+ self.feed = '/'.join([self.service, old_feed, self.projection])
+
+ if self.profile_id:
+ self.feed += '/' + self.profile_id
+ self.feed = '/%s' % (self.feed,)
+
+ new_feed = gdata.service.Query.ToUri(self)
+ self.feed = old_feed
+ return new_feed
+
+
+class HealthProfileListQuery(gdata.service.Query):
+
+ """Object used to construct a URI to query a Health profile list feed."""
+
+ def __init__(self, service='health', feed='feeds/profile/list'):
+ """Constructor for Health profile list feed query.
+
+ Args:
+ service: string (optional) The service to query. Either 'health' or 'h9'.
+ feed: string (optional) The path for the feed. The default value is
+ 'feeds/profile/list'.
+ """
+ gdata.service.Query.__init__(self, feed)
+ self.service = service
+
+ def ToUri(self):
+ """Generates a URI from the query parameters set in the object.
+
+ Returns:
+ A string containing the URI used to retrieve entries from the
+ profile list feed.
+ """
+ return '/%s' % ('/'.join([self.service, self.feed]),)
+
+
+class HealthRegisterQuery(gdata.service.Query):
+
+ """Object used to construct a URI to query a Health register/notice feed."""
+
+ def __init__(self, service='health', feed='feeds/register',
+ projection='default', profile_id=None):
+ """Constructor for Health profile list feed query.
+
+ Args:
+ service: string (optional) The service to query. Either 'health' or 'h9'.
+ feed: string (optional) The path for the feed. The default value is
+ 'feeds/register'.
+ projection: string (optional) The visibility of the data. Possible values
+ are 'default' for AuthSub and 'ui' for ClientLogin. If this value
+ is set to 'ui', the profile_id parameter should also be set.
+ profile_id: string (optional) The profile id to query. This should only
+ be used when using ClientLogin.
+ """
+ gdata.service.Query.__init__(self, feed)
+ self.service = service
+ self.projection = projection
+ self.profile_id = profile_id
+
+ def ToUri(self):
+ """Generates a URI from the query parameters set in the object.
+
+ Returns:
+ A string containing the URI needed to interact with the register feed.
+ """
+ old_feed = self.feed
+ self.feed = '/'.join([self.service, old_feed, self.projection])
+ new_feed = gdata.service.Query.ToUri(self)
+ self.feed = old_feed
+
+ if self.profile_id:
+ new_feed += '/' + self.profile_id
+ return '/%s' % (new_feed,)
diff --git a/src/gdata/marketplace/__init__.py b/src/gdata/marketplace/__init__.py
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/src/gdata/marketplace/__init__.py
@@ -0,0 +1 @@
+
diff --git a/src/gdata/marketplace/client.py b/src/gdata/marketplace/client.py
new file mode 100644
index 0000000..8ffc348
--- /dev/null
+++ b/src/gdata/marketplace/client.py
@@ -0,0 +1,160 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""LicensingClient simplifies Google Apps Marketplace Licensing API calls.
+
+LicensingClient extends gdata.client.GDClient to ease interaction with
+the Google Apps Marketplace Licensing API. These interactions include the ability
+to retrieve License informations for an application in the Google Apps Marketplace.
+"""
+
+
+__author__ = 'Alexandre Vivien <alex@simplecode.fr>'
+
+import gdata.marketplace.data
+import gdata.client
+import urllib
+
+
+# Feed URI template. This must end with a /
+# The strings in this template are eventually replaced with the API version
+# and Google Apps domain name, respectively.
+LICENSE_ROOT_URL = 'http://feedserver-enterprise.googleusercontent.com'
+LICENSE_FEED_TEMPLATE = '%s/license?bq=' % LICENSE_ROOT_URL
+LICENSE_NOTIFICATIONS_FEED_TEMPLATE = '%s/licensenotification?bq=' % LICENSE_ROOT_URL
+
+
+class LicensingClient(gdata.client.GDClient):
+ """Client extension for the Google Apps Marketplace Licensing API service.
+
+ Attributes:
+ host: string The hostname for the Google Apps Marketplace Licensing API service.
+ api_version: string The version of the Google Apps Marketplace Licensing API.
+ """
+
+ api_version = '1.0'
+ auth_service = 'apps'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['apps']
+ ssl = False
+
+ def __init__(self, domain, auth_token=None, **kwargs):
+ """Constructs a new client for the Google Apps Marketplace Licensing API.
+
+ Args:
+ domain: string The Google Apps domain with the application installed.
+ auth_token: (optional) gdata.gauth.OAuthToken which authorizes this client to retrieve the License information.
+ kwargs: The other parameters to pass to the gdata.client.GDClient constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.domain = domain
+
+ def make_license_feed_uri(self, app_id=None, params=None):
+ """Creates a license feed URI for the Google Apps Marketplace Licensing API.
+
+ Using this client's Google Apps domain, create a license feed URI for a particular application
+ in this domain. If params are provided, append them as GET params.
+
+ Args:
+ app_id: string The ID of the application for which to make a license feed URI.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+ Returns:
+ A string giving the URI for the application's license for this client's Google
+ Apps domain.
+ """
+ parameters = '[appid=%s][domain=%s]' % (app_id, self.domain)
+ uri = LICENSE_FEED_TEMPLATE + urllib.quote_plus(parameters)
+ if params:
+ uri += '&' + urllib.urlencode(params)
+ return uri
+
+ MakeLicenseFeedUri = make_license_feed_uri
+
+ def make_license_notifications_feed_uri(self, app_id=None, startdatetime=None, max_results=None, params=None):
+ """Creates a license notifications feed URI for the Google Apps Marketplace Licensing API.
+
+ Using this client's Google Apps domain, create a license notifications feed URI for a particular application.
+ If params are provided, append them as GET params.
+
+ Args:
+ app_id: string The ID of the application for which to make a license feed URI.
+ startdatetime: Start date to retrieve the License notifications.
+ max_results: Number of results per page. Maximum is 100.
+ params: dict (optional) key -> value params to append as GET vars to the
+ URI. Example: params={'start': 'my-resource-id'}
+ Returns:
+ A string giving the URI for the application's license notifications for this client's Google
+ Apps domain.
+ """
+ parameters = '[appid=%s]' % (app_id)
+ if startdatetime:
+ parameters += '[startdatetime=%s]' % startdatetime
+ else:
+ parameters += '[startdatetime=1970-01-01T00:00:00Z]'
+ if max_results:
+ parameters += '[max-results=%s]' % max_results
+ else:
+ parameters += '[max-results=100]'
+ uri = LICENSE_NOTIFICATIONS_FEED_TEMPLATE + urllib.quote_plus(parameters)
+ if params:
+ uri += '&' + urllib.urlencode(params)
+ return uri
+
+ MakeLicenseNotificationsFeedUri = make_license_notifications_feed_uri
+
+ def get_license(self, uri=None, app_id=None, **kwargs):
+ """Fetches the application's license by application ID.
+
+ Args:
+ uri: string The base URI of the feed from which to fetch the license.
+ app_id: string The string ID of the application for which to fetch the license.
+ kwargs: The other parameters to pass to gdata.client.GDClient.get_entry().
+
+ Returns:
+ A License feed object representing the license with the given
+ base URI and application ID.
+ """
+
+ if uri is None:
+ uri = self.MakeLicenseFeedUri(app_id)
+ return self.get_feed(uri,
+ desired_class=gdata.marketplace.data.LicenseFeed,
+ **kwargs)
+
+ GetLicense = get_license
+
+ def get_license_notifications(self, uri=None, app_id=None, startdatetime=None, max_results=None, **kwargs):
+ """Fetches the application's license notifications by application ID.
+
+ Args:
+ uri: string The base URI of the feed from which to fetch the license.
+ app_id: string The string ID of the application for which to fetch the license.
+ startdatetime: Start date to retrieve the License notifications.
+ max_results: Number of results per page. Maximum is 100.
+ kwargs: The other parameters to pass to gdata.client.GDClient.get_entry().
+
+ Returns:
+ A License feed object representing the license notifications with the given
+ base URI and application ID.
+ """
+
+ if uri is None:
+ uri = self.MakeLicenseNotificationsFeedUri(app_id, startdatetime, max_results)
+ return self.get_feed(uri,
+ desired_class=gdata.marketplace.data.LicenseFeed,
+ **kwargs)
+
+ GetLicenseNotifications = get_license_notifications
diff --git a/src/gdata/marketplace/data.py b/src/gdata/marketplace/data.py
new file mode 100644
index 0000000..e8c76a2
--- /dev/null
+++ b/src/gdata/marketplace/data.py
@@ -0,0 +1,115 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model for parsing and generating XML for the Google Apps Marketplace Licensing API."""
+
+
+__author__ = 'Alexandre Vivien <alex@simplecode.fr>'
+
+
+import atom.core
+import gdata
+import gdata.data
+
+
+LICENSES_NAMESPACE = 'http://www.w3.org/2005/Atom'
+LICENSES_TEMPLATE = '{%s}%%s' % LICENSES_NAMESPACE
+
+
+class Enabled(atom.core.XmlElement):
+ """ """
+
+ _qname = LICENSES_TEMPLATE % 'enabled'
+
+
+class Id(atom.core.XmlElement):
+ """ """
+
+ _qname = LICENSES_TEMPLATE % 'id'
+
+
+class CustomerId(atom.core.XmlElement):
+ """ """
+
+ _qname = LICENSES_TEMPLATE % 'customerid'
+
+
+class DomainName(atom.core.XmlElement):
+ """ """
+
+ _qname = LICENSES_TEMPLATE % 'domainname'
+
+
+class InstallerEmail(atom.core.XmlElement):
+ """ """
+
+ _qname = LICENSES_TEMPLATE % 'installeremail'
+
+
+class TosAcceptanceTime(atom.core.XmlElement):
+ """ """
+
+ _qname = LICENSES_TEMPLATE % 'tosacceptancetime'
+
+
+class LastChangeTime(atom.core.XmlElement):
+ """ """
+
+ _qname = LICENSES_TEMPLATE % 'lastchangetime'
+
+
+class ProductConfigId(atom.core.XmlElement):
+ """ """
+
+ _qname = LICENSES_TEMPLATE % 'productconfigid'
+
+
+class State(atom.core.XmlElement):
+ """ """
+
+ _qname = LICENSES_TEMPLATE % 'state'
+
+
+class Entity(atom.core.XmlElement):
+ """ The entity representing the License. """
+
+ _qname = LICENSES_TEMPLATE % 'entity'
+
+ enabled = Enabled
+ id = Id
+ customer_id = CustomerId
+ domain_name = DomainName
+ installer_email = InstallerEmail
+ tos_acceptance_time = TosAcceptanceTime
+ last_change_time = LastChangeTime
+ product_config_id = ProductConfigId
+ state = State
+
+
+class Content(atom.data.Content):
+ entity = Entity
+
+class LicenseEntry(gdata.data.GDEntry):
+ """ Represents a LicenseEntry object. """
+
+ content = Content
+
+
+class LicenseFeed(gdata.data.GDFeed):
+ """ Represents a feed of LicenseEntry objects. """
+
+ # Override entry so that this feed knows how to type its list of entries.
+ entry = [LicenseEntry]
diff --git a/src/gdata/media/__init__.py b/src/gdata/media/__init__.py
new file mode 100644
index 0000000..e6af1ae
--- /dev/null
+++ b/src/gdata/media/__init__.py
@@ -0,0 +1,355 @@
+# -*-*- encoding: utf-8 -*-*-
+#
+# This is gdata.photos.media, implementing parts of the MediaRSS spec in gdata structures
+#
+# $Id: __init__.py 81 2007-10-03 14:41:42Z havard.gulldahl $
+#
+# Copyright 2007 Håvard Gulldahl
+# Portions copyright 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Essential attributes of photos in Google Photos/Picasa Web Albums are
+expressed using elements from the `media' namespace, defined in the
+MediaRSS specification[1].
+
+Due to copyright issues, the elements herein are documented sparingly, please
+consult with the Google Photos API Reference Guide[2], alternatively the
+official MediaRSS specification[1] for details.
+(If there is a version conflict between the two sources, stick to the
+Google Photos API).
+
+[1]: http://search.yahoo.com/mrss (version 1.1.1)
+[2]: http://code.google.com/apis/picasaweb/reference.html#media_reference
+
+Keep in mind that Google Photos only uses a subset of the MediaRSS elements
+(and some of the attributes are trimmed down, too):
+
+media:content
+media:credit
+media:description
+media:group
+media:keywords
+media:thumbnail
+media:title
+"""
+
+__author__ = u'havard@gulldahl.no'# (Håvard Gulldahl)' #BUG: api chokes on non-ascii chars in __author__
+__license__ = 'Apache License v2'
+
+
+import atom
+import gdata
+
+MEDIA_NAMESPACE = 'http://search.yahoo.com/mrss/'
+YOUTUBE_NAMESPACE = 'http://gdata.youtube.com/schemas/2007'
+
+
+class MediaBaseElement(atom.AtomBase):
+ """Base class for elements in the MEDIA_NAMESPACE.
+ To add new elements, you only need to add the element tag name to self._tag
+ """
+
+ _tag = ''
+ _namespace = MEDIA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, name=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Content(MediaBaseElement):
+ """(attribute container) This element describes the original content,
+ e.g. an image or a video. There may be multiple Content elements
+ in a media:Group.
+
+ For example, a video may have a
+ <media:content medium="image"> element that specifies a JPEG
+ representation of the video, and a <media:content medium="video">
+ element that specifies the URL of the video itself.
+
+ Attributes:
+ url: non-ambigous reference to online object
+ width: width of the object frame, in pixels
+ height: width of the object frame, in pixels
+ medium: one of `image' or `video', allowing the api user to quickly
+ determine the object's type
+ type: Internet media Type[1] (a.k.a. mime type) of the object -- a more
+ verbose way of determining the media type. To set the type member
+ in the contructor, use the content_type parameter.
+ (optional) fileSize: the size of the object, in bytes
+
+ [1]: http://en.wikipedia.org/wiki/Internet_media_type
+ """
+
+ _tag = 'content'
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['url'] = 'url'
+ _attributes['width'] = 'width'
+ _attributes['height'] = 'height'
+ _attributes['medium'] = 'medium'
+ _attributes['type'] = 'type'
+ _attributes['fileSize'] = 'fileSize'
+
+ def __init__(self, url=None, width=None, height=None,
+ medium=None, content_type=None, fileSize=None, format=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ MediaBaseElement.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+ self.url = url
+ self.width = width
+ self.height = height
+ self.medium = medium
+ self.type = content_type
+ self.fileSize = fileSize
+
+
+def ContentFromString(xml_string):
+ return atom.CreateClassFromXMLString(Content, xml_string)
+
+
+class Credit(MediaBaseElement):
+ """(string) Contains the nickname of the user who created the content,
+ e.g. `Liz Bennet'.
+
+ This is a user-specified value that should be used when referring to
+ the user by name.
+
+ Note that none of the attributes from the MediaRSS spec are supported.
+ """
+
+ _tag = 'credit'
+
+
+def CreditFromString(xml_string):
+ return atom.CreateClassFromXMLString(Credit, xml_string)
+
+
+class Description(MediaBaseElement):
+ """(string) A description of the media object.
+ Either plain unicode text, or entity-encoded html (look at the `type'
+ attribute).
+
+ E.g `A set of photographs I took while vacationing in Italy.'
+
+ For `api' projections, the description is in plain text;
+ for `base' projections, the description is in HTML.
+
+ Attributes:
+ type: either `text' or `html'. To set the type member in the contructor,
+ use the description_type parameter.
+ """
+
+ _tag = 'description'
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['type'] = 'type'
+ def __init__(self, description_type=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ MediaBaseElement.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+ self.type = description_type
+
+
+def DescriptionFromString(xml_string):
+ return atom.CreateClassFromXMLString(Description, xml_string)
+
+
+class Keywords(MediaBaseElement):
+ """(string) Lists the tags associated with the entry,
+ e.g `italy, vacation, sunset'.
+
+ Contains a comma-separated list of tags that have been added to the photo, or
+ all tags that have been added to photos in the album.
+ """
+
+ _tag = 'keywords'
+
+
+def KeywordsFromString(xml_string):
+ return atom.CreateClassFromXMLString(Keywords, xml_string)
+
+
+class Thumbnail(MediaBaseElement):
+ """(attributes) Contains the URL of a thumbnail of a photo or album cover.
+
+ There can be multiple <media:thumbnail> elements for a given <media:group>;
+ for example, a given item may have multiple thumbnails at different sizes.
+ Photos generally have two thumbnails at different sizes;
+ albums generally have one cropped thumbnail.
+
+ If the thumbsize parameter is set to the initial query, this element points
+ to thumbnails of the requested sizes; otherwise the thumbnails are the
+ default thumbnail size.
+
+ This element must not be confused with the <gphoto:thumbnail> element.
+
+ Attributes:
+ url: The URL of the thumbnail image.
+ height: The height of the thumbnail image, in pixels.
+ width: The width of the thumbnail image, in pixels.
+ """
+
+ _tag = 'thumbnail'
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['url'] = 'url'
+ _attributes['width'] = 'width'
+ _attributes['height'] = 'height'
+ def __init__(self, url=None, width=None, height=None,
+ extension_attributes=None, text=None, extension_elements=None):
+ MediaBaseElement.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+ self.url = url
+ self.width = width
+ self.height = height
+
+
+def ThumbnailFromString(xml_string):
+ return atom.CreateClassFromXMLString(Thumbnail, xml_string)
+
+
+class Title(MediaBaseElement):
+ """(string) Contains the title of the entry's media content, in plain text.
+
+ Attributes:
+ type: Always set to plain. To set the type member in the constructor, use
+ the title_type parameter.
+ """
+
+ _tag = 'title'
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['type'] = 'type'
+ def __init__(self, title_type=None,
+ extension_attributes=None, text=None, extension_elements=None):
+ MediaBaseElement.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+ self.type = title_type
+
+
+def TitleFromString(xml_string):
+ return atom.CreateClassFromXMLString(Title, xml_string)
+
+
+class Player(MediaBaseElement):
+ """(string) Contains the embeddable player URL for the entry's media content
+ if the media is a video.
+
+ Attributes:
+ url: Always set to plain
+ """
+
+ _tag = 'player'
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['url'] = 'url'
+
+ def __init__(self, player_url=None,
+ extension_attributes=None, extension_elements=None):
+ MediaBaseElement.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.url= player_url
+
+
+class Private(atom.AtomBase):
+ """The YouTube Private element"""
+ _tag = 'private'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Duration(atom.AtomBase):
+ """The YouTube Duration element"""
+ _tag = 'duration'
+ _namespace = YOUTUBE_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['seconds'] = 'seconds'
+
+
+class Category(MediaBaseElement):
+ """The mediagroup:category element"""
+
+ _tag = 'category'
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['term'] = 'term'
+ _attributes['scheme'] = 'scheme'
+ _attributes['label'] = 'label'
+
+ def __init__(self, term=None, scheme=None, label=None, text=None,
+ extension_elements=None, extension_attributes=None):
+ """Constructor for Category
+
+ Args:
+ term: str
+ scheme: str
+ label: str
+ text: str The text data in the this element
+ extension_elements: list A list of ExtensionElement instances
+ extension_attributes: dict A dictionary of attribute value string pairs
+ """
+
+ self.term = term
+ self.scheme = scheme
+ self.label = label
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+class Group(MediaBaseElement):
+ """Container element for all media elements.
+ The <media:group> element can appear as a child of an album, photo or
+ video entry."""
+
+ _tag = 'group'
+ _children = atom.AtomBase._children.copy()
+ _children['{%s}content' % MEDIA_NAMESPACE] = ('content', [Content,])
+ _children['{%s}credit' % MEDIA_NAMESPACE] = ('credit', Credit)
+ _children['{%s}description' % MEDIA_NAMESPACE] = ('description', Description)
+ _children['{%s}keywords' % MEDIA_NAMESPACE] = ('keywords', Keywords)
+ _children['{%s}thumbnail' % MEDIA_NAMESPACE] = ('thumbnail', [Thumbnail,])
+ _children['{%s}title' % MEDIA_NAMESPACE] = ('title', Title)
+ _children['{%s}category' % MEDIA_NAMESPACE] = ('category', [Category,])
+ _children['{%s}duration' % YOUTUBE_NAMESPACE] = ('duration', Duration)
+ _children['{%s}private' % YOUTUBE_NAMESPACE] = ('private', Private)
+ _children['{%s}player' % MEDIA_NAMESPACE] = ('player', Player)
+
+ def __init__(self, content=None, credit=None, description=None, keywords=None,
+ thumbnail=None, title=None, duration=None, private=None,
+ category=None, player=None, extension_elements=None,
+ extension_attributes=None, text=None):
+
+ MediaBaseElement.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+ self.content=content
+ self.credit=credit
+ self.description=description
+ self.keywords=keywords
+ self.thumbnail=thumbnail or []
+ self.title=title
+ self.duration=duration
+ self.private=private
+ self.category=category or []
+ self.player=player
+
+
+def GroupFromString(xml_string):
+ return atom.CreateClassFromXMLString(Group, xml_string)
diff --git a/src/gdata/media/data.py b/src/gdata/media/data.py
new file mode 100644
index 0000000..bb5d2c8
--- /dev/null
+++ b/src/gdata/media/data.py
@@ -0,0 +1,159 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains the data classes of the Yahoo! Media RSS Extension"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+
+
+MEDIA_TEMPLATE = '{http://search.yahoo.com/mrss//}%s'
+
+
+class MediaCategory(atom.core.XmlElement):
+ """Describes a media category."""
+ _qname = MEDIA_TEMPLATE % 'category'
+ scheme = 'scheme'
+ label = 'label'
+
+
+class MediaCopyright(atom.core.XmlElement):
+ """Describes a media copyright."""
+ _qname = MEDIA_TEMPLATE % 'copyright'
+ url = 'url'
+
+
+class MediaCredit(atom.core.XmlElement):
+ """Describes a media credit."""
+ _qname = MEDIA_TEMPLATE % 'credit'
+ role = 'role'
+ scheme = 'scheme'
+
+
+class MediaDescription(atom.core.XmlElement):
+ """Describes a media description."""
+ _qname = MEDIA_TEMPLATE % 'description'
+ type = 'type'
+
+
+class MediaHash(atom.core.XmlElement):
+ """Describes a media hash."""
+ _qname = MEDIA_TEMPLATE % 'hash'
+ algo = 'algo'
+
+
+class MediaKeywords(atom.core.XmlElement):
+ """Describes a media keywords."""
+ _qname = MEDIA_TEMPLATE % 'keywords'
+
+
+class MediaPlayer(atom.core.XmlElement):
+ """Describes a media player."""
+ _qname = MEDIA_TEMPLATE % 'player'
+ height = 'height'
+ width = 'width'
+ url = 'url'
+
+
+class MediaRating(atom.core.XmlElement):
+ """Describes a media rating."""
+ _qname = MEDIA_TEMPLATE % 'rating'
+ scheme = 'scheme'
+
+
+class MediaRestriction(atom.core.XmlElement):
+ """Describes a media restriction."""
+ _qname = MEDIA_TEMPLATE % 'restriction'
+ relationship = 'relationship'
+ type = 'type'
+
+
+class MediaText(atom.core.XmlElement):
+ """Describes a media text."""
+ _qname = MEDIA_TEMPLATE % 'text'
+ end = 'end'
+ lang = 'lang'
+ type = 'type'
+ start = 'start'
+
+
+class MediaThumbnail(atom.core.XmlElement):
+ """Describes a media thumbnail."""
+ _qname = MEDIA_TEMPLATE % 'thumbnail'
+ time = 'time'
+ url = 'url'
+ width = 'width'
+ height = 'height'
+
+
+class MediaTitle(atom.core.XmlElement):
+ """Describes a media title."""
+ _qname = MEDIA_TEMPLATE % 'title'
+ type = 'type'
+
+
+class MediaContent(atom.core.XmlElement):
+ """Describes a media content."""
+ _qname = MEDIA_TEMPLATE % 'content'
+ bitrate = 'bitrate'
+ is_default = 'isDefault'
+ medium = 'medium'
+ height = 'height'
+ credit = [MediaCredit]
+ language = 'language'
+ hash = MediaHash
+ width = 'width'
+ player = MediaPlayer
+ url = 'url'
+ file_size = 'fileSize'
+ channels = 'channels'
+ expression = 'expression'
+ text = [MediaText]
+ samplingrate = 'samplingrate'
+ title = MediaTitle
+ category = [MediaCategory]
+ rating = [MediaRating]
+ type = 'type'
+ description = MediaDescription
+ framerate = 'framerate'
+ thumbnail = [MediaThumbnail]
+ duration = 'duration'
+ copyright = MediaCopyright
+ keywords = MediaKeywords
+ restriction = [MediaRestriction]
+
+
+class MediaGroup(atom.core.XmlElement):
+ """Describes a media group."""
+ _qname = MEDIA_TEMPLATE % 'group'
+ credit = [MediaCredit]
+ content = [MediaContent]
+ copyright = MediaCopyright
+ description = MediaDescription
+ category = [MediaCategory]
+ player = MediaPlayer
+ rating = [MediaRating]
+ hash = MediaHash
+ title = MediaTitle
+ keywords = MediaKeywords
+ restriction = [MediaRestriction]
+ thumbnail = [MediaThumbnail]
+ text = [MediaText]
+
+
diff --git a/src/gdata/notebook/__init__.py b/src/gdata/notebook/__init__.py
new file mode 100644
index 0000000..22071f7
--- /dev/null
+++ b/src/gdata/notebook/__init__.py
@@ -0,0 +1,15 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/src/gdata/notebook/data.py b/src/gdata/notebook/data.py
new file mode 100644
index 0000000..53405e0
--- /dev/null
+++ b/src/gdata/notebook/data.py
@@ -0,0 +1,55 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains the data classes of the Google Notebook Data API"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+import atom.data
+import gdata.data
+import gdata.opensearch.data
+
+
+NB_TEMPLATE = '{http://schemas.google.com/notes/2008/}%s'
+
+
+class ComesAfter(atom.core.XmlElement):
+ """Preceding element."""
+ _qname = NB_TEMPLATE % 'comesAfter'
+ id = 'id'
+
+
+class NoteEntry(gdata.data.GDEntry):
+ """Describes a note entry in the feed of a user's notebook."""
+
+
+class NotebookFeed(gdata.data.GDFeed):
+ """Describes a notebook feed."""
+ entry = [NoteEntry]
+
+
+class NotebookListEntry(gdata.data.GDEntry):
+ """Describes a note list entry in the feed of a user's list of public notebooks."""
+
+
+class NotebookListFeed(gdata.data.GDFeed):
+ """Describes a notebook list feed."""
+ entry = [NotebookListEntry]
+
+
diff --git a/src/gdata/oauth/CHANGES.txt b/src/gdata/oauth/CHANGES.txt
new file mode 100755
index 0000000..7c2b92c
--- /dev/null
+++ b/src/gdata/oauth/CHANGES.txt
@@ -0,0 +1,17 @@
+1. Moved oauth.py to __init__.py
+
+2. Refactored __init__.py for compatibility with python 2.2 (Issue 59)
+
+3. Refactored rsa.py for compatibility with python 2.2 (Issue 59)
+
+4. Refactored OAuthRequest.from_token_and_callback since the callback url was
+getting double url-encoding the callback url in place of single. (Issue 43)
+
+5. Added build_signature_base_string method to rsa.py since it used the
+implementation of this method from oauth.OAuthSignatureMethod_HMAC_SHA1 which
+was incorrect since it enforced the presence of a consumer secret and a token
+secret. Also, changed its super class from oauth.OAuthSignatureMethod_HMAC_SHA1
+to oauth.OAuthSignatureMethod (Issue 64)
+
+6. Refactored <OAuthRequest>.to_header method since it returned non-oauth params
+as well which was incorrect. (Issue 31)
\ No newline at end of file
diff --git a/src/gdata/oauth/__init__.py b/src/gdata/oauth/__init__.py
new file mode 100755
index 0000000..44d9c7a
--- /dev/null
+++ b/src/gdata/oauth/__init__.py
@@ -0,0 +1,529 @@
+import cgi
+import urllib
+import time
+import random
+import urlparse
+import hmac
+import binascii
+
+VERSION = '1.0' # Hi Blaine!
+HTTP_METHOD = 'GET'
+SIGNATURE_METHOD = 'PLAINTEXT'
+
+# Generic exception class
+class OAuthError(RuntimeError):
+ def __init__(self, message='OAuth error occured.'):
+ self.message = message
+
+# optional WWW-Authenticate header (401 error)
+def build_authenticate_header(realm=''):
+ return {'WWW-Authenticate': 'OAuth realm="%s"' % realm}
+
+# url escape
+def escape(s):
+ # escape '/' too
+ return urllib.quote(s, safe='~')
+
+# util function: current timestamp
+# seconds since epoch (UTC)
+def generate_timestamp():
+ return int(time.time())
+
+# util function: nonce
+# pseudorandom number
+def generate_nonce(length=8):
+ return ''.join([str(random.randint(0, 9)) for i in range(length)])
+
+# OAuthConsumer is a data type that represents the identity of the Consumer
+# via its shared secret with the Service Provider.
+class OAuthConsumer(object):
+ key = None
+ secret = None
+
+ def __init__(self, key, secret):
+ self.key = key
+ self.secret = secret
+
+# OAuthToken is a data type that represents an End User via either an access
+# or request token.
+class OAuthToken(object):
+ # access tokens and request tokens
+ key = None
+ secret = None
+
+ '''
+ key = the token
+ secret = the token secret
+ '''
+ def __init__(self, key, secret):
+ self.key = key
+ self.secret = secret
+
+ def to_string(self):
+ return urllib.urlencode({'oauth_token': self.key, 'oauth_token_secret': self.secret})
+
+ # return a token from something like:
+ # oauth_token_secret=digg&oauth_token=digg
+ def from_string(s):
+ params = cgi.parse_qs(s, keep_blank_values=False)
+ key = params['oauth_token'][0]
+ secret = params['oauth_token_secret'][0]
+ return OAuthToken(key, secret)
+ from_string = staticmethod(from_string)
+
+ def __str__(self):
+ return self.to_string()
+
+# OAuthRequest represents the request and can be serialized
+class OAuthRequest(object):
+ '''
+ OAuth parameters:
+ - oauth_consumer_key
+ - oauth_token
+ - oauth_signature_method
+ - oauth_signature
+ - oauth_timestamp
+ - oauth_nonce
+ - oauth_version
+ ... any additional parameters, as defined by the Service Provider.
+ '''
+ parameters = None # oauth parameters
+ http_method = HTTP_METHOD
+ http_url = None
+ version = VERSION
+
+ def __init__(self, http_method=HTTP_METHOD, http_url=None, parameters=None):
+ self.http_method = http_method
+ self.http_url = http_url
+ self.parameters = parameters or {}
+
+ def set_parameter(self, parameter, value):
+ self.parameters[parameter] = value
+
+ def get_parameter(self, parameter):
+ try:
+ return self.parameters[parameter]
+ except:
+ raise OAuthError('Parameter not found: %s' % parameter)
+
+ def _get_timestamp_nonce(self):
+ return self.get_parameter('oauth_timestamp'), self.get_parameter('oauth_nonce')
+
+ # get any non-oauth parameters
+ def get_nonoauth_parameters(self):
+ parameters = {}
+ for k, v in self.parameters.iteritems():
+ # ignore oauth parameters
+ if k.find('oauth_') < 0:
+ parameters[k] = v
+ return parameters
+
+ # serialize as a header for an HTTPAuth request
+ def to_header(self, realm=''):
+ auth_header = 'OAuth realm="%s"' % realm
+ # add the oauth parameters
+ if self.parameters:
+ for k, v in self.parameters.iteritems():
+ if k[:6] == 'oauth_':
+ auth_header += ', %s="%s"' % (k, escape(str(v)))
+ return {'Authorization': auth_header}
+
+ # serialize as post data for a POST request
+ def to_postdata(self):
+ return '&'.join(['%s=%s' % (escape(str(k)), escape(str(v))) for k, v in self.parameters.iteritems()])
+
+ # serialize as a url for a GET request
+ def to_url(self):
+ return '%s?%s' % (self.get_normalized_http_url(), self.to_postdata())
+
+ # return a string that consists of all the parameters that need to be signed
+ def get_normalized_parameters(self):
+ params = self.parameters
+ try:
+ # exclude the signature if it exists
+ del params['oauth_signature']
+ except:
+ pass
+ key_values = params.items()
+ # sort lexicographically, first after key, then after value
+ key_values.sort()
+ # combine key value pairs in string and escape
+ return '&'.join(['%s=%s' % (escape(str(k)), escape(str(v))) for k, v in key_values])
+
+ # just uppercases the http method
+ def get_normalized_http_method(self):
+ return self.http_method.upper()
+
+ # parses the url and rebuilds it to be scheme://host/path
+ def get_normalized_http_url(self):
+ parts = urlparse.urlparse(self.http_url)
+ host = parts[1].lower()
+ if host.endswith(':80') or host.endswith(':443'):
+ host = host.split(':')[0]
+ url_string = '%s://%s%s' % (parts[0], host, parts[2]) # scheme, netloc, path
+ return url_string
+
+ # set the signature parameter to the result of build_signature
+ def sign_request(self, signature_method, consumer, token):
+ # set the signature method
+ self.set_parameter('oauth_signature_method', signature_method.get_name())
+ # set the signature
+ self.set_parameter('oauth_signature', self.build_signature(signature_method, consumer, token))
+
+ def build_signature(self, signature_method, consumer, token):
+ # call the build signature method within the signature method
+ return signature_method.build_signature(self, consumer, token)
+
+ def from_request(http_method, http_url, headers=None, parameters=None, query_string=None):
+ # combine multiple parameter sources
+ if parameters is None:
+ parameters = {}
+
+ # headers
+ if headers and 'Authorization' in headers:
+ auth_header = headers['Authorization']
+ # check that the authorization header is OAuth
+ if auth_header.index('OAuth') > -1:
+ try:
+ # get the parameters from the header
+ header_params = OAuthRequest._split_header(auth_header)
+ parameters.update(header_params)
+ except:
+ raise OAuthError('Unable to parse OAuth parameters from Authorization header.')
+
+ # GET or POST query string
+ if query_string:
+ query_params = OAuthRequest._split_url_string(query_string)
+ parameters.update(query_params)
+
+ # URL parameters
+ param_str = urlparse.urlparse(http_url)[4] # query
+ url_params = OAuthRequest._split_url_string(param_str)
+ parameters.update(url_params)
+
+ if parameters:
+ return OAuthRequest(http_method, http_url, parameters)
+
+ return None
+ from_request = staticmethod(from_request)
+
+ def from_consumer_and_token(oauth_consumer, token=None, http_method=HTTP_METHOD, http_url=None, parameters=None):
+ if not parameters:
+ parameters = {}
+
+ defaults = {
+ 'oauth_consumer_key': oauth_consumer.key,
+ 'oauth_timestamp': generate_timestamp(),
+ 'oauth_nonce': generate_nonce(),
+ 'oauth_version': OAuthRequest.version,
+ }
+
+ defaults.update(parameters)
+ parameters = defaults
+
+ if token:
+ parameters['oauth_token'] = token.key
+
+ return OAuthRequest(http_method, http_url, parameters)
+ from_consumer_and_token = staticmethod(from_consumer_and_token)
+
+ def from_token_and_callback(token, callback=None, http_method=HTTP_METHOD, http_url=None, parameters=None):
+ if not parameters:
+ parameters = {}
+
+ parameters['oauth_token'] = token.key
+
+ if callback:
+ parameters['oauth_callback'] = callback
+
+ return OAuthRequest(http_method, http_url, parameters)
+ from_token_and_callback = staticmethod(from_token_and_callback)
+
+ # util function: turn Authorization: header into parameters, has to do some unescaping
+ def _split_header(header):
+ params = {}
+ parts = header[6:].split(',')
+ for param in parts:
+ # ignore realm parameter
+ if param.find('realm') > -1:
+ continue
+ # remove whitespace
+ param = param.strip()
+ # split key-value
+ param_parts = param.split('=', 1)
+ # remove quotes and unescape the value
+ params[param_parts[0]] = urllib.unquote(param_parts[1].strip('\"'))
+ return params
+ _split_header = staticmethod(_split_header)
+
+ # util function: turn url string into parameters, has to do some unescaping
+ # even empty values should be included
+ def _split_url_string(param_str):
+ parameters = cgi.parse_qs(param_str, keep_blank_values=True)
+ for k, v in parameters.iteritems():
+ parameters[k] = urllib.unquote(v[0])
+ return parameters
+ _split_url_string = staticmethod(_split_url_string)
+
+# OAuthServer is a worker to check a requests validity against a data store
+class OAuthServer(object):
+ timestamp_threshold = 300 # in seconds, five minutes
+ version = VERSION
+ signature_methods = None
+ data_store = None
+
+ def __init__(self, data_store=None, signature_methods=None):
+ self.data_store = data_store
+ self.signature_methods = signature_methods or {}
+
+ def set_data_store(self, oauth_data_store):
+ self.data_store = oauth_data_store
+
+ def get_data_store(self):
+ return self.data_store
+
+ def add_signature_method(self, signature_method):
+ self.signature_methods[signature_method.get_name()] = signature_method
+ return self.signature_methods
+
+ # process a request_token request
+ # returns the request token on success
+ def fetch_request_token(self, oauth_request):
+ try:
+ # get the request token for authorization
+ token = self._get_token(oauth_request, 'request')
+ except OAuthError:
+ # no token required for the initial token request
+ version = self._get_version(oauth_request)
+ consumer = self._get_consumer(oauth_request)
+ self._check_signature(oauth_request, consumer, None)
+ # fetch a new token
+ token = self.data_store.fetch_request_token(consumer)
+ return token
+
+ # process an access_token request
+ # returns the access token on success
+ def fetch_access_token(self, oauth_request):
+ version = self._get_version(oauth_request)
+ consumer = self._get_consumer(oauth_request)
+ # get the request token
+ token = self._get_token(oauth_request, 'request')
+ self._check_signature(oauth_request, consumer, token)
+ new_token = self.data_store.fetch_access_token(consumer, token)
+ return new_token
+
+ # verify an api call, checks all the parameters
+ def verify_request(self, oauth_request):
+ # -> consumer and token
+ version = self._get_version(oauth_request)
+ consumer = self._get_consumer(oauth_request)
+ # get the access token
+ token = self._get_token(oauth_request, 'access')
+ self._check_signature(oauth_request, consumer, token)
+ parameters = oauth_request.get_nonoauth_parameters()
+ return consumer, token, parameters
+
+ # authorize a request token
+ def authorize_token(self, token, user):
+ return self.data_store.authorize_request_token(token, user)
+
+ # get the callback url
+ def get_callback(self, oauth_request):
+ return oauth_request.get_parameter('oauth_callback')
+
+ # optional support for the authenticate header
+ def build_authenticate_header(self, realm=''):
+ return {'WWW-Authenticate': 'OAuth realm="%s"' % realm}
+
+ # verify the correct version request for this server
+ def _get_version(self, oauth_request):
+ try:
+ version = oauth_request.get_parameter('oauth_version')
+ except:
+ version = VERSION
+ if version and version != self.version:
+ raise OAuthError('OAuth version %s not supported.' % str(version))
+ return version
+
+ # figure out the signature with some defaults
+ def _get_signature_method(self, oauth_request):
+ try:
+ signature_method = oauth_request.get_parameter('oauth_signature_method')
+ except:
+ signature_method = SIGNATURE_METHOD
+ try:
+ # get the signature method object
+ signature_method = self.signature_methods[signature_method]
+ except:
+ signature_method_names = ', '.join(self.signature_methods.keys())
+ raise OAuthError('Signature method %s not supported try one of the following: %s' % (signature_method, signature_method_names))
+
+ return signature_method
+
+ def _get_consumer(self, oauth_request):
+ consumer_key = oauth_request.get_parameter('oauth_consumer_key')
+ if not consumer_key:
+ raise OAuthError('Invalid consumer key.')
+ consumer = self.data_store.lookup_consumer(consumer_key)
+ if not consumer:
+ raise OAuthError('Invalid consumer.')
+ return consumer
+
+ # try to find the token for the provided request token key
+ def _get_token(self, oauth_request, token_type='access'):
+ token_field = oauth_request.get_parameter('oauth_token')
+ consumer = self._get_consumer(oauth_request)
+ token = self.data_store.lookup_token(consumer, token_type, token_field)
+ if not token:
+ raise OAuthError('Invalid %s token: %s' % (token_type, token_field))
+ return token
+
+ def _check_signature(self, oauth_request, consumer, token):
+ timestamp, nonce = oauth_request._get_timestamp_nonce()
+ self._check_timestamp(timestamp)
+ self._check_nonce(consumer, token, nonce)
+ signature_method = self._get_signature_method(oauth_request)
+ try:
+ signature = oauth_request.get_parameter('oauth_signature')
+ except:
+ raise OAuthError('Missing signature.')
+ # validate the signature
+ valid_sig = signature_method.check_signature(oauth_request, consumer, token, signature)
+ if not valid_sig:
+ key, base = signature_method.build_signature_base_string(oauth_request, consumer, token)
+ raise OAuthError('Invalid signature. Expected signature base string: %s' % base)
+ built = signature_method.build_signature(oauth_request, consumer, token)
+
+ def _check_timestamp(self, timestamp):
+ # verify that timestamp is recentish
+ timestamp = int(timestamp)
+ now = int(time.time())
+ lapsed = now - timestamp
+ if lapsed > self.timestamp_threshold:
+ raise OAuthError('Expired timestamp: given %d and now %s has a greater difference than threshold %d' % (timestamp, now, self.timestamp_threshold))
+
+ def _check_nonce(self, consumer, token, nonce):
+ # verify that the nonce is uniqueish
+ nonce = self.data_store.lookup_nonce(consumer, token, nonce)
+ if nonce:
+ raise OAuthError('Nonce already used: %s' % str(nonce))
+
+# OAuthClient is a worker to attempt to execute a request
+class OAuthClient(object):
+ consumer = None
+ token = None
+
+ def __init__(self, oauth_consumer, oauth_token):
+ self.consumer = oauth_consumer
+ self.token = oauth_token
+
+ def get_consumer(self):
+ return self.consumer
+
+ def get_token(self):
+ return self.token
+
+ def fetch_request_token(self, oauth_request):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def fetch_access_token(self, oauth_request):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def access_resource(self, oauth_request):
+ # -> some protected resource
+ raise NotImplementedError
+
+# OAuthDataStore is a database abstraction used to lookup consumers and tokens
+class OAuthDataStore(object):
+
+ def lookup_consumer(self, key):
+ # -> OAuthConsumer
+ raise NotImplementedError
+
+ def lookup_token(self, oauth_consumer, token_type, token_token):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def lookup_nonce(self, oauth_consumer, oauth_token, nonce, timestamp):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def fetch_request_token(self, oauth_consumer):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def fetch_access_token(self, oauth_consumer, oauth_token):
+ # -> OAuthToken
+ raise NotImplementedError
+
+ def authorize_request_token(self, oauth_token, user):
+ # -> OAuthToken
+ raise NotImplementedError
+
+# OAuthSignatureMethod is a strategy class that implements a signature method
+class OAuthSignatureMethod(object):
+ def get_name(self):
+ # -> str
+ raise NotImplementedError
+
+ def build_signature_base_string(self, oauth_request, oauth_consumer, oauth_token):
+ # -> str key, str raw
+ raise NotImplementedError
+
+ def build_signature(self, oauth_request, oauth_consumer, oauth_token):
+ # -> str
+ raise NotImplementedError
+
+ def check_signature(self, oauth_request, consumer, token, signature):
+ built = self.build_signature(oauth_request, consumer, token)
+ return built == signature
+
+class OAuthSignatureMethod_HMAC_SHA1(OAuthSignatureMethod):
+
+ def get_name(self):
+ return 'HMAC-SHA1'
+
+ def build_signature_base_string(self, oauth_request, consumer, token):
+ sig = (
+ escape(oauth_request.get_normalized_http_method()),
+ escape(oauth_request.get_normalized_http_url()),
+ escape(oauth_request.get_normalized_parameters()),
+ )
+
+ key = '%s&' % escape(consumer.secret)
+ if token:
+ key += escape(token.secret)
+ raw = '&'.join(sig)
+ return key, raw
+
+ def build_signature(self, oauth_request, consumer, token):
+ # build the base signature string
+ key, raw = self.build_signature_base_string(oauth_request, consumer, token)
+
+ # hmac object
+ try:
+ import hashlib # 2.5
+ hashed = hmac.new(key, raw, hashlib.sha1)
+ except:
+ import sha # deprecated
+ hashed = hmac.new(key, raw, sha)
+
+ # calculate the digest base 64
+ return binascii.b2a_base64(hashed.digest())[:-1]
+
+class OAuthSignatureMethod_PLAINTEXT(OAuthSignatureMethod):
+
+ def get_name(self):
+ return 'PLAINTEXT'
+
+ def build_signature_base_string(self, oauth_request, consumer, token):
+ # concatenate the consumer key and secret
+ sig = escape(consumer.secret) + '&'
+ if token:
+ sig = sig + escape(token.secret)
+ return sig
+
+ def build_signature(self, oauth_request, consumer, token):
+ return self.build_signature_base_string(oauth_request, consumer, token)
diff --git a/src/gdata/oauth/rsa.py b/src/gdata/oauth/rsa.py
new file mode 100755
index 0000000..733e2bb
--- /dev/null
+++ b/src/gdata/oauth/rsa.py
@@ -0,0 +1,126 @@
+#!/usr/bin/python
+
+"""
+requires tlslite - http://trevp.net/tlslite/
+
+"""
+
+import binascii
+
+try:
+ from gdata.tlslite.utils import keyfactory
+except ImportError:
+ from tlslite.tlslite.utils import keyfactory
+try:
+ from gdata.tlslite.utils import cryptomath
+except ImportError:
+ from tlslite.tlslite.utils import cryptomath
+
+# XXX andy: ugly local import due to module name, oauth.oauth
+import gdata.oauth as oauth
+
+class OAuthSignatureMethod_RSA_SHA1(oauth.OAuthSignatureMethod):
+ def get_name(self):
+ return "RSA-SHA1"
+
+ def _fetch_public_cert(self, oauth_request):
+ # not implemented yet, ideas are:
+ # (1) do a lookup in a table of trusted certs keyed off of consumer
+ # (2) fetch via http using a url provided by the requester
+ # (3) some sort of specific discovery code based on request
+ #
+ # either way should return a string representation of the certificate
+ raise NotImplementedError
+
+ def _fetch_private_cert(self, oauth_request):
+ # not implemented yet, ideas are:
+ # (1) do a lookup in a table of trusted certs keyed off of consumer
+ #
+ # either way should return a string representation of the certificate
+ raise NotImplementedError
+
+ def build_signature_base_string(self, oauth_request, consumer, token):
+ sig = (
+ oauth.escape(oauth_request.get_normalized_http_method()),
+ oauth.escape(oauth_request.get_normalized_http_url()),
+ oauth.escape(oauth_request.get_normalized_parameters()),
+ )
+ key = ''
+ raw = '&'.join(sig)
+ return key, raw
+
+ def build_signature(self, oauth_request, consumer, token):
+ key, base_string = self.build_signature_base_string(oauth_request,
+ consumer,
+ token)
+
+ # Fetch the private key cert based on the request
+ cert = self._fetch_private_cert(oauth_request)
+
+ # Pull the private key from the certificate
+ privatekey = keyfactory.parsePrivateKey(cert)
+
+ # Convert base_string to bytes
+ #base_string_bytes = cryptomath.createByteArraySequence(base_string)
+
+ # Sign using the key
+ signed = privatekey.hashAndSign(base_string)
+
+ return binascii.b2a_base64(signed)[:-1]
+
+ def check_signature(self, oauth_request, consumer, token, signature):
+ decoded_sig = base64.b64decode(signature);
+
+ key, base_string = self.build_signature_base_string(oauth_request,
+ consumer,
+ token)
+
+ # Fetch the public key cert based on the request
+ cert = self._fetch_public_cert(oauth_request)
+
+ # Pull the public key from the certificate
+ publickey = keyfactory.parsePEMKey(cert, public=True)
+
+ # Check the signature
+ ok = publickey.hashAndVerify(decoded_sig, base_string)
+
+ return ok
+
+
+class TestOAuthSignatureMethod_RSA_SHA1(OAuthSignatureMethod_RSA_SHA1):
+ def _fetch_public_cert(self, oauth_request):
+ cert = """
+-----BEGIN CERTIFICATE-----
+MIIBpjCCAQ+gAwIBAgIBATANBgkqhkiG9w0BAQUFADAZMRcwFQYDVQQDDA5UZXN0
+IFByaW5jaXBhbDAeFw03MDAxMDEwODAwMDBaFw0zODEyMzEwODAwMDBaMBkxFzAV
+BgNVBAMMDlRlc3QgUHJpbmNpcGFsMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKB
+gQC0YjCwIfYoprq/FQO6lb3asXrxLlJFuCvtinTF5p0GxvQGu5O3gYytUvtC2JlY
+zypSRjVxwxrsuRcP3e641SdASwfrmzyvIgP08N4S0IFzEURkV1wp/IpH7kH41Etb
+mUmrXSwfNZsnQRE5SYSOhh+LcK2wyQkdgcMv11l4KoBkcwIDAQABMA0GCSqGSIb3
+DQEBBQUAA4GBAGZLPEuJ5SiJ2ryq+CmEGOXfvlTtEL2nuGtr9PewxkgnOjZpUy+d
+4TvuXJbNQc8f4AMWL/tO9w0Fk80rWKp9ea8/df4qMq5qlFWlx6yOLQxumNOmECKb
+WpkUQDIDJEoFUzKMVuJf4KO/FJ345+BNLGgbJ6WujreoM1X/gYfdnJ/J
+-----END CERTIFICATE-----
+"""
+ return cert
+
+ def _fetch_private_cert(self, oauth_request):
+ cert = """
+-----BEGIN PRIVATE KEY-----
+MIICdgIBADANBgkqhkiG9w0BAQEFAASCAmAwggJcAgEAAoGBALRiMLAh9iimur8V
+A7qVvdqxevEuUkW4K+2KdMXmnQbG9Aa7k7eBjK1S+0LYmVjPKlJGNXHDGuy5Fw/d
+7rjVJ0BLB+ubPK8iA/Tw3hLQgXMRRGRXXCn8ikfuQfjUS1uZSatdLB81mydBETlJ
+hI6GH4twrbDJCR2Bwy/XWXgqgGRzAgMBAAECgYBYWVtleUzavkbrPjy0T5FMou8H
+X9u2AC2ry8vD/l7cqedtwMPp9k7TubgNFo+NGvKsl2ynyprOZR1xjQ7WgrgVB+mm
+uScOM/5HVceFuGRDhYTCObE+y1kxRloNYXnx3ei1zbeYLPCHdhxRYW7T0qcynNmw
+rn05/KO2RLjgQNalsQJBANeA3Q4Nugqy4QBUCEC09SqylT2K9FrrItqL2QKc9v0Z
+zO2uwllCbg0dwpVuYPYXYvikNHHg+aCWF+VXsb9rpPsCQQDWR9TT4ORdzoj+Nccn
+qkMsDmzt0EfNaAOwHOmVJ2RVBspPcxt5iN4HI7HNeG6U5YsFBb+/GZbgfBT3kpNG
+WPTpAkBI+gFhjfJvRw38n3g/+UeAkwMI2TJQS4n8+hid0uus3/zOjDySH3XHCUno
+cn1xOJAyZODBo47E+67R4jV1/gzbAkEAklJaspRPXP877NssM5nAZMU0/O/NGCZ+
+3jPgDUno6WbJn5cqm8MqWhW1xGkImgRk+fkDBquiq4gPiT898jusgQJAd5Zrr6Q8
+AO/0isr/3aa6O6NLQxISLKcPDk2NOccAfS/xOtfOz4sJYM3+Bs4Io9+dZGSDCA54
+Lw03eHTNQghS0A==
+-----END PRIVATE KEY-----
+"""
+ return cert
diff --git a/src/gdata/opensearch/__init__.py b/src/gdata/opensearch/__init__.py
new file mode 100644
index 0000000..22071f7
--- /dev/null
+++ b/src/gdata/opensearch/__init__.py
@@ -0,0 +1,15 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
diff --git a/src/gdata/opensearch/data.py b/src/gdata/opensearch/data.py
new file mode 100644
index 0000000..89d7a28
--- /dev/null
+++ b/src/gdata/opensearch/data.py
@@ -0,0 +1,48 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains the data classes of the OpenSearch Extension"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+
+
+OPENSEARCH_TEMPLATE_V1 = '{http://a9.com/-/spec/opensearchrss/1.0//}%s'
+OPENSEARCH_TEMPLATE_V2 = '{http://a9.com/-/spec/opensearch/1.1//}%s'
+
+
+class ItemsPerPage(atom.core.XmlElement):
+ """Describes the number of items that will be returned per page for paged feeds"""
+ _qname = (OPENSEARCH_TEMPLATE_V1 % 'itemsPerPage',
+ OPENSEARCH_TEMPLATE_V2 % 'itemsPerPage')
+
+
+class StartIndex(atom.core.XmlElement):
+ """Describes the starting index of the contained entries for paged feeds"""
+ _qname = (OPENSEARCH_TEMPLATE_V1 % 'startIndex',
+ OPENSEARCH_TEMPLATE_V2 % 'startIndex')
+
+
+class TotalResults(atom.core.XmlElement):
+ """Describes the total number of results associated with this feed"""
+ _qname = (OPENSEARCH_TEMPLATE_V1 % 'totalResults',
+ OPENSEARCH_TEMPLATE_V2 % 'totalResults')
+
+
diff --git a/src/gdata/photos/__init__.py b/src/gdata/photos/__init__.py
new file mode 100644
index 0000000..1952135
--- /dev/null
+++ b/src/gdata/photos/__init__.py
@@ -0,0 +1,1112 @@
+# -*-*- encoding: utf-8 -*-*-
+#
+# This is the base file for the PicasaWeb python client.
+# It is used for lower level operations.
+#
+# $Id: __init__.py 148 2007-10-28 15:09:19Z havard.gulldahl $
+#
+# Copyright 2007 Håvard Gulldahl
+# Portions (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""This module provides a pythonic, gdata-centric interface to Google Photos
+(a.k.a. Picasa Web Services.
+
+It is modelled after the gdata/* interfaces from the gdata-python-client
+project[1] by Google.
+
+You'll find the user-friendly api in photos.service. Please see the
+documentation or live help() system for available methods.
+
+[1]: http://gdata-python-client.googlecode.com/
+
+ """
+
+__author__ = u'havard@gulldahl.no'# (Håvard Gulldahl)' #BUG: pydoc chokes on non-ascii chars in __author__
+__license__ = 'Apache License v2'
+__version__ = '$Revision: 164 $'[11:-2]
+
+import re
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import atom
+import gdata
+
+# importing google photo submodules
+import gdata.media as Media, gdata.exif as Exif, gdata.geo as Geo
+
+# XML namespaces which are often used in Google Photo elements
+PHOTOS_NAMESPACE = 'http://schemas.google.com/photos/2007'
+MEDIA_NAMESPACE = 'http://search.yahoo.com/mrss/'
+EXIF_NAMESPACE = 'http://schemas.google.com/photos/exif/2007'
+OPENSEARCH_NAMESPACE = 'http://a9.com/-/spec/opensearchrss/1.0/'
+GEO_NAMESPACE = 'http://www.w3.org/2003/01/geo/wgs84_pos#'
+GML_NAMESPACE = 'http://www.opengis.net/gml'
+GEORSS_NAMESPACE = 'http://www.georss.org/georss'
+PHEED_NAMESPACE = 'http://www.pheed.com/pheed/'
+BATCH_NAMESPACE = 'http://schemas.google.com/gdata/batch'
+
+
+class PhotosBaseElement(atom.AtomBase):
+ """Base class for elements in the PHOTO_NAMESPACE. To add new elements,
+ you only need to add the element tag name to self._tag
+ """
+
+ _tag = ''
+ _namespace = PHOTOS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, name=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ self.name = name
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+ #def __str__(self):
+ #return str(self.text)
+ #def __unicode__(self):
+ #return unicode(self.text)
+ def __int__(self):
+ return int(self.text)
+ def bool(self):
+ return self.text == 'true'
+
+class GPhotosBaseFeed(gdata.GDataFeed, gdata.LinkFinder):
+ "Base class for all Feeds in gdata.photos"
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children = gdata.GDataFeed._children.copy()
+ # We deal with Entry elements ourselves
+ del _children['{%s}entry' % atom.ATOM_NAMESPACE]
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None):
+ gdata.GDataFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+ def kind(self):
+ "(string) Returns the kind"
+ try:
+ return self.category[0].term.split('#')[1]
+ except IndexError:
+ return None
+
+ def _feedUri(self, kind):
+ "Convenience method to return a uri to a feed of a special kind"
+ assert(kind in ('album', 'tag', 'photo', 'comment', 'user'))
+ here_href = self.GetSelfLink().href
+ if 'kind=%s' % kind in here_href:
+ return here_href
+ if not 'kind=' in here_href:
+ sep = '?'
+ if '?' in here_href: sep = '&'
+ return here_href + "%skind=%s" % (sep, kind)
+ rx = re.match('.*(kind=)(album|tag|photo|comment)', here_href)
+ return here_href[:rx.end(1)] + kind + here_href[rx.end(2):]
+
+ def _ConvertElementTreeToMember(self, child_tree):
+ """Re-implementing the method from AtomBase, since we deal with
+ Entry elements specially"""
+ category = child_tree.find('{%s}category' % atom.ATOM_NAMESPACE)
+ if category is None:
+ return atom.AtomBase._ConvertElementTreeToMember(self, child_tree)
+ namespace, kind = category.get('term').split('#')
+ if namespace != PHOTOS_NAMESPACE:
+ return atom.AtomBase._ConvertElementTreeToMember(self, child_tree)
+ ## TODO: is it safe to use getattr on gdata.photos?
+ entry_class = getattr(gdata.photos, '%sEntry' % kind.title())
+ if not hasattr(self, 'entry') or self.entry is None:
+ self.entry = []
+ self.entry.append(atom._CreateClassFromElementTree(
+ entry_class, child_tree))
+
+class GPhotosBaseEntry(gdata.GDataEntry, gdata.LinkFinder):
+ "Base class for all Entry elements in gdata.photos"
+ _tag = 'entry'
+ _kind = ''
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title,
+ updated=updated, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+ self.category.append(
+ atom.Category(scheme='http://schemas.google.com/g/2005#kind',
+ term = 'http://schemas.google.com/photos/2007#%s' % self._kind))
+
+ def kind(self):
+ "(string) Returns the kind"
+ try:
+ return self.category[0].term.split('#')[1]
+ except IndexError:
+ return None
+
+ def _feedUri(self, kind):
+ "Convenience method to get the uri to this entry's feed of the some kind"
+ try:
+ href = self.GetFeedLink().href
+ except AttributeError:
+ return None
+ sep = '?'
+ if '?' in href: sep = '&'
+ return '%s%skind=%s' % (href, sep, kind)
+
+
+class PhotosBaseEntry(GPhotosBaseEntry):
+ pass
+
+class PhotosBaseFeed(GPhotosBaseFeed):
+ pass
+
+class GPhotosBaseData(object):
+ pass
+
+class Access(PhotosBaseElement):
+ """The Google Photo `Access' element.
+
+ The album's access level. Valid values are `public' or `private'.
+ In documentation, access level is also referred to as `visibility.'"""
+
+ _tag = 'access'
+def AccessFromString(xml_string):
+ return atom.CreateClassFromXMLString(Access, xml_string)
+
+class Albumid(PhotosBaseElement):
+ "The Google Photo `Albumid' element"
+
+ _tag = 'albumid'
+def AlbumidFromString(xml_string):
+ return atom.CreateClassFromXMLString(Albumid, xml_string)
+
+class BytesUsed(PhotosBaseElement):
+ "The Google Photo `BytesUsed' element"
+
+ _tag = 'bytesUsed'
+def BytesUsedFromString(xml_string):
+ return atom.CreateClassFromXMLString(BytesUsed, xml_string)
+
+class Client(PhotosBaseElement):
+ "The Google Photo `Client' element"
+
+ _tag = 'client'
+def ClientFromString(xml_string):
+ return atom.CreateClassFromXMLString(Client, xml_string)
+
+class Checksum(PhotosBaseElement):
+ "The Google Photo `Checksum' element"
+
+ _tag = 'checksum'
+def ChecksumFromString(xml_string):
+ return atom.CreateClassFromXMLString(Checksum, xml_string)
+
+class CommentCount(PhotosBaseElement):
+ "The Google Photo `CommentCount' element"
+
+ _tag = 'commentCount'
+def CommentCountFromString(xml_string):
+ return atom.CreateClassFromXMLString(CommentCount, xml_string)
+
+class CommentingEnabled(PhotosBaseElement):
+ "The Google Photo `CommentingEnabled' element"
+
+ _tag = 'commentingEnabled'
+def CommentingEnabledFromString(xml_string):
+ return atom.CreateClassFromXMLString(CommentingEnabled, xml_string)
+
+class Height(PhotosBaseElement):
+ "The Google Photo `Height' element"
+
+ _tag = 'height'
+def HeightFromString(xml_string):
+ return atom.CreateClassFromXMLString(Height, xml_string)
+
+class Id(PhotosBaseElement):
+ "The Google Photo `Id' element"
+
+ _tag = 'id'
+def IdFromString(xml_string):
+ return atom.CreateClassFromXMLString(Id, xml_string)
+
+class Location(PhotosBaseElement):
+ "The Google Photo `Location' element"
+
+ _tag = 'location'
+def LocationFromString(xml_string):
+ return atom.CreateClassFromXMLString(Location, xml_string)
+
+class MaxPhotosPerAlbum(PhotosBaseElement):
+ "The Google Photo `MaxPhotosPerAlbum' element"
+
+ _tag = 'maxPhotosPerAlbum'
+def MaxPhotosPerAlbumFromString(xml_string):
+ return atom.CreateClassFromXMLString(MaxPhotosPerAlbum, xml_string)
+
+class Name(PhotosBaseElement):
+ "The Google Photo `Name' element"
+
+ _tag = 'name'
+def NameFromString(xml_string):
+ return atom.CreateClassFromXMLString(Name, xml_string)
+
+class Nickname(PhotosBaseElement):
+ "The Google Photo `Nickname' element"
+
+ _tag = 'nickname'
+def NicknameFromString(xml_string):
+ return atom.CreateClassFromXMLString(Nickname, xml_string)
+
+class Numphotos(PhotosBaseElement):
+ "The Google Photo `Numphotos' element"
+
+ _tag = 'numphotos'
+def NumphotosFromString(xml_string):
+ return atom.CreateClassFromXMLString(Numphotos, xml_string)
+
+class Numphotosremaining(PhotosBaseElement):
+ "The Google Photo `Numphotosremaining' element"
+
+ _tag = 'numphotosremaining'
+def NumphotosremainingFromString(xml_string):
+ return atom.CreateClassFromXMLString(Numphotosremaining, xml_string)
+
+class Position(PhotosBaseElement):
+ "The Google Photo `Position' element"
+
+ _tag = 'position'
+def PositionFromString(xml_string):
+ return atom.CreateClassFromXMLString(Position, xml_string)
+
+class Photoid(PhotosBaseElement):
+ "The Google Photo `Photoid' element"
+
+ _tag = 'photoid'
+def PhotoidFromString(xml_string):
+ return atom.CreateClassFromXMLString(Photoid, xml_string)
+
+class Quotacurrent(PhotosBaseElement):
+ "The Google Photo `Quotacurrent' element"
+
+ _tag = 'quotacurrent'
+def QuotacurrentFromString(xml_string):
+ return atom.CreateClassFromXMLString(Quotacurrent, xml_string)
+
+class Quotalimit(PhotosBaseElement):
+ "The Google Photo `Quotalimit' element"
+
+ _tag = 'quotalimit'
+def QuotalimitFromString(xml_string):
+ return atom.CreateClassFromXMLString(Quotalimit, xml_string)
+
+class Rotation(PhotosBaseElement):
+ "The Google Photo `Rotation' element"
+
+ _tag = 'rotation'
+def RotationFromString(xml_string):
+ return atom.CreateClassFromXMLString(Rotation, xml_string)
+
+class Size(PhotosBaseElement):
+ "The Google Photo `Size' element"
+
+ _tag = 'size'
+def SizeFromString(xml_string):
+ return atom.CreateClassFromXMLString(Size, xml_string)
+
+class Snippet(PhotosBaseElement):
+ """The Google Photo `snippet' element.
+
+ When searching, the snippet element will contain a
+ string with the word you're looking for, highlighted in html markup
+ E.g. when your query is `hafjell', this element may contain:
+ `... here at <b>Hafjell</b>.'
+
+ You'll find this element in searches -- that is, feeds that combine the
+ `kind=photo' and `q=yoursearch' parameters in the request.
+
+ See also gphoto:truncated and gphoto:snippettype.
+
+ """
+
+ _tag = 'snippet'
+def SnippetFromString(xml_string):
+ return atom.CreateClassFromXMLString(Snippet, xml_string)
+
+class Snippettype(PhotosBaseElement):
+ """The Google Photo `Snippettype' element
+
+ When searching, this element will tell you the type of element that matches.
+
+ You'll find this element in searches -- that is, feeds that combine the
+ `kind=photo' and `q=yoursearch' parameters in the request.
+
+ See also gphoto:snippet and gphoto:truncated.
+
+ Possible values and their interpretation:
+ o ALBUM_TITLE - The album title matches
+ o PHOTO_TAGS - The match is a tag/keyword
+ o PHOTO_DESCRIPTION - The match is in the photo's description
+
+ If you discover a value not listed here, please submit a patch to update this docstring.
+
+ """
+
+ _tag = 'snippettype'
+def SnippettypeFromString(xml_string):
+ return atom.CreateClassFromXMLString(Snippettype, xml_string)
+
+class Thumbnail(PhotosBaseElement):
+ """The Google Photo `Thumbnail' element
+
+ Used to display user's photo thumbnail (hackergotchi).
+
+ (Not to be confused with the <media:thumbnail> element, which gives you
+ small versions of the photo object.)"""
+
+ _tag = 'thumbnail'
+def ThumbnailFromString(xml_string):
+ return atom.CreateClassFromXMLString(Thumbnail, xml_string)
+
+class Timestamp(PhotosBaseElement):
+ """The Google Photo `Timestamp' element
+ Represented as the number of milliseconds since January 1st, 1970.
+
+
+ Take a look at the convenience methods .isoformat() and .datetime():
+
+ photo_epoch = Time.text # 1180294337000
+ photo_isostring = Time.isoformat() # '2007-05-27T19:32:17.000Z'
+
+ Alternatively:
+ photo_datetime = Time.datetime() # (requires python >= 2.3)
+ """
+
+ _tag = 'timestamp'
+ def isoformat(self):
+ """(string) Return the timestamp as a ISO 8601 formatted string,
+ e.g. '2007-05-27T19:32:17.000Z'
+ """
+ import time
+ epoch = float(self.text)/1000
+ return time.strftime('%Y-%m-%dT%H:%M:%S.000Z', time.gmtime(epoch))
+
+ def datetime(self):
+ """(datetime.datetime) Return the timestamp as a datetime.datetime object
+
+ Requires python 2.3
+ """
+ import datetime
+ epoch = float(self.text)/1000
+ return datetime.datetime.fromtimestamp(epoch)
+def TimestampFromString(xml_string):
+ return atom.CreateClassFromXMLString(Timestamp, xml_string)
+
+class Truncated(PhotosBaseElement):
+ """The Google Photo `Truncated' element
+
+ You'll find this element in searches -- that is, feeds that combine the
+ `kind=photo' and `q=yoursearch' parameters in the request.
+
+ See also gphoto:snippet and gphoto:snippettype.
+
+ Possible values and their interpretation:
+ 0 -- unknown
+ """
+
+ _tag = 'Truncated'
+def TruncatedFromString(xml_string):
+ return atom.CreateClassFromXMLString(Truncated, xml_string)
+
+class User(PhotosBaseElement):
+ "The Google Photo `User' element"
+
+ _tag = 'user'
+def UserFromString(xml_string):
+ return atom.CreateClassFromXMLString(User, xml_string)
+
+class Version(PhotosBaseElement):
+ "The Google Photo `Version' element"
+
+ _tag = 'version'
+def VersionFromString(xml_string):
+ return atom.CreateClassFromXMLString(Version, xml_string)
+
+class Width(PhotosBaseElement):
+ "The Google Photo `Width' element"
+
+ _tag = 'width'
+def WidthFromString(xml_string):
+ return atom.CreateClassFromXMLString(Width, xml_string)
+
+class Weight(PhotosBaseElement):
+ """The Google Photo `Weight' element.
+
+ The weight of the tag is the number of times the tag
+ appears in the collection of tags currently being viewed.
+ The default weight is 1, in which case this tags is omitted."""
+ _tag = 'weight'
+def WeightFromString(xml_string):
+ return atom.CreateClassFromXMLString(Weight, xml_string)
+
+class CommentAuthor(atom.Author):
+ """The Atom `Author' element in CommentEntry entries is augmented to
+ contain elements from the PHOTOS_NAMESPACE
+
+ http://groups.google.com/group/Google-Picasa-Data-API/msg/819b0025b5ff5e38
+ """
+ _children = atom.Author._children.copy()
+ _children['{%s}user' % PHOTOS_NAMESPACE] = ('user', User)
+ _children['{%s}nickname' % PHOTOS_NAMESPACE] = ('nickname', Nickname)
+ _children['{%s}thumbnail' % PHOTOS_NAMESPACE] = ('thumbnail', Thumbnail)
+def CommentAuthorFromString(xml_string):
+ return atom.CreateClassFromXMLString(CommentAuthor, xml_string)
+
+########################## ################################
+
+class AlbumData(object):
+ _children = {}
+ _children['{%s}id' % PHOTOS_NAMESPACE] = ('gphoto_id', Id)
+ _children['{%s}name' % PHOTOS_NAMESPACE] = ('name', Name)
+ _children['{%s}location' % PHOTOS_NAMESPACE] = ('location', Location)
+ _children['{%s}access' % PHOTOS_NAMESPACE] = ('access', Access)
+ _children['{%s}bytesUsed' % PHOTOS_NAMESPACE] = ('bytesUsed', BytesUsed)
+ _children['{%s}timestamp' % PHOTOS_NAMESPACE] = ('timestamp', Timestamp)
+ _children['{%s}numphotos' % PHOTOS_NAMESPACE] = ('numphotos', Numphotos)
+ _children['{%s}numphotosremaining' % PHOTOS_NAMESPACE] = \
+ ('numphotosremaining', Numphotosremaining)
+ _children['{%s}user' % PHOTOS_NAMESPACE] = ('user', User)
+ _children['{%s}nickname' % PHOTOS_NAMESPACE] = ('nickname', Nickname)
+ _children['{%s}commentingEnabled' % PHOTOS_NAMESPACE] = \
+ ('commentingEnabled', CommentingEnabled)
+ _children['{%s}commentCount' % PHOTOS_NAMESPACE] = \
+ ('commentCount', CommentCount)
+ ## NOTE: storing media:group as self.media, to create a self-explaining api
+ gphoto_id = None
+ name = None
+ location = None
+ access = None
+ bytesUsed = None
+ timestamp = None
+ numphotos = None
+ numphotosremaining = None
+ user = None
+ nickname = None
+ commentingEnabled = None
+ commentCount = None
+
+class AlbumEntry(GPhotosBaseEntry, AlbumData):
+ """All metadata for a Google Photos Album
+
+ Take a look at AlbumData for metadata accessible as attributes to this object.
+
+ Notes:
+ To avoid name clashes, and to create a more sensible api, some
+ objects have names that differ from the original elements:
+
+ o media:group -> self.media,
+ o geo:where -> self.geo,
+ o photo:id -> self.gphoto_id
+ """
+
+ _kind = 'album'
+ _children = GPhotosBaseEntry._children.copy()
+ _children.update(AlbumData._children.copy())
+ # child tags only for Album entries, not feeds
+ _children['{%s}where' % GEORSS_NAMESPACE] = ('geo', Geo.Where)
+ _children['{%s}group' % MEDIA_NAMESPACE] = ('media', Media.Group)
+ media = Media.Group()
+ geo = Geo.Where()
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ #GPHOTO NAMESPACE:
+ gphoto_id=None, name=None, location=None, access=None,
+ timestamp=None, numphotos=None, user=None, nickname=None,
+ commentingEnabled=None, commentCount=None, thumbnail=None,
+ # MEDIA NAMESPACE:
+ media=None,
+ # GEORSS NAMESPACE:
+ geo=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ GPhotosBaseEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title,
+ updated=updated, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+
+ ## NOTE: storing photo:id as self.gphoto_id, to avoid name clash with atom:id
+ self.gphoto_id = gphoto_id
+ self.name = name
+ self.location = location
+ self.access = access
+ self.timestamp = timestamp
+ self.numphotos = numphotos
+ self.user = user
+ self.nickname = nickname
+ self.commentingEnabled = commentingEnabled
+ self.commentCount = commentCount
+ self.thumbnail = thumbnail
+ self.extended_property = extended_property or []
+ self.text = text
+ ## NOTE: storing media:group as self.media, and geo:where as geo,
+ ## to create a self-explaining api
+ self.media = media or Media.Group()
+ self.geo = geo or Geo.Where()
+
+ def GetAlbumId(self):
+ "Return the id of this album"
+
+ return self.GetFeedLink().href.split('/')[-1]
+
+ def GetPhotosUri(self):
+ "(string) Return the uri to this albums feed of the PhotoEntry kind"
+ return self._feedUri('photo')
+
+ def GetCommentsUri(self):
+ "(string) Return the uri to this albums feed of the CommentEntry kind"
+ return self._feedUri('comment')
+
+ def GetTagsUri(self):
+ "(string) Return the uri to this albums feed of the TagEntry kind"
+ return self._feedUri('tag')
+
+def AlbumEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(AlbumEntry, xml_string)
+
+class AlbumFeed(GPhotosBaseFeed, AlbumData):
+ """All metadata for a Google Photos Album, including its sub-elements
+
+ This feed represents an album as the container for other objects.
+
+ A Album feed contains entries of
+ PhotoEntry, CommentEntry or TagEntry,
+ depending on the `kind' parameter in the original query.
+
+ Take a look at AlbumData for accessible attributes.
+
+ """
+
+ _children = GPhotosBaseFeed._children.copy()
+ _children.update(AlbumData._children.copy())
+
+ def GetPhotosUri(self):
+ "(string) Return the uri to the same feed, but of the PhotoEntry kind"
+
+ return self._feedUri('photo')
+
+ def GetTagsUri(self):
+ "(string) Return the uri to the same feed, but of the TagEntry kind"
+
+ return self._feedUri('tag')
+
+ def GetCommentsUri(self):
+ "(string) Return the uri to the same feed, but of the CommentEntry kind"
+
+ return self._feedUri('comment')
+
+def AlbumFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(AlbumFeed, xml_string)
+
+
+class PhotoData(object):
+ _children = {}
+ ## NOTE: storing photo:id as self.gphoto_id, to avoid name clash with atom:id
+ _children['{%s}id' % PHOTOS_NAMESPACE] = ('gphoto_id', Id)
+ _children['{%s}albumid' % PHOTOS_NAMESPACE] = ('albumid', Albumid)
+ _children['{%s}checksum' % PHOTOS_NAMESPACE] = ('checksum', Checksum)
+ _children['{%s}client' % PHOTOS_NAMESPACE] = ('client', Client)
+ _children['{%s}height' % PHOTOS_NAMESPACE] = ('height', Height)
+ _children['{%s}position' % PHOTOS_NAMESPACE] = ('position', Position)
+ _children['{%s}rotation' % PHOTOS_NAMESPACE] = ('rotation', Rotation)
+ _children['{%s}size' % PHOTOS_NAMESPACE] = ('size', Size)
+ _children['{%s}timestamp' % PHOTOS_NAMESPACE] = ('timestamp', Timestamp)
+ _children['{%s}version' % PHOTOS_NAMESPACE] = ('version', Version)
+ _children['{%s}width' % PHOTOS_NAMESPACE] = ('width', Width)
+ _children['{%s}commentingEnabled' % PHOTOS_NAMESPACE] = \
+ ('commentingEnabled', CommentingEnabled)
+ _children['{%s}commentCount' % PHOTOS_NAMESPACE] = \
+ ('commentCount', CommentCount)
+ ## NOTE: storing media:group as self.media, exif:tags as self.exif, and
+ ## geo:where as self.geo, to create a self-explaining api
+ _children['{%s}tags' % EXIF_NAMESPACE] = ('exif', Exif.Tags)
+ _children['{%s}where' % GEORSS_NAMESPACE] = ('geo', Geo.Where)
+ _children['{%s}group' % MEDIA_NAMESPACE] = ('media', Media.Group)
+ # These elements show up in search feeds
+ _children['{%s}snippet' % PHOTOS_NAMESPACE] = ('snippet', Snippet)
+ _children['{%s}snippettype' % PHOTOS_NAMESPACE] = ('snippettype', Snippettype)
+ _children['{%s}truncated' % PHOTOS_NAMESPACE] = ('truncated', Truncated)
+ gphoto_id = None
+ albumid = None
+ checksum = None
+ client = None
+ height = None
+ position = None
+ rotation = None
+ size = None
+ timestamp = None
+ version = None
+ width = None
+ commentingEnabled = None
+ commentCount = None
+ snippet=None
+ snippettype=None
+ truncated=None
+ media = Media.Group()
+ geo = Geo.Where()
+ tags = Exif.Tags()
+
+class PhotoEntry(GPhotosBaseEntry, PhotoData):
+ """All metadata for a Google Photos Photo
+
+ Take a look at PhotoData for metadata accessible as attributes to this object.
+
+ Notes:
+ To avoid name clashes, and to create a more sensible api, some
+ objects have names that differ from the original elements:
+
+ o media:group -> self.media,
+ o exif:tags -> self.exif,
+ o geo:where -> self.geo,
+ o photo:id -> self.gphoto_id
+ """
+
+ _kind = 'photo'
+ _children = GPhotosBaseEntry._children.copy()
+ _children.update(PhotoData._children.copy())
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None, text=None,
+ # GPHOTO NAMESPACE:
+ gphoto_id=None, albumid=None, checksum=None, client=None, height=None,
+ position=None, rotation=None, size=None, timestamp=None, version=None,
+ width=None, commentCount=None, commentingEnabled=None,
+ # MEDIARSS NAMESPACE:
+ media=None,
+ # EXIF_NAMESPACE:
+ exif=None,
+ # GEORSS NAMESPACE:
+ geo=None,
+ extension_elements=None, extension_attributes=None):
+ GPhotosBaseEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+
+
+ ## NOTE: storing photo:id as self.gphoto_id, to avoid name clash with atom:id
+ self.gphoto_id = gphoto_id
+ self.albumid = albumid
+ self.checksum = checksum
+ self.client = client
+ self.height = height
+ self.position = position
+ self.rotation = rotation
+ self.size = size
+ self.timestamp = timestamp
+ self.version = version
+ self.width = width
+ self.commentingEnabled = commentingEnabled
+ self.commentCount = commentCount
+ ## NOTE: storing media:group as self.media, to create a self-explaining api
+ self.media = media or Media.Group()
+ self.exif = exif or Exif.Tags()
+ self.geo = geo or Geo.Where()
+
+ def GetPostLink(self):
+ "Return the uri to this photo's `POST' link (use it for updates of the object)"
+
+ return self.GetFeedLink()
+
+ def GetCommentsUri(self):
+ "Return the uri to this photo's feed of CommentEntry comments"
+ return self._feedUri('comment')
+
+ def GetTagsUri(self):
+ "Return the uri to this photo's feed of TagEntry tags"
+ return self._feedUri('tag')
+
+ def GetAlbumUri(self):
+ """Return the uri to the AlbumEntry containing this photo"""
+
+ href = self.GetSelfLink().href
+ return href[:href.find('/photoid')]
+
+def PhotoEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(PhotoEntry, xml_string)
+
+class PhotoFeed(GPhotosBaseFeed, PhotoData):
+ """All metadata for a Google Photos Photo, including its sub-elements
+
+ This feed represents a photo as the container for other objects.
+
+ A Photo feed contains entries of
+ CommentEntry or TagEntry,
+ depending on the `kind' parameter in the original query.
+
+ Take a look at PhotoData for metadata accessible as attributes to this object.
+
+ """
+ _children = GPhotosBaseFeed._children.copy()
+ _children.update(PhotoData._children.copy())
+
+ def GetTagsUri(self):
+ "(string) Return the uri to the same feed, but of the TagEntry kind"
+
+ return self._feedUri('tag')
+
+ def GetCommentsUri(self):
+ "(string) Return the uri to the same feed, but of the CommentEntry kind"
+
+ return self._feedUri('comment')
+
+def PhotoFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(PhotoFeed, xml_string)
+
+class TagData(GPhotosBaseData):
+ _children = {}
+ _children['{%s}weight' % PHOTOS_NAMESPACE] = ('weight', Weight)
+ weight=None
+
+class TagEntry(GPhotosBaseEntry, TagData):
+ """All metadata for a Google Photos Tag
+
+ The actual tag is stored in the .title.text attribute
+
+ """
+
+ _kind = 'tag'
+ _children = GPhotosBaseEntry._children.copy()
+ _children.update(TagData._children.copy())
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ # GPHOTO NAMESPACE:
+ weight=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ GPhotosBaseEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated, text=text,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+
+ self.weight = weight
+
+ def GetAlbumUri(self):
+ """Return the uri to the AlbumEntry containing this tag"""
+
+ href = self.GetSelfLink().href
+ pos = href.find('/photoid')
+ if pos == -1:
+ return None
+ return href[:pos]
+
+ def GetPhotoUri(self):
+ """Return the uri to the PhotoEntry containing this tag"""
+
+ href = self.GetSelfLink().href
+ pos = href.find('/tag')
+ if pos == -1:
+ return None
+ return href[:pos]
+
+def TagEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(TagEntry, xml_string)
+
+
+class TagFeed(GPhotosBaseFeed, TagData):
+ """All metadata for a Google Photos Tag, including its sub-elements"""
+
+ _children = GPhotosBaseFeed._children.copy()
+ _children.update(TagData._children.copy())
+
+def TagFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(TagFeed, xml_string)
+
+class CommentData(GPhotosBaseData):
+ _children = {}
+ ## NOTE: storing photo:id as self.gphoto_id, to avoid name clash with atom:id
+ _children['{%s}id' % PHOTOS_NAMESPACE] = ('gphoto_id', Id)
+ _children['{%s}albumid' % PHOTOS_NAMESPACE] = ('albumid', Albumid)
+ _children['{%s}photoid' % PHOTOS_NAMESPACE] = ('photoid', Photoid)
+ _children['{%s}author' % atom.ATOM_NAMESPACE] = ('author', [CommentAuthor,])
+ gphoto_id=None
+ albumid=None
+ photoid=None
+ author=None
+
+class CommentEntry(GPhotosBaseEntry, CommentData):
+ """All metadata for a Google Photos Comment
+
+ The comment is stored in the .content.text attribute,
+ with a content type in .content.type.
+
+
+ """
+
+ _kind = 'comment'
+ _children = GPhotosBaseEntry._children.copy()
+ _children.update(CommentData._children.copy())
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ # GPHOTO NAMESPACE:
+ gphoto_id=None, albumid=None, photoid=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ GPhotosBaseEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+ self.gphoto_id = gphoto_id
+ self.albumid = albumid
+ self.photoid = photoid
+
+ def GetCommentId(self):
+ """Return the globally unique id of this comment"""
+ return self.GetSelfLink().href.split('/')[-1]
+
+ def GetAlbumUri(self):
+ """Return the uri to the AlbumEntry containing this comment"""
+
+ href = self.GetSelfLink().href
+ return href[:href.find('/photoid')]
+
+ def GetPhotoUri(self):
+ """Return the uri to the PhotoEntry containing this comment"""
+
+ href = self.GetSelfLink().href
+ return href[:href.find('/commentid')]
+
+def CommentEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(CommentEntry, xml_string)
+
+class CommentFeed(GPhotosBaseFeed, CommentData):
+ """All metadata for a Google Photos Comment, including its sub-elements"""
+
+ _children = GPhotosBaseFeed._children.copy()
+ _children.update(CommentData._children.copy())
+
+def CommentFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(CommentFeed, xml_string)
+
+class UserData(GPhotosBaseData):
+ _children = {}
+ _children['{%s}maxPhotosPerAlbum' % PHOTOS_NAMESPACE] = ('maxPhotosPerAlbum', MaxPhotosPerAlbum)
+ _children['{%s}nickname' % PHOTOS_NAMESPACE] = ('nickname', Nickname)
+ _children['{%s}quotalimit' % PHOTOS_NAMESPACE] = ('quotalimit', Quotalimit)
+ _children['{%s}quotacurrent' % PHOTOS_NAMESPACE] = ('quotacurrent', Quotacurrent)
+ _children['{%s}thumbnail' % PHOTOS_NAMESPACE] = ('thumbnail', Thumbnail)
+ _children['{%s}user' % PHOTOS_NAMESPACE] = ('user', User)
+ _children['{%s}id' % PHOTOS_NAMESPACE] = ('gphoto_id', Id)
+
+ maxPhotosPerAlbum=None
+ nickname=None
+ quotalimit=None
+ quotacurrent=None
+ thumbnail=None
+ user=None
+ gphoto_id=None
+
+
+class UserEntry(GPhotosBaseEntry, UserData):
+ """All metadata for a Google Photos User
+
+ This entry represents an album owner and all appropriate metadata.
+
+ Take a look at at the attributes of the UserData for metadata available.
+ """
+ _children = GPhotosBaseEntry._children.copy()
+ _children.update(UserData._children.copy())
+ _kind = 'user'
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None,
+ title=None, updated=None,
+ # GPHOTO NAMESPACE:
+ gphoto_id=None, maxPhotosPerAlbum=None, nickname=None, quotalimit=None,
+ quotacurrent=None, thumbnail=None, user=None,
+ extended_property=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ GPhotosBaseEntry.__init__(self, author=author, category=category,
+ content=content,
+ atom_id=atom_id, link=link, published=published,
+ title=title, updated=updated,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+ self.gphoto_id=gphoto_id
+ self.maxPhotosPerAlbum=maxPhotosPerAlbum
+ self.nickname=nickname
+ self.quotalimit=quotalimit
+ self.quotacurrent=quotacurrent
+ self.thumbnail=thumbnail
+ self.user=user
+
+ def GetAlbumsUri(self):
+ "(string) Return the uri to this user's feed of the AlbumEntry kind"
+ return self._feedUri('album')
+
+ def GetPhotosUri(self):
+ "(string) Return the uri to this user's feed of the PhotoEntry kind"
+ return self._feedUri('photo')
+
+ def GetCommentsUri(self):
+ "(string) Return the uri to this user's feed of the CommentEntry kind"
+ return self._feedUri('comment')
+
+ def GetTagsUri(self):
+ "(string) Return the uri to this user's feed of the TagEntry kind"
+ return self._feedUri('tag')
+
+def UserEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(UserEntry, xml_string)
+
+class UserFeed(GPhotosBaseFeed, UserData):
+ """Feed for a User in the google photos api.
+
+ This feed represents a user as the container for other objects.
+
+ A User feed contains entries of
+ AlbumEntry, PhotoEntry, CommentEntry, UserEntry or TagEntry,
+ depending on the `kind' parameter in the original query.
+
+ The user feed itself also contains all of the metadata available
+ as part of a UserData object."""
+ _children = GPhotosBaseFeed._children.copy()
+ _children.update(UserData._children.copy())
+
+ def GetAlbumsUri(self):
+ """Get the uri to this feed, but with entries of the AlbumEntry kind."""
+ return self._feedUri('album')
+
+ def GetTagsUri(self):
+ """Get the uri to this feed, but with entries of the TagEntry kind."""
+ return self._feedUri('tag')
+
+ def GetPhotosUri(self):
+ """Get the uri to this feed, but with entries of the PhotosEntry kind."""
+ return self._feedUri('photo')
+
+ def GetCommentsUri(self):
+ """Get the uri to this feed, but with entries of the CommentsEntry kind."""
+ return self._feedUri('comment')
+
+def UserFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(UserFeed, xml_string)
+
+
+
+def AnyFeedFromString(xml_string):
+ """Creates an instance of the appropriate feed class from the
+ xml string contents.
+
+ Args:
+ xml_string: str A string which contains valid XML. The root element
+ of the XML string should match the tag and namespace of the desired
+ class.
+
+ Returns:
+ An instance of the target class with members assigned according to the
+ contents of the XML - or a basic gdata.GDataFeed instance if it is
+ impossible to determine the appropriate class (look for extra elements
+ in GDataFeed's .FindExtensions() and extension_elements[] ).
+ """
+ tree = ElementTree.fromstring(xml_string)
+ category = tree.find('{%s}category' % atom.ATOM_NAMESPACE)
+ if category is None:
+ # TODO: is this the best way to handle this?
+ return atom._CreateClassFromElementTree(GPhotosBaseFeed, tree)
+ namespace, kind = category.get('term').split('#')
+ if namespace != PHOTOS_NAMESPACE:
+ # TODO: is this the best way to handle this?
+ return atom._CreateClassFromElementTree(GPhotosBaseFeed, tree)
+ ## TODO: is getattr safe this way?
+ feed_class = getattr(gdata.photos, '%sFeed' % kind.title())
+ return atom._CreateClassFromElementTree(feed_class, tree)
+
+def AnyEntryFromString(xml_string):
+ """Creates an instance of the appropriate entry class from the
+ xml string contents.
+
+ Args:
+ xml_string: str A string which contains valid XML. The root element
+ of the XML string should match the tag and namespace of the desired
+ class.
+
+ Returns:
+ An instance of the target class with members assigned according to the
+ contents of the XML - or a basic gdata.GDataEndry instance if it is
+ impossible to determine the appropriate class (look for extra elements
+ in GDataEntry's .FindExtensions() and extension_elements[] ).
+ """
+ tree = ElementTree.fromstring(xml_string)
+ category = tree.find('{%s}category' % atom.ATOM_NAMESPACE)
+ if category is None:
+ # TODO: is this the best way to handle this?
+ return atom._CreateClassFromElementTree(GPhotosBaseEntry, tree)
+ namespace, kind = category.get('term').split('#')
+ if namespace != PHOTOS_NAMESPACE:
+ # TODO: is this the best way to handle this?
+ return atom._CreateClassFromElementTree(GPhotosBaseEntry, tree)
+ ## TODO: is getattr safe this way?
+ feed_class = getattr(gdata.photos, '%sEntry' % kind.title())
+ return atom._CreateClassFromElementTree(feed_class, tree)
+
diff --git a/src/gdata/photos/service.py b/src/gdata/photos/service.py
new file mode 100755
index 0000000..23c5feb
--- /dev/null
+++ b/src/gdata/photos/service.py
@@ -0,0 +1,681 @@
+#!/usr/bin/env python
+# -*-*- encoding: utf-8 -*-*-
+#
+# This is the service file for the Google Photo python client.
+# It is used for higher level operations.
+#
+# $Id: service.py 144 2007-10-25 21:03:34Z havard.gulldahl $
+#
+# Copyright 2007 Håvard Gulldahl
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Google PhotoService provides a human-friendly interface to
+Google Photo (a.k.a Picasa Web) services[1].
+
+It extends gdata.service.GDataService and as such hides all the
+nasty details about authenticating, parsing and communicating with
+Google Photos.
+
+[1]: http://code.google.com/apis/picasaweb/gdata.html
+
+Example:
+ import gdata.photos, gdata.photos.service
+ pws = gdata.photos.service.PhotosService()
+ pws.ClientLogin(username, password)
+ #Get all albums
+ albums = pws.GetUserFeed().entry
+ # Get all photos in second album
+ photos = pws.GetFeed(albums[1].GetPhotosUri()).entry
+ # Get all tags for photos in second album and print them
+ tags = pws.GetFeed(albums[1].GetTagsUri()).entry
+ print [ tag.summary.text for tag in tags ]
+ # Get all comments for the first photos in list and print them
+ comments = pws.GetCommentFeed(photos[0].GetCommentsUri()).entry
+ print [ c.summary.text for c in comments ]
+
+ # Get a photo to work with
+ photo = photos[0]
+ # Update metadata
+
+ # Attributes from the <gphoto:*> namespace
+ photo.summary.text = u'A nice view from my veranda'
+ photo.title.text = u'Verandaview.jpg'
+
+ # Attributes from the <media:*> namespace
+ photo.media.keywords.text = u'Home, Long-exposure, Sunset' # Comma-separated
+
+ # Adding attributes to media object
+
+ # Rotate 90 degrees clockwise
+ photo.rotation = gdata.photos.Rotation(text='90')
+
+ # Submit modified photo object
+ photo = pws.UpdatePhotoMetadata(photo)
+
+ # Make sure you only modify the newly returned object, else you'll get
+ # versioning errors. See Optimistic-concurrency
+
+ # Add comment to a picture
+ comment = pws.InsertComment(photo, u'I wish the water always was this warm')
+
+ # Remove comment because it was silly
+ print "*blush*"
+ pws.Delete(comment.GetEditLink().href)
+
+"""
+
+__author__ = u'havard@gulldahl.no'# (Håvard Gulldahl)' #BUG: pydoc chokes on non-ascii chars in __author__
+__license__ = 'Apache License v2'
+__version__ = '$Revision: 176 $'[11:-2]
+
+
+import sys, os.path, StringIO
+import time
+import gdata.service
+import gdata
+import atom.service
+import atom
+import gdata.photos
+
+SUPPORTED_UPLOAD_TYPES = ('bmp', 'jpeg', 'jpg', 'gif', 'png')
+
+UNKOWN_ERROR=1000
+GPHOTOS_BAD_REQUEST=400
+GPHOTOS_CONFLICT=409
+GPHOTOS_INTERNAL_SERVER_ERROR=500
+GPHOTOS_INVALID_ARGUMENT=601
+GPHOTOS_INVALID_CONTENT_TYPE=602
+GPHOTOS_NOT_AN_IMAGE=603
+GPHOTOS_INVALID_KIND=604
+
+class GooglePhotosException(Exception):
+ def __init__(self, response):
+
+ self.error_code = response['status']
+ self.reason = response['reason'].strip()
+ if '<html>' in str(response['body']): #general html message, discard it
+ response['body'] = ""
+ self.body = response['body'].strip()
+ self.message = "(%(status)s) %(body)s -- %(reason)s" % response
+
+ #return explicit error codes
+ error_map = { '(12) Not an image':GPHOTOS_NOT_AN_IMAGE,
+ 'kind: That is not one of the acceptable values':
+ GPHOTOS_INVALID_KIND,
+
+ }
+ for msg, code in error_map.iteritems():
+ if self.body == msg:
+ self.error_code = code
+ break
+ self.args = [self.error_code, self.reason, self.body]
+
+class PhotosService(gdata.service.GDataService):
+ ssl = True
+ userUri = '/data/feed/api/user/%s'
+
+ def __init__(self, email=None, password=None, source=None,
+ server='picasaweb.google.com', additional_headers=None,
+ **kwargs):
+ """Creates a client for the Google Photos service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'picasaweb.google.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ self.email = email
+ self.client = source
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='lh2', source=source,
+ server=server, additional_headers=additional_headers, **kwargs)
+
+ def GetFeed(self, uri, limit=None, start_index=None):
+ """Get a feed.
+
+ The results are ordered by the values of their `updated' elements,
+ with the most recently updated entry appearing first in the feed.
+
+ Arguments:
+ uri: the uri to fetch
+ limit (optional): the maximum number of entries to return. Defaults to what
+ the server returns.
+
+ Returns:
+ one of gdata.photos.AlbumFeed,
+ gdata.photos.UserFeed,
+ gdata.photos.PhotoFeed,
+ gdata.photos.CommentFeed,
+ gdata.photos.TagFeed,
+ depending on the results of the query.
+ Raises:
+ GooglePhotosException
+
+ See:
+ http://code.google.com/apis/picasaweb/gdata.html#Get_Album_Feed_Manual
+ """
+ if limit is not None:
+ uri += '&max-results=%s' % limit
+ if start_index is not None:
+ uri += '&start-index=%s' % start_index
+ try:
+ return self.Get(uri, converter=gdata.photos.AnyFeedFromString)
+ except gdata.service.RequestError, e:
+ raise GooglePhotosException(e.args[0])
+
+ def GetEntry(self, uri, limit=None, start_index=None):
+ """Get an Entry.
+
+ Arguments:
+ uri: the uri to the entry
+ limit (optional): the maximum number of entries to return. Defaults to what
+ the server returns.
+
+ Returns:
+ one of gdata.photos.AlbumEntry,
+ gdata.photos.UserEntry,
+ gdata.photos.PhotoEntry,
+ gdata.photos.CommentEntry,
+ gdata.photos.TagEntry,
+ depending on the results of the query.
+ Raises:
+ GooglePhotosException
+ """
+ if limit is not None:
+ uri += '&max-results=%s' % limit
+ if start_index is not None:
+ uri += '&start-index=%s' % start_index
+ try:
+ return self.Get(uri, converter=gdata.photos.AnyEntryFromString)
+ except gdata.service.RequestError, e:
+ raise GooglePhotosException(e.args[0])
+
+ def GetUserFeed(self, kind='album', user='default', limit=None):
+ """Get user-based feed, containing albums, photos, comments or tags;
+ defaults to albums.
+
+ The entries are ordered by the values of their `updated' elements,
+ with the most recently updated entry appearing first in the feed.
+
+ Arguments:
+ kind: the kind of entries to get, either `album', `photo',
+ `comment' or `tag', or a python list of these. Defaults to `album'.
+ user (optional): whose albums we're querying. Defaults to current user.
+ limit (optional): the maximum number of entries to return.
+ Defaults to everything the server returns.
+
+
+ Returns:
+ gdata.photos.UserFeed, containing appropriate Entry elements
+
+ See:
+ http://code.google.com/apis/picasaweb/gdata.html#Get_Album_Feed_Manual
+ http://googledataapis.blogspot.com/2007/07/picasa-web-albums-adds-new-api-features.html
+ """
+ if isinstance(kind, (list, tuple) ):
+ kind = ",".join(kind)
+
+ uri = '/data/feed/api/user/%s?kind=%s' % (user, kind)
+ return self.GetFeed(uri, limit=limit)
+
+ def GetTaggedPhotos(self, tag, user='default', limit=None):
+ """Get all photos belonging to a specific user, tagged by the given keyword
+
+ Arguments:
+ tag: The tag you're looking for, e.g. `dog'
+ user (optional): Whose images/videos you want to search, defaults
+ to current user
+ limit (optional): the maximum number of entries to return.
+ Defaults to everything the server returns.
+
+ Returns:
+ gdata.photos.UserFeed containing PhotoEntry elements
+ """
+ # Lower-casing because of
+ # http://code.google.com/p/gdata-issues/issues/detail?id=194
+ uri = '/data/feed/api/user/%s?kind=photo&tag=%s' % (user, tag.lower())
+ return self.GetFeed(uri, limit)
+
+ def SearchUserPhotos(self, query, user='default', limit=100):
+ """Search through all photos for a specific user and return a feed.
+ This will look for matches in file names and image tags (a.k.a. keywords)
+
+ Arguments:
+ query: The string you're looking for, e.g. `vacation'
+ user (optional): The username of whose photos you want to search, defaults
+ to current user.
+ limit (optional): Don't return more than `limit' hits, defaults to 100
+
+ Only public photos are searched, unless you are authenticated and
+ searching through your own photos.
+
+ Returns:
+ gdata.photos.UserFeed with PhotoEntry elements
+ """
+ uri = '/data/feed/api/user/%s?kind=photo&q=%s' % (user, query)
+ return self.GetFeed(uri, limit=limit)
+
+ def SearchCommunityPhotos(self, query, limit=100):
+ """Search through all public photos and return a feed.
+ This will look for matches in file names and image tags (a.k.a. keywords)
+
+ Arguments:
+ query: The string you're looking for, e.g. `vacation'
+ limit (optional): Don't return more than `limit' hits, defaults to 100
+
+ Returns:
+ gdata.GDataFeed with PhotoEntry elements
+ """
+ uri='/data/feed/api/all?q=%s' % query
+ return self.GetFeed(uri, limit=limit)
+
+ def GetContacts(self, user='default', limit=None):
+ """Retrieve a feed that contains a list of your contacts
+
+ Arguments:
+ user: Username of the user whose contacts you want
+
+ Returns
+ gdata.photos.UserFeed, with UserEntry entries
+
+ See:
+ http://groups.google.com/group/Google-Picasa-Data-API/msg/819b0025b5ff5e38
+ """
+ uri = '/data/feed/api/user/%s/contacts?kind=user' % user
+ return self.GetFeed(uri, limit=limit)
+
+ def SearchContactsPhotos(self, user='default', search=None, limit=None):
+ """Search over your contacts' photos and return a feed
+
+ Arguments:
+ user: Username of the user whose contacts you want
+ search (optional): What to search for (photo title, description and keywords)
+
+ Returns
+ gdata.photos.UserFeed, with PhotoEntry elements
+
+ See:
+ http://groups.google.com/group/Google-Picasa-Data-API/msg/819b0025b5ff5e38
+ """
+
+ uri = '/data/feed/api/user/%s/contacts?kind=photo&q=%s' % (user, search)
+ return self.GetFeed(uri, limit=limit)
+
+ def InsertAlbum(self, title, summary, location=None, access='public',
+ commenting_enabled='true', timestamp=None):
+ """Add an album.
+
+ Needs authentication, see self.ClientLogin()
+
+ Arguments:
+ title: Album title
+ summary: Album summary / description
+ access (optional): `private' or `public'. Public albums are searchable
+ by everyone on the internet. Defaults to `public'
+ commenting_enabled (optional): `true' or `false'. Defaults to `true'.
+ timestamp (optional): A date and time for the album, in milliseconds since
+ Unix epoch[1] UTC. Defaults to now.
+
+ Returns:
+ The newly created gdata.photos.AlbumEntry
+
+ See:
+ http://code.google.com/apis/picasaweb/gdata.html#Add_Album_Manual_Installed
+
+ [1]: http://en.wikipedia.org/wiki/Unix_epoch
+ """
+ album = gdata.photos.AlbumEntry()
+ album.title = atom.Title(text=title, title_type='text')
+ album.summary = atom.Summary(text=summary, summary_type='text')
+ if location is not None:
+ album.location = gdata.photos.Location(text=location)
+ album.access = gdata.photos.Access(text=access)
+ if commenting_enabled in ('true', 'false'):
+ album.commentingEnabled = gdata.photos.CommentingEnabled(text=commenting_enabled)
+ if timestamp is None:
+ timestamp = '%i' % int(time.time() * 1000)
+ album.timestamp = gdata.photos.Timestamp(text=timestamp)
+ try:
+ return self.Post(album, uri=self.userUri % self.email,
+ converter=gdata.photos.AlbumEntryFromString)
+ except gdata.service.RequestError, e:
+ raise GooglePhotosException(e.args[0])
+
+ def InsertPhoto(self, album_or_uri, photo, filename_or_handle,
+ content_type='image/jpeg'):
+ """Add a PhotoEntry
+
+ Needs authentication, see self.ClientLogin()
+
+ Arguments:
+ album_or_uri: AlbumFeed or uri of the album where the photo should go
+ photo: PhotoEntry to add
+ filename_or_handle: A file-like object or file name where the image/video
+ will be read from
+ content_type (optional): Internet media type (a.k.a. mime type) of
+ media object. Currently Google Photos supports these types:
+ o image/bmp
+ o image/gif
+ o image/jpeg
+ o image/png
+
+ Images will be converted to jpeg on upload. Defaults to `image/jpeg'
+
+ """
+
+ try:
+ assert(isinstance(photo, gdata.photos.PhotoEntry))
+ except AssertionError:
+ raise GooglePhotosException({'status':GPHOTOS_INVALID_ARGUMENT,
+ 'body':'`photo` must be a gdata.photos.PhotoEntry instance',
+ 'reason':'Found %s, not PhotoEntry' % type(photo)
+ })
+ try:
+ majtype, mintype = content_type.split('/')
+ assert(mintype in SUPPORTED_UPLOAD_TYPES)
+ except (ValueError, AssertionError):
+ raise GooglePhotosException({'status':GPHOTOS_INVALID_CONTENT_TYPE,
+ 'body':'This is not a valid content type: %s' % content_type,
+ 'reason':'Accepted content types: %s' % \
+ ['image/'+t for t in SUPPORTED_UPLOAD_TYPES]
+ })
+ if isinstance(filename_or_handle, (str, unicode)) and \
+ os.path.exists(filename_or_handle): # it's a file name
+ mediasource = gdata.MediaSource()
+ mediasource.setFile(filename_or_handle, content_type)
+ elif hasattr(filename_or_handle, 'read'):# it's a file-like resource
+ if hasattr(filename_or_handle, 'seek'):
+ filename_or_handle.seek(0) # rewind pointer to the start of the file
+ # gdata.MediaSource needs the content length, so read the whole image
+ file_handle = StringIO.StringIO(filename_or_handle.read())
+ name = 'image'
+ if hasattr(filename_or_handle, 'name'):
+ name = filename_or_handle.name
+ mediasource = gdata.MediaSource(file_handle, content_type,
+ content_length=file_handle.len, file_name=name)
+ else: #filename_or_handle is not valid
+ raise GooglePhotosException({'status':GPHOTOS_INVALID_ARGUMENT,
+ 'body':'`filename_or_handle` must be a path name or a file-like object',
+ 'reason':'Found %s, not path name or object with a .read() method' % \
+ filename_or_handle
+ })
+
+ if isinstance(album_or_uri, (str, unicode)): # it's a uri
+ feed_uri = album_or_uri
+ elif hasattr(album_or_uri, 'GetFeedLink'): # it's a AlbumFeed object
+ feed_uri = album_or_uri.GetFeedLink().href
+
+ try:
+ return self.Post(photo, uri=feed_uri, media_source=mediasource,
+ converter=gdata.photos.PhotoEntryFromString)
+ except gdata.service.RequestError, e:
+ raise GooglePhotosException(e.args[0])
+
+ def InsertPhotoSimple(self, album_or_uri, title, summary, filename_or_handle,
+ content_type='image/jpeg', keywords=None):
+ """Add a photo without constructing a PhotoEntry.
+
+ Needs authentication, see self.ClientLogin()
+
+ Arguments:
+ album_or_uri: AlbumFeed or uri of the album where the photo should go
+ title: Photo title
+ summary: Photo summary / description
+ filename_or_handle: A file-like object or file name where the image/video
+ will be read from
+ content_type (optional): Internet media type (a.k.a. mime type) of
+ media object. Currently Google Photos supports these types:
+ o image/bmp
+ o image/gif
+ o image/jpeg
+ o image/png
+
+ Images will be converted to jpeg on upload. Defaults to `image/jpeg'
+ keywords (optional): a 1) comma separated string or 2) a python list() of
+ keywords (a.k.a. tags) to add to the image.
+ E.g. 1) `dog, vacation, happy' 2) ['dog', 'happy', 'vacation']
+
+ Returns:
+ The newly created gdata.photos.PhotoEntry or GooglePhotosException on errors
+
+ See:
+ http://code.google.com/apis/picasaweb/gdata.html#Add_Album_Manual_Installed
+ [1]: http://en.wikipedia.org/wiki/Unix_epoch
+ """
+
+ metadata = gdata.photos.PhotoEntry()
+ metadata.title=atom.Title(text=title)
+ metadata.summary = atom.Summary(text=summary, summary_type='text')
+ if keywords is not None:
+ if isinstance(keywords, list):
+ keywords = ','.join(keywords)
+ metadata.media.keywords = gdata.media.Keywords(text=keywords)
+ return self.InsertPhoto(album_or_uri, metadata, filename_or_handle,
+ content_type)
+
+ def UpdatePhotoMetadata(self, photo):
+ """Update a photo's metadata.
+
+ Needs authentication, see self.ClientLogin()
+
+ You can update any or all of the following metadata properties:
+ * <title>
+ * <media:description>
+ * <gphoto:checksum>
+ * <gphoto:client>
+ * <gphoto:rotation>
+ * <gphoto:timestamp>
+ * <gphoto:commentingEnabled>
+
+ Arguments:
+ photo: a gdata.photos.PhotoEntry object with updated elements
+
+ Returns:
+ The modified gdata.photos.PhotoEntry
+
+ Example:
+ p = GetFeed(uri).entry[0]
+ p.title.text = u'My new text'
+ p.commentingEnabled.text = 'false'
+ p = UpdatePhotoMetadata(p)
+
+ It is important that you don't keep the old object around, once
+ it has been updated. See
+ http://code.google.com/apis/gdata/reference.html#Optimistic-concurrency
+ """
+ try:
+ return self.Put(data=photo, uri=photo.GetEditLink().href,
+ converter=gdata.photos.PhotoEntryFromString)
+ except gdata.service.RequestError, e:
+ raise GooglePhotosException(e.args[0])
+
+
+ def UpdatePhotoBlob(self, photo_or_uri, filename_or_handle,
+ content_type = 'image/jpeg'):
+ """Update a photo's binary data.
+
+ Needs authentication, see self.ClientLogin()
+
+ Arguments:
+ photo_or_uri: a gdata.photos.PhotoEntry that will be updated, or a
+ `edit-media' uri pointing to it
+ filename_or_handle: A file-like object or file name where the image/video
+ will be read from
+ content_type (optional): Internet media type (a.k.a. mime type) of
+ media object. Currently Google Photos supports these types:
+ o image/bmp
+ o image/gif
+ o image/jpeg
+ o image/png
+ Images will be converted to jpeg on upload. Defaults to `image/jpeg'
+
+ Returns:
+ The modified gdata.photos.PhotoEntry
+
+ Example:
+ p = GetFeed(PhotoUri)
+ p = UpdatePhotoBlob(p, '/tmp/newPic.jpg')
+
+ It is important that you don't keep the old object around, once
+ it has been updated. See
+ http://code.google.com/apis/gdata/reference.html#Optimistic-concurrency
+ """
+
+ try:
+ majtype, mintype = content_type.split('/')
+ assert(mintype in SUPPORTED_UPLOAD_TYPES)
+ except (ValueError, AssertionError):
+ raise GooglePhotosException({'status':GPHOTOS_INVALID_CONTENT_TYPE,
+ 'body':'This is not a valid content type: %s' % content_type,
+ 'reason':'Accepted content types: %s' % \
+ ['image/'+t for t in SUPPORTED_UPLOAD_TYPES]
+ })
+
+ if isinstance(filename_or_handle, (str, unicode)) and \
+ os.path.exists(filename_or_handle): # it's a file name
+ photoblob = gdata.MediaSource()
+ photoblob.setFile(filename_or_handle, content_type)
+ elif hasattr(filename_or_handle, 'read'):# it's a file-like resource
+ if hasattr(filename_or_handle, 'seek'):
+ filename_or_handle.seek(0) # rewind pointer to the start of the file
+ # gdata.MediaSource needs the content length, so read the whole image
+ file_handle = StringIO.StringIO(filename_or_handle.read())
+ name = 'image'
+ if hasattr(filename_or_handle, 'name'):
+ name = filename_or_handle.name
+ mediasource = gdata.MediaSource(file_handle, content_type,
+ content_length=file_handle.len, file_name=name)
+ else: #filename_or_handle is not valid
+ raise GooglePhotosException({'status':GPHOTOS_INVALID_ARGUMENT,
+ 'body':'`filename_or_handle` must be a path name or a file-like object',
+ 'reason':'Found %s, not path name or an object with .read() method' % \
+ type(filename_or_handle)
+ })
+
+ if isinstance(photo_or_uri, (str, unicode)):
+ entry_uri = photo_or_uri # it's a uri
+ elif hasattr(photo_or_uri, 'GetEditMediaLink'):
+ entry_uri = photo_or_uri.GetEditMediaLink().href
+ try:
+ return self.Put(photoblob, entry_uri,
+ converter=gdata.photos.PhotoEntryFromString)
+ except gdata.service.RequestError, e:
+ raise GooglePhotosException(e.args[0])
+
+ def InsertTag(self, photo_or_uri, tag):
+ """Add a tag (a.k.a. keyword) to a photo.
+
+ Needs authentication, see self.ClientLogin()
+
+ Arguments:
+ photo_or_uri: a gdata.photos.PhotoEntry that will be tagged, or a
+ `post' uri pointing to it
+ (string) tag: The tag/keyword
+
+ Returns:
+ The new gdata.photos.TagEntry
+
+ Example:
+ p = GetFeed(PhotoUri)
+ tag = InsertTag(p, 'Beautiful sunsets')
+
+ """
+ tag = gdata.photos.TagEntry(title=atom.Title(text=tag))
+ if isinstance(photo_or_uri, (str, unicode)):
+ post_uri = photo_or_uri # it's a uri
+ elif hasattr(photo_or_uri, 'GetEditMediaLink'):
+ post_uri = photo_or_uri.GetPostLink().href
+ try:
+ return self.Post(data=tag, uri=post_uri,
+ converter=gdata.photos.TagEntryFromString)
+ except gdata.service.RequestError, e:
+ raise GooglePhotosException(e.args[0])
+
+
+ def InsertComment(self, photo_or_uri, comment):
+ """Add a comment to a photo.
+
+ Needs authentication, see self.ClientLogin()
+
+ Arguments:
+ photo_or_uri: a gdata.photos.PhotoEntry that is about to be commented
+ , or a `post' uri pointing to it
+ (string) comment: The actual comment
+
+ Returns:
+ The new gdata.photos.CommentEntry
+
+ Example:
+ p = GetFeed(PhotoUri)
+ tag = InsertComment(p, 'OOOH! I would have loved to be there.
+ Who's that in the back?')
+
+ """
+ comment = gdata.photos.CommentEntry(content=atom.Content(text=comment))
+ if isinstance(photo_or_uri, (str, unicode)):
+ post_uri = photo_or_uri # it's a uri
+ elif hasattr(photo_or_uri, 'GetEditMediaLink'):
+ post_uri = photo_or_uri.GetPostLink().href
+ try:
+ return self.Post(data=comment, uri=post_uri,
+ converter=gdata.photos.CommentEntryFromString)
+ except gdata.service.RequestError, e:
+ raise GooglePhotosException(e.args[0])
+
+ def Delete(self, object_or_uri, *args, **kwargs):
+ """Delete an object.
+
+ Re-implementing the GDataService.Delete method, to add some
+ convenience.
+
+ Arguments:
+ object_or_uri: Any object that has a GetEditLink() method that
+ returns a link, or a uri to that object.
+
+ Returns:
+ ? or GooglePhotosException on errors
+ """
+ try:
+ uri = object_or_uri.GetEditLink().href
+ except AttributeError:
+ uri = object_or_uri
+ try:
+ return gdata.service.GDataService.Delete(self, uri, *args, **kwargs)
+ except gdata.service.RequestError, e:
+ raise GooglePhotosException(e.args[0])
+
+def GetSmallestThumbnail(media_thumbnail_list):
+ """Helper function to get the smallest thumbnail of a list of
+ gdata.media.Thumbnail.
+ Returns gdata.media.Thumbnail """
+ r = {}
+ for thumb in media_thumbnail_list:
+ r[int(thumb.width)*int(thumb.height)] = thumb
+ keys = r.keys()
+ keys.sort()
+ return r[keys[0]]
+
+def ConvertAtomTimestampToEpoch(timestamp):
+ """Helper function to convert a timestamp string, for instance
+ from atom:updated or atom:published, to milliseconds since Unix epoch
+ (a.k.a. POSIX time).
+
+ `2007-07-22T00:45:10.000Z' -> """
+ return time.mktime(time.strptime(timestamp, '%Y-%m-%dT%H:%M:%S.000Z'))
+ ## TODO: Timezone aware
diff --git a/src/gdata/projecthosting/__init__.py b/src/gdata/projecthosting/__init__.py
new file mode 100755
index 0000000..8b13789
--- /dev/null
+++ b/src/gdata/projecthosting/__init__.py
@@ -0,0 +1 @@
+
diff --git a/src/gdata/projecthosting/client.py b/src/gdata/projecthosting/client.py
new file mode 100755
index 0000000..512eb32
--- /dev/null
+++ b/src/gdata/projecthosting/client.py
@@ -0,0 +1,201 @@
+#!/usr/bin/env python
+#
+# Copyright 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import atom.data
+import gdata.client
+import gdata.gauth
+import gdata.projecthosting.data
+
+
+class ProjectHostingClient(gdata.client.GDClient):
+ """Client to interact with the Project Hosting GData API."""
+ api_version = '1.0'
+ auth_service = 'code'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['code']
+ host = 'code.google.com'
+ ssl = True
+
+ def get_issues(self, project_name,
+ desired_class=gdata.projecthosting.data.IssuesFeed, **kwargs):
+ """Get a feed of issues for a particular project.
+
+ Args:
+ project_name str The name of the project.
+ query Query Set returned issues parameters.
+
+ Returns:
+ data.IssuesFeed
+ """
+ return self.get_feed(gdata.projecthosting.data.ISSUES_FULL_FEED %
+ project_name, desired_class=desired_class, **kwargs)
+
+ def add_issue(self, project_name, title, content, author,
+ status=None, owner=None, labels=None, ccs=None, **kwargs):
+ """Create a new issue for the project.
+
+ Args:
+ project_name str The name of the project.
+ title str The title of the new issue.
+ content str The summary of the new issue.
+ author str The authenticated user's username.
+ status str The status of the new issue, Accepted, etc.
+ owner str The username of new issue's owner.
+ labels [str] Labels to associate with the new issue.
+ ccs [str] usernames to Cc on the new issue.
+ Returns:
+ data.IssueEntry
+ """
+ new_entry = gdata.projecthosting.data.IssueEntry(
+ title=atom.data.Title(text=title),
+ content=atom.data.Content(text=content),
+ author=[atom.data.Author(name=atom.data.Name(text=author))])
+
+ if status:
+ new_entry.status = gdata.projecthosting.data.Status(text=status)
+
+ if owner:
+ owner = [gdata.projecthosting.data.Owner(
+ username=gdata.projecthosting.data.Username(text=owner))]
+
+ if labels:
+ new_entry.label = [gdata.projecthosting.data.Label(text=label)
+ for label in labels]
+ if ccs:
+ new_entry.cc = [
+ gdata.projecthosting.data.Cc(
+ username=gdata.projecthosting.data.Username(text=cc))
+ for cc in ccs]
+
+ return self.post(
+ new_entry,
+ gdata.projecthosting.data.ISSUES_FULL_FEED % project_name,
+ **kwargs)
+
+ def update_issue(self, project_name, issue_id, author, comment=None,
+ summary=None, status=None, owner=None, labels=None, ccs=None,
+ **kwargs):
+ """Update or comment on one issue for the project.
+
+ Args:
+ project_name str The name of the issue's project.
+ issue_id str The issue number needing updated.
+ author str The authenticated user's username.
+ comment str A comment to append to the issue
+ summary str Rewrite the summary of the issue.
+ status str A new status for the issue.
+ owner str The username of the new owner.
+ labels [str] Labels to set on the issue (prepend issue with - to remove a
+ label).
+ ccs [str] Ccs to set on th enew issue (prepend cc with - to remove a cc).
+
+ Returns:
+ data.CommentEntry
+ """
+ updates = gdata.projecthosting.data.Updates()
+
+ if summary:
+ updates.summary = gdata.projecthosting.data.Summary(text=summary)
+
+ if status:
+ updates.status = gdata.projecthosting.data.Status(text=status)
+
+ if owner:
+ updates.ownerUpdate = gdata.projecthosting.data.OwnerUpdate(text=owner)
+
+ if labels:
+ updates.label = [gdata.projecthosting.data.Label(text=label)
+ for label in labels]
+ if ccs:
+ updates.ccUpdate = [gdata.projecthosting.data.CcUpdate(text=cc)
+ for cc in ccs]
+
+ update_entry = gdata.projecthosting.data.CommentEntry(
+ content=atom.data.Content(text=comment),
+ author=[atom.data.Author(name=atom.data.Name(text=author))],
+ updates=updates)
+
+ return self.post(
+ update_entry,
+ gdata.projecthosting.data.COMMENTS_FULL_FEED % (project_name, issue_id),
+ **kwargs)
+
+ def get_comments(self, project_name, issue_id,
+ desired_class=gdata.projecthosting.data.CommentsFeed,
+ **kwargs):
+ """Get a feed of all updates to an issue.
+
+ Args:
+ project_name str The name of the issue's project.
+ issue_id str The issue number needing updated.
+
+ Returns:
+ data.CommentsFeed
+ """
+ return self.get_feed(
+ gdata.projecthosting.data.COMMENTS_FULL_FEED % (project_name, issue_id),
+ desired_class=desired_class, **kwargs)
+
+ def update(self, entry, auth_token=None, force=False, **kwargs):
+ """Unsupported GData update method.
+
+ Use update_*() instead.
+ """
+ raise NotImplementedError(
+ 'GData Update operation unsupported, try update_*')
+
+ def delete(self, entry_or_uri, auth_token=None, force=False, **kwargs):
+ """Unsupported GData delete method.
+
+ Use update_issue(status='Closed') instead.
+ """
+ raise NotImplementedError(
+ 'GData Delete API unsupported, try closing the issue instead.')
+
+
+class Query(gdata.client.Query):
+
+ def __init__(self, issue_id=None, label=None, canned_query=None, owner=None,
+ status=None, **kwargs):
+ """Constructs a Google Data Query to filter feed contents serverside.
+ Args:
+ issue_id: int or str The issue to return based on the issue id.
+ label: str A label returned issues must have.
+ canned_query: str Return issues based on a canned query identifier
+ owner: str Return issues based on the owner of the issue. For Gmail users,
+ this will be the part of the email preceding the '@' sign.
+ status: str Return issues based on the status of the issue.
+ """
+ super(Query, self).__init__(**kwargs)
+ self.label = label
+ self.issue_id = issue_id
+ self.canned_query = canned_query
+ self.owner = owner
+ self.status = status
+
+ def modify_request(self, http_request):
+ if self.issue_id:
+ gdata.client._add_query_param('id', self.issue_id, http_request)
+ if self.label:
+ gdata.client._add_query_param('label', self.label, http_request)
+ if self.canned_query:
+ gdata.client._add_query_param('can', self.canned_query, http_request)
+ if self.owner:
+ gdata.client._add_query_param('owner', self.owner, http_request)
+ if self.status:
+ gdata.client._add_query_param('status', self.status, http_request)
+ super(Query, self).modify_request(http_request)
+
+ ModifyRequest = modify_request
diff --git a/src/gdata/projecthosting/data.py b/src/gdata/projecthosting/data.py
new file mode 100755
index 0000000..b0af2f5
--- /dev/null
+++ b/src/gdata/projecthosting/data.py
@@ -0,0 +1,134 @@
+#!/usr/bin/env python
+#
+# Copyright 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+"""Provides classes and constants for XML in the Google Project Hosting API.
+
+Canonical documentation for the raw XML which these classes represent can be
+found here: http://code.google.com/p/support/wiki/IssueTrackerAPI
+"""
+
+
+__author__ = 'jlapenna@google.com (Joe LaPenna)'
+
+import atom.core
+import gdata.data
+
+
+ISSUES_TEMPLATE = '{http://schemas.google.com/projecthosting/issues/2009}%s'
+
+
+ISSUES_FULL_FEED = '/feeds/issues/p/%s/issues/full'
+COMMENTS_FULL_FEED = '/feeds/issues/p/%s/issues/%s/comments/full'
+
+
+class Uri(atom.core.XmlElement):
+ """The issues:uri element."""
+ _qname = ISSUES_TEMPLATE % 'uri'
+
+
+class Username(atom.core.XmlElement):
+ """The issues:username element."""
+ _qname = ISSUES_TEMPLATE % 'username'
+
+
+class Cc(atom.core.XmlElement):
+ """The issues:cc element."""
+ _qname = ISSUES_TEMPLATE % 'cc'
+ uri = Uri
+ username = Username
+
+
+class Label(atom.core.XmlElement):
+ """The issues:label element."""
+ _qname = ISSUES_TEMPLATE % 'label'
+
+
+class Owner(atom.core.XmlElement):
+ """The issues:owner element."""
+ _qname = ISSUES_TEMPLATE % 'owner'
+ uri = Uri
+ username = Username
+
+
+class Stars(atom.core.XmlElement):
+ """The issues:stars element."""
+ _qname = ISSUES_TEMPLATE % 'stars'
+
+
+class State(atom.core.XmlElement):
+ """The issues:state element."""
+ _qname = ISSUES_TEMPLATE % 'state'
+
+
+class Status(atom.core.XmlElement):
+ """The issues:status element."""
+ _qname = ISSUES_TEMPLATE % 'status'
+
+
+class Summary(atom.core.XmlElement):
+ """The issues:summary element."""
+ _qname = ISSUES_TEMPLATE % 'summary'
+
+
+class OwnerUpdate(atom.core.XmlElement):
+ """The issues:ownerUpdate element."""
+ _qname = ISSUES_TEMPLATE % 'ownerUpdate'
+
+
+class CcUpdate(atom.core.XmlElement):
+ """The issues:ccUpdate element."""
+ _qname = ISSUES_TEMPLATE % 'ccUpdate'
+
+
+class Updates(atom.core.XmlElement):
+ """The issues:updates element."""
+ _qname = ISSUES_TEMPLATE % 'updates'
+ summary = Summary
+ status = Status
+ ownerUpdate = OwnerUpdate
+ label = [Label]
+ ccUpdate = [CcUpdate]
+
+
+class IssueEntry(gdata.data.GDEntry):
+ """Represents the information of one issue."""
+ _qname = atom.data.ATOM_TEMPLATE % 'entry'
+ owner = Owner
+ cc = [Cc]
+ label = [Label]
+ stars = Stars
+ state = State
+ status = Status
+
+
+class IssuesFeed(gdata.data.GDFeed):
+ """An Atom feed listing a project's issues."""
+ entry = [IssueEntry]
+
+
+class CommentEntry(gdata.data.GDEntry):
+ """An entry detailing one comment on an issue."""
+ _qname = atom.data.ATOM_TEMPLATE % 'entry'
+ updates = Updates
+
+
+class CommentsFeed(gdata.data.GDFeed):
+ """An Atom feed listing a project's issue's comments."""
+ entry = [CommentEntry]
diff --git a/src/gdata/sample_util.py b/src/gdata/sample_util.py
new file mode 100644
index 0000000..aae866e
--- /dev/null
+++ b/src/gdata/sample_util.py
@@ -0,0 +1,269 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Provides utility functions used with command line samples."""
+
+# This module is used for version 2 of the Google Data APIs.
+
+import sys
+import getpass
+import urllib
+import gdata.gauth
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+CLIENT_LOGIN = 1
+AUTHSUB = 2
+OAUTH = 3
+
+HMAC = 1
+RSA = 2
+
+
+class SettingsUtil(object):
+ """Gather's user preferences from flags or command prompts.
+
+ An instance of this object stores the choices made by the user. At some
+ point it might be useful to save the user's preferences so that they do
+ not need to always set flags or answer preference prompts.
+ """
+
+ def __init__(self, prefs=None):
+ self.prefs = prefs or {}
+
+ def get_param(self, name, prompt='', secret=False, ask=True, reuse=False):
+ # First, check in this objects stored preferences.
+ if name in self.prefs:
+ return self.prefs[name]
+ # Second, check for a command line parameter.
+ value = None
+ for i in xrange(len(sys.argv)):
+ if sys.argv[i].startswith('--%s=' % name):
+ value = sys.argv[i].split('=')[1]
+ elif sys.argv[i] == '--%s' % name:
+ value = sys.argv[i + 1]
+ # Third, if it was not on the command line, ask the user to input the
+ # value.
+ if value is None and ask:
+ prompt = '%s: ' % prompt
+ if secret:
+ value = getpass.getpass(prompt)
+ else:
+ value = raw_input(prompt)
+ # If we want to save the preference for reuse in future requests, add it
+ # to this object's prefs.
+ if value is not None and reuse:
+ self.prefs[name] = value
+ return value
+
+ def authorize_client(self, client, auth_type=None, service=None,
+ source=None, scopes=None, oauth_type=None,
+ consumer_key=None, consumer_secret=None):
+ """Uses command line arguments, or prompts user for token values."""
+ if 'client_auth_token' in self.prefs:
+ return
+ if auth_type is None:
+ auth_type = int(self.get_param(
+ 'auth_type', 'Please choose the authorization mechanism you want'
+ ' to use.\n'
+ '1. to use your email address and password (ClientLogin)\n'
+ '2. to use a web browser to visit an auth web page (AuthSub)\n'
+ '3. if you have registed to use OAuth\n', reuse=True))
+
+ # Get the scopes for the services we want to access.
+ if auth_type == AUTHSUB or auth_type == OAUTH:
+ if scopes is None:
+ scopes = self.get_param(
+ 'scopes', 'Enter the URL prefixes (scopes) for the resources you '
+ 'would like to access.\nFor multiple scope URLs, place a comma '
+ 'between each URL.\n'
+ 'Example: http://www.google.com/calendar/feeds/,'
+ 'http://www.google.com/m8/feeds/\n', reuse=True).split(',')
+ elif isinstance(scopes, (str, unicode)):
+ scopes = scopes.split(',')
+
+ if auth_type == CLIENT_LOGIN:
+ email = self.get_param('email', 'Please enter your username',
+ reuse=False)
+ password = self.get_param('password', 'Password', True, reuse=False)
+ if service is None:
+ service = self.get_param(
+ 'service', 'What is the name of the service you wish to access?'
+ '\n(See list:'
+ ' http://code.google.com/apis/gdata/faq.html#clientlogin)',
+ reuse=True)
+ if source is None:
+ source = self.get_param('source', ask=False, reuse=True)
+ client.client_login(email, password, source=source, service=service)
+ elif auth_type == AUTHSUB:
+ auth_sub_token = self.get_param('auth_sub_token', ask=False, reuse=True)
+ session_token = self.get_param('session_token', ask=False, reuse=True)
+ private_key = None
+ auth_url = None
+ single_use_token = None
+ rsa_private_key = self.get_param(
+ 'rsa_private_key',
+ 'If you want to use secure mode AuthSub, please provide the\n'
+ ' location of your RSA private key which corresponds to the\n'
+ ' certificate you have uploaded for your domain. If you do not\n'
+ ' have an RSA key, simply press enter', reuse=True)
+
+ if rsa_private_key:
+ try:
+ private_key_file = open(rsa_private_key, 'rb')
+ private_key = private_key_file.read()
+ private_key_file.close()
+ except IOError:
+ print 'Unable to read private key from file'
+
+ if private_key is not None:
+ if client.auth_token is None:
+ if session_token:
+ client.auth_token = gdata.gauth.SecureAuthSubToken(
+ session_token, private_key, scopes)
+ self.prefs['client_auth_token'] = gdata.gauth.token_to_blob(
+ client.auth_token)
+ return
+ elif auth_sub_token:
+ client.auth_token = gdata.gauth.SecureAuthSubToken(
+ auth_sub_token, private_key, scopes)
+ client.upgrade_token()
+ self.prefs['client_auth_token'] = gdata.gauth.token_to_blob(
+ client.auth_token)
+ return
+
+ auth_url = gdata.gauth.generate_auth_sub_url(
+ 'http://gauthmachine.appspot.com/authsub', scopes, True)
+ print 'with a private key, get ready for this URL', auth_url
+
+ else:
+ if client.auth_token is None:
+ if session_token:
+ client.auth_token = gdata.gauth.AuthSubToken(session_token,
+ scopes)
+ self.prefs['client_auth_token'] = gdata.gauth.token_to_blob(
+ client.auth_token)
+ return
+ elif auth_sub_token:
+ client.auth_token = gdata.gauth.AuthSubToken(auth_sub_token,
+ scopes)
+ client.upgrade_token()
+ self.prefs['client_auth_token'] = gdata.gauth.token_to_blob(
+ client.auth_token)
+ return
+
+ auth_url = gdata.gauth.generate_auth_sub_url(
+ 'http://gauthmachine.appspot.com/authsub', scopes)
+
+ print 'Visit the following URL in your browser to authorize this app:'
+ print str(auth_url)
+ print 'After agreeing to authorize the app, copy the token value from'
+ print ' the URL. Example: "www.google.com/?token=ab12" token value is'
+ print ' ab12'
+ token_value = raw_input('Please enter the token value: ')
+ if private_key is not None:
+ single_use_token = gdata.gauth.SecureAuthSubToken(
+ token_value, private_key, scopes)
+ else:
+ single_use_token = gdata.gauth.AuthSubToken(token_value, scopes)
+ client.auth_token = single_use_token
+ client.upgrade_token()
+
+ elif auth_type == OAUTH:
+ if oauth_type is None:
+ oauth_type = int(self.get_param(
+ 'oauth_type', 'Please choose the authorization mechanism you want'
+ ' to use.\n'
+ '1. use an HMAC signature using your consumer key and secret\n'
+ '2. use RSA with your private key to sign requests\n',
+ reuse=True))
+
+ consumer_key = self.get_param(
+ 'consumer_key', 'Please enter your OAuth conumer key '
+ 'which identifies your app', reuse=True)
+
+ if oauth_type == HMAC:
+ consumer_secret = self.get_param(
+ 'consumer_secret', 'Please enter your OAuth conumer secret '
+ 'which you share with the OAuth provider', True, reuse=False)
+ # Swap out this code once the client supports requesting an oauth
+ # token.
+ # Get a request token.
+ request_token = client.get_oauth_token(
+ scopes, 'http://gauthmachine.appspot.com/oauth', consumer_key,
+ consumer_secret=consumer_secret)
+ elif oauth_type == RSA:
+ rsa_private_key = self.get_param(
+ 'rsa_private_key',
+ 'Please provide the location of your RSA private key which\n'
+ ' corresponds to the certificate you have uploaded for your'
+ ' domain.',
+ reuse=True)
+ try:
+ private_key_file = open(rsa_private_key, 'rb')
+ private_key = private_key_file.read()
+ private_key_file.close()
+ except IOError:
+ print 'Unable to read private key from file'
+
+ request_token = client.get_oauth_token(
+ scopes, 'http://gauthmachine.appspot.com/oauth', consumer_key,
+ rsa_private_key=private_key)
+ else:
+ print 'Invalid OAuth signature type'
+ return None
+
+ # Authorize the request token in the browser.
+ print 'Visit the following URL in your browser to authorize this app:'
+ print str(request_token.generate_authorization_url())
+ print 'After agreeing to authorize the app, copy URL from the browser\'s'
+ print ' address bar.'
+ url = raw_input('Please enter the url: ')
+ gdata.gauth.authorize_request_token(request_token, url)
+ # Exchange for an access token.
+ client.auth_token = client.get_access_token(request_token)
+ else:
+ print 'Invalid authorization type.'
+ return None
+ if client.auth_token:
+ self.prefs['client_auth_token'] = gdata.gauth.token_to_blob(
+ client.auth_token)
+
+
+def get_param(name, prompt='', secret=False, ask=True):
+ settings = SettingsUtil()
+ return settings.get_param(name=name, prompt=prompt, secret=secret, ask=ask)
+
+
+def authorize_client(client, auth_type=None, service=None, source=None,
+ scopes=None, oauth_type=None, consumer_key=None,
+ consumer_secret=None):
+ """Uses command line arguments, or prompts user for token values."""
+ settings = SettingsUtil()
+ return settings.authorize_client(client=client, auth_type=auth_type,
+ service=service, source=source,
+ scopes=scopes, oauth_type=oauth_type,
+ consumer_key=consumer_key,
+ consumer_secret=consumer_secret)
+
+
+def print_options():
+ """Displays usage information, available command line params."""
+ # TODO: fill in the usage description for authorizing the client.
+ print ''
+
diff --git a/src/gdata/service.py b/src/gdata/service.py
new file mode 100755
index 0000000..df05d1f
--- /dev/null
+++ b/src/gdata/service.py
@@ -0,0 +1,1718 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006,2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""GDataService provides CRUD ops. and programmatic login for GData services.
+
+ Error: A base exception class for all exceptions in the gdata_client
+ module.
+
+ CaptchaRequired: This exception is thrown when a login attempt results in a
+ captcha challenge from the ClientLogin service. When this
+ exception is thrown, the captcha_token and captcha_url are
+ set to the values provided in the server's response.
+
+ BadAuthentication: Raised when a login attempt is made with an incorrect
+ username or password.
+
+ NotAuthenticated: Raised if an operation requiring authentication is called
+ before a user has authenticated.
+
+ NonAuthSubToken: Raised if a method to modify an AuthSub token is used when
+ the user is either not authenticated or is authenticated
+ through another authentication mechanism.
+
+ NonOAuthToken: Raised if a method to modify an OAuth token is used when the
+ user is either not authenticated or is authenticated through
+ another authentication mechanism.
+
+ RequestError: Raised if a CRUD request returned a non-success code.
+
+ UnexpectedReturnType: Raised if the response from the server was not of the
+ desired type. For example, this would be raised if the
+ server sent a feed when the client requested an entry.
+
+ GDataService: Encapsulates user credentials needed to perform insert, update
+ and delete operations with the GData API. An instance can
+ perform user authentication, query, insertion, deletion, and
+ update.
+
+ Query: Eases query URI creation by allowing URI parameters to be set as
+ dictionary attributes. For example a query with a feed of
+ '/base/feeds/snippets' and ['bq'] set to 'digital camera' will
+ produce '/base/feeds/snippets?bq=digital+camera' when .ToUri() is
+ called on it.
+"""
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+import re
+import urllib
+import urlparse
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import atom.service
+import gdata
+import atom
+import atom.http_interface
+import atom.token_store
+import gdata.auth
+import gdata.gauth
+
+
+AUTH_SERVER_HOST = 'https://www.google.com'
+
+
+# When requesting an AuthSub token, it is often helpful to track the scope
+# which is being requested. One way to accomplish this is to add a URL
+# parameter to the 'next' URL which contains the requested scope. This
+# constant is the default name (AKA key) for the URL parameter.
+SCOPE_URL_PARAM_NAME = 'authsub_token_scope'
+# When requesting an OAuth access token or authorization of an existing OAuth
+# request token, it is often helpful to track the scope(s) which is/are being
+# requested. One way to accomplish this is to add a URL parameter to the
+# 'callback' URL which contains the requested scope. This constant is the
+# default name (AKA key) for the URL parameter.
+OAUTH_SCOPE_URL_PARAM_NAME = 'oauth_token_scope'
+# Maps the service names used in ClientLogin to scope URLs.
+CLIENT_LOGIN_SCOPES = gdata.gauth.AUTH_SCOPES
+# Default parameters for GDataService.GetWithRetries method
+DEFAULT_NUM_RETRIES = 3
+DEFAULT_DELAY = 1
+DEFAULT_BACKOFF = 2
+
+
+def lookup_scopes(service_name):
+ """Finds the scope URLs for the desired service.
+
+ In some cases, an unknown service may be used, and in those cases this
+ function will return None.
+ """
+ if service_name in CLIENT_LOGIN_SCOPES:
+ return CLIENT_LOGIN_SCOPES[service_name]
+ return None
+
+
+# Module level variable specifies which module should be used by GDataService
+# objects to make HttpRequests. This setting can be overridden on each
+# instance of GDataService.
+# This module level variable is deprecated. Reassign the http_client member
+# of a GDataService object instead.
+http_request_handler = atom.service
+
+
+class Error(Exception):
+ pass
+
+
+class CaptchaRequired(Error):
+ pass
+
+
+class BadAuthentication(Error):
+ pass
+
+
+class NotAuthenticated(Error):
+ pass
+
+
+class NonAuthSubToken(Error):
+ pass
+
+
+class NonOAuthToken(Error):
+ pass
+
+
+class RequestError(Error):
+ pass
+
+
+class UnexpectedReturnType(Error):
+ pass
+
+
+class BadAuthenticationServiceURL(Error):
+ pass
+
+
+class FetchingOAuthRequestTokenFailed(RequestError):
+ pass
+
+
+class TokenUpgradeFailed(RequestError):
+ pass
+
+
+class RevokingOAuthTokenFailed(RequestError):
+ pass
+
+
+class AuthorizationRequired(Error):
+ pass
+
+
+class TokenHadNoScope(Error):
+ pass
+
+
+class RanOutOfTries(Error):
+ pass
+
+
+class GDataService(atom.service.AtomService):
+ """Contains elements needed for GData login and CRUD request headers.
+
+ Maintains additional headers (tokens for example) needed for the GData
+ services to allow a user to perform inserts, updates, and deletes.
+ """
+ # The hander member is deprecated, use http_client instead.
+ handler = None
+ # The auth_token member is deprecated, use the token_store instead.
+ auth_token = None
+ # The tokens dict is deprecated in favor of the token_store.
+ tokens = None
+
+ def __init__(self, email=None, password=None, account_type='HOSTED_OR_GOOGLE',
+ service=None, auth_service_url=None, source=None, server=None,
+ additional_headers=None, handler=None, tokens=None,
+ http_client=None, token_store=None):
+ """Creates an object of type GDataService.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ account_type: string (optional) The type of account to use. Use
+ 'GOOGLE' for regular Google accounts or 'HOSTED' for Google
+ Apps accounts, or 'HOSTED_OR_GOOGLE' to try finding a HOSTED
+ account first and, if it doesn't exist, try finding a regular
+ GOOGLE account. Default value: 'HOSTED_OR_GOOGLE'.
+ service: string (optional) The desired service for which credentials
+ will be obtained.
+ auth_service_url: string (optional) User-defined auth token request URL
+ allows users to explicitly specify where to send auth token requests.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'base.google.com'.
+ additional_headers: dictionary (optional) Any additional headers which
+ should be included with CRUD operations.
+ handler: module (optional) This parameter is deprecated and has been
+ replaced by http_client.
+ tokens: This parameter is deprecated, calls should be made to
+ token_store instead.
+ http_client: An object responsible for making HTTP requests using a
+ request method. If none is provided, a new instance of
+ atom.http.ProxiedHttpClient will be used.
+ token_store: Keeps a collection of authorization tokens which can be
+ applied to requests for a specific URLs. Critical methods are
+ find_token based on a URL (atom.url.Url or a string), add_token,
+ and remove_token.
+ """
+ atom.service.AtomService.__init__(self, http_client=http_client,
+ token_store=token_store)
+ self.email = email
+ self.password = password
+ self.account_type = account_type
+ self.service = service
+ self.auth_service_url = auth_service_url
+ self.server = server
+ self.additional_headers = additional_headers or {}
+ self._oauth_input_params = None
+ self.__SetSource(source)
+ self.__captcha_token = None
+ self.__captcha_url = None
+ self.__gsessionid = None
+
+ if http_request_handler.__name__ == 'gdata.urlfetch':
+ import gdata.alt.appengine
+ self.http_client = gdata.alt.appengine.AppEngineHttpClient()
+
+ def _SetSessionId(self, session_id):
+ """Used in unit tests to simulate a 302 which sets a gsessionid."""
+ self.__gsessionid = session_id
+
+ # Define properties for GDataService
+ def _SetAuthSubToken(self, auth_token, scopes=None):
+ """Deprecated, use SetAuthSubToken instead."""
+ self.SetAuthSubToken(auth_token, scopes=scopes)
+
+ def __SetAuthSubToken(self, auth_token, scopes=None):
+ """Deprecated, use SetAuthSubToken instead."""
+ self._SetAuthSubToken(auth_token, scopes=scopes)
+
+ def _GetAuthToken(self):
+ """Returns the auth token used for authenticating requests.
+
+ Returns:
+ string
+ """
+ current_scopes = lookup_scopes(self.service)
+ if current_scopes:
+ token = self.token_store.find_token(current_scopes[0])
+ if hasattr(token, 'auth_header'):
+ return token.auth_header
+ return None
+
+ def _GetCaptchaToken(self):
+ """Returns a captcha token if the most recent login attempt generated one.
+
+ The captcha token is only set if the Programmatic Login attempt failed
+ because the Google service issued a captcha challenge.
+
+ Returns:
+ string
+ """
+ return self.__captcha_token
+
+ def __GetCaptchaToken(self):
+ return self._GetCaptchaToken()
+
+ captcha_token = property(__GetCaptchaToken,
+ doc="""Get the captcha token for a login request.""")
+
+ def _GetCaptchaURL(self):
+ """Returns the URL of the captcha image if a login attempt generated one.
+
+ The captcha URL is only set if the Programmatic Login attempt failed
+ because the Google service issued a captcha challenge.
+
+ Returns:
+ string
+ """
+ return self.__captcha_url
+
+ def __GetCaptchaURL(self):
+ return self._GetCaptchaURL()
+
+ captcha_url = property(__GetCaptchaURL,
+ doc="""Get the captcha URL for a login request.""")
+
+ def GetGeneratorFromLinkFinder(self, link_finder, func,
+ num_retries=DEFAULT_NUM_RETRIES,
+ delay=DEFAULT_DELAY,
+ backoff=DEFAULT_BACKOFF):
+ """returns a generator for pagination"""
+ yield link_finder
+ next = link_finder.GetNextLink()
+ while next is not None:
+ next_feed = func(str(self.GetWithRetries(
+ next.href, num_retries=num_retries, delay=delay, backoff=backoff)))
+ yield next_feed
+ next = next_feed.GetNextLink()
+
+ def _GetElementGeneratorFromLinkFinder(self, link_finder, func,
+ num_retries=DEFAULT_NUM_RETRIES,
+ delay=DEFAULT_DELAY,
+ backoff=DEFAULT_BACKOFF):
+ for element in self.GetGeneratorFromLinkFinder(link_finder, func,
+ num_retries=num_retries,
+ delay=delay,
+ backoff=backoff).entry:
+ yield element
+
+ def GetOAuthInputParameters(self):
+ return self._oauth_input_params
+
+ def SetOAuthInputParameters(self, signature_method, consumer_key,
+ consumer_secret=None, rsa_key=None,
+ two_legged_oauth=False, requestor_id=None):
+ """Sets parameters required for using OAuth authentication mechanism.
+
+ NOTE: Though consumer_secret and rsa_key are optional, either of the two
+ is required depending on the value of the signature_method.
+
+ Args:
+ signature_method: class which provides implementation for strategy class
+ oauth.oauth.OAuthSignatureMethod. Signature method to be used for
+ signing each request. Valid implementations are provided as the
+ constants defined by gdata.auth.OAuthSignatureMethod. Currently
+ they are gdata.auth.OAuthSignatureMethod.RSA_SHA1 and
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1
+ consumer_key: string Domain identifying third_party web application.
+ consumer_secret: string (optional) Secret generated during registration.
+ Required only for HMAC_SHA1 signature method.
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature
+ method.
+ two_legged_oauth: boolean (optional) Enables two-legged OAuth process.
+ requestor_id: string (optional) User email adress to make requests on
+ their behalf. This parameter should only be set when two_legged_oauth
+ is True.
+ """
+ self._oauth_input_params = gdata.auth.OAuthInputParams(
+ signature_method, consumer_key, consumer_secret=consumer_secret,
+ rsa_key=rsa_key, requestor_id=requestor_id)
+ if two_legged_oauth:
+ oauth_token = gdata.auth.OAuthToken(
+ oauth_input_params=self._oauth_input_params)
+ self.SetOAuthToken(oauth_token)
+
+ def FetchOAuthRequestToken(self, scopes=None, extra_parameters=None,
+ request_url='%s/accounts/OAuthGetRequestToken' % \
+ AUTH_SERVER_HOST, oauth_callback=None):
+ """Fetches and sets the OAuth request token and returns it.
+
+ Args:
+ scopes: string or list of string base URL(s) of the service(s) to be
+ accessed. If None, then this method tries to determine the
+ scope(s) from the current service.
+ extra_parameters: dict (optional) key-value pairs as any additional
+ parameters to be included in the URL and signature while making a
+ request for fetching an OAuth request token. All the OAuth parameters
+ are added by default. But if provided through this argument, any
+ default parameters will be overwritten. For e.g. a default parameter
+ oauth_version 1.0 can be overwritten if
+ extra_parameters = {'oauth_version': '2.0'}
+ request_url: Request token URL. The default is
+ 'https://www.google.com/accounts/OAuthGetRequestToken'.
+ oauth_callback: str (optional) If set, it is assume the client is using
+ the OAuth v1.0a protocol where the callback url is sent in the
+ request token step. If the oauth_callback is also set in
+ extra_params, this value will override that one.
+
+ Returns:
+ The fetched request token as a gdata.auth.OAuthToken object.
+
+ Raises:
+ FetchingOAuthRequestTokenFailed if the server responded to the request
+ with an error.
+ """
+ if scopes is None:
+ scopes = lookup_scopes(self.service)
+ if not isinstance(scopes, (list, tuple)):
+ scopes = [scopes,]
+ if oauth_callback:
+ if extra_parameters is not None:
+ extra_parameters['oauth_callback'] = oauth_callback
+ else:
+ extra_parameters = {'oauth_callback': oauth_callback}
+ request_token_url = gdata.auth.GenerateOAuthRequestTokenUrl(
+ self._oauth_input_params, scopes,
+ request_token_url=request_url,
+ extra_parameters=extra_parameters)
+ response = self.http_client.request('GET', str(request_token_url))
+ if response.status == 200:
+ token = gdata.auth.OAuthToken()
+ token.set_token_string(response.read())
+ token.scopes = scopes
+ token.oauth_input_params = self._oauth_input_params
+ self.SetOAuthToken(token)
+ return token
+ error = {
+ 'status': response.status,
+ 'reason': 'Non 200 response on fetch request token',
+ 'body': response.read()
+ }
+ raise FetchingOAuthRequestTokenFailed(error)
+
+ def SetOAuthToken(self, oauth_token):
+ """Attempts to set the current token and add it to the token store.
+
+ The oauth_token can be any OAuth token i.e. unauthorized request token,
+ authorized request token or access token.
+ This method also attempts to add the token to the token store.
+ Use this method any time you want the current token to point to the
+ oauth_token passed. For e.g. call this method with the request token
+ you receive from FetchOAuthRequestToken.
+
+ Args:
+ request_token: gdata.auth.OAuthToken OAuth request token.
+ """
+ if self.auto_set_current_token:
+ self.current_token = oauth_token
+ if self.auto_store_tokens:
+ self.token_store.add_token(oauth_token)
+
+ def GenerateOAuthAuthorizationURL(
+ self, request_token=None, callback_url=None, extra_params=None,
+ include_scopes_in_callback=False,
+ scopes_param_prefix=OAUTH_SCOPE_URL_PARAM_NAME,
+ request_url='%s/accounts/OAuthAuthorizeToken' % AUTH_SERVER_HOST):
+ """Generates URL at which user will login to authorize the request token.
+
+ Args:
+ request_token: gdata.auth.OAuthToken (optional) OAuth request token.
+ If not specified, then the current token will be used if it is of
+ type <gdata.auth.OAuthToken>, else it is found by looking in the
+ token_store by looking for a token for the current scope.
+ callback_url: string (optional) The URL user will be sent to after
+ logging in and granting access.
+ extra_params: dict (optional) Additional parameters to be sent.
+ include_scopes_in_callback: Boolean (default=False) if set to True, and
+ if 'callback_url' is present, the 'callback_url' will be modified to
+ include the scope(s) from the request token as a URL parameter. The
+ key for the 'callback' URL's scope parameter will be
+ OAUTH_SCOPE_URL_PARAM_NAME. The benefit of including the scope URL as
+ a parameter to the 'callback' URL, is that the page which receives
+ the OAuth token will be able to tell which URLs the token grants
+ access to.
+ scopes_param_prefix: string (default='oauth_token_scope') The URL
+ parameter key which maps to the list of valid scopes for the token.
+ This URL parameter will be included in the callback URL along with
+ the scopes of the token as value if include_scopes_in_callback=True.
+ request_url: Authorization URL. The default is
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'.
+ Returns:
+ A string URL at which the user is required to login.
+
+ Raises:
+ NonOAuthToken if the user's request token is not an OAuth token or if a
+ request token was not available.
+ """
+ if request_token and not isinstance(request_token, gdata.auth.OAuthToken):
+ raise NonOAuthToken
+ if not request_token:
+ if isinstance(self.current_token, gdata.auth.OAuthToken):
+ request_token = self.current_token
+ else:
+ current_scopes = lookup_scopes(self.service)
+ if current_scopes:
+ token = self.token_store.find_token(current_scopes[0])
+ if isinstance(token, gdata.auth.OAuthToken):
+ request_token = token
+ if not request_token:
+ raise NonOAuthToken
+ return str(gdata.auth.GenerateOAuthAuthorizationUrl(
+ request_token,
+ authorization_url=request_url,
+ callback_url=callback_url, extra_params=extra_params,
+ include_scopes_in_callback=include_scopes_in_callback,
+ scopes_param_prefix=scopes_param_prefix))
+
+ def UpgradeToOAuthAccessToken(self, authorized_request_token=None,
+ request_url='%s/accounts/OAuthGetAccessToken' \
+ % AUTH_SERVER_HOST, oauth_version='1.0',
+ oauth_verifier=None):
+ """Upgrades the authorized request token to an access token and returns it
+
+ Args:
+ authorized_request_token: gdata.auth.OAuthToken (optional) OAuth request
+ token. If not specified, then the current token will be used if it is
+ of type <gdata.auth.OAuthToken>, else it is found by looking in the
+ token_store by looking for a token for the current scope.
+ request_url: Access token URL. The default is
+ 'https://www.google.com/accounts/OAuthGetAccessToken'.
+ oauth_version: str (default='1.0') oauth_version parameter. All other
+ 'oauth_' parameters are added by default. This parameter too, is
+ added by default but here you can override it's value.
+ oauth_verifier: str (optional) If present, it is assumed that the client
+ will use the OAuth v1.0a protocol which includes passing the
+ oauth_verifier (as returned by the SP) in the access token step.
+
+ Returns:
+ Access token
+
+ Raises:
+ NonOAuthToken if the user's authorized request token is not an OAuth
+ token or if an authorized request token was not available.
+ TokenUpgradeFailed if the server responded to the request with an
+ error.
+ """
+ if (authorized_request_token and
+ not isinstance(authorized_request_token, gdata.auth.OAuthToken)):
+ raise NonOAuthToken
+ if not authorized_request_token:
+ if isinstance(self.current_token, gdata.auth.OAuthToken):
+ authorized_request_token = self.current_token
+ else:
+ current_scopes = lookup_scopes(self.service)
+ if current_scopes:
+ token = self.token_store.find_token(current_scopes[0])
+ if isinstance(token, gdata.auth.OAuthToken):
+ authorized_request_token = token
+ if not authorized_request_token:
+ raise NonOAuthToken
+ access_token_url = gdata.auth.GenerateOAuthAccessTokenUrl(
+ authorized_request_token,
+ self._oauth_input_params,
+ access_token_url=request_url,
+ oauth_version=oauth_version,
+ oauth_verifier=oauth_verifier)
+ response = self.http_client.request('GET', str(access_token_url))
+ if response.status == 200:
+ token = gdata.auth.OAuthTokenFromHttpBody(response.read())
+ token.scopes = authorized_request_token.scopes
+ token.oauth_input_params = authorized_request_token.oauth_input_params
+ self.SetOAuthToken(token)
+ return token
+ else:
+ raise TokenUpgradeFailed({'status': response.status,
+ 'reason': 'Non 200 response on upgrade',
+ 'body': response.read()})
+
+ def RevokeOAuthToken(self, request_url='%s/accounts/AuthSubRevokeToken' % \
+ AUTH_SERVER_HOST):
+ """Revokes an existing OAuth token.
+
+ request_url: Token revoke URL. The default is
+ 'https://www.google.com/accounts/AuthSubRevokeToken'.
+ Raises:
+ NonOAuthToken if the user's auth token is not an OAuth token.
+ RevokingOAuthTokenFailed if request for revoking an OAuth token failed.
+ """
+ scopes = lookup_scopes(self.service)
+ token = self.token_store.find_token(scopes[0])
+ if not isinstance(token, gdata.auth.OAuthToken):
+ raise NonOAuthToken
+
+ response = token.perform_request(self.http_client, 'GET', request_url,
+ headers={'Content-Type':'application/x-www-form-urlencoded'})
+ if response.status == 200:
+ self.token_store.remove_token(token)
+ else:
+ raise RevokingOAuthTokenFailed
+
+ def GetAuthSubToken(self):
+ """Returns the AuthSub token as a string.
+
+ If the token is an gdta.auth.AuthSubToken, the Authorization Label
+ ("AuthSub token") is removed.
+
+ This method examines the current_token to see if it is an AuthSubToken
+ or SecureAuthSubToken. If not, it searches the token_store for a token
+ which matches the current scope.
+
+ The current scope is determined by the service name string member.
+
+ Returns:
+ If the current_token is set to an AuthSubToken/SecureAuthSubToken,
+ return the token string. If there is no current_token, a token string
+ for a token which matches the service object's default scope is returned.
+ If there are no tokens valid for the scope, returns None.
+ """
+ if isinstance(self.current_token, gdata.auth.AuthSubToken):
+ return self.current_token.get_token_string()
+ current_scopes = lookup_scopes(self.service)
+ if current_scopes:
+ token = self.token_store.find_token(current_scopes[0])
+ if isinstance(token, gdata.auth.AuthSubToken):
+ return token.get_token_string()
+ else:
+ token = self.token_store.find_token(atom.token_store.SCOPE_ALL)
+ if isinstance(token, gdata.auth.ClientLoginToken):
+ return token.get_token_string()
+ return None
+
+ def SetAuthSubToken(self, token, scopes=None, rsa_key=None):
+ """Sets the token sent in requests to an AuthSub token.
+
+ Sets the current_token and attempts to add the token to the token_store.
+
+ Only use this method if you have received a token from the AuthSub
+ service. The auth token is set automatically when UpgradeToSessionToken()
+ is used. See documentation for Google AuthSub here:
+ http://code.google.com/apis/accounts/AuthForWebApps.html
+
+ Args:
+ token: gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken or string
+ The token returned by the AuthSub service. If the token is an
+ AuthSubToken or SecureAuthSubToken, the scope information stored in
+ the token is used. If the token is a string, the scopes parameter is
+ used to determine the valid scopes.
+ scopes: list of URLs for which the token is valid. This is only used
+ if the token parameter is a string.
+ rsa_key: string (optional) Private key required for RSA_SHA1 signature
+ method. This parameter is necessary if the token is a string
+ representing a secure token.
+ """
+ if not isinstance(token, gdata.auth.AuthSubToken):
+ token_string = token
+ if rsa_key:
+ token = gdata.auth.SecureAuthSubToken(rsa_key)
+ else:
+ token = gdata.auth.AuthSubToken()
+
+ token.set_token_string(token_string)
+
+ # If no scopes were set for the token, use the scopes passed in, or
+ # try to determine the scopes based on the current service name. If
+ # all else fails, set the token to match all requests.
+ if not token.scopes:
+ if scopes is None:
+ scopes = lookup_scopes(self.service)
+ if scopes is None:
+ scopes = [atom.token_store.SCOPE_ALL]
+ token.scopes = scopes
+ if self.auto_set_current_token:
+ self.current_token = token
+ if self.auto_store_tokens:
+ self.token_store.add_token(token)
+
+ def GetClientLoginToken(self):
+ """Returns the token string for the current token or a token matching the
+ service scope.
+
+ If the current_token is a ClientLoginToken, the token string for
+ the current token is returned. If the current_token is not set, this method
+ searches for a token in the token_store which is valid for the service
+ object's current scope.
+
+ The current scope is determined by the service name string member.
+ The token string is the end of the Authorization header, it doesn not
+ include the ClientLogin label.
+ """
+ if isinstance(self.current_token, gdata.auth.ClientLoginToken):
+ return self.current_token.get_token_string()
+ current_scopes = lookup_scopes(self.service)
+ if current_scopes:
+ token = self.token_store.find_token(current_scopes[0])
+ if isinstance(token, gdata.auth.ClientLoginToken):
+ return token.get_token_string()
+ else:
+ token = self.token_store.find_token(atom.token_store.SCOPE_ALL)
+ if isinstance(token, gdata.auth.ClientLoginToken):
+ return token.get_token_string()
+ return None
+
+ def SetClientLoginToken(self, token, scopes=None):
+ """Sets the token sent in requests to a ClientLogin token.
+
+ This method sets the current_token to a new ClientLoginToken and it
+ also attempts to add the ClientLoginToken to the token_store.
+
+ Only use this method if you have received a token from the ClientLogin
+ service. The auth_token is set automatically when ProgrammaticLogin()
+ is used. See documentation for Google ClientLogin here:
+ http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html
+
+ Args:
+ token: string or instance of a ClientLoginToken.
+ """
+ if not isinstance(token, gdata.auth.ClientLoginToken):
+ token_string = token
+ token = gdata.auth.ClientLoginToken()
+ token.set_token_string(token_string)
+
+ if not token.scopes:
+ if scopes is None:
+ scopes = lookup_scopes(self.service)
+ if scopes is None:
+ scopes = [atom.token_store.SCOPE_ALL]
+ token.scopes = scopes
+ if self.auto_set_current_token:
+ self.current_token = token
+ if self.auto_store_tokens:
+ self.token_store.add_token(token)
+
+ # Private methods to create the source property.
+ def __GetSource(self):
+ return self.__source
+
+ def __SetSource(self, new_source):
+ self.__source = new_source
+ # Update the UserAgent header to include the new application name.
+ self.additional_headers['User-Agent'] = atom.http_interface.USER_AGENT % (
+ self.__source,)
+
+ source = property(__GetSource, __SetSource,
+ doc="""The source is the name of the application making the request.
+ It should be in the form company_id-app_name-app_version""")
+
+ # Authentication operations
+
+ def ProgrammaticLogin(self, captcha_token=None, captcha_response=None):
+ """Authenticates the user and sets the GData Auth token.
+
+ Login retreives a temporary auth token which must be used with all
+ requests to GData services. The auth token is stored in the GData client
+ object.
+
+ Login is also used to respond to a captcha challenge. If the user's login
+ attempt failed with a CaptchaRequired error, the user can respond by
+ calling Login with the captcha token and the answer to the challenge.
+
+ Args:
+ captcha_token: string (optional) The identifier for the captcha challenge
+ which was presented to the user.
+ captcha_response: string (optional) The user's answer to the captch
+ challenge.
+
+ Raises:
+ CaptchaRequired if the login service will require a captcha response
+ BadAuthentication if the login service rejected the username or password
+ Error if the login service responded with a 403 different from the above
+ """
+ request_body = gdata.auth.generate_client_login_request_body(self.email,
+ self.password, self.service, self.source, self.account_type,
+ captcha_token, captcha_response)
+
+ # If the user has defined their own authentication service URL,
+ # send the ClientLogin requests to this URL:
+ if not self.auth_service_url:
+ auth_request_url = AUTH_SERVER_HOST + '/accounts/ClientLogin'
+ else:
+ auth_request_url = self.auth_service_url
+
+ auth_response = self.http_client.request('POST', auth_request_url,
+ data=request_body,
+ headers={'Content-Type':'application/x-www-form-urlencoded'})
+ response_body = auth_response.read()
+
+ if auth_response.status == 200:
+ # TODO: insert the token into the token_store directly.
+ self.SetClientLoginToken(
+ gdata.auth.get_client_login_token(response_body))
+ self.__captcha_token = None
+ self.__captcha_url = None
+
+ elif auth_response.status == 403:
+ # Examine each line to find the error type and the captcha token and
+ # captch URL if they are present.
+ captcha_parameters = gdata.auth.get_captcha_challenge(response_body,
+ captcha_base_url='%s/accounts/' % AUTH_SERVER_HOST)
+ if captcha_parameters:
+ self.__captcha_token = captcha_parameters['token']
+ self.__captcha_url = captcha_parameters['url']
+ raise CaptchaRequired, 'Captcha Required'
+ elif response_body.splitlines()[0] == 'Error=BadAuthentication':
+ self.__captcha_token = None
+ self.__captcha_url = None
+ raise BadAuthentication, 'Incorrect username or password'
+ else:
+ self.__captcha_token = None
+ self.__captcha_url = None
+ raise Error, 'Server responded with a 403 code'
+ elif auth_response.status == 302:
+ self.__captcha_token = None
+ self.__captcha_url = None
+ # Google tries to redirect all bad URLs back to
+ # http://www.google.<locale>. If a redirect
+ # attempt is made, assume the user has supplied an incorrect authentication URL
+ raise BadAuthenticationServiceURL, 'Server responded with a 302 code.'
+
+ def ClientLogin(self, username, password, account_type=None, service=None,
+ auth_service_url=None, source=None, captcha_token=None,
+ captcha_response=None):
+ """Convenience method for authenticating using ProgrammaticLogin.
+
+ Sets values for email, password, and other optional members.
+
+ Args:
+ username:
+ password:
+ account_type: string (optional)
+ service: string (optional)
+ auth_service_url: string (optional)
+ captcha_token: string (optional)
+ captcha_response: string (optional)
+ """
+ self.email = username
+ self.password = password
+
+ if account_type:
+ self.account_type = account_type
+ if service:
+ self.service = service
+ if source:
+ self.source = source
+ if auth_service_url:
+ self.auth_service_url = auth_service_url
+
+ self.ProgrammaticLogin(captcha_token, captcha_response)
+
+ def GenerateAuthSubURL(self, next, scope, secure=False, session=True,
+ domain='default'):
+ """Generate a URL at which the user will login and be redirected back.
+
+ Users enter their credentials on a Google login page and a token is sent
+ to the URL specified in next. See documentation for AuthSub login at:
+ http://code.google.com/apis/accounts/docs/AuthSub.html
+
+ Args:
+ next: string The URL user will be sent to after logging in.
+ scope: string or list of strings. The URLs of the services to be
+ accessed.
+ secure: boolean (optional) Determines whether or not the issued token
+ is a secure token.
+ session: boolean (optional) Determines whether or not the issued token
+ can be upgraded to a session token.
+ """
+ if not isinstance(scope, (list, tuple)):
+ scope = (scope,)
+ return gdata.auth.generate_auth_sub_url(next, scope, secure=secure,
+ session=session,
+ request_url='%s/accounts/AuthSubRequest' % AUTH_SERVER_HOST,
+ domain=domain)
+
+ def UpgradeToSessionToken(self, token=None):
+ """Upgrades a single use AuthSub token to a session token.
+
+ Args:
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken
+ (optional) which is good for a single use but can be upgraded
+ to a session token. If no token is passed in, the token
+ is found by looking in the token_store by looking for a token
+ for the current scope.
+
+ Raises:
+ NonAuthSubToken if the user's auth token is not an AuthSub token
+ TokenUpgradeFailed if the server responded to the request with an
+ error.
+ """
+ if token is None:
+ scopes = lookup_scopes(self.service)
+ if scopes:
+ token = self.token_store.find_token(scopes[0])
+ else:
+ token = self.token_store.find_token(atom.token_store.SCOPE_ALL)
+ if not isinstance(token, gdata.auth.AuthSubToken):
+ raise NonAuthSubToken
+
+ self.SetAuthSubToken(self.upgrade_to_session_token(token))
+
+ def upgrade_to_session_token(self, token):
+ """Upgrades a single use AuthSub token to a session token.
+
+ Args:
+ token: A gdata.auth.AuthSubToken or gdata.auth.SecureAuthSubToken
+ which is good for a single use but can be upgraded to a
+ session token.
+
+ Returns:
+ The upgraded token as a gdata.auth.AuthSubToken object.
+
+ Raises:
+ TokenUpgradeFailed if the server responded to the request with an
+ error.
+ """
+ response = token.perform_request(self.http_client, 'GET',
+ AUTH_SERVER_HOST + '/accounts/AuthSubSessionToken',
+ headers={'Content-Type':'application/x-www-form-urlencoded'})
+ response_body = response.read()
+ if response.status == 200:
+ token.set_token_string(
+ gdata.auth.token_from_http_body(response_body))
+ return token
+ else:
+ raise TokenUpgradeFailed({'status': response.status,
+ 'reason': 'Non 200 response on upgrade',
+ 'body': response_body})
+
+ def RevokeAuthSubToken(self):
+ """Revokes an existing AuthSub token.
+
+ Raises:
+ NonAuthSubToken if the user's auth token is not an AuthSub token
+ """
+ scopes = lookup_scopes(self.service)
+ token = self.token_store.find_token(scopes[0])
+ if not isinstance(token, gdata.auth.AuthSubToken):
+ raise NonAuthSubToken
+
+ response = token.perform_request(self.http_client, 'GET',
+ AUTH_SERVER_HOST + '/accounts/AuthSubRevokeToken',
+ headers={'Content-Type':'application/x-www-form-urlencoded'})
+ if response.status == 200:
+ self.token_store.remove_token(token)
+
+ def AuthSubTokenInfo(self):
+ """Fetches the AuthSub token's metadata from the server.
+
+ Raises:
+ NonAuthSubToken if the user's auth token is not an AuthSub token
+ """
+ scopes = lookup_scopes(self.service)
+ token = self.token_store.find_token(scopes[0])
+ if not isinstance(token, gdata.auth.AuthSubToken):
+ raise NonAuthSubToken
+
+ response = token.perform_request(self.http_client, 'GET',
+ AUTH_SERVER_HOST + '/accounts/AuthSubTokenInfo',
+ headers={'Content-Type':'application/x-www-form-urlencoded'})
+ result_body = response.read()
+ if response.status == 200:
+ return result_body
+ else:
+ raise RequestError, {'status': response.status,
+ 'body': result_body}
+
+ def GetWithRetries(self, uri, extra_headers=None, redirects_remaining=4,
+ encoding='UTF-8', converter=None, num_retries=DEFAULT_NUM_RETRIES,
+ delay=DEFAULT_DELAY, backoff=DEFAULT_BACKOFF, logger=None):
+ """This is a wrapper method for Get with retrying capability.
+
+ To avoid various errors while retrieving bulk entities by retrying
+ specified times.
+
+ Note this method relies on the time module and so may not be usable
+ by default in Python2.2.
+
+ Args:
+ num_retries: Integer; the retry count.
+ delay: Integer; the initial delay for retrying.
+ backoff: Integer; how much the delay should lengthen after each failure.
+ logger: An object which has a debug(str) method to receive logging
+ messages. Recommended that you pass in the logging module.
+ Raises:
+ ValueError if any of the parameters has an invalid value.
+ RanOutOfTries on failure after number of retries.
+ """
+ # Moved import for time module inside this method since time is not a
+ # default module in Python2.2. This method will not be usable in
+ # Python2.2.
+ import time
+ if backoff <= 1:
+ raise ValueError("backoff must be greater than 1")
+ num_retries = int(num_retries)
+
+ if num_retries < 0:
+ raise ValueError("num_retries must be 0 or greater")
+
+ if delay <= 0:
+ raise ValueError("delay must be greater than 0")
+
+ # Let's start
+ mtries, mdelay = num_retries, delay
+ while mtries > 0:
+ if mtries != num_retries:
+ if logger:
+ logger.debug("Retrying: %s" % uri)
+ try:
+ rv = self.Get(uri, extra_headers=extra_headers,
+ redirects_remaining=redirects_remaining,
+ encoding=encoding, converter=converter)
+ except SystemExit:
+ # Allow this error
+ raise
+ except RequestError, e:
+ # Error 500 is 'internal server error' and warrants a retry
+ # Error 503 is 'service unavailable' and warrants a retry
+ if e[0]['status'] not in [500, 503]:
+ raise e
+ # Else, fall through to the retry code...
+ except Exception, e:
+ if logger:
+ logger.debug(e)
+ # Fall through to the retry code...
+ else:
+ # This is the right path.
+ return rv
+ mtries -= 1
+ time.sleep(mdelay)
+ mdelay *= backoff
+ raise RanOutOfTries('Ran out of tries.')
+
+ # CRUD operations
+ def Get(self, uri, extra_headers=None, redirects_remaining=4,
+ encoding='UTF-8', converter=None):
+ """Query the GData API with the given URI
+
+ The uri is the portion of the URI after the server value
+ (ex: www.google.com).
+
+ To perform a query against Google Base, set the server to
+ 'base.google.com' and set the uri to '/base/feeds/...', where ... is
+ your query. For example, to find snippets for all digital cameras uri
+ should be set to: '/base/feeds/snippets?bq=digital+camera'
+
+ Args:
+ uri: string The query in the form of a URI. Example:
+ '/base/feeds/snippets?bq=digital+camera'.
+ extra_headers: dictionary (optional) Extra HTTP headers to be included
+ in the GET request. These headers are in addition to
+ those stored in the client's additional_headers property.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+ redirects_remaining: int (optional) Tracks the number of additional
+ redirects this method will allow. If the service object receives
+ a redirect and remaining is 0, it will not follow the redirect.
+ This was added to avoid infinite redirect loops.
+ encoding: string (optional) The character encoding for the server's
+ response. Default is UTF-8
+ converter: func (optional) A function which will transform
+ the server's results before it is returned. Example: use
+ GDataFeedFromString to parse the server response as if it
+ were a GDataFeed.
+
+ Returns:
+ If there is no ResultsTransformer specified in the call, a GDataFeed
+ or GDataEntry depending on which is sent from the server. If the
+ response is niether a feed or entry and there is no ResultsTransformer,
+ return a string. If there is a ResultsTransformer, the returned value
+ will be that of the ResultsTransformer function.
+ """
+
+ if extra_headers is None:
+ extra_headers = {}
+
+ if self.__gsessionid is not None:
+ if uri.find('gsessionid=') < 0:
+ if uri.find('?') > -1:
+ uri += '&gsessionid=%s' % (self.__gsessionid,)
+ else:
+ uri += '?gsessionid=%s' % (self.__gsessionid,)
+
+ server_response = self.request('GET', uri,
+ headers=extra_headers)
+ result_body = server_response.read()
+
+ if server_response.status == 200:
+ if converter:
+ return converter(result_body)
+ # There was no ResultsTransformer specified, so try to convert the
+ # server's response into a GDataFeed.
+ feed = gdata.GDataFeedFromString(result_body)
+ if not feed:
+ # If conversion to a GDataFeed failed, try to convert the server's
+ # response to a GDataEntry.
+ entry = gdata.GDataEntryFromString(result_body)
+ if not entry:
+ # The server's response wasn't a feed, or an entry, so return the
+ # response body as a string.
+ return result_body
+ return entry
+ return feed
+ elif server_response.status == 302:
+ if redirects_remaining > 0:
+ location = (server_response.getheader('Location')
+ or server_response.getheader('location'))
+ if location is not None:
+ m = re.compile('[\?\&]gsessionid=(\w*\-)').search(location)
+ if m is not None:
+ self.__gsessionid = m.group(1)
+ return GDataService.Get(self, location, extra_headers, redirects_remaining - 1,
+ encoding=encoding, converter=converter)
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': '302 received without Location header',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': 'Redirect received, but redirects_remaining <= 0',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': server_response.reason, 'body': result_body}
+
+ def GetMedia(self, uri, extra_headers=None):
+ """Returns a MediaSource containing media and its metadata from the given
+ URI string.
+ """
+ response_handle = self.request('GET', uri,
+ headers=extra_headers)
+ return gdata.MediaSource(response_handle, response_handle.getheader(
+ 'Content-Type'),
+ response_handle.getheader('Content-Length'))
+
+ def GetEntry(self, uri, extra_headers=None):
+ """Query the GData API with the given URI and receive an Entry.
+
+ See also documentation for gdata.service.Get
+
+ Args:
+ uri: string The query in the form of a URI. Example:
+ '/base/feeds/snippets?bq=digital+camera'.
+ extra_headers: dictionary (optional) Extra HTTP headers to be included
+ in the GET request. These headers are in addition to
+ those stored in the client's additional_headers property.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+
+ Returns:
+ A GDataEntry built from the XML in the server's response.
+ """
+
+ result = GDataService.Get(self, uri, extra_headers,
+ converter=atom.EntryFromString)
+ if isinstance(result, atom.Entry):
+ return result
+ else:
+ raise UnexpectedReturnType, 'Server did not send an entry'
+
+ def GetFeed(self, uri, extra_headers=None,
+ converter=gdata.GDataFeedFromString):
+ """Query the GData API with the given URI and receive a Feed.
+
+ See also documentation for gdata.service.Get
+
+ Args:
+ uri: string The query in the form of a URI. Example:
+ '/base/feeds/snippets?bq=digital+camera'.
+ extra_headers: dictionary (optional) Extra HTTP headers to be included
+ in the GET request. These headers are in addition to
+ those stored in the client's additional_headers property.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+
+ Returns:
+ A GDataFeed built from the XML in the server's response.
+ """
+
+ result = GDataService.Get(self, uri, extra_headers, converter=converter)
+ if isinstance(result, atom.Feed):
+ return result
+ else:
+ raise UnexpectedReturnType, 'Server did not send a feed'
+
+ def GetNext(self, feed):
+ """Requests the next 'page' of results in the feed.
+
+ This method uses the feed's next link to request an additional feed
+ and uses the class of the feed to convert the results of the GET request.
+
+ Args:
+ feed: atom.Feed or a subclass. The feed should contain a next link and
+ the type of the feed will be applied to the results from the
+ server. The new feed which is returned will be of the same class
+ as this feed which was passed in.
+
+ Returns:
+ A new feed representing the next set of results in the server's feed.
+ The type of this feed will match that of the feed argument.
+ """
+ next_link = feed.GetNextLink()
+ # Create a closure which will convert an XML string to the class of
+ # the feed object passed in.
+ def ConvertToFeedClass(xml_string):
+ return atom.CreateClassFromXMLString(feed.__class__, xml_string)
+ # Make a GET request on the next link and use the above closure for the
+ # converted which processes the XML string from the server.
+ if next_link and next_link.href:
+ return GDataService.Get(self, next_link.href,
+ converter=ConvertToFeedClass)
+ else:
+ return None
+
+ def Post(self, data, uri, extra_headers=None, url_params=None,
+ escape_params=True, redirects_remaining=4, media_source=None,
+ converter=None):
+ """Insert or update data into a GData service at the given URI.
+
+ Args:
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The
+ XML to be sent to the uri.
+ uri: string The location (feed) to which the data should be inserted.
+ Example: '/base/feeds/items'.
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type,
+ Authorization, and Content-Length headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+ media_source: MediaSource (optional) Container for the media to be sent
+ along with the entry, if provided.
+ converter: func (optional) A function which will be executed on the
+ server's response. Often this is a function like
+ GDataEntryFromString which will parse the body of the server's
+ response and return a GDataEntry.
+
+ Returns:
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,
+ or the results of running converter on the server's result body (if
+ converter was specified).
+ """
+ return GDataService.PostOrPut(self, 'POST', data, uri,
+ extra_headers=extra_headers, url_params=url_params,
+ escape_params=escape_params, redirects_remaining=redirects_remaining,
+ media_source=media_source, converter=converter)
+
+ def PostOrPut(self, verb, data, uri, extra_headers=None, url_params=None,
+ escape_params=True, redirects_remaining=4, media_source=None,
+ converter=None):
+ """Insert data into a GData service at the given URI.
+
+ Args:
+ verb: string, either 'POST' or 'PUT'
+ data: string, ElementTree._Element, atom.Entry, or gdata.GDataEntry The
+ XML to be sent to the uri.
+ uri: string The location (feed) to which the data should be inserted.
+ Example: '/base/feeds/items'.
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type,
+ Authorization, and Content-Length headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+ media_source: MediaSource (optional) Container for the media to be sent
+ along with the entry, if provided.
+ converter: func (optional) A function which will be executed on the
+ server's response. Often this is a function like
+ GDataEntryFromString which will parse the body of the server's
+ response and return a GDataEntry.
+
+ Returns:
+ If the post succeeded, this method will return a GDataFeed, GDataEntry,
+ or the results of running converter on the server's result body (if
+ converter was specified).
+ """
+ if extra_headers is None:
+ extra_headers = {}
+
+ if self.__gsessionid is not None:
+ if uri.find('gsessionid=') < 0:
+ if url_params is None:
+ url_params = {}
+ url_params['gsessionid'] = self.__gsessionid
+
+ if data and media_source:
+ if ElementTree.iselement(data):
+ data_str = ElementTree.tostring(data)
+ else:
+ data_str = str(data)
+
+ multipart = []
+ multipart.append('Media multipart posting\r\n--END_OF_PART\r\n' + \
+ 'Content-Type: application/atom+xml\r\n\r\n')
+ multipart.append('\r\n--END_OF_PART\r\nContent-Type: ' + \
+ media_source.content_type+'\r\n\r\n')
+ multipart.append('\r\n--END_OF_PART--\r\n')
+
+ extra_headers['MIME-version'] = '1.0'
+ extra_headers['Content-Length'] = str(len(multipart[0]) +
+ len(multipart[1]) + len(multipart[2]) +
+ len(data_str) + media_source.content_length)
+
+ extra_headers['Content-Type'] = 'multipart/related; boundary=END_OF_PART'
+ server_response = self.request(verb, uri,
+ data=[multipart[0], data_str, multipart[1], media_source.file_handle,
+ multipart[2]], headers=extra_headers, url_params=url_params)
+ result_body = server_response.read()
+
+ elif media_source or isinstance(data, gdata.MediaSource):
+ if isinstance(data, gdata.MediaSource):
+ media_source = data
+ extra_headers['Content-Length'] = str(media_source.content_length)
+ extra_headers['Content-Type'] = media_source.content_type
+ server_response = self.request(verb, uri,
+ data=media_source.file_handle, headers=extra_headers,
+ url_params=url_params)
+ result_body = server_response.read()
+
+ else:
+ http_data = data
+ if 'Content-Type' not in extra_headers:
+ content_type = 'application/atom+xml'
+ extra_headers['Content-Type'] = content_type
+ server_response = self.request(verb, uri, data=http_data,
+ headers=extra_headers, url_params=url_params)
+ result_body = server_response.read()
+
+ # Server returns 201 for most post requests, but when performing a batch
+ # request the server responds with a 200 on success.
+ if server_response.status == 201 or server_response.status == 200:
+ if converter:
+ return converter(result_body)
+ feed = gdata.GDataFeedFromString(result_body)
+ if not feed:
+ entry = gdata.GDataEntryFromString(result_body)
+ if not entry:
+ return result_body
+ return entry
+ return feed
+ elif server_response.status == 302:
+ if redirects_remaining > 0:
+ location = (server_response.getheader('Location')
+ or server_response.getheader('location'))
+ if location is not None:
+ m = re.compile('[\?\&]gsessionid=(\w*\-)').search(location)
+ if m is not None:
+ self.__gsessionid = m.group(1)
+ return GDataService.PostOrPut(self, verb, data, location,
+ extra_headers, url_params, escape_params,
+ redirects_remaining - 1, media_source, converter=converter)
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': '302 received without Location header',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': 'Redirect received, but redirects_remaining <= 0',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': server_response.reason, 'body': result_body}
+
+ def Put(self, data, uri, extra_headers=None, url_params=None,
+ escape_params=True, redirects_remaining=3, media_source=None,
+ converter=None):
+ """Updates an entry at the given URI.
+
+ Args:
+ data: string, ElementTree._Element, or xml_wrapper.ElementWrapper The
+ XML containing the updated data.
+ uri: string A URI indicating entry to which the update will be applied.
+ Example: '/base/feeds/items/ITEM-ID'
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type,
+ Authorization, and Content-Length headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+ converter: func (optional) A function which will be executed on the
+ server's response. Often this is a function like
+ GDataEntryFromString which will parse the body of the server's
+ response and return a GDataEntry.
+
+ Returns:
+ If the put succeeded, this method will return a GDataFeed, GDataEntry,
+ or the results of running converter on the server's result body (if
+ converter was specified).
+ """
+ return GDataService.PostOrPut(self, 'PUT', data, uri,
+ extra_headers=extra_headers, url_params=url_params,
+ escape_params=escape_params, redirects_remaining=redirects_remaining,
+ media_source=media_source, converter=converter)
+
+ def Delete(self, uri, extra_headers=None, url_params=None,
+ escape_params=True, redirects_remaining=4):
+ """Deletes the entry at the given URI.
+
+ Args:
+ uri: string The URI of the entry to be deleted. Example:
+ '/base/feeds/items/ITEM-ID'
+ extra_headers: dict (optional) HTTP headers which are to be included.
+ The client automatically sets the Content-Type and
+ Authorization headers.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the URI. These are translated into query arguments
+ in the form '&dict_key=value&...'.
+ Example: {'max-results': '250'} becomes &max-results=250
+ escape_params: boolean (optional) If false, the calling code has already
+ ensured that the query will form a valid URL (all
+ reserved characters have been escaped). If true, this
+ method will escape the query and any URL parameters
+ provided.
+
+ Returns:
+ True if the entry was deleted.
+ """
+ if extra_headers is None:
+ extra_headers = {}
+
+ if self.__gsessionid is not None:
+ if uri.find('gsessionid=') < 0:
+ if url_params is None:
+ url_params = {}
+ url_params['gsessionid'] = self.__gsessionid
+
+ server_response = self.request('DELETE', uri,
+ headers=extra_headers, url_params=url_params)
+ result_body = server_response.read()
+
+ if server_response.status == 200:
+ return True
+ elif server_response.status == 302:
+ if redirects_remaining > 0:
+ location = (server_response.getheader('Location')
+ or server_response.getheader('location'))
+ if location is not None:
+ m = re.compile('[\?\&]gsessionid=(\w*\-)').search(location)
+ if m is not None:
+ self.__gsessionid = m.group(1)
+ return GDataService.Delete(self, location, extra_headers,
+ url_params, escape_params, redirects_remaining - 1)
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': '302 received without Location header',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': 'Redirect received, but redirects_remaining <= 0',
+ 'body': result_body}
+ else:
+ raise RequestError, {'status': server_response.status,
+ 'reason': server_response.reason, 'body': result_body}
+
+
+def ExtractToken(url, scopes_included_in_next=True):
+ """Gets the AuthSub token from the current page's URL.
+
+ Designed to be used on the URL that the browser is sent to after the user
+ authorizes this application at the page given by GenerateAuthSubRequestUrl.
+
+ Args:
+ url: The current page's URL. It should contain the token as a URL
+ parameter. Example: 'http://example.com/?...&token=abcd435'
+ scopes_included_in_next: If True, this function looks for a scope value
+ associated with the token. The scope is a URL parameter with the
+ key set to SCOPE_URL_PARAM_NAME. This parameter should be present
+ if the AuthSub request URL was generated using
+ GenerateAuthSubRequestUrl with include_scope_in_next set to True.
+
+ Returns:
+ A tuple containing the token string and a list of scope strings for which
+ this token should be valid. If the scope was not included in the URL, the
+ tuple will contain (token, None).
+ """
+ parsed = urlparse.urlparse(url)
+ token = gdata.auth.AuthSubTokenFromUrl(parsed[4])
+ scopes = ''
+ if scopes_included_in_next:
+ for pair in parsed[4].split('&'):
+ if pair.startswith('%s=' % SCOPE_URL_PARAM_NAME):
+ scopes = urllib.unquote_plus(pair.split('=')[1])
+ return (token, scopes.split(' '))
+
+
+def GenerateAuthSubRequestUrl(next, scopes, hd='default', secure=False,
+ session=True, request_url='https://www.google.com/accounts/AuthSubRequest',
+ include_scopes_in_next=True):
+ """Creates a URL to request an AuthSub token to access Google services.
+
+ For more details on AuthSub, see the documentation here:
+ http://code.google.com/apis/accounts/docs/AuthSub.html
+
+ Args:
+ next: The URL where the browser should be sent after the user authorizes
+ the application. This page is responsible for receiving the token
+ which is embeded in the URL as a parameter.
+ scopes: The base URL to which access will be granted. Example:
+ 'http://www.google.com/calendar/feeds' will grant access to all
+ URLs in the Google Calendar data API. If you would like a token for
+ multiple scopes, pass in a list of URL strings.
+ hd: The domain to which the user's account belongs. This is set to the
+ domain name if you are using Google Apps. Example: 'example.org'
+ Defaults to 'default'
+ secure: If set to True, all requests should be signed. The default is
+ False.
+ session: If set to True, the token received by the 'next' URL can be
+ upgraded to a multiuse session token. If session is set to False, the
+ token may only be used once and cannot be upgraded. Default is True.
+ request_url: The base of the URL to which the user will be sent to
+ authorize this application to access their data. The default is
+ 'https://www.google.com/accounts/AuthSubRequest'.
+ include_scopes_in_next: Boolean if set to true, the 'next' parameter will
+ be modified to include the requested scope as a URL parameter. The
+ key for the next's scope parameter will be SCOPE_URL_PARAM_NAME. The
+ benefit of including the scope URL as a parameter to the next URL, is
+ that the page which receives the AuthSub token will be able to tell
+ which URLs the token grants access to.
+
+ Returns:
+ A URL string to which the browser should be sent.
+ """
+ if isinstance(scopes, list):
+ scope = ' '.join(scopes)
+ else:
+ scope = scopes
+ if include_scopes_in_next:
+ if next.find('?') > -1:
+ next += '&%s' % urllib.urlencode({SCOPE_URL_PARAM_NAME:scope})
+ else:
+ next += '?%s' % urllib.urlencode({SCOPE_URL_PARAM_NAME:scope})
+ return gdata.auth.GenerateAuthSubUrl(next=next, scope=scope, secure=secure,
+ session=session, request_url=request_url, domain=hd)
+
+
+class Query(dict):
+ """Constructs a query URL to be used in GET requests
+
+ Url parameters are created by adding key-value pairs to this object as a
+ dict. For example, to add &max-results=25 to the URL do
+ my_query['max-results'] = 25
+
+ Category queries are created by adding category strings to the categories
+ member. All items in the categories list will be concatenated with the /
+ symbol (symbolizing a category x AND y restriction). If you would like to OR
+ 2 categories, append them as one string with a | between the categories.
+ For example, do query.categories.append('Fritz|Laurie') to create a query
+ like this feed/-/Fritz%7CLaurie . This query will look for results in both
+ categories.
+ """
+
+ def __init__(self, feed=None, text_query=None, params=None,
+ categories=None):
+ """Constructor for Query
+
+ Args:
+ feed: str (optional) The path for the feed (Examples:
+ '/base/feeds/snippets' or 'calendar/feeds/jo@gmail.com/private/full'
+ text_query: str (optional) The contents of the q query parameter. The
+ contents of the text_query are URL escaped upon conversion to a URI.
+ params: dict (optional) Parameter value string pairs which become URL
+ params when translated to a URI. These parameters are added to the
+ query's items (key-value pairs).
+ categories: list (optional) List of category strings which should be
+ included as query categories. See
+ http://code.google.com/apis/gdata/reference.html#Queries for
+ details. If you want to get results from category A or B (both
+ categories), specify a single list item 'A|B'.
+ """
+
+ self.feed = feed
+ self.categories = []
+ if text_query:
+ self.text_query = text_query
+ if isinstance(params, dict):
+ for param in params:
+ self[param] = params[param]
+ if isinstance(categories, list):
+ for category in categories:
+ self.categories.append(category)
+
+ def _GetTextQuery(self):
+ if 'q' in self.keys():
+ return self['q']
+ else:
+ return None
+
+ def _SetTextQuery(self, query):
+ self['q'] = query
+
+ text_query = property(_GetTextQuery, _SetTextQuery,
+ doc="""The feed query's q parameter""")
+
+ def _GetAuthor(self):
+ if 'author' in self.keys():
+ return self['author']
+ else:
+ return None
+
+ def _SetAuthor(self, query):
+ self['author'] = query
+
+ author = property(_GetAuthor, _SetAuthor,
+ doc="""The feed query's author parameter""")
+
+ def _GetAlt(self):
+ if 'alt' in self.keys():
+ return self['alt']
+ else:
+ return None
+
+ def _SetAlt(self, query):
+ self['alt'] = query
+
+ alt = property(_GetAlt, _SetAlt,
+ doc="""The feed query's alt parameter""")
+
+ def _GetUpdatedMin(self):
+ if 'updated-min' in self.keys():
+ return self['updated-min']
+ else:
+ return None
+
+ def _SetUpdatedMin(self, query):
+ self['updated-min'] = query
+
+ updated_min = property(_GetUpdatedMin, _SetUpdatedMin,
+ doc="""The feed query's updated-min parameter""")
+
+ def _GetUpdatedMax(self):
+ if 'updated-max' in self.keys():
+ return self['updated-max']
+ else:
+ return None
+
+ def _SetUpdatedMax(self, query):
+ self['updated-max'] = query
+
+ updated_max = property(_GetUpdatedMax, _SetUpdatedMax,
+ doc="""The feed query's updated-max parameter""")
+
+ def _GetPublishedMin(self):
+ if 'published-min' in self.keys():
+ return self['published-min']
+ else:
+ return None
+
+ def _SetPublishedMin(self, query):
+ self['published-min'] = query
+
+ published_min = property(_GetPublishedMin, _SetPublishedMin,
+ doc="""The feed query's published-min parameter""")
+
+ def _GetPublishedMax(self):
+ if 'published-max' in self.keys():
+ return self['published-max']
+ else:
+ return None
+
+ def _SetPublishedMax(self, query):
+ self['published-max'] = query
+
+ published_max = property(_GetPublishedMax, _SetPublishedMax,
+ doc="""The feed query's published-max parameter""")
+
+ def _GetStartIndex(self):
+ if 'start-index' in self.keys():
+ return self['start-index']
+ else:
+ return None
+
+ def _SetStartIndex(self, query):
+ if not isinstance(query, str):
+ query = str(query)
+ self['start-index'] = query
+
+ start_index = property(_GetStartIndex, _SetStartIndex,
+ doc="""The feed query's start-index parameter""")
+
+ def _GetMaxResults(self):
+ if 'max-results' in self.keys():
+ return self['max-results']
+ else:
+ return None
+
+ def _SetMaxResults(self, query):
+ if not isinstance(query, str):
+ query = str(query)
+ self['max-results'] = query
+
+ max_results = property(_GetMaxResults, _SetMaxResults,
+ doc="""The feed query's max-results parameter""")
+
+ def _GetOrderBy(self):
+ if 'orderby' in self.keys():
+ return self['orderby']
+ else:
+ return None
+
+ def _SetOrderBy(self, query):
+ self['orderby'] = query
+
+ orderby = property(_GetOrderBy, _SetOrderBy,
+ doc="""The feed query's orderby parameter""")
+
+ def ToUri(self):
+ q_feed = self.feed or ''
+ category_string = '/'.join(
+ [urllib.quote_plus(c) for c in self.categories])
+ # Add categories to the feed if there are any.
+ if len(self.categories) > 0:
+ q_feed = q_feed + '/-/' + category_string
+ return atom.service.BuildUri(q_feed, self)
+
+ def __str__(self):
+ return self.ToUri()
diff --git a/src/gdata/sites/__init__.py b/src/gdata/sites/__init__.py
new file mode 100755
index 0000000..e69de29
--- /dev/null
+++ b/src/gdata/sites/__init__.py
diff --git a/src/gdata/sites/client.py b/src/gdata/sites/client.py
new file mode 100755
index 0000000..c06de69
--- /dev/null
+++ b/src/gdata/sites/client.py
@@ -0,0 +1,480 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""SitesClient extends gdata.client.GDClient to streamline Sites API calls."""
+
+
+__author__ = 'e.bidelman (Eric Bidelman)'
+
+import atom.data
+import gdata.client
+import gdata.sites.data
+import gdata.gauth
+
+
+# Feed URI templates
+CONTENT_FEED_TEMPLATE = '/feeds/content/%s/%s/'
+REVISION_FEED_TEMPLATE = '/feeds/revision/%s/%s/'
+ACTIVITY_FEED_TEMPLATE = '/feeds/activity/%s/%s/'
+SITE_FEED_TEMPLATE = '/feeds/site/%s/'
+ACL_FEED_TEMPLATE = '/feeds/acl/site/%s/%s/'
+
+
+class SitesClient(gdata.client.GDClient):
+
+ """Client extension for the Google Sites API service."""
+
+ host = 'sites.google.com' # default server for the API
+ domain = 'site' # default site domain name
+ api_version = '1.1' # default major version for the service.
+ auth_service = 'jotspot'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['jotspot']
+ ssl = True
+
+ def __init__(self, site=None, domain=None, auth_token=None, **kwargs):
+ """Constructs a new client for the Sites API.
+
+ Args:
+ site: string (optional) Name (webspace) of the Google Site
+ domain: string (optional) Domain of the (Google Apps hosted) Site.
+ If no domain is given, the Site is assumed to be a consumer Google
+ Site, in which case the value 'site' is used.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ kwargs: The other parameters to pass to gdata.client.GDClient
+ constructor.
+ """
+ gdata.client.GDClient.__init__(self, auth_token=auth_token, **kwargs)
+ self.site = site
+ if domain is not None:
+ self.domain = domain
+
+ def __make_kind_category(self, label):
+ if label is None:
+ return None
+ return atom.data.Category(
+ scheme=gdata.sites.data.SITES_KIND_SCHEME,
+ term='%s#%s' % (gdata.sites.data.SITES_NAMESPACE, label), label=label)
+
+ __MakeKindCategory = __make_kind_category
+
+ def __upload(self, entry, media_source, auth_token=None, **kwargs):
+ """Uploads an attachment file to the Sites API.
+
+ Args:
+ entry: gdata.sites.data.ContentEntry The Atom XML to include.
+ media_source: gdata.data.MediaSource The file payload to be uploaded.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ kwargs: Other parameters to pass to gdata.client.post().
+
+ Returns:
+ The created entry.
+ """
+ uri = self.make_content_feed_uri()
+ return self.post(entry, uri, media_source=media_source,
+ auth_token=auth_token, **kwargs)
+
+ def _get_file_content(self, uri):
+ """Fetches the file content from the specified URI.
+
+ Args:
+ uri: string The full URL to fetch the file contents from.
+
+ Returns:
+ The binary file content.
+
+ Raises:
+ gdata.client.RequestError: on error response from server.
+ """
+ server_response = self.request('GET', uri)
+ if server_response.status != 200:
+ raise gdata.client.RequestError, {'status': server_response.status,
+ 'reason': server_response.reason,
+ 'body': server_response.read()}
+ return server_response.read()
+
+ _GetFileContent = _get_file_content
+
+ def make_content_feed_uri(self):
+ return CONTENT_FEED_TEMPLATE % (self.domain, self.site)
+
+ MakeContentFeedUri = make_content_feed_uri
+
+ def make_revision_feed_uri(self):
+ return REVISION_FEED_TEMPLATE % (self.domain, self.site)
+
+ MakeRevisionFeedUri = make_revision_feed_uri
+
+ def make_activity_feed_uri(self):
+ return ACTIVITY_FEED_TEMPLATE % (self.domain, self.site)
+
+ MakeActivityFeedUri = make_activity_feed_uri
+
+ def make_site_feed_uri(self, site_name=None):
+ if site_name is not None:
+ return (SITE_FEED_TEMPLATE % self.domain) + site_name
+ else:
+ return SITE_FEED_TEMPLATE % self.domain
+
+ MakeSiteFeedUri = make_site_feed_uri
+
+ def make_acl_feed_uri(self):
+ return ACL_FEED_TEMPLATE % (self.domain, self.site)
+
+ MakeAclFeedUri = make_acl_feed_uri
+
+ def get_content_feed(self, uri=None, auth_token=None, **kwargs):
+ """Retrieves the content feed containing the current state of site.
+
+ Args:
+ uri: string (optional) A full URI to query the Content feed with.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ kwargs: Other parameters to pass to self.get_feed().
+
+ Returns:
+ gdata.sites.data.ContentFeed
+ """
+ if uri is None:
+ uri = self.make_content_feed_uri()
+ return self.get_feed(uri, desired_class=gdata.sites.data.ContentFeed,
+ auth_token=auth_token, **kwargs)
+
+ GetContentFeed = get_content_feed
+
+ def get_revision_feed(self, entry_or_uri_or_id, auth_token=None, **kwargs):
+ """Retrieves the revision feed containing the revision history for a node.
+
+ Args:
+ entry_or_uri_or_id: string or gdata.sites.data.ContentEntry A full URI,
+ content entry node ID, or a content entry object of the entry to
+ retrieve revision information for.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ kwargs: Other parameters to pass to self.get_feed().
+
+ Returns:
+ gdata.sites.data.RevisionFeed
+ """
+ uri = self.make_revision_feed_uri()
+ if isinstance(entry_or_uri_or_id, gdata.sites.data.ContentEntry):
+ uri = entry_or_uri_or_id.FindRevisionLink()
+ elif entry_or_uri_or_id.find('/') == -1:
+ uri += entry_or_uri_or_id
+ else:
+ uri = entry_or_uri_or_id
+ return self.get_feed(uri, desired_class=gdata.sites.data.RevisionFeed,
+ auth_token=auth_token, **kwargs)
+
+ GetRevisionFeed = get_revision_feed
+
+ def get_activity_feed(self, uri=None, auth_token=None, **kwargs):
+ """Retrieves the activity feed containing recent Site activity.
+
+ Args:
+ uri: string (optional) A full URI to query the Activity feed.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ kwargs: Other parameters to pass to self.get_feed().
+
+ Returns:
+ gdata.sites.data.ActivityFeed
+ """
+ if uri is None:
+ uri = self.make_activity_feed_uri()
+ return self.get_feed(uri, desired_class=gdata.sites.data.ActivityFeed,
+ auth_token=auth_token, **kwargs)
+
+ GetActivityFeed = get_activity_feed
+
+ def get_site_feed(self, uri=None, auth_token=None, **kwargs):
+ """Retrieves the site feed containing a list of sites a user has access to.
+
+ Args:
+ uri: string (optional) A full URI to query the site feed.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ kwargs: Other parameters to pass to self.get_feed().
+
+ Returns:
+ gdata.sites.data.SiteFeed
+ """
+ if uri is None:
+ uri = self.make_site_feed_uri()
+ return self.get_feed(uri, desired_class=gdata.sites.data.SiteFeed,
+ auth_token=auth_token, **kwargs)
+
+ GetSiteFeed = get_site_feed
+
+ def get_acl_feed(self, uri=None, auth_token=None, **kwargs):
+ """Retrieves the acl feed containing a site's sharing permissions.
+
+ Args:
+ uri: string (optional) A full URI to query the acl feed.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ kwargs: Other parameters to pass to self.get_feed().
+
+ Returns:
+ gdata.sites.data.AclFeed
+ """
+ if uri is None:
+ uri = self.make_acl_feed_uri()
+ return self.get_feed(uri, desired_class=gdata.sites.data.AclFeed,
+ auth_token=auth_token, **kwargs)
+
+ GetAclFeed = get_acl_feed
+
+ def create_site(self, title, description=None, source_site=None,
+ theme=None, uri=None, auth_token=None, **kwargs):
+ """Creates a new Google Site.
+
+ Note: This feature is only available to Google Apps domains.
+
+ Args:
+ title: string Title for the site.
+ description: string (optional) A description/summary for the site.
+ source_site: string (optional) The site feed URI of the site to copy.
+ This parameter should only be specified when copying a site.
+ theme: string (optional) The name of the theme to create the site with.
+ uri: string (optional) A full site feed URI to override where the site
+ is created/copied. By default, the site will be created under
+ the currently set domain (e.g. self.domain).
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ kwargs: Other parameters to pass to gdata.client.post().
+
+ Returns:
+ gdata.sites.data.SiteEntry of the created site.
+ """
+ new_entry = gdata.sites.data.SiteEntry(title=atom.data.Title(text=title))
+
+ if description is not None:
+ new_entry.summary = gdata.sites.data.Summary(text=description)
+
+ # Add the source link if we're making a copy of a site.
+ if source_site is not None:
+ source_link = atom.data.Link(rel=gdata.sites.data.SITES_SOURCE_LINK_REL,
+ type='application/atom+xml',
+ href=source_site)
+ new_entry.link.append(source_link)
+
+ if theme is not None:
+ new_entry.theme = gdata.sites.data.Theme(text=theme)
+
+ if uri is None:
+ uri = self.make_site_feed_uri()
+
+ return self.post(new_entry, uri, auth_token=auth_token, **kwargs)
+
+ CreateSite = create_site
+
+ def create_page(self, kind, title, html='', page_name=None, parent=None,
+ auth_token=None, template=None, **kwargs):
+ """Creates a new page (specified by kind) on a Google Site.
+
+ Args:
+ kind: string The type of page/item to create. For example, webpage,
+ listpage, comment, announcementspage, filecabinet, etc. The full list
+ of supported kinds can be found in gdata.sites.gdata.SUPPORT_KINDS.
+ title: string Title for the page.
+ html: string (optional) XHTML for the page's content body.
+ page_name: string (optional) The URL page name to set. If not set, the
+ title will be normalized and used as the page's URL path.
+ parent: string or gdata.sites.data.ContentEntry (optional) The parent
+ entry or parent link url to create the page under.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ template: string or gdata.sites.data.ContentEntry (optional) Create page
+ using the given template. Any content elements will be discarded as
+ they are not valid when creating a page from a template.
+ kwargs: Other parameters to pass to gdata.client.post().
+
+ Returns:
+ gdata.sites.data.ContentEntry of the created page.
+ """
+ content = gdata.sites.data.Content(text=html)
+ if template is not None:
+ content = None
+ new_entry = gdata.sites.data.ContentEntry(
+ title=atom.data.Title(text=title), kind=kind,
+ content=content)
+
+ if page_name is not None:
+ new_entry.page_name = gdata.sites.data.PageName(text=page_name)
+
+ # Add parent link to entry if it should be uploaded as a subpage.
+ if isinstance(parent, gdata.sites.data.ContentEntry):
+ parent_link = atom.data.Link(rel=gdata.sites.data.SITES_PARENT_LINK_REL,
+ type='application/atom+xml',
+ href=parent.GetSelfLink().href)
+ new_entry.link.append(parent_link)
+ elif parent is not None:
+ parent_link = atom.data.Link(rel=gdata.sites.data.SITES_PARENT_LINK_REL,
+ type='application/atom+xml',
+ href=parent)
+ new_entry.link.append(parent_link)
+
+ # Add template link to entry if present.
+ if isinstance(template, gdata.sites.data.ContentEntry):
+ template_link = atom.data.Link(
+ rel=gdata.sites.data.SITES_TEMPLATE_LINK_REL,
+ type='application/atom+xml', href=template.GetSelfLink().href)
+ new_entry.link.append(template_link)
+ elif template is not None:
+ template_link = atom.data.Link(
+ rel=gdata.sites.data.SITES_TEMPLATE_LINK_REL,
+ type='application/atom+xml', href=template)
+ new_entry.link.append(template_link)
+
+ return self.post(new_entry, self.make_content_feed_uri(),
+ auth_token=auth_token, **kwargs)
+
+ CreatePage = create_page
+
+ def create_webattachment(self, src, content_type, title, parent,
+ description=None, auth_token=None, **kwargs):
+ """Creates a new webattachment within a filecabinet.
+
+ Args:
+ src: string The url of the web attachment.
+ content_type: string The MIME type of the web attachment.
+ title: string The title to name the web attachment.
+ parent: string or gdata.sites.data.ContentEntry (optional) The
+ parent entry or url of the filecabinet to create the attachment under.
+ description: string (optional) A summary/description for the attachment.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ kwargs: Other parameters to pass to gdata.client.post().
+
+ Returns:
+ gdata.sites.data.ContentEntry of the created page.
+ """
+ new_entry = gdata.sites.data.ContentEntry(
+ title=atom.data.Title(text=title), kind='webattachment',
+ content=gdata.sites.data.Content(src=src, type=content_type))
+
+ if isinstance(parent, gdata.sites.data.ContentEntry):
+ link = atom.data.Link(rel=gdata.sites.data.SITES_PARENT_LINK_REL,
+ type='application/atom+xml',
+ href=parent.GetSelfLink().href)
+ elif parent is not None:
+ link = atom.data.Link(rel=gdata.sites.data.SITES_PARENT_LINK_REL,
+ type='application/atom+xml', href=parent)
+
+ new_entry.link.append(link)
+
+ # Add file decription if it was specified
+ if description is not None:
+ new_entry.summary = gdata.sites.data.Summary(type='text',
+ text=description)
+
+ return self.post(new_entry, self.make_content_feed_uri(),
+ auth_token=auth_token, **kwargs)
+
+ CreateWebAttachment = create_webattachment
+
+ def upload_attachment(self, file_handle, parent, content_type=None,
+ title=None, description=None, folder_name=None,
+ auth_token=None, **kwargs):
+ """Uploads an attachment to a parent page.
+
+ Args:
+ file_handle: MediaSource or string A gdata.data.MediaSource object
+ containing the file to be uploaded or the full path name to the
+ file on disk.
+ parent: gdata.sites.data.ContentEntry or string The parent page to
+ upload the file to or the full URI of the entry's self link.
+ content_type: string (optional) The MIME type of the file
+ (e.g 'application/pdf'). This should be provided if file is not a
+ MediaSource object.
+ title: string (optional) The title to name the attachment. If not
+ included, the filepath or media source's filename is used.
+ description: string (optional) A summary/description for the attachment.
+ folder_name: string (optional) The name of an existing folder to upload
+ the attachment to. This only applies when the parent parameter points
+ to a filecabinet entry.
+ auth_token: (optional) gdata.gauth.ClientLoginToken, AuthSubToken, or
+ OAuthToken which authorizes this client to edit the user's data.
+ kwargs: Other parameters to pass to self.__upload().
+
+ Returns:
+ A gdata.sites.data.ContentEntry containing information about the created
+ attachment.
+ """
+ if isinstance(parent, gdata.sites.data.ContentEntry):
+ link = atom.data.Link(rel=gdata.sites.data.SITES_PARENT_LINK_REL,
+ type='application/atom+xml',
+ href=parent.GetSelfLink().href)
+ else:
+ link = atom.data.Link(rel=gdata.sites.data.SITES_PARENT_LINK_REL,
+ type='application/atom+xml',
+ href=parent)
+
+ if not isinstance(file_handle, gdata.data.MediaSource):
+ ms = gdata.data.MediaSource(file_path=file_handle,
+ content_type=content_type)
+ else:
+ ms = file_handle
+
+ # If no title specified, use the file name
+ if title is None:
+ title = ms.file_name
+
+ new_entry = gdata.sites.data.ContentEntry(kind='attachment')
+ new_entry.title = atom.data.Title(text=title)
+ new_entry.link.append(link)
+
+ # Add file decription if it was specified
+ if description is not None:
+ new_entry.summary = gdata.sites.data.Summary(type='text',
+ text=description)
+
+ # Upload the attachment to a filecabinet folder?
+ if parent.Kind() == 'filecabinet' and folder_name is not None:
+ folder_category = atom.data.Category(
+ scheme=gdata.sites.data.FOLDER_KIND_TERM, term=folder_name)
+ new_entry.category.append(folder_category)
+
+ return self.__upload(new_entry, ms, auth_token=auth_token, **kwargs)
+
+ UploadAttachment = upload_attachment
+
+ def download_attachment(self, uri_or_entry, file_path):
+ """Downloads an attachment file to disk.
+
+ Args:
+ uri_or_entry: string The full URL to download the file from.
+ file_path: string The full path to save the file to.
+
+ Raises:
+ gdata.client.RequestError: on error response from server.
+ """
+ uri = uri_or_entry
+ if isinstance(uri_or_entry, gdata.sites.data.ContentEntry):
+ uri = uri_or_entry.content.src
+
+ f = open(file_path, 'wb')
+ try:
+ f.write(self._get_file_content(uri))
+ except gdata.client.RequestError, e:
+ f.close()
+ raise e
+ f.flush()
+ f.close()
+
+ DownloadAttachment = download_attachment
diff --git a/src/gdata/sites/data.py b/src/gdata/sites/data.py
new file mode 100644
index 0000000..78c42db
--- /dev/null
+++ b/src/gdata/sites/data.py
@@ -0,0 +1,378 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model classes for parsing and generating XML for the Sites Data API."""
+
+__author__ = 'e.bidelman (Eric Bidelman)'
+
+
+import atom.core
+import atom.data
+import gdata.acl.data
+import gdata.data
+
+# XML Namespaces used in Google Sites entities.
+SITES_NAMESPACE = 'http://schemas.google.com/sites/2008'
+SITES_TEMPLATE = '{http://schemas.google.com/sites/2008}%s'
+SPREADSHEETS_NAMESPACE = 'http://schemas.google.com/spreadsheets/2006'
+SPREADSHEETS_TEMPLATE = '{http://schemas.google.com/spreadsheets/2006}%s'
+DC_TERMS_TEMPLATE = '{http://purl.org/dc/terms}%s'
+THR_TERMS_TEMPLATE = '{http://purl.org/syndication/thread/1.0}%s'
+XHTML_NAMESPACE = 'http://www.w3.org/1999/xhtml'
+XHTML_TEMPLATE = '{http://www.w3.org/1999/xhtml}%s'
+
+SITES_PARENT_LINK_REL = SITES_NAMESPACE + '#parent'
+SITES_REVISION_LINK_REL = SITES_NAMESPACE + '#revision'
+SITES_SOURCE_LINK_REL = SITES_NAMESPACE + '#source'
+SITES_TEMPLATE_LINK_REL = SITES_NAMESPACE + '#template'
+
+SITES_KIND_SCHEME = 'http://schemas.google.com/g/2005#kind'
+ANNOUNCEMENT_KIND_TERM = SITES_NAMESPACE + '#announcement'
+ANNOUNCEMENT_PAGE_KIND_TERM = SITES_NAMESPACE + '#announcementspage'
+ATTACHMENT_KIND_TERM = SITES_NAMESPACE + '#attachment'
+COMMENT_KIND_TERM = SITES_NAMESPACE + '#comment'
+FILECABINET_KIND_TERM = SITES_NAMESPACE + '#filecabinet'
+LISTITEM_KIND_TERM = SITES_NAMESPACE + '#listitem'
+LISTPAGE_KIND_TERM = SITES_NAMESPACE + '#listpage'
+WEBPAGE_KIND_TERM = SITES_NAMESPACE + '#webpage'
+WEBATTACHMENT_KIND_TERM = SITES_NAMESPACE + '#webattachment'
+FOLDER_KIND_TERM = SITES_NAMESPACE + '#folder'
+TAG_KIND_TERM = SITES_NAMESPACE + '#tag'
+
+SUPPORT_KINDS = [
+ 'announcement', 'announcementspage', 'attachment', 'comment', 'filecabinet',
+ 'listitem', 'listpage', 'webpage', 'webattachment', 'tag'
+ ]
+
+
+class Revision(atom.core.XmlElement):
+ """Google Sites <sites:revision>."""
+ _qname = SITES_TEMPLATE % 'revision'
+
+
+class PageName(atom.core.XmlElement):
+ """Google Sites <sites:pageName>."""
+ _qname = SITES_TEMPLATE % 'pageName'
+
+
+class SiteName(atom.core.XmlElement):
+ """Google Sites <sites:siteName>."""
+ _qname = SITES_TEMPLATE % 'siteName'
+
+
+class Theme(atom.core.XmlElement):
+ """Google Sites <sites:theme>."""
+ _qname = SITES_TEMPLATE % 'theme'
+
+
+class Deleted(atom.core.XmlElement):
+ """Google Sites <gd:deleted>."""
+ _qname = gdata.data.GDATA_TEMPLATE % 'deleted'
+
+
+class Publisher(atom.core.XmlElement):
+ """Google Sites <dc:pulisher>."""
+ _qname = DC_TERMS_TEMPLATE % 'publisher'
+
+
+class Worksheet(atom.core.XmlElement):
+ """Google Sites List Page <gs:worksheet>."""
+
+ _qname = SPREADSHEETS_TEMPLATE % 'worksheet'
+ name = 'name'
+
+
+class Header(atom.core.XmlElement):
+ """Google Sites List Page <gs:header>."""
+
+ _qname = SPREADSHEETS_TEMPLATE % 'header'
+ row = 'row'
+
+
+class Column(atom.core.XmlElement):
+ """Google Sites List Page <gs:column>."""
+
+ _qname = SPREADSHEETS_TEMPLATE % 'column'
+ index = 'index'
+ name = 'name'
+
+
+class Data(atom.core.XmlElement):
+ """Google Sites List Page <gs:data>."""
+
+ _qname = SPREADSHEETS_TEMPLATE % 'data'
+ startRow = 'startRow'
+ column = [Column]
+
+
+class Field(atom.core.XmlElement):
+ """Google Sites List Item <gs:field>."""
+
+ _qname = SPREADSHEETS_TEMPLATE % 'field'
+ index = 'index'
+ name = 'name'
+
+
+class InReplyTo(atom.core.XmlElement):
+ """Google Sites List Item <thr:in-reply-to>."""
+
+ _qname = THR_TERMS_TEMPLATE % 'in-reply-to'
+ href = 'href'
+ ref = 'ref'
+ source = 'source'
+ type = 'type'
+
+
+class Content(atom.data.Content):
+ """Google Sites version of <atom:content> that encapsulates XHTML."""
+
+ def __init__(self, html=None, type=None, **kwargs):
+ if type is None and html:
+ type = 'xhtml'
+ super(Content, self).__init__(type=type, **kwargs)
+ if html is not None:
+ self.html = html
+
+ def _get_html(self):
+ if self.children:
+ return self.children[0]
+ else:
+ return ''
+
+ def _set_html(self, html):
+ if not html:
+ self.children = []
+ return
+
+ if type(html) == str:
+ html = atom.core.parse(html)
+ if not html.namespace:
+ html.namespace = XHTML_NAMESPACE
+
+ self.children = [html]
+
+ html = property(_get_html, _set_html)
+
+
+class Summary(atom.data.Summary):
+ """Google Sites version of <atom:summary>."""
+
+ def __init__(self, html=None, type=None, text=None, **kwargs):
+ if type is None and html:
+ type = 'xhtml'
+
+ super(Summary, self).__init__(type=type, text=text, **kwargs)
+ if html is not None:
+ self.html = html
+
+ def _get_html(self):
+ if self.children:
+ return self.children[0]
+ else:
+ return ''
+
+ def _set_html(self, html):
+ if not html:
+ self.children = []
+ return
+
+ if type(html) == str:
+ html = atom.core.parse(html)
+ if not html.namespace:
+ html.namespace = XHTML_NAMESPACE
+
+ self.children = [html]
+
+ html = property(_get_html, _set_html)
+
+
+class BaseSiteEntry(gdata.data.GDEntry):
+ """Google Sites Entry."""
+
+ def __init__(self, kind=None, **kwargs):
+ super(BaseSiteEntry, self).__init__(**kwargs)
+ if kind is not None:
+ self.category.append(
+ atom.data.Category(scheme=SITES_KIND_SCHEME,
+ term='%s#%s' % (SITES_NAMESPACE, kind),
+ label=kind))
+
+ def __find_category_scheme(self, scheme):
+ for category in self.category:
+ if category.scheme == scheme:
+ return category
+ return None
+
+ def kind(self):
+ kind = self.__find_category_scheme(SITES_KIND_SCHEME)
+ if kind is not None:
+ return kind.term[len(SITES_NAMESPACE) + 1:]
+ else:
+ return None
+
+ Kind = kind
+
+ def get_node_id(self):
+ return self.id.text[self.id.text.rfind('/') + 1:]
+
+ GetNodeId = get_node_id
+
+ def find_parent_link(self):
+ return self.find_url(SITES_PARENT_LINK_REL)
+
+ FindParentLink = find_parent_link
+
+ def is_deleted(self):
+ return self.deleted is not None
+
+ IsDeleted = is_deleted
+
+
+class ContentEntry(BaseSiteEntry):
+ """Google Sites Content Entry."""
+ content = Content
+ deleted = Deleted
+ publisher = Publisher
+ in_reply_to = InReplyTo
+ worksheet = Worksheet
+ header = Header
+ data = Data
+ field = [Field]
+ revision = Revision
+ page_name = PageName
+ feed_link = gdata.data.FeedLink
+
+ def find_revison_link(self):
+ return self.find_url(SITES_REVISION_LINK_REL)
+
+ FindRevisionLink = find_revison_link
+
+
+class ContentFeed(gdata.data.GDFeed):
+ """Google Sites Content Feed.
+
+ The Content feed is a feed containing the current, editable site content.
+ """
+ entry = [ContentEntry]
+
+ def __get_entry_type(self, kind):
+ matches = []
+ for entry in self.entry:
+ if entry.Kind() == kind:
+ matches.append(entry)
+ return matches
+
+ def get_announcements(self):
+ return self.__get_entry_type('announcement')
+
+ GetAnnouncements = get_announcements
+
+ def get_announcement_pages(self):
+ return self.__get_entry_type('announcementspage')
+
+ GetAnnouncementPages = get_announcement_pages
+
+ def get_attachments(self):
+ return self.__get_entry_type('attachment')
+
+ GetAttachments = get_attachments
+
+ def get_comments(self):
+ return self.__get_entry_type('comment')
+
+ GetComments = get_comments
+
+ def get_file_cabinets(self):
+ return self.__get_entry_type('filecabinet')
+
+ GetFileCabinets = get_file_cabinets
+
+ def get_list_items(self):
+ return self.__get_entry_type('listitem')
+
+ GetListItems = get_list_items
+
+ def get_list_pages(self):
+ return self.__get_entry_type('listpage')
+
+ GetListPages = get_list_pages
+
+ def get_webpages(self):
+ return self.__get_entry_type('webpage')
+
+ GetWebpages = get_webpages
+
+ def get_webattachments(self):
+ return self.__get_entry_type('webattachment')
+
+ GetWebattachments = get_webattachments
+
+
+class ActivityEntry(BaseSiteEntry):
+ """Google Sites Activity Entry."""
+ summary = Summary
+
+
+class ActivityFeed(gdata.data.GDFeed):
+ """Google Sites Activity Feed.
+
+ The Activity feed is a feed containing recent Site activity.
+ """
+ entry = [ActivityEntry]
+
+
+class RevisionEntry(BaseSiteEntry):
+ """Google Sites Revision Entry."""
+ content = Content
+
+
+class RevisionFeed(gdata.data.GDFeed):
+ """Google Sites Revision Feed.
+
+ The Activity feed is a feed containing recent Site activity.
+ """
+ entry = [RevisionEntry]
+
+
+class SiteEntry(gdata.data.GDEntry):
+ """Google Sites Site Feed Entry."""
+ site_name = SiteName
+ theme = Theme
+
+ def find_source_link(self):
+ return self.find_url(SITES_SOURCE_LINK_REL)
+
+ FindSourceLink = find_source_link
+
+
+class SiteFeed(gdata.data.GDFeed):
+ """Google Sites Site Feed.
+
+ The Site feed can be used to list a user's sites and create new sites.
+ """
+ entry = [SiteEntry]
+
+
+class AclEntry(gdata.acl.data.AclEntry):
+ """Google Sites ACL Entry."""
+
+
+class AclFeed(gdata.acl.data.AclFeed):
+ """Google Sites ACL Feed.
+
+ The ACL feed can be used to modify the sharing permissions of a Site.
+ """
+ entry = [AclEntry]
diff --git a/src/gdata/spreadsheet/__init__.py b/src/gdata/spreadsheet/__init__.py
new file mode 100755
index 0000000..e9a0fb3
--- /dev/null
+++ b/src/gdata/spreadsheet/__init__.py
@@ -0,0 +1,474 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains extensions to Atom objects used with Google Spreadsheets.
+"""
+
+__author__ = 'api.laurabeth@gmail.com (Laura Beth Lincoln)'
+
+
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import atom
+import gdata
+import re
+import string
+
+
+# XML namespaces which are often used in Google Spreadsheets entities.
+GSPREADSHEETS_NAMESPACE = 'http://schemas.google.com/spreadsheets/2006'
+GSPREADSHEETS_TEMPLATE = '{http://schemas.google.com/spreadsheets/2006}%s'
+
+GSPREADSHEETS_EXTENDED_NAMESPACE = ('http://schemas.google.com/spreadsheets'
+ '/2006/extended')
+GSPREADSHEETS_EXTENDED_TEMPLATE = ('{http://schemas.google.com/spreadsheets'
+ '/2006/extended}%s')
+
+
+class ColCount(atom.AtomBase):
+ """The Google Spreadsheets colCount element """
+
+ _tag = 'colCount'
+ _namespace = GSPREADSHEETS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def ColCountFromString(xml_string):
+ return atom.CreateClassFromXMLString(ColCount, xml_string)
+
+
+class RowCount(atom.AtomBase):
+ """The Google Spreadsheets rowCount element """
+
+ _tag = 'rowCount'
+ _namespace = GSPREADSHEETS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, text=None, extension_elements=None,
+ extension_attributes=None):
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+def RowCountFromString(xml_string):
+ return atom.CreateClassFromXMLString(RowCount, xml_string)
+
+
+class Cell(atom.AtomBase):
+ """The Google Spreadsheets cell element """
+
+ _tag = 'cell'
+ _namespace = GSPREADSHEETS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['row'] = 'row'
+ _attributes['col'] = 'col'
+ _attributes['inputValue'] = 'inputValue'
+ _attributes['numericValue'] = 'numericValue'
+
+ def __init__(self, text=None, row=None, col=None, inputValue=None,
+ numericValue=None, extension_elements=None, extension_attributes=None):
+ self.text = text
+ self.row = row
+ self.col = col
+ self.inputValue = inputValue
+ self.numericValue = numericValue
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def CellFromString(xml_string):
+ return atom.CreateClassFromXMLString(Cell, xml_string)
+
+
+class Custom(atom.AtomBase):
+ """The Google Spreadsheets custom element"""
+
+ _namespace = GSPREADSHEETS_EXTENDED_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+
+ def __init__(self, column=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ self.column = column # The name of the column
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ def _BecomeChildElement(self, tree):
+ new_child = ElementTree.Element('')
+ tree.append(new_child)
+ new_child.tag = '{%s}%s' % (self.__class__._namespace,
+ self.column)
+ self._AddMembersToElementTree(new_child)
+
+ def _ToElementTree(self):
+ new_tree = ElementTree.Element('{%s}%s' % (self.__class__._namespace,
+ self.column))
+ self._AddMembersToElementTree(new_tree)
+ return new_tree
+
+ def _HarvestElementTree(self, tree):
+ namespace_uri, local_tag = string.split(tree.tag[1:], "}", 1)
+ self.column = local_tag
+ # Fill in the instance members from the contents of the XML tree.
+ for child in tree:
+ self._ConvertElementTreeToMember(child)
+ for attribute, value in tree.attrib.iteritems():
+ self._ConvertElementAttributeToMember(attribute, value)
+ self.text = tree.text
+
+
+def CustomFromString(xml_string):
+ element_tree = ElementTree.fromstring(xml_string)
+ return _CustomFromElementTree(element_tree)
+
+
+def _CustomFromElementTree(element_tree):
+ namespace_uri, local_tag = string.split(element_tree.tag[1:], "}", 1)
+ if namespace_uri == GSPREADSHEETS_EXTENDED_NAMESPACE:
+ new_custom = Custom()
+ new_custom._HarvestElementTree(element_tree)
+ new_custom.column = local_tag
+ return new_custom
+ return None
+
+
+
+
+
+class SpreadsheetsSpreadsheet(gdata.GDataEntry):
+ """A Google Spreadsheets flavor of a Spreadsheet Atom Entry """
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+ def __init__(self, author=None, category=None, content=None,
+ contributor=None, atom_id=None, link=None, published=None, rights=None,
+ source=None, summary=None, title=None, control=None, updated=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ self.author = author or []
+ self.category = category or []
+ self.content = content
+ self.contributor = contributor or []
+ self.id = atom_id
+ self.link = link or []
+ self.published = published
+ self.rights = rights
+ self.source = source
+ self.summary = summary
+ self.control = control
+ self.title = title
+ self.updated = updated
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SpreadsheetsSpreadsheetFromString(xml_string):
+ return atom.CreateClassFromXMLString(SpreadsheetsSpreadsheet,
+ xml_string)
+
+
+class SpreadsheetsWorksheet(gdata.GDataEntry):
+ """A Google Spreadsheets flavor of a Worksheet Atom Entry """
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}rowCount' % GSPREADSHEETS_NAMESPACE] = ('row_count',
+ RowCount)
+ _children['{%s}colCount' % GSPREADSHEETS_NAMESPACE] = ('col_count',
+ ColCount)
+
+ def __init__(self, author=None, category=None, content=None,
+ contributor=None, atom_id=None, link=None, published=None, rights=None,
+ source=None, summary=None, title=None, control=None, updated=None,
+ row_count=None, col_count=None, text=None, extension_elements=None,
+ extension_attributes=None):
+ self.author = author or []
+ self.category = category or []
+ self.content = content
+ self.contributor = contributor or []
+ self.id = atom_id
+ self.link = link or []
+ self.published = published
+ self.rights = rights
+ self.source = source
+ self.summary = summary
+ self.control = control
+ self.title = title
+ self.updated = updated
+ self.row_count = row_count
+ self.col_count = col_count
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SpreadsheetsWorksheetFromString(xml_string):
+ return atom.CreateClassFromXMLString(SpreadsheetsWorksheet,
+ xml_string)
+
+
+class SpreadsheetsCell(gdata.BatchEntry):
+ """A Google Spreadsheets flavor of a Cell Atom Entry """
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.BatchEntry._children.copy()
+ _attributes = gdata.BatchEntry._attributes.copy()
+ _children['{%s}cell' % GSPREADSHEETS_NAMESPACE] = ('cell', Cell)
+
+ def __init__(self, author=None, category=None, content=None,
+ contributor=None, atom_id=None, link=None, published=None, rights=None,
+ source=None, summary=None, title=None, control=None, updated=None,
+ cell=None, batch_operation=None, batch_id=None, batch_status=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ self.author = author or []
+ self.category = category or []
+ self.content = content
+ self.contributor = contributor or []
+ self.id = atom_id
+ self.link = link or []
+ self.published = published
+ self.rights = rights
+ self.source = source
+ self.summary = summary
+ self.control = control
+ self.title = title
+ self.batch_operation = batch_operation
+ self.batch_id = batch_id
+ self.batch_status = batch_status
+ self.updated = updated
+ self.cell = cell
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SpreadsheetsCellFromString(xml_string):
+ return atom.CreateClassFromXMLString(SpreadsheetsCell,
+ xml_string)
+
+
+class SpreadsheetsList(gdata.GDataEntry):
+ """A Google Spreadsheets flavor of a List Atom Entry """
+
+ _tag = 'entry'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+ def __init__(self, author=None, category=None, content=None,
+ contributor=None, atom_id=None, link=None, published=None, rights=None,
+ source=None, summary=None, title=None, control=None, updated=None,
+ custom=None,
+ text=None, extension_elements=None, extension_attributes=None):
+ self.author = author or []
+ self.category = category or []
+ self.content = content
+ self.contributor = contributor or []
+ self.id = atom_id
+ self.link = link or []
+ self.published = published
+ self.rights = rights
+ self.source = source
+ self.summary = summary
+ self.control = control
+ self.title = title
+ self.updated = updated
+ self.custom = custom or {}
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+ # We need to overwrite _ConvertElementTreeToMember to add special logic to
+ # convert custom attributes to members
+ def _ConvertElementTreeToMember(self, child_tree):
+ # Find the element's tag in this class's list of child members
+ if self.__class__._children.has_key(child_tree.tag):
+ member_name = self.__class__._children[child_tree.tag][0]
+ member_class = self.__class__._children[child_tree.tag][1]
+ # If the class member is supposed to contain a list, make sure the
+ # matching member is set to a list, then append the new member
+ # instance to the list.
+ if isinstance(member_class, list):
+ if getattr(self, member_name) is None:
+ setattr(self, member_name, [])
+ getattr(self, member_name).append(atom._CreateClassFromElementTree(
+ member_class[0], child_tree))
+ else:
+ setattr(self, member_name,
+ atom._CreateClassFromElementTree(member_class, child_tree))
+ elif child_tree.tag.find('{%s}' % GSPREADSHEETS_EXTENDED_NAMESPACE) == 0:
+ # If this is in the custom namespace, make add it to the custom dict.
+ name = child_tree.tag[child_tree.tag.index('}')+1:]
+ custom = _CustomFromElementTree(child_tree)
+ if custom:
+ self.custom[name] = custom
+ else:
+ atom.ExtensionContainer._ConvertElementTreeToMember(self, child_tree)
+
+ # We need to overwtite _AddMembersToElementTree to add special logic to
+ # convert custom members to XML nodes.
+ def _AddMembersToElementTree(self, tree):
+ # Convert the members of this class which are XML child nodes.
+ # This uses the class's _children dictionary to find the members which
+ # should become XML child nodes.
+ member_node_names = [values[0] for tag, values in
+ self.__class__._children.iteritems()]
+ for member_name in member_node_names:
+ member = getattr(self, member_name)
+ if member is None:
+ pass
+ elif isinstance(member, list):
+ for instance in member:
+ instance._BecomeChildElement(tree)
+ else:
+ member._BecomeChildElement(tree)
+ # Convert the members of this class which are XML attributes.
+ for xml_attribute, member_name in self.__class__._attributes.iteritems():
+ member = getattr(self, member_name)
+ if member is not None:
+ tree.attrib[xml_attribute] = member
+ # Convert all special custom item attributes to nodes
+ for name, custom in self.custom.iteritems():
+ custom._BecomeChildElement(tree)
+ # Lastly, call the ExtensionContainers's _AddMembersToElementTree to
+ # convert any extension attributes.
+ atom.ExtensionContainer._AddMembersToElementTree(self, tree)
+
+
+def SpreadsheetsListFromString(xml_string):
+ return atom.CreateClassFromXMLString(SpreadsheetsList,
+ xml_string)
+ element_tree = ElementTree.fromstring(xml_string)
+ return _SpreadsheetsListFromElementTree(element_tree)
+
+
+class SpreadsheetsSpreadsheetsFeed(gdata.GDataFeed):
+ """A feed containing Google Spreadsheets Spreadsheets"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [SpreadsheetsSpreadsheet])
+
+
+def SpreadsheetsSpreadsheetsFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(SpreadsheetsSpreadsheetsFeed,
+ xml_string)
+
+
+class SpreadsheetsWorksheetsFeed(gdata.GDataFeed):
+ """A feed containing Google Spreadsheets Spreadsheets"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [SpreadsheetsWorksheet])
+
+
+def SpreadsheetsWorksheetsFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(SpreadsheetsWorksheetsFeed,
+ xml_string)
+
+
+class SpreadsheetsCellsFeed(gdata.BatchFeed):
+ """A feed containing Google Spreadsheets Cells"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.BatchFeed._children.copy()
+ _attributes = gdata.BatchFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [SpreadsheetsCell])
+ _children['{%s}rowCount' % GSPREADSHEETS_NAMESPACE] = ('row_count',
+ RowCount)
+ _children['{%s}colCount' % GSPREADSHEETS_NAMESPACE] = ('col_count',
+ ColCount)
+
+ def __init__(self, author=None, category=None, contributor=None,
+ generator=None, icon=None, atom_id=None, link=None, logo=None,
+ rights=None, subtitle=None, title=None, updated=None,
+ entry=None, total_results=None, start_index=None,
+ items_per_page=None, extension_elements=None,
+ extension_attributes=None, text=None, row_count=None,
+ col_count=None, interrupted=None):
+ gdata.BatchFeed.__init__(self, author=author, category=category,
+ contributor=contributor, generator=generator,
+ icon=icon, atom_id=atom_id, link=link,
+ logo=logo, rights=rights, subtitle=subtitle,
+ title=title, updated=updated, entry=entry,
+ total_results=total_results,
+ start_index=start_index,
+ items_per_page=items_per_page,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text, interrupted=interrupted)
+ self.row_count = row_count
+ self.col_count = col_count
+
+ def GetBatchLink(self):
+ for link in self.link:
+ if link.rel == 'http://schemas.google.com/g/2005#batch':
+ return link
+ return None
+
+
+def SpreadsheetsCellsFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(SpreadsheetsCellsFeed,
+ xml_string)
+
+
+class SpreadsheetsListFeed(gdata.GDataFeed):
+ """A feed containing Google Spreadsheets Spreadsheets"""
+
+ _tag = 'feed'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [SpreadsheetsList])
+
+
+def SpreadsheetsListFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(SpreadsheetsListFeed,
+ xml_string)
diff --git a/src/gdata/spreadsheet/service.py b/src/gdata/spreadsheet/service.py
new file mode 100755
index 0000000..1fe3eb7
--- /dev/null
+++ b/src/gdata/spreadsheet/service.py
@@ -0,0 +1,487 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""SpreadsheetsService extends the GDataService to streamline Google
+Spreadsheets operations.
+
+ SpreadsheetService: Provides methods to query feeds and manipulate items.
+ Extends GDataService.
+
+ DictionaryToParamList: Function which converts a dictionary into a list of
+ URL arguments (represented as strings). This is a
+ utility function used in CRUD operations.
+"""
+
+__author__ = 'api.laurabeth@gmail.com (Laura Beth Lincoln)'
+
+
+import gdata
+import atom.service
+import gdata.service
+import gdata.spreadsheet
+import atom
+
+
+class Error(Exception):
+ """Base class for exceptions in this module."""
+ pass
+
+
+class RequestError(Error):
+ pass
+
+
+class SpreadsheetsService(gdata.service.GDataService):
+ """Client for the Google Spreadsheets service."""
+
+ def __init__(self, email=None, password=None, source=None,
+ server='spreadsheets.google.com', additional_headers=None,
+ **kwargs):
+ """Creates a client for the Google Spreadsheets service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'spreadsheets.google.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='wise', source=source,
+ server=server, additional_headers=additional_headers, **kwargs)
+
+ def GetSpreadsheetsFeed(self, key=None, query=None, visibility='private',
+ projection='full'):
+ """Gets a spreadsheets feed or a specific entry if a key is defined
+ Args:
+ key: string (optional) The spreadsheet key defined in /ccc?key=
+ query: DocumentQuery (optional) Query parameters
+
+ Returns:
+ If there is no key, then a SpreadsheetsSpreadsheetsFeed.
+ If there is a key, then a SpreadsheetsSpreadsheet.
+ """
+
+ base_uri = 'https://%s/feeds/spreadsheets' % self.server
+ uri = ('%s/%s/%s'
+ % (base_uri, visibility, projection))
+
+ if key is not None:
+ uri = '%s/%s' % (uri, key)
+
+ if query != None:
+ query.feed = base_uri
+ query.visibility = visibility
+ query.projection = projection
+ uri = query.ToUri()
+
+ if key:
+ return self.Get(uri,
+ converter=gdata.spreadsheet.SpreadsheetsSpreadsheetFromString)
+ else:
+ return self.Get(uri,
+ converter=gdata.spreadsheet.SpreadsheetsSpreadsheetsFeedFromString)
+
+ def GetWorksheetsFeed(self, key, wksht_id=None, query=None,
+ visibility='private', projection='full'):
+ """Gets a worksheets feed or a specific entry if a wksht is defined
+ Args:
+ key: string The spreadsheet key defined in /ccc?key=
+ wksht_id: string (optional) The id for a specific worksheet entry
+ query: DocumentQuery (optional) Query parameters
+
+ Returns:
+ If there is no wksht_id, then a SpreadsheetsWorksheetsFeed.
+ If there is a wksht_id, then a SpreadsheetsWorksheet.
+ """
+
+ uri = ('https://%s/feeds/worksheets/%s/%s/%s'
+ % (self.server, key, visibility, projection))
+
+ if wksht_id != None:
+ uri = '%s/%s' % (uri, wksht_id)
+
+ if query != None:
+ query.feed = uri
+ uri = query.ToUri()
+
+ if wksht_id:
+ return self.Get(uri,
+ converter=gdata.spreadsheet.SpreadsheetsWorksheetFromString)
+ else:
+ return self.Get(uri,
+ converter=gdata.spreadsheet.SpreadsheetsWorksheetsFeedFromString)
+
+ def AddWorksheet(self, title, row_count, col_count, key):
+ """Creates a new worksheet in the desired spreadsheet.
+
+ The new worksheet is appended to the end of the list of worksheets. The
+ new worksheet will only have the available number of columns and cells
+ specified.
+
+ Args:
+ title: str The title which will be displayed in the list of worksheets.
+ row_count: int or str The number of rows in the new worksheet.
+ col_count: int or str The number of columns in the new worksheet.
+ key: str The spreadsheet key to the spreadsheet to which the new
+ worksheet should be added.
+
+ Returns:
+ A SpreadsheetsWorksheet if the new worksheet was created succesfully.
+ """
+ new_worksheet = gdata.spreadsheet.SpreadsheetsWorksheet(
+ title=atom.Title(text=title),
+ row_count=gdata.spreadsheet.RowCount(text=str(row_count)),
+ col_count=gdata.spreadsheet.ColCount(text=str(col_count)))
+ return self.Post(new_worksheet,
+ 'https://%s/feeds/worksheets/%s/private/full' % (self.server, key),
+ converter=gdata.spreadsheet.SpreadsheetsWorksheetFromString)
+
+ def UpdateWorksheet(self, worksheet_entry, url=None):
+ """Changes the size and/or title of the desired worksheet.
+
+ Args:
+ worksheet_entry: SpreadsheetWorksheet The new contents of the
+ worksheet.
+ url: str (optional) The URL to which the edited worksheet entry should
+ be sent. If the url is None, the edit URL from the worksheet will
+ be used.
+
+ Returns:
+ A SpreadsheetsWorksheet with the new information about the worksheet.
+ """
+ target_url = url or worksheet_entry.GetEditLink().href
+ return self.Put(worksheet_entry, target_url,
+ converter=gdata.spreadsheet.SpreadsheetsWorksheetFromString)
+
+ def DeleteWorksheet(self, worksheet_entry=None, url=None):
+ """Removes the desired worksheet from the spreadsheet
+
+ Args:
+ worksheet_entry: SpreadsheetWorksheet (optional) The worksheet to
+ be deleted. If this is none, then the DELETE reqest is sent to
+ the url specified in the url parameter.
+ url: str (optaional) The URL to which the DELETE request should be
+ sent. If left as None, the worksheet's edit URL is used.
+
+ Returns:
+ True if the worksheet was deleted successfully.
+ """
+ if url:
+ target_url = url
+ else:
+ target_url = worksheet_entry.GetEditLink().href
+ return self.Delete(target_url)
+
+ def GetCellsFeed(self, key, wksht_id='default', cell=None, query=None,
+ visibility='private', projection='full'):
+ """Gets a cells feed or a specific entry if a cell is defined
+ Args:
+ key: string The spreadsheet key defined in /ccc?key=
+ wksht_id: string The id for a specific worksheet entry
+ cell: string (optional) The R1C1 address of the cell
+ query: DocumentQuery (optional) Query parameters
+
+ Returns:
+ If there is no cell, then a SpreadsheetsCellsFeed.
+ If there is a cell, then a SpreadsheetsCell.
+ """
+
+ uri = ('https://%s/feeds/cells/%s/%s/%s/%s'
+ % (self.server, key, wksht_id, visibility, projection))
+
+ if cell != None:
+ uri = '%s/%s' % (uri, cell)
+
+ if query != None:
+ query.feed = uri
+ uri = query.ToUri()
+
+ if cell:
+ return self.Get(uri,
+ converter=gdata.spreadsheet.SpreadsheetsCellFromString)
+ else:
+ return self.Get(uri,
+ converter=gdata.spreadsheet.SpreadsheetsCellsFeedFromString)
+
+ def GetListFeed(self, key, wksht_id='default', row_id=None, query=None,
+ visibility='private', projection='full'):
+ """Gets a list feed or a specific entry if a row_id is defined
+ Args:
+ key: string The spreadsheet key defined in /ccc?key=
+ wksht_id: string The id for a specific worksheet entry
+ row_id: string (optional) The row_id of a row in the list
+ query: DocumentQuery (optional) Query parameters
+
+ Returns:
+ If there is no row_id, then a SpreadsheetsListFeed.
+ If there is a row_id, then a SpreadsheetsList.
+ """
+
+ uri = ('https://%s/feeds/list/%s/%s/%s/%s'
+ % (self.server, key, wksht_id, visibility, projection))
+
+ if row_id is not None:
+ uri = '%s/%s' % (uri, row_id)
+
+ if query is not None:
+ query.feed = uri
+ uri = query.ToUri()
+
+ if row_id:
+ return self.Get(uri,
+ converter=gdata.spreadsheet.SpreadsheetsListFromString)
+ else:
+ return self.Get(uri,
+ converter=gdata.spreadsheet.SpreadsheetsListFeedFromString)
+
+ def UpdateCell(self, row, col, inputValue, key, wksht_id='default'):
+ """Updates an existing cell.
+
+ Args:
+ row: int The row the cell to be editted is in
+ col: int The column the cell to be editted is in
+ inputValue: str the new value of the cell
+ key: str The key of the spreadsheet in which this cell resides.
+ wksht_id: str The ID of the worksheet which holds this cell.
+
+ Returns:
+ The updated cell entry
+ """
+ row = str(row)
+ col = str(col)
+ # make the new cell
+ new_cell = gdata.spreadsheet.Cell(row=row, col=col, inputValue=inputValue)
+ # get the edit uri and PUT
+ cell = 'R%sC%s' % (row, col)
+ entry = self.GetCellsFeed(key, wksht_id, cell)
+ for a_link in entry.link:
+ if a_link.rel == 'edit':
+ entry.cell = new_cell
+ return self.Put(entry, a_link.href,
+ converter=gdata.spreadsheet.SpreadsheetsCellFromString)
+
+ def _GenerateCellsBatchUrl(self, spreadsheet_key, worksheet_id):
+ return ('https://spreadsheets.google.com/feeds/cells/%s/%s/'
+ 'private/full/batch' % (spreadsheet_key, worksheet_id))
+
+ def ExecuteBatch(self, batch_feed, url=None, spreadsheet_key=None,
+ worksheet_id=None,
+ converter=gdata.spreadsheet.SpreadsheetsCellsFeedFromString):
+ """Sends a batch request feed to the server.
+
+ The batch request needs to be sent to the batch URL for a particular
+ worksheet. You can specify the worksheet by providing the spreadsheet_key
+ and worksheet_id, or by sending the URL from the cells feed's batch link.
+
+ Args:
+ batch_feed: gdata.spreadsheet.SpreadsheetsCellFeed A feed containing
+ BatchEntry elements which contain the desired CRUD operation and
+ any necessary data to modify a cell.
+ url: str (optional) The batch URL for the cells feed to which these
+ changes should be applied. This can be found by calling
+ cells_feed.GetBatchLink().href.
+ spreadsheet_key: str (optional) Used to generate the batch request URL
+ if the url argument is None. If using the spreadsheet key to
+ generate the URL, the worksheet id is also required.
+ worksheet_id: str (optional) Used if the url is not provided, it is
+ oart of the batch feed target URL. This is used with the spreadsheet
+ key.
+ converter: Function (optional) Function to be executed on the server's
+ response. This function should take one string as a parameter. The
+ default value is SpreadsheetsCellsFeedFromString which will turn the result
+ into a gdata.spreadsheet.SpreadsheetsCellsFeed object.
+
+ Returns:
+ A gdata.BatchFeed containing the results.
+ """
+
+ if url is None:
+ url = self._GenerateCellsBatchUrl(spreadsheet_key, worksheet_id)
+ return self.Post(batch_feed, url, converter=converter)
+
+ def InsertRow(self, row_data, key, wksht_id='default'):
+ """Inserts a new row with the provided data
+
+ Args:
+ uri: string The post uri of the list feed
+ row_data: dict A dictionary of column header to row data
+
+ Returns:
+ The inserted row
+ """
+ new_entry = gdata.spreadsheet.SpreadsheetsList()
+ for k, v in row_data.iteritems():
+ new_custom = gdata.spreadsheet.Custom()
+ new_custom.column = k
+ new_custom.text = v
+ new_entry.custom[new_custom.column] = new_custom
+ # Generate the post URL for the worksheet which will receive the new entry.
+ post_url = 'https://spreadsheets.google.com/feeds/list/%s/%s/private/full'%(
+ key, wksht_id)
+ return self.Post(new_entry, post_url,
+ converter=gdata.spreadsheet.SpreadsheetsListFromString)
+
+ def UpdateRow(self, entry, new_row_data):
+ """Updates a row with the provided data
+
+ If you want to add additional information to a row, it is often
+ easier to change the values in entry.custom, then use the Put
+ method instead of UpdateRow. This UpdateRow method will replace
+ the contents of the row with new_row_data - it will change all columns
+ not just the columns specified in the new_row_data dict.
+
+ Args:
+ entry: gdata.spreadsheet.SpreadsheetsList The entry to be updated
+ new_row_data: dict A dictionary of column header to row data
+
+ Returns:
+ The updated row
+ """
+ entry.custom = {}
+ for k, v in new_row_data.iteritems():
+ new_custom = gdata.spreadsheet.Custom()
+ new_custom.column = k
+ new_custom.text = v
+ entry.custom[k] = new_custom
+ for a_link in entry.link:
+ if a_link.rel == 'edit':
+ return self.Put(entry, a_link.href,
+ converter=gdata.spreadsheet.SpreadsheetsListFromString)
+
+ def DeleteRow(self, entry):
+ """Deletes a row, the provided entry
+
+ Args:
+ entry: gdata.spreadsheet.SpreadsheetsList The row to be deleted
+
+ Returns:
+ The delete response
+ """
+ for a_link in entry.link:
+ if a_link.rel == 'edit':
+ return self.Delete(a_link.href)
+
+
+class DocumentQuery(gdata.service.Query):
+
+ def _GetTitleQuery(self):
+ return self['title']
+
+ def _SetTitleQuery(self, document_query):
+ self['title'] = document_query
+
+ title = property(_GetTitleQuery, _SetTitleQuery,
+ doc="""The title query parameter""")
+
+ def _GetTitleExactQuery(self):
+ return self['title-exact']
+
+ def _SetTitleExactQuery(self, document_query):
+ self['title-exact'] = document_query
+
+ title_exact = property(_GetTitleExactQuery, _SetTitleExactQuery,
+ doc="""The title-exact query parameter""")
+
+
+class CellQuery(gdata.service.Query):
+
+ def _GetMinRowQuery(self):
+ return self['min-row']
+
+ def _SetMinRowQuery(self, cell_query):
+ self['min-row'] = cell_query
+
+ min_row = property(_GetMinRowQuery, _SetMinRowQuery,
+ doc="""The min-row query parameter""")
+
+ def _GetMaxRowQuery(self):
+ return self['max-row']
+
+ def _SetMaxRowQuery(self, cell_query):
+ self['max-row'] = cell_query
+
+ max_row = property(_GetMaxRowQuery, _SetMaxRowQuery,
+ doc="""The max-row query parameter""")
+
+ def _GetMinColQuery(self):
+ return self['min-col']
+
+ def _SetMinColQuery(self, cell_query):
+ self['min-col'] = cell_query
+
+ min_col = property(_GetMinColQuery, _SetMinColQuery,
+ doc="""The min-col query parameter""")
+
+ def _GetMaxColQuery(self):
+ return self['max-col']
+
+ def _SetMaxColQuery(self, cell_query):
+ self['max-col'] = cell_query
+
+ max_col = property(_GetMaxColQuery, _SetMaxColQuery,
+ doc="""The max-col query parameter""")
+
+ def _GetRangeQuery(self):
+ return self['range']
+
+ def _SetRangeQuery(self, cell_query):
+ self['range'] = cell_query
+
+ range = property(_GetRangeQuery, _SetRangeQuery,
+ doc="""The range query parameter""")
+
+ def _GetReturnEmptyQuery(self):
+ return self['return-empty']
+
+ def _SetReturnEmptyQuery(self, cell_query):
+ self['return-empty'] = cell_query
+
+ return_empty = property(_GetReturnEmptyQuery, _SetReturnEmptyQuery,
+ doc="""The return-empty query parameter""")
+
+
+class ListQuery(gdata.service.Query):
+
+ def _GetSpreadsheetQuery(self):
+ return self['sq']
+
+ def _SetSpreadsheetQuery(self, list_query):
+ self['sq'] = list_query
+
+ sq = property(_GetSpreadsheetQuery, _SetSpreadsheetQuery,
+ doc="""The sq query parameter""")
+
+ def _GetOrderByQuery(self):
+ return self['orderby']
+
+ def _SetOrderByQuery(self, list_query):
+ self['orderby'] = list_query
+
+ orderby = property(_GetOrderByQuery, _SetOrderByQuery,
+ doc="""The orderby query parameter""")
+
+ def _GetReverseQuery(self):
+ return self['reverse']
+
+ def _SetReverseQuery(self, list_query):
+ self['reverse'] = list_query
+
+ reverse = property(_GetReverseQuery, _SetReverseQuery,
+ doc="""The reverse query parameter""")
diff --git a/src/gdata/spreadsheet/text_db.py b/src/gdata/spreadsheet/text_db.py
new file mode 100644
index 0000000..a8de546
--- /dev/null
+++ b/src/gdata/spreadsheet/text_db.py
@@ -0,0 +1,559 @@
+#!/usr/bin/python
+#
+# Copyright Google 2007-2008, all rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import StringIO
+import gdata
+import gdata.service
+import gdata.spreadsheet
+import gdata.spreadsheet.service
+import gdata.docs
+import gdata.docs.service
+
+
+"""Make the Google Documents API feel more like using a database.
+
+This module contains a client and other classes which make working with the
+Google Documents List Data API and the Google Spreadsheets Data API look a
+bit more like working with a heirarchical database. Using the DatabaseClient,
+you can create or find spreadsheets and use them like a database, with
+worksheets representing tables and rows representing records.
+
+Example Usage:
+# Create a new database, a new table, and add records.
+client = gdata.spreadsheet.text_db.DatabaseClient(username='jo@example.com',
+ password='12345')
+database = client.CreateDatabase('My Text Database')
+table = database.CreateTable('addresses', ['name','email',
+ 'phonenumber', 'mailingaddress'])
+record = table.AddRecord({'name':'Bob', 'email':'bob@example.com',
+ 'phonenumber':'555-555-1234', 'mailingaddress':'900 Imaginary St.'})
+
+# Edit a record
+record.content['email'] = 'bob2@example.com'
+record.Push()
+
+# Delete a table
+table.Delete
+
+Warnings:
+Care should be exercised when using this module on spreadsheets
+which contain formulas. This module treats all rows as containing text and
+updating a row will overwrite any formula with the output of the formula.
+The intended use case is to allow easy storage of text data in a spreadsheet.
+
+ Error: Domain specific extension of Exception.
+ BadCredentials: Error raised is username or password was incorrect.
+ CaptchaRequired: Raised if a login attempt failed and a CAPTCHA challenge
+ was issued.
+ DatabaseClient: Communicates with Google Docs APIs servers.
+ Database: Represents a spreadsheet and interacts with tables.
+ Table: Represents a worksheet and interacts with records.
+ RecordResultSet: A list of records in a table.
+ Record: Represents a row in a worksheet allows manipulation of text data.
+"""
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+
+class Error(Exception):
+ pass
+
+
+class BadCredentials(Error):
+ pass
+
+
+class CaptchaRequired(Error):
+ pass
+
+
+class DatabaseClient(object):
+ """Allows creation and finding of Google Spreadsheets databases.
+
+ The DatabaseClient simplifies the process of creating and finding Google
+ Spreadsheets and will talk to both the Google Spreadsheets API and the
+ Google Documents List API.
+ """
+
+ def __init__(self, username=None, password=None):
+ """Constructor for a Database Client.
+
+ If the username and password are present, the constructor will contact
+ the Google servers to authenticate.
+
+ Args:
+ username: str (optional) Example: jo@example.com
+ password: str (optional)
+ """
+ self.__docs_client = gdata.docs.service.DocsService()
+ self.__spreadsheets_client = (
+ gdata.spreadsheet.service.SpreadsheetsService())
+ self.SetCredentials(username, password)
+
+ def SetCredentials(self, username, password):
+ """Attempts to log in to Google APIs using the provided credentials.
+
+ If the username or password are None, the client will not request auth
+ tokens.
+
+ Args:
+ username: str (optional) Example: jo@example.com
+ password: str (optional)
+ """
+ self.__docs_client.email = username
+ self.__docs_client.password = password
+ self.__spreadsheets_client.email = username
+ self.__spreadsheets_client.password = password
+ if username and password:
+ try:
+ self.__docs_client.ProgrammaticLogin()
+ self.__spreadsheets_client.ProgrammaticLogin()
+ except gdata.service.CaptchaRequired:
+ raise CaptchaRequired('Please visit https://www.google.com/accounts/'
+ 'DisplayUnlockCaptcha to unlock your account.')
+ except gdata.service.BadAuthentication:
+ raise BadCredentials('Username or password incorrect.')
+
+ def CreateDatabase(self, name):
+ """Creates a new Google Spreadsheet with the desired name.
+
+ Args:
+ name: str The title for the spreadsheet.
+
+ Returns:
+ A Database instance representing the new spreadsheet.
+ """
+ # Create a Google Spreadsheet to form the foundation of this database.
+ # Spreadsheet is created by uploading a file to the Google Documents
+ # List API.
+ virtual_csv_file = StringIO.StringIO(',,,')
+ virtual_media_source = gdata.MediaSource(file_handle=virtual_csv_file, content_type='text/csv', content_length=3)
+ db_entry = self.__docs_client.UploadSpreadsheet(virtual_media_source, name)
+ return Database(spreadsheet_entry=db_entry, database_client=self)
+
+ def GetDatabases(self, spreadsheet_key=None, name=None):
+ """Finds spreadsheets which have the unique key or title.
+
+ If querying on the spreadsheet_key there will be at most one result, but
+ searching by name could yield multiple results.
+
+ Args:
+ spreadsheet_key: str The unique key for the spreadsheet, this
+ usually in the the form 'pk23...We' or 'o23...423.12,,,3'.
+ name: str The title of the spreadsheets.
+
+ Returns:
+ A list of Database objects representing the desired spreadsheets.
+ """
+ if spreadsheet_key:
+ db_entry = self.__docs_client.GetDocumentListEntry(
+ r'/feeds/documents/private/full/spreadsheet%3A' + spreadsheet_key)
+ return [Database(spreadsheet_entry=db_entry, database_client=self)]
+ else:
+ title_query = gdata.docs.service.DocumentQuery()
+ title_query['title'] = name
+ db_feed = self.__docs_client.QueryDocumentListFeed(title_query.ToUri())
+ matching_databases = []
+ for entry in db_feed.entry:
+ matching_databases.append(Database(spreadsheet_entry=entry,
+ database_client=self))
+ return matching_databases
+
+ def _GetDocsClient(self):
+ return self.__docs_client
+
+ def _GetSpreadsheetsClient(self):
+ return self.__spreadsheets_client
+
+
+class Database(object):
+ """Provides interface to find and create tables.
+
+ The database represents a Google Spreadsheet.
+ """
+
+ def __init__(self, spreadsheet_entry=None, database_client=None):
+ """Constructor for a database object.
+
+ Args:
+ spreadsheet_entry: gdata.docs.DocumentListEntry The
+ Atom entry which represents the Google Spreadsheet. The
+ spreadsheet's key is extracted from the entry and stored as a
+ member.
+ database_client: DatabaseClient A client which can talk to the
+ Google Spreadsheets servers to perform operations on worksheets
+ within this spreadsheet.
+ """
+ self.entry = spreadsheet_entry
+ if self.entry:
+ id_parts = spreadsheet_entry.id.text.split('/')
+ self.spreadsheet_key = id_parts[-1].replace('spreadsheet%3A', '')
+ self.client = database_client
+
+ def CreateTable(self, name, fields=None):
+ """Add a new worksheet to this spreadsheet and fill in column names.
+
+ Args:
+ name: str The title of the new worksheet.
+ fields: list of strings The column names which are placed in the
+ first row of this worksheet. These names are converted into XML
+ tags by the server. To avoid changes during the translation
+ process I recommend using all lowercase alphabetic names. For
+ example ['somelongname', 'theothername']
+
+ Returns:
+ Table representing the newly created worksheet.
+ """
+ worksheet = self.client._GetSpreadsheetsClient().AddWorksheet(title=name,
+ row_count=1, col_count=len(fields), key=self.spreadsheet_key)
+ return Table(name=name, worksheet_entry=worksheet,
+ database_client=self.client,
+ spreadsheet_key=self.spreadsheet_key, fields=fields)
+
+ def GetTables(self, worksheet_id=None, name=None):
+ """Searches for a worksheet with the specified ID or name.
+
+ The list of results should have one table at most, or no results
+ if the id or name were not found.
+
+ Args:
+ worksheet_id: str The ID of the worksheet, example: 'od6'
+ name: str The title of the worksheet.
+
+ Returns:
+ A list of length 0 or 1 containing the desired Table. A list is returned
+ to make this method feel like GetDatabases and GetRecords.
+ """
+ if worksheet_id:
+ worksheet_entry = self.client._GetSpreadsheetsClient().GetWorksheetsFeed(
+ self.spreadsheet_key, wksht_id=worksheet_id)
+ return [Table(name=worksheet_entry.title.text,
+ worksheet_entry=worksheet_entry, database_client=self.client,
+ spreadsheet_key=self.spreadsheet_key)]
+ else:
+ matching_tables = []
+ query = None
+ if name:
+ query = gdata.spreadsheet.service.DocumentQuery()
+ query.title = name
+
+ worksheet_feed = self.client._GetSpreadsheetsClient().GetWorksheetsFeed(
+ self.spreadsheet_key, query=query)
+ for entry in worksheet_feed.entry:
+ matching_tables.append(Table(name=entry.title.text,
+ worksheet_entry=entry, database_client=self.client,
+ spreadsheet_key=self.spreadsheet_key))
+ return matching_tables
+
+ def Delete(self):
+ """Deletes the entire database spreadsheet from Google Spreadsheets."""
+ entry = self.client._GetDocsClient().Get(
+ r'http://docs.google.com/feeds/documents/private/full/spreadsheet%3A' +
+ self.spreadsheet_key)
+ self.client._GetDocsClient().Delete(entry.GetEditLink().href)
+
+
+class Table(object):
+
+ def __init__(self, name=None, worksheet_entry=None, database_client=None,
+ spreadsheet_key=None, fields=None):
+ self.name = name
+ self.entry = worksheet_entry
+ id_parts = worksheet_entry.id.text.split('/')
+ self.worksheet_id = id_parts[-1]
+ self.spreadsheet_key = spreadsheet_key
+ self.client = database_client
+ self.fields = fields or []
+ if fields:
+ self.SetFields(fields)
+
+ def LookupFields(self):
+ """Queries to find the column names in the first row of the worksheet.
+
+ Useful when you have retrieved the table from the server and you don't
+ know the column names.
+ """
+ if self.entry:
+ first_row_contents = []
+ query = gdata.spreadsheet.service.CellQuery()
+ query.max_row = '1'
+ query.min_row = '1'
+ feed = self.client._GetSpreadsheetsClient().GetCellsFeed(
+ self.spreadsheet_key, wksht_id=self.worksheet_id, query=query)
+ for entry in feed.entry:
+ first_row_contents.append(entry.content.text)
+ # Get the next set of cells if needed.
+ next_link = feed.GetNextLink()
+ while next_link:
+ feed = self.client._GetSpreadsheetsClient().Get(next_link.href,
+ converter=gdata.spreadsheet.SpreadsheetsCellsFeedFromString)
+ for entry in feed.entry:
+ first_row_contents.append(entry.content.text)
+ next_link = feed.GetNextLink()
+ # Convert the contents of the cells to valid headers.
+ self.fields = ConvertStringsToColumnHeaders(first_row_contents)
+
+ def SetFields(self, fields):
+ """Changes the contents of the cells in the first row of this worksheet.
+
+ Args:
+ fields: list of strings The names in the list comprise the
+ first row of the worksheet. These names are converted into XML
+ tags by the server. To avoid changes during the translation
+ process I recommend using all lowercase alphabetic names. For
+ example ['somelongname', 'theothername']
+ """
+ # TODO: If the table already had fields, we might want to clear out the,
+ # current column headers.
+ self.fields = fields
+ i = 0
+ for column_name in fields:
+ i = i + 1
+ # TODO: speed this up by using a batch request to update cells.
+ self.client._GetSpreadsheetsClient().UpdateCell(1, i, column_name,
+ self.spreadsheet_key, self.worksheet_id)
+
+ def Delete(self):
+ """Deletes this worksheet from the spreadsheet."""
+ worksheet = self.client._GetSpreadsheetsClient().GetWorksheetsFeed(
+ self.spreadsheet_key, wksht_id=self.worksheet_id)
+ self.client._GetSpreadsheetsClient().DeleteWorksheet(
+ worksheet_entry=worksheet)
+
+ def AddRecord(self, data):
+ """Adds a new row to this worksheet.
+
+ Args:
+ data: dict of strings Mapping of string values to column names.
+
+ Returns:
+ Record which represents this row of the spreadsheet.
+ """
+ new_row = self.client._GetSpreadsheetsClient().InsertRow(data,
+ self.spreadsheet_key, wksht_id=self.worksheet_id)
+ return Record(content=data, row_entry=new_row,
+ spreadsheet_key=self.spreadsheet_key, worksheet_id=self.worksheet_id,
+ database_client=self.client)
+
+ def GetRecord(self, row_id=None, row_number=None):
+ """Gets a single record from the worksheet based on row ID or number.
+
+ Args:
+ row_id: The ID for the individual row.
+ row_number: str or int The position of the desired row. Numbering
+ begins at 1, which refers to the second row in the worksheet since
+ the first row is used for column names.
+
+ Returns:
+ Record for the desired row.
+ """
+ if row_id:
+ row_entry = self.client._GetSpreadsheetsClient().GetListFeed(
+ self.spreadsheet_key, wksht_id=self.worksheet_id, row_id=row_id)
+ return Record(content=None, row_entry=row_entry,
+ spreadsheet_key=self.spreadsheet_key,
+ worksheet_id=self.worksheet_id, database_client=self.client)
+ else:
+ row_query = gdata.spreadsheet.service.ListQuery()
+ row_query.start_index = str(row_number)
+ row_query.max_results = '1'
+ row_feed = self.client._GetSpreadsheetsClient().GetListFeed(
+ self.spreadsheet_key, wksht_id=self.worksheet_id, query=row_query)
+ if len(row_feed.entry) >= 1:
+ return Record(content=None, row_entry=row_feed.entry[0],
+ spreadsheet_key=self.spreadsheet_key,
+ worksheet_id=self.worksheet_id, database_client=self.client)
+ else:
+ return None
+
+ def GetRecords(self, start_row, end_row):
+ """Gets all rows between the start and end row numbers inclusive.
+
+ Args:
+ start_row: str or int
+ end_row: str or int
+
+ Returns:
+ RecordResultSet for the desired rows.
+ """
+ start_row = int(start_row)
+ end_row = int(end_row)
+ max_rows = end_row - start_row + 1
+ row_query = gdata.spreadsheet.service.ListQuery()
+ row_query.start_index = str(start_row)
+ row_query.max_results = str(max_rows)
+ rows_feed = self.client._GetSpreadsheetsClient().GetListFeed(
+ self.spreadsheet_key, wksht_id=self.worksheet_id, query=row_query)
+ return RecordResultSet(rows_feed, self.client, self.spreadsheet_key,
+ self.worksheet_id)
+
+ def FindRecords(self, query_string):
+ """Performs a query against the worksheet to find rows which match.
+
+ For details on query string syntax see the section on sq under
+ http://code.google.com/apis/spreadsheets/reference.html#list_Parameters
+
+ Args:
+ query_string: str Examples: 'name == john' to find all rows with john
+ in the name column, '(cost < 19.50 and name != toy) or cost > 500'
+
+ Returns:
+ RecordResultSet with the first group of matches.
+ """
+ row_query = gdata.spreadsheet.service.ListQuery()
+ row_query.sq = query_string
+ matching_feed = self.client._GetSpreadsheetsClient().GetListFeed(
+ self.spreadsheet_key, wksht_id=self.worksheet_id, query=row_query)
+ return RecordResultSet(matching_feed, self.client,
+ self.spreadsheet_key, self.worksheet_id)
+
+
+class RecordResultSet(list):
+ """A collection of rows which allows fetching of the next set of results.
+
+ The server may not send all rows in the requested range because there are
+ too many. Using this result set you can access the first set of results
+ as if it is a list, then get the next batch (if there are more results) by
+ calling GetNext().
+ """
+
+ def __init__(self, feed, client, spreadsheet_key, worksheet_id):
+ self.client = client
+ self.spreadsheet_key = spreadsheet_key
+ self.worksheet_id = worksheet_id
+ self.feed = feed
+ list(self)
+ for entry in self.feed.entry:
+ self.append(Record(content=None, row_entry=entry,
+ spreadsheet_key=spreadsheet_key, worksheet_id=worksheet_id,
+ database_client=client))
+
+ def GetNext(self):
+ """Fetches the next batch of rows in the result set.
+
+ Returns:
+ A new RecordResultSet.
+ """
+ next_link = self.feed.GetNextLink()
+ if next_link and next_link.href:
+ new_feed = self.client._GetSpreadsheetsClient().Get(next_link.href,
+ converter=gdata.spreadsheet.SpreadsheetsListFeedFromString)
+ return RecordResultSet(new_feed, self.client, self.spreadsheet_key,
+ self.worksheet_id)
+
+
+class Record(object):
+ """Represents one row in a worksheet and provides a dictionary of values.
+
+ Attributes:
+ custom: dict Represents the contents of the row with cell values mapped
+ to column headers.
+ """
+
+ def __init__(self, content=None, row_entry=None, spreadsheet_key=None,
+ worksheet_id=None, database_client=None):
+ """Constructor for a record.
+
+ Args:
+ content: dict of strings Mapping of string values to column names.
+ row_entry: gdata.spreadsheet.SpreadsheetsList The Atom entry
+ representing this row in the worksheet.
+ spreadsheet_key: str The ID of the spreadsheet in which this row
+ belongs.
+ worksheet_id: str The ID of the worksheet in which this row belongs.
+ database_client: DatabaseClient The client which can be used to talk
+ the Google Spreadsheets server to edit this row.
+ """
+ self.entry = row_entry
+ self.spreadsheet_key = spreadsheet_key
+ self.worksheet_id = worksheet_id
+ if row_entry:
+ self.row_id = row_entry.id.text.split('/')[-1]
+ else:
+ self.row_id = None
+ self.client = database_client
+ self.content = content or {}
+ if not content:
+ self.ExtractContentFromEntry(row_entry)
+
+ def ExtractContentFromEntry(self, entry):
+ """Populates the content and row_id based on content of the entry.
+
+ This method is used in the Record's contructor.
+
+ Args:
+ entry: gdata.spreadsheet.SpreadsheetsList The Atom entry
+ representing this row in the worksheet.
+ """
+ self.content = {}
+ if entry:
+ self.row_id = entry.id.text.split('/')[-1]
+ for label, custom in entry.custom.iteritems():
+ self.content[label] = custom.text
+
+ def Push(self):
+ """Send the content of the record to spreadsheets to edit the row.
+
+ All items in the content dictionary will be sent. Items which have been
+ removed from the content may remain in the row. The content member
+ of the record will not be modified so additional fields in the row
+ might be absent from this local copy.
+ """
+ self.entry = self.client._GetSpreadsheetsClient().UpdateRow(self.entry, self.content)
+
+ def Pull(self):
+ """Query Google Spreadsheets to get the latest data from the server.
+
+ Fetches the entry for this row and repopulates the content dictionary
+ with the data found in the row.
+ """
+ if self.row_id:
+ self.entry = self.client._GetSpreadsheetsClient().GetListFeed(
+ self.spreadsheet_key, wksht_id=self.worksheet_id, row_id=self.row_id)
+ self.ExtractContentFromEntry(self.entry)
+
+ def Delete(self):
+ self.client._GetSpreadsheetsClient().DeleteRow(self.entry)
+
+
+def ConvertStringsToColumnHeaders(proposed_headers):
+ """Converts a list of strings to column names which spreadsheets accepts.
+
+ When setting values in a record, the keys which represent column names must
+ fit certain rules. They are all lower case, contain no spaces or special
+ characters. If two columns have the same name after being sanitized, the
+ columns further to the right have _2, _3 _4, etc. appended to them.
+
+ If there are column names which consist of all special characters, or if
+ the column header is blank, an obfuscated value will be used for a column
+ name. This method does not handle blank column names or column names with
+ only special characters.
+ """
+ headers = []
+ for input_string in proposed_headers:
+ # TODO: probably a more efficient way to do this. Perhaps regex.
+ sanitized = input_string.lower().replace('_', '').replace(
+ ':', '').replace(' ', '')
+ # When the same sanitized header appears multiple times in the first row
+ # of a spreadsheet, _n is appended to the name to make it unique.
+ header_count = headers.count(sanitized)
+ if header_count > 0:
+ headers.append('%s_%i' % (sanitized, header_count+1))
+ else:
+ headers.append(sanitized)
+ return headers
diff --git a/src/gdata/spreadsheets/__init__.py b/src/gdata/spreadsheets/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/src/gdata/spreadsheets/__init__.py
diff --git a/src/gdata/spreadsheets/client.py b/src/gdata/spreadsheets/client.py
new file mode 100644
index 0000000..872ec13
--- /dev/null
+++ b/src/gdata/spreadsheets/client.py
@@ -0,0 +1,592 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains a client to communicate with the Google Spreadsheets servers.
+
+For documentation on the Spreadsheets API, see:
+http://code.google.com/apis/spreadsheets/
+"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import gdata.client
+import gdata.gauth
+import gdata.spreadsheets.data
+import atom.data
+import atom.http_core
+
+
+SPREADSHEETS_URL = ('https://spreadsheets.google.com/feeds/spreadsheets'
+ '/private/full')
+WORKSHEETS_URL = ('https://spreadsheets.google.com/feeds/worksheets/'
+ '%s/private/full')
+WORKSHEET_URL = ('https://spreadsheets.google.com/feeds/worksheets/'
+ '%s/private/full/%s')
+TABLES_URL = 'https://spreadsheets.google.com/feeds/%s/tables'
+RECORDS_URL = 'https://spreadsheets.google.com/feeds/%s/records/%s'
+RECORD_URL = 'https://spreadsheets.google.com/feeds/%s/records/%s/%s'
+CELLS_URL = 'https://spreadsheets.google.com/feeds/cells/%s/%s/private/full'
+CELL_URL = ('https://spreadsheets.google.com/feeds/cells/%s/%s/private/full/'
+ 'R%sC%s')
+LISTS_URL = 'https://spreadsheets.google.com/feeds/list/%s/%s/private/full'
+
+
+class SpreadsheetsClient(gdata.client.GDClient):
+ api_version = '3'
+ auth_service = 'wise'
+ auth_scopes = gdata.gauth.AUTH_SCOPES['wise']
+ ssl = True
+
+ def get_spreadsheets(self, auth_token=None,
+ desired_class=gdata.spreadsheets.data.SpreadsheetsFeed,
+ **kwargs):
+ """Obtains a feed with the spreadsheets belonging to the current user.
+
+ Args:
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (converter=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.spreadsheets.data.SpreadsheetsFeed.
+ """
+ return self.get_feed(SPREADSHEETS_URL, auth_token=auth_token,
+ desired_class=desired_class, **kwargs)
+
+ GetSpreadsheets = get_spreadsheets
+
+ def get_worksheets(self, spreadsheet_key, auth_token=None,
+ desired_class=gdata.spreadsheets.data.WorksheetsFeed,
+ **kwargs):
+ """Finds the worksheets within a given spreadsheet.
+
+ Args:
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (converter=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.spreadsheets.data.WorksheetsFeed.
+ """
+ return self.get_feed(WORKSHEETS_URL % spreadsheet_key,
+ auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetWorksheets = get_worksheets
+
+ def add_worksheet(self, spreadsheet_key, title, rows, cols,
+ auth_token=None, **kwargs):
+ """Creates a new worksheet entry in the spreadsheet.
+
+ Args:
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ title: str, The title to be used in for the worksheet.
+ rows: str or int, The number of rows this worksheet should start with.
+ cols: str or int, The number of columns this worksheet should start with.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ new_worksheet = gdata.spreadsheets.data.WorksheetEntry(
+ title=atom.data.Title(text=title),
+ row_count=gdata.spreadsheets.data.RowCount(text=str(rows)),
+ col_count=gdata.spreadsheets.data.ColCount(text=str(cols)))
+ return self.post(new_worksheet, WORKSHEETS_URL % spreadsheet_key,
+ auth_token=auth_token, **kwargs)
+
+ AddWorksheet = add_worksheet
+
+ def get_worksheet(self, spreadsheet_key, worksheet_id,
+ desired_class=gdata.spreadsheets.data.WorksheetEntry,
+ auth_token=None, **kwargs):
+ """Retrieves a single worksheet.
+
+ Args:
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ worksheet_id: str, The unique ID for the worksheet withing the desired
+ spreadsheet.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (converter=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.spreadsheets.data.WorksheetEntry.
+
+ """
+ return self.get_entry(WORKSHEET_URL % (spreadsheet_key, worksheet_id,),
+ auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetWorksheet = get_worksheet
+
+ def add_table(self, spreadsheet_key, title, summary, worksheet_name,
+ header_row, num_rows, start_row, insertion_mode,
+ column_headers, auth_token=None, **kwargs):
+ """Creates a new table within the worksheet.
+
+ Args:
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ title: str, The title for the new table within a worksheet.
+ summary: str, A description of the table.
+ worksheet_name: str The name of the worksheet in which this table
+ should live.
+ header_row: int or str, The number of the row in the worksheet which
+ will contain the column names for the data in this table.
+ num_rows: int or str, The number of adjacent rows in this table.
+ start_row: int or str, The number of the row at which the data begins.
+ insertion_mode: str
+ column_headers: dict of strings, maps the column letters (A, B, C) to
+ the desired name which will be viewable in the
+ worksheet.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ data = gdata.spreadsheets.data.Data(
+ insertion_mode=insertion_mode, num_rows=str(num_rows),
+ start_row=str(start_row))
+ for index, name in column_headers.iteritems():
+ data.column.append(gdata.spreadsheets.data.Column(
+ index=index, name=name))
+ new_table = gdata.spreadsheets.data.Table(
+ title=atom.data.Title(text=title), summary=atom.data.Summary(summary),
+ worksheet=gdata.spreadsheets.data.Worksheet(name=worksheet_name),
+ header=gdata.spreadsheets.data.Header(row=str(header_row)), data=data)
+ return self.post(new_table, TABLES_URL % spreadsheet_key,
+ auth_token=auth_token, **kwargs)
+
+ AddTable = add_table
+
+ def get_tables(self, spreadsheet_key,
+ desired_class=gdata.spreadsheets.data.TablesFeed,
+ auth_token=None, **kwargs):
+ """Retrieves a feed listing the tables in this spreadsheet.
+
+ Args:
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (converter=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.spreadsheets.data.TablesFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_feed(TABLES_URL % spreadsheet_key,
+ desired_class=desired_class, auth_token=auth_token,
+ **kwargs)
+
+ GetTables = get_tables
+
+ def add_record(self, spreadsheet_key, table_id, fields,
+ title=None, auth_token=None, **kwargs):
+ """Adds a new row to the table.
+
+ Args:
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ table_id: str, The ID of the table within the worksheet which should
+ receive this new record. The table ID can be found using the
+ get_table_id method of a gdata.spreadsheets.data.Table.
+ fields: dict of strings mapping column names to values.
+ title: str, optional The title for this row.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ new_record = gdata.spreadsheets.data.Record()
+ if title is not None:
+ new_record.title = atom.data.Title(text=title)
+ for name, value in fields.iteritems():
+ new_record.field.append(gdata.spreadsheets.data.Field(
+ name=name, text=value))
+ return self.post(new_record, RECORDS_URL % (spreadsheet_key, table_id),
+ auth_token=auth_token, **kwargs)
+
+ AddRecord = add_record
+
+ def get_records(self, spreadsheet_key, table_id,
+ desired_class=gdata.spreadsheets.data.RecordsFeed,
+ auth_token=None, **kwargs):
+ """Retrieves the records in a table.
+
+ Args:
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ table_id: str, The ID of the table within the worksheet whose records
+ we would like to fetch. The table ID can be found using the
+ get_table_id method of a gdata.spreadsheets.data.Table.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (converter=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.spreadsheets.data.RecordsFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_feed(RECORDS_URL % (spreadsheet_key, table_id),
+ desired_class=desired_class, auth_token=auth_token,
+ **kwargs)
+
+ GetRecords = get_records
+
+ def get_record(self, spreadsheet_key, table_id, record_id,
+ desired_class=gdata.spreadsheets.data.Record,
+ auth_token=None, **kwargs):
+ """Retrieves a single record from the table.
+
+ Args:
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ table_id: str, The ID of the table within the worksheet whose records
+ we would like to fetch. The table ID can be found using the
+ get_table_id method of a gdata.spreadsheets.data.Table.
+ record_id: str, The ID of the record within this table which we want to
+ fetch. You can find the record ID using get_record_id() on
+ an instance of the gdata.spreadsheets.data.Record class.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (converter=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.spreadsheets.data.RecordsFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_entry(RECORD_URL % (spreadsheet_key, table_id, record_id),
+ desired_class=desired_class, auth_token=auth_token,
+ **kwargs)
+
+ GetRecord = get_record
+
+ def get_cells(self, spreadsheet_key, worksheet_id,
+ desired_class=gdata.spreadsheets.data.CellsFeed,
+ auth_token=None, **kwargs):
+ """Retrieves the cells which have values in this spreadsheet.
+
+ Blank cells are not included.
+
+ Args:
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ worksheet_id: str, The unique ID of the worksheet in this spreadsheet
+ whose cells we want. This can be obtained using
+ WorksheetEntry's get_worksheet_id method.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (converter=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.spreadsheets.data.CellsFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_feed(CELLS_URL % (spreadsheet_key, worksheet_id),
+ auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetCells = get_cells
+
+ def get_cell(self, spreadsheet_key, worksheet_id, row_num, col_num,
+ desired_class=gdata.spreadsheets.data.CellEntry,
+ auth_token=None, **kwargs):
+ """Retrieves a single cell from the worksheet.
+
+ Indexes are 1 based so the first cell in the worksheet is 1, 1.
+
+ Args:
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ worksheet_id: str, The unique ID of the worksheet in this spreadsheet
+ whose cells we want. This can be obtained using
+ WorksheetEntry's get_worksheet_id method.
+ row_num: int, The row of the cell that we want. Numbering starts with 1.
+ col_num: int, The column of the cell we want. Numbering starts with 1.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (converter=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.spreadsheets.data.CellEntry.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_entry(
+ CELL_URL % (spreadsheet_key, worksheet_id, row_num, col_num),
+ auth_token=auth_token, desired_class=desired_class, **kwargs)
+
+ GetCell = get_cell
+
+ def get_list_feed(self, spreadsheet_key, worksheet_id,
+ desired_class=gdata.spreadsheets.data.ListsFeed,
+ auth_token=None, **kwargs):
+ """Retrieves the value rows from the worksheet's list feed.
+
+ The list feed is a view of the spreadsheet in which the first row is used
+ for column names and subsequent rows up to the first blank line are
+ records.
+
+ Args:
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ worksheet_id: str, The unique ID of the worksheet in this spreadsheet
+ whose cells we want. This can be obtained using
+ WorksheetEntry's get_worksheet_id method.
+ desired_class: class descended from atom.core.XmlElement to which a
+ successful response should be converted. If there is no
+ converter function specified (converter=None) then the
+ desired_class will be used in calling the
+ atom.core.parse function. If neither
+ the desired_class nor the converter is specified, an
+ HTTP reponse object will be returned. Defaults to
+ gdata.spreadsheets.data.ListsFeed.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.get_feed(LISTS_URL % (spreadsheet_key, worksheet_id),
+ auth_token=auth_token, desired_class=desired_class,
+ **kwargs)
+
+ GetListFeed = get_list_feed
+
+ def add_list_entry(self, list_entry, spreadsheet_key, worksheet_id,
+ auth_token=None, **kwargs):
+ """Adds a new row to the worksheet's list feed.
+
+ Args:
+ list_entry: gdata.spreadsheets.data.ListsEntry An entry which contains
+ the values which should be set for the columns in this
+ record.
+ spreadsheet_key: str, The unique ID of this containing spreadsheet. This
+ can be the ID from the URL or as provided in a
+ Spreadsheet entry.
+ worksheet_id: str, The unique ID of the worksheet in this spreadsheet
+ whose cells we want. This can be obtained using
+ WorksheetEntry's get_worksheet_id method.
+ auth_token: An object which sets the Authorization HTTP header in its
+ modify_request method. Recommended classes include
+ gdata.gauth.ClientLoginToken and gdata.gauth.AuthSubToken
+ among others. Represents the current user. Defaults to None
+ and if None, this method will look for a value in the
+ auth_token member of SpreadsheetsClient.
+ """
+ return self.post(list_entry, LISTS_URL % (spreadsheet_key, worksheet_id),
+ auth_token=auth_token, **kwargs)
+
+ AddListEntry = add_list_entry
+
+
+class SpreadsheetQuery(gdata.client.Query):
+
+ def __init__(self, title=None, title_exact=None, **kwargs):
+ """Adds Spreadsheets feed query parameters to a request.
+
+ Args:
+ title: str Specifies the search terms for the title of a document.
+ This parameter used without title-exact will only submit partial
+ queries, not exact queries.
+ title_exact: str Specifies whether the title query should be taken as an
+ exact string. Meaningless without title. Possible values are
+ 'true' and 'false'.
+ """
+ gdata.client.Query.__init__(self, **kwargs)
+ self.title = title
+ self.title_exact = title_exact
+
+ def modify_request(self, http_request):
+ gdata.client._add_query_param('title', self.title, http_request)
+ gdata.client._add_query_param('title-exact', self.title_exact,
+ http_request)
+ gdata.client.Query.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
+
+
+class WorksheetQuery(SpreadsheetQuery):
+ pass
+
+
+class ListQuery(gdata.client.Query):
+
+ def __init__(self, order_by=None, reverse=None, sq=None, **kwargs):
+ """Adds List-feed specific query parameters to a request.
+
+ Args:
+ order_by: str Specifies what column to use in ordering the entries in
+ the feed. By position (the default): 'position' returns
+ rows in the order in which they appear in the GUI. Row 1, then
+ row 2, then row 3, and so on. By column:
+ 'column:columnName' sorts rows in ascending order based on the
+ values in the column with the given columnName, where
+ columnName is the value in the header row for that column.
+ reverse: str Specifies whether to sort in descending or ascending order.
+ Reverses default sort order: 'true' results in a descending
+ sort; 'false' (the default) results in an ascending sort.
+ sq: str Structured query on the full text in the worksheet.
+ [columnName][binaryOperator][value]
+ Supported binaryOperators are:
+ - (), for overriding order of operations
+ - = or ==, for strict equality
+ - <> or !=, for strict inequality
+ - and or &&, for boolean and
+ - or or ||, for boolean or
+ """
+ gdata.client.Query.__init__(self, **kwargs)
+ self.order_by = order_by
+ self.reverse = reverse
+ self.sq = sq
+
+ def modify_request(self, http_request):
+ gdata.client._add_query_param('orderby', self.order_by, http_request)
+ gdata.client._add_query_param('reverse', self.reverse, http_request)
+ gdata.client._add_query_param('sq', self.sq, http_request)
+ gdata.client.Query.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
+
+
+class TableQuery(ListQuery):
+ pass
+
+
+class CellQuery(gdata.client.Query):
+
+ def __init__(self, min_row=None, max_row=None, min_col=None, max_col=None,
+ range=None, return_empty=None, **kwargs):
+ """Adds Cells-feed specific query parameters to a request.
+
+ Args:
+ min_row: str or int Positional number of minimum row returned in query.
+ max_row: str or int Positional number of maximum row returned in query.
+ min_col: str or int Positional number of minimum column returned in query.
+ max_col: str or int Positional number of maximum column returned in query.
+ range: str A single cell or a range of cells. Use standard spreadsheet
+ cell-range notations, using a colon to separate start and end of
+ range. Examples:
+ - 'A1' and 'R1C1' both specify only cell A1.
+ - 'D1:F3' and 'R1C4:R3C6' both specify the rectangle of cells with
+ corners at D1 and F3.
+ return_empty: str If 'true' then empty cells will be returned in the feed.
+ If omitted, the default is 'false'.
+ """
+ gdata.client.Query.__init__(self, **kwargs)
+ self.min_row = min_row
+ self.max_row = max_row
+ self.min_col = min_col
+ self.max_col = max_col
+ self.range = range
+ self.return_empty = return_empty
+
+ def modify_request(self, http_request):
+ gdata.client._add_query_param('min-row', self.min_row, http_request)
+ gdata.client._add_query_param('max-row', self.max_row, http_request)
+ gdata.client._add_query_param('min-col', self.min_col, http_request)
+ gdata.client._add_query_param('max-col', self.max_col, http_request)
+ gdata.client._add_query_param('range', self.range, http_request)
+ gdata.client._add_query_param('return-empty', self.return_empty,
+ http_request)
+ gdata.client.Query.modify_request(self, http_request)
+
+ ModifyRequest = modify_request
diff --git a/src/gdata/spreadsheets/data.py b/src/gdata/spreadsheets/data.py
new file mode 100644
index 0000000..35e776a
--- /dev/null
+++ b/src/gdata/spreadsheets/data.py
@@ -0,0 +1,383 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+"""Provides classes and constants for the XML in the Google Spreadsheets API.
+
+Documentation for the raw XML which these classes represent can be found here:
+http://code.google.com/apis/spreadsheets/docs/3.0/reference.html#Elements
+"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+import gdata.data
+
+
+GS_TEMPLATE = '{http://schemas.google.com/spreadsheets/2006}%s'
+GSX_NAMESPACE = 'http://schemas.google.com/spreadsheets/2006/extended'
+
+
+INSERT_MODE = 'insert'
+OVERWRITE_MODE = 'overwrite'
+
+
+WORKSHEETS_REL = 'http://schemas.google.com/spreadsheets/2006#worksheetsfeed'
+
+BATCH_POST_ID_TEMPLATE = ('https://spreadsheets.google.com/feeds/cells'
+ '/%s/%s/private/full')
+BATCH_ENTRY_ID_TEMPLATE = '%s/R%sC%s'
+BATCH_EDIT_LINK_TEMPLATE = '%s/batch'
+
+
+class Error(Exception):
+ pass
+
+
+class FieldMissing(Exception):
+ pass
+
+
+class HeaderNotSet(Error):
+ """The desired column header had no value for the row in the list feed."""
+
+
+class Cell(atom.core.XmlElement):
+ """The gs:cell element.
+
+ A cell in the worksheet. The <gs:cell> element can appear only as a child
+ of <atom:entry>.
+ """
+ _qname = GS_TEMPLATE % 'cell'
+ col = 'col'
+ input_value = 'inputValue'
+ numeric_value = 'numericValue'
+ row = 'row'
+
+
+class ColCount(atom.core.XmlElement):
+ """The gs:colCount element.
+
+ Indicates the number of columns in the worksheet, including columns that
+ contain only empty cells. The <gs:colCount> element can appear as a child
+ of <atom:entry> or <atom:feed>
+ """
+ _qname = GS_TEMPLATE % 'colCount'
+
+
+class Field(atom.core.XmlElement):
+ """The gs:field element.
+
+ A field single cell within a record. Contained in an <atom:entry>.
+ """
+ _qname = GS_TEMPLATE % 'field'
+ index = 'index'
+ name = 'name'
+
+
+class Column(Field):
+ """The gs:column element."""
+ _qname = GS_TEMPLATE % 'column'
+
+
+class Data(atom.core.XmlElement):
+ """The gs:data element.
+
+ A data region of a table. Contained in an <atom:entry> element.
+ """
+ _qname = GS_TEMPLATE % 'data'
+ column = [Column]
+ insertion_mode = 'insertionMode'
+ num_rows = 'numRows'
+ start_row = 'startRow'
+
+
+class Header(atom.core.XmlElement):
+ """The gs:header element.
+
+ Indicates which row is the header row. Contained in an <atom:entry>.
+ """
+ _qname = GS_TEMPLATE % 'header'
+ row = 'row'
+
+
+class RowCount(atom.core.XmlElement):
+ """The gs:rowCount element.
+
+ Indicates the number of total rows in the worksheet, including rows that
+ contain only empty cells. The <gs:rowCount> element can appear as a
+ child of <atom:entry> or <atom:feed>.
+ """
+ _qname = GS_TEMPLATE % 'rowCount'
+
+
+class Worksheet(atom.core.XmlElement):
+ """The gs:worksheet element.
+
+ The worksheet where the table lives.Contained in an <atom:entry>.
+ """
+ _qname = GS_TEMPLATE % 'worksheet'
+ name = 'name'
+
+
+class Spreadsheet(gdata.data.GDEntry):
+ """An Atom entry which represents a Google Spreadsheet."""
+
+ def find_worksheets_feed(self):
+ return self.find_url(WORKSHEETS_REL)
+
+ FindWorksheetsFeed = find_worksheets_feed
+
+ def get_spreadsheet_key(self):
+ """Extracts the spreadsheet key unique to this spreadsheet."""
+ return self.get_id().split('/')[-1]
+
+ GetSpreadsheetKey = get_spreadsheet_key
+
+
+class SpreadsheetsFeed(gdata.data.GDFeed):
+ """An Atom feed listing a user's Google Spreadsheets."""
+ entry = [Spreadsheet]
+
+
+class WorksheetEntry(gdata.data.GDEntry):
+ """An Atom entry representing a single worksheet in a spreadsheet."""
+ row_count = RowCount
+ col_count = ColCount
+
+ def get_worksheet_id(self):
+ """The worksheet ID identifies this worksheet in its spreadsheet."""
+ return self.get_id().split('/')[-1]
+
+ GetWorksheetId = get_worksheet_id
+
+
+class WorksheetsFeed(gdata.data.GDFeed):
+ """A feed containing the worksheets in a single spreadsheet."""
+ entry = [WorksheetEntry]
+
+
+class Table(gdata.data.GDEntry):
+ """An Atom entry that represents a subsection of a worksheet.
+
+ A table allows you to treat part or all of a worksheet somewhat like a
+ table in a database that is, as a set of structured data items. Tables
+ don't exist until you explicitly create them before you can use a table
+ feed, you have to explicitly define where the table data comes from.
+ """
+ data = Data
+ header = Header
+ worksheet = Worksheet
+
+ def get_table_id(self):
+ if self.id.text:
+ return self.id.text.split('/')[-1]
+ return None
+
+ GetTableId = get_table_id
+
+
+class TablesFeed(gdata.data.GDFeed):
+ """An Atom feed containing the tables defined within a worksheet."""
+ entry = [Table]
+
+
+class Record(gdata.data.GDEntry):
+ """An Atom entry representing a single record in a table.
+
+ Note that the order of items in each record is the same as the order of
+ columns in the table definition, which may not match the order of
+ columns in the GUI.
+ """
+ field = [Field]
+
+ def value_for_index(self, column_index):
+ for field in self.field:
+ if field.index == column_index:
+ return field.text
+ raise FieldMissing('There is no field for %s' % column_index)
+
+ ValueForIndex = value_for_index
+
+ def value_for_name(self, name):
+ for field in self.field:
+ if field.name == name:
+ return field.text
+ raise FieldMissing('There is no field for %s' % name)
+
+ ValueForName = value_for_name
+
+ def get_record_id(self):
+ if self.id.text:
+ return self.id.text.split('/')[-1]
+ return None
+
+
+class RecordsFeed(gdata.data.GDFeed):
+ """An Atom feed containing the individuals records in a table."""
+ entry = [Record]
+
+
+class ListRow(atom.core.XmlElement):
+ """A gsx column value within a row.
+
+ The local tag in the _qname is blank and must be set to the column
+ name. For example, when adding to a ListEntry, do:
+ col_value = ListRow(text='something')
+ col_value._qname = col_value._qname % 'mycolumnname'
+ """
+ _qname = '{http://schemas.google.com/spreadsheets/2006/extended}%s'
+
+
+class ListEntry(gdata.data.GDEntry):
+ """An Atom entry representing a worksheet row in the list feed.
+
+ The values for a particular column can be get and set using
+ x.get_value('columnheader') and x.set_value('columnheader', 'value').
+ See also the explanation of column names in the ListFeed class.
+ """
+
+ def get_value(self, column_name):
+ """Returns the displayed text for the desired column in this row.
+
+ The formula or input which generated the displayed value is not accessible
+ through the list feed, to see the user's input, use the cells feed.
+
+ If a column is not present in this spreadsheet, or there is no value
+ for a column in this row, this method will return None.
+ """
+ values = self.get_elements(column_name, GSX_NAMESPACE)
+ if len(values) == 0:
+ return None
+ return values[0].text
+
+ def set_value(self, column_name, value):
+ """Changes the value of cell in this row under the desired column name.
+
+ Warning: if the cell contained a formula, it will be wiped out by setting
+ the value using the list feed since the list feed only works with
+ displayed values.
+
+ No client side checking is performed on the column_name, you need to
+ ensure that the column_name is the local tag name in the gsx tag for the
+ column. For example, the column_name will not contain special characters,
+ spaces, uppercase letters, etc.
+ """
+ # Try to find the column in this row to change an existing value.
+ values = self.get_elements(column_name, GSX_NAMESPACE)
+ if len(values) > 0:
+ values[0].text = value
+ else:
+ # There is no value in this row for the desired column, so add a new
+ # gsx:column_name element.
+ new_value = ListRow(text=value)
+ new_value._qname = new_value._qname % (column_name,)
+ self._other_elements.append(new_value)
+
+ def to_dict(self):
+ """Converts this row to a mapping of column names to their values."""
+ result = {}
+ values = self.get_elements(namespace=GSX_NAMESPACE)
+ for item in values:
+ result[item._get_tag()] = item.text
+ return result
+
+ def from_dict(self, values):
+ """Sets values for this row from the dictionary.
+
+ Old values which are already in the entry will not be removed unless
+ they are overwritten with new values from the dict.
+ """
+ for column, value in values.iteritems():
+ self.set_value(column, value)
+
+
+class ListsFeed(gdata.data.GDFeed):
+ """An Atom feed in which each entry represents a row in a worksheet.
+
+ The first row in the worksheet is used as the column names for the values
+ in each row. If a header cell is empty, then a unique column ID is used
+ for the gsx element name.
+
+ Spaces in a column name are removed from the name of the corresponding
+ gsx element.
+
+ Caution: The columnNames are case-insensitive. For example, if you see
+ a <gsx:e-mail> element in a feed, you can't know whether the column
+ heading in the original worksheet was "e-mail" or "E-Mail".
+
+ Note: If two or more columns have the same name, then subsequent columns
+ of the same name have _n appended to the columnName. For example, if the
+ first column name is "e-mail", followed by columns named "E-Mail" and
+ "E-mail", then the columnNames will be gsx:e-mail, gsx:e-mail_2, and
+ gsx:e-mail_3 respectively.
+ """
+ entry = [ListEntry]
+
+
+class CellEntry(gdata.data.BatchEntry):
+ """An Atom entry representing a single cell in a worksheet."""
+ cell = Cell
+
+
+class CellsFeed(gdata.data.BatchFeed):
+ """An Atom feed contains one entry per cell in a worksheet.
+
+ The cell feed supports batch operations, you can send multiple cell
+ operations in one HTTP request.
+ """
+ entry = [CellEntry]
+
+ def add_set_cell(self, row, col, input_value):
+ """Adds a request to change the contents of a cell to this batch request.
+
+ Args:
+ row: int, The row number for this cell. Numbering starts at 1.
+ col: int, The column number for this cell. Starts at 1.
+ input_value: str, The desired formula/content this cell should contain.
+ """
+ self.add_update(CellEntry(
+ id=atom.data.Id(text=BATCH_ENTRY_ID_TEMPLATE % (
+ self.id.text, row, col)),
+ cell=Cell(col=str(col), row=str(row), input_value=input_value)))
+ return self
+
+ AddSetCell = add_set_cell
+
+
+def build_batch_cells_update(spreadsheet_key, worksheet_id):
+ """Creates an empty cells feed for adding batch cell updates to.
+
+ Call batch_set_cell on the resulting CellsFeed instance then send the batch
+ request TODO: fill in
+
+ Args:
+ spreadsheet_key: The ID of the spreadsheet
+ worksheet_id:
+ """
+ feed_id_text = BATCH_POST_ID_TEMPLATE % (spreadsheet_key, worksheet_id)
+ return CellsFeed(
+ id=atom.data.Id(text=feed_id_text),
+ link=[atom.data.Link(
+ rel='edit', href=BATCH_EDIT_LINK_TEMPLATE % (feed_id_text,))])
+
+
+BuildBatchCellsUpdate = build_batch_cells_update
diff --git a/src/gdata/test_config.py b/src/gdata/test_config.py
new file mode 100644
index 0000000..16e04e5
--- /dev/null
+++ b/src/gdata/test_config.py
@@ -0,0 +1,441 @@
+#!/usr/bin/env python
+
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import sys
+import unittest
+import getpass
+import inspect
+import atom.mock_http_core
+import gdata.gauth
+
+
+"""Loads configuration for tests which connect to Google servers.
+
+Settings used in tests are stored in a ConfigCollection instance in this
+module called options. If your test needs to get a test related setting,
+use
+
+import gdata.test_config
+option_value = gdata.test_config.options.get_value('x')
+
+The above will check the command line for an '--x' argument, and if not
+found will either use the default value for 'x' or prompt the user to enter
+one.
+
+Your test can override the value specified by the user by performing:
+
+gdata.test_config.options.set_value('x', 'y')
+
+If your test uses a new option which you would like to allow the user to
+specify on the command line or via a prompt, you can use the register_option
+method as follows:
+
+gdata.test_config.options.register(
+ 'option_name', 'Prompt shown to the user', secret=False #As for password.
+ 'This is the description of the option, shown when help is requested.',
+ 'default value, provide only if you do not want the user to be prompted')
+"""
+
+
+class Option(object):
+
+ def __init__(self, name, prompt, secret=False, description=None, default=None):
+ self.name = name
+ self.prompt = prompt
+ self.secret = secret
+ self.description = description
+ self.default = default
+
+ def get(self):
+ value = self.default
+ # Check for a command line parameter.
+ for i in xrange(len(sys.argv)):
+ if sys.argv[i].startswith('--%s=' % self.name):
+ value = sys.argv[i].split('=')[1]
+ elif sys.argv[i] == '--%s' % self.name:
+ value = sys.argv[i + 1]
+ # If the param was not on the command line, ask the user to input the
+ # value.
+ # In order for this to prompt the user, the default value for the option
+ # must be None.
+ if value is None:
+ prompt = '%s: ' % self.prompt
+ if self.secret:
+ value = getpass.getpass(prompt)
+ else:
+ print 'You can specify this on the command line using --%s' % self.name
+ value = raw_input(prompt)
+ return value
+
+
+class ConfigCollection(object):
+
+ def __init__(self, options=None):
+ self.options = options or {}
+ self.values = {}
+
+ def register_option(self, option):
+ self.options[option.name] = option
+
+ def register(self, *args, **kwargs):
+ self.register_option(Option(*args, **kwargs))
+
+ def get_value(self, option_name):
+ if option_name in self.values:
+ return self.values[option_name]
+ value = self.options[option_name].get()
+ if value is not None:
+ self.values[option_name] = value
+ return value
+
+ def set_value(self, option_name, value):
+ self.values[option_name] = value
+
+ def render_usage(self):
+ message_parts = []
+ for opt_name, option in self.options.iteritems():
+ message_parts.append('--%s: %s' % (opt_name, option.description))
+ return '\n'.join(message_parts)
+
+
+options = ConfigCollection()
+
+
+# Register the default options.
+options.register(
+ 'username',
+ 'Please enter the email address of your test account',
+ description=('The email address you want to sign in with. '
+ 'Make sure this is a test account as these tests may edit'
+ ' or delete data.'))
+options.register(
+ 'password',
+ 'Please enter the password for your test account',
+ secret=True, description='The test account password.')
+options.register(
+ 'clearcache',
+ 'Delete cached data? (enter true or false)',
+ description=('If set to true, any temporary files which cache test'
+ ' requests and responses will be deleted.'),
+ default='true')
+options.register(
+ 'savecache',
+ 'Save requests and responses in a temporary file? (enter true or false)',
+ description=('If set to true, requests to the server and responses will'
+ ' be saved in temporary files.'),
+ default='false')
+options.register(
+ 'runlive',
+ 'Run the live tests which contact the server? (enter true or false)',
+ description=('If set to true, the tests will make real HTTP requests to'
+ ' the servers. This slows down test execution and may'
+ ' modify the users data, be sure to use a test account.'),
+ default='true')
+options.register(
+ 'host',
+ 'Run the live tests against the given host',
+ description='Examples: docs.google.com, spreadsheets.google.com, etc.',
+ default='')
+options.register(
+ 'ssl',
+ 'Run the live tests over SSL (enter true or false)',
+ description='If set to true, all tests will be performed over HTTPS (SSL)',
+ default='false')
+options.register(
+ 'clean',
+ 'Clean ALL data first before and after each test (enter true or false)',
+ description='If set to true, all tests will remove all data (DANGEROUS)',
+ default='false')
+options.register(
+ 'appsusername',
+ 'Please enter the email address of your test Apps domain account',
+ description=('The email address you want to sign in with. '
+ 'Make sure this is a test account on your Apps domain as '
+ 'these tests may edit or delete data.'))
+options.register(
+ 'appspassword',
+ 'Please enter the password for your test Apps domain account',
+ secret=True, description='The test Apps account password.')
+
+# Other options which may be used if needed.
+BLOG_ID_OPTION = Option(
+ 'blogid',
+ 'Please enter the ID of your test blog',
+ description=('The blog ID for the blog which should have test posts added'
+ ' to it. Example 7682659670455539811'))
+TEST_IMAGE_LOCATION_OPTION = Option(
+ 'imgpath',
+ 'Please enter the full path to a test image to upload',
+ description=('This test image will be uploaded to a service which'
+ ' accepts a media file, it must be a jpeg.'))
+SPREADSHEET_ID_OPTION = Option(
+ 'spreadsheetid',
+ 'Please enter the ID of a spreadsheet to use in these tests',
+ description=('The spreadsheet ID for the spreadsheet which should be'
+ ' modified by theses tests.'))
+APPS_DOMAIN_OPTION = Option(
+ 'appsdomain',
+ 'Please enter your Google Apps domain',
+ description=('The domain the Google Apps is hosted on or leave blank'
+ ' if n/a'))
+SITES_NAME_OPTION = Option(
+ 'sitename',
+ 'Please enter name of your Google Site',
+ description='The webspace name of the Site found in its URL.')
+PROJECT_NAME_OPTION = Option(
+ 'project_name',
+ 'Please enter the name of your project hosting project',
+ description=('The name of the project which should have test issues added'
+ ' to it. Example gdata-python-client'))
+ISSUE_ASSIGNEE_OPTION = Option(
+ 'issue_assignee',
+ 'Enter the email address of the target owner of the updated issue.',
+ description=('The email address of the user a created issue\'s owner will '
+ ' become. Example testuser2@gmail.com'))
+GA_TABLE_ID = Option(
+ 'table_id',
+ 'Enter the Table ID of the Google Analytics profile to test',
+ description=('The Table ID of the Google Analytics profile to test.'
+ ' Example ga:1174'))
+TARGET_USERNAME_OPTION = Option(
+ 'targetusername',
+ 'Please enter the username (without domain) of the user which will be'
+ ' affected by the tests',
+ description=('The username of the user to be tested'))
+YT_DEVELOPER_KEY_OPTION = Option(
+ 'developerkey',
+ 'Please enter your YouTube developer key',
+ description=('The YouTube developer key for your account'))
+YT_CLIENT_ID_OPTION = Option(
+ 'clientid',
+ 'Please enter your YouTube client ID',
+ description=('The YouTube client ID for your account'))
+YT_VIDEO_ID_OPTION= Option(
+ 'videoid',
+ 'Please enter the ID of a YouTube video you uploaded',
+ description=('The video ID of a YouTube video uploaded to your account'))
+
+
+# Functions to inject a cachable HTTP client into a service client.
+def configure_client(client, case_name, service_name, use_apps_auth=False):
+ """Sets up a mock client which will reuse a saved session.
+
+ Should be called during setUp of each unit test.
+
+ Handles authentication to allow the GDClient to make requests which
+ require an auth header.
+
+ Args:
+ client: a gdata.GDClient whose http_client member should be replaced
+ with a atom.mock_http_core.MockHttpClient so that repeated
+ executions can used cached responses instead of contacting
+ the server.
+ case_name: str The name of the test case class. Examples: 'BloggerTest',
+ 'ContactsTest'. Used to save a session
+ for the ClientLogin auth token request, so the case_name
+ should be reused if and only if the same username, password,
+ and service are being used.
+ service_name: str The service name as used for ClientLogin to identify
+ the Google Data API being accessed. Example: 'blogger',
+ 'wise', etc.
+ use_apps_auth: bool (optional) If set to True, use appsusername and
+ appspassword command-line args instead of username and
+ password respectively.
+ """
+ # Use a mock HTTP client which will record and replay the HTTP traffic
+ # from these tests.
+ client.http_client = atom.mock_http_core.MockHttpClient()
+ client.http_client.cache_case_name = case_name
+ # Getting the auth token only needs to be done once in the course of test
+ # runs.
+ auth_token_key = '%s_auth_token' % service_name
+ if (auth_token_key not in options.values
+ and options.get_value('runlive') == 'true'):
+ client.http_client.cache_test_name = 'client_login'
+ cache_name = client.http_client.get_cache_file_name()
+ if options.get_value('clearcache') == 'true':
+ client.http_client.delete_session(cache_name)
+ client.http_client.use_cached_session(cache_name)
+ if not use_apps_auth:
+ username = options.get_value('username')
+ password = options.get_value('password')
+ else:
+ username = options.get_value('appsusername')
+ password = options.get_value('appspassword')
+ auth_token = client.client_login(username, password, case_name,
+ service=service_name)
+ options.values[auth_token_key] = gdata.gauth.token_to_blob(auth_token)
+ if client.alt_auth_service is not None:
+ options.values[client.alt_auth_service] = gdata.gauth.token_to_blob(
+ client.alt_auth_token)
+ client.http_client.close_session()
+ # Allow a config auth_token of False to prevent the client's auth header
+ # from being modified.
+ if auth_token_key in options.values:
+ client.auth_token = gdata.gauth.token_from_blob(
+ options.values[auth_token_key])
+ if client.alt_auth_service is not None:
+ client.alt_auth_token = gdata.gauth.token_from_blob(
+ options.values[client.alt_auth_service])
+ if options.get_value('host'):
+ client.host = options.get_value('host')
+
+
+def configure_cache(client, test_name):
+ """Loads or begins a cached session to record HTTP traffic.
+
+ Should be called at the beginning of each test method.
+
+ Args:
+ client: a gdata.GDClient whose http_client member has been replaced
+ with a atom.mock_http_core.MockHttpClient so that repeated
+ executions can used cached responses instead of contacting
+ the server.
+ test_name: str The name of this test method. Examples:
+ 'TestClass.test_x_works', 'TestClass.test_crud_operations'.
+ This is used to name the recording of the HTTP requests and
+ responses, so it should be unique to each test method in the
+ test case.
+ """
+ # Auth token is obtained in configure_client which is called as part of
+ # setUp.
+ client.http_client.cache_test_name = test_name
+ cache_name = client.http_client.get_cache_file_name()
+ if options.get_value('clearcache') == 'true':
+ client.http_client.delete_session(cache_name)
+ client.http_client.use_cached_session(cache_name)
+
+
+def close_client(client):
+ """Saves the recoded responses to a temp file if the config file allows.
+
+ This should be called in the unit test's tearDown method.
+
+ Checks to see if the 'savecache' option is set to 'true', to make sure we
+ only save sessions to repeat if the user desires.
+ """
+ if client and options.get_value('savecache') == 'true':
+ # If this was a live request, save the recording.
+ client.http_client.close_session()
+
+
+def configure_service(service, case_name, service_name):
+ """Sets up a mock GDataService v1 client to reuse recorded sessions.
+
+ Should be called during setUp of each unit test. This is a duplicate of
+ configure_client, modified to handle old v1 service classes.
+ """
+ service.http_client.v2_http_client = atom.mock_http_core.MockHttpClient()
+ service.http_client.v2_http_client.cache_case_name = case_name
+ # Getting the auth token only needs to be done once in the course of test
+ # runs.
+ auth_token_key = 'service_%s_auth_token' % service_name
+ if (auth_token_key not in options.values
+ and options.get_value('runlive') == 'true'):
+ service.http_client.v2_http_client.cache_test_name = 'client_login'
+ cache_name = service.http_client.v2_http_client.get_cache_file_name()
+ if options.get_value('clearcache') == 'true':
+ service.http_client.v2_http_client.delete_session(cache_name)
+ service.http_client.v2_http_client.use_cached_session(cache_name)
+ service.ClientLogin(options.get_value('username'),
+ options.get_value('password'),
+ service=service_name, source=case_name)
+ options.values[auth_token_key] = service.GetClientLoginToken()
+ service.http_client.v2_http_client.close_session()
+ if auth_token_key in options.values:
+ service.SetClientLoginToken(options.values[auth_token_key])
+
+
+def configure_service_cache(service, test_name):
+ """Loads or starts a session recording for a v1 Service object.
+
+ Duplicates the behavior of configure_cache, but the target for this
+ function is a v1 Service object instead of a v2 Client.
+ """
+ service.http_client.v2_http_client.cache_test_name = test_name
+ cache_name = service.http_client.v2_http_client.get_cache_file_name()
+ if options.get_value('clearcache') == 'true':
+ service.http_client.v2_http_client.delete_session(cache_name)
+ service.http_client.v2_http_client.use_cached_session(cache_name)
+
+
+def close_service(service):
+ if service and options.get_value('savecache') == 'true':
+ # If this was a live request, save the recording.
+ service.http_client.v2_http_client.close_session()
+
+
+def build_suite(classes):
+ """Creates a TestSuite for all unit test classes in the list.
+
+ Assumes that each of the classes in the list has unit test methods which
+ begin with 'test'. Calls unittest.makeSuite.
+
+ Returns:
+ A new unittest.TestSuite containing a test suite for all classes.
+ """
+ suites = [unittest.makeSuite(a_class, 'test') for a_class in classes]
+ return unittest.TestSuite(suites)
+
+
+def check_data_classes(test, classes):
+ import inspect
+ for data_class in classes:
+ test.assert_(data_class.__doc__ is not None,
+ 'The class %s should have a docstring' % data_class)
+ if hasattr(data_class, '_qname'):
+ qname_versions = None
+ if isinstance(data_class._qname, tuple):
+ qname_versions = data_class._qname
+ else:
+ qname_versions = (data_class._qname,)
+ for versioned_qname in qname_versions:
+ test.assert_(isinstance(versioned_qname, str),
+ 'The class %s has a non-string _qname' % data_class)
+ test.assert_(not versioned_qname.endswith('}'),
+ 'The _qname for class %s is only a namespace' % (
+ data_class))
+
+ for attribute_name, value in data_class.__dict__.iteritems():
+ # Ignore all elements that start with _ (private members)
+ if not attribute_name.startswith('_'):
+ try:
+ if not (isinstance(value, str) or inspect.isfunction(value)
+ or (isinstance(value, list)
+ and issubclass(value[0], atom.core.XmlElement))
+ or type(value) == property # Allow properties.
+ or inspect.ismethod(value) # Allow methods.
+ or inspect.ismethoddescriptor(value) # Allow method descriptors.
+ # staticmethod et al.
+ or issubclass(value, atom.core.XmlElement)):
+ test.fail(
+ 'XmlElement member should have an attribute, XML class,'
+ ' or list of XML classes as attributes.')
+
+ except TypeError:
+ test.fail('Element %s in %s was of type %s' % (
+ attribute_name, data_class._qname, type(value)))
+
+
+def check_clients_with_auth(test, classes):
+ for client_class in classes:
+ test.assert_(hasattr(client_class, 'api_version'))
+ test.assert_(isinstance(client_class.auth_service, (str, unicode, int)))
+ test.assert_(hasattr(client_class, 'auth_service'))
+ test.assert_(isinstance(client_class.auth_service, (str, unicode)))
+ test.assert_(hasattr(client_class, 'auth_scopes'))
+ test.assert_(isinstance(client_class.auth_scopes, (list, tuple)))
diff --git a/src/gdata/test_data.py b/src/gdata/test_data.py
new file mode 100755
index 0000000..7c979e7
--- /dev/null
+++ b/src/gdata/test_data.py
@@ -0,0 +1,6063 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+
+XML_ENTRY_1 = """<?xml version='1.0'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:g='http://base.google.com/ns/1.0'>
+ <category scheme="http://base.google.com/categories/itemtypes"
+ term="products"/>
+ <id> http://www.google.com/test/id/url </id>
+ <title type='text'>Testing 2000 series laptop</title>
+ <content type='xhtml'>
+ <div xmlns='http://www.w3.org/1999/xhtml'>A Testing Laptop</div>
+ </content>
+ <link rel='alternate' type='text/html'
+ href='http://www.provider-host.com/123456789'/>
+ <link rel='license'
+ href='http://creativecommons.org/licenses/by-nc/2.5/rdf'/>
+ <g:label>Computer</g:label>
+ <g:label>Laptop</g:label>
+ <g:label>testing laptop</g:label>
+ <g:item_type>products</g:item_type>
+</entry>"""
+
+
+TEST_BASE_ENTRY = """<?xml version='1.0'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:g='http://base.google.com/ns/1.0'>
+ <category scheme="http://base.google.com/categories/itemtypes"
+ term="products"/>
+ <title type='text'>Testing 2000 series laptop</title>
+ <content type='xhtml'>
+ <div xmlns='http://www.w3.org/1999/xhtml'>A Testing Laptop</div>
+ </content>
+ <app:control xmlns:app='http://purl.org/atom/app#'>
+ <app:draft>yes</app:draft>
+ <gm:disapproved xmlns:gm='http://base.google.com/ns-metadata/1.0'/>
+ </app:control>
+ <link rel='alternate' type='text/html'
+ href='http://www.provider-host.com/123456789'/>
+ <g:label>Computer</g:label>
+ <g:label>Laptop</g:label>
+ <g:label>testing laptop</g:label>
+ <g:item_type>products</g:item_type>
+</entry>"""
+
+
+BIG_FEED = """<?xml version="1.0" encoding="utf-8"?>
+ <feed xmlns="http://www.w3.org/2005/Atom">
+ <title type="text">dive into mark</title>
+ <subtitle type="html">
+ A <em>lot</em> of effort
+ went into making this effortless
+ </subtitle>
+ <updated>2005-07-31T12:29:29Z</updated>
+ <id>tag:example.org,2003:3</id>
+ <link rel="alternate" type="text/html"
+ hreflang="en" href="http://example.org/"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://example.org/feed.atom"/>
+ <rights>Copyright (c) 2003, Mark Pilgrim</rights>
+ <generator uri="http://www.example.com/" version="1.0">
+ Example Toolkit
+ </generator>
+ <entry>
+ <title>Atom draft-07 snapshot</title>
+ <link rel="alternate" type="text/html"
+ href="http://example.org/2005/04/02/atom"/>
+ <link rel="enclosure" type="audio/mpeg" length="1337"
+ href="http://example.org/audio/ph34r_my_podcast.mp3"/>
+ <id>tag:example.org,2003:3.2397</id>
+ <updated>2005-07-31T12:29:29Z</updated>
+ <published>2003-12-13T08:29:29-04:00</published>
+ <author>
+ <name>Mark Pilgrim</name>
+ <uri>http://example.org/</uri>
+ <email>f8dy@example.com</email>
+ </author>
+ <contributor>
+ <name>Sam Ruby</name>
+ </contributor>
+ <contributor>
+ <name>Joe Gregorio</name>
+ </contributor>
+ <content type="xhtml" xml:lang="en"
+ xml:base="http://diveintomark.org/">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <p><i>[Update: The Atom draft is finished.]</i></p>
+ </div>
+ </content>
+ </entry>
+ </feed>
+"""
+
+SMALL_FEED = """<?xml version="1.0" encoding="utf-8"?>
+ <feed xmlns="http://www.w3.org/2005/Atom">
+ <title>Example Feed</title>
+ <link href="http://example.org/"/>
+ <updated>2003-12-13T18:30:02Z</updated>
+ <author>
+ <name>John Doe</name>
+ </author>
+ <id>urn:uuid:60a76c80-d399-11d9-b93C-0003939e0af6</id>
+ <entry>
+ <title>Atom-Powered Robots Run Amok</title>
+ <link href="http://example.org/2003/12/13/atom03"/>
+ <id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
+ <updated>2003-12-13T18:30:02Z</updated>
+ <summary>Some text.</summary>
+ </entry>
+ </feed>
+"""
+
+GBASE_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:g='http://base.google.com/ns/1.0' xmlns:batch='http://schemas.google.com/gdata/batch'>
+<id>http://www.google.com/base/feeds/snippets</id>
+<updated>2007-02-08T23:18:21.935Z</updated>
+<title type='text'>Items matching query: digital camera</title>
+<link rel='alternate' type='text/html' href='http://base.google.com'>
+</link>
+<link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets'>
+</link>
+<link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets?start-index=1&max-results=25&bq=digital+camera'>
+</link>
+<link rel='next' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets?start-index=26&max-results=25&bq=digital+camera'>
+</link>
+<generator version='1.0' uri='http://base.google.com'>GoogleBase </generator>
+<openSearch:totalResults>2171885</openSearch:totalResults>
+<openSearch:startIndex>1</openSearch:startIndex>
+<openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+<entry>
+<id>http://www.google.com/base/feeds/snippets/13246453826751927533</id>
+<published>2007-02-08T13:23:27.000Z</published>
+<updated>2007-02-08T16:40:57.000Z</updated>
+<category scheme='http://base.google.com/categories/itemtypes' term='Products'>
+</category>
+<title type='text'>Digital Camera Battery Notebook Computer 12v DC Power Cable - 5.5mm x 2.5mm (Center +) Camera Connecting Cables</title>
+<content type='html'>Notebook Computer 12v DC Power Cable - 5.5mm x 2.1mm (Center +) This connection cable will allow any Digital Pursuits battery pack to power portable computers that operate with 12v power and have a 2.1mm power connector (center +) Digital ...</content>
+<link rel='alternate' type='text/html' href='http://www.bhphotovideo.com/bnh/controller/home?O=productlist&A=details&Q=&sku=305668&is=REG&kw=DIDCB5092&BI=583'>
+</link>
+<link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets/13246453826751927533'>
+</link>
+<author>
+<name>B&H Photo-Video</name>
+<email>anon-szot0wdsq0at@base.google.com</email>
+</author>
+<g:payment_notes type='text'>PayPal & Bill Me Later credit available online only.</g:payment_notes>
+<g:condition type='text'>new</g:condition>
+<g:location type='location'>420 9th Ave. 10001</g:location>
+<g:id type='text'>305668-REG</g:id>
+<g:item_type type='text'>Products</g:item_type>
+<g:brand type='text'>Digital Camera Battery</g:brand>
+<g:expiration_date type='dateTime'>2007-03-10T13:23:27.000Z</g:expiration_date>
+<g:customer_id type='int'>1172711</g:customer_id>
+<g:price type='floatUnit'>34.95 usd</g:price>
+<g:product_type type='text'>Digital Photography>Camera Connecting Cables</g:product_type>
+<g:item_language type='text'>EN</g:item_language>
+<g:manufacturer_id type='text'>DCB5092</g:manufacturer_id>
+<g:target_country type='text'>US</g:target_country>
+<g:weight type='float'>1.0</g:weight>
+<g:image_link type='url'>http://base.google.com/base_image?q=http%3A%2F%2Fwww.bhphotovideo.com%2Fimages%2Fitems%2F305668.jpg&dhm=ffffffff84c9a95e&size=6</g:image_link>
+</entry>
+<entry>
+<id>http://www.google.com/base/feeds/snippets/10145771037331858608</id>
+<published>2007-02-08T13:23:27.000Z</published>
+<updated>2007-02-08T16:40:57.000Z</updated>
+<category scheme='http://base.google.com/categories/itemtypes' term='Products'>
+</category>
+<title type='text'>Digital Camera Battery Electronic Device 5v DC Power Cable - 5.5mm x 2.5mm (Center +) Camera Connecting Cables</title>
+<content type='html'>Electronic Device 5v DC Power Cable - 5.5mm x 2.5mm (Center +) This connection cable will allow any Digital Pursuits battery pack to power any electronic device that operates with 5v power and has a 2.5mm power connector (center +) Digital ...</content>
+<link rel='alternate' type='text/html' href='http://www.bhphotovideo.com/bnh/controller/home?O=productlist&A=details&Q=&sku=305656&is=REG&kw=DIDCB5108&BI=583'>
+</link>
+<link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets/10145771037331858608'>
+</link>
+<author>
+<name>B&H Photo-Video</name>
+<email>anon-szot0wdsq0at@base.google.com</email>
+</author>
+<g:location type='location'>420 9th Ave. 10001</g:location>
+<g:condition type='text'>new</g:condition>
+<g:weight type='float'>0.18</g:weight>
+<g:target_country type='text'>US</g:target_country>
+<g:product_type type='text'>Digital Photography>Camera Connecting Cables</g:product_type>
+<g:payment_notes type='text'>PayPal & Bill Me Later credit available online only.</g:payment_notes>
+<g:id type='text'>305656-REG</g:id>
+<g:image_link type='url'>http://base.google.com/base_image?q=http%3A%2F%2Fwww.bhphotovideo.com%2Fimages%2Fitems%2F305656.jpg&dhm=7315bdc8&size=6</g:image_link>
+<g:manufacturer_id type='text'>DCB5108</g:manufacturer_id>
+<g:upc type='text'>838098005108</g:upc>
+<g:price type='floatUnit'>34.95 usd</g:price>
+<g:item_language type='text'>EN</g:item_language>
+<g:brand type='text'>Digital Camera Battery</g:brand>
+<g:customer_id type='int'>1172711</g:customer_id>
+<g:item_type type='text'>Products</g:item_type>
+<g:expiration_date type='dateTime'>2007-03-10T13:23:27.000Z</g:expiration_date>
+</entry>
+<entry>
+<id>http://www.google.com/base/feeds/snippets/3128608193804768644</id>
+<published>2007-02-08T02:21:27.000Z</published>
+<updated>2007-02-08T15:40:13.000Z</updated>
+<category scheme='http://base.google.com/categories/itemtypes' term='Products'>
+</category>
+<title type='text'>Digital Camera Battery Power Cable for Kodak 645 Pro-Back ProBack & DCS-300 Series Camera Connecting Cables</title>
+<content type='html'>Camera Connection Cable - to Power Kodak 645 Pro-Back DCS-300 Series Digital Cameras This connection cable will allow any Digital Pursuits battery pack to power the following digital cameras: Kodak DCS Pro Back 645 DCS-300 series Digital Photography ...</content>
+<link rel='alternate' type='text/html' href='http://www.bhphotovideo.com/bnh/controller/home?O=productlist&A=details&Q=&sku=305685&is=REG&kw=DIDCB6006&BI=583'>
+</link>
+<link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/snippets/3128608193804768644'>
+</link>
+<author>
+<name>B&H Photo-Video</name>
+<email>anon-szot0wdsq0at@base.google.com</email>
+</author>
+<g:weight type='float'>0.3</g:weight>
+<g:manufacturer_id type='text'>DCB6006</g:manufacturer_id>
+<g:image_link type='url'>http://base.google.com/base_image?q=http%3A%2F%2Fwww.bhphotovideo.com%2Fimages%2Fitems%2F305685.jpg&dhm=72f0ca0a&size=6</g:image_link>
+<g:location type='location'>420 9th Ave. 10001</g:location>
+<g:payment_notes type='text'>PayPal & Bill Me Later credit available online only.</g:payment_notes>
+<g:item_type type='text'>Products</g:item_type>
+<g:target_country type='text'>US</g:target_country>
+<g:accessory_for type='text'>digital kodak camera</g:accessory_for>
+<g:brand type='text'>Digital Camera Battery</g:brand>
+<g:expiration_date type='dateTime'>2007-03-10T02:21:27.000Z</g:expiration_date>
+<g:item_language type='text'>EN</g:item_language>
+<g:condition type='text'>new</g:condition>
+<g:price type='floatUnit'>34.95 usd</g:price>
+<g:customer_id type='int'>1172711</g:customer_id>
+<g:product_type type='text'>Digital Photography>Camera Connecting Cables</g:product_type>
+<g:id type='text'>305685-REG</g:id>
+</entry>
+</feed>"""
+
+EXTENSION_TREE = """<?xml version="1.0" encoding="utf-8"?>
+ <feed xmlns="http://www.w3.org/2005/Atom">
+ <g:author xmlns:g="http://www.google.com">
+ <g:name>John Doe
+ <g:foo yes="no" up="down">Bar</g:foo>
+ </g:name>
+ </g:author>
+ </feed>
+"""
+
+TEST_AUTHOR = """<?xml version="1.0" encoding="utf-8"?>
+ <author xmlns="http://www.w3.org/2005/Atom">
+ <name xmlns="http://www.w3.org/2005/Atom">John Doe</name>
+ <email xmlns="http://www.w3.org/2005/Atom">johndoes@someemailadress.com</email>
+ <uri xmlns="http://www.w3.org/2005/Atom">http://www.google.com</uri>
+ </author>
+"""
+
+TEST_LINK = """<?xml version="1.0" encoding="utf-8"?>
+ <link xmlns="http://www.w3.org/2005/Atom" href="http://www.google.com"
+ rel="test rel" foo1="bar" foo2="rab"/>
+"""
+
+TEST_GBASE_ATTRIBUTE = """<?xml version="1.0" encoding="utf-8"?>
+ <g:brand type='text' xmlns:g="http://base.google.com/ns/1.0">Digital Camera Battery</g:brand>
+"""
+
+
+CALENDAR_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:gd='http://schemas.google.com/g/2005'
+xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <id>http://www.google.com/calendar/feeds/default</id>
+ <updated>2007-03-20T22:48:57.833Z</updated>
+ <title type='text'>GData Ops Demo's Calendar List</title>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default'></link>
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default'></link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <generator version='1.0' uri='http://www.google.com/calendar'>
+ Google Calendar</generator>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/gdata.ops.demo%40gmail.com</id>
+ <published>2007-03-20T22:48:57.837Z</published>
+ <updated>2007-03-20T22:48:52.000Z</updated>
+ <title type='text'>GData Ops Demo</title>
+ <link rel='alternate' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/gdata.ops.demo%40gmail.com/private/full'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/gdata.ops.demo%40gmail.com'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:color value='#2952A3'></gCal:color>
+ <gCal:accesslevel value='owner'></gCal:accesslevel>
+ <gCal:hidden value='false'></gCal:hidden>
+ <gCal:timezone value='America/Los_Angeles'></gCal:timezone>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/jnh21ovnjgfph21h32gvms2758%40group.calendar.google.com</id>
+ <published>2007-03-20T22:48:57.837Z</published>
+ <updated>2007-03-20T22:48:53.000Z</updated>
+ <title type='text'>GData Ops Demo Secondary Calendar</title>
+ <summary type='text'></summary>
+ <link rel='alternate' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/jnh21ovnjgfph21h32gvms2758%40group.calendar.google.com/private/full'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/jnh21ovnjgfph21h32gvms2758%40group.calendar.google.com'>
+ </link>
+ <author>
+ <name>GData Ops Demo Secondary Calendar</name>
+ </author>
+ <gCal:color value='#528800'></gCal:color>
+ <gCal:accesslevel value='owner'></gCal:accesslevel>
+ <gCal:hidden value='false'></gCal:hidden>
+ <gCal:timezone value='America/Los_Angeles'></gCal:timezone>
+ <gd:where valueString=''></gd:where>
+ </entry>
+</feed>
+"""
+
+CALENDAR_FULL_EVENT_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:gd='http://schemas.google.com/g/2005'
+xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full</id>
+ <updated>2007-03-20T21:29:57.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>GData Ops Demo</title>
+ <subtitle type='text'>GData Ops Demo</subtitle>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full?updated-min=2001-01-01&max-results=25'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <generator version='1.0' uri='http://www.google.com/calendar'>
+ Google Calendar</generator>
+ <openSearch:totalResults>10</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <gCal:timezone value='America/Los_Angeles'></gCal:timezone>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/o99flmgmkfkfrr8u745ghr3100</id>
+ <published>2007-03-20T21:29:52.000Z</published>
+ <updated>2007-03-20T21:29:57.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>test deleted</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=bzk5ZmxtZ21rZmtmcnI4dTc0NWdocjMxMDAgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/o99flmgmkfkfrr8u745ghr3100'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/o99flmgmkfkfrr8u745ghr3100/63310109397'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.canceled'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/o99flmgmkfkfrr8u745ghr3100/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-23T12:00:00.000-07:00'
+ endTime='2007-03-23T13:00:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/2qt3ao5hbaq7m9igr5ak9esjo0</id>
+ <published>2007-03-20T21:26:04.000Z</published>
+ <updated>2007-03-20T21:28:46.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Afternoon at Dolores Park with Kim</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=MnF0M2FvNWhiYXE3bTlpZ3I1YWs5ZXNqbzAgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/2qt3ao5hbaq7m9igr5ak9esjo0'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/2qt3ao5hbaq7m9igr5ak9esjo0/63310109326'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/2qt3ao5hbaq7m9igr5ak9esjo0/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.private'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:who rel='http://schemas.google.com/g/2005#event.organizer'
+ valueString='GData Ops Demo' email='gdata.ops.demo@gmail.com'>
+ <gd:attendeeStatus value='http://schemas.google.com/g/2005#event.accepted'>
+ </gd:attendeeStatus>
+ </gd:who>
+ <gd:who rel='http://schemas.google.com/g/2005#event.attendee'
+ valueString='Ryan Boyd (API)' email='api.rboyd@gmail.com'>
+ <gd:attendeeStatus value='http://schemas.google.com/g/2005#event.invited'>
+ </gd:attendeeStatus>
+ </gd:who>
+ <gd:when startTime='2007-03-24T12:00:00.000-07:00'
+ endTime='2007-03-24T15:00:00.000-07:00'>
+ <gd:reminder minutes='20'></gd:reminder>
+ </gd:when>
+ <gd:where valueString='Dolores Park with Kim'></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/uvsqhg7klnae40v50vihr1pvos</id>
+ <published>2007-03-20T21:28:37.000Z</published>
+ <updated>2007-03-20T21:28:37.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Team meeting</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=dXZzcWhnN2tsbmFlNDB2NTB2aWhyMXB2b3NfMjAwNzAzMjNUMTYwMDAwWiBnZGF0YS5vcHMuZGVtb0Bt'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/uvsqhg7klnae40v50vihr1pvos'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/uvsqhg7klnae40v50vihr1pvos/63310109317'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gd:recurrence>DTSTART;TZID=America/Los_Angeles:20070323T090000
+ DTEND;TZID=America/Los_Angeles:20070323T100000
+ RRULE:FREQ=WEEKLY;BYDAY=FR;UNTIL=20070817T160000Z;WKST=SU
+ BEGIN:VTIMEZONE TZID:America/Los_Angeles
+ X-LIC-LOCATION:America/Los_Angeles BEGIN:STANDARD
+ TZOFFSETFROM:-0700 TZOFFSETTO:-0800 TZNAME:PST
+ DTSTART:19701025T020000 RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU
+ END:STANDARD BEGIN:DAYLIGHT TZOFFSETFROM:-0800 TZOFFSETTO:-0700
+ TZNAME:PDT DTSTART:19700405T020000
+ RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=1SU END:DAYLIGHT
+ END:VTIMEZONE</gd:recurrence>
+ <gCal:sendEventNotifications value='true'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.public'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:reminder minutes='10'></gd:reminder>
+ <gd:where valueString=''></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/st4vk9kiffs6rasrl32e4a7alo</id>
+ <published>2007-03-20T21:25:46.000Z</published>
+ <updated>2007-03-20T21:25:46.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Movie with Kim and danah</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=c3Q0dms5a2lmZnM2cmFzcmwzMmU0YTdhbG8gZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/st4vk9kiffs6rasrl32e4a7alo'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/st4vk9kiffs6rasrl32e4a7alo/63310109146'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/st4vk9kiffs6rasrl32e4a7alo/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-24T20:00:00.000-07:00'
+ endTime='2007-03-24T21:00:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/ofl1e45ubtsoh6gtu127cls2oo</id>
+ <published>2007-03-20T21:24:43.000Z</published>
+ <updated>2007-03-20T21:25:08.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Dinner with Kim and Sarah</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=b2ZsMWU0NXVidHNvaDZndHUxMjdjbHMyb28gZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ofl1e45ubtsoh6gtu127cls2oo'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ofl1e45ubtsoh6gtu127cls2oo/63310109108'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/ofl1e45ubtsoh6gtu127cls2oo/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-20T19:00:00.000-07:00'
+ endTime='2007-03-20T21:30:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/b69s2avfi2joigsclecvjlc91g</id>
+ <published>2007-03-20T21:24:19.000Z</published>
+ <updated>2007-03-20T21:25:05.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Dinner with Jane and John</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=YjY5czJhdmZpMmpvaWdzY2xlY3ZqbGM5MWcgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/b69s2avfi2joigsclecvjlc91g'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/b69s2avfi2joigsclecvjlc91g/63310109105'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/b69s2avfi2joigsclecvjlc91g/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-22T17:00:00.000-07:00'
+ endTime='2007-03-22T19:30:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/u9p66kkiotn8bqh9k7j4rcnjjc</id>
+ <published>2007-03-20T21:24:33.000Z</published>
+ <updated>2007-03-20T21:24:33.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Tennis with Elizabeth</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=dTlwNjZra2lvdG44YnFoOWs3ajRyY25qamMgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/u9p66kkiotn8bqh9k7j4rcnjjc'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/u9p66kkiotn8bqh9k7j4rcnjjc/63310109073'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/u9p66kkiotn8bqh9k7j4rcnjjc/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-24T10:00:00.000-07:00'
+ endTime='2007-03-24T11:00:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/76oj2kceidob3s708tvfnuaq3c</id>
+ <published>2007-03-20T21:24:00.000Z</published>
+ <updated>2007-03-20T21:24:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Lunch with Jenn</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=NzZvajJrY2VpZG9iM3M3MDh0dmZudWFxM2MgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/76oj2kceidob3s708tvfnuaq3c'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/76oj2kceidob3s708tvfnuaq3c/63310109040'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/76oj2kceidob3s708tvfnuaq3c/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-03-20T11:30:00.000-07:00'
+ endTime='2007-03-20T12:30:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/5np9ec8m7uoauk1vedh5mhodco</id>
+ <published>2007-03-20T07:50:02.000Z</published>
+ <updated>2007-03-20T20:39:26.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>test entry</title>
+ <content type='text'>test desc</content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=NW5wOWVjOG03dW9hdWsxdmVkaDVtaG9kY28gZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/5np9ec8m7uoauk1vedh5mhodco'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/5np9ec8m7uoauk1vedh5mhodco/63310106366'>
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/5np9ec8m7uoauk1vedh5mhodco/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.private'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:who rel='http://schemas.google.com/g/2005#event.attendee'
+ valueString='Vivian Li' email='vli@google.com'>
+ <gd:attendeeStatus value='http://schemas.google.com/g/2005#event.declined'>
+ </gd:attendeeStatus>
+ </gd:who>
+ <gd:who rel='http://schemas.google.com/g/2005#event.organizer'
+ valueString='GData Ops Demo' email='gdata.ops.demo@gmail.com'>
+ <gd:attendeeStatus value='http://schemas.google.com/g/2005#event.accepted'>
+ </gd:attendeeStatus>
+ </gd:who>
+ <gd:when startTime='2007-03-21T08:00:00.000-07:00'
+ endTime='2007-03-21T09:00:00.000-07:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where valueString='anywhere'></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/fu6sl0rqakf3o0a13oo1i1a1mg</id>
+ <published>2007-02-14T23:23:37.000Z</published>
+ <updated>2007-02-14T23:25:30.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>test</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=ZnU2c2wwcnFha2YzbzBhMTNvbzFpMWExbWcgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/fu6sl0rqakf3o0a13oo1i1a1mg'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/fu6sl0rqakf3o0a13oo1i1a1mg/63307178730'>
+ </link>
+ <link rel="http://schemas.google.com/gCal/2005/webContent" title="World Cup" href="http://www.google.com/calendar/images/google-holiday.gif" type="image/gif">
+ <gCal:webContent width="276" height="120" url="http://www.google.com/logos/worldcup06.gif" />
+ </link>
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/fu6sl0rqakf3o0a13oo1i1a1mg/comments'>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:when startTime='2007-02-15T08:30:00.000-08:00'
+ endTime='2007-02-15T09:30:00.000-08:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where></gd:where>
+ </entry>
+ <entry>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/full/h7a0haa4da8sil3rr19ia6luvc</id>
+ <published>2007-07-16T22:13:28.000Z</published>
+ <updated>2007-07-16T22:13:29.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event' />
+ <title type='text'></title>
+ <content type='text' />
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=aDdhMGhhYTRkYThzaWwzcnIxOWlhNmx1dmMgZ2RhdGEub3BzLmRlbW9AbQ'
+ title='alternate' />
+ <link rel='http://schemas.google.com/gCal/2005/webContent'
+ type='application/x-google-gadgets+xml'
+ href='http://gdata.ops.demo.googlepages.com/birthdayicon.gif'
+ title='Date and Time Gadget'>
+ <gCal:webContent width='300' height='136'
+ url='http://google.com/ig/modules/datetime.xml'>
+ <gCal:webContentGadgetPref name='color' value='green' />
+ </gCal:webContent>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/h7a0haa4da8sil3rr19ia6luvc' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/h7a0haa4da8sil3rr19ia6luvc/63320307209' />
+ <author>
+ <name>GData Ops Demo</name>
+ <email>gdata.ops.demo@gmail.com</email>
+ </author>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/h7a0haa4da8sil3rr19ia6luvc/comments' />
+ </gd:comments>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed' />
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default' />
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque' />
+ <gd:when startTime='2007-03-14' endTime='2007-03-15' />
+ <gd:where />
+ </entry>
+</feed>
+"""
+
+CALENDAR_BATCH_REQUEST = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:batch='http://schemas.google.com/gdata/batch'
+ xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <entry>
+ <batch:id>1</batch:id>
+ <batch:operation type='insert' />
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event inserted via batch</title>
+ </entry>
+ <entry>
+ <batch:id>2</batch:id>
+ <batch:operation type='query' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/glcs0kv2qqa0gf52qi1jo018gc</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event queried via batch</title>
+ </entry>
+ <entry>
+ <batch:id>3</batch:id>
+ <batch:operation type='update' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event updated via batch</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=dWptMGdvNWR0bmdka3I2dTkxZGNxdmowcXMgaGFyaXNodi50ZXN0QG0' title='alternate' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs/63326098791' />
+ </entry>
+ <entry>
+ <batch:id>4</batch:id>
+ <batch:operation type='delete' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/d8qbg9egk1n6lhsgq1sjbqffqc</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event deleted via batch</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=ZDhxYmc5ZWdrMW42bGhzZ3Exc2picWZmcWMgaGFyaXNodi50ZXN0QG0' title='alternate' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/d8qbg9egk1n6lhsgq1sjbqffqc' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/d8qbg9egk1n6lhsgq1sjbqffqc/63326018324' />
+ </entry>
+</feed>
+"""
+
+CALENDAR_BATCH_RESPONSE = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:batch='http://schemas.google.com/gdata/batch'
+ xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <id>http://www.google.com/calendar/feeds/default/private/full</id>
+ <updated>2007-09-21T23:01:00.380Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>Batch Feed</title>
+ <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full' />
+ <link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full' />
+ <link rel='http://schemas.google.com/g/2005#batch' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/batch' />
+ <entry>
+ <batch:id>1</batch:id>
+ <batch:status code='201' reason='Created' />
+ <batch:operation type='insert' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/n9ug78gd9tv53ppn4hdjvk68ek</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event inserted via batch</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=bjl1Zzc4Z2Q5dHY1M3BwbjRoZGp2azY4ZWsgaGFyaXNodi50ZXN0QG0' title='alternate' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/n9ug78gd9tv53ppn4hdjvk68ek' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/n9ug78gd9tv53ppn4hdjvk68ek/63326098860' />
+ </entry>
+ <entry>
+ <batch:id>2</batch:id>
+ <batch:status code='200' reason='Success' />
+ <batch:operation type='query' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/glsc0kv2aqa0ff52qi1jo018gc</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event queried via batch</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=Z2xzYzBrdjJhcWEwZmY1MnFpMWpvMDE4Z2MgaGFyaXNodi50ZXN0QG0' title='alternate' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/glsc0kv2aqa0ff52qi1jo018gc' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/glsc0kv2aqa0ff52qi1jo018gc/63326098791' />
+ </entry>
+ <entry xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <batch:id>3</batch:id>
+ <batch:status code='200' reason='Success' />
+ <batch:operation type='update' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event updated via batch</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=dWptMGdvNWR0bmdka3I2dTkxZGNxdmowcXMgaGFyaXNodi50ZXN0QG0' title='alternate' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/full/ujm0go5dtngdkr6u91dcqvj0qs/63326098860' />
+ <batch:id>3</batch:id>
+ <batch:status code='200' reason='Success' />
+ <batch:operation type='update' />
+ </entry>
+ <entry>
+ <batch:id>4</batch:id>
+ <batch:status code='200' reason='Success' />
+ <batch:operation type='delete' />
+ <id>http://www.google.com/calendar/feeds/default/private/full/d8qbg9egk1n6lhsgq1sjbqffqc</id>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/g/2005#event' />
+ <title type='text'>Event deleted via batch</title>
+ <content type='text'>Deleted</content>
+ </entry>
+</feed>
+"""
+
+GBASE_ATTRIBUTE_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+ <feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gm='http://base.google.com/ns-metadata/1.0'>
+ <id>http://www.google.com/base/feeds/attributes</id>
+ <updated>2006-11-01T20:35:59.578Z</updated>
+ <category scheme='http://base.google.com/categories/itemtypes' term='online jobs'></category>
+ <category scheme='http://base.google.com/categories/itemtypes' term='jobs'></category>
+ <title type='text'>Attribute histogram for query: [item type:jobs]</title>
+ <link rel='alternate' type='text/html' href='http://base.google.com'></link>
+ <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://www.google.com/base/feeds
+/attributes'></link>
+ <link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/attributes/-/jobs'></link>
+ <generator version='1.0' uri='http://base.google.com'>GoogleBase</generator>
+ <openSearch:totalResults>16</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>16</openSearch:itemsPerPage>
+ <entry>
+ <id>http://www.google.com/base/feeds/attributes/job+industry%28text%29N%5Bitem+type%3Ajobs%5D</id>
+ <updated>2006-11-01T20:36:00.100Z</updated>
+ <title type='text'>job industry(text)</title>
+ <content type='text'>Attribute"job industry" of type text.
+ </content>
+ <link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/attributes/job+industry%28text
+%29N%5Bitem+type%3Ajobs%5D'></link>
+ <gm:attribute name='job industry' type='text' count='4416629'>
+ <gm:value count='380772'>it internet</gm:value>
+ <gm:value count='261565'>healthcare</gm:value>
+ <gm:value count='142018'>information technology</gm:value>
+ <gm:value count='124622'>accounting</gm:value>
+ <gm:value count='111311'>clerical and administrative</gm:value>
+ <gm:value count='82928'>other</gm:value>
+ <gm:value count='77620'>sales and sales management</gm:value>
+ <gm:value count='68764'>information systems</gm:value>
+ <gm:value count='65859'>engineering and architecture</gm:value>
+ <gm:value count='64757'>sales</gm:value>
+ </gm:attribute>
+ </entry>
+ </feed>
+"""
+
+
+GBASE_ATTRIBUTE_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+ <entry xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gm='http://base.google.com/ns-metadata/1.0'>
+ <id>http://www.google.com/base/feeds/attributes/job+industry%28text%29N%5Bitem+type%3Ajobs%5D</id>
+ <updated>2006-11-01T20:36:00.100Z</updated>
+ <title type='text'>job industry(text)</title>
+ <content type='text'>Attribute"job industry" of type text.
+ </content>
+ <link rel='self' type='application/atom+xml' href='http://www.google.com/base/feeds/attributes/job+industry%28text%29N%5Bitem+type%3Ajobs%5D'></link>
+ <gm:attribute name='job industry' type='text' count='4416629'>
+ <gm:value count='380772'>it internet</gm:value>
+ <gm:value count='261565'>healthcare</gm:value>
+ <gm:value count='142018'>information technology</gm:value>
+ <gm:value count='124622'>accounting</gm:value>
+ <gm:value count='111311'>clerical and administrative</gm:value>
+ <gm:value count='82928'>other</gm:value>
+ <gm:value count='77620'>sales and sales management</gm:value>
+ <gm:value count='68764'>information systems</gm:value>
+ <gm:value count='65859'>engineering and architecture</gm:value>
+ <gm:value count='64757'>sales</gm:value>
+ </gm:attribute>
+ </entry>
+"""
+
+GBASE_LOCALES_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+ xmlns:gm='http://base.google.com/ns-metadata/1.0'>
+ <id> http://www.google.com/base/feeds/locales/</id>
+ <updated>2006-06-13T18:11:40.120Z</updated>
+ <title type="text">Locales</title>
+ <link rel="alternate" type="text/html" href="http://base.google.com"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml"
+
+ href="http://www.google.com/base/feeds/locales/"/>
+ <link rel="self" type="application/atom+xml" href="http://www.google.com/base/feeds/locales/"/>
+ <author>
+ <name>Google Inc.</name>
+ <email>base@google.com</email>
+ </author>
+ <generator version="1.0" uri="http://base.google.com">GoogleBase</generator>
+ <openSearch:totalResults>3</openSearch:totalResults>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+
+<entry>
+ <id>http://www.google.com/base/feeds/locales/en_US</id>
+ <updated>2006-03-27T22:27:36.658Z</updated>
+ <category scheme="http://base.google.com/categories/locales" term="en_US"/>
+
+ <title type="text">en_US</title>
+ <content type="text">en_US</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/locales/en_US"></link>
+
+ <link rel="related" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/itemtypes/en_US" title="Item types in en_US"/>
+</entry>
+<entry>
+ <id>http://www.google.com/base/feeds/locales/en_GB</id>
+ <updated>2006-06-13T18:14:18.601Z</updated>
+ <category scheme="http://base.google.com/categories/locales" term="en_GB"/>
+ <title type="text">en_GB</title>
+ <content type="text">en_GB</content>
+ <link rel="related" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/itemtypes/en_GB" title="Item types in en_GB"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/locales/en_GB"/>
+</entry>
+<entry>
+ <id>http://www.google.com/base/feeds/locales/de_DE</id>
+ <updated>2006-06-13T18:14:18.601Z</updated>
+ <category scheme="http://base.google.com/categories/locales" term="de_DE"/>
+ <title type="text">de_DE</title>
+ <content type="text">de_DE</content>
+ <link rel="related" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/itemtypes/de_DE" title="Item types in de_DE"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://www.google.com/base/feeds/locales/de_DE"/>
+</entry>
+</feed>"""
+
+GBASE_STRING_ENCODING_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom' xmlns:gm='http://base.google.com/ns-metadata/1.0'
+ xmlns:g='http://base.google.com/ns/1.0' xmlns:batch='http://schemas.google.com/gdata/batch'>
+ <id>http://www.google.com/base/feeds/snippets/17495780256183230088</id>
+ <published>2007-12-09T03:13:07.000Z</published>
+ <updated>2008-01-07T03:26:46.000Z</updated>
+ <category scheme='http://base.google.com/categories/itemtypes' term='Products'/>
+ <title type='text'>Digital Camera Cord Fits SONY Cybershot DSC-R1 S40</title>
+ <content type='html'>SONY \xC2\xB7 Cybershot Digital Camera Usb Cable DESCRIPTION
+ This is a 2.5 USB 2.0 A to Mini B (5 Pin) high quality digital camera
+ cable used for connecting your Sony Digital Cameras and Camcoders. Backward
+ Compatible with USB 2.0, 1.0 and 1.1. Fully ...</content>
+ <link rel='alternate' type='text/html'
+ href='http://adfarm.mediaplex.com/ad/ck/711-5256-8196-2?loc=http%3A%2F%2Fcgi.ebay.com%2FDigital-Camera-Cord-Fits-SONY-Cybershot-DSC-R1-S40_W0QQitemZ270195049057QQcmdZViewItem'/>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/base/feeds/snippets/17495780256183230088'/>
+ <author>
+ <name>eBay</name>
+ </author>
+ <g:item_type type='text'>Products</g:item_type>
+ <g:item_language type='text'>EN</g:item_language>
+ <g:target_country type='text'>US</g:target_country>
+ <g:price type='floatUnit'>0.99 usd</g:price>
+ <g:image_link type='url'>http://thumbs.ebaystatic.com/pict/270195049057_1.jpg</g:image_link>
+ <g:category type='text'>Cameras & Photo>Digital Camera Accessories>Cables</g:category>
+ <g:category type='text'>Cords & Connectors>USB Cables>For Other Brands</g:category>
+ <g:customer_id type='int'>11729</g:customer_id>
+ <g:id type='text'>270195049057</g:id>
+ <g:expiration_date type='dateTime'>2008-02-06T03:26:46Z</g:expiration_date>
+</entry>"""
+
+
+RECURRENCE_EXCEPTION_ENTRY = """<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:gd='http://schemas.google.com/g/2005'
+xmlns:gCal='http://schemas.google.com/gCal/2005'>
+ <id>
+ http://www.google.com/calendar/feeds/default/private/composite/i7lgfj69mjqjgnodklif3vbm7g</id>
+ <published>2007-04-05T21:51:49.000Z</published>
+ <updated>2007-04-05T21:51:49.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>testDavid</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=aTdsZ2ZqNjltanFqZ25vZGtsaWYzdmJtN2dfMjAwNzA0MDNUMTgwMDAwWiBnZGF0YS5vcHMudGVzdEBt'
+ title='alternate'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/default/private/composite/i7lgfj69mjqjgnodklif3vbm7g'>
+ </link>
+ <author>
+ <name>gdata ops</name>
+ <email>gdata.ops.test@gmail.com</email>
+ </author>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gCal:sendEventNotifications value='true'>
+ </gCal:sendEventNotifications>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.confirmed'>
+ </gd:eventStatus>
+ <gd:recurrence>DTSTART;TZID=America/Anchorage:20070403T100000
+ DTEND;TZID=America/Anchorage:20070403T110000
+ RRULE:FREQ=DAILY;UNTIL=20070408T180000Z;WKST=SU
+ EXDATE;TZID=America/Anchorage:20070407T100000
+ EXDATE;TZID=America/Anchorage:20070405T100000
+ EXDATE;TZID=America/Anchorage:20070404T100000 BEGIN:VTIMEZONE
+ TZID:America/Anchorage X-LIC-LOCATION:America/Anchorage
+ BEGIN:STANDARD TZOFFSETFROM:-0800 TZOFFSETTO:-0900 TZNAME:AKST
+ DTSTART:19701025T020000 RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU
+ END:STANDARD BEGIN:DAYLIGHT TZOFFSETFROM:-0900 TZOFFSETTO:-0800
+ TZNAME:AKDT DTSTART:19700405T020000
+ RRULE:FREQ=YEARLY;BYMONTH=4;BYDAY=1SU END:DAYLIGHT
+ END:VTIMEZONE</gd:recurrence>
+ <gd:where valueString=''></gd:where>
+ <gd:reminder minutes='10'></gd:reminder>
+ <gd:recurrenceException specialized='true'>
+ <gd:entryLink>
+ <entry>
+ <id>i7lgfj69mjqjgnodklif3vbm7g_20070407T180000Z</id>
+ <published>2007-04-05T21:51:49.000Z</published>
+ <updated>2007-04-05T21:52:58.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#event'></category>
+ <title type='text'>testDavid</title>
+ <content type='text'></content>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/event?eid=aTdsZ2ZqNjltanFqZ25vZGtsaWYzdmJtN2dfMjAwNzA0MDdUMTgwMDAwWiBnZGF0YS5vcHMudGVzdEBt'
+ title='alternate'></link>
+ <author>
+ <name>gdata ops</name>
+ <email>gdata.ops.test@gmail.com</email>
+ </author>
+ <gd:visibility value='http://schemas.google.com/g/2005#event.default'>
+ </gd:visibility>
+ <gd:originalEvent id='i7lgfj69mjqjgnodklif3vbm7g'
+ href='http://www.google.com/calendar/feeds/default/private/composite/i7lgfj69mjqjgnodklif3vbm7g'>
+
+ <gd:when startTime='2007-04-07T13:00:00.000-05:00'>
+ </gd:when>
+ </gd:originalEvent>
+ <gCal:sendEventNotifications value='false'>
+ </gCal:sendEventNotifications>
+ <gd:transparency value='http://schemas.google.com/g/2005#event.opaque'>
+ </gd:transparency>
+ <gd:eventStatus value='http://schemas.google.com/g/2005#event.canceled'>
+ </gd:eventStatus>
+ <gd:comments>
+ <gd:feedLink href='http://www.google.com/calendar/feeds/default/private/full/i7lgfj69mjqjgnodklif3vbm7g_20070407T180000Z/comments'>
+
+ <feed>
+ <updated>2007-04-05T21:54:09.285Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/g/2005#message'>
+ </category>
+ <title type='text'>Comments for: testDavid</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.google.com/calendar/feeds/default/private/full/i7lgfj69mjqjgnodklif3vbm7g_20070407T180000Z/comments'
+ title='alternate'></link>
+ </feed>
+ </gd:feedLink>
+ </gd:comments>
+ <gd:when startTime='2007-04-07T13:00:00.000-05:00'
+ endTime='2007-04-07T14:00:00.000-05:00'>
+ <gd:reminder minutes='10'></gd:reminder>
+ </gd:when>
+ <gd:where valueString=''></gd:where>
+ </entry>
+ </gd:entryLink>
+ </gd:recurrenceException>
+ </entry>"""
+
+NICK_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>https://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo</atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname'/>
+ <atom:title type="text">Foo</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo"/>
+ <apps:nickname name="Foo"/>
+ <apps:login userName="TestUser"/>
+</atom:entry>"""
+
+NICK_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:feed xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:apps="http://schemas.google.com/apps/2006">
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/nickname/2.0
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname'/>
+ <atom:title type="text">Nicknames for user SusanJones</atom:title>
+ <atom:link rel='http://schemas.google.com/g/2005#feed'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0"/>
+ <atom:link rel='http://schemas.google.com/g/2005#post'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0"/>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0?username=TestUser"/>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>2</openSearch:itemsPerPage>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo
+ </atom:id>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname'/>
+ <atom:title type="text">Foo</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo"/>
+ <apps:nickname name="Foo"/>
+ <apps:login userName="TestUser"/>
+ </atom:entry>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/suse
+ </atom:id>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname'/>
+ <atom:title type="text">suse</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Bar"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Bar"/>
+ <apps:nickname name="Bar"/>
+ <apps:login userName="TestUser"/>
+ </atom:entry>
+</atom:feed>"""
+
+USER_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>https://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser</atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#user'/>
+ <atom:title type="text">TestUser</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser"/>
+ <apps:login userName="TestUser" password="password" suspended="false"
+ ipWhitelisted='false' hashFunctionName="SHA-1"/>
+ <apps:name familyName="Test" givenName="User"/>
+ <apps:quota limit="1024"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames'
+ href="https://apps-apis.google.com/a/feeds/example.com/nickname/2.0?username=Test-3121"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists'
+ href="https://apps-apis.google.com/a/feeds/example.com/emailList/2.0?recipient=testlist@example.com"/>
+</atom:entry>"""
+
+USER_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:feed xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/user/2.0
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#user'/>
+ <atom:title type="text">Users</atom:title>
+ <atom:link rel="next" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0?startUsername=john"/>
+ <atom:link rel='http://schemas.google.com/g/2005#feed'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0"/>
+ <atom:link rel='http://schemas.google.com/g/2005#post'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0"/>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0"/>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser
+ </atom:id>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#user'/>
+ <atom:title type="text">TestUser</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser"/>
+ <gd:who rel='http://schemas.google.com/apps/2006#user.recipient'
+ email="TestUser@example.com"/>
+ <apps:login userName="TestUser" suspended="false"/>
+ <apps:quota limit="2048"/>
+ <apps:name familyName="Test" givenName="User"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames'
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0?username=TestUser"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists'
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0?recipient=TestUser@example.com"/>
+ </atom:entry>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/user/2.0/JohnSmith
+ </atom:id>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#user'/>
+ <atom:title type="text">JohnSmith</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0/JohnSmith"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/user/2.0/JohnSmith"/>
+ <gd:who rel='http://schemas.google.com/apps/2006#user.recipient'
+ email="JohnSmith@example.com"/>
+ <apps:login userName="JohnSmith" suspended="false"/>
+ <apps:quota limit="2048"/>
+ <apps:name familyName="Smith" givenName="John"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames'
+ href="http://apps-apis.google.com/a/feeds/example.com/nickname/2.0?username=JohnSmith"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists'
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0?recipient=JohnSmith@example.com"/>
+ </atom:entry>
+</atom:feed>"""
+
+EMAIL_LIST_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>
+ https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/testlist
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList'/>
+ <atom:title type="text">testlist</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/testlist"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/testlist"/>
+ <apps:emailList name="testlist"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients'
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/testlist/recipient/"/>
+</atom:entry>"""
+
+EMAIL_LIST_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:feed xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList'/>
+ <atom:title type="text">EmailLists</atom:title>
+ <atom:link rel="next" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0?startEmailListName=john"/>
+ <atom:link rel='http://schemas.google.com/g/2005#feed'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0"/>
+ <atom:link rel='http://schemas.google.com/g/2005#post'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0"/>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0"/>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList'/>
+ <atom:title type="text">us-sales</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales"/>
+ <apps:emailList name="us-sales"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients'
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/"/>
+ </atom:entry>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-eng
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList'/>
+ <atom:title type="text">us-eng</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-eng"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-eng"/>
+ <apps:emailList name="us-eng"/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients'
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-eng/recipient/"/>
+ </atom:entry>
+</atom:feed>"""
+
+EMAIL_LIST_RECIPIENT_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:apps="http://schemas.google.com/apps/2006"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/TestUser%40example.com</atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList.recipient'/>
+ <atom:title type="text">TestUser</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/TestUser%40example.com"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/TestUser%40example.com"/>
+ <gd:who email="TestUser@example.com"/>
+</atom:entry>"""
+
+EMAIL_LIST_RECIPIENT_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:feed xmlns:atom="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList.recipient'/>
+ <atom:title type="text">Recipients for email list us-sales</atom:title>
+ <atom:link rel="next" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/?startRecipient=terry@example.com"/>
+ <atom:link rel='http://schemas.google.com/g/2005#feed'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient"/>
+ <atom:link rel='http://schemas.google.com/g/2005#post'
+ type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient"/>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient"/>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/joe%40example.com
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList.recipient'/>
+ <atom:title type="text">joe@example.com</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/joe%40example.com"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/joe%40example.com"/>
+ <gd:who email="joe@example.com"/>
+ </atom:entry>
+ <atom:entry>
+ <atom:id>
+ http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/susan%40example.com
+ </atom:id>
+ <atom:updated>1970-01-01T00:00:00.000Z</atom:updated>
+ <atom:category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#emailList.recipient'/>
+ <atom:title type="text">susan@example.com</atom:title>
+ <atom:link rel="self" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/susan%40example.com"/>
+ <atom:link rel="edit" type="application/atom+xml"
+ href="http://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/recipient/susan%40example.com"/>
+ <gd:who email="susan@example.com"/>
+ </atom:entry>
+</atom:feed>"""
+
+ACL_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+ <feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+ xmlns:gAcl='http://schemas.google.com/acl/2007'>
+ <id>http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full</id>
+ <updated>2007-04-21T00:52:04.000Z</updated>
+ <title type='text'>Elizabeth Bennet's access control list</title>
+ <link rel='http://schemas.google.com/acl/2007#controlledObject'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/private/full'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full'>
+ </link>
+ <generator version='1.0'
+ uri='http://www.google.com/calendar'>Google Calendar</generator>
+ <openSearch:totalResults>2</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com</id>
+ <updated>2007-04-21T00:52:04.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'>
+ </category>
+ <title type='text'>owner</title>
+ <content type='text'></content>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <gAcl:scope type='user' value='liz@gmail.com'></gAcl:scope>
+ <gAcl:role value='http://schemas.google.com/gCal/2005#owner'>
+ </gAcl:role>
+ </entry>
+ <entry>
+ <id>http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/default</id>
+ <updated>2007-04-21T00:52:04.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'>
+ </category>
+ <title type='text'>read</title>
+ <content type='text'></content>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/default'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/default'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <gAcl:scope type='default'></gAcl:scope>
+ <gAcl:role value='http://schemas.google.com/gCal/2005#read'>
+ </gAcl:role>
+ </entry>
+ </feed>"""
+
+ACL_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+ <entry xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gd='http://schemas.google.com/g/2005' xmlns:gCal='http://schemas.google.com/gCal/2005' xmlns:gAcl='http://schemas.google.com/acl/2007'>
+ <id>http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com</id>
+ <updated>2007-04-21T00:52:04.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'>
+ </category>
+ <title type='text'>owner</title>
+ <content type='text'></content>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/calendar/feeds/liz%40gmail.com/acl/full/user%3Aliz%40gmail.com'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <gAcl:scope type='user' value='liz@gmail.com'></gAcl:scope>
+ <gAcl:role value='http://schemas.google.com/gCal/2005#owner'>
+ </gAcl:role>
+ </entry>"""
+
+DOCUMENT_LIST_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<ns0:feed xmlns:ns0="http://www.w3.org/2005/Atom" xmlns:ns2="http://schemas.google.com/g/2005" xmlns:ns3="http://schemas.google.com/docs/2007"><ns1:totalResults
+xmlns:ns1="http://a9.com/-/spec/opensearchrss/1.0/">2</ns1:totalResults><ns1:startIndex
+xmlns:ns1="http://a9.com/-/spec/opensearchrss/1.0/">1</ns1:startIndex><ns0:entry><ns0:content
+src="https://foo.com/fm?fmcmd=102&key=supercalifragilisticexpeadocious"
+type="text/html"
+/><ns0:author><ns0:name>test.user</ns0:name><ns0:email>test.user@gmail.com</ns0:email></ns0:author><ns0:category
+label="spreadsheet" scheme="http://schemas.google.com/g/2005#kind"
+term="http://schemas.google.com/docs/2007#spreadsheet"
+/><ns0:id>https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpeadocious</ns0:id><ns0:link
+href="https://foo.com/ccc?key=supercalifragilisticexpeadocious" rel="alternate"
+type="text/html" /><ns0:link
+href="https://foo.com/feeds/worksheets/supercalifragilisticexpeadocious/private/full"
+rel="http://schemas.google.com/spreadsheets/2006#worksheetsfeed"
+type="application/atom+xml" /><ns0:link
+href="https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpeadocious"
+rel="self" type="application/atom+xml" /><ns0:title type="text">Test Spreadsheet</ns0:title><ns0:updated>2007-07-03T18:03:32.045Z</ns0:updated>
+<ns2:feedLink href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3Afoofoofoo" rel="http://schemas.google.com/acl/2007#accessControlList"/>
+<ns2:resourceId>document:dfrkj84g_3348jbxpxcd</ns2:resourceId>
+<ns2:lastModifiedBy>
+ <ns0:name>test.user</ns0:name>
+ <ns0:email>test.user@gmail.com</ns0:email>
+</ns2:lastModifiedBy>
+<ns2:lastViewed>2009-03-05T07:48:21.493Z</ns2:lastViewed>
+<ns3:writersCanInvite value='true'/>
+</ns0:entry><ns0:entry><ns0:content
+src="http://docs.google.com/RawDocContents?action=fetch&docID=gr00vy"
+type="text/html"
+/><ns0:author><ns0:name>test.user</ns0:name><ns0:email>test.user@gmail.com</ns0:email></ns0:author><ns0:category
+label="document" scheme="http://schemas.google.com/g/2005#kind"
+term="http://schemas.google.com/docs/2007#document"
+/><ns0:id>http://docs.google.com/feeds/documents/private/full/document%3Agr00vy</ns0:id><ns0:link
+href="http://foobar.com/Doc?id=gr00vy" rel="alternate" type="text/html"
+/><ns0:link
+href="http://docs.google.com/feeds/documents/private/full/document%3Agr00vy"
+rel="self" type="application/atom+xml" /><ns0:title type="text">Test Document</ns0:title><ns0:updated>2007-07-03T18:02:50.338Z</ns0:updated>
+<ns2:feedLink href="http://docs.google.com/feeds/acl/private/full/document%3Afoofoofoo" rel="http://schemas.google.com/acl/2007#accessControlList"/>
+<ns2:lastModifiedBy>
+ <ns0:name>test.user</ns0:name>
+ <ns0:email>test.user@gmail.com</ns0:email>
+</ns2:lastModifiedBy>
+<ns3:writersCanInvite value='false'/>
+ <ns2:lastViewed>2009-03-05T07:48:21.493Z</ns2:lastViewed>
+</ns0:entry><ns0:id>http://docs.google.com/feeds/documents/private/full</ns0:id><ns0:link
+href="http://docs.google.com" rel="alternate" type="text/html" /><ns0:link
+href="http://docs.google.com/feeds/documents/private/full"
+rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml"
+/><ns0:link href="http://docs.google.com/feeds/documents/private/full"
+rel="http://schemas.google.com/g/2005#post" type="application/atom+xml"
+/><ns0:link href="http://docs.google.com/feeds/documents/private/full"
+rel="self" type="application/atom+xml" /><ns0:title type="text">Available
+Documents -
+test.user@gmail.com</ns0:title><ns0:updated>2007-07-09T23:07:21.898Z</ns0:updated>
+</ns0:feed>
+"""
+
+DOCUMENT_LIST_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<ns0:entry xmlns:ns0="http://www.w3.org/2005/Atom" xmlns:ns1="http://schemas.google.com/g/2005" xmlns:ns2="http://schemas.google.com/docs/2007"><ns0:content
+src="https://foo.com/fm?fmcmd=102&key=supercalifragilisticexpealidocious" type="text/html"/>
+<ns0:author><ns0:name>test.user</ns0:name><ns0:email>test.user@gmail.com</ns0:email></ns0:author>
+<ns0:category label="spreadsheet" scheme="http://schemas.google.com/g/2005#kind"
+term="http://schemas.google.com/docs/2007#spreadsheet"
+/><ns0:id>https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpealidocious</ns0:id>
+<ns0:link href="https://foo.com/ccc?key=supercalifragilisticexpealidocious"
+rel="alternate" type="text/html" /><ns0:link
+href="https://foo.com/feeds/worksheets/supercalifragilisticexpealidocious/private/full"
+rel="http://schemas.google.com/spreadsheets/2006#worksheetsfeed"
+type="application/atom+xml" /><ns0:link
+href="https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpealidocious"
+rel="self" type="application/atom+xml" />
+<ns0:title type="text">Test Spreadsheet</ns0:title><ns0:updated>2007-07-03T18:03:32.045Z</ns0:updated>
+<ns1:resourceId>spreadsheet:supercalifragilisticexpealidocious</ns1:resourceId>
+<ns1:lastModifiedBy>
+ <ns0:name>test.user</ns0:name>
+ <ns0:email>test.user@gmail.com</ns0:email>
+</ns1:lastModifiedBy>
+<ns1:lastViewed>2009-03-05T07:48:21.493Z</ns1:lastViewed>
+<ns2:writersCanInvite value='true'/>
+</ns0:entry>
+"""
+
+DOCUMENT_LIST_ENTRY_V3 = """<?xml version='1.0' encoding='UTF-8'?>
+<ns0:entry xmlns:ns0="http://www.w3.org/2005/Atom" xmlns:ns1="http://schemas.google.com/g/2005" xmlns:ns2="http://schemas.google.com/docs/2007"><ns0:content
+src="https://foo.com/fm?fmcmd=102&key=supercalifragilisticexpealidocious" type="text/html"/>
+<ns0:author><ns0:name>test.user</ns0:name><ns0:email>test.user@gmail.com</ns0:email></ns0:author>
+<ns0:category label="spreadsheet" scheme="http://schemas.google.com/g/2005#kind"
+term="http://schemas.google.com/docs/2007#spreadsheet"
+/><ns0:id>https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpealidocious</ns0:id>
+<ns0:link href="https://foo.com/ccc?key=supercalifragilisticexpealidocious"
+rel="alternate" type="text/html" /><ns0:link
+href="https://foo.com/feeds/worksheets/supercalifragilisticexpealidocious/private/full"
+rel="http://schemas.google.com/spreadsheets/2006#worksheetsfeed"
+type="application/atom+xml" /><ns0:link
+href="https://docs.google.com/feeds/documents/private/full/spreadsheet%3Asupercalifragilisticexpealidocious"
+rel="self" type="application/atom+xml" />
+<ns0:link rel="http://schemas.google.com/docs/2007#parent" type="application/atom+xml"
+href="http://docs.google.com/feeds/default/private/full/folder%3A12345" title="AFolderName" />
+<ns0:title type="text">Test Spreadsheet</ns0:title><ns0:updated>2007-07-03T18:03:32.045Z</ns0:updated>
+<ns1:resourceId>spreadsheet:supercalifragilisticexpealidocious</ns1:resourceId>
+<ns1:lastModifiedBy>
+ <ns0:name>test.user</ns0:name>
+ <ns0:email>test.user@gmail.com</ns0:email>
+</ns1:lastModifiedBy>
+<ns1:lastViewed>2009-03-05T07:48:21.493Z</ns1:lastViewed>
+<ns2:writersCanInvite value='true'/>
+<ns1:quotaBytesUsed>1000</ns1:quotaBytesUsed>
+<ns1:feedLink rel="http://schemas.google.com/acl/2007#accessControlList" href="https://docs.google.com/feeds/default/private/full/spreadsheet%3Asupercalifragilisticexpealidocious/acl" />
+<ns1:feedLink rel="http://schemas.google.com/docs/2007/revisions" href="https://docs.google.com/feeds/default/private/full/spreadsheet%3Asupercalifragilisticexpealidocious/revisions" />
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#starred" label="starred"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#viewed" label="viewed"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#hidden" label="hidden"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#trashed" label="trashed"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#mine" label="mine"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#private" label="private"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#shared-with-domain" label="shared-with-domain"/>
+<ns0:category scheme="http://schemas.google.com/g/2005/labels" term="http://schemas.google.com/g/2005/labels#restricted-download" label="restricted-download"/>
+</ns0:entry>
+"""
+
+DOCUMENT_LIST_ACL_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gAcl='http://schemas.google.com/acl/2007'>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'/>
+ <gAcl:role value='writer'/>
+ <gAcl:scope type='user' value='user@gmail.com'/>
+</entry>"""
+
+
+DOCUMENT_LIST_ACL_WITHKEY_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gAcl='http://schemas.google.com/acl/2007'>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'/>
+ <gAcl:withKey key='somekey'><gAcl:role value='writer' /></gAcl:withKey>
+ <gAcl:scope type='domain' value='example.com' />
+</entry>"""
+
+
+DOCUMENT_LIST_ACL_ADDITIONAL_ROLE_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gAcl='http://schemas.google.com/acl/2007'>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/acl/2007#accessRule'/>
+ <gAcl:additionalRole value='commenter' />
+ <gAcl:withKey key='somekey'>
+ <gAcl:role value='writer' />
+ <gAcl:additionalRole value='commenter' />
+ </gAcl:withKey>
+ <gAcl:scope type='domain' value='example.com' />
+</entry>"""
+
+
+DOCUMENT_LIST_ACL_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gAcl="http://schemas.google.com/acl/2007"
+ xmlns:batch="http://schemas.google.com/gdata/batch">
+<id>http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZpwUQ</id>
+<updated>2009-02-22T03:48:25.895Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/>
+<title type="text">Document Permissions</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZpwUQ"/>
+<link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZpwUQ"/>
+<link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZpwUQ/batch"/>
+<link rel="self" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZpwUQ"/>
+<openSearch:totalResults>2</openSearch:totalResults>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+ <id>http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQp4pwUwUQ/user%3Auser%40gmail.com</id>
+ <updated>2009-02-22T03:48:25.896Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/>
+ <title type="text">Document Permission - user@gmail.com</title>
+ <link rel="self" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQp4pwUwUQ/user%3Auser%40gmail.com"/>
+ <link rel="edit" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQp4pwUwUQ/user%3Auser%40gmail.com"/>
+ <gAcl:role value="owner"/>
+ <gAcl:scope type="user" value="user@gmail.com"/>
+</entry>
+<entry>
+ <id>http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8fCgZp4pwUwUQ/user%3Auser2%40google.com</id>
+ <updated>2009-02-22T03:48:26.257Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/>
+ <title type="text">Document Permission - user2@google.com</title>
+ <link rel="self" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZp4pwUwUQ/user%3Auser2%40google.com"/>
+ <link rel="edit" type="application/atom+xml" href="http://docs.google.com/feeds/acl/private/full/spreadsheet%3ApFrmMi8feTQYCgZp4pwUwUQ/user%3Auser2%40google.com"/>
+ <gAcl:role value="writer"/>
+ <gAcl:scope type="domain" value="google.com"/>
+</entry>
+</feed>"""
+
+DOCUMENT_LIST_REVISION_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
+ xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005"
+ xmlns:docs="http://schemas.google.com/docs/2007"
+ gd:etag="W/"CE4HQX08cCt7ImA9WxNTFEU."">
+<id>https://docs.google.com/feeds/default/private/full/resource_id/revisions</id>
+<updated>2009-08-17T04:22:10.378Z</updated>
+<title>Document Revisions</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml"
+ href="https://docs.google.com/feeds/default/private/full/resource_id/revisions"/>
+<link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml"
+ href="https://docs.google.com/feeds/default/private/full/resource_id/revisions/batch"/>
+<link rel="self" type="application/atom+xml"
+ href="https://docs.google.com/feeds/default/private/full/resource_id/revisions"/>
+<openSearch:totalResults>6</openSearch:totalResults>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+ <id>https://docs.google.com/feeds/id/resource_id/revisions/2</id>
+ <updated>2009-08-17T04:22:10.440Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-08-14T07:11:34.197Z</app:edited>
+ <title>Revision 2</title>
+ <content type="text/html" src="https://docs.google.com/feeds/download/documents/Export?docId=doc_id&revision=2"/>
+ <link rel="alternate" type="text/html"
+ href="https://docs.google.com/Doc?id=doc_id&revision=2"/>
+ <link rel="self" type="application/atom+xml"
+ href="https://docs.google.com/feeds/default/private/full/resource_id/revisions/2"/>
+ <link rel='http://schemas.google.com/docs/2007#publish' type='text/html' href='https://docs.google.com/View?docid=dfr4&pageview=1&hgd=1'/>
+ <author>
+ <name>another_user</name>
+ <email>another_user@gmail.com</email>
+ </author>
+ <docs:publish value="true"/>
+ <docs:publishAuto value="true"/>
+ <docs:publishOutsideDomain value="false"/>
+</entry>
+</feed>
+"""
+
+DOCUMENT_LIST_METADATA = """
+<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:docs="http://schemas.google.com/docs/2007"
+ xmlns:gd="http://schemas.google.com/g/2005"
+ xmlns:gAcl="http://schemas.google.com/acl/2007"
+ gd:etag="W/"AkYNRnc_eSt7ImA9WxBUFks."">
+ <docs:additionalRoleInfo kind='document'>
+ <docs:additionalRoleSet primaryRole='reader'>
+ <gAcl:additionalRole value='commenter' />
+ </docs:additionalRoleSet>
+ </docs:additionalRoleInfo>
+</entry>
+"""
+
+BATCH_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:batch="http://schemas.google.com/gdata/batch"
+ xmlns:g="http://base.google.com/ns/1.0">
+ <id>http://www.google.com/base/feeds/items/2173859253842813008</id>
+ <published>2006-07-11T14:51:43.560Z</published>
+ <updated>2006-07-11T14:51: 43.560Z</updated>
+ <title type="text">title</title>
+ <content type="html">content</content>
+ <link rel="self"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/2173859253842813008"/>
+ <link rel="edit"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/2173859253842813008"/>
+ <g:item_type>recipes</g:item_type>
+ <batch:operation type="insert"/>
+ <batch:id>itemB</batch:id>
+ <batch:status code="201" reason="Created"/>
+</entry>"""
+
+BATCH_FEED_REQUEST = """<?xml version="1.0" encoding="UTF-8"?>
+<feed
+ xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:g="http://base.google.com/ns/1.0"
+ xmlns:batch="http://schemas.google.com/gdata/batch">
+ <title type="text">My Batch Feed</title>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/13308004346459454600</id>
+ <batch:operation type="delete"/>
+ </entry>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/17437536661927313949</id>
+ <batch:operation type="delete"/>
+ </entry>
+ <entry>
+ <title type="text">...</title>
+ <content type="html">...</content>
+ <batch:id>itemA</batch:id>
+ <batch:operation type="insert"/>
+ <g:item_type>recipes</g:item_type>
+ </entry>
+ <entry>
+ <title type="text">...</title>
+ <content type="html">...</content>
+ <batch:id>itemB</batch:id>
+ <batch:operation type="insert"/>
+ <g:item_type>recipes</g:item_type>
+ </entry>
+</feed>"""
+
+BATCH_FEED_RESULT = """<?xml version="1.0" encoding="UTF-8"?>
+<feed
+ xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:g="http://base.google.com/ns/1.0"
+ xmlns:batch="http://schemas.google.com/gdata/batch">
+ <id>http://www.google.com/base/feeds/items</id>
+ <updated>2006-07-11T14:51:42.894Z</updated>
+ <title type="text">My Batch</title>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items"/>
+ <link rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items"/>
+ <link rel=" http://schemas.google.com/g/2005#batch"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/batch"/>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/2173859253842813008</id>
+ <published>2006-07-11T14:51:43.560Z</published>
+ <updated>2006-07-11T14:51: 43.560Z</updated>
+ <title type="text">...</title>
+ <content type="html">...</content>
+ <link rel="self"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/2173859253842813008"/>
+ <link rel="edit"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/2173859253842813008"/>
+ <g:item_type>recipes</g:item_type>
+ <batch:operation type="insert"/>
+ <batch:id>itemB</batch:id>
+ <batch:status code="201" reason="Created"/>
+ </entry>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/11974645606383737963</id>
+ <published>2006-07-11T14:51:43.247Z</published>
+ <updated>2006-07-11T14:51: 43.247Z</updated>
+ <title type="text">...</title>
+ <content type="html">...</content>
+ <link rel="self"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/11974645606383737963"/>
+ <link rel="edit"
+ type="application/atom+xml"
+ href="http://www.google.com/base/feeds/items/11974645606383737963"/>
+ <g:item_type>recipes</g:item_type>
+ <batch:operation type="insert"/>
+ <batch:id>itemA</batch:id>
+ <batch:status code="201" reason="Created"/>
+ </entry>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/13308004346459454600</id>
+ <updated>2006-07-11T14:51:42.894Z</updated>
+ <title type="text">Error</title>
+ <content type="text">Bad request</content>
+ <batch:status code="404"
+ reason="Bad request"
+ content-type="application/xml">
+ <errors>
+ <error type="request" reason="Cannot find item"/>
+ </errors>
+ </batch:status>
+ </entry>
+ <entry>
+ <id>http://www.google.com/base/feeds/items/17437536661927313949</id>
+ <updated>2006-07-11T14:51:43.246Z</updated>
+ <content type="text">Deleted</content>
+ <batch:operation type="delete"/>
+ <batch:status code="200" reason="Success"/>
+ </entry>
+</feed>"""
+
+ALBUM_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:exif="http://schemas.google.com/photos/exif/2007" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#" xmlns:gml="http://www.opengis.net/gml" xmlns:georss="http://www.georss.org/georss" xmlns:photo="http://www.pheed.com/pheed/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gphoto="http://schemas.google.com/photos/2007">
+ <id>http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/1</id>
+ <updated>2007-09-21T18:23:05.000Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/photos/2007#album"/>
+ <title type="text">Test</title>
+ <subtitle type="text"/>
+ <rights type="text">public</rights>
+ <icon>http://lh6.google.com/sample.user/Rt8WNoDZEJE/AAAAAAAAABk/HQGlDhpIgWo/s160-c/Test.jpg</icon>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/1"/>
+ <link rel="alternate" type="text/html" href="http://picasaweb.google.com/sample.user/Test"/>
+ <link rel="http://schemas.google.com/photos/2007#slideshow" type="application/x-shockwave-flash" href="http://picasaweb.google.com/s/c/bin/slideshow.swf?host=picasaweb.google.com&RGB=0x000000&feed=http%3A%2F%2Fpicasaweb.google.com%2Fdata%2Ffeed%2Fapi%2Fuser%2Fsample.user%2Falbumid%2F1%3Falt%3Drss"/>
+ <link rel="self" type="application/atom+xml" href="http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/1?start-index=1&max-results=500&kind=photo%2Ctag"/>
+ <author>
+ <name>sample</name>
+ <uri>http://picasaweb.google.com/sample.user</uri>
+ </author>
+ <generator version="1.00" uri="http://picasaweb.google.com/">Picasaweb</generator> <openSearch:totalResults>4</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>500</openSearch:itemsPerPage>
+ <gphoto:id>1</gphoto:id>
+ <gphoto:name>Test</gphoto:name>
+ <gphoto:location/>
+ <gphoto:access>public</gphoto:access> <gphoto:timestamp>1188975600000</gphoto:timestamp>
+ <gphoto:numphotos>2</gphoto:numphotos>
+ <gphoto:user>sample.user</gphoto:user>
+ <gphoto:nickname>sample</gphoto:nickname>
+ <gphoto:commentingEnabled>true</gphoto:commentingEnabled>
+ <gphoto:commentCount>0</gphoto:commentCount>
+ <entry> <id>http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/photoid/2</id>
+ <published>2007-09-05T20:49:23.000Z</published>
+ <updated>2007-09-21T18:23:05.000Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/photos/2007#photo"/>
+ <title type="text">Aqua Blue.jpg</title>
+ <summary type="text">Blue</summary>
+ <content type="image/jpeg" src="http://lh4.google.com/sample.user/Rt8WU4DZEKI/AAAAAAAAABY/IVgLqmnzJII/Aqua%20Blue.jpg"/> <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/1/photoid/2"/>
+ <link rel="alternate" type="text/html" href="http://picasaweb.google.com/sample.user/Test/photo#2"/>
+ <link rel="self" type="application/atom+xml" href="http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/photoid/2"/>
+ <gphoto:id>2</gphoto:id>
+ <gphoto:version>1190398985145172</gphoto:version>
+ <gphoto:position>0.0</gphoto:position>
+ <gphoto:albumid>1</gphoto:albumid> <gphoto:width>2560</gphoto:width>
+ <gphoto:height>1600</gphoto:height>
+ <gphoto:size>883405</gphoto:size>
+ <gphoto:client/>
+ <gphoto:checksum/>
+ <gphoto:timestamp>1189025362000</gphoto:timestamp>
+ <exif:tags> <exif:flash>true</exif:flash>
+ <exif:imageUniqueID>c041ce17aaa637eb656c81d9cf526c24</exif:imageUniqueID>
+ </exif:tags>
+ <gphoto:commentingEnabled>true</gphoto:commentingEnabled>
+ <gphoto:commentCount>1</gphoto:commentCount>
+ <media:group>
+ <media:title type="plain">Aqua Blue.jpg</media:title> <media:description type="plain">Blue</media:description>
+ <media:keywords>tag, test</media:keywords>
+ <media:content url="http://lh4.google.com/sample.user/Rt8WU4DZEKI/AAAAAAAAABY/IVgLqmnzJII/Aqua%20Blue.jpg" height="1600" width="2560" type="image/jpeg" medium="image"/>
+ <media:thumbnail url="http://lh4.google.com/sample.user/Rt8WU4DZEKI/AAAAAAAAABY/IVgLqmnzJII/s72/Aqua%20Blue.jpg" height="45" width="72"/>
+ <media:thumbnail url="http://lh4.google.com/sample.user/Rt8WU4DZEKI/AAAAAAAAABY/IVgLqmnzJII/s144/Aqua%20Blue.jpg" height="90" width="144"/>
+ <media:thumbnail url="http://lh4.google.com/sample.user/Rt8WU4DZEKI/AAAAAAAAABY/IVgLqmnzJII/s288/Aqua%20Blue.jpg" height="180" width="288"/>
+ <media:credit>sample</media:credit>
+ </media:group>
+ </entry>
+ <entry>
+ <id>http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/photoid/3</id>
+ <published>2007-09-05T20:49:24.000Z</published>
+ <updated>2007-09-21T18:19:38.000Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/photos/2007#photo"/>
+ <title type="text">Aqua Graphite.jpg</title>
+ <summary type="text">Gray</summary>
+ <content type="image/jpeg" src="http://lh5.google.com/sample.user/Rt8WVIDZELI/AAAAAAAAABg/d7e0i7gvhNU/Aqua%20Graphite.jpg"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/1/photoid/3"/>
+ <link rel="alternate" type="text/html" href="http://picasaweb.google.com/sample.user/Test/photo#3"/>
+ <link rel="self" type="application/atom+xml" href="http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/photoid/3"/>
+ <gphoto:id>3</gphoto:id>
+ <gphoto:version>1190398778006402</gphoto:version>
+ <gphoto:position>1.0</gphoto:position>
+ <gphoto:albumid>1</gphoto:albumid>
+ <gphoto:width>2560</gphoto:width>
+ <gphoto:height>1600</gphoto:height>
+ <gphoto:size>798334</gphoto:size>
+ <gphoto:client/>
+ <gphoto:checksum/>
+ <gphoto:timestamp>1189025363000</gphoto:timestamp>
+ <exif:tags>
+ <exif:flash>true</exif:flash>
+ <exif:imageUniqueID>a5ce2e36b9df7d3cb081511c72e73926</exif:imageUniqueID>
+ </exif:tags>
+ <gphoto:commentingEnabled>true</gphoto:commentingEnabled>
+ <gphoto:commentCount>0</gphoto:commentCount>
+ <media:group>
+ <media:title type="plain">Aqua Graphite.jpg</media:title>
+ <media:description type="plain">Gray</media:description>
+ <media:keywords/>
+ <media:content url="http://lh5.google.com/sample.user/Rt8WVIDZELI/AAAAAAAAABg/d7e0i7gvhNU/Aqua%20Graphite.jpg" height="1600" width="2560" type="image/jpeg" medium="image"/>
+ <media:thumbnail url="http://lh5.google.com/sample.user/Rt8WVIDZELI/AAAAAAAAABg/d7e0i7gvhNU/s72/Aqua%20Graphite.jpg" height="45" width="72"/>
+ <media:thumbnail url="http://lh5.google.com/sample.user/Rt8WVIDZELI/AAAAAAAAABg/d7e0i7gvhNU/s144/Aqua%20Graphite.jpg" height="90" width="144"/>
+ <media:thumbnail url="http://lh5.google.com/sample.user/Rt8WVIDZELI/AAAAAAAAABg/d7e0i7gvhNU/s288/Aqua%20Graphite.jpg" height="180" width="288"/>
+ <media:credit>sample</media:credit>
+ </media:group>
+ </entry>
+ <entry>
+ <id>http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/tag/tag</id>
+ <updated>2007-09-05T20:49:24.000Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/photos/2007#tag"/>
+ <title type="text">tag</title>
+ <summary type="text">tag</summary>
+ <link rel="alternate" type="text/html" href="http://picasaweb.google.com/lh/searchbrowse?q=tag&psc=G&uname=sample.user&filter=0"/>
+ <link rel="self" type="application/atom+xml" href="http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/tag/tag"/>
+ <author>
+ <name>sample</name>
+ <uri>http://picasaweb.google.com/sample.user</uri>
+ </author>
+ </entry>
+ <entry>
+ <id>http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/tag/test</id>
+ <updated>2007-09-05T20:49:24.000Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/photos/2007#tag"/>
+ <title type="text">test</title>
+ <summary type="text">test</summary>
+ <link rel="alternate" type="text/html" href="http://picasaweb.google.com/lh/searchbrowse?q=test&psc=G&uname=sample.user&filter=0"/>
+ <link rel="self" type="application/atom+xml" href="http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/tag/test"/>
+ <author>
+ <name>sample</name>
+ <uri>http://picasaweb.google.com/sample.user</uri>
+ </author>
+ </entry>
+</feed>"""
+
+CODE_SEARCH_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:gcs="http://schemas.google.com/codesearch/2006" xml:base="http://www.google.com">
+<id>http://www.google.com/codesearch/feeds/search?q=malloc</id>
+<updated>2007-12-19T16:08:04Z</updated>
+<title type="text">Google Code Search</title>
+<generator version="1.0" uri="http://www.google.com/codesearch">Google Code Search</generator>
+<opensearch:totalResults>2530000</opensearch:totalResults>
+<opensearch:startIndex>1</opensearch:startIndex>
+<author>
+<name>Google Code Search</name>
+
+<uri>http://www.google.com/codesearch</uri>
+</author>
+<link rel="http://schemas.google.com/g/2006#feed" type="application/atom+xml" href="http://schemas.google.com/codesearch/2006"/>
+<link rel="self" type="application/atom+xml" href="http://www.google.com/codesearch/feeds/search?q=malloc"/>
+<link rel="next" type="application/atom+xml" href="http://www.google.com/codesearch/feeds/search?q=malloc&start-index=11"/>
+<link rel="alternate" type="text/html" href="http://www.google.com/codesearch?q=malloc"/>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:LDjwp-Iqc7U:84hEYaYsZk8:xDGReDhvNi0&sa=N&ct=rx&cd=1&cs_p=http://www.gnu.org&cs_f=software/autoconf/manual/autoconf-2.60/autoconf.html-002&cs_p=http://www.gnu.org&cs_f=software/autoconf/manual/autoconf-2.60/autoconf.html-002#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">software/autoconf/manual/autoconf-2.60/autoconf.html</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:LDjwp-Iqc7U:84hEYaYsZk8:xDGReDhvNi0&sa=N&ct=rx&cd=1&cs_p=http://www.gnu.org&cs_f=software/autoconf/manual/autoconf-2.60/autoconf.html-002&cs_p=http://www.gnu.org&cs_f=software/autoconf/manual/autoconf-2.60/autoconf.html-002#first"/><gcs:package name="http://www.gnu.org" uri="http://www.gnu.org"></gcs:package><gcs:file name="software/autoconf/manual/autoconf-2.60/autoconf.html-002"></gcs:file><content type="text/html"><pre> 8: void *<b>malloc</b> ();
+
+
+</pre></content><gcs:match lineNumber="4" type="text/html"><pre> #undef <b>malloc</b>
+</pre></gcs:match><gcs:match lineNumber="8" type="text/html"><pre> void *<b>malloc</b> ();
+
+</pre></gcs:match><gcs:match lineNumber="14" type="text/html"><pre> rpl_<b>malloc</b> (size_t n)
+</pre></gcs:match><gcs:match lineNumber="18" type="text/html"><pre> return <b>malloc</b> (n);
+
+</pre></gcs:match></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:h4hfh-fV-jI:niBq_bwWZNs:H0OhClf0HWQ&sa=N&ct=rx&cd=2&cs_p=ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz&cs_f=guile-1.6.8/libguile/mallocs.c&cs_p=ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz&cs_f=guile-1.6.8/libguile/mallocs.c#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">guile-1.6.8/libguile/mallocs.c</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:h4hfh-fV-jI:niBq_bwWZNs:H0OhClf0HWQ&sa=N&ct=rx&cd=2&cs_p=ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz&cs_f=guile-1.6.8/libguile/mallocs.c&cs_p=ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz&cs_f=guile-1.6.8/libguile/mallocs.c#first"/><gcs:package name="ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz" uri="ftp://ftp.gnu.org/gnu/guile/guile-1.6.8.tar.gz"></gcs:package><gcs:file name="guile-1.6.8/libguile/mallocs.c"></gcs:file><content type="text/html"><pre> 86: {
+ scm_t_bits mem = n ? (scm_t_bits) <b>malloc</b> (n) : 0;
+ if (n &amp;&amp; !mem)
+
+</pre></content><gcs:match lineNumber="54" type="text/html"><pre>#include &lt;<b>malloc</b>.h&gt;
+</pre></gcs:match><gcs:match lineNumber="62" type="text/html"><pre>scm_t_bits scm_tc16_<b>malloc</b>;
+
+</pre></gcs:match><gcs:match lineNumber="66" type="text/html"><pre><b>malloc</b>_free (SCM ptr)
+</pre></gcs:match><gcs:match lineNumber="75" type="text/html"><pre><b>malloc</b>_print (SCM exp, SCM port, scm_print_state *pstate SCM_UNUSED)
+
+</pre></gcs:match><gcs:match lineNumber="77" type="text/html"><pre> scm_puts(&quot;#&lt;<b>malloc</b> &quot;, port);
+</pre></gcs:match><gcs:match lineNumber="87" type="text/html"><pre> scm_t_bits mem = n ? (scm_t_bits) <b>malloc</b> (n) : 0;
+
+</pre></gcs:match><gcs:match lineNumber="90" type="text/html"><pre> SCM_RETURN_NEWSMOB (scm_tc16_<b>malloc</b>, mem);
+</pre></gcs:match><gcs:match lineNumber="98" type="text/html"><pre> scm_tc16_<b>malloc</b> = scm_make_smob_type (&quot;<b>malloc</b>&quot;, 0);
+
+</pre></gcs:match><gcs:match lineNumber="99" type="text/html"><pre> scm_set_smob_free (scm_tc16_<b>malloc</b>, <b>malloc</b>_free);
+</pre></gcs:match><rights>GPL</rights></entry>
+
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:9wyZUG-N_30:7_dFxoC1ZrY:C0_iYbFj90M&sa=N&ct=rx&cd=3&cs_p=http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz&cs_f=bash-3.0/lib/malloc/alloca.c&cs_p=http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz&cs_f=bash-3.0/lib/malloc/alloca.c#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">bash-3.0/lib/malloc/alloca.c</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:9wyZUG-N_30:7_dFxoC1ZrY:C0_iYbFj90M&sa=N&ct=rx&cd=3&cs_p=http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz&cs_f=bash-3.0/lib/malloc/alloca.c&cs_p=http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz&cs_f=bash-3.0/lib/malloc/alloca.c#first"/><gcs:package name="http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz" uri="http://ftp.gnu.org/gnu/bash/bash-3.0.tar.gz"></gcs:package><gcs:file name="bash-3.0/lib/malloc/alloca.c"></gcs:file><content type="text/html"><pre> 78: #ifndef emacs
+ #define <b>malloc</b> x<b>malloc</b>
+ extern pointer x<b>malloc</b> ();
+
+</pre></content><gcs:match lineNumber="69" type="text/html"><pre> <b>malloc</b>. The Emacs executable needs alloca to call x<b>malloc</b>, because
+</pre></gcs:match><gcs:match lineNumber="70" type="text/html"><pre> ordinary <b>malloc</b> isn&#39;t protected from input signals. On the other
+
+</pre></gcs:match><gcs:match lineNumber="71" type="text/html"><pre> hand, the utilities in lib-src need alloca to call <b>malloc</b>; some of
+</pre></gcs:match><gcs:match lineNumber="72" type="text/html"><pre> them are very simple, and don&#39;t have an x<b>malloc</b> routine.
+
+</pre></gcs:match><gcs:match lineNumber="76" type="text/html"><pre> Callers below should use <b>malloc</b>. */
+</pre></gcs:match><gcs:match lineNumber="79" type="text/html"><pre>#define <b>malloc</b> x<b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="80" type="text/html"><pre>extern pointer x<b>malloc</b> ();
+</pre></gcs:match><gcs:match lineNumber="132" type="text/html"><pre> It is very important that sizeof(header) agree with <b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="198" type="text/html"><pre> register pointer new = <b>malloc</b> (sizeof (header) + size);
+</pre></gcs:match><rights>GPL</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:uhVCKyPcT6k:8juMxxzmUJw:H7_IDsTB2L4&sa=N&ct=rx&cd=4&cs_p=http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2&cs_f=mozilla/xpcom/build/malloc.c&cs_p=http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2&cs_f=mozilla/xpcom/build/malloc.c#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">mozilla/xpcom/build/malloc.c</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:uhVCKyPcT6k:8juMxxzmUJw:H7_IDsTB2L4&sa=N&ct=rx&cd=4&cs_p=http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2&cs_f=mozilla/xpcom/build/malloc.c&cs_p=http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2&cs_f=mozilla/xpcom/build/malloc.c#first"/><gcs:package name="http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2" uri="http://ftp.mozilla.org/pub/mozilla.org/mozilla/releases/mozilla1.7b/src/mozilla-source-1.7b-source.tar.bz2"></gcs:package><gcs:file name="mozilla/xpcom/build/malloc.c"></gcs:file><content type="text/html"><pre> 54: http://gee.cs.oswego.edu/dl/html/<b>malloc</b>.html
+
+ You may already by default be using a c library containing a <b>malloc</b>
+
+</pre></content><gcs:match lineNumber="4" type="text/html"><pre>/* ---------- To make a <b>malloc</b>.h, start cutting here ------------ */
+</pre></gcs:match><gcs:match lineNumber="22" type="text/html"><pre> Note: There may be an updated version of this <b>malloc</b> obtainable at
+
+</pre></gcs:match><gcs:match lineNumber="23" type="text/html"><pre> ftp://gee.cs.oswego.edu/pub/misc/<b>malloc</b>.c
+</pre></gcs:match><gcs:match lineNumber="34" type="text/html"><pre>* Why use this <b>malloc</b>?
+
+</pre></gcs:match><gcs:match lineNumber="37" type="text/html"><pre> most tunable <b>malloc</b> ever written. However it is among the fastest
+</pre></gcs:match><gcs:match lineNumber="40" type="text/html"><pre> allocator for <b>malloc</b>-intensive programs.
+
+</pre></gcs:match><gcs:match lineNumber="54" type="text/html"><pre> http://gee.cs.oswego.edu/dl/html/<b>malloc</b>.html
+</pre></gcs:match><gcs:match lineNumber="56" type="text/html"><pre> You may already by default be using a c library containing a <b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="57" type="text/html"><pre> that is somehow based on some version of this <b>malloc</b> (for example in
+</pre></gcs:match><rights>Mozilla</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:4n1P2HVOISs:Ybbpph0wR2M:OhIN_sDrG0U&sa=N&ct=rx&cd=5&cs_p=http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz&cs_f=hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh&cs_p=http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz&cs_f=hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:4n1P2HVOISs:Ybbpph0wR2M:OhIN_sDrG0U&sa=N&ct=rx&cd=5&cs_p=http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz&cs_f=hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh&cs_p=http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz&cs_f=hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh#first"/><gcs:package name="http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz" uri="http://regexps.srparish.net/src/hackerlab/hackerlab-1.0pre2.tar.gz"></gcs:package><gcs:file name="hackerlab-1.0pre2/src/hackerlab/tests/mem-tests/unit-must-malloc.sh"></gcs:file><content type="text/html"><pre> 11: echo ================ unit-must-<b>malloc</b> tests ================
+ ./unit-must-<b>malloc</b>
+ echo ...passed
+
+</pre></content><gcs:match lineNumber="2" type="text/html"><pre># tag: Tom Lord Tue Dec 4 14:54:29 2001 (mem-tests/unit-must-<b>malloc</b>.sh)
+</pre></gcs:match><gcs:match lineNumber="11" type="text/html"><pre>echo ================ unit-must-<b>malloc</b> tests ================
+
+</pre></gcs:match><gcs:match lineNumber="12" type="text/html"><pre>./unit-must-<b>malloc</b>
+</pre></gcs:match><rights>GPL</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:GzkwiWG266M:ykuz3bG00ws:2sTvVSif08g&sa=N&ct=rx&cd=6&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2&cs_f=tar-1.14/lib/malloc.c&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2&cs_f=tar-1.14/lib/malloc.c#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">tar-1.14/lib/malloc.c</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:GzkwiWG266M:ykuz3bG00ws:2sTvVSif08g&sa=N&ct=rx&cd=6&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2&cs_f=tar-1.14/lib/malloc.c&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2&cs_f=tar-1.14/lib/malloc.c#first"/><gcs:package name="http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2" uri="http://ftp.gnu.org/gnu/tar/tar-1.14.tar.bz2"></gcs:package><gcs:file name="tar-1.14/lib/malloc.c"></gcs:file><content type="text/html"><pre> 22: #endif
+ #undef <b>malloc</b>
+
+
+</pre></content><gcs:match lineNumber="1" type="text/html"><pre>/* Work around bug on some systems where <b>malloc</b> (0) fails.
+</pre></gcs:match><gcs:match lineNumber="23" type="text/html"><pre>#undef <b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="31" type="text/html"><pre>rpl_<b>malloc</b> (size_t n)
+</pre></gcs:match><gcs:match lineNumber="35" type="text/html"><pre> return <b>malloc</b> (n);
+
+</pre></gcs:match><rights>GPL</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:o_TFIeBY6dY:ktI_dt8wPao:AI03BD1Dz0Y&sa=N&ct=rx&cd=7&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz&cs_f=tar-1.16.1/lib/malloc.c&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz&cs_f=tar-1.16.1/lib/malloc.c#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">tar-1.16.1/lib/malloc.c</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:o_TFIeBY6dY:ktI_dt8wPao:AI03BD1Dz0Y&sa=N&ct=rx&cd=7&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz&cs_f=tar-1.16.1/lib/malloc.c&cs_p=http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz&cs_f=tar-1.16.1/lib/malloc.c#first"/><gcs:package name="http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz" uri="http://ftp.gnu.org/gnu/tar/tar-1.16.1.tar.gz"></gcs:package><gcs:file name="tar-1.16.1/lib/malloc.c"></gcs:file><content type="text/html"><pre> 21: #include &lt;config.h&gt;
+ #undef <b>malloc</b>
+
+
+</pre></content><gcs:match lineNumber="1" type="text/html"><pre>/* <b>malloc</b>() function that is glibc compatible.
+</pre></gcs:match><gcs:match lineNumber="22" type="text/html"><pre>#undef <b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="30" type="text/html"><pre>rpl_<b>malloc</b> (size_t n)
+</pre></gcs:match><gcs:match lineNumber="34" type="text/html"><pre> return <b>malloc</b> (n);
+
+</pre></gcs:match><rights>GPL</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:_ibw-VLkMoI:jBOtIJSmFd4:-0NUEVeCwfY&sa=N&ct=rx&cd=8&cs_p=http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2&cs_f=uClibc-0.9.29/include/malloc.h&cs_p=http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2&cs_f=uClibc-0.9.29/include/malloc.h#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">uClibc-0.9.29/include/malloc.h</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:_ibw-VLkMoI:jBOtIJSmFd4:-0NUEVeCwfY&sa=N&ct=rx&cd=8&cs_p=http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2&cs_f=uClibc-0.9.29/include/malloc.h&cs_p=http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2&cs_f=uClibc-0.9.29/include/malloc.h#first"/><gcs:package name="http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2" uri="http://freshmeat.net/redir/uclibc/20616/url_bz2/uClibc-0.9.28.1.tar.bz2"></gcs:package><gcs:file name="uClibc-0.9.29/include/malloc.h"></gcs:file><content type="text/html"><pre> 1: /* Prototypes and definition for <b>malloc</b> implementation.
+ Copyright (C) 1996, 1997, 1999, 2000 Free Software Foundation, Inc.
+
+</pre></content><gcs:match lineNumber="1" type="text/html"><pre>/* Prototypes and definition for <b>malloc</b> implementation.
+</pre></gcs:match><gcs:match lineNumber="26" type="text/html"><pre> `pt<b>malloc</b>&#39;, a <b>malloc</b> implementation for multiple threads without
+
+</pre></gcs:match><gcs:match lineNumber="28" type="text/html"><pre> See the files `pt<b>malloc</b>.c&#39; or `COPYRIGHT&#39; for copying conditions.
+</pre></gcs:match><gcs:match lineNumber="32" type="text/html"><pre> This work is mainly derived from <b>malloc</b>-2.6.4 by Doug Lea
+
+</pre></gcs:match><gcs:match lineNumber="35" type="text/html"><pre> ftp://g.oswego.edu/pub/misc/<b>malloc</b>.c
+</pre></gcs:match><gcs:match lineNumber="40" type="text/html"><pre> `pt<b>malloc</b>.c&#39;.
+
+</pre></gcs:match><gcs:match lineNumber="45" type="text/html"><pre># define __<b>malloc</b>_ptr_t void *
+</pre></gcs:match><gcs:match lineNumber="51" type="text/html"><pre># define __<b>malloc</b>_ptr_t char *
+
+</pre></gcs:match><gcs:match lineNumber="56" type="text/html"><pre># define __<b>malloc</b>_size_t size_t
+</pre></gcs:match><rights>LGPL</rights></entry>
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:F6qHcZ9vefo:bTX7o9gKfks:hECF4r_eKC0&sa=N&ct=rx&cd=9&cs_p=http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz&cs_f=glibc-2.0.1/hurd/hurdmalloc.h&cs_p=http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz&cs_f=glibc-2.0.1/hurd/hurdmalloc.h#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">glibc-2.0.1/hurd/hurdmalloc.h</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:F6qHcZ9vefo:bTX7o9gKfks:hECF4r_eKC0&sa=N&ct=rx&cd=9&cs_p=http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz&cs_f=glibc-2.0.1/hurd/hurdmalloc.h&cs_p=http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz&cs_f=glibc-2.0.1/hurd/hurdmalloc.h#first"/><gcs:package name="http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz" uri="http://ftp.gnu.org/gnu/glibc/glibc-2.0.1.tar.gz"></gcs:package><gcs:file name="glibc-2.0.1/hurd/hurdmalloc.h"></gcs:file><content type="text/html"><pre> 15: #define <b>malloc</b> _hurd_<b>malloc</b>
+ #define realloc _hurd_realloc
+
+</pre></content><gcs:match lineNumber="3" type="text/html"><pre> All hurd-internal code which uses <b>malloc</b> et al includes this file so it
+</pre></gcs:match><gcs:match lineNumber="4" type="text/html"><pre> will use the internal <b>malloc</b> routines _hurd_{<b>malloc</b>,realloc,free}
+
+</pre></gcs:match><gcs:match lineNumber="7" type="text/html"><pre> of <b>malloc</b> et al is the unixoid one using sbrk.
+</pre></gcs:match><gcs:match lineNumber="11" type="text/html"><pre>extern void *_hurd_<b>malloc</b> (size_t);
+
+</pre></gcs:match><gcs:match lineNumber="15" type="text/html"><pre>#define <b>malloc</b> _hurd_<b>malloc</b>
+</pre></gcs:match><rights>GPL</rights></entry>
+
+<entry><id>http://www.google.com/codesearch?hl=en&q=+malloc+show:CHUvHYzyLc8:pdcAfzDA6lY:wjofHuNLTHg&sa=N&ct=rx&cd=10&cs_p=ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2&cs_f=httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h&cs_p=ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2&cs_f=httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h#first</id><updated>2007-12-19T16:08:04Z</updated><author><name>Code owned by external author.</name></author><title type="text">httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h</title><link rel="alternate" type="text/html" href="http://www.google.com/codesearch?hl=en&q=+malloc+show:CHUvHYzyLc8:pdcAfzDA6lY:wjofHuNLTHg&sa=N&ct=rx&cd=10&cs_p=ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2&cs_f=httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h&cs_p=ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2&cs_f=httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h#first"/><gcs:package name="ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2" uri="ftp://apache.mirrors.pair.com/httpd/httpd-2.2.4.tar.bz2"></gcs:package><gcs:file name="httpd-2.2.4/srclib/apr/include/arch/netware/apr_private.h"></gcs:file><content type="text/html"><pre> 173: #undef <b>malloc</b>
+ #define <b>malloc</b>(x) library_<b>malloc</b>(gLibHandle,x)
+
+</pre></content><gcs:match lineNumber="170" type="text/html"><pre>/* Redefine <b>malloc</b> to use the library <b>malloc</b> call so
+</pre></gcs:match><gcs:match lineNumber="173" type="text/html"><pre>#undef <b>malloc</b>
+
+</pre></gcs:match><gcs:match lineNumber="174" type="text/html"><pre>#define <b>malloc</b>(x) library_<b>malloc</b>(gLibHandle,x)
+</pre></gcs:match><rights>Apache</rights></entry>
+
+</feed>"""
+
+YOUTUBE_VIDEO_FEED = """<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gml='http://www.opengis.net/gml' xmlns:georss='http://www.georss.org/georss' xmlns:media='http://search.yahoo.com/mrss/' xmlns:yt='http://gdata.youtube.com/schemas/2007' xmlns:gd='http://schemas.google.com/g/2005'><id>http://gdata.youtube.com/feeds/api/standardfeeds/top_rated</id><updated>2008-05-14T02:24:07.000-07:00</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#video'/><title type='text'>Top Rated</title><logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo><link rel='alternate' type='text/html' href='http://www.youtube.com/browse?s=tr'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/standardfeeds/top_rated'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/standardfeeds/top_rated?start-index=1&max-results=25'/><link rel='next' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/standardfeeds/top_rated?start-index=26&max-results=25'/><author><name>YouTube</name><uri>http://www.youtube.com/</uri></author><generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator><openSearch:totalResults>100</openSearch:totalResults><openSearch:startIndex>1</openSearch:startIndex><openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+<entry><id>http://gdata.youtube.com/feeds/api/videos/C71ypXYGho8</id><published>2008-03-20T10:17:27.000-07:00</published><updated>2008-05-14T04:26:37.000-07:00</updated><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='karyn'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='garcia'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='me'/><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#video'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='boyfriend'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='por'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='te'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='odeio'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='amar'/><category scheme='http://gdata.youtube.com/schemas/2007/categories.cat' term='Music' label='Music'/><title type='text'>Me odeio por te amar - KARYN GARCIA</title><content type='text'>http://www.karyngarcia.com.br</content><link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=C71ypXYGho8'/><link rel='http://gdata.youtube.com/schemas/2007#video.related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/C71ypXYGho8/related'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/standardfeeds/top_rated/C71ypXYGho8'/><author><name>TvKarynGarcia</name><uri>http://gdata.youtube.com/feeds/api/users/tvkaryngarcia</uri></author><media:group><media:title type='plain'>Me odeio por te amar - KARYN GARCIA</media:title><media:description type='plain'>http://www.karyngarcia.com.br</media:description><media:keywords>amar, boyfriend, garcia, karyn, me, odeio, por, te</media:keywords><yt:duration seconds='203'/><media:category label='Music' scheme='http://gdata.youtube.com/schemas/2007/categories.cat'>Music</media:category><media:category label='test111' scheme='http://gdata.youtube.com/schemas/2007/developertags.cat'>test111</media:category><media:category label='test222' scheme='http://gdata.youtube.com/schemas/2007/developertags.cat'>test222</media:category><media:content url='http://www.youtube.com/v/C71ypXYGho8' type='application/x-shockwave-flash' medium='video' isDefault='true' expression='full' duration='203' yt:format='5'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQmPhgZ2pXK9CxMYDSANFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='203' yt:format='1'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQmPhgZ2pXK9CxMYESARFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='203' yt:format='6'/><media:player url='http://www.youtube.com/watch?v=C71ypXYGho8'/><media:thumbnail url='http://img.youtube.com/vi/C71ypXYGho8/2.jpg' height='97' width='130' time='00:01:41.500'/><media:thumbnail url='http://img.youtube.com/vi/C71ypXYGho8/1.jpg' height='97' width='130' time='00:00:50.750'/><media:thumbnail url='http://img.youtube.com/vi/C71ypXYGho8/3.jpg' height='97' width='130' time='00:02:32.250'/><media:thumbnail url='http://img.youtube.com/vi/C71ypXYGho8/0.jpg' height='240' width='320' time='00:01:41.500'/></media:group><yt:statistics viewCount='138864' favoriteCount='2474'/><gd:rating min='1' max='5' numRaters='4626' average='4.95'/><gd:comments><gd:feedLink href='http://gdata.youtube.com/feeds/api/videos/C71ypXYGho8/comments' countHint='27'/></gd:comments></entry>
+<entry><id>http://gdata.youtube.com/feeds/api/videos/gsVaTyb1tBw</id><published>2008-02-15T04:31:45.000-08:00</published><updated>2008-05-14T05:09:42.000-07:00</updated><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='extreme'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='cam'/><category scheme='http://gdata.youtube.com/schemas/2007/categories.cat' term='Sports' label='Sports'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='alcala'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='kani'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='helmet'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='campillo'/><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#video'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='pato'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='dirt'/><title type='text'>extreme helmet cam Kani, Keil and Pato</title><content type='text'>trimmed</content><link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=gsVaTyb1tBw'/><link rel='http://gdata.youtube.com/schemas/2007#video.responses' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/gsVaTyb1tBw/responses'/><link rel='http://gdata.youtube.com/schemas/2007#video.related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/gsVaTyb1tBw/related'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/standardfeeds/recently_featured/gsVaTyb1tBw'/><author><name>peraltamagic</name><uri>http://gdata.youtube.com/feeds/api/users/peraltamagic</uri></author><media:group><media:title type='plain'>extreme helmet cam Kani, Keil and Pato</media:title><media:description type='plain'>trimmed</media:description><media:keywords>alcala, cam, campillo, dirt, extreme, helmet, kani, pato</media:keywords><yt:duration seconds='31'/><media:category label='Sports' scheme='http://gdata.youtube.com/schemas/2007/categories.cat'>Sports</media:category><media:content url='http://www.youtube.com/v/gsVaTyb1tBw' type='application/x-shockwave-flash' medium='video' isDefault='true' expression='full' duration='31' yt:format='5'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQkctPUmT1rFghMYDSANFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='31' yt:format='1'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQkctPUmT1rFghMYESARFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='31' yt:format='6'/><media:player url='http://www.youtube.com/watch?v=gsVaTyb1tBw'/><media:thumbnail url='http://img.youtube.com/vi/gsVaTyb1tBw/2.jpg' height='97' width='130' time='00:00:15.500'/><media:thumbnail url='http://img.youtube.com/vi/gsVaTyb1tBw/1.jpg' height='97' width='130' time='00:00:07.750'/><media:thumbnail url='http://img.youtube.com/vi/gsVaTyb1tBw/3.jpg' height='97' width='130' time='00:00:23.250'/><media:thumbnail url='http://img.youtube.com/vi/gsVaTyb1tBw/0.jpg' height='240' width='320' time='00:00:15.500'/></media:group><yt:statistics viewCount='489941' favoriteCount='561'/><gd:rating min='1' max='5' numRaters='1255' average='4.11'/><gd:comments><gd:feedLink href='http://gdata.youtube.com/feeds/api/videos/gsVaTyb1tBw/comments' countHint='1116'/></gd:comments></entry>
+</feed>"""
+
+YOUTUBE_ENTRY_PRIVATE = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:media='http://search.yahoo.com/mrss/'
+xmlns:gd='http://schemas.google.com/g/2005'
+xmlns:yt='http://gdata.youtube.com/schemas/2007'
+xmlns:gml='http://www.opengis.net/gml'
+xmlns:georss='http://www.georss.org/georss'
+xmlns:app='http://purl.org/atom/app#'>
+ <id>http://gdata.youtube.com/feeds/videos/UMFI1hdm96E</id>
+ <published>2007-01-07T01:50:15.000Z</published>
+ <updated>2007-01-07T01:50:15.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://gdata.youtube.com/schemas/2007#video' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='barkley' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='singing' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='acoustic' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='cover' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/categories.cat'
+ term='Music' label='Music' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='gnarls' />
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat'
+ term='music' />
+ <title type='text'>"Crazy (Gnarles Barkley)" - Acoustic Cover</title>
+ <content type='html'><div style="color: #000000;font-family:
+ Arial, Helvetica, sans-serif; font-size:12px; font-size: 12px;
+ width: 555px;"><table cellspacing="0" cellpadding="0"
+ border="0"><tbody><tr><td width="140"
+ valign="top" rowspan="2"><div style="border: 1px solid
+ #999999; margin: 0px 10px 5px 0px;"><a
+ href="http://www.youtube.com/watch?v=UMFI1hdm96E"><img
+ alt=""
+ src="http://img.youtube.com/vi/UMFI1hdm96E/2.jpg"></a></div></td>
+ <td width="256" valign="top"><div style="font-size:
+ 12px; font-weight: bold;"><a style="font-size: 15px;
+ font-weight: bold; font-decoration: none;"
+ href="http://www.youtube.com/watch?v=UMFI1hdm96E">&quot;Crazy
+ (Gnarles Barkley)&quot; - Acoustic Cover</a>
+ <br></div> <div style="font-size: 12px; margin:
+ 3px 0px;"><span>Gnarles Barkley acoustic cover
+ http://www.myspace.com/davidchoimusic</span></div></td>
+ <td style="font-size: 11px; line-height: 1.4em; padding-left:
+ 20px; padding-top: 1px;" width="146"
+ valign="top"><div><span style="color: #666666;
+ font-size: 11px;">From:</span> <a
+ href="http://www.youtube.com/profile?user=davidchoimusic">davidchoimusic</a></div>
+ <div><span style="color: #666666; font-size:
+ 11px;">Views:</span> 113321</div> <div
+ style="white-space: nowrap;text-align: left"><img
+ style="border: 0px none; margin: 0px; padding: 0px;
+ vertical-align: middle; font-size: 11px;" align="top" alt=""
+ src="http://gdata.youtube.com/static/images/icn_star_full_11x11.gif">
+ <img style="border: 0px none; margin: 0px; padding: 0px;
+ vertical-align: middle; font-size: 11px;" align="top" alt=""
+ src="http://gdata.youtube.com/static/images/icn_star_full_11x11.gif">
+ <img style="border: 0px none; margin: 0px; padding: 0px;
+ vertical-align: middle; font-size: 11px;" align="top" alt=""
+ src="http://gdata.youtube.com/static/images/icn_star_full_11x11.gif">
+ <img style="border: 0px none; margin: 0px; padding: 0px;
+ vertical-align: middle; font-size: 11px;" align="top" alt=""
+ src="http://gdata.youtube.com/static/images/icn_star_full_11x11.gif">
+ <img style="border: 0px none; margin: 0px; padding: 0px;
+ vertical-align: middle; font-size: 11px;" align="top" alt=""
+ src="http://gdata.youtube.com/static/images/icn_star_half_11x11.gif"></div>
+ <div style="font-size: 11px;">1005 <span style="color:
+ #666666; font-size:
+ 11px;">ratings</span></div></td></tr>
+ <tr><td><span style="color: #666666; font-size:
+ 11px;">Time:</span> <span style="color: #000000;
+ font-size: 11px; font-weight:
+ bold;">04:15</span></td> <td style="font-size:
+ 11px; padding-left: 20px;"><span style="color: #666666;
+ font-size: 11px;">More in</span> <a
+ href="http://www.youtube.com/categories_portal?c=10">Music</a></td></tr></tbody></table></div></content>
+ <link rel='self' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/videos/UMFI1hdm96E' />
+ <link rel='alternate' type='text/html'
+ href='http://www.youtube.com/watch?v=UMFI1hdm96E' />
+ <link rel='http://gdata.youtube.com/schemas/2007#video.responses'
+ type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/videos/UMFI1hdm96E/responses' />
+ <link rel='http://gdata.youtube.com/schemas/2007#video.related'
+ type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/videos/UMFI1hdm96E/related' />
+ <author>
+ <name>davidchoimusic</name>
+ <uri>http://gdata.youtube.com/feeds/users/davidchoimusic</uri>
+ </author>
+ <media:group>
+ <media:title type='plain'>"Crazy (Gnarles Barkley)" - Acoustic Cover</media:title>
+ <media:description type='plain'>Gnarles Barkley acoustic cover http://www.myspace.com/davidchoimusic</media:description>
+ <media:keywords>music, singing, gnarls, barkley, acoustic, cover</media:keywords>
+ <yt:duration seconds='255' />
+ <media:category label='Music'
+ scheme='http://gdata.youtube.com/schemas/2007/categories.cat'>
+ Music</media:category>
+ <media:category
+ scheme='http://gdata.youtube.com/schemas/2007/developertags.cat'>
+ DeveloperTag1</media:category>
+ <media:content url='http://www.youtube.com/v/UMFI1hdm96E'
+ type='application/x-shockwave-flash' medium='video'
+ isDefault='true' expression='full' duration='255'
+ yt:format='5' />
+ <media:player url='http://www.youtube.com/watch?v=UMFI1hdm96E' />
+ <media:thumbnail url='http://img.youtube.com/vi/UMFI1hdm96E/2.jpg'
+ height='97' width='130' time='00:02:07.500' />
+ <media:thumbnail url='http://img.youtube.com/vi/UMFI1hdm96E/1.jpg'
+ height='97' width='130' time='00:01:03.750' />
+ <media:thumbnail url='http://img.youtube.com/vi/UMFI1hdm96E/3.jpg'
+ height='97' width='130' time='00:03:11.250' />
+ <media:thumbnail url='http://img.youtube.com/vi/UMFI1hdm96E/0.jpg'
+ height='240' width='320' time='00:02:07.500' />
+ <yt:private />
+ </media:group>
+ <yt:statistics viewCount='113321' />
+ <gd:rating min='1' max='5' numRaters='1005' average='4.77' />
+ <georss:where>
+ <gml:Point>
+ <gml:pos>37.398529052734375 -122.0635986328125</gml:pos>
+ </gml:Point>
+ </georss:where>
+ <gd:comments>
+ <gd:feedLink href='http://gdata.youtube.com/feeds/videos/UMFI1hdm96E/comments' />
+ </gd:comments>
+ <yt:noembed />
+ <app:control>
+ <app:draft>yes</app:draft>
+ <yt:state
+ name="rejected"
+ reasonCode="inappropriate"
+ helpUrl="http://www.youtube.com/t/community_guidelines">
+ The content of this video may violate the terms of use.</yt:state>
+ </app:control>
+</entry>"""
+
+YOUTUBE_COMMENT_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'><id>http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments</id><updated>2008-05-19T21:45:45.261Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#comment'/><title type='text'>Comments</title><logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo><link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU'/><link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=2Idhz9ef5oU'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments?start-index=1&max-results=25'/><author><name>YouTube</name><uri>http://www.youtube.com/</uri></author><generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator><openSearch:totalResults>0</openSearch:totalResults><openSearch:startIndex>1</openSearch:startIndex><openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/91F809A3DE2EB81B</id>
+ <published>2008-02-22T15:27:15.000-08:00</published><updated>2008-02-22T15:27:15.000-08:00</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#comment'/>
+ <title type='text'>test66</title>
+ <content type='text'>test66</content>
+ <link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU'/>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=2Idhz9ef5oU'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/91F809A3DE2EB81B'/>
+ <author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author>
+ </entry>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/A261AEEFD23674AA</id>
+ <published>2008-02-22T15:27:01.000-08:00</published><updated>2008-02-22T15:27:01.000-08:00</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#comment'/>
+ <title type='text'>test333</title>
+ <content type='text'>test333</content>
+ <link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU'/>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=2Idhz9ef5oU'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/A261AEEFD23674AA'/>
+ <author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author>
+ </entry>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/0DCF1E3531B3FF85</id>
+ <published>2008-02-22T15:11:06.000-08:00</published><updated>2008-02-22T15:11:06.000-08:00</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#comment'/>
+ <title type='text'>test2</title>
+ <content type='text'>test2</content>
+ <link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU'/>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=2Idhz9ef5oU'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments/0DCF1E3531B3FF85'/>
+ <author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author>
+ </entry>
+</feed>"""
+
+YOUTUBE_PLAYLIST_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+ xmlns:media='http://search.yahoo.com/mrss/'
+ xmlns:yt='http://gdata.youtube.com/schemas/2007'
+ xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://gdata.youtube.com/feeds/users/andyland74/playlists?start-index=1&max-results=25</id>
+ <updated>2008-02-26T00:26:15.635Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#playlistLink'/>
+ <title type='text'>andyland74's Playlists</title>
+ <logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo>
+ <link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/andyland74'/>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/profile_play_list?user=andyland74'/>
+ <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/andyland74/playlists'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/andyland74/playlists?start-index=1&max-results=25'/>
+ <author>
+ <name>andyland74</name>
+ <uri>http://gdata.youtube.com/feeds/users/andyland74</uri>
+ </author>
+ <generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <yt:description>My new playlist Description</yt:description>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#playlist' href='http://gdata.youtube.com/feeds/playlists/8BCDD04DE8F771B2'/>
+ <id>http://gdata.youtube.com/feeds/users/andyland74/playlists/8BCDD04DE8F771B2</id>
+ <published>2007-11-04T17:30:27.000-08:00</published>
+ <updated>2008-02-22T09:55:14.000-08:00</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#playlistLink'/>
+ <title type='text'>My New Playlist Title</title>
+ <content type='text'>My new playlist Description</content>
+ <link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/andyland74'/>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/view_play_list?p=8BCDD04DE8F771B2'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/andyland74/playlists/8BCDD04DE8F771B2'/>
+ <author>
+ <name>andyland74</name>
+ <uri>http://gdata.youtube.com/feeds/users/andyland74</uri>
+ </author>
+ </entry>
+</feed>"""
+
+YOUTUBE_PLAYLIST_VIDEO_FEED = """<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gml='http://www.opengis.net/gml' xmlns:georss='http://www.georss.org/georss' xmlns:media='http://search.yahoo.com/mrss/' xmlns:yt='http://gdata.youtube.com/schemas/2007' xmlns:gd='http://schemas.google.com/g/2005'><id>http://gdata.youtube.com/feeds/api/playlists/BCB3BB96DF51B505</id><updated>2008-05-16T12:03:17.000-07:00</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#playlist'/><category scheme='http://gdata.youtube.com/schemas/2007/tags.cat' term='videos'/><category scheme='http://gdata.youtube.com/schemas/2007/tags.cat' term='python'/><title type='text'>Test Playlist</title><subtitle type='text'>Test playlist 1</subtitle><logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo><link rel='alternate' type='text/html' href='http://www.youtube.com/view_play_list?p=BCB3BB96DF51B505'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/playlists/BCB3BB96DF51B505'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/playlists/BCB3BB96DF51B505?start-index=1&max-results=25'/><author><name>gdpython</name><uri>http://gdata.youtube.com/feeds/api/users/gdpython</uri></author><generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator><openSearch:totalResults>1</openSearch:totalResults><openSearch:startIndex>1</openSearch:startIndex><openSearch:itemsPerPage>25</openSearch:itemsPerPage><media:group><media:title type='plain'>Test Playlist</media:title><media:description type='plain'>Test playlist 1</media:description><media:content url='http://www.youtube.com/ep.swf?id=BCB3BB96DF51B505' type='application/x-shockwave-flash' yt:format='5'/></media:group><entry><id>http://gdata.youtube.com/feeds/api/playlists/BCB3BB96DF51B505/B0F29389E537F888</id><updated>2008-05-16T20:54:08.520Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#playlist'/><title type='text'>Uploading YouTube Videos with the PHP Client Library</title><content type='text'>Jochen Hartmann demonstrates the basics of how to use the PHP Client Library with the YouTube Data API.
+
+PHP Developer's Guide:
+http://code.google.com/apis/youtube/developers_guide_php.html
+
+Other documentation:
+http://code.google.com/apis/youtube/</content><link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=iIp7OnHXBlo'/><link rel='http://gdata.youtube.com/schemas/2007#video.responses' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/iIp7OnHXBlo/responses'/><link rel='http://gdata.youtube.com/schemas/2007#video.related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/iIp7OnHXBlo/related'/><link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/videos/iIp7OnHXBlo'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/api/playlists/BCB3BB96DF51B505/B0F29389E537F888'/><author><name>GoogleDevelopers</name><uri>http://gdata.youtube.com/feeds/api/users/googledevelopers</uri></author><media:group><media:title type='plain'>Uploading YouTube Videos with the PHP Client Library</media:title><media:description type='plain'>Jochen Hartmann demonstrates the basics of how to use the PHP Client Library with the YouTube Data API.
+
+PHP Developer's Guide:
+http://code.google.com/apis/youtube/developers_guide_php.html
+
+Other documentation:
+http://code.google.com/apis/youtube/</media:description><media:keywords>api, data, demo, php, screencast, tutorial, uploading, walkthrough, youtube</media:keywords><yt:duration seconds='466'/><media:category label='Education' scheme='http://gdata.youtube.com/schemas/2007/categories.cat'>Education</media:category><media:content url='http://www.youtube.com/v/iIp7OnHXBlo' type='application/x-shockwave-flash' medium='video' isDefault='true' expression='full' duration='466' yt:format='5'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQlaBtdxOnuKiBMYDSANFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='466' yt:format='1'/><media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQlaBtdxOnuKiBMYESARFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='466' yt:format='6'/><media:player url='http://www.youtube.com/watch?v=iIp7OnHXBlo'/><media:thumbnail url='http://img.youtube.com/vi/iIp7OnHXBlo/2.jpg' height='97' width='130' time='00:03:53'/><media:thumbnail url='http://img.youtube.com/vi/iIp7OnHXBlo/1.jpg' height='97' width='130' time='00:01:56.500'/><media:thumbnail url='http://img.youtube.com/vi/iIp7OnHXBlo/3.jpg' height='97' width='130' time='00:05:49.500'/><media:thumbnail url='http://img.youtube.com/vi/iIp7OnHXBlo/0.jpg' height='240' width='320' time='00:03:53'/></media:group><yt:statistics viewCount='1550' favoriteCount='5'/><gd:rating min='1' max='5' numRaters='3' average='4.67'/><yt:location>undefined</yt:location><gd:comments><gd:feedLink href='http://gdata.youtube.com/feeds/api/videos/iIp7OnHXBlo/comments' countHint='2'/></gd:comments><yt:position>1</yt:position></entry></feed>"""
+
+YOUTUBE_SUBSCRIPTION_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+ xmlns:media='http://search.yahoo.com/mrss/'
+ xmlns:yt='http://gdata.youtube.com/schemas/2007'
+ xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://gdata.youtube.com/feeds/users/andyland74/subscriptions?start-index=1&max-results=25</id>
+ <updated>2008-02-26T00:26:15.635Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://gdata.youtube.com/schemas/2007#subscription'/>
+ <title type='text'>andyland74's Subscriptions</title>
+ <logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo>
+ <link rel='related' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74'/>
+ <link rel='alternate' type='text/html'
+ href='http://www.youtube.com/profile_subscriptions?user=andyland74'/>
+ <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74/subscriptions'/>
+ <link rel='self' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74/subscriptions?start-index=1&max-results=25'/>
+ <author>
+ <name>andyland74</name>
+ <uri>http://gdata.youtube.com/feeds/users/andyland74</uri>
+ </author>
+ <generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/users/andyland74/subscriptions/d411759045e2ad8c</id>
+ <published>2007-11-04T17:30:27.000-08:00</published>
+ <updated>2008-02-22T09:55:14.000-08:00</updated>
+ <category scheme='http://gdata.youtube.com/schemas/2007/subscriptiontypes.cat'
+ term='channel'/>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://gdata.youtube.com/schemas/2007#subscription'/>
+ <title type='text'>Videos published by : NBC</title>
+ <link rel='related' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74'/>
+ <link rel='alternate' type='text/html'
+ href='http://www.youtube.com/profile_videos?user=NBC'/>
+ <link rel='self' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74/subscriptions/d411759045e2ad8c'/>
+ <author>
+ <name>andyland74</name>
+ <uri>http://gdata.youtube.com/feeds/users/andyland74</uri>
+ </author>
+ <yt:username>NBC</yt:username>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.uploads'
+ href='http://gdata.youtube.com/feeds/api/users/nbc/uploads'/>
+ </entry>
+</feed>"""
+
+YOUTUBE_VIDEO_RESPONSE_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+ <feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gml='http://www.opengis.net/gml' xmlns:georss='http://www.georss.org/georss' xmlns:media='http://search.yahoo.com/mrss/' xmlns:yt='http://gdata.youtube.com/schemas/2007' xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY/responses</id><updated>2008-05-19T22:37:34.076Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#video'/><title type='text'>Videos responses to 'Giant NES controller coffee table'</title><logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo><link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY'/><link rel='alternate' type='text/html' href='http://www.youtube.com/video_response_view_all?v=2c3q9K4cHzY'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY/responses'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY/responses?start-index=1&max-results=25'/><author><name>YouTube</name><uri>http://www.youtube.com/</uri></author><generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator><openSearch:totalResults>8</openSearch:totalResults><openSearch:startIndex>1</openSearch:startIndex><openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/videos/7b9EnRI9VbY</id><published>2008-03-11T19:08:53.000-07:00</published><updated>2008-05-18T21:33:10.000-07:00</updated>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='OD'/><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#video'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='chat'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='Uncle'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='sex'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='catmint'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='kato'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='kissa'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='katt'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/categories.cat' term='Animals' label='Pets & Animals'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='kat'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='cat'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='cats'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='kedi'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='gato'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='Brattman'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='drug'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='overdose'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='catnip'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='party'/>
+ <category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='Katze'/><category scheme='http://gdata.youtube.com/schemas/2007/keywords.cat' term='gatto'/>
+ <title type='text'>Catnip Party</title><content type='html'>snipped</content>
+ <link rel='alternate' type='text/html' href='http://www.youtube.com/watch?v=7b9EnRI9VbY'/>
+ <link rel='http://gdata.youtube.com/schemas/2007#video.responses' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/7b9EnRI9VbY/responses'/>
+ <link rel='http://gdata.youtube.com/schemas/2007#video.related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/7b9EnRI9VbY/related'/>
+ <link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY/responses/7b9EnRI9VbY'/>
+ <author><name>PismoBeach</name><uri>http://gdata.youtube.com/feeds/users/pismobeach</uri></author>
+ <media:group>
+ <media:title type='plain'>Catnip Party</media:title>
+ <media:description type='plain'>Uncle, Hillary, Hankette, and B4 all but overdose on the patio</media:description><media:keywords>Brattman, cat, catmint, catnip, cats, chat, drug, gato, gatto, kat, kato, katt, Katze, kedi, kissa, OD, overdose, party, sex, Uncle</media:keywords>
+ <yt:duration seconds='139'/>
+ <media:category label='Pets & Animals' scheme='http://gdata.youtube.com/schemas/2007/categories.cat'>Animals</media:category>
+ <media:content url='http://www.youtube.com/v/7b9EnRI9VbY' type='application/x-shockwave-flash' medium='video' isDefault='true' expression='full' duration='139' yt:format='5'/>
+ <media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQm2VT0SnUS_7RMYDSANFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='139' yt:format='1'/>
+ <media:content url='rtsp://rtsp2.youtube.com/ChoLENy73wIaEQm2VT0SnUS_7RMYESARFEgGDA==/0/0/0/video.3gp' type='video/3gpp' medium='video' expression='full' duration='139' yt:format='6'/>
+ <media:player url='http://www.youtube.com/watch?v=7b9EnRI9VbY'/>
+ <media:thumbnail url='http://img.youtube.com/vi/7b9EnRI9VbY/2.jpg' height='97' width='130' time='00:01:09.500'/>
+ <media:thumbnail url='http://img.youtube.com/vi/7b9EnRI9VbY/1.jpg' height='97' width='130' time='00:00:34.750'/>
+ <media:thumbnail url='http://img.youtube.com/vi/7b9EnRI9VbY/3.jpg' height='97' width='130' time='00:01:44.250'/>
+ <media:thumbnail url='http://img.youtube.com/vi/7b9EnRI9VbY/0.jpg' height='240' width='320' time='00:01:09.500'/>
+ </media:group>
+ <yt:statistics viewCount='4235' favoriteCount='3'/>
+ <gd:rating min='1' max='5' numRaters='24' average='3.54'/>
+ <gd:comments>
+ <gd:feedLink href='http://gdata.youtube.com/feeds/videos/7b9EnRI9VbY/comments' countHint='14'/>
+ </gd:comments>
+ </entry>
+</feed>
+"""
+
+
+YOUTUBE_PROFILE = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:media='http://search.yahoo.com/mrss/'
+ xmlns:yt='http://gdata.youtube.com/schemas/2007'
+ xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://gdata.youtube.com/feeds/users/andyland74</id>
+ <published>2006-10-16T00:09:45.000-07:00</published>
+ <updated>2008-02-26T11:48:21.000-08:00</updated>
+ <category scheme='http://gdata.youtube.com/schemas/2007/channeltypes.cat'
+ term='Standard'/>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://gdata.youtube.com/schemas/2007#userProfile'/>
+ <title type='text'>andyland74 Channel</title>
+ <link rel='alternate' type='text/html'
+ href='http://www.youtube.com/profile?user=andyland74'/>
+ <link rel='self' type='application/atom+xml'
+ href='http://gdata.youtube.com/feeds/users/andyland74'/>
+ <author>
+ <name>andyland74</name>
+ <uri>http://gdata.youtube.com/feeds/users/andyland74</uri>
+ </author>
+ <yt:age>33</yt:age>
+ <yt:username>andyland74</yt:username>
+ <yt:firstName>andy</yt:firstName>
+ <yt:lastName>example</yt:lastName>
+ <yt:books>Catch-22</yt:books>
+ <yt:gender>m</yt:gender>
+ <yt:company>Google</yt:company>
+ <yt:hobbies>Testing YouTube APIs</yt:hobbies>
+ <yt:hometown>Somewhere</yt:hometown>
+ <yt:location>US</yt:location>
+ <yt:movies>Aqua Teen Hungerforce</yt:movies>
+ <yt:music>Elliott Smith</yt:music>
+ <yt:occupation>Technical Writer</yt:occupation>
+ <yt:school>University of North Carolina</yt:school>
+ <media:thumbnail url='http://i.ytimg.com/vi/YFbSxcdOL-w/default.jpg'/>
+ <yt:statistics viewCount='9' videoWatchCount='21' subscriberCount='1'
+ lastWebAccess='2008-02-25T16:03:38.000-08:00'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.favorites'
+ href='http://gdata.youtube.com/feeds/users/andyland74/favorites' countHint='4'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.contacts'
+ href='http://gdata.youtube.com/feeds/users/andyland74/contacts' countHint='1'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.inbox'
+ href='http://gdata.youtube.com/feeds/users/andyland74/inbox' countHint='0'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.playlists'
+ href='http://gdata.youtube.com/feeds/users/andyland74/playlists'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.subscriptions'
+ href='http://gdata.youtube.com/feeds/users/andyland74/subscriptions' countHint='4'/>
+ <gd:feedLink rel='http://gdata.youtube.com/schemas/2007#user.uploads'
+ href='http://gdata.youtube.com/feeds/users/andyland74/uploads' countHint='1'/>
+</entry>"""
+
+YOUTUBE_CONTACTS_FEED = """<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:yt='http://gdata.youtube.com/schemas/2007' xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts</id><updated>2008-05-16T19:24:34.916Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#friend'/><title type='text'>apitestjhartmann's Contacts</title><logo>http://www.youtube.com/img/pic_youtubelogo_123x63.gif</logo><link rel='alternate' type='text/html' href='http://www.youtube.com/profile_friends?user=apitestjhartmann'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts?start-index=1&max-results=25'/><author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author><generator version='beta' uri='http://gdata.youtube.com/'>YouTube data API</generator><openSearch:totalResults>2</openSearch:totalResults><openSearch:startIndex>1</openSearch:startIndex><openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/test89899090</id><published>2008-02-04T11:27:54.000-08:00</published><updated>2008-05-16T19:24:34.916Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#friend'/><title type='text'>test89899090</title><link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/test89899090'/><link rel='alternate' type='text/html' href='http://www.youtube.com/profile?user=test89899090'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/test89899090'/><link rel='edit' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/test89899090'/><author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author><yt:username>test89899090</yt:username><yt:status>requested</yt:status></entry>
+ <entry>
+ <id>http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/testjfisher</id><published>2008-02-26T14:13:03.000-08:00</published><updated>2008-05-16T19:24:34.916Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://gdata.youtube.com/schemas/2007#friend'/><title type='text'>testjfisher</title><link rel='related' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/testjfisher'/><link rel='alternate' type='text/html' href='http://www.youtube.com/profile?user=testjfisher'/><link rel='self' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/testjfisher'/><link rel='edit' type='application/atom+xml' href='http://gdata.youtube.com/feeds/users/apitestjhartmann/contacts/testjfisher'/><author><name>apitestjhartmann</name><uri>http://gdata.youtube.com/feeds/users/apitestjhartmann</uri></author><yt:username>testjfisher</yt:username><yt:status>pending</yt:status></entry>
+</feed>"""
+
+NEW_CONTACT = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:gd='http://schemas.google.com/g/2005'
+ xmlns:gContact='http://schemas.google.com/contact/2008'>
+ <id>http://www.google.com/m8/feeds/contacts/liz%40gmail.com/base/8411573</id>
+ <updated>2008-02-28T18:47:02.303Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/contact/2008#contact' />
+ <title type='text'>Fitzgerald</title>
+ <content type='text'>Notes</content>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/8411573' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/8411573/1204224422303000' />
+ <gd:email rel='http://schemas.google.com/g/2005#work'
+ address='liz@gmail.com' />
+ <gd:email rel='http://schemas.google.com/g/2005#home'
+ address='liz@example.org' />
+ <gd:phoneNumber rel='http://schemas.google.com/g/2005#work'
+ primary='true'>(206)555-1212</gd:phoneNumber>
+ <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
+ primary='true'>456-123-2133</gd:phoneNumber>
+ <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>(206)555-1213</gd:phoneNumber>
+ <gd:extendedProperty name="pet" value="hamster" />
+ <gd:extendedProperty name="cousine">
+ <italian />
+ </gd:extendedProperty>
+ <gContact:groupMembershipInfo deleted="false" href="http://google.com/m8/feeds/groups/liz%40gmail.com/base/270f" />
+ <gd:im address='liz@gmail.com'
+ protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
+ rel='http://schemas.google.com/g/2005#home' />
+ <gd:postalAddress rel='http://schemas.google.com/g/2005#work'
+ primary='true'>1600 Amphitheatre Pkwy Mountain View</gd:postalAddress>
+</entry>"""
+
+CONTACTS_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+ xmlns:gd='http://schemas.google.com/g/2005'
+ xmlns:gContact='http://schemas.google.com/contact/2008'
+ xmlns:batch='http://schemas.google.com/gdata/batch'>
+ <id>http://www.google.com/m8/feeds/contacts/liz%40gmail.com/base</id>
+ <updated>2008-03-05T12:36:38.836Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/contact/2008#contact' />
+ <title type='text'>Contacts</title>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full' />
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full' />
+ <link rel='http://schemas.google.com/g/2005#batch'
+ type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/batch' />
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full?max-results=25' />
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <generator version='1.0' uri='http://www.google.com/m8/feeds/contacts'>
+ Contacts
+ </generator>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>
+ http://www.google.com/m8/feeds/contacts/liz%40gmail.com/base/c9012de
+ </id>
+ <updated>2008-03-05T12:36:38.835Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/contact/2008#contact' />
+ <title type='text'>Fitzgerald</title>
+ <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
+ href="http://google.com/m8/feeds/photos/media/liz%40gmail.com/c9012de"/>
+ <link rel="http://schemas.google.com/contacts/2008/rel#edit-photo" type="image/*"
+ href="http://www.google.com/m8/feeds/photos/media/liz%40gmail.com/c9012de/photo4524"/>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/c9012de' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/c9012de/1204720598835000' />
+ <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
+ primary='true'>
+ 456
+ </gd:phoneNumber>
+ <gd:extendedProperty name="pet" value="hamster" />
+ <gContact:groupMembershipInfo deleted="false" href="http://google.com/m8/feeds/groups/liz%40gmail.com/base/270f" />
+ </entry>
+</feed>"""
+
+
+CONTACT_GROUPS_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gContact="http://schemas.google.com/contact/2008"
+ xmlns:batch="http://schemas.google.com/gdata/batch"
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <id>jo@gmail.com</id>
+ <updated>2008-05-21T21:11:25.237Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#group"/>
+ <title type="text">Jo's Contact Groups</title>
+ <link rel="alternate" type="text/html" href="http://www.google.com/"/>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml"
+ href="http://google.m/m8/feeds/groups/jo%40gmail.com/thin"/>
+ <link rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml"
+ href="http://google.m/m8/feeds/groups/jo%40gmail.com/thin"/>
+ <link rel="http://schemas.google.com/g/2005#batch"
+ type="application/atom+xml"
+ href="http://googleom/m8/feeds/groups/jo%40gmail.com/thin/batch"/>
+ <link rel="self"
+ type="application/atom+xml"
+ href="http://google.com/m8/feeds/groups/jo%40gmail.com/thin?max-results=25"/>
+ <author>
+ <name>Jo Brown</name>
+ <email>jo@gmail.com</email>
+ </author>
+ <generator version="1.0" uri="http://google.com/m8/feeds">Contacts</generator>
+ <openSearch:totalResults>3</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
+ <entry>
+ <id>http://google.com/m8/feeds/groups/jo%40gmail.com/base/270f</id>
+ <updated>2008-05-14T13:10:19.070Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/contact/2008#group"/>
+ <title type="text">joggers</title>
+ <content type="text">joggers</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://google.com/m8/feeds/groups/jo%40gmail.com/thin/270f"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://google.com/m8/feeds/groups/jo%40gmail.com/thin/270f/1210770619070000"/>
+ </entry>
+</feed>"""
+
+CONTACT_GROUP_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:gd="http://schemas.google.com/g/2005">
+ <category scheme="http://schemas.google.com/g/2005#kind"
+ term="http://schemas.google.com/g/2005#group"/>
+ <id>http://www.google.com/feeds/groups/jo%40gmail.com/base/1234</id>
+ <published>2005-01-18T21:00:00Z</published>
+ <updated>2006-01-01T00:00:00Z</updated>
+ <title type="text">Salsa group</title>
+ <content type="text">Salsa group</content>
+ <link rel='self' type='application/atom+xml'
+ href= 'http://www.google.com/m8/feeds/groups/jo%40gmail.com/full/2' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/groups/jo%40gmail.com/full/2/0'/>
+ <gd:extendedProperty name="more info about the group">
+ <info>Very nice people.</info>
+ </gd:extendedProperty>
+</entry>"""
+
+CALENDAR_RESOURCE_ENTRY = """<?xml version="1.0"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom" xmlns:apps="http://schemas.google.com/apps/2006">
+ <apps:property name="resourceId" value="CR-NYC-14-12-BR"/>
+ <apps:property name="resourceCommonName" value="Boardroom"/>
+ <apps:property name="resourceDescription" value="This conference room is in New York City, building 14, floor 12, Boardroom"/>
+ <apps:property name="resourceType" value="CR"/>
+</atom:entry>"""
+
+CALENDAR_RESOURCES_FEED = """<?xml version="1.0"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:apps="http://schemas.google.com/apps/2006">
+ <id>https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com</id>
+ <updated>2008-10-17T15:29:21.064Z</updated>
+ <link rel="next" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/?start=the next resourceId"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com"/>
+ <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com"/>
+ <link rel="self" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com?start=CR-NYC-14-12-BR"/>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/CR-NYC-14-12-BR</id>
+ <updated>2008-10-17T15:29:21.064Z</updated>
+ <link rel="self" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/CR-NYC-14-12-BR"/>
+ <link rel="edit" type="application/atom+xml" href="https://apps-apis.google.com/feeds/calendar/resource/2.0/yourdomain.com/CR-NYC-14-12-BR"/>
+ <apps:property name="resourceId" value="CR-NYC-14-12-BR"/>
+ <apps:property name="resourceCommonName" value="Boardroom"/>
+ <apps:property name="resourceEmail" value="domain_123456@resource.calendar.google.com"/>
+ <apps:property name="resourceDescription" value="This conference room is in New York City, building 14, floor 12, Boardroom"/>
+ <apps:property name="resourceType" value="CR"/>
+ </entry>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/?start=(Bike)-London-43-Lobby-Bike-1</id>
+ <updated>2008-10-17T15:29:21.064Z</updated>
+ <link rel="self" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/(Bike)-London-43-Lobby-Bike-1"/>
+ <link rel="edit" type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/(Bike)-London-43-Lobby-Bike-1"/>
+ <apps:property name="resourceId" value="(Bike)-London-43-Lobby-Bike-1"/>
+ <apps:property name="resourceCommonName" value="London bike-1"/>
+ <apps:property name="resourceEmail" value="domain_123457@resource.calendar.google.com"/>
+ <apps:property name="resourceDescription" value="Bike is in London at building 43's lobby."/>
+ <apps:property name="resourceType" value="(Bike)"/>
+ </entry>
+</feed>"""
+
+BLOG_ENTRY = """<entry xmlns='http://www.w3.org/2005/Atom'>
+ <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
+ <published>2006-08-02T18:44:43.089-07:00</published>
+ <updated>2006-11-08T18:10:23.020-08:00</updated>
+ <title type='text'>Lizzy's Diary</title>
+ <summary type='html'>Being the journal of Elizabeth Bennet</summary>
+ <link rel='alternate' type='text/html'
+ href='http://blogName.blogspot.com/'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://blogName.blogspot.com/feeds/posts/default'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://www.blogger.com/feeds/blogID/posts/default'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.blogger.com/feeds/userID/blogs/blogID'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.blogger.com/feeds/userID/blogs/blogID'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+</entry>"""
+
+BLOG_POST = """<entry xmlns='http://www.w3.org/2005/Atom'>
+ <title type='text'>Marriage!</title>
+ <content type='xhtml'>
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <p>Mr. Darcy has <em>proposed marriage</em> to me!</p>
+ <p>He is the last man on earth I would ever desire to marry.</p>
+ <p>Whatever shall I do?</p>
+ </div>
+ </content>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+</entry>"""
+
+BLOG_POSTS_FEED = """<feed xmlns='http://www.w3.org/2005/Atom'>
+ <id>tag:blogger.com,1999:blog-blogID</id>
+ <updated>2006-11-08T18:10:23.020-08:00</updated>
+ <title type='text'>Lizzy's Diary</title>
+ <link rel='alternate' type='text/html'
+ href='http://blogName.blogspot.com/index.html'>
+ </link>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://blogName.blogspot.com/feeds/posts/default'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://blogName.blogspot.com/feeds/posts/default'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <generator version='7.00' uri='http://www2.blogger.com'>Blogger</generator>
+ <entry>
+ <id>tag:blogger.com,1999:blog-blogID.post-postID</id>
+ <published>2006-11-08T18:10:00.000-08:00</published>
+ <updated>2006-11-08T18:10:14.954-08:00</updated>
+ <title type='text'>Quite disagreeable</title>
+ <content type='html'><p>I met Mr. Bingley's friend Mr. Darcy
+ this evening. I found him quite disagreeable.</p></content>
+ <link rel='alternate' type='text/html'
+ href='http://blogName.blogspot.com/2006/11/quite-disagreeable.html'>
+ </link>
+ <link rel='self' type='application/atom+xml'
+ href='http://blogName.blogspot.com/feeds/posts/default/postID'>
+ </link>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.blogger.com/feeds/blogID/posts/default/postID'>
+ </link>
+ <author>
+ <name>Elizabeth Bennet</name>
+ <email>liz@gmail.com</email>
+ </author>
+ </entry>
+</feed>"""
+
+BLOG_COMMENTS_FEED = """<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/">
+ <id>tag:blogger.com,1999:blog-blogID.postpostID..comments</id>
+ <updated>2007-04-04T21:56:29.803-07:00</updated>
+ <title type="text">My Blog : Time to relax</title>
+ <link rel="alternate" type="text/html" href="http://blogName.blogspot.com/2007/04/first-post.html"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default"/>
+ <link rel="self" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default"/>
+ <author>
+ <name>Blog Author name</name>
+ </author>
+ <generator version="7.00" uri="http://www2.blogger.com">Blogger</generator>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>tag:blogger.com,1999:blog-blogID.post-commentID</id>
+ <published>2007-04-04T21:56:00.000-07:00</published>
+ <updated>2007-04-04T21:56:29.803-07:00</updated>
+ <title type="text">This is my first comment</title>
+ <content type="html">This is my first comment</content>
+ <link rel="alternate" type="text/html" href="http://a-blogName.blogspot.com/2007/04/first-post.html#commentID"/>
+ <link rel="self" type="application/atom+xml" href="http://blogName.blogspot.com/feeds/postID/comments/default/commentID"/>
+ <link rel="edit" type="application/atom+xml" href="http://www.blogger.com/feeds/blogID/postID/comments/default/commentID"/>
+ <author>
+ <name>Blog Author name</name>
+ </author>
+ <thr:in-reply-to xmlns:thr='http://purl.org/syndication/thread/1.0'
+ href='http://blogName.blogspot.com/2007/04/first-post.html'
+ ref='tag:blogger.com,1999:blog-blogID.post-postID'
+ source='http://blogName.blogspot.com/feeds/posts/default/postID'
+ type='text/html' />
+ </entry>
+</feed>"""
+
+
+SITES_FEED = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gd="http://schemas.google.com/g/2005"
+ xmlns:wt="http://schemas.google.com/webmasters/tools/2007">
+ <id>https://www.google.com/webmasters/tools/feeds/sites</id>
+ <title>Sites</title>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/webmasters/tools/2007#sites-feed" />
+ <link href="http://www.google.com/webmasters/tools/feeds/sites" rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" />
+ <link href="http://www.google.com/webmasters/tools/feeds/sites" rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" />
+ <link href="http://www.google.com/webmasters/tools/feeds/sites" rel="self" type="application/atom+xml" />
+ <updated>2008-10-02T07:26:51.833Z</updated>
+ <entry>
+ <id>http://www.example.com</id>
+ <title type="text">http://www.example.com</title>
+ <link href="http://www.google.com/webmasters/tools/feeds/sites/http%3A%2F%2Fwww.example.com%2F" rel="self" type="application/atom+xml"/>
+ <link href="http://www.google.com/webmasters/tools/feeds/sites/http%3A%2F%2Fwww.example.com%2F" rel="edit" type="application/atom+xml"/>
+ <content src="http://www.example.com"/>
+ <updated>2007-11-17T18:27:32.543Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/webmasters/tools/2007#site-info"/>
+ <gd:entryLink rel="http://schemas.google.com/webmasters/tools/2007#verification"
+ href="https://www.google.com/webmasters/tools/feeds/http%3A%2F%2Fwww%2Eexample%2Ecom%2F/verification" />
+ <gd:entryLink rel="http://schemas.google.com/webmasters/tools/2007#sitemaps"
+ href="https://www.google.com/webmasters/tools/feeds/http%3A%2F%2Fwww%2Eexample%2Ecom%2F/sitemaps" />
+ <wt:indexed>true</wt:indexed>
+ <wt:crawled>2008-09-14T08:59:28.000</wt:crawled>
+ <wt:geolocation>US</wt:geolocation>
+ <wt:preferred-domain>none</wt:preferred-domain>
+ <wt:crawl-rate>normal</wt:crawl-rate>
+ <wt:enhanced-image-search>true</wt:enhanced-image-search>
+ <wt:verified>false</wt:verified>
+ <wt:verification-method type="metatag" in-use="false"><meta name="verify-v1" content="a2Ai"/>
+ </wt:verification-method>
+ <wt:verification-method type="htmlpage" in-use="false">456456-google.html</wt:verification-method>
+ </entry>
+</feed>"""
+
+
+SITEMAPS_FEED = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:wt="http://schemas.google.com/webmasters/tools/2007">
+ <id>http://www.example.com</id>
+ <title type="text">http://www.example.com/</title>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <link rel="self" type="application/atom+xml"
+ href="https://www.google.com/webmasters/tools/feeds/http%3A%2F%2Fwww%2Eexample%2Ecom%2F/sitemaps" />
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/webmasters/tools/2007#sitemaps-feed'/>
+ <wt:sitemap-mobile>
+ <wt:markup-language>HTML</wt:markup-language>
+ <wt:markup-language>WAP</wt:markup-language>
+ </wt:sitemap-mobile>
+ <wt:sitemap-news>
+ <wt:publication-label>Value1</wt:publication-label>
+ <wt:publication-label>Value2</wt:publication-label>
+ <wt:publication-label>Value3</wt:publication-label>
+ </wt:sitemap-news>
+ <entry>
+ <id>http://www.example.com/sitemap-index.xml</id>
+ <title type="text">http://www.example.com/sitemap-index.xml</title>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/webmasters/tools/2007#sitemap-regular'/>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <wt:sitemap-type>WEB</wt:sitemap-type>
+ <wt:sitemap-status>StatusValue</wt:sitemap-status>
+ <wt:sitemap-last-downloaded>2006-11-18T19:27:32.543Z</wt:sitemap-last-downloaded>
+ <wt:sitemap-url-count>102</wt:sitemap-url-count>
+ </entry>
+ <entry>
+ <id>http://www.example.com/mobile/sitemap-index.xml</id>
+ <title type="text">http://www.example.com/mobile/sitemap-index.xml</title>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/webmasters/tools/2007#sitemap-mobile'/>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <wt:sitemap-status>StatusValue</wt:sitemap-status>
+ <wt:sitemap-last-downloaded>2006-11-18T19:27:32.543Z</wt:sitemap-last-downloaded>
+ <wt:sitemap-url-count>102</wt:sitemap-url-count>
+ <wt:sitemap-mobile-markup-language>HTML</wt:sitemap-mobile-markup-language>
+ </entry>
+ <entry>
+ <id>http://www.example.com/news/sitemap-index.xml</id>
+ <title type="text">http://www.example.com/news/sitemap-index.xml</title>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/webmasters/tools/2007#sitemap-news'/>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <wt:sitemap-status>StatusValue</wt:sitemap-status>
+ <wt:sitemap-last-downloaded>2006-11-18T19:27:32.543Z</wt:sitemap-last-downloaded>
+ <wt:sitemap-url-count>102</wt:sitemap-url-count>
+ <wt:sitemap-news-publication-label>LabelValue</wt:sitemap-news-publication-label>
+ </entry>
+</feed>"""
+
+HEALTH_CCR_NOTICE_PAYLOAD = """<ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <Body>
+ <Problems>
+ <Problem>
+ <DateTime>
+ <Type><Text>Start date</Text></Type>
+ <ExactDateTime>2007-04-04T07:00:00Z</ExactDateTime>
+ </DateTime>
+ <Description>
+ <Text>Aortic valve disorders</Text>
+ <Code>
+ <Value>410.10</Value>
+ <CodingSystem>ICD9</CodingSystem>
+ <Version>2004</Version>
+ </Code>
+ </Description>
+ <Status><Text>Active</Text></Status>
+ </Problem>
+ </Problems>
+ </Body>
+</ContinuityOfCareRecord>"""
+
+HEALTH_PROFILE_ENTRY_DIGEST = """<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:ccr="urn:astm-org:CCR" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:h9m="http://schemas.google.com/health/metadata">
+ <id>https://www.google.com/health/feeds/profile/default/vneCn5qdEIY_digest</id>
+ <updated>2008-09-29T07:52:17.176Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile" />
+ <link rel="alternate" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default?digest=true" />
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/vneCn5qdEIY_digest" />
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/vneCn5qdEIY_digest" />
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>vneCn5qdEIY</CCRDocumentObjectID>
+ <Language>
+ <Text>English</Text>
+ <Code>
+ <Value>en</Value>
+ <CodingSystem>ISO-639-1</CodingSystem>
+ </Code>
+ </Language>
+ <Version>V1.0</Version>
+ <DateTime>
+ <ExactDateTime>2008-09-29T07:52:17.176Z</ExactDateTime>
+ </DateTime>
+ <Patient>
+ <ActorID>Google Health Profile</ActorID>
+ </Patient>
+ <Body>
+ <FunctionalStatus>
+ <Function>
+ <Type>
+ <Text>Pregnancy status</Text>
+ </Type>
+ <Description>
+ <Text>Not pregnant</Text>
+ </Description>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@google.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Function>
+ <Function>
+ <Type>
+ <Text>Breastfeeding status</Text>
+ </Type>
+ <Description>
+ <Text>Not breastfeeding</Text>
+ </Description>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Function>
+ </FunctionalStatus>
+ <Problems>
+ <Problem>
+ <CCRDataObjectID>Hn0FE0IlcY-FMFFgSTxkvA/CONDITION/0</CCRDataObjectID>
+ <DateTime>
+ <Type>
+ <Text>Start date</Text>
+ </Type>
+ <ExactDateTime>2007-04-04T07:00:00Z</ExactDateTime>
+ </DateTime>
+ <Description>
+ <Text>Aortic valve disorders</Text>
+ <Code>
+ <Value>410.10</Value>
+ <CodingSystem>ICD9</CodingSystem>
+ <Version>2004</Version>
+ </Code>
+ </Description>
+ <Status>
+ <Text>Active</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>example.com</ActorID>
+ <ActorRole>
+ <Text>Information Provider</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Problem>
+ <Problem>
+ <Type />
+ <Description>
+ <Text>Malaria</Text>
+ <Code>
+ <Value>136.9</Value>
+ <CodingSystem>ICD9_Broader</CodingSystem>
+ </Code>
+ <Code>
+ <Value>084.6</Value>
+ <CodingSystem>ICD9</CodingSystem>
+ </Code>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <HealthStatus>
+ <Description />
+ </HealthStatus>
+ </Problem>
+ </Problems>
+ <SocialHistory>
+ <SocialHistoryElement>
+ <Type>
+ <Text>Race</Text>
+ <Code>
+ <Value>S15814</Value>
+ <CodingSystem>HL7</CodingSystem>
+ </Code>
+ </Type>
+ <Description>
+ <Text>White</Text>
+ </Description>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Episodes>
+ <Frequency>
+ <Units />
+ </Frequency>
+ </Episodes>
+ </SocialHistoryElement>
+ </SocialHistory>
+ <Alerts>
+ <Alert>
+ <Type>
+ <Text>Allergy</Text>
+ </Type>
+ <Description>
+ <Text>A-Fil</Text>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Reaction>
+ <Description />
+ <Severity>
+ <Text>Severe</Text>
+ </Severity>
+ </Reaction>
+ </Alert>
+ <Alert>
+ <Type>
+ <Text>Allergy</Text>
+ </Type>
+ <Description>
+ <Text>A.E.R Traveler</Text>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Reaction>
+ <Description />
+ <Severity>
+ <Text>Severe</Text>
+ </Severity>
+ </Reaction>
+ </Alert>
+ </Alerts>
+ <Medications>
+ <Medication>
+ <Type />
+ <Description />
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>A& D</Text>
+ </ProductName>
+ <Strength>
+ <Units />
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier />
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description />
+ <DeliveryMethod />
+ <Dose>
+ <Units />
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier />
+ </Dose>
+ <Route>
+ <Text>To skin</Text>
+ <Code>
+ <Value>C38305</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier />
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills />
+ </Medication>
+ <Medication>
+ <Type />
+ <Description />
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>A-Fil</Text>
+ </ProductName>
+ <Strength>
+ <Units />
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier />
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description />
+ <DeliveryMethod />
+ <Dose>
+ <Units />
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier />
+ </Dose>
+ <Route>
+ <Text>To skin</Text>
+ <Code>
+ <Value>C38305</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier />
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills />
+ </Medication>
+ <Medication>
+ <Type />
+ <Description />
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>Lipitor</Text>
+ </ProductName>
+ <Strength>
+ <Units />
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier />
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description />
+ <DeliveryMethod />
+ <Dose>
+ <Units />
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier />
+ </Dose>
+ <Route>
+ <Text>By mouth</Text>
+ <Code>
+ <Value>C38288</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier />
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills />
+ </Medication>
+ </Medications>
+ <Immunizations>
+ <Immunization>
+ <Type />
+ <Description />
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>Chickenpox Vaccine</Text>
+ <Code>
+ <Value>21</Value>
+ <CodingSystem>HL7</CodingSystem>
+ </Code>
+ </ProductName>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description />
+ <DeliveryMethod />
+ </Direction>
+ </Directions>
+ <Refills />
+ </Immunization>
+ </Immunizations>
+ <VitalSigns>
+ <Result>
+ <Type />
+ <Description />
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance />
+ <Test>
+ <Type />
+ <Description>
+ <Text>Height</Text>
+ </Description>
+ <Status />
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier />
+ <Value>70</Value>
+ <Units>
+ <Unit>inches</Unit>
+ </Units>
+ </TestResult>
+ <ConfidenceValue />
+ </Test>
+ </Result>
+ <Result>
+ <Type />
+ <Description />
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance />
+ <Test>
+ <Type />
+ <Description>
+ <Text>Weight</Text>
+ </Description>
+ <Status />
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier />
+ <Value>2480</Value>
+ <Units>
+ <Unit>ounces</Unit>
+ </Units>
+ </TestResult>
+ <ConfidenceValue />
+ </Test>
+ </Result>
+ <Result>
+ <Type />
+ <Description />
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance />
+ <Test>
+ <Type />
+ <Description>
+ <Text>Blood Type</Text>
+ </Description>
+ <Status />
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier />
+ <Value>O+</Value>
+ <Units />
+ </TestResult>
+ <ConfidenceValue />
+ </Test>
+ </Result>
+ </VitalSigns>
+ <Results>
+ <Result>
+ <Type />
+ <Description />
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance />
+ <Test>
+ <DateTime>
+ <Type>
+ <Text>Collection start date</Text>
+ </Type>
+ <ExactDateTime>2008-09-03</ExactDateTime>
+ </DateTime>
+ <Type />
+ <Description>
+ <Text>Acetaldehyde - Blood</Text>
+ </Description>
+ <Status />
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier />
+ <Units />
+ </TestResult>
+ <ConfidenceValue />
+ </Test>
+ </Result>
+ </Results>
+ <Procedures>
+ <Procedure>
+ <Type />
+ <Description>
+ <Text>Abdominal Ultrasound</Text>
+ </Description>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Procedure>
+ <Procedure>
+ <Type />
+ <Description>
+ <Text>Abdominoplasty</Text>
+ </Description>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Procedure>
+ </Procedures>
+ </Body>
+ <Actors>
+ <Actor>
+ <ActorObjectID>Google Health Profile</ActorObjectID>
+ <Person>
+ <Name>
+ <BirthName />
+ <CurrentName />
+ </Name>
+ <DateOfBirth>
+ <Type />
+ <ExactDateTime>1984-07-22</ExactDateTime>
+ </DateOfBirth>
+ <Gender>
+ <Text>Male</Text>
+ </Gender>
+ </Person>
+ <Status />
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Actor>
+ </Actors>
+ </ContinuityOfCareRecord>
+</entry>"""
+
+HEALTH_PROFILE_FEED = """<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+xmlns:ccr="urn:astm-org:CCR" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:h9m="http://schemas.google.com/health/metadata">
+<id>https://www.google.com/health/feeds/profile/default</id>
+<updated>2008-09-30T01:07:17.888Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+<title type="text">Profile Feed</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default"/>
+<link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default"/>
+<link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/batch"/>
+<link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default?digest=false"/>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/DysasdfARnFAao</id>
+ <published>2008-09-29T03:12:50.850Z</published>
+ <updated>2008-09-29T03:12:50.850Z</updated>
+ <category term="MEDICATION"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="A& D"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/MEDICATION/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DA%26+D"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/DysasdfARnFAao"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/DysasdfARnFAao"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>hiD9sEigSzdk8nNT0evR4g</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Medications>
+ <Medication>
+ <Type/>
+ <Description/>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>A& D</Text>
+ </ProductName>
+ <Strength>
+ <Units/>
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier/>
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description/>
+ <DeliveryMethod/>
+ <Dose>
+ <Units/>
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier/>
+ </Dose>
+ <Route>
+ <Text>To skin</Text>
+ <Code>
+ <Value>C38305</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier/>
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills/>
+ </Medication>
+ </Medications>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/7I1WQzZrgp4</id>
+ <published>2008-09-29T03:27:14.909Z</published>
+ <updated>2008-09-29T03:27:14.909Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="A-Fil"/>
+ <category term="ALLERGY"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DA-Fil/ALLERGY"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/7I1WQzZrgp4"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/7I1WQzZrgp4"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>YOyHDxQUiECCPgnsjV8SlQ</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Alerts>
+ <Alert>
+ <Type>
+ <Text>Allergy</Text>
+ </Type>
+ <Description>
+ <Text>A-Fil</Text>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Reaction>
+ <Description/>
+ <Severity>
+ <Text>Severe</Text>
+ </Severity>
+ </Reaction>
+ </Alert>
+ </Alerts>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/Dz9wV83sKFg</id>
+ <published>2008-09-29T03:12:52.166Z</published>
+ <updated>2008-09-29T03:12:52.167Z</updated>
+ <category term="MEDICATION"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="A-Fil"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/MEDICATION/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DA-Fil"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/Dz9wV83sKFg"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/Dz9wV83sKFg"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>7w.XFEPeuIYN3Rn32pUiUw</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Medications>
+ <Medication>
+ <Type/>
+ <Description/>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>A-Fil</Text>
+ </ProductName>
+ <Strength>
+ <Units/>
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier/>
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description/>
+ <DeliveryMethod/>
+ <Dose>
+ <Units/>
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier/>
+ </Dose>
+ <Route>
+ <Text>To skin</Text>
+ <Code>
+ <Value>C38305</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier/>
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills/>
+ </Medication>
+ </Medications>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/lzsxVzqZUyw</id>
+ <published>2008-09-29T03:13:07.496Z</published>
+ <updated>2008-09-29T03:13:07.497Z</updated>
+ <category scheme="http://schemas.google.com/health/item" term="A.E.R Traveler"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="ALLERGY"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DA.E.R+Traveler/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/ALLERGY"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/lzsxVzqZUyw"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/lzsxVzqZUyw"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>5efFB0J2WgEHNUvk2z3A1A</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Alerts>
+ <Alert>
+ <Type>
+ <Text>Allergy</Text>
+ </Type>
+ <Description>
+ <Text>A.E.R Traveler</Text>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Reaction>
+ <Description/>
+ <Severity>
+ <Text>Severe</Text>
+ </Severity>
+ </Reaction>
+ </Alert>
+ </Alerts>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/6PvhfKAXyYw</id>
+ <published>2008-09-29T03:13:02.123Z</published>
+ <updated>2008-09-29T03:13:02.124Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="PROCEDURE"/>
+ <category scheme="http://schemas.google.com/health/item" term="Abdominal Ultrasound"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/PROCEDURE/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DAbdominal+Ultrasound"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/6PvhfKAXyYw"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/6PvhfKAXyYw"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>W3Wbvx_QHwG5pxVchpuF1A</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Procedures>
+ <Procedure>
+ <Type/>
+ <Description>
+ <Text>Abdominal Ultrasound</Text>
+ </Description>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Procedure>
+ </Procedures>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/r2zGPGewCeU</id>
+ <published>2008-09-29T03:13:03.434Z</published>
+ <updated>2008-09-29T03:13:03.435Z</updated>
+ <category scheme="http://schemas.google.com/health/item" term="Abdominoplasty"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="PROCEDURE"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DAbdominoplasty/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/PROCEDURE"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/r2zGPGewCeU"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/r2zGPGewCeU"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>OUKgj5X0KMnbkC5sDL.yHA</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Procedures>
+ <Procedure>
+ <Type/>
+ <Description>
+ <Text>Abdominoplasty</Text>
+ </Description>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Procedure>
+ </Procedures>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/_cCCbQ0O3ug</id>
+ <published>2008-09-29T03:13:29.041Z</published>
+ <updated>2008-09-29T03:13:29.042Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="Acetaldehyde - Blood"/>
+ <category term="LABTEST"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DAcetaldehyde+-+Blood/LABTEST"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/_cCCbQ0O3ug"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/_cCCbQ0O3ug"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>YWtomFb8aG.DueZ7z7fyug</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Results>
+ <Result>
+ <Type/>
+ <Description/>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance/>
+ <Test>
+ <DateTime>
+ <Type>
+ <Text>Collection start date</Text>
+ </Type>
+ <ExactDateTime>2008-09-03</ExactDateTime>
+ </DateTime>
+ <Type/>
+ <Description>
+ <Text>Acetaldehyde - Blood</Text>
+ </Description>
+ <Status/>
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier/>
+ <Units/>
+ </TestResult>
+ <ConfidenceValue/>
+ </Test>
+ </Result>
+ </Results>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/BdyA3iJZyCc</id>
+ <published>2008-09-29T03:00:45.915Z</published>
+ <updated>2008-09-29T03:00:45.915Z</updated>
+ <category scheme="http://schemas.google.com/health/item" term="Aortic valve disorders"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="CONDITION"/>
+ <title type="text">Aortic valve disorders</title>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DAortic+valve+disorders/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/CONDITION"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/BdyA3iJZyCc"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/BdyA3iJZyCc"/>
+ <author>
+ <name>example.com</name>
+ <uri>example.com</uri>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>h1ljpoeKJ85li.1FHsG9Gw</CCRDocumentObjectID>
+ <Body>
+ <Problems>
+ <Problem>
+ <CCRDataObjectID>Hn0FE0IlcY-FMFFgSTxkvA/CONDITION/0</CCRDataObjectID>
+ <DateTime>
+ <Type>
+ <Text>Start date</Text>
+ </Type>
+ <ExactDateTime>2007-04-04T07:00:00Z</ExactDateTime>
+ </DateTime>
+ <Description>
+ <Text>Aortic valve disorders</Text>
+ <Code>
+ <Value>410.10</Value>
+ <CodingSystem>ICD9</CodingSystem>
+ <Version>2004</Version>
+ </Code>
+ </Description>
+ <Status>
+ <Text>Active</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>example.com</ActorID>
+ <ActorRole>
+ <Text>Information Provider</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Problem>
+ </Problems>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/Cl.aMWIH5VA</id>
+ <published>2008-09-29T03:13:34.996Z</published>
+ <updated>2008-09-29T03:13:34.997Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="Chickenpox Vaccine"/>
+ <category term="IMMUNIZATION"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DChickenpox+Vaccine/IMMUNIZATION"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/Cl.aMWIH5VA"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/Cl.aMWIH5VA"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>KlhUqfftgELIitpKbqYalw</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Immunizations>
+ <Immunization>
+ <Type/>
+ <Description/>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>Chickenpox Vaccine</Text>
+ <Code>
+ <Value>21</Value>
+ <CodingSystem>HL7</CodingSystem>
+ </Code>
+ </ProductName>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description/>
+ <DeliveryMethod/>
+ </Direction>
+ </Directions>
+ <Refills/>
+ </Immunization>
+ </Immunizations>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/l0a7.FlX3_0</id>
+ <published>2008-09-29T03:14:47.461Z</published>
+ <updated>2008-09-29T03:14:47.461Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="DEMOGRAPHICS"/>
+ <category scheme="http://schemas.google.com/health/item" term="Demographics"/>
+ <title type="text">Demographics</title>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/DEMOGRAPHICS/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DDemographics"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/l0a7.FlX3_0"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/l0a7.FlX3_0"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>U5GDAVOxFbexQw3iyvqPYg</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body/>
+ <Actors>
+ <Actor>
+ <Person>
+ <Name>
+ <BirthName/>
+ <CurrentName/>
+ </Name>
+ <DateOfBirth>
+ <Type/>
+ <ExactDateTime>1984-07-22</ExactDateTime>
+ </DateOfBirth>
+ <Gender>
+ <Text>Male</Text>
+ </Gender>
+ </Person>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Actor>
+ </Actors>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/oIBDdgwFLyo</id>
+ <published>2008-09-29T03:14:47.690Z</published>
+ <updated>2008-09-29T03:14:47.691Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="DEMOGRAPHICS"/>
+ <category scheme="http://schemas.google.com/health/item" term="FunctionalStatus"/>
+ <title type="text">FunctionalStatus</title>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/DEMOGRAPHICS/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DFunctionalStatus"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/oIBDdgwFLyo"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/oIBDdgwFLyo"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>W.EJcnhxb7W5M4eR4Tr1YA</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <FunctionalStatus>
+ <Function>
+ <Type>
+ <Text>Pregnancy status</Text>
+ </Type>
+ <Description>
+ <Text>Not pregnant</Text>
+ </Description>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Function>
+ <Function>
+ <Type>
+ <Text>Breastfeeding status</Text>
+ </Type>
+ <Description>
+ <Text>Not breastfeeding</Text>
+ </Description>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ </Function>
+ </FunctionalStatus>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/wwljIlXuTVg</id>
+ <published>2008-09-29T03:26:10.080Z</published>
+ <updated>2008-09-29T03:26:10.081Z</updated>
+ <category term="MEDICATION"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="Lipitor"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/MEDICATION/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DLipitor"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/wwljIlXuTVg"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/wwljIlXuTVg"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>OrpghzvvbG_YaO5koqT2ug</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Medications>
+ <Medication>
+ <Type/>
+ <Description/>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Product>
+ <ProductName>
+ <Text>Lipitor</Text>
+ </ProductName>
+ <Strength>
+ <Units/>
+ <StrengthSequencePosition>0</StrengthSequencePosition>
+ <VariableStrengthModifier/>
+ </Strength>
+ </Product>
+ <Directions>
+ <Direction>
+ <Description/>
+ <DeliveryMethod/>
+ <Dose>
+ <Units/>
+ <DoseSequencePosition>0</DoseSequencePosition>
+ <VariableDoseModifier/>
+ </Dose>
+ <Route>
+ <Text>By mouth</Text>
+ <Code>
+ <Value>C38288</Value>
+ <CodingSystem>FDA</CodingSystem>
+ </Code>
+ <RouteSequencePosition>0</RouteSequencePosition>
+ <MultipleRouteModifier/>
+ </Route>
+ </Direction>
+ </Directions>
+ <Refills/>
+ </Medication>
+ </Medications>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/dd09TR12SiY</id>
+ <published>2008-09-29T07:52:17.175Z</published>
+ <updated>2008-09-29T07:52:17.176Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category scheme="http://schemas.google.com/health/item" term="Malaria"/>
+ <category term="CONDITION"/>
+ <title type="text"/>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DMalaria/CONDITION"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/dd09TR12SiY"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/dd09TR12SiY"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>XF99N6X4lpy.jfPUPLMMSQ</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <Problems>
+ <Problem>
+ <Type/>
+ <Description>
+ <Text>Malaria</Text>
+ <Code>
+ <Value>136.9</Value>
+ <CodingSystem>ICD9_Broader</CodingSystem>
+ </Code>
+ <Code>
+ <Value>084.6</Value>
+ <CodingSystem>ICD9</CodingSystem>
+ </Code>
+ </Description>
+ <Status>
+ <Text>ACTIVE</Text>
+ </Status>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <HealthStatus>
+ <Description/>
+ </HealthStatus>
+ </Problem>
+ </Problems>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/aS0Cf964DPs</id>
+ <published>2008-09-29T03:14:47.463Z</published>
+ <updated>2008-09-29T03:14:47.463Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="DEMOGRAPHICS"/>
+ <category scheme="http://schemas.google.com/health/item" term="SocialHistory (Drinking, Smoking)"/>
+ <title type="text">SocialHistory (Drinking, Smoking)</title>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/DEMOGRAPHICS/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DSocialHistory+%28Drinking%2C+Smoking%29"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/aS0Cf964DPs"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/aS0Cf964DPs"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>kXylGU5YXLBzriv61xPGZQ</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <SocialHistory>
+ <SocialHistoryElement>
+ <Type>
+ <Text>Race</Text>
+ <Code>
+ <Value>S15814</Value>
+ <CodingSystem>HL7</CodingSystem>
+ </Code>
+ </Type>
+ <Description>
+ <Text>White</Text>
+ </Description>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Episodes>
+ <Frequency>
+ <Units/>
+ </Frequency>
+ </Episodes>
+ </SocialHistoryElement>
+ </SocialHistory>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+<entry>
+ <id>https://www.google.com/health/feeds/profile/default/s5lII5xfj_g</id>
+ <published>2008-09-29T03:14:47.544Z</published>
+ <updated>2008-09-29T03:14:47.545Z</updated>
+ <category scheme="http://schemas.google.com/health/item" term="VitalSigns"/>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/health/kinds#profile"/>
+ <category term="DEMOGRAPHICS"/>
+ <title type="text">VitalSigns</title>
+ <content type="html"/>
+ <link rel="http://schemas.google.com/health/data#complete" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/-/%7Bhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fitem%7DVitalSigns/%7Bhttp%3A%2F%2Fschemas.google.com%2Fg%2F2005%23kind%7Dhttp%3A%2F%2Fschemas.google.com%2Fhealth%2Fkinds%23profile/DEMOGRAPHICS"/>
+ <link rel="self" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/s5lII5xfj_g"/>
+ <link rel="edit" type="application/atom+xml" href="https://www.google.com/health/feeds/profile/default/s5lII5xfj_g"/>
+ <author>
+ <name>User Name</name>
+ <email>user@gmail.com</email>
+ </author>
+ <ContinuityOfCareRecord xmlns="urn:astm-org:CCR">
+ <CCRDocumentObjectID>FTTIiY0TVVj35kZqFFjPjQ</CCRDocumentObjectID>
+ <Language/>
+ <DateTime>
+ <Type/>
+ </DateTime>
+ <Patient/>
+ <Body>
+ <VitalSigns>
+ <Result>
+ <Type/>
+ <Description/>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance/>
+ <Test>
+ <Type/>
+ <Description>
+ <Text>Height</Text>
+ </Description>
+ <Status/>
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier/>
+ <Value>70</Value>
+ <Units>
+ <Unit>inches</Unit>
+ </Units>
+ </TestResult>
+ <ConfidenceValue/>
+ </Test>
+ </Result>
+ <Result>
+ <Type/>
+ <Description/>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance/>
+ <Test>
+ <Type/>
+ <Description>
+ <Text>Weight</Text>
+ </Description>
+ <Status/>
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier/>
+ <Value>2480</Value>
+ <Units>
+ <Unit>ounces</Unit>
+ </Units>
+ </TestResult>
+ <ConfidenceValue/>
+ </Test>
+ </Result>
+ <Result>
+ <Type/>
+ <Description/>
+ <Status/>
+ <Source>
+ <Actor>
+ <ActorID>user@gmail.com</ActorID>
+ <ActorRole>
+ <Text>Patient</Text>
+ </ActorRole>
+ </Actor>
+ </Source>
+ <Substance/>
+ <Test>
+ <Type/>
+ <Description>
+ <Text>Blood Type</Text>
+ </Description>
+ <Status/>
+ <TestResult>
+ <ResultSequencePosition>0</ResultSequencePosition>
+ <VariableResultModifier/>
+ <Value>O+</Value>
+ <Units/>
+ </TestResult>
+ <ConfidenceValue/>
+ </Test>
+ </Result>
+ </VitalSigns>
+ </Body>
+ </ContinuityOfCareRecord>
+</entry>
+</feed>"""
+
+HEALTH_PROFILE_LIST_ENTRY = """ <entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'>
+ <id>
+ https://www.google.com/health/feeds/profile/list/vndCn5sdfwdEIY</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <title type='text'>profile name</title>
+ <content type='text'>vndCn5sdfwdEIY</content>
+ <link rel='self' type='application/atom+xml'
+ href='https://www.google.com/health/feeds/profile/list/vndCn5sdfwdEIY' />
+ <link rel='edit' type='application/atom+xml'
+ href='https://www.google.com/health/feeds/profile/list/vndCn5sdfwdEIY' />
+ <author>
+ <name>user@gmail.com</name>
+ </author>
+</entry>"""
+
+BOOK_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>"""\
+ """<entry xmlns='http://www.w3.org/2005/Atom' xmlns:gbs='http://schemas.google.com/books/2008' xmlns:dc='http://purl.org/dc/terms' xmlns:gd='http://schemas.google.com/g/2005'>"""\
+ """<id>http://www.google.com/books/feeds/volumes/b7GZr5Btp30C</id>"""\
+ """<updated>2009-04-24T23:35:16.000Z</updated>"""\
+ """<category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/books/2008#volume'/>"""\
+ """<title type='text'>A theory of justice</title>"""\
+ """<link rel='http://schemas.google.com/books/2008/thumbnail' type='image/x-unknown' href='http://bks0.books.google.com/books?id=b7GZr5Btp30C&printsec=frontcover&img=1&zoom=5&sig=ACfU3U121bWZsbjBfVwVRSK2o982jJTd1w&source=gbs_gdata'/>"""\
+ """<link rel='http://schemas.google.com/books/2008/info' type='text/html' href='http://books.google.com/books?id=b7GZr5Btp30C&ie=ISO-8859-1&source=gbs_gdata'/>"""\
+ """<link rel='http://schemas.google.com/books/2008/annotation' type='application/atom+xml' href='http://www.google.com/books/feeds/users/me/volumes'/>"""\
+ """<link rel='alternate' type='text/html' href='http://books.google.com/books?id=b7GZr5Btp30C&ie=ISO-8859-1'/>"""\
+ """<link rel='self' type='application/atom+xml' href='http://www.google.com/books/feeds/volumes/b7GZr5Btp30C'/>"""\
+ """<gbs:embeddability value='http://schemas.google.com/books/2008#embeddable'/>"""\
+ """<gbs:openAccess value='http://schemas.google.com/books/2008#disabled'/>"""\
+ """<gd:rating min='1' max='5' average='4.00'/>"""\
+ """<gbs:viewability value='http://schemas.google.com/books/2008#view_partial'/>"""\
+ """<dc:creator>John Rawls</dc:creator>"""\
+ """<dc:date>1999</dc:date>"""\
+ """<dc:description>p Since it appeared in 1971, John Rawls's i A Theory of Justice /i has become a classic. The author has now revised the original edition to clear up a number of difficulties he and others have found in the original book. /p p Rawls aims to express an essential part of the common core of the democratic tradition--justice as fairness--and to provide an alternative to utilitarianism, which had dominated the Anglo-Saxon tradition of political thought since the nineteenth century. Rawls substitutes the ideal of the social contract as a more satisfactory account of the basic rights and liberties of citizens as free and equal persons. "Each person," writes Rawls, "possesses an inviolability founded on justice that even the welfare of society as a whole cannot override." Advancing the ideas of Rousseau, Kant, Emerson, and Lincoln, Rawls's theory is as powerful today as it was when first published. /p</dc:description>"""\
+ """<dc:format>538 pages</dc:format>"""\
+ """<dc:identifier>b7GZr5Btp30C</dc:identifier>"""\
+ """<dc:identifier>ISBN:0198250541</dc:identifier>"""\
+ """<dc:identifier>ISBN:9780198250548</dc:identifier>"""\
+ """<dc:language>en</dc:language>"""\
+ """<dc:publisher>Oxford University Press</dc:publisher>"""\
+ """<dc:title>A theory of justice</dc:title>"""\
+"""</entry>"""
+
+BOOK_FEED = """<?xml version='1.0' encoding='UTF-8'?>"""\
+ """<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gbs='http://schemas.google.com/books/2008' xmlns:dc='http://purl.org/dc/terms' xmlns:gd='http://schemas.google.com/g/2005'>"""\
+ """<id>http://www.google.com/books/feeds/volumes</id>"""\
+ """<updated>2009-04-24T23:39:47.000Z</updated>"""\
+ """<category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/books/2008#volume'/>"""\
+ """<title type='text'>Search results for 9780198250548</title>"""\
+ """<link rel='alternate' type='text/html' href='http://www.google.com'/>"""\
+ """<link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='http://www.google.com/books/feeds/volumes'/>"""\
+ """<link rel='self' type='application/atom+xml' href='http://www.google.com/books/feeds/volumes?q=9780198250548'/>"""\
+ """<author>"""\
+ """<name>Google Books Search</name>"""\
+ """<uri>http://www.google.com</uri>"""\
+ """</author>"""\
+ """<generator version='beta'>Google Book Search data API</generator>"""\
+ """<openSearch:totalResults>1</openSearch:totalResults>"""\
+ """<openSearch:startIndex>1</openSearch:startIndex>"""\
+ """<openSearch:itemsPerPage>20</openSearch:itemsPerPage>"""\
+ """<entry>"""\
+ """<id>http://www.google.com/books/feeds/volumes/b7GZr5Btp30C</id>"""\
+ """<updated>2009-04-24T23:39:47.000Z</updated>"""\
+ """<category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/books/2008#volume'/>"""\
+ """<title type='text'>A theory of justice</title>"""\
+ """<link rel='http://schemas.google.com/books/2008/thumbnail' type='image/x-unknown' href='http://bks9.books.google.com/books?id=b7GZr5Btp30C&printsec=frontcover&img=1&zoom=5&sig=ACfU3U121bWZsbjBfVwVRSK2o982jJTd1w&source=gbs_gdata'/>"""\
+ """<link rel='http://schemas.google.com/books/2008/info' type='text/html' href='http://books.google.com/books?id=b7GZr5Btp30C&dq=9780198250548&ie=ISO-8859-1&source=gbs_gdata'/>"""\
+ """<link rel='http://schemas.google.com/books/2008/preview' type='text/html' href='http://books.google.com/books?id=b7GZr5Btp30C&pg=PA494&dq=9780198250548&ie=ISO-8859-1&source=gbs_gdata'/>"""\
+ """<link rel='http://schemas.google.com/books/2008/annotation' type='application/atom+xml' href='http://www.google.com/books/feeds/users/me/volumes'/>"""\
+ """<link rel='alternate' type='text/html' href='http://books.google.com/books?id=b7GZr5Btp30C&dq=9780198250548&ie=ISO-8859-1'/>"""\
+ """<link rel='self' type='application/atom+xml' href='http://www.google.com/books/feeds/volumes/b7GZr5Btp30C'/>"""\
+ """<gbs:embeddability value='http://schemas.google.com/books/2008#embeddable'/>"""\
+ """<gbs:openAccess value='http://schemas.google.com/books/2008#disabled'/>"""\
+ """<gbs:viewability value='http://schemas.google.com/books/2008#view_partial'/>"""\
+ """<dc:creator>John Rawls</dc:creator>"""\
+ """<dc:date>1999</dc:date>"""\
+ """<dc:description>... 9780198250548 ...</dc:description>"""\
+ """<dc:format>538 pages</dc:format>"""\
+ """<dc:identifier>b7GZr5Btp30C</dc:identifier>"""\
+ """<dc:identifier>ISBN:0198250541</dc:identifier>"""\
+ """<dc:identifier>ISBN:9780198250548</dc:identifier>"""\
+ """<dc:subject>Law</dc:subject>"""\
+ """<dc:title>A theory of justice</dc:title>"""\
+ """</entry>"""\
+"""</feed>"""
+
+MAP_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CkIESHg4eSp7ImA9WxJbF08."">
+ <id>http://maps.google.com/maps/feeds/maps/208825816854482607313</id>
+ <updated>2009-07-27T18:48:29.631Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#map"/>
+ <title>My maps</title>
+ <link rel="alternate" type="text/html" href="http://maps.google.com/maps/ms?msa=1"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full"/>
+ <link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full"/>
+ <link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full/batch"/>
+ <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full"/>
+ <author>
+ <name>Roman</name>
+ </author>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1</openSearch:itemsPerPage>
+ <entry gd:etag="W/"CkIESHg4eSp7ImA9WxJbF08."">
+ <id>http://maps.google.com/maps/feeds/maps/208825816854482607313/00046fb45f88fa910bcea</id>
+ <published>2009-07-27T18:46:34.451Z</published>
+ <updated>2009-07-27T18:48:29.631Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:48:29.631Z</app:edited>
+ <app:control xmlns:app="http://www.w3.org/2007/app">
+ <app:draft>yes</app:draft>
+ </app:control>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#map"/>
+ <title>Untitled</title>
+ <summary/>
+ <content src="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full"/>
+ <link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full/00046fb45f88fa910bcea"/>
+ <link rel="alternate" type="text/html" href="http://maps.google.com/maps/ms?msa=0&msid=208825816854482607313.00046fb45f88fa910bcea"/>
+ <link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full/00046fb45f88fa910bcea"/>
+ <author>
+ <name>Roman</name>
+ </author>
+ </entry>
+</feed>
+"""
+
+MAP_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns="http://www.w3.org/2005/Atom" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CkIESHg4eSp7ImA9WxJbF08."">
+ <id>http://maps.google.com/maps/feeds/maps/208825816854482607313/00046fb45f88fa910bcea</id>
+ <published>2009-07-27T18:46:34.451Z</published>
+ <updated>2009-07-27T18:48:29.631Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:48:29.631Z</app:edited>
+ <app:control xmlns:app="http://www.w3.org/2007/app">
+ <app:draft>yes</app:draft>
+ </app:control>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#map"/>
+ <title>Untitled</title>
+ <summary/>
+ <content src="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full"/>
+ <link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full/00046fb45f88fa910bcea"/>
+ <link rel="alternate" type="text/html" href="http://maps.google.com/maps/ms?msa=0&msid=208825816854482607313.00046fb45f88fa910bcea"/>
+ <link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/maps/208825816854482607313/full/00046fb45f88fa910bcea"/>
+ <author>
+ <name>Roman</name>
+ </author>
+</entry>
+"""
+
+MAP_FEATURE_FEED = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:feed xmlns="http://www.opengis.net/kml/2.2" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CkIESHg4eSp7ImA9WxJbF08."">
+ <atom:id>http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea</atom:id>
+ <atom:updated>2009-07-27T18:48:29.631Z</atom:updated>
+ <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#feature"/>
+ <atom:title>Untitled</atom:title>
+ <atom:link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full"/>
+ <atom:link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full"/>
+ <atom:link rel="http://schemas.google.com/g/2005#batch" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/batch"/>
+ <atom:link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full"/>
+ <openSearch:totalResults>4</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>4</openSearch:itemsPerPage>
+ <atom:entry gd:etag="W/"CkMBRH44fyp7ImA9WxJbF08."">
+ <atom:id>http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/00046fb4632573b19e0b7</atom:id>
+ <atom:published>2009-07-27T18:47:35.037Z</atom:published>
+ <atom:updated>2009-07-27T18:47:35.037Z</atom:updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:47:35.037Z</app:edited>
+ <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#feature"/>
+ <atom:title>Some feature title</atom:title>
+ <atom:content type="application/vnd.google-earth.kml+xml">
+ <Placemark>
+ <name>Some feature title</name>
+ <description><![CDATA[<div dir="ltr">Some feature content</div>]]></description>
+ <Style>
+ <IconStyle>
+ <Icon>
+ <href>http://maps.gstatic.com/intl/en_us/mapfiles/ms/micons/ylw-pushpin.png</href>
+ </Icon>
+ </IconStyle>
+ </Style>
+ <Point>
+ <coordinates>-113.818359,41.442726,0.0</coordinates>
+ </Point>
+ </Placemark>
+ </atom:content>
+ <atom:link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb4632573b19e0b7"/>
+ <atom:link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb4632573b19e0b7"/>
+ <atom:author>
+ <atom:name>Roman</atom:name>
+ </atom:author>
+ <atom:contributor>
+ <atom:name>Roman</atom:name>
+ </atom:contributor>
+ </atom:entry>
+ <atom:entry gd:etag="W/"CkIEQ38zfCp7ImA9WxJbF08."">
+ <atom:id>http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/00046fb46325e839a11e6</atom:id>
+ <atom:published>2009-07-27T18:47:35.067Z</atom:published>
+ <atom:updated>2009-07-27T18:48:22.184Z</atom:updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:48:22.184Z</app:edited>
+ <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#feature"/>
+ <atom:title>A cool poly!</atom:title>
+ <atom:content type="application/vnd.google-earth.kml+xml">
+ <Placemark>
+ <name>A cool poly!</name>
+ <description><![CDATA[<div dir="ltr">And a description</div>]]></description>
+ <Style>
+ <LineStyle>
+ <color>FF0066FF</color>
+ <width>3</width>
+ </LineStyle>
+ <PolyStyle>
+ <color>730099FF</color>
+ <fill>1</fill>
+ <outline>1</outline>
+ </PolyStyle>
+ </Style>
+ <Polygon>
+ <outerBoundaryIs>
+ <LinearRing>
+ <tessellate>1</tessellate>
+ <coordinates>-109.775391,47.457809,0.0 -99.755859,51.508742,0.0 -92.900391,48.04871,0.0 -92.8125,44.339565,0.0 -95.273437,44.402392,0.0 -97.207031,46.619261,0.0 -100.898437,46.073231,0.0 -102.480469,43.068888,0.0 -110.742187,45.274886,0.0 -109.775391,47.457809,0.0 </coordinates>
+ </LinearRing>
+ </outerBoundaryIs>
+ </Polygon>
+ </Placemark>
+ </atom:content>
+ <atom:link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb46325e839a11e6"/>
+ <atom:link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb46325e839a11e6"/>
+ <atom:author>
+ <atom:name>Roman</atom:name>
+ </atom:author>
+ <atom:contributor>
+ <atom:name>Roman</atom:name>
+ </atom:contributor>
+ </atom:entry>
+ <atom:entry gd:etag="W/"CkIEQ38yfCp7ImA9WxJbF08."">
+ <atom:id>http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/00046fb465f5002e56b7a</atom:id>
+ <atom:published>2009-07-27T18:48:22.194Z</atom:published>
+ <atom:updated>2009-07-27T18:48:22.194Z</atom:updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:48:22.194Z</app:edited>
+ <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#feature"/>
+ <atom:title>New Mexico</atom:title>
+ <atom:content type="application/vnd.google-earth.kml+xml">
+ <Placemark>
+ <name>New Mexico</name>
+ <description><![CDATA[<div dir="ltr">Word.</div>]]></description>
+ <Style>
+ <LineStyle>
+ <color>73009900</color>
+ <width>5</width>
+ </LineStyle>
+ </Style>
+ <LineString>
+ <tessellate>1</tessellate>
+ <coordinates>-110.039062,37.788081,0.0 -103.183594,37.926868,0.0 -103.183594,32.472695,0.0 -108.896484,32.026706,0.0 -109.863281,31.203405,0.0 -110.039062,37.788081,0.0 </coordinates>
+ </LineString>
+ </Placemark>
+ </atom:content>
+ <atom:link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb465f5002e56b7a"/>
+ <atom:link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb465f5002e56b7a"/>
+ <atom:author>
+ <atom:name>Roman</atom:name>
+ </atom:author>
+ <atom:contributor>
+ <atom:name>Roman</atom:name>
+ </atom:contributor>
+ </atom:entry>
+</atom:feed>
+"""
+
+MAP_FEATURE_ENTRY = """<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns="http://www.opengis.net/kml/2.2" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"CkMBRH44fyp7ImA9WxJbF08."">
+ <atom:id>http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/00046fb4632573b19e0b7</atom:id>
+ <atom:published>2009-07-27T18:47:35.037Z</atom:published>
+ <atom:updated>2009-07-27T18:47:35.037Z</atom:updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-07-27T18:47:35.037Z</app:edited>
+ <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/maps/2008#feature"/>
+ <atom:title>Some feature title</atom:title>
+ <atom:content type="application/vnd.google-earth.kml+xml">
+ <Placemark>
+ <name>Some feature title</name>
+ <description><![CDATA[<div dir="ltr">Some feature content</div>]]></description>
+ <Style>
+ <IconStyle>
+ <Icon>
+ <href>http://maps.gstatic.com/intl/en_us/mapfiles/ms/micons/ylw-pushpin.png</href>
+ </Icon>
+ </IconStyle>
+ </Style>
+ <Point>
+ <coordinates>-113.818359,41.442726,0.0</coordinates>
+ </Point>
+ </Placemark>
+ </atom:content>
+ <atom:link rel="self" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb4632573b19e0b7"/>
+ <atom:link rel="edit" type="application/atom+xml" href="http://maps.google.com/maps/feeds/features/208825816854482607313/00046fb45f88fa910bcea/full/00046fb4632573b19e0b7"/>
+ <atom:author>
+ <atom:name>Roman</atom:name>
+ </atom:author>
+ <atom:contributor>
+ <atom:name>Roman</atom:name>
+ </atom:contributor>
+</atom:entry>
+"""
+
+MAP_FEATURE_KML = """<Placemark>
+ <name>Some feature title</name>
+ <description><![CDATA[<div dir="ltr">Some feature content</div>]]></description>
+ <Style>
+ <IconStyle>
+ <Icon>
+ <href>http://maps.gstatic.com/intl/en_us/mapfiles/ms/micons/ylw-pushpin.png</href>
+ </Icon>
+ </IconStyle>
+ </Style>
+ <Point>
+ <coordinates>-113.818359,41.442726,0.0</coordinates>
+ </Point>
+</Placemark>
+"""
+
+SITES_LISTPAGE_ENTRY = '''<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns="http://www.w3.org/2005/Atom">
+ <id>http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703</id>
+ <updated>2009-06-16T00:37:37.393Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#listpage"/>
+ <title type="text">ListPagesTitle</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <jot:section xmlns:jot="http://www.google.com/ns/jotspot/srvtmpl/" target="content-1">
+ <div dir="ltr">stuff go here<div>asdf</div>
+ <div>sdf</div>
+ <div>
+ <br/>
+ </div>
+ </div>
+ </jot:section>
+ </div>
+ </content>
+ <link rel="self" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703"/>
+ <link rel="edit" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <gs:worksheet xmlns:gs="http://schemas.google.com/spreadsheets/2006" name="listpage"/>
+ <gs:header xmlns:gs="http://schemas.google.com/spreadsheets/2006" row="1"/>
+ <gs:data xmlns:gs="http://schemas.google.com/spreadsheets/2006" startRow="2">
+ <gs:column index="A" name="Owner"/>
+ <gs:column index="B" name="Description"/>
+ <gs:column index="C" name="Resolution"/>
+ <gs:column index="D" name="Complete"/>
+ <gs:column index="E" name="MyCo"/>
+ </gs:data>
+ <gd:feedLink xmlns:gd="http://schemas.google.com/g/2005" href="http:///sites.google.com/feeds/content/site/gdatatestsite?parent=abc"/>
+</entry>'''
+
+SITES_COMMENT_ENTRY = '''<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns="http://www.w3.org/2005/Atom">
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-15T18:40:22.407Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#comment"/>
+ <title type="text"/>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">first comment</div>
+ </content>
+ <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123parent"/>
+ <link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <thr:in-reply-to xmlns:thr="http://purl.org/syndication/thread/1.0" href="http://sites.google.com/site/gdatatestsite/annoucment/testpost" ref="http://sites.google.com/feeds/content/site/gdatatestsite/abc123" source="http://sites.google.com/feeds/content/site/gdatatestsite" type="text/html"/>
+</entry>'''
+
+SITES_LISTITEM_ENTRY = '''<?xml version="1.0" encoding="UTF-8"?>
+<entry xmlns="http://www.w3.org/2005/Atom">
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-16T00:34:55.633Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#listitem"/>
+ <title type="text"/>
+ <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123def"/>
+ <link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="A" name="Owner">test value</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="B" name="Description">test</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="C" name="Resolution">90</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="D" name="Complete"/>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="E" name="MyCo">2009-05-31</gs:field>
+</entry>'''
+
+SITES_CONTENT_FEED = '''<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
+xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006"
+xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch"
+xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0">
+<id>http://sites.google.com/feeds/content/site/gdatatestsite</id>
+<updated>2009-06-15T21:35:43.282Z</updated>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite"/>
+<link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite"/>
+<generator version="1" uri="http://sites.google.com">Google Sites</generator>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+ <id>http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703</id>
+ <updated>2009-06-16T00:37:37.393Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#listpage"/>
+ <title type="text">ListPagesTitle</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <jot:section xmlns:jot="http://www.google.com/ns/jotspot/srvtmpl/" target="content-1">
+ <div dir="ltr">stuff go here<div>asdf</div>
+ <div>sdf</div>
+ <div>
+ <br/>
+ </div>
+ </div>
+ </jot:section>
+ </div>
+ </content>
+ <link rel="alternate" type="text/html" href="http:///sites.google.com/site/gdatatestsite/asdfsdfsdf"/>
+ <link rel="self" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703"/>
+ <link rel="edit" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/1712987567114738703"/>
+ <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/12345"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <gs:worksheet xmlns:gs="http://schemas.google.com/spreadsheets/2006" name="listpage"/>
+ <gs:header xmlns:gs="http://schemas.google.com/spreadsheets/2006" row="1"/>
+ <gs:data xmlns:gs="http://schemas.google.com/spreadsheets/2006" startRow="2">
+ <gs:column index="A" name="Owner"/>
+ <gs:column index="B" name="Description"/>
+ <gs:column index="C" name="Resolution"/>
+ <gs:column index="D" name="Complete"/>
+ <gs:column index="E" name="MyCo"/>
+ </gs:data>
+ <sites:revision>2</sites:revision>
+ <gd:deleted/>
+ <sites:pageName>home</sites:pageName>
+ <gd:feedLink xmlns:gd="http://schemas.google.com/g/2005" href="http://sites.google.com/feeds/content/site/gdatatestsite?parent=abc"/>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-17T00:40:37.082Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#filecabinet"/>
+ <title type="text">filecabinet</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <jot:section xmlns:jot="http://www.google.com/ns/jotspot/srvtmpl/" target="content-1">
+ <div dir="ltr">sdf</div>
+ </jot:section>
+</div>
+</content>
+<link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+<gd:feedLink xmlns:gd="http://schemas.google.com/g/2005" href="http://sites.google.com/feeds/content/site/gdatatestsite?parent=8472761212299270332"/>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-16T00:34:55.633Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#listitem"/>
+ <title type="text"/>
+ <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123def"/>
+ <link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="A" name="Owner">test value</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="B" name="Description">test</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="C" name="Resolution">90</gs:field>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="D" name="Complete"/>
+ <gs:field xmlns:gs="http://schemas.google.com/spreadsheets/2006" index="E" name="MyCo">2009-05-31</gs:field>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-15T18:40:32.922Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#attachment"/>
+ <title type="text">testFile.ods</title>
+ <link rel="alternate" type="application/vnd.oasis.opendocument.spreadsheet" href="http://sites.google.com/feeds/SOMELONGURL"/>
+ <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <gd:deleted/>
+ <sites:pageName>something else</sites:pageName>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-15T18:40:22.407Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#comment"/>
+ <title type="text"/>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">first comment</div>
+ </content>
+ <link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+ <author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+ </author>
+ <thr:in-reply-to xmlns:thr="http://purl.org/syndication/thread/1.0" href="http://sites.google.com/site/gdatatestsite/annoucment/testpost" ref="http://sites.google.com/feeds/content/site/gdatatestsite/abc123" source="http://sites.google.com/feeds/content/site/gdatatestsite" type="text/html"/>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-15T18:40:16.388Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#announcement"/>
+ <title type="text">TestPost</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <jot:section xmlns:jot="http://www.google.com/ns/jotspot/srvtmpl/" target="content-1">
+ <div dir="ltr">content goes here</div>
+ </jot:section>
+</div>
+</content>
+<link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+</author>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/abc123</id>
+ <updated>2009-06-12T23:37:59.417Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#webpage"/>
+ <title type="text">Home</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <jot:section xmlns:jot="http://www.google.com/ns/jotspot/srvtmpl/" target="content-1">
+ <div dir="ltr">Some Content goes here<div>
+ <br/>
+ </div>
+ <div>
+ <jot:embed height="300" id="4981865780428052" props="align:left;width:250;maxDepth:6" src="http://www.google.com/chart?SOMELONGURL" style="display: block; text-align: left; " type="toc" width="250"/>
+ <br/>
+ </div>
+</div>
+</jot:section>
+</div>
+</content>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+</author>
+</entry>
+<entry>
+ <id>http://sites.google.com/feeds/content/site/gdatatestsite/2639323850129333500</id>
+ <updated>2009-06-12T23:32:09.191Z</updated>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#announcementspage"/>
+ <title type="text">annoucment</title>
+ <content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ </div>
+</content>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="edit" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http:///sites.google.com/feeds/content/site/gdatatestsite/abc123"/>
+<author>
+ <name>Test User</name>
+ <email>test@gmail.com</email>
+</author>
+<gd:feedLink xmlns:gd="http://schemas.google.com/g/2005" href="http://sites.google.com/feeds/content/site/gdatatestsite?parent=abc123"/>
+</entry>
+</feed>'''
+
+SITES_ACTIVITY_FEED = '''<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/">
+<id>http://sites.google.com/feeds/activity/site/siteName</id>
+<updated>2009-08-19T05:46:01.503Z</updated>
+<title>Activity</title>
+<link rel="alternate" type="text/html" href="http://sites.google.com/a/site/siteName/system/app/pages/recentChanges"/>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://sites.google.com/feeds/activity/site/siteName"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/activity/site/siteName"/>
+<generator version="1" uri="http://sites.google.com">Google Sites</generator>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"DUENSH0zfyl7ImA9WxNTFEs."">
+<id>http://sites.google.com/feeds/activity/site/siteName/197441951793148343</id>
+<updated>2009-08-17T00:08:19.387Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#deletion" label="deletion"/>
+<title>NewWebpage3</title>
+<summary type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">User deleted <a href="http://sites.google.com/site/siteName/newwebpage">NewWebpage3</a>
+</div>
+</summary>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http://sites.google.com/feeds/revision/site/siteName/6397361387376148502"/>
+<link rel="http://schemas.google.com/sites/2008#current" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/siteName/6397361387376148502"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/activity/site/siteName/197441951793148343"/>
+<author>
+ <name>User</name>
+ <email>user@gmail.com</email>
+</author>
+</entry>
+<entry xmlns:gd="http://schemas.google.com/g/2005" gd:etag="W/"DUEMQnk6eSl7ImA9WxNTFEs."">
+<id>http://sites.google.com/feeds/activity/site/siteName/7299542210274956360</id>
+<updated>2009-08-17T00:08:03.711Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#edit" label="edit"/>
+<title>NewWebpage3</title>
+<summary type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">User edited <a href="http://sites.google.com/site/siteName/newwebpage">NewWebpage3</a>
+</div>
+</summary>
+<link rel="http://schemas.google.com/sites/2008#revision" type="application/atom+xml" href="http://sites.google.com/feeds/revision/site/siteName/6397361387376148502"/>
+<link rel="http://schemas.google.com/sites/2008#current" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/siteName/6397361387376148502"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/activity/site/siteName/7299542210274956360"/>
+<author>
+ <name>User</name>
+ <email>user@gmail.com</email>
+</author>
+</entry>
+</feed>'''
+
+SITES_REVISION_FEED = '''
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0">
+<id>http://sites.google.com/feeds/revision/site/siteName/2947510322163358574</id>
+<updated>2009-08-19T06:20:18.151Z</updated>
+<title>Revisions</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="http://sites.google.com/feeds/revision/2947510322163358574"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/revision/site/siteName/2947510322163358574"/>
+<generator version="1" uri="http://sites.google.com">Google Sites</generator>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry gd:etag="W/"DEQNRXY-fil7ImA9WxNTFkg."">
+<id>http://sites.google.com/feeds/revision/site/siteName/2947510322163358574/1</id>
+<updated>2009-08-19T04:33:14.856Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/sites/2008#comment" label="comment"/>
+<title/>
+<content type="xhtml">
+ <div xmlns="http://www.w3.org/1999/xhtml">
+ <table cellspacing="0" class="sites-layout-name-one-column sites-layout-hbox">
+ <tbody>
+ <tr>
+ <td class="sites-layout-tile sites-tile-name-content-1">testcomment</td>
+ </tr>
+ </tbody>
+ </table>
+</div>
+</content>
+<link rel="http://schemas.google.com/sites/2008#parent" type="application/atom+xml" href="http://sites.google.com/feeds/content/site/siteName/54395424125706119"/>
+<link rel="alternate" type="text" href="http://sites.google.com/site/system/app/pages/admin/compare?wuid=wuid%3Agx%3A28e7a9057c581b6e&rev1=1"/>
+<link rel="self" type="application/atom+xml" href="http://sites.google.com/feeds/revision/site/siteName/2947510322163358574/1"/>
+<author>
+ <name>User</name>
+ <email>user@gmail.com</email>
+</author>
+<thr:in-reply-to href="http://sites.google.com/site/siteName/code/js" ref="http://sites.google.com/feeds/content/site/siteName/54395424125706119" source="http://sites.google.com/feeds/content/google.com/siteName" type="text/html;charset=UTF-8"/>
+<sites:revision>1</sites:revision>
+</entry>
+</feed>'''
+
+SITES_SITE_FEED = '''
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:gAcl="http://schemas.google.com/acl/2007" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0">
+<id>https://sites.google.com/feeds/site/example.com</id>
+<updated>2009-12-09T01:05:54.631Z</updated>
+<title>Site</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com"/>
+<link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com"/>
+<link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com"/>
+<generator version="1" uri="http://sites.google.com">Google Sites</generator>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry gd:etag="W/"DkIHQH4_eCl7I2A9WxNaF0Q."">
+<id>https://sites.google.com/feeds/site/example.com/new-test-site</id>
+<updated>2009-12-02T22:55:31.040Z</updated>
+<app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-02T22:55:31.040Z</app:edited>
+<title>New Test Site</title>
+<summary>A new site to hold memories</summary>
+<link rel="alternate" type="text/html" href="http://sites.google.com/a/example.com/new-test-site/"/>
+<link rel="http://schemas.google.com/sites/2008#source" type="application/atom+xml" href="http://sites.google.com/feeds/site/example.com/source-site"/>
+<link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="http://sites.google.com/feeds/acl/site/example.com/new-test-site"/>
+<link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/new-test-site"/>
+<link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/new-test-site"/>
+<sites:siteName>new-test-site</sites:siteName>
+<sites:theme>iceberg</sites:theme>
+</entry>
+<entry gd:etag="W/"CE8MQH48fyl7I2A9WxNaGUo."">
+<id>https://sites.google.com/feeds/site/example.com/newautosite2</id>
+<updated>2009-12-05T00:28:01.077Z</updated>
+<app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-05T00:28:01.077Z</app:edited>
+<title>newAutoSite3</title>
+<summary>A new site to hold memories2</summary>
+<link rel="alternate" type="text/html" href="http://sites.google.com/a/example.com/newautosite2/"/>
+<link rel="http://schemas.google.com/acl/2007#accessControlList" type="application/atom+xml" href="http://sites.google.com/feeds/acl/site/examp.e.com/newautosite2"/>
+<link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/newautosite2"/>
+<link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/site/example.com/newautosite2"/>
+<sites:siteName>newautosite2</sites:siteName>
+<sites:theme>default</sites:theme>
+</entry>
+</feed>'''
+
+SITES_ACL_FEED = '''
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:gAcl="http://schemas.google.com/acl/2007" xmlns:sites="http://schemas.google.com/sites/2008" xmlns:gs="http://schemas.google.com/spreadsheets/2006" xmlns:dc="http://purl.org/dc/terms" xmlns:batch="http://schemas.google.com/gdata/batch" xmlns:gd="http://schemas.google.com/g/2005" xmlns:thr="http://purl.org/syndication/thread/1.0">
+<id>https://sites.google.comsites.google.com/feeds/acl/site/example.com/new-test-site</id>
+<updated>2009-12-09T01:24:59.080Z</updated>
+<category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/>
+<title>Acl</title>
+<link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/new-test-site"/>
+<link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/new-test-site"/>
+<link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/new-test-site"/>
+<generator version="1" uri="http://sites.google.com">Google Sites</generator>
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+ <id>https://sites.google.com/feeds/acl/site/google.com/new-test-site/user%3Auser%40example.com</id>
+ <updated>2009-12-09T01:24:59.080Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">2009-12-09T01:24:59.080Z</app:edited>
+ <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/acl/2007#accessRule"/>
+ <link rel="self" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/new-test-site/user%3Auser%40example.com"/>
+ <link rel="edit" type="application/atom+xml" href="https://sites.google.com/feeds/acl/site/example.com/new-test-site/user%3Auser%40example.com"/>
+ <gAcl:scope type="user" value="user@example.com"/>
+ <gAcl:role value="owner"/>
+</entry>
+</feed>'''
+
+ANALYTICS_ACCOUNT_FEED_old = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:dxp='http://schemas.google.com/analytics/2009'>
+<id>http://www.google.com/analytics/feeds/accounts/abc@test.com</id>
+<updated>2009-06-25T03:55:22.000-07:00</updated>
+<title type='text'>Profile list for abc@test.com</title>
+<link rel='self' type='application/atom+xml' href='http://www.google.com/analytics/feeds/accounts/default'/>
+<author>
+<name>Google Analytics</name>
+</author>
+<generator version='1.0'>Google Analytics</generator>
+<openSearch:totalResults>12</openSearch:totalResults>
+<openSearch:startIndex>1</openSearch:startIndex>
+<openSearch:itemsPerPage>12</openSearch:itemsPerPage>
+<entry>
+<id>http://www.google.com/analytics/feeds/accounts/ga:1174</id>
+<updated>2009-06-25T03:55:22.000-07:00</updated>
+<title type='text'>www.googlestore.com</title>
+<link rel='alternate' type='text/html' href='http://www.google.com/analytics'/>
+<dxp:tableId>ga:1174</dxp:tableId>
+<dxp:property name='ga:accountId' value='30481'/>
+<dxp:property name='ga:accountName' value='Google Store'/>
+<dxp:property name='ga:profileId' value='1174'/>
+<dxp:property name='ga:webPropertyId' value='UA-30481-1'/>
+<dxp:property name='ga:currency' value='USD'/>
+<dxp:property name='ga:timezone' value='America/Los_Angeles'/>
+</entry>
+</feed>'''
+
+ANALYTICS_ACCOUNT_FEED = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:dxp='http://schemas.google.com/analytics/2009' xmlns:ga='http://schemas.google.com/ga/2009' xmlns:openSearch='http://a9.com/-/spec/opensearch/1.1/' xmlns:gd='http://schemas.google\
+.com/g/2005' gd:etag='W/"DE8CRH47eCp7I2A9WxNWFU4."' gd:kind='analytics#accounts'>
+ <id>http://www.google.com/analytics/feeds/accounts/api.nickm@google.com</id>
+ <updated>2009-10-14T09:14:25.000-07:00</updated>
+ <title>Profile list for abc@test.com</title>
+ <link rel='self' type='application/atom+xml' href='http://www.google.com/analytics/feeds/accounts/default?v=2'/>
+ <author>
+ <name>Google Analytics</name>
+ </author>
+ <generator version='1.0'>Google Analytics</generator>
+ <openSearch:totalResults>37</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>37</openSearch:itemsPerPage>
+ <dxp:segment id='gaid::-11' name='Visits from iPhones'>
+ <dxp:definition>ga:operatingSystem==iPhone</dxp:definition>
+ </dxp:segment>
+ <entry gd:etag='W/"DE8CRH47eCp7I2A9WxNWFU4."' gd:kind='analytics#account'>
+ <id>http://www.google.com/analytics/feeds/accounts/ga:1174</id>
+ <updated>2009-10-14T09:14:25.000-07:00</updated>
+ <title>www.googlestore.com</title>
+ <link rel='alternate' type='text/html' href='http://www.google.com/analytics'/>
+ <ga:goal active='true' name='Completing Order' number='1' value='10.0'>
+ <ga:destination caseSensitive='false' expression='/purchaseComplete.html' matchType='regex' step1Required='false'>
+ <ga:step name='View Product Categories' number='1' path='/Apps|Accessories|Fun|Kid\+s|Office'/>
+ <ga:step name='View Product' number='2' path='/Apps|Accessories|Fun|Kid\+s|Office|Wearables'/>
+ </ga:destination>
+ </ga:goal>
+ <ga:goal active='true' name='Browsed my site over 5 minutes' number='6' value='0.0'>
+ <ga:engagement comparison='>' thresholdValue='300' type='timeOnSite'/>
+ </ga:goal>
+ <ga:goal active='true' name='Visited > 4 pages' number='7' value='0.25'>
+ <ga:engagement comparison='>' thresholdValue='4' type='pagesVisited'/>
+ </ga:goal>
+ <ga:customVariable index='1' name='My Custom Variable' scope='3'/>
+ <ga:customVariable index='2' name='My Seconds Variable' scope='1'/>
+ <dxp:property name='ga:accountId' value='30481'/>
+ <dxp:property name='ga:accountName' value='Google Store'/>
+ <dxp:property name='ga:profileId' value='1174'/>
+ <dxp:property name='ga:webPropertyId' value='UA-30481-1'/>
+ <dxp:property name='ga:currency' value='USD'/>
+ <dxp:property name='ga:timezone' value='America/Los_Angeles'/>
+ <dxp:tableId>ga:1174</dxp:tableId>
+ </entry>
+</feed>'''
+
+ANALYTICS_DATA_FEED = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:dxp='http://schemas.google.com/analytics/2009'>
+ <id>http://www.google.com/analytics/feeds/data?ids=ga:1174&dimensions=ga:medium,ga:source&metrics=ga:bounces,ga:visits&filters=ga:medium%3D%3Dreferral&start-date=2008-10-01&end-date=2008-10-31</id>
+ <updated>2008-10-31T16:59:59.999-07:00</updated>
+ <title type='text'>Google Analytics Data for Profile 1174</title>
+ <link rel='self' type='application/atom+xml' href='http://www.google.com/analytics/feeds/data?max-results=5&sort=-ga%3Avisits&end-date=2008-10-31&start-date=2008-10-01&metrics=ga%3Avisits%2Cga%3Abounces&ids=ga%3A1174&dimensions=ga%3Asource%2Cga%3Amedium&filters=ga%3Amedium%3D%3Dreferral'/>
+ <link rel='next' type='application/atom+xml' href='http://www.google.com/analytics/feeds/data?start-index=6&max-results=5&sort=-ga%3Avisits&end-date=2008-10-31&start-date=2008-10-01&metrics=ga%3Avisits%2Cga%3Abounces&ids=ga%3A1174&dimensions=ga%3Asource%2Cga%3Amedium&filters=ga%3Amedium%3D%3Dreferral'/>
+ <author>
+ <name>Google Analytics</name>
+ </author>
+ <generator version='1.0'>Google Analytics</generator>
+ <openSearch:totalResults>6451</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>2</openSearch:itemsPerPage>
+ <dxp:startDate>2008-10-01</dxp:startDate>
+ <dxp:endDate>2008-10-31</dxp:endDate>
+ <dxp:segment id='gaid::-11' name='Visits from iPhones'>
+ <dxp:definition>ga:operatingSystem==iPhone</dxp:definition>
+ </dxp:segment>
+ <dxp:aggregates>
+ <dxp:metric confidenceInterval='0.0' name='ga:visits' type='integer' value='136540'/>
+ <dxp:metric confidenceInterval='0.0' name='ga:bounces' type='integer' value='101535'/>
+ </dxp:aggregates>
+ <dxp:containsSampledData>true</dxp:containsSampledData>
+ <dxp:dataSource>
+ <dxp:tableId>ga:1174</dxp:tableId>
+ <dxp:tableName>www.googlestore.com</dxp:tableName>
+ <dxp:property name='ga:profileId' value='1174'/>
+ <dxp:property name='ga:webPropertyId' value='UA-30481-1'/>
+ <dxp:property name='ga:accountName' value='Google Store'/>
+ </dxp:dataSource>
+ <entry>
+ <id>http://www.google.com/analytics/feeds/data?ids=ga:1174&ga:medium=referral&ga:source=blogger.com&filters=ga:medium%3D%3Dreferral&start-date=2008-10-01&end-date=2008-10-31</id>
+ <updated>2008-10-30T17:00:00.001-07:00</updated>
+ <title type='text'>ga:source=blogger.com | ga:medium=referral</title>
+ <link rel='alternate' type='text/html' href='http://www.google.com/analytics'/>
+ <dxp:dimension name='ga:source' value='blogger.com'/>
+ <dxp:dimension name='ga:medium' value='referral'/>
+ <dxp:metric confidenceInterval='0.0' name='ga:visits' type='integer' value='68140'/>
+ <dxp:metric confidenceInterval='0.0' name='ga:bounces' type='integer' value='61095'/>
+ </entry>
+</feed>'''
+
+
+ANALYTICS_MGMT_PROFILE_FEED = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:dxp='http://schemas.google.com/analytics/2009' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gd='http://schemas.google.com/g/2005' gd:kind='analytics#profiles'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/accounts/~all/webproperties/~all/profiles</id>
+ <updated>2010-06-14T22:18:48.676Z</updated>
+ <title type='text'>Google Analytics Profiles for superman@gmail.com</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/~all/webproperties/~all/profiles'/>
+ <author>
+ <name>Google Analytics</name>
+ </author>
+ <generator version='1.0'>Google Analytics</generator>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1000</openSearch:itemsPerPage>
+ <entry gd:etag='W/"CkQAQ3Y-fSp7I2A9WxFXGEU."' gd:kind='analytics#profile'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174</id>
+ <updated>2010-06-09T05:58:15.436-07:00</updated>
+ <title type='text'>Google Analytics Profile www.googlestore.com</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174'/>
+ <link rel='http://schemas.google.com/ga/2009#parent' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1' gd:targetKind='analytics#webproperty'/>
+ <link rel='http://schemas.google.com/ga/2009#child' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174/goals' gd:targetKind='analytics#goals'/>
+ <dxp:property name='ga:accountId' value='30481'/>
+ <dxp:property name='ga:webPropertyId' value='UA-30481-1'/>
+ <dxp:property name='ga:profileName' value='www.googlestore.com'/>
+ <dxp:property name='ga:profileId' value='1174'/>
+ <dxp:property name='dxp:tableId' value='ga:1174'/>
+ <dxp:property name='ga:currency' value='USD'/>
+ <dxp:property name='ga:timezone' value='America/Los_Angeles'/>
+ </entry>
+</feed>
+'''
+
+ANALYTICS_MGMT_GOAL_FEED = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:dxp='http://schemas.google.com/analytics/2009' xmlns:ga='http://schemas.google.com/ga/2009' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gd='http://schemas.google.com/g/2005' gd:kind='analytics#goals'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/accounts/~all/webproperties/~all/profiles/~all/goals</id>
+ <updated>2010-06-14T22:21:18.485Z</updated>
+ <title type='text'>Google Analytics Goals for superman@gmail.com</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/~all/webproperties/~all/profiles/~all/goals'/>
+ <author>
+ <name>Google Analytics</name>
+ </author>
+ <generator version='1.0'>Google Analytics</generator>
+ <openSearch:totalResults>3</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1000</openSearch:itemsPerPage>
+ <entry gd:etag='W/"DUYCQn08fip7I2A9WxBWFUo."' gd:kind='analytics#goal'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174/goals/1</id>
+ <updated>2010-02-07T13:12:43.377-08:00</updated>
+ <title type='text'>Google Analytics Goal 1</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174/goals/1'/>
+ <link rel='http://schemas.google.com/ga/2009#parent' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174' gd:targetKind='analytics#profile'/>
+ <ga:goal active='true' name='Completing Order' number='1' value='10.0'>
+ <ga:destination caseSensitive='false' expression='/purchaseComplete.html' matchType='regex' step1Required='false'>
+ <ga:step name='View Product Categories' number='1' path='/Apps|Accessories'/>
+ </ga:destination>
+ </ga:goal>
+ <dxp:property name='ga:profileId' value='1174'/>
+ </entry>
+ <entry gd:etag='W/"DUYCQn08fip7I2A9WxBWFUo."' gd:kind='analytics#goal'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174/goals/2</id>
+ <updated>2010-02-07T13:12:43.376-08:00</updated>
+ <title type='text'>Google Analytics Goal 2</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174/goals/2'/>
+ <link rel='http://schemas.google.com/ga/2009#parent' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174' gd:targetKind='analytics#profile'/>
+ <ga:goal active='true' name='Browsed my site over 5 minutes' number='2' value='0.0'>
+ <ga:engagement comparison='>' thresholdValue='300' type='timeOnSite'/>
+ </ga:goal>
+ <dxp:property name='ga:profileId' value='1174'/>
+ </entry>
+</feed>
+'''
+
+ANALYTICS_MGMT_ADV_SEGMENT_FEED = '''
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:dxp='http://schemas.google.com/analytics/2009' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:gd='http://schemas.google.com/g/2005' gd:kind='analytics#segments'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/segments</id>
+ <updated>2010-06-14T22:22:02.728Z</updated>
+ <title type='text'>Google Analytics Advanced Segments for superman@gmail.com</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/segments'/>
+ <author>
+ <name>Google Analytics</name>
+ </author>
+ <generator version='1.0'>Google Analytics</generator>
+ <openSearch:totalResults>2</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1000</openSearch:itemsPerPage>
+ <entry gd:etag='W/"YDwqeyM."' gd:kind='analytics#segment'>
+ <id>https://www.google.com/analytics/feeds/datasources/ga/segments/gaid::0</id>
+ <updated>2009-10-26T13:00:44.915-07:00</updated>
+ <title type='text'>Google Analytics Advanced Segment Sources Form Google</title>
+ <link rel='self' type='application/atom+xml' href='https://www.google.com/analytics/feeds/datasources/ga/segments/gaid::0'/>
+ <dxp:segment id='gaid::0' name='Sources Form Google'>
+ <dxp:definition>ga:source=~^\Qgoogle\E</dxp:definition>
+ </dxp:segment>
+ </entry>
+</feed>
+'''
+
+MULTIDOMAIN_USER_ENTRY = """<?xml version="1.0"?>
+<atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
+ <apps:property name="password" value="51eea05d46317fadd5cad6787a8f562be90b4446"/>
+ <apps:property name="hashFunction" value="SHA-1"/>
+ <apps:property name="userEmail" value="liz@example.com"/>
+ <apps:property name="firstName" value="Liz"/>
+ <apps:property name="lastName" value="Smith"/>
+ <apps:property name="isAdmin" value="true"/>
+</atom:entry>"""
+
+MULTIDOMAIN_USER_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensesearchrss/1.0/"
+ xmlns:apps="http://schemas.google.com/apps/2006">
+ <id>https://apps-apis.google.com/a/feeds/user/2.0/example.com</id>
+ <updated>2010-01-26T23:38:13.215Z</updated>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/user/2.0/example.com" />
+ <link rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/user/2.0/example.com" />
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/user/2.0/example.com?start=admin%40example.com" />
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/user/2.0/example.com/admin%40example.com</id>
+ <updated>2010-01-26T23:38:13.210Z</updated>
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/user/2.0/example.com/admin%40example.com" />
+ <link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/user/2.0/example.com/admin%40example.com" />
+ <apps:property name="lastName" value="Brown" />
+ <apps:property name="isChangePasswordAtNextLogin" value="false" />
+ <apps:property name="isSuspended" value="false" />
+ <apps:property name="userEmail" value="admin@example.com" />
+ <apps:property name="isAdmin" value="true" />
+ <apps:property name="firstName" value="Joe" />
+ <apps:property name="ipWhitelisted" value="false" />
+ </entry>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/user/2.0/example.com/liz%40example.com</id>
+ <updated>2010-01-26T23:38:13.210Z</updated>
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/user/2.0/example.com/liz%40example.com" />
+ <link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/user/2.0/example.com/liz%40example.com" />
+ <apps:property name="lastName" value="Smith" />
+ <apps:property name="isChangePasswordAtNextLogin" value="false" />
+ <apps:property name="isSuspended" value="false" />
+ <apps:property name="userEmail" value="liz@example.com" />
+ <apps:property name="isAdmin" value="true" />
+ <apps:property name="firstName" value="Elizabeth" />
+ <apps:property name="ipWhitelisted" value="false" />
+ </entry>
+</feed>"""
+
+MULTIDOMAIN_USER_RENAME_REQUEST = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
+ <apps:property name='newEmail' value='liz@newexample4liz.com'/>
+</entry>"""
+
+MULTIDOMAIN_ALIAS_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com</id>
+ <updated>2008-10-17T15:02:45.646Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com'/>
+ <link rel='edit' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com'/>
+ <apps:property name="userEmail" value="liz@example.com" />
+ <apps:property name="aliasEmail" value="helpdesk@gethelp_example.com" />
+</entry>"""
+
+MULTIDOMAIN_ALIAS_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns="http://www.w3.org/2005/Atom" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:apps="http://schemas.google.com/apps/2006">
+ <id>https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com</id>
+ <updated>2010-01-26T23:38:13.215Z</updated>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com" />
+ <link rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml" href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com" />
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com?start=helpdesk%40gethelp_example.com" />
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com</id>
+ <updated>2010-01-26T23:38:13.210Z</updated>
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com" />
+ <link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/helpdesk%40gethelp_example.com" />
+ <apps:property name="userEmail" value="liz@example.com" />
+ <apps:property name="aliasEmail" value="helpdesk@gethelp_example.com" />
+ </entry>
+ <entry>
+ <id>https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/support%40gethelp_example.com</id>
+ <updated>2010-01-26T23:38:13.210Z</updated>
+ <link rel="self" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/support%40gethelp_example.com" />
+ <link rel="edit" type="application/atom+xml"
+ href="https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/support%40gethelp_example.com" />
+ <apps:property name="userEmail" value="joe@example.com" />
+ <apps:property name="aliasEmail" value="support@gethelp_example.com" />
+ </entry>
+</feed>"""
+
+USER_ENTRY1 = """<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom' xmlns:apps='http://schemas.google.com/apps/2006' xmlns:gd='http://schemas.google.com/g/2005'>
+ <id>http://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/abcd12310</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/>
+ <title type='text'>abcd12310</title>
+ <link rel='self' type='application/atom+xml' href='http://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/abcd12310'/>
+ <link rel='edit' type='application/atom+xml' href='http://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/abcd12310'/>
+ <apps:login userName='abcd12310' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='25600'/>
+ <apps:name familyName='efgh3' givenName='abcd33'/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='http://apps-apis.google.com/a/feeds/srkapps.com/nickname/2.0?username=abcd12310'/>
+ <gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='http://apps-apis.google.com/a/feeds/srkapps.com/emailList/2.0?recipient=abcd12310%40srkapps.com'/>
+</entry>"""
+
+USER_FEED1 = """<?xml version='1.0' encoding='utf-8'?>
+<ns0:feed xmlns:ns0="http://www.w3.org/2005/Atom">
+ <ns0:category scheme="http://schemas.google.com/g/2005#kind"
+ term="http://schemas.google.com/apps/2006#user" />
+ <ns0:id>
+ https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0</ns0:id>
+ <ns1:startIndex xmlns:ns1="http://a9.com/-/spec/opensearchrss/1.0/">
+ 1</ns1:startIndex>
+ <ns0:title type="text">Users</ns0:title>
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0"
+ rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml" />
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0"
+ rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml" />
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0?startUsername=user8306"
+ rel="self" type="application/atom+xml" />
+ <ns0:updated>1970-01-01T00:00:00.000Z</ns0:updated>
+ <ns0:entry>
+ <ns1:name familyName="LastName8306"
+ givenName="FirstName8306"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ <ns0:category scheme="http://schemas.google.com/g/2005#kind"
+ term="http://schemas.google.com/apps/2006#user" />
+ <ns0:id>
+ https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8306</ns0:id>
+ <ns0:updated>1970-01-01T00:00:00.000Z</ns0:updated>
+ <ns1:quota limit="25600"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ <ns1:feedLink href="https://apps-apis.google.com/a/feeds/srkapps.com/nickname/2.0?username=user8306"
+ rel="http://schemas.google.com/apps/2006#user.nicknames"
+ xmlns:ns1="http://schemas.google.com/g/2005" />
+ <ns1:feedLink href="https://apps-apis.google.com/a/feeds/srkapps.com/emailList/2.0?recipient=user8306%40srkapps.com"
+ rel="http://schemas.google.com/apps/2006#user.emailLists"
+ xmlns:ns1="http://schemas.google.com/g/2005" />
+ <ns0:title type="text">user8306</ns0:title>
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8306"
+ rel="self" type="application/atom+xml" />
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8306"
+ rel="edit" type="application/atom+xml" />
+ <ns1:login admin="false" agreedToTerms="false"
+ changePasswordAtNextLogin="false" ipWhitelisted="false"
+ suspended="false" userName="user8306"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ </ns0:entry>
+ <ns0:entry>
+ <ns1:name familyName="LastName8307"
+ givenName="FirstName8307"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ <ns0:category scheme="http://schemas.google.com/g/2005#kind"
+ term="http://schemas.google.com/apps/2006#user" />
+ <ns0:id>
+ https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8307</ns0:id>
+ <ns0:updated>1970-01-01T00:00:00.000Z</ns0:updated>
+ <ns1:quota limit="25600"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ <ns1:feedLink href="https://apps-apis.google.com/a/feeds/srkapps.com/nickname/2.0?username=user8307"
+ rel="http://schemas.google.com/apps/2006#user.nicknames"
+ xmlns:ns1="http://schemas.google.com/g/2005" />
+ <ns1:feedLink href="https://apps-apis.google.com/a/feeds/srkapps.com/emailList/2.0?recipient=user8307%40srkapps.com"
+ rel="http://schemas.google.com/apps/2006#user.emailLists"
+ xmlns:ns1="http://schemas.google.com/g/2005" />
+ <ns0:title type="text">user8307</ns0:title>
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8307"
+ rel="self" type="application/atom+xml" />
+ <ns0:link href="https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8307"
+ rel="edit" type="application/atom+xml" />
+ <ns1:login admin="false" agreedToTerms="false"
+ changePasswordAtNextLogin="false" ipWhitelisted="false"
+ suspended="false" userName="user8307"
+ xmlns:ns1="http://schemas.google.com/apps/2006" />
+ </ns0:entry>
+</ns0:feed>"""
+
+NICKNAME_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname' />
+ <title type='text'>nehag</title>
+ <link rel='self' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag' />
+ <link rel='edit' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag' />
+ <apps:nickname name='nehag' />
+ <apps:login userName='neha' />
+</entry>"""
+
+
+NICKNAME_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname' />
+ <title type='text'>Nicknames</title>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0' />
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0' />
+ <link rel='self' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0' />
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>
+ https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname' />
+ <title type='text'>nehag</title>
+ <link rel='self' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag' />
+ <link rel='edit' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/nehag' />
+ <apps:nickname name='nehag' />
+ <apps:login userName='neha' />
+ </entry>
+ <entry>
+ <id>
+ https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/richag</id>
+ <updated>1970-01-01T00:00:00.000Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/apps/2006#nickname' />
+ <title type='text'>richag</title>
+ <link rel='self' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/richag' />
+ <link rel='edit' type='application/atom+xml'
+ href='https://apps-apis.google.com/a/feeds/srkapps.net/nickname/2.0/richag' />
+ <apps:nickname name='richag' />
+ <apps:login userName='richa' />
+ </entry>
+</feed>"""
+
+GROUP_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com</id>
+ <updated>2011-11-10T16:54:56.784Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com' />
+ <apps:property name='groupId' value='trial@srkapps.com' />
+ <apps:property name='groupName' value='Trial' />
+ <apps:property name='emailPermission' value='Domain' />
+ <apps:property name='permissionPreset' value='Custom' />
+ <apps:property name='description' value='For try' />
+</entry>"""
+
+GROUP_FEED= """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com</id>
+ <updated>2011-11-10T16:56:03.830Z</updated>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com' />
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com' />
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com' />
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/firstgroup%40srkapps.com</id>
+ <updated>2011-11-10T16:56:03.830Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/firstgroup%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/firstgroup%40srkapps.com' />
+ <apps:property name='groupId' value='firstgroup@srkapps.com' />
+ <apps:property name='groupName' value='FirstGroup' />
+ <apps:property name='emailPermission' value='Domain' />
+ <apps:property name='permissionPreset' value='Custom' />
+ <apps:property name='description' value='First group' />
+ </entry>
+ <entry>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com</id>
+ <updated>2011-11-10T16:56:03.830Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial%40srkapps.com' />
+ <apps:property name='groupId' value='trial@srkapps.com' />
+ <apps:property name='groupName' value='Trial' />
+ <apps:property name='emailPermission' value='Domain' />
+ <apps:property name='permissionPreset' value='Custom' />
+ <apps:property name='description' value='For try' />
+ </entry>
+</feed>"""
+
+GROUP_MEMBER_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com</id>
+ <updated>2011-11-10T16:58:40.804Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com' />
+ <apps:property name='memberType' value='User' />
+ <apps:property name='memberId' value='abcd12310@srkapps.com' />
+ <apps:property name='directMember' value='true' />
+</entry>"""
+
+GROUP_MEMBER_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member</id>
+ <updated>2011-11-10T16:57:15.574Z</updated>
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member' />
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member' />
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member' />
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com</id>
+ <updated>2011-11-10T16:57:15.574Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/abcd12310%40srkapps.com' />
+ <apps:property name='memberType' value='User' />
+ <apps:property name='memberId' value='abcd12310@srkapps.com' />
+ <apps:property name='directMember' value='true' />
+ </entry>
+ <entry>
+ <id>
+ http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/neha.technocrat%40srkapps.com</id>
+ <updated>2011-11-10T16:57:15.574Z</updated>
+ <link rel='self' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/neha.technocrat%40srkapps.com' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/member/neha.technocrat%40srkapps.com' />
+ <apps:property name='memberType' value='User' />
+ <apps:property name='memberId' value='neha.technocrat@srkapps.com' />
+ <apps:property name='directMember' value='true' />
+ </entry>
+</feed>"""
+
+ORGANIZATION_UNIT_CUSTOMER_ID_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+<id>
+https://apps-apis.google.com/a/feeds/customer/2.0/C123A456B</id>
+<updated>2011-11-21T13:17:02.274Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/customer/2.0/C123A456B' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/customer/2.0/C123A456B' />
+<apps:property name='customerOrgUnitDescription'
+value='example.com' />
+<apps:property name='customerId' value='C123A456B' />
+<apps:property name='customerOrgUnitName' value='example.com' />
+<apps:property name='description' value='tempdescription' />
+<apps:property name='name' value='example.com' />
+</entry>"""
+
+ORGANIZATION_UNIT_ORGUNIT_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+<id>
+https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/Test+Organization</id>
+<updated>2011-11-21T13:32:12.334Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/Test+Organization' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/Test+Organization' />
+<apps:property name='description' value='New Test Org' />
+<apps:property name='parentOrgUnitPath' value='Test' />
+<apps:property name='name' value='Test Organization' />
+<apps:property name='orgUnitPath' value='Test/Test+Organization' />
+<apps:property name='blockInheritance' value='false' />
+</entry>"""
+
+ORGANIZATION_UNIT_ORGUNIT_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+<id>https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B</id>
+<updated>2011-11-21T13:47:12.551Z</updated>
+<link rel='http://schemas.google.com/g/2005#feed'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B' />
+<link rel='http://schemas.google.com/g/2005#post'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B' />
+<link rel='http://schemas.google.com/g/2005#batch'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/batch' />
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B?get=all' />
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+<id>
+https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit92</id>
+<updated>2011-11-21T13:42:45.349Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit92' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit92' />
+<apps:property name='description' value='test92' />
+<apps:property name='parentOrgUnitPath' value='Test' />
+<apps:property name='name' value='testOrgUnit92' />
+<apps:property name='orgUnitPath' value='Test/testOrgUnit92' />
+<apps:property name='blockInheritance' value='false' />
+</entry>
+<entry>
+<id>
+https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit93</id>
+<updated>2011-11-21T13:42:45.349Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit93' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orgunit/2.0/C123A456B/testOrgUnit93' />
+<apps:property name='description' value='test93' />
+<apps:property name='parentOrgUnitPath' value='Test' />
+<apps:property name='name' value='testOrgUnit93' />
+<apps:property name='orgUnitPath' value='Test/testOrgUnit93' />
+<apps:property name='blockInheritance' value='false' />
+</entry>
+</feed>"""
+
+
+ORGANIZATION_UNIT_ORGUSER_ENTRY = """<?xml version='1.0' encoding='utf-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+<id>
+https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/admin%40example.com</id>
+<updated>2011-11-21T14:05:17.734Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/admin%40example.com' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/admin%40example.com' />
+<apps:property name='orgUserEmail' value='admin@example.com' />
+<apps:property name='orgUnitPath' value='Test' />
+</entry>"""
+
+ORGANIZATION_UNIT_ORGUSER_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'
+xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+xmlns:apps='http://schemas.google.com/apps/2006'>
+<id>https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B</id>
+<updated>2011-11-21T14:10:48.206Z</updated>
+<link rel='http://schemas.google.com/g/2005#feed'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B' />
+<link rel='http://schemas.google.com/g/2005#post'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B' />
+<link rel='http://schemas.google.com/g/2005#batch'
+type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/batch' />
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B?get=all' />
+<openSearch:startIndex>1</openSearch:startIndex>
+<entry>
+<id>
+https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user720430%40example.com</id>
+<updated>2011-11-21T14:09:16.600Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user720430%40example.com' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user720430%40example.com' />
+<apps:property name='orgUserEmail'
+value='user720430@example.com' />
+<apps:property name='orgUnitPath' value='Test' />
+</entry>
+<entry>
+<id>
+https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user832648%40example.com</id>
+<updated>2011-11-21T14:09:16.600Z</updated>
+<link rel='self' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user832648%40example.com' />
+<link rel='edit' type='application/atom+xml'
+href='https://apps-apis.google.com/a/feeds/orguser/2.0/C123A456B/user832648%40example.com' />
+<apps:property name='orgUserEmail'
+value='user832648@example.com' />
+<apps:property name='orgUnitPath' value='Test' />
+</entry>
+</feed>"""
diff --git a/src/gdata/tlslite/BaseDB.py b/src/gdata/tlslite/BaseDB.py
new file mode 100755
index 0000000..ca8dff6
--- /dev/null
+++ b/src/gdata/tlslite/BaseDB.py
@@ -0,0 +1,120 @@
+"""Base class for SharedKeyDB and VerifierDB."""
+
+import anydbm
+import thread
+
+class BaseDB:
+ def __init__(self, filename, type):
+ self.type = type
+ self.filename = filename
+ if self.filename:
+ self.db = None
+ else:
+ self.db = {}
+ self.lock = thread.allocate_lock()
+
+ def create(self):
+ """Create a new on-disk database.
+
+ @raise anydbm.error: If there's a problem creating the database.
+ """
+ if self.filename:
+ self.db = anydbm.open(self.filename, "n") #raises anydbm.error
+ self.db["--Reserved--type"] = self.type
+ self.db.sync()
+ else:
+ self.db = {}
+
+ def open(self):
+ """Open a pre-existing on-disk database.
+
+ @raise anydbm.error: If there's a problem opening the database.
+ @raise ValueError: If the database is not of the right type.
+ """
+ if not self.filename:
+ raise ValueError("Can only open on-disk databases")
+ self.db = anydbm.open(self.filename, "w") #raises anydbm.error
+ try:
+ if self.db["--Reserved--type"] != self.type:
+ raise ValueError("Not a %s database" % self.type)
+ except KeyError:
+ raise ValueError("Not a recognized database")
+
+ def __getitem__(self, username):
+ if self.db == None:
+ raise AssertionError("DB not open")
+
+ self.lock.acquire()
+ try:
+ valueStr = self.db[username]
+ finally:
+ self.lock.release()
+
+ return self._getItem(username, valueStr)
+
+ def __setitem__(self, username, value):
+ if self.db == None:
+ raise AssertionError("DB not open")
+
+ valueStr = self._setItem(username, value)
+
+ self.lock.acquire()
+ try:
+ self.db[username] = valueStr
+ if self.filename:
+ self.db.sync()
+ finally:
+ self.lock.release()
+
+ def __delitem__(self, username):
+ if self.db == None:
+ raise AssertionError("DB not open")
+
+ self.lock.acquire()
+ try:
+ del(self.db[username])
+ if self.filename:
+ self.db.sync()
+ finally:
+ self.lock.release()
+
+ def __contains__(self, username):
+ """Check if the database contains the specified username.
+
+ @type username: str
+ @param username: The username to check for.
+
+ @rtype: bool
+ @return: True if the database contains the username, False
+ otherwise.
+
+ """
+ if self.db == None:
+ raise AssertionError("DB not open")
+
+ self.lock.acquire()
+ try:
+ return self.db.has_key(username)
+ finally:
+ self.lock.release()
+
+ def check(self, username, param):
+ value = self.__getitem__(username)
+ return self._checkItem(value, username, param)
+
+ def keys(self):
+ """Return a list of usernames in the database.
+
+ @rtype: list
+ @return: The usernames in the database.
+ """
+ if self.db == None:
+ raise AssertionError("DB not open")
+
+ self.lock.acquire()
+ try:
+ usernames = self.db.keys()
+ finally:
+ self.lock.release()
+ usernames = [u for u in usernames if not u.startswith("--Reserved--")]
+ return usernames
\ No newline at end of file
diff --git a/src/gdata/tlslite/Checker.py b/src/gdata/tlslite/Checker.py
new file mode 100755
index 0000000..f978697
--- /dev/null
+++ b/src/gdata/tlslite/Checker.py
@@ -0,0 +1,146 @@
+"""Class for post-handshake certificate checking."""
+
+from utils.cryptomath import hashAndBase64
+from X509 import X509
+from X509CertChain import X509CertChain
+from errors import *
+
+
+class Checker:
+ """This class is passed to a handshake function to check the other
+ party's certificate chain.
+
+ If a handshake function completes successfully, but the Checker
+ judges the other party's certificate chain to be missing or
+ inadequate, a subclass of
+ L{tlslite.errors.TLSAuthenticationError} will be raised.
+
+ Currently, the Checker can check either an X.509 or a cryptoID
+ chain (for the latter, cryptoIDlib must be installed).
+ """
+
+ def __init__(self, cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ checkResumedSession=False):
+ """Create a new Checker instance.
+
+ You must pass in one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ @type cryptoID: str
+ @param cryptoID: A cryptoID which the other party's certificate
+ chain must match. The cryptoIDlib module must be installed.
+ Mutually exclusive with all of the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: A cryptoID protocol URI which the other
+ party's certificate chain must match. Requires the 'cryptoID'
+ argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: A hex-encoded X.509 end-entity
+ fingerprint which the other party's end-entity certificate must
+ match. Mutually exclusive with the 'cryptoID' and
+ 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed. Mutually exclusive with the 'cryptoID' and
+ 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type checkResumedSession: bool
+ @param checkResumedSession: If resumed sessions should be
+ checked. This defaults to False, on the theory that if the
+ session was checked once, we don't need to bother
+ re-checking it.
+ """
+
+ if cryptoID and (x509Fingerprint or x509TrustList):
+ raise ValueError()
+ if x509Fingerprint and x509TrustList:
+ raise ValueError()
+ if x509CommonName and not x509TrustList:
+ raise ValueError()
+ if protocol and not cryptoID:
+ raise ValueError()
+ if cryptoID:
+ import cryptoIDlib #So we raise an error here
+ if x509TrustList:
+ import cryptlib_py #So we raise an error here
+ self.cryptoID = cryptoID
+ self.protocol = protocol
+ self.x509Fingerprint = x509Fingerprint
+ self.x509TrustList = x509TrustList
+ self.x509CommonName = x509CommonName
+ self.checkResumedSession = checkResumedSession
+
+ def __call__(self, connection):
+ """Check a TLSConnection.
+
+ When a Checker is passed to a handshake function, this will
+ be called at the end of the function.
+
+ @type connection: L{tlslite.TLSConnection.TLSConnection}
+ @param connection: The TLSConnection to examine.
+
+ @raise tlslite.errors.TLSAuthenticationError: If the other
+ party's certificate chain is missing or bad.
+ """
+ if not self.checkResumedSession and connection.resumed:
+ return
+
+ if self.cryptoID or self.x509Fingerprint or self.x509TrustList:
+ if connection._client:
+ chain = connection.session.serverCertChain
+ else:
+ chain = connection.session.clientCertChain
+
+ if self.x509Fingerprint or self.x509TrustList:
+ if isinstance(chain, X509CertChain):
+ if self.x509Fingerprint:
+ if chain.getFingerprint() != self.x509Fingerprint:
+ raise TLSFingerprintError(\
+ "X.509 fingerprint mismatch: %s, %s" % \
+ (chain.getFingerprint(), self.x509Fingerprint))
+ else: #self.x509TrustList
+ if not chain.validate(self.x509TrustList):
+ raise TLSValidationError("X.509 validation failure")
+ if self.x509CommonName and \
+ (chain.getCommonName() != self.x509CommonName):
+ raise TLSAuthorizationError(\
+ "X.509 Common Name mismatch: %s, %s" % \
+ (chain.getCommonName(), self.x509CommonName))
+ elif chain:
+ raise TLSAuthenticationTypeError()
+ else:
+ raise TLSNoAuthenticationError()
+ elif self.cryptoID:
+ import cryptoIDlib.CertChain
+ if isinstance(chain, cryptoIDlib.CertChain.CertChain):
+ if chain.cryptoID != self.cryptoID:
+ raise TLSFingerprintError(\
+ "cryptoID mismatch: %s, %s" % \
+ (chain.cryptoID, self.cryptoID))
+ if self.protocol:
+ if not chain.checkProtocol(self.protocol):
+ raise TLSAuthorizationError(\
+ "cryptoID protocol mismatch")
+ if not chain.validate():
+ raise TLSValidationError("cryptoID validation failure")
+ elif chain:
+ raise TLSAuthenticationTypeError()
+ else:
+ raise TLSNoAuthenticationError()
+
diff --git a/src/gdata/tlslite/FileObject.py b/src/gdata/tlslite/FileObject.py
new file mode 100755
index 0000000..6ee02b2
--- /dev/null
+++ b/src/gdata/tlslite/FileObject.py
@@ -0,0 +1,220 @@
+"""Class returned by TLSConnection.makefile()."""
+
+class FileObject:
+ """This class provides a file object interface to a
+ L{tlslite.TLSConnection.TLSConnection}.
+
+ Call makefile() on a TLSConnection to create a FileObject instance.
+
+ This class was copied, with minor modifications, from the
+ _fileobject class in socket.py. Note that fileno() is not
+ implemented."""
+
+ default_bufsize = 16384 #TREV: changed from 8192
+
+ def __init__(self, sock, mode='rb', bufsize=-1):
+ self._sock = sock
+ self.mode = mode # Not actually used in this version
+ if bufsize < 0:
+ bufsize = self.default_bufsize
+ self.bufsize = bufsize
+ self.softspace = False
+ if bufsize == 0:
+ self._rbufsize = 1
+ elif bufsize == 1:
+ self._rbufsize = self.default_bufsize
+ else:
+ self._rbufsize = bufsize
+ self._wbufsize = bufsize
+ self._rbuf = "" # A string
+ self._wbuf = [] # A list of strings
+
+ def _getclosed(self):
+ return self._sock is not None
+ closed = property(_getclosed, doc="True if the file is closed")
+
+ def close(self):
+ try:
+ if self._sock:
+ for result in self._sock._decrefAsync(): #TREV
+ pass
+ finally:
+ self._sock = None
+
+ def __del__(self):
+ try:
+ self.close()
+ except:
+ # close() may fail if __init__ didn't complete
+ pass
+
+ def flush(self):
+ if self._wbuf:
+ buffer = "".join(self._wbuf)
+ self._wbuf = []
+ self._sock.sendall(buffer)
+
+ #def fileno(self):
+ # raise NotImplementedError() #TREV
+
+ def write(self, data):
+ data = str(data) # XXX Should really reject non-string non-buffers
+ if not data:
+ return
+ self._wbuf.append(data)
+ if (self._wbufsize == 0 or
+ self._wbufsize == 1 and '\n' in data or
+ self._get_wbuf_len() >= self._wbufsize):
+ self.flush()
+
+ def writelines(self, list):
+ # XXX We could do better here for very long lists
+ # XXX Should really reject non-string non-buffers
+ self._wbuf.extend(filter(None, map(str, list)))
+ if (self._wbufsize <= 1 or
+ self._get_wbuf_len() >= self._wbufsize):
+ self.flush()
+
+ def _get_wbuf_len(self):
+ buf_len = 0
+ for x in self._wbuf:
+ buf_len += len(x)
+ return buf_len
+
+ def read(self, size=-1):
+ data = self._rbuf
+ if size < 0:
+ # Read until EOF
+ buffers = []
+ if data:
+ buffers.append(data)
+ self._rbuf = ""
+ if self._rbufsize <= 1:
+ recv_size = self.default_bufsize
+ else:
+ recv_size = self._rbufsize
+ while True:
+ data = self._sock.recv(recv_size)
+ if not data:
+ break
+ buffers.append(data)
+ return "".join(buffers)
+ else:
+ # Read until size bytes or EOF seen, whichever comes first
+ buf_len = len(data)
+ if buf_len >= size:
+ self._rbuf = data[size:]
+ return data[:size]
+ buffers = []
+ if data:
+ buffers.append(data)
+ self._rbuf = ""
+ while True:
+ left = size - buf_len
+ recv_size = max(self._rbufsize, left)
+ data = self._sock.recv(recv_size)
+ if not data:
+ break
+ buffers.append(data)
+ n = len(data)
+ if n >= left:
+ self._rbuf = data[left:]
+ buffers[-1] = data[:left]
+ break
+ buf_len += n
+ return "".join(buffers)
+
+ def readline(self, size=-1):
+ data = self._rbuf
+ if size < 0:
+ # Read until \n or EOF, whichever comes first
+ if self._rbufsize <= 1:
+ # Speed up unbuffered case
+ assert data == ""
+ buffers = []
+ recv = self._sock.recv
+ while data != "\n":
+ data = recv(1)
+ if not data:
+ break
+ buffers.append(data)
+ return "".join(buffers)
+ nl = data.find('\n')
+ if nl >= 0:
+ nl += 1
+ self._rbuf = data[nl:]
+ return data[:nl]
+ buffers = []
+ if data:
+ buffers.append(data)
+ self._rbuf = ""
+ while True:
+ data = self._sock.recv(self._rbufsize)
+ if not data:
+ break
+ buffers.append(data)
+ nl = data.find('\n')
+ if nl >= 0:
+ nl += 1
+ self._rbuf = data[nl:]
+ buffers[-1] = data[:nl]
+ break
+ return "".join(buffers)
+ else:
+ # Read until size bytes or \n or EOF seen, whichever comes first
+ nl = data.find('\n', 0, size)
+ if nl >= 0:
+ nl += 1
+ self._rbuf = data[nl:]
+ return data[:nl]
+ buf_len = len(data)
+ if buf_len >= size:
+ self._rbuf = data[size:]
+ return data[:size]
+ buffers = []
+ if data:
+ buffers.append(data)
+ self._rbuf = ""
+ while True:
+ data = self._sock.recv(self._rbufsize)
+ if not data:
+ break
+ buffers.append(data)
+ left = size - buf_len
+ nl = data.find('\n', 0, left)
+ if nl >= 0:
+ nl += 1
+ self._rbuf = data[nl:]
+ buffers[-1] = data[:nl]
+ break
+ n = len(data)
+ if n >= left:
+ self._rbuf = data[left:]
+ buffers[-1] = data[:left]
+ break
+ buf_len += n
+ return "".join(buffers)
+
+ def readlines(self, sizehint=0):
+ total = 0
+ list = []
+ while True:
+ line = self.readline()
+ if not line:
+ break
+ list.append(line)
+ total += len(line)
+ if sizehint and total >= sizehint:
+ break
+ return list
+
+ # Iterator protocols
+
+ def __iter__(self):
+ return self
+
+ def next(self):
+ line = self.readline()
+ if not line:
+ raise StopIteration
+ return line
diff --git a/src/gdata/tlslite/HandshakeSettings.py b/src/gdata/tlslite/HandshakeSettings.py
new file mode 100755
index 0000000..c7c3223
--- /dev/null
+++ b/src/gdata/tlslite/HandshakeSettings.py
@@ -0,0 +1,159 @@
+"""Class for setting handshake parameters."""
+
+from constants import CertificateType
+from utils import cryptomath
+from utils import cipherfactory
+
+class HandshakeSettings:
+ """This class encapsulates various parameters that can be used with
+ a TLS handshake.
+ @sort: minKeySize, maxKeySize, cipherNames, certificateTypes,
+ minVersion, maxVersion
+
+ @type minKeySize: int
+ @ivar minKeySize: The minimum bit length for asymmetric keys.
+
+ If the other party tries to use SRP, RSA, or Diffie-Hellman
+ parameters smaller than this length, an alert will be
+ signalled. The default is 1023.
+
+ @type maxKeySize: int
+ @ivar maxKeySize: The maximum bit length for asymmetric keys.
+
+ If the other party tries to use SRP, RSA, or Diffie-Hellman
+ parameters larger than this length, an alert will be signalled.
+ The default is 8193.
+
+ @type cipherNames: list
+ @ivar cipherNames: The allowed ciphers, in order of preference.
+
+ The allowed values in this list are 'aes256', 'aes128', '3des', and
+ 'rc4'. If these settings are used with a client handshake, they
+ determine the order of the ciphersuites offered in the ClientHello
+ message.
+
+ If these settings are used with a server handshake, the server will
+ choose whichever ciphersuite matches the earliest entry in this
+ list.
+
+ NOTE: If '3des' is used in this list, but TLS Lite can't find an
+ add-on library that supports 3DES, then '3des' will be silently
+ removed.
+
+ The default value is ['aes256', 'aes128', '3des', 'rc4'].
+
+ @type certificateTypes: list
+ @ivar certificateTypes: The allowed certificate types, in order of
+ preference.
+
+ The allowed values in this list are 'x509' and 'cryptoID'. This
+ list is only used with a client handshake. The client will
+ advertise to the server which certificate types are supported, and
+ will check that the server uses one of the appropriate types.
+
+ NOTE: If 'cryptoID' is used in this list, but cryptoIDlib is not
+ installed, then 'cryptoID' will be silently removed.
+
+ @type minVersion: tuple
+ @ivar minVersion: The minimum allowed SSL/TLS version.
+
+ This variable can be set to (3,0) for SSL 3.0, (3,1) for
+ TLS 1.0, or (3,2) for TLS 1.1. If the other party wishes to
+ use a lower version, a protocol_version alert will be signalled.
+ The default is (3,0).
+
+ @type maxVersion: tuple
+ @ivar maxVersion: The maximum allowed SSL/TLS version.
+
+ This variable can be set to (3,0) for SSL 3.0, (3,1) for
+ TLS 1.0, or (3,2) for TLS 1.1. If the other party wishes to
+ use a higher version, a protocol_version alert will be signalled.
+ The default is (3,2). (WARNING: Some servers may (improperly)
+ reject clients which offer support for TLS 1.1. In this case,
+ try lowering maxVersion to (3,1)).
+ """
+ def __init__(self):
+ self.minKeySize = 1023
+ self.maxKeySize = 8193
+ self.cipherNames = ["aes256", "aes128", "3des", "rc4"]
+ self.cipherImplementations = ["cryptlib", "openssl", "pycrypto",
+ "python"]
+ self.certificateTypes = ["x509", "cryptoID"]
+ self.minVersion = (3,0)
+ self.maxVersion = (3,2)
+
+ #Filters out options that are not supported
+ def _filter(self):
+ other = HandshakeSettings()
+ other.minKeySize = self.minKeySize
+ other.maxKeySize = self.maxKeySize
+ other.cipherNames = self.cipherNames
+ other.cipherImplementations = self.cipherImplementations
+ other.certificateTypes = self.certificateTypes
+ other.minVersion = self.minVersion
+ other.maxVersion = self.maxVersion
+
+ if not cipherfactory.tripleDESPresent:
+ other.cipherNames = [e for e in self.cipherNames if e != "3des"]
+ if len(other.cipherNames)==0:
+ raise ValueError("No supported ciphers")
+
+ try:
+ import cryptoIDlib
+ except ImportError:
+ other.certificateTypes = [e for e in self.certificateTypes \
+ if e != "cryptoID"]
+ if len(other.certificateTypes)==0:
+ raise ValueError("No supported certificate types")
+
+ if not cryptomath.cryptlibpyLoaded:
+ other.cipherImplementations = [e for e in \
+ self.cipherImplementations if e != "cryptlib"]
+ if not cryptomath.m2cryptoLoaded:
+ other.cipherImplementations = [e for e in \
+ other.cipherImplementations if e != "openssl"]
+ if not cryptomath.pycryptoLoaded:
+ other.cipherImplementations = [e for e in \
+ other.cipherImplementations if e != "pycrypto"]
+ if len(other.cipherImplementations)==0:
+ raise ValueError("No supported cipher implementations")
+
+ if other.minKeySize<512:
+ raise ValueError("minKeySize too small")
+ if other.minKeySize>16384:
+ raise ValueError("minKeySize too large")
+ if other.maxKeySize<512:
+ raise ValueError("maxKeySize too small")
+ if other.maxKeySize>16384:
+ raise ValueError("maxKeySize too large")
+ for s in other.cipherNames:
+ if s not in ("aes256", "aes128", "rc4", "3des"):
+ raise ValueError("Unknown cipher name: '%s'" % s)
+ for s in other.cipherImplementations:
+ if s not in ("cryptlib", "openssl", "python", "pycrypto"):
+ raise ValueError("Unknown cipher implementation: '%s'" % s)
+ for s in other.certificateTypes:
+ if s not in ("x509", "cryptoID"):
+ raise ValueError("Unknown certificate type: '%s'" % s)
+
+ if other.minVersion > other.maxVersion:
+ raise ValueError("Versions set incorrectly")
+
+ if not other.minVersion in ((3,0), (3,1), (3,2)):
+ raise ValueError("minVersion set incorrectly")
+
+ if not other.maxVersion in ((3,0), (3,1), (3,2)):
+ raise ValueError("maxVersion set incorrectly")
+
+ return other
+
+ def _getCertificateTypes(self):
+ l = []
+ for ct in self.certificateTypes:
+ if ct == "x509":
+ l.append(CertificateType.x509)
+ elif ct == "cryptoID":
+ l.append(CertificateType.cryptoID)
+ else:
+ raise AssertionError()
+ return l
diff --git a/src/gdata/tlslite/Session.py b/src/gdata/tlslite/Session.py
new file mode 100755
index 0000000..a951f45
--- /dev/null
+++ b/src/gdata/tlslite/Session.py
@@ -0,0 +1,131 @@
+"""Class representing a TLS session."""
+
+from utils.compat import *
+from mathtls import *
+from constants import *
+
+class Session:
+ """
+ This class represents a TLS session.
+
+ TLS distinguishes between connections and sessions. A new
+ handshake creates both a connection and a session. Data is
+ transmitted over the connection.
+
+ The session contains a more permanent record of the handshake. The
+ session can be inspected to determine handshake results. The
+ session can also be used to create a new connection through
+ "session resumption". If the client and server both support this,
+ they can create a new connection based on an old session without
+ the overhead of a full handshake.
+
+ The session for a L{tlslite.TLSConnection.TLSConnection} can be
+ retrieved from the connection's 'session' attribute.
+
+ @type srpUsername: str
+ @ivar srpUsername: The client's SRP username (or None).
+
+ @type sharedKeyUsername: str
+ @ivar sharedKeyUsername: The client's shared-key username (or
+ None).
+
+ @type clientCertChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @ivar clientCertChain: The client's certificate chain (or None).
+
+ @type serverCertChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @ivar serverCertChain: The server's certificate chain (or None).
+ """
+
+ def __init__(self):
+ self.masterSecret = createByteArraySequence([])
+ self.sessionID = createByteArraySequence([])
+ self.cipherSuite = 0
+ self.srpUsername = None
+ self.sharedKeyUsername = None
+ self.clientCertChain = None
+ self.serverCertChain = None
+ self.resumable = False
+ self.sharedKey = False
+
+ def _clone(self):
+ other = Session()
+ other.masterSecret = self.masterSecret
+ other.sessionID = self.sessionID
+ other.cipherSuite = self.cipherSuite
+ other.srpUsername = self.srpUsername
+ other.sharedKeyUsername = self.sharedKeyUsername
+ other.clientCertChain = self.clientCertChain
+ other.serverCertChain = self.serverCertChain
+ other.resumable = self.resumable
+ other.sharedKey = self.sharedKey
+ return other
+
+ def _calcMasterSecret(self, version, premasterSecret, clientRandom,
+ serverRandom):
+ if version == (3,0):
+ self.masterSecret = PRF_SSL(premasterSecret,
+ concatArrays(clientRandom, serverRandom), 48)
+ elif version in ((3,1), (3,2)):
+ self.masterSecret = PRF(premasterSecret, "master secret",
+ concatArrays(clientRandom, serverRandom), 48)
+ else:
+ raise AssertionError()
+
+ def valid(self):
+ """If this session can be used for session resumption.
+
+ @rtype: bool
+ @return: If this session can be used for session resumption.
+ """
+ return self.resumable or self.sharedKey
+
+ def _setResumable(self, boolean):
+ #Only let it be set if this isn't a shared key
+ if not self.sharedKey:
+ #Only let it be set to True if the sessionID is non-null
+ if (not boolean) or (boolean and self.sessionID):
+ self.resumable = boolean
+
+ def getCipherName(self):
+ """Get the name of the cipher used with this connection.
+
+ @rtype: str
+ @return: The name of the cipher used with this connection.
+ Either 'aes128', 'aes256', 'rc4', or '3des'.
+ """
+ if self.cipherSuite in CipherSuite.aes128Suites:
+ return "aes128"
+ elif self.cipherSuite in CipherSuite.aes256Suites:
+ return "aes256"
+ elif self.cipherSuite in CipherSuite.rc4Suites:
+ return "rc4"
+ elif self.cipherSuite in CipherSuite.tripleDESSuites:
+ return "3des"
+ else:
+ return None
+
+ def _createSharedKey(self, sharedKeyUsername, sharedKey):
+ if len(sharedKeyUsername)>16:
+ raise ValueError()
+ if len(sharedKey)>47:
+ raise ValueError()
+
+ self.sharedKeyUsername = sharedKeyUsername
+
+ self.sessionID = createByteArrayZeros(16)
+ for x in range(len(sharedKeyUsername)):
+ self.sessionID[x] = ord(sharedKeyUsername[x])
+
+ premasterSecret = createByteArrayZeros(48)
+ sharedKey = chr(len(sharedKey)) + sharedKey
+ for x in range(48):
+ premasterSecret[x] = ord(sharedKey[x % len(sharedKey)])
+
+ self.masterSecret = PRF(premasterSecret, "shared secret",
+ createByteArraySequence([]), 48)
+ self.sharedKey = True
+ return self
+
+
diff --git a/src/gdata/tlslite/SessionCache.py b/src/gdata/tlslite/SessionCache.py
new file mode 100755
index 0000000..34cf0b0
--- /dev/null
+++ b/src/gdata/tlslite/SessionCache.py
@@ -0,0 +1,103 @@
+"""Class for caching TLS sessions."""
+
+import thread
+import time
+
+class SessionCache:
+ """This class is used by the server to cache TLS sessions.
+
+ Caching sessions allows the client to use TLS session resumption
+ and avoid the expense of a full handshake. To use this class,
+ simply pass a SessionCache instance into the server handshake
+ function.
+
+ This class is thread-safe.
+ """
+
+ #References to these instances
+ #are also held by the caller, who may change the 'resumable'
+ #flag, so the SessionCache must return the same instances
+ #it was passed in.
+
+ def __init__(self, maxEntries=10000, maxAge=14400):
+ """Create a new SessionCache.
+
+ @type maxEntries: int
+ @param maxEntries: The maximum size of the cache. When this
+ limit is reached, the oldest sessions will be deleted as
+ necessary to make room for new ones. The default is 10000.
+
+ @type maxAge: int
+ @param maxAge: The number of seconds before a session expires
+ from the cache. The default is 14400 (i.e. 4 hours)."""
+
+ self.lock = thread.allocate_lock()
+
+ # Maps sessionIDs to sessions
+ self.entriesDict = {}
+
+ #Circular list of (sessionID, timestamp) pairs
+ self.entriesList = [(None,None)] * maxEntries
+
+ self.firstIndex = 0
+ self.lastIndex = 0
+ self.maxAge = maxAge
+
+ def __getitem__(self, sessionID):
+ self.lock.acquire()
+ try:
+ self._purge() #Delete old items, so we're assured of a new one
+ session = self.entriesDict[sessionID]
+
+ #When we add sessions they're resumable, but it's possible
+ #for the session to be invalidated later on (if a fatal alert
+ #is returned), so we have to check for resumability before
+ #returning the session.
+
+ if session.valid():
+ return session
+ else:
+ raise KeyError()
+ finally:
+ self.lock.release()
+
+
+ def __setitem__(self, sessionID, session):
+ self.lock.acquire()
+ try:
+ #Add the new element
+ self.entriesDict[sessionID] = session
+ self.entriesList[self.lastIndex] = (sessionID, time.time())
+ self.lastIndex = (self.lastIndex+1) % len(self.entriesList)
+
+ #If the cache is full, we delete the oldest element to make an
+ #empty space
+ if self.lastIndex == self.firstIndex:
+ del(self.entriesDict[self.entriesList[self.firstIndex][0]])
+ self.firstIndex = (self.firstIndex+1) % len(self.entriesList)
+ finally:
+ self.lock.release()
+
+ #Delete expired items
+ def _purge(self):
+ currentTime = time.time()
+
+ #Search through the circular list, deleting expired elements until
+ #we reach a non-expired element. Since elements in list are
+ #ordered in time, we can break once we reach the first non-expired
+ #element
+ index = self.firstIndex
+ while index != self.lastIndex:
+ if currentTime - self.entriesList[index][1] > self.maxAge:
+ del(self.entriesDict[self.entriesList[index][0]])
+ index = (index+1) % len(self.entriesList)
+ else:
+ break
+ self.firstIndex = index
+
+def _test():
+ import doctest, SessionCache
+ return doctest.testmod(SessionCache)
+
+if __name__ == "__main__":
+ _test()
diff --git a/src/gdata/tlslite/SharedKeyDB.py b/src/gdata/tlslite/SharedKeyDB.py
new file mode 100755
index 0000000..3246ec7
--- /dev/null
+++ b/src/gdata/tlslite/SharedKeyDB.py
@@ -0,0 +1,58 @@
+"""Class for storing shared keys."""
+
+from utils.cryptomath import *
+from utils.compat import *
+from mathtls import *
+from Session import Session
+from BaseDB import BaseDB
+
+class SharedKeyDB(BaseDB):
+ """This class represent an in-memory or on-disk database of shared
+ keys.
+
+ A SharedKeyDB can be passed to a server handshake function to
+ authenticate a client based on one of the shared keys.
+
+ This class is thread-safe.
+ """
+
+ def __init__(self, filename=None):
+ """Create a new SharedKeyDB.
+
+ @type filename: str
+ @param filename: Filename for an on-disk database, or None for
+ an in-memory database. If the filename already exists, follow
+ this with a call to open(). To create a new on-disk database,
+ follow this with a call to create().
+ """
+ BaseDB.__init__(self, filename, "shared key")
+
+ def _getItem(self, username, valueStr):
+ session = Session()
+ session._createSharedKey(username, valueStr)
+ return session
+
+ def __setitem__(self, username, sharedKey):
+ """Add a shared key to the database.
+
+ @type username: str
+ @param username: The username to associate the shared key with.
+ Must be less than or equal to 16 characters in length, and must
+ not already be in the database.
+
+ @type sharedKey: str
+ @param sharedKey: The shared key to add. Must be less than 48
+ characters in length.
+ """
+ BaseDB.__setitem__(self, username, sharedKey)
+
+ def _setItem(self, username, value):
+ if len(username)>16:
+ raise ValueError("username too long")
+ if len(value)>=48:
+ raise ValueError("shared key too long")
+ return value
+
+ def _checkItem(self, value, username, param):
+ newSession = self._getItem(username, param)
+ return value.masterSecret == newSession.masterSecret
\ No newline at end of file
diff --git a/src/gdata/tlslite/TLSConnection.py b/src/gdata/tlslite/TLSConnection.py
new file mode 100755
index 0000000..d125f8f
--- /dev/null
+++ b/src/gdata/tlslite/TLSConnection.py
@@ -0,0 +1,1600 @@
+"""
+MAIN CLASS FOR TLS LITE (START HERE!).
+"""
+from __future__ import generators
+
+import socket
+from utils.compat import formatExceptionTrace
+from TLSRecordLayer import TLSRecordLayer
+from Session import Session
+from constants import *
+from utils.cryptomath import getRandomBytes
+from errors import *
+from messages import *
+from mathtls import *
+from HandshakeSettings import HandshakeSettings
+
+
+class TLSConnection(TLSRecordLayer):
+ """
+ This class wraps a socket and provides TLS handshaking and data
+ transfer.
+
+ To use this class, create a new instance, passing a connected
+ socket into the constructor. Then call some handshake function.
+ If the handshake completes without raising an exception, then a TLS
+ connection has been negotiated. You can transfer data over this
+ connection as if it were a socket.
+
+ This class provides both synchronous and asynchronous versions of
+ its key functions. The synchronous versions should be used when
+ writing single-or multi-threaded code using blocking sockets. The
+ asynchronous versions should be used when performing asynchronous,
+ event-based I/O with non-blocking sockets.
+
+ Asynchronous I/O is a complicated subject; typically, you should
+ not use the asynchronous functions directly, but should use some
+ framework like asyncore or Twisted which TLS Lite integrates with
+ (see
+ L{tlslite.integration.TLSAsyncDispatcherMixIn.TLSAsyncDispatcherMixIn} or
+ L{tlslite.integration.TLSTwistedProtocolWrapper.TLSTwistedProtocolWrapper}).
+ """
+
+
+ def __init__(self, sock):
+ """Create a new TLSConnection instance.
+
+ @param sock: The socket data will be transmitted on. The
+ socket should already be connected. It may be in blocking or
+ non-blocking mode.
+
+ @type sock: L{socket.socket}
+ """
+ TLSRecordLayer.__init__(self, sock)
+
+ def handshakeClientSRP(self, username, password, session=None,
+ settings=None, checker=None, async=False):
+ """Perform an SRP handshake in the role of client.
+
+ This function performs a TLS/SRP handshake. SRP mutually
+ authenticates both parties to each other using only a
+ username and password. This function may also perform a
+ combined SRP and server-certificate handshake, if the server
+ chooses to authenticate itself with a certificate chain in
+ addition to doing SRP.
+
+ TLS/SRP is non-standard. Most TLS implementations don't
+ support it. See
+ U{http://www.ietf.org/html.charters/tls-charter.html} or
+ U{http://trevp.net/tlssrp/} for the latest information on
+ TLS/SRP.
+
+ Like any handshake function, this can be called on a closed
+ TLS connection, or on a TLS connection that is already open.
+ If called on an open connection it performs a re-handshake.
+
+ If the function completes without raising an exception, the
+ TLS connection will be open and available for data transfer.
+
+ If an exception is raised, the connection will have been
+ automatically closed (if it was ever open).
+
+ @type username: str
+ @param username: The SRP username.
+
+ @type password: str
+ @param password: The SRP password.
+
+ @type session: L{tlslite.Session.Session}
+ @param session: A TLS session to attempt to resume. This
+ session must be an SRP session performed with the same username
+ and password as were passed in. If the resumption does not
+ succeed, a full SRP handshake will be performed.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+
+ @type checker: L{tlslite.Checker.Checker}
+ @param checker: A Checker instance. This instance will be
+ invoked to examine the other party's authentication
+ credentials, if the handshake completes succesfully.
+
+ @type async: bool
+ @param async: If False, this function will block until the
+ handshake is completed. If True, this function will return a
+ generator. Successive invocations of the generator will
+ return 0 if it is waiting to read from the socket, 1 if it is
+ waiting to write to the socket, or will raise StopIteration if
+ the handshake operation is completed.
+
+ @rtype: None or an iterable
+ @return: If 'async' is True, a generator object will be
+ returned.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ @raise tlslite.errors.TLSAuthenticationError: If the checker
+ doesn't like the other party's authentication credentials.
+ """
+ handshaker = self._handshakeClientAsync(srpParams=(username, password),
+ session=session, settings=settings, checker=checker)
+ if async:
+ return handshaker
+ for result in handshaker:
+ pass
+
+ def handshakeClientCert(self, certChain=None, privateKey=None,
+ session=None, settings=None, checker=None,
+ async=False):
+ """Perform a certificate-based handshake in the role of client.
+
+ This function performs an SSL or TLS handshake. The server
+ will authenticate itself using an X.509 or cryptoID certificate
+ chain. If the handshake succeeds, the server's certificate
+ chain will be stored in the session's serverCertChain attribute.
+ Unless a checker object is passed in, this function does no
+ validation or checking of the server's certificate chain.
+
+ If the server requests client authentication, the
+ client will send the passed-in certificate chain, and use the
+ passed-in private key to authenticate itself. If no
+ certificate chain and private key were passed in, the client
+ will attempt to proceed without client authentication. The
+ server may or may not allow this.
+
+ Like any handshake function, this can be called on a closed
+ TLS connection, or on a TLS connection that is already open.
+ If called on an open connection it performs a re-handshake.
+
+ If the function completes without raising an exception, the
+ TLS connection will be open and available for data transfer.
+
+ If an exception is raised, the connection will have been
+ automatically closed (if it was ever open).
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: The certificate chain to be used if the
+ server requests client authentication.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: The private key to be used if the server
+ requests client authentication.
+
+ @type session: L{tlslite.Session.Session}
+ @param session: A TLS session to attempt to resume. If the
+ resumption does not succeed, a full handshake will be
+ performed.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+
+ @type checker: L{tlslite.Checker.Checker}
+ @param checker: A Checker instance. This instance will be
+ invoked to examine the other party's authentication
+ credentials, if the handshake completes succesfully.
+
+ @type async: bool
+ @param async: If False, this function will block until the
+ handshake is completed. If True, this function will return a
+ generator. Successive invocations of the generator will
+ return 0 if it is waiting to read from the socket, 1 if it is
+ waiting to write to the socket, or will raise StopIteration if
+ the handshake operation is completed.
+
+ @rtype: None or an iterable
+ @return: If 'async' is True, a generator object will be
+ returned.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ @raise tlslite.errors.TLSAuthenticationError: If the checker
+ doesn't like the other party's authentication credentials.
+ """
+ handshaker = self._handshakeClientAsync(certParams=(certChain,
+ privateKey), session=session, settings=settings,
+ checker=checker)
+ if async:
+ return handshaker
+ for result in handshaker:
+ pass
+
+ def handshakeClientUnknown(self, srpCallback=None, certCallback=None,
+ session=None, settings=None, checker=None,
+ async=False):
+ """Perform a to-be-determined type of handshake in the role of client.
+
+ This function performs an SSL or TLS handshake. If the server
+ requests client certificate authentication, the
+ certCallback will be invoked and should return a (certChain,
+ privateKey) pair. If the callback returns None, the library
+ will attempt to proceed without client authentication. The
+ server may or may not allow this.
+
+ If the server requests SRP authentication, the srpCallback
+ will be invoked and should return a (username, password) pair.
+ If the callback returns None, the local implementation will
+ signal a user_canceled error alert.
+
+ After the handshake completes, the client can inspect the
+ connection's session attribute to determine what type of
+ authentication was performed.
+
+ Like any handshake function, this can be called on a closed
+ TLS connection, or on a TLS connection that is already open.
+ If called on an open connection it performs a re-handshake.
+
+ If the function completes without raising an exception, the
+ TLS connection will be open and available for data transfer.
+
+ If an exception is raised, the connection will have been
+ automatically closed (if it was ever open).
+
+ @type srpCallback: callable
+ @param srpCallback: The callback to be used if the server
+ requests SRP authentication. If None, the client will not
+ offer support for SRP ciphersuites.
+
+ @type certCallback: callable
+ @param certCallback: The callback to be used if the server
+ requests client certificate authentication.
+
+ @type session: L{tlslite.Session.Session}
+ @param session: A TLS session to attempt to resume. If the
+ resumption does not succeed, a full handshake will be
+ performed.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+
+ @type checker: L{tlslite.Checker.Checker}
+ @param checker: A Checker instance. This instance will be
+ invoked to examine the other party's authentication
+ credentials, if the handshake completes succesfully.
+
+ @type async: bool
+ @param async: If False, this function will block until the
+ handshake is completed. If True, this function will return a
+ generator. Successive invocations of the generator will
+ return 0 if it is waiting to read from the socket, 1 if it is
+ waiting to write to the socket, or will raise StopIteration if
+ the handshake operation is completed.
+
+ @rtype: None or an iterable
+ @return: If 'async' is True, a generator object will be
+ returned.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ @raise tlslite.errors.TLSAuthenticationError: If the checker
+ doesn't like the other party's authentication credentials.
+ """
+ handshaker = self._handshakeClientAsync(unknownParams=(srpCallback,
+ certCallback), session=session, settings=settings,
+ checker=checker)
+ if async:
+ return handshaker
+ for result in handshaker:
+ pass
+
+ def handshakeClientSharedKey(self, username, sharedKey, settings=None,
+ checker=None, async=False):
+ """Perform a shared-key handshake in the role of client.
+
+ This function performs a shared-key handshake. Using shared
+ symmetric keys of high entropy (128 bits or greater) mutually
+ authenticates both parties to each other.
+
+ TLS with shared-keys is non-standard. Most TLS
+ implementations don't support it. See
+ U{http://www.ietf.org/html.charters/tls-charter.html} for the
+ latest information on TLS with shared-keys. If the shared-keys
+ Internet-Draft changes or is superceded, TLS Lite will track
+ those changes, so the shared-key support in later versions of
+ TLS Lite may become incompatible with this version.
+
+ Like any handshake function, this can be called on a closed
+ TLS connection, or on a TLS connection that is already open.
+ If called on an open connection it performs a re-handshake.
+
+ If the function completes without raising an exception, the
+ TLS connection will be open and available for data transfer.
+
+ If an exception is raised, the connection will have been
+ automatically closed (if it was ever open).
+
+ @type username: str
+ @param username: The shared-key username.
+
+ @type sharedKey: str
+ @param sharedKey: The shared key.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+
+ @type checker: L{tlslite.Checker.Checker}
+ @param checker: A Checker instance. This instance will be
+ invoked to examine the other party's authentication
+ credentials, if the handshake completes succesfully.
+
+ @type async: bool
+ @param async: If False, this function will block until the
+ handshake is completed. If True, this function will return a
+ generator. Successive invocations of the generator will
+ return 0 if it is waiting to read from the socket, 1 if it is
+ waiting to write to the socket, or will raise StopIteration if
+ the handshake operation is completed.
+
+ @rtype: None or an iterable
+ @return: If 'async' is True, a generator object will be
+ returned.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ @raise tlslite.errors.TLSAuthenticationError: If the checker
+ doesn't like the other party's authentication credentials.
+ """
+ handshaker = self._handshakeClientAsync(sharedKeyParams=(username,
+ sharedKey), settings=settings, checker=checker)
+ if async:
+ return handshaker
+ for result in handshaker:
+ pass
+
+ def _handshakeClientAsync(self, srpParams=(), certParams=(),
+ unknownParams=(), sharedKeyParams=(),
+ session=None, settings=None, checker=None,
+ recursive=False):
+
+ handshaker = self._handshakeClientAsyncHelper(srpParams=srpParams,
+ certParams=certParams, unknownParams=unknownParams,
+ sharedKeyParams=sharedKeyParams, session=session,
+ settings=settings, recursive=recursive)
+ for result in self._handshakeWrapperAsync(handshaker, checker):
+ yield result
+
+
+ def _handshakeClientAsyncHelper(self, srpParams, certParams, unknownParams,
+ sharedKeyParams, session, settings, recursive):
+ if not recursive:
+ self._handshakeStart(client=True)
+
+ #Unpack parameters
+ srpUsername = None # srpParams
+ password = None # srpParams
+ clientCertChain = None # certParams
+ privateKey = None # certParams
+ srpCallback = None # unknownParams
+ certCallback = None # unknownParams
+ #session # sharedKeyParams (or session)
+ #settings # settings
+
+ if srpParams:
+ srpUsername, password = srpParams
+ elif certParams:
+ clientCertChain, privateKey = certParams
+ elif unknownParams:
+ srpCallback, certCallback = unknownParams
+ elif sharedKeyParams:
+ session = Session()._createSharedKey(*sharedKeyParams)
+
+ if not settings:
+ settings = HandshakeSettings()
+ settings = settings._filter()
+
+ #Validate parameters
+ if srpUsername and not password:
+ raise ValueError("Caller passed a username but no password")
+ if password and not srpUsername:
+ raise ValueError("Caller passed a password but no username")
+
+ if clientCertChain and not privateKey:
+ raise ValueError("Caller passed a certChain but no privateKey")
+ if privateKey and not clientCertChain:
+ raise ValueError("Caller passed a privateKey but no certChain")
+
+ if clientCertChain:
+ foundType = False
+ try:
+ import cryptoIDlib.CertChain
+ if isinstance(clientCertChain, cryptoIDlib.CertChain.CertChain):
+ if "cryptoID" not in settings.certificateTypes:
+ raise ValueError("Client certificate doesn't "\
+ "match Handshake Settings")
+ settings.certificateTypes = ["cryptoID"]
+ foundType = True
+ except ImportError:
+ pass
+ if not foundType and isinstance(clientCertChain,
+ X509CertChain):
+ if "x509" not in settings.certificateTypes:
+ raise ValueError("Client certificate doesn't match "\
+ "Handshake Settings")
+ settings.certificateTypes = ["x509"]
+ foundType = True
+ if not foundType:
+ raise ValueError("Unrecognized certificate type")
+
+
+ if session:
+ if not session.valid():
+ session = None #ignore non-resumable sessions...
+ elif session.resumable and \
+ (session.srpUsername != srpUsername):
+ raise ValueError("Session username doesn't match")
+
+ #Add Faults to parameters
+ if srpUsername and self.fault == Fault.badUsername:
+ srpUsername += "GARBAGE"
+ if password and self.fault == Fault.badPassword:
+ password += "GARBAGE"
+ if sharedKeyParams:
+ identifier = sharedKeyParams[0]
+ sharedKey = sharedKeyParams[1]
+ if self.fault == Fault.badIdentifier:
+ identifier += "GARBAGE"
+ session = Session()._createSharedKey(identifier, sharedKey)
+ elif self.fault == Fault.badSharedKey:
+ sharedKey += "GARBAGE"
+ session = Session()._createSharedKey(identifier, sharedKey)
+
+
+ #Initialize locals
+ serverCertChain = None
+ cipherSuite = 0
+ certificateType = CertificateType.x509
+ premasterSecret = None
+
+ #Get client nonce
+ clientRandom = getRandomBytes(32)
+
+ #Initialize acceptable ciphersuites
+ cipherSuites = []
+ if srpParams:
+ cipherSuites += CipherSuite.getSrpRsaSuites(settings.cipherNames)
+ cipherSuites += CipherSuite.getSrpSuites(settings.cipherNames)
+ elif certParams:
+ cipherSuites += CipherSuite.getRsaSuites(settings.cipherNames)
+ elif unknownParams:
+ if srpCallback:
+ cipherSuites += \
+ CipherSuite.getSrpRsaSuites(settings.cipherNames)
+ cipherSuites += \
+ CipherSuite.getSrpSuites(settings.cipherNames)
+ cipherSuites += CipherSuite.getRsaSuites(settings.cipherNames)
+ elif sharedKeyParams:
+ cipherSuites += CipherSuite.getRsaSuites(settings.cipherNames)
+ else:
+ cipherSuites += CipherSuite.getRsaSuites(settings.cipherNames)
+
+ #Initialize acceptable certificate types
+ certificateTypes = settings._getCertificateTypes()
+
+ #Tentatively set the version to the client's minimum version.
+ #We'll use this for the ClientHello, and if an error occurs
+ #parsing the Server Hello, we'll use this version for the response
+ self.version = settings.maxVersion
+
+ #Either send ClientHello (with a resumable session)...
+ if session:
+ #If it's a resumable (i.e. not a shared-key session), then its
+ #ciphersuite must be one of the acceptable ciphersuites
+ if (not sharedKeyParams) and \
+ session.cipherSuite not in cipherSuites:
+ raise ValueError("Session's cipher suite not consistent "\
+ "with parameters")
+ else:
+ clientHello = ClientHello()
+ clientHello.create(settings.maxVersion, clientRandom,
+ session.sessionID, cipherSuites,
+ certificateTypes, session.srpUsername)
+
+ #Or send ClientHello (without)
+ else:
+ clientHello = ClientHello()
+ clientHello.create(settings.maxVersion, clientRandom,
+ createByteArraySequence([]), cipherSuites,
+ certificateTypes, srpUsername)
+ for result in self._sendMsg(clientHello):
+ yield result
+
+ #Get ServerHello (or missing_srp_username)
+ for result in self._getMsg((ContentType.handshake,
+ ContentType.alert),
+ HandshakeType.server_hello):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ msg = result
+
+ if isinstance(msg, ServerHello):
+ serverHello = msg
+ elif isinstance(msg, Alert):
+ alert = msg
+
+ #If it's not a missing_srp_username, re-raise
+ if alert.description != AlertDescription.missing_srp_username:
+ self._shutdown(False)
+ raise TLSRemoteAlert(alert)
+
+ #If we're not in SRP callback mode, we won't have offered SRP
+ #without a username, so we shouldn't get this alert
+ if not srpCallback:
+ for result in self._sendError(\
+ AlertDescription.unexpected_message):
+ yield result
+ srpParams = srpCallback()
+ #If the callback returns None, cancel the handshake
+ if srpParams == None:
+ for result in self._sendError(AlertDescription.user_canceled):
+ yield result
+
+ #Recursively perform handshake
+ for result in self._handshakeClientAsyncHelper(srpParams,
+ None, None, None, None, settings, True):
+ yield result
+ return
+
+ #Get the server version. Do this before anything else, so any
+ #error alerts will use the server's version
+ self.version = serverHello.server_version
+
+ #Future responses from server must use this version
+ self._versionCheck = True
+
+ #Check ServerHello
+ if serverHello.server_version < settings.minVersion:
+ for result in self._sendError(\
+ AlertDescription.protocol_version,
+ "Too old version: %s" % str(serverHello.server_version)):
+ yield result
+ if serverHello.server_version > settings.maxVersion:
+ for result in self._sendError(\
+ AlertDescription.protocol_version,
+ "Too new version: %s" % str(serverHello.server_version)):
+ yield result
+ if serverHello.cipher_suite not in cipherSuites:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Server responded with incorrect ciphersuite"):
+ yield result
+ if serverHello.certificate_type not in certificateTypes:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Server responded with incorrect certificate type"):
+ yield result
+ if serverHello.compression_method != 0:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Server responded with incorrect compression method"):
+ yield result
+
+ #Get the server nonce
+ serverRandom = serverHello.random
+
+ #If the server agrees to resume
+ if session and session.sessionID and \
+ serverHello.session_id == session.sessionID:
+
+ #If a shared-key, we're flexible about suites; otherwise the
+ #server-chosen suite has to match the session's suite
+ if sharedKeyParams:
+ session.cipherSuite = serverHello.cipher_suite
+ elif serverHello.cipher_suite != session.cipherSuite:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,\
+ "Server's ciphersuite doesn't match session"):
+ yield result
+
+ #Set the session for this connection
+ self.session = session
+
+ #Calculate pending connection states
+ self._calcPendingStates(clientRandom, serverRandom,
+ settings.cipherImplementations)
+
+ #Exchange ChangeCipherSpec and Finished messages
+ for result in self._getFinished():
+ yield result
+ for result in self._sendFinished():
+ yield result
+
+ #Mark the connection as open
+ self._handshakeDone(resumed=True)
+
+ #If server DOES NOT agree to resume
+ else:
+
+ if sharedKeyParams:
+ for result in self._sendError(\
+ AlertDescription.user_canceled,
+ "Was expecting a shared-key resumption"):
+ yield result
+
+ #We've already validated these
+ cipherSuite = serverHello.cipher_suite
+ certificateType = serverHello.certificate_type
+
+ #If the server chose an SRP suite...
+ if cipherSuite in CipherSuite.srpSuites:
+ #Get ServerKeyExchange, ServerHelloDone
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.server_key_exchange, cipherSuite):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverKeyExchange = result
+
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.server_hello_done):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverHelloDone = result
+
+ #If the server chose an SRP+RSA suite...
+ elif cipherSuite in CipherSuite.srpRsaSuites:
+ #Get Certificate, ServerKeyExchange, ServerHelloDone
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.certificate, certificateType):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverCertificate = result
+
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.server_key_exchange, cipherSuite):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverKeyExchange = result
+
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.server_hello_done):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverHelloDone = result
+
+ #If the server chose an RSA suite...
+ elif cipherSuite in CipherSuite.rsaSuites:
+ #Get Certificate[, CertificateRequest], ServerHelloDone
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.certificate, certificateType):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverCertificate = result
+
+ for result in self._getMsg(ContentType.handshake,
+ (HandshakeType.server_hello_done,
+ HandshakeType.certificate_request)):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ msg = result
+
+ certificateRequest = None
+ if isinstance(msg, CertificateRequest):
+ certificateRequest = msg
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.server_hello_done):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ serverHelloDone = result
+ elif isinstance(msg, ServerHelloDone):
+ serverHelloDone = msg
+ else:
+ raise AssertionError()
+
+
+ #Calculate SRP premaster secret, if server chose an SRP or
+ #SRP+RSA suite
+ if cipherSuite in CipherSuite.srpSuites + \
+ CipherSuite.srpRsaSuites:
+ #Get and check the server's group parameters and B value
+ N = serverKeyExchange.srp_N
+ g = serverKeyExchange.srp_g
+ s = serverKeyExchange.srp_s
+ B = serverKeyExchange.srp_B
+
+ if (g,N) not in goodGroupParameters:
+ for result in self._sendError(\
+ AlertDescription.untrusted_srp_parameters,
+ "Unknown group parameters"):
+ yield result
+ if numBits(N) < settings.minKeySize:
+ for result in self._sendError(\
+ AlertDescription.untrusted_srp_parameters,
+ "N value is too small: %d" % numBits(N)):
+ yield result
+ if numBits(N) > settings.maxKeySize:
+ for result in self._sendError(\
+ AlertDescription.untrusted_srp_parameters,
+ "N value is too large: %d" % numBits(N)):
+ yield result
+ if B % N == 0:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Suspicious B value"):
+ yield result
+
+ #Check the server's signature, if server chose an
+ #SRP+RSA suite
+ if cipherSuite in CipherSuite.srpRsaSuites:
+ #Hash ServerKeyExchange/ServerSRPParams
+ hashBytes = serverKeyExchange.hash(clientRandom,
+ serverRandom)
+
+ #Extract signature bytes from ServerKeyExchange
+ sigBytes = serverKeyExchange.signature
+ if len(sigBytes) == 0:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Server sent an SRP ServerKeyExchange "\
+ "message without a signature"):
+ yield result
+
+ #Get server's public key from the Certificate message
+ for result in self._getKeyFromChain(serverCertificate,
+ settings):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ publicKey, serverCertChain = result
+
+ #Verify signature
+ if not publicKey.verify(sigBytes, hashBytes):
+ for result in self._sendError(\
+ AlertDescription.decrypt_error,
+ "Signature failed to verify"):
+ yield result
+
+
+ #Calculate client's ephemeral DH values (a, A)
+ a = bytesToNumber(getRandomBytes(32))
+ A = powMod(g, a, N)
+
+ #Calculate client's static DH values (x, v)
+ x = makeX(bytesToString(s), srpUsername, password)
+ v = powMod(g, x, N)
+
+ #Calculate u
+ u = makeU(N, A, B)
+
+ #Calculate premaster secret
+ k = makeK(N, g)
+ S = powMod((B - (k*v)) % N, a+(u*x), N)
+
+ if self.fault == Fault.badA:
+ A = N
+ S = 0
+ premasterSecret = numberToBytes(S)
+
+ #Send ClientKeyExchange
+ for result in self._sendMsg(\
+ ClientKeyExchange(cipherSuite).createSRP(A)):
+ yield result
+
+
+ #Calculate RSA premaster secret, if server chose an RSA suite
+ elif cipherSuite in CipherSuite.rsaSuites:
+
+ #Handle the presence of a CertificateRequest
+ if certificateRequest:
+ if unknownParams and certCallback:
+ certParamsNew = certCallback()
+ if certParamsNew:
+ clientCertChain, privateKey = certParamsNew
+
+ #Get server's public key from the Certificate message
+ for result in self._getKeyFromChain(serverCertificate,
+ settings):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ publicKey, serverCertChain = result
+
+
+ #Calculate premaster secret
+ premasterSecret = getRandomBytes(48)
+ premasterSecret[0] = settings.maxVersion[0]
+ premasterSecret[1] = settings.maxVersion[1]
+
+ if self.fault == Fault.badPremasterPadding:
+ premasterSecret[0] = 5
+ if self.fault == Fault.shortPremasterSecret:
+ premasterSecret = premasterSecret[:-1]
+
+ #Encrypt premaster secret to server's public key
+ encryptedPreMasterSecret = publicKey.encrypt(premasterSecret)
+
+ #If client authentication was requested, send Certificate
+ #message, either with certificates or empty
+ if certificateRequest:
+ clientCertificate = Certificate(certificateType)
+
+ if clientCertChain:
+ #Check to make sure we have the same type of
+ #certificates the server requested
+ wrongType = False
+ if certificateType == CertificateType.x509:
+ if not isinstance(clientCertChain, X509CertChain):
+ wrongType = True
+ elif certificateType == CertificateType.cryptoID:
+ if not isinstance(clientCertChain,
+ cryptoIDlib.CertChain.CertChain):
+ wrongType = True
+ if wrongType:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure,
+ "Client certificate is of wrong type"):
+ yield result
+
+ clientCertificate.create(clientCertChain)
+
+ for result in self._sendMsg(clientCertificate):
+ yield result
+ else:
+ #The server didn't request client auth, so we
+ #zeroize these so the clientCertChain won't be
+ #stored in the session.
+ privateKey = None
+ clientCertChain = None
+
+ #Send ClientKeyExchange
+ clientKeyExchange = ClientKeyExchange(cipherSuite,
+ self.version)
+ clientKeyExchange.createRSA(encryptedPreMasterSecret)
+ for result in self._sendMsg(clientKeyExchange):
+ yield result
+
+ #If client authentication was requested and we have a
+ #private key, send CertificateVerify
+ if certificateRequest and privateKey:
+ if self.version == (3,0):
+ #Create a temporary session object, just for the
+ #purpose of creating the CertificateVerify
+ session = Session()
+ session._calcMasterSecret(self.version,
+ premasterSecret,
+ clientRandom,
+ serverRandom)
+ verifyBytes = self._calcSSLHandshakeHash(\
+ session.masterSecret, "")
+ elif self.version in ((3,1), (3,2)):
+ verifyBytes = stringToBytes(\
+ self._handshake_md5.digest() + \
+ self._handshake_sha.digest())
+ if self.fault == Fault.badVerifyMessage:
+ verifyBytes[0] = ((verifyBytes[0]+1) % 256)
+ signedBytes = privateKey.sign(verifyBytes)
+ certificateVerify = CertificateVerify()
+ certificateVerify.create(signedBytes)
+ for result in self._sendMsg(certificateVerify):
+ yield result
+
+
+ #Create the session object
+ self.session = Session()
+ self.session._calcMasterSecret(self.version, premasterSecret,
+ clientRandom, serverRandom)
+ self.session.sessionID = serverHello.session_id
+ self.session.cipherSuite = cipherSuite
+ self.session.srpUsername = srpUsername
+ self.session.clientCertChain = clientCertChain
+ self.session.serverCertChain = serverCertChain
+
+ #Calculate pending connection states
+ self._calcPendingStates(clientRandom, serverRandom,
+ settings.cipherImplementations)
+
+ #Exchange ChangeCipherSpec and Finished messages
+ for result in self._sendFinished():
+ yield result
+ for result in self._getFinished():
+ yield result
+
+ #Mark the connection as open
+ self.session._setResumable(True)
+ self._handshakeDone(resumed=False)
+
+
+
+ def handshakeServer(self, sharedKeyDB=None, verifierDB=None,
+ certChain=None, privateKey=None, reqCert=False,
+ sessionCache=None, settings=None, checker=None):
+ """Perform a handshake in the role of server.
+
+ This function performs an SSL or TLS handshake. Depending on
+ the arguments and the behavior of the client, this function can
+ perform a shared-key, SRP, or certificate-based handshake. It
+ can also perform a combined SRP and server-certificate
+ handshake.
+
+ Like any handshake function, this can be called on a closed
+ TLS connection, or on a TLS connection that is already open.
+ If called on an open connection it performs a re-handshake.
+ This function does not send a Hello Request message before
+ performing the handshake, so if re-handshaking is required,
+ the server must signal the client to begin the re-handshake
+ through some other means.
+
+ If the function completes without raising an exception, the
+ TLS connection will be open and available for data transfer.
+
+ If an exception is raised, the connection will have been
+ automatically closed (if it was ever open).
+
+ @type sharedKeyDB: L{tlslite.SharedKeyDB.SharedKeyDB}
+ @param sharedKeyDB: A database of shared symmetric keys
+ associated with usernames. If the client performs a
+ shared-key handshake, the session's sharedKeyUsername
+ attribute will be set.
+
+ @type verifierDB: L{tlslite.VerifierDB.VerifierDB}
+ @param verifierDB: A database of SRP password verifiers
+ associated with usernames. If the client performs an SRP
+ handshake, the session's srpUsername attribute will be set.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: The certificate chain to be used if the
+ client requests server certificate authentication.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: The private key to be used if the client
+ requests server certificate authentication.
+
+ @type reqCert: bool
+ @param reqCert: Whether to request client certificate
+ authentication. This only applies if the client chooses server
+ certificate authentication; if the client chooses SRP or
+ shared-key authentication, this will be ignored. If the client
+ performs a client certificate authentication, the sessions's
+ clientCertChain attribute will be set.
+
+ @type sessionCache: L{tlslite.SessionCache.SessionCache}
+ @param sessionCache: An in-memory cache of resumable sessions.
+ The client can resume sessions from this cache. Alternatively,
+ if the client performs a full handshake, a new session will be
+ added to the cache.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites and SSL/TLS version chosen by the server.
+
+ @type checker: L{tlslite.Checker.Checker}
+ @param checker: A Checker instance. This instance will be
+ invoked to examine the other party's authentication
+ credentials, if the handshake completes succesfully.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ @raise tlslite.errors.TLSAuthenticationError: If the checker
+ doesn't like the other party's authentication credentials.
+ """
+ for result in self.handshakeServerAsync(sharedKeyDB, verifierDB,
+ certChain, privateKey, reqCert, sessionCache, settings,
+ checker):
+ pass
+
+
+ def handshakeServerAsync(self, sharedKeyDB=None, verifierDB=None,
+ certChain=None, privateKey=None, reqCert=False,
+ sessionCache=None, settings=None, checker=None):
+ """Start a server handshake operation on the TLS connection.
+
+ This function returns a generator which behaves similarly to
+ handshakeServer(). Successive invocations of the generator
+ will return 0 if it is waiting to read from the socket, 1 if it is
+ waiting to write to the socket, or it will raise StopIteration
+ if the handshake operation is complete.
+
+ @rtype: iterable
+ @return: A generator; see above for details.
+ """
+ handshaker = self._handshakeServerAsyncHelper(\
+ sharedKeyDB=sharedKeyDB,
+ verifierDB=verifierDB, certChain=certChain,
+ privateKey=privateKey, reqCert=reqCert,
+ sessionCache=sessionCache, settings=settings)
+ for result in self._handshakeWrapperAsync(handshaker, checker):
+ yield result
+
+
+ def _handshakeServerAsyncHelper(self, sharedKeyDB, verifierDB,
+ certChain, privateKey, reqCert, sessionCache,
+ settings):
+
+ self._handshakeStart(client=False)
+
+ if (not sharedKeyDB) and (not verifierDB) and (not certChain):
+ raise ValueError("Caller passed no authentication credentials")
+ if certChain and not privateKey:
+ raise ValueError("Caller passed a certChain but no privateKey")
+ if privateKey and not certChain:
+ raise ValueError("Caller passed a privateKey but no certChain")
+
+ if not settings:
+ settings = HandshakeSettings()
+ settings = settings._filter()
+
+ #Initialize acceptable cipher suites
+ cipherSuites = []
+ if verifierDB:
+ if certChain:
+ cipherSuites += \
+ CipherSuite.getSrpRsaSuites(settings.cipherNames)
+ cipherSuites += CipherSuite.getSrpSuites(settings.cipherNames)
+ if sharedKeyDB or certChain:
+ cipherSuites += CipherSuite.getRsaSuites(settings.cipherNames)
+
+ #Initialize acceptable certificate type
+ certificateType = None
+ if certChain:
+ try:
+ import cryptoIDlib.CertChain
+ if isinstance(certChain, cryptoIDlib.CertChain.CertChain):
+ certificateType = CertificateType.cryptoID
+ except ImportError:
+ pass
+ if isinstance(certChain, X509CertChain):
+ certificateType = CertificateType.x509
+ if certificateType == None:
+ raise ValueError("Unrecognized certificate type")
+
+ #Initialize locals
+ clientCertChain = None
+ serverCertChain = None #We may set certChain to this later
+ postFinishedError = None
+
+ #Tentatively set version to most-desirable version, so if an error
+ #occurs parsing the ClientHello, this is what we'll use for the
+ #error alert
+ self.version = settings.maxVersion
+
+ #Get ClientHello
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.client_hello):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ clientHello = result
+
+ #If client's version is too low, reject it
+ if clientHello.client_version < settings.minVersion:
+ self.version = settings.minVersion
+ for result in self._sendError(\
+ AlertDescription.protocol_version,
+ "Too old version: %s" % str(clientHello.client_version)):
+ yield result
+
+ #If client's version is too high, propose my highest version
+ elif clientHello.client_version > settings.maxVersion:
+ self.version = settings.maxVersion
+
+ else:
+ #Set the version to the client's version
+ self.version = clientHello.client_version
+
+ #Get the client nonce; create server nonce
+ clientRandom = clientHello.random
+ serverRandom = getRandomBytes(32)
+
+ #Calculate the first cipher suite intersection.
+ #This is the 'privileged' ciphersuite. We'll use it if we're
+ #doing a shared-key resumption or a new negotiation. In fact,
+ #the only time we won't use it is if we're resuming a non-sharedkey
+ #session, in which case we use the ciphersuite from the session.
+ #
+ #Given the current ciphersuite ordering, this means we prefer SRP
+ #over non-SRP.
+ for cipherSuite in cipherSuites:
+ if cipherSuite in clientHello.cipher_suites:
+ break
+ else:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+
+ #If resumption was requested...
+ if clientHello.session_id and (sharedKeyDB or sessionCache):
+ session = None
+
+ #Check in the sharedKeys container
+ if sharedKeyDB and len(clientHello.session_id)==16:
+ try:
+ #Trim off zero padding, if any
+ for x in range(16):
+ if clientHello.session_id[x]==0:
+ break
+ self.allegedSharedKeyUsername = bytesToString(\
+ clientHello.session_id[:x])
+ session = sharedKeyDB[self.allegedSharedKeyUsername]
+ if not session.sharedKey:
+ raise AssertionError()
+ #use privileged ciphersuite
+ session.cipherSuite = cipherSuite
+ except KeyError:
+ pass
+
+ #Then check in the session cache
+ if sessionCache and not session:
+ try:
+ session = sessionCache[bytesToString(\
+ clientHello.session_id)]
+ if session.sharedKey:
+ raise AssertionError()
+ if not session.resumable:
+ raise AssertionError()
+ #Check for consistency with ClientHello
+ if session.cipherSuite not in cipherSuites:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+ if session.cipherSuite not in clientHello.cipher_suites:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+ if clientHello.srp_username:
+ if clientHello.srp_username != session.srpUsername:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+ except KeyError:
+ pass
+
+ #If a session is found..
+ if session:
+ #Set the session
+ self.session = session
+
+ #Send ServerHello
+ serverHello = ServerHello()
+ serverHello.create(self.version, serverRandom,
+ session.sessionID, session.cipherSuite,
+ certificateType)
+ for result in self._sendMsg(serverHello):
+ yield result
+
+ #From here on, the client's messages must have the right version
+ self._versionCheck = True
+
+ #Calculate pending connection states
+ self._calcPendingStates(clientRandom, serverRandom,
+ settings.cipherImplementations)
+
+ #Exchange ChangeCipherSpec and Finished messages
+ for result in self._sendFinished():
+ yield result
+ for result in self._getFinished():
+ yield result
+
+ #Mark the connection as open
+ self._handshakeDone(resumed=True)
+ return
+
+
+ #If not a resumption...
+
+ #TRICKY: we might have chosen an RSA suite that was only deemed
+ #acceptable because of the shared-key resumption. If the shared-
+ #key resumption failed, because the identifier wasn't recognized,
+ #we might fall through to here, where we have an RSA suite
+ #chosen, but no certificate.
+ if cipherSuite in CipherSuite.rsaSuites and not certChain:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+
+ #If an RSA suite is chosen, check for certificate type intersection
+ #(We do this check down here because if the mismatch occurs but the
+ # client is using a shared-key session, it's okay)
+ if cipherSuite in CipherSuite.rsaSuites + \
+ CipherSuite.srpRsaSuites:
+ if certificateType not in clientHello.certificate_types:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure,
+ "the client doesn't support my certificate type"):
+ yield result
+
+ #Move certChain -> serverCertChain, now that we're using it
+ serverCertChain = certChain
+
+
+ #Create sessionID
+ if sessionCache:
+ sessionID = getRandomBytes(32)
+ else:
+ sessionID = createByteArraySequence([])
+
+ #If we've selected an SRP suite, exchange keys and calculate
+ #premaster secret:
+ if cipherSuite in CipherSuite.srpSuites + CipherSuite.srpRsaSuites:
+
+ #If there's no SRP username...
+ if not clientHello.srp_username:
+
+ #Ask the client to re-send ClientHello with one
+ for result in self._sendMsg(Alert().create(\
+ AlertDescription.missing_srp_username,
+ AlertLevel.warning)):
+ yield result
+
+ #Get ClientHello
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.client_hello):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ clientHello = result
+
+ #Check ClientHello
+ #If client's version is too low, reject it (COPIED CODE; BAD!)
+ if clientHello.client_version < settings.minVersion:
+ self.version = settings.minVersion
+ for result in self._sendError(\
+ AlertDescription.protocol_version,
+ "Too old version: %s" % str(clientHello.client_version)):
+ yield result
+
+ #If client's version is too high, propose my highest version
+ elif clientHello.client_version > settings.maxVersion:
+ self.version = settings.maxVersion
+
+ else:
+ #Set the version to the client's version
+ self.version = clientHello.client_version
+
+ #Recalculate the privileged cipher suite, making sure to
+ #pick an SRP suite
+ cipherSuites = [c for c in cipherSuites if c in \
+ CipherSuite.srpSuites + \
+ CipherSuite.srpRsaSuites]
+ for cipherSuite in cipherSuites:
+ if cipherSuite in clientHello.cipher_suites:
+ break
+ else:
+ for result in self._sendError(\
+ AlertDescription.handshake_failure):
+ yield result
+
+ #Get the client nonce; create server nonce
+ clientRandom = clientHello.random
+ serverRandom = getRandomBytes(32)
+
+ #The username better be there, this time
+ if not clientHello.srp_username:
+ for result in self._sendError(\
+ AlertDescription.illegal_parameter,
+ "Client resent a hello, but without the SRP"\
+ " username"):
+ yield result
+
+
+ #Get username
+ self.allegedSrpUsername = clientHello.srp_username
+
+ #Get parameters from username
+ try:
+ entry = verifierDB[self.allegedSrpUsername]
+ except KeyError:
+ for result in self._sendError(\
+ AlertDescription.unknown_srp_username):
+ yield result
+ (N, g, s, v) = entry
+
+ #Calculate server's ephemeral DH values (b, B)
+ b = bytesToNumber(getRandomBytes(32))
+ k = makeK(N, g)
+ B = (powMod(g, b, N) + (k*v)) % N
+
+ #Create ServerKeyExchange, signing it if necessary
+ serverKeyExchange = ServerKeyExchange(cipherSuite)
+ serverKeyExchange.createSRP(N, g, stringToBytes(s), B)
+ if cipherSuite in CipherSuite.srpRsaSuites:
+ hashBytes = serverKeyExchange.hash(clientRandom,
+ serverRandom)
+ serverKeyExchange.signature = privateKey.sign(hashBytes)
+
+ #Send ServerHello[, Certificate], ServerKeyExchange,
+ #ServerHelloDone
+ msgs = []
+ serverHello = ServerHello()
+ serverHello.create(self.version, serverRandom, sessionID,
+ cipherSuite, certificateType)
+ msgs.append(serverHello)
+ if cipherSuite in CipherSuite.srpRsaSuites:
+ certificateMsg = Certificate(certificateType)
+ certificateMsg.create(serverCertChain)
+ msgs.append(certificateMsg)
+ msgs.append(serverKeyExchange)
+ msgs.append(ServerHelloDone())
+ for result in self._sendMsgs(msgs):
+ yield result
+
+ #From here on, the client's messages must have the right version
+ self._versionCheck = True
+
+ #Get and check ClientKeyExchange
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.client_key_exchange,
+ cipherSuite):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ clientKeyExchange = result
+ A = clientKeyExchange.srp_A
+ if A % N == 0:
+ postFinishedError = (AlertDescription.illegal_parameter,
+ "Suspicious A value")
+ #Calculate u
+ u = makeU(N, A, B)
+
+ #Calculate premaster secret
+ S = powMod((A * powMod(v,u,N)) % N, b, N)
+ premasterSecret = numberToBytes(S)
+
+
+ #If we've selected an RSA suite, exchange keys and calculate
+ #premaster secret:
+ elif cipherSuite in CipherSuite.rsaSuites:
+
+ #Send ServerHello, Certificate[, CertificateRequest],
+ #ServerHelloDone
+ msgs = []
+ msgs.append(ServerHello().create(self.version, serverRandom,
+ sessionID, cipherSuite, certificateType))
+ msgs.append(Certificate(certificateType).create(serverCertChain))
+ if reqCert:
+ msgs.append(CertificateRequest())
+ msgs.append(ServerHelloDone())
+ for result in self._sendMsgs(msgs):
+ yield result
+
+ #From here on, the client's messages must have the right version
+ self._versionCheck = True
+
+ #Get [Certificate,] (if was requested)
+ if reqCert:
+ if self.version == (3,0):
+ for result in self._getMsg((ContentType.handshake,
+ ContentType.alert),
+ HandshakeType.certificate,
+ certificateType):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ msg = result
+
+ if isinstance(msg, Alert):
+ #If it's not a no_certificate alert, re-raise
+ alert = msg
+ if alert.description != \
+ AlertDescription.no_certificate:
+ self._shutdown(False)
+ raise TLSRemoteAlert(alert)
+ elif isinstance(msg, Certificate):
+ clientCertificate = msg
+ if clientCertificate.certChain and \
+ clientCertificate.certChain.getNumCerts()!=0:
+ clientCertChain = clientCertificate.certChain
+ else:
+ raise AssertionError()
+ elif self.version in ((3,1), (3,2)):
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.certificate,
+ certificateType):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ clientCertificate = result
+ if clientCertificate.certChain and \
+ clientCertificate.certChain.getNumCerts()!=0:
+ clientCertChain = clientCertificate.certChain
+ else:
+ raise AssertionError()
+
+ #Get ClientKeyExchange
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.client_key_exchange,
+ cipherSuite):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ clientKeyExchange = result
+
+ #Decrypt ClientKeyExchange
+ premasterSecret = privateKey.decrypt(\
+ clientKeyExchange.encryptedPreMasterSecret)
+
+ randomPreMasterSecret = getRandomBytes(48)
+ versionCheck = (premasterSecret[0], premasterSecret[1])
+ if not premasterSecret:
+ premasterSecret = randomPreMasterSecret
+ elif len(premasterSecret)!=48:
+ premasterSecret = randomPreMasterSecret
+ elif versionCheck != clientHello.client_version:
+ if versionCheck != self.version: #Tolerate buggy IE clients
+ premasterSecret = randomPreMasterSecret
+
+ #Get and check CertificateVerify, if relevant
+ if clientCertChain:
+ if self.version == (3,0):
+ #Create a temporary session object, just for the purpose
+ #of checking the CertificateVerify
+ session = Session()
+ session._calcMasterSecret(self.version, premasterSecret,
+ clientRandom, serverRandom)
+ verifyBytes = self._calcSSLHandshakeHash(\
+ session.masterSecret, "")
+ elif self.version in ((3,1), (3,2)):
+ verifyBytes = stringToBytes(self._handshake_md5.digest() +\
+ self._handshake_sha.digest())
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.certificate_verify):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ certificateVerify = result
+ publicKey = clientCertChain.getEndEntityPublicKey()
+ if len(publicKey) < settings.minKeySize:
+ postFinishedError = (AlertDescription.handshake_failure,
+ "Client's public key too small: %d" % len(publicKey))
+ if len(publicKey) > settings.maxKeySize:
+ postFinishedError = (AlertDescription.handshake_failure,
+ "Client's public key too large: %d" % len(publicKey))
+
+ if not publicKey.verify(certificateVerify.signature,
+ verifyBytes):
+ postFinishedError = (AlertDescription.decrypt_error,
+ "Signature failed to verify")
+
+
+ #Create the session object
+ self.session = Session()
+ self.session._calcMasterSecret(self.version, premasterSecret,
+ clientRandom, serverRandom)
+ self.session.sessionID = sessionID
+ self.session.cipherSuite = cipherSuite
+ self.session.srpUsername = self.allegedSrpUsername
+ self.session.clientCertChain = clientCertChain
+ self.session.serverCertChain = serverCertChain
+
+ #Calculate pending connection states
+ self._calcPendingStates(clientRandom, serverRandom,
+ settings.cipherImplementations)
+
+ #Exchange ChangeCipherSpec and Finished messages
+ for result in self._getFinished():
+ yield result
+
+ #If we were holding a post-finished error until receiving the client
+ #finished message, send it now. We delay the call until this point
+ #because calling sendError() throws an exception, and our caller might
+ #shut down the socket upon receiving the exception. If he did, and the
+ #client was still sending its ChangeCipherSpec or Finished messages, it
+ #would cause a socket error on the client side. This is a lot of
+ #consideration to show to misbehaving clients, but this would also
+ #cause problems with fault-testing.
+ if postFinishedError:
+ for result in self._sendError(*postFinishedError):
+ yield result
+
+ for result in self._sendFinished():
+ yield result
+
+ #Add the session object to the session cache
+ if sessionCache and sessionID:
+ sessionCache[bytesToString(sessionID)] = self.session
+
+ #Mark the connection as open
+ self.session._setResumable(True)
+ self._handshakeDone(resumed=False)
+
+
+ def _handshakeWrapperAsync(self, handshaker, checker):
+ if not self.fault:
+ try:
+ for result in handshaker:
+ yield result
+ if checker:
+ try:
+ checker(self)
+ except TLSAuthenticationError:
+ alert = Alert().create(AlertDescription.close_notify,
+ AlertLevel.fatal)
+ for result in self._sendMsg(alert):
+ yield result
+ raise
+ except:
+ self._shutdown(False)
+ raise
+ else:
+ try:
+ for result in handshaker:
+ yield result
+ if checker:
+ try:
+ checker(self)
+ except TLSAuthenticationError:
+ alert = Alert().create(AlertDescription.close_notify,
+ AlertLevel.fatal)
+ for result in self._sendMsg(alert):
+ yield result
+ raise
+ except socket.error, e:
+ raise TLSFaultError("socket error!")
+ except TLSAbruptCloseError, e:
+ raise TLSFaultError("abrupt close error!")
+ except TLSAlert, alert:
+ if alert.description not in Fault.faultAlerts[self.fault]:
+ raise TLSFaultError(str(alert))
+ else:
+ pass
+ except:
+ self._shutdown(False)
+ raise
+ else:
+ raise TLSFaultError("No error!")
+
+
+ def _getKeyFromChain(self, certificate, settings):
+ #Get and check cert chain from the Certificate message
+ certChain = certificate.certChain
+ if not certChain or certChain.getNumCerts() == 0:
+ for result in self._sendError(AlertDescription.illegal_parameter,
+ "Other party sent a Certificate message without "\
+ "certificates"):
+ yield result
+
+ #Get and check public key from the cert chain
+ publicKey = certChain.getEndEntityPublicKey()
+ if len(publicKey) < settings.minKeySize:
+ for result in self._sendError(AlertDescription.handshake_failure,
+ "Other party's public key too small: %d" % len(publicKey)):
+ yield result
+ if len(publicKey) > settings.maxKeySize:
+ for result in self._sendError(AlertDescription.handshake_failure,
+ "Other party's public key too large: %d" % len(publicKey)):
+ yield result
+
+ yield publicKey, certChain
diff --git a/src/gdata/tlslite/TLSRecordLayer.py b/src/gdata/tlslite/TLSRecordLayer.py
new file mode 100755
index 0000000..875ce80
--- /dev/null
+++ b/src/gdata/tlslite/TLSRecordLayer.py
@@ -0,0 +1,1123 @@
+"""Helper class for TLSConnection."""
+from __future__ import generators
+
+from utils.compat import *
+from utils.cryptomath import *
+from utils.cipherfactory import createAES, createRC4, createTripleDES
+from utils.codec import *
+from errors import *
+from messages import *
+from mathtls import *
+from constants import *
+from utils.cryptomath import getRandomBytes
+from utils import hmac
+from FileObject import FileObject
+import sha
+import md5
+import socket
+import errno
+import traceback
+
+class _ConnectionState:
+ def __init__(self):
+ self.macContext = None
+ self.encContext = None
+ self.seqnum = 0
+
+ def getSeqNumStr(self):
+ w = Writer(8)
+ w.add(self.seqnum, 8)
+ seqnumStr = bytesToString(w.bytes)
+ self.seqnum += 1
+ return seqnumStr
+
+
+class TLSRecordLayer:
+ """
+ This class handles data transmission for a TLS connection.
+
+ Its only subclass is L{tlslite.TLSConnection.TLSConnection}. We've
+ separated the code in this class from TLSConnection to make things
+ more readable.
+
+
+ @type sock: socket.socket
+ @ivar sock: The underlying socket object.
+
+ @type session: L{tlslite.Session.Session}
+ @ivar session: The session corresponding to this connection.
+
+ Due to TLS session resumption, multiple connections can correspond
+ to the same underlying session.
+
+ @type version: tuple
+ @ivar version: The TLS version being used for this connection.
+
+ (3,0) means SSL 3.0, and (3,1) means TLS 1.0.
+
+ @type closed: bool
+ @ivar closed: If this connection is closed.
+
+ @type resumed: bool
+ @ivar resumed: If this connection is based on a resumed session.
+
+ @type allegedSharedKeyUsername: str or None
+ @ivar allegedSharedKeyUsername: This is set to the shared-key
+ username asserted by the client, whether the handshake succeeded or
+ not. If the handshake fails, this can be inspected to
+ determine if a guessing attack is in progress against a particular
+ user account.
+
+ @type allegedSrpUsername: str or None
+ @ivar allegedSrpUsername: This is set to the SRP username
+ asserted by the client, whether the handshake succeeded or not.
+ If the handshake fails, this can be inspected to determine
+ if a guessing attack is in progress against a particular user
+ account.
+
+ @type closeSocket: bool
+ @ivar closeSocket: If the socket should be closed when the
+ connection is closed (writable).
+
+ If you set this to True, TLS Lite will assume the responsibility of
+ closing the socket when the TLS Connection is shutdown (either
+ through an error or through the user calling close()). The default
+ is False.
+
+ @type ignoreAbruptClose: bool
+ @ivar ignoreAbruptClose: If an abrupt close of the socket should
+ raise an error (writable).
+
+ If you set this to True, TLS Lite will not raise a
+ L{tlslite.errors.TLSAbruptCloseError} exception if the underlying
+ socket is unexpectedly closed. Such an unexpected closure could be
+ caused by an attacker. However, it also occurs with some incorrect
+ TLS implementations.
+
+ You should set this to True only if you're not worried about an
+ attacker truncating the connection, and only if necessary to avoid
+ spurious errors. The default is False.
+
+ @sort: __init__, read, readAsync, write, writeAsync, close, closeAsync,
+ getCipherImplementation, getCipherName
+ """
+
+ def __init__(self, sock):
+ self.sock = sock
+
+ #My session object (Session instance; read-only)
+ self.session = None
+
+ #Am I a client or server?
+ self._client = None
+
+ #Buffers for processing messages
+ self._handshakeBuffer = []
+ self._readBuffer = ""
+
+ #Handshake digests
+ self._handshake_md5 = md5.md5()
+ self._handshake_sha = sha.sha()
+
+ #TLS Protocol Version
+ self.version = (0,0) #read-only
+ self._versionCheck = False #Once we choose a version, this is True
+
+ #Current and Pending connection states
+ self._writeState = _ConnectionState()
+ self._readState = _ConnectionState()
+ self._pendingWriteState = _ConnectionState()
+ self._pendingReadState = _ConnectionState()
+
+ #Is the connection open?
+ self.closed = True #read-only
+ self._refCount = 0 #Used to trigger closure
+
+ #Is this a resumed (or shared-key) session?
+ self.resumed = False #read-only
+
+ #What username did the client claim in his handshake?
+ self.allegedSharedKeyUsername = None
+ self.allegedSrpUsername = None
+
+ #On a call to close(), do we close the socket? (writeable)
+ self.closeSocket = False
+
+ #If the socket is abruptly closed, do we ignore it
+ #and pretend the connection was shut down properly? (writeable)
+ self.ignoreAbruptClose = False
+
+ #Fault we will induce, for testing purposes
+ self.fault = None
+
+ #*********************************************************
+ # Public Functions START
+ #*********************************************************
+
+ def read(self, max=None, min=1):
+ """Read some data from the TLS connection.
+
+ This function will block until at least 'min' bytes are
+ available (or the connection is closed).
+
+ If an exception is raised, the connection will have been
+ automatically closed.
+
+ @type max: int
+ @param max: The maximum number of bytes to return.
+
+ @type min: int
+ @param min: The minimum number of bytes to return
+
+ @rtype: str
+ @return: A string of no more than 'max' bytes, and no fewer
+ than 'min' (unless the connection has been closed, in which
+ case fewer than 'min' bytes may be returned).
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ """
+ for result in self.readAsync(max, min):
+ pass
+ return result
+
+ def readAsync(self, max=None, min=1):
+ """Start a read operation on the TLS connection.
+
+ This function returns a generator which behaves similarly to
+ read(). Successive invocations of the generator will return 0
+ if it is waiting to read from the socket, 1 if it is waiting
+ to write to the socket, or a string if the read operation has
+ completed.
+
+ @rtype: iterable
+ @return: A generator; see above for details.
+ """
+ try:
+ while len(self._readBuffer)<min and not self.closed:
+ try:
+ for result in self._getMsg(ContentType.application_data):
+ if result in (0,1):
+ yield result
+ applicationData = result
+ self._readBuffer += bytesToString(applicationData.write())
+ except TLSRemoteAlert, alert:
+ if alert.description != AlertDescription.close_notify:
+ raise
+ except TLSAbruptCloseError:
+ if not self.ignoreAbruptClose:
+ raise
+ else:
+ self._shutdown(True)
+
+ if max == None:
+ max = len(self._readBuffer)
+
+ returnStr = self._readBuffer[:max]
+ self._readBuffer = self._readBuffer[max:]
+ yield returnStr
+ except:
+ self._shutdown(False)
+ raise
+
+ def write(self, s):
+ """Write some data to the TLS connection.
+
+ This function will block until all the data has been sent.
+
+ If an exception is raised, the connection will have been
+ automatically closed.
+
+ @type s: str
+ @param s: The data to transmit to the other party.
+
+ @raise socket.error: If a socket error occurs.
+ """
+ for result in self.writeAsync(s):
+ pass
+
+ def writeAsync(self, s):
+ """Start a write operation on the TLS connection.
+
+ This function returns a generator which behaves similarly to
+ write(). Successive invocations of the generator will return
+ 1 if it is waiting to write to the socket, or will raise
+ StopIteration if the write operation has completed.
+
+ @rtype: iterable
+ @return: A generator; see above for details.
+ """
+ try:
+ if self.closed:
+ raise ValueError()
+
+ index = 0
+ blockSize = 16384
+ skipEmptyFrag = False
+ while 1:
+ startIndex = index * blockSize
+ endIndex = startIndex + blockSize
+ if startIndex >= len(s):
+ break
+ if endIndex > len(s):
+ endIndex = len(s)
+ block = stringToBytes(s[startIndex : endIndex])
+ applicationData = ApplicationData().create(block)
+ for result in self._sendMsg(applicationData, skipEmptyFrag):
+ yield result
+ skipEmptyFrag = True #only send an empy fragment on 1st message
+ index += 1
+ except:
+ self._shutdown(False)
+ raise
+
+ def close(self):
+ """Close the TLS connection.
+
+ This function will block until it has exchanged close_notify
+ alerts with the other party. After doing so, it will shut down the
+ TLS connection. Further attempts to read through this connection
+ will return "". Further attempts to write through this connection
+ will raise ValueError.
+
+ If makefile() has been called on this connection, the connection
+ will be not be closed until the connection object and all file
+ objects have been closed.
+
+ Even if an exception is raised, the connection will have been
+ closed.
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ """
+ if not self.closed:
+ for result in self._decrefAsync():
+ pass
+
+ def closeAsync(self):
+ """Start a close operation on the TLS connection.
+
+ This function returns a generator which behaves similarly to
+ close(). Successive invocations of the generator will return 0
+ if it is waiting to read from the socket, 1 if it is waiting
+ to write to the socket, or will raise StopIteration if the
+ close operation has completed.
+
+ @rtype: iterable
+ @return: A generator; see above for details.
+ """
+ if not self.closed:
+ for result in self._decrefAsync():
+ yield result
+
+ def _decrefAsync(self):
+ self._refCount -= 1
+ if self._refCount == 0 and not self.closed:
+ try:
+ for result in self._sendMsg(Alert().create(\
+ AlertDescription.close_notify, AlertLevel.warning)):
+ yield result
+ alert = None
+ while not alert:
+ for result in self._getMsg((ContentType.alert, \
+ ContentType.application_data)):
+ if result in (0,1):
+ yield result
+ if result.contentType == ContentType.alert:
+ alert = result
+ if alert.description == AlertDescription.close_notify:
+ self._shutdown(True)
+ else:
+ raise TLSRemoteAlert(alert)
+ except (socket.error, TLSAbruptCloseError):
+ #If the other side closes the socket, that's okay
+ self._shutdown(True)
+ except:
+ self._shutdown(False)
+ raise
+
+ def getCipherName(self):
+ """Get the name of the cipher used with this connection.
+
+ @rtype: str
+ @return: The name of the cipher used with this connection.
+ Either 'aes128', 'aes256', 'rc4', or '3des'.
+ """
+ if not self._writeState.encContext:
+ return None
+ return self._writeState.encContext.name
+
+ def getCipherImplementation(self):
+ """Get the name of the cipher implementation used with
+ this connection.
+
+ @rtype: str
+ @return: The name of the cipher implementation used with
+ this connection. Either 'python', 'cryptlib', 'openssl',
+ or 'pycrypto'.
+ """
+ if not self._writeState.encContext:
+ return None
+ return self._writeState.encContext.implementation
+
+
+
+ #Emulate a socket, somewhat -
+ def send(self, s):
+ """Send data to the TLS connection (socket emulation).
+
+ @raise socket.error: If a socket error occurs.
+ """
+ self.write(s)
+ return len(s)
+
+ def sendall(self, s):
+ """Send data to the TLS connection (socket emulation).
+
+ @raise socket.error: If a socket error occurs.
+ """
+ self.write(s)
+
+ def recv(self, bufsize):
+ """Get some data from the TLS connection (socket emulation).
+
+ @raise socket.error: If a socket error occurs.
+ @raise tlslite.errors.TLSAbruptCloseError: If the socket is closed
+ without a preceding alert.
+ @raise tlslite.errors.TLSAlert: If a TLS alert is signalled.
+ """
+ return self.read(bufsize)
+
+ def makefile(self, mode='r', bufsize=-1):
+ """Create a file object for the TLS connection (socket emulation).
+
+ @rtype: L{tlslite.FileObject.FileObject}
+ """
+ self._refCount += 1
+ return FileObject(self, mode, bufsize)
+
+ def getsockname(self):
+ """Return the socket's own address (socket emulation)."""
+ return self.sock.getsockname()
+
+ def getpeername(self):
+ """Return the remote address to which the socket is connected
+ (socket emulation)."""
+ return self.sock.getpeername()
+
+ def settimeout(self, value):
+ """Set a timeout on blocking socket operations (socket emulation)."""
+ return self.sock.settimeout(value)
+
+ def gettimeout(self):
+ """Return the timeout associated with socket operations (socket
+ emulation)."""
+ return self.sock.gettimeout()
+
+ def setsockopt(self, level, optname, value):
+ """Set the value of the given socket option (socket emulation)."""
+ return self.sock.setsockopt(level, optname, value)
+
+
+ #*********************************************************
+ # Public Functions END
+ #*********************************************************
+
+ def _shutdown(self, resumable):
+ self._writeState = _ConnectionState()
+ self._readState = _ConnectionState()
+ #Don't do this: self._readBuffer = ""
+ self.version = (0,0)
+ self._versionCheck = False
+ self.closed = True
+ if self.closeSocket:
+ self.sock.close()
+
+ #Even if resumable is False, we'll never toggle this on
+ if not resumable and self.session:
+ self.session.resumable = False
+
+
+ def _sendError(self, alertDescription, errorStr=None):
+ alert = Alert().create(alertDescription, AlertLevel.fatal)
+ for result in self._sendMsg(alert):
+ yield result
+ self._shutdown(False)
+ raise TLSLocalAlert(alert, errorStr)
+
+ def _sendMsgs(self, msgs):
+ skipEmptyFrag = False
+ for msg in msgs:
+ for result in self._sendMsg(msg, skipEmptyFrag):
+ yield result
+ skipEmptyFrag = True
+
+ def _sendMsg(self, msg, skipEmptyFrag=False):
+ bytes = msg.write()
+ contentType = msg.contentType
+
+ #Whenever we're connected and asked to send a message,
+ #we first send an empty Application Data message. This prevents
+ #an attacker from launching a chosen-plaintext attack based on
+ #knowing the next IV.
+ if not self.closed and not skipEmptyFrag and self.version == (3,1):
+ if self._writeState.encContext:
+ if self._writeState.encContext.isBlockCipher:
+ for result in self._sendMsg(ApplicationData(),
+ skipEmptyFrag=True):
+ yield result
+
+ #Update handshake hashes
+ if contentType == ContentType.handshake:
+ bytesStr = bytesToString(bytes)
+ self._handshake_md5.update(bytesStr)
+ self._handshake_sha.update(bytesStr)
+
+ #Calculate MAC
+ if self._writeState.macContext:
+ seqnumStr = self._writeState.getSeqNumStr()
+ bytesStr = bytesToString(bytes)
+ mac = self._writeState.macContext.copy()
+ mac.update(seqnumStr)
+ mac.update(chr(contentType))
+ if self.version == (3,0):
+ mac.update( chr( int(len(bytes)/256) ) )
+ mac.update( chr( int(len(bytes)%256) ) )
+ elif self.version in ((3,1), (3,2)):
+ mac.update(chr(self.version[0]))
+ mac.update(chr(self.version[1]))
+ mac.update( chr( int(len(bytes)/256) ) )
+ mac.update( chr( int(len(bytes)%256) ) )
+ else:
+ raise AssertionError()
+ mac.update(bytesStr)
+ macString = mac.digest()
+ macBytes = stringToBytes(macString)
+ if self.fault == Fault.badMAC:
+ macBytes[0] = (macBytes[0]+1) % 256
+
+ #Encrypt for Block or Stream Cipher
+ if self._writeState.encContext:
+ #Add padding and encrypt (for Block Cipher):
+ if self._writeState.encContext.isBlockCipher:
+
+ #Add TLS 1.1 fixed block
+ if self.version == (3,2):
+ bytes = self.fixedIVBlock + bytes
+
+ #Add padding: bytes = bytes + (macBytes + paddingBytes)
+ currentLength = len(bytes) + len(macBytes) + 1
+ blockLength = self._writeState.encContext.block_size
+ paddingLength = blockLength-(currentLength % blockLength)
+
+ paddingBytes = createByteArraySequence([paddingLength] * \
+ (paddingLength+1))
+ if self.fault == Fault.badPadding:
+ paddingBytes[0] = (paddingBytes[0]+1) % 256
+ endBytes = concatArrays(macBytes, paddingBytes)
+ bytes = concatArrays(bytes, endBytes)
+ #Encrypt
+ plaintext = stringToBytes(bytes)
+ ciphertext = self._writeState.encContext.encrypt(plaintext)
+ bytes = stringToBytes(ciphertext)
+
+ #Encrypt (for Stream Cipher)
+ else:
+ bytes = concatArrays(bytes, macBytes)
+ plaintext = bytesToString(bytes)
+ ciphertext = self._writeState.encContext.encrypt(plaintext)
+ bytes = stringToBytes(ciphertext)
+
+ #Add record header and send
+ r = RecordHeader3().create(self.version, contentType, len(bytes))
+ s = bytesToString(concatArrays(r.write(), bytes))
+ while 1:
+ try:
+ bytesSent = self.sock.send(s) #Might raise socket.error
+ except socket.error, why:
+ if why[0] == errno.EWOULDBLOCK:
+ yield 1
+ continue
+ else:
+ raise
+ if bytesSent == len(s):
+ return
+ s = s[bytesSent:]
+ yield 1
+
+
+ def _getMsg(self, expectedType, secondaryType=None, constructorType=None):
+ try:
+ if not isinstance(expectedType, tuple):
+ expectedType = (expectedType,)
+
+ #Spin in a loop, until we've got a non-empty record of a type we
+ #expect. The loop will be repeated if:
+ # - we receive a renegotiation attempt; we send no_renegotiation,
+ # then try again
+ # - we receive an empty application-data fragment; we try again
+ while 1:
+ for result in self._getNextRecord():
+ if result in (0,1):
+ yield result
+ recordHeader, p = result
+
+ #If this is an empty application-data fragment, try again
+ if recordHeader.type == ContentType.application_data:
+ if p.index == len(p.bytes):
+ continue
+
+ #If we received an unexpected record type...
+ if recordHeader.type not in expectedType:
+
+ #If we received an alert...
+ if recordHeader.type == ContentType.alert:
+ alert = Alert().parse(p)
+
+ #We either received a fatal error, a warning, or a
+ #close_notify. In any case, we're going to close the
+ #connection. In the latter two cases we respond with
+ #a close_notify, but ignore any socket errors, since
+ #the other side might have already closed the socket.
+ if alert.level == AlertLevel.warning or \
+ alert.description == AlertDescription.close_notify:
+
+ #If the sendMsg() call fails because the socket has
+ #already been closed, we will be forgiving and not
+ #report the error nor invalidate the "resumability"
+ #of the session.
+ try:
+ alertMsg = Alert()
+ alertMsg.create(AlertDescription.close_notify,
+ AlertLevel.warning)
+ for result in self._sendMsg(alertMsg):
+ yield result
+ except socket.error:
+ pass
+
+ if alert.description == \
+ AlertDescription.close_notify:
+ self._shutdown(True)
+ elif alert.level == AlertLevel.warning:
+ self._shutdown(False)
+
+ else: #Fatal alert:
+ self._shutdown(False)
+
+ #Raise the alert as an exception
+ raise TLSRemoteAlert(alert)
+
+ #If we received a renegotiation attempt...
+ if recordHeader.type == ContentType.handshake:
+ subType = p.get(1)
+ reneg = False
+ if self._client:
+ if subType == HandshakeType.hello_request:
+ reneg = True
+ else:
+ if subType == HandshakeType.client_hello:
+ reneg = True
+ #Send no_renegotiation, then try again
+ if reneg:
+ alertMsg = Alert()
+ alertMsg.create(AlertDescription.no_renegotiation,
+ AlertLevel.warning)
+ for result in self._sendMsg(alertMsg):
+ yield result
+ continue
+
+ #Otherwise: this is an unexpected record, but neither an
+ #alert nor renegotiation
+ for result in self._sendError(\
+ AlertDescription.unexpected_message,
+ "received type=%d" % recordHeader.type):
+ yield result
+
+ break
+
+ #Parse based on content_type
+ if recordHeader.type == ContentType.change_cipher_spec:
+ yield ChangeCipherSpec().parse(p)
+ elif recordHeader.type == ContentType.alert:
+ yield Alert().parse(p)
+ elif recordHeader.type == ContentType.application_data:
+ yield ApplicationData().parse(p)
+ elif recordHeader.type == ContentType.handshake:
+ #Convert secondaryType to tuple, if it isn't already
+ if not isinstance(secondaryType, tuple):
+ secondaryType = (secondaryType,)
+
+ #If it's a handshake message, check handshake header
+ if recordHeader.ssl2:
+ subType = p.get(1)
+ if subType != HandshakeType.client_hello:
+ for result in self._sendError(\
+ AlertDescription.unexpected_message,
+ "Can only handle SSLv2 ClientHello messages"):
+ yield result
+ if HandshakeType.client_hello not in secondaryType:
+ for result in self._sendError(\
+ AlertDescription.unexpected_message):
+ yield result
+ subType = HandshakeType.client_hello
+ else:
+ subType = p.get(1)
+ if subType not in secondaryType:
+ for result in self._sendError(\
+ AlertDescription.unexpected_message,
+ "Expecting %s, got %s" % (str(secondaryType), subType)):
+ yield result
+
+ #Update handshake hashes
+ sToHash = bytesToString(p.bytes)
+ self._handshake_md5.update(sToHash)
+ self._handshake_sha.update(sToHash)
+
+ #Parse based on handshake type
+ if subType == HandshakeType.client_hello:
+ yield ClientHello(recordHeader.ssl2).parse(p)
+ elif subType == HandshakeType.server_hello:
+ yield ServerHello().parse(p)
+ elif subType == HandshakeType.certificate:
+ yield Certificate(constructorType).parse(p)
+ elif subType == HandshakeType.certificate_request:
+ yield CertificateRequest().parse(p)
+ elif subType == HandshakeType.certificate_verify:
+ yield CertificateVerify().parse(p)
+ elif subType == HandshakeType.server_key_exchange:
+ yield ServerKeyExchange(constructorType).parse(p)
+ elif subType == HandshakeType.server_hello_done:
+ yield ServerHelloDone().parse(p)
+ elif subType == HandshakeType.client_key_exchange:
+ yield ClientKeyExchange(constructorType, \
+ self.version).parse(p)
+ elif subType == HandshakeType.finished:
+ yield Finished(self.version).parse(p)
+ else:
+ raise AssertionError()
+
+ #If an exception was raised by a Parser or Message instance:
+ except SyntaxError, e:
+ for result in self._sendError(AlertDescription.decode_error,
+ formatExceptionTrace(e)):
+ yield result
+
+
+ #Returns next record or next handshake message
+ def _getNextRecord(self):
+
+ #If there's a handshake message waiting, return it
+ if self._handshakeBuffer:
+ recordHeader, bytes = self._handshakeBuffer[0]
+ self._handshakeBuffer = self._handshakeBuffer[1:]
+ yield (recordHeader, Parser(bytes))
+ return
+
+ #Otherwise...
+ #Read the next record header
+ bytes = createByteArraySequence([])
+ recordHeaderLength = 1
+ ssl2 = False
+ while 1:
+ try:
+ s = self.sock.recv(recordHeaderLength-len(bytes))
+ except socket.error, why:
+ if why[0] == errno.EWOULDBLOCK:
+ yield 0
+ continue
+ else:
+ raise
+
+ #If the connection was abruptly closed, raise an error
+ if len(s)==0:
+ raise TLSAbruptCloseError()
+
+ bytes += stringToBytes(s)
+ if len(bytes)==1:
+ if bytes[0] in ContentType.all:
+ ssl2 = False
+ recordHeaderLength = 5
+ elif bytes[0] == 128:
+ ssl2 = True
+ recordHeaderLength = 2
+ else:
+ raise SyntaxError()
+ if len(bytes) == recordHeaderLength:
+ break
+
+ #Parse the record header
+ if ssl2:
+ r = RecordHeader2().parse(Parser(bytes))
+ else:
+ r = RecordHeader3().parse(Parser(bytes))
+
+ #Check the record header fields
+ if r.length > 18432:
+ for result in self._sendError(AlertDescription.record_overflow):
+ yield result
+
+ #Read the record contents
+ bytes = createByteArraySequence([])
+ while 1:
+ try:
+ s = self.sock.recv(r.length - len(bytes))
+ except socket.error, why:
+ if why[0] == errno.EWOULDBLOCK:
+ yield 0
+ continue
+ else:
+ raise
+
+ #If the connection is closed, raise a socket error
+ if len(s)==0:
+ raise TLSAbruptCloseError()
+
+ bytes += stringToBytes(s)
+ if len(bytes) == r.length:
+ break
+
+ #Check the record header fields (2)
+ #We do this after reading the contents from the socket, so that
+ #if there's an error, we at least don't leave extra bytes in the
+ #socket..
+ #
+ # THIS CHECK HAS NO SECURITY RELEVANCE (?), BUT COULD HURT INTEROP.
+ # SO WE LEAVE IT OUT FOR NOW.
+ #
+ #if self._versionCheck and r.version != self.version:
+ # for result in self._sendError(AlertDescription.protocol_version,
+ # "Version in header field: %s, should be %s" % (str(r.version),
+ # str(self.version))):
+ # yield result
+
+ #Decrypt the record
+ for result in self._decryptRecord(r.type, bytes):
+ if result in (0,1):
+ yield result
+ else:
+ break
+ bytes = result
+ p = Parser(bytes)
+
+ #If it doesn't contain handshake messages, we can just return it
+ if r.type != ContentType.handshake:
+ yield (r, p)
+ #If it's an SSLv2 ClientHello, we can return it as well
+ elif r.ssl2:
+ yield (r, p)
+ else:
+ #Otherwise, we loop through and add the handshake messages to the
+ #handshake buffer
+ while 1:
+ if p.index == len(bytes): #If we're at the end
+ if not self._handshakeBuffer:
+ for result in self._sendError(\
+ AlertDescription.decode_error, \
+ "Received empty handshake record"):
+ yield result
+ break
+ #There needs to be at least 4 bytes to get a header
+ if p.index+4 > len(bytes):
+ for result in self._sendError(\
+ AlertDescription.decode_error,
+ "A record has a partial handshake message (1)"):
+ yield result
+ p.get(1) # skip handshake type
+ msgLength = p.get(3)
+ if p.index+msgLength > len(bytes):
+ for result in self._sendError(\
+ AlertDescription.decode_error,
+ "A record has a partial handshake message (2)"):
+ yield result
+
+ handshakePair = (r, bytes[p.index-4 : p.index+msgLength])
+ self._handshakeBuffer.append(handshakePair)
+ p.index += msgLength
+
+ #We've moved at least one handshake message into the
+ #handshakeBuffer, return the first one
+ recordHeader, bytes = self._handshakeBuffer[0]
+ self._handshakeBuffer = self._handshakeBuffer[1:]
+ yield (recordHeader, Parser(bytes))
+
+
+ def _decryptRecord(self, recordType, bytes):
+ if self._readState.encContext:
+
+ #Decrypt if it's a block cipher
+ if self._readState.encContext.isBlockCipher:
+ blockLength = self._readState.encContext.block_size
+ if len(bytes) % blockLength != 0:
+ for result in self._sendError(\
+ AlertDescription.decryption_failed,
+ "Encrypted data not a multiple of blocksize"):
+ yield result
+ ciphertext = bytesToString(bytes)
+ plaintext = self._readState.encContext.decrypt(ciphertext)
+ if self.version == (3,2): #For TLS 1.1, remove explicit IV
+ plaintext = plaintext[self._readState.encContext.block_size : ]
+ bytes = stringToBytes(plaintext)
+
+ #Check padding
+ paddingGood = True
+ paddingLength = bytes[-1]
+ if (paddingLength+1) > len(bytes):
+ paddingGood=False
+ totalPaddingLength = 0
+ else:
+ if self.version == (3,0):
+ totalPaddingLength = paddingLength+1
+ elif self.version in ((3,1), (3,2)):
+ totalPaddingLength = paddingLength+1
+ paddingBytes = bytes[-totalPaddingLength:-1]
+ for byte in paddingBytes:
+ if byte != paddingLength:
+ paddingGood = False
+ totalPaddingLength = 0
+ else:
+ raise AssertionError()
+
+ #Decrypt if it's a stream cipher
+ else:
+ paddingGood = True
+ ciphertext = bytesToString(bytes)
+ plaintext = self._readState.encContext.decrypt(ciphertext)
+ bytes = stringToBytes(plaintext)
+ totalPaddingLength = 0
+
+ #Check MAC
+ macGood = True
+ macLength = self._readState.macContext.digest_size
+ endLength = macLength + totalPaddingLength
+ if endLength > len(bytes):
+ macGood = False
+ else:
+ #Read MAC
+ startIndex = len(bytes) - endLength
+ endIndex = startIndex + macLength
+ checkBytes = bytes[startIndex : endIndex]
+
+ #Calculate MAC
+ seqnumStr = self._readState.getSeqNumStr()
+ bytes = bytes[:-endLength]
+ bytesStr = bytesToString(bytes)
+ mac = self._readState.macContext.copy()
+ mac.update(seqnumStr)
+ mac.update(chr(recordType))
+ if self.version == (3,0):
+ mac.update( chr( int(len(bytes)/256) ) )
+ mac.update( chr( int(len(bytes)%256) ) )
+ elif self.version in ((3,1), (3,2)):
+ mac.update(chr(self.version[0]))
+ mac.update(chr(self.version[1]))
+ mac.update( chr( int(len(bytes)/256) ) )
+ mac.update( chr( int(len(bytes)%256) ) )
+ else:
+ raise AssertionError()
+ mac.update(bytesStr)
+ macString = mac.digest()
+ macBytes = stringToBytes(macString)
+
+ #Compare MACs
+ if macBytes != checkBytes:
+ macGood = False
+
+ if not (paddingGood and macGood):
+ for result in self._sendError(AlertDescription.bad_record_mac,
+ "MAC failure (or padding failure)"):
+ yield result
+
+ yield bytes
+
+ def _handshakeStart(self, client):
+ self._client = client
+ self._handshake_md5 = md5.md5()
+ self._handshake_sha = sha.sha()
+ self._handshakeBuffer = []
+ self.allegedSharedKeyUsername = None
+ self.allegedSrpUsername = None
+ self._refCount = 1
+
+ def _handshakeDone(self, resumed):
+ self.resumed = resumed
+ self.closed = False
+
+ def _calcPendingStates(self, clientRandom, serverRandom, implementations):
+ if self.session.cipherSuite in CipherSuite.aes128Suites:
+ macLength = 20
+ keyLength = 16
+ ivLength = 16
+ createCipherFunc = createAES
+ elif self.session.cipherSuite in CipherSuite.aes256Suites:
+ macLength = 20
+ keyLength = 32
+ ivLength = 16
+ createCipherFunc = createAES
+ elif self.session.cipherSuite in CipherSuite.rc4Suites:
+ macLength = 20
+ keyLength = 16
+ ivLength = 0
+ createCipherFunc = createRC4
+ elif self.session.cipherSuite in CipherSuite.tripleDESSuites:
+ macLength = 20
+ keyLength = 24
+ ivLength = 8
+ createCipherFunc = createTripleDES
+ else:
+ raise AssertionError()
+
+ if self.version == (3,0):
+ createMACFunc = MAC_SSL
+ elif self.version in ((3,1), (3,2)):
+ createMACFunc = hmac.HMAC
+
+ outputLength = (macLength*2) + (keyLength*2) + (ivLength*2)
+
+ #Calculate Keying Material from Master Secret
+ if self.version == (3,0):
+ keyBlock = PRF_SSL(self.session.masterSecret,
+ concatArrays(serverRandom, clientRandom),
+ outputLength)
+ elif self.version in ((3,1), (3,2)):
+ keyBlock = PRF(self.session.masterSecret,
+ "key expansion",
+ concatArrays(serverRandom,clientRandom),
+ outputLength)
+ else:
+ raise AssertionError()
+
+ #Slice up Keying Material
+ clientPendingState = _ConnectionState()
+ serverPendingState = _ConnectionState()
+ p = Parser(keyBlock)
+ clientMACBlock = bytesToString(p.getFixBytes(macLength))
+ serverMACBlock = bytesToString(p.getFixBytes(macLength))
+ clientKeyBlock = bytesToString(p.getFixBytes(keyLength))
+ serverKeyBlock = bytesToString(p.getFixBytes(keyLength))
+ clientIVBlock = bytesToString(p.getFixBytes(ivLength))
+ serverIVBlock = bytesToString(p.getFixBytes(ivLength))
+ clientPendingState.macContext = createMACFunc(clientMACBlock,
+ digestmod=sha)
+ serverPendingState.macContext = createMACFunc(serverMACBlock,
+ digestmod=sha)
+ clientPendingState.encContext = createCipherFunc(clientKeyBlock,
+ clientIVBlock,
+ implementations)
+ serverPendingState.encContext = createCipherFunc(serverKeyBlock,
+ serverIVBlock,
+ implementations)
+
+ #Assign new connection states to pending states
+ if self._client:
+ self._pendingWriteState = clientPendingState
+ self._pendingReadState = serverPendingState
+ else:
+ self._pendingWriteState = serverPendingState
+ self._pendingReadState = clientPendingState
+
+ if self.version == (3,2) and ivLength:
+ #Choose fixedIVBlock for TLS 1.1 (this is encrypted with the CBC
+ #residue to create the IV for each sent block)
+ self.fixedIVBlock = getRandomBytes(ivLength)
+
+ def _changeWriteState(self):
+ self._writeState = self._pendingWriteState
+ self._pendingWriteState = _ConnectionState()
+
+ def _changeReadState(self):
+ self._readState = self._pendingReadState
+ self._pendingReadState = _ConnectionState()
+
+ def _sendFinished(self):
+ #Send ChangeCipherSpec
+ for result in self._sendMsg(ChangeCipherSpec()):
+ yield result
+
+ #Switch to pending write state
+ self._changeWriteState()
+
+ #Calculate verification data
+ verifyData = self._calcFinished(True)
+ if self.fault == Fault.badFinished:
+ verifyData[0] = (verifyData[0]+1)%256
+
+ #Send Finished message under new state
+ finished = Finished(self.version).create(verifyData)
+ for result in self._sendMsg(finished):
+ yield result
+
+ def _getFinished(self):
+ #Get and check ChangeCipherSpec
+ for result in self._getMsg(ContentType.change_cipher_spec):
+ if result in (0,1):
+ yield result
+ changeCipherSpec = result
+
+ if changeCipherSpec.type != 1:
+ for result in self._sendError(AlertDescription.illegal_parameter,
+ "ChangeCipherSpec type incorrect"):
+ yield result
+
+ #Switch to pending read state
+ self._changeReadState()
+
+ #Calculate verification data
+ verifyData = self._calcFinished(False)
+
+ #Get and check Finished message under new state
+ for result in self._getMsg(ContentType.handshake,
+ HandshakeType.finished):
+ if result in (0,1):
+ yield result
+ finished = result
+ if finished.verify_data != verifyData:
+ for result in self._sendError(AlertDescription.decrypt_error,
+ "Finished message is incorrect"):
+ yield result
+
+ def _calcFinished(self, send=True):
+ if self.version == (3,0):
+ if (self._client and send) or (not self._client and not send):
+ senderStr = "\x43\x4C\x4E\x54"
+ else:
+ senderStr = "\x53\x52\x56\x52"
+
+ verifyData = self._calcSSLHandshakeHash(self.session.masterSecret,
+ senderStr)
+ return verifyData
+
+ elif self.version in ((3,1), (3,2)):
+ if (self._client and send) or (not self._client and not send):
+ label = "client finished"
+ else:
+ label = "server finished"
+
+ handshakeHashes = stringToBytes(self._handshake_md5.digest() + \
+ self._handshake_sha.digest())
+ verifyData = PRF(self.session.masterSecret, label, handshakeHashes,
+ 12)
+ return verifyData
+ else:
+ raise AssertionError()
+
+ #Used for Finished messages and CertificateVerify messages in SSL v3
+ def _calcSSLHandshakeHash(self, masterSecret, label):
+ masterSecretStr = bytesToString(masterSecret)
+
+ imac_md5 = self._handshake_md5.copy()
+ imac_sha = self._handshake_sha.copy()
+
+ imac_md5.update(label + masterSecretStr + '\x36'*48)
+ imac_sha.update(label + masterSecretStr + '\x36'*40)
+
+ md5Str = md5.md5(masterSecretStr + ('\x5c'*48) + \
+ imac_md5.digest()).digest()
+ shaStr = sha.sha(masterSecretStr + ('\x5c'*40) + \
+ imac_sha.digest()).digest()
+
+ return stringToBytes(md5Str + shaStr)
+
diff --git a/src/gdata/tlslite/VerifierDB.py b/src/gdata/tlslite/VerifierDB.py
new file mode 100755
index 0000000..f706b17
--- /dev/null
+++ b/src/gdata/tlslite/VerifierDB.py
@@ -0,0 +1,90 @@
+"""Class for storing SRP password verifiers."""
+
+from utils.cryptomath import *
+from utils.compat import *
+import mathtls
+from BaseDB import BaseDB
+
+class VerifierDB(BaseDB):
+ """This class represent an in-memory or on-disk database of SRP
+ password verifiers.
+
+ A VerifierDB can be passed to a server handshake to authenticate
+ a client based on one of the verifiers.
+
+ This class is thread-safe.
+ """
+ def __init__(self, filename=None):
+ """Create a new VerifierDB instance.
+
+ @type filename: str
+ @param filename: Filename for an on-disk database, or None for
+ an in-memory database. If the filename already exists, follow
+ this with a call to open(). To create a new on-disk database,
+ follow this with a call to create().
+ """
+ BaseDB.__init__(self, filename, "verifier")
+
+ def _getItem(self, username, valueStr):
+ (N, g, salt, verifier) = valueStr.split(" ")
+ N = base64ToNumber(N)
+ g = base64ToNumber(g)
+ salt = base64ToString(salt)
+ verifier = base64ToNumber(verifier)
+ return (N, g, salt, verifier)
+
+ def __setitem__(self, username, verifierEntry):
+ """Add a verifier entry to the database.
+
+ @type username: str
+ @param username: The username to associate the verifier with.
+ Must be less than 256 characters in length. Must not already
+ be in the database.
+
+ @type verifierEntry: tuple
+ @param verifierEntry: The verifier entry to add. Use
+ L{tlslite.VerifierDB.VerifierDB.makeVerifier} to create a
+ verifier entry.
+ """
+ BaseDB.__setitem__(self, username, verifierEntry)
+
+
+ def _setItem(self, username, value):
+ if len(username)>=256:
+ raise ValueError("username too long")
+ N, g, salt, verifier = value
+ N = numberToBase64(N)
+ g = numberToBase64(g)
+ salt = stringToBase64(salt)
+ verifier = numberToBase64(verifier)
+ valueStr = " ".join( (N, g, salt, verifier) )
+ return valueStr
+
+ def _checkItem(self, value, username, param):
+ (N, g, salt, verifier) = value
+ x = mathtls.makeX(salt, username, param)
+ v = powMod(g, x, N)
+ return (verifier == v)
+
+
+ def makeVerifier(username, password, bits):
+ """Create a verifier entry which can be stored in a VerifierDB.
+
+ @type username: str
+ @param username: The username for this verifier. Must be less
+ than 256 characters in length.
+
+ @type password: str
+ @param password: The password for this verifier.
+
+ @type bits: int
+ @param bits: This values specifies which SRP group parameters
+ to use. It must be one of (1024, 1536, 2048, 3072, 4096, 6144,
+ 8192). Larger values are more secure but slower. 2048 is a
+ good compromise between safety and speed.
+
+ @rtype: tuple
+ @return: A tuple which may be stored in a VerifierDB.
+ """
+ return mathtls.makeVerifier(username, password, bits)
+ makeVerifier = staticmethod(makeVerifier)
\ No newline at end of file
diff --git a/src/gdata/tlslite/X509.py b/src/gdata/tlslite/X509.py
new file mode 100755
index 0000000..a47ddcf
--- /dev/null
+++ b/src/gdata/tlslite/X509.py
@@ -0,0 +1,133 @@
+"""Class representing an X.509 certificate."""
+
+from utils.ASN1Parser import ASN1Parser
+from utils.cryptomath import *
+from utils.keyfactory import _createPublicRSAKey
+
+
+class X509:
+ """This class represents an X.509 certificate.
+
+ @type bytes: L{array.array} of unsigned bytes
+ @ivar bytes: The DER-encoded ASN.1 certificate
+
+ @type publicKey: L{tlslite.utils.RSAKey.RSAKey}
+ @ivar publicKey: The subject public key from the certificate.
+ """
+
+ def __init__(self):
+ self.bytes = createByteArraySequence([])
+ self.publicKey = None
+
+ def parse(self, s):
+ """Parse a PEM-encoded X.509 certificate.
+
+ @type s: str
+ @param s: A PEM-encoded X.509 certificate (i.e. a base64-encoded
+ certificate wrapped with "-----BEGIN CERTIFICATE-----" and
+ "-----END CERTIFICATE-----" tags).
+ """
+
+ start = s.find("-----BEGIN CERTIFICATE-----")
+ end = s.find("-----END CERTIFICATE-----")
+ if start == -1:
+ raise SyntaxError("Missing PEM prefix")
+ if end == -1:
+ raise SyntaxError("Missing PEM postfix")
+ s = s[start+len("-----BEGIN CERTIFICATE-----") : end]
+
+ bytes = base64ToBytes(s)
+ self.parseBinary(bytes)
+ return self
+
+ def parseBinary(self, bytes):
+ """Parse a DER-encoded X.509 certificate.
+
+ @type bytes: str or L{array.array} of unsigned bytes
+ @param bytes: A DER-encoded X.509 certificate.
+ """
+
+ if isinstance(bytes, type("")):
+ bytes = stringToBytes(bytes)
+
+ self.bytes = bytes
+ p = ASN1Parser(bytes)
+
+ #Get the tbsCertificate
+ tbsCertificateP = p.getChild(0)
+
+ #Is the optional version field present?
+ #This determines which index the key is at.
+ if tbsCertificateP.value[0]==0xA0:
+ subjectPublicKeyInfoIndex = 6
+ else:
+ subjectPublicKeyInfoIndex = 5
+
+ #Get the subjectPublicKeyInfo
+ subjectPublicKeyInfoP = tbsCertificateP.getChild(\
+ subjectPublicKeyInfoIndex)
+
+ #Get the algorithm
+ algorithmP = subjectPublicKeyInfoP.getChild(0)
+ rsaOID = algorithmP.value
+ if list(rsaOID) != [6, 9, 42, 134, 72, 134, 247, 13, 1, 1, 1, 5, 0]:
+ raise SyntaxError("Unrecognized AlgorithmIdentifier")
+
+ #Get the subjectPublicKey
+ subjectPublicKeyP = subjectPublicKeyInfoP.getChild(1)
+
+ #Adjust for BIT STRING encapsulation
+ if (subjectPublicKeyP.value[0] !=0):
+ raise SyntaxError()
+ subjectPublicKeyP = ASN1Parser(subjectPublicKeyP.value[1:])
+
+ #Get the modulus and exponent
+ modulusP = subjectPublicKeyP.getChild(0)
+ publicExponentP = subjectPublicKeyP.getChild(1)
+
+ #Decode them into numbers
+ n = bytesToNumber(modulusP.value)
+ e = bytesToNumber(publicExponentP.value)
+
+ #Create a public key instance
+ self.publicKey = _createPublicRSAKey(n, e)
+
+ def getFingerprint(self):
+ """Get the hex-encoded fingerprint of this certificate.
+
+ @rtype: str
+ @return: A hex-encoded fingerprint.
+ """
+ return sha.sha(self.bytes).hexdigest()
+
+ def getCommonName(self):
+ """Get the Subject's Common Name from the certificate.
+
+ The cryptlib_py module must be installed in order to use this
+ function.
+
+ @rtype: str or None
+ @return: The CN component of the certificate's subject DN, if
+ present.
+ """
+ import cryptlib_py
+ import array
+ c = cryptlib_py.cryptImportCert(self.bytes, cryptlib_py.CRYPT_UNUSED)
+ name = cryptlib_py.CRYPT_CERTINFO_COMMONNAME
+ try:
+ try:
+ length = cryptlib_py.cryptGetAttributeString(c, name, None)
+ returnVal = array.array('B', [0] * length)
+ cryptlib_py.cryptGetAttributeString(c, name, returnVal)
+ returnVal = returnVal.tostring()
+ except cryptlib_py.CryptException, e:
+ if e[0] == cryptlib_py.CRYPT_ERROR_NOTFOUND:
+ returnVal = None
+ return returnVal
+ finally:
+ cryptlib_py.cryptDestroyCert(c)
+
+ def writeBytes(self):
+ return self.bytes
+
+
diff --git a/src/gdata/tlslite/X509CertChain.py b/src/gdata/tlslite/X509CertChain.py
new file mode 100755
index 0000000..d5f0b4d
--- /dev/null
+++ b/src/gdata/tlslite/X509CertChain.py
@@ -0,0 +1,181 @@
+"""Class representing an X.509 certificate chain."""
+
+from utils import cryptomath
+
+class X509CertChain:
+ """This class represents a chain of X.509 certificates.
+
+ @type x509List: list
+ @ivar x509List: A list of L{tlslite.X509.X509} instances,
+ starting with the end-entity certificate and with every
+ subsequent certificate certifying the previous.
+ """
+
+ def __init__(self, x509List=None):
+ """Create a new X509CertChain.
+
+ @type x509List: list
+ @param x509List: A list of L{tlslite.X509.X509} instances,
+ starting with the end-entity certificate and with every
+ subsequent certificate certifying the previous.
+ """
+ if x509List:
+ self.x509List = x509List
+ else:
+ self.x509List = []
+
+ def getNumCerts(self):
+ """Get the number of certificates in this chain.
+
+ @rtype: int
+ """
+ return len(self.x509List)
+
+ def getEndEntityPublicKey(self):
+ """Get the public key from the end-entity certificate.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ """
+ if self.getNumCerts() == 0:
+ raise AssertionError()
+ return self.x509List[0].publicKey
+
+ def getFingerprint(self):
+ """Get the hex-encoded fingerprint of the end-entity certificate.
+
+ @rtype: str
+ @return: A hex-encoded fingerprint.
+ """
+ if self.getNumCerts() == 0:
+ raise AssertionError()
+ return self.x509List[0].getFingerprint()
+
+ def getCommonName(self):
+ """Get the Subject's Common Name from the end-entity certificate.
+
+ The cryptlib_py module must be installed in order to use this
+ function.
+
+ @rtype: str or None
+ @return: The CN component of the certificate's subject DN, if
+ present.
+ """
+ if self.getNumCerts() == 0:
+ raise AssertionError()
+ return self.x509List[0].getCommonName()
+
+ def validate(self, x509TrustList):
+ """Check the validity of the certificate chain.
+
+ This checks that every certificate in the chain validates with
+ the subsequent one, until some certificate validates with (or
+ is identical to) one of the passed-in root certificates.
+
+ The cryptlib_py module must be installed in order to use this
+ function.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ certificate chain must extend to one of these certificates to
+ be considered valid.
+ """
+
+ import cryptlib_py
+ c1 = None
+ c2 = None
+ lastC = None
+ rootC = None
+
+ try:
+ rootFingerprints = [c.getFingerprint() for c in x509TrustList]
+
+ #Check that every certificate in the chain validates with the
+ #next one
+ for cert1, cert2 in zip(self.x509List, self.x509List[1:]):
+
+ #If we come upon a root certificate, we're done.
+ if cert1.getFingerprint() in rootFingerprints:
+ return True
+
+ c1 = cryptlib_py.cryptImportCert(cert1.writeBytes(),
+ cryptlib_py.CRYPT_UNUSED)
+ c2 = cryptlib_py.cryptImportCert(cert2.writeBytes(),
+ cryptlib_py.CRYPT_UNUSED)
+ try:
+ cryptlib_py.cryptCheckCert(c1, c2)
+ except:
+ return False
+ cryptlib_py.cryptDestroyCert(c1)
+ c1 = None
+ cryptlib_py.cryptDestroyCert(c2)
+ c2 = None
+
+ #If the last certificate is one of the root certificates, we're
+ #done.
+ if self.x509List[-1].getFingerprint() in rootFingerprints:
+ return True
+
+ #Otherwise, find a root certificate that the last certificate
+ #chains to, and validate them.
+ lastC = cryptlib_py.cryptImportCert(self.x509List[-1].writeBytes(),
+ cryptlib_py.CRYPT_UNUSED)
+ for rootCert in x509TrustList:
+ rootC = cryptlib_py.cryptImportCert(rootCert.writeBytes(),
+ cryptlib_py.CRYPT_UNUSED)
+ if self._checkChaining(lastC, rootC):
+ try:
+ cryptlib_py.cryptCheckCert(lastC, rootC)
+ return True
+ except:
+ return False
+ return False
+ finally:
+ if not (c1 is None):
+ cryptlib_py.cryptDestroyCert(c1)
+ if not (c2 is None):
+ cryptlib_py.cryptDestroyCert(c2)
+ if not (lastC is None):
+ cryptlib_py.cryptDestroyCert(lastC)
+ if not (rootC is None):
+ cryptlib_py.cryptDestroyCert(rootC)
+
+
+
+ def _checkChaining(self, lastC, rootC):
+ import cryptlib_py
+ import array
+ def compareNames(name):
+ try:
+ length = cryptlib_py.cryptGetAttributeString(lastC, name, None)
+ lastName = array.array('B', [0] * length)
+ cryptlib_py.cryptGetAttributeString(lastC, name, lastName)
+ lastName = lastName.tostring()
+ except cryptlib_py.CryptException, e:
+ if e[0] == cryptlib_py.CRYPT_ERROR_NOTFOUND:
+ lastName = None
+ try:
+ length = cryptlib_py.cryptGetAttributeString(rootC, name, None)
+ rootName = array.array('B', [0] * length)
+ cryptlib_py.cryptGetAttributeString(rootC, name, rootName)
+ rootName = rootName.tostring()
+ except cryptlib_py.CryptException, e:
+ if e[0] == cryptlib_py.CRYPT_ERROR_NOTFOUND:
+ rootName = None
+
+ return lastName == rootName
+
+ cryptlib_py.cryptSetAttribute(lastC,
+ cryptlib_py.CRYPT_CERTINFO_ISSUERNAME,
+ cryptlib_py.CRYPT_UNUSED)
+
+ if not compareNames(cryptlib_py.CRYPT_CERTINFO_COUNTRYNAME):
+ return False
+ if not compareNames(cryptlib_py.CRYPT_CERTINFO_LOCALITYNAME):
+ return False
+ if not compareNames(cryptlib_py.CRYPT_CERTINFO_ORGANIZATIONNAME):
+ return False
+ if not compareNames(cryptlib_py.CRYPT_CERTINFO_ORGANIZATIONALUNITNAME):
+ return False
+ if not compareNames(cryptlib_py.CRYPT_CERTINFO_COMMONNAME):
+ return False
+ return True
\ No newline at end of file
diff --git a/src/gdata/tlslite/__init__.py b/src/gdata/tlslite/__init__.py
new file mode 100755
index 0000000..47cfd1c
--- /dev/null
+++ b/src/gdata/tlslite/__init__.py
@@ -0,0 +1,39 @@
+"""
+TLS Lite is a free python library that implements SSL v3, TLS v1, and
+TLS v1.1. TLS Lite supports non-traditional authentication methods
+such as SRP, shared keys, and cryptoIDs, in addition to X.509
+certificates. TLS Lite is pure python, however it can access OpenSSL,
+cryptlib, pycrypto, and GMPY for faster crypto operations. TLS Lite
+integrates with httplib, xmlrpclib, poplib, imaplib, smtplib,
+SocketServer, asyncore, and Twisted.
+
+To use, do::
+
+ from tlslite.api import *
+
+Then use the L{tlslite.TLSConnection.TLSConnection} class with a socket,
+or use one of the integration classes in L{tlslite.integration}.
+
+@version: 0.3.8
+"""
+__version__ = "0.3.8"
+
+__all__ = ["api",
+ "BaseDB",
+ "Checker",
+ "constants",
+ "errors",
+ "FileObject",
+ "HandshakeSettings",
+ "mathtls",
+ "messages",
+ "Session",
+ "SessionCache",
+ "SharedKeyDB",
+ "TLSConnection",
+ "TLSRecordLayer",
+ "VerifierDB",
+ "X509",
+ "X509CertChain",
+ "integration",
+ "utils"]
diff --git a/src/gdata/tlslite/api.py b/src/gdata/tlslite/api.py
new file mode 100755
index 0000000..eebfbc6
--- /dev/null
+++ b/src/gdata/tlslite/api.py
@@ -0,0 +1,75 @@
+"""Import this module for easy access to TLS Lite objects.
+
+The TLS Lite API consists of classes, functions, and variables spread
+throughout this package. Instead of importing them individually with::
+
+ from tlslite.TLSConnection import TLSConnection
+ from tlslite.HandshakeSettings import HandshakeSettings
+ from tlslite.errors import *
+ .
+ .
+
+It's easier to do::
+
+ from tlslite.api import *
+
+This imports all the important objects (TLSConnection, Checker,
+HandshakeSettings, etc.) into the global namespace. In particular, it
+imports::
+
+ from constants import AlertLevel, AlertDescription, Fault
+ from errors import *
+ from Checker import Checker
+ from HandshakeSettings import HandshakeSettings
+ from Session import Session
+ from SessionCache import SessionCache
+ from SharedKeyDB import SharedKeyDB
+ from TLSConnection import TLSConnection
+ from VerifierDB import VerifierDB
+ from X509 import X509
+ from X509CertChain import X509CertChain
+
+ from integration.HTTPTLSConnection import HTTPTLSConnection
+ from integration.POP3_TLS import POP3_TLS
+ from integration.IMAP4_TLS import IMAP4_TLS
+ from integration.SMTP_TLS import SMTP_TLS
+ from integration.XMLRPCTransport import XMLRPCTransport
+ from integration.TLSSocketServerMixIn import TLSSocketServerMixIn
+ from integration.TLSAsyncDispatcherMixIn import TLSAsyncDispatcherMixIn
+ from integration.TLSTwistedProtocolWrapper import TLSTwistedProtocolWrapper
+ from utils.cryptomath import cryptlibpyLoaded, m2cryptoLoaded,
+ gmpyLoaded, pycryptoLoaded, prngName
+ from utils.keyfactory import generateRSAKey, parsePEMKey, parseXMLKey,
+ parseAsPublicKey, parsePrivateKey
+"""
+
+from constants import AlertLevel, AlertDescription, Fault
+from errors import *
+from Checker import Checker
+from HandshakeSettings import HandshakeSettings
+from Session import Session
+from SessionCache import SessionCache
+from SharedKeyDB import SharedKeyDB
+from TLSConnection import TLSConnection
+from VerifierDB import VerifierDB
+from X509 import X509
+from X509CertChain import X509CertChain
+
+from integration.HTTPTLSConnection import HTTPTLSConnection
+from integration.TLSSocketServerMixIn import TLSSocketServerMixIn
+from integration.TLSAsyncDispatcherMixIn import TLSAsyncDispatcherMixIn
+from integration.POP3_TLS import POP3_TLS
+from integration.IMAP4_TLS import IMAP4_TLS
+from integration.SMTP_TLS import SMTP_TLS
+from integration.XMLRPCTransport import XMLRPCTransport
+try:
+ import twisted
+ del(twisted)
+ from integration.TLSTwistedProtocolWrapper import TLSTwistedProtocolWrapper
+except ImportError:
+ pass
+
+from utils.cryptomath import cryptlibpyLoaded, m2cryptoLoaded, gmpyLoaded, \
+ pycryptoLoaded, prngName
+from utils.keyfactory import generateRSAKey, parsePEMKey, parseXMLKey, \
+ parseAsPublicKey, parsePrivateKey
diff --git a/src/gdata/tlslite/constants.py b/src/gdata/tlslite/constants.py
new file mode 100755
index 0000000..8f2d559
--- /dev/null
+++ b/src/gdata/tlslite/constants.py
@@ -0,0 +1,225 @@
+"""Constants used in various places."""
+
+class CertificateType:
+ x509 = 0
+ openpgp = 1
+ cryptoID = 2
+
+class HandshakeType:
+ hello_request = 0
+ client_hello = 1
+ server_hello = 2
+ certificate = 11
+ server_key_exchange = 12
+ certificate_request = 13
+ server_hello_done = 14
+ certificate_verify = 15
+ client_key_exchange = 16
+ finished = 20
+
+class ContentType:
+ change_cipher_spec = 20
+ alert = 21
+ handshake = 22
+ application_data = 23
+ all = (20,21,22,23)
+
+class AlertLevel:
+ warning = 1
+ fatal = 2
+
+class AlertDescription:
+ """
+ @cvar bad_record_mac: A TLS record failed to decrypt properly.
+
+ If this occurs during a shared-key or SRP handshake it most likely
+ indicates a bad password. It may also indicate an implementation
+ error, or some tampering with the data in transit.
+
+ This alert will be signalled by the server if the SRP password is bad. It
+ may also be signalled by the server if the SRP username is unknown to the
+ server, but it doesn't wish to reveal that fact.
+
+ This alert will be signalled by the client if the shared-key username is
+ bad.
+
+ @cvar handshake_failure: A problem occurred while handshaking.
+
+ This typically indicates a lack of common ciphersuites between client and
+ server, or some other disagreement (about SRP parameters or key sizes,
+ for example).
+
+ @cvar protocol_version: The other party's SSL/TLS version was unacceptable.
+
+ This indicates that the client and server couldn't agree on which version
+ of SSL or TLS to use.
+
+ @cvar user_canceled: The handshake is being cancelled for some reason.
+
+ """
+
+ close_notify = 0
+ unexpected_message = 10
+ bad_record_mac = 20
+ decryption_failed = 21
+ record_overflow = 22
+ decompression_failure = 30
+ handshake_failure = 40
+ no_certificate = 41 #SSLv3
+ bad_certificate = 42
+ unsupported_certificate = 43
+ certificate_revoked = 44
+ certificate_expired = 45
+ certificate_unknown = 46
+ illegal_parameter = 47
+ unknown_ca = 48
+ access_denied = 49
+ decode_error = 50
+ decrypt_error = 51
+ export_restriction = 60
+ protocol_version = 70
+ insufficient_security = 71
+ internal_error = 80
+ user_canceled = 90
+ no_renegotiation = 100
+ unknown_srp_username = 120
+ missing_srp_username = 121
+ untrusted_srp_parameters = 122
+
+class CipherSuite:
+ TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA = 0x0050
+ TLS_SRP_SHA_WITH_AES_128_CBC_SHA = 0x0053
+ TLS_SRP_SHA_WITH_AES_256_CBC_SHA = 0x0056
+
+ TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA = 0x0051
+ TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA = 0x0054
+ TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA = 0x0057
+
+ TLS_RSA_WITH_3DES_EDE_CBC_SHA = 0x000A
+ TLS_RSA_WITH_AES_128_CBC_SHA = 0x002F
+ TLS_RSA_WITH_AES_256_CBC_SHA = 0x0035
+ TLS_RSA_WITH_RC4_128_SHA = 0x0005
+
+ srpSuites = []
+ srpSuites.append(TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA)
+ srpSuites.append(TLS_SRP_SHA_WITH_AES_128_CBC_SHA)
+ srpSuites.append(TLS_SRP_SHA_WITH_AES_256_CBC_SHA)
+ def getSrpSuites(ciphers):
+ suites = []
+ for cipher in ciphers:
+ if cipher == "aes128":
+ suites.append(CipherSuite.TLS_SRP_SHA_WITH_AES_128_CBC_SHA)
+ elif cipher == "aes256":
+ suites.append(CipherSuite.TLS_SRP_SHA_WITH_AES_256_CBC_SHA)
+ elif cipher == "3des":
+ suites.append(CipherSuite.TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA)
+ return suites
+ getSrpSuites = staticmethod(getSrpSuites)
+
+ srpRsaSuites = []
+ srpRsaSuites.append(TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA)
+ srpRsaSuites.append(TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA)
+ srpRsaSuites.append(TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA)
+ def getSrpRsaSuites(ciphers):
+ suites = []
+ for cipher in ciphers:
+ if cipher == "aes128":
+ suites.append(CipherSuite.TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA)
+ elif cipher == "aes256":
+ suites.append(CipherSuite.TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA)
+ elif cipher == "3des":
+ suites.append(CipherSuite.TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA)
+ return suites
+ getSrpRsaSuites = staticmethod(getSrpRsaSuites)
+
+ rsaSuites = []
+ rsaSuites.append(TLS_RSA_WITH_3DES_EDE_CBC_SHA)
+ rsaSuites.append(TLS_RSA_WITH_AES_128_CBC_SHA)
+ rsaSuites.append(TLS_RSA_WITH_AES_256_CBC_SHA)
+ rsaSuites.append(TLS_RSA_WITH_RC4_128_SHA)
+ def getRsaSuites(ciphers):
+ suites = []
+ for cipher in ciphers:
+ if cipher == "aes128":
+ suites.append(CipherSuite.TLS_RSA_WITH_AES_128_CBC_SHA)
+ elif cipher == "aes256":
+ suites.append(CipherSuite.TLS_RSA_WITH_AES_256_CBC_SHA)
+ elif cipher == "rc4":
+ suites.append(CipherSuite.TLS_RSA_WITH_RC4_128_SHA)
+ elif cipher == "3des":
+ suites.append(CipherSuite.TLS_RSA_WITH_3DES_EDE_CBC_SHA)
+ return suites
+ getRsaSuites = staticmethod(getRsaSuites)
+
+ tripleDESSuites = []
+ tripleDESSuites.append(TLS_SRP_SHA_WITH_3DES_EDE_CBC_SHA)
+ tripleDESSuites.append(TLS_SRP_SHA_RSA_WITH_3DES_EDE_CBC_SHA)
+ tripleDESSuites.append(TLS_RSA_WITH_3DES_EDE_CBC_SHA)
+
+ aes128Suites = []
+ aes128Suites.append(TLS_SRP_SHA_WITH_AES_128_CBC_SHA)
+ aes128Suites.append(TLS_SRP_SHA_RSA_WITH_AES_128_CBC_SHA)
+ aes128Suites.append(TLS_RSA_WITH_AES_128_CBC_SHA)
+
+ aes256Suites = []
+ aes256Suites.append(TLS_SRP_SHA_WITH_AES_256_CBC_SHA)
+ aes256Suites.append(TLS_SRP_SHA_RSA_WITH_AES_256_CBC_SHA)
+ aes256Suites.append(TLS_RSA_WITH_AES_256_CBC_SHA)
+
+ rc4Suites = []
+ rc4Suites.append(TLS_RSA_WITH_RC4_128_SHA)
+
+
+class Fault:
+ badUsername = 101
+ badPassword = 102
+ badA = 103
+ clientSrpFaults = range(101,104)
+
+ badVerifyMessage = 601
+ clientCertFaults = range(601,602)
+
+ badPremasterPadding = 501
+ shortPremasterSecret = 502
+ clientNoAuthFaults = range(501,503)
+
+ badIdentifier = 401
+ badSharedKey = 402
+ clientSharedKeyFaults = range(401,403)
+
+ badB = 201
+ serverFaults = range(201,202)
+
+ badFinished = 300
+ badMAC = 301
+ badPadding = 302
+ genericFaults = range(300,303)
+
+ faultAlerts = {\
+ badUsername: (AlertDescription.unknown_srp_username, \
+ AlertDescription.bad_record_mac),\
+ badPassword: (AlertDescription.bad_record_mac,),\
+ badA: (AlertDescription.illegal_parameter,),\
+ badIdentifier: (AlertDescription.handshake_failure,),\
+ badSharedKey: (AlertDescription.bad_record_mac,),\
+ badPremasterPadding: (AlertDescription.bad_record_mac,),\
+ shortPremasterSecret: (AlertDescription.bad_record_mac,),\
+ badVerifyMessage: (AlertDescription.decrypt_error,),\
+ badFinished: (AlertDescription.decrypt_error,),\
+ badMAC: (AlertDescription.bad_record_mac,),\
+ badPadding: (AlertDescription.bad_record_mac,)
+ }
+
+ faultNames = {\
+ badUsername: "bad username",\
+ badPassword: "bad password",\
+ badA: "bad A",\
+ badIdentifier: "bad identifier",\
+ badSharedKey: "bad sharedkey",\
+ badPremasterPadding: "bad premaster padding",\
+ shortPremasterSecret: "short premaster secret",\
+ badVerifyMessage: "bad verify message",\
+ badFinished: "bad finished message",\
+ badMAC: "bad MAC",\
+ badPadding: "bad padding"
+ }
diff --git a/src/gdata/tlslite/errors.py b/src/gdata/tlslite/errors.py
new file mode 100755
index 0000000..c7f7ba8
--- /dev/null
+++ b/src/gdata/tlslite/errors.py
@@ -0,0 +1,149 @@
+"""Exception classes.
+@sort: TLSError, TLSAbruptCloseError, TLSAlert, TLSLocalAlert, TLSRemoteAlert,
+TLSAuthenticationError, TLSNoAuthenticationError, TLSAuthenticationTypeError,
+TLSFingerprintError, TLSAuthorizationError, TLSValidationError, TLSFaultError
+"""
+
+from constants import AlertDescription, AlertLevel
+
+class TLSError(Exception):
+ """Base class for all TLS Lite exceptions."""
+ pass
+
+class TLSAbruptCloseError(TLSError):
+ """The socket was closed without a proper TLS shutdown.
+
+ The TLS specification mandates that an alert of some sort
+ must be sent before the underlying socket is closed. If the socket
+ is closed without this, it could signify that an attacker is trying
+ to truncate the connection. It could also signify a misbehaving
+ TLS implementation, or a random network failure.
+ """
+ pass
+
+class TLSAlert(TLSError):
+ """A TLS alert has been signalled."""
+ pass
+
+ _descriptionStr = {\
+ AlertDescription.close_notify: "close_notify",\
+ AlertDescription.unexpected_message: "unexpected_message",\
+ AlertDescription.bad_record_mac: "bad_record_mac",\
+ AlertDescription.decryption_failed: "decryption_failed",\
+ AlertDescription.record_overflow: "record_overflow",\
+ AlertDescription.decompression_failure: "decompression_failure",\
+ AlertDescription.handshake_failure: "handshake_failure",\
+ AlertDescription.no_certificate: "no certificate",\
+ AlertDescription.bad_certificate: "bad_certificate",\
+ AlertDescription.unsupported_certificate: "unsupported_certificate",\
+ AlertDescription.certificate_revoked: "certificate_revoked",\
+ AlertDescription.certificate_expired: "certificate_expired",\
+ AlertDescription.certificate_unknown: "certificate_unknown",\
+ AlertDescription.illegal_parameter: "illegal_parameter",\
+ AlertDescription.unknown_ca: "unknown_ca",\
+ AlertDescription.access_denied: "access_denied",\
+ AlertDescription.decode_error: "decode_error",\
+ AlertDescription.decrypt_error: "decrypt_error",\
+ AlertDescription.export_restriction: "export_restriction",\
+ AlertDescription.protocol_version: "protocol_version",\
+ AlertDescription.insufficient_security: "insufficient_security",\
+ AlertDescription.internal_error: "internal_error",\
+ AlertDescription.user_canceled: "user_canceled",\
+ AlertDescription.no_renegotiation: "no_renegotiation",\
+ AlertDescription.unknown_srp_username: "unknown_srp_username",\
+ AlertDescription.missing_srp_username: "missing_srp_username"}
+
+class TLSLocalAlert(TLSAlert):
+ """A TLS alert has been signalled by the local implementation.
+
+ @type description: int
+ @ivar description: Set to one of the constants in
+ L{tlslite.constants.AlertDescription}
+
+ @type level: int
+ @ivar level: Set to one of the constants in
+ L{tlslite.constants.AlertLevel}
+
+ @type message: str
+ @ivar message: Description of what went wrong.
+ """
+ def __init__(self, alert, message=None):
+ self.description = alert.description
+ self.level = alert.level
+ self.message = message
+
+ def __str__(self):
+ alertStr = TLSAlert._descriptionStr.get(self.description)
+ if alertStr == None:
+ alertStr = str(self.description)
+ if self.message:
+ return alertStr + ": " + self.message
+ else:
+ return alertStr
+
+class TLSRemoteAlert(TLSAlert):
+ """A TLS alert has been signalled by the remote implementation.
+
+ @type description: int
+ @ivar description: Set to one of the constants in
+ L{tlslite.constants.AlertDescription}
+
+ @type level: int
+ @ivar level: Set to one of the constants in
+ L{tlslite.constants.AlertLevel}
+ """
+ def __init__(self, alert):
+ self.description = alert.description
+ self.level = alert.level
+
+ def __str__(self):
+ alertStr = TLSAlert._descriptionStr.get(self.description)
+ if alertStr == None:
+ alertStr = str(self.description)
+ return alertStr
+
+class TLSAuthenticationError(TLSError):
+ """The handshake succeeded, but the other party's authentication
+ was inadequate.
+
+ This exception will only be raised when a
+ L{tlslite.Checker.Checker} has been passed to a handshake function.
+ The Checker will be invoked once the handshake completes, and if
+ the Checker objects to how the other party authenticated, a
+ subclass of this exception will be raised.
+ """
+ pass
+
+class TLSNoAuthenticationError(TLSAuthenticationError):
+ """The Checker was expecting the other party to authenticate with a
+ certificate chain, but this did not occur."""
+ pass
+
+class TLSAuthenticationTypeError(TLSAuthenticationError):
+ """The Checker was expecting the other party to authenticate with a
+ different type of certificate chain."""
+ pass
+
+class TLSFingerprintError(TLSAuthenticationError):
+ """The Checker was expecting the other party to authenticate with a
+ certificate chain that matches a different fingerprint."""
+ pass
+
+class TLSAuthorizationError(TLSAuthenticationError):
+ """The Checker was expecting the other party to authenticate with a
+ certificate chain that has a different authorization."""
+ pass
+
+class TLSValidationError(TLSAuthenticationError):
+ """The Checker has determined that the other party's certificate
+ chain is invalid."""
+ pass
+
+class TLSFaultError(TLSError):
+ """The other party responded incorrectly to an induced fault.
+
+ This exception will only occur during fault testing, when a
+ TLSConnection's fault variable is set to induce some sort of
+ faulty behavior, and the other party doesn't respond appropriately.
+ """
+ pass
diff --git a/src/gdata/tlslite/integration/AsyncStateMachine.py b/src/gdata/tlslite/integration/AsyncStateMachine.py
new file mode 100755
index 0000000..abed604
--- /dev/null
+++ b/src/gdata/tlslite/integration/AsyncStateMachine.py
@@ -0,0 +1,235 @@
+"""
+A state machine for using TLS Lite with asynchronous I/O.
+"""
+
+class AsyncStateMachine:
+ """
+ This is an abstract class that's used to integrate TLS Lite with
+ asyncore and Twisted.
+
+ This class signals wantsReadsEvent() and wantsWriteEvent(). When
+ the underlying socket has become readable or writeable, the event
+ should be passed to this class by calling inReadEvent() or
+ inWriteEvent(). This class will then try to read or write through
+ the socket, and will update its state appropriately.
+
+ This class will forward higher-level events to its subclass. For
+ example, when a complete TLS record has been received,
+ outReadEvent() will be called with the decrypted data.
+ """
+
+ def __init__(self):
+ self._clear()
+
+ def _clear(self):
+ #These store the various asynchronous operations (i.e.
+ #generators). Only one of them, at most, is ever active at a
+ #time.
+ self.handshaker = None
+ self.closer = None
+ self.reader = None
+ self.writer = None
+
+ #This stores the result from the last call to the
+ #currently active operation. If 0 it indicates that the
+ #operation wants to read, if 1 it indicates that the
+ #operation wants to write. If None, there is no active
+ #operation.
+ self.result = None
+
+ def _checkAssert(self, maxActive=1):
+ #This checks that only one operation, at most, is
+ #active, and that self.result is set appropriately.
+ activeOps = 0
+ if self.handshaker:
+ activeOps += 1
+ if self.closer:
+ activeOps += 1
+ if self.reader:
+ activeOps += 1
+ if self.writer:
+ activeOps += 1
+
+ if self.result == None:
+ if activeOps != 0:
+ raise AssertionError()
+ elif self.result in (0,1):
+ if activeOps != 1:
+ raise AssertionError()
+ else:
+ raise AssertionError()
+ if activeOps > maxActive:
+ raise AssertionError()
+
+ def wantsReadEvent(self):
+ """If the state machine wants to read.
+
+ If an operation is active, this returns whether or not the
+ operation wants to read from the socket. If an operation is
+ not active, this returns None.
+
+ @rtype: bool or None
+ @return: If the state machine wants to read.
+ """
+ if self.result != None:
+ return self.result == 0
+ return None
+
+ def wantsWriteEvent(self):
+ """If the state machine wants to write.
+
+ If an operation is active, this returns whether or not the
+ operation wants to write to the socket. If an operation is
+ not active, this returns None.
+
+ @rtype: bool or None
+ @return: If the state machine wants to write.
+ """
+ if self.result != None:
+ return self.result == 1
+ return None
+
+ def outConnectEvent(self):
+ """Called when a handshake operation completes.
+
+ May be overridden in subclass.
+ """
+ pass
+
+ def outCloseEvent(self):
+ """Called when a close operation completes.
+
+ May be overridden in subclass.
+ """
+ pass
+
+ def outReadEvent(self, readBuffer):
+ """Called when a read operation completes.
+
+ May be overridden in subclass."""
+ pass
+
+ def outWriteEvent(self):
+ """Called when a write operation completes.
+
+ May be overridden in subclass."""
+ pass
+
+ def inReadEvent(self):
+ """Tell the state machine it can read from the socket."""
+ try:
+ self._checkAssert()
+ if self.handshaker:
+ self._doHandshakeOp()
+ elif self.closer:
+ self._doCloseOp()
+ elif self.reader:
+ self._doReadOp()
+ elif self.writer:
+ self._doWriteOp()
+ else:
+ self.reader = self.tlsConnection.readAsync(16384)
+ self._doReadOp()
+ except:
+ self._clear()
+ raise
+
+ def inWriteEvent(self):
+ """Tell the state machine it can write to the socket."""
+ try:
+ self._checkAssert()
+ if self.handshaker:
+ self._doHandshakeOp()
+ elif self.closer:
+ self._doCloseOp()
+ elif self.reader:
+ self._doReadOp()
+ elif self.writer:
+ self._doWriteOp()
+ else:
+ self.outWriteEvent()
+ except:
+ self._clear()
+ raise
+
+ def _doHandshakeOp(self):
+ try:
+ self.result = self.handshaker.next()
+ except StopIteration:
+ self.handshaker = None
+ self.result = None
+ self.outConnectEvent()
+
+ def _doCloseOp(self):
+ try:
+ self.result = self.closer.next()
+ except StopIteration:
+ self.closer = None
+ self.result = None
+ self.outCloseEvent()
+
+ def _doReadOp(self):
+ self.result = self.reader.next()
+ if not self.result in (0,1):
+ readBuffer = self.result
+ self.reader = None
+ self.result = None
+ self.outReadEvent(readBuffer)
+
+ def _doWriteOp(self):
+ try:
+ self.result = self.writer.next()
+ except StopIteration:
+ self.writer = None
+ self.result = None
+
+ def setHandshakeOp(self, handshaker):
+ """Start a handshake operation.
+
+ @type handshaker: generator
+ @param handshaker: A generator created by using one of the
+ asynchronous handshake functions (i.e. handshakeServerAsync, or
+ handshakeClientxxx(..., async=True).
+ """
+ try:
+ self._checkAssert(0)
+ self.handshaker = handshaker
+ self._doHandshakeOp()
+ except:
+ self._clear()
+ raise
+
+ def setServerHandshakeOp(self, **args):
+ """Start a handshake operation.
+
+ The arguments passed to this function will be forwarded to
+ L{tlslite.TLSConnection.TLSConnection.handshakeServerAsync}.
+ """
+ handshaker = self.tlsConnection.handshakeServerAsync(**args)
+ self.setHandshakeOp(handshaker)
+
+ def setCloseOp(self):
+ """Start a close operation.
+ """
+ try:
+ self._checkAssert(0)
+ self.closer = self.tlsConnection.closeAsync()
+ self._doCloseOp()
+ except:
+ self._clear()
+ raise
+
+ def setWriteOp(self, writeBuffer):
+ """Start a write operation.
+
+ @type writeBuffer: str
+ @param writeBuffer: The string to transmit.
+ """
+ try:
+ self._checkAssert(0)
+ self.writer = self.tlsConnection.writeAsync(writeBuffer)
+ self._doWriteOp()
+ except:
+ self._clear()
+ raise
+
diff --git a/src/gdata/tlslite/integration/ClientHelper.py b/src/gdata/tlslite/integration/ClientHelper.py
new file mode 100755
index 0000000..58e0152
--- /dev/null
+++ b/src/gdata/tlslite/integration/ClientHelper.py
@@ -0,0 +1,163 @@
+"""
+A helper class for using TLS Lite with stdlib clients
+(httplib, xmlrpclib, imaplib, poplib).
+"""
+
+from gdata.tlslite.Checker import Checker
+
+class ClientHelper:
+ """This is a helper class used to integrate TLS Lite with various
+ TLS clients (e.g. poplib, smtplib, httplib, etc.)"""
+
+ def __init__(self,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings = None):
+ """
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The constructor does not perform the TLS handshake itself, but
+ simply stores these arguments for later. The handshake is
+ performed only when this class needs to connect with the
+ server. Then you should be prepared to handle TLS-specific
+ exceptions. See the client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+
+ self.username = None
+ self.password = None
+ self.sharedKey = None
+ self.certChain = None
+ self.privateKey = None
+ self.checker = None
+
+ #SRP Authentication
+ if username and password and not \
+ (sharedKey or certChain or privateKey):
+ self.username = username
+ self.password = password
+
+ #Shared Key Authentication
+ elif username and sharedKey and not \
+ (password or certChain or privateKey):
+ self.username = username
+ self.sharedKey = sharedKey
+
+ #Certificate Chain Authentication
+ elif certChain and privateKey and not \
+ (username or password or sharedKey):
+ self.certChain = certChain
+ self.privateKey = privateKey
+
+ #No Authentication
+ elif not password and not username and not \
+ sharedKey and not certChain and not privateKey:
+ pass
+
+ else:
+ raise ValueError("Bad parameters")
+
+ #Authenticate the server based on its cryptoID or fingerprint
+ if sharedKey and (cryptoID or protocol or x509Fingerprint):
+ raise ValueError("Can't use shared keys with other forms of"\
+ "authentication")
+
+ self.checker = Checker(cryptoID, protocol, x509Fingerprint,
+ x509TrustList, x509CommonName)
+ self.settings = settings
+
+ self.tlsSession = None
+
+ def _handshake(self, tlsConnection):
+ if self.username and self.password:
+ tlsConnection.handshakeClientSRP(username=self.username,
+ password=self.password,
+ checker=self.checker,
+ settings=self.settings,
+ session=self.tlsSession)
+ elif self.username and self.sharedKey:
+ tlsConnection.handshakeClientSharedKey(username=self.username,
+ sharedKey=self.sharedKey,
+ settings=self.settings)
+ else:
+ tlsConnection.handshakeClientCert(certChain=self.certChain,
+ privateKey=self.privateKey,
+ checker=self.checker,
+ settings=self.settings,
+ session=self.tlsSession)
+ self.tlsSession = tlsConnection.session
diff --git a/src/gdata/tlslite/integration/HTTPTLSConnection.py b/src/gdata/tlslite/integration/HTTPTLSConnection.py
new file mode 100755
index 0000000..58e31a1
--- /dev/null
+++ b/src/gdata/tlslite/integration/HTTPTLSConnection.py
@@ -0,0 +1,169 @@
+"""TLS Lite + httplib."""
+
+import socket
+import httplib
+from gdata.tlslite.TLSConnection import TLSConnection
+from gdata.tlslite.integration.ClientHelper import ClientHelper
+
+
+class HTTPBaseTLSConnection(httplib.HTTPConnection):
+ """This abstract class provides a framework for adding TLS support
+ to httplib."""
+
+ default_port = 443
+
+ def __init__(self, host, port=None, strict=None):
+ if strict == None:
+ #Python 2.2 doesn't support strict
+ httplib.HTTPConnection.__init__(self, host, port)
+ else:
+ httplib.HTTPConnection.__init__(self, host, port, strict)
+
+ def connect(self):
+ sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+ if hasattr(sock, 'settimeout'):
+ sock.settimeout(10)
+ sock.connect((self.host, self.port))
+
+ #Use a TLSConnection to emulate a socket
+ self.sock = TLSConnection(sock)
+
+ #When httplib closes this, close the socket
+ self.sock.closeSocket = True
+ self._handshake(self.sock)
+
+ def _handshake(self, tlsConnection):
+ """Called to perform some sort of handshake.
+
+ This method must be overridden in a subclass to do some type of
+ handshake. This method will be called after the socket has
+ been connected but before any data has been sent. If this
+ method does not raise an exception, the TLS connection will be
+ considered valid.
+
+ This method may (or may not) be called every time an HTTP
+ request is performed, depending on whether the underlying HTTP
+ connection is persistent.
+
+ @type tlsConnection: L{tlslite.TLSConnection.TLSConnection}
+ @param tlsConnection: The connection to perform the handshake
+ on.
+ """
+ raise NotImplementedError()
+
+
+class HTTPTLSConnection(HTTPBaseTLSConnection, ClientHelper):
+ """This class extends L{HTTPBaseTLSConnection} to support the
+ common types of handshaking."""
+
+ def __init__(self, host, port=None,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings = None):
+ """Create a new HTTPTLSConnection.
+
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The constructor does not perform the TLS handshake itself, but
+ simply stores these arguments for later. The handshake is
+ performed only when this class needs to connect with the
+ server. Thus you should be prepared to handle TLS-specific
+ exceptions when calling methods inherited from
+ L{httplib.HTTPConnection} such as request(), connect(), and
+ send(). See the client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type host: str
+ @param host: Server to connect to.
+
+ @type port: int
+ @param port: Port to connect to.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+
+ HTTPBaseTLSConnection.__init__(self, host, port)
+
+ ClientHelper.__init__(self,
+ username, password, sharedKey,
+ certChain, privateKey,
+ cryptoID, protocol,
+ x509Fingerprint,
+ x509TrustList, x509CommonName,
+ settings)
+
+ def _handshake(self, tlsConnection):
+ ClientHelper._handshake(self, tlsConnection)
diff --git a/src/gdata/tlslite/integration/IMAP4_TLS.py b/src/gdata/tlslite/integration/IMAP4_TLS.py
new file mode 100755
index 0000000..e47076c
--- /dev/null
+++ b/src/gdata/tlslite/integration/IMAP4_TLS.py
@@ -0,0 +1,132 @@
+"""TLS Lite + imaplib."""
+
+import socket
+from imaplib import IMAP4
+from gdata.tlslite.TLSConnection import TLSConnection
+from gdata.tlslite.integration.ClientHelper import ClientHelper
+
+# IMAP TLS PORT
+IMAP4_TLS_PORT = 993
+
+class IMAP4_TLS(IMAP4, ClientHelper):
+ """This class extends L{imaplib.IMAP4} with TLS support."""
+
+ def __init__(self, host = '', port = IMAP4_TLS_PORT,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings=None):
+ """Create a new IMAP4_TLS.
+
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The caller should be prepared to handle TLS-specific
+ exceptions. See the client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type host: str
+ @param host: Server to connect to.
+
+ @type port: int
+ @param port: Port to connect to.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+
+ ClientHelper.__init__(self,
+ username, password, sharedKey,
+ certChain, privateKey,
+ cryptoID, protocol,
+ x509Fingerprint,
+ x509TrustList, x509CommonName,
+ settings)
+
+ IMAP4.__init__(self, host, port)
+
+
+ def open(self, host = '', port = IMAP4_TLS_PORT):
+ """Setup connection to remote server on "host:port".
+
+ This connection will be used by the routines:
+ read, readline, send, shutdown.
+ """
+ self.host = host
+ self.port = port
+ self.sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+ self.sock.connect((host, port))
+ self.sock = TLSConnection(self.sock)
+ self.sock.closeSocket = True
+ ClientHelper._handshake(self, self.sock)
+ self.file = self.sock.makefile('rb')
diff --git a/src/gdata/tlslite/integration/IntegrationHelper.py b/src/gdata/tlslite/integration/IntegrationHelper.py
new file mode 100755
index 0000000..af5193b
--- /dev/null
+++ b/src/gdata/tlslite/integration/IntegrationHelper.py
@@ -0,0 +1,52 @@
+
+class IntegrationHelper:
+
+ def __init__(self,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings = None):
+
+ self.username = None
+ self.password = None
+ self.sharedKey = None
+ self.certChain = None
+ self.privateKey = None
+ self.checker = None
+
+ #SRP Authentication
+ if username and password and not \
+ (sharedKey or certChain or privateKey):
+ self.username = username
+ self.password = password
+
+ #Shared Key Authentication
+ elif username and sharedKey and not \
+ (password or certChain or privateKey):
+ self.username = username
+ self.sharedKey = sharedKey
+
+ #Certificate Chain Authentication
+ elif certChain and privateKey and not \
+ (username or password or sharedKey):
+ self.certChain = certChain
+ self.privateKey = privateKey
+
+ #No Authentication
+ elif not password and not username and not \
+ sharedKey and not certChain and not privateKey:
+ pass
+
+ else:
+ raise ValueError("Bad parameters")
+
+ #Authenticate the server based on its cryptoID or fingerprint
+ if sharedKey and (cryptoID or protocol or x509Fingerprint):
+ raise ValueError("Can't use shared keys with other forms of"\
+ "authentication")
+
+ self.checker = Checker(cryptoID, protocol, x509Fingerprint,
+ x509TrustList, x509CommonName)
+ self.settings = settings
\ No newline at end of file
diff --git a/src/gdata/tlslite/integration/POP3_TLS.py b/src/gdata/tlslite/integration/POP3_TLS.py
new file mode 100755
index 0000000..26b37fd
--- /dev/null
+++ b/src/gdata/tlslite/integration/POP3_TLS.py
@@ -0,0 +1,142 @@
+"""TLS Lite + poplib."""
+
+import socket
+from poplib import POP3
+from gdata.tlslite.TLSConnection import TLSConnection
+from gdata.tlslite.integration.ClientHelper import ClientHelper
+
+# POP TLS PORT
+POP3_TLS_PORT = 995
+
+class POP3_TLS(POP3, ClientHelper):
+ """This class extends L{poplib.POP3} with TLS support."""
+
+ def __init__(self, host, port = POP3_TLS_PORT,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings=None):
+ """Create a new POP3_TLS.
+
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The caller should be prepared to handle TLS-specific
+ exceptions. See the client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type host: str
+ @param host: Server to connect to.
+
+ @type port: int
+ @param port: Port to connect to.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+
+ self.host = host
+ self.port = port
+ msg = "getaddrinfo returns an empty list"
+ self.sock = None
+ for res in socket.getaddrinfo(self.host, self.port, 0, socket.SOCK_STREAM):
+ af, socktype, proto, canonname, sa = res
+ try:
+ self.sock = socket.socket(af, socktype, proto)
+ self.sock.connect(sa)
+ except socket.error, msg:
+ if self.sock:
+ self.sock.close()
+ self.sock = None
+ continue
+ break
+ if not self.sock:
+ raise socket.error, msg
+
+ ### New code below (all else copied from poplib)
+ ClientHelper.__init__(self,
+ username, password, sharedKey,
+ certChain, privateKey,
+ cryptoID, protocol,
+ x509Fingerprint,
+ x509TrustList, x509CommonName,
+ settings)
+
+ self.sock = TLSConnection(self.sock)
+ self.sock.closeSocket = True
+ ClientHelper._handshake(self, self.sock)
+ ###
+
+ self.file = self.sock.makefile('rb')
+ self._debugging = 0
+ self.welcome = self._getresp()
diff --git a/src/gdata/tlslite/integration/SMTP_TLS.py b/src/gdata/tlslite/integration/SMTP_TLS.py
new file mode 100755
index 0000000..67e0feb
--- /dev/null
+++ b/src/gdata/tlslite/integration/SMTP_TLS.py
@@ -0,0 +1,114 @@
+"""TLS Lite + smtplib."""
+
+from smtplib import SMTP
+from gdata.tlslite.TLSConnection import TLSConnection
+from gdata.tlslite.integration.ClientHelper import ClientHelper
+
+class SMTP_TLS(SMTP):
+ """This class extends L{smtplib.SMTP} with TLS support."""
+
+ def starttls(self,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings=None):
+ """Puts the connection to the SMTP server into TLS mode.
+
+ If the server supports TLS, this will encrypt the rest of the SMTP
+ session.
+
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The caller should be prepared to handle TLS-specific
+ exceptions. See the client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+ (resp, reply) = self.docmd("STARTTLS")
+ if resp == 220:
+ helper = ClientHelper(
+ username, password, sharedKey,
+ certChain, privateKey,
+ cryptoID, protocol,
+ x509Fingerprint,
+ x509TrustList, x509CommonName,
+ settings)
+ conn = TLSConnection(self.sock)
+ conn.closeSocket = True
+ helper._handshake(conn)
+ self.sock = conn
+ self.file = conn.makefile('rb')
+ return (resp, reply)
diff --git a/src/gdata/tlslite/integration/TLSAsyncDispatcherMixIn.py b/src/gdata/tlslite/integration/TLSAsyncDispatcherMixIn.py
new file mode 100755
index 0000000..f732f62
--- /dev/null
+++ b/src/gdata/tlslite/integration/TLSAsyncDispatcherMixIn.py
@@ -0,0 +1,139 @@
+"""TLS Lite + asyncore."""
+
+
+import asyncore
+from gdata.tlslite.TLSConnection import TLSConnection
+from AsyncStateMachine import AsyncStateMachine
+
+
+class TLSAsyncDispatcherMixIn(AsyncStateMachine):
+ """This class can be "mixed in" with an
+ L{asyncore.dispatcher} to add TLS support.
+
+ This class essentially sits between the dispatcher and the select
+ loop, intercepting events and only calling the dispatcher when
+ applicable.
+
+ In the case of handle_read(), a read operation will be activated,
+ and when it completes, the bytes will be placed in a buffer where
+ the dispatcher can retrieve them by calling recv(), and the
+ dispatcher's handle_read() will be called.
+
+ In the case of handle_write(), the dispatcher's handle_write() will
+ be called, and when it calls send(), a write operation will be
+ activated.
+
+ To use this class, you must combine it with an asyncore.dispatcher,
+ and pass in a handshake operation with setServerHandshakeOp().
+
+ Below is an example of using this class with medusa. This class is
+ mixed in with http_channel to create http_tls_channel. Note:
+ 1. the mix-in is listed first in the inheritance list
+
+ 2. the input buffer size must be at least 16K, otherwise the
+ dispatcher might not read all the bytes from the TLS layer,
+ leaving some bytes in limbo.
+
+ 3. IE seems to have a problem receiving a whole HTTP response in a
+ single TLS record, so HTML pages containing '\\r\\n\\r\\n' won't
+ be displayed on IE.
+
+ Add the following text into 'start_medusa.py', in the 'HTTP Server'
+ section::
+
+ from tlslite.api import *
+ s = open("./serverX509Cert.pem").read()
+ x509 = X509()
+ x509.parse(s)
+ certChain = X509CertChain([x509])
+
+ s = open("./serverX509Key.pem").read()
+ privateKey = parsePEMKey(s, private=True)
+
+ class http_tls_channel(TLSAsyncDispatcherMixIn,
+ http_server.http_channel):
+ ac_in_buffer_size = 16384
+
+ def __init__ (self, server, conn, addr):
+ http_server.http_channel.__init__(self, server, conn, addr)
+ TLSAsyncDispatcherMixIn.__init__(self, conn)
+ self.tlsConnection.ignoreAbruptClose = True
+ self.setServerHandshakeOp(certChain=certChain,
+ privateKey=privateKey)
+
+ hs.channel_class = http_tls_channel
+
+ If the TLS layer raises an exception, the exception will be caught
+ in asyncore.dispatcher, which will call close() on this class. The
+ TLS layer always closes the TLS connection before raising an
+ exception, so the close operation will complete right away, causing
+ asyncore.dispatcher.close() to be called, which closes the socket
+ and removes this instance from the asyncore loop.
+
+ """
+
+
+ def __init__(self, sock=None):
+ AsyncStateMachine.__init__(self)
+
+ if sock:
+ self.tlsConnection = TLSConnection(sock)
+
+ #Calculate the sibling I'm being mixed in with.
+ #This is necessary since we override functions
+ #like readable(), handle_read(), etc., but we
+ #also want to call the sibling's versions.
+ for cl in self.__class__.__bases__:
+ if cl != TLSAsyncDispatcherMixIn and cl != AsyncStateMachine:
+ self.siblingClass = cl
+ break
+ else:
+ raise AssertionError()
+
+ def readable(self):
+ result = self.wantsReadEvent()
+ if result != None:
+ return result
+ return self.siblingClass.readable(self)
+
+ def writable(self):
+ result = self.wantsWriteEvent()
+ if result != None:
+ return result
+ return self.siblingClass.writable(self)
+
+ def handle_read(self):
+ self.inReadEvent()
+
+ def handle_write(self):
+ self.inWriteEvent()
+
+ def outConnectEvent(self):
+ self.siblingClass.handle_connect(self)
+
+ def outCloseEvent(self):
+ asyncore.dispatcher.close(self)
+
+ def outReadEvent(self, readBuffer):
+ self.readBuffer = readBuffer
+ self.siblingClass.handle_read(self)
+
+ def outWriteEvent(self):
+ self.siblingClass.handle_write(self)
+
+ def recv(self, bufferSize=16384):
+ if bufferSize < 16384 or self.readBuffer == None:
+ raise AssertionError()
+ returnValue = self.readBuffer
+ self.readBuffer = None
+ return returnValue
+
+ def send(self, writeBuffer):
+ self.setWriteOp(writeBuffer)
+ return len(writeBuffer)
+
+ def close(self):
+ if hasattr(self, "tlsConnection"):
+ self.setCloseOp()
+ else:
+ asyncore.dispatcher.close(self)
diff --git a/src/gdata/tlslite/integration/TLSSocketServerMixIn.py b/src/gdata/tlslite/integration/TLSSocketServerMixIn.py
new file mode 100755
index 0000000..10224b6
--- /dev/null
+++ b/src/gdata/tlslite/integration/TLSSocketServerMixIn.py
@@ -0,0 +1,59 @@
+"""TLS Lite + SocketServer."""
+
+from gdata.tlslite.TLSConnection import TLSConnection
+
+class TLSSocketServerMixIn:
+ """
+ This class can be mixed in with any L{SocketServer.TCPServer} to
+ add TLS support.
+
+ To use this class, define a new class that inherits from it and
+ some L{SocketServer.TCPServer} (with the mix-in first). Then
+ implement the handshake() method, doing some sort of server
+ handshake on the connection argument. If the handshake method
+ returns True, the RequestHandler will be triggered. Below is a
+ complete example of a threaded HTTPS server::
+
+ from SocketServer import *
+ from BaseHTTPServer import *
+ from SimpleHTTPServer import *
+ from tlslite.api import *
+
+ s = open("./serverX509Cert.pem").read()
+ x509 = X509()
+ x509.parse(s)
+ certChain = X509CertChain([x509])
+
+ s = open("./serverX509Key.pem").read()
+ privateKey = parsePEMKey(s, private=True)
+
+ sessionCache = SessionCache()
+
+ class MyHTTPServer(ThreadingMixIn, TLSSocketServerMixIn,
+ HTTPServer):
+ def handshake(self, tlsConnection):
+ try:
+ tlsConnection.handshakeServer(certChain=certChain,
+ privateKey=privateKey,
+ sessionCache=sessionCache)
+ tlsConnection.ignoreAbruptClose = True
+ return True
+ except TLSError, error:
+ print "Handshake failure:", str(error)
+ return False
+
+ httpd = MyHTTPServer(('localhost', 443), SimpleHTTPRequestHandler)
+ httpd.serve_forever()
+ """
+
+
+ def finish_request(self, sock, client_address):
+ tlsConnection = TLSConnection(sock)
+ if self.handshake(tlsConnection) == True:
+ self.RequestHandlerClass(tlsConnection, client_address, self)
+ tlsConnection.close()
+
+ #Implement this method to do some form of handshaking. Return True
+ #if the handshake finishes properly and the request is authorized.
+ def handshake(self, tlsConnection):
+ raise NotImplementedError()
diff --git a/src/gdata/tlslite/integration/TLSTwistedProtocolWrapper.py b/src/gdata/tlslite/integration/TLSTwistedProtocolWrapper.py
new file mode 100755
index 0000000..c88703c
--- /dev/null
+++ b/src/gdata/tlslite/integration/TLSTwistedProtocolWrapper.py
@@ -0,0 +1,196 @@
+"""TLS Lite + Twisted."""
+
+from twisted.protocols.policies import ProtocolWrapper, WrappingFactory
+from twisted.python.failure import Failure
+
+from AsyncStateMachine import AsyncStateMachine
+from gdata.tlslite.TLSConnection import TLSConnection
+from gdata.tlslite.errors import *
+
+import socket
+import errno
+
+
+#The TLSConnection is created around a "fake socket" that
+#plugs it into the underlying Twisted transport
+class _FakeSocket:
+ def __init__(self, wrapper):
+ self.wrapper = wrapper
+ self.data = ""
+
+ def send(self, data):
+ ProtocolWrapper.write(self.wrapper, data)
+ return len(data)
+
+ def recv(self, numBytes):
+ if self.data == "":
+ raise socket.error, (errno.EWOULDBLOCK, "")
+ returnData = self.data[:numBytes]
+ self.data = self.data[numBytes:]
+ return returnData
+
+class TLSTwistedProtocolWrapper(ProtocolWrapper, AsyncStateMachine):
+ """This class can wrap Twisted protocols to add TLS support.
+
+ Below is a complete example of using TLS Lite with a Twisted echo
+ server.
+
+ There are two server implementations below. Echo is the original
+ protocol, which is oblivious to TLS. Echo1 subclasses Echo and
+ negotiates TLS when the client connects. Echo2 subclasses Echo and
+ negotiates TLS when the client sends "STARTTLS"::
+
+ from twisted.internet.protocol import Protocol, Factory
+ from twisted.internet import reactor
+ from twisted.protocols.policies import WrappingFactory
+ from twisted.protocols.basic import LineReceiver
+ from twisted.python import log
+ from twisted.python.failure import Failure
+ import sys
+ from tlslite.api import *
+
+ s = open("./serverX509Cert.pem").read()
+ x509 = X509()
+ x509.parse(s)
+ certChain = X509CertChain([x509])
+
+ s = open("./serverX509Key.pem").read()
+ privateKey = parsePEMKey(s, private=True)
+
+ verifierDB = VerifierDB("verifierDB")
+ verifierDB.open()
+
+ class Echo(LineReceiver):
+ def connectionMade(self):
+ self.transport.write("Welcome to the echo server!\\r\\n")
+
+ def lineReceived(self, line):
+ self.transport.write(line + "\\r\\n")
+
+ class Echo1(Echo):
+ def connectionMade(self):
+ if not self.transport.tlsStarted:
+ self.transport.setServerHandshakeOp(certChain=certChain,
+ privateKey=privateKey,
+ verifierDB=verifierDB)
+ else:
+ Echo.connectionMade(self)
+
+ def connectionLost(self, reason):
+ pass #Handle any TLS exceptions here
+
+ class Echo2(Echo):
+ def lineReceived(self, data):
+ if data == "STARTTLS":
+ self.transport.setServerHandshakeOp(certChain=certChain,
+ privateKey=privateKey,
+ verifierDB=verifierDB)
+ else:
+ Echo.lineReceived(self, data)
+
+ def connectionLost(self, reason):
+ pass #Handle any TLS exceptions here
+
+ factory = Factory()
+ factory.protocol = Echo1
+ #factory.protocol = Echo2
+
+ wrappingFactory = WrappingFactory(factory)
+ wrappingFactory.protocol = TLSTwistedProtocolWrapper
+
+ log.startLogging(sys.stdout)
+ reactor.listenTCP(1079, wrappingFactory)
+ reactor.run()
+
+ This class works as follows:
+
+ Data comes in and is given to the AsyncStateMachine for handling.
+ AsyncStateMachine will forward events to this class, and we'll
+ pass them on to the ProtocolHandler, which will proxy them to the
+ wrapped protocol. The wrapped protocol may then call back into
+ this class, and these calls will be proxied into the
+ AsyncStateMachine.
+
+ The call graph looks like this:
+ - self.dataReceived
+ - AsyncStateMachine.inReadEvent
+ - self.out(Connect|Close|Read)Event
+ - ProtocolWrapper.(connectionMade|loseConnection|dataReceived)
+ - self.(loseConnection|write|writeSequence)
+ - AsyncStateMachine.(setCloseOp|setWriteOp)
+ """
+
+ #WARNING: IF YOU COPY-AND-PASTE THE ABOVE CODE, BE SURE TO REMOVE
+ #THE EXTRA ESCAPING AROUND "\\r\\n"
+
+ def __init__(self, factory, wrappedProtocol):
+ ProtocolWrapper.__init__(self, factory, wrappedProtocol)
+ AsyncStateMachine.__init__(self)
+ self.fakeSocket = _FakeSocket(self)
+ self.tlsConnection = TLSConnection(self.fakeSocket)
+ self.tlsStarted = False
+ self.connectionLostCalled = False
+
+ def connectionMade(self):
+ try:
+ ProtocolWrapper.connectionMade(self)
+ except TLSError, e:
+ self.connectionLost(Failure(e))
+ ProtocolWrapper.loseConnection(self)
+
+ def dataReceived(self, data):
+ try:
+ if not self.tlsStarted:
+ ProtocolWrapper.dataReceived(self, data)
+ else:
+ self.fakeSocket.data += data
+ while self.fakeSocket.data:
+ AsyncStateMachine.inReadEvent(self)
+ except TLSError, e:
+ self.connectionLost(Failure(e))
+ ProtocolWrapper.loseConnection(self)
+
+ def connectionLost(self, reason):
+ if not self.connectionLostCalled:
+ ProtocolWrapper.connectionLost(self, reason)
+ self.connectionLostCalled = True
+
+
+ def outConnectEvent(self):
+ ProtocolWrapper.connectionMade(self)
+
+ def outCloseEvent(self):
+ ProtocolWrapper.loseConnection(self)
+
+ def outReadEvent(self, data):
+ if data == "":
+ ProtocolWrapper.loseConnection(self)
+ else:
+ ProtocolWrapper.dataReceived(self, data)
+
+
+ def setServerHandshakeOp(self, **args):
+ self.tlsStarted = True
+ AsyncStateMachine.setServerHandshakeOp(self, **args)
+
+ def loseConnection(self):
+ if not self.tlsStarted:
+ ProtocolWrapper.loseConnection(self)
+ else:
+ AsyncStateMachine.setCloseOp(self)
+
+ def write(self, data):
+ if not self.tlsStarted:
+ ProtocolWrapper.write(self, data)
+ else:
+ #Because of the FakeSocket, write operations are guaranteed to
+ #terminate immediately.
+ AsyncStateMachine.setWriteOp(self, data)
+
+ def writeSequence(self, seq):
+ if not self.tlsStarted:
+ ProtocolWrapper.writeSequence(self, seq)
+ else:
+ #Because of the FakeSocket, write operations are guaranteed to
+ #terminate immediately.
+ AsyncStateMachine.setWriteOp(self, "".join(seq))
diff --git a/src/gdata/tlslite/integration/XMLRPCTransport.py b/src/gdata/tlslite/integration/XMLRPCTransport.py
new file mode 100755
index 0000000..3f025e4
--- /dev/null
+++ b/src/gdata/tlslite/integration/XMLRPCTransport.py
@@ -0,0 +1,137 @@
+"""TLS Lite + xmlrpclib."""
+
+import xmlrpclib
+import httplib
+from gdata.tlslite.integration.HTTPTLSConnection import HTTPTLSConnection
+from gdata.tlslite.integration.ClientHelper import ClientHelper
+
+
+class XMLRPCTransport(xmlrpclib.Transport, ClientHelper):
+ """Handles an HTTPS transaction to an XML-RPC server."""
+
+ def __init__(self,
+ username=None, password=None, sharedKey=None,
+ certChain=None, privateKey=None,
+ cryptoID=None, protocol=None,
+ x509Fingerprint=None,
+ x509TrustList=None, x509CommonName=None,
+ settings=None):
+ """Create a new XMLRPCTransport.
+
+ An instance of this class can be passed to L{xmlrpclib.ServerProxy}
+ to use TLS with XML-RPC calls::
+
+ from tlslite.api import XMLRPCTransport
+ from xmlrpclib import ServerProxy
+
+ transport = XMLRPCTransport(user="alice", password="abra123")
+ server = ServerProxy("https://localhost", transport)
+
+ For client authentication, use one of these argument
+ combinations:
+ - username, password (SRP)
+ - username, sharedKey (shared-key)
+ - certChain, privateKey (certificate)
+
+ For server authentication, you can either rely on the
+ implicit mutual authentication performed by SRP or
+ shared-keys, or you can do certificate-based server
+ authentication with one of these argument combinations:
+ - cryptoID[, protocol] (requires cryptoIDlib)
+ - x509Fingerprint
+ - x509TrustList[, x509CommonName] (requires cryptlib_py)
+
+ Certificate-based server authentication is compatible with
+ SRP or certificate-based client authentication. It is
+ not compatible with shared-keys.
+
+ The constructor does not perform the TLS handshake itself, but
+ simply stores these arguments for later. The handshake is
+ performed only when this class needs to connect with the
+ server. Thus you should be prepared to handle TLS-specific
+ exceptions when calling methods of L{xmlrpclib.ServerProxy}. See the
+ client handshake functions in
+ L{tlslite.TLSConnection.TLSConnection} for details on which
+ exceptions might be raised.
+
+ @type username: str
+ @param username: SRP or shared-key username. Requires the
+ 'password' or 'sharedKey' argument.
+
+ @type password: str
+ @param password: SRP password for mutual authentication.
+ Requires the 'username' argument.
+
+ @type sharedKey: str
+ @param sharedKey: Shared key for mutual authentication.
+ Requires the 'username' argument.
+
+ @type certChain: L{tlslite.X509CertChain.X509CertChain} or
+ L{cryptoIDlib.CertChain.CertChain}
+ @param certChain: Certificate chain for client authentication.
+ Requires the 'privateKey' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type privateKey: L{tlslite.utils.RSAKey.RSAKey}
+ @param privateKey: Private key for client authentication.
+ Requires the 'certChain' argument. Excludes the SRP or
+ shared-key related arguments.
+
+ @type cryptoID: str
+ @param cryptoID: cryptoID for server authentication. Mutually
+ exclusive with the 'x509...' arguments.
+
+ @type protocol: str
+ @param protocol: cryptoID protocol URI for server
+ authentication. Requires the 'cryptoID' argument.
+
+ @type x509Fingerprint: str
+ @param x509Fingerprint: Hex-encoded X.509 fingerprint for
+ server authentication. Mutually exclusive with the 'cryptoID'
+ and 'x509TrustList' arguments.
+
+ @type x509TrustList: list of L{tlslite.X509.X509}
+ @param x509TrustList: A list of trusted root certificates. The
+ other party must present a certificate chain which extends to
+ one of these root certificates. The cryptlib_py module must be
+ installed to use this parameter. Mutually exclusive with the
+ 'cryptoID' and 'x509Fingerprint' arguments.
+
+ @type x509CommonName: str
+ @param x509CommonName: The end-entity certificate's 'CN' field
+ must match this value. For a web server, this is typically a
+ server name such as 'www.amazon.com'. Mutually exclusive with
+ the 'cryptoID' and 'x509Fingerprint' arguments. Requires the
+ 'x509TrustList' argument.
+
+ @type settings: L{tlslite.HandshakeSettings.HandshakeSettings}
+ @param settings: Various settings which can be used to control
+ the ciphersuites, certificate types, and SSL/TLS versions
+ offered by the client.
+ """
+
+ ClientHelper.__init__(self,
+ username, password, sharedKey,
+ certChain, privateKey,
+ cryptoID, protocol,
+ x509Fingerprint,
+ x509TrustList, x509CommonName,
+ settings)
+
+
+ def make_connection(self, host):
+ # create a HTTPS connection object from a host descriptor
+ host, extra_headers, x509 = self.get_host_info(host)
+ http = HTTPTLSConnection(host, None,
+ self.username, self.password,
+ self.sharedKey,
+ self.certChain, self.privateKey,
+ self.checker.cryptoID,
+ self.checker.protocol,
+ self.checker.x509Fingerprint,
+ self.checker.x509TrustList,
+ self.checker.x509CommonName,
+ self.settings)
+ http2 = httplib.HTTP()
+ http2._setup(http)
+ return http2
diff --git a/src/gdata/tlslite/integration/__init__.py b/src/gdata/tlslite/integration/__init__.py
new file mode 100755
index 0000000..960f406
--- /dev/null
+++ b/src/gdata/tlslite/integration/__init__.py
@@ -0,0 +1,17 @@
+"""Classes for integrating TLS Lite with other packages."""
+
+__all__ = ["AsyncStateMachine",
+ "HTTPTLSConnection",
+ "POP3_TLS",
+ "IMAP4_TLS",
+ "SMTP_TLS",
+ "XMLRPCTransport",
+ "TLSSocketServerMixIn",
+ "TLSAsyncDispatcherMixIn",
+ "TLSTwistedProtocolWrapper"]
+
+try:
+ import twisted
+ del twisted
+except ImportError:
+ del __all__[__all__.index("TLSTwistedProtocolWrapper")]
diff --git a/src/gdata/tlslite/mathtls.py b/src/gdata/tlslite/mathtls.py
new file mode 100755
index 0000000..3b8ede6
--- /dev/null
+++ b/src/gdata/tlslite/mathtls.py
@@ -0,0 +1,170 @@
+"""Miscellaneous helper functions."""
+
+from utils.compat import *
+from utils.cryptomath import *
+
+import hmac
+import md5
+import sha
+
+#1024, 1536, 2048, 3072, 4096, 6144, and 8192 bit groups]
+goodGroupParameters = [(2,0xEEAF0AB9ADB38DD69C33F80AFA8FC5E86072618775FF3C0B9EA2314C9C256576D674DF7496EA81D3383B4813D692C6E0E0D5D8E250B98BE48E495C1D6089DAD15DC7D7B46154D6B6CE8EF4AD69B15D4982559B297BCF1885C529F566660E57EC68EDBC3C05726CC02FD4CBF4976EAA9AFD5138FE8376435B9FC61D2FC0EB06E3),\
+ (2,0x9DEF3CAFB939277AB1F12A8617A47BBBDBA51DF499AC4C80BEEEA9614B19CC4D5F4F5F556E27CBDE51C6A94BE4607A291558903BA0D0F84380B655BB9A22E8DCDF028A7CEC67F0D08134B1C8B97989149B609E0BE3BAB63D47548381DBC5B1FC764E3F4B53DD9DA1158BFD3E2B9C8CF56EDF019539349627DB2FD53D24B7C48665772E437D6C7F8CE442734AF7CCB7AE837C264AE3A9BEB87F8A2FE9B8B5292E5A021FFF5E91479E8CE7A28C2442C6F315180F93499A234DCF76E3FED135F9BB),\
+ (2,0xAC6BDB41324A9A9BF166DE5E1389582FAF72B6651987EE07FC3192943DB56050A37329CBB4A099ED8193E0757767A13DD52312AB4B03310DCD7F48A9DA04FD50E8083969EDB767B0CF6095179A163AB3661A05FBD5FAAAE82918A9962F0B93B855F97993EC975EEAA80D740ADBF4FF747359D041D5C33EA71D281E446B14773BCA97B43A23FB801676BD207A436C6481F1D2B9078717461A5B9D32E688F87748544523B524B0D57D5EA77A2775D2ECFA032CFBDBF52FB3786160279004E57AE6AF874E7303CE53299CCC041C7BC308D82A5698F3A8D0C38271AE35F8E9DBFBB694B5C803D89F7AE435DE236D525F54759B65E372FCD68EF20FA7111F9E4AFF73),\
+ (2,0xFFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F14374FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7EDEE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF0598DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3BE39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF6955817183995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E208E24FA074E5AB3143DB5BFCE0FD108E4B82D120A93AD2CAFFFFFFFFFFFFFFFF),\
+ (5,0xFFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F14374FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7EDEE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF0598DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3BE39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF6955817183995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E208E24FA074E5AB3143DB5BFCE0FD108E4B82D120A92108011A723C12A787E6D788719A10BDBA5B2699C327186AF4E23C1A946834B6150BDA2583E9CA2AD44CE8DBBBC2DB04DE8EF92E8EFC141FBECAA6287C59474E6BC05D99B2964FA090C3A2233BA186515BE7ED1F612970CEE2D7AFB81BDD762170481CD0069127D5B05AA993B4EA988D8FDDC186FFB7DC90A6C08F4DF435C934063199FFFFFFFFFFFFFFFF),\
+ (5,0xFFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F14374FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7EDEE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF0598DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3BE39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF6955817183995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E208E24FA074E5AB3143DB5BFCE0FD108E4B82D120A92108011A723C12A787E6D788719A10BDBA5B2699C327186AF4E23C1A946834B6150BDA2583E9CA2AD44CE8DBBBC2DB04DE8EF92E8EFC141FBECAA6287C59474E6BC05D99B2964FA090C3A2233BA186515BE7ED1F612970CEE2D7AFB81BDD762170481CD0069127D5B05AA993B4EA988D8FDDC186FFB7DC90A6C08F4DF435C93402849236C3FAB4D27C7026C1D4DCB2602646DEC9751E763DBA37BDF8FF9406AD9E530EE5DB382F413001AEB06A53ED9027D831179727B0865A8918DA3EDBEBCF9B14ED44CE6CBACED4BB1BDB7F1447E6CC254B332051512BD7AF426FB8F401378CD2BF5983CA01C64B92ECF032EA15D1721D03F482D7CE6E74FEF6D55E702F46980C82B5A84031900B1C9E59E7C97FBEC7E8F323A97A7E36CC88BE0F1D45B7FF585AC54BD407B22B4154AACC8F6D7EBF48E1D814CC5ED20F8037E0A79715EEF29BE32806A1D58BB7C5DA76F550AA3D8A1FBFF0EB19CCB1A313D55CDA56C9EC2EF29632387FE8D76E3C0468043E8F663F4860EE12BF2D5B0B7474D6E694F91E6DCC4024FFFFFFFFFFFFFFFF),\
+ (5,0xFFFFFFFFFFFFFFFFC90FDAA22168C234C4C6628B80DC1CD129024E088A67CC74020BBEA63B139B22514A08798E3404DDEF9519B3CD3A431B302B0A6DF25F14374FE1356D6D51C245E485B576625E7EC6F44C42E9A637ED6B0BFF5CB6F406B7EDEE386BFB5A899FA5AE9F24117C4B1FE649286651ECE45B3DC2007CB8A163BF0598DA48361C55D39A69163FA8FD24CF5F83655D23DCA3AD961C62F356208552BB9ED529077096966D670C354E4ABC9804F1746C08CA18217C32905E462E36CE3BE39E772C180E86039B2783A2EC07A28FB5C55DF06F4C52C9DE2BCBF6955817183995497CEA956AE515D2261898FA051015728E5A8AAAC42DAD33170D04507A33A85521ABDF1CBA64ECFB850458DBEF0A8AEA71575D060C7DB3970F85A6E1E4C7ABF5AE8CDB0933D71E8C94E04A25619DCEE3D2261AD2EE6BF12FFA06D98A0864D87602733EC86A64521F2B18177B200CBBE117577A615D6C770988C0BAD946E208E24FA074E5AB3143DB5BFCE0FD108E4B82D120A92108011A723C12A787E6D788719A10BDBA5B2699C327186AF4E23C1A946834B6150BDA2583E9CA2AD44CE8DBBBC2DB04DE8EF92E8EFC141FBECAA6287C59474E6BC05D99B2964FA090C3A2233BA186515BE7ED1F612970CEE2D7AFB81BDD762170481CD0069127D5B05AA993B4EA988D8FDDC186FFB7DC90A6C08F4DF435C93402849236C3FAB4D27C7026C1D4DCB2602646DEC9751E763DBA37BDF8FF9406AD9E530EE5DB382F413001AEB06A53ED9027D831179727B0865A8918DA3EDBEBCF9B14ED44CE6CBACED4BB1BDB7F1447E6CC254B332051512BD7AF426FB8F401378CD2BF5983CA01C64B92ECF032EA15D1721D03F482D7CE6E74FEF6D55E702F46980C82B5A84031900B1C9E59E7C97FBEC7E8F323A97A7E36CC88BE0F1D45B7FF585AC54BD407B22B4154AACC8F6D7EBF48E1D814CC5ED20F8037E0A79715EEF29BE32806A1D58BB7C5DA76F550AA3D8A1FBFF0EB19CCB1A313D55CDA56C9EC2EF29632387FE8D76E3C0468043E8F663F4860EE12BF2D5B0B7474D6E694F91E6DBE115974A3926F12FEE5E438777CB6A932DF8CD8BEC4D073B931BA3BC832B68D9DD300741FA7BF8AFC47ED2576F6936BA424663AAB639C5AE4F5683423B4742BF1C978238F16CBE39D652DE3FDB8BEFC848AD922222E04A4037C0713EB57A81A23F0C73473FC646CEA306B4BCBC8862F8385DDFA9D4B7FA2C087E879683303ED5BDD3A062B3CF5B3A278A66D2A13F83F44F82DDF310EE074AB6A364597E899A0255DC164F31CC50846851DF9AB48195DED7EA1B1D510BD7EE74D73FAF36BC31ECFA268359046F4EB879F924009438B481C6CD7889A002ED5EE382BC9190DA6FC026E479558E4475677E9AA9E3050E2765694DFC81F56E880B96E7160C980DD98EDD3DFFFFFFFFFFFFFFFFF)]
+
+def P_hash(hashModule, secret, seed, length):
+ bytes = createByteArrayZeros(length)
+ secret = bytesToString(secret)
+ seed = bytesToString(seed)
+ A = seed
+ index = 0
+ while 1:
+ A = hmac.HMAC(secret, A, hashModule).digest()
+ output = hmac.HMAC(secret, A+seed, hashModule).digest()
+ for c in output:
+ if index >= length:
+ return bytes
+ bytes[index] = ord(c)
+ index += 1
+ return bytes
+
+def PRF(secret, label, seed, length):
+ #Split the secret into left and right halves
+ S1 = secret[ : int(math.ceil(len(secret)/2.0))]
+ S2 = secret[ int(math.floor(len(secret)/2.0)) : ]
+
+ #Run the left half through P_MD5 and the right half through P_SHA1
+ p_md5 = P_hash(md5, S1, concatArrays(stringToBytes(label), seed), length)
+ p_sha1 = P_hash(sha, S2, concatArrays(stringToBytes(label), seed), length)
+
+ #XOR the output values and return the result
+ for x in range(length):
+ p_md5[x] ^= p_sha1[x]
+ return p_md5
+
+
+def PRF_SSL(secret, seed, length):
+ secretStr = bytesToString(secret)
+ seedStr = bytesToString(seed)
+ bytes = createByteArrayZeros(length)
+ index = 0
+ for x in range(26):
+ A = chr(ord('A')+x) * (x+1) # 'A', 'BB', 'CCC', etc..
+ input = secretStr + sha.sha(A + secretStr + seedStr).digest()
+ output = md5.md5(input).digest()
+ for c in output:
+ if index >= length:
+ return bytes
+ bytes[index] = ord(c)
+ index += 1
+ return bytes
+
+def makeX(salt, username, password):
+ if len(username)>=256:
+ raise ValueError("username too long")
+ if len(salt)>=256:
+ raise ValueError("salt too long")
+ return stringToNumber(sha.sha(salt + sha.sha(username + ":" + password)\
+ .digest()).digest())
+
+#This function is used by VerifierDB.makeVerifier
+def makeVerifier(username, password, bits):
+ bitsIndex = {1024:0, 1536:1, 2048:2, 3072:3, 4096:4, 6144:5, 8192:6}[bits]
+ g,N = goodGroupParameters[bitsIndex]
+ salt = bytesToString(getRandomBytes(16))
+ x = makeX(salt, username, password)
+ verifier = powMod(g, x, N)
+ return N, g, salt, verifier
+
+def PAD(n, x):
+ nLength = len(numberToString(n))
+ s = numberToString(x)
+ if len(s) < nLength:
+ s = ("\0" * (nLength-len(s))) + s
+ return s
+
+def makeU(N, A, B):
+ return stringToNumber(sha.sha(PAD(N, A) + PAD(N, B)).digest())
+
+def makeK(N, g):
+ return stringToNumber(sha.sha(numberToString(N) + PAD(N, g)).digest())
+
+
+"""
+MAC_SSL
+Modified from Python HMAC by Trevor
+"""
+
+class MAC_SSL:
+ """MAC_SSL class.
+
+ This supports the API for Cryptographic Hash Functions (PEP 247).
+ """
+
+ def __init__(self, key, msg = None, digestmod = None):
+ """Create a new MAC_SSL object.
+
+ key: key for the keyed hash object.
+ msg: Initial input for the hash, if provided.
+ digestmod: A module supporting PEP 247. Defaults to the md5 module.
+ """
+ if digestmod is None:
+ import md5
+ digestmod = md5
+
+ if key == None: #TREVNEW - for faster copying
+ return #TREVNEW
+
+ self.digestmod = digestmod
+ self.outer = digestmod.new()
+ self.inner = digestmod.new()
+ self.digest_size = digestmod.digest_size
+
+ ipad = "\x36" * 40
+ opad = "\x5C" * 40
+
+ self.inner.update(key)
+ self.inner.update(ipad)
+ self.outer.update(key)
+ self.outer.update(opad)
+ if msg is not None:
+ self.update(msg)
+
+
+ def update(self, msg):
+ """Update this hashing object with the string msg.
+ """
+ self.inner.update(msg)
+
+ def copy(self):
+ """Return a separate copy of this hashing object.
+
+ An update to this copy won't affect the original object.
+ """
+ other = MAC_SSL(None) #TREVNEW - for faster copying
+ other.digest_size = self.digest_size #TREVNEW
+ other.digestmod = self.digestmod
+ other.inner = self.inner.copy()
+ other.outer = self.outer.copy()
+ return other
+
+ def digest(self):
+ """Return the hash value of this hashing object.
+
+ This returns a string containing 8-bit data. The object is
+ not altered in any way by this function; you can continue
+ updating the object after calling this function.
+ """
+ h = self.outer.copy()
+ h.update(self.inner.digest())
+ return h.digest()
+
+ def hexdigest(self):
+ """Like digest(), but returns a string of hexadecimal digits instead.
+ """
+ return "".join([hex(ord(x))[2:].zfill(2)
+ for x in tuple(self.digest())])
diff --git a/src/gdata/tlslite/messages.py b/src/gdata/tlslite/messages.py
new file mode 100755
index 0000000..afccc79
--- /dev/null
+++ b/src/gdata/tlslite/messages.py
@@ -0,0 +1,561 @@
+"""Classes representing TLS messages."""
+
+from utils.compat import *
+from utils.cryptomath import *
+from errors import *
+from utils.codec import *
+from constants import *
+from X509 import X509
+from X509CertChain import X509CertChain
+
+import sha
+import md5
+
+class RecordHeader3:
+ def __init__(self):
+ self.type = 0
+ self.version = (0,0)
+ self.length = 0
+ self.ssl2 = False
+
+ def create(self, version, type, length):
+ self.type = type
+ self.version = version
+ self.length = length
+ return self
+
+ def write(self):
+ w = Writer(5)
+ w.add(self.type, 1)
+ w.add(self.version[0], 1)
+ w.add(self.version[1], 1)
+ w.add(self.length, 2)
+ return w.bytes
+
+ def parse(self, p):
+ self.type = p.get(1)
+ self.version = (p.get(1), p.get(1))
+ self.length = p.get(2)
+ self.ssl2 = False
+ return self
+
+class RecordHeader2:
+ def __init__(self):
+ self.type = 0
+ self.version = (0,0)
+ self.length = 0
+ self.ssl2 = True
+
+ def parse(self, p):
+ if p.get(1)!=128:
+ raise SyntaxError()
+ self.type = ContentType.handshake
+ self.version = (2,0)
+ #We don't support 2-byte-length-headers; could be a problem
+ self.length = p.get(1)
+ return self
+
+
+class Msg:
+ def preWrite(self, trial):
+ if trial:
+ w = Writer()
+ else:
+ length = self.write(True)
+ w = Writer(length)
+ return w
+
+ def postWrite(self, w, trial):
+ if trial:
+ return w.index
+ else:
+ return w.bytes
+
+class Alert(Msg):
+ def __init__(self):
+ self.contentType = ContentType.alert
+ self.level = 0
+ self.description = 0
+
+ def create(self, description, level=AlertLevel.fatal):
+ self.level = level
+ self.description = description
+ return self
+
+ def parse(self, p):
+ p.setLengthCheck(2)
+ self.level = p.get(1)
+ self.description = p.get(1)
+ p.stopLengthCheck()
+ return self
+
+ def write(self):
+ w = Writer(2)
+ w.add(self.level, 1)
+ w.add(self.description, 1)
+ return w.bytes
+
+
+class HandshakeMsg(Msg):
+ def preWrite(self, handshakeType, trial):
+ if trial:
+ w = Writer()
+ w.add(handshakeType, 1)
+ w.add(0, 3)
+ else:
+ length = self.write(True)
+ w = Writer(length)
+ w.add(handshakeType, 1)
+ w.add(length-4, 3)
+ return w
+
+
+class ClientHello(HandshakeMsg):
+ def __init__(self, ssl2=False):
+ self.contentType = ContentType.handshake
+ self.ssl2 = ssl2
+ self.client_version = (0,0)
+ self.random = createByteArrayZeros(32)
+ self.session_id = createByteArraySequence([])
+ self.cipher_suites = [] # a list of 16-bit values
+ self.certificate_types = [CertificateType.x509]
+ self.compression_methods = [] # a list of 8-bit values
+ self.srp_username = None # a string
+
+ def create(self, version, random, session_id, cipher_suites,
+ certificate_types=None, srp_username=None):
+ self.client_version = version
+ self.random = random
+ self.session_id = session_id
+ self.cipher_suites = cipher_suites
+ self.certificate_types = certificate_types
+ self.compression_methods = [0]
+ self.srp_username = srp_username
+ return self
+
+ def parse(self, p):
+ if self.ssl2:
+ self.client_version = (p.get(1), p.get(1))
+ cipherSpecsLength = p.get(2)
+ sessionIDLength = p.get(2)
+ randomLength = p.get(2)
+ self.cipher_suites = p.getFixList(3, int(cipherSpecsLength/3))
+ self.session_id = p.getFixBytes(sessionIDLength)
+ self.random = p.getFixBytes(randomLength)
+ if len(self.random) < 32:
+ zeroBytes = 32-len(self.random)
+ self.random = createByteArrayZeros(zeroBytes) + self.random
+ self.compression_methods = [0]#Fake this value
+
+ #We're not doing a stopLengthCheck() for SSLv2, oh well..
+ else:
+ p.startLengthCheck(3)
+ self.client_version = (p.get(1), p.get(1))
+ self.random = p.getFixBytes(32)
+ self.session_id = p.getVarBytes(1)
+ self.cipher_suites = p.getVarList(2, 2)
+ self.compression_methods = p.getVarList(1, 1)
+ if not p.atLengthCheck():
+ totalExtLength = p.get(2)
+ soFar = 0
+ while soFar != totalExtLength:
+ extType = p.get(2)
+ extLength = p.get(2)
+ if extType == 6:
+ self.srp_username = bytesToString(p.getVarBytes(1))
+ elif extType == 7:
+ self.certificate_types = p.getVarList(1, 1)
+ else:
+ p.getFixBytes(extLength)
+ soFar += 4 + extLength
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.client_hello, trial)
+ w.add(self.client_version[0], 1)
+ w.add(self.client_version[1], 1)
+ w.addFixSeq(self.random, 1)
+ w.addVarSeq(self.session_id, 1, 1)
+ w.addVarSeq(self.cipher_suites, 2, 2)
+ w.addVarSeq(self.compression_methods, 1, 1)
+
+ extLength = 0
+ if self.certificate_types and self.certificate_types != \
+ [CertificateType.x509]:
+ extLength += 5 + len(self.certificate_types)
+ if self.srp_username:
+ extLength += 5 + len(self.srp_username)
+ if extLength > 0:
+ w.add(extLength, 2)
+
+ if self.certificate_types and self.certificate_types != \
+ [CertificateType.x509]:
+ w.add(7, 2)
+ w.add(len(self.certificate_types)+1, 2)
+ w.addVarSeq(self.certificate_types, 1, 1)
+ if self.srp_username:
+ w.add(6, 2)
+ w.add(len(self.srp_username)+1, 2)
+ w.addVarSeq(stringToBytes(self.srp_username), 1, 1)
+
+ return HandshakeMsg.postWrite(self, w, trial)
+
+
+class ServerHello(HandshakeMsg):
+ def __init__(self):
+ self.contentType = ContentType.handshake
+ self.server_version = (0,0)
+ self.random = createByteArrayZeros(32)
+ self.session_id = createByteArraySequence([])
+ self.cipher_suite = 0
+ self.certificate_type = CertificateType.x509
+ self.compression_method = 0
+
+ def create(self, version, random, session_id, cipher_suite,
+ certificate_type):
+ self.server_version = version
+ self.random = random
+ self.session_id = session_id
+ self.cipher_suite = cipher_suite
+ self.certificate_type = certificate_type
+ self.compression_method = 0
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ self.server_version = (p.get(1), p.get(1))
+ self.random = p.getFixBytes(32)
+ self.session_id = p.getVarBytes(1)
+ self.cipher_suite = p.get(2)
+ self.compression_method = p.get(1)
+ if not p.atLengthCheck():
+ totalExtLength = p.get(2)
+ soFar = 0
+ while soFar != totalExtLength:
+ extType = p.get(2)
+ extLength = p.get(2)
+ if extType == 7:
+ self.certificate_type = p.get(1)
+ else:
+ p.getFixBytes(extLength)
+ soFar += 4 + extLength
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.server_hello, trial)
+ w.add(self.server_version[0], 1)
+ w.add(self.server_version[1], 1)
+ w.addFixSeq(self.random, 1)
+ w.addVarSeq(self.session_id, 1, 1)
+ w.add(self.cipher_suite, 2)
+ w.add(self.compression_method, 1)
+
+ extLength = 0
+ if self.certificate_type and self.certificate_type != \
+ CertificateType.x509:
+ extLength += 5
+
+ if extLength != 0:
+ w.add(extLength, 2)
+
+ if self.certificate_type and self.certificate_type != \
+ CertificateType.x509:
+ w.add(7, 2)
+ w.add(1, 2)
+ w.add(self.certificate_type, 1)
+
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class Certificate(HandshakeMsg):
+ def __init__(self, certificateType):
+ self.certificateType = certificateType
+ self.contentType = ContentType.handshake
+ self.certChain = None
+
+ def create(self, certChain):
+ self.certChain = certChain
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ if self.certificateType == CertificateType.x509:
+ chainLength = p.get(3)
+ index = 0
+ certificate_list = []
+ while index != chainLength:
+ certBytes = p.getVarBytes(3)
+ x509 = X509()
+ x509.parseBinary(certBytes)
+ certificate_list.append(x509)
+ index += len(certBytes)+3
+ if certificate_list:
+ self.certChain = X509CertChain(certificate_list)
+ elif self.certificateType == CertificateType.cryptoID:
+ s = bytesToString(p.getVarBytes(2))
+ if s:
+ try:
+ import cryptoIDlib.CertChain
+ except ImportError:
+ raise SyntaxError(\
+ "cryptoID cert chain received, cryptoIDlib not present")
+ self.certChain = cryptoIDlib.CertChain.CertChain().parse(s)
+ else:
+ raise AssertionError()
+
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.certificate, trial)
+ if self.certificateType == CertificateType.x509:
+ chainLength = 0
+ if self.certChain:
+ certificate_list = self.certChain.x509List
+ else:
+ certificate_list = []
+ #determine length
+ for cert in certificate_list:
+ bytes = cert.writeBytes()
+ chainLength += len(bytes)+3
+ #add bytes
+ w.add(chainLength, 3)
+ for cert in certificate_list:
+ bytes = cert.writeBytes()
+ w.addVarSeq(bytes, 1, 3)
+ elif self.certificateType == CertificateType.cryptoID:
+ if self.certChain:
+ bytes = stringToBytes(self.certChain.write())
+ else:
+ bytes = createByteArraySequence([])
+ w.addVarSeq(bytes, 1, 2)
+ else:
+ raise AssertionError()
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class CertificateRequest(HandshakeMsg):
+ def __init__(self):
+ self.contentType = ContentType.handshake
+ self.certificate_types = []
+ #treat as opaque bytes for now
+ self.certificate_authorities = createByteArraySequence([])
+
+ def create(self, certificate_types, certificate_authorities):
+ self.certificate_types = certificate_types
+ self.certificate_authorities = certificate_authorities
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ self.certificate_types = p.getVarList(1, 1)
+ self.certificate_authorities = p.getVarBytes(2)
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.certificate_request,
+ trial)
+ w.addVarSeq(self.certificate_types, 1, 1)
+ w.addVarSeq(self.certificate_authorities, 1, 2)
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class ServerKeyExchange(HandshakeMsg):
+ def __init__(self, cipherSuite):
+ self.cipherSuite = cipherSuite
+ self.contentType = ContentType.handshake
+ self.srp_N = 0L
+ self.srp_g = 0L
+ self.srp_s = createByteArraySequence([])
+ self.srp_B = 0L
+ self.signature = createByteArraySequence([])
+
+ def createSRP(self, srp_N, srp_g, srp_s, srp_B):
+ self.srp_N = srp_N
+ self.srp_g = srp_g
+ self.srp_s = srp_s
+ self.srp_B = srp_B
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ self.srp_N = bytesToNumber(p.getVarBytes(2))
+ self.srp_g = bytesToNumber(p.getVarBytes(2))
+ self.srp_s = p.getVarBytes(1)
+ self.srp_B = bytesToNumber(p.getVarBytes(2))
+ if self.cipherSuite in CipherSuite.srpRsaSuites:
+ self.signature = p.getVarBytes(2)
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.server_key_exchange,
+ trial)
+ w.addVarSeq(numberToBytes(self.srp_N), 1, 2)
+ w.addVarSeq(numberToBytes(self.srp_g), 1, 2)
+ w.addVarSeq(self.srp_s, 1, 1)
+ w.addVarSeq(numberToBytes(self.srp_B), 1, 2)
+ if self.cipherSuite in CipherSuite.srpRsaSuites:
+ w.addVarSeq(self.signature, 1, 2)
+ return HandshakeMsg.postWrite(self, w, trial)
+
+ def hash(self, clientRandom, serverRandom):
+ oldCipherSuite = self.cipherSuite
+ self.cipherSuite = None
+ try:
+ bytes = clientRandom + serverRandom + self.write()[4:]
+ s = bytesToString(bytes)
+ return stringToBytes(md5.md5(s).digest() + sha.sha(s).digest())
+ finally:
+ self.cipherSuite = oldCipherSuite
+
+class ServerHelloDone(HandshakeMsg):
+ def __init__(self):
+ self.contentType = ContentType.handshake
+
+ def create(self):
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.server_hello_done, trial)
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class ClientKeyExchange(HandshakeMsg):
+ def __init__(self, cipherSuite, version=None):
+ self.cipherSuite = cipherSuite
+ self.version = version
+ self.contentType = ContentType.handshake
+ self.srp_A = 0
+ self.encryptedPreMasterSecret = createByteArraySequence([])
+
+ def createSRP(self, srp_A):
+ self.srp_A = srp_A
+ return self
+
+ def createRSA(self, encryptedPreMasterSecret):
+ self.encryptedPreMasterSecret = encryptedPreMasterSecret
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ if self.cipherSuite in CipherSuite.srpSuites + \
+ CipherSuite.srpRsaSuites:
+ self.srp_A = bytesToNumber(p.getVarBytes(2))
+ elif self.cipherSuite in CipherSuite.rsaSuites:
+ if self.version in ((3,1), (3,2)):
+ self.encryptedPreMasterSecret = p.getVarBytes(2)
+ elif self.version == (3,0):
+ self.encryptedPreMasterSecret = \
+ p.getFixBytes(len(p.bytes)-p.index)
+ else:
+ raise AssertionError()
+ else:
+ raise AssertionError()
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.client_key_exchange,
+ trial)
+ if self.cipherSuite in CipherSuite.srpSuites + \
+ CipherSuite.srpRsaSuites:
+ w.addVarSeq(numberToBytes(self.srp_A), 1, 2)
+ elif self.cipherSuite in CipherSuite.rsaSuites:
+ if self.version in ((3,1), (3,2)):
+ w.addVarSeq(self.encryptedPreMasterSecret, 1, 2)
+ elif self.version == (3,0):
+ w.addFixSeq(self.encryptedPreMasterSecret, 1)
+ else:
+ raise AssertionError()
+ else:
+ raise AssertionError()
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class CertificateVerify(HandshakeMsg):
+ def __init__(self):
+ self.contentType = ContentType.handshake
+ self.signature = createByteArraySequence([])
+
+ def create(self, signature):
+ self.signature = signature
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ self.signature = p.getVarBytes(2)
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.certificate_verify,
+ trial)
+ w.addVarSeq(self.signature, 1, 2)
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class ChangeCipherSpec(Msg):
+ def __init__(self):
+ self.contentType = ContentType.change_cipher_spec
+ self.type = 1
+
+ def create(self):
+ self.type = 1
+ return self
+
+ def parse(self, p):
+ p.setLengthCheck(1)
+ self.type = p.get(1)
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = Msg.preWrite(self, trial)
+ w.add(self.type,1)
+ return Msg.postWrite(self, w, trial)
+
+
+class Finished(HandshakeMsg):
+ def __init__(self, version):
+ self.contentType = ContentType.handshake
+ self.version = version
+ self.verify_data = createByteArraySequence([])
+
+ def create(self, verify_data):
+ self.verify_data = verify_data
+ return self
+
+ def parse(self, p):
+ p.startLengthCheck(3)
+ if self.version == (3,0):
+ self.verify_data = p.getFixBytes(36)
+ elif self.version in ((3,1), (3,2)):
+ self.verify_data = p.getFixBytes(12)
+ else:
+ raise AssertionError()
+ p.stopLengthCheck()
+ return self
+
+ def write(self, trial=False):
+ w = HandshakeMsg.preWrite(self, HandshakeType.finished, trial)
+ w.addFixSeq(self.verify_data, 1)
+ return HandshakeMsg.postWrite(self, w, trial)
+
+class ApplicationData(Msg):
+ def __init__(self):
+ self.contentType = ContentType.application_data
+ self.bytes = createByteArraySequence([])
+
+ def create(self, bytes):
+ self.bytes = bytes
+ return self
+
+ def parse(self, p):
+ self.bytes = p.bytes
+ return self
+
+ def write(self):
+ return self.bytes
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/AES.py b/src/gdata/tlslite/utils/AES.py
new file mode 100755
index 0000000..8413f4c
--- /dev/null
+++ b/src/gdata/tlslite/utils/AES.py
@@ -0,0 +1,31 @@
+"""Abstract class for AES."""
+
+class AES:
+ def __init__(self, key, mode, IV, implementation):
+ if len(key) not in (16, 24, 32):
+ raise AssertionError()
+ if mode != 2:
+ raise AssertionError()
+ if len(IV) != 16:
+ raise AssertionError()
+ self.isBlockCipher = True
+ self.block_size = 16
+ self.implementation = implementation
+ if len(key)==16:
+ self.name = "aes128"
+ elif len(key)==24:
+ self.name = "aes192"
+ elif len(key)==32:
+ self.name = "aes256"
+ else:
+ raise AssertionError()
+
+ #CBC-Mode encryption, returns ciphertext
+ #WARNING: *MAY* modify the input as well
+ def encrypt(self, plaintext):
+ assert(len(plaintext) % 16 == 0)
+
+ #CBC-Mode decryption, returns plaintext
+ #WARNING: *MAY* modify the input as well
+ def decrypt(self, ciphertext):
+ assert(len(ciphertext) % 16 == 0)
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/ASN1Parser.py b/src/gdata/tlslite/utils/ASN1Parser.py
new file mode 100755
index 0000000..16b50f2
--- /dev/null
+++ b/src/gdata/tlslite/utils/ASN1Parser.py
@@ -0,0 +1,34 @@
+"""Class for parsing ASN.1"""
+from compat import *
+from codec import *
+
+#Takes a byte array which has a DER TLV field at its head
+class ASN1Parser:
+ def __init__(self, bytes):
+ p = Parser(bytes)
+ p.get(1) #skip Type
+
+ #Get Length
+ self.length = self._getASN1Length(p)
+
+ #Get Value
+ self.value = p.getFixBytes(self.length)
+
+ #Assuming this is a sequence...
+ def getChild(self, which):
+ p = Parser(self.value)
+ for x in range(which+1):
+ markIndex = p.index
+ p.get(1) #skip Type
+ length = self._getASN1Length(p)
+ p.getFixBytes(length)
+ return ASN1Parser(p.bytes[markIndex : p.index])
+
+ #Decode the ASN.1 DER length field
+ def _getASN1Length(self, p):
+ firstLength = p.get(1)
+ if firstLength<=127:
+ return firstLength
+ else:
+ lengthLength = firstLength & 0x7F
+ return p.get(lengthLength)
diff --git a/src/gdata/tlslite/utils/Cryptlib_AES.py b/src/gdata/tlslite/utils/Cryptlib_AES.py
new file mode 100755
index 0000000..9e101fc
--- /dev/null
+++ b/src/gdata/tlslite/utils/Cryptlib_AES.py
@@ -0,0 +1,34 @@
+"""Cryptlib AES implementation."""
+
+from cryptomath import *
+from AES import *
+
+if cryptlibpyLoaded:
+
+ def new(key, mode, IV):
+ return Cryptlib_AES(key, mode, IV)
+
+ class Cryptlib_AES(AES):
+
+ def __init__(self, key, mode, IV):
+ AES.__init__(self, key, mode, IV, "cryptlib")
+ self.context = cryptlib_py.cryptCreateContext(cryptlib_py.CRYPT_UNUSED, cryptlib_py.CRYPT_ALGO_AES)
+ cryptlib_py.cryptSetAttribute(self.context, cryptlib_py.CRYPT_CTXINFO_MODE, cryptlib_py.CRYPT_MODE_CBC)
+ cryptlib_py.cryptSetAttribute(self.context, cryptlib_py.CRYPT_CTXINFO_KEYSIZE, len(key))
+ cryptlib_py.cryptSetAttributeString(self.context, cryptlib_py.CRYPT_CTXINFO_KEY, key)
+ cryptlib_py.cryptSetAttributeString(self.context, cryptlib_py.CRYPT_CTXINFO_IV, IV)
+
+ def __del__(self):
+ cryptlib_py.cryptDestroyContext(self.context)
+
+ def encrypt(self, plaintext):
+ AES.encrypt(self, plaintext)
+ bytes = stringToBytes(plaintext)
+ cryptlib_py.cryptEncrypt(self.context, bytes)
+ return bytesToString(bytes)
+
+ def decrypt(self, ciphertext):
+ AES.decrypt(self, ciphertext)
+ bytes = stringToBytes(ciphertext)
+ cryptlib_py.cryptDecrypt(self.context, bytes)
+ return bytesToString(bytes)
diff --git a/src/gdata/tlslite/utils/Cryptlib_RC4.py b/src/gdata/tlslite/utils/Cryptlib_RC4.py
new file mode 100755
index 0000000..7c6d087
--- /dev/null
+++ b/src/gdata/tlslite/utils/Cryptlib_RC4.py
@@ -0,0 +1,28 @@
+"""Cryptlib RC4 implementation."""
+
+from cryptomath import *
+from RC4 import RC4
+
+if cryptlibpyLoaded:
+
+ def new(key):
+ return Cryptlib_RC4(key)
+
+ class Cryptlib_RC4(RC4):
+
+ def __init__(self, key):
+ RC4.__init__(self, key, "cryptlib")
+ self.context = cryptlib_py.cryptCreateContext(cryptlib_py.CRYPT_UNUSED, cryptlib_py.CRYPT_ALGO_RC4)
+ cryptlib_py.cryptSetAttribute(self.context, cryptlib_py.CRYPT_CTXINFO_KEYSIZE, len(key))
+ cryptlib_py.cryptSetAttributeString(self.context, cryptlib_py.CRYPT_CTXINFO_KEY, key)
+
+ def __del__(self):
+ cryptlib_py.cryptDestroyContext(self.context)
+
+ def encrypt(self, plaintext):
+ bytes = stringToBytes(plaintext)
+ cryptlib_py.cryptEncrypt(self.context, bytes)
+ return bytesToString(bytes)
+
+ def decrypt(self, ciphertext):
+ return self.encrypt(ciphertext)
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/Cryptlib_TripleDES.py b/src/gdata/tlslite/utils/Cryptlib_TripleDES.py
new file mode 100755
index 0000000..a4f8155
--- /dev/null
+++ b/src/gdata/tlslite/utils/Cryptlib_TripleDES.py
@@ -0,0 +1,35 @@
+"""Cryptlib 3DES implementation."""
+
+from cryptomath import *
+
+from TripleDES import *
+
+if cryptlibpyLoaded:
+
+ def new(key, mode, IV):
+ return Cryptlib_TripleDES(key, mode, IV)
+
+ class Cryptlib_TripleDES(TripleDES):
+
+ def __init__(self, key, mode, IV):
+ TripleDES.__init__(self, key, mode, IV, "cryptlib")
+ self.context = cryptlib_py.cryptCreateContext(cryptlib_py.CRYPT_UNUSED, cryptlib_py.CRYPT_ALGO_3DES)
+ cryptlib_py.cryptSetAttribute(self.context, cryptlib_py.CRYPT_CTXINFO_MODE, cryptlib_py.CRYPT_MODE_CBC)
+ cryptlib_py.cryptSetAttribute(self.context, cryptlib_py.CRYPT_CTXINFO_KEYSIZE, len(key))
+ cryptlib_py.cryptSetAttributeString(self.context, cryptlib_py.CRYPT_CTXINFO_KEY, key)
+ cryptlib_py.cryptSetAttributeString(self.context, cryptlib_py.CRYPT_CTXINFO_IV, IV)
+
+ def __del__(self):
+ cryptlib_py.cryptDestroyContext(self.context)
+
+ def encrypt(self, plaintext):
+ TripleDES.encrypt(self, plaintext)
+ bytes = stringToBytes(plaintext)
+ cryptlib_py.cryptEncrypt(self.context, bytes)
+ return bytesToString(bytes)
+
+ def decrypt(self, ciphertext):
+ TripleDES.decrypt(self, ciphertext)
+ bytes = stringToBytes(ciphertext)
+ cryptlib_py.cryptDecrypt(self.context, bytes)
+ return bytesToString(bytes)
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/OpenSSL_AES.py b/src/gdata/tlslite/utils/OpenSSL_AES.py
new file mode 100755
index 0000000..e60679b
--- /dev/null
+++ b/src/gdata/tlslite/utils/OpenSSL_AES.py
@@ -0,0 +1,49 @@
+"""OpenSSL/M2Crypto AES implementation."""
+
+from cryptomath import *
+from AES import *
+
+if m2cryptoLoaded:
+
+ def new(key, mode, IV):
+ return OpenSSL_AES(key, mode, IV)
+
+ class OpenSSL_AES(AES):
+
+ def __init__(self, key, mode, IV):
+ AES.__init__(self, key, mode, IV, "openssl")
+ self.key = key
+ self.IV = IV
+
+ def _createContext(self, encrypt):
+ context = m2.cipher_ctx_new()
+ if len(self.key)==16:
+ cipherType = m2.aes_128_cbc()
+ if len(self.key)==24:
+ cipherType = m2.aes_192_cbc()
+ if len(self.key)==32:
+ cipherType = m2.aes_256_cbc()
+ m2.cipher_init(context, cipherType, self.key, self.IV, encrypt)
+ return context
+
+ def encrypt(self, plaintext):
+ AES.encrypt(self, plaintext)
+ context = self._createContext(1)
+ ciphertext = m2.cipher_update(context, plaintext)
+ m2.cipher_ctx_free(context)
+ self.IV = ciphertext[-self.block_size:]
+ return ciphertext
+
+ def decrypt(self, ciphertext):
+ AES.decrypt(self, ciphertext)
+ context = self._createContext(0)
+ #I think M2Crypto has a bug - it fails to decrypt and return the last block passed in.
+ #To work around this, we append sixteen zeros to the string, below:
+ plaintext = m2.cipher_update(context, ciphertext+('\0'*16))
+
+ #If this bug is ever fixed, then plaintext will end up having a garbage
+ #plaintext block on the end. That's okay - the below code will discard it.
+ plaintext = plaintext[:len(ciphertext)]
+ m2.cipher_ctx_free(context)
+ self.IV = ciphertext[-self.block_size:]
+ return plaintext
diff --git a/src/gdata/tlslite/utils/OpenSSL_RC4.py b/src/gdata/tlslite/utils/OpenSSL_RC4.py
new file mode 100755
index 0000000..ac433aa
--- /dev/null
+++ b/src/gdata/tlslite/utils/OpenSSL_RC4.py
@@ -0,0 +1,25 @@
+"""OpenSSL/M2Crypto RC4 implementation."""
+
+from cryptomath import *
+from RC4 import RC4
+
+if m2cryptoLoaded:
+
+ def new(key):
+ return OpenSSL_RC4(key)
+
+ class OpenSSL_RC4(RC4):
+
+ def __init__(self, key):
+ RC4.__init__(self, key, "openssl")
+ self.rc4 = m2.rc4_new()
+ m2.rc4_set_key(self.rc4, key)
+
+ def __del__(self):
+ m2.rc4_free(self.rc4)
+
+ def encrypt(self, plaintext):
+ return m2.rc4_update(self.rc4, plaintext)
+
+ def decrypt(self, ciphertext):
+ return self.encrypt(ciphertext)
diff --git a/src/gdata/tlslite/utils/OpenSSL_RSAKey.py b/src/gdata/tlslite/utils/OpenSSL_RSAKey.py
new file mode 100755
index 0000000..fe1a3cd
--- /dev/null
+++ b/src/gdata/tlslite/utils/OpenSSL_RSAKey.py
@@ -0,0 +1,148 @@
+"""OpenSSL/M2Crypto RSA implementation."""
+
+from cryptomath import *
+
+from RSAKey import *
+from Python_RSAKey import Python_RSAKey
+
+#copied from M2Crypto.util.py, so when we load the local copy of m2
+#we can still use it
+def password_callback(v, prompt1='Enter private key passphrase:',
+ prompt2='Verify passphrase:'):
+ from getpass import getpass
+ while 1:
+ try:
+ p1=getpass(prompt1)
+ if v:
+ p2=getpass(prompt2)
+ if p1==p2:
+ break
+ else:
+ break
+ except KeyboardInterrupt:
+ return None
+ return p1
+
+
+if m2cryptoLoaded:
+ class OpenSSL_RSAKey(RSAKey):
+ def __init__(self, n=0, e=0):
+ self.rsa = None
+ self._hasPrivateKey = False
+ if (n and not e) or (e and not n):
+ raise AssertionError()
+ if n and e:
+ self.rsa = m2.rsa_new()
+ m2.rsa_set_n(self.rsa, numberToMPI(n))
+ m2.rsa_set_e(self.rsa, numberToMPI(e))
+
+ def __del__(self):
+ if self.rsa:
+ m2.rsa_free(self.rsa)
+
+ def __getattr__(self, name):
+ if name == 'e':
+ if not self.rsa:
+ return 0
+ return mpiToNumber(m2.rsa_get_e(self.rsa))
+ elif name == 'n':
+ if not self.rsa:
+ return 0
+ return mpiToNumber(m2.rsa_get_n(self.rsa))
+ else:
+ raise AttributeError
+
+ def hasPrivateKey(self):
+ return self._hasPrivateKey
+
+ def hash(self):
+ return Python_RSAKey(self.n, self.e).hash()
+
+ def _rawPrivateKeyOp(self, m):
+ s = numberToString(m)
+ byteLength = numBytes(self.n)
+ if len(s)== byteLength:
+ pass
+ elif len(s) == byteLength-1:
+ s = '\0' + s
+ else:
+ raise AssertionError()
+ c = stringToNumber(m2.rsa_private_encrypt(self.rsa, s,
+ m2.no_padding))
+ return c
+
+ def _rawPublicKeyOp(self, c):
+ s = numberToString(c)
+ byteLength = numBytes(self.n)
+ if len(s)== byteLength:
+ pass
+ elif len(s) == byteLength-1:
+ s = '\0' + s
+ else:
+ raise AssertionError()
+ m = stringToNumber(m2.rsa_public_decrypt(self.rsa, s,
+ m2.no_padding))
+ return m
+
+ def acceptsPassword(self): return True
+
+ def write(self, password=None):
+ bio = m2.bio_new(m2.bio_s_mem())
+ if self._hasPrivateKey:
+ if password:
+ def f(v): return password
+ m2.rsa_write_key(self.rsa, bio, m2.des_ede_cbc(), f)
+ else:
+ def f(): pass
+ m2.rsa_write_key_no_cipher(self.rsa, bio, f)
+ else:
+ if password:
+ raise AssertionError()
+ m2.rsa_write_pub_key(self.rsa, bio)
+ s = m2.bio_read(bio, m2.bio_ctrl_pending(bio))
+ m2.bio_free(bio)
+ return s
+
+ def writeXMLPublicKey(self, indent=''):
+ return Python_RSAKey(self.n, self.e).write(indent)
+
+ def generate(bits):
+ key = OpenSSL_RSAKey()
+ def f():pass
+ key.rsa = m2.rsa_generate_key(bits, 3, f)
+ key._hasPrivateKey = True
+ return key
+ generate = staticmethod(generate)
+
+ def parse(s, passwordCallback=None):
+ if s.startswith("-----BEGIN "):
+ if passwordCallback==None:
+ callback = password_callback
+ else:
+ def f(v, prompt1=None, prompt2=None):
+ return passwordCallback()
+ callback = f
+ bio = m2.bio_new(m2.bio_s_mem())
+ try:
+ m2.bio_write(bio, s)
+ key = OpenSSL_RSAKey()
+ if s.startswith("-----BEGIN RSA PRIVATE KEY-----"):
+ def f():pass
+ key.rsa = m2.rsa_read_key(bio, callback)
+ if key.rsa == None:
+ raise SyntaxError()
+ key._hasPrivateKey = True
+ elif s.startswith("-----BEGIN PUBLIC KEY-----"):
+ key.rsa = m2.rsa_read_pub_key(bio)
+ if key.rsa == None:
+ raise SyntaxError()
+ key._hasPrivateKey = False
+ else:
+ raise SyntaxError()
+ return key
+ finally:
+ m2.bio_free(bio)
+ else:
+ raise SyntaxError()
+
+ parse = staticmethod(parse)
diff --git a/src/gdata/tlslite/utils/OpenSSL_TripleDES.py b/src/gdata/tlslite/utils/OpenSSL_TripleDES.py
new file mode 100755
index 0000000..f5ba165
--- /dev/null
+++ b/src/gdata/tlslite/utils/OpenSSL_TripleDES.py
@@ -0,0 +1,44 @@
+"""OpenSSL/M2Crypto 3DES implementation."""
+
+from cryptomath import *
+from TripleDES import *
+
+if m2cryptoLoaded:
+
+ def new(key, mode, IV):
+ return OpenSSL_TripleDES(key, mode, IV)
+
+ class OpenSSL_TripleDES(TripleDES):
+
+ def __init__(self, key, mode, IV):
+ TripleDES.__init__(self, key, mode, IV, "openssl")
+ self.key = key
+ self.IV = IV
+
+ def _createContext(self, encrypt):
+ context = m2.cipher_ctx_new()
+ cipherType = m2.des_ede3_cbc()
+ m2.cipher_init(context, cipherType, self.key, self.IV, encrypt)
+ return context
+
+ def encrypt(self, plaintext):
+ TripleDES.encrypt(self, plaintext)
+ context = self._createContext(1)
+ ciphertext = m2.cipher_update(context, plaintext)
+ m2.cipher_ctx_free(context)
+ self.IV = ciphertext[-self.block_size:]
+ return ciphertext
+
+ def decrypt(self, ciphertext):
+ TripleDES.decrypt(self, ciphertext)
+ context = self._createContext(0)
+ #I think M2Crypto has a bug - it fails to decrypt and return the last block passed in.
+ #To work around this, we append sixteen zeros to the string, below:
+ plaintext = m2.cipher_update(context, ciphertext+('\0'*16))
+
+ #If this bug is ever fixed, then plaintext will end up having a garbage
+ #plaintext block on the end. That's okay - the below code will ignore it.
+ plaintext = plaintext[:len(ciphertext)]
+ m2.cipher_ctx_free(context)
+ self.IV = ciphertext[-self.block_size:]
+ return plaintext
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/PyCrypto_AES.py b/src/gdata/tlslite/utils/PyCrypto_AES.py
new file mode 100755
index 0000000..e38b19d
--- /dev/null
+++ b/src/gdata/tlslite/utils/PyCrypto_AES.py
@@ -0,0 +1,22 @@
+"""PyCrypto AES implementation."""
+
+from cryptomath import *
+from AES import *
+
+if pycryptoLoaded:
+ import Crypto.Cipher.AES
+
+ def new(key, mode, IV):
+ return PyCrypto_AES(key, mode, IV)
+
+ class PyCrypto_AES(AES):
+
+ def __init__(self, key, mode, IV):
+ AES.__init__(self, key, mode, IV, "pycrypto")
+ self.context = Crypto.Cipher.AES.new(key, mode, IV)
+
+ def encrypt(self, plaintext):
+ return self.context.encrypt(plaintext)
+
+ def decrypt(self, ciphertext):
+ return self.context.decrypt(ciphertext)
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/PyCrypto_RC4.py b/src/gdata/tlslite/utils/PyCrypto_RC4.py
new file mode 100755
index 0000000..6c6d86a
--- /dev/null
+++ b/src/gdata/tlslite/utils/PyCrypto_RC4.py
@@ -0,0 +1,22 @@
+"""PyCrypto RC4 implementation."""
+
+from cryptomath import *
+from RC4 import *
+
+if pycryptoLoaded:
+ import Crypto.Cipher.ARC4
+
+ def new(key):
+ return PyCrypto_RC4(key)
+
+ class PyCrypto_RC4(RC4):
+
+ def __init__(self, key):
+ RC4.__init__(self, key, "pycrypto")
+ self.context = Crypto.Cipher.ARC4.new(key)
+
+ def encrypt(self, plaintext):
+ return self.context.encrypt(plaintext)
+
+ def decrypt(self, ciphertext):
+ return self.context.decrypt(ciphertext)
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/PyCrypto_RSAKey.py b/src/gdata/tlslite/utils/PyCrypto_RSAKey.py
new file mode 100755
index 0000000..48b5cef
--- /dev/null
+++ b/src/gdata/tlslite/utils/PyCrypto_RSAKey.py
@@ -0,0 +1,61 @@
+"""PyCrypto RSA implementation."""
+
+from cryptomath import *
+
+from RSAKey import *
+from Python_RSAKey import Python_RSAKey
+
+if pycryptoLoaded:
+
+ from Crypto.PublicKey import RSA
+
+ class PyCrypto_RSAKey(RSAKey):
+ def __init__(self, n=0, e=0, d=0, p=0, q=0, dP=0, dQ=0, qInv=0):
+ if not d:
+ self.rsa = RSA.construct( (n, e) )
+ else:
+ self.rsa = RSA.construct( (n, e, d, p, q) )
+
+ def __getattr__(self, name):
+ return getattr(self.rsa, name)
+
+ def hasPrivateKey(self):
+ return self.rsa.has_private()
+
+ def hash(self):
+ return Python_RSAKey(self.n, self.e).hash()
+
+ def _rawPrivateKeyOp(self, m):
+ s = numberToString(m)
+ byteLength = numBytes(self.n)
+ if len(s)== byteLength:
+ pass
+ elif len(s) == byteLength-1:
+ s = '\0' + s
+ else:
+ raise AssertionError()
+ c = stringToNumber(self.rsa.decrypt((s,)))
+ return c
+
+ def _rawPublicKeyOp(self, c):
+ s = numberToString(c)
+ byteLength = numBytes(self.n)
+ if len(s)== byteLength:
+ pass
+ elif len(s) == byteLength-1:
+ s = '\0' + s
+ else:
+ raise AssertionError()
+ m = stringToNumber(self.rsa.encrypt(s, None)[0])
+ return m
+
+ def writeXMLPublicKey(self, indent=''):
+ return Python_RSAKey(self.n, self.e).write(indent)
+
+ def generate(bits):
+ key = PyCrypto_RSAKey()
+ def f(numBytes):
+ return bytesToString(getRandomBytes(numBytes))
+ key.rsa = RSA.generate(bits, f)
+ return key
+ generate = staticmethod(generate)
diff --git a/src/gdata/tlslite/utils/PyCrypto_TripleDES.py b/src/gdata/tlslite/utils/PyCrypto_TripleDES.py
new file mode 100755
index 0000000..8c22bb8
--- /dev/null
+++ b/src/gdata/tlslite/utils/PyCrypto_TripleDES.py
@@ -0,0 +1,22 @@
+"""PyCrypto 3DES implementation."""
+
+from cryptomath import *
+from TripleDES import *
+
+if pycryptoLoaded:
+ import Crypto.Cipher.DES3
+
+ def new(key, mode, IV):
+ return PyCrypto_TripleDES(key, mode, IV)
+
+ class PyCrypto_TripleDES(TripleDES):
+
+ def __init__(self, key, mode, IV):
+ TripleDES.__init__(self, key, mode, IV, "pycrypto")
+ self.context = Crypto.Cipher.DES3.new(key, mode, IV)
+
+ def encrypt(self, plaintext):
+ return self.context.encrypt(plaintext)
+
+ def decrypt(self, ciphertext):
+ return self.context.decrypt(ciphertext)
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/Python_AES.py b/src/gdata/tlslite/utils/Python_AES.py
new file mode 100755
index 0000000..657152f
--- /dev/null
+++ b/src/gdata/tlslite/utils/Python_AES.py
@@ -0,0 +1,68 @@
+"""Pure-Python AES implementation."""
+
+from cryptomath import *
+
+from AES import *
+from rijndael import rijndael
+
+def new(key, mode, IV):
+ return Python_AES(key, mode, IV)
+
+class Python_AES(AES):
+ def __init__(self, key, mode, IV):
+ AES.__init__(self, key, mode, IV, "python")
+ self.rijndael = rijndael(key, 16)
+ self.IV = IV
+
+ def encrypt(self, plaintext):
+ AES.encrypt(self, plaintext)
+
+ plaintextBytes = stringToBytes(plaintext)
+ chainBytes = stringToBytes(self.IV)
+
+ #CBC Mode: For each block...
+ for x in range(len(plaintextBytes)/16):
+
+ #XOR with the chaining block
+ blockBytes = plaintextBytes[x*16 : (x*16)+16]
+ for y in range(16):
+ blockBytes[y] ^= chainBytes[y]
+ blockString = bytesToString(blockBytes)
+
+ #Encrypt it
+ encryptedBytes = stringToBytes(self.rijndael.encrypt(blockString))
+
+ #Overwrite the input with the output
+ for y in range(16):
+ plaintextBytes[(x*16)+y] = encryptedBytes[y]
+
+ #Set the next chaining block
+ chainBytes = encryptedBytes
+
+ self.IV = bytesToString(chainBytes)
+ return bytesToString(plaintextBytes)
+
+ def decrypt(self, ciphertext):
+ AES.decrypt(self, ciphertext)
+
+ ciphertextBytes = stringToBytes(ciphertext)
+ chainBytes = stringToBytes(self.IV)
+
+ #CBC Mode: For each block...
+ for x in range(len(ciphertextBytes)/16):
+
+ #Decrypt it
+ blockBytes = ciphertextBytes[x*16 : (x*16)+16]
+ blockString = bytesToString(blockBytes)
+ decryptedBytes = stringToBytes(self.rijndael.decrypt(blockString))
+
+ #XOR with the chaining block and overwrite the input with output
+ for y in range(16):
+ decryptedBytes[y] ^= chainBytes[y]
+ ciphertextBytes[(x*16)+y] = decryptedBytes[y]
+
+ #Set the next chaining block
+ chainBytes = blockBytes
+
+ self.IV = bytesToString(chainBytes)
+ return bytesToString(ciphertextBytes)
diff --git a/src/gdata/tlslite/utils/Python_RC4.py b/src/gdata/tlslite/utils/Python_RC4.py
new file mode 100755
index 0000000..56ce5fb
--- /dev/null
+++ b/src/gdata/tlslite/utils/Python_RC4.py
@@ -0,0 +1,39 @@
+"""Pure-Python RC4 implementation."""
+
+from RC4 import RC4
+from cryptomath import *
+
+def new(key):
+ return Python_RC4(key)
+
+class Python_RC4(RC4):
+ def __init__(self, key):
+ RC4.__init__(self, key, "python")
+ keyBytes = stringToBytes(key)
+ S = [i for i in range(256)]
+ j = 0
+ for i in range(256):
+ j = (j + S[i] + keyBytes[i % len(keyBytes)]) % 256
+ S[i], S[j] = S[j], S[i]
+
+ self.S = S
+ self.i = 0
+ self.j = 0
+
+ def encrypt(self, plaintext):
+ plaintextBytes = stringToBytes(plaintext)
+ S = self.S
+ i = self.i
+ j = self.j
+ for x in range(len(plaintextBytes)):
+ i = (i + 1) % 256
+ j = (j + S[i]) % 256
+ S[i], S[j] = S[j], S[i]
+ t = (S[i] + S[j]) % 256
+ plaintextBytes[x] ^= S[t]
+ self.i = i
+ self.j = j
+ return bytesToString(plaintextBytes)
+
+ def decrypt(self, ciphertext):
+ return self.encrypt(ciphertext)
diff --git a/src/gdata/tlslite/utils/Python_RSAKey.py b/src/gdata/tlslite/utils/Python_RSAKey.py
new file mode 100755
index 0000000..2c469b5
--- /dev/null
+++ b/src/gdata/tlslite/utils/Python_RSAKey.py
@@ -0,0 +1,209 @@
+"""Pure-Python RSA implementation."""
+
+from cryptomath import *
+import xmltools
+from ASN1Parser import ASN1Parser
+from RSAKey import *
+
+class Python_RSAKey(RSAKey):
+ def __init__(self, n=0, e=0, d=0, p=0, q=0, dP=0, dQ=0, qInv=0):
+ if (n and not e) or (e and not n):
+ raise AssertionError()
+ self.n = n
+ self.e = e
+ self.d = d
+ self.p = p
+ self.q = q
+ self.dP = dP
+ self.dQ = dQ
+ self.qInv = qInv
+ self.blinder = 0
+ self.unblinder = 0
+
+ def hasPrivateKey(self):
+ return self.d != 0
+
+ def hash(self):
+ s = self.writeXMLPublicKey('\t\t')
+ return hashAndBase64(s.strip())
+
+ def _rawPrivateKeyOp(self, m):
+ #Create blinding values, on the first pass:
+ if not self.blinder:
+ self.unblinder = getRandomNumber(2, self.n)
+ self.blinder = powMod(invMod(self.unblinder, self.n), self.e,
+ self.n)
+
+ #Blind the input
+ m = (m * self.blinder) % self.n
+
+ #Perform the RSA operation
+ c = self._rawPrivateKeyOpHelper(m)
+
+ #Unblind the output
+ c = (c * self.unblinder) % self.n
+
+ #Update blinding values
+ self.blinder = (self.blinder * self.blinder) % self.n
+ self.unblinder = (self.unblinder * self.unblinder) % self.n
+
+ #Return the output
+ return c
+
+
+ def _rawPrivateKeyOpHelper(self, m):
+ #Non-CRT version
+ #c = powMod(m, self.d, self.n)
+
+ #CRT version (~3x faster)
+ s1 = powMod(m, self.dP, self.p)
+ s2 = powMod(m, self.dQ, self.q)
+ h = ((s1 - s2) * self.qInv) % self.p
+ c = s2 + self.q * h
+ return c
+
+ def _rawPublicKeyOp(self, c):
+ m = powMod(c, self.e, self.n)
+ return m
+
+ def acceptsPassword(self): return False
+
+ def write(self, indent=''):
+ if self.d:
+ s = indent+'<privateKey xmlns="http://trevp.net/rsa">\n'
+ else:
+ s = indent+'<publicKey xmlns="http://trevp.net/rsa">\n'
+ s += indent+'\t<n>%s</n>\n' % numberToBase64(self.n)
+ s += indent+'\t<e>%s</e>\n' % numberToBase64(self.e)
+ if self.d:
+ s += indent+'\t<d>%s</d>\n' % numberToBase64(self.d)
+ s += indent+'\t<p>%s</p>\n' % numberToBase64(self.p)
+ s += indent+'\t<q>%s</q>\n' % numberToBase64(self.q)
+ s += indent+'\t<dP>%s</dP>\n' % numberToBase64(self.dP)
+ s += indent+'\t<dQ>%s</dQ>\n' % numberToBase64(self.dQ)
+ s += indent+'\t<qInv>%s</qInv>\n' % numberToBase64(self.qInv)
+ s += indent+'</privateKey>'
+ else:
+ s += indent+'</publicKey>'
+ #Only add \n if part of a larger structure
+ if indent != '':
+ s += '\n'
+ return s
+
+ def writeXMLPublicKey(self, indent=''):
+ return Python_RSAKey(self.n, self.e).write(indent)
+
+ def generate(bits):
+ key = Python_RSAKey()
+ p = getRandomPrime(bits/2, False)
+ q = getRandomPrime(bits/2, False)
+ t = lcm(p-1, q-1)
+ key.n = p * q
+ key.e = 3L #Needed to be long, for Java
+ key.d = invMod(key.e, t)
+ key.p = p
+ key.q = q
+ key.dP = key.d % (p-1)
+ key.dQ = key.d % (q-1)
+ key.qInv = invMod(q, p)
+ return key
+ generate = staticmethod(generate)
+
+ def parsePEM(s, passwordCallback=None):
+ """Parse a string containing a <privateKey> or <publicKey>, or
+ PEM-encoded key."""
+
+ start = s.find("-----BEGIN PRIVATE KEY-----")
+ if start != -1:
+ end = s.find("-----END PRIVATE KEY-----")
+ if end == -1:
+ raise SyntaxError("Missing PEM Postfix")
+ s = s[start+len("-----BEGIN PRIVATE KEY -----") : end]
+ bytes = base64ToBytes(s)
+ return Python_RSAKey._parsePKCS8(bytes)
+ else:
+ start = s.find("-----BEGIN RSA PRIVATE KEY-----")
+ if start != -1:
+ end = s.find("-----END RSA PRIVATE KEY-----")
+ if end == -1:
+ raise SyntaxError("Missing PEM Postfix")
+ s = s[start+len("-----BEGIN RSA PRIVATE KEY -----") : end]
+ bytes = base64ToBytes(s)
+ return Python_RSAKey._parseSSLeay(bytes)
+ raise SyntaxError("Missing PEM Prefix")
+ parsePEM = staticmethod(parsePEM)
+
+ def parseXML(s):
+ element = xmltools.parseAndStripWhitespace(s)
+ return Python_RSAKey._parseXML(element)
+ parseXML = staticmethod(parseXML)
+
+ def _parsePKCS8(bytes):
+ p = ASN1Parser(bytes)
+
+ version = p.getChild(0).value[0]
+ if version != 0:
+ raise SyntaxError("Unrecognized PKCS8 version")
+
+ rsaOID = p.getChild(1).value
+ if list(rsaOID) != [6, 9, 42, 134, 72, 134, 247, 13, 1, 1, 1, 5, 0]:
+ raise SyntaxError("Unrecognized AlgorithmIdentifier")
+
+ #Get the privateKey
+ privateKeyP = p.getChild(2)
+
+ #Adjust for OCTET STRING encapsulation
+ privateKeyP = ASN1Parser(privateKeyP.value)
+
+ return Python_RSAKey._parseASN1PrivateKey(privateKeyP)
+ _parsePKCS8 = staticmethod(_parsePKCS8)
+
+ def _parseSSLeay(bytes):
+ privateKeyP = ASN1Parser(bytes)
+ return Python_RSAKey._parseASN1PrivateKey(privateKeyP)
+ _parseSSLeay = staticmethod(_parseSSLeay)
+
+ def _parseASN1PrivateKey(privateKeyP):
+ version = privateKeyP.getChild(0).value[0]
+ if version != 0:
+ raise SyntaxError("Unrecognized RSAPrivateKey version")
+ n = bytesToNumber(privateKeyP.getChild(1).value)
+ e = bytesToNumber(privateKeyP.getChild(2).value)
+ d = bytesToNumber(privateKeyP.getChild(3).value)
+ p = bytesToNumber(privateKeyP.getChild(4).value)
+ q = bytesToNumber(privateKeyP.getChild(5).value)
+ dP = bytesToNumber(privateKeyP.getChild(6).value)
+ dQ = bytesToNumber(privateKeyP.getChild(7).value)
+ qInv = bytesToNumber(privateKeyP.getChild(8).value)
+ return Python_RSAKey(n, e, d, p, q, dP, dQ, qInv)
+ _parseASN1PrivateKey = staticmethod(_parseASN1PrivateKey)
+
+ def _parseXML(element):
+ try:
+ xmltools.checkName(element, "privateKey")
+ except SyntaxError:
+ xmltools.checkName(element, "publicKey")
+
+ #Parse attributes
+ xmltools.getReqAttribute(element, "xmlns", "http://trevp.net/rsa\Z")
+ xmltools.checkNoMoreAttributes(element)
+
+ #Parse public values (<n> and <e>)
+ n = base64ToNumber(xmltools.getText(xmltools.getChild(element, 0, "n"), xmltools.base64RegEx))
+ e = base64ToNumber(xmltools.getText(xmltools.getChild(element, 1, "e"), xmltools.base64RegEx))
+ d = 0
+ p = 0
+ q = 0
+ dP = 0
+ dQ = 0
+ qInv = 0
+ #Parse private values, if present
+ if element.childNodes.length>=3:
+ d = base64ToNumber(xmltools.getText(xmltools.getChild(element, 2, "d"), xmltools.base64RegEx))
+ p = base64ToNumber(xmltools.getText(xmltools.getChild(element, 3, "p"), xmltools.base64RegEx))
+ q = base64ToNumber(xmltools.getText(xmltools.getChild(element, 4, "q"), xmltools.base64RegEx))
+ dP = base64ToNumber(xmltools.getText(xmltools.getChild(element, 5, "dP"), xmltools.base64RegEx))
+ dQ = base64ToNumber(xmltools.getText(xmltools.getChild(element, 6, "dQ"), xmltools.base64RegEx))
+ qInv = base64ToNumber(xmltools.getText(xmltools.getLastChild(element, 7, "qInv"), xmltools.base64RegEx))
+ return Python_RSAKey(n, e, d, p, q, dP, dQ, qInv)
+ _parseXML = staticmethod(_parseXML)
diff --git a/src/gdata/tlslite/utils/RC4.py b/src/gdata/tlslite/utils/RC4.py
new file mode 100755
index 0000000..5506923
--- /dev/null
+++ b/src/gdata/tlslite/utils/RC4.py
@@ -0,0 +1,17 @@
+"""Abstract class for RC4."""
+
+from compat import * #For False
+
+class RC4:
+ def __init__(self, keyBytes, implementation):
+ if len(keyBytes) < 16 or len(keyBytes) > 256:
+ raise ValueError()
+ self.isBlockCipher = False
+ self.name = "rc4"
+ self.implementation = implementation
+
+ def encrypt(self, plaintext):
+ raise NotImplementedError()
+
+ def decrypt(self, ciphertext):
+ raise NotImplementedError()
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/RSAKey.py b/src/gdata/tlslite/utils/RSAKey.py
new file mode 100755
index 0000000..2f5d286
--- /dev/null
+++ b/src/gdata/tlslite/utils/RSAKey.py
@@ -0,0 +1,264 @@
+"""Abstract class for RSA."""
+
+from cryptomath import *
+
+
+class RSAKey:
+ """This is an abstract base class for RSA keys.
+
+ Particular implementations of RSA keys, such as
+ L{OpenSSL_RSAKey.OpenSSL_RSAKey},
+ L{Python_RSAKey.Python_RSAKey}, and
+ L{PyCrypto_RSAKey.PyCrypto_RSAKey},
+ inherit from this.
+
+ To create or parse an RSA key, don't use one of these classes
+ directly. Instead, use the factory functions in
+ L{tlslite.utils.keyfactory}.
+ """
+
+ def __init__(self, n=0, e=0):
+ """Create a new RSA key.
+
+ If n and e are passed in, the new key will be initialized.
+
+ @type n: int
+ @param n: RSA modulus.
+
+ @type e: int
+ @param e: RSA public exponent.
+ """
+ raise NotImplementedError()
+
+ def __len__(self):
+ """Return the length of this key in bits.
+
+ @rtype: int
+ """
+ return numBits(self.n)
+
+ def hasPrivateKey(self):
+ """Return whether or not this key has a private component.
+
+ @rtype: bool
+ """
+ raise NotImplementedError()
+
+ def hash(self):
+ """Return the cryptoID <keyHash> value corresponding to this
+ key.
+
+ @rtype: str
+ """
+ raise NotImplementedError()
+
+ def getSigningAlgorithm(self):
+ """Return the cryptoID sigAlgo value corresponding to this key.
+
+ @rtype: str
+ """
+ return "pkcs1-sha1"
+
+ def hashAndSign(self, bytes):
+ """Hash and sign the passed-in bytes.
+
+ This requires the key to have a private component. It performs
+ a PKCS1-SHA1 signature on the passed-in data.
+
+ @type bytes: str or L{array.array} of unsigned bytes
+ @param bytes: The value which will be hashed and signed.
+
+ @rtype: L{array.array} of unsigned bytes.
+ @return: A PKCS1-SHA1 signature on the passed-in data.
+ """
+ if not isinstance(bytes, type("")):
+ bytes = bytesToString(bytes)
+ hashBytes = stringToBytes(sha1(bytes).digest())
+ prefixedHashBytes = self._addPKCS1SHA1Prefix(hashBytes)
+ sigBytes = self.sign(prefixedHashBytes)
+ return sigBytes
+
+ def hashAndVerify(self, sigBytes, bytes):
+ """Hash and verify the passed-in bytes with the signature.
+
+ This verifies a PKCS1-SHA1 signature on the passed-in data.
+
+ @type sigBytes: L{array.array} of unsigned bytes
+ @param sigBytes: A PKCS1-SHA1 signature.
+
+ @type bytes: str or L{array.array} of unsigned bytes
+ @param bytes: The value which will be hashed and verified.
+
+ @rtype: bool
+ @return: Whether the signature matches the passed-in data.
+ """
+ if not isinstance(bytes, type("")):
+ bytes = bytesToString(bytes)
+ hashBytes = stringToBytes(sha1(bytes).digest())
+ prefixedHashBytes = self._addPKCS1SHA1Prefix(hashBytes)
+ return self.verify(sigBytes, prefixedHashBytes)
+
+ def sign(self, bytes):
+ """Sign the passed-in bytes.
+
+ This requires the key to have a private component. It performs
+ a PKCS1 signature on the passed-in data.
+
+ @type bytes: L{array.array} of unsigned bytes
+ @param bytes: The value which will be signed.
+
+ @rtype: L{array.array} of unsigned bytes.
+ @return: A PKCS1 signature on the passed-in data.
+ """
+ if not self.hasPrivateKey():
+ raise AssertionError()
+ paddedBytes = self._addPKCS1Padding(bytes, 1)
+ m = bytesToNumber(paddedBytes)
+ if m >= self.n:
+ raise ValueError()
+ c = self._rawPrivateKeyOp(m)
+ sigBytes = numberToBytes(c)
+ return sigBytes
+
+ def verify(self, sigBytes, bytes):
+ """Verify the passed-in bytes with the signature.
+
+ This verifies a PKCS1 signature on the passed-in data.
+
+ @type sigBytes: L{array.array} of unsigned bytes
+ @param sigBytes: A PKCS1 signature.
+
+ @type bytes: L{array.array} of unsigned bytes
+ @param bytes: The value which will be verified.
+
+ @rtype: bool
+ @return: Whether the signature matches the passed-in data.
+ """
+ paddedBytes = self._addPKCS1Padding(bytes, 1)
+ c = bytesToNumber(sigBytes)
+ if c >= self.n:
+ return False
+ m = self._rawPublicKeyOp(c)
+ checkBytes = numberToBytes(m)
+ return checkBytes == paddedBytes
+
+ def encrypt(self, bytes):
+ """Encrypt the passed-in bytes.
+
+ This performs PKCS1 encryption of the passed-in data.
+
+ @type bytes: L{array.array} of unsigned bytes
+ @param bytes: The value which will be encrypted.
+
+ @rtype: L{array.array} of unsigned bytes.
+ @return: A PKCS1 encryption of the passed-in data.
+ """
+ paddedBytes = self._addPKCS1Padding(bytes, 2)
+ m = bytesToNumber(paddedBytes)
+ if m >= self.n:
+ raise ValueError()
+ c = self._rawPublicKeyOp(m)
+ encBytes = numberToBytes(c)
+ return encBytes
+
+ def decrypt(self, encBytes):
+ """Decrypt the passed-in bytes.
+
+ This requires the key to have a private component. It performs
+ PKCS1 decryption of the passed-in data.
+
+ @type encBytes: L{array.array} of unsigned bytes
+ @param encBytes: The value which will be decrypted.
+
+ @rtype: L{array.array} of unsigned bytes or None.
+ @return: A PKCS1 decryption of the passed-in data or None if
+ the data is not properly formatted.
+ """
+ if not self.hasPrivateKey():
+ raise AssertionError()
+ c = bytesToNumber(encBytes)
+ if c >= self.n:
+ return None
+ m = self._rawPrivateKeyOp(c)
+ decBytes = numberToBytes(m)
+ if (len(decBytes) != numBytes(self.n)-1): #Check first byte
+ return None
+ if decBytes[0] != 2: #Check second byte
+ return None
+ for x in range(len(decBytes)-1): #Scan through for zero separator
+ if decBytes[x]== 0:
+ break
+ else:
+ return None
+ return decBytes[x+1:] #Return everything after the separator
+
+ def _rawPrivateKeyOp(self, m):
+ raise NotImplementedError()
+
+ def _rawPublicKeyOp(self, c):
+ raise NotImplementedError()
+
+ def acceptsPassword(self):
+ """Return True if the write() method accepts a password for use
+ in encrypting the private key.
+
+ @rtype: bool
+ """
+ raise NotImplementedError()
+
+ def write(self, password=None):
+ """Return a string containing the key.
+
+ @rtype: str
+ @return: A string describing the key, in whichever format (PEM
+ or XML) is native to the implementation.
+ """
+ raise NotImplementedError()
+
+ def writeXMLPublicKey(self, indent=''):
+ """Return a string containing the key.
+
+ @rtype: str
+ @return: A string describing the public key, in XML format.
+ """
+ return Python_RSAKey(self.n, self.e).write(indent)
+
+ def generate(bits):
+ """Generate a new key with the specified bit length.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ """
+ raise NotImplementedError()
+ generate = staticmethod(generate)
+
+
+ # **************************************************************************
+ # Helper Functions for RSA Keys
+ # **************************************************************************
+
+ def _addPKCS1SHA1Prefix(self, bytes):
+ prefixBytes = createByteArraySequence(\
+ [48,33,48,9,6,5,43,14,3,2,26,5,0,4,20])
+ prefixedBytes = prefixBytes + bytes
+ return prefixedBytes
+
+ def _addPKCS1Padding(self, bytes, blockType):
+ padLength = (numBytes(self.n) - (len(bytes)+3))
+ if blockType == 1: #Signature padding
+ pad = [0xFF] * padLength
+ elif blockType == 2: #Encryption padding
+ pad = createByteArraySequence([])
+ while len(pad) < padLength:
+ padBytes = getRandomBytes(padLength * 2)
+ pad = [b for b in padBytes if b != 0]
+ pad = pad[:padLength]
+ else:
+ raise AssertionError()
+
+ #NOTE: To be proper, we should add [0,blockType]. However,
+ #the zero is lost when the returned padding is converted
+ #to a number, so we don't even bother with it. Also,
+ #adding it would cause a misalignment in verify()
+ padding = createByteArraySequence([blockType] + pad + [0])
+ paddedBytes = padding + bytes
+ return paddedBytes
diff --git a/src/gdata/tlslite/utils/TripleDES.py b/src/gdata/tlslite/utils/TripleDES.py
new file mode 100755
index 0000000..2db4588
--- /dev/null
+++ b/src/gdata/tlslite/utils/TripleDES.py
@@ -0,0 +1,26 @@
+"""Abstract class for 3DES."""
+
+from compat import * #For True
+
+class TripleDES:
+ def __init__(self, key, mode, IV, implementation):
+ if len(key) != 24:
+ raise ValueError()
+ if mode != 2:
+ raise ValueError()
+ if len(IV) != 8:
+ raise ValueError()
+ self.isBlockCipher = True
+ self.block_size = 8
+ self.implementation = implementation
+ self.name = "3des"
+
+ #CBC-Mode encryption, returns ciphertext
+ #WARNING: *MAY* modify the input as well
+ def encrypt(self, plaintext):
+ assert(len(plaintext) % 8 == 0)
+
+ #CBC-Mode decryption, returns plaintext
+ #WARNING: *MAY* modify the input as well
+ def decrypt(self, ciphertext):
+ assert(len(ciphertext) % 8 == 0)
diff --git a/src/gdata/tlslite/utils/__init__.py b/src/gdata/tlslite/utils/__init__.py
new file mode 100755
index 0000000..e96b4be
--- /dev/null
+++ b/src/gdata/tlslite/utils/__init__.py
@@ -0,0 +1,31 @@
+"""Toolkit for crypto and other stuff."""
+
+__all__ = ["AES",
+ "ASN1Parser",
+ "cipherfactory",
+ "codec",
+ "Cryptlib_AES",
+ "Cryptlib_RC4",
+ "Cryptlib_TripleDES",
+ "cryptomath: cryptomath module",
+ "dateFuncs",
+ "hmac",
+ "JCE_RSAKey",
+ "compat",
+ "keyfactory",
+ "OpenSSL_AES",
+ "OpenSSL_RC4",
+ "OpenSSL_RSAKey",
+ "OpenSSL_TripleDES",
+ "PyCrypto_AES",
+ "PyCrypto_RC4",
+ "PyCrypto_RSAKey",
+ "PyCrypto_TripleDES",
+ "Python_AES",
+ "Python_RC4",
+ "Python_RSAKey",
+ "RC4",
+ "rijndael",
+ "RSAKey",
+ "TripleDES",
+ "xmltools"]
diff --git a/src/gdata/tlslite/utils/cipherfactory.py b/src/gdata/tlslite/utils/cipherfactory.py
new file mode 100755
index 0000000..ccbb6b5
--- /dev/null
+++ b/src/gdata/tlslite/utils/cipherfactory.py
@@ -0,0 +1,111 @@
+"""Factory functions for symmetric cryptography."""
+
+import os
+
+import Python_AES
+import Python_RC4
+
+import cryptomath
+
+tripleDESPresent = False
+
+if cryptomath.m2cryptoLoaded:
+ import OpenSSL_AES
+ import OpenSSL_RC4
+ import OpenSSL_TripleDES
+ tripleDESPresent = True
+
+if cryptomath.cryptlibpyLoaded:
+ import Cryptlib_AES
+ import Cryptlib_RC4
+ import Cryptlib_TripleDES
+ tripleDESPresent = True
+
+if cryptomath.pycryptoLoaded:
+ import PyCrypto_AES
+ import PyCrypto_RC4
+ import PyCrypto_TripleDES
+ tripleDESPresent = True
+
+# **************************************************************************
+# Factory Functions for AES
+# **************************************************************************
+
+def createAES(key, IV, implList=None):
+ """Create a new AES object.
+
+ @type key: str
+ @param key: A 16, 24, or 32 byte string.
+
+ @type IV: str
+ @param IV: A 16 byte string
+
+ @rtype: L{tlslite.utils.AES}
+ @return: An AES object.
+ """
+ if implList == None:
+ implList = ["cryptlib", "openssl", "pycrypto", "python"]
+
+ for impl in implList:
+ if impl == "cryptlib" and cryptomath.cryptlibpyLoaded:
+ return Cryptlib_AES.new(key, 2, IV)
+ elif impl == "openssl" and cryptomath.m2cryptoLoaded:
+ return OpenSSL_AES.new(key, 2, IV)
+ elif impl == "pycrypto" and cryptomath.pycryptoLoaded:
+ return PyCrypto_AES.new(key, 2, IV)
+ elif impl == "python":
+ return Python_AES.new(key, 2, IV)
+ raise NotImplementedError()
+
+def createRC4(key, IV, implList=None):
+ """Create a new RC4 object.
+
+ @type key: str
+ @param key: A 16 to 32 byte string.
+
+ @type IV: object
+ @param IV: Ignored, whatever it is.
+
+ @rtype: L{tlslite.utils.RC4}
+ @return: An RC4 object.
+ """
+ if implList == None:
+ implList = ["cryptlib", "openssl", "pycrypto", "python"]
+
+ if len(IV) != 0:
+ raise AssertionError()
+ for impl in implList:
+ if impl == "cryptlib" and cryptomath.cryptlibpyLoaded:
+ return Cryptlib_RC4.new(key)
+ elif impl == "openssl" and cryptomath.m2cryptoLoaded:
+ return OpenSSL_RC4.new(key)
+ elif impl == "pycrypto" and cryptomath.pycryptoLoaded:
+ return PyCrypto_RC4.new(key)
+ elif impl == "python":
+ return Python_RC4.new(key)
+ raise NotImplementedError()
+
+#Create a new TripleDES instance
+def createTripleDES(key, IV, implList=None):
+ """Create a new 3DES object.
+
+ @type key: str
+ @param key: A 24 byte string.
+
+ @type IV: str
+ @param IV: An 8 byte string
+
+ @rtype: L{tlslite.utils.TripleDES}
+ @return: A 3DES object.
+ """
+ if implList == None:
+ implList = ["cryptlib", "openssl", "pycrypto"]
+
+ for impl in implList:
+ if impl == "cryptlib" and cryptomath.cryptlibpyLoaded:
+ return Cryptlib_TripleDES.new(key, 2, IV)
+ elif impl == "openssl" and cryptomath.m2cryptoLoaded:
+ return OpenSSL_TripleDES.new(key, 2, IV)
+ elif impl == "pycrypto" and cryptomath.pycryptoLoaded:
+ return PyCrypto_TripleDES.new(key, 2, IV)
+ raise NotImplementedError()
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/codec.py b/src/gdata/tlslite/utils/codec.py
new file mode 100755
index 0000000..13022a0
--- /dev/null
+++ b/src/gdata/tlslite/utils/codec.py
@@ -0,0 +1,94 @@
+"""Classes for reading/writing binary data (such as TLS records)."""
+
+from compat import *
+
+class Writer:
+ def __init__(self, length=0):
+ #If length is zero, then this is just a "trial run" to determine length
+ self.index = 0
+ self.bytes = createByteArrayZeros(length)
+
+ def add(self, x, length):
+ if self.bytes:
+ newIndex = self.index+length-1
+ while newIndex >= self.index:
+ self.bytes[newIndex] = x & 0xFF
+ x >>= 8
+ newIndex -= 1
+ self.index += length
+
+ def addFixSeq(self, seq, length):
+ if self.bytes:
+ for e in seq:
+ self.add(e, length)
+ else:
+ self.index += len(seq)*length
+
+ def addVarSeq(self, seq, length, lengthLength):
+ if self.bytes:
+ self.add(len(seq)*length, lengthLength)
+ for e in seq:
+ self.add(e, length)
+ else:
+ self.index += lengthLength + (len(seq)*length)
+
+
+class Parser:
+ def __init__(self, bytes):
+ self.bytes = bytes
+ self.index = 0
+
+ def get(self, length):
+ if self.index + length > len(self.bytes):
+ raise SyntaxError()
+ x = 0
+ for count in range(length):
+ x <<= 8
+ x |= self.bytes[self.index]
+ self.index += 1
+ return x
+
+ def getFixBytes(self, lengthBytes):
+ bytes = self.bytes[self.index : self.index+lengthBytes]
+ self.index += lengthBytes
+ return bytes
+
+ def getVarBytes(self, lengthLength):
+ lengthBytes = self.get(lengthLength)
+ return self.getFixBytes(lengthBytes)
+
+ def getFixList(self, length, lengthList):
+ l = [0] * lengthList
+ for x in range(lengthList):
+ l[x] = self.get(length)
+ return l
+
+ def getVarList(self, length, lengthLength):
+ lengthList = self.get(lengthLength)
+ if lengthList % length != 0:
+ raise SyntaxError()
+ lengthList = int(lengthList/length)
+ l = [0] * lengthList
+ for x in range(lengthList):
+ l[x] = self.get(length)
+ return l
+
+ def startLengthCheck(self, lengthLength):
+ self.lengthCheck = self.get(lengthLength)
+ self.indexCheck = self.index
+
+ def setLengthCheck(self, length):
+ self.lengthCheck = length
+ self.indexCheck = self.index
+
+ def stopLengthCheck(self):
+ if (self.index - self.indexCheck) != self.lengthCheck:
+ raise SyntaxError()
+
+ def atLengthCheck(self):
+ if (self.index - self.indexCheck) < self.lengthCheck:
+ return False
+ elif (self.index - self.indexCheck) == self.lengthCheck:
+ return True
+ else:
+ raise SyntaxError()
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/compat.py b/src/gdata/tlslite/utils/compat.py
new file mode 100755
index 0000000..7d2d925
--- /dev/null
+++ b/src/gdata/tlslite/utils/compat.py
@@ -0,0 +1,140 @@
+"""Miscellaneous functions to mask Python version differences."""
+
+import sys
+import os
+
+if sys.version_info < (2,2):
+ raise AssertionError("Python 2.2 or later required")
+
+if sys.version_info < (2,3):
+
+ def enumerate(collection):
+ return zip(range(len(collection)), collection)
+
+ class Set:
+ def __init__(self, seq=None):
+ self.values = {}
+ if seq:
+ for e in seq:
+ self.values[e] = None
+
+ def add(self, e):
+ self.values[e] = None
+
+ def discard(self, e):
+ if e in self.values.keys():
+ del(self.values[e])
+
+ def union(self, s):
+ ret = Set()
+ for e in self.values.keys():
+ ret.values[e] = None
+ for e in s.values.keys():
+ ret.values[e] = None
+ return ret
+
+ def issubset(self, other):
+ for e in self.values.keys():
+ if e not in other.values.keys():
+ return False
+ return True
+
+ def __nonzero__( self):
+ return len(self.values.keys())
+
+ def __contains__(self, e):
+ return e in self.values.keys()
+
+ def __iter__(self):
+ return iter(set.values.keys())
+
+
+if os.name != "java":
+
+ import array
+ def createByteArraySequence(seq):
+ return array.array('B', seq)
+ def createByteArrayZeros(howMany):
+ return array.array('B', [0] * howMany)
+ def concatArrays(a1, a2):
+ return a1+a2
+
+ def bytesToString(bytes):
+ return bytes.tostring()
+ def stringToBytes(s):
+ bytes = createByteArrayZeros(0)
+ bytes.fromstring(s)
+ return bytes
+
+ import math
+ def numBits(n):
+ if n==0:
+ return 0
+ s = "%x" % n
+ return ((len(s)-1)*4) + \
+ {'0':0, '1':1, '2':2, '3':2,
+ '4':3, '5':3, '6':3, '7':3,
+ '8':4, '9':4, 'a':4, 'b':4,
+ 'c':4, 'd':4, 'e':4, 'f':4,
+ }[s[0]]
+ return int(math.floor(math.log(n, 2))+1)
+
+ BaseException = Exception
+ import sys
+ import traceback
+ def formatExceptionTrace(e):
+ newStr = "".join(traceback.format_exception(sys.exc_type, sys.exc_value, sys.exc_traceback))
+ return newStr
+
+else:
+ #Jython 2.1 is missing lots of python 2.3 stuff,
+ #which we have to emulate here:
+ #NOTE: JYTHON SUPPORT NO LONGER WORKS, DUE TO USE OF GENERATORS.
+ #THIS CODE IS LEFT IN SO THAT ONE JYTHON UPDATES TO 2.2, IT HAS A
+ #CHANCE OF WORKING AGAIN.
+
+ import java
+ import jarray
+
+ def createByteArraySequence(seq):
+ if isinstance(seq, type("")): #If it's a string, convert
+ seq = [ord(c) for c in seq]
+ return jarray.array(seq, 'h') #use short instead of bytes, cause bytes are signed
+ def createByteArrayZeros(howMany):
+ return jarray.zeros(howMany, 'h') #use short instead of bytes, cause bytes are signed
+ def concatArrays(a1, a2):
+ l = list(a1)+list(a2)
+ return createByteArraySequence(l)
+
+ #WAY TOO SLOW - MUST BE REPLACED------------
+ def bytesToString(bytes):
+ return "".join([chr(b) for b in bytes])
+
+ def stringToBytes(s):
+ bytes = createByteArrayZeros(len(s))
+ for count, c in enumerate(s):
+ bytes[count] = ord(c)
+ return bytes
+ #WAY TOO SLOW - MUST BE REPLACED------------
+
+ def numBits(n):
+ if n==0:
+ return 0
+ n= 1L * n; #convert to long, if it isn't already
+ return n.__tojava__(java.math.BigInteger).bitLength()
+
+ #Adjust the string to an array of bytes
+ def stringToJavaByteArray(s):
+ bytes = jarray.zeros(len(s), 'b')
+ for count, c in enumerate(s):
+ x = ord(c)
+ if x >= 128: x -= 256
+ bytes[count] = x
+ return bytes
+
+ BaseException = java.lang.Exception
+ import sys
+ import traceback
+ def formatExceptionTrace(e):
+ newStr = "".join(traceback.format_exception(sys.exc_type, sys.exc_value, sys.exc_traceback))
+ return newStr
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/cryptomath.py b/src/gdata/tlslite/utils/cryptomath.py
new file mode 100755
index 0000000..92fb774
--- /dev/null
+++ b/src/gdata/tlslite/utils/cryptomath.py
@@ -0,0 +1,404 @@
+"""cryptomath module
+
+This module has basic math/crypto code."""
+
+import os
+import sys
+import math
+import base64
+import binascii
+if sys.version_info[:2] <= (2, 4):
+ from sha import sha as sha1
+else:
+ from hashlib import sha1
+
+from compat import *
+
+
+# **************************************************************************
+# Load Optional Modules
+# **************************************************************************
+
+# Try to load M2Crypto/OpenSSL
+try:
+ from M2Crypto import m2
+ m2cryptoLoaded = True
+
+except ImportError:
+ m2cryptoLoaded = False
+
+
+# Try to load cryptlib
+try:
+ import cryptlib_py
+ try:
+ cryptlib_py.cryptInit()
+ except cryptlib_py.CryptException, e:
+ #If tlslite and cryptoIDlib are both present,
+ #they might each try to re-initialize this,
+ #so we're tolerant of that.
+ if e[0] != cryptlib_py.CRYPT_ERROR_INITED:
+ raise
+ cryptlibpyLoaded = True
+
+except ImportError:
+ cryptlibpyLoaded = False
+
+#Try to load GMPY
+try:
+ import gmpy
+ gmpyLoaded = True
+except ImportError:
+ gmpyLoaded = False
+
+#Try to load pycrypto
+try:
+ import Crypto.Cipher.AES
+ pycryptoLoaded = True
+except ImportError:
+ pycryptoLoaded = False
+
+
+# **************************************************************************
+# PRNG Functions
+# **************************************************************************
+
+# Get os.urandom PRNG
+try:
+ os.urandom(1)
+ def getRandomBytes(howMany):
+ return stringToBytes(os.urandom(howMany))
+ prngName = "os.urandom"
+
+except:
+ # Else get cryptlib PRNG
+ if cryptlibpyLoaded:
+ def getRandomBytes(howMany):
+ randomKey = cryptlib_py.cryptCreateContext(cryptlib_py.CRYPT_UNUSED,
+ cryptlib_py.CRYPT_ALGO_AES)
+ cryptlib_py.cryptSetAttribute(randomKey,
+ cryptlib_py.CRYPT_CTXINFO_MODE,
+ cryptlib_py.CRYPT_MODE_OFB)
+ cryptlib_py.cryptGenerateKey(randomKey)
+ bytes = createByteArrayZeros(howMany)
+ cryptlib_py.cryptEncrypt(randomKey, bytes)
+ return bytes
+ prngName = "cryptlib"
+
+ else:
+ #Else get UNIX /dev/urandom PRNG
+ try:
+ devRandomFile = open("/dev/urandom", "rb")
+ def getRandomBytes(howMany):
+ return stringToBytes(devRandomFile.read(howMany))
+ prngName = "/dev/urandom"
+ except IOError:
+ #Else get Win32 CryptoAPI PRNG
+ try:
+ import win32prng
+ def getRandomBytes(howMany):
+ s = win32prng.getRandomBytes(howMany)
+ if len(s) != howMany:
+ raise AssertionError()
+ return stringToBytes(s)
+ prngName ="CryptoAPI"
+ except ImportError:
+ #Else no PRNG :-(
+ def getRandomBytes(howMany):
+ raise NotImplementedError("No Random Number Generator "\
+ "available.")
+ prngName = "None"
+
+# **************************************************************************
+# Converter Functions
+# **************************************************************************
+
+def bytesToNumber(bytes):
+ total = 0L
+ multiplier = 1L
+ for count in range(len(bytes)-1, -1, -1):
+ byte = bytes[count]
+ total += multiplier * byte
+ multiplier *= 256
+ return total
+
+def numberToBytes(n):
+ howManyBytes = numBytes(n)
+ bytes = createByteArrayZeros(howManyBytes)
+ for count in range(howManyBytes-1, -1, -1):
+ bytes[count] = int(n % 256)
+ n >>= 8
+ return bytes
+
+def bytesToBase64(bytes):
+ s = bytesToString(bytes)
+ return stringToBase64(s)
+
+def base64ToBytes(s):
+ s = base64ToString(s)
+ return stringToBytes(s)
+
+def numberToBase64(n):
+ bytes = numberToBytes(n)
+ return bytesToBase64(bytes)
+
+def base64ToNumber(s):
+ bytes = base64ToBytes(s)
+ return bytesToNumber(bytes)
+
+def stringToNumber(s):
+ bytes = stringToBytes(s)
+ return bytesToNumber(bytes)
+
+def numberToString(s):
+ bytes = numberToBytes(s)
+ return bytesToString(bytes)
+
+def base64ToString(s):
+ try:
+ return base64.decodestring(s)
+ except binascii.Error, e:
+ raise SyntaxError(e)
+ except binascii.Incomplete, e:
+ raise SyntaxError(e)
+
+def stringToBase64(s):
+ return base64.encodestring(s).replace("\n", "")
+
+def mpiToNumber(mpi): #mpi is an openssl-format bignum string
+ if (ord(mpi[4]) & 0x80) !=0: #Make sure this is a positive number
+ raise AssertionError()
+ bytes = stringToBytes(mpi[4:])
+ return bytesToNumber(bytes)
+
+def numberToMPI(n):
+ bytes = numberToBytes(n)
+ ext = 0
+ #If the high-order bit is going to be set,
+ #add an extra byte of zeros
+ if (numBits(n) & 0x7)==0:
+ ext = 1
+ length = numBytes(n) + ext
+ bytes = concatArrays(createByteArrayZeros(4+ext), bytes)
+ bytes[0] = (length >> 24) & 0xFF
+ bytes[1] = (length >> 16) & 0xFF
+ bytes[2] = (length >> 8) & 0xFF
+ bytes[3] = length & 0xFF
+ return bytesToString(bytes)
+
+
+
+# **************************************************************************
+# Misc. Utility Functions
+# **************************************************************************
+
+def numBytes(n):
+ if n==0:
+ return 0
+ bits = numBits(n)
+ return int(math.ceil(bits / 8.0))
+
+def hashAndBase64(s):
+ return stringToBase64(sha1(s).digest())
+
+def getBase64Nonce(numChars=22): #defaults to an 132 bit nonce
+ bytes = getRandomBytes(numChars)
+ bytesStr = "".join([chr(b) for b in bytes])
+ return stringToBase64(bytesStr)[:numChars]
+
+
+# **************************************************************************
+# Big Number Math
+# **************************************************************************
+
+def getRandomNumber(low, high):
+ if low >= high:
+ raise AssertionError()
+ howManyBits = numBits(high)
+ howManyBytes = numBytes(high)
+ lastBits = howManyBits % 8
+ while 1:
+ bytes = getRandomBytes(howManyBytes)
+ if lastBits:
+ bytes[0] = bytes[0] % (1 << lastBits)
+ n = bytesToNumber(bytes)
+ if n >= low and n < high:
+ return n
+
+def gcd(a,b):
+ a, b = max(a,b), min(a,b)
+ while b:
+ a, b = b, a % b
+ return a
+
+def lcm(a, b):
+ #This will break when python division changes, but we can't use // cause
+ #of Jython
+ return (a * b) / gcd(a, b)
+
+#Returns inverse of a mod b, zero if none
+#Uses Extended Euclidean Algorithm
+def invMod(a, b):
+ c, d = a, b
+ uc, ud = 1, 0
+ while c != 0:
+ #This will break when python division changes, but we can't use //
+ #cause of Jython
+ q = d / c
+ c, d = d-(q*c), c
+ uc, ud = ud - (q * uc), uc
+ if d == 1:
+ return ud % b
+ return 0
+
+
+if gmpyLoaded:
+ def powMod(base, power, modulus):
+ base = gmpy.mpz(base)
+ power = gmpy.mpz(power)
+ modulus = gmpy.mpz(modulus)
+ result = pow(base, power, modulus)
+ return long(result)
+
+else:
+ #Copied from Bryan G. Olson's post to comp.lang.python
+ #Does left-to-right instead of pow()'s right-to-left,
+ #thus about 30% faster than the python built-in with small bases
+ def powMod(base, power, modulus):
+ nBitScan = 5
+
+ """ Return base**power mod modulus, using multi bit scanning
+ with nBitScan bits at a time."""
+
+ #TREV - Added support for negative exponents
+ negativeResult = False
+ if (power < 0):
+ power *= -1
+ negativeResult = True
+
+ exp2 = 2**nBitScan
+ mask = exp2 - 1
+
+ # Break power into a list of digits of nBitScan bits.
+ # The list is recursive so easy to read in reverse direction.
+ nibbles = None
+ while power:
+ nibbles = int(power & mask), nibbles
+ power = power >> nBitScan
+
+ # Make a table of powers of base up to 2**nBitScan - 1
+ lowPowers = [1]
+ for i in xrange(1, exp2):
+ lowPowers.append((lowPowers[i-1] * base) % modulus)
+
+ # To exponentiate by the first nibble, look it up in the table
+ nib, nibbles = nibbles
+ prod = lowPowers[nib]
+
+ # For the rest, square nBitScan times, then multiply by
+ # base^nibble
+ while nibbles:
+ nib, nibbles = nibbles
+ for i in xrange(nBitScan):
+ prod = (prod * prod) % modulus
+ if nib: prod = (prod * lowPowers[nib]) % modulus
+
+ #TREV - Added support for negative exponents
+ if negativeResult:
+ prodInv = invMod(prod, modulus)
+ #Check to make sure the inverse is correct
+ if (prod * prodInv) % modulus != 1:
+ raise AssertionError()
+ return prodInv
+ return prod
+
+
+#Pre-calculate a sieve of the ~100 primes < 1000:
+def makeSieve(n):
+ sieve = range(n)
+ for count in range(2, int(math.sqrt(n))):
+ if sieve[count] == 0:
+ continue
+ x = sieve[count] * 2
+ while x < len(sieve):
+ sieve[x] = 0
+ x += sieve[count]
+ sieve = [x for x in sieve[2:] if x]
+ return sieve
+
+sieve = makeSieve(1000)
+
+def isPrime(n, iterations=5, display=False):
+ #Trial division with sieve
+ for x in sieve:
+ if x >= n: return True
+ if n % x == 0: return False
+ #Passed trial division, proceed to Rabin-Miller
+ #Rabin-Miller implemented per Ferguson & Schneier
+ #Compute s, t for Rabin-Miller
+ if display: print "*",
+ s, t = n-1, 0
+ while s % 2 == 0:
+ s, t = s/2, t+1
+ #Repeat Rabin-Miller x times
+ a = 2 #Use 2 as a base for first iteration speedup, per HAC
+ for count in range(iterations):
+ v = powMod(a, s, n)
+ if v==1:
+ continue
+ i = 0
+ while v != n-1:
+ if i == t-1:
+ return False
+ else:
+ v, i = powMod(v, 2, n), i+1
+ a = getRandomNumber(2, n)
+ return True
+
+def getRandomPrime(bits, display=False):
+ if bits < 10:
+ raise AssertionError()
+ #The 1.5 ensures the 2 MSBs are set
+ #Thus, when used for p,q in RSA, n will have its MSB set
+ #
+ #Since 30 is lcm(2,3,5), we'll set our test numbers to
+ #29 % 30 and keep them there
+ low = (2L ** (bits-1)) * 3/2
+ high = 2L ** bits - 30
+ p = getRandomNumber(low, high)
+ p += 29 - (p % 30)
+ while 1:
+ if display: print ".",
+ p += 30
+ if p >= high:
+ p = getRandomNumber(low, high)
+ p += 29 - (p % 30)
+ if isPrime(p, display=display):
+ return p
+
+#Unused at the moment...
+def getRandomSafePrime(bits, display=False):
+ if bits < 10:
+ raise AssertionError()
+ #The 1.5 ensures the 2 MSBs are set
+ #Thus, when used for p,q in RSA, n will have its MSB set
+ #
+ #Since 30 is lcm(2,3,5), we'll set our test numbers to
+ #29 % 30 and keep them there
+ low = (2 ** (bits-2)) * 3/2
+ high = (2 ** (bits-1)) - 30
+ q = getRandomNumber(low, high)
+ q += 29 - (q % 30)
+ while 1:
+ if display: print ".",
+ q += 30
+ if (q >= high):
+ q = getRandomNumber(low, high)
+ q += 29 - (q % 30)
+ #Ideas from Tom Wu's SRP code
+ #Do trial division on p and q before Rabin-Miller
+ if isPrime(q, 0, display=display):
+ p = (2 * q) + 1
+ if isPrime(p, display=display):
+ if isPrime(q, display=display):
+ return p
diff --git a/src/gdata/tlslite/utils/dateFuncs.py b/src/gdata/tlslite/utils/dateFuncs.py
new file mode 100755
index 0000000..38812eb
--- /dev/null
+++ b/src/gdata/tlslite/utils/dateFuncs.py
@@ -0,0 +1,75 @@
+
+import os
+
+#Functions for manipulating datetime objects
+#CCYY-MM-DDThh:mm:ssZ
+def parseDateClass(s):
+ year, month, day = s.split("-")
+ day, tail = day[:2], day[2:]
+ hour, minute, second = tail[1:].split(":")
+ second = second[:2]
+ year, month, day = int(year), int(month), int(day)
+ hour, minute, second = int(hour), int(minute), int(second)
+ return createDateClass(year, month, day, hour, minute, second)
+
+
+if os.name != "java":
+ from datetime import datetime, timedelta
+
+ #Helper functions for working with a date/time class
+ def createDateClass(year, month, day, hour, minute, second):
+ return datetime(year, month, day, hour, minute, second)
+
+ def printDateClass(d):
+ #Split off fractional seconds, append 'Z'
+ return d.isoformat().split(".")[0]+"Z"
+
+ def getNow():
+ return datetime.utcnow()
+
+ def getHoursFromNow(hours):
+ return datetime.utcnow() + timedelta(hours=hours)
+
+ def getMinutesFromNow(minutes):
+ return datetime.utcnow() + timedelta(minutes=minutes)
+
+ def isDateClassExpired(d):
+ return d < datetime.utcnow()
+
+ def isDateClassBefore(d1, d2):
+ return d1 < d2
+
+else:
+ #Jython 2.1 is missing lots of python 2.3 stuff,
+ #which we have to emulate here:
+ import java
+ import jarray
+
+ def createDateClass(year, month, day, hour, minute, second):
+ c = java.util.Calendar.getInstance()
+ c.setTimeZone(java.util.TimeZone.getTimeZone("UTC"))
+ c.set(year, month-1, day, hour, minute, second)
+ return c
+
+ def printDateClass(d):
+ return "%04d-%02d-%02dT%02d:%02d:%02dZ" % \
+ (d.get(d.YEAR), d.get(d.MONTH)+1, d.get(d.DATE), \
+ d.get(d.HOUR_OF_DAY), d.get(d.MINUTE), d.get(d.SECOND))
+
+ def getNow():
+ c = java.util.Calendar.getInstance()
+ c.setTimeZone(java.util.TimeZone.getTimeZone("UTC"))
+ c.get(c.HOUR) #force refresh?
+ return c
+
+ def getHoursFromNow(hours):
+ d = getNow()
+ d.add(d.HOUR, hours)
+ return d
+
+ def isDateClassExpired(d):
+ n = getNow()
+ return d.before(n)
+
+ def isDateClassBefore(d1, d2):
+ return d1.before(d2)
diff --git a/src/gdata/tlslite/utils/entropy.c b/src/gdata/tlslite/utils/entropy.c
new file mode 100755
index 0000000..c627794
--- /dev/null
+++ b/src/gdata/tlslite/utils/entropy.c
@@ -0,0 +1,173 @@
+
+#include "Python.h"
+
+
+#ifdef MS_WINDOWS
+
+/* The following #define is not needed on VC6 with the Platform SDK, and it
+may not be needed on VC7, I'm not sure. I don't think it hurts anything.*/
+#define _WIN32_WINNT 0x0400
+
+#include <windows.h>
+
+
+typedef BOOL (WINAPI *CRYPTACQUIRECONTEXTA)(HCRYPTPROV *phProv,\
+ LPCSTR pszContainer, LPCSTR pszProvider, DWORD dwProvType,\
+ DWORD dwFlags );
+typedef BOOL (WINAPI *CRYPTGENRANDOM)(HCRYPTPROV hProv, DWORD dwLen,\
+ BYTE *pbBuffer );
+typedef BOOL (WINAPI *CRYPTRELEASECONTEXT)(HCRYPTPROV hProv,\
+ DWORD dwFlags);
+
+
+static PyObject* entropy(PyObject *self, PyObject *args)
+{
+ int howMany = 0;
+ HINSTANCE hAdvAPI32 = NULL;
+ CRYPTACQUIRECONTEXTA pCryptAcquireContextA = NULL;
+ CRYPTGENRANDOM pCryptGenRandom = NULL;
+ CRYPTRELEASECONTEXT pCryptReleaseContext = NULL;
+ HCRYPTPROV hCryptProv = 0;
+ unsigned char* bytes = NULL;
+ PyObject* returnVal = NULL;
+
+
+ /* Read arguments */
+ if (!PyArg_ParseTuple(args, "i", &howMany))
+ return(NULL);
+
+ /* Obtain handle to the DLL containing CryptoAPI
+ This should not fail */
+ if( (hAdvAPI32 = GetModuleHandle("advapi32.dll")) == NULL) {
+ PyErr_Format(PyExc_SystemError,
+ "Advapi32.dll not found");
+ return NULL;
+ }
+
+ /* Obtain pointers to the CryptoAPI functions
+ This will fail on some early version of Win95 */
+ pCryptAcquireContextA = (CRYPTACQUIRECONTEXTA)GetProcAddress(hAdvAPI32,\
+ "CryptAcquireContextA");
+ pCryptGenRandom = (CRYPTGENRANDOM)GetProcAddress(hAdvAPI32,\
+ "CryptGenRandom");
+ pCryptReleaseContext = (CRYPTRELEASECONTEXT) GetProcAddress(hAdvAPI32,\
+ "CryptReleaseContext");
+ if (pCryptAcquireContextA == NULL || pCryptGenRandom == NULL ||
+ pCryptReleaseContext == NULL) {
+ PyErr_Format(PyExc_NotImplementedError,
+ "CryptoAPI not available on this version of Windows");
+ return NULL;
+ }
+
+ /* Allocate bytes */
+ if ((bytes = (unsigned char*)PyMem_Malloc(howMany)) == NULL)
+ return PyErr_NoMemory();
+
+
+ /* Acquire context */
+ if(!pCryptAcquireContextA(&hCryptProv, NULL, NULL, PROV_RSA_FULL,
+ CRYPT_VERIFYCONTEXT)) {
+ PyErr_Format(PyExc_SystemError,
+ "CryptAcquireContext failed, error %d", GetLastError());
+ PyMem_Free(bytes);
+ return NULL;
+ }
+
+ /* Get random data */
+ if(!pCryptGenRandom(hCryptProv, howMany, bytes)) {
+ PyErr_Format(PyExc_SystemError,
+ "CryptGenRandom failed, error %d", GetLastError());
+ PyMem_Free(bytes);
+ CryptReleaseContext(hCryptProv, 0);
+ return NULL;
+ }
+
+ /* Build return value */
+ returnVal = Py_BuildValue("s#", bytes, howMany);
+ PyMem_Free(bytes);
+
+ /* Release context */
+ if (!pCryptReleaseContext(hCryptProv, 0)) {
+ PyErr_Format(PyExc_SystemError,
+ "CryptReleaseContext failed, error %d", GetLastError());
+ return NULL;
+ }
+
+ return returnVal;
+}
+
+#elif defined(HAVE_UNISTD_H) && defined(HAVE_FCNTL_H)
+
+#include <unistd.h>
+#include <fcntl.h>
+
+static PyObject* entropy(PyObject *self, PyObject *args)
+{
+ int howMany;
+ int fd;
+ unsigned char* bytes = NULL;
+ PyObject* returnVal = NULL;
+
+
+ /* Read arguments */
+ if (!PyArg_ParseTuple(args, "i", &howMany))
+ return(NULL);
+
+ /* Allocate bytes */
+ if ((bytes = (unsigned char*)PyMem_Malloc(howMany)) == NULL)
+ return PyErr_NoMemory();
+
+ /* Open device */
+ if ((fd = open("/dev/urandom", O_RDONLY, 0)) == -1) {
+ PyErr_Format(PyExc_NotImplementedError,
+ "No entropy source found");
+ PyMem_Free(bytes);
+ return NULL;
+ }
+
+ /* Get random data */
+ if (read(fd, bytes, howMany) < howMany) {
+ PyErr_Format(PyExc_SystemError,
+ "Reading from /dev/urandom failed");
+ PyMem_Free(bytes);
+ close(fd);
+ return NULL;
+ }
+
+ /* Build return value */
+ returnVal = Py_BuildValue("s#", bytes, howMany);
+ PyMem_Free(bytes);
+
+ /* Close device */
+ close(fd);
+
+ return returnVal;
+}
+
+#else
+
+static PyObject* entropy(PyObject *self, PyObject *args)
+{
+ PyErr_Format(PyExc_NotImplementedError,
+ "Function not supported");
+ return NULL;
+}
+
+#endif
+
+
+
+/* List of functions exported by this module */
+
+static struct PyMethodDef entropy_functions[] = {
+ {"entropy", (PyCFunction)entropy, METH_VARARGS, "Return a string of random bytes produced by a platform-specific\nentropy source."},
+ {NULL, NULL} /* Sentinel */
+};
+
+
+/* Initialize this module. */
+
+PyMODINIT_FUNC initentropy(void)
+{
+ Py_InitModule("entropy", entropy_functions);
+}
\ No newline at end of file
diff --git a/src/gdata/tlslite/utils/hmac.py b/src/gdata/tlslite/utils/hmac.py
new file mode 100755
index 0000000..fe8feec
--- /dev/null
+++ b/src/gdata/tlslite/utils/hmac.py
@@ -0,0 +1,104 @@
+"""HMAC (Keyed-Hashing for Message Authentication) Python module.
+
+Implements the HMAC algorithm as described by RFC 2104.
+
+(This file is modified from the standard library version to do faster
+copying)
+"""
+
+def _strxor(s1, s2):
+ """Utility method. XOR the two strings s1 and s2 (must have same length).
+ """
+ return "".join(map(lambda x, y: chr(ord(x) ^ ord(y)), s1, s2))
+
+# The size of the digests returned by HMAC depends on the underlying
+# hashing module used.
+digest_size = None
+
+class HMAC:
+ """RFC2104 HMAC class.
+
+ This supports the API for Cryptographic Hash Functions (PEP 247).
+ """
+
+ def __init__(self, key, msg = None, digestmod = None):
+ """Create a new HMAC object.
+
+ key: key for the keyed hash object.
+ msg: Initial input for the hash, if provided.
+ digestmod: A module supporting PEP 247. Defaults to the md5 module.
+ """
+ if digestmod is None:
+ import md5
+ digestmod = md5
+
+ if key == None: #TREVNEW - for faster copying
+ return #TREVNEW
+
+ self.digestmod = digestmod
+ self.outer = digestmod.new()
+ self.inner = digestmod.new()
+ self.digest_size = digestmod.digest_size
+
+ blocksize = 64
+ ipad = "\x36" * blocksize
+ opad = "\x5C" * blocksize
+
+ if len(key) > blocksize:
+ key = digestmod.new(key).digest()
+
+ key = key + chr(0) * (blocksize - len(key))
+ self.outer.update(_strxor(key, opad))
+ self.inner.update(_strxor(key, ipad))
+ if msg is not None:
+ self.update(msg)
+
+## def clear(self):
+## raise NotImplementedError, "clear() method not available in HMAC."
+
+ def update(self, msg):
+ """Update this hashing object with the string msg.
+ """
+ self.inner.update(msg)
+
+ def copy(self):
+ """Return a separate copy of this hashing object.
+
+ An update to this copy won't affect the original object.
+ """
+ other = HMAC(None) #TREVNEW - for faster copying
+ other.digest_size = self.digest_size #TREVNEW
+ other.digestmod = self.digestmod
+ other.inner = self.inner.copy()
+ other.outer = self.outer.copy()
+ return other
+
+ def digest(self):
+ """Return the hash value of this hashing object.
+
+ This returns a string containing 8-bit data. The object is
+ not altered in any way by this function; you can continue
+ updating the object after calling this function.
+ """
+ h = self.outer.copy()
+ h.update(self.inner.digest())
+ return h.digest()
+
+ def hexdigest(self):
+ """Like digest(), but returns a string of hexadecimal digits instead.
+ """
+ return "".join([hex(ord(x))[2:].zfill(2)
+ for x in tuple(self.digest())])
+
+def new(key, msg = None, digestmod = None):
+ """Create a new hashing object and return it.
+
+ key: The starting key for the hash.
+ msg: if available, will immediately be hashed into the object's starting
+ state.
+
+ You can now feed arbitrary strings into the object using its update()
+ method, and can ask for the hash value at any time by calling its digest()
+ method.
+ """
+ return HMAC(key, msg, digestmod)
diff --git a/src/gdata/tlslite/utils/jython_compat.py b/src/gdata/tlslite/utils/jython_compat.py
new file mode 100755
index 0000000..1245183
--- /dev/null
+++ b/src/gdata/tlslite/utils/jython_compat.py
@@ -0,0 +1,195 @@
+"""Miscellaneous functions to mask Python/Jython differences."""
+
+import os
+import sha
+
+if os.name != "java":
+ BaseException = Exception
+
+ from sets import Set
+ import array
+ import math
+
+ def createByteArraySequence(seq):
+ return array.array('B', seq)
+ def createByteArrayZeros(howMany):
+ return array.array('B', [0] * howMany)
+ def concatArrays(a1, a2):
+ return a1+a2
+
+ def bytesToString(bytes):
+ return bytes.tostring()
+
+ def stringToBytes(s):
+ bytes = createByteArrayZeros(0)
+ bytes.fromstring(s)
+ return bytes
+
+ def numBits(n):
+ if n==0:
+ return 0
+ return int(math.floor(math.log(n, 2))+1)
+
+ class CertChainBase: pass
+ class SelfTestBase: pass
+ class ReportFuncBase: pass
+
+ #Helper functions for working with sets (from Python 2.3)
+ def iterSet(set):
+ return iter(set)
+
+ def getListFromSet(set):
+ return list(set)
+
+ #Factory function for getting a SHA1 object
+ def getSHA1(s):
+ return sha.sha(s)
+
+ import sys
+ import traceback
+
+ def formatExceptionTrace(e):
+ newStr = "".join(traceback.format_exception(sys.exc_type, sys.exc_value, sys.exc_traceback))
+ return newStr
+
+else:
+ #Jython 2.1 is missing lots of python 2.3 stuff,
+ #which we have to emulate here:
+ import java
+ import jarray
+
+ BaseException = java.lang.Exception
+
+ def createByteArraySequence(seq):
+ if isinstance(seq, type("")): #If it's a string, convert
+ seq = [ord(c) for c in seq]
+ return jarray.array(seq, 'h') #use short instead of bytes, cause bytes are signed
+ def createByteArrayZeros(howMany):
+ return jarray.zeros(howMany, 'h') #use short instead of bytes, cause bytes are signed
+ def concatArrays(a1, a2):
+ l = list(a1)+list(a2)
+ return createByteArraySequence(l)
+
+ #WAY TOO SLOW - MUST BE REPLACED------------
+ def bytesToString(bytes):
+ return "".join([chr(b) for b in bytes])
+
+ def stringToBytes(s):
+ bytes = createByteArrayZeros(len(s))
+ for count, c in enumerate(s):
+ bytes[count] = ord(c)
+ return bytes
+ #WAY TOO SLOW - MUST BE REPLACED------------
+
+ def numBits(n):
+ if n==0:
+ return 0
+ n= 1L * n; #convert to long, if it isn't already
+ return n.__tojava__(java.math.BigInteger).bitLength()
+
+ #This properly creates static methods for Jython
+ class staticmethod:
+ def __init__(self, anycallable): self.__call__ = anycallable
+
+ #Properties are not supported for Jython
+ class property:
+ def __init__(self, anycallable): pass
+
+ #True and False have to be specially defined
+ False = 0
+ True = 1
+
+ class StopIteration(Exception): pass
+
+ def enumerate(collection):
+ return zip(range(len(collection)), collection)
+
+ class Set:
+ def __init__(self, seq=None):
+ self.values = {}
+ if seq:
+ for e in seq:
+ self.values[e] = None
+
+ def add(self, e):
+ self.values[e] = None
+
+ def discard(self, e):
+ if e in self.values.keys():
+ del(self.values[e])
+
+ def union(self, s):
+ ret = Set()
+ for e in self.values.keys():
+ ret.values[e] = None
+ for e in s.values.keys():
+ ret.values[e] = None
+ return ret
+
+ def issubset(self, other):
+ for e in self.values.keys():
+ if e not in other.values.keys():
+ return False
+ return True
+
+ def __nonzero__( self):
+ return len(self.values.keys())
+
+ def __contains__(self, e):
+ return e in self.values.keys()
+
+ def iterSet(set):
+ return set.values.keys()
+
+ def getListFromSet(set):
+ return set.values.keys()
+
+ """
+ class JCE_SHA1:
+ def __init__(self, s=None):
+ self.md = java.security.MessageDigest.getInstance("SHA1")
+ if s:
+ self.update(s)
+
+ def update(self, s):
+ self.md.update(s)
+
+ def copy(self):
+ sha1 = JCE_SHA1()
+ sha1.md = self.md.clone()
+ return sha1
+
+ def digest(self):
+ digest = self.md.digest()
+ bytes = jarray.zeros(20, 'h')
+ for count in xrange(20):
+ x = digest[count]
+ if x < 0: x += 256
+ bytes[count] = x
+ return bytes
+ """
+
+ #Factory function for getting a SHA1 object
+ #The JCE_SHA1 class is way too slow...
+ #the sha.sha object we use instead is broken in the jython 2.1
+ #release, and needs to be patched
+ def getSHA1(s):
+ #return JCE_SHA1(s)
+ return sha.sha(s)
+
+
+ #Adjust the string to an array of bytes
+ def stringToJavaByteArray(s):
+ bytes = jarray.zeros(len(s), 'b')
+ for count, c in enumerate(s):
+ x = ord(c)
+ if x >= 128: x -= 256
+ bytes[count] = x
+ return bytes
+
+ import sys
+ import traceback
+
+ def formatExceptionTrace(e):
+ newStr = "".join(traceback.format_exception(sys.exc_type, sys.exc_value, sys.exc_traceback))
+ return newStr
diff --git a/src/gdata/tlslite/utils/keyfactory.py b/src/gdata/tlslite/utils/keyfactory.py
new file mode 100755
index 0000000..5005af7
--- /dev/null
+++ b/src/gdata/tlslite/utils/keyfactory.py
@@ -0,0 +1,243 @@
+"""Factory functions for asymmetric cryptography.
+@sort: generateRSAKey, parseXMLKey, parsePEMKey, parseAsPublicKey,
+parseAsPrivateKey
+"""
+
+from compat import *
+
+from RSAKey import RSAKey
+from Python_RSAKey import Python_RSAKey
+import cryptomath
+
+if cryptomath.m2cryptoLoaded:
+ from OpenSSL_RSAKey import OpenSSL_RSAKey
+
+if cryptomath.pycryptoLoaded:
+ from PyCrypto_RSAKey import PyCrypto_RSAKey
+
+# **************************************************************************
+# Factory Functions for RSA Keys
+# **************************************************************************
+
+def generateRSAKey(bits, implementations=["openssl", "python"]):
+ """Generate an RSA key with the specified bit length.
+
+ @type bits: int
+ @param bits: Desired bit length of the new key's modulus.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ @return: A new RSA private key.
+ """
+ for implementation in implementations:
+ if implementation == "openssl" and cryptomath.m2cryptoLoaded:
+ return OpenSSL_RSAKey.generate(bits)
+ elif implementation == "python":
+ return Python_RSAKey.generate(bits)
+ raise ValueError("No acceptable implementations")
+
+def parseXMLKey(s, private=False, public=False, implementations=["python"]):
+ """Parse an XML-format key.
+
+ The XML format used here is specific to tlslite and cryptoIDlib. The
+ format can store the public component of a key, or the public and
+ private components. For example::
+
+ <publicKey xmlns="http://trevp.net/rsa">
+ <n>4a5yzB8oGNlHo866CAspAC47M4Fvx58zwK8pou...
+ <e>Aw==</e>
+ </publicKey>
+
+ <privateKey xmlns="http://trevp.net/rsa">
+ <n>4a5yzB8oGNlHo866CAspAC47M4Fvx58zwK8pou...
+ <e>Aw==</e>
+ <d>JZ0TIgUxWXmL8KJ0VqyG1V0J3ern9pqIoB0xmy...
+ <p>5PreIj6z6ldIGL1V4+1C36dQFHNCQHJvW52GXc...
+ <q>/E/wDit8YXPCxx126zTq2ilQ3IcW54NJYyNjiZ...
+ <dP>mKc+wX8inDowEH45Qp4slRo1YveBgExKPROu6...
+ <dQ>qDVKtBz9lk0shL5PR3ickXDgkwS576zbl2ztB...
+ <qInv>j6E8EA7dNsTImaXexAmLA1DoeArsYeFAInr...
+ </privateKey>
+
+ @type s: str
+ @param s: A string containing an XML public or private key.
+
+ @type private: bool
+ @param private: If True, a L{SyntaxError} will be raised if the private
+ key component is not present.
+
+ @type public: bool
+ @param public: If True, the private key component (if present) will be
+ discarded, so this function will always return a public key.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ @return: An RSA key.
+
+ @raise SyntaxError: If the key is not properly formatted.
+ """
+ for implementation in implementations:
+ if implementation == "python":
+ key = Python_RSAKey.parseXML(s)
+ break
+ else:
+ raise ValueError("No acceptable implementations")
+
+ return _parseKeyHelper(key, private, public)
+
+#Parse as an OpenSSL or Python key
+def parsePEMKey(s, private=False, public=False, passwordCallback=None,
+ implementations=["openssl", "python"]):
+ """Parse a PEM-format key.
+
+ The PEM format is used by OpenSSL and other tools. The
+ format is typically used to store both the public and private
+ components of a key. For example::
+
+ -----BEGIN RSA PRIVATE KEY-----
+ MIICXQIBAAKBgQDYscuoMzsGmW0pAYsmyHltxB2TdwHS0dImfjCMfaSDkfLdZY5+
+ dOWORVns9etWnr194mSGA1F0Pls/VJW8+cX9+3vtJV8zSdANPYUoQf0TP7VlJxkH
+ dSRkUbEoz5bAAs/+970uos7n7iXQIni+3erUTdYEk2iWnMBjTljfgbK/dQIDAQAB
+ AoGAJHoJZk75aKr7DSQNYIHuruOMdv5ZeDuJvKERWxTrVJqE32/xBKh42/IgqRrc
+ esBN9ZregRCd7YtxoL+EVUNWaJNVx2mNmezEznrc9zhcYUrgeaVdFO2yBF1889zO
+ gCOVwrO8uDgeyj6IKa25H6c1N13ih/o7ZzEgWbGG+ylU1yECQQDv4ZSJ4EjSh/Fl
+ aHdz3wbBa/HKGTjC8iRy476Cyg2Fm8MZUe9Yy3udOrb5ZnS2MTpIXt5AF3h2TfYV
+ VoFXIorjAkEA50FcJmzT8sNMrPaV8vn+9W2Lu4U7C+K/O2g1iXMaZms5PC5zV5aV
+ CKXZWUX1fq2RaOzlbQrpgiolhXpeh8FjxwJBAOFHzSQfSsTNfttp3KUpU0LbiVvv
+ i+spVSnA0O4rq79KpVNmK44Mq67hsW1P11QzrzTAQ6GVaUBRv0YS061td1kCQHnP
+ wtN2tboFR6lABkJDjxoGRvlSt4SOPr7zKGgrWjeiuTZLHXSAnCY+/hr5L9Q3ZwXG
+ 6x6iBdgLjVIe4BZQNtcCQQDXGv/gWinCNTN3MPWfTW/RGzuMYVmyBFais0/VrgdH
+ h1dLpztmpQqfyH/zrBXQ9qL/zR4ojS6XYneO/U18WpEe
+ -----END RSA PRIVATE KEY-----
+
+ To generate a key like this with OpenSSL, run::
+
+ openssl genrsa 2048 > key.pem
+
+ This format also supports password-encrypted private keys. TLS
+ Lite can only handle password-encrypted private keys when OpenSSL
+ and M2Crypto are installed. In this case, passwordCallback will be
+ invoked to query the user for the password.
+
+ @type s: str
+ @param s: A string containing a PEM-encoded public or private key.
+
+ @type private: bool
+ @param private: If True, a L{SyntaxError} will be raised if the
+ private key component is not present.
+
+ @type public: bool
+ @param public: If True, the private key component (if present) will
+ be discarded, so this function will always return a public key.
+
+ @type passwordCallback: callable
+ @param passwordCallback: This function will be called, with no
+ arguments, if the PEM-encoded private key is password-encrypted.
+ The callback should return the password string. If the password is
+ incorrect, SyntaxError will be raised. If no callback is passed
+ and the key is password-encrypted, a prompt will be displayed at
+ the console.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ @return: An RSA key.
+
+ @raise SyntaxError: If the key is not properly formatted.
+ """
+ for implementation in implementations:
+ if implementation == "openssl" and cryptomath.m2cryptoLoaded:
+ key = OpenSSL_RSAKey.parse(s, passwordCallback)
+ break
+ elif implementation == "python":
+ key = Python_RSAKey.parsePEM(s)
+ break
+ else:
+ raise ValueError("No acceptable implementations")
+
+ return _parseKeyHelper(key, private, public)
+
+
+def _parseKeyHelper(key, private, public):
+ if private:
+ if not key.hasPrivateKey():
+ raise SyntaxError("Not a private key!")
+
+ if public:
+ return _createPublicKey(key)
+
+ if private:
+ if hasattr(key, "d"):
+ return _createPrivateKey(key)
+ else:
+ return key
+
+ return key
+
+def parseAsPublicKey(s):
+ """Parse an XML or PEM-formatted public key.
+
+ @type s: str
+ @param s: A string containing an XML or PEM-encoded public or private key.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ @return: An RSA public key.
+
+ @raise SyntaxError: If the key is not properly formatted.
+ """
+ try:
+ return parsePEMKey(s, public=True)
+ except:
+ return parseXMLKey(s, public=True)
+
+def parsePrivateKey(s):
+ """Parse an XML or PEM-formatted private key.
+
+ @type s: str
+ @param s: A string containing an XML or PEM-encoded private key.
+
+ @rtype: L{tlslite.utils.RSAKey.RSAKey}
+ @return: An RSA private key.
+
+ @raise SyntaxError: If the key is not properly formatted.
+ """
+ try:
+ return parsePEMKey(s, private=True)
+ except:
+ return parseXMLKey(s, private=True)
+
+def _createPublicKey(key):
+ """
+ Create a new public key. Discard any private component,
+ and return the most efficient key possible.
+ """
+ if not isinstance(key, RSAKey):
+ raise AssertionError()
+ return _createPublicRSAKey(key.n, key.e)
+
+def _createPrivateKey(key):
+ """
+ Create a new private key. Return the most efficient key possible.
+ """
+ if not isinstance(key, RSAKey):
+ raise AssertionError()
+ if not key.hasPrivateKey():
+ raise AssertionError()
+ return _createPrivateRSAKey(key.n, key.e, key.d, key.p, key.q, key.dP,
+ key.dQ, key.qInv)
+
+def _createPublicRSAKey(n, e, implementations = ["openssl", "pycrypto",
+ "python"]):
+ for implementation in implementations:
+ if implementation == "openssl" and cryptomath.m2cryptoLoaded:
+ return OpenSSL_RSAKey(n, e)
+ elif implementation == "pycrypto" and cryptomath.pycryptoLoaded:
+ return PyCrypto_RSAKey(n, e)
+ elif implementation == "python":
+ return Python_RSAKey(n, e)
+ raise ValueError("No acceptable implementations")
+
+def _createPrivateRSAKey(n, e, d, p, q, dP, dQ, qInv,
+ implementations = ["pycrypto", "python"]):
+ for implementation in implementations:
+ if implementation == "pycrypto" and cryptomath.pycryptoLoaded:
+ return PyCrypto_RSAKey(n, e, d, p, q, dP, dQ, qInv)
+ elif implementation == "python":
+ return Python_RSAKey(n, e, d, p, q, dP, dQ, qInv)
+ raise ValueError("No acceptable implementations")
diff --git a/src/gdata/tlslite/utils/rijndael.py b/src/gdata/tlslite/utils/rijndael.py
new file mode 100755
index 0000000..cb2f547
--- /dev/null
+++ b/src/gdata/tlslite/utils/rijndael.py
@@ -0,0 +1,392 @@
+"""
+A pure python (slow) implementation of rijndael with a decent interface
+
+To include -
+
+from rijndael import rijndael
+
+To do a key setup -
+
+r = rijndael(key, block_size = 16)
+
+key must be a string of length 16, 24, or 32
+blocksize must be 16, 24, or 32. Default is 16
+
+To use -
+
+ciphertext = r.encrypt(plaintext)
+plaintext = r.decrypt(ciphertext)
+
+If any strings are of the wrong length a ValueError is thrown
+"""
+
+# ported from the Java reference code by Bram Cohen, bram@gawth.com, April 2001
+# this code is public domain, unless someone makes
+# an intellectual property claim against the reference
+# code, in which case it can be made public domain by
+# deleting all the comments and renaming all the variables
+
+import copy
+import string
+
+
+
+#-----------------------
+#TREV - ADDED BECAUSE THERE'S WARNINGS ABOUT INT OVERFLOW BEHAVIOR CHANGING IN
+#2.4.....
+import os
+if os.name != "java":
+ import exceptions
+ if hasattr(exceptions, "FutureWarning"):
+ import warnings
+ warnings.filterwarnings("ignore", category=FutureWarning, append=1)
+#-----------------------
+
+
+
+shifts = [[[0, 0], [1, 3], [2, 2], [3, 1]],
+ [[0, 0], [1, 5], [2, 4], [3, 3]],
+ [[0, 0], [1, 7], [3, 5], [4, 4]]]
+
+# [keysize][block_size]
+num_rounds = {16: {16: 10, 24: 12, 32: 14}, 24: {16: 12, 24: 12, 32: 14}, 32: {16: 14, 24: 14, 32: 14}}
+
+A = [[1, 1, 1, 1, 1, 0, 0, 0],
+ [0, 1, 1, 1, 1, 1, 0, 0],
+ [0, 0, 1, 1, 1, 1, 1, 0],
+ [0, 0, 0, 1, 1, 1, 1, 1],
+ [1, 0, 0, 0, 1, 1, 1, 1],
+ [1, 1, 0, 0, 0, 1, 1, 1],
+ [1, 1, 1, 0, 0, 0, 1, 1],
+ [1, 1, 1, 1, 0, 0, 0, 1]]
+
+# produce log and alog tables, needed for multiplying in the
+# field GF(2^m) (generator = 3)
+alog = [1]
+for i in xrange(255):
+ j = (alog[-1] << 1) ^ alog[-1]
+ if j & 0x100 != 0:
+ j ^= 0x11B
+ alog.append(j)
+
+log = [0] * 256
+for i in xrange(1, 255):
+ log[alog[i]] = i
+
+# multiply two elements of GF(2^m)
+def mul(a, b):
+ if a == 0 or b == 0:
+ return 0
+ return alog[(log[a & 0xFF] + log[b & 0xFF]) % 255]
+
+# substitution box based on F^{-1}(x)
+box = [[0] * 8 for i in xrange(256)]
+box[1][7] = 1
+for i in xrange(2, 256):
+ j = alog[255 - log[i]]
+ for t in xrange(8):
+ box[i][t] = (j >> (7 - t)) & 0x01
+
+B = [0, 1, 1, 0, 0, 0, 1, 1]
+
+# affine transform: box[i] <- B + A*box[i]
+cox = [[0] * 8 for i in xrange(256)]
+for i in xrange(256):
+ for t in xrange(8):
+ cox[i][t] = B[t]
+ for j in xrange(8):
+ cox[i][t] ^= A[t][j] * box[i][j]
+
+# S-boxes and inverse S-boxes
+S = [0] * 256
+Si = [0] * 256
+for i in xrange(256):
+ S[i] = cox[i][0] << 7
+ for t in xrange(1, 8):
+ S[i] ^= cox[i][t] << (7-t)
+ Si[S[i] & 0xFF] = i
+
+# T-boxes
+G = [[2, 1, 1, 3],
+ [3, 2, 1, 1],
+ [1, 3, 2, 1],
+ [1, 1, 3, 2]]
+
+AA = [[0] * 8 for i in xrange(4)]
+
+for i in xrange(4):
+ for j in xrange(4):
+ AA[i][j] = G[i][j]
+ AA[i][i+4] = 1
+
+for i in xrange(4):
+ pivot = AA[i][i]
+ if pivot == 0:
+ t = i + 1
+ while AA[t][i] == 0 and t < 4:
+ t += 1
+ assert t != 4, 'G matrix must be invertible'
+ for j in xrange(8):
+ AA[i][j], AA[t][j] = AA[t][j], AA[i][j]
+ pivot = AA[i][i]
+ for j in xrange(8):
+ if AA[i][j] != 0:
+ AA[i][j] = alog[(255 + log[AA[i][j] & 0xFF] - log[pivot & 0xFF]) % 255]
+ for t in xrange(4):
+ if i != t:
+ for j in xrange(i+1, 8):
+ AA[t][j] ^= mul(AA[i][j], AA[t][i])
+ AA[t][i] = 0
+
+iG = [[0] * 4 for i in xrange(4)]
+
+for i in xrange(4):
+ for j in xrange(4):
+ iG[i][j] = AA[i][j + 4]
+
+def mul4(a, bs):
+ if a == 0:
+ return 0
+ r = 0
+ for b in bs:
+ r <<= 8
+ if b != 0:
+ r = r | mul(a, b)
+ return r
+
+T1 = []
+T2 = []
+T3 = []
+T4 = []
+T5 = []
+T6 = []
+T7 = []
+T8 = []
+U1 = []
+U2 = []
+U3 = []
+U4 = []
+
+for t in xrange(256):
+ s = S[t]
+ T1.append(mul4(s, G[0]))
+ T2.append(mul4(s, G[1]))
+ T3.append(mul4(s, G[2]))
+ T4.append(mul4(s, G[3]))
+
+ s = Si[t]
+ T5.append(mul4(s, iG[0]))
+ T6.append(mul4(s, iG[1]))
+ T7.append(mul4(s, iG[2]))
+ T8.append(mul4(s, iG[3]))
+
+ U1.append(mul4(t, iG[0]))
+ U2.append(mul4(t, iG[1]))
+ U3.append(mul4(t, iG[2]))
+ U4.append(mul4(t, iG[3]))
+
+# round constants
+rcon = [1]
+r = 1
+for t in xrange(1, 30):
+ r = mul(2, r)
+ rcon.append(r)
+
+del A
+del AA
+del pivot
+del B
+del G
+del box
+del log
+del alog
+del i
+del j
+del r
+del s
+del t
+del mul
+del mul4
+del cox
+del iG
+
+class rijndael:
+ def __init__(self, key, block_size = 16):
+ if block_size != 16 and block_size != 24 and block_size != 32:
+ raise ValueError('Invalid block size: ' + str(block_size))
+ if len(key) != 16 and len(key) != 24 and len(key) != 32:
+ raise ValueError('Invalid key size: ' + str(len(key)))
+ self.block_size = block_size
+
+ ROUNDS = num_rounds[len(key)][block_size]
+ BC = block_size / 4
+ # encryption round keys
+ Ke = [[0] * BC for i in xrange(ROUNDS + 1)]
+ # decryption round keys
+ Kd = [[0] * BC for i in xrange(ROUNDS + 1)]
+ ROUND_KEY_COUNT = (ROUNDS + 1) * BC
+ KC = len(key) / 4
+
+ # copy user material bytes into temporary ints
+ tk = []
+ for i in xrange(0, KC):
+ tk.append((ord(key[i * 4]) << 24) | (ord(key[i * 4 + 1]) << 16) |
+ (ord(key[i * 4 + 2]) << 8) | ord(key[i * 4 + 3]))
+
+ # copy values into round key arrays
+ t = 0
+ j = 0
+ while j < KC and t < ROUND_KEY_COUNT:
+ Ke[t / BC][t % BC] = tk[j]
+ Kd[ROUNDS - (t / BC)][t % BC] = tk[j]
+ j += 1
+ t += 1
+ tt = 0
+ rconpointer = 0
+ while t < ROUND_KEY_COUNT:
+ # extrapolate using phi (the round key evolution function)
+ tt = tk[KC - 1]
+ tk[0] ^= (S[(tt >> 16) & 0xFF] & 0xFF) << 24 ^ \
+ (S[(tt >> 8) & 0xFF] & 0xFF) << 16 ^ \
+ (S[ tt & 0xFF] & 0xFF) << 8 ^ \
+ (S[(tt >> 24) & 0xFF] & 0xFF) ^ \
+ (rcon[rconpointer] & 0xFF) << 24
+ rconpointer += 1
+ if KC != 8:
+ for i in xrange(1, KC):
+ tk[i] ^= tk[i-1]
+ else:
+ for i in xrange(1, KC / 2):
+ tk[i] ^= tk[i-1]
+ tt = tk[KC / 2 - 1]
+ tk[KC / 2] ^= (S[ tt & 0xFF] & 0xFF) ^ \
+ (S[(tt >> 8) & 0xFF] & 0xFF) << 8 ^ \
+ (S[(tt >> 16) & 0xFF] & 0xFF) << 16 ^ \
+ (S[(tt >> 24) & 0xFF] & 0xFF) << 24
+ for i in xrange(KC / 2 + 1, KC):
+ tk[i] ^= tk[i-1]
+ # copy values into round key arrays
+ j = 0
+ while j < KC and t < ROUND_KEY_COUNT:
+ Ke[t / BC][t % BC] = tk[j]
+ Kd[ROUNDS - (t / BC)][t % BC] = tk[j]
+ j += 1
+ t += 1
+ # inverse MixColumn where needed
+ for r in xrange(1, ROUNDS):
+ for j in xrange(BC):
+ tt = Kd[r][j]
+ Kd[r][j] = U1[(tt >> 24) & 0xFF] ^ \
+ U2[(tt >> 16) & 0xFF] ^ \
+ U3[(tt >> 8) & 0xFF] ^ \
+ U4[ tt & 0xFF]
+ self.Ke = Ke
+ self.Kd = Kd
+
+ def encrypt(self, plaintext):
+ if len(plaintext) != self.block_size:
+ raise ValueError('wrong block length, expected ' + str(self.block_size) + ' got ' + str(len(plaintext)))
+ Ke = self.Ke
+
+ BC = self.block_size / 4
+ ROUNDS = len(Ke) - 1
+ if BC == 4:
+ SC = 0
+ elif BC == 6:
+ SC = 1
+ else:
+ SC = 2
+ s1 = shifts[SC][1][0]
+ s2 = shifts[SC][2][0]
+ s3 = shifts[SC][3][0]
+ a = [0] * BC
+ # temporary work array
+ t = []
+ # plaintext to ints + key
+ for i in xrange(BC):
+ t.append((ord(plaintext[i * 4 ]) << 24 |
+ ord(plaintext[i * 4 + 1]) << 16 |
+ ord(plaintext[i * 4 + 2]) << 8 |
+ ord(plaintext[i * 4 + 3]) ) ^ Ke[0][i])
+ # apply round transforms
+ for r in xrange(1, ROUNDS):
+ for i in xrange(BC):
+ a[i] = (T1[(t[ i ] >> 24) & 0xFF] ^
+ T2[(t[(i + s1) % BC] >> 16) & 0xFF] ^
+ T3[(t[(i + s2) % BC] >> 8) & 0xFF] ^
+ T4[ t[(i + s3) % BC] & 0xFF] ) ^ Ke[r][i]
+ t = copy.copy(a)
+ # last round is special
+ result = []
+ for i in xrange(BC):
+ tt = Ke[ROUNDS][i]
+ result.append((S[(t[ i ] >> 24) & 0xFF] ^ (tt >> 24)) & 0xFF)
+ result.append((S[(t[(i + s1) % BC] >> 16) & 0xFF] ^ (tt >> 16)) & 0xFF)
+ result.append((S[(t[(i + s2) % BC] >> 8) & 0xFF] ^ (tt >> 8)) & 0xFF)
+ result.append((S[ t[(i + s3) % BC] & 0xFF] ^ tt ) & 0xFF)
+ return string.join(map(chr, result), '')
+
+ def decrypt(self, ciphertext):
+ if len(ciphertext) != self.block_size:
+ raise ValueError('wrong block length, expected ' + str(self.block_size) + ' got ' + str(len(plaintext)))
+ Kd = self.Kd
+
+ BC = self.block_size / 4
+ ROUNDS = len(Kd) - 1
+ if BC == 4:
+ SC = 0
+ elif BC == 6:
+ SC = 1
+ else:
+ SC = 2
+ s1 = shifts[SC][1][1]
+ s2 = shifts[SC][2][1]
+ s3 = shifts[SC][3][1]
+ a = [0] * BC
+ # temporary work array
+ t = [0] * BC
+ # ciphertext to ints + key
+ for i in xrange(BC):
+ t[i] = (ord(ciphertext[i * 4 ]) << 24 |
+ ord(ciphertext[i * 4 + 1]) << 16 |
+ ord(ciphertext[i * 4 + 2]) << 8 |
+ ord(ciphertext[i * 4 + 3]) ) ^ Kd[0][i]
+ # apply round transforms
+ for r in xrange(1, ROUNDS):
+ for i in xrange(BC):
+ a[i] = (T5[(t[ i ] >> 24) & 0xFF] ^
+ T6[(t[(i + s1) % BC] >> 16) & 0xFF] ^
+ T7[(t[(i + s2) % BC] >> 8) & 0xFF] ^
+ T8[ t[(i + s3) % BC] & 0xFF] ) ^ Kd[r][i]
+ t = copy.copy(a)
+ # last round is special
+ result = []
+ for i in xrange(BC):
+ tt = Kd[ROUNDS][i]
+ result.append((Si[(t[ i ] >> 24) & 0xFF] ^ (tt >> 24)) & 0xFF)
+ result.append((Si[(t[(i + s1) % BC] >> 16) & 0xFF] ^ (tt >> 16)) & 0xFF)
+ result.append((Si[(t[(i + s2) % BC] >> 8) & 0xFF] ^ (tt >> 8)) & 0xFF)
+ result.append((Si[ t[(i + s3) % BC] & 0xFF] ^ tt ) & 0xFF)
+ return string.join(map(chr, result), '')
+
+def encrypt(key, block):
+ return rijndael(key, len(block)).encrypt(block)
+
+def decrypt(key, block):
+ return rijndael(key, len(block)).decrypt(block)
+
+def test():
+ def t(kl, bl):
+ b = 'b' * bl
+ r = rijndael('a' * kl, bl)
+ assert r.decrypt(r.encrypt(b)) == b
+ t(16, 16)
+ t(16, 24)
+ t(16, 32)
+ t(24, 16)
+ t(24, 24)
+ t(24, 32)
+ t(32, 16)
+ t(32, 24)
+ t(32, 32)
+
diff --git a/src/gdata/tlslite/utils/win32prng.c b/src/gdata/tlslite/utils/win32prng.c
new file mode 100755
index 0000000..de08b3b
--- /dev/null
+++ b/src/gdata/tlslite/utils/win32prng.c
@@ -0,0 +1,63 @@
+
+#include "Python.h"
+#define _WIN32_WINNT 0x0400 /* Needed for CryptoAPI on some systems */
+#include <windows.h>
+
+
+static PyObject* getRandomBytes(PyObject *self, PyObject *args)
+{
+ int howMany;
+ HCRYPTPROV hCryptProv;
+ unsigned char* bytes = NULL;
+ PyObject* returnVal = NULL;
+
+
+ /* Read Arguments */
+ if (!PyArg_ParseTuple(args, "i", &howMany))
+ return(NULL);
+
+ /* Get Context */
+ if(CryptAcquireContext(
+ &hCryptProv,
+ NULL,
+ NULL,
+ PROV_RSA_FULL,
+ CRYPT_VERIFYCONTEXT) == 0)
+ return Py_BuildValue("s#", NULL, 0);
+
+
+ /* Allocate bytes */
+ bytes = malloc(howMany);
+
+
+ /* Get random data */
+ if(CryptGenRandom(
+ hCryptProv,
+ howMany,
+ bytes) == 0)
+ returnVal = Py_BuildValue("s#", NULL, 0);
+ else
+ returnVal = Py_BuildValue("s#", bytes, howMany);
+
+ free(bytes);
+ CryptReleaseContext(hCryptProv, 0);
+
+ return returnVal;
+}
+
+
+
+/* List of functions exported by this module */
+
+static struct PyMethodDef win32prng_functions[] = {
+ {"getRandomBytes", (PyCFunction)getRandomBytes, METH_VARARGS},
+ {NULL, NULL} /* Sentinel */
+};
+
+
+/* Initialize this module. */
+
+DL_EXPORT(void) initwin32prng(void)
+{
+ Py_InitModule("win32prng", win32prng_functions);
+}
diff --git a/src/gdata/tlslite/utils/xmltools.py b/src/gdata/tlslite/utils/xmltools.py
new file mode 100755
index 0000000..c1e8c4d
--- /dev/null
+++ b/src/gdata/tlslite/utils/xmltools.py
@@ -0,0 +1,202 @@
+"""Helper functions for XML.
+
+This module has misc. helper functions for working with XML DOM nodes."""
+
+from compat import *
+import os
+import re
+
+if os.name == "java":
+ # Only for Jython
+ from javax.xml.parsers import *
+ import java
+
+ builder = DocumentBuilderFactory.newInstance().newDocumentBuilder()
+
+ def parseDocument(s):
+ stream = java.io.ByteArrayInputStream(java.lang.String(s).getBytes())
+ return builder.parse(stream)
+else:
+ from xml.dom import minidom
+ from xml.sax import saxutils
+
+ def parseDocument(s):
+ return minidom.parseString(s)
+
+def parseAndStripWhitespace(s):
+ try:
+ element = parseDocument(s).documentElement
+ except BaseException, e:
+ raise SyntaxError(str(e))
+ stripWhitespace(element)
+ return element
+
+#Goes through a DOM tree and removes whitespace besides child elements,
+#as long as this whitespace is correctly tab-ified
+def stripWhitespace(element, tab=0):
+ element.normalize()
+
+ lastSpacer = "\n" + ("\t"*tab)
+ spacer = lastSpacer + "\t"
+
+ #Zero children aren't allowed (i.e. <empty/>)
+ #This makes writing output simpler, and matches Canonical XML
+ if element.childNodes.length==0: #DON'T DO len(element.childNodes) - doesn't work in Jython
+ raise SyntaxError("Empty XML elements not allowed")
+
+ #If there's a single child, it must be text context
+ if element.childNodes.length==1:
+ if element.firstChild.nodeType == element.firstChild.TEXT_NODE:
+ #If it's an empty element, remove
+ if element.firstChild.data == lastSpacer:
+ element.removeChild(element.firstChild)
+ return
+ #If not text content, give an error
+ elif element.firstChild.nodeType == element.firstChild.ELEMENT_NODE:
+ raise SyntaxError("Bad whitespace under '%s'" % element.tagName)
+ else:
+ raise SyntaxError("Unexpected node type in XML document")
+
+ #Otherwise there's multiple child element
+ child = element.firstChild
+ while child:
+ if child.nodeType == child.ELEMENT_NODE:
+ stripWhitespace(child, tab+1)
+ child = child.nextSibling
+ elif child.nodeType == child.TEXT_NODE:
+ if child == element.lastChild:
+ if child.data != lastSpacer:
+ raise SyntaxError("Bad whitespace under '%s'" % element.tagName)
+ elif child.data != spacer:
+ raise SyntaxError("Bad whitespace under '%s'" % element.tagName)
+ next = child.nextSibling
+ element.removeChild(child)
+ child = next
+ else:
+ raise SyntaxError("Unexpected node type in XML document")
+
+
+def checkName(element, name):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Missing element: '%s'" % name)
+
+ if name == None:
+ return
+
+ if element.tagName != name:
+ raise SyntaxError("Wrong element name: should be '%s', is '%s'" % (name, element.tagName))
+
+def getChild(element, index, name=None):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in getChild()")
+
+ child = element.childNodes.item(index)
+ if child == None:
+ raise SyntaxError("Missing child: '%s'" % name)
+ checkName(child, name)
+ return child
+
+def getChildIter(element, index):
+ class ChildIter:
+ def __init__(self, element, index):
+ self.element = element
+ self.index = index
+
+ def next(self):
+ if self.index < len(self.element.childNodes):
+ retVal = self.element.childNodes.item(self.index)
+ self.index += 1
+ else:
+ retVal = None
+ return retVal
+
+ def checkEnd(self):
+ if self.index != len(self.element.childNodes):
+ raise SyntaxError("Too many elements under: '%s'" % self.element.tagName)
+ return ChildIter(element, index)
+
+def getChildOrNone(element, index):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in getChild()")
+ child = element.childNodes.item(index)
+ return child
+
+def getLastChild(element, index, name=None):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in getLastChild()")
+
+ child = element.childNodes.item(index)
+ if child == None:
+ raise SyntaxError("Missing child: '%s'" % name)
+ if child != element.lastChild:
+ raise SyntaxError("Too many elements under: '%s'" % element.tagName)
+ checkName(child, name)
+ return child
+
+#Regular expressions for syntax-checking attribute and element content
+nsRegEx = "http://trevp.net/cryptoID\Z"
+cryptoIDRegEx = "([a-km-z3-9]{5}\.){3}[a-km-z3-9]{5}\Z"
+urlRegEx = "http(s)?://.{1,100}\Z"
+sha1Base64RegEx = "[A-Za-z0-9+/]{27}=\Z"
+base64RegEx = "[A-Za-z0-9+/]+={0,4}\Z"
+certsListRegEx = "(0)?(1)?(2)?(3)?(4)?(5)?(6)?(7)?(8)?(9)?\Z"
+keyRegEx = "[A-Z]\Z"
+keysListRegEx = "(A)?(B)?(C)?(D)?(E)?(F)?(G)?(H)?(I)?(J)?(K)?(L)?(M)?(N)?(O)?(P)?(Q)?(R)?(S)?(T)?(U)?(V)?(W)?(X)?(Y)?(Z)?\Z"
+dateTimeRegEx = "\d\d\d\d-\d\d-\d\dT\d\d:\d\d:\d\dZ\Z"
+shortStringRegEx = ".{1,100}\Z"
+exprRegEx = "[a-zA-Z0-9 ,()]{1,200}\Z"
+notAfterDeltaRegEx = "0|([1-9][0-9]{0,8})\Z" #A number from 0 to (1 billion)-1
+booleanRegEx = "(true)|(false)"
+
+def getReqAttribute(element, attrName, regEx=""):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in getReqAttribute()")
+
+ value = element.getAttribute(attrName)
+ if not value:
+ raise SyntaxError("Missing Attribute: " + attrName)
+ if not re.match(regEx, value):
+ raise SyntaxError("Bad Attribute Value for '%s': '%s' " % (attrName, value))
+ element.removeAttribute(attrName)
+ return str(value) #de-unicode it; this is needed for bsddb, for example
+
+def getAttribute(element, attrName, regEx=""):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in getAttribute()")
+
+ value = element.getAttribute(attrName)
+ if value:
+ if not re.match(regEx, value):
+ raise SyntaxError("Bad Attribute Value for '%s': '%s' " % (attrName, value))
+ element.removeAttribute(attrName)
+ return str(value) #de-unicode it; this is needed for bsddb, for example
+
+def checkNoMoreAttributes(element):
+ if element.nodeType != element.ELEMENT_NODE:
+ raise SyntaxError("Wrong node type in checkNoMoreAttributes()")
+
+ if element.attributes.length!=0:
+ raise SyntaxError("Extra attributes on '%s'" % element.tagName)
+
+def getText(element, regEx=""):
+ textNode = element.firstChild
+ if textNode == None:
+ raise SyntaxError("Empty element '%s'" % element.tagName)
+ if textNode.nodeType != textNode.TEXT_NODE:
+ raise SyntaxError("Non-text node: '%s'" % element.tagName)
+ if not re.match(regEx, textNode.data):
+ raise SyntaxError("Bad Text Value for '%s': '%s' " % (element.tagName, textNode.data))
+ return str(textNode.data) #de-unicode it; this is needed for bsddb, for example
+
+#Function for adding tabs to a string
+def indent(s, steps, ch="\t"):
+ tabs = ch*steps
+ if s[-1] != "\n":
+ s = tabs + s.replace("\n", "\n"+tabs)
+ else:
+ s = tabs + s.replace("\n", "\n"+tabs)
+ s = s[ : -len(tabs)]
+ return s
+
+def escape(s):
+ return saxutils.escape(s)
diff --git a/src/gdata/urlfetch.py b/src/gdata/urlfetch.py
new file mode 100644
index 0000000..890b257
--- /dev/null
+++ b/src/gdata/urlfetch.py
@@ -0,0 +1,247 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Provides HTTP functions for gdata.service to use on Google App Engine
+
+AppEngineHttpClient: Provides an HTTP request method which uses App Engine's
+ urlfetch API. Set the http_client member of a GDataService object to an
+ instance of an AppEngineHttpClient to allow the gdata library to run on
+ Google App Engine.
+
+run_on_appengine: Function which will modify an existing GDataService object
+ to allow it to run on App Engine. It works by creating a new instance of
+ the AppEngineHttpClient and replacing the GDataService object's
+ http_client.
+
+HttpRequest: Function that wraps google.appengine.api.urlfetch.Fetch in a
+ common interface which is used by gdata.service.GDataService. In other
+ words, this module can be used as the gdata service request handler so
+ that all HTTP requests will be performed by the hosting Google App Engine
+ server.
+"""
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import StringIO
+import atom.service
+import atom.http_interface
+from google.appengine.api import urlfetch
+
+
+def run_on_appengine(gdata_service):
+ """Modifies a GDataService object to allow it to run on App Engine.
+
+ Args:
+ gdata_service: An instance of AtomService, GDataService, or any
+ of their subclasses which has an http_client member.
+ """
+ gdata_service.http_client = AppEngineHttpClient()
+
+
+class AppEngineHttpClient(atom.http_interface.GenericHttpClient):
+ def __init__(self, headers=None):
+ self.debug = False
+ self.headers = headers or {}
+
+ def request(self, operation, url, data=None, headers=None):
+ """Performs an HTTP call to the server, supports GET, POST, PUT, and
+ DELETE.
+
+ Usage example, perform and HTTP GET on http://www.google.com/:
+ import atom.http
+ client = atom.http.HttpClient()
+ http_response = client.request('GET', 'http://www.google.com/')
+
+ Args:
+ operation: str The HTTP operation to be performed. This is usually one
+ of 'GET', 'POST', 'PUT', or 'DELETE'
+ data: filestream, list of parts, or other object which can be converted
+ to a string. Should be set to None when performing a GET or DELETE.
+ If data is a file-like object which can be read, this method will
+ read a chunk of 100K bytes at a time and send them.
+ If the data is a list of parts to be sent, each part will be
+ evaluated and sent.
+ url: The full URL to which the request should be sent. Can be a string
+ or atom.url.Url.
+ headers: dict of strings. HTTP headers which should be sent
+ in the request.
+ """
+ all_headers = self.headers.copy()
+ if headers:
+ all_headers.update(headers)
+
+ # Construct the full payload.
+ # Assume that data is None or a string.
+ data_str = data
+ if data:
+ if isinstance(data, list):
+ # If data is a list of different objects, convert them all to strings
+ # and join them together.
+ converted_parts = [__ConvertDataPart(x) for x in data]
+ data_str = ''.join(converted_parts)
+ else:
+ data_str = __ConvertDataPart(data)
+
+ # If the list of headers does not include a Content-Length, attempt to
+ # calculate it based on the data object.
+ if data and 'Content-Length' not in all_headers:
+ all_headers['Content-Length'] = len(data_str)
+
+ # Set the content type to the default value if none was set.
+ if 'Content-Type' not in all_headers:
+ all_headers['Content-Type'] = 'application/atom+xml'
+
+ # Lookup the urlfetch operation which corresponds to the desired HTTP verb.
+ if operation == 'GET':
+ method = urlfetch.GET
+ elif operation == 'POST':
+ method = urlfetch.POST
+ elif operation == 'PUT':
+ method = urlfetch.PUT
+ elif operation == 'DELETE':
+ method = urlfetch.DELETE
+ else:
+ method = None
+ return HttpResponse(urlfetch.Fetch(url=str(url), payload=data_str,
+ method=method, headers=all_headers))
+
+
+def HttpRequest(service, operation, data, uri, extra_headers=None,
+ url_params=None, escape_params=True, content_type='application/atom+xml'):
+ """Performs an HTTP call to the server, supports GET, POST, PUT, and DELETE.
+
+ This function is deprecated, use AppEngineHttpClient.request instead.
+
+ To use this module with gdata.service, you can set this module to be the
+ http_request_handler so that HTTP requests use Google App Engine's urlfetch.
+ import gdata.service
+ import gdata.urlfetch
+ gdata.service.http_request_handler = gdata.urlfetch
+
+ Args:
+ service: atom.AtomService object which contains some of the parameters
+ needed to make the request. The following members are used to
+ construct the HTTP call: server (str), additional_headers (dict),
+ port (int), and ssl (bool).
+ operation: str The HTTP operation to be performed. This is usually one of
+ 'GET', 'POST', 'PUT', or 'DELETE'
+ data: filestream, list of parts, or other object which can be
+ converted to a string.
+ Should be set to None when performing a GET or PUT.
+ If data is a file-like object which can be read, this method will read
+ a chunk of 100K bytes at a time and send them.
+ If the data is a list of parts to be sent, each part will be evaluated
+ and sent.
+ uri: The beginning of the URL to which the request should be sent.
+ Examples: '/', '/base/feeds/snippets',
+ '/m8/feeds/contacts/default/base'
+ extra_headers: dict of strings. HTTP headers which should be sent
+ in the request. These headers are in addition to those stored in
+ service.additional_headers.
+ url_params: dict of strings. Key value pairs to be added to the URL as
+ URL parameters. For example {'foo':'bar', 'test':'param'} will
+ become ?foo=bar&test=param.
+ escape_params: bool default True. If true, the keys and values in
+ url_params will be URL escaped when the form is constructed
+ (Special characters converted to %XX form.)
+ content_type: str The MIME type for the data being sent. Defaults to
+ 'application/atom+xml', this is only used if data is set.
+ """
+ full_uri = atom.service.BuildUri(uri, url_params, escape_params)
+ (server, port, ssl, partial_uri) = atom.service.ProcessUrl(service, full_uri)
+ # Construct the full URL for the request.
+ if ssl:
+ full_url = 'https://%s%s' % (server, partial_uri)
+ else:
+ full_url = 'http://%s%s' % (server, partial_uri)
+
+ # Construct the full payload.
+ # Assume that data is None or a string.
+ data_str = data
+ if data:
+ if isinstance(data, list):
+ # If data is a list of different objects, convert them all to strings
+ # and join them together.
+ converted_parts = [__ConvertDataPart(x) for x in data]
+ data_str = ''.join(converted_parts)
+ else:
+ data_str = __ConvertDataPart(data)
+
+ # Construct the dictionary of HTTP headers.
+ headers = {}
+ if isinstance(service.additional_headers, dict):
+ headers = service.additional_headers.copy()
+ if isinstance(extra_headers, dict):
+ for header, value in extra_headers.iteritems():
+ headers[header] = value
+ # Add the content type header (we don't need to calculate content length,
+ # since urlfetch.Fetch will calculate for us).
+ if content_type:
+ headers['Content-Type'] = content_type
+
+ # Lookup the urlfetch operation which corresponds to the desired HTTP verb.
+ if operation == 'GET':
+ method = urlfetch.GET
+ elif operation == 'POST':
+ method = urlfetch.POST
+ elif operation == 'PUT':
+ method = urlfetch.PUT
+ elif operation == 'DELETE':
+ method = urlfetch.DELETE
+ else:
+ method = None
+ return HttpResponse(urlfetch.Fetch(url=full_url, payload=data_str,
+ method=method, headers=headers))
+
+
+def __ConvertDataPart(data):
+ if not data or isinstance(data, str):
+ return data
+ elif hasattr(data, 'read'):
+ # data is a file like object, so read it completely.
+ return data.read()
+ # The data object was not a file.
+ # Try to convert to a string and send the data.
+ return str(data)
+
+
+class HttpResponse(object):
+ """Translates a urlfetch resoinse to look like an hhtplib resoinse.
+
+ Used to allow the resoinse from HttpRequest to be usable by gdata.service
+ methods.
+ """
+
+ def __init__(self, urlfetch_response):
+ self.body = StringIO.StringIO(urlfetch_response.content)
+ self.headers = urlfetch_response.headers
+ self.status = urlfetch_response.status_code
+ self.reason = ''
+
+ def read(self, length=None):
+ if not length:
+ return self.body.read()
+ else:
+ return self.body.read(length)
+
+ def getheader(self, name):
+ if not self.headers.has_key(name):
+ return self.headers[name.lower()]
+ return self.headers[name]
+
diff --git a/src/gdata/webmastertools/__init__.py b/src/gdata/webmastertools/__init__.py
new file mode 100644
index 0000000..7ad20ff
--- /dev/null
+++ b/src/gdata/webmastertools/__init__.py
@@ -0,0 +1,544 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Yu-Jie Lin
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains extensions to Atom objects used with Google Webmaster Tools."""
+
+
+__author__ = 'livibetter (Yu-Jie Lin)'
+
+
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import atom
+import gdata
+
+
+# XML namespaces which are often used in Google Webmaster Tools entities.
+GWEBMASTERTOOLS_NAMESPACE = 'http://schemas.google.com/webmasters/tools/2007'
+GWEBMASTERTOOLS_TEMPLATE = '{http://schemas.google.com/webmasters/tools/2007}%s'
+
+
+class Indexed(atom.AtomBase):
+ _tag = 'indexed'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def IndexedFromString(xml_string):
+ return atom.CreateClassFromXMLString(Indexed, xml_string)
+
+
+class Crawled(atom.Date):
+ _tag = 'crawled'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def CrawledFromString(xml_string):
+ return atom.CreateClassFromXMLString(Crawled, xml_string)
+
+
+class GeoLocation(atom.AtomBase):
+ _tag = 'geolocation'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def GeoLocationFromString(xml_string):
+ return atom.CreateClassFromXMLString(GeoLocation, xml_string)
+
+
+class PreferredDomain(atom.AtomBase):
+ _tag = 'preferred-domain'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def PreferredDomainFromString(xml_string):
+ return atom.CreateClassFromXMLString(PreferredDomain, xml_string)
+
+
+class CrawlRate(atom.AtomBase):
+ _tag = 'crawl-rate'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def CrawlRateFromString(xml_string):
+ return atom.CreateClassFromXMLString(CrawlRate, xml_string)
+
+
+class EnhancedImageSearch(atom.AtomBase):
+ _tag = 'enhanced-image-search'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def EnhancedImageSearchFromString(xml_string):
+ return atom.CreateClassFromXMLString(EnhancedImageSearch, xml_string)
+
+
+class Verified(atom.AtomBase):
+ _tag = 'verified'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def VerifiedFromString(xml_string):
+ return atom.CreateClassFromXMLString(Verified, xml_string)
+
+
+class VerificationMethodMeta(atom.AtomBase):
+ _tag = 'meta'
+ _namespace = atom.ATOM_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['name'] = 'name'
+ _attributes['content'] = 'content'
+
+ def __init__(self, text=None, name=None, content=None,
+ extension_elements=None, extension_attributes=None):
+ self.text = text
+ self.name = name
+ self.content = content
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def VerificationMethodMetaFromString(xml_string):
+ return atom.CreateClassFromXMLString(VerificationMethodMeta, xml_string)
+
+
+class VerificationMethod(atom.AtomBase):
+ _tag = 'verification-method'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+ _children = atom.Text._children.copy()
+ _attributes = atom.Text._attributes.copy()
+ _children['{%s}meta' % atom.ATOM_NAMESPACE] = (
+ 'meta', VerificationMethodMeta)
+ _attributes['in-use'] = 'in_use'
+ _attributes['type'] = 'type'
+
+ def __init__(self, text=None, in_use=None, meta=None, type=None,
+ extension_elements=None, extension_attributes=None):
+ self.text = text
+ self.in_use = in_use
+ self.meta = meta
+ self.type = type
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def VerificationMethodFromString(xml_string):
+ return atom.CreateClassFromXMLString(VerificationMethod, xml_string)
+
+
+class MarkupLanguage(atom.AtomBase):
+ _tag = 'markup-language'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def MarkupLanguageFromString(xml_string):
+ return atom.CreateClassFromXMLString(MarkupLanguage, xml_string)
+
+
+class SitemapMobile(atom.AtomBase):
+ _tag = 'sitemap-mobile'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}markup-language' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'markup_language', [MarkupLanguage])
+
+ def __init__(self, markup_language=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ self.markup_language = markup_language or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SitemapMobileFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitemapMobile, xml_string)
+
+
+class SitemapMobileMarkupLanguage(atom.AtomBase):
+ _tag = 'sitemap-mobile-markup-language'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def SitemapMobileMarkupLanguageFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitemapMobileMarkupLanguage, xml_string)
+
+
+class PublicationLabel(atom.AtomBase):
+ _tag = 'publication-label'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def PublicationLabelFromString(xml_string):
+ return atom.CreateClassFromXMLString(PublicationLabel, xml_string)
+
+
+class SitemapNews(atom.AtomBase):
+ _tag = 'sitemap-news'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}publication-label' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'publication_label', [PublicationLabel])
+
+ def __init__(self, publication_label=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ self.publication_label = publication_label or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SitemapNewsFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitemapNews, xml_string)
+
+
+class SitemapNewsPublicationLabel(atom.AtomBase):
+ _tag = 'sitemap-news-publication-label'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def SitemapNewsPublicationLabelFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitemapNewsPublicationLabel, xml_string)
+
+
+class SitemapLastDownloaded(atom.Date):
+ _tag = 'sitemap-last-downloaded'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def SitemapLastDownloadedFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitemapLastDownloaded, xml_string)
+
+
+class SitemapType(atom.AtomBase):
+ _tag = 'sitemap-type'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def SitemapTypeFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitemapType, xml_string)
+
+
+class SitemapStatus(atom.AtomBase):
+ _tag = 'sitemap-status'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def SitemapStatusFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitemapStatus, xml_string)
+
+
+class SitemapUrlCount(atom.AtomBase):
+ _tag = 'sitemap-url-count'
+ _namespace = GWEBMASTERTOOLS_NAMESPACE
+
+
+def SitemapUrlCountFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitemapUrlCount, xml_string)
+
+
+class LinkFinder(atom.LinkFinder):
+ """An "interface" providing methods to find link elements
+
+ SitesEntry elements often contain multiple links which differ in the rel
+ attribute or content type. Often, developers are interested in a specific
+ type of link so this class provides methods to find specific classes of links.
+
+ This class is used as a mixin in SitesEntry.
+ """
+
+ def GetSelfLink(self):
+ """Find the first link with rel set to 'self'
+
+ Returns:
+ An atom.Link or none if none of the links had rel equal to 'self'
+ """
+
+ for a_link in self.link:
+ if a_link.rel == 'self':
+ return a_link
+ return None
+
+ def GetEditLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'edit':
+ return a_link
+ return None
+
+ def GetPostLink(self):
+ """Get a link containing the POST target URL.
+
+ The POST target URL is used to insert new entries.
+
+ Returns:
+ A link object with a rel matching the POST type.
+ """
+ for a_link in self.link:
+ if a_link.rel == 'http://schemas.google.com/g/2005#post':
+ return a_link
+ return None
+
+ def GetFeedLink(self):
+ for a_link in self.link:
+ if a_link.rel == 'http://schemas.google.com/g/2005#feed':
+ return a_link
+ return None
+
+
+class SitesEntry(atom.Entry, LinkFinder):
+ """A Google Webmaster Tools meta Entry flavor of an Atom Entry """
+
+ _tag = atom.Entry._tag
+ _namespace = atom.Entry._namespace
+ _children = atom.Entry._children.copy()
+ _attributes = atom.Entry._attributes.copy()
+ _children['{%s}entryLink' % gdata.GDATA_NAMESPACE] = (
+ 'entry_link', [gdata.EntryLink])
+ _children['{%s}indexed' % GWEBMASTERTOOLS_NAMESPACE] = ('indexed', Indexed)
+ _children['{%s}crawled' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'crawled', Crawled)
+ _children['{%s}geolocation' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'geolocation', GeoLocation)
+ _children['{%s}preferred-domain' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'preferred_domain', PreferredDomain)
+ _children['{%s}crawl-rate' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'crawl_rate', CrawlRate)
+ _children['{%s}enhanced-image-search' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'enhanced_image_search', EnhancedImageSearch)
+ _children['{%s}verified' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'verified', Verified)
+ _children['{%s}verification-method' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'verification_method', [VerificationMethod])
+
+ def __GetId(self):
+ return self.__id
+
+ # This method was created to strip the unwanted whitespace from the id's
+ # text node.
+ def __SetId(self, id):
+ self.__id = id
+ if id is not None and id.text is not None:
+ self.__id.text = id.text.strip()
+
+ id = property(__GetId, __SetId)
+
+ def __init__(self, category=None, content=None,
+ atom_id=None, link=None, title=None, updated=None,
+ entry_link=None, indexed=None, crawled=None,
+ geolocation=None, preferred_domain=None, crawl_rate=None,
+ enhanced_image_search=None,
+ verified=None, verification_method=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ atom.Entry.__init__(self, category=category,
+ content=content, atom_id=atom_id, link=link,
+ title=title, updated=updated, text=text)
+
+ self.entry_link = entry_link or []
+ self.indexed = indexed
+ self.crawled = crawled
+ self.geolocation = geolocation
+ self.preferred_domain = preferred_domain
+ self.crawl_rate = crawl_rate
+ self.enhanced_image_search = enhanced_image_search
+ self.verified = verified
+ self.verification_method = verification_method or []
+
+
+def SitesEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitesEntry, xml_string)
+
+
+class SitesFeed(atom.Feed, LinkFinder):
+ """A Google Webmaster Tools meta Sites feed flavor of an Atom Feed"""
+
+ _tag = atom.Feed._tag
+ _namespace = atom.Feed._namespace
+ _children = atom.Feed._children.copy()
+ _attributes = atom.Feed._attributes.copy()
+ _children['{%s}startIndex' % gdata.OPENSEARCH_NAMESPACE] = (
+ 'start_index', gdata.StartIndex)
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [SitesEntry])
+ del _children['{%s}generator' % atom.ATOM_NAMESPACE]
+ del _children['{%s}author' % atom.ATOM_NAMESPACE]
+ del _children['{%s}contributor' % atom.ATOM_NAMESPACE]
+ del _children['{%s}logo' % atom.ATOM_NAMESPACE]
+ del _children['{%s}icon' % atom.ATOM_NAMESPACE]
+ del _children['{%s}rights' % atom.ATOM_NAMESPACE]
+ del _children['{%s}subtitle' % atom.ATOM_NAMESPACE]
+
+ def __GetId(self):
+ return self.__id
+
+ def __SetId(self, id):
+ self.__id = id
+ if id is not None and id.text is not None:
+ self.__id.text = id.text.strip()
+
+ id = property(__GetId, __SetId)
+
+ def __init__(self, start_index=None, atom_id=None, title=None, entry=None,
+ category=None, link=None, updated=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ """Constructor for Source
+
+ Args:
+ category: list (optional) A list of Category instances
+ id: Id (optional) The entry's Id element
+ link: list (optional) A list of Link instances
+ title: Title (optional) the entry's title element
+ updated: Updated (optional) the entry's updated element
+ entry: list (optional) A list of the Entry instances contained in the
+ feed.
+ text: String (optional) The text contents of the element. This is the
+ contents of the Entry's XML text node.
+ (Example: <foo>This is the text</foo>)
+ extension_elements: list (optional) A list of ExtensionElement instances
+ which are children of this element.
+ extension_attributes: dict (optional) A dictionary of strings which are
+ the values for additional XML attributes of this element.
+ """
+
+ self.start_index = start_index
+ self.category = category or []
+ self.id = atom_id
+ self.link = link or []
+ self.title = title
+ self.updated = updated
+ self.entry = entry or []
+ self.text = text
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SitesFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitesFeed, xml_string)
+
+
+class SitemapsEntry(atom.Entry, LinkFinder):
+ """A Google Webmaster Tools meta Sitemaps Entry flavor of an Atom Entry """
+
+ _tag = atom.Entry._tag
+ _namespace = atom.Entry._namespace
+ _children = atom.Entry._children.copy()
+ _attributes = atom.Entry._attributes.copy()
+ _children['{%s}sitemap-type' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'sitemap_type', SitemapType)
+ _children['{%s}sitemap-status' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'sitemap_status', SitemapStatus)
+ _children['{%s}sitemap-last-downloaded' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'sitemap_last_downloaded', SitemapLastDownloaded)
+ _children['{%s}sitemap-url-count' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'sitemap_url_count', SitemapUrlCount)
+ _children['{%s}sitemap-mobile-markup-language' % GWEBMASTERTOOLS_NAMESPACE] \
+ = ('sitemap_mobile_markup_language', SitemapMobileMarkupLanguage)
+ _children['{%s}sitemap-news-publication-label' % GWEBMASTERTOOLS_NAMESPACE] \
+ = ('sitemap_news_publication_label', SitemapNewsPublicationLabel)
+
+ def __GetId(self):
+ return self.__id
+
+ # This method was created to strip the unwanted whitespace from the id's
+ # text node.
+ def __SetId(self, id):
+ self.__id = id
+ if id is not None and id.text is not None:
+ self.__id.text = id.text.strip()
+
+ id = property(__GetId, __SetId)
+
+ def __init__(self, category=None, content=None,
+ atom_id=None, link=None, title=None, updated=None,
+ sitemap_type=None, sitemap_status=None, sitemap_last_downloaded=None,
+ sitemap_url_count=None, sitemap_mobile_markup_language=None,
+ sitemap_news_publication_label=None,
+ extension_elements=None, extension_attributes=None, text=None):
+ atom.Entry.__init__(self, category=category,
+ content=content, atom_id=atom_id, link=link,
+ title=title, updated=updated, text=text)
+
+ self.sitemap_type = sitemap_type
+ self.sitemap_status = sitemap_status
+ self.sitemap_last_downloaded = sitemap_last_downloaded
+ self.sitemap_url_count = sitemap_url_count
+ self.sitemap_mobile_markup_language = sitemap_mobile_markup_language
+ self.sitemap_news_publication_label = sitemap_news_publication_label
+
+
+def SitemapsEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitemapsEntry, xml_string)
+
+
+class SitemapsFeed(atom.Feed, LinkFinder):
+ """A Google Webmaster Tools meta Sitemaps feed flavor of an Atom Feed"""
+
+ _tag = atom.Feed._tag
+ _namespace = atom.Feed._namespace
+ _children = atom.Feed._children.copy()
+ _attributes = atom.Feed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [SitemapsEntry])
+ _children['{%s}sitemap-mobile' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'sitemap_mobile', SitemapMobile)
+ _children['{%s}sitemap-news' % GWEBMASTERTOOLS_NAMESPACE] = (
+ 'sitemap_news', SitemapNews)
+ del _children['{%s}generator' % atom.ATOM_NAMESPACE]
+ del _children['{%s}author' % atom.ATOM_NAMESPACE]
+ del _children['{%s}contributor' % atom.ATOM_NAMESPACE]
+ del _children['{%s}logo' % atom.ATOM_NAMESPACE]
+ del _children['{%s}icon' % atom.ATOM_NAMESPACE]
+ del _children['{%s}rights' % atom.ATOM_NAMESPACE]
+ del _children['{%s}subtitle' % atom.ATOM_NAMESPACE]
+
+ def __GetId(self):
+ return self.__id
+
+ def __SetId(self, id):
+ self.__id = id
+ if id is not None and id.text is not None:
+ self.__id.text = id.text.strip()
+
+ id = property(__GetId, __SetId)
+
+ def __init__(self, category=None, content=None,
+ atom_id=None, link=None, title=None, updated=None,
+ entry=None, sitemap_mobile=None, sitemap_news=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ self.category = category or []
+ self.id = atom_id
+ self.link = link or []
+ self.title = title
+ self.updated = updated
+ self.entry = entry or []
+ self.text = text
+ self.sitemap_mobile = sitemap_mobile
+ self.sitemap_news = sitemap_news
+ self.extension_elements = extension_elements or []
+ self.extension_attributes = extension_attributes or {}
+
+
+def SitemapsFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(SitemapsFeed, xml_string)
diff --git a/src/gdata/webmastertools/data.py b/src/gdata/webmastertools/data.py
new file mode 100644
index 0000000..8b50a47
--- /dev/null
+++ b/src/gdata/webmastertools/data.py
@@ -0,0 +1,217 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains the data classes of the Google Webmaster Tools Data API"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+import atom.data
+import gdata.data
+import gdata.opensearch.data
+
+
+WT_TEMPLATE = '{http://schemas.google.com/webmaster/tools/2007/}%s'
+
+
+class CrawlIssueCrawlType(atom.core.XmlElement):
+ """Type of crawl of the crawl issue"""
+ _qname = WT_TEMPLATE % 'crawl-type'
+
+
+class CrawlIssueDateDetected(atom.core.XmlElement):
+ """Detection date for the issue"""
+ _qname = WT_TEMPLATE % 'date-detected'
+
+
+class CrawlIssueDetail(atom.core.XmlElement):
+ """Detail of the crawl issue"""
+ _qname = WT_TEMPLATE % 'detail'
+
+
+class CrawlIssueIssueType(atom.core.XmlElement):
+ """Type of crawl issue"""
+ _qname = WT_TEMPLATE % 'issue-type'
+
+
+class CrawlIssueLinkedFromUrl(atom.core.XmlElement):
+ """Source URL that links to the issue URL"""
+ _qname = WT_TEMPLATE % 'linked-from'
+
+
+class CrawlIssueUrl(atom.core.XmlElement):
+ """URL affected by the crawl issue"""
+ _qname = WT_TEMPLATE % 'url'
+
+
+class CrawlIssueEntry(gdata.data.GDEntry):
+ """Describes a crawl issue entry"""
+ date_detected = CrawlIssueDateDetected
+ url = CrawlIssueUrl
+ detail = CrawlIssueDetail
+ issue_type = CrawlIssueIssueType
+ crawl_type = CrawlIssueCrawlType
+ linked_from = [CrawlIssueLinkedFromUrl]
+
+
+class CrawlIssuesFeed(gdata.data.GDFeed):
+ """Feed of crawl issues for a particular site"""
+ entry = [CrawlIssueEntry]
+
+
+class Indexed(atom.core.XmlElement):
+ """Describes the indexing status of a site"""
+ _qname = WT_TEMPLATE % 'indexed'
+
+
+class Keyword(atom.core.XmlElement):
+ """A keyword in a site or in a link to a site"""
+ _qname = WT_TEMPLATE % 'keyword'
+ source = 'source'
+
+
+class KeywordEntry(gdata.data.GDEntry):
+ """Describes a keyword entry"""
+
+
+class KeywordsFeed(gdata.data.GDFeed):
+ """Feed of keywords for a particular site"""
+ entry = [KeywordEntry]
+ keyword = [Keyword]
+
+
+class LastCrawled(atom.core.XmlElement):
+ """Describes the last crawled date of a site"""
+ _qname = WT_TEMPLATE % 'last-crawled'
+
+
+class MessageBody(atom.core.XmlElement):
+ """Message body"""
+ _qname = WT_TEMPLATE % 'body'
+
+
+class MessageDate(atom.core.XmlElement):
+ """Message date"""
+ _qname = WT_TEMPLATE % 'date'
+
+
+class MessageLanguage(atom.core.XmlElement):
+ """Message language"""
+ _qname = WT_TEMPLATE % 'language'
+
+
+class MessageRead(atom.core.XmlElement):
+ """Indicates if the message has already been read"""
+ _qname = WT_TEMPLATE % 'read'
+
+
+class MessageSubject(atom.core.XmlElement):
+ """Message subject"""
+ _qname = WT_TEMPLATE % 'subject'
+
+
+class SiteId(atom.core.XmlElement):
+ """Site URL"""
+ _qname = WT_TEMPLATE % 'id'
+
+
+class MessageEntry(gdata.data.GDEntry):
+ """Describes a message entry"""
+ wt_id = SiteId
+ subject = MessageSubject
+ date = MessageDate
+ body = MessageBody
+ language = MessageLanguage
+ read = MessageRead
+
+
+class MessagesFeed(gdata.data.GDFeed):
+ """Describes a messages feed"""
+ entry = [MessageEntry]
+
+
+class SitemapEntry(gdata.data.GDEntry):
+ """Describes a sitemap entry"""
+ indexed = Indexed
+ wt_id = SiteId
+
+
+class SitemapMobileMarkupLanguage(atom.core.XmlElement):
+ """Describes a markup language for URLs in this sitemap"""
+ _qname = WT_TEMPLATE % 'sitemap-mobile-markup-language'
+
+
+class SitemapMobile(atom.core.XmlElement):
+ """Lists acceptable mobile markup languages for URLs in this sitemap"""
+ _qname = WT_TEMPLATE % 'sitemap-mobile'
+ sitemap_mobile_markup_language = [SitemapMobileMarkupLanguage]
+
+
+class SitemapNewsPublicationLabel(atom.core.XmlElement):
+ """Specifies the publication label for this sitemap"""
+ _qname = WT_TEMPLATE % 'sitemap-news-publication-label'
+
+
+class SitemapNews(atom.core.XmlElement):
+ """Lists publication labels for this sitemap"""
+ _qname = WT_TEMPLATE % 'sitemap-news'
+ sitemap_news_publication_label = [SitemapNewsPublicationLabel]
+
+
+class SitemapType(atom.core.XmlElement):
+ """Indicates the type of sitemap. Not used for News or Mobile Sitemaps"""
+ _qname = WT_TEMPLATE % 'sitemap-type'
+
+
+class SitemapUrlCount(atom.core.XmlElement):
+ """Indicates the number of URLs contained in the sitemap"""
+ _qname = WT_TEMPLATE % 'sitemap-url-count'
+
+
+class SitemapsFeed(gdata.data.GDFeed):
+ """Describes a sitemaps feed"""
+ entry = [SitemapEntry]
+
+
+class VerificationMethod(atom.core.XmlElement):
+ """Describes a verification method that may be used for a site"""
+ _qname = WT_TEMPLATE % 'verification-method'
+ in_use = 'in-use'
+ type = 'type'
+
+
+class Verified(atom.core.XmlElement):
+ """Describes the verification status of a site"""
+ _qname = WT_TEMPLATE % 'verified'
+
+
+class SiteEntry(gdata.data.GDEntry):
+ """Describes a site entry"""
+ indexed = Indexed
+ wt_id = SiteId
+ verified = Verified
+ last_crawled = LastCrawled
+ verification_method = [VerificationMethod]
+
+
+class SitesFeed(gdata.data.GDFeed):
+ """Describes a sites feed"""
+ entry = [SiteEntry]
+
+
diff --git a/src/gdata/webmastertools/service.py b/src/gdata/webmastertools/service.py
new file mode 100644
index 0000000..8c3286d
--- /dev/null
+++ b/src/gdata/webmastertools/service.py
@@ -0,0 +1,516 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Yu-Jie Lin
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""GWebmasterToolsService extends the GDataService to streamline
+Google Webmaster Tools operations.
+
+ GWebmasterToolsService: Provides methods to query feeds and manipulate items.
+ Extends GDataService.
+"""
+
+__author__ = 'livibetter (Yu-Jie Lin)'
+
+import urllib
+import gdata
+import atom.service
+import gdata.service
+import gdata.webmastertools as webmastertools
+import atom
+
+
+FEED_BASE = 'https://www.google.com/webmasters/tools/feeds/'
+SITES_FEED = FEED_BASE + 'sites/'
+SITE_TEMPLATE = SITES_FEED + '%s'
+SITEMAPS_FEED_TEMPLATE = FEED_BASE + '%(site_id)s/sitemaps/'
+SITEMAP_TEMPLATE = SITEMAPS_FEED_TEMPLATE + '%(sitemap_id)s'
+
+
+class Error(Exception):
+ pass
+
+
+class RequestError(Error):
+ pass
+
+
+class GWebmasterToolsService(gdata.service.GDataService):
+ """Client for the Google Webmaster Tools service."""
+
+ def __init__(self, email=None, password=None, source=None,
+ server='www.google.com', **kwargs):
+ """Creates a client for the Google Webmaster Tools service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'www.google.com'.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service='sitemaps', source=source,
+ server=server, **kwargs)
+
+ def GetSitesFeed(self, uri=SITES_FEED,
+ converter=webmastertools.SitesFeedFromString):
+ """Gets sites feed.
+
+ Args:
+ uri: str (optional) URI to retrieve sites feed.
+ converter: func (optional) Function which is executed on the server's
+ response before it is returned. Usually this is a function like
+ SitesFeedFromString which will parse the response and turn it into
+ an object.
+
+ Returns:
+ If converter is defined, the results of running converter on the server's
+ response. Otherwise, it will be a SitesFeed object.
+ """
+ return self.Get(uri, converter=converter)
+
+ def AddSite(self, site_uri, uri=SITES_FEED,
+ url_params=None, escape_params=True, converter=None):
+ """Adds a site to Google Webmaster Tools.
+
+ Args:
+ site_uri: str URI of which site to add.
+ uri: str (optional) URI to add a site.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+ converter: func (optional) Function which is executed on the server's
+ response before it is returned. Usually this is a function like
+ SitesEntryFromString which will parse the response and turn it into
+ an object.
+
+ Returns:
+ If converter is defined, the results of running converter on the server's
+ response. Otherwise, it will be a SitesEntry object.
+ """
+
+ site_entry = webmastertools.SitesEntry()
+ site_entry.content = atom.Content(src=site_uri)
+ response = self.Post(site_entry, uri,
+ url_params=url_params,
+ escape_params=escape_params, converter=converter)
+ if not converter and isinstance(response, atom.Entry):
+ return webmastertools.SitesEntryFromString(response.ToString())
+ return response
+
+ def DeleteSite(self, site_uri, uri=SITE_TEMPLATE,
+ url_params=None, escape_params=True):
+ """Removes a site from Google Webmaster Tools.
+
+ Args:
+ site_uri: str URI of which site to remove.
+ uri: str (optional) A URI template to send DELETE request.
+ Default SITE_TEMPLATE.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ True if the delete succeeded.
+ """
+
+ return self.Delete(
+ uri % urllib.quote_plus(site_uri),
+ url_params=url_params, escape_params=escape_params)
+
+ def VerifySite(self, site_uri, verification_method, uri=SITE_TEMPLATE,
+ url_params=None, escape_params=True, converter=None):
+ """Requests a verification of a site.
+
+ Args:
+ site_uri: str URI of which site to add sitemap for.
+ verification_method: str The method to verify a site. Valid values are
+ 'htmlpage', and 'metatag'.
+ uri: str (optional) URI template to update a site.
+ Default SITE_TEMPLATE.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+ converter: func (optional) Function which is executed on the server's
+ response before it is returned. Usually this is a function like
+ SitemapsEntryFromString which will parse the response and turn it into
+ an object.
+
+ Returns:
+ If converter is defined, the results of running converter on the server's
+ response. Otherwise, it will be a SitesEntry object.
+ """
+
+ site_entry = webmastertools.SitesEntry(
+ atom_id=atom.Id(text=site_uri),
+ category=atom.Category(
+ scheme='http://schemas.google.com/g/2005#kind',
+ term='http://schemas.google.com/webmasters/tools/2007#sites-info'),
+ verification_method=webmastertools.VerificationMethod(
+ type=verification_method, in_use='true')
+ )
+ response = self.Put(
+ site_entry,
+ uri % urllib.quote_plus(site_uri),
+ url_params=url_params,
+ escape_params=escape_params, converter=converter)
+ if not converter and isinstance(response, atom.Entry):
+ return webmastertools.SitesEntryFromString(response.ToString())
+ return response
+
+
+ def UpdateGeoLocation(self, site_uri, geolocation, uri=SITE_TEMPLATE,
+ url_params=None, escape_params=True, converter=None):
+ """Updates geolocation setting of a site.
+
+ Args:
+ site_uri: str URI of which site to add sitemap for.
+ geolocation: str The geographic location. Valid values are listed in
+ http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+ uri: str (optional) URI template to update a site.
+ Default SITE_TEMPLATE.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+ converter: func (optional) Function which is executed on the server's
+ response before it is returned. Usually this is a function like
+ SitemapsEntryFromString which will parse the response and turn it into
+ an object.
+
+ Returns:
+ If converter is defined, the results of running converter on the server's
+ response. Otherwise, it will be a SitesEntry object.
+ """
+
+ site_entry = webmastertools.SitesEntry(
+ atom_id=atom.Id(text=site_uri),
+ category=atom.Category(
+ scheme='http://schemas.google.com/g/2005#kind',
+ term='http://schemas.google.com/webmasters/tools/2007#sites-info'),
+ geolocation=webmastertools.GeoLocation(text=geolocation)
+ )
+ response = self.Put(
+ site_entry,
+ uri % urllib.quote_plus(site_uri),
+ url_params=url_params,
+ escape_params=escape_params, converter=converter)
+ if not converter and isinstance(response, atom.Entry):
+ return webmastertools.SitesEntryFromString(response.ToString())
+ return response
+
+ def UpdateCrawlRate(self, site_uri, crawl_rate, uri=SITE_TEMPLATE,
+ url_params=None, escape_params=True, converter=None):
+ """Updates crawl rate setting of a site.
+
+ Args:
+ site_uri: str URI of which site to add sitemap for.
+ crawl_rate: str The crawl rate for a site. Valid values are 'slower',
+ 'normal', and 'faster'.
+ uri: str (optional) URI template to update a site.
+ Default SITE_TEMPLATE.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+ converter: func (optional) Function which is executed on the server's
+ response before it is returned. Usually this is a function like
+ SitemapsEntryFromString which will parse the response and turn it into
+ an object.
+
+ Returns:
+ If converter is defined, the results of running converter on the server's
+ response. Otherwise, it will be a SitesEntry object.
+ """
+
+ site_entry = webmastertools.SitesEntry(
+ atom_id=atom.Id(text=site_uri),
+ category=atom.Category(
+ scheme='http://schemas.google.com/g/2005#kind',
+ term='http://schemas.google.com/webmasters/tools/2007#sites-info'),
+ crawl_rate=webmastertools.CrawlRate(text=crawl_rate)
+ )
+ response = self.Put(
+ site_entry,
+ uri % urllib.quote_plus(site_uri),
+ url_params=url_params,
+ escape_params=escape_params, converter=converter)
+ if not converter and isinstance(response, atom.Entry):
+ return webmastertools.SitesEntryFromString(response.ToString())
+ return response
+
+ def UpdatePreferredDomain(self, site_uri, preferred_domain, uri=SITE_TEMPLATE,
+ url_params=None, escape_params=True, converter=None):
+ """Updates preferred domain setting of a site.
+
+ Note that if using 'preferwww', will also need www.example.com in account to
+ take effect.
+
+ Args:
+ site_uri: str URI of which site to add sitemap for.
+ preferred_domain: str The preferred domain for a site. Valid values are 'none',
+ 'preferwww', and 'prefernowww'.
+ uri: str (optional) URI template to update a site.
+ Default SITE_TEMPLATE.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+ converter: func (optional) Function which is executed on the server's
+ response before it is returned. Usually this is a function like
+ SitemapsEntryFromString which will parse the response and turn it into
+ an object.
+
+ Returns:
+ If converter is defined, the results of running converter on the server's
+ response. Otherwise, it will be a SitesEntry object.
+ """
+
+ site_entry = webmastertools.SitesEntry(
+ atom_id=atom.Id(text=site_uri),
+ category=atom.Category(
+ scheme='http://schemas.google.com/g/2005#kind',
+ term='http://schemas.google.com/webmasters/tools/2007#sites-info'),
+ preferred_domain=webmastertools.PreferredDomain(text=preferred_domain)
+ )
+ response = self.Put(
+ site_entry,
+ uri % urllib.quote_plus(site_uri),
+ url_params=url_params,
+ escape_params=escape_params, converter=converter)
+ if not converter and isinstance(response, atom.Entry):
+ return webmastertools.SitesEntryFromString(response.ToString())
+ return response
+
+ def UpdateEnhancedImageSearch(self, site_uri, enhanced_image_search,
+ uri=SITE_TEMPLATE, url_params=None, escape_params=True, converter=None):
+ """Updates enhanced image search setting of a site.
+
+ Args:
+ site_uri: str URI of which site to add sitemap for.
+ enhanced_image_search: str The enhanced image search setting for a site.
+ Valid values are 'true', and 'false'.
+ uri: str (optional) URI template to update a site.
+ Default SITE_TEMPLATE.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+ converter: func (optional) Function which is executed on the server's
+ response before it is returned. Usually this is a function like
+ SitemapsEntryFromString which will parse the response and turn it into
+ an object.
+
+ Returns:
+ If converter is defined, the results of running converter on the server's
+ response. Otherwise, it will be a SitesEntry object.
+ """
+
+ site_entry = webmastertools.SitesEntry(
+ atom_id=atom.Id(text=site_uri),
+ category=atom.Category(
+ scheme='http://schemas.google.com/g/2005#kind',
+ term='http://schemas.google.com/webmasters/tools/2007#sites-info'),
+ enhanced_image_search=webmastertools.EnhancedImageSearch(
+ text=enhanced_image_search)
+ )
+ response = self.Put(
+ site_entry,
+ uri % urllib.quote_plus(site_uri),
+ url_params=url_params,
+ escape_params=escape_params, converter=converter)
+ if not converter and isinstance(response, atom.Entry):
+ return webmastertools.SitesEntryFromString(response.ToString())
+ return response
+
+ def GetSitemapsFeed(self, site_uri, uri=SITEMAPS_FEED_TEMPLATE,
+ converter=webmastertools.SitemapsFeedFromString):
+ """Gets sitemaps feed of a site.
+
+ Args:
+ site_uri: str (optional) URI of which site to retrieve its sitemaps feed.
+ uri: str (optional) URI to retrieve sites feed.
+ converter: func (optional) Function which is executed on the server's
+ response before it is returned. Usually this is a function like
+ SitemapsFeedFromString which will parse the response and turn it into
+ an object.
+
+ Returns:
+ If converter is defined, the results of running converter on the server's
+ response. Otherwise, it will be a SitemapsFeed object.
+ """
+ return self.Get(uri % {'site_id': urllib.quote_plus(site_uri)},
+ converter=converter)
+
+ def AddSitemap(self, site_uri, sitemap_uri, sitemap_type='WEB',
+ uri=SITEMAPS_FEED_TEMPLATE,
+ url_params=None, escape_params=True, converter=None):
+ """Adds a regular sitemap to a site.
+
+ Args:
+ site_uri: str URI of which site to add sitemap for.
+ sitemap_uri: str URI of sitemap to add to a site.
+ sitemap_type: str Type of added sitemap. Valid types: WEB, VIDEO, or CODE.
+ uri: str (optional) URI template to add a sitemap.
+ Default SITEMAP_FEED_TEMPLATE.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+ converter: func (optional) Function which is executed on the server's
+ response before it is returned. Usually this is a function like
+ SitemapsEntryFromString which will parse the response and turn it into
+ an object.
+
+ Returns:
+ If converter is defined, the results of running converter on the server's
+ response. Otherwise, it will be a SitemapsEntry object.
+ """
+
+ sitemap_entry = webmastertools.SitemapsEntry(
+ atom_id=atom.Id(text=sitemap_uri),
+ category=atom.Category(
+ scheme='http://schemas.google.com/g/2005#kind',
+ term='http://schemas.google.com/webmasters/tools/2007#sitemap-regular'),
+ sitemap_type=webmastertools.SitemapType(text=sitemap_type))
+ response = self.Post(
+ sitemap_entry,
+ uri % {'site_id': urllib.quote_plus(site_uri)},
+ url_params=url_params,
+ escape_params=escape_params, converter=converter)
+ if not converter and isinstance(response, atom.Entry):
+ return webmastertools.SitemapsEntryFromString(response.ToString())
+ return response
+
+ def AddMobileSitemap(self, site_uri, sitemap_uri,
+ sitemap_mobile_markup_language='XHTML', uri=SITEMAPS_FEED_TEMPLATE,
+ url_params=None, escape_params=True, converter=None):
+ """Adds a mobile sitemap to a site.
+
+ Args:
+ site_uri: str URI of which site to add sitemap for.
+ sitemap_uri: str URI of sitemap to add to a site.
+ sitemap_mobile_markup_language: str Format of added sitemap. Valid types:
+ XHTML, WML, or cHTML.
+ uri: str (optional) URI template to add a sitemap.
+ Default SITEMAP_FEED_TEMPLATE.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+ converter: func (optional) Function which is executed on the server's
+ response before it is returned. Usually this is a function like
+ SitemapsEntryFromString which will parse the response and turn it into
+ an object.
+
+ Returns:
+ If converter is defined, the results of running converter on the server's
+ response. Otherwise, it will be a SitemapsEntry object.
+ """
+ # FIXME
+ sitemap_entry = webmastertools.SitemapsEntry(
+ atom_id=atom.Id(text=sitemap_uri),
+ category=atom.Category(
+ scheme='http://schemas.google.com/g/2005#kind',
+ term='http://schemas.google.com/webmasters/tools/2007#sitemap-mobile'),
+ sitemap_mobile_markup_language=\
+ webmastertools.SitemapMobileMarkupLanguage(
+ text=sitemap_mobile_markup_language))
+ print sitemap_entry
+ response = self.Post(
+ sitemap_entry,
+ uri % {'site_id': urllib.quote_plus(site_uri)},
+ url_params=url_params,
+ escape_params=escape_params, converter=converter)
+ if not converter and isinstance(response, atom.Entry):
+ return webmastertools.SitemapsEntryFromString(response.ToString())
+ return response
+
+ def AddNewsSitemap(self, site_uri, sitemap_uri,
+ sitemap_news_publication_label, uri=SITEMAPS_FEED_TEMPLATE,
+ url_params=None, escape_params=True, converter=None):
+ """Adds a news sitemap to a site.
+
+ Args:
+ site_uri: str URI of which site to add sitemap for.
+ sitemap_uri: str URI of sitemap to add to a site.
+ sitemap_news_publication_label: str, list of str Publication Labels for
+ sitemap.
+ uri: str (optional) URI template to add a sitemap.
+ Default SITEMAP_FEED_TEMPLATE.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+ converter: func (optional) Function which is executed on the server's
+ response before it is returned. Usually this is a function like
+ SitemapsEntryFromString which will parse the response and turn it into
+ an object.
+
+ Returns:
+ If converter is defined, the results of running converter on the server's
+ response. Otherwise, it will be a SitemapsEntry object.
+ """
+
+ sitemap_entry = webmastertools.SitemapsEntry(
+ atom_id=atom.Id(text=sitemap_uri),
+ category=atom.Category(
+ scheme='http://schemas.google.com/g/2005#kind',
+ term='http://schemas.google.com/webmasters/tools/2007#sitemap-news'),
+ sitemap_news_publication_label=[],
+ )
+ if isinstance(sitemap_news_publication_label, str):
+ sitemap_news_publication_label = [sitemap_news_publication_label]
+ for label in sitemap_news_publication_label:
+ sitemap_entry.sitemap_news_publication_label.append(
+ webmastertools.SitemapNewsPublicationLabel(text=label))
+ print sitemap_entry
+ response = self.Post(
+ sitemap_entry,
+ uri % {'site_id': urllib.quote_plus(site_uri)},
+ url_params=url_params,
+ escape_params=escape_params, converter=converter)
+ if not converter and isinstance(response, atom.Entry):
+ return webmastertools.SitemapsEntryFromString(response.ToString())
+ return response
+
+ def DeleteSitemap(self, site_uri, sitemap_uri, uri=SITEMAP_TEMPLATE,
+ url_params=None, escape_params=True):
+ """Removes a sitemap from a site.
+
+ Args:
+ site_uri: str URI of which site to remove a sitemap from.
+ sitemap_uri: str URI of sitemap to remove from a site.
+ uri: str (optional) A URI template to send DELETE request.
+ Default SITEMAP_TEMPLATE.
+ url_params: dict (optional) Additional URL parameters to be included
+ in the insertion request.
+ escape_params: boolean (optional) If true, the url_parameters will be
+ escaped before they are included in the request.
+
+ Returns:
+ True if the delete succeeded.
+ """
+
+ return self.Delete(
+ uri % {'site_id': urllib.quote_plus(site_uri),
+ 'sitemap_id': urllib.quote_plus(sitemap_uri)},
+ url_params=url_params, escape_params=escape_params)
diff --git a/src/gdata/youtube/__init__.py b/src/gdata/youtube/__init__.py
new file mode 100755
index 0000000..c41aaea
--- /dev/null
+++ b/src/gdata/youtube/__init__.py
@@ -0,0 +1,684 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = ('api.stephaniel@gmail.com (Stephanie Liu)'
+ ', api.jhartmann@gmail.com (Jochen Hartmann)')
+
+import atom
+import gdata
+import gdata.media as Media
+import gdata.geo as Geo
+
+YOUTUBE_NAMESPACE = 'http://gdata.youtube.com/schemas/2007'
+YOUTUBE_FORMAT = '{http://gdata.youtube.com/schemas/2007}format'
+YOUTUBE_DEVELOPER_TAG_SCHEME = '%s/%s' % (YOUTUBE_NAMESPACE,
+ 'developertags.cat')
+YOUTUBE_SUBSCRIPTION_TYPE_SCHEME = '%s/%s' % (YOUTUBE_NAMESPACE,
+ 'subscriptiontypes.cat')
+
+class Username(atom.AtomBase):
+ """The YouTube Username element"""
+ _tag = 'username'
+ _namespace = YOUTUBE_NAMESPACE
+
+class QueryString(atom.AtomBase):
+ """The YouTube QueryString element"""
+ _tag = 'queryString'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class FirstName(atom.AtomBase):
+ """The YouTube FirstName element"""
+ _tag = 'firstName'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class LastName(atom.AtomBase):
+ """The YouTube LastName element"""
+ _tag = 'lastName'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Age(atom.AtomBase):
+ """The YouTube Age element"""
+ _tag = 'age'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Books(atom.AtomBase):
+ """The YouTube Books element"""
+ _tag = 'books'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Gender(atom.AtomBase):
+ """The YouTube Gender element"""
+ _tag = 'gender'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Company(atom.AtomBase):
+ """The YouTube Company element"""
+ _tag = 'company'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Hobbies(atom.AtomBase):
+ """The YouTube Hobbies element"""
+ _tag = 'hobbies'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Hometown(atom.AtomBase):
+ """The YouTube Hometown element"""
+ _tag = 'hometown'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Location(atom.AtomBase):
+ """The YouTube Location element"""
+ _tag = 'location'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Movies(atom.AtomBase):
+ """The YouTube Movies element"""
+ _tag = 'movies'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Music(atom.AtomBase):
+ """The YouTube Music element"""
+ _tag = 'music'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Occupation(atom.AtomBase):
+ """The YouTube Occupation element"""
+ _tag = 'occupation'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class School(atom.AtomBase):
+ """The YouTube School element"""
+ _tag = 'school'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Relationship(atom.AtomBase):
+ """The YouTube Relationship element"""
+ _tag = 'relationship'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Recorded(atom.AtomBase):
+ """The YouTube Recorded element"""
+ _tag = 'recorded'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Statistics(atom.AtomBase):
+ """The YouTube Statistics element."""
+ _tag = 'statistics'
+ _namespace = YOUTUBE_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['viewCount'] = 'view_count'
+ _attributes['videoWatchCount'] = 'video_watch_count'
+ _attributes['subscriberCount'] = 'subscriber_count'
+ _attributes['lastWebAccess'] = 'last_web_access'
+ _attributes['favoriteCount'] = 'favorite_count'
+
+ def __init__(self, view_count=None, video_watch_count=None,
+ favorite_count=None, subscriber_count=None, last_web_access=None,
+ extension_elements=None, extension_attributes=None, text=None):
+
+ self.view_count = view_count
+ self.video_watch_count = video_watch_count
+ self.subscriber_count = subscriber_count
+ self.last_web_access = last_web_access
+ self.favorite_count = favorite_count
+
+ atom.AtomBase.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+
+class Status(atom.AtomBase):
+ """The YouTube Status element"""
+ _tag = 'status'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Position(atom.AtomBase):
+ """The YouTube Position element. The position in a playlist feed."""
+ _tag = 'position'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Racy(atom.AtomBase):
+ """The YouTube Racy element."""
+ _tag = 'racy'
+ _namespace = YOUTUBE_NAMESPACE
+
+class Description(atom.AtomBase):
+ """The YouTube Description element."""
+ _tag = 'description'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Private(atom.AtomBase):
+ """The YouTube Private element."""
+ _tag = 'private'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class NoEmbed(atom.AtomBase):
+ """The YouTube VideoShare element. Whether a video can be embedded or not."""
+ _tag = 'noembed'
+ _namespace = YOUTUBE_NAMESPACE
+
+
+class Comments(atom.AtomBase):
+ """The GData Comments element"""
+ _tag = 'comments'
+ _namespace = gdata.GDATA_NAMESPACE
+ _children = atom.AtomBase._children.copy()
+ _attributes = atom.AtomBase._attributes.copy()
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feed_link',
+ [gdata.FeedLink])
+
+ def __init__(self, feed_link=None, extension_elements=None,
+ extension_attributes=None, text=None):
+
+ self.feed_link = feed_link
+ atom.AtomBase.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+
+class Rating(atom.AtomBase):
+ """The GData Rating element"""
+ _tag = 'rating'
+ _namespace = gdata.GDATA_NAMESPACE
+ _attributes = atom.AtomBase._attributes.copy()
+ _attributes['min'] = 'min'
+ _attributes['max'] = 'max'
+ _attributes['numRaters'] = 'num_raters'
+ _attributes['average'] = 'average'
+
+ def __init__(self, min=None, max=None,
+ num_raters=None, average=None, extension_elements=None,
+ extension_attributes=None, text=None):
+
+ self.min = min
+ self.max = max
+ self.num_raters = num_raters
+ self.average = average
+
+ atom.AtomBase.__init__(self, extension_elements=extension_elements,
+ extension_attributes=extension_attributes, text=text)
+
+
+class YouTubePlaylistVideoEntry(gdata.GDataEntry):
+ """Represents a YouTubeVideoEntry on a YouTubePlaylist."""
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feed_link',
+ [gdata.FeedLink])
+ _children['{%s}description' % YOUTUBE_NAMESPACE] = ('description',
+ Description)
+ _children['{%s}rating' % gdata.GDATA_NAMESPACE] = ('rating', Rating)
+ _children['{%s}comments' % gdata.GDATA_NAMESPACE] = ('comments', Comments)
+ _children['{%s}statistics' % YOUTUBE_NAMESPACE] = ('statistics', Statistics)
+ _children['{%s}location' % YOUTUBE_NAMESPACE] = ('location', Location)
+ _children['{%s}position' % YOUTUBE_NAMESPACE] = ('position', Position)
+ _children['{%s}group' % gdata.media.MEDIA_NAMESPACE] = ('media', Media.Group)
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None, title=None,
+ updated=None, feed_link=None, description=None,
+ rating=None, comments=None, statistics=None,
+ location=None, position=None, media=None,
+ extension_elements=None, extension_attributes=None):
+
+ self.feed_link = feed_link
+ self.description = description
+ self.rating = rating
+ self.comments = comments
+ self.statistics = statistics
+ self.location = location
+ self.position = position
+ self.media = media
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id,
+ link=link, published=published, title=title,
+ updated=updated,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+
+
+class YouTubeVideoCommentEntry(gdata.GDataEntry):
+ """Represents a comment on YouTube."""
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+
+
+class YouTubeSubscriptionEntry(gdata.GDataEntry):
+ """Represents a subscription entry on YouTube."""
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}username' % YOUTUBE_NAMESPACE] = ('username', Username)
+ _children['{%s}queryString' % YOUTUBE_NAMESPACE] = (
+ 'query_string', QueryString)
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feed_link',
+ [gdata.FeedLink])
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None, title=None,
+ updated=None, username=None, query_string=None, feed_link=None,
+ extension_elements=None, extension_attributes=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title, updated=updated)
+
+ self.username = username
+ self.query_string = query_string
+ self.feed_link = feed_link
+
+
+ def GetSubscriptionType(self):
+ """Retrieve the type of this subscription.
+
+ Returns:
+ A string that is either 'channel, 'query' or 'favorites'
+ """
+ for category in self.category:
+ if category.scheme == YOUTUBE_SUBSCRIPTION_TYPE_SCHEME:
+ return category.term
+
+
+class YouTubeVideoResponseEntry(gdata.GDataEntry):
+ """Represents a video response. """
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}rating' % gdata.GDATA_NAMESPACE] = ('rating', Rating)
+ _children['{%s}noembed' % YOUTUBE_NAMESPACE] = ('noembed', NoEmbed)
+ _children['{%s}statistics' % YOUTUBE_NAMESPACE] = ('statistics', Statistics)
+ _children['{%s}racy' % YOUTUBE_NAMESPACE] = ('racy', Racy)
+ _children['{%s}group' % gdata.media.MEDIA_NAMESPACE] = ('media', Media.Group)
+
+ def __init__(self, author=None, category=None, content=None, atom_id=None,
+ link=None, published=None, title=None, updated=None, rating=None,
+ noembed=None, statistics=None, racy=None, media=None,
+ extension_elements=None, extension_attributes=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title, updated=updated)
+
+ self.rating = rating
+ self.noembed = noembed
+ self.statistics = statistics
+ self.racy = racy
+ self.media = media or Media.Group()
+
+
+class YouTubeContactEntry(gdata.GDataEntry):
+ """Represents a contact entry."""
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}username' % YOUTUBE_NAMESPACE] = ('username', Username)
+ _children['{%s}status' % YOUTUBE_NAMESPACE] = ('status', Status)
+
+
+ def __init__(self, author=None, category=None, content=None, atom_id=None,
+ link=None, published=None, title=None, updated=None,
+ username=None, status=None, extension_elements=None,
+ extension_attributes=None, text=None):
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title, updated=updated)
+
+ self.username = username
+ self.status = status
+
+
+class YouTubeVideoEntry(gdata.GDataEntry):
+ """Represents a video on YouTube."""
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}rating' % gdata.GDATA_NAMESPACE] = ('rating', Rating)
+ _children['{%s}comments' % gdata.GDATA_NAMESPACE] = ('comments', Comments)
+ _children['{%s}noembed' % YOUTUBE_NAMESPACE] = ('noembed', NoEmbed)
+ _children['{%s}statistics' % YOUTUBE_NAMESPACE] = ('statistics', Statistics)
+ _children['{%s}recorded' % YOUTUBE_NAMESPACE] = ('recorded', Recorded)
+ _children['{%s}racy' % YOUTUBE_NAMESPACE] = ('racy', Racy)
+ _children['{%s}group' % gdata.media.MEDIA_NAMESPACE] = ('media', Media.Group)
+ _children['{%s}where' % gdata.geo.GEORSS_NAMESPACE] = ('geo', Geo.Where)
+
+ def __init__(self, author=None, category=None, content=None, atom_id=None,
+ link=None, published=None, title=None, updated=None, rating=None,
+ noembed=None, statistics=None, racy=None, media=None, geo=None,
+ recorded=None, comments=None, extension_elements=None,
+ extension_attributes=None):
+
+ self.rating = rating
+ self.noembed = noembed
+ self.statistics = statistics
+ self.racy = racy
+ self.comments = comments
+ self.media = media or Media.Group()
+ self.geo = geo
+ self.recorded = recorded
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id, link=link,
+ published=published, title=title, updated=updated,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+
+ def GetSwfUrl(self):
+ """Return the URL for the embeddable Video
+
+ Returns:
+ URL of the embeddable video
+ """
+ if self.media.content:
+ for content in self.media.content:
+ if content.extension_attributes[YOUTUBE_FORMAT] == '5':
+ return content.url
+ else:
+ return None
+
+ def AddDeveloperTags(self, developer_tags):
+ """Add a developer tag for this entry.
+
+ Developer tags can only be set during the initial upload.
+
+ Arguments:
+ developer_tags: A list of developer tags as strings.
+
+ Returns:
+ A list of all developer tags for this video entry.
+ """
+ for tag_text in developer_tags:
+ self.media.category.append(gdata.media.Category(
+ text=tag_text, label=tag_text, scheme=YOUTUBE_DEVELOPER_TAG_SCHEME))
+
+ return self.GetDeveloperTags()
+
+ def GetDeveloperTags(self):
+ """Retrieve developer tags for this video entry."""
+ developer_tags = []
+ for category in self.media.category:
+ if category.scheme == YOUTUBE_DEVELOPER_TAG_SCHEME:
+ developer_tags.append(category)
+ if len(developer_tags) > 0:
+ return developer_tags
+
+ def GetYouTubeCategoryAsString(self):
+ """Convenience method to return the YouTube category as string.
+
+ YouTubeVideoEntries can contain multiple Category objects with differing
+ schemes. This method returns only the category with the correct
+ scheme, ignoring developer tags.
+ """
+ for category in self.media.category:
+ if category.scheme != YOUTUBE_DEVELOPER_TAG_SCHEME:
+ return category.text
+
+class YouTubeUserEntry(gdata.GDataEntry):
+ """Represents a user on YouTube."""
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}username' % YOUTUBE_NAMESPACE] = ('username', Username)
+ _children['{%s}firstName' % YOUTUBE_NAMESPACE] = ('first_name', FirstName)
+ _children['{%s}lastName' % YOUTUBE_NAMESPACE] = ('last_name', LastName)
+ _children['{%s}age' % YOUTUBE_NAMESPACE] = ('age', Age)
+ _children['{%s}books' % YOUTUBE_NAMESPACE] = ('books', Books)
+ _children['{%s}gender' % YOUTUBE_NAMESPACE] = ('gender', Gender)
+ _children['{%s}company' % YOUTUBE_NAMESPACE] = ('company', Company)
+ _children['{%s}description' % YOUTUBE_NAMESPACE] = ('description',
+ Description)
+ _children['{%s}hobbies' % YOUTUBE_NAMESPACE] = ('hobbies', Hobbies)
+ _children['{%s}hometown' % YOUTUBE_NAMESPACE] = ('hometown', Hometown)
+ _children['{%s}location' % YOUTUBE_NAMESPACE] = ('location', Location)
+ _children['{%s}movies' % YOUTUBE_NAMESPACE] = ('movies', Movies)
+ _children['{%s}music' % YOUTUBE_NAMESPACE] = ('music', Music)
+ _children['{%s}occupation' % YOUTUBE_NAMESPACE] = ('occupation', Occupation)
+ _children['{%s}school' % YOUTUBE_NAMESPACE] = ('school', School)
+ _children['{%s}relationship' % YOUTUBE_NAMESPACE] = ('relationship',
+ Relationship)
+ _children['{%s}statistics' % YOUTUBE_NAMESPACE] = ('statistics', Statistics)
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feed_link',
+ [gdata.FeedLink])
+ _children['{%s}thumbnail' % gdata.media.MEDIA_NAMESPACE] = ('thumbnail',
+ Media.Thumbnail)
+
+ def __init__(self, author=None, category=None, content=None, atom_id=None,
+ link=None, published=None, title=None, updated=None,
+ username=None, first_name=None, last_name=None, age=None,
+ books=None, gender=None, company=None, description=None,
+ hobbies=None, hometown=None, location=None, movies=None,
+ music=None, occupation=None, school=None, relationship=None,
+ statistics=None, feed_link=None, extension_elements=None,
+ extension_attributes=None, text=None):
+
+ self.username = username
+ self.first_name = first_name
+ self.last_name = last_name
+ self.age = age
+ self.books = books
+ self.gender = gender
+ self.company = company
+ self.description = description
+ self.hobbies = hobbies
+ self.hometown = hometown
+ self.location = location
+ self.movies = movies
+ self.music = music
+ self.occupation = occupation
+ self.school = school
+ self.relationship = relationship
+ self.statistics = statistics
+ self.feed_link = feed_link
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id,
+ link=link, published=published,
+ title=title, updated=updated,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes,
+ text=text)
+
+
+class YouTubeVideoFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """Represents a video feed on YouTube."""
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry', [YouTubeVideoEntry])
+
+class YouTubePlaylistEntry(gdata.GDataEntry):
+ """Represents a playlist in YouTube."""
+ _tag = gdata.GDataEntry._tag
+ _namespace = gdata.GDataEntry._namespace
+ _children = gdata.GDataEntry._children.copy()
+ _attributes = gdata.GDataEntry._attributes.copy()
+ _children['{%s}description' % YOUTUBE_NAMESPACE] = ('description',
+ Description)
+ _children['{%s}private' % YOUTUBE_NAMESPACE] = ('private',
+ Private)
+ _children['{%s}feedLink' % gdata.GDATA_NAMESPACE] = ('feed_link',
+ [gdata.FeedLink])
+
+ def __init__(self, author=None, category=None, content=None,
+ atom_id=None, link=None, published=None, title=None,
+ updated=None, private=None, feed_link=None,
+ description=None, extension_elements=None,
+ extension_attributes=None):
+
+ self.description = description
+ self.private = private
+ self.feed_link = feed_link
+
+ gdata.GDataEntry.__init__(self, author=author, category=category,
+ content=content, atom_id=atom_id,
+ link=link, published=published, title=title,
+ updated=updated,
+ extension_elements=extension_elements,
+ extension_attributes=extension_attributes)
+
+
+
+class YouTubePlaylistFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """Represents a feed of a user's playlists """
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [YouTubePlaylistEntry])
+
+
+class YouTubePlaylistVideoFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """Represents a feed of video entry on a playlist."""
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [YouTubePlaylistVideoEntry])
+
+
+class YouTubeContactFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """Represents a feed of a users contacts."""
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [YouTubeContactEntry])
+
+
+class YouTubeSubscriptionFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """Represents a feed of a users subscriptions."""
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [YouTubeSubscriptionEntry])
+
+
+class YouTubeVideoCommentFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """Represents a feed of comments for a video."""
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [YouTubeVideoCommentEntry])
+
+
+class YouTubeVideoResponseFeed(gdata.GDataFeed, gdata.LinkFinder):
+ """Represents a feed of video responses."""
+ _tag = gdata.GDataFeed._tag
+ _namespace = gdata.GDataFeed._namespace
+ _children = gdata.GDataFeed._children.copy()
+ _attributes = gdata.GDataFeed._attributes.copy()
+ _children['{%s}entry' % atom.ATOM_NAMESPACE] = ('entry',
+ [YouTubeVideoResponseEntry])
+
+
+def YouTubeVideoFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeVideoFeed, xml_string)
+
+
+def YouTubeVideoEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeVideoEntry, xml_string)
+
+
+def YouTubeContactFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeContactFeed, xml_string)
+
+
+def YouTubeContactEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeContactEntry, xml_string)
+
+
+def YouTubeVideoCommentFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeVideoCommentFeed, xml_string)
+
+
+def YouTubeVideoCommentEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeVideoCommentEntry, xml_string)
+
+
+def YouTubeUserFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeVideoFeed, xml_string)
+
+
+def YouTubeUserEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeUserEntry, xml_string)
+
+
+def YouTubePlaylistFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubePlaylistFeed, xml_string)
+
+
+def YouTubePlaylistVideoFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubePlaylistVideoFeed, xml_string)
+
+
+def YouTubePlaylistEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubePlaylistEntry, xml_string)
+
+
+def YouTubePlaylistVideoEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubePlaylistVideoEntry, xml_string)
+
+
+def YouTubeSubscriptionFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeSubscriptionFeed, xml_string)
+
+
+def YouTubeSubscriptionEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeSubscriptionEntry, xml_string)
+
+
+def YouTubeVideoResponseFeedFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeVideoResponseFeed, xml_string)
+
+
+def YouTubeVideoResponseEntryFromString(xml_string):
+ return atom.CreateClassFromXMLString(YouTubeVideoResponseEntry, xml_string)
diff --git a/src/gdata/youtube/client.py b/src/gdata/youtube/client.py
new file mode 100644
index 0000000..87933a8
--- /dev/null
+++ b/src/gdata/youtube/client.py
@@ -0,0 +1,265 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains a client to communicate with the YouTube servers.
+
+ A quick and dirty port of the YouTube GDATA 1.0 Python client
+ libraries to version 2.0 of the GDATA library.
+
+"""
+
+# __author__ = 's.@google.com (John Skidgel)'
+
+import logging
+
+import gdata.client
+import gdata.youtube.data
+import atom.data
+import atom.http_core
+
+# Constants
+# -----------------------------------------------------------------------------
+YOUTUBE_CLIENTLOGIN_AUTHENTICATION_URL = 'https://www.google.com/youtube/accounts/ClientLogin'
+YOUTUBE_SUPPORTED_UPLOAD_TYPES = ('mov', 'avi', 'wmv', 'mpg', 'quicktime',
+ 'flv')
+YOUTUBE_QUERY_VALID_TIME_PARAMETERS = ('today', 'this_week', 'this_month',
+ 'all_time')
+YOUTUBE_QUERY_VALID_ORDERBY_PARAMETERS = ('published', 'viewCount', 'rating',
+ 'relevance')
+YOUTUBE_QUERY_VALID_RACY_PARAMETERS = ('include', 'exclude')
+YOUTUBE_QUERY_VALID_FORMAT_PARAMETERS = ('1', '5', '6')
+YOUTUBE_STANDARDFEEDS = ('most_recent', 'recently_featured',
+ 'top_rated', 'most_viewed','watch_on_mobile')
+
+YOUTUBE_UPLOAD_TOKEN_URI = 'http://gdata.youtube.com/action/GetUploadToken'
+YOUTUBE_SERVER = 'gdata.youtube.com/feeds/api'
+YOUTUBE_SERVICE = 'youtube'
+YOUTUBE_VIDEO_FEED_URI = 'http://%s/videos' % YOUTUBE_SERVER
+YOUTUBE_USER_FEED_URI = 'http://%s/users/' % YOUTUBE_SERVER
+
+# Takes a youtube video ID.
+YOUTUBE_CAPTION_FEED_URI = 'http://gdata.youtube.com/feeds/api/videos/%s/captions'
+
+# Takes a youtube video ID and a caption track ID.
+YOUTUBE_CAPTION_URI = 'http://gdata.youtube.com/feeds/api/videos/%s/captiondata/%s'
+
+YOUTUBE_CAPTION_MIME_TYPE = 'application/vnd.youtube.timedtext; charset=UTF-8'
+
+
+# Classes
+# -----------------------------------------------------------------------------
+class Error(Exception):
+ """Base class for errors within the YouTube service."""
+ pass
+
+
+class RequestError(Error):
+ """Error class that is thrown in response to an invalid HTTP Request."""
+ pass
+
+
+class YouTubeError(Error):
+ """YouTube service specific error class."""
+ pass
+
+
+class YouTubeClient(gdata.client.GDClient):
+ """Client for the YouTube service.
+
+ Performs a partial list of Google Data YouTube API functions, such as
+ retrieving the videos feed for a user and the feed for a video.
+ YouTube Service requires authentication for any write, update or delete
+ actions.
+ """
+ api_version = '2'
+ auth_service = YOUTUBE_SERVICE
+ auth_scopes = ['https://%s' % YOUTUBE_SERVER]
+ ssl = True
+
+ def get_videos(self, uri=YOUTUBE_VIDEO_FEED_URI, auth_token=None,
+ desired_class=gdata.youtube.data.VideoFeed,
+ **kwargs):
+ """Retrieves a YouTube video feed.
+ Args:
+ uri: A string representing the URI of the feed that is to be retrieved.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ return self.get_feed(uri, auth_token=auth_token,
+ desired_class=desired_class,
+ **kwargs)
+
+ GetVideos = get_videos
+
+
+ def get_user_feed(self, uri=None, username=None):
+ """Retrieve a YouTubeVideoFeed of user uploaded videos.
+
+ Either a uri or a username must be provided. This will retrieve list
+ of videos uploaded by specified user. The uri will be of format
+ "http://gdata.youtube.com/feeds/api/users/{username}/uploads".
+
+ Args:
+ uri: An optional string representing the URI of the user feed that is
+ to be retrieved.
+ username: An optional string representing the username.
+
+ Returns:
+ A YouTubeUserFeed if successfully retrieved.
+
+ Raises:
+ YouTubeError: You must provide at least a uri or a username to the
+ GetYouTubeUserFeed() method.
+ """
+ if uri is None and username is None:
+ raise YouTubeError('You must provide at least a uri or a username '
+ 'to the GetYouTubeUserFeed() method')
+ elif username and not uri:
+ uri = '%s%s/%s' % (YOUTUBE_USER_FEED_URI, username, 'uploads')
+ return self.get_feed(uri, desired_class=gdata.youtube.data.VideoFeed)
+
+ GetUserFeed = get_user_feed
+
+
+ def get_video_entry(self, uri=None, video_id=None,
+ auth_token=None, **kwargs):
+ """Retrieve a YouTubeVideoEntry.
+
+ Either a uri or a video_id must be provided.
+
+ Args:
+ uri: An optional string representing the URI of the entry that is to
+ be retrieved.
+ video_id: An optional string representing the ID of the video.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+
+ Raises:
+ YouTubeError: You must provide at least a uri or a video_id to the
+ GetYouTubeVideoEntry() method.
+ """
+ if uri is None and video_id is None:
+ raise YouTubeError('You must provide at least a uri or a video_id '
+ 'to the get_youtube_video_entry() method')
+ elif video_id and uri is None:
+ uri = '%s/%s' % (YOUTUBE_VIDEO_FEED_URI, video_id)
+ return self.get_feed(uri,
+ desired_class=gdata.youtube.data.VideoEntry,
+ auth_token=auth_token,
+ **kwargs)
+
+ GetVideoEntry = get_video_entry
+
+
+ def get_caption_feed(self, uri):
+ """Retrieve a Caption feed of tracks.
+
+ Args:
+ uri: A string representing the caption feed's URI to be retrieved.
+
+ Returns:
+ A YouTube CaptionFeed if successfully retrieved.
+ """
+ return self.get_feed(uri, desired_class=gdata.youtube.data.CaptionFeed)
+
+ GetCaptionFeed = get_caption_feed
+
+ def get_caption_track(self, track_url, client_id,
+ developer_key, auth_token=None, **kwargs):
+ http_request = atom.http_core.HttpRequest(uri = track_url, method = 'GET')
+ dev_key = 'key=' + developer_key
+ authsub = 'AuthSub token="' + str(auth_token) + '"'
+ http_request.headers = {
+ 'Authorization': authsub,
+ 'X-GData-Client': client_id,
+ 'X-GData-Key': dev_key
+ }
+ return self.request(http_request=http_request, **kwargs)
+
+ GetCaptionTrack = get_caption_track
+
+ def create_track(self, video_id, title, language, body, client_id,
+ developer_key, auth_token=None, title_type='text', **kwargs):
+ """Creates a closed-caption track and adds to an existing YouTube video.
+ """
+ new_entry = gdata.youtube.data.TrackEntry(
+ content = gdata.youtube.data.TrackContent(text = body, lang = language))
+ uri = YOUTUBE_CAPTION_FEED_URI % video_id
+ http_request = atom.http_core.HttpRequest(uri = uri, method = 'POST')
+ dev_key = 'key=' + developer_key
+ authsub = 'AuthSub token="' + str(auth_token) + '"'
+ http_request.headers = {
+ 'Content-Type': YOUTUBE_CAPTION_MIME_TYPE,
+ 'Content-Language': language,
+ 'Slug': title,
+ 'Authorization': authsub,
+ 'GData-Version': self.api_version,
+ 'X-GData-Client': client_id,
+ 'X-GData-Key': dev_key
+ }
+ http_request.add_body_part(body, http_request.headers['Content-Type'])
+ return self.request(http_request = http_request,
+ desired_class = new_entry.__class__, **kwargs)
+
+
+ CreateTrack = create_track
+
+ def delete_track(self, video_id, track, client_id, developer_key,
+ auth_token=None, **kwargs):
+ """Deletes a track."""
+ if isinstance(track, gdata.youtube.data.TrackEntry):
+ track_id_text_node = track.get_id().split(':')
+ track_id = track_id_text_node[3]
+ else:
+ track_id = track
+ uri = YOUTUBE_CAPTION_URI % (video_id, track_id)
+ http_request = atom.http_core.HttpRequest(uri = uri, method = 'DELETE')
+ dev_key = 'key=' + developer_key
+ authsub = 'AuthSub token="' + str(auth_token) + '"'
+ http_request.headers = {
+ 'Authorization': authsub,
+ 'GData-Version': self.api_version,
+ 'X-GData-Client': client_id,
+ 'X-GData-Key': dev_key
+ }
+ return self.request(http_request=http_request, **kwargs)
+
+ DeleteTrack = delete_track
+
+ def update_track(self, video_id, track, body, client_id, developer_key,
+ auth_token=None, **kwargs):
+ """Updates a closed-caption track for an existing YouTube video.
+ """
+ track_id_text_node = track.get_id().split(':')
+ track_id = track_id_text_node[3]
+ uri = YOUTUBE_CAPTION_URI % (video_id, track_id)
+ http_request = atom.http_core.HttpRequest(uri = uri, method = 'PUT')
+ dev_key = 'key=' + developer_key
+ authsub = 'AuthSub token="' + str(auth_token) + '"'
+ http_request.headers = {
+ 'Content-Type': YOUTUBE_CAPTION_MIME_TYPE,
+ 'Authorization': authsub,
+ 'GData-Version': self.api_version,
+ 'X-GData-Client': client_id,
+ 'X-GData-Key': dev_key
+ }
+ http_request.add_body_part(body, http_request.headers['Content-Type'])
+ return self.request(http_request = http_request,
+ desired_class = track.__class__, **kwargs)
+
+ UpdateTrack = update_track
diff --git a/src/gdata/youtube/data.py b/src/gdata/youtube/data.py
new file mode 100644
index 0000000..4ef2d62
--- /dev/null
+++ b/src/gdata/youtube/data.py
@@ -0,0 +1,502 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Contains the data classes of the YouTube Data API"""
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import atom.core
+import atom.data
+import gdata.data
+import gdata.geo.data
+import gdata.media.data
+import gdata.opensearch.data
+import gdata.youtube.data
+
+
+YT_TEMPLATE = '{http://gdata.youtube.com/schemas/2007/}%s'
+
+
+class ComplaintEntry(gdata.data.GDEntry):
+ """Describes a complaint about a video"""
+
+
+class ComplaintFeed(gdata.data.GDFeed):
+ """Describes complaints about a video"""
+ entry = [ComplaintEntry]
+
+
+class RatingEntry(gdata.data.GDEntry):
+ """A rating about a video"""
+ rating = gdata.data.Rating
+
+
+class RatingFeed(gdata.data.GDFeed):
+ """Describes ratings for a video"""
+ entry = [RatingEntry]
+
+
+class YouTubeMediaContent(gdata.media.data.MediaContent):
+ """Describes a you tube media content"""
+ _qname = gdata.media.data.MEDIA_TEMPLATE % 'content'
+ format = 'format'
+
+
+class YtAge(atom.core.XmlElement):
+ """User's age"""
+ _qname = YT_TEMPLATE % 'age'
+
+
+class YtBooks(atom.core.XmlElement):
+ """User's favorite books"""
+ _qname = YT_TEMPLATE % 'books'
+
+
+class YtCompany(atom.core.XmlElement):
+ """User's company"""
+ _qname = YT_TEMPLATE % 'company'
+
+
+class YtDescription(atom.core.XmlElement):
+ """Description"""
+ _qname = YT_TEMPLATE % 'description'
+
+
+class YtDuration(atom.core.XmlElement):
+ """Video duration"""
+ _qname = YT_TEMPLATE % 'duration'
+ seconds = 'seconds'
+
+
+class YtFirstName(atom.core.XmlElement):
+ """User's first name"""
+ _qname = YT_TEMPLATE % 'firstName'
+
+
+class YtGender(atom.core.XmlElement):
+ """User's gender"""
+ _qname = YT_TEMPLATE % 'gender'
+
+
+class YtHobbies(atom.core.XmlElement):
+ """User's hobbies"""
+ _qname = YT_TEMPLATE % 'hobbies'
+
+
+class YtHometown(atom.core.XmlElement):
+ """User's hometown"""
+ _qname = YT_TEMPLATE % 'hometown'
+
+
+class YtLastName(atom.core.XmlElement):
+ """User's last name"""
+ _qname = YT_TEMPLATE % 'lastName'
+
+
+class YtLocation(atom.core.XmlElement):
+ """Location"""
+ _qname = YT_TEMPLATE % 'location'
+
+
+class YtMovies(atom.core.XmlElement):
+ """User's favorite movies"""
+ _qname = YT_TEMPLATE % 'movies'
+
+
+class YtMusic(atom.core.XmlElement):
+ """User's favorite music"""
+ _qname = YT_TEMPLATE % 'music'
+
+
+class YtNoEmbed(atom.core.XmlElement):
+ """Disables embedding for the video"""
+ _qname = YT_TEMPLATE % 'noembed'
+
+
+class YtOccupation(atom.core.XmlElement):
+ """User's occupation"""
+ _qname = YT_TEMPLATE % 'occupation'
+
+
+class YtPlaylistId(atom.core.XmlElement):
+ """Playlist id"""
+ _qname = YT_TEMPLATE % 'playlistId'
+
+
+class YtPosition(atom.core.XmlElement):
+ """Video position on the playlist"""
+ _qname = YT_TEMPLATE % 'position'
+
+
+class YtPrivate(atom.core.XmlElement):
+ """Flags the entry as private"""
+ _qname = YT_TEMPLATE % 'private'
+
+
+class YtQueryString(atom.core.XmlElement):
+ """Keywords or query string associated with a subscription"""
+ _qname = YT_TEMPLATE % 'queryString'
+
+
+class YtRacy(atom.core.XmlElement):
+ """Mature content"""
+ _qname = YT_TEMPLATE % 'racy'
+
+
+class YtRecorded(atom.core.XmlElement):
+ """Date when the video was recorded"""
+ _qname = YT_TEMPLATE % 'recorded'
+
+
+class YtRelationship(atom.core.XmlElement):
+ """User's relationship status"""
+ _qname = YT_TEMPLATE % 'relationship'
+
+
+class YtSchool(atom.core.XmlElement):
+ """User's school"""
+ _qname = YT_TEMPLATE % 'school'
+
+
+class YtStatistics(atom.core.XmlElement):
+ """Video and user statistics"""
+ _qname = YT_TEMPLATE % 'statistics'
+ favorite_count = 'favoriteCount'
+ video_watch_count = 'videoWatchCount'
+ view_count = 'viewCount'
+ last_web_access = 'lastWebAccess'
+ subscriber_count = 'subscriberCount'
+
+
+class YtStatus(atom.core.XmlElement):
+ """Status of a contact"""
+ _qname = YT_TEMPLATE % 'status'
+
+
+class YtUserProfileStatistics(YtStatistics):
+ """User statistics"""
+ _qname = YT_TEMPLATE % 'statistics'
+
+
+class YtUsername(atom.core.XmlElement):
+ """Youtube username"""
+ _qname = YT_TEMPLATE % 'username'
+
+
+class FriendEntry(gdata.data.BatchEntry):
+ """Describes a contact in friend list"""
+ username = YtUsername
+ status = YtStatus
+ email = gdata.data.Email
+
+
+class FriendFeed(gdata.data.BatchFeed):
+ """Describes user's friends"""
+ entry = [FriendEntry]
+
+
+class YtVideoStatistics(YtStatistics):
+ """Video statistics"""
+ _qname = YT_TEMPLATE % 'statistics'
+
+
+class ChannelEntry(gdata.data.GDEntry):
+ """Describes a video channel"""
+
+
+class ChannelFeed(gdata.data.GDFeed):
+ """Describes channels"""
+ entry = [ChannelEntry]
+
+
+class FavoriteEntry(gdata.data.BatchEntry):
+ """Describes a favorite video"""
+
+
+class FavoriteFeed(gdata.data.BatchFeed):
+ """Describes favorite videos"""
+ entry = [FavoriteEntry]
+
+
+class YouTubeMediaCredit(gdata.media.data.MediaCredit):
+ """Describes a you tube media credit"""
+ _qname = gdata.media.data.MEDIA_TEMPLATE % 'credit'
+ type = 'type'
+
+
+class YouTubeMediaRating(gdata.media.data.MediaRating):
+ """Describes a you tube media rating"""
+ _qname = gdata.media.data.MEDIA_TEMPLATE % 'rating'
+ country = 'country'
+
+
+class YtAboutMe(atom.core.XmlElement):
+ """User's self description"""
+ _qname = YT_TEMPLATE % 'aboutMe'
+
+
+class UserProfileEntry(gdata.data.BatchEntry):
+ """Describes an user's profile"""
+ relationship = YtRelationship
+ description = YtDescription
+ location = YtLocation
+ statistics = YtUserProfileStatistics
+ school = YtSchool
+ music = YtMusic
+ first_name = YtFirstName
+ gender = YtGender
+ occupation = YtOccupation
+ hometown = YtHometown
+ company = YtCompany
+ movies = YtMovies
+ books = YtBooks
+ username = YtUsername
+ about_me = YtAboutMe
+ last_name = YtLastName
+ age = YtAge
+ thumbnail = gdata.media.data.MediaThumbnail
+ hobbies = YtHobbies
+
+
+class UserProfileFeed(gdata.data.BatchFeed):
+ """Describes a feed of user's profile"""
+ entry = [UserProfileEntry]
+
+
+class YtAspectRatio(atom.core.XmlElement):
+ """The aspect ratio of a media file"""
+ _qname = YT_TEMPLATE % 'aspectRatio'
+
+
+class YtBasePublicationState(atom.core.XmlElement):
+ """Status of an unpublished entry"""
+ _qname = YT_TEMPLATE % 'state'
+ help_url = 'helpUrl'
+
+
+class YtPublicationState(YtBasePublicationState):
+ """Status of an unpublished video"""
+ _qname = YT_TEMPLATE % 'state'
+ name = 'name'
+ reason_code = 'reasonCode'
+
+
+class YouTubeAppControl(atom.data.Control):
+ """Describes a you tube app control"""
+ _qname = (atom.data.APP_TEMPLATE_V1 % 'control',
+ atom.data.APP_TEMPLATE_V2 % 'control')
+ state = YtPublicationState
+
+
+class YtCaptionPublicationState(YtBasePublicationState):
+ """Status of an unpublished caption track"""
+ _qname = YT_TEMPLATE % 'state'
+ reason_code = 'reasonCode'
+ name = 'name'
+
+
+class YouTubeCaptionAppControl(atom.data.Control):
+ """Describes a you tube caption app control"""
+ _qname = atom.data.APP_TEMPLATE_V2 % 'control'
+ state = YtCaptionPublicationState
+
+
+class CaptionTrackEntry(gdata.data.GDEntry):
+ """Describes a caption track"""
+
+
+class CaptionTrackFeed(gdata.data.GDFeed):
+ """Describes caption tracks"""
+ entry = [CaptionTrackEntry]
+
+
+class YtCountHint(atom.core.XmlElement):
+ """Hint as to how many entries the linked feed contains"""
+ _qname = YT_TEMPLATE % 'countHint'
+
+
+class PlaylistLinkEntry(gdata.data.BatchEntry):
+ """Describes a playlist"""
+ description = YtDescription
+ playlist_id = YtPlaylistId
+ count_hint = YtCountHint
+ private = YtPrivate
+
+
+class PlaylistLinkFeed(gdata.data.BatchFeed):
+ """Describes list of playlists"""
+ entry = [PlaylistLinkEntry]
+
+
+class YtModerationStatus(atom.core.XmlElement):
+ """Moderation status"""
+ _qname = YT_TEMPLATE % 'moderationStatus'
+
+
+class YtPlaylistTitle(atom.core.XmlElement):
+ """Playlist title"""
+ _qname = YT_TEMPLATE % 'playlistTitle'
+
+
+class SubscriptionEntry(gdata.data.BatchEntry):
+ """Describes user's channel subscritpions"""
+ count_hint = YtCountHint
+ playlist_title = YtPlaylistTitle
+ thumbnail = gdata.media.data.MediaThumbnail
+ username = YtUsername
+ query_string = YtQueryString
+ playlist_id = YtPlaylistId
+
+
+class SubscriptionFeed(gdata.data.BatchFeed):
+ """Describes list of user's video subscriptions"""
+ entry = [SubscriptionEntry]
+
+
+class YtSpam(atom.core.XmlElement):
+ """Indicates that the entry probably contains spam"""
+ _qname = YT_TEMPLATE % 'spam'
+
+
+class CommentEntry(gdata.data.BatchEntry):
+ """Describes a comment for a video"""
+ spam = YtSpam
+
+
+class CommentFeed(gdata.data.BatchFeed):
+ """Describes comments for a video"""
+ entry = [CommentEntry]
+
+
+class YtUploaded(atom.core.XmlElement):
+ """Date/Time at which the video was uploaded"""
+ _qname = YT_TEMPLATE % 'uploaded'
+
+
+class YtVideoId(atom.core.XmlElement):
+ """Video id"""
+ _qname = YT_TEMPLATE % 'videoid'
+
+
+class YouTubeMediaGroup(gdata.media.data.MediaGroup):
+ """Describes a you tube media group"""
+ _qname = gdata.media.data.MEDIA_TEMPLATE % 'group'
+ videoid = YtVideoId
+ private = YtPrivate
+ duration = YtDuration
+ aspect_ratio = YtAspectRatio
+ uploaded = YtUploaded
+
+
+class VideoEntryBase(gdata.data.GDEntry):
+ """Elements that describe or contain videos"""
+ group = YouTubeMediaGroup
+ statistics = YtVideoStatistics
+ racy = YtRacy
+ recorded = YtRecorded
+ where = gdata.geo.data.GeoRssWhere
+ rating = gdata.data.Rating
+ noembed = YtNoEmbed
+ location = YtLocation
+ comments = gdata.data.Comments
+
+
+class PlaylistEntry(gdata.data.BatchEntry):
+ """Describes a video in a playlist"""
+ description = YtDescription
+ position = YtPosition
+
+
+class PlaylistFeed(gdata.data.BatchFeed):
+ """Describes videos in a playlist"""
+ private = YtPrivate
+ group = YouTubeMediaGroup
+ playlist_id = YtPlaylistId
+ entry = [PlaylistEntry]
+
+
+class VideoEntry(gdata.data.BatchEntry):
+ """Describes a video"""
+
+
+class VideoFeed(gdata.data.BatchFeed):
+ """Describes a video feed"""
+ entry = [VideoEntry]
+
+
+class VideoMessageEntry(gdata.data.BatchEntry):
+ """Describes a video message"""
+ description = YtDescription
+
+
+class VideoMessageFeed(gdata.data.BatchFeed):
+ """Describes videos in a videoMessage"""
+ entry = [VideoMessageEntry]
+
+
+class UserEventEntry(gdata.data.GDEntry):
+ """Describes a user event"""
+ playlist_id = YtPlaylistId
+ videoid = YtVideoId
+ username = YtUsername
+ query_string = YtQueryString
+ rating = gdata.data.Rating
+
+
+class UserEventFeed(gdata.data.GDFeed):
+ """Describes list of events"""
+ entry = [UserEventEntry]
+
+
+class VideoModerationEntry(gdata.data.GDEntry):
+ """Describes video moderation"""
+ moderation_status = YtModerationStatus
+ videoid = YtVideoId
+
+
+class VideoModerationFeed(gdata.data.GDFeed):
+ """Describes a video moderation feed"""
+ entry = [VideoModerationEntry]
+
+
+class TrackContent(atom.data.Content):
+ lang = atom.data.XML_TEMPLATE % 'lang'
+
+
+class TrackEntry(gdata.data.GDEntry):
+ """Represents the URL for a caption track"""
+ content = TrackContent
+
+ def get_caption_track_id(self):
+ """Extracts the ID of this caption track.
+ Returns:
+ The caption track's id as a string.
+ """
+ if self.id.text:
+ match = CAPTION_TRACK_ID_PATTERN.match(self.id.text)
+ if match:
+ return match.group(2)
+ return None
+
+ GetCaptionTrackId = get_caption_track_id
+
+
+class CaptionFeed(gdata.data.GDFeed):
+ """Represents a caption feed for a video on YouTube."""
+ entry = [TrackEntry]
diff --git a/src/gdata/youtube/service.py b/src/gdata/youtube/service.py
new file mode 100644
index 0000000..59a21a1
--- /dev/null
+++ b/src/gdata/youtube/service.py
@@ -0,0 +1,1568 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""YouTubeService extends GDataService to streamline YouTube operations.
+
+ YouTubeService: Provides methods to perform CRUD operations on YouTube feeds.
+ Extends GDataService.
+"""
+
+__author__ = ('api.stephaniel@gmail.com (Stephanie Liu), '
+ 'api.jhartmann@gmail.com (Jochen Hartmann)')
+
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import os
+import atom
+import gdata
+import gdata.service
+import gdata.youtube
+
+YOUTUBE_SERVER = 'gdata.youtube.com'
+YOUTUBE_SERVICE = 'youtube'
+YOUTUBE_CLIENTLOGIN_AUTHENTICATION_URL = 'https://www.google.com/accounts/ClientLogin'
+YOUTUBE_SUPPORTED_UPLOAD_TYPES = ('mov', 'avi', 'wmv', 'mpg', 'quicktime',
+ 'flv', 'mp4', 'x-flv')
+YOUTUBE_QUERY_VALID_TIME_PARAMETERS = ('today', 'this_week', 'this_month',
+ 'all_time')
+YOUTUBE_QUERY_VALID_ORDERBY_PARAMETERS = ('published', 'viewCount', 'rating',
+ 'relevance')
+YOUTUBE_QUERY_VALID_RACY_PARAMETERS = ('include', 'exclude')
+YOUTUBE_QUERY_VALID_FORMAT_PARAMETERS = ('1', '5', '6')
+YOUTUBE_STANDARDFEEDS = ('most_recent', 'recently_featured',
+ 'top_rated', 'most_viewed','watch_on_mobile')
+YOUTUBE_UPLOAD_URI = 'https://uploads.gdata.youtube.com/feeds/api/users'
+YOUTUBE_UPLOAD_TOKEN_URI = 'https://gdata.youtube.com/action/GetUploadToken'
+YOUTUBE_VIDEO_URI = 'https://gdata.youtube.com/feeds/api/videos'
+YOUTUBE_USER_FEED_URI = 'https://gdata.youtube.com/feeds/api/users'
+YOUTUBE_PLAYLIST_FEED_URI = 'https://gdata.youtube.com/feeds/api/playlists'
+
+YOUTUBE_STANDARD_FEEDS = 'https://gdata.youtube.com/feeds/api/standardfeeds'
+YOUTUBE_STANDARD_TOP_RATED_URI = '%s/%s' % (YOUTUBE_STANDARD_FEEDS, 'top_rated')
+YOUTUBE_STANDARD_MOST_VIEWED_URI = '%s/%s' % (YOUTUBE_STANDARD_FEEDS,
+ 'most_viewed')
+YOUTUBE_STANDARD_RECENTLY_FEATURED_URI = '%s/%s' % (YOUTUBE_STANDARD_FEEDS,
+ 'recently_featured')
+YOUTUBE_STANDARD_WATCH_ON_MOBILE_URI = '%s/%s' % (YOUTUBE_STANDARD_FEEDS,
+ 'watch_on_mobile')
+YOUTUBE_STANDARD_TOP_FAVORITES_URI = '%s/%s' % (YOUTUBE_STANDARD_FEEDS,
+ 'top_favorites')
+YOUTUBE_STANDARD_MOST_RECENT_URI = '%s/%s' % (YOUTUBE_STANDARD_FEEDS,
+ 'most_recent')
+YOUTUBE_STANDARD_MOST_DISCUSSED_URI = '%s/%s' % (YOUTUBE_STANDARD_FEEDS,
+ 'most_discussed')
+YOUTUBE_STANDARD_MOST_LINKED_URI = '%s/%s' % (YOUTUBE_STANDARD_FEEDS,
+ 'most_linked')
+YOUTUBE_STANDARD_MOST_RESPONDED_URI = '%s/%s' % (YOUTUBE_STANDARD_FEEDS,
+ 'most_responded')
+YOUTUBE_SCHEMA = 'http://gdata.youtube.com/schemas'
+
+YOUTUBE_RATING_LINK_REL = '%s#video.ratings' % YOUTUBE_SCHEMA
+
+YOUTUBE_COMPLAINT_CATEGORY_SCHEME = '%s/%s' % (YOUTUBE_SCHEMA,
+ 'complaint-reasons.cat')
+YOUTUBE_SUBSCRIPTION_CATEGORY_SCHEME = '%s/%s' % (YOUTUBE_SCHEMA,
+ 'subscriptiontypes.cat')
+
+YOUTUBE_COMPLAINT_CATEGORY_TERMS = ('PORN', 'VIOLENCE', 'HATE', 'DANGEROUS',
+ 'RIGHTS', 'SPAM')
+YOUTUBE_CONTACT_STATUS = ('accepted', 'rejected')
+YOUTUBE_CONTACT_CATEGORY = ('Friends', 'Family')
+
+UNKOWN_ERROR = 1000
+YOUTUBE_BAD_REQUEST = 400
+YOUTUBE_CONFLICT = 409
+YOUTUBE_INTERNAL_SERVER_ERROR = 500
+YOUTUBE_INVALID_ARGUMENT = 601
+YOUTUBE_INVALID_CONTENT_TYPE = 602
+YOUTUBE_NOT_A_VIDEO = 603
+YOUTUBE_INVALID_KIND = 604
+
+
+class Error(Exception):
+ """Base class for errors within the YouTube service."""
+ pass
+
+class RequestError(Error):
+ """Error class that is thrown in response to an invalid HTTP Request."""
+ pass
+
+class YouTubeError(Error):
+ """YouTube service specific error class."""
+ pass
+
+class YouTubeService(gdata.service.GDataService):
+
+ """Client for the YouTube service.
+
+ Performs all documented Google Data YouTube API functions, such as inserting,
+ updating and deleting videos, comments, playlist, subscriptions etc.
+ YouTube Service requires authentication for any write, update or delete
+ actions.
+
+ Attributes:
+ email: An optional string identifying the user. Required only for
+ authenticated actions.
+ password: An optional string identifying the user's password.
+ source: An optional string identifying the name of your application.
+ server: An optional address of the YouTube API server. gdata.youtube.com
+ is provided as the default value.
+ additional_headers: An optional dictionary containing additional headers
+ to be passed along with each request. Use to store developer key.
+ client_id: An optional string identifying your application, required for
+ authenticated requests, along with a developer key.
+ developer_key: An optional string value. Register your application at
+ http://code.google.com/apis/youtube/dashboard to obtain a (free) key.
+ """
+
+ ssl = True
+
+ def __init__(self, email=None, password=None, source=None,
+ server=YOUTUBE_SERVER, additional_headers=None, client_id=None,
+ developer_key=None, **kwargs):
+ """Creates a client for the YouTube service.
+
+ Args:
+ email: string (optional) The user's email address, used for
+ authentication.
+ password: string (optional) The user's password.
+ source: string (optional) The name of the user's application.
+ server: string (optional) The name of the server to which a connection
+ will be opened. Default value: 'gdata.youtube.com'.
+ client_id: string (optional) Identifies your application, required for
+ authenticated requests, along with a developer key.
+ developer_key: string (optional) Register your application at
+ http://code.google.com/apis/youtube/dashboard to obtain a (free) key.
+ **kwargs: The other parameters to pass to gdata.service.GDataService
+ constructor.
+ """
+
+ gdata.service.GDataService.__init__(
+ self, email=email, password=password, service=YOUTUBE_SERVICE,
+ source=source, server=server, additional_headers=additional_headers,
+ **kwargs)
+
+ if client_id is not None:
+ self.additional_headers['X-Gdata-Client'] = client_id
+
+ if developer_key is not None:
+ self.additional_headers['X-GData-Key'] = 'key=%s' % developer_key
+
+ if 'GData-Version' not in self.additional_headers:
+ self.additional_headers['GData-Version'] = 1
+
+ self.auth_service_url = YOUTUBE_CLIENTLOGIN_AUTHENTICATION_URL
+
+ def GetYouTubeVideoFeed(self, uri):
+ """Retrieve a YouTubeVideoFeed.
+
+ Args:
+ uri: A string representing the URI of the feed that is to be retrieved.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ return self.Get(uri, converter=gdata.youtube.YouTubeVideoFeedFromString)
+
+ def GetYouTubeVideoEntry(self, uri=None, video_id=None):
+ """Retrieve a YouTubeVideoEntry.
+
+ Either a uri or a video_id must be provided.
+
+ Args:
+ uri: An optional string representing the URI of the entry that is to
+ be retrieved.
+ video_id: An optional string representing the ID of the video.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+
+ Raises:
+ YouTubeError: You must provide at least a uri or a video_id to the
+ GetYouTubeVideoEntry() method.
+ """
+ if uri is None and video_id is None:
+ raise YouTubeError('You must provide at least a uri or a video_id '
+ 'to the GetYouTubeVideoEntry() method')
+ elif video_id and not uri:
+ uri = '%s/%s' % (YOUTUBE_VIDEO_URI, video_id)
+ return self.Get(uri, converter=gdata.youtube.YouTubeVideoEntryFromString)
+
+ def GetYouTubeContactFeed(self, uri=None, username='default'):
+ """Retrieve a YouTubeContactFeed.
+
+ Either a uri or a username must be provided.
+
+ Args:
+ uri: An optional string representing the URI of the contact feed that
+ is to be retrieved.
+ username: An optional string representing the username. Defaults to the
+ currently authenticated user.
+
+ Returns:
+ A YouTubeContactFeed if successfully retrieved.
+
+ Raises:
+ YouTubeError: You must provide at least a uri or a username to the
+ GetYouTubeContactFeed() method.
+ """
+ if uri is None:
+ uri = '%s/%s/%s' % (YOUTUBE_USER_FEED_URI, username, 'contacts')
+ return self.Get(uri, converter=gdata.youtube.YouTubeContactFeedFromString)
+
+ def GetYouTubeContactEntry(self, uri):
+ """Retrieve a YouTubeContactEntry.
+
+ Args:
+ uri: A string representing the URI of the contact entry that is to
+ be retrieved.
+
+ Returns:
+ A YouTubeContactEntry if successfully retrieved.
+ """
+ return self.Get(uri, converter=gdata.youtube.YouTubeContactEntryFromString)
+
+ def GetYouTubeVideoCommentFeed(self, uri=None, video_id=None):
+ """Retrieve a YouTubeVideoCommentFeed.
+
+ Either a uri or a video_id must be provided.
+
+ Args:
+ uri: An optional string representing the URI of the comment feed that
+ is to be retrieved.
+ video_id: An optional string representing the ID of the video for which
+ to retrieve the comment feed.
+
+ Returns:
+ A YouTubeVideoCommentFeed if successfully retrieved.
+
+ Raises:
+ YouTubeError: You must provide at least a uri or a video_id to the
+ GetYouTubeVideoCommentFeed() method.
+ """
+ if uri is None and video_id is None:
+ raise YouTubeError('You must provide at least a uri or a video_id '
+ 'to the GetYouTubeVideoCommentFeed() method')
+ elif video_id and not uri:
+ uri = '%s/%s/%s' % (YOUTUBE_VIDEO_URI, video_id, 'comments')
+ return self.Get(
+ uri, converter=gdata.youtube.YouTubeVideoCommentFeedFromString)
+
+ def GetYouTubeVideoCommentEntry(self, uri):
+ """Retrieve a YouTubeVideoCommentEntry.
+
+ Args:
+ uri: A string representing the URI of the comment entry that is to
+ be retrieved.
+
+ Returns:
+ A YouTubeCommentEntry if successfully retrieved.
+ """
+ return self.Get(
+ uri, converter=gdata.youtube.YouTubeVideoCommentEntryFromString)
+
+ def GetYouTubeUserFeed(self, uri=None, username=None):
+ """Retrieve a YouTubeVideoFeed of user uploaded videos
+
+ Either a uri or a username must be provided. This will retrieve list
+ of videos uploaded by specified user. The uri will be of format
+ "http://gdata.youtube.com/feeds/api/users/{username}/uploads".
+
+ Args:
+ uri: An optional string representing the URI of the user feed that is
+ to be retrieved.
+ username: An optional string representing the username.
+
+ Returns:
+ A YouTubeUserFeed if successfully retrieved.
+
+ Raises:
+ YouTubeError: You must provide at least a uri or a username to the
+ GetYouTubeUserFeed() method.
+ """
+ if uri is None and username is None:
+ raise YouTubeError('You must provide at least a uri or a username '
+ 'to the GetYouTubeUserFeed() method')
+ elif username and not uri:
+ uri = '%s/%s/%s' % (YOUTUBE_USER_FEED_URI, username, 'uploads')
+ return self.Get(uri, converter=gdata.youtube.YouTubeUserFeedFromString)
+
+ def GetYouTubeUserEntry(self, uri=None, username=None):
+ """Retrieve a YouTubeUserEntry.
+
+ Either a uri or a username must be provided.
+
+ Args:
+ uri: An optional string representing the URI of the user entry that is
+ to be retrieved.
+ username: An optional string representing the username.
+
+ Returns:
+ A YouTubeUserEntry if successfully retrieved.
+
+ Raises:
+ YouTubeError: You must provide at least a uri or a username to the
+ GetYouTubeUserEntry() method.
+ """
+ if uri is None and username is None:
+ raise YouTubeError('You must provide at least a uri or a username '
+ 'to the GetYouTubeUserEntry() method')
+ elif username and not uri:
+ uri = '%s/%s' % (YOUTUBE_USER_FEED_URI, username)
+ return self.Get(uri, converter=gdata.youtube.YouTubeUserEntryFromString)
+
+ def GetYouTubePlaylistFeed(self, uri=None, username='default'):
+ """Retrieve a YouTubePlaylistFeed (a feed of playlists for a user).
+
+ Either a uri or a username must be provided.
+
+ Args:
+ uri: An optional string representing the URI of the playlist feed that
+ is to be retrieved.
+ username: An optional string representing the username. Defaults to the
+ currently authenticated user.
+
+ Returns:
+ A YouTubePlaylistFeed if successfully retrieved.
+
+ Raises:
+ YouTubeError: You must provide at least a uri or a username to the
+ GetYouTubePlaylistFeed() method.
+ """
+ if uri is None:
+ uri = '%s/%s/%s' % (YOUTUBE_USER_FEED_URI, username, 'playlists')
+ return self.Get(uri, converter=gdata.youtube.YouTubePlaylistFeedFromString)
+
+ def GetYouTubePlaylistEntry(self, uri):
+ """Retrieve a YouTubePlaylistEntry.
+
+ Args:
+ uri: A string representing the URI of the playlist feed that is to
+ be retrieved.
+
+ Returns:
+ A YouTubePlaylistEntry if successfully retrieved.
+ """
+ return self.Get(uri, converter=gdata.youtube.YouTubePlaylistEntryFromString)
+
+ def GetYouTubePlaylistVideoFeed(self, uri=None, playlist_id=None):
+ """Retrieve a YouTubePlaylistVideoFeed (a feed of videos on a playlist).
+
+ Either a uri or a playlist_id must be provided.
+
+ Args:
+ uri: An optional string representing the URI of the playlist video feed
+ that is to be retrieved.
+ playlist_id: An optional string representing the Id of the playlist whose
+ playlist video feed is to be retrieved.
+
+ Returns:
+ A YouTubePlaylistVideoFeed if successfully retrieved.
+
+ Raises:
+ YouTubeError: You must provide at least a uri or a playlist_id to the
+ GetYouTubePlaylistVideoFeed() method.
+ """
+ if uri is None and playlist_id is None:
+ raise YouTubeError('You must provide at least a uri or a playlist_id '
+ 'to the GetYouTubePlaylistVideoFeed() method')
+ elif playlist_id and not uri:
+ uri = '%s/%s' % (YOUTUBE_PLAYLIST_FEED_URI, playlist_id)
+ return self.Get(
+ uri, converter=gdata.youtube.YouTubePlaylistVideoFeedFromString)
+
+ def GetYouTubeVideoResponseFeed(self, uri=None, video_id=None):
+ """Retrieve a YouTubeVideoResponseFeed.
+
+ Either a uri or a playlist_id must be provided.
+
+ Args:
+ uri: An optional string representing the URI of the video response feed
+ that is to be retrieved.
+ video_id: An optional string representing the ID of the video whose
+ response feed is to be retrieved.
+
+ Returns:
+ A YouTubeVideoResponseFeed if successfully retrieved.
+
+ Raises:
+ YouTubeError: You must provide at least a uri or a video_id to the
+ GetYouTubeVideoResponseFeed() method.
+ """
+ if uri is None and video_id is None:
+ raise YouTubeError('You must provide at least a uri or a video_id '
+ 'to the GetYouTubeVideoResponseFeed() method')
+ elif video_id and not uri:
+ uri = '%s/%s/%s' % (YOUTUBE_VIDEO_URI, video_id, 'responses')
+ return self.Get(
+ uri, converter=gdata.youtube.YouTubeVideoResponseFeedFromString)
+
+ def GetYouTubeVideoResponseEntry(self, uri):
+ """Retrieve a YouTubeVideoResponseEntry.
+
+ Args:
+ uri: A string representing the URI of the video response entry that
+ is to be retrieved.
+
+ Returns:
+ A YouTubeVideoResponseEntry if successfully retrieved.
+ """
+ return self.Get(
+ uri, converter=gdata.youtube.YouTubeVideoResponseEntryFromString)
+
+ def GetYouTubeSubscriptionFeed(self, uri=None, username='default'):
+ """Retrieve a YouTubeSubscriptionFeed.
+
+ Either the uri of the feed or a username must be provided.
+
+ Args:
+ uri: An optional string representing the URI of the feed that is to
+ be retrieved.
+ username: An optional string representing the username whose subscription
+ feed is to be retrieved. Defaults to the currently authenticted user.
+
+ Returns:
+ A YouTubeVideoSubscriptionFeed if successfully retrieved.
+ """
+ if uri is None:
+ uri = '%s/%s/%s' % (YOUTUBE_USER_FEED_URI, username, 'subscriptions')
+ return self.Get(
+ uri, converter=gdata.youtube.YouTubeSubscriptionFeedFromString)
+
+ def GetYouTubeSubscriptionEntry(self, uri):
+ """Retrieve a YouTubeSubscriptionEntry.
+
+ Args:
+ uri: A string representing the URI of the entry that is to be retrieved.
+
+ Returns:
+ A YouTubeVideoSubscriptionEntry if successfully retrieved.
+ """
+ return self.Get(
+ uri, converter=gdata.youtube.YouTubeSubscriptionEntryFromString)
+
+ def GetYouTubeRelatedVideoFeed(self, uri=None, video_id=None):
+ """Retrieve a YouTubeRelatedVideoFeed.
+
+ Either a uri for the feed or a video_id is required.
+
+ Args:
+ uri: An optional string representing the URI of the feed that is to
+ be retrieved.
+ video_id: An optional string representing the ID of the video for which
+ to retrieve the related video feed.
+
+ Returns:
+ A YouTubeRelatedVideoFeed if successfully retrieved.
+
+ Raises:
+ YouTubeError: You must provide at least a uri or a video_id to the
+ GetYouTubeRelatedVideoFeed() method.
+ """
+ if uri is None and video_id is None:
+ raise YouTubeError('You must provide at least a uri or a video_id '
+ 'to the GetYouTubeRelatedVideoFeed() method')
+ elif video_id and not uri:
+ uri = '%s/%s/%s' % (YOUTUBE_VIDEO_URI, video_id, 'related')
+ return self.Get(
+ uri, converter=gdata.youtube.YouTubeVideoFeedFromString)
+
+ def GetTopRatedVideoFeed(self):
+ """Retrieve the 'top_rated' standard video feed.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ return self.GetYouTubeVideoFeed(YOUTUBE_STANDARD_TOP_RATED_URI)
+
+ def GetMostViewedVideoFeed(self):
+ """Retrieve the 'most_viewed' standard video feed.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ return self.GetYouTubeVideoFeed(YOUTUBE_STANDARD_MOST_VIEWED_URI)
+
+ def GetRecentlyFeaturedVideoFeed(self):
+ """Retrieve the 'recently_featured' standard video feed.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ return self.GetYouTubeVideoFeed(YOUTUBE_STANDARD_RECENTLY_FEATURED_URI)
+
+ def GetWatchOnMobileVideoFeed(self):
+ """Retrieve the 'watch_on_mobile' standard video feed.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ return self.GetYouTubeVideoFeed(YOUTUBE_STANDARD_WATCH_ON_MOBILE_URI)
+
+ def GetTopFavoritesVideoFeed(self):
+ """Retrieve the 'top_favorites' standard video feed.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ return self.GetYouTubeVideoFeed(YOUTUBE_STANDARD_TOP_FAVORITES_URI)
+
+ def GetMostRecentVideoFeed(self):
+ """Retrieve the 'most_recent' standard video feed.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ return self.GetYouTubeVideoFeed(YOUTUBE_STANDARD_MOST_RECENT_URI)
+
+ def GetMostDiscussedVideoFeed(self):
+ """Retrieve the 'most_discussed' standard video feed.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ return self.GetYouTubeVideoFeed(YOUTUBE_STANDARD_MOST_DISCUSSED_URI)
+
+ def GetMostLinkedVideoFeed(self):
+ """Retrieve the 'most_linked' standard video feed.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ return self.GetYouTubeVideoFeed(YOUTUBE_STANDARD_MOST_LINKED_URI)
+
+ def GetMostRespondedVideoFeed(self):
+ """Retrieve the 'most_responded' standard video feed.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ return self.GetYouTubeVideoFeed(YOUTUBE_STANDARD_MOST_RESPONDED_URI)
+
+ def GetUserFavoritesFeed(self, username='default'):
+ """Retrieve the favorites feed for a given user.
+
+ Args:
+ username: An optional string representing the username whose favorites
+ feed is to be retrieved. Defaults to the currently authenticated user.
+
+ Returns:
+ A YouTubeVideoFeed if successfully retrieved.
+ """
+ favorites_feed_uri = '%s/%s/%s' % (YOUTUBE_USER_FEED_URI, username,
+ 'favorites')
+ return self.GetYouTubeVideoFeed(favorites_feed_uri)
+
+ def InsertVideoEntry(self, video_entry, filename_or_handle,
+ youtube_username='default',
+ content_type='video/quicktime'):
+ """Upload a new video to YouTube using the direct upload mechanism.
+
+ Needs authentication.
+
+ Args:
+ video_entry: The YouTubeVideoEntry to upload.
+ filename_or_handle: A file-like object or file name where the video
+ will be read from.
+ youtube_username: An optional string representing the username into whose
+ account this video is to be uploaded to. Defaults to the currently
+ authenticated user.
+ content_type: An optional string representing internet media type
+ (a.k.a. mime type) of the media object. Currently the YouTube API
+ supports these types:
+ o video/mpeg
+ o video/quicktime
+ o video/x-msvideo
+ o video/mp4
+ o video/x-flv
+
+ Returns:
+ The newly created YouTubeVideoEntry if successful.
+
+ Raises:
+ AssertionError: video_entry must be a gdata.youtube.VideoEntry instance.
+ YouTubeError: An error occurred trying to read the video file provided.
+ gdata.service.RequestError: An error occurred trying to upload the video
+ to the API server.
+ """
+
+ # We need to perform a series of checks on the video_entry and on the
+ # file that we plan to upload, such as checking whether we have a valid
+ # video_entry and that the file is the correct type and readable, prior
+ # to performing the actual POST request.
+
+ try:
+ assert(isinstance(video_entry, gdata.youtube.YouTubeVideoEntry))
+ except AssertionError:
+ raise YouTubeError({'status':YOUTUBE_INVALID_ARGUMENT,
+ 'body':'`video_entry` must be a gdata.youtube.VideoEntry instance',
+ 'reason':'Found %s, not VideoEntry' % type(video_entry)
+ })
+ #majtype, mintype = content_type.split('/')
+ #
+ #try:
+ # assert(mintype in YOUTUBE_SUPPORTED_UPLOAD_TYPES)
+ #except (ValueError, AssertionError):
+ # raise YouTubeError({'status':YOUTUBE_INVALID_CONTENT_TYPE,
+ # 'body':'This is not a valid content type: %s' % content_type,
+ # 'reason':'Accepted content types: %s' %
+ # ['video/%s' % (t) for t in YOUTUBE_SUPPORTED_UPLOAD_TYPES]})
+
+ if (isinstance(filename_or_handle, (str, unicode))
+ and os.path.exists(filename_or_handle)):
+ mediasource = gdata.MediaSource()
+ mediasource.setFile(filename_or_handle, content_type)
+ elif hasattr(filename_or_handle, 'read'):
+ import StringIO
+ if hasattr(filename_or_handle, 'seek'):
+ filename_or_handle.seek(0)
+ file_handle = filename_or_handle
+ name = 'video'
+ if hasattr(filename_or_handle, 'name'):
+ name = filename_or_handle.name
+ mediasource = gdata.MediaSource(file_handle, content_type,
+ content_length=file_handle.len, file_name=name)
+ else:
+ raise YouTubeError({'status':YOUTUBE_INVALID_ARGUMENT, 'body':
+ '`filename_or_handle` must be a path name or a file-like object',
+ 'reason': ('Found %s, not path name or object '
+ 'with a .read() method' % type(filename_or_handle))})
+ upload_uri = '%s/%s/%s' % (YOUTUBE_UPLOAD_URI, youtube_username,
+ 'uploads')
+ self.additional_headers['Slug'] = mediasource.file_name
+
+ # Using a nested try statement to retain Python 2.4 compatibility
+ try:
+ try:
+ return self.Post(video_entry, uri=upload_uri, media_source=mediasource,
+ converter=gdata.youtube.YouTubeVideoEntryFromString)
+ except gdata.service.RequestError, e:
+ raise YouTubeError(e.args[0])
+ finally:
+ del(self.additional_headers['Slug'])
+
+ def CheckUploadStatus(self, video_entry=None, video_id=None):
+ """Check upload status on a recently uploaded video entry.
+
+ Needs authentication. Either video_entry or video_id must be provided.
+
+ Args:
+ video_entry: An optional YouTubeVideoEntry whose upload status to check
+ video_id: An optional string representing the ID of the uploaded video
+ whose status is to be checked.
+
+ Returns:
+ A tuple containing (video_upload_state, detailed_message) or None if
+ no status information is found.
+
+ Raises:
+ YouTubeError: You must provide at least a video_entry or a video_id to the
+ CheckUploadStatus() method.
+ """
+ if video_entry is None and video_id is None:
+ raise YouTubeError('You must provide at least a uri or a video_id '
+ 'to the CheckUploadStatus() method')
+ elif video_id and not video_entry:
+ video_entry = self.GetYouTubeVideoEntry(video_id=video_id)
+
+ control = video_entry.control
+ if control is not None:
+ draft = control.draft
+ if draft is not None:
+ if draft.text == 'yes':
+ yt_state = control.extension_elements[0]
+ if yt_state is not None:
+ state_value = yt_state.attributes['name']
+ message = ''
+ if yt_state.text is not None:
+ message = yt_state.text
+
+ return (state_value, message)
+
+ def GetFormUploadToken(self, video_entry, uri=YOUTUBE_UPLOAD_TOKEN_URI):
+ """Receives a YouTube Token and a YouTube PostUrl from a YouTubeVideoEntry.
+
+ Needs authentication.
+
+ Args:
+ video_entry: The YouTubeVideoEntry to upload (meta-data only).
+ uri: An optional string representing the URI from where to fetch the
+ token information. Defaults to the YOUTUBE_UPLOADTOKEN_URI.
+
+ Returns:
+ A tuple containing the URL to which to post your video file, along
+ with the youtube token that must be included with your upload in the
+ form of: (post_url, youtube_token).
+ """
+ try:
+ response = self.Post(video_entry, uri)
+ except gdata.service.RequestError, e:
+ raise YouTubeError(e.args[0])
+
+ tree = ElementTree.fromstring(response)
+
+ for child in tree:
+ if child.tag == 'url':
+ post_url = child.text
+ elif child.tag == 'token':
+ youtube_token = child.text
+ return (post_url, youtube_token)
+
+ def UpdateVideoEntry(self, video_entry):
+ """Updates a video entry's meta-data.
+
+ Needs authentication.
+
+ Args:
+ video_entry: The YouTubeVideoEntry to update, containing updated
+ meta-data.
+
+ Returns:
+ An updated YouTubeVideoEntry on success or None.
+ """
+ for link in video_entry.link:
+ if link.rel == 'edit':
+ edit_uri = link.href
+ return self.Put(video_entry, uri=edit_uri,
+ converter=gdata.youtube.YouTubeVideoEntryFromString)
+
+ def DeleteVideoEntry(self, video_entry):
+ """Deletes a video entry.
+
+ Needs authentication.
+
+ Args:
+ video_entry: The YouTubeVideoEntry to be deleted.
+
+ Returns:
+ True if entry was deleted successfully.
+ """
+ for link in video_entry.link:
+ if link.rel == 'edit':
+ edit_uri = link.href
+ return self.Delete(edit_uri)
+
+ def AddRating(self, rating_value, video_entry):
+ """Add a rating to a video entry.
+
+ Needs authentication.
+
+ Args:
+ rating_value: The integer value for the rating (between 1 and 5).
+ video_entry: The YouTubeVideoEntry to be rated.
+
+ Returns:
+ True if the rating was added successfully.
+
+ Raises:
+ YouTubeError: rating_value must be between 1 and 5 in AddRating().
+ """
+ if rating_value < 1 or rating_value > 5:
+ raise YouTubeError('rating_value must be between 1 and 5 in AddRating()')
+
+ entry = gdata.GDataEntry()
+ rating = gdata.youtube.Rating(min='1', max='5')
+ rating.extension_attributes['name'] = 'value'
+ rating.extension_attributes['value'] = str(rating_value)
+ entry.extension_elements.append(rating)
+
+ for link in video_entry.link:
+ if link.rel == YOUTUBE_RATING_LINK_REL:
+ rating_uri = link.href
+
+ return self.Post(entry, uri=rating_uri)
+
+ def AddComment(self, comment_text, video_entry):
+ """Add a comment to a video entry.
+
+ Needs authentication. Note that each comment that is posted must contain
+ the video entry that it is to be posted to.
+
+ Args:
+ comment_text: A string representing the text of the comment.
+ video_entry: The YouTubeVideoEntry to be commented on.
+
+ Returns:
+ True if the comment was added successfully.
+ """
+ content = atom.Content(text=comment_text)
+ comment_entry = gdata.youtube.YouTubeVideoCommentEntry(content=content)
+ comment_post_uri = video_entry.comments.feed_link[0].href
+
+ return self.Post(comment_entry, uri=comment_post_uri)
+
+ def AddVideoResponse(self, video_id_to_respond_to, video_response):
+ """Add a video response.
+
+ Needs authentication.
+
+ Args:
+ video_id_to_respond_to: A string representing the ID of the video to be
+ responded to.
+ video_response: YouTubeVideoEntry to be posted as a response.
+
+ Returns:
+ True if video response was posted successfully.
+ """
+ post_uri = '%s/%s/%s' % (YOUTUBE_VIDEO_URI, video_id_to_respond_to,
+ 'responses')
+ return self.Post(video_response, uri=post_uri)
+
+ def DeleteVideoResponse(self, video_id, response_video_id):
+ """Delete a video response.
+
+ Needs authentication.
+
+ Args:
+ video_id: A string representing the ID of video that contains the
+ response.
+ response_video_id: A string representing the ID of the video that was
+ posted as a response.
+
+ Returns:
+ True if video response was deleted succcessfully.
+ """
+ delete_uri = '%s/%s/%s/%s' % (YOUTUBE_VIDEO_URI, video_id, 'responses',
+ response_video_id)
+ return self.Delete(delete_uri)
+
+ def AddComplaint(self, complaint_text, complaint_term, video_id):
+ """Add a complaint for a particular video entry.
+
+ Needs authentication.
+
+ Args:
+ complaint_text: A string representing the complaint text.
+ complaint_term: A string representing the complaint category term.
+ video_id: A string representing the ID of YouTubeVideoEntry to
+ complain about.
+
+ Returns:
+ True if posted successfully.
+
+ Raises:
+ YouTubeError: Your complaint_term is not valid.
+ """
+ if complaint_term not in YOUTUBE_COMPLAINT_CATEGORY_TERMS:
+ raise YouTubeError('Your complaint_term is not valid')
+
+ content = atom.Content(text=complaint_text)
+ category = atom.Category(term=complaint_term,
+ scheme=YOUTUBE_COMPLAINT_CATEGORY_SCHEME)
+
+ complaint_entry = gdata.GDataEntry(content=content, category=[category])
+ post_uri = '%s/%s/%s' % (YOUTUBE_VIDEO_URI, video_id, 'complaints')
+
+ return self.Post(complaint_entry, post_uri)
+
+ def AddVideoEntryToFavorites(self, video_entry, username='default'):
+ """Add a video entry to a users favorite feed.
+
+ Needs authentication.
+
+ Args:
+ video_entry: The YouTubeVideoEntry to add.
+ username: An optional string representing the username to whose favorite
+ feed you wish to add the entry. Defaults to the currently
+ authenticated user.
+ Returns:
+ The posted YouTubeVideoEntry if successfully posted.
+ """
+ post_uri = '%s/%s/%s' % (YOUTUBE_USER_FEED_URI, username, 'favorites')
+
+ return self.Post(video_entry, post_uri,
+ converter=gdata.youtube.YouTubeVideoEntryFromString)
+
+ def DeleteVideoEntryFromFavorites(self, video_id, username='default'):
+ """Delete a video entry from the users favorite feed.
+
+ Needs authentication.
+
+ Args:
+ video_id: A string representing the ID of the video that is to be removed
+ username: An optional string representing the username of the user's
+ favorite feed. Defaults to the currently authenticated user.
+
+ Returns:
+ True if entry was successfully deleted.
+ """
+ edit_link = '%s/%s/%s/%s' % (YOUTUBE_USER_FEED_URI, username, 'favorites',
+ video_id)
+ return self.Delete(edit_link)
+
+ def AddPlaylist(self, playlist_title, playlist_description,
+ playlist_private=None):
+ """Add a new playlist to the currently authenticated users account.
+
+ Needs authentication.
+
+ Args:
+ playlist_title: A string representing the title for the new playlist.
+ playlist_description: A string representing the description of the
+ playlist.
+ playlist_private: An optional boolean, set to True if the playlist is
+ to be private.
+
+ Returns:
+ The YouTubePlaylistEntry if successfully posted.
+ """
+ playlist_entry = gdata.youtube.YouTubePlaylistEntry(
+ title=atom.Title(text=playlist_title),
+ description=gdata.youtube.Description(text=playlist_description))
+ if playlist_private:
+ playlist_entry.private = gdata.youtube.Private()
+
+ playlist_post_uri = '%s/%s/%s' % (YOUTUBE_USER_FEED_URI, 'default',
+ 'playlists')
+ return self.Post(playlist_entry, playlist_post_uri,
+ converter=gdata.youtube.YouTubePlaylistEntryFromString)
+
+ def UpdatePlaylist(self, playlist_id, new_playlist_title,
+ new_playlist_description, playlist_private=None,
+ username='default'):
+ """Update a playlist with new meta-data.
+
+ Needs authentication.
+
+ Args:
+ playlist_id: A string representing the ID of the playlist to be updated.
+ new_playlist_title: A string representing a new title for the playlist.
+ new_playlist_description: A string representing a new description for the
+ playlist.
+ playlist_private: An optional boolean, set to True if the playlist is
+ to be private.
+ username: An optional string representing the username whose playlist is
+ to be updated. Defaults to the currently authenticated user.
+
+ Returns:
+ A YouTubePlaylistEntry if the update was successful.
+ """
+ updated_playlist = gdata.youtube.YouTubePlaylistEntry(
+ title=atom.Title(text=new_playlist_title),
+ description=gdata.youtube.Description(text=new_playlist_description))
+ if playlist_private:
+ updated_playlist.private = gdata.youtube.Private()
+
+ playlist_put_uri = '%s/%s/playlists/%s' % (YOUTUBE_USER_FEED_URI, username,
+ playlist_id)
+
+ return self.Put(updated_playlist, playlist_put_uri,
+ converter=gdata.youtube.YouTubePlaylistEntryFromString)
+
+ def DeletePlaylist(self, playlist_uri):
+ """Delete a playlist from the currently authenticated users playlists.
+
+ Needs authentication.
+
+ Args:
+ playlist_uri: A string representing the URI of the playlist that is
+ to be deleted.
+
+ Returns:
+ True if successfully deleted.
+ """
+ return self.Delete(playlist_uri)
+
+ def AddPlaylistVideoEntryToPlaylist(
+ self, playlist_uri, video_id, custom_video_title=None,
+ custom_video_description=None):
+ """Add a video entry to a playlist, optionally providing a custom title
+ and description.
+
+ Needs authentication.
+
+ Args:
+ playlist_uri: A string representing the URI of the playlist to which this
+ video entry is to be added.
+ video_id: A string representing the ID of the video entry to add.
+ custom_video_title: An optional string representing a custom title for
+ the video (only shown on the playlist).
+ custom_video_description: An optional string representing a custom
+ description for the video (only shown on the playlist).
+
+ Returns:
+ A YouTubePlaylistVideoEntry if successfully posted.
+ """
+ playlist_video_entry = gdata.youtube.YouTubePlaylistVideoEntry(
+ atom_id=atom.Id(text=video_id))
+ if custom_video_title:
+ playlist_video_entry.title = atom.Title(text=custom_video_title)
+ if custom_video_description:
+ playlist_video_entry.description = gdata.youtube.Description(
+ text=custom_video_description)
+
+ return self.Post(playlist_video_entry, playlist_uri,
+ converter=gdata.youtube.YouTubePlaylistVideoEntryFromString)
+
+ def UpdatePlaylistVideoEntryMetaData(
+ self, playlist_uri, playlist_entry_id, new_video_title,
+ new_video_description, new_video_position):
+ """Update the meta data for a YouTubePlaylistVideoEntry.
+
+ Needs authentication.
+
+ Args:
+ playlist_uri: A string representing the URI of the playlist that contains
+ the entry to be updated.
+ playlist_entry_id: A string representing the ID of the entry to be
+ updated.
+ new_video_title: A string representing the new title for the video entry.
+ new_video_description: A string representing the new description for
+ the video entry.
+ new_video_position: An integer representing the new position on the
+ playlist for the video.
+
+ Returns:
+ A YouTubePlaylistVideoEntry if the update was successful.
+ """
+ playlist_video_entry = gdata.youtube.YouTubePlaylistVideoEntry(
+ title=atom.Title(text=new_video_title),
+ description=gdata.youtube.Description(text=new_video_description),
+ position=gdata.youtube.Position(text=str(new_video_position)))
+
+ playlist_put_uri = playlist_uri + '/' + playlist_entry_id
+
+ return self.Put(playlist_video_entry, playlist_put_uri,
+ converter=gdata.youtube.YouTubePlaylistVideoEntryFromString)
+
+ def DeletePlaylistVideoEntry(self, playlist_uri, playlist_video_entry_id):
+ """Delete a playlist video entry from a playlist.
+
+ Needs authentication.
+
+ Args:
+ playlist_uri: A URI representing the playlist from which the playlist
+ video entry is to be removed from.
+ playlist_video_entry_id: A string representing id of the playlist video
+ entry that is to be removed.
+
+ Returns:
+ True if entry was successfully deleted.
+ """
+ delete_uri = '%s/%s' % (playlist_uri, playlist_video_entry_id)
+ return self.Delete(delete_uri)
+
+ def AddSubscriptionToChannel(self, username_to_subscribe_to,
+ my_username = 'default'):
+ """Add a new channel subscription to the currently authenticated users
+ account.
+
+ Needs authentication.
+
+ Args:
+ username_to_subscribe_to: A string representing the username of the
+ channel to which we want to subscribe to.
+ my_username: An optional string representing the name of the user which
+ we want to subscribe. Defaults to currently authenticated user.
+
+ Returns:
+ A new YouTubeSubscriptionEntry if successfully posted.
+ """
+ subscription_category = atom.Category(
+ scheme=YOUTUBE_SUBSCRIPTION_CATEGORY_SCHEME,
+ term='channel')
+ subscription_username = gdata.youtube.Username(
+ text=username_to_subscribe_to)
+
+ subscription_entry = gdata.youtube.YouTubeSubscriptionEntry(
+ category=subscription_category,
+ username=subscription_username)
+
+ post_uri = '%s/%s/%s' % (YOUTUBE_USER_FEED_URI, my_username,
+ 'subscriptions')
+
+ return self.Post(subscription_entry, post_uri,
+ converter=gdata.youtube.YouTubeSubscriptionEntryFromString)
+
+ def AddSubscriptionToFavorites(self, username, my_username = 'default'):
+ """Add a new subscription to a users favorites to the currently
+ authenticated user's account.
+
+ Needs authentication
+
+ Args:
+ username: A string representing the username of the user's favorite feed
+ to subscribe to.
+ my_username: An optional string representing the username of the user
+ that is to be subscribed. Defaults to currently authenticated user.
+
+ Returns:
+ A new YouTubeSubscriptionEntry if successful.
+ """
+ subscription_category = atom.Category(
+ scheme=YOUTUBE_SUBSCRIPTION_CATEGORY_SCHEME,
+ term='favorites')
+ subscription_username = gdata.youtube.Username(text=username)
+
+ subscription_entry = gdata.youtube.YouTubeSubscriptionEntry(
+ category=subscription_category,
+ username=subscription_username)
+
+ post_uri = '%s/%s/%s' % (YOUTUBE_USER_FEED_URI, my_username,
+ 'subscriptions')
+
+ return self.Post(subscription_entry, post_uri,
+ converter=gdata.youtube.YouTubeSubscriptionEntryFromString)
+
+ def AddSubscriptionToQuery(self, query, my_username = 'default'):
+ """Add a new subscription to a specific keyword query to the currently
+ authenticated user's account.
+
+ Needs authentication
+
+ Args:
+ query: A string representing the keyword query to subscribe to.
+ my_username: An optional string representing the username of the user
+ that is to be subscribed. Defaults to currently authenticated user.
+
+ Returns:
+ A new YouTubeSubscriptionEntry if successful.
+ """
+ subscription_category = atom.Category(
+ scheme=YOUTUBE_SUBSCRIPTION_CATEGORY_SCHEME,
+ term='query')
+ subscription_query_string = gdata.youtube.QueryString(text=query)
+
+ subscription_entry = gdata.youtube.YouTubeSubscriptionEntry(
+ category=subscription_category,
+ query_string=subscription_query_string)
+
+ post_uri = '%s/%s/%s' % (YOUTUBE_USER_FEED_URI, my_username,
+ 'subscriptions')
+
+ return self.Post(subscription_entry, post_uri,
+ converter=gdata.youtube.YouTubeSubscriptionEntryFromString)
+
+
+
+ def DeleteSubscription(self, subscription_uri):
+ """Delete a subscription from the currently authenticated user's account.
+
+ Needs authentication.
+
+ Args:
+ subscription_uri: A string representing the URI of the subscription that
+ is to be deleted.
+
+ Returns:
+ True if deleted successfully.
+ """
+ return self.Delete(subscription_uri)
+
+ def AddContact(self, contact_username, my_username='default'):
+ """Add a new contact to the currently authenticated user's contact feed.
+
+ Needs authentication.
+
+ Args:
+ contact_username: A string representing the username of the contact
+ that you wish to add.
+ my_username: An optional string representing the username to whose
+ contact the new contact is to be added.
+
+ Returns:
+ A YouTubeContactEntry if added successfully.
+ """
+ contact_category = atom.Category(
+ scheme = 'http://gdata.youtube.com/schemas/2007/contact.cat',
+ term = 'Friends')
+ contact_username = gdata.youtube.Username(text=contact_username)
+ contact_entry = gdata.youtube.YouTubeContactEntry(
+ category=contact_category,
+ username=contact_username)
+
+ contact_post_uri = '%s/%s/%s' % (YOUTUBE_USER_FEED_URI, my_username,
+ 'contacts')
+
+ return self.Post(contact_entry, contact_post_uri,
+ converter=gdata.youtube.YouTubeContactEntryFromString)
+
+ def UpdateContact(self, contact_username, new_contact_status,
+ new_contact_category, my_username='default'):
+ """Update a contact, providing a new status and a new category.
+
+ Needs authentication.
+
+ Args:
+ contact_username: A string representing the username of the contact
+ that is to be updated.
+ new_contact_status: A string representing the new status of the contact.
+ This can either be set to 'accepted' or 'rejected'.
+ new_contact_category: A string representing the new category for the
+ contact, either 'Friends' or 'Family'.
+ my_username: An optional string representing the username of the user
+ whose contact feed we are modifying. Defaults to the currently
+ authenticated user.
+
+ Returns:
+ A YouTubeContactEntry if updated succesfully.
+
+ Raises:
+ YouTubeError: New contact status must be within the accepted values. Or
+ new contact category must be within the accepted categories.
+ """
+ if new_contact_status not in YOUTUBE_CONTACT_STATUS:
+ raise YouTubeError('New contact status must be one of %s' %
+ (' '.join(YOUTUBE_CONTACT_STATUS)))
+ if new_contact_category not in YOUTUBE_CONTACT_CATEGORY:
+ raise YouTubeError('New contact category must be one of %s' %
+ (' '.join(YOUTUBE_CONTACT_CATEGORY)))
+
+ contact_category = atom.Category(
+ scheme='http://gdata.youtube.com/schemas/2007/contact.cat',
+ term=new_contact_category)
+
+ contact_status = gdata.youtube.Status(text=new_contact_status)
+ contact_entry = gdata.youtube.YouTubeContactEntry(
+ category=contact_category,
+ status=contact_status)
+
+ contact_put_uri = '%s/%s/%s/%s' % (YOUTUBE_USER_FEED_URI, my_username,
+ 'contacts', contact_username)
+
+ return self.Put(contact_entry, contact_put_uri,
+ converter=gdata.youtube.YouTubeContactEntryFromString)
+
+ def DeleteContact(self, contact_username, my_username='default'):
+ """Delete a contact from a users contact feed.
+
+ Needs authentication.
+
+ Args:
+ contact_username: A string representing the username of the contact
+ that is to be deleted.
+ my_username: An optional string representing the username of the user's
+ contact feed from which to delete the contact. Defaults to the
+ currently authenticated user.
+
+ Returns:
+ True if the contact was deleted successfully
+ """
+ contact_edit_uri = '%s/%s/%s/%s' % (YOUTUBE_USER_FEED_URI, my_username,
+ 'contacts', contact_username)
+ return self.Delete(contact_edit_uri)
+
+ def _GetDeveloperKey(self):
+ """Getter for Developer Key property.
+
+ Returns:
+ If the developer key has been set, a string representing the developer key
+ is returned or None.
+ """
+ if 'X-GData-Key' in self.additional_headers:
+ return self.additional_headers['X-GData-Key'][4:]
+ else:
+ return None
+
+ def _SetDeveloperKey(self, developer_key):
+ """Setter for Developer Key property.
+
+ Sets the developer key in the 'X-GData-Key' header. The actual value that
+ is set is 'key=' plus the developer_key that was passed.
+ """
+ self.additional_headers['X-GData-Key'] = 'key=' + developer_key
+
+ developer_key = property(_GetDeveloperKey, _SetDeveloperKey,
+ doc="""The Developer Key property""")
+
+ def _GetClientId(self):
+ """Getter for Client Id property.
+
+ Returns:
+ If the client_id has been set, a string representing it is returned
+ or None.
+ """
+ if 'X-Gdata-Client' in self.additional_headers:
+ return self.additional_headers['X-Gdata-Client']
+ else:
+ return None
+
+ def _SetClientId(self, client_id):
+ """Setter for Client Id property.
+
+ Sets the 'X-Gdata-Client' header.
+ """
+ self.additional_headers['X-Gdata-Client'] = client_id
+
+ client_id = property(_GetClientId, _SetClientId,
+ doc="""The ClientId property""")
+
+ def Query(self, uri):
+ """Performs a query and returns a resulting feed or entry.
+
+ Args:
+ uri: A string representing the URI of the feed that is to be queried.
+
+ Returns:
+ On success, a tuple in the form:
+ (boolean succeeded=True, ElementTree._Element result)
+ On failure, a tuple in the form:
+ (boolean succeeded=False, {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server's response})
+ """
+ result = self.Get(uri)
+ return result
+
+ def YouTubeQuery(self, query):
+ """Performs a YouTube specific query and returns a resulting feed or entry.
+
+ Args:
+ query: A Query object or one if its sub-classes (YouTubeVideoQuery,
+ YouTubeUserQuery or YouTubePlaylistQuery).
+
+ Returns:
+ Depending on the type of Query object submitted returns either a
+ YouTubeVideoFeed, a YouTubeUserFeed, a YouTubePlaylistFeed. If the
+ Query object provided was not YouTube-related, a tuple is returned.
+ On success the tuple will be in this form:
+ (boolean succeeded=True, ElementTree._Element result)
+ On failure, the tuple will be in this form:
+ (boolean succeeded=False, {'status': HTTP status code from server,
+ 'reason': HTTP reason from the server,
+ 'body': HTTP body of the server response})
+ """
+ result = self.Query(query.ToUri())
+ if isinstance(query, YouTubeUserQuery):
+ return gdata.youtube.YouTubeUserFeedFromString(result.ToString())
+ elif isinstance(query, YouTubePlaylistQuery):
+ return gdata.youtube.YouTubePlaylistFeedFromString(result.ToString())
+ elif isinstance(query, YouTubeVideoQuery):
+ return gdata.youtube.YouTubeVideoFeedFromString(result.ToString())
+ else:
+ return result
+
+class YouTubeVideoQuery(gdata.service.Query):
+
+ """Subclasses gdata.service.Query to represent a YouTube Data API query.
+
+ Attributes are set dynamically via properties. Properties correspond to
+ the standard Google Data API query parameters with YouTube Data API
+ extensions. Please refer to the API documentation for details.
+
+ Attributes:
+ vq: The vq parameter, which is only supported for video feeds, specifies a
+ search query term. Refer to API documentation for further details.
+ orderby: The orderby parameter, which is only supported for video feeds,
+ specifies the value that will be used to sort videos in the search
+ result set. Valid values for this parameter are relevance, published,
+ viewCount and rating.
+ time: The time parameter, which is only available for the top_rated,
+ top_favorites, most_viewed, most_discussed, most_linked and
+ most_responded standard feeds, restricts the search to videos uploaded
+ within the specified time. Valid values for this parameter are today
+ (1 day), this_week (7 days), this_month (1 month) and all_time.
+ The default value for this parameter is all_time.
+ format: The format parameter specifies that videos must be available in a
+ particular video format. Refer to the API documentation for details.
+ racy: The racy parameter allows a search result set to include restricted
+ content as well as standard content. Valid values for this parameter
+ are include and exclude. By default, restricted content is excluded.
+ lr: The lr parameter restricts the search to videos that have a title,
+ description or keywords in a specific language. Valid values for the lr
+ parameter are ISO 639-1 two-letter language codes.
+ restriction: The restriction parameter identifies the IP address that
+ should be used to filter videos that can only be played in specific
+ countries.
+ location: A string of geo coordinates. Note that this is not used when the
+ search is performed but rather to filter the returned videos for ones
+ that match to the location entered.
+ feed: str (optional) The base URL which is the beginning of the query URL.
+ defaults to 'http://%s/feeds/videos' % (YOUTUBE_SERVER)
+ """
+
+ def __init__(self, video_id=None, feed_type=None, text_query=None,
+ params=None, categories=None, feed=None):
+
+ if feed_type in YOUTUBE_STANDARDFEEDS and feed is None:
+ feed = 'http://%s/feeds/standardfeeds/%s' % (YOUTUBE_SERVER, feed_type)
+ elif (feed_type is 'responses' or feed_type is 'comments' and video_id
+ and feed is None):
+ feed = 'http://%s/feeds/videos/%s/%s' % (YOUTUBE_SERVER, video_id,
+ feed_type)
+ elif feed is None:
+ feed = 'http://%s/feeds/videos' % (YOUTUBE_SERVER)
+
+ gdata.service.Query.__init__(self, feed, text_query=text_query,
+ params=params, categories=categories)
+
+ def _GetVideoQuery(self):
+ if 'vq' in self:
+ return self['vq']
+ else:
+ return None
+
+ def _SetVideoQuery(self, val):
+ self['vq'] = val
+
+ vq = property(_GetVideoQuery, _SetVideoQuery,
+ doc="""The video query (vq) query parameter""")
+
+ def _GetOrderBy(self):
+ if 'orderby' in self:
+ return self['orderby']
+ else:
+ return None
+
+ def _SetOrderBy(self, val):
+ if val not in YOUTUBE_QUERY_VALID_ORDERBY_PARAMETERS:
+ if val.startswith('relevance_lang_') is False:
+ raise YouTubeError('OrderBy must be one of: %s ' %
+ ' '.join(YOUTUBE_QUERY_VALID_ORDERBY_PARAMETERS))
+ self['orderby'] = val
+
+ orderby = property(_GetOrderBy, _SetOrderBy,
+ doc="""The orderby query parameter""")
+
+ def _GetTime(self):
+ if 'time' in self:
+ return self['time']
+ else:
+ return None
+
+ def _SetTime(self, val):
+ if val not in YOUTUBE_QUERY_VALID_TIME_PARAMETERS:
+ raise YouTubeError('Time must be one of: %s ' %
+ ' '.join(YOUTUBE_QUERY_VALID_TIME_PARAMETERS))
+ self['time'] = val
+
+ time = property(_GetTime, _SetTime,
+ doc="""The time query parameter""")
+
+ def _GetFormat(self):
+ if 'format' in self:
+ return self['format']
+ else:
+ return None
+
+ def _SetFormat(self, val):
+ if val not in YOUTUBE_QUERY_VALID_FORMAT_PARAMETERS:
+ raise YouTubeError('Format must be one of: %s ' %
+ ' '.join(YOUTUBE_QUERY_VALID_FORMAT_PARAMETERS))
+ self['format'] = val
+
+ format = property(_GetFormat, _SetFormat,
+ doc="""The format query parameter""")
+
+ def _GetRacy(self):
+ if 'racy' in self:
+ return self['racy']
+ else:
+ return None
+
+ def _SetRacy(self, val):
+ if val not in YOUTUBE_QUERY_VALID_RACY_PARAMETERS:
+ raise YouTubeError('Racy must be one of: %s ' %
+ ' '.join(YOUTUBE_QUERY_VALID_RACY_PARAMETERS))
+ self['racy'] = val
+
+ racy = property(_GetRacy, _SetRacy,
+ doc="""The racy query parameter""")
+
+ def _GetLanguageRestriction(self):
+ if 'lr' in self:
+ return self['lr']
+ else:
+ return None
+
+ def _SetLanguageRestriction(self, val):
+ self['lr'] = val
+
+ lr = property(_GetLanguageRestriction, _SetLanguageRestriction,
+ doc="""The lr (language restriction) query parameter""")
+
+ def _GetIPRestriction(self):
+ if 'restriction' in self:
+ return self['restriction']
+ else:
+ return None
+
+ def _SetIPRestriction(self, val):
+ self['restriction'] = val
+
+ restriction = property(_GetIPRestriction, _SetIPRestriction,
+ doc="""The restriction query parameter""")
+
+ def _GetLocation(self):
+ if 'location' in self:
+ return self['location']
+ else:
+ return None
+
+ def _SetLocation(self, val):
+ self['location'] = val
+
+ location = property(_GetLocation, _SetLocation,
+ doc="""The location query parameter""")
+
+
+
+class YouTubeUserQuery(YouTubeVideoQuery):
+
+ """Subclasses YouTubeVideoQuery to perform user-specific queries.
+
+ Attributes are set dynamically via properties. Properties correspond to
+ the standard Google Data API query parameters with YouTube Data API
+ extensions.
+ """
+
+ def __init__(self, username=None, feed_type=None, subscription_id=None,
+ text_query=None, params=None, categories=None):
+
+ uploads_favorites_playlists = ('uploads', 'favorites', 'playlists')
+
+ if feed_type is 'subscriptions' and subscription_id and username:
+ feed = "http://%s/feeds/users/%s/%s/%s" % (YOUTUBE_SERVER, username,
+ feed_type, subscription_id)
+ elif feed_type is 'subscriptions' and not subscription_id and username:
+ feed = "http://%s/feeds/users/%s/%s" % (YOUTUBE_SERVER, username,
+ feed_type)
+ elif feed_type in uploads_favorites_playlists:
+ feed = "http://%s/feeds/users/%s/%s" % (YOUTUBE_SERVER, username,
+ feed_type)
+ else:
+ feed = "http://%s/feeds/users" % (YOUTUBE_SERVER)
+
+ YouTubeVideoQuery.__init__(self, feed=feed, text_query=text_query,
+ params=params, categories=categories)
+
+
+class YouTubePlaylistQuery(YouTubeVideoQuery):
+
+ """Subclasses YouTubeVideoQuery to perform playlist-specific queries.
+
+ Attributes are set dynamically via properties. Properties correspond to
+ the standard Google Data API query parameters with YouTube Data API
+ extensions.
+ """
+
+ def __init__(self, playlist_id, text_query=None, params=None,
+ categories=None):
+ if playlist_id:
+ feed = "http://%s/feeds/playlists/%s" % (YOUTUBE_SERVER, playlist_id)
+ else:
+ feed = "http://%s/feeds/playlists" % (YOUTUBE_SERVER)
+
+ YouTubeVideoQuery.__init__(self, feed=feed, text_query=text_query,
+ params=params, categories=categories)
diff --git a/tests/__init__.py b/tests/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/__init__.py
diff --git a/tests/all_tests.py b/tests/all_tests.py
new file mode 100644
index 0000000..403f703
--- /dev/null
+++ b/tests/all_tests.py
@@ -0,0 +1,97 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+import unittest
+# Tests for v2 features.
+import atom_tests.core_test
+import atom_tests.data_test
+import atom_tests.http_core_test
+import atom_tests.auth_test
+import atom_tests.mock_http_core_test
+import atom_tests.client_test
+import gdata_tests.client_test
+import gdata_tests.core_test
+import gdata_tests.data_test
+import gdata_tests.data_smoke_test
+import gdata_tests.client_smoke_test
+import gdata_tests.live_client_test
+import gdata_tests.gauth_test
+import gdata_tests.blogger.data_test
+import gdata_tests.blogger.live_client_test
+import gdata_tests.spreadsheets.data_test
+import gdata_tests.spreadsheets.live_client_test
+import gdata_tests.projecthosting.data_test
+import gdata_tests.projecthosting.live_client_test
+import gdata_tests.sites.data_test
+import gdata_tests.sites.live_client_test
+import gdata_tests.analytics.data_test
+import gdata_tests.analytics.live_client_test
+import gdata_tests.contacts.live_client_test
+import gdata_tests.contacts.profiles.live_client_test
+import gdata_tests.calendar_resource.live_client_test
+import gdata_tests.calendar_resource.data_test
+import gdata_tests.apps.emailsettings.data_test
+import gdata_tests.apps.emailsettings.live_client_test
+import gdata_tests.apps.multidomain.data_test
+import gdata_tests.apps.multidomain.live_client_test
+import gdata_tests.youtube.live_client_test
+
+
+def suite():
+ return unittest.TestSuite((
+ gdata_tests.contacts.profiles.live_client_test.suite(),
+ atom_tests.core_test.suite(),
+ atom_tests.data_test.suite(),
+ atom_tests.http_core_test.suite(),
+ atom_tests.auth_test.suite(),
+ atom_tests.mock_http_core_test.suite(),
+ atom_tests.client_test.suite(),
+ gdata_tests.client_test.suite(),
+ gdata_tests.core_test.suite(),
+ gdata_tests.data_test.suite(),
+ gdata_tests.data_smoke_test.suite(),
+ gdata_tests.client_smoke_test.suite(),
+ gdata_tests.live_client_test.suite(),
+ gdata_tests.gauth_test.suite(),
+ gdata_tests.blogger.data_test.suite(),
+ gdata_tests.blogger.live_client_test.suite(),
+ gdata_tests.spreadsheets.data_test.suite(),
+ gdata_tests.spreadsheets.live_client_test.suite(),
+ gdata_tests.projecthosting.data_test.suite(),
+ gdata_tests.projecthosting.live_client_test.suite(),
+ gdata_tests.sites.data_test.suite(),
+ gdata_tests.sites.live_client_test.suite(),
+ gdata_tests.analytics.data_test.suite(),
+ gdata_tests.analytics.live_client_test.suite(),
+ gdata_tests.contacts.live_client_test.suite(),
+ gdata_tests.calendar_resource.live_client_test.suite(),
+ gdata_tests.calendar_resource.data_test.suite(),
+ gdata_tests.apps.emailsettings.live_client_test.suite(),
+ gdata_tests.apps.emailsettings.data_test.suite(),
+ gdata_tests.apps.multidomain.live_client_test.suite(),
+ gdata_tests.apps.multidomain.data_test.suite(),
+ gdata_tests.youtube.live_client_test.suite(),
+ ))
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/all_tests_cached.py b/tests/all_tests_cached.py
new file mode 100755
index 0000000..b77429b
--- /dev/null
+++ b/tests/all_tests_cached.py
@@ -0,0 +1,38 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import all_tests
+import gdata.test_config as conf
+
+
+conf.options.set_value('runlive', 'true')
+conf.options.set_value('savecache', 'true')
+conf.options.set_value('clearcache', 'false')
+
+
+def suite():
+ return unittest.TestSuite((atom_tests.core_test.suite(),))
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(all_tests.suite())
diff --git a/tests/all_tests_clear_cache.py b/tests/all_tests_clear_cache.py
new file mode 100755
index 0000000..a1ebfae
--- /dev/null
+++ b/tests/all_tests_clear_cache.py
@@ -0,0 +1,39 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import all_tests
+from gdata.test_config import settings
+
+
+settings.RUN_LIVE_TESTS = True
+settings.CACHE_RESPONSES = True
+settings.CLEAR_CACHE = True
+
+
+def suite():
+ return unittest.TestSuite((atom_tests.core_test.suite(),))
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(all_tests.suite())
diff --git a/tests/all_tests_coverage.py b/tests/all_tests_coverage.py
new file mode 100755
index 0000000..c795de2
--- /dev/null
+++ b/tests/all_tests_coverage.py
@@ -0,0 +1,58 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import coverage
+import all_tests
+import atom.core
+import atom.http_core
+import atom.mock_http_core
+import atom.auth
+import atom.client
+import gdata.gauth
+import gdata.client
+import gdata.data
+import gdata.blogger.data
+import gdata.blogger.client
+import gdata.spreadsheets.data
+from gdata.test_config import settings
+
+
+# Ensure that coverage tests execute the live requests to the servers, but
+# allow use of cached server responses to speed up repeated runs.
+settings.RUN_LIVE_TESTS = True
+settings.CLEAR_CACHE = False
+
+
+def suite():
+ return unittest.TestSuite((atom_tests.core_test.suite(),))
+
+if __name__ == '__main__':
+ coverage.erase()
+ coverage.start()
+ unittest.TextTestRunner().run(all_tests.suite())
+ coverage.stop()
+ coverage.report([atom.core, atom.http_core, atom.auth, atom.data,
+ atom.mock_http_core, atom.client, gdata.gauth, gdata.client,
+ gdata.core, gdata.data, gdata.blogger.data, gdata.blogger.client,
+ gdata.spreadsheets.data])
diff --git a/tests/all_tests_local.py b/tests/all_tests_local.py
new file mode 100755
index 0000000..dfe54f3
--- /dev/null
+++ b/tests/all_tests_local.py
@@ -0,0 +1,37 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import all_tests
+import gdata.test_config as conf
+
+
+conf.options.set_value('runlive', 'false')
+
+
+def suite():
+ return unittest.TestSuite((atom_tests.core_test.suite(),))
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(all_tests.suite())
diff --git a/tests/atom_test.py b/tests/atom_test.py
new file mode 100755
index 0000000..287ca10
--- /dev/null
+++ b/tests/atom_test.py
@@ -0,0 +1,706 @@
+#!/usr/bin/python
+# -*-*- encoding: utf-8 -*-*-
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import sys
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom
+from gdata import test_data
+import gdata.test_config as conf
+
+
+class AuthorTest(unittest.TestCase):
+
+ def setUp(self):
+ self.author = atom.Author()
+
+ def testEmptyAuthorShouldHaveEmptyExtensionsList(self):
+ self.assert_(isinstance(self.author.extension_elements, list))
+ self.assert_(len(self.author.extension_elements) == 0)
+
+ def testNormalAuthorShouldHaveNoExtensionElements(self):
+ self.author.name = atom.Name(text='Jeff Scudder')
+ self.assert_(self.author.name.text == 'Jeff Scudder')
+ self.assert_(len(self.author.extension_elements) == 0)
+ new_author = atom.AuthorFromString(self.author.ToString())
+ self.assert_(len(self.author.extension_elements) == 0)
+
+ self.author.extension_elements.append(atom.ExtensionElement(
+ 'foo', text='bar'))
+ self.assert_(len(self.author.extension_elements) == 1)
+ self.assert_(self.author.name.text == 'Jeff Scudder')
+ new_author = atom.AuthorFromString(self.author.ToString())
+ self.assert_(len(self.author.extension_elements) == 1)
+ self.assert_(new_author.name.text == 'Jeff Scudder')
+
+ def testEmptyAuthorToAndFromStringShouldMatch(self):
+ string_from_author = self.author.ToString()
+ new_author = atom.AuthorFromString(string_from_author)
+ string_from_new_author = new_author.ToString()
+ self.assert_(string_from_author == string_from_new_author)
+
+ def testAuthorWithNameToAndFromStringShouldMatch(self):
+ self.author.name = atom.Name()
+ self.author.name.text = 'Jeff Scudder'
+ string_from_author = self.author.ToString()
+ new_author = atom.AuthorFromString(string_from_author)
+ string_from_new_author = new_author.ToString()
+ self.assert_(string_from_author == string_from_new_author)
+ self.assert_(self.author.name.text == new_author.name.text)
+
+ def testExtensionElements(self):
+ self.author.extension_attributes['foo1'] = 'bar'
+ self.author.extension_attributes['foo2'] = 'rab'
+ self.assert_(self.author.extension_attributes['foo1'] == 'bar')
+ self.assert_(self.author.extension_attributes['foo2'] == 'rab')
+ new_author = atom.AuthorFromString(self.author.ToString())
+ self.assert_(new_author.extension_attributes['foo1'] == 'bar')
+ self.assert_(new_author.extension_attributes['foo2'] == 'rab')
+
+ def testConvertFullAuthorToAndFromString(self):
+ author = atom.AuthorFromString(test_data.TEST_AUTHOR)
+ self.assert_(author.name.text == 'John Doe')
+ self.assert_(author.email.text == 'johndoes@someemailadress.com')
+ self.assert_(author.uri.text == 'http://www.google.com')
+
+
+class EmailTest(unittest.TestCase):
+
+ def setUp(self):
+ self.email = atom.Email()
+
+ def testEmailToAndFromString(self):
+ self.email.text = 'This is a test'
+ new_email = atom.EmailFromString(self.email.ToString())
+ self.assert_(self.email.text == new_email.text)
+ self.assert_(self.email.extension_elements ==
+ new_email.extension_elements)
+
+
+class NameTest(unittest.TestCase):
+
+ def setUp(self):
+ self.name = atom.Name()
+
+ def testEmptyNameToAndFromStringShouldMatch(self):
+ string_from_name = self.name.ToString()
+ new_name = atom.NameFromString(string_from_name)
+ string_from_new_name = new_name.ToString()
+ self.assert_(string_from_name == string_from_new_name)
+
+ def testText(self):
+ self.assert_(self.name.text is None)
+ self.name.text = 'Jeff Scudder'
+ self.assert_(self.name.text == 'Jeff Scudder')
+ new_name = atom.NameFromString(self.name.ToString())
+ self.assert_(new_name.text == self.name.text)
+
+ def testExtensionElements(self):
+ self.name.extension_attributes['foo'] = 'bar'
+ self.assert_(self.name.extension_attributes['foo'] == 'bar')
+ new_name = atom.NameFromString(self.name.ToString())
+ self.assert_(new_name.extension_attributes['foo'] == 'bar')
+
+
+class ExtensionElementTest(unittest.TestCase):
+
+ def setUp(self):
+ self.ee = atom.ExtensionElement('foo')
+
+ def testEmptyEEShouldProduceEmptyString(self):
+ pass
+
+ def testEEParsesTreeCorrectly(self):
+ deep_tree = atom.ExtensionElementFromString(test_data.EXTENSION_TREE)
+ self.assert_(deep_tree.tag == 'feed')
+ self.assert_(deep_tree.namespace == 'http://www.w3.org/2005/Atom')
+ self.assert_(deep_tree.children[0].tag == 'author')
+ self.assert_(deep_tree.children[0].namespace == 'http://www.google.com')
+ self.assert_(deep_tree.children[0].children[0].tag == 'name')
+ self.assert_(deep_tree.children[0].children[0].namespace ==
+ 'http://www.google.com')
+ self.assert_(deep_tree.children[0].children[0].text.strip() == 'John Doe')
+ self.assert_(deep_tree.children[0].children[0].children[0].text.strip() ==
+ 'Bar')
+ foo = deep_tree.children[0].children[0].children[0]
+ self.assert_(foo.tag == 'foo')
+ self.assert_(foo.namespace == 'http://www.google.com')
+ self.assert_(foo.attributes['up'] == 'down')
+ self.assert_(foo.attributes['yes'] == 'no')
+ self.assert_(foo.children == [])
+
+ def testEEToAndFromStringShouldMatch(self):
+ string_from_ee = self.ee.ToString()
+ new_ee = atom.ExtensionElementFromString(string_from_ee)
+ string_from_new_ee = new_ee.ToString()
+ self.assert_(string_from_ee == string_from_new_ee)
+
+ deep_tree = atom.ExtensionElementFromString(test_data.EXTENSION_TREE)
+ string_from_deep_tree = deep_tree.ToString()
+ new_deep_tree = atom.ExtensionElementFromString(string_from_deep_tree)
+ string_from_new_deep_tree = new_deep_tree.ToString()
+ self.assert_(string_from_deep_tree == string_from_new_deep_tree)
+
+
+class LinkTest(unittest.TestCase):
+
+ def setUp(self):
+ self.link = atom.Link()
+
+ def testLinkToAndFromString(self):
+ self.link.href = 'test href'
+ self.link.hreflang = 'english'
+ self.link.type = 'text/html'
+ self.link.extension_attributes['foo'] = 'bar'
+ self.assert_(self.link.href == 'test href')
+ self.assert_(self.link.hreflang == 'english')
+ self.assert_(self.link.type == 'text/html')
+ self.assert_(self.link.extension_attributes['foo'] == 'bar')
+ new_link = atom.LinkFromString(self.link.ToString())
+ self.assert_(self.link.href == new_link.href)
+ self.assert_(self.link.type == new_link.type)
+ self.assert_(self.link.hreflang == new_link.hreflang)
+ self.assert_(self.link.extension_attributes['foo'] ==
+ new_link.extension_attributes['foo'])
+
+ def testLinkType(self):
+ test_link = atom.Link(link_type='text/html')
+ self.assert_(test_link.type == 'text/html')
+
+
+class GeneratorTest(unittest.TestCase):
+
+ def setUp(self):
+ self.generator = atom.Generator()
+
+ def testGeneratorToAndFromString(self):
+ self.generator.uri = 'www.google.com'
+ self.generator.version = '1.0'
+ self.generator.extension_attributes['foo'] = 'bar'
+ self.assert_(self.generator.uri == 'www.google.com')
+ self.assert_(self.generator.version == '1.0')
+ self.assert_(self.generator.extension_attributes['foo'] == 'bar')
+ new_generator = atom.GeneratorFromString(self.generator.ToString())
+ self.assert_(self.generator.uri == new_generator.uri)
+ self.assert_(self.generator.version == new_generator.version)
+ self.assert_(self.generator.extension_attributes['foo'] ==
+ new_generator.extension_attributes['foo'])
+
+
+class TitleTest(unittest.TestCase):
+
+ def setUp(self):
+ self.title = atom.Title()
+
+ def testTitleToAndFromString(self):
+ self.title.type = 'text'
+ self.title.text = 'Less: <'
+ self.assert_(self.title.type == 'text')
+ self.assert_(self.title.text == 'Less: <')
+ new_title = atom.TitleFromString(self.title.ToString())
+ self.assert_(self.title.type == new_title.type)
+ self.assert_(self.title.text == new_title.text)
+
+
+class SubtitleTest(unittest.TestCase):
+
+ def setUp(self):
+ self.subtitle = atom.Subtitle()
+
+ def testTitleToAndFromString(self):
+ self.subtitle.type = 'text'
+ self.subtitle.text = 'sub & title'
+ self.assert_(self.subtitle.type == 'text')
+ self.assert_(self.subtitle.text == 'sub & title')
+ new_subtitle = atom.SubtitleFromString(self.subtitle.ToString())
+ self.assert_(self.subtitle.type == new_subtitle.type)
+ self.assert_(self.subtitle.text == new_subtitle.text)
+
+
+class SummaryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.summary = atom.Summary()
+
+ def testTitleToAndFromString(self):
+ self.summary.type = 'text'
+ self.summary.text = 'Less: <'
+ self.assert_(self.summary.type == 'text')
+ self.assert_(self.summary.text == 'Less: <')
+ new_summary = atom.SummaryFromString(self.summary.ToString())
+ self.assert_(self.summary.type == new_summary.type)
+ self.assert_(self.summary.text == new_summary.text)
+
+
+class CategoryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.category = atom.Category()
+
+ def testCategoryToAndFromString(self):
+ self.category.term = 'x'
+ self.category.scheme = 'y'
+ self.category.label = 'z'
+ self.assert_(self.category.term == 'x')
+ self.assert_(self.category.scheme == 'y')
+ self.assert_(self.category.label == 'z')
+ new_category = atom.CategoryFromString(self.category.ToString())
+ self.assert_(self.category.term == new_category.term)
+ self.assert_(self.category.scheme == new_category.scheme)
+ self.assert_(self.category.label == new_category.label)
+
+
+class ContributorTest(unittest.TestCase):
+
+ def setUp(self):
+ self.contributor = atom.Contributor()
+
+ def testContributorToAndFromString(self):
+ self.contributor.name = atom.Name(text='J Scud')
+ self.contributor.email = atom.Email(text='nobody@nowhere')
+ self.contributor.uri = atom.Uri(text='http://www.google.com')
+ self.assert_(self.contributor.name.text == 'J Scud')
+ self.assert_(self.contributor.email.text == 'nobody@nowhere')
+ self.assert_(self.contributor.uri.text == 'http://www.google.com')
+ new_contributor = atom.ContributorFromString(self.contributor.ToString())
+ self.assert_(self.contributor.name.text == new_contributor.name.text)
+ self.assert_(self.contributor.email.text == new_contributor.email.text)
+ self.assert_(self.contributor.uri.text == new_contributor.uri.text)
+
+
+class IdTest(unittest.TestCase):
+
+ def setUp(self):
+ self.my_id = atom.Id()
+
+ def testIdToAndFromString(self):
+ self.my_id.text = 'my nifty id'
+ self.assert_(self.my_id.text == 'my nifty id')
+ new_id = atom.IdFromString(self.my_id.ToString())
+ self.assert_(self.my_id.text == new_id.text)
+
+
+class IconTest(unittest.TestCase):
+
+ def setUp(self):
+ self.icon = atom.Icon()
+
+ def testIconToAndFromString(self):
+ self.icon.text = 'my picture'
+ self.assert_(self.icon.text == 'my picture')
+ new_icon = atom.IconFromString(str(self.icon))
+ self.assert_(self.icon.text == new_icon.text)
+
+
+class LogoTest(unittest.TestCase):
+
+ def setUp(self):
+ self.logo = atom.Logo()
+
+ def testLogoToAndFromString(self):
+ self.logo.text = 'my logo'
+ self.assert_(self.logo.text == 'my logo')
+ new_logo = atom.LogoFromString(self.logo.ToString())
+ self.assert_(self.logo.text == new_logo.text)
+
+
+class RightsTest(unittest.TestCase):
+
+ def setUp(self):
+ self.rights = atom.Rights()
+
+ def testContributorToAndFromString(self):
+ self.rights.text = 'you have the right to remain silent'
+ self.rights.type = 'text'
+ self.assert_(self.rights.text == 'you have the right to remain silent')
+ self.assert_(self.rights.type == 'text')
+ new_rights = atom.RightsFromString(self.rights.ToString())
+ self.assert_(self.rights.text == new_rights.text)
+ self.assert_(self.rights.type == new_rights.type)
+
+
+class UpdatedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.updated = atom.Updated()
+
+ def testUpdatedToAndFromString(self):
+ self.updated.text = 'my time'
+ self.assert_(self.updated.text == 'my time')
+ new_updated = atom.UpdatedFromString(self.updated.ToString())
+ self.assert_(self.updated.text == new_updated.text)
+
+
+class PublishedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.published = atom.Published()
+
+ def testPublishedToAndFromString(self):
+ self.published.text = 'pub time'
+ self.assert_(self.published.text == 'pub time')
+ new_published = atom.PublishedFromString(self.published.ToString())
+ self.assert_(self.published.text == new_published.text)
+
+
+class FeedEntryParentTest(unittest.TestCase):
+ """The test accesses hidden methods in atom.FeedEntryParent"""
+
+ def testConvertToAndFromElementTree(self):
+ # Use entry because FeedEntryParent doesn't have a tag or namespace.
+ original = atom.Entry()
+ copy = atom.FeedEntryParent()
+
+ original.author.append(atom.Author(name=atom.Name(text='J Scud')))
+ self.assert_(original.author[0].name.text == 'J Scud')
+ self.assert_(copy.author == [])
+
+ original.id = atom.Id(text='test id')
+ self.assert_(original.id.text == 'test id')
+ self.assert_(copy.id is None)
+
+ copy._HarvestElementTree(original._ToElementTree())
+ self.assert_(original.author[0].name.text == copy.author[0].name.text)
+ self.assert_(original.id.text == copy.id.text)
+
+
+class EntryTest(unittest.TestCase):
+
+ def testConvertToAndFromString(self):
+ entry = atom.Entry()
+ entry.author.append(atom.Author(name=atom.Name(text='js')))
+ entry.title = atom.Title(text='my test entry')
+ self.assert_(entry.author[0].name.text == 'js')
+ self.assert_(entry.title.text == 'my test entry')
+ new_entry = atom.EntryFromString(entry.ToString())
+ self.assert_(new_entry.author[0].name.text == 'js')
+ self.assert_(new_entry.title.text == 'my test entry')
+
+ def testEntryCorrectlyConvertsActualData(self):
+ entry = atom.EntryFromString(test_data.XML_ENTRY_1)
+ self.assert_(entry.category[0].scheme ==
+ 'http://base.google.com/categories/itemtypes')
+ self.assert_(entry.category[0].term == 'products')
+ self.assert_(entry.id.text == ' http://www.google.com/test/id/url ')
+ self.assert_(entry.title.text == 'Testing 2000 series laptop')
+ self.assert_(entry.title.type == 'text')
+ self.assert_(entry.content.type == 'xhtml')
+ #TODO check all other values for the test entry
+
+ def testAppControl(self):
+ entry = atom.EntryFromString(test_data.TEST_BASE_ENTRY)
+ self.assertEquals(entry.control.draft.text, 'yes')
+ self.assertEquals(len(entry.control.extension_elements), 1)
+ self.assertEquals(entry.control.extension_elements[0].tag, 'disapproved')
+
+
+class ControlTest(unittest.TestCase):
+
+ def testConvertToAndFromString(self):
+ control = atom.Control()
+ control.text = 'some text'
+ control.draft = atom.Draft(text='yes')
+ self.assertEquals(control.draft.text, 'yes')
+ self.assertEquals(control.text, 'some text')
+ self.assertEquals(isinstance(control.draft, atom.Draft), True)
+ new_control = atom.ControlFromString(str(control))
+ self.assertEquals(control.draft.text, new_control.draft.text)
+ self.assertEquals(control.text, new_control.text)
+ self.assertEquals(isinstance(new_control.draft, atom.Draft), True)
+
+
+class DraftTest(unittest.TestCase):
+
+ def testConvertToAndFromString(self):
+ draft = atom.Draft()
+ draft.text = 'maybe'
+ draft.extension_attributes['foo'] = 'bar'
+ self.assertEquals(draft.text, 'maybe')
+ self.assertEquals(draft.extension_attributes['foo'], 'bar')
+ new_draft = atom.DraftFromString(str(draft))
+ self.assertEquals(draft.text, new_draft.text)
+ self.assertEquals(draft.extension_attributes['foo'],
+ new_draft.extension_attributes['foo'])
+
+
+
+class SourceTest(unittest.TestCase):
+
+ def testConvertToAndFromString(self):
+ source = atom.Source()
+ source.author.append(atom.Author(name=atom.Name(text='js')))
+ source.title = atom.Title(text='my test source')
+ source.generator = atom.Generator(text='gen')
+ self.assert_(source.author[0].name.text == 'js')
+ self.assert_(source.title.text == 'my test source')
+ self.assert_(source.generator.text == 'gen')
+ new_source = atom.SourceFromString(source.ToString())
+ self.assert_(new_source.author[0].name.text == 'js')
+ self.assert_(new_source.title.text == 'my test source')
+ self.assert_(new_source.generator.text == 'gen')
+
+
+class FeedTest(unittest.TestCase):
+
+ def testConvertToAndFromString(self):
+ feed = atom.Feed()
+ feed.author.append(atom.Author(name=atom.Name(text='js')))
+ feed.title = atom.Title(text='my test source')
+ feed.generator = atom.Generator(text='gen')
+ feed.entry.append(atom.Entry(author=[atom.Author(name=atom.Name(
+ text='entry author'))]))
+ self.assert_(feed.author[0].name.text == 'js')
+ self.assert_(feed.title.text == 'my test source')
+ self.assert_(feed.generator.text == 'gen')
+ self.assert_(feed.entry[0].author[0].name.text == 'entry author')
+ new_feed = atom.FeedFromString(feed.ToString())
+ self.assert_(new_feed.author[0].name.text == 'js')
+ self.assert_(new_feed.title.text == 'my test source')
+ self.assert_(new_feed.generator.text == 'gen')
+ self.assert_(new_feed.entry[0].author[0].name.text == 'entry author')
+
+ def testPreserveEntryOrder(self):
+ test_xml = (
+ '<feed xmlns="http://www.w3.org/2005/Atom">'
+ '<entry><id>0</id></entry>'
+ '<entry><id>1</id></entry>'
+ '<title>Testing Order</title>'
+ '<entry><id>2</id></entry>'
+ '<entry><id>3</id></entry>'
+ '<entry><id>4</id></entry>'
+ '<entry><id>5</id></entry>'
+ '<entry><id>6</id></entry>'
+ '<entry><id>7</id></entry>'
+ '<author/>'
+ '<entry><id>8</id></entry>'
+ '<id>feed_id</id>'
+ '<entry><id>9</id></entry>'
+ '</feed>')
+ feed = atom.FeedFromString(test_xml)
+ for i in xrange(10):
+ self.assert_(feed.entry[i].id.text == str(i))
+ feed = atom.FeedFromString(feed.ToString())
+ for i in xrange(10):
+ self.assert_(feed.entry[i].id.text == str(i))
+ temp = feed.entry[3]
+ feed.entry[3] = feed.entry[4]
+ feed.entry[4] = temp
+ self.assert_(feed.entry[2].id.text == '2')
+ self.assert_(feed.entry[3].id.text == '4')
+ self.assert_(feed.entry[4].id.text == '3')
+ self.assert_(feed.entry[5].id.text == '5')
+ feed = atom.FeedFromString(feed.ToString())
+ self.assert_(feed.entry[2].id.text == '2')
+ self.assert_(feed.entry[3].id.text == '4')
+ self.assert_(feed.entry[4].id.text == '3')
+ self.assert_(feed.entry[5].id.text == '5')
+
+
+class ContentEntryParentTest(unittest.TestCase):
+ """The test accesses hidden methods in atom.FeedEntryParent"""
+
+ def setUp(self):
+ self.content = atom.Content()
+
+ def testConvertToAndFromElementTree(self):
+ self.content.text = 'my content'
+ self.content.type = 'text'
+ self.content.src = 'my source'
+ self.assert_(self.content.text == 'my content')
+ self.assert_(self.content.type == 'text')
+ self.assert_(self.content.src == 'my source')
+ new_content = atom.ContentFromString(self.content.ToString())
+ self.assert_(self.content.text == new_content.text)
+ self.assert_(self.content.type == new_content.type)
+ self.assert_(self.content.src == new_content.src)
+
+ def testContentConstructorSetsSrc(self):
+ new_content = atom.Content(src='abcd')
+ self.assertEquals(new_content.src, 'abcd')
+
+
+class PreserveUnkownElementTest(unittest.TestCase):
+ """Tests correct preservation of XML elements which are non Atom"""
+
+ def setUp(self):
+ self.feed = atom.FeedFromString(test_data.GBASE_ATTRIBUTE_FEED)
+
+ def testCaptureOpenSearchElements(self):
+ self.assertEquals(self.feed.FindExtensions('totalResults')[0].tag,
+ 'totalResults')
+ self.assertEquals(self.feed.FindExtensions('totalResults')[0].namespace,
+ 'http://a9.com/-/spec/opensearchrss/1.0/')
+ open_search_extensions = self.feed.FindExtensions(
+ namespace='http://a9.com/-/spec/opensearchrss/1.0/')
+ self.assertEquals(len(open_search_extensions), 3)
+ for element in open_search_extensions:
+ self.assertEquals(element.namespace,
+ 'http://a9.com/-/spec/opensearchrss/1.0/')
+
+ def testCaptureMetaElements(self):
+ meta_elements = self.feed.entry[0].FindExtensions(
+ namespace='http://base.google.com/ns-metadata/1.0')
+ self.assertEquals(len(meta_elements), 1)
+ self.assertEquals(meta_elements[0].attributes['count'], '4416629')
+ self.assertEquals(len(meta_elements[0].children), 10)
+
+ def testCaptureMetaChildElements(self):
+ meta_elements = self.feed.entry[0].FindExtensions(
+ namespace='http://base.google.com/ns-metadata/1.0')
+ meta_children = meta_elements[0].FindChildren(
+ namespace='http://base.google.com/ns-metadata/1.0')
+ self.assertEquals(len(meta_children), 10)
+ for child in meta_children:
+ self.assertEquals(child.tag, 'value')
+
+
+class LinkFinderTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.EntryFromString(test_data.XML_ENTRY_1)
+
+ def testLinkFinderGetsLicenseLink(self):
+ self.assertEquals(isinstance(self.entry.GetLicenseLink(), atom.Link),
+ True)
+ self.assertEquals(self.entry.GetLicenseLink().href,
+ 'http://creativecommons.org/licenses/by-nc/2.5/rdf')
+ self.assertEquals(self.entry.GetLicenseLink().rel, 'license')
+
+ def testLinkFinderGetsAlternateLink(self):
+ self.assertEquals(isinstance(self.entry.GetAlternateLink(), atom.Link),
+ True)
+ self.assertEquals(self.entry.GetAlternateLink().href,
+ 'http://www.provider-host.com/123456789')
+ self.assertEquals(self.entry.GetAlternateLink().rel, 'alternate')
+
+
+class AtomBaseTest(unittest.TestCase):
+
+ def testAtomBaseConvertsExtensions(self):
+ # Using Id because it adds no additional members.
+ atom_base = atom.Id()
+ extension_child = atom.ExtensionElement('foo', namespace='http://ns0.com')
+ extension_grandchild = atom.ExtensionElement('bar',
+ namespace='http://ns0.com')
+ extension_child.children.append(extension_grandchild)
+ atom_base.extension_elements.append(extension_child)
+ self.assertEquals(len(atom_base.extension_elements), 1)
+ self.assertEquals(len(atom_base.extension_elements[0].children), 1)
+ self.assertEquals(atom_base.extension_elements[0].tag, 'foo')
+ self.assertEquals(atom_base.extension_elements[0].children[0].tag, 'bar')
+
+ element_tree = atom_base._ToElementTree()
+ self.assert_(element_tree.find('{http://ns0.com}foo') is not None)
+ self.assert_(element_tree.find('{http://ns0.com}foo').find(
+ '{http://ns0.com}bar') is not None)
+
+
+class UtfParsingTest(unittest.TestCase):
+
+ def setUp(self):
+ self.test_xml = u"""<?xml version="1.0" encoding="utf-8"?>
+<entry xmlns='http://www.w3.org/2005/Atom'>
+ <id>http://www.google.com/test/id/url</id>
+ <title type='\u03B1\u03BB\u03C6\u03B1'>\u03B1\u03BB\u03C6\u03B1</title>
+</entry>"""
+
+ def testMemberStringEncoding(self):
+ atom_entry = atom.EntryFromString(self.test_xml)
+ #self.assertEqual(atom_entry.title.type.encode('utf-8'),
+ # u'\u03B1\u03BB\u03C6\u03B1'.encode('utf-8'))
+ #self.assertEqual(atom_entry.title.text.encode('utf-8'),
+ # u'\u03B1\u03BB\u03C6\u03B1'.encode('utf-8'))
+
+ # Setting object members to unicode strings is supported even if
+ # MEMBER_STRING_ENCODING is set 'utf-8' (should it be?)
+ atom_entry.title.type = u'\u03B1\u03BB\u03C6\u03B1'
+ xml = atom_entry.ToString()
+ self.assert_(u'\u03B1\u03BB\u03C6\u03B1'.encode('utf-8') in xml)
+
+ # Make sure that we can use plain text when MEMBER_STRING_ENCODING is utf8
+ atom_entry.title.type = "plain text"
+ atom_entry.title.text = "more text"
+ xml = atom_entry.ToString()
+ self.assert_("plain text" in xml)
+ self.assert_("more text" in xml)
+
+ # Test something else than utf-8
+ atom.MEMBER_STRING_ENCODING = 'iso8859_7'
+ atom_entry = atom.EntryFromString(self.test_xml)
+ self.assert_(atom_entry.title.type == u'\u03B1\u03BB\u03C6\u03B1'.encode(
+ 'iso8859_7'))
+ self.assert_(atom_entry.title.text == u'\u03B1\u03BB\u03C6\u03B1'.encode(
+ 'iso8859_7'))
+
+ # Test using unicode strings directly for object members
+ atom.MEMBER_STRING_ENCODING = unicode
+ atom_entry = atom.EntryFromString(self.test_xml)
+ self.assert_(atom_entry.title.type == u'\u03B1\u03BB\u03C6\u03B1')
+ self.assert_(atom_entry.title.text == u'\u03B1\u03BB\u03C6\u03B1')
+
+ # Make sure that we can use plain text when MEMBER_STRING_ENCODING is
+ # unicode
+ atom_entry.title.type = "plain text"
+ atom_entry.title.text = "more text"
+ xml = atom_entry.ToString()
+ self.assert_("plain text" in xml)
+ self.assert_("more text" in xml)
+
+ def testConvertExampleXML(self):
+ try:
+ entry = atom.CreateClassFromXMLString(atom.Entry,
+ test_data.GBASE_STRING_ENCODING_ENTRY)
+ except UnicodeDecodeError:
+ self.fail('Error when converting XML')
+
+
+class DeprecationDecoratorTest(unittest.TestCase):
+
+ def testDeprecationWarning(self):
+ def to_deprecate():
+ return 5
+ self.assertEqual(to_deprecate.func_name, 'to_deprecate')
+ deprecated = atom.deprecated('test')(to_deprecate)
+ self.assertNotEqual(to_deprecate, deprecated)
+ # After decorating a function as deprecated, the function name should
+ # still be the name of the original function.
+ self.assertEqual(deprecated.func_name, 'to_deprecate')
+ #@atom.deprecated()
+ def also_deprecated():
+ return 6
+ also_deprecated = atom.deprecated()(also_deprecated)
+ self.assertEqual(also_deprecated.func_name, 'also_deprecated')
+
+
+def suite():
+ return conf.build_suite([AuthorTest, EmailTest, NameTest,
+ ExtensionElementTest, LinkTest, GeneratorTest, TitleTest, SubtitleTest,
+ SummaryTest, IdTest, IconTest, LogoTest, RightsTest, UpdatedTest,
+ PublishedTest, FeedEntryParentTest, EntryTest, ContentEntryParentTest,
+ PreserveUnkownElementTest, FeedTest, LinkFinderTest, AtomBaseTest,
+ UtfParsingTest, DeprecationDecoratorTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/__init__.py b/tests/atom_tests/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/atom_tests/__init__.py
diff --git a/tests/atom_tests/auth_test.py b/tests/atom_tests/auth_test.py
new file mode 100644
index 0000000..61497ee
--- /dev/null
+++ b/tests/atom_tests/auth_test.py
@@ -0,0 +1,45 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import atom.auth
+import atom.http_core
+
+
+class BasicAuthTest(unittest.TestCase):
+
+ def test_modify_request(self):
+ http_request = atom.http_core.HttpRequest()
+ credentials = atom.auth.BasicAuth('Aladdin', 'open sesame')
+ self.assert_(credentials.basic_cookie == 'QWxhZGRpbjpvcGVuIHNlc2FtZQ==')
+ credentials.modify_request(http_request)
+ self.assert_(http_request.headers[
+ 'Authorization'] == 'Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==')
+
+
+def suite():
+ return unittest.TestSuite((unittest.makeSuite(BasicAuthTest,'test'),))
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/client_test.py b/tests/atom_tests/client_test.py
new file mode 100755
index 0000000..85c3a7c
--- /dev/null
+++ b/tests/atom_tests/client_test.py
@@ -0,0 +1,185 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+# This test may make an actual HTTP request.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import atom.http_core
+import atom.auth
+import atom.client
+import atom.mock_http_core
+
+
+class AtomPubClientEchoTest(unittest.TestCase):
+
+ def test_simple_request_with_no_client_defaults(self):
+ client = atom.client.AtomPubClient(atom.mock_http_core.EchoHttpClient())
+ self.assert_(client.host is None)
+ self.assert_(client.auth_token is None)
+ # Make several equivalent requests.
+ responses = [client.request('GET', 'http://example.org/'),
+ client.request(http_request=atom.http_core.HttpRequest(
+ uri=atom.http_core.Uri('http', 'example.org', path='/'),
+ method='GET')),
+ client.request('GET',
+ http_request=atom.http_core.HttpRequest(
+ uri=atom.http_core.Uri('http', 'example.org',
+ path='/')))]
+ for response in responses:
+ self.assert_(response.getheader('Echo-Host') == 'example.org:None')
+ self.assert_(response.getheader('Echo-Uri') == '/')
+ self.assert_(response.getheader('Echo-Scheme') == 'http')
+ self.assert_(response.getheader('Echo-Method') == 'GET')
+ self.assert_(response.getheader('User-Agent').startswith('gdata-py/'))
+
+ def test_auth_request_with_no_client_defaults(self):
+ client = atom.client.AtomPubClient(atom.mock_http_core.EchoHttpClient())
+ token = atom.auth.BasicAuth('Jeff', '123')
+ response = client.request('POST', 'https://example.net:8080/',
+ auth_token=token)
+ self.assert_(response.getheader('Echo-Host') == 'example.net:8080')
+ self.assert_(response.getheader('Echo-Uri') == '/')
+ self.assert_(response.getheader('Echo-Scheme') == 'https')
+ self.assert_(response.getheader('Authorization') == 'Basic SmVmZjoxMjM=')
+ self.assert_(response.getheader('Echo-Method') == 'POST')
+
+ def test_request_with_client_defaults(self):
+ client = atom.client.AtomPubClient(atom.mock_http_core.EchoHttpClient(),
+ 'example.com', atom.auth.BasicAuth('Jeff', '123'))
+ self.assert_(client.host == 'example.com')
+ self.assert_(client.auth_token is not None)
+ self.assert_(client.auth_token.basic_cookie == 'SmVmZjoxMjM=')
+ response = client.request('GET', 'http://example.org/')
+ self.assert_(response.getheader('Echo-Host') == 'example.org:None')
+ self.assert_(response.getheader('Echo-Uri') == '/')
+ self.assert_(response.getheader('Echo-Scheme') == 'http')
+ self.assert_(response.getheader('Echo-Method') == 'GET')
+ self.assert_(response.getheader('Authorization') == 'Basic SmVmZjoxMjM=')
+ response = client.request('GET', '/')
+ self.assert_(response.getheader('Echo-Host') == 'example.com:None')
+ self.assert_(response.getheader('Echo-Uri') == '/')
+ self.assert_(response.getheader('Echo-Scheme') == 'http')
+ self.assert_(response.getheader('Authorization') == 'Basic SmVmZjoxMjM=')
+ response = client.request('GET', '/',
+ http_request=atom.http_core.HttpRequest(
+ uri=atom.http_core.Uri(port=99)))
+ self.assert_(response.getheader('Echo-Host') == 'example.com:99')
+ self.assert_(response.getheader('Echo-Uri') == '/')
+
+ def test_get(self):
+ client = atom.client.AtomPubClient(atom.mock_http_core.EchoHttpClient())
+ response = client.get('http://example.com/simple')
+ self.assert_(response.getheader('Echo-Host') == 'example.com:None')
+ self.assert_(response.getheader('Echo-Uri') == '/simple')
+ self.assert_(response.getheader('Echo-Method') == 'GET')
+ response = client.Get(uri='http://example.com/simple2')
+ self.assert_(response.getheader('Echo-Uri') == '/simple2')
+ self.assert_(response.getheader('Echo-Method') == 'GET')
+
+ def test_modify_request_using_args(self):
+ client = atom.client.AtomPubClient(atom.mock_http_core.EchoHttpClient())
+ class RequestModifier(object):
+ def modify_request(self, http_request):
+ http_request.headers['Special'] = 'Set'
+ response = client.get('http://example.com/modified',
+ extra=RequestModifier())
+ self.assert_(response.getheader('Echo-Host') == 'example.com:None')
+ self.assert_(response.getheader('Echo-Uri') == '/modified')
+ self.assert_(response.getheader('Echo-Method') == 'GET')
+ self.assert_(response.getheader('Special') == 'Set')
+
+ def test_modify_request_using_object_str(self):
+ client = atom.client.AtomPubClient(atom.mock_http_core.EchoHttpClient())
+ class RequestModifier(object):
+ def __str__(self):
+ return 'value'
+ response = client.get('http://example.com/modified',
+ name=RequestModifier())
+ self.assert_(response.getheader('Echo-Host') == 'example.com:None')
+ self.assert_(response.getheader('Echo-Uri') == '/modified?name=value')
+ self.assert_(response.getheader('Echo-Method') == 'GET')
+
+ def test_modify_request_using_string(self):
+ client = atom.client.AtomPubClient(atom.mock_http_core.EchoHttpClient())
+ response = client.get('http://example.com/modified',
+ name='value')
+ self.assert_(response.getheader('Echo-Host') == 'example.com:None')
+ self.assert_(response.getheader('Echo-Uri') == '/modified?name=value')
+ self.assert_(response.getheader('Echo-Method') == 'GET')
+
+ def test_post(self):
+ client = atom.client.AtomPubClient(atom.mock_http_core.EchoHttpClient())
+ class TestData(object):
+ def modify_request(self, http_request):
+ http_request.add_body_part('test body', 'text/testdata')
+ response = client.Post(uri='http://example.com/', data=TestData())
+ self.assert_(response.getheader('Echo-Host') == 'example.com:None')
+ self.assert_(response.getheader('Echo-Uri') == '/')
+ self.assert_(response.getheader('Echo-Method') == 'POST')
+ self.assert_(response.getheader('Content-Length') == str(len('test body')))
+ self.assert_(response.getheader('Content-Type') == 'text/testdata')
+ self.assert_(response.read(2) == 'te')
+ self.assert_(response.read() == 'st body')
+ response = client.post(data=TestData(), uri='http://example.com/')
+ self.assert_(response.read() == 'test body')
+ self.assert_(response.getheader('Content-Type') == 'text/testdata')
+ # Don't pass in a body, but use an extra kwarg to add the body to the
+ # http_request.
+ response = client.post(x=TestData(), uri='http://example.com/')
+ self.assert_(response.read() == 'test body')
+
+ def test_put(self):
+ body_text = '<put>test</put>'
+ client = atom.client.AtomPubClient(atom.mock_http_core.EchoHttpClient())
+ class TestData(object):
+ def modify_request(self, http_request):
+ http_request.add_body_part(body_text, 'application/xml')
+ response = client.put('http://example.org', TestData())
+ self.assert_(response.getheader('Echo-Host') == 'example.org:None')
+ self.assert_(response.getheader('Echo-Uri') == '/')
+ self.assert_(response.getheader('Echo-Method') == 'PUT')
+ self.assert_(response.getheader('Content-Length') == str(len(body_text)))
+ self.assert_(response.getheader('Content-Type') == 'application/xml')
+ response = client.put(uri='http://example.org', data=TestData())
+ self.assert_(response.getheader('Content-Length') == str(len(body_text)))
+ self.assert_(response.getheader('Content-Type') == 'application/xml')
+
+ def test_delete(self):
+ client = atom.client.AtomPubClient(atom.mock_http_core.EchoHttpClient(),
+ source='my new app')
+ response = client.Delete('http://example.com/simple')
+ self.assertEqual(response.getheader('Echo-Host'), 'example.com:None')
+ self.assertEqual(response.getheader('Echo-Uri'), '/simple')
+ self.assertEqual(response.getheader('Echo-Method'), 'DELETE')
+ response = client.delete(uri='http://example.com/d')
+ self.assertEqual(response.getheader('Echo-Uri'), '/d')
+ self.assertEqual(response.getheader('Echo-Method'), 'DELETE')
+ self.assert_(
+ response.getheader('User-Agent').startswith('my new app gdata-py/'))
+
+def suite():
+ return unittest.TestSuite((unittest.makeSuite(AtomPubClientEchoTest, 'test'),
+ ))
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/core_test.py b/tests/atom_tests/core_test.py
new file mode 100755
index 0000000..76a0cbf
--- /dev/null
+++ b/tests/atom_tests/core_test.py
@@ -0,0 +1,461 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+try:
+ from xml.etree import cElementTree as ElementTree
+except ImportError:
+ try:
+ import cElementTree as ElementTree
+ except ImportError:
+ try:
+ from xml.etree import ElementTree
+ except ImportError:
+ from elementtree import ElementTree
+import atom.core
+import gdata.test_config as conf
+
+
+SAMPLE_XML = ('<outer xmlns="http://example.com/xml/1" '
+ 'xmlns:two="http://example.com/xml/2">'
+ '<inner x="123"/>'
+ '<inner x="234" y="abc"/>'
+ '<inner>'
+ '<two:nested>Some Test</two:nested>'
+ '<nested>Different Namespace</nested>'
+ '</inner>'
+ '<other two:z="true"></other>'
+ '</outer>')
+
+
+NO_NAMESPACE_XML = ('<foo bar="123"><baz>Baz Text!</baz></foo>')
+
+
+V1_XML = ('<able xmlns="http://example.com/1" '
+ 'xmlns:ex="http://example.com/ex/1">'
+ '<baker foo="42"/>'
+ '<ex:charlie>Greetings!</ex:charlie>'
+ '<same xmlns="http://example.com/s" x="true">'
+ '</able>')
+
+
+V2_XML = ('<alpha xmlns="http://example.com/2" '
+ 'xmlns:ex="http://example.com/ex/2">'
+ '<bravo bar="42"/>'
+ '<ex:charlie>Greetings!</ex:charlie>'
+ '<same xmlns="http://example.com/s" x="true">'
+ '</alpha>')
+
+
+class Child(atom.core.XmlElement):
+ _qname = ('{http://example.com/1}child', '{http://example.com/2}child')
+
+
+class Foo(atom.core.XmlElement):
+ _qname = 'foo'
+
+
+class Example(atom.core.XmlElement):
+ _qname = '{http://example.com}foo'
+ child = Child
+ foos = [Foo]
+ tag = 'tag'
+ versioned_attr = ('attr', '{http://new_ns}attr')
+
+
+# Example XmlElement subclass declarations.
+class Inner(atom.core.XmlElement):
+ _qname = '{http://example.com/xml/1}inner'
+ my_x = 'x'
+
+
+class Outer(atom.core.XmlElement):
+ _qname = '{http://example.com/xml/1}outer'
+ innards = [Inner]
+
+
+class XmlElementTest(unittest.TestCase):
+
+ def testGetQName(self):
+ class Unversioned(atom.core.XmlElement):
+ _qname = '{http://example.com}foo'
+
+ class Versioned(atom.core.XmlElement):
+ _qname = ('{http://example.com/1}foo', '{http://example.com/2}foo')
+
+ self.assert_(
+ atom.core._get_qname(Unversioned, 1) == '{http://example.com}foo')
+ self.assert_(
+ atom.core._get_qname(Unversioned, 2) == '{http://example.com}foo')
+ self.assert_(
+ atom.core._get_qname(Versioned, 1) == '{http://example.com/1}foo')
+ self.assert_(
+ atom.core._get_qname(Versioned, 2) == '{http://example.com/2}foo')
+
+ def testConstructor(self):
+ e = Example()
+ self.assert_(e.child is None)
+ self.assert_(e.tag is None)
+ self.assert_(e.versioned_attr is None)
+ self.assert_(e.foos == [])
+ self.assert_(e.text is None)
+
+ def testGetRules(self):
+ rules1 = Example._get_rules(1)
+ self.assert_(rules1[0] == '{http://example.com}foo')
+ self.assert_(rules1[1]['{http://example.com/1}child'] == ('child', Child,
+ False))
+ self.assert_(rules1[1]['foo'] == ('foos', Foo, True))
+ self.assert_(rules1[2]['tag'] == 'tag')
+ self.assert_(rules1[2]['attr'] == 'versioned_attr')
+ # Check to make sure we don't recalculate the rules.
+ self.assert_(rules1 == Example._get_rules(1))
+ rules2 = Example._get_rules(2)
+ self.assert_(rules2[0] == '{http://example.com}foo')
+ self.assert_(rules2[1]['{http://example.com/2}child'] == ('child', Child,
+ False))
+ self.assert_(rules2[1]['foo'] == ('foos', Foo, True))
+ self.assert_(rules2[2]['tag'] == 'tag')
+ self.assert_(rules2[2]['{http://new_ns}attr'] == 'versioned_attr')
+
+ def testGetElements(self):
+ e = Example()
+ e.child = Child()
+ e.child.text = 'child text'
+ e.foos.append(Foo())
+ e.foos[0].text = 'foo1'
+ e.foos.append(Foo())
+ e.foos[1].text = 'foo2'
+ e._other_elements.append(atom.core.XmlElement())
+ e._other_elements[0]._qname = 'bar'
+ e._other_elements[0].text = 'other1'
+ e._other_elements.append(atom.core.XmlElement())
+ e._other_elements[1]._qname = 'child'
+ e._other_elements[1].text = 'other2'
+
+ self.contains_expected_elements(e.get_elements(),
+ ['foo1', 'foo2', 'child text', 'other1', 'other2'])
+ self.contains_expected_elements(e.get_elements('child'),
+ ['child text', 'other2'])
+ self.contains_expected_elements(
+ e.get_elements('child', 'http://example.com/1'), ['child text'])
+ self.contains_expected_elements(
+ e.get_elements('child', 'http://example.com/2'), [])
+ self.contains_expected_elements(
+ e.get_elements('child', 'http://example.com/2', 2), ['child text'])
+ self.contains_expected_elements(
+ e.get_elements('child', 'http://example.com/1', 2), [])
+ self.contains_expected_elements(
+ e.get_elements('child', 'http://example.com/2', 3), ['child text'])
+ self.contains_expected_elements(e.get_elements('bar'), ['other1'])
+ self.contains_expected_elements(e.get_elements('bar', version=2),
+ ['other1'])
+ self.contains_expected_elements(e.get_elements('bar', version=3),
+ ['other1'])
+
+ def contains_expected_elements(self, elements, expected_texts):
+ self.assert_(len(elements) == len(expected_texts))
+ for element in elements:
+ self.assert_(element.text in expected_texts)
+
+ def testConstructorKwargs(self):
+ e = Example('hello', child=Child('world'), versioned_attr='1')
+ self.assert_(e.text == 'hello')
+ self.assert_(e.child.text == 'world')
+ self.assert_(e.versioned_attr == '1')
+ self.assert_(e.foos == [])
+ self.assert_(e.tag is None)
+
+ e = Example(foos=[Foo('1', ignored=1), Foo(text='2')], tag='ok')
+ self.assert_(e.text is None)
+ self.assert_(e.child is None)
+ self.assert_(e.versioned_attr is None)
+ self.assert_(len(e.foos) == 2)
+ self.assert_(e.foos[0].text == '1')
+ self.assert_(e.foos[1].text == '2')
+ self.assert_('ignored' not in e.foos[0].__dict__)
+ self.assert_(e.tag == 'ok')
+
+ def testParseBasicXmlElement(self):
+ element = atom.core.xml_element_from_string(SAMPLE_XML,
+ atom.core.XmlElement)
+ inners = element.get_elements('inner')
+ self.assert_(len(inners) == 3)
+ self.assert_(inners[0].get_attributes('x')[0].value == '123')
+ self.assert_(inners[0].get_attributes('y') == [])
+ self.assert_(inners[1].get_attributes('x')[0].value == '234')
+ self.assert_(inners[1].get_attributes('y')[0].value == 'abc')
+ self.assert_(inners[2].get_attributes('x') == [])
+ inners = element.get_elements('inner', 'http://example.com/xml/1')
+ self.assert_(len(inners) == 3)
+ inners = element.get_elements(None, 'http://example.com/xml/1')
+ self.assert_(len(inners) == 4)
+ inners = element.get_elements()
+ self.assert_(len(inners) == 4)
+ inners = element.get_elements('other')
+ self.assert_(len(inners) == 1)
+ self.assert_(inners[0].get_attributes(
+ 'z', 'http://example.com/xml/2')[0].value == 'true')
+ inners = element.get_elements('missing')
+ self.assert_(len(inners) == 0)
+
+ def testBasicXmlElementPreservesMarkup(self):
+ element = atom.core.xml_element_from_string(SAMPLE_XML,
+ atom.core.XmlElement)
+ tree1 = ElementTree.fromstring(SAMPLE_XML)
+ tree2 = ElementTree.fromstring(element.to_string())
+ self.assert_trees_similar(tree1, tree2)
+
+ def testSchemaParse(self):
+ outer = atom.core.xml_element_from_string(SAMPLE_XML, Outer)
+ self.assert_(isinstance(outer.innards, list))
+ self.assert_(len(outer.innards) == 3)
+ self.assert_(outer.innards[0].my_x == '123')
+
+ def testSchemaParsePreservesMarkup(self):
+ outer = atom.core.xml_element_from_string(SAMPLE_XML, Outer)
+ tree1 = ElementTree.fromstring(SAMPLE_XML)
+ tree2 = ElementTree.fromstring(outer.to_string())
+ self.assert_trees_similar(tree1, tree2)
+ found_x_and_y = False
+ found_x_123 = False
+ child = tree1.find('{http://example.com/xml/1}inner')
+ matching_children = tree2.findall(child.tag)
+ for match in matching_children:
+ if 'y' in match.attrib and match.attrib['y'] == 'abc':
+ if match.attrib['x'] == '234':
+ found_x_and_y = True
+ self.assert_(match.attrib['x'] == '234')
+ if 'x' in match.attrib and match.attrib['x'] == '123':
+ self.assert_('y' not in match.attrib)
+ found_x_123 = True
+ self.assert_(found_x_and_y)
+ self.assert_(found_x_123)
+
+ def testGenericTagAndNamespace(self):
+ element = atom.core.XmlElement(text='content')
+ # Try setting tag then namespace.
+ element.tag = 'foo'
+ self.assert_(element._qname == 'foo')
+ element.namespace = 'http://example.com/ns'
+ self.assert_(element._qname == '{http://example.com/ns}foo')
+
+ element = atom.core.XmlElement()
+ # Try setting namespace then tag.
+ element.namespace = 'http://example.com/ns'
+ self.assert_(element._qname == '{http://example.com/ns}')
+ element.tag = 'foo'
+ self.assert_(element._qname == '{http://example.com/ns}foo')
+
+ def assert_trees_similar(self, a, b):
+ """Compares two XML trees for approximate matching."""
+ for child in a:
+ self.assert_(len(a.findall(child.tag)) == len(b.findall(child.tag)))
+ for child in b:
+ self.assert_(len(a.findall(child.tag)) == len(b.findall(child.tag)))
+ self.assert_(len(a) == len(b))
+ self.assert_(a.text == b.text)
+ self.assert_(a.attrib == b.attrib)
+
+
+class UtilityFunctionTest(unittest.TestCase):
+
+ def testMatchQnames(self):
+ self.assert_(atom.core._qname_matches(
+ 'foo', 'http://example.com', '{http://example.com}foo'))
+ self.assert_(atom.core._qname_matches(
+ None, None, '{http://example.com}foo'))
+ self.assert_(atom.core._qname_matches(
+ None, None, 'foo'))
+ self.assert_(atom.core._qname_matches(
+ None, None, None))
+ self.assert_(atom.core._qname_matches(
+ None, None, '{http://example.com}'))
+ self.assert_(atom.core._qname_matches(
+ 'foo', None, '{http://example.com}foo'))
+ self.assert_(atom.core._qname_matches(
+ None, 'http://example.com', '{http://example.com}foo'))
+ self.assert_(atom.core._qname_matches(
+ None, '', 'foo'))
+ self.assert_(atom.core._qname_matches(
+ 'foo', '', 'foo'))
+ self.assert_(atom.core._qname_matches(
+ 'foo', '', 'foo'))
+ self.assert_(atom.core._qname_matches(
+ 'foo', 'http://google.com', '{http://example.com}foo') == False)
+ self.assert_(atom.core._qname_matches(
+ 'foo', 'http://example.com', '{http://example.com}bar') == False)
+ self.assert_(atom.core._qname_matches(
+ 'foo', 'http://example.com', '{http://google.com}foo') == False)
+ self.assert_(atom.core._qname_matches(
+ 'bar', 'http://example.com', '{http://google.com}foo') == False)
+ self.assert_(atom.core._qname_matches(
+ 'foo', None, '{http://example.com}bar') == False)
+ self.assert_(atom.core._qname_matches(
+ None, 'http://google.com', '{http://example.com}foo') == False)
+ self.assert_(atom.core._qname_matches(
+ None, '', '{http://example.com}foo') == False)
+ self.assert_(atom.core._qname_matches(
+ 'foo', '', 'bar') == False)
+
+
+class Chars(atom.core.XmlElement):
+ _qname = u'{http://example.com/}chars'
+ y = 'y'
+ alpha = 'a'
+
+
+class Strs(atom.core.XmlElement):
+ _qname = '{http://example.com/}strs'
+ chars = [Chars]
+ delta = u'd'
+
+
+def parse(string):
+ return atom.core.xml_element_from_string(string, atom.core.XmlElement)
+
+
+def create(tag, string):
+ element = atom.core.XmlElement(text=string)
+ element._qname = tag
+ return element
+
+
+class CharacterEncodingTest(unittest.TestCase):
+
+ def testUnicodeInputString(self):
+ # Test parsing the inner text.
+ self.assertEqual(parse(u'<x>δ</x>').text, u'\u03b4')
+ self.assertEqual(parse(u'<x>\u03b4</x>').text, u'\u03b4')
+
+ # Test output valid XML.
+ self.assertEqual(parse(u'<x>δ</x>').to_string(), '<x>δ</x>')
+ self.assertEqual(parse(u'<x>\u03b4</x>').to_string(), '<x>δ</x>')
+
+ # Test setting the inner text and output valid XML.
+ e = create(u'x', u'\u03b4')
+ self.assertEqual(e.to_string(), '<x>δ</x>')
+ self.assertEqual(e.text, u'\u03b4')
+ self.assert_(isinstance(e.text, unicode))
+ self.assertEqual(create(u'x', '\xce\xb4'.decode('utf-8')).to_string(),
+ '<x>δ</x>')
+
+ def testUnicodeTagsAndAttributes(self):
+ # Begin with test to show underlying ElementTree behavior.
+ t = ElementTree.fromstring(u'<del\u03b4ta>test</del\u03b4ta>'.encode('utf-8'))
+ self.assertEqual(t.tag, u'del\u03b4ta')
+ self.assertEqual(parse(u'<\u03b4elta>test</\u03b4elta>')._qname,
+ u'\u03b4elta')
+ # Test unicode attribute names and values.
+ t = ElementTree.fromstring(u'<x \u03b4a="\u03b4b" />'.encode('utf-8'))
+ self.assertEqual(t.attrib, {u'\u03b4a': u'\u03b4b'})
+ self.assertEqual(parse(u'<x \u03b4a="\u03b4b" />').get_attributes(
+ u'\u03b4a')[0].value, u'\u03b4b')
+ x = create('x', None)
+ x._other_attributes[u'a'] = u'\u03b4elta'
+ self.assert_(x.to_string().startswith('<x a="δelta"'))
+
+ def testUtf8InputString(self):
+ # Test parsing inner text.
+ self.assertEqual(parse('<x>δ</x>').text, u'\u03b4')
+ self.assertEqual(parse(u'<x>\u03b4</x>'.encode('utf-8')).text, u'\u03b4')
+ self.assertEqual(parse('<x>\xce\xb4</x>').text, u'\u03b4')
+
+ # Test output valid XML.
+ self.assertEqual(parse('<x>δ</x>').to_string(), '<x>δ</x>')
+ self.assertEqual(parse(u'<x>\u03b4</x>'.encode('utf-8')).to_string(),
+ '<x>δ</x>')
+ self.assertEqual(parse('<x>\xce\xb4</x>').to_string(), '<x>δ</x>')
+
+ # Test setting the inner text and output valid XML.
+ e = create('x', '\xce\xb4')
+ self.assertEqual(e.to_string(), '<x>δ</x>')
+ # Don't change the encoding until the we convert to an XML string.
+ self.assertEqual(e.text, '\xce\xb4')
+ self.assert_(isinstance(e.text, str))
+ self.assert_(isinstance(e.to_string(), str))
+ self.assertEqual(create('x', u'\u03b4'.encode('utf-8')).to_string(),
+ '<x>δ</x>')
+ # Test attributes and values with UTF-8 inputs.
+ self.assertEqual(parse('<x \xce\xb4a="\xce\xb4b" />').get_attributes(
+ u'\u03b4a')[0].value, u'\u03b4b')
+
+ def testUtf8TagsAndAttributes(self):
+ self.assertEqual(
+ parse(u'<\u03b4elta>test</\u03b4elta>'.encode('utf-8'))._qname,
+ u'\u03b4elta')
+ self.assertEqual(parse('<\xce\xb4elta>test</\xce\xb4elta>')._qname,
+ u'\u03b4elta')
+ # Test an element with UTF-8 in the attribute value.
+ x = create('x', None)
+ x._other_attributes[u'a'] = '\xce\xb4'
+ self.assert_(x.to_string(encoding='UTF-8').startswith('<x a="δ"'))
+ self.assert_(x.to_string().startswith('<x a="δ"'))
+
+ def testOtherEncodingOnInputString(self):
+ BIG_ENDIAN = 0
+ LITTLE_ENDIAN = 1
+ # Test parsing inner text.
+ self.assertEqual(parse(u'<x>\u03b4</x>'.encode('utf-16')).text, u'\u03b4')
+
+ # Test output valid XML.
+ self.assertEqual(parse(u'<x>\u03b4</x>'.encode('utf-16')).to_string(),
+ '<x>δ</x>')
+
+ # Test setting the inner text and output valid XML.
+ e = create('x', u'\u03b4'.encode('utf-16'))
+ self.assertEqual(e.to_string(encoding='utf-16'), '<x>δ</x>')
+ # Don't change the encoding until the we convert to an XML string.
+ # Allow either little-endian or big-endian byte orderings.
+ self.assert_(e.text in ['\xff\xfe\xb4\x03', '\xfe\xff\x03\xb4'])
+ endianness = LITTLE_ENDIAN
+ if e.text == '\xfe\xff\x03\xb4':
+ endianness = BIG_ENDIAN
+ self.assert_(isinstance(e.text, str))
+ self.assert_(isinstance(e.to_string(encoding='utf-16'), str))
+ if endianness == LITTLE_ENDIAN:
+ self.assertEqual(
+ create('x', '\xff\xfe\xb4\x03').to_string(encoding='utf-16'),
+ '<x>δ</x>')
+ else:
+ self.assertEqual(
+ create('x', '\xfe\xff\x03\xb4').to_string(encoding='utf-16'),
+ '<x>δ</x>')
+
+ def testOtherEncodingInTagsAndAttributes(self):
+ self.assertEqual(
+ parse(u'<\u03b4elta>test</\u03b4elta>'.encode('utf-16'))._qname,
+ u'\u03b4elta')
+ # Test an element with UTF-16 in the attribute value.
+ x = create('x', None)
+ x._other_attributes[u'a'] = u'\u03b4'.encode('utf-16')
+ self.assert_(x.to_string(encoding='UTF-16').startswith('<x a="δ"'))
+
+
+def suite():
+ return conf.build_suite([XmlElementTest, UtilityFunctionTest,
+ CharacterEncodingTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/data_test.py b/tests/atom_tests/data_test.py
new file mode 100755
index 0000000..74c2273
--- /dev/null
+++ b/tests/atom_tests/data_test.py
@@ -0,0 +1,925 @@
+#!/usr/bin/python
+# -*-*- encoding: utf-8 -*-*-
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder@gmail.com (Jeff Scudder)'
+
+
+import sys
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom.data
+import atom.core
+import gdata.test_config as conf
+
+
+XML_ENTRY_1 = """<?xml version='1.0'?>
+ <entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:g='http://base.google.com/ns/1.0'>
+ <category scheme="http://base.google.com/categories/itemtypes"
+ term="products"/>
+ <id> http://www.google.com/test/id/url </id>
+ <title type='text'>Testing 2000 series laptop</title>
+ <content type='xhtml'>
+ <div xmlns='http://www.w3.org/1999/xhtml'>A Testing Laptop</div>
+ </content>
+ <link rel='alternate' type='text/html'
+ href='http://www.provider-host.com/123456789'/>
+ <link rel='license'
+ href='http://creativecommons.org/licenses/by-nc/2.5/rdf'/>
+ <g:label>Computer</g:label>
+ <g:label>Laptop</g:label>
+ <g:label>testing laptop</g:label>
+ <g:item_type>products</g:item_type>
+ </entry>"""
+
+class AuthorTest(unittest.TestCase):
+
+ def setUp(self):
+ self.author = atom.data.Author()
+
+ def testEmptyAuthorShouldHaveEmptyExtensionLists(self):
+ self.assert_(isinstance(self.author._other_elements, list))
+ self.assertEqual(len(self.author._other_elements), 0)
+ self.assert_(isinstance(self.author._other_attributes, dict))
+ self.assertEqual(len(self.author._other_attributes), 0)
+
+ def testNormalAuthorShouldHaveNoExtensionElements(self):
+ self.author.name = atom.data.Name(text='Jeff Scudder')
+ self.assertEqual(self.author.name.text, 'Jeff Scudder')
+ self.assertEqual(len(self.author._other_elements), 0)
+ new_author = atom.core.XmlElementFromString(self.author.ToString(),
+ atom.data.Author)
+ self.assertEqual(len(new_author._other_elements), 0)
+ self.assertEqual(new_author.name.text, 'Jeff Scudder')
+
+ self.author.extension_elements.append(atom.data.ExtensionElement(
+ 'foo', text='bar'))
+ self.assertEqual(len(self.author.extension_elements), 1)
+ self.assertEqual(self.author.name.text, 'Jeff Scudder')
+ new_author = atom.core.parse(self.author.ToString(), atom.data.Author)
+ self.assertEqual(len(self.author.extension_elements), 1)
+ self.assertEqual(new_author.name.text, 'Jeff Scudder')
+
+ def testEmptyAuthorToAndFromStringShouldMatch(self):
+ string_from_author = self.author.ToString()
+ new_author = atom.core.XmlElementFromString(string_from_author,
+ atom.data.Author)
+ string_from_new_author = new_author.ToString()
+ self.assertEqual(string_from_author, string_from_new_author)
+
+ def testAuthorWithNameToAndFromStringShouldMatch(self):
+ self.author.name = atom.data.Name()
+ self.author.name.text = 'Jeff Scudder'
+ string_from_author = self.author.ToString()
+ new_author = atom.core.XmlElementFromString(string_from_author,
+ atom.data.Author)
+ string_from_new_author = new_author.ToString()
+ self.assertEqual(string_from_author, string_from_new_author)
+ self.assertEqual(self.author.name.text, new_author.name.text)
+
+ def testExtensionElements(self):
+ self.author.extension_attributes['foo1'] = 'bar'
+ self.author.extension_attributes['foo2'] = 'rab'
+ self.assertEqual(self.author.extension_attributes['foo1'], 'bar')
+ self.assertEqual(self.author.extension_attributes['foo2'], 'rab')
+ new_author = atom.core.parse(str(self.author), atom.data.Author)
+ self.assertEqual(new_author.extension_attributes['foo1'], 'bar')
+ self.assertEqual(new_author.extension_attributes['foo2'], 'rab')
+
+ def testConvertFullAuthorToAndFromString(self):
+ TEST_AUTHOR = """<?xml version="1.0" encoding="utf-8"?>
+ <author xmlns="http://www.w3.org/2005/Atom">
+ <name xmlns="http://www.w3.org/2005/Atom">John Doe</name>
+ <email xmlns="http://www.w3.org/2005/Atom">john@example.com</email>
+ <uri>http://www.google.com</uri>
+ </author>"""
+ author = atom.core.parse(TEST_AUTHOR, atom.data.Author)
+ self.assertEqual(author.name.text, 'John Doe')
+ self.assertEqual(author.email.text, 'john@example.com')
+ self.assertEqual(author.uri.text, 'http://www.google.com')
+
+
+class EmailTest(unittest.TestCase):
+
+ def setUp(self):
+ self.email = atom.data.Email()
+
+ def testEmailToAndFromString(self):
+ self.email.text = 'This is a test'
+ new_email = atom.core.parse(self.email.to_string(), atom.data.Email)
+ self.assertEqual(self.email.text, new_email.text)
+ self.assertEqual(self.email.extension_elements,
+ new_email.extension_elements)
+
+
+class NameTest(unittest.TestCase):
+
+ def setUp(self):
+ self.name = atom.data.Name()
+
+ def testEmptyNameToAndFromStringShouldMatch(self):
+ string_from_name = self.name.ToString()
+ new_name = atom.core.XmlElementFromString(string_from_name,
+ atom.data.Name)
+ string_from_new_name = new_name.ToString()
+ self.assertEqual(string_from_name, string_from_new_name)
+
+ def testText(self):
+ self.assert_(self.name.text is None)
+ self.name.text = 'Jeff Scudder'
+ self.assertEqual(self.name.text, 'Jeff Scudder')
+ new_name = atom.core.parse(self.name.to_string(), atom.data.Name)
+ self.assertEqual(new_name.text, self.name.text)
+
+ def testExtensionElements(self):
+ self.name.extension_attributes['foo'] = 'bar'
+ self.assertEqual(self.name.extension_attributes['foo'], 'bar')
+ new_name = atom.core.parse(self.name.ToString(), atom.data.Name)
+ self.assertEqual(new_name.extension_attributes['foo'], 'bar')
+
+
+class ExtensionElementTest(unittest.TestCase):
+
+ def setUp(self):
+ self.ee = atom.data.ExtensionElement('foo')
+ self.EXTENSION_TREE = """<?xml version="1.0" encoding="utf-8"?>
+ <feed xmlns="http://www.w3.org/2005/Atom">
+ <g:author xmlns:g="http://www.google.com">
+ <g:name>John Doe
+ <g:foo yes="no" up="down">Bar</g:foo>
+ </g:name>
+ </g:author>
+ </feed>"""
+
+ def testEmptyEEShouldProduceEmptyString(self):
+ pass
+
+ def testEEParsesTreeCorrectly(self):
+ deep_tree = atom.core.xml_element_from_string(self.EXTENSION_TREE,
+ atom.data.ExtensionElement)
+ self.assertEqual(deep_tree.tag, 'feed')
+ self.assertEqual(deep_tree.namespace, 'http://www.w3.org/2005/Atom')
+ self.assert_(deep_tree.children[0].tag == 'author')
+ self.assert_(deep_tree.children[0].namespace == 'http://www.google.com')
+ self.assert_(deep_tree.children[0].children[0].tag == 'name')
+ self.assert_(deep_tree.children[0].children[0].namespace ==
+ 'http://www.google.com')
+ self.assert_(deep_tree.children[0].children[0].text.strip() == 'John Doe')
+ self.assert_(deep_tree.children[0].children[0].children[0].text.strip() ==
+ 'Bar')
+ foo = deep_tree.children[0].children[0].children[0]
+ self.assert_(foo.tag == 'foo')
+ self.assert_(foo.namespace == 'http://www.google.com')
+ self.assert_(foo.attributes['up'] == 'down')
+ self.assert_(foo.attributes['yes'] == 'no')
+ self.assert_(foo.children == [])
+
+ def testEEToAndFromStringShouldMatch(self):
+ string_from_ee = self.ee.ToString()
+ new_ee = atom.core.xml_element_from_string(string_from_ee,
+ atom.data.ExtensionElement)
+ string_from_new_ee = new_ee.ToString()
+ self.assert_(string_from_ee == string_from_new_ee)
+
+ deep_tree = atom.core.xml_element_from_string(self.EXTENSION_TREE,
+ atom.data.ExtensionElement)
+ string_from_deep_tree = deep_tree.ToString()
+ new_deep_tree = atom.core.xml_element_from_string(string_from_deep_tree,
+ atom.data.ExtensionElement)
+ string_from_new_deep_tree = new_deep_tree.ToString()
+ self.assert_(string_from_deep_tree == string_from_new_deep_tree)
+
+
+class LinkTest(unittest.TestCase):
+
+ def setUp(self):
+ self.link = atom.data.Link()
+
+ def testLinkToAndFromString(self):
+ self.link.href = 'test href'
+ self.link.hreflang = 'english'
+ self.link.type = 'text/html'
+ self.link.extension_attributes['foo'] = 'bar'
+ self.assert_(self.link.href == 'test href')
+ self.assert_(self.link.hreflang == 'english')
+ self.assert_(self.link.type == 'text/html')
+ self.assert_(self.link.extension_attributes['foo'] == 'bar')
+ new_link = atom.core.parse(self.link.ToString(), atom.data.Link)
+ self.assert_(self.link.href == new_link.href)
+ self.assert_(self.link.type == new_link.type)
+ self.assert_(self.link.hreflang == new_link.hreflang)
+ self.assert_(self.link.extension_attributes['foo'] ==
+ new_link.extension_attributes['foo'])
+
+ def testLinkType(self):
+ test_link = atom.data.Link(type='text/html')
+ self.assertEqual(test_link.type, 'text/html')
+
+
+class GeneratorTest(unittest.TestCase):
+
+ def setUp(self):
+ self.generator = atom.data.Generator()
+
+ def testGeneratorToAndFromString(self):
+ self.generator.uri = 'www.google.com'
+ self.generator.version = '1.0'
+ self.generator.extension_attributes['foo'] = 'bar'
+ self.assert_(self.generator.uri == 'www.google.com')
+ self.assert_(self.generator.version == '1.0')
+ self.assert_(self.generator.extension_attributes['foo'] == 'bar')
+ new_generator = atom.core.parse(self.generator.ToString(), atom.data.Generator)
+ self.assert_(self.generator.uri == new_generator.uri)
+ self.assert_(self.generator.version == new_generator.version)
+ self.assert_(self.generator.extension_attributes['foo'] ==
+ new_generator.extension_attributes['foo'])
+
+
+class TitleTest(unittest.TestCase):
+
+ def setUp(self):
+ self.title = atom.data.Title()
+
+ def testTitleToAndFromString(self):
+ self.title.type = 'text'
+ self.title.text = 'Less: <'
+ self.assert_(self.title.type == 'text')
+ self.assert_(self.title.text == 'Less: <')
+ new_title = atom.core.parse(str(self.title), atom.data.Title)
+ self.assert_(self.title.type == new_title.type)
+ self.assert_(self.title.text == new_title.text)
+
+
+class SubtitleTest(unittest.TestCase):
+
+ def setUp(self):
+ self.subtitle = atom.data.Subtitle()
+
+ def testTitleToAndFromString(self):
+ self.subtitle.type = 'text'
+ self.subtitle.text = 'sub & title'
+ self.assert_(self.subtitle.type == 'text')
+ self.assert_(self.subtitle.text == 'sub & title')
+ new_subtitle = atom.core.parse(self.subtitle.ToString(),
+ atom.data.Subtitle)
+ self.assert_(self.subtitle.type == new_subtitle.type)
+ self.assert_(self.subtitle.text == new_subtitle.text)
+
+
+class SummaryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.summary = atom.data.Summary()
+
+ def testTitleToAndFromString(self):
+ self.summary.type = 'text'
+ self.summary.text = 'Less: <'
+ self.assert_(self.summary.type == 'text')
+ self.assert_(self.summary.text == 'Less: <')
+ new_summary = atom.core.parse(self.summary.ToString(), atom.data.Summary)
+ self.assert_(self.summary.type == new_summary.type)
+ self.assert_(self.summary.text == new_summary.text)
+
+
+class CategoryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.category = atom.data.Category()
+
+ def testCategoryToAndFromString(self):
+ self.category.term = 'x'
+ self.category.scheme = 'y'
+ self.category.label = 'z'
+ self.assert_(self.category.term == 'x')
+ self.assert_(self.category.scheme == 'y')
+ self.assert_(self.category.label == 'z')
+ new_category = atom.core.parse(self.category.to_string(),
+ atom.data.Category)
+ self.assert_(self.category.term == new_category.term)
+ self.assert_(self.category.scheme == new_category.scheme)
+ self.assert_(self.category.label == new_category.label)
+
+
+class ContributorTest(unittest.TestCase):
+
+ def setUp(self):
+ self.contributor = atom.data.Contributor()
+
+ def testContributorToAndFromString(self):
+ self.contributor.name = atom.data.Name(text='J Scud')
+ self.contributor.email = atom.data.Email(text='nobody@nowhere')
+ self.contributor.uri = atom.data.Uri(text='http://www.google.com')
+ self.assert_(self.contributor.name.text == 'J Scud')
+ self.assert_(self.contributor.email.text == 'nobody@nowhere')
+ self.assert_(self.contributor.uri.text == 'http://www.google.com')
+ new_contributor = atom.core.parse(self.contributor.ToString(),
+ atom.data.Contributor)
+ self.assert_(self.contributor.name.text == new_contributor.name.text)
+ self.assert_(self.contributor.email.text == new_contributor.email.text)
+ self.assert_(self.contributor.uri.text == new_contributor.uri.text)
+
+
+class IdTest(unittest.TestCase):
+
+ def setUp(self):
+ self.my_id = atom.data.Id()
+
+ def testIdToAndFromString(self):
+ self.my_id.text = 'my nifty id'
+ self.assert_(self.my_id.text == 'my nifty id')
+ new_id = atom.core.parse(self.my_id.ToString(), atom.data.Id)
+ self.assert_(self.my_id.text == new_id.text)
+
+
+class IconTest(unittest.TestCase):
+
+ def setUp(self):
+ self.icon = atom.data.Icon()
+
+ def testIconToAndFromString(self):
+ self.icon.text = 'my picture'
+ self.assert_(self.icon.text == 'my picture')
+ new_icon = atom.core.parse(str(self.icon), atom.data.Icon)
+ self.assert_(self.icon.text == new_icon.text)
+
+
+class LogoTest(unittest.TestCase):
+
+ def setUp(self):
+ self.logo = atom.data.Logo()
+
+ def testLogoToAndFromString(self):
+ self.logo.text = 'my logo'
+ self.assert_(self.logo.text == 'my logo')
+ new_logo = atom.core.parse(self.logo.ToString(), atom.data.Logo)
+ self.assert_(self.logo.text == new_logo.text)
+
+
+class RightsTest(unittest.TestCase):
+
+ def setUp(self):
+ self.rights = atom.data.Rights()
+
+ def testContributorToAndFromString(self):
+ self.rights.text = 'you have the right to remain silent'
+ self.rights.type = 'text'
+ self.assert_(self.rights.text == 'you have the right to remain silent')
+ self.assert_(self.rights.type == 'text')
+ new_rights = atom.core.parse(self.rights.ToString(), atom.data.Rights)
+ self.assert_(self.rights.text == new_rights.text)
+ self.assert_(self.rights.type == new_rights.type)
+
+
+class UpdatedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.updated = atom.data.Updated()
+
+ def testUpdatedToAndFromString(self):
+ self.updated.text = 'my time'
+ self.assert_(self.updated.text == 'my time')
+ new_updated = atom.core.parse(self.updated.ToString(), atom.data.Updated)
+ self.assert_(self.updated.text == new_updated.text)
+
+
+class PublishedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.published = atom.data.Published()
+
+ def testPublishedToAndFromString(self):
+ self.published.text = 'pub time'
+ self.assert_(self.published.text == 'pub time')
+ new_published = atom.core.parse(self.published.ToString(),
+ atom.data.Published)
+ self.assert_(self.published.text == new_published.text)
+
+
+class FeedEntryParentTest(unittest.TestCase):
+ """The test accesses hidden methods in atom.FeedEntryParent"""
+
+ def testConvertToAndFromElementTree(self):
+ # Use entry because FeedEntryParent doesn't have a tag or namespace.
+ original = atom.data.Entry()
+ copy = atom.data.FeedEntryParent()
+
+ original.author.append(atom.data.Author(name=atom.data.Name(
+ text='J Scud')))
+ self.assert_(original.author[0].name.text == 'J Scud')
+ self.assert_(copy.author == [])
+
+ original.id = atom.data.Id(text='test id')
+ self.assert_(original.id.text == 'test id')
+ self.assert_(copy.id is None)
+
+ copy._harvest_tree(original._to_tree())
+ self.assert_(original.author[0].name.text == copy.author[0].name.text)
+ self.assert_(original.id.text == copy.id.text)
+
+
+class EntryTest(unittest.TestCase):
+
+ def testConvertToAndFromString(self):
+ entry = atom.data.Entry()
+ entry.author.append(atom.data.Author(name=atom.data.Name(text='js')))
+ entry.title = atom.data.Title(text='my test entry')
+ self.assert_(entry.author[0].name.text == 'js')
+ self.assert_(entry.title.text == 'my test entry')
+ new_entry = atom.core.parse(entry.ToString(), atom.data.Entry)
+ self.assert_(new_entry.author[0].name.text == 'js')
+ self.assert_(new_entry.title.text == 'my test entry')
+
+ def testEntryCorrectlyConvertsActualData(self):
+ entry = atom.core.parse(XML_ENTRY_1, atom.data.Entry)
+ self.assert_(entry.category[0].scheme ==
+ 'http://base.google.com/categories/itemtypes')
+ self.assert_(entry.category[0].term == 'products')
+ self.assert_(entry.id.text == ' http://www.google.com/test/id/url ')
+ self.assert_(entry.title.text == 'Testing 2000 series laptop')
+ self.assert_(entry.title.type == 'text')
+ self.assert_(entry.content.type == 'xhtml')
+ #TODO check all other values for the test entry
+
+ def testEntryWithFindElementAndFindAttribute(self):
+ entry = atom.data.Entry()
+ entry.link.append(atom.data.Link(rel='self', href='x'))
+ entry.link.append(atom.data.Link(rel='foo', href='y'))
+ entry.link.append(atom.data.Link(rel='edit',href='z'))
+
+ self_link = None
+ edit_link = None
+
+ for link in entry.get_elements('link', 'http://www.w3.org/2005/Atom'):
+ ignored1, ignored2, attributes = link.__class__._get_rules(2)
+ if link.get_attributes('rel')[0].value == 'self':
+ self_link = link.get_attributes('href')[0].value
+ elif link.get_attributes('rel')[0].value == 'edit':
+ edit_link = link.get_attributes('href')[0].value
+
+ self.assertEqual(self_link, 'x')
+ self.assertEqual(edit_link, 'z')
+
+ def testAppControl(self):
+ TEST_BASE_ENTRY = """<?xml version='1.0'?>
+ <entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:g='http://base.google.com/ns/1.0'>
+ <category scheme="http://base.google.com/categories/itemtypes"
+ term="products"/>
+ <title type='text'>Testing 2000 series laptop</title>
+ <content type='xhtml'>
+ <div xmlns='http://www.w3.org/1999/xhtml'>A Testing Laptop</div>
+ </content>
+ <app:control xmlns:app='http://purl.org/atom/app#'>
+ <app:draft>yes</app:draft>
+ <gm:disapproved
+ xmlns:gm='http://base.google.com/ns-metadata/1.0'/>
+ </app:control>
+ <link rel='alternate' type='text/html'
+ href='http://www.provider-host.com/123456789'/>
+ <g:label>Computer</g:label>
+ <g:label>Laptop</g:label>
+ <g:label>testing laptop</g:label>
+ <g:item_type>products</g:item_type>
+ </entry>"""
+ entry = atom.core.parse(TEST_BASE_ENTRY, atom.data.Entry)
+ self.assertEquals(entry.control.draft.text, 'yes')
+ self.assertEquals(len(entry.control.extension_elements), 1)
+ self.assertEquals(entry.control.extension_elements[0].tag, 'disapproved')
+
+
+class ControlTest(unittest.TestCase):
+
+ def testVersionRuleGeneration(self):
+ self.assertEqual(atom.core._get_qname(atom.data.Control, 1),
+ '{http://purl.org/atom/app#}control')
+ self.assertEqual(atom.data.Control._get_rules(1)[0],
+ '{http://purl.org/atom/app#}control')
+
+
+ def testVersionedControlFromString(self):
+ xml_v1 = """<control xmlns="http://purl.org/atom/app#">
+ <draft>no</draft></control>"""
+ xml_v2 = """<control xmlns="http://www.w3.org/2007/app">
+ <draft>no</draft></control>"""
+ control_v1 = atom.core.parse(xml_v1, atom.data.Control, 1)
+ control_v2 = atom.core.parse(xml_v2, atom.data.Control, 2)
+ self.assert_(control_v1 is not None)
+ self.assert_(control_v2 is not None)
+ # Parsing with mismatched version numbers should return None.
+ self.assert_(atom.core.parse(xml_v1, atom.data.Control, 2) is None)
+ self.assert_(atom.core.parse(xml_v2, atom.data.Control, 1) is None)
+
+ def testConvertToAndFromString(self):
+ control = atom.data.Control()
+ control.text = 'some text'
+ control.draft = atom.data.Draft(text='yes')
+ self.assertEquals(control.draft.text, 'yes')
+ self.assertEquals(control.text, 'some text')
+ self.assert_(isinstance(control.draft, atom.data.Draft))
+ new_control = atom.core.parse(str(control), atom.data.Control)
+ self.assertEquals(control.draft.text, new_control.draft.text)
+ self.assertEquals(control.text, new_control.text)
+ self.assert_(isinstance(new_control.draft, atom.data.Draft))
+
+
+class DraftTest(unittest.TestCase):
+
+ def testConvertToAndFromString(self):
+ draft = atom.data.Draft()
+ draft.text = 'maybe'
+ draft.extension_attributes['foo'] = 'bar'
+ self.assertEquals(draft.text, 'maybe')
+ self.assertEquals(draft.extension_attributes['foo'], 'bar')
+ new_draft = atom.core.parse(str(draft), atom.data.Draft)
+ self.assertEquals(draft.text, new_draft.text)
+ self.assertEquals(draft.extension_attributes['foo'],
+ new_draft.extension_attributes['foo'])
+
+
+
+class SourceTest(unittest.TestCase):
+
+ def testConvertToAndFromString(self):
+ source = atom.data.Source()
+ source.author.append(atom.data.Author(name=atom.data.Name(text='js')))
+ source.title = atom.data.Title(text='my test source')
+ source.generator = atom.data.Generator(text='gen')
+ self.assert_(source.author[0].name.text == 'js')
+ self.assert_(source.title.text == 'my test source')
+ self.assert_(source.generator.text == 'gen')
+ new_source = atom.core.parse(source.ToString(), atom.data.Source)
+ self.assert_(new_source.author[0].name.text == 'js')
+ self.assert_(new_source.title.text == 'my test source')
+ self.assert_(new_source.generator.text == 'gen')
+
+
+class FeedTest(unittest.TestCase):
+
+ def testConvertToAndFromString(self):
+ feed = atom.data.Feed()
+ feed.author.append(atom.data.Author(name=atom.data.Name(text='js')))
+ feed.title = atom.data.Title(text='my test source')
+ feed.generator = atom.data.Generator(text='gen')
+ feed.entry.append(atom.data.Entry(author=[atom.data.Author(
+ name=atom.data.Name(text='entry author'))]))
+ self.assert_(feed.author[0].name.text == 'js')
+ self.assert_(feed.title.text == 'my test source')
+ self.assert_(feed.generator.text == 'gen')
+ self.assert_(feed.entry[0].author[0].name.text == 'entry author')
+ new_feed = atom.core.parse(feed.ToString(), atom.data.Feed)
+ self.assert_(new_feed.author[0].name.text == 'js')
+ self.assert_(new_feed.title.text == 'my test source')
+ self.assert_(new_feed.generator.text == 'gen')
+ self.assert_(new_feed.entry[0].author[0].name.text == 'entry author')
+
+ def testPreserveEntryOrder(self):
+ test_xml = (
+ '<feed xmlns="http://www.w3.org/2005/Atom">'
+ '<entry><id>0</id></entry>'
+ '<entry><id>1</id></entry>'
+ '<title>Testing Order</title>'
+ '<entry><id>2</id></entry>'
+ '<entry><id>3</id></entry>'
+ '<entry><id>4</id></entry>'
+ '<entry><id>5</id></entry>'
+ '<entry><id>6</id></entry>'
+ '<entry><id>7</id></entry>'
+ '<author/>'
+ '<entry><id>8</id></entry>'
+ '<id>feed_id</id>'
+ '<entry><id>9</id></entry>'
+ '</feed>')
+ feed = atom.core.parse(test_xml, atom.data.Feed)
+ for i in xrange(10):
+ self.assertEqual(feed.entry[i].id.text, str(i))
+ feed = atom.core.parse(feed.ToString(), atom.data.Feed)
+ for i in xrange(10):
+ self.assertEqual(feed.entry[i].id.text, str(i))
+ temp = feed.entry[3]
+ feed.entry[3] = feed.entry[4]
+ feed.entry[4] = temp
+ self.assert_(feed.entry[2].id.text == '2')
+ self.assert_(feed.entry[3].id.text == '4')
+ self.assert_(feed.entry[4].id.text == '3')
+ self.assert_(feed.entry[5].id.text == '5')
+ feed = atom.core.parse(feed.to_string(), atom.data.Feed)
+ self.assertEqual(feed.entry[2].id.text, '2')
+ self.assertEqual(feed.entry[3].id.text, '4')
+ self.assertEqual(feed.entry[4].id.text, '3')
+ self.assertEqual(feed.entry[5].id.text, '5')
+
+
+class ContentEntryParentTest(unittest.TestCase):
+ """The test accesses hidden methods in atom.FeedEntryParent"""
+
+ def setUp(self):
+ self.content = atom.data.Content()
+
+ def testConvertToAndFromElementTree(self):
+ self.content.text = 'my content'
+ self.content.type = 'text'
+ self.content.src = 'my source'
+ self.assert_(self.content.text == 'my content')
+ self.assert_(self.content.type == 'text')
+ self.assert_(self.content.src == 'my source')
+ new_content = atom.core.parse(self.content.ToString(), atom.data.Content)
+ self.assert_(self.content.text == new_content.text)
+ self.assert_(self.content.type == new_content.type)
+ self.assert_(self.content.src == new_content.src)
+
+ def testContentConstructorSetsSrc(self):
+ new_content = atom.data.Content(src='abcd')
+ self.assertEquals(new_content.src, 'abcd')
+
+ def testContentFromString(self):
+ content_xml = '<content xmlns="http://www.w3.org/2005/Atom" type="test"/>'
+ content = atom.core.parse(content_xml, atom.data.Content)
+ self.assert_(isinstance(content, atom.data.Content))
+ self.assertEqual(content.type, 'test')
+
+
+class PreserveUnkownElementTest(unittest.TestCase):
+ """Tests correct preservation of XML elements which are non Atom"""
+
+ def setUp(self):
+ GBASE_ATTRIBUTE_FEED = """<?xml version='1.0' encoding='UTF-8'?>
+ <feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+ xmlns:gm='http://base.google.com/ns-metadata/1.0'>
+ <id>http://www.google.com/base/feeds/attributes</id>
+ <updated>2006-11-01T20:35:59.578Z</updated>
+ <category scheme='http://base.google.com/categories/itemtypes'
+ term='online jobs'></category>
+ <category scheme='http://base.google.com/categories/itemtypes'
+ term='jobs'></category>
+ <title type='text'>histogram for query: [item type:jobs]</title>
+ <link rel='alternate' type='text/html'
+ href='http://base.google.com'></link>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/base/attributes/jobs'></link>
+ <generator version='1.0'
+ uri='http://base.google.com'>GoogleBase</generator>
+ <openSearch:totalResults>16</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>16</openSearch:itemsPerPage>
+ <entry>
+ <id>http://www.google.com/base/feeds/attributes/job+industy</id>
+ <updated>2006-11-01T20:36:00.100Z</updated>
+ <title type='text'>job industry(text)</title>
+ <content type='text'>Attribute"job industry" of type text.
+ </content>
+ <gm:attribute name='job industry' type='text' count='4416629'>
+ <gm:value count='380772'>it internet</gm:value>
+ <gm:value count='261565'>healthcare</gm:value>
+ <gm:value count='142018'>information technology</gm:value>
+ <gm:value count='124622'>accounting</gm:value>
+ <gm:value count='111311'>clerical and administrative</gm:value>
+ <gm:value count='82928'>other</gm:value>
+ <gm:value count='77620'>sales and sales management</gm:value>
+ <gm:value count='68764'>information systems</gm:value>
+ <gm:value count='65859'>engineering and architecture</gm:value>
+ <gm:value count='64757'>sales</gm:value>
+ </gm:attribute>
+ </entry>
+ </feed>"""
+ self.feed = atom.core.parse(GBASE_ATTRIBUTE_FEED,
+ atom.data.Feed)
+
+ def testCaptureOpenSearchElements(self):
+ self.assertEquals(self.feed.FindExtensions('totalResults')[0].tag,
+ 'totalResults')
+ self.assertEquals(self.feed.FindExtensions('totalResults')[0].namespace,
+ 'http://a9.com/-/spec/opensearchrss/1.0/')
+ open_search_extensions = self.feed.FindExtensions(
+ namespace='http://a9.com/-/spec/opensearchrss/1.0/')
+ self.assertEquals(len(open_search_extensions), 3)
+ for element in open_search_extensions:
+ self.assertEquals(element.namespace,
+ 'http://a9.com/-/spec/opensearchrss/1.0/')
+
+ def testCaptureMetaElements(self):
+ meta_elements = self.feed.entry[0].FindExtensions(
+ namespace='http://base.google.com/ns-metadata/1.0')
+ self.assertEquals(len(meta_elements), 1)
+ self.assertEquals(meta_elements[0].attributes['count'], '4416629')
+ self.assertEquals(len(meta_elements[0].children), 10)
+
+ def testCaptureMetaChildElements(self):
+ meta_elements = self.feed.entry[0].FindExtensions(
+ namespace='http://base.google.com/ns-metadata/1.0')
+ meta_children = meta_elements[0].FindChildren(
+ namespace='http://base.google.com/ns-metadata/1.0')
+ self.assertEquals(len(meta_children), 10)
+ for child in meta_children:
+ self.assertEquals(child.tag, 'value')
+
+
+class LinkFinderTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(XML_ENTRY_1, atom.data.Entry)
+
+ def testLinkFinderGetsLicenseLink(self):
+ self.assert_(isinstance(self.entry.GetLink('license'), atom.data.Link))
+ self.assert_(isinstance(self.entry.GetLicenseLink(), atom.data.Link))
+ self.assertEquals(self.entry.GetLink('license').href,
+ 'http://creativecommons.org/licenses/by-nc/2.5/rdf')
+ self.assertEquals(self.entry.get_license_link().href,
+ 'http://creativecommons.org/licenses/by-nc/2.5/rdf')
+ self.assertEquals(self.entry.GetLink('license').rel, 'license')
+ self.assertEquals(self.entry.FindLicenseLink(),
+ 'http://creativecommons.org/licenses/by-nc/2.5/rdf')
+
+ def testLinkFinderGetsAlternateLink(self):
+ self.assert_(isinstance(self.entry.GetLink('alternate'),
+ atom.data.Link))
+ self.assertEquals(self.entry.GetLink('alternate').href,
+ 'http://www.provider-host.com/123456789')
+ self.assertEquals(self.entry.FindAlternateLink(),
+ 'http://www.provider-host.com/123456789')
+ self.assertEquals(self.entry.GetLink('alternate').rel, 'alternate')
+
+
+class AtomBaseTest(unittest.TestCase):
+
+ def testAtomBaseConvertsExtensions(self):
+ # Using Id because it adds no additional members.
+ atom_base = atom.data.Id()
+ extension_child = atom.data.ExtensionElement('foo',
+ namespace='http://ns0.com')
+ extension_grandchild = atom.data.ExtensionElement('bar',
+ namespace='http://ns0.com')
+ extension_child.children.append(extension_grandchild)
+ atom_base.extension_elements.append(extension_child)
+ self.assertEquals(len(atom_base.extension_elements), 1)
+ self.assertEquals(len(atom_base.extension_elements[0].children), 1)
+ self.assertEquals(atom_base.extension_elements[0].tag, 'foo')
+ self.assertEquals(atom_base.extension_elements[0].children[0].tag, 'bar')
+
+ element_tree = atom_base._to_tree()
+ self.assert_(element_tree.find('{http://ns0.com}foo') is not None)
+ self.assert_(element_tree.find('{http://ns0.com}foo').find(
+ '{http://ns0.com}bar') is not None)
+
+
+class UtfParsingTest(unittest.TestCase):
+
+ def setUp(self):
+ self.test_xml = u"""<?xml version="1.0" encoding="utf-8"?>
+<entry xmlns='http://www.w3.org/2005/Atom'>
+ <id>http://www.google.com/test/id/url</id>
+ <title type='αλφα'>αλφα</title>
+</entry>"""
+
+ def testMemberStringEncoding(self):
+ atom_entry = atom.core.parse(self.test_xml, atom.data.Entry)
+ self.assert_(isinstance(atom_entry.title.type, unicode))
+ self.assertEqual(atom_entry.title.type, u'\u03B1\u03BB\u03C6\u03B1')
+ self.assertEqual(atom_entry.title.text, u'\u03B1\u03BB\u03C6\u03B1')
+
+ # Setting object members to unicode strings is supported.
+ atom_entry.title.type = u'\u03B1\u03BB\u03C6\u03B1'
+ xml = atom_entry.ToString()
+ # The unicode code points should be converted to XML escaped sequences.
+ self.assert_('αλφα' in xml)
+
+ # Make sure that we can use plain text when MEMBER_STRING_ENCODING is utf8
+ atom_entry.title.type = "plain text"
+ atom_entry.title.text = "more text"
+ xml = atom_entry.ToString()
+ self.assert_("plain text" in xml)
+ self.assert_("more text" in xml)
+
+ # Test something else than utf-8
+ atom.core.STRING_ENCODING = 'iso8859_7'
+ atom_entry = atom.core.parse(self.test_xml, atom.data.Entry)
+ self.assert_(atom_entry.title.type == u'\u03B1\u03BB\u03C6\u03B1')
+ self.assert_(atom_entry.title.text == u'\u03B1\u03BB\u03C6\u03B1')
+
+ # Test using unicode strings directly for object members
+ atom_entry = atom.core.parse(self.test_xml, atom.data.Entry)
+ self.assert_(atom_entry.title.type == u'\u03B1\u03BB\u03C6\u03B1')
+ self.assert_(atom_entry.title.text == u'\u03B1\u03BB\u03C6\u03B1')
+
+ # Make sure that we can use plain text when MEMBER_STRING_ENCODING is
+ # unicode
+ atom_entry.title.type = "plain text"
+ atom_entry.title.text = "more text"
+ xml = atom_entry.ToString()
+ self.assert_("plain text" in xml)
+ self.assert_("more text" in xml)
+
+ def testConvertExampleXML(self):
+ GBASE_STRING_ENCODING_ENTRY = """<?xml version='1.0' encoding='UTF-8'?>
+ <entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:gm='http://base.google.com/ns-metadata/1.0'
+ xmlns:g='http://base.google.com/ns/1.0'
+ xmlns:batch='http://schemas.google.com/gdata/batch'>
+ <id>http://www.google.com/base/feeds/snippets/1749</id>
+ <published>2007-12-09T03:13:07.000Z</published>
+ <updated>2008-01-07T03:26:46.000Z</updated>
+ <category scheme='http://base.google.com/categories/itemtypes'
+ term='Products'/>
+ <title type='text'>Digital Camera Cord Fits DSC-R1 S40</title>
+ <content type='html'>SONY \xC2\xB7 Cybershot Digital Camera Usb
+ Cable DESCRIPTION This is a 2.5 USB 2.0 A to Mini B (5 Pin)
+ high quality digital camera cable used for connecting your
+ Sony Digital Cameras and Camcoders. Backward
+ Compatible with USB 2.0, 1.0 and 1.1. Fully ...</content>
+ <link rel='alternate' type='text/html'
+ href='http://adfarm.mediaplex.com/ad/ck/711-5256-8196-2mm'/>
+ <link rel='self' type='application/atom+xml'
+ href='http://www.google.com/base/feeds/snippets/1749'/>
+ <author>
+ <name>eBay</name>
+ </author>
+ <g:item_type type='text'>Products</g:item_type>
+ <g:item_language type='text'>EN</g:item_language>
+ <g:target_country type='text'>US</g:target_country>
+ <g:price type='floatUnit'>0.99 usd</g:price>
+ <g:image_link
+ type='url'>http://www.example.com/pict/27_1.jpg</g:image_link>
+ <g:category type='text'>Cameras & Photo>Digital Camera
+ Accessories>Cables</g:category>
+ <g:category type='text'>Cords & USB Cables</g:category>
+ <g:customer_id type='int'>11729</g:customer_id>
+ <g:id type='text'>270195049057</g:id>
+ <g:expiration_date
+ type='dateTime'>2008-02-06T03:26:46Z</g:expiration_date>
+ </entry>"""
+ try:
+ entry = atom.core.parse(GBASE_STRING_ENCODING_ENTRY,
+ atom.data.Entry)
+ except UnicodeDecodeError:
+ self.fail('Error when converting XML')
+
+
+class VersionedXmlTest(unittest.TestCase):
+
+ def test_monoversioned_parent_with_multiversioned_child(self):
+ v2_rules = atom.data.Entry._get_rules(2)
+ self.assert_('{http://www.w3.org/2007/app}control' in v2_rules[1])
+
+ entry_xml = """<entry xmlns='http://www.w3.org/2005/Atom'>
+ <app:control xmlns:app='http://www.w3.org/2007/app'>
+ <app:draft>yes</app:draft>
+ </app:control>
+ </entry>"""
+
+ entry = e = atom.core.parse(entry_xml, atom.data.Entry, version=2)
+ self.assert_(entry is not None)
+ self.assert_(entry.control is not None)
+ self.assert_(entry.control.draft is not None)
+ self.assertEqual(entry.control.draft.text, 'yes')
+
+ # v1 rules should not parse v2 XML.
+ entry = e = atom.core.parse(entry_xml, atom.data.Entry, version=1)
+ self.assert_(entry is not None)
+ self.assert_(entry.control is None)
+
+ # The default version should be v1.
+ entry = e = atom.core.parse(entry_xml, atom.data.Entry)
+ self.assert_(entry is not None)
+ self.assert_(entry.control is None)
+
+
+class DataModelSanityTest(unittest.TestCase):
+
+ def test_xml_elements(self):
+ conf.check_data_classes(self, [
+ atom.data.Feed, atom.data.Source, atom.data.Logo,
+ atom.data.Control, atom.data.Draft, atom.data.Generator])
+
+
+def suite():
+ return conf.build_suite([AuthorTest, EmailTest, NameTest,
+ ExtensionElementTest, LinkTest, GeneratorTest,
+ TitleTest, SubtitleTest, SummaryTest, IdTest,
+ IconTest, LogoTest, RightsTest, UpdatedTest,
+ PublishedTest, FeedEntryParentTest, EntryTest,
+ ContentEntryParentTest, PreserveUnkownElementTest,
+ FeedTest, LinkFinderTest, AtomBaseTest,
+ UtfParsingTest, VersionedXmlTest,
+ DataModelSanityTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/http_core_test.py b/tests/atom_tests/http_core_test.py
new file mode 100644
index 0000000..474d90c
--- /dev/null
+++ b/tests/atom_tests/http_core_test.py
@@ -0,0 +1,159 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import atom.http_core
+import StringIO
+
+
+class UriTest(unittest.TestCase):
+
+ def test_parse_uri(self):
+ uri = atom.http_core.parse_uri('http://www.google.com/test?q=foo&z=bar')
+ self.assert_(uri.scheme == 'http')
+ self.assert_(uri.host == 'www.google.com')
+ self.assert_(uri.port is None)
+ self.assert_(uri.path == '/test')
+ self.assert_(uri.query == {'z':'bar', 'q':'foo'})
+
+ def test_static_parse_uri(self):
+ uri = atom.http_core.Uri.parse_uri('http://test.com/?token=foo&x=1')
+ self.assertEqual(uri.scheme, 'http')
+ self.assertEqual(uri.host, 'test.com')
+ self.assert_(uri.port is None)
+ self.assertEqual(uri.query, {'token':'foo', 'x':'1'})
+
+ def test_modify_request_no_request(self):
+ uri = atom.http_core.parse_uri('http://www.google.com/test?q=foo&z=bar')
+ request = uri.modify_request()
+ self.assert_(request.uri.scheme == 'http')
+ self.assert_(request.uri.host == 'www.google.com')
+ # If no port was provided, the HttpClient is responsible for determining
+ # the default.
+ self.assert_(request.uri.port is None)
+ self.assert_(request.uri.path.startswith('/test'))
+ self.assertEqual(request.uri.query, {'z': 'bar', 'q': 'foo'})
+ self.assert_(request.method is None)
+ self.assert_(request.headers == {})
+ self.assert_(request._body_parts == [])
+
+ def test_modify_request_http_with_set_port(self):
+ request = atom.http_core.HttpRequest(uri=atom.http_core.Uri(port=8080),
+ method='POST')
+ request.add_body_part('hello', 'text/plain')
+ uri = atom.http_core.parse_uri('//example.com/greet')
+ self.assert_(uri.query == {})
+ self.assert_(uri._get_relative_path() == '/greet')
+ self.assert_(uri.host == 'example.com')
+ self.assert_(uri.port is None)
+
+ uri.ModifyRequest(request)
+ self.assert_(request.uri.host == 'example.com')
+ # If no scheme was provided, the URI will not add one, but the HttpClient
+ # should assume the request is HTTP.
+ self.assert_(request.uri.scheme is None)
+ self.assert_(request.uri.port == 8080)
+ self.assert_(request.uri.path == '/greet')
+ self.assert_(request.method == 'POST')
+ self.assert_(request.headers['Content-Type'] == 'text/plain')
+
+ def test_modify_request_use_default_ssl_port(self):
+ request = atom.http_core.HttpRequest(
+ uri=atom.http_core.Uri(scheme='https'), method='PUT')
+ request.add_body_part('hello', 'text/plain')
+ uri = atom.http_core.parse_uri('/greet')
+ uri.modify_request(request)
+ self.assert_(request.uri.host is None)
+ self.assert_(request.uri.scheme == 'https')
+ # If no port was provided, leave the port as None, it is up to the
+ # HttpClient to set the correct default port.
+ self.assert_(request.uri.port is None)
+ self.assert_(request.uri.path == '/greet')
+ self.assert_(request.method == 'PUT')
+ self.assert_(request.headers['Content-Type'] == 'text/plain')
+ self.assert_(len(request._body_parts) == 1)
+ self.assert_(request._body_parts[0] == 'hello')
+
+ def test_to_string(self):
+ uri = atom.http_core.Uri(host='www.google.com', query={'q':'sippycode'})
+ uri_string = uri._to_string()
+ self.assert_(uri_string == 'http://www.google.com/?q=sippycode')
+
+
+class HttpRequestTest(unittest.TestCase):
+
+ def test_request_with_one_body_part(self):
+ request = atom.http_core.HttpRequest()
+ self.assert_(len(request._body_parts) == 0)
+ self.assert_('Content-Length' not in request.headers)
+ self.assert_(not 'Content-Type' in request.headers)
+ self.assert_(not 'Content-Length' in request.headers)
+ request.add_body_part('this is a test', 'text/plain')
+ self.assert_(len(request._body_parts) == 1)
+ self.assert_(request.headers['Content-Type'] == 'text/plain')
+ self.assert_(request._body_parts[0] == 'this is a test')
+ self.assert_(request.headers['Content-Length'] == str(len(
+ 'this is a test')))
+
+ def test_add_file_without_size(self):
+ virtual_file = StringIO.StringIO('this is a test')
+ request = atom.http_core.HttpRequest()
+ try:
+ request.add_body_part(virtual_file, 'text/plain')
+ self.fail('We should have gotten an UnknownSize error.')
+ except atom.http_core.UnknownSize:
+ pass
+ request.add_body_part(virtual_file, 'text/plain', len('this is a test'))
+ self.assert_(len(request._body_parts) == 1)
+ self.assert_(request.headers['Content-Type'] == 'text/plain')
+ self.assert_(request._body_parts[0].read() == 'this is a test')
+ self.assert_(request.headers['Content-Length'] == str(len(
+ 'this is a test')))
+
+ def test_copy(self):
+ request = atom.http_core.HttpRequest(
+ uri=atom.http_core.Uri(scheme='https', host='www.google.com'),
+ method='POST', headers={'test':'1', 'ok':'yes'})
+ request.add_body_part('body1', 'text/plain')
+ request.add_body_part('<html>body2</html>', 'text/html')
+ copied = request._copy()
+ self.assert_(request.uri.scheme == copied.uri.scheme)
+ self.assert_(request.uri.host == copied.uri.host)
+ self.assert_(request.method == copied.method)
+ self.assert_(request.uri.path == copied.uri.path)
+ self.assert_(request.headers == copied.headers)
+ self.assert_(request._body_parts == copied._body_parts)
+ copied.headers['test'] = '2'
+ copied._body_parts[1] = '<html>body3</html>'
+ self.assert_(request.headers != copied.headers)
+ self.assert_(request._body_parts != copied._body_parts)
+
+
+def suite():
+ return unittest.TestSuite((unittest.makeSuite(UriTest,'test'),
+ unittest.makeSuite(HttpRequestTest,'test')))
+
+
+if __name__ == '__main__':
+ unittest.main()
+
diff --git a/tests/atom_tests/http_interface_test.py b/tests/atom_tests/http_interface_test.py
new file mode 100755
index 0000000..c2f1c45
--- /dev/null
+++ b/tests/atom_tests/http_interface_test.py
@@ -0,0 +1,47 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import unittest
+import atom.http_interface
+import StringIO
+
+
+class HttpResponseTest(unittest.TestCase):
+
+ def testConstructorWithStrings(self):
+ resp = atom.http_interface.HttpResponse(body='Hi there!', status=200,
+ reason='OK', headers={'Content-Length':'9'})
+ self.assertEqual(resp.read(amt=1), 'H')
+ self.assertEqual(resp.read(amt=2), 'i ')
+ self.assertEqual(resp.read(), 'there!')
+ self.assertEqual(resp.read(), '')
+ self.assertEqual(resp.reason, 'OK')
+ self.assertEqual(resp.status, 200)
+ self.assertEqual(resp.getheader('Content-Length'), '9')
+ self.assert_(resp.getheader('Missing') is None)
+ self.assertEqual(resp.getheader('Missing', default='yes'), 'yes')
+
+
+def suite():
+ return unittest.TestSuite((unittest.makeSuite(HttpResponseTest,'test'),))
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/mock_client_test.py b/tests/atom_tests/mock_client_test.py
new file mode 100755
index 0000000..4b798a4
--- /dev/null
+++ b/tests/atom_tests/mock_client_test.py
@@ -0,0 +1,76 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import atom.mock_http
+import atom.http
+
+
+class MockHttpClientUnitTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = atom.mock_http.MockHttpClient()
+
+ def testRepondToGet(self):
+ mock_response = atom.http_interface.HttpResponse(body='Hooray!',
+ status=200, reason='OK')
+ self.client.add_response(mock_response, 'GET',
+ 'http://example.com/hooray')
+
+ response = self.client.request('GET', 'http://example.com/hooray')
+
+ self.assertEquals(len(self.client.recordings), 1)
+ self.assertEquals(response.status, 200)
+ self.assertEquals(response.read(), 'Hooray!')
+
+ def testRecordResponse(self):
+ # Turn on pass-through record mode.
+ self.client.real_client = atom.http.ProxiedHttpClient()
+ live_response = self.client.request('GET',
+ 'http://www.google.com/base/feeds/snippets?max-results=1')
+ live_response_body = live_response.read()
+ self.assertEquals(live_response.status, 200)
+ self.assertEquals(live_response_body.startswith('<?xml'), True)
+
+ # Requery for the now canned data.
+ self.client.real_client = None
+ canned_response = self.client.request('GET',
+ 'http://www.google.com/base/feeds/snippets?max-results=1')
+
+ # The canned response should be the stored response.
+ canned_response_body = canned_response.read()
+ self.assertEquals(canned_response.status, 200)
+ self.assertEquals(canned_response_body, live_response_body)
+
+ def testUnrecordedRequest(self):
+ try:
+ self.client.request('POST', 'http://example.org')
+ self.fail()
+ except atom.mock_http.NoRecordingFound:
+ pass
+
+
+def suite():
+ return unittest.TestSuite(
+ (unittest.makeSuite(MockHttpClientUnitTest,'test'),))
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/mock_http_core_test.py b/tests/atom_tests/mock_http_core_test.py
new file mode 100755
index 0000000..21c2df4
--- /dev/null
+++ b/tests/atom_tests/mock_http_core_test.py
@@ -0,0 +1,199 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+# This test may make an actual HTTP request.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import StringIO
+import os.path
+import atom.mock_http_core
+import atom.http_core
+
+
+class EchoClientTest(unittest.TestCase):
+
+ def test_echo_response(self):
+ client = atom.mock_http_core.EchoHttpClient()
+ # Send a bare-bones POST request.
+ request = atom.http_core.HttpRequest(method='POST',
+ uri=atom.http_core.Uri(host='www.jeffscudder.com', path='/'))
+ request.add_body_part('hello world!', 'text/plain')
+ response = client.request(request)
+ self.assert_(response.getheader('Echo-Host') == 'www.jeffscudder.com:None')
+ self.assert_(response.getheader('Echo-Uri') == '/')
+ self.assert_(response.getheader('Echo-Scheme') is None)
+ self.assert_(response.getheader('Echo-Method') == 'POST')
+ self.assert_(response.getheader('Content-Length') == str(len(
+ 'hello world!')))
+ self.assert_(response.getheader('Content-Type') == 'text/plain')
+ self.assert_(response.read() == 'hello world!')
+
+ # Test a path of None should default to /
+ request = atom.http_core.HttpRequest(method='POST',
+ uri=atom.http_core.Uri(host='www.jeffscudder.com', path=None))
+ response = client.request(request)
+ self.assert_(response.getheader('Echo-Host') == 'www.jeffscudder.com:None')
+ self.assert_(response.getheader('Echo-Method') == 'POST')
+ self.assert_(response.getheader('Echo-Uri') == '/')
+
+ # Send a multipart request.
+ request = atom.http_core.HttpRequest(method='POST',
+ uri=atom.http_core.Uri(scheme='https', host='www.jeffscudder.com',
+ port=8080, path='/multipart',
+ query={'test': 'true', 'happy': 'yes'}),
+ headers={'Authorization':'Test xyzzy', 'Testing':'True'})
+ request.add_body_part('start', 'text/plain')
+ request.add_body_part(StringIO.StringIO('<html><body>hi</body></html>'),
+ 'text/html', len('<html><body>hi</body></html>'))
+ request.add_body_part('alert("Greetings!")', 'text/javascript')
+ response = client.request(request)
+ self.assert_(response.getheader('Echo-Host') == 'www.jeffscudder.com:8080')
+ self.assert_(
+ response.getheader('Echo-Uri') == '/multipart?test=true&happy=yes')
+ self.assert_(response.getheader('Echo-Scheme') == 'https')
+ self.assert_(response.getheader('Echo-Method') == 'POST')
+ self.assert_(response.getheader('Content-Type') == (
+ 'multipart/related; boundary="%s"' % (atom.http_core.MIME_BOUNDARY,)))
+ expected_body = ('Media multipart posting'
+ '\r\n--%s\r\n'
+ 'Content-Type: text/plain\r\n\r\n'
+ 'start'
+ '\r\n--%s\r\n'
+ 'Content-Type: text/html\r\n\r\n'
+ '<html><body>hi</body></html>'
+ '\r\n--%s\r\n'
+ 'Content-Type: text/javascript\r\n\r\n'
+ 'alert("Greetings!")'
+ '\r\n--%s--') % (atom.http_core.MIME_BOUNDARY,
+ atom.http_core.MIME_BOUNDARY, atom.http_core.MIME_BOUNDARY,
+ atom.http_core.MIME_BOUNDARY,)
+ self.assert_(response.read() == expected_body)
+ self.assert_(response.getheader('Content-Length') == str(
+ len(expected_body)))
+
+
+class MockHttpClientTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = atom.mock_http_core.MockHttpClient()
+
+ def test_respond_with_recording(self):
+ request = atom.http_core.HttpRequest(method='GET')
+ atom.http_core.parse_uri('http://www.google.com/').modify_request(request)
+ self.client.add_response(request, 200, 'OK', body='Testing')
+ response = self.client.request(request)
+ self.assert_(response.status == 200)
+ self.assert_(response.reason == 'OK')
+ self.assert_(response.read() == 'Testing')
+
+ def test_save_and_load_recordings(self):
+ request = atom.http_core.HttpRequest(method='GET')
+ atom.http_core.parse_uri('http://www.google.com/').modify_request(request)
+ self.client.add_response(request, 200, 'OK', body='Testing')
+ response = self.client.request(request)
+ self.client._save_recordings('test_save_and_load_recordings')
+ self.client._recordings = []
+ try:
+ response = self.client.request(request)
+ self.fail('There should be no recording for this request.')
+ except atom.mock_http_core.NoRecordingFound:
+ pass
+ self.client._load_recordings('test_save_and_load_recordings')
+ response = self.client.request(request)
+ self.assert_(response.status == 200)
+ self.assert_(response.reason == 'OK')
+ self.assert_(response.read() == 'Testing')
+
+ def test_use_recordings(self):
+ request = atom.http_core.HttpRequest(method='GET')
+ atom.http_core.parse_uri('http://www.google.com/').modify_request(request)
+ self.client._load_or_use_client('test_use_recordings',
+ atom.http_core.HttpClient())
+ response = self.client.request(request)
+ if self.client.real_client:
+ self.client._save_recordings('test_use_recordings')
+ self.assert_(response.status in (200, 302))
+ self.assert_(response.reason in ('OK', 'Found'))
+ self.assert_(response.getheader('server') == 'gws')
+ body = response.read()
+ self.assert_(body.startswith('<!doctype html>') or
+ body.startswith('<HTML>'))
+
+ def test_match_request(self):
+ x = atom.http_core.HttpRequest('http://example.com/', 'GET')
+ y = atom.http_core.HttpRequest('http://example.com/', 'GET')
+ self.assert_(atom.mock_http_core._match_request(x, y))
+ y = atom.http_core.HttpRequest('http://example.com/', 'POST')
+ self.assert_(not atom.mock_http_core._match_request(x, y))
+ y = atom.http_core.HttpRequest('http://example.com/1', 'GET')
+ self.assert_(not atom.mock_http_core._match_request(x, y))
+ y = atom.http_core.HttpRequest('http://example.com/?gsessionid=1', 'GET')
+ self.assert_(not atom.mock_http_core._match_request(x, y))
+ y = atom.http_core.HttpRequest('http://example.com/?start_index=1', 'GET')
+ self.assert_(atom.mock_http_core._match_request(x, y))
+ x = atom.http_core.HttpRequest('http://example.com/?gsessionid=1', 'GET')
+ y = atom.http_core.HttpRequest('http://example.com/?gsessionid=1', 'GET')
+ self.assert_(atom.mock_http_core._match_request(x, y))
+ y = atom.http_core.HttpRequest('http://example.com/?gsessionid=2', 'GET')
+ self.assert_(not atom.mock_http_core._match_request(x, y))
+ y = atom.http_core.HttpRequest('http://example.com/', 'GET')
+ self.assert_(not atom.mock_http_core._match_request(x, y))
+
+ def test_use_named_sessions(self):
+ self.client._delete_recordings('mock_http_test.test_use_named_sessions')
+ self.client.use_cached_session('mock_http_test.test_use_named_sessions',
+ atom.mock_http_core.EchoHttpClient())
+ request = atom.http_core.HttpRequest('http://example.com', 'GET')
+ response = self.client.request(request)
+ self.assertEqual(response.getheader('Echo-Method'), 'GET')
+ self.assertEqual(response.getheader('Echo-Host'), 'example.com:None')
+ # We will insert a Cache-Marker header to indicate that this is a
+ # recorded response, but initially it should not be present.
+ self.assertEqual(response.getheader('Cache-Marker'), None)
+ # Modify the recorded response to allow us to identify a cached result
+ # from an echoed result. We need to be able to check to see if this
+ # came from a recording.
+ self.assert_('Cache-Marker' not in self.client._recordings[0][1]._headers)
+ self.client._recordings[0][1]._headers['Cache-Marker'] = '1'
+ self.assert_('Cache-Marker' in self.client._recordings[0][1]._headers)
+ # Save the recorded responses.
+ self.client.close_session()
+
+ # Create a new client, and have it use the recorded session.
+ client = atom.mock_http_core.MockHttpClient()
+ client.use_cached_session('mock_http_test.test_use_named_sessions',
+ atom.mock_http_core.EchoHttpClient())
+ # Make the same request, which should use the recorded result.
+ response = client.request(request)
+ self.assertEqual(response.getheader('Echo-Method'), 'GET')
+ self.assertEqual(response.getheader('Echo-Host'), 'example.com:None')
+ # We should now see the cache marker since the response is replayed.
+ self.assertEqual(response.getheader('Cache-Marker'), '1')
+
+
+def suite():
+ return unittest.TestSuite((unittest.makeSuite(MockHttpClientTest, 'test'),
+ unittest.makeSuite(EchoClientTest, 'test')))
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/mock_http_test.py b/tests/atom_tests/mock_http_test.py
new file mode 100755
index 0000000..d7d096d
--- /dev/null
+++ b/tests/atom_tests/mock_http_test.py
@@ -0,0 +1,74 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import atom.mock_http
+import atom.http
+
+
+class MockHttpClientUnitTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = atom.mock_http.MockHttpClient()
+
+ def testRepondToGet(self):
+ mock_response = atom.http_interface.HttpResponse(body='Hooray!',
+ status=200, reason='OK')
+ self.client.add_response(mock_response, 'GET',
+ 'http://example.com/hooray')
+
+ response = self.client.request('GET', 'http://example.com/hooray')
+
+ self.assertEquals(len(self.client.recordings), 1)
+ self.assertEquals(response.status, 200)
+ self.assertEquals(response.read(), 'Hooray!')
+
+ def testRecordResponse(self):
+ # Turn on pass-through record mode.
+ self.client.real_client = atom.http.ProxiedHttpClient()
+ live_response = self.client.request('GET',
+ 'http://www.google.com/base/feeds/snippets?max-results=1')
+ live_response_body = live_response.read()
+ self.assertEquals(live_response.status, 200)
+ self.assertEquals(live_response_body.startswith('<?xml'), True)
+
+ # Requery for the now canned data.
+ self.client.real_client = None
+ canned_response = self.client.request('GET',
+ 'http://www.google.com/base/feeds/snippets?max-results=1')
+
+ # The canned response should be the stored response.
+ canned_response_body = canned_response.read()
+ self.assertEquals(canned_response.status, 200)
+ self.assertEquals(canned_response_body, live_response_body)
+
+ def testUnrecordedRequest(self):
+ try:
+ self.client.request('POST', 'http://example.org')
+ self.fail()
+ except atom.mock_http.NoRecordingFound:
+ pass
+
+def suite():
+ return unittest.TestSuite(
+ (unittest.makeSuite(MockHttpClientUnitTest,'test'),))
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/mock_server_test.py b/tests/atom_tests/mock_server_test.py
new file mode 100755
index 0000000..a4b837e
--- /dev/null
+++ b/tests/atom_tests/mock_server_test.py
@@ -0,0 +1,97 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import unittest
+import gdata.service
+import atom.mock_service
+
+
+gdata.service.http_request_handler = atom.mock_service
+
+
+class MockRequestTest(unittest.TestCase):
+
+ def setUp(self):
+ self.request_thumbprint = atom.mock_service.MockRequest('GET',
+ 'http://www.google.com',
+ extra_headers={'Header1':'a', 'Header2':'b'})
+
+ def testIsMatch(self):
+ matching_request = atom.mock_service.MockRequest('GET',
+ 'http://www.google.com', extra_headers={'Header1':'a',
+ 'Header2':'b', 'Header3':'c'})
+ bad_url = atom.mock_service.MockRequest('GET', 'http://example.com',
+ extra_headers={'Header1':'a', 'Header2':'b', 'Header3':'c'})
+ # Should match because we don't check headers at the moment.
+ bad_header = atom.mock_service.MockRequest('GET',
+ 'http://www.google.com', extra_headers={'Header1':'a',
+ 'Header2':'1', 'Header3':'c'})
+ bad_verb = atom.mock_service.MockRequest('POST', 'http://www.google.com',
+ data='post data', extra_headers={'Header1':'a', 'Header2':'b'})
+ self.assertEquals(self.request_thumbprint.IsMatch(matching_request), True)
+ self.assertEquals(self.request_thumbprint.IsMatch(bad_url), False)
+ self.assertEquals(self.request_thumbprint.IsMatch(bad_header), True)
+ self.assertEquals(self.request_thumbprint.IsMatch(bad_verb), False)
+
+
+class HttpRequestTest(unittest.TestCase):
+
+ def setUp(self):
+ atom.mock_service.recordings = []
+ self.client = gdata.service.GDataService()
+
+ def testSimpleRecordedGet(self):
+ recorded_request = atom.mock_service.MockRequest('GET', 'http://example.com/')
+ recorded_response = atom.mock_service.MockHttpResponse('Got it', 200,
+ 'OK')
+ # Add a tuple mapping the mock request to the mock response
+ atom.mock_service.recordings.append((recorded_request, recorded_response))
+ # Try a couple of GET requests which should match the recorded request.
+ response = self.client.Get('http://example.com/', converter=str)
+ self.assertEquals(response, 'Got it')
+
+ self.client.server = 'example.com'
+ raw_response = self.client.handler.HttpRequest(self.client, 'GET', None,
+ '/')
+ self.assertEquals(raw_response.read(), 'Got it')
+ self.assertEquals(raw_response.status, 200)
+ self.assertEquals(raw_response.reason, 'OK')
+
+
+class RecordRealHttpRequestsTest(unittest.TestCase):
+
+ def testRecordAndReuseResponse(self):
+ client = gdata.service.GDataService()
+ client.server = 'www.google.com'
+ atom.mock_service.recordings = []
+ atom.mock_service.real_request_handler = atom.service
+
+ # Record a response
+ real_response = atom.mock_service.HttpRequest(client, 'GET', None, 'http://www.google.com/')
+ # Enter 'replay' mode
+ atom.mock_service.real_request_handler = None
+ mock_response = atom.mock_service.HttpRequest(client, 'GET', None, 'http://www.google.com/')
+ self.assertEquals(real_response.reason, mock_response.reason)
+ self.assertEquals(real_response.status, mock_response.status)
+ self.assertEquals(real_response.read(), mock_response.read())
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/service_test.py b/tests/atom_tests/service_test.py
new file mode 100755
index 0000000..be3b607
--- /dev/null
+++ b/tests/atom_tests/service_test.py
@@ -0,0 +1,173 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+import os
+import unittest
+import atom.service
+import atom.mock_http_core
+import gdata.test_config as conf
+
+class AtomServiceUnitTest(unittest.TestCase):
+
+ def testBuildUriWithNoParams(self):
+ x = atom.service.BuildUri('/base/feeds/snippets')
+ self.assert_(x == '/base/feeds/snippets')
+
+ def testBuildUriWithParams(self):
+ # Add parameters to a URI
+ x = atom.service.BuildUri('/base/feeds/snippets', url_params={'foo': 'bar',
+ 'bq': 'digital camera'})
+ self.assert_(x == '/base/feeds/snippets?foo=bar&bq=digital+camera')
+ self.assert_(x.startswith('/base/feeds/snippets'))
+ self.assert_(x.count('?') == 1)
+ self.assert_(x.count('&') == 1)
+ self.assert_(x.index('?') < x.index('&'))
+ self.assert_(x.index('bq=digital+camera') != -1)
+
+ # Add parameters to a URI that already has parameters
+ x = atom.service.BuildUri('/base/feeds/snippets?bq=digital+camera',
+ url_params={'foo': 'bar', 'max-results': '250'})
+ self.assert_(x.startswith('/base/feeds/snippets?bq=digital+camera'))
+ self.assert_(x.count('?') == 1)
+ self.assert_(x.count('&') == 2)
+ self.assert_(x.index('?') < x.index('&'))
+ self.assert_(x.index('max-results=250') != -1)
+ self.assert_(x.index('foo=bar') != -1)
+
+
+ def testBuildUriWithoutParameterEscaping(self):
+ x = atom.service.BuildUri('/base/feeds/snippets',
+ url_params={'foo': ' bar', 'bq': 'digital camera'},
+ escape_params=False)
+ self.assert_(x.index('foo= bar') != -1)
+ self.assert_(x.index('bq=digital camera') != -1)
+
+ def testParseHttpUrl(self):
+ atom_service = atom.service.AtomService('code.google.com')
+ self.assertEquals(atom_service.server, 'code.google.com')
+ (host, port, ssl, path) = atom.service.ProcessUrl(atom_service,
+ 'http://www.google.com/service/subservice?name=value')
+
+ self.assertEquals(ssl, False)
+ self.assertEquals(host, 'www.google.com')
+ self.assertEquals(port, 80)
+ self.assertEquals(path, '/service/subservice?name=value')
+
+ def testParseHttpUrlWithPort(self):
+ atom_service = atom.service.AtomService('code.google.com')
+ self.assertEquals(atom_service.server, 'code.google.com')
+ (host, port, ssl, path) = atom.service.ProcessUrl(atom_service,
+ 'http://www.google.com:12/service/subservice?name=value&newname=newvalue')
+
+ self.assertEquals(ssl, False)
+ self.assertEquals(host, 'www.google.com')
+ self.assertEquals(port, 12)
+ self.assert_(path.startswith('/service/subservice?'))
+ self.assert_(path.find('name=value') >= len('/service/subservice?'))
+ self.assert_(path.find('newname=newvalue') >= len('/service/subservice?'))
+
+ def testParseHttpsUrl(self):
+ atom_service = atom.service.AtomService('code.google.com')
+ self.assertEquals(atom_service.server, 'code.google.com')
+ (host, port, ssl, path) = atom.service.ProcessUrl(atom_service,
+ 'https://www.google.com/service/subservice?name=value&newname=newvalue')
+
+ self.assertEquals(ssl, True)
+ self.assertEquals(host, 'www.google.com')
+ self.assertEquals(port, 443)
+ self.assert_(path.startswith('/service/subservice?'))
+ self.assert_(path.find('name=value') >= len('/service/subservice?'))
+ self.assert_(path.find('newname=newvalue') >= len('/service/subservice?'))
+
+ def testParseHttpsUrlWithPort(self):
+ atom_service = atom.service.AtomService('code.google.com')
+ self.assertEquals(atom_service.server, 'code.google.com')
+ (host, port, ssl, path) = atom.service.ProcessUrl(atom_service,
+ 'https://www.google.com:13981/service/subservice?name=value&newname=newvalue')
+
+ self.assertEquals(ssl, True)
+ self.assertEquals(host, 'www.google.com')
+ self.assertEquals(port, 13981)
+ self.assert_(path.startswith('/service/subservice?'))
+ self.assert_(path.find('name=value') >= len('/service/subservice?'))
+ self.assert_(path.find('newname=newvalue') >= len('/service/subservice?'))
+
+ def testSetBasicAuth(self):
+ client = atom.service.AtomService()
+ client.UseBasicAuth('foo', 'bar')
+ token = client.token_store.find_token('http://')
+ self.assert_(isinstance(token, atom.service.BasicAuthToken))
+ self.assertEquals(token.auth_header, 'Basic Zm9vOmJhcg==')
+ client.UseBasicAuth('','')
+ token = client.token_store.find_token('http://')
+ self.assert_(isinstance(token, atom.service.BasicAuthToken))
+ self.assertEquals(token.auth_header, 'Basic Og==')
+
+ def testProcessUrlWithStringForService(self):
+ (server, port, ssl, uri) = atom.service.ProcessUrl(
+ service='www.google.com', url='/base/feeds/items')
+ self.assertEquals(server, 'www.google.com')
+ self.assertEquals(port, 80)
+ self.assertEquals(ssl, False)
+ self.assert_(uri.startswith('/base/feeds/items'))
+
+ client = atom.service.AtomService()
+ client.server = 'www.google.com'
+ client.ssl = True
+ (server, port, ssl, uri) = atom.service.ProcessUrl(
+ service=client, url='/base/feeds/items')
+ self.assertEquals(server, 'www.google.com')
+ self.assertEquals(ssl, True)
+ self.assert_(uri.startswith('/base/feeds/items'))
+
+ (server, port, ssl, uri) = atom.service.ProcessUrl(service=None,
+ url='https://www.google.com/base/feeds/items')
+ self.assertEquals(server, 'www.google.com')
+ self.assertEquals(port, 443)
+ self.assertEquals(ssl, True)
+ self.assert_(uri.startswith('/base/feeds/items'))
+
+ def testHostHeaderContainsNonDefaultPort(self):
+ client = atom.service.AtomService()
+ client.http_client.v2_http_client = atom.mock_http_core.EchoHttpClient()
+ response = client.Get('http://example.com')
+ self.assertEqual(response.getheader('Echo-Host'), 'example.com:None')
+ response = client.Get('https://example.com')
+ self.assertEqual(response.getheader('Echo-Host'), 'example.com:None')
+ response = client.Get('https://example.com:8080')
+ self.assertEqual(response.getheader('Echo-Host'), 'example.com:8080')
+ response = client.Get('http://example.com:1234')
+ self.assertEqual(response.getheader('Echo-Host'), 'example.com:1234')
+
+ def testBadHttpsProxyRaisesRealException(self):
+ """Test that real exceptions are raised when there is an error connecting to
+ a host with an https proxy
+ """
+ client = atom.service.AtomService(server='example.com')
+ client.server = 'example.com'
+ os.environ['https_proxy'] = 'http://example.com'
+ self.assertRaises(atom.http.ProxyError,
+ atom.service.PrepareConnection, client, 'https://example.com')
+
+
+def suite():
+ return conf.build_suite([AtomServiceUnitTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/token_store_test.py b/tests/atom_tests/token_store_test.py
new file mode 100755
index 0000000..22af039
--- /dev/null
+++ b/tests/atom_tests/token_store_test.py
@@ -0,0 +1,78 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import atom.token_store
+import atom.http_interface
+import atom.service
+import atom.url
+
+class TokenStoreTest(unittest.TestCase):
+
+ def setUp(self):
+ self.token = atom.service.BasicAuthToken('aaa1', scopes=[
+ 'http://example.com/', 'http://example.org'])
+ self.tokens = atom.token_store.TokenStore()
+ self.tokens.add_token(self.token)
+
+ def testAddAndFindTokens(self):
+ self.assert_(self.tokens.find_token('http://example.com/') == self.token)
+ self.assert_(self.tokens.find_token('http://example.org/') == self.token)
+ self.assert_(self.tokens.find_token('http://example.org/foo?ok=1') == (
+ self.token))
+ self.assert_(isinstance(self.tokens.find_token('http://example.net/'),
+ atom.http_interface.GenericToken))
+ self.assert_(isinstance(self.tokens.find_token('example.com/'),
+ atom.http_interface.GenericToken))
+
+ def testFindTokenUsingMultipleUrls(self):
+ self.assert_(self.tokens.find_token(
+ 'http://example.com/') == self.token)
+ self.assert_(self.tokens.find_token(
+ 'http://example.org/bar') == self.token)
+ self.assert_(isinstance(self.tokens.find_token(''),
+ atom.http_interface.GenericToken))
+ self.assert_(isinstance(self.tokens.find_token(
+ 'http://example.net/'),
+ atom.http_interface.GenericToken))
+
+ def testFindTokenWithPartialScopes(self):
+ token = atom.service.BasicAuthToken('aaa1',
+ scopes=[atom.url.Url(host='www.example.com', path='/foo'),
+ atom.url.Url(host='www.example.net')])
+ token_store = atom.token_store.TokenStore()
+ token_store.add_token(token)
+ self.assert_(token_store.find_token(
+ 'http://www.example.com/foobar') == token)
+ self.assert_(token_store.find_token(
+ 'https://www.example.com:443/foobar') == token)
+ self.assert_(token_store.find_token(
+ 'http://www.example.net/xyz') == token)
+ self.assert_(token_store.find_token('http://www.example.org/') != token)
+ self.assert_(isinstance(token_store.find_token('http://example.org/'),
+ atom.http_interface.GenericToken))
+
+
+def suite():
+ return unittest.TestSuite((unittest.makeSuite(TokenStoreTest,'test'),))
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/atom_tests/url_test.py b/tests/atom_tests/url_test.py
new file mode 100755
index 0000000..b1c6567
--- /dev/null
+++ b/tests/atom_tests/url_test.py
@@ -0,0 +1,96 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import atom.url
+import gdata.test_config as conf
+
+
+class UrlTest(unittest.TestCase):
+
+ def testParseUrl(self):
+ url = atom.url.parse_url('http://www.google.com/calendar/feeds')
+ self.assert_(url.protocol == 'http')
+ self.assert_(url.port is None)
+ self.assert_(url.host == 'www.google.com')
+ self.assert_(url.path == '/calendar/feeds')
+ self.assert_(url.params == {})
+
+ url = atom.url.parse_url('http://example.com:6091/calendar/feeds')
+ self.assert_(url.protocol == 'http')
+ self.assert_(url.host == 'example.com')
+ self.assert_(url.port == '6091')
+ self.assert_(url.path == '/calendar/feeds')
+ self.assert_(url.params == {})
+
+ url = atom.url.parse_url('/calendar/feeds?foo=bar')
+ self.assert_(url.protocol is None)
+ self.assert_(url.host is None)
+ self.assert_(url.path == '/calendar/feeds')
+ self.assert_(len(url.params.keys()) == 1)
+ self.assert_('foo' in url.params)
+ self.assert_(url.params['foo'] == 'bar')
+
+ url = atom.url.parse_url('/calendar/feeds?my+foo=bar%3Dx')
+ self.assert_(len(url.params.keys()) == 1)
+ self.assert_('my foo' in url.params)
+ self.assert_(url.params['my foo'] == 'bar=x')
+
+ def testUrlToString(self):
+ url = atom.url.Url(port=80)
+ url.host = 'example.com'
+ self.assert_(str(url), '//example.com:80')
+
+ url = atom.url.Url(protocol='http', host='example.com', path='/feed')
+ url.params['has spaces'] = 'sneaky=values?&!'
+ self.assert_(url.to_string() == (
+ 'http://example.com/feed?has+spaces=sneaky%3Dvalues%3F%26%21'))
+
+ def testGetRequestUri(self):
+ url = atom.url.Url(protocol='http', host='example.com', path='/feed')
+ url.params['has spaces'] = 'sneaky=values?&!'
+ self.assert_(url.get_request_uri() == (
+ '/feed?has+spaces=sneaky%3Dvalues%3F%26%21'))
+ self.assert_(url.get_param_string() == (
+ 'has+spaces=sneaky%3Dvalues%3F%26%21'))
+
+ def testComparistons(self):
+ url1 = atom.url.Url(protocol='http', host='example.com', path='/feed',
+ params={'x':'1', 'y':'2'})
+ url2 = atom.url.Url(host='example.com', port=80, path='/feed',
+ params={'y':'2', 'x':'1'})
+ self.assertEquals(url1, url2)
+ url3 = atom.url.Url(host='example.com', port=81, path='/feed',
+ params={'x':'1', 'y':'2'})
+ self.assert_(url1 != url3)
+ self.assert_(url2 != url3)
+ url4 = atom.url.Url(protocol='ftp', host='example.com', path='/feed',
+ params={'x':'1', 'y':'2'})
+ self.assert_(url1 != url4)
+ self.assert_(url2 != url4)
+ self.assert_(url3 != url4)
+
+
+def suite():
+ return conf.build_suite([UrlTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/coverage.py b/tests/coverage.py
new file mode 100644
index 0000000..b7b24c7
--- /dev/null
+++ b/tests/coverage.py
@@ -0,0 +1,601 @@
+#!/usr/bin/env python
+#
+# Perforce Defect Tracking Integration Project
+# <http://www.ravenbrook.com/project/p4dti/>
+#
+# COVERAGE.PY -- COVERAGE TESTING
+#
+# Gareth Rees, Ravenbrook Limited, 2001-12-04
+#
+#
+# 1. INTRODUCTION
+#
+# This module provides coverage testing for Python code.
+#
+# The intended readership is all Python developers.
+#
+# This document is not confidential.
+#
+# See [GDR 2001-12-04a] for the command-line interface, programmatic
+# interface and limitations. See [GDR 2001-12-04b] for requirements and
+# design.
+
+"""Usage:
+
+coverage.py -x MODULE.py [ARG1 ARG2 ...]
+ Execute module, passing the given command-line arguments, collecting
+ coverage data.
+
+coverage.py -e
+ Erase collected coverage data.
+
+coverage.py -r [-m] FILE1 FILE2 ...
+ Report on the statement coverage for the given files. With the -m
+ option, show line numbers of the statements that weren't executed.
+
+coverage.py -a [-d dir] FILE1 FILE2 ...
+ Make annotated copies of the given files, marking statements that
+ are executed with > and statements that are missed with !. With
+ the -d option, make the copies in that directory. Without the -d
+ option, make each copy in the same directory as the original.
+
+Coverage data is saved in the file .coverage by default. Set the
+COVERAGE_FILE environment variable to save it somewhere else."""
+
+import os
+import re
+import string
+import sys
+import types
+
+
+# 2. IMPLEMENTATION
+#
+# This uses the "singleton" pattern.
+#
+# The word "morf" means a module object (from which the source file can
+# be deduced by suitable manipulation of the __file__ attribute) or a
+# filename.
+#
+# When we generate a coverage report we have to canonicalize every
+# filename in the coverage dictionary just in case it refers to the
+# module we are reporting on. It seems a shame to throw away this
+# information so the data in the coverage dictionary is transferred to
+# the 'cexecuted' dictionary under the canonical filenames.
+#
+# The coverage dictionary is called "c" and the trace function "t". The
+# reason for these short names is that Python looks up variables by name
+# at runtime and so execution time depends on the length of variables!
+# In the bottleneck of this application it's appropriate to abbreviate
+# names to increase speed.
+
+# A dictionary with an entry for (Python source file name, line number
+# in that file) if that line has been executed.
+c = {}
+
+# t(f, x, y). This method is passed to sys.settrace as a trace
+# function. See [van Rossum 2001-07-20b, 9.2] for an explanation of
+# sys.settrace and the arguments and return value of the trace function.
+# See [van Rossum 2001-07-20a, 3.2] for a description of frame and code
+# objects.
+
+def t(f, x, y):
+ c[(f.f_code.co_filename, f.f_lineno)] = 1
+ return t
+
+the_coverage = None
+
+class coverage:
+ error = "coverage error"
+
+ # Name of the cache file (unless environment variable is set).
+ cache_default = ".coverage"
+
+ # Environment variable naming the cache file.
+ cache_env = "COVERAGE_FILE"
+
+ # A map from canonical Python source file name to a dictionary in
+ # which there's an entry for each line number that has been
+ # executed.
+ cexecuted = {}
+
+ # Cache of results of calling the analysis() method, so that you can
+ # specify both -r and -a without doing double work.
+ analysis_cache = {}
+
+ # Cache of results of calling the canonical_filename() method, to
+ # avoid duplicating work.
+ canonical_filename_cache = {}
+
+ def __init__(self):
+ global the_coverage
+ if the_coverage:
+ raise self.error, "Only one coverage object allowed."
+ self.cache = os.environ.get(self.cache_env, self.cache_default)
+ self.restore()
+ self.analysis_cache = {}
+
+ def help(self, error=None):
+ if error:
+ print error
+ print
+ print __doc__
+ sys.exit(1)
+
+ def command_line(self):
+ import getopt
+ settings = {}
+ optmap = {
+ '-a': 'annotate',
+ '-d:': 'directory=',
+ '-e': 'erase',
+ '-h': 'help',
+ '-i': 'ignore-errors',
+ '-m': 'show-missing',
+ '-r': 'report',
+ '-x': 'execute',
+ }
+ short_opts = string.join(map(lambda o: o[1:], optmap.keys()), '')
+ long_opts = optmap.values()
+ options, args = getopt.getopt(sys.argv[1:], short_opts,
+ long_opts)
+ for o, a in options:
+ if optmap.has_key(o):
+ settings[optmap[o]] = 1
+ elif optmap.has_key(o + ':'):
+ settings[optmap[o + ':']] = a
+ elif o[2:] in long_opts:
+ settings[o[2:]] = 1
+ elif o[2:] + '=' in long_opts:
+ settings[o[2:]] = a
+ else:
+ self.help("Unknown option: '%s'." % o)
+ if settings.get('help'):
+ self.help()
+ for i in ['erase', 'execute']:
+ for j in ['annotate', 'report']:
+ if settings.get(i) and settings.get(j):
+ self.help("You can't specify the '%s' and '%s' "
+ "options at the same time." % (i, j))
+ args_needed = (settings.get('execute')
+ or settings.get('annotate')
+ or settings.get('report'))
+ action = settings.get('erase') or args_needed
+ if not action:
+ self.help("You must specify at least one of -e, -x, -r, "
+ "or -a.")
+ if not args_needed and args:
+ self.help("Unexpected arguments %s." % args)
+ if settings.get('erase'):
+ self.erase()
+ if settings.get('execute'):
+ if not args:
+ self.help("Nothing to do.")
+ sys.argv = args
+ self.start()
+ import __main__
+ # When Python starts a script, sys.path[0] is the directory
+ # in which the Python script was found. So when we run a
+ # script, change sys.path so that it matches what the script
+ # would have found if it had been run normally.
+ sys.path[0] = os.path.dirname(sys.argv[0])
+ execfile(sys.argv[0], __main__.__dict__)
+ if not args:
+ args = self.cexecuted.keys()
+ ignore_errors = settings.get('ignore-errors')
+ show_missing = settings.get('show-missing')
+ directory = settings.get('directory=')
+ if settings.get('report'):
+ self.report(args, show_missing, ignore_errors)
+ if settings.get('annotate'):
+ self.annotate(args, directory, ignore_errors)
+
+ def start(self):
+ sys.settrace(t)
+
+ def stop(self):
+ sys.settrace(None)
+
+ def erase(self):
+ global c
+ c = {}
+ self.analysis_cache = {}
+ self.cexecuted = {}
+ if os.path.exists(self.cache):
+ os.remove(self.cache)
+
+ # save(). Save coverage data to the coverage cache.
+
+ def save(self):
+ self.canonicalize_filenames()
+ cache = open(self.cache, 'wb')
+ import marshal
+ marshal.dump(self.cexecuted, cache)
+ cache.close()
+
+ # restore(). Restore coverage data from the coverage cache (if it
+ # exists).
+
+ def restore(self):
+ global c
+ c = {}
+ self.cexecuted = {}
+ if not os.path.exists(self.cache):
+ return
+ try:
+ cache = open(self.cache, 'rb')
+ import marshal
+ cexecuted = marshal.load(cache)
+ cache.close()
+ if isinstance(cexecuted, types.DictType):
+ self.cexecuted = cexecuted
+ except:
+ pass
+
+ # canonical_filename(filename). Return a canonical filename for the
+ # file (that is, an absolute path with no redundant components and
+ # normalized case). See [GDR 2001-12-04b, 3.3].
+
+ def canonical_filename(self, filename):
+ if not self.canonical_filename_cache.has_key(filename):
+ f = filename
+ if os.path.isabs(f) and not os.path.exists(f):
+ f = os.path.basename(f)
+ if not os.path.isabs(f):
+ for path in [os.curdir] + sys.path:
+ g = os.path.join(path, f)
+ if os.path.exists(g):
+ f = g
+ break
+ cf = os.path.normcase(os.path.abspath(f))
+ self.canonical_filename_cache[filename] = cf
+ return self.canonical_filename_cache[filename]
+
+ # canonicalize_filenames(). Copy results from "executed" to
+ # "cexecuted", canonicalizing filenames on the way. Clear the
+ # "executed" map.
+
+ def canonicalize_filenames(self):
+ global c
+ for filename, lineno in c.keys():
+ f = self.canonical_filename(filename)
+ if not self.cexecuted.has_key(f):
+ self.cexecuted[f] = {}
+ self.cexecuted[f][lineno] = 1
+ c = {}
+
+ # morf_filename(morf). Return the filename for a module or file.
+
+ def morf_filename(self, morf):
+ if isinstance(morf, types.ModuleType):
+ if not hasattr(morf, '__file__'):
+ raise self.error, "Module has no __file__ attribute."
+ file = morf.__file__
+ else:
+ file = morf
+ return self.canonical_filename(file)
+
+ # analyze_morf(morf). Analyze the module or filename passed as
+ # the argument. If the source code can't be found, raise an error.
+ # Otherwise, return a pair of (1) the canonical filename of the
+ # source code for the module, and (2) a list of lines of statements
+ # in the source code.
+
+ def analyze_morf(self, morf):
+ if self.analysis_cache.has_key(morf):
+ return self.analysis_cache[morf]
+ filename = self.morf_filename(morf)
+ ext = os.path.splitext(filename)[1]
+ if ext == '.pyc':
+ if not os.path.exists(filename[0:-1]):
+ raise self.error, ("No source for compiled code '%s'."
+ % filename)
+ filename = filename[0:-1]
+ elif ext != '.py':
+ raise self.error, "File '%s' not Python source." % filename
+ source = open(filename, 'r')
+ import parser
+ tree = parser.suite(source.read()).totuple(1)
+ source.close()
+ statements = {}
+ self.find_statements(tree, statements)
+ lines = statements.keys()
+ lines.sort()
+ result = filename, lines
+ self.analysis_cache[morf] = result
+ return result
+
+ # find_statements(tree, dict). Find each statement in the parse
+ # tree and record the line on which the statement starts in the
+ # dictionary (by assigning it to 1).
+ #
+ # It works by walking the whole tree depth-first. Every time it
+ # comes across a statement (symbol.stmt -- this includes compound
+ # statements like 'if' and 'while') it calls find_statement, which
+ # descends the tree below the statement to find the first terminal
+ # token in that statement and record the lines on which that token
+ # was found.
+ #
+ # This algorithm may find some lines several times (because of the
+ # grammar production statement -> compound statement -> statement),
+ # but that doesn't matter because we record lines as the keys of the
+ # dictionary.
+ #
+ # See also [GDR 2001-12-04b, 3.2].
+
+ def find_statements(self, tree, dict):
+ import symbol, token
+ if token.ISNONTERMINAL(tree[0]):
+ for t in tree[1:]:
+ self.find_statements(t, dict)
+ if tree[0] == symbol.stmt:
+ self.find_statement(tree[1], dict)
+ elif (tree[0] == token.NAME
+ and tree[1] in ['elif', 'except', 'finally']):
+ dict[tree[2]] = 1
+
+ def find_statement(self, tree, dict):
+ import token
+ while token.ISNONTERMINAL(tree[0]):
+ tree = tree[1]
+ dict[tree[2]] = 1
+
+ # format_lines(statements, lines). Format a list of line numbers
+ # for printing by coalescing groups of lines as long as the lines
+ # represent consecutive statements. This will coalesce even if
+ # there are gaps between statements, so if statements =
+ # [1,2,3,4,5,10,11,12,13,14] and lines = [1,2,5,10,11,13,14] then
+ # format_lines will return "1-2, 5-11, 13-14".
+
+ def format_lines(self, statements, lines):
+ pairs = []
+ i = 0
+ j = 0
+ start = None
+ pairs = []
+ while i < len(statements) and j < len(lines):
+ if statements[i] == lines[j]:
+ if start == None:
+ start = lines[j]
+ end = lines[j]
+ j = j + 1
+ elif start:
+ pairs.append((start, end))
+ start = None
+ i = i + 1
+ if start:
+ pairs.append((start, end))
+ def stringify(pair):
+ start, end = pair
+ if start == end:
+ return "%d" % start
+ else:
+ return "%d-%d" % (start, end)
+ import string
+ return string.join(map(stringify, pairs), ", ")
+
+ def analysis(self, morf):
+ filename, statements = self.analyze_morf(morf)
+ self.canonicalize_filenames()
+ if not self.cexecuted.has_key(filename):
+ self.cexecuted[filename] = {}
+ missing = []
+ for line in statements:
+ if not self.cexecuted[filename].has_key(line):
+ missing.append(line)
+ return (filename, statements, missing,
+ self.format_lines(statements, missing))
+
+ def morf_name(self, morf):
+ if isinstance(morf, types.ModuleType):
+ return morf.__name__
+ else:
+ return os.path.splitext(os.path.basename(morf))[0]
+
+ def report(self, morfs, show_missing=1, ignore_errors=0):
+ if not isinstance(morfs, types.ListType):
+ morfs = [morfs]
+ max_name = max([5,] + map(len, map(self.morf_name, morfs)))
+ fmt_name = "%%- %ds " % max_name
+ fmt_err = fmt_name + "%s: %s"
+ header = fmt_name % "Name" + " Stmts Exec Cover"
+ fmt_coverage = fmt_name + "% 6d % 6d % 5d%%"
+ if show_missing:
+ header = header + " Missing"
+ fmt_coverage = fmt_coverage + " %s"
+ print header
+ print "-" * len(header)
+ total_statements = 0
+ total_executed = 0
+ for morf in morfs:
+ name = self.morf_name(morf)
+ try:
+ _, statements, missing, readable = self.analysis(morf)
+ n = len(statements)
+ m = n - len(missing)
+ if n > 0:
+ pc = 100.0 * m / n
+ else:
+ pc = 100.0
+ args = (name, n, m, pc)
+ if show_missing:
+ args = args + (readable,)
+ print fmt_coverage % args
+ total_statements = total_statements + n
+ total_executed = total_executed + m
+ except KeyboardInterrupt:
+ raise
+ except:
+ if not ignore_errors:
+ type, msg = sys.exc_info()[0:2]
+ print fmt_err % (name, type, msg)
+ if len(morfs) > 1:
+ print "-" * len(header)
+ if total_statements > 0:
+ pc = 100.0 * total_executed / total_statements
+ else:
+ pc = 100.0
+ args = ("TOTAL", total_statements, total_executed, pc)
+ if show_missing:
+ args = args + ("",)
+ print fmt_coverage % args
+
+ # annotate(morfs, ignore_errors).
+
+ blank_re = re.compile("\\s*(#|$)")
+ else_re = re.compile("\\s*else\\s*:\\s*(#|$)")
+
+ def annotate(self, morfs, directory=None, ignore_errors=0):
+ for morf in morfs:
+ try:
+ filename, statements, missing, _ = self.analysis(morf)
+ source = open(filename, 'r')
+ if directory:
+ dest_file = os.path.join(directory,
+ os.path.basename(filename)
+ + ',cover')
+ else:
+ dest_file = filename + ',cover'
+ dest = open(dest_file, 'w')
+ lineno = 0
+ i = 0
+ j = 0
+ covered = 1
+ while 1:
+ line = source.readline()
+ if line == '':
+ break
+ lineno = lineno + 1
+ while i < len(statements) and statements[i] < lineno:
+ i = i + 1
+ while j < len(missing) and missing[j] < lineno:
+ j = j + 1
+ if i < len(statements) and statements[i] == lineno:
+ covered = j >= len(missing) or missing[j] > lineno
+ if self.blank_re.match(line):
+ dest.write(' ')
+ elif self.else_re.match(line):
+ # Special logic for lines containing only
+ # 'else:'. See [GDR 2001-12-04b, 3.2].
+ if i >= len(statements) and j >= len(missing):
+ dest.write('! ')
+ elif i >= len(statements) or j >= len(missing):
+ dest.write('> ')
+ elif statements[i] == missing[j]:
+ dest.write('! ')
+ else:
+ dest.write('> ')
+ elif covered:
+ dest.write('> ')
+ else:
+ dest.write('! ')
+ dest.write(line)
+ source.close()
+ dest.close()
+ except KeyboardInterrupt:
+ raise
+ except:
+ if not ignore_errors:
+ raise
+
+
+# Singleton object.
+the_coverage = coverage()
+
+# Module functions call methods in the singleton object.
+def start(*args, **kw): return apply(the_coverage.start, args, kw)
+def stop(*args, **kw): return apply(the_coverage.stop, args, kw)
+def erase(*args, **kw): return apply(the_coverage.erase, args, kw)
+def analysis(*args, **kw): return apply(the_coverage.analysis, args, kw)
+def report(*args, **kw): return apply(the_coverage.report, args, kw)
+
+# Save coverage data when Python exits. (The atexit module wasn't
+# introduced until Python 2.0, so use sys.exitfunc when it's not
+# available.)
+try:
+ import atexit
+ atexit.register(the_coverage.save)
+except ImportError:
+ sys.exitfunc = the_coverage.save
+
+# Command-line interface.
+if __name__ == '__main__':
+ the_coverage.command_line()
+
+
+# A. REFERENCES
+#
+# [GDR 2001-12-04a] "Statement coverage for Python"; Gareth Rees;
+# Ravenbrook Limited; 2001-12-04;
+# <http://garethrees.org/2001/12/04/python-coverage/>.
+#
+# [GDR 2001-12-04b] "Statement coverage for Python: design and
+# analysis"; Gareth Rees; Ravenbrook Limited; 2001-12-04;
+# <http://garethrees.org/2001/12/04/python-coverage/design.html>.
+#
+# [van Rossum 2001-07-20a] "Python Reference Manual (releae 2.1.1)";
+# Guide van Rossum; 2001-07-20;
+# <http://www.python.org/doc/2.1.1/ref/ref.html>.
+#
+# [van Rossum 2001-07-20b] "Python Library Reference"; Guido van Rossum;
+# 2001-07-20; <http://www.python.org/doc/2.1.1/lib/lib.html>.
+#
+#
+# B. DOCUMENT HISTORY
+#
+# 2001-12-04 GDR Created.
+#
+# 2001-12-06 GDR Added command-line interface and source code
+# annotation.
+#
+# 2001-12-09 GDR Moved design and interface to separate documents.
+#
+# 2001-12-10 GDR Open cache file as binary on Windows. Allow
+# simultaneous -e and -x, or -a and -r.
+#
+# 2001-12-12 GDR Added command-line help. Cache analysis so that it
+# only needs to be done once when you specify -a and -r.
+#
+# 2001-12-13 GDR Improved speed while recording. Portable between
+# Python 1.5.2 and 2.1.1.
+#
+# 2002-01-03 GDR Module-level functions work correctly.
+#
+# 2002-01-07 GDR Update sys.path when running a file with the -x option,
+# so that it matches the value the program would get if it were run on
+# its own.
+#
+#
+# C. COPYRIGHT AND LICENCE
+#
+# Copyright 2001 Gareth Rees. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+# 1. Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+#
+# 2. Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the
+# distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+# HOLDERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+# OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
+# TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
+# USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
+# DAMAGE.
+#
+#
+#
+# $Id: //info.ravenbrook.com/user/gdr/www.garethrees.org/2001/12/04/python-coverage/coverage.py#9 $
+
diff --git a/tests/files/testimage.jpg b/tests/files/testimage.jpg
new file mode 100755
index 0000000..165db62
--- /dev/null
+++ b/tests/files/testimage.jpg
Binary files differ
diff --git a/tests/gdata_test.py b/tests/gdata_test.py
new file mode 100755
index 0000000..7885201
--- /dev/null
+++ b/tests/gdata_test.py
@@ -0,0 +1,364 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import gdata
+import atom
+from gdata import test_data
+import gdata.test_config as conf
+
+
+class StartIndexTest(unittest.TestCase):
+
+ def setUp(self):
+ self.start_index = gdata.StartIndex()
+
+ def testToAndFromString(self):
+ self.start_index.text = '1'
+ self.assert_(self.start_index.text == '1')
+ new_start_index = gdata.StartIndexFromString(self.start_index.ToString())
+ self.assert_(self.start_index.text == new_start_index.text)
+
+
+class ItemsPerPageTest(unittest.TestCase):
+
+ def setUp(self):
+ self.items_per_page = gdata.ItemsPerPage()
+
+ def testToAndFromString(self):
+ self.items_per_page.text = '10'
+ self.assert_(self.items_per_page.text == '10')
+ new_items_per_page = gdata.ItemsPerPageFromString(
+ self.items_per_page.ToString())
+ self.assert_(self.items_per_page.text == new_items_per_page.text)
+
+
+class GDataEntryTest(unittest.TestCase):
+
+ def testIdShouldBeCleaned(self):
+ entry = gdata.GDataEntryFromString(test_data.XML_ENTRY_1)
+ element_tree = ElementTree.fromstring(test_data.XML_ENTRY_1)
+ self.assert_(element_tree.findall(
+ '{http://www.w3.org/2005/Atom}id')[0].text != entry.id.text)
+ self.assert_(entry.id.text == 'http://www.google.com/test/id/url')
+
+ def testGeneratorShouldBeCleaned(self):
+ feed = gdata.GDataFeedFromString(test_data.GBASE_FEED)
+ element_tree = ElementTree.fromstring(test_data.GBASE_FEED)
+ self.assert_(element_tree.findall('{http://www.w3.org/2005/Atom}generator'
+ )[0].text != feed.generator.text)
+ self.assert_(feed.generator.text == 'GoogleBase')
+
+ def testAllowsEmptyId(self):
+ entry = gdata.GDataEntry()
+ try:
+ entry.id = atom.Id()
+ except AttributeError:
+ self.fail('Empty id should not raise an attribute error.')
+
+
+class LinkFinderTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.GDataEntryFromString(test_data.XML_ENTRY_1)
+
+ def testLinkFinderGetsLicenseLink(self):
+ self.assertEquals(isinstance(self.entry.GetLicenseLink(), atom.Link),
+ True)
+ self.assertEquals(self.entry.GetLicenseLink().href,
+ 'http://creativecommons.org/licenses/by-nc/2.5/rdf')
+ self.assertEquals(self.entry.GetLicenseLink().rel, 'license')
+
+ def testLinkFinderGetsAlternateLink(self):
+ self.assertEquals(isinstance(self.entry.GetAlternateLink(), atom.Link),
+ True)
+ self.assertEquals(self.entry.GetAlternateLink().href,
+ 'http://www.provider-host.com/123456789')
+ self.assertEquals(self.entry.GetAlternateLink().rel, 'alternate')
+
+
+class GDataFeedTest(unittest.TestCase):
+
+ def testCorrectConversionToElementTree(self):
+ test_feed = gdata.GDataFeedFromString(test_data.GBASE_FEED)
+ self.assert_(test_feed.total_results is not None)
+ element_tree = test_feed._ToElementTree()
+ feed = element_tree.find('{http://www.w3.org/2005/Atom}feed')
+ self.assert_(element_tree.find(
+ '{http://a9.com/-/spec/opensearchrss/1.0/}totalResults') is not None)
+
+ def testAllowsEmptyId(self):
+ feed = gdata.GDataFeed()
+ try:
+ feed.id = atom.Id()
+ except AttributeError:
+ self.fail('Empty id should not raise an attribute error.')
+
+
+class BatchEntryTest(unittest.TestCase):
+
+ def testCorrectConversionFromAndToString(self):
+ batch_entry = gdata.BatchEntryFromString(test_data.BATCH_ENTRY)
+
+ self.assertEquals(batch_entry.batch_id.text, 'itemB')
+ self.assertEquals(batch_entry.id.text,
+ 'http://www.google.com/base/feeds/items/'
+ '2173859253842813008')
+ self.assertEquals(batch_entry.batch_operation.type, 'insert')
+ self.assertEquals(batch_entry.batch_status.code, '201')
+ self.assertEquals(batch_entry.batch_status.reason, 'Created')
+
+ new_entry = gdata.BatchEntryFromString(str(batch_entry))
+
+ self.assertEquals(batch_entry.batch_id.text, new_entry.batch_id.text)
+ self.assertEquals(batch_entry.id.text, new_entry.id.text)
+ self.assertEquals(batch_entry.batch_operation.type,
+ new_entry.batch_operation.type)
+ self.assertEquals(batch_entry.batch_status.code,
+ new_entry.batch_status.code)
+ self.assertEquals(batch_entry.batch_status.reason,
+ new_entry.batch_status.reason)
+
+
+class BatchFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.batch_feed = gdata.BatchFeed()
+ self.example_entry = gdata.BatchEntry(
+ atom_id=atom.Id(text='http://example.com/1'), text='This is a test')
+
+ def testConvertRequestFeed(self):
+ batch_feed = gdata.BatchFeedFromString(test_data.BATCH_FEED_REQUEST)
+
+ self.assertEquals(len(batch_feed.entry), 4)
+ for entry in batch_feed.entry:
+ self.assert_(isinstance(entry, gdata.BatchEntry))
+ self.assertEquals(batch_feed.title.text, 'My Batch Feed')
+
+ new_feed = gdata.BatchFeedFromString(str(batch_feed))
+
+ self.assertEquals(len(new_feed.entry), 4)
+ for entry in new_feed.entry:
+ self.assert_(isinstance(entry, gdata.BatchEntry))
+ self.assertEquals(new_feed.title.text, 'My Batch Feed')
+
+ def testConvertResultFeed(self):
+ batch_feed = gdata.BatchFeedFromString(test_data.BATCH_FEED_RESULT)
+
+ self.assertEquals(len(batch_feed.entry), 4)
+ for entry in batch_feed.entry:
+ self.assert_(isinstance(entry, gdata.BatchEntry))
+ if entry.id.text == ('http://www.google.com/base/feeds/items/'
+ '2173859253842813008'):
+ self.assertEquals(entry.batch_operation.type, 'insert')
+ self.assertEquals(entry.batch_id.text, 'itemB')
+ self.assertEquals(entry.batch_status.code, '201')
+ self.assertEquals(entry.batch_status.reason, 'Created')
+ self.assertEquals(batch_feed.title.text, 'My Batch')
+
+ new_feed = gdata.BatchFeedFromString(str(batch_feed))
+
+ self.assertEquals(len(new_feed.entry), 4)
+ for entry in new_feed.entry:
+ self.assert_(isinstance(entry, gdata.BatchEntry))
+ if entry.id.text == ('http://www.google.com/base/feeds/items/'
+ '2173859253842813008'):
+ self.assertEquals(entry.batch_operation.type, 'insert')
+ self.assertEquals(entry.batch_id.text, 'itemB')
+ self.assertEquals(entry.batch_status.code, '201')
+ self.assertEquals(entry.batch_status.reason, 'Created')
+ self.assertEquals(new_feed.title.text, 'My Batch')
+
+ def testAddBatchEntry(self):
+ try:
+ self.batch_feed.AddBatchEntry(batch_id_string='a')
+ self.fail('AddBatchEntry with neither entry or URL should raise Error')
+ except gdata.MissingRequiredParameters:
+ pass
+
+ new_entry = self.batch_feed.AddBatchEntry(
+ id_url_string='http://example.com/1')
+ self.assertEquals(len(self.batch_feed.entry), 1)
+ self.assertEquals(self.batch_feed.entry[0].id.text,
+ 'http://example.com/1')
+ self.assertEquals(self.batch_feed.entry[0].batch_id.text, '0')
+ self.assertEquals(new_entry.id.text, 'http://example.com/1')
+ self.assertEquals(new_entry.batch_id.text, '0')
+
+ to_add = gdata.BatchEntry(atom_id=atom.Id(text='originalId'))
+ new_entry = self.batch_feed.AddBatchEntry(entry=to_add,
+ batch_id_string='foo')
+ self.assertEquals(new_entry.batch_id.text, 'foo')
+ self.assertEquals(new_entry.id.text, 'originalId')
+
+ to_add = gdata.BatchEntry(atom_id=atom.Id(text='originalId'),
+ batch_id=gdata.BatchId(text='bar'))
+ new_entry = self.batch_feed.AddBatchEntry(entry=to_add,
+ id_url_string='newId',
+ batch_id_string='foo')
+ self.assertEquals(new_entry.batch_id.text, 'foo')
+ self.assertEquals(new_entry.id.text, 'originalId')
+
+ to_add = gdata.BatchEntry(atom_id=atom.Id(text='originalId'),
+ batch_id=gdata.BatchId(text='bar'))
+ new_entry = self.batch_feed.AddBatchEntry(entry=to_add,
+ id_url_string='newId')
+ self.assertEquals(new_entry.batch_id.text, 'bar')
+ self.assertEquals(new_entry.id.text, 'originalId')
+
+ to_add = gdata.BatchEntry(atom_id=atom.Id(text='originalId'),
+ batch_id=gdata.BatchId(text='bar'),
+ batch_operation=gdata.BatchOperation(
+ op_type=gdata.BATCH_INSERT))
+ self.assertEquals(to_add.batch_operation.type, gdata.BATCH_INSERT)
+ new_entry = self.batch_feed.AddBatchEntry(entry=to_add,
+ id_url_string='newId', batch_id_string='foo',
+ operation_string=gdata.BATCH_UPDATE)
+ self.assertEquals(new_entry.batch_operation.type, gdata.BATCH_UPDATE)
+
+
+ def testAddInsert(self):
+
+ first_entry = gdata.BatchEntry(
+ atom_id=atom.Id(text='http://example.com/1'), text='This is a test1')
+ self.batch_feed.AddInsert(first_entry)
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.BATCH_INSERT)
+ self.assertEquals(self.batch_feed.entry[0].batch_id.text, '0')
+
+ second_entry = gdata.BatchEntry(
+ atom_id=atom.Id(text='http://example.com/2'), text='This is a test2')
+ self.batch_feed.AddInsert(second_entry, batch_id_string='foo')
+ self.assertEquals(self.batch_feed.entry[1].batch_operation.type,
+ gdata.BATCH_INSERT)
+ self.assertEquals(self.batch_feed.entry[1].batch_id.text, 'foo')
+
+
+ third_entry = gdata.BatchEntry(
+ atom_id=atom.Id(text='http://example.com/3'), text='This is a test3')
+ third_entry.batch_operation = gdata.BatchOperation(
+ op_type=gdata.BATCH_DELETE)
+ # Add an entry with a delete operation already assigned.
+ self.batch_feed.AddInsert(third_entry)
+ # The batch entry should not have the original operation, it should
+ # have been changed to an insert.
+ self.assertEquals(self.batch_feed.entry[2].batch_operation.type,
+ gdata.BATCH_INSERT)
+ self.assertEquals(self.batch_feed.entry[2].batch_id.text, '2')
+
+ def testAddDelete(self):
+ # Try deleting an entry
+ delete_entry = gdata.BatchEntry(
+ atom_id=atom.Id(text='http://example.com/1'), text='This is a test')
+ self.batch_feed.AddDelete(entry=delete_entry)
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.BATCH_DELETE)
+ self.assertEquals(self.batch_feed.entry[0].id.text,
+ 'http://example.com/1')
+ self.assertEquals(self.batch_feed.entry[0].text, 'This is a test')
+
+ # Try deleting a URL
+ self.batch_feed.AddDelete(url_string='http://example.com/2')
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.BATCH_DELETE)
+ self.assertEquals(self.batch_feed.entry[1].id.text,
+ 'http://example.com/2')
+ self.assert_(self.batch_feed.entry[1].text is None)
+
+ def testAddQuery(self):
+ # Try querying with an existing batch entry
+ delete_entry = gdata.BatchEntry(
+ atom_id=atom.Id(text='http://example.com/1'))
+ self.batch_feed.AddQuery(entry=delete_entry)
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.BATCH_QUERY)
+ self.assertEquals(self.batch_feed.entry[0].id.text,
+ 'http://example.com/1')
+
+ # Try querying a URL
+ self.batch_feed.AddQuery(url_string='http://example.com/2')
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.BATCH_QUERY)
+ self.assertEquals(self.batch_feed.entry[1].id.text,
+ 'http://example.com/2')
+
+ def testAddUpdate(self):
+ # Try updating an entry
+ delete_entry = gdata.BatchEntry(
+ atom_id=atom.Id(text='http://example.com/1'), text='This is a test')
+ self.batch_feed.AddUpdate(entry=delete_entry)
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.BATCH_UPDATE)
+ self.assertEquals(self.batch_feed.entry[0].id.text,
+ 'http://example.com/1')
+ self.assertEquals(self.batch_feed.entry[0].text, 'This is a test')
+
+
+class ExtendedPropertyTest(unittest.TestCase):
+
+ def testXmlBlobRoundTrip(self):
+ ep = gdata.ExtendedProperty(name='blobby')
+ ep.SetXmlBlob('<some_xml attr="test"/>')
+ extension = ep.GetXmlBlobExtensionElement()
+ self.assertEquals(extension.tag, 'some_xml')
+ self.assert_(extension.namespace is None)
+ self.assertEquals(extension.attributes['attr'], 'test')
+
+ ep2 = gdata.ExtendedPropertyFromString(ep.ToString())
+
+ extension = ep2.GetXmlBlobExtensionElement()
+ self.assertEquals(extension.tag, 'some_xml')
+ self.assert_(extension.namespace is None)
+ self.assertEquals(extension.attributes['attr'], 'test')
+
+ def testGettersShouldReturnNoneWithNoBlob(self):
+ ep = gdata.ExtendedProperty(name='no blob')
+ self.assert_(ep.GetXmlBlobExtensionElement() is None)
+ self.assert_(ep.GetXmlBlobString() is None)
+
+ def testGettersReturnCorrectTypes(self):
+ ep = gdata.ExtendedProperty(name='has blob')
+ ep.SetXmlBlob('<some_xml attr="test"/>')
+ self.assert_(isinstance(ep.GetXmlBlobExtensionElement(),
+ atom.ExtensionElement))
+ self.assert_(isinstance(ep.GetXmlBlobString(), str))
+
+
+class FeedLinkTest(unittest.TestCase):
+
+ def testCorrectFromStringType(self):
+ link = gdata.FeedLinkFromString(
+ '<feedLink xmlns="http://schemas.google.com/g/2005" countHint="5"/>')
+ self.assert_(isinstance(link, gdata.FeedLink))
+ self.assertEqual(link.count_hint, '5')
+
+
+def suite():
+ return conf.build_suite([StartIndexTest, StartIndexTest, GDataEntryTest,
+ LinkFinderTest, GDataFeedTest, BatchEntryTest, BatchFeedTest,
+ ExtendedPropertyTest, FeedLinkTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/__init__.py b/tests/gdata_tests/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/__init__.py
diff --git a/tests/gdata_tests/analytics/__init__.py b/tests/gdata_tests/analytics/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/analytics/__init__.py
diff --git a/tests/gdata_tests/analytics/data_test.py b/tests/gdata_tests/analytics/data_test.py
new file mode 100755
index 0000000..09ac200
--- /dev/null
+++ b/tests/gdata_tests/analytics/data_test.py
@@ -0,0 +1,456 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2010 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit Tests for Google Analytics Data Export API and Management APIs.
+
+Although the Data Export API and Management API conceptually operate on
+different parts of Google Analytics, the APIs share some code so they
+are released in the same module.
+
+AccountFeedTest: All unit tests for AccountFeed class.
+DataFeedTest: All unit tests for DataFeed class.
+ManagementFeedAccountTest: Unit tests for ManagementFeed class.
+ManagementFeedGoalTest: Unit tests for ManagementFeed class.
+ManagementFeedAdvSegTest: Unit tests for ManagementFeed class.
+"""
+
+__author__ = 'api.nickm@google.com (Nick Mihailovski)'
+
+
+import unittest
+from gdata import test_data
+import gdata.analytics.data
+import atom.core
+import gdata.test_config as conf
+
+
+class AccountFeedTest(unittest.TestCase):
+ """Unit test for all custom elements in the Account Feed."""
+
+ def setUp(self):
+ """Retrieves the test XML feed into a AccountFeed object."""
+ self.feed = atom.core.parse(test_data.ANALYTICS_ACCOUNT_FEED,
+ gdata.analytics.data.AccountFeed)
+
+ def testSegment(self):
+ """Tests Segment class in Google Analytics Account Feed."""
+
+ segment = self.feed.segment[0]
+ self.assertEquals(segment.id, 'gaid::-11')
+ self.assertEquals(segment.name, 'Visits from iPhones')
+
+ def testSegmentDefinition(self):
+ """Tests Definition class in Google Analytics Account Feed."""
+
+ definition = self.feed.segment[0].definition
+ self.assertEquals(definition.text, 'ga:operatingSystem==iPhone')
+
+ def testEntryTableId(self):
+ """Tests custom classes in Google Analytics Account Feed."""
+
+ entry = self.feed.entry[0]
+ self.assertEquals(entry.table_id.text, 'ga:1174')
+
+ def testEntryProperty(self):
+ """Tests the property classes in Google Analytics Account Feed."""
+ property = self.feed.entry[0].property
+
+ self.assertEquals(property[0].name, 'ga:accountId')
+ self.assertEquals(property[0].value, '30481')
+
+ self.assertEquals(property[1].name, 'ga:accountName')
+ self.assertEquals(property[1].value, 'Google Store')
+
+ self.assertEquals(property[2].name, 'ga:profileId')
+ self.assertEquals(property[2].value, '1174')
+
+ self.assertEquals(property[3].name, 'ga:webPropertyId')
+ self.assertEquals(property[3].value, 'UA-30481-1')
+
+ self.assertEquals(property[4].name, 'ga:currency')
+ self.assertEquals(property[4].value, 'USD')
+
+ self.assertEquals(property[5].name, 'ga:timezone')
+ self.assertEquals(property[5].value, 'America/Los_Angeles')
+
+ def testEntryGetProperty(self):
+ """Tests GetProperty inherited class in the AccountEntry class."""
+
+ entry = self.feed.entry[0]
+ self.assertEquals(entry.GetProperty('ga:accountId').value, '30481')
+ self.assertEquals(entry.GetProperty('ga:accountName').value, 'Google Store')
+ self.assertEquals(entry.GetProperty('ga:profileId').value, '1174')
+ self.assertEquals(entry.GetProperty('ga:webPropertyId').value, 'UA-30481-1')
+ self.assertEquals(entry.GetProperty('ga:currency').value, 'USD')
+ self.assertEquals(entry.GetProperty('ga:timezone').value, 'America/Los_Angeles')
+
+ def testGoal(self):
+ """Tests Goal class in Google Anlaytics Account Feed."""
+
+ goal = self.feed.entry[0].goal[0]
+ self.assertEquals(goal.number, '1')
+ self.assertEquals(goal.name, 'Completing Order')
+ self.assertEquals(goal.value, '10.0')
+ self.assertEquals(goal.active, 'true')
+
+ def testDestination(self):
+ """Tests Destination class in Google Analytics Account Feed."""
+
+ destination = self.feed.entry[0].goal[0].destination
+ self.assertEquals(destination.expression, '/purchaseComplete.html')
+ self.assertEquals(destination.case_sensitive, 'false')
+ self.assertEquals(destination.match_type, 'regex')
+ self.assertEquals(destination.step1_required, 'false')
+
+ def testStep(self):
+ """Tests Step class in Google Analytics Account Feed."""
+
+ step = self.feed.entry[0].goal[0].destination.step[0]
+ self.assertEquals(step.number, '1')
+ self.assertEquals(step.name, 'View Product Categories')
+ self.assertEquals(step.path, '/Apps|Accessories|Fun|Kid\+s|Office')
+
+ def testEngagemet(self):
+ """Tests Engagement class in Google Analytics Account Feed."""
+
+ engagement = self.feed.entry[0].goal[1].engagement
+ self.assertEquals(engagement.type, 'timeOnSite')
+ self.assertEquals(engagement.comparison, '>')
+ self.assertEquals(engagement.threshold_value, '300')
+
+ def testCustomVariable(self):
+ """Tests CustomVariable class in Google Analytics Account Feed."""
+
+ customVar = self.feed.entry[0].custom_variable[0]
+ self.assertEquals(customVar.index, '1')
+ self.assertEquals(customVar.name, 'My Custom Variable')
+ self.assertEquals(customVar.scope, '3')
+
+
+class DataFeedTest(unittest.TestCase):
+ """Unit test for all custom elements in the Data Feed."""
+
+ def setUp(self):
+ """Retrieves the test XML feed into a DataFeed object."""
+
+ self.feed = atom.core.parse(test_data.ANALYTICS_DATA_FEED,
+ gdata.analytics.data.DataFeed)
+
+ def testDataFeed(self):
+ """Tests custom classes in Google Analytics Data Feed."""
+
+ self.assertEquals(self.feed.start_date.text, '2008-10-01')
+ self.assertEquals(self.feed.end_date.text, '2008-10-31')
+
+ def testAggregates(self):
+ """Tests Aggregates class in Google Analytics Data Feed."""
+
+ self.assert_(self.feed.aggregates is not None)
+
+ def testContainsSampledData(self):
+ """Tests ContainsSampledData class in Google Analytics Data Feed."""
+
+ contains_sampled_data = self.feed.contains_sampled_data.text
+ self.assertEquals(contains_sampled_data, 'true')
+ self.assertTrue(self.feed.HasSampledData())
+
+ def testAggregatesElements(self):
+ """Tests Metrics class in Aggregates class."""
+
+ metric = self.feed.aggregates.metric[0]
+ self.assertEquals(metric.confidence_interval, '0.0')
+ self.assertEquals(metric.name, 'ga:visits')
+ self.assertEquals(metric.type, 'integer')
+ self.assertEquals(metric.value, '136540')
+
+ metric = self.feed.aggregates.GetMetric('ga:visits')
+ self.assertEquals(metric.confidence_interval, '0.0')
+ self.assertEquals(metric.name, 'ga:visits')
+ self.assertEquals(metric.type, 'integer')
+ self.assertEquals(metric.value, '136540')
+
+ def testDataSource(self):
+ """Tests DataSources class in Google Analytics Data Feed."""
+
+ self.assert_(self.feed.data_source[0] is not None)
+
+ def testDataSourceTableId(self):
+ """Tests TableId class in the DataSource class."""
+
+ table_id = self.feed.data_source[0].table_id
+ self.assertEquals(table_id.text, 'ga:1174')
+
+ def testDataSourceTableName(self):
+ """Tests TableName class in the DataSource class."""
+
+ table_name = self.feed.data_source[0].table_name
+ self.assertEquals(table_name.text, 'www.googlestore.com')
+
+ def testDataSourceProperty(self):
+ """Tests Property class in the DataSource class."""
+
+ property = self.feed.data_source[0].property
+ self.assertEquals(property[0].name, 'ga:profileId')
+ self.assertEquals(property[0].value, '1174')
+
+ self.assertEquals(property[1].name, 'ga:webPropertyId')
+ self.assertEquals(property[1].value, 'UA-30481-1')
+
+ self.assertEquals(property[2].name, 'ga:accountName')
+ self.assertEquals(property[2].value, 'Google Store')
+
+ def testDataSourceGetProperty(self):
+ """Tests GetProperty utility method in the DataSource class."""
+
+ ds = self.feed.data_source[0]
+ self.assertEquals(ds.GetProperty('ga:profileId').value, '1174')
+ self.assertEquals(ds.GetProperty('ga:webPropertyId').value, 'UA-30481-1')
+ self.assertEquals(ds.GetProperty('ga:accountName').value, 'Google Store')
+
+ def testSegment(self):
+ """Tests Segment class in DataFeed class."""
+
+ segment = self.feed.segment
+ self.assertEquals(segment.id, 'gaid::-11')
+ self.assertEquals(segment.name, 'Visits from iPhones')
+
+ def testSegmentDefinition(self):
+ """Tests Definition class in Segment class."""
+
+ definition = self.feed.segment.definition
+ self.assertEquals(definition.text, 'ga:operatingSystem==iPhone')
+
+ def testEntryDimension(self):
+ """Tests Dimension class in Entry class."""
+
+ dim = self.feed.entry[0].dimension[0]
+ self.assertEquals(dim.name, 'ga:source')
+ self.assertEquals(dim.value, 'blogger.com')
+
+ def testEntryGetDimension(self):
+ """Tests GetDimension utility method in the Entry class."""
+
+ dim = self.feed.entry[0].GetDimension('ga:source')
+ self.assertEquals(dim.name, 'ga:source')
+ self.assertEquals(dim.value, 'blogger.com')
+
+ error = self.feed.entry[0].GetDimension('foo')
+ self.assertEquals(error, None)
+
+ def testEntryMetric(self):
+ """Tests Metric class in Entry class."""
+
+ met = self.feed.entry[0].metric[0]
+ self.assertEquals(met.confidence_interval, '0.0')
+ self.assertEquals(met.name, 'ga:visits')
+ self.assertEquals(met.type, 'integer')
+ self.assertEquals(met.value, '68140')
+
+ def testEntryGetMetric(self):
+ """Tests GetMetric utility method in the Entry class."""
+
+ met = self.feed.entry[0].GetMetric('ga:visits')
+ self.assertEquals(met.confidence_interval, '0.0')
+ self.assertEquals(met.name, 'ga:visits')
+ self.assertEquals(met.type, 'integer')
+ self.assertEquals(met.value, '68140')
+
+ error = self.feed.entry[0].GetMetric('foo')
+ self.assertEquals(error, None)
+
+ def testEntryGetObject(self):
+ """Tests GetObjectOf utility method in Entry class."""
+
+ entry = self.feed.entry[0]
+
+ dimension = entry.GetObject('ga:source')
+ self.assertEquals(dimension.name, 'ga:source')
+ self.assertEquals(dimension.value, 'blogger.com')
+
+ metric = entry.GetObject('ga:visits')
+ self.assertEquals(metric.name, 'ga:visits')
+ self.assertEquals(metric.value, '68140')
+ self.assertEquals(metric.type, 'integer')
+ self.assertEquals(metric.confidence_interval, '0.0')
+
+ error = entry.GetObject('foo')
+ self.assertEquals(error, None)
+
+
+class ManagementFeedProfileTest(unittest.TestCase):
+ """Unit test for all property elements in Google Analytics Management Feed.
+
+ Since the Account, Web Property and Profile feed all have the same
+ structure and XML elements, this single test case covers all three feeds.
+ """
+
+ def setUp(self):
+ """Retrieves the test XML feed into a DataFeed object."""
+
+ self.feed = atom.core.parse(test_data.ANALYTICS_MGMT_PROFILE_FEED,
+ gdata.analytics.data.ManagementFeed)
+
+ def testFeedKindAttribute(self):
+ """Tests the kind attribute in the feed."""
+
+ self.assertEqual(self.feed.kind, 'analytics#profiles')
+
+ def testEntryKindAttribute(self):
+ """tests the kind attribute in the entry."""
+
+ entry_kind = self.feed.entry[0].kind
+ self.assertEqual(entry_kind, 'analytics#profile')
+
+ def testEntryProperty(self):
+ """Tests property classes in Managment Entry class."""
+
+ property = self.feed.entry[0].property
+ self.assertEquals(property[0].name, 'ga:accountId')
+ self.assertEquals(property[0].value, '30481')
+
+ def testEntryGetProperty(self):
+ """Tests GetProperty helper method in Management Entry class."""
+
+ entry = self.feed.entry[0]
+ self.assertEquals(entry.GetProperty('ga:accountId').value, '30481')
+
+ def testGetParentLinks(self):
+ """Tests GetParentLinks utility method."""
+
+ parent_links = self.feed.entry[0].GetParentLinks()
+ self.assertEquals(len(parent_links), 1)
+
+ parent_link = parent_links[0]
+ self.assertEquals(parent_link.rel,
+ 'http://schemas.google.com/ga/2009#parent')
+ self.assertEquals(parent_link.type,
+ 'application/atom+xml')
+ self.assertEquals(parent_link.href,
+ 'https://www.google.com/analytics/feeds/datasources'
+ '/ga/accounts/30481/webproperties/UA-30481-1')
+ self.assertEquals(parent_link.target_kind,
+ 'analytics#webproperty')
+
+ def testGetChildLinks(self):
+ """Tests GetChildLinks utility method."""
+
+ child_links = self.feed.entry[0].GetChildLinks()
+ self.assertEquals(len(child_links), 1)
+
+ self.ChildLinkTestHelper(child_links[0])
+
+ def testGetChildLink(self):
+ """Tests getChildLink utility method."""
+
+ child_link = self.feed.entry[0].GetChildLink('analytics#goals')
+ self.ChildLinkTestHelper(child_link)
+
+ child_link = self.feed.entry[0].GetChildLink('foo_bar')
+ self.assertEquals(child_link, None)
+
+ def ChildLinkTestHelper(self, child_link):
+ """Common method to test a child link."""
+
+ self.assertEquals(child_link.rel,
+ 'http://schemas.google.com/ga/2009#child')
+ self.assertEquals(child_link.type,
+ 'application/atom+xml')
+ self.assertEquals(child_link.href,
+ 'https://www.google.com/analytics/feeds/datasources'
+ '/ga/accounts/30481/webproperties/UA-30481-1/profiles/1174/goals')
+ self.assertEquals(child_link.target_kind,
+ 'analytics#goals')
+
+
+class ManagementFeedGoalTest(unittest.TestCase):
+ """Unit test for all Goal elements in Management Feed."""
+
+ def setUp(self):
+ """Retrieves the test XML feed into a DataFeed object."""
+
+ self.feed = atom.core.parse(test_data.ANALYTICS_MGMT_GOAL_FEED,
+ gdata.analytics.data.ManagementFeed)
+
+ def testEntryGoal(self):
+ """Tests Goal class in Google Anlaytics Account Feed."""
+
+ goal = self.feed.entry[0].goal
+ self.assertEquals(goal.number, '1')
+ self.assertEquals(goal.name, 'Completing Order')
+ self.assertEquals(goal.value, '10.0')
+ self.assertEquals(goal.active, 'true')
+
+ def testGoalDestination(self):
+ """Tests Destination class in Google Analytics Account Feed."""
+
+ destination = self.feed.entry[0].goal.destination
+ self.assertEquals(destination.expression, '/purchaseComplete.html')
+ self.assertEquals(destination.case_sensitive, 'false')
+ self.assertEquals(destination.match_type, 'regex')
+ self.assertEquals(destination.step1_required, 'false')
+
+ def testGoalDestinationStep(self):
+ """Tests Step class in Google Analytics Account Feed."""
+
+ step = self.feed.entry[0].goal.destination.step[0]
+ self.assertEquals(step.number, '1')
+ self.assertEquals(step.name, 'View Product Categories')
+ self.assertEquals(step.path, '/Apps|Accessories')
+
+ def testGoalEngagemet(self):
+ """Tests Engagement class in Google Analytics Account Feed."""
+
+ engagement = self.feed.entry[1].goal.engagement
+ self.assertEquals(engagement.type, 'timeOnSite')
+ self.assertEquals(engagement.comparison, '>')
+ self.assertEquals(engagement.threshold_value, '300')
+
+
+class ManagementFeedAdvSegTest(unittest.TestCase):
+ """Unit test for all Advanced Segment elements in Management Feed."""
+
+ def setUp(self):
+ """Retrieves the test XML feed into a DataFeed object."""
+
+ self.feed = atom.core.parse(test_data.ANALYTICS_MGMT_ADV_SEGMENT_FEED,
+ gdata.analytics.data.ManagementFeed)
+
+ def testEntrySegment(self):
+ """Tests Segment class in ManagementEntry class."""
+
+ segment = self.feed.entry[0].segment
+ self.assertEquals(segment.id, 'gaid::0')
+ self.assertEquals(segment.name, 'Sources Form Google')
+
+ def testSegmentDefinition(self):
+ """Tests Definition class in Segment class."""
+
+ definition = self.feed.entry[0].segment.definition
+ self.assertEquals(definition.text, 'ga:source=~^\Qgoogle\E')
+
+
+def suite():
+ """Test Account Feed, Data Feed and Management API Feeds."""
+ return conf.build_suite([
+ AccountFeedTest,
+ DataFeedTest,
+ ManagementFeedProfileTest,
+ ManagementFeedGoalTest,
+ ManagementFeedAdvSegTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/analytics/live_client_test.py b/tests/gdata_tests/analytics/live_client_test.py
new file mode 100644
index 0000000..adadc1c
--- /dev/null
+++ b/tests/gdata_tests/analytics/live_client_test.py
@@ -0,0 +1,129 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2010 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Functional Tests for Google Analytics Account Feed and Data Feed.
+
+AnalyticsClientTest: Tests making live requests to Google Analytics API.
+"""
+
+__author__ = 'api.nickm@google.com (Nick Mihailovski)'
+
+
+import unittest
+import gdata.client
+import gdata.data
+import gdata.gauth
+import gdata.analytics.client
+import gdata.test_config as conf
+
+
+conf.options.register_option(conf.GA_TABLE_ID)
+
+
+class AnalyticsClientTest(unittest.TestCase):
+ """Tests creating an Account Feed query and making a request to the
+ Google Analytics Account Feed."""
+
+ def setUp(self):
+ """Creates an AnalyticsClient object."""
+
+ self.client = None
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.analytics.client.AnalyticsClient()
+ self.client.http_client.debug = True
+
+ conf.configure_client(
+ self.client,
+ 'AnalyticsClientTest',
+ self.client.auth_service)
+
+ def testAccountFeed(self):
+ """Tests if the Account Feed exists."""
+
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_cache(self.client, 'testAccountFeed')
+
+ account_query = gdata.analytics.client.AccountFeedQuery({
+ 'max-results': '1'
+ })
+
+ feed = self.client.GetAccountFeed(account_query)
+ self.assert_(feed.entry is not None)
+
+ properties = [
+ 'ga:accountId',
+ 'ga:accountName',
+ 'ga:profileId',
+ 'ga:webPropertyId',
+ 'ga:currency',
+ 'ga:timezone'
+ ]
+
+ entry = feed.entry[0]
+ for prop in properties:
+ property = entry.GetProperty(prop)
+ self.assertEquals(property.name, prop)
+
+ def testDataFeed(self):
+ """Tests if the Data Feed exists."""
+
+ start_date = '2008-10-01'
+ end_date = '2008-10-02'
+ metrics = 'ga:visits'
+
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_cache(self.client, 'testDataFeed')
+
+ data_query = gdata.analytics.client.DataFeedQuery({
+ 'ids': conf.options.get_value('table_id'),
+ 'start-date': start_date,
+ 'end-date': end_date,
+ 'metrics' : metrics,
+ 'max-results': '1'
+ })
+ feed = self.client.GetDataFeed(data_query)
+
+ self.assert_(feed.entry is not None)
+ self.assertEquals(feed.start_date.text, start_date)
+ self.assertEquals(feed.end_date.text, end_date)
+ self.assertEquals(feed.entry[0].GetMetric(metrics).name, metrics)
+
+ def testManagementFeed(self):
+ """Tests of the Management Feed exists."""
+
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_cache(self.client, 'testManagementFeed')
+
+ account_query = gdata.analytics.client.AccountQuery()
+ feed = self.client.GetManagementFeed(account_query)
+
+ self.assert_(feed.entry is not None)
+
+ def tearDown(self):
+ """Closes client connection."""
+ conf.close_client(self.client)
+
+
+def suite():
+ return conf.build_suite([AnalyticsClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
+
diff --git a/tests/gdata_tests/analytics/query_test.py b/tests/gdata_tests/analytics/query_test.py
new file mode 100644
index 0000000..42b9982
--- /dev/null
+++ b/tests/gdata_tests/analytics/query_test.py
@@ -0,0 +1,166 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2010 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Unit Tests for Google Analytics API query objects.
+
+AnalyticsClientTest: Tests making live requests to Google Analytics API.
+"""
+
+__author__ = 'api.nickm@google.com (Nick Mihailovski)'
+
+
+import unittest
+from gdata.analytics import client
+
+
+class DataExportQueryTest(unittest.TestCase):
+ """Tests making Data Export API Queries."""
+
+ def testAccountFeed(self):
+ """Tests Account Feed queries."""
+ queryTest1 = client.AccountFeedQuery()
+ self.assertEquals(str(queryTest1),
+ 'https://www.google.com/analytics/feeds/accounts/default')
+
+ queryTest2 = client.AccountFeedQuery({'max-results': 50})
+ self.assertEquals(str(queryTest2),
+ 'https://www.google.com/analytics/feeds/accounts/default'
+ '?max-results=50')
+
+ queryTest3 = client.AccountFeedQuery()
+ queryTest3.query['max-results'] = 100
+ self.assertEquals(str(queryTest3),
+ 'https://www.google.com/analytics/feeds/accounts/default'
+ '?max-results=100')
+
+ def testDataFeed(self):
+ """Tests Data Feed queries."""
+ queryTest1 = client.DataFeedQuery()
+ self.assertEquals(str(queryTest1),
+ 'https://www.google.com/analytics/feeds/data')
+
+ queryTest2 = client.DataFeedQuery({'ids': 'ga:1234'})
+ self.assertEquals(str(queryTest2),
+ 'https://www.google.com/analytics/feeds/data?ids=ga%3A1234')
+
+ queryTest3 = client.DataFeedQuery()
+ queryTest3.query['ids'] = 'ga:1234'
+ self.assertEquals(str(queryTest3),
+ 'https://www.google.com/analytics/feeds/data?ids=ga%3A1234')
+
+
+class ManagementQueryTest(unittest.TestCase):
+ """Tests making Management API queries."""
+
+ def setUp(self):
+ self.base_url = 'https://www.google.com/analytics/feeds/datasources/ga'
+
+
+ def testAccountFeedQuery(self):
+ """Tests Account Feed queries."""
+ queryTest1 = client.AccountQuery()
+ self.assertEquals(str(queryTest1),
+ '%s/accounts' % self.base_url)
+
+ queryTest2 = client.AccountQuery({'max-results': 50})
+ self.assertEquals(str(queryTest2),
+ '%s/accounts?max-results=50' % self.base_url)
+
+ def testWebPropertyFeedQuery(self):
+ """Tests Web Property Feed queries."""
+ queryTest1 = client.WebPropertyQuery()
+ self.assertEquals(str(queryTest1),
+ '%s/accounts/~all/webproperties' % self.base_url)
+
+ queryTest2 = client.WebPropertyQuery('123')
+ self.assertEquals(str(queryTest2),
+ '%s/accounts/123/webproperties' % self.base_url)
+
+ queryTest3 = client.WebPropertyQuery('123', {'max-results': 100})
+ self.assertEquals(str(queryTest3),
+ '%s/accounts/123/webproperties?max-results=100' % self.base_url)
+
+ def testProfileFeedQuery(self):
+ """Tests Profile Feed queries."""
+ queryTest1 = client.ProfileQuery()
+ self.assertEquals(str(queryTest1),
+ '%s/accounts/~all/webproperties/~all/profiles' % self.base_url)
+
+ queryTest2 = client.ProfileQuery('123', 'UA-123-1')
+ self.assertEquals(str(queryTest2),
+ '%s/accounts/123/webproperties/UA-123-1/profiles' % self.base_url)
+
+ queryTest3 = client.ProfileQuery('123', 'UA-123-1',
+ {'max-results': 100})
+ self.assertEquals(str(queryTest3),
+ '%s/accounts/123/webproperties/UA-123-1/profiles?max-results=100'
+ % self.base_url)
+
+ queryTest4 = client.ProfileQuery()
+ queryTest4.acct_id = '123'
+ queryTest4.web_prop_id = 'UA-123-1'
+ queryTest4.query['max-results'] = 100
+ self.assertEquals(str(queryTest4),
+ '%s/accounts/123/webproperties/UA-123-1/profiles?max-results=100'
+ % self.base_url)
+
+ def testGoalFeedQuery(self):
+ """Tests Goal Feed queries."""
+ queryTest1 = client.GoalQuery()
+ self.assertEquals(str(queryTest1),
+ '%s/accounts/~all/webproperties/~all/profiles/~all/goals'
+ % self.base_url)
+
+ queryTest2 = client.GoalQuery('123', 'UA-123-1', '555')
+ self.assertEquals(str(queryTest2),
+ '%s/accounts/123/webproperties/UA-123-1/profiles/555/goals'
+ % self.base_url)
+
+ queryTest3 = client.GoalQuery('123', 'UA-123-1', '555',
+ {'max-results': 100})
+ self.assertEquals(str(queryTest3),
+ '%s/accounts/123/webproperties/UA-123-1/profiles/555/goals'
+ '?max-results=100' % self.base_url)
+
+ queryTest4 = client.GoalQuery()
+ queryTest4.acct_id = '123'
+ queryTest4.web_prop_id = 'UA-123-1'
+ queryTest4.profile_id = '555'
+ queryTest4.query['max-results'] = 100
+ self.assertEquals(str(queryTest3),
+ '%s/accounts/123/webproperties/UA-123-1/profiles/555/goals'
+ '?max-results=100' % self.base_url)
+
+ def testAdvSegQuery(self):
+ """Tests Advanced Segment Feed queries."""
+ queryTest1 = client.AdvSegQuery()
+ self.assertEquals(str(queryTest1),
+ '%s/segments'
+ % self.base_url)
+
+ queryTest2 = client.AdvSegQuery({'max-results': 100})
+ self.assertEquals(str(queryTest2),
+ '%s/segments?max-results=100'
+ % self.base_url)
+
+
+def suite():
+ return conf.build_suite([DataExportQueryTest,
+ ManagementQueryTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllEmailLists.pickle b/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllEmailLists.pickle
new file mode 100644
index 0000000..23811f3
--- /dev/null
+++ b/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllEmailLists.pickle
@@ -0,0 +1,190 @@
+(lp0
+(ccopy_reg
+_reconstructor
+p1
+(catom.mock_http
+MockRequest
+p2
+c__builtin__
+object
+p3
+Ntp4
+Rp5
+(dp6
+S'url'
+p7
+g1
+(catom.url
+Url
+p8
+g3
+Ntp9
+Rp10
+(dp11
+S'path'
+p12
+S'/accounts/ClientLogin'
+p13
+sS'host'
+p14
+S'www.google.com'
+p15
+sS'protocol'
+p16
+S'https'
+p17
+sS'port'
+p18
+NsS'params'
+p19
+(dp20
+sbsS'headers'
+p21
+(dp22
+S'Content-Type'
+p23
+S'application/x-www-form-urlencoded'
+p24
+ssS'operation'
+p25
+S'POST'
+p26
+sS'data'
+p27
+S'Passwd=hogehoge&source=AppsClient+%22Unit%22+Tests&service=apps&Email=zzz%40test.shehas.net&accountType=HOSTED_OR_GOOGLE'
+p28
+sbg1
+(catom.mock_http
+MockResponse
+p29
+g3
+Ntp30
+Rp31
+(dp32
+S'body'
+p33
+S'SID=hogehoge\nLSID=hogehoge\nAuth=hogehoge\n'
+p34
+sS'status'
+p35
+I200
+sS'reason'
+p36
+S'OK'
+p37
+sS'_headers'
+p38
+(dp39
+sbtp40
+a(g1
+(g2
+g3
+Ntp41
+Rp42
+(dp43
+g7
+g1
+(g8
+g3
+Ntp44
+Rp45
+(dp46
+g12
+S'/a/feeds/test.shehas.net/emailList/2.0'
+p47
+sg14
+S'apps-apis.google.com'
+p48
+sg16
+S'https'
+p49
+sg18
+Nsg19
+(dp50
+sbsg21
+(dp51
+S'Authorization'
+p52
+S'hogehoge'
+p53
+sS'User-Agent'
+p54
+S'AppsClient "Unit" Tests GData-Python/2.0.2'
+p55
+ssg25
+S'GET'
+p56
+sg27
+Nsbg1
+(g29
+g3
+Ntp57
+Rp58
+(dp59
+g33
+S"<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006' xmlns:gd='http://schemas.google.com/g/2005'><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>EmailLists</title><link rel='next' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?startEmailListName=b100-20091013151051'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0'/><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0'/><openSearch:startIndex>1</openSearch:startIndex><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b000-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b000-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b000-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b000-20091013151051'/><apps:emailList name='b000-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b000-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b001-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b001-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b001-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b001-20091013151051'/><apps:emailList name='b001-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b001-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b002-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b002-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b002-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b002-20091013151051'/><apps:emailList name='b002-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b002-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b003-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b003-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b003-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b003-20091013151051'/><apps:emailList name='b003-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b003-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b004-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b004-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b004-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b004-20091013151051'/><apps:emailList name='b004-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b004-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b005-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b005-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b005-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b005-20091013151051'/><apps:emailList name='b005-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b005-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b006-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b006-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b006-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b006-20091013151051'/><apps:emailList name='b006-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b006-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b007-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b007-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b007-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b007-20091013151051'/><apps:emailList name='b007-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b007-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b008-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b008-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b008-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b008-20091013151051'/><apps:emailList name='b008-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b008-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b009-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b009-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b009-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b009-20091013151051'/><apps:emailList name='b009-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b009-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b010-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b010-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b010-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b010-20091013151051'/><apps:emailList name='b010-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b010-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b011-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b011-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b011-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b011-20091013151051'/><apps:emailList name='b011-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b011-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b012-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b012-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b012-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b012-20091013151051'/><apps:emailList name='b012-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b012-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b013-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b013-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b013-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b013-20091013151051'/><apps:emailList name='b013-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b013-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b014-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b014-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b014-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b014-20091013151051'/><apps:emailList name='b014-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b014-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b015-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b015-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b015-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b015-20091013151051'/><apps:emailList name='b015-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b015-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b016-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b016-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b016-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b016-20091013151051'/><apps:emailList name='b016-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b016-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b017-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b017-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b017-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b017-20091013151051'/><apps:emailList name='b017-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b017-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b018-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b018-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b018-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b018-20091013151051'/><apps:emailList name='b018-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b018-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b019-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b019-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b019-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b019-20091013151051'/><apps:emailList name='b019-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b019-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b020-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b020-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b020-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b020-20091013151051'/><apps:emailList name='b020-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b020-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b021-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b021-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b021-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b021-20091013151051'/><apps:emailList name='b021-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b021-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b022-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b022-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b022-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b022-20091013151051'/><apps:emailList name='b022-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b022-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b023-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b023-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b023-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b023-20091013151051'/><apps:emailList name='b023-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b023-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b024-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b024-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b024-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b024-20091013151051'/><apps:emailList name='b024-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b024-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b025-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b025-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b025-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b025-20091013151051'/><apps:emailList name='b025-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b025-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b026-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b026-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b026-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b026-20091013151051'/><apps:emailList name='b026-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b026-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b027-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b027-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b027-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b027-20091013151051'/><apps:emailList name='b027-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b027-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b028-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b028-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b028-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b028-20091013151051'/><apps:emailList name='b028-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b028-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b029-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b029-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b029-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b029-20091013151051'/><apps:emailList name='b029-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b029-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b030-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b030-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b030-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b030-20091013151051'/><apps:emailList name='b030-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b030-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b031-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b031-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b031-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b031-20091013151051'/><apps:emailList name='b031-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b031-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b032-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b032-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b032-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b032-20091013151051'/><apps:emailList name='b032-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b032-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b033-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b033-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b033-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b033-20091013151051'/><apps:emailList name='b033-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b033-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b034-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b034-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b034-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b034-20091013151051'/><apps:emailList name='b034-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b034-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b035-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b035-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b035-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b035-20091013151051'/><apps:emailList name='b035-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b035-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b036-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b036-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b036-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b036-20091013151051'/><apps:emailList name='b036-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b036-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b037-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b037-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b037-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b037-20091013151051'/><apps:emailList name='b037-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b037-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b038-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b038-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b038-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b038-20091013151051'/><apps:emailList name='b038-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b038-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b039-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b039-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b039-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b039-20091013151051'/><apps:emailList name='b039-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b039-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b040-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b040-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b040-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b040-20091013151051'/><apps:emailList name='b040-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b040-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b041-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b041-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b041-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b041-20091013151051'/><apps:emailList name='b041-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b041-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b042-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b042-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b042-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b042-20091013151051'/><apps:emailList name='b042-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b042-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b043-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b043-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b043-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b043-20091013151051'/><apps:emailList name='b043-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b043-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b044-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b044-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b044-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b044-20091013151051'/><apps:emailList name='b044-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b044-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b045-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b045-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b045-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b045-20091013151051'/><apps:emailList name='b045-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b045-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b046-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b046-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b046-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b046-20091013151051'/><apps:emailList name='b046-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b046-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b047-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b047-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b047-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b047-20091013151051'/><apps:emailList name='b047-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b047-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b048-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b048-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b048-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b048-20091013151051'/><apps:emailList name='b048-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b048-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b049-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b049-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b049-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b049-20091013151051'/><apps:emailList name='b049-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b049-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b050-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b050-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b050-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b050-20091013151051'/><apps:emailList name='b050-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b050-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b051-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b051-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b051-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b051-20091013151051'/><apps:emailList name='b051-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b051-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b052-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b052-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b052-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b052-20091013151051'/><apps:emailList name='b052-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b052-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b053-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b053-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b053-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b053-20091013151051'/><apps:emailList name='b053-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b053-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b054-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b054-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b054-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b054-20091013151051'/><apps:emailList name='b054-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b054-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b055-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b055-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b055-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b055-20091013151051'/><apps:emailList name='b055-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b055-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b056-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b056-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b056-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b056-20091013151051'/><apps:emailList name='b056-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b056-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b057-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b057-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b057-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b057-20091013151051'/><apps:emailList name='b057-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b057-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b058-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b058-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b058-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b058-20091013151051'/><apps:emailList name='b058-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b058-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b059-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b059-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b059-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b059-20091013151051'/><apps:emailList name='b059-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b059-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b060-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b060-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b060-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b060-20091013151051'/><apps:emailList name='b060-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b060-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b061-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b061-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b061-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b061-20091013151051'/><apps:emailList name='b061-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b061-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b062-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b062-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b062-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b062-20091013151051'/><apps:emailList name='b062-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b062-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b063-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b063-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b063-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b063-20091013151051'/><apps:emailList name='b063-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b063-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b064-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b064-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b064-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b064-20091013151051'/><apps:emailList name='b064-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b064-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b065-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b065-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b065-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b065-20091013151051'/><apps:emailList name='b065-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b065-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b066-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b066-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b066-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b066-20091013151051'/><apps:emailList name='b066-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b066-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b067-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b067-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b067-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b067-20091013151051'/><apps:emailList name='b067-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b067-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b068-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b068-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b068-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b068-20091013151051'/><apps:emailList name='b068-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b068-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b069-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b069-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b069-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b069-20091013151051'/><apps:emailList name='b069-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b069-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b070-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b070-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b070-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b070-20091013151051'/><apps:emailList name='b070-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b070-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b071-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b071-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b071-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b071-20091013151051'/><apps:emailList name='b071-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b071-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b072-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b072-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b072-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b072-20091013151051'/><apps:emailList name='b072-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b072-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b073-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b073-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b073-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b073-20091013151051'/><apps:emailList name='b073-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b073-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b074-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b074-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b074-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b074-20091013151051'/><apps:emailList name='b074-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b074-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b075-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b075-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b075-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b075-20091013151051'/><apps:emailList name='b075-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b075-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b076-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b076-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b076-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b076-20091013151051'/><apps:emailList name='b076-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b076-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b077-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b077-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b077-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b077-20091013151051'/><apps:emailList name='b077-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b077-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b078-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b078-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b078-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b078-20091013151051'/><apps:emailList name='b078-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b078-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b079-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b079-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b079-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b079-20091013151051'/><apps:emailList name='b079-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b079-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b080-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b080-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b080-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b080-20091013151051'/><apps:emailList name='b080-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b080-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b081-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b081-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b081-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b081-20091013151051'/><apps:emailList name='b081-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b081-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b082-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b082-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b082-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b082-20091013151051'/><apps:emailList name='b082-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b082-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b083-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b083-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b083-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b083-20091013151051'/><apps:emailList name='b083-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b083-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b084-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b084-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b084-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b084-20091013151051'/><apps:emailList name='b084-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b084-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b085-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b085-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b085-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b085-20091013151051'/><apps:emailList name='b085-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b085-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b086-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b086-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b086-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b086-20091013151051'/><apps:emailList name='b086-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b086-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b087-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b087-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b087-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b087-20091013151051'/><apps:emailList name='b087-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b087-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b088-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b088-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b088-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b088-20091013151051'/><apps:emailList name='b088-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b088-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b089-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b089-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b089-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b089-20091013151051'/><apps:emailList name='b089-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b089-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b090-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b090-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b090-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b090-20091013151051'/><apps:emailList name='b090-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b090-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b091-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b091-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b091-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b091-20091013151051'/><apps:emailList name='b091-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b091-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b092-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b092-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b092-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b092-20091013151051'/><apps:emailList name='b092-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b092-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b093-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b093-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b093-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b093-20091013151051'/><apps:emailList name='b093-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b093-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b094-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b094-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b094-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b094-20091013151051'/><apps:emailList name='b094-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b094-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b095-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b095-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b095-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b095-20091013151051'/><apps:emailList name='b095-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b095-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b096-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b096-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b096-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b096-20091013151051'/><apps:emailList name='b096-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b096-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b097-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b097-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b097-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b097-20091013151051'/><apps:emailList name='b097-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b097-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b098-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b098-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b098-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b098-20091013151051'/><apps:emailList name='b098-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b098-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b099-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b099-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b099-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b099-20091013151051'/><apps:emailList name='b099-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b099-20091013151051/recipient/'/></entry></feed>"
+p60
+sg35
+I200
+sg36
+S'OK'
+p61
+sg38
+(dp62
+sbtp63
+a(g1
+(g2
+g3
+Ntp64
+Rp65
+(dp66
+g7
+g1
+(g8
+g3
+Ntp67
+Rp68
+(dp69
+g12
+S'/a/feeds/test.shehas.net/emailList/2.0'
+p70
+sg14
+S'apps-apis.google.com'
+p71
+sg16
+S'https'
+p72
+sg18
+Nsg19
+(dp73
+S'startEmailListName'
+p74
+S'b100-20091013151051'
+p75
+ssbsg21
+(dp76
+g52
+g53
+sg54
+g55
+ssg25
+g56
+sg27
+Nsbg1
+(g29
+g3
+Ntp77
+Rp78
+(dp79
+g33
+S"<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006' xmlns:gd='http://schemas.google.com/g/2005'><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>EmailLists</title><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0'/><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?startEmailListName=b100-20091013151051'/><openSearch:startIndex>1</openSearch:startIndex><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b100-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b100-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b100-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b100-20091013151051'/><apps:emailList name='b100-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b100-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>b101-20091013151051</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051'/><apps:emailList name='b101-20091013151051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/info</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>info</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/info'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/info'/><apps:emailList name='info'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/info/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/testgroup2</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>testgroup2</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/testgroup2'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/testgroup2'/><apps:emailList name='testgroup2'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/testgroup2/recipient/'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/testgroup</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList'/><title type='text'>testgroup</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/testgroup'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/testgroup'/><apps:emailList name='testgroup'/><gd:feedLink rel='http://schemas.google.com/apps/2006#emailList.recipients' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/testgroup/recipient/'/></entry></feed>"
+p80
+sg35
+I200
+sg36
+S'OK'
+p81
+sg38
+(dp82
+sbtp83
+a.
diff --git a/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllNicknames.pickle b/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllNicknames.pickle
new file mode 100644
index 0000000..d552482
--- /dev/null
+++ b/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllNicknames.pickle
@@ -0,0 +1,190 @@
+(lp0
+(ccopy_reg
+_reconstructor
+p1
+(catom.mock_http
+MockRequest
+p2
+c__builtin__
+object
+p3
+Ntp4
+Rp5
+(dp6
+S'url'
+p7
+g1
+(catom.url
+Url
+p8
+g3
+Ntp9
+Rp10
+(dp11
+S'path'
+p12
+S'/accounts/ClientLogin'
+p13
+sS'host'
+p14
+S'www.google.com'
+p15
+sS'protocol'
+p16
+S'https'
+p17
+sS'port'
+p18
+NsS'params'
+p19
+(dp20
+sbsS'headers'
+p21
+(dp22
+S'Content-Type'
+p23
+S'application/x-www-form-urlencoded'
+p24
+ssS'operation'
+p25
+S'POST'
+p26
+sS'data'
+p27
+S'Passwd=hogehoge&source=AppsClient+%22Unit%22+Tests&service=apps&Email=zzz%40test.shehas.net&accountType=HOSTED_OR_GOOGLE'
+p28
+sbg1
+(catom.mock_http
+MockResponse
+p29
+g3
+Ntp30
+Rp31
+(dp32
+S'body'
+p33
+S'SID=hogehoge\nLSID=hogehoge\nAuth=hogehoge\n'
+p34
+sS'status'
+p35
+I200
+sS'reason'
+p36
+S'OK'
+p37
+sS'_headers'
+p38
+(dp39
+sbtp40
+a(g1
+(g2
+g3
+Ntp41
+Rp42
+(dp43
+g7
+g1
+(g8
+g3
+Ntp44
+Rp45
+(dp46
+g12
+S'/a/feeds/test.shehas.net/nickname/2.0'
+p47
+sg14
+S'apps-apis.google.com'
+p48
+sg16
+S'https'
+p49
+sg18
+Nsg19
+(dp50
+sbsg21
+(dp51
+S'Authorization'
+p52
+S'hogehoge'
+p53
+sS'User-Agent'
+p54
+S'AppsClient "Unit" Tests GData-Python/2.0.2'
+p55
+ssg25
+S'GET'
+p56
+sg27
+Nsbg1
+(g29
+g3
+Ntp57
+Rp58
+(dp59
+g33
+S"<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006'><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>Nicknames</title><link rel='next' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?startNickname=b100-20091013145336'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0'/><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0'/><openSearch:startIndex>1</openSearch:startIndex><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b000-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b000-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b000-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b000-20091013145336'/><apps:nickname name='b000-20091013145336'/><apps:login userName='b000-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b001-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b001-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b001-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b001-20091013145336'/><apps:nickname name='b001-20091013145336'/><apps:login userName='b001-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b002-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b002-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b002-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b002-20091013145336'/><apps:nickname name='b002-20091013145336'/><apps:login userName='b002-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b003-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b003-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b003-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b003-20091013145336'/><apps:nickname name='b003-20091013145336'/><apps:login userName='b003-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b004-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b004-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b004-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b004-20091013145336'/><apps:nickname name='b004-20091013145336'/><apps:login userName='b004-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b005-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b005-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b005-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b005-20091013145336'/><apps:nickname name='b005-20091013145336'/><apps:login userName='b005-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b006-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b006-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b006-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b006-20091013145336'/><apps:nickname name='b006-20091013145336'/><apps:login userName='b006-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b007-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b007-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b007-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b007-20091013145336'/><apps:nickname name='b007-20091013145336'/><apps:login userName='b007-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b008-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b008-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b008-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b008-20091013145336'/><apps:nickname name='b008-20091013145336'/><apps:login userName='b008-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b009-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b009-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b009-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b009-20091013145336'/><apps:nickname name='b009-20091013145336'/><apps:login userName='b009-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b010-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b010-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b010-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b010-20091013145336'/><apps:nickname name='b010-20091013145336'/><apps:login userName='b010-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b011-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b011-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b011-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b011-20091013145336'/><apps:nickname name='b011-20091013145336'/><apps:login userName='b011-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b012-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b012-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b012-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b012-20091013145336'/><apps:nickname name='b012-20091013145336'/><apps:login userName='b012-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b013-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b013-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b013-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b013-20091013145336'/><apps:nickname name='b013-20091013145336'/><apps:login userName='b013-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b014-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b014-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b014-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b014-20091013145336'/><apps:nickname name='b014-20091013145336'/><apps:login userName='b014-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b015-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b015-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b015-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b015-20091013145336'/><apps:nickname name='b015-20091013145336'/><apps:login userName='b015-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b016-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b016-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b016-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b016-20091013145336'/><apps:nickname name='b016-20091013145336'/><apps:login userName='b016-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b017-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b017-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b017-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b017-20091013145336'/><apps:nickname name='b017-20091013145336'/><apps:login userName='b017-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b018-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b018-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b018-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b018-20091013145336'/><apps:nickname name='b018-20091013145336'/><apps:login userName='b018-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b019-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b019-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b019-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b019-20091013145336'/><apps:nickname name='b019-20091013145336'/><apps:login userName='b019-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b020-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b020-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b020-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b020-20091013145336'/><apps:nickname name='b020-20091013145336'/><apps:login userName='b020-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b021-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b021-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b021-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b021-20091013145336'/><apps:nickname name='b021-20091013145336'/><apps:login userName='b021-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b022-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b022-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b022-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b022-20091013145336'/><apps:nickname name='b022-20091013145336'/><apps:login userName='b022-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b023-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b023-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b023-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b023-20091013145336'/><apps:nickname name='b023-20091013145336'/><apps:login userName='b023-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b024-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b024-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b024-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b024-20091013145336'/><apps:nickname name='b024-20091013145336'/><apps:login userName='b024-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b025-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b025-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b025-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b025-20091013145336'/><apps:nickname name='b025-20091013145336'/><apps:login userName='b025-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b026-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b026-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b026-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b026-20091013145336'/><apps:nickname name='b026-20091013145336'/><apps:login userName='b026-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b027-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b027-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b027-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b027-20091013145336'/><apps:nickname name='b027-20091013145336'/><apps:login userName='b027-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b028-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b028-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b028-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b028-20091013145336'/><apps:nickname name='b028-20091013145336'/><apps:login userName='b028-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b029-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b029-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b029-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b029-20091013145336'/><apps:nickname name='b029-20091013145336'/><apps:login userName='b029-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b030-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b030-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b030-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b030-20091013145336'/><apps:nickname name='b030-20091013145336'/><apps:login userName='b030-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b031-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b031-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b031-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b031-20091013145336'/><apps:nickname name='b031-20091013145336'/><apps:login userName='b031-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b032-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b032-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b032-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b032-20091013145336'/><apps:nickname name='b032-20091013145336'/><apps:login userName='b032-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b033-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b033-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b033-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b033-20091013145336'/><apps:nickname name='b033-20091013145336'/><apps:login userName='b033-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b034-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b034-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b034-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b034-20091013145336'/><apps:nickname name='b034-20091013145336'/><apps:login userName='b034-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b035-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b035-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b035-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b035-20091013145336'/><apps:nickname name='b035-20091013145336'/><apps:login userName='b035-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b036-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b036-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b036-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b036-20091013145336'/><apps:nickname name='b036-20091013145336'/><apps:login userName='b036-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b037-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b037-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b037-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b037-20091013145336'/><apps:nickname name='b037-20091013145336'/><apps:login userName='b037-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b038-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b038-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b038-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b038-20091013145336'/><apps:nickname name='b038-20091013145336'/><apps:login userName='b038-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b039-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b039-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b039-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b039-20091013145336'/><apps:nickname name='b039-20091013145336'/><apps:login userName='b039-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b040-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b040-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b040-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b040-20091013145336'/><apps:nickname name='b040-20091013145336'/><apps:login userName='b040-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b041-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b041-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b041-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b041-20091013145336'/><apps:nickname name='b041-20091013145336'/><apps:login userName='b041-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b042-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b042-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b042-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b042-20091013145336'/><apps:nickname name='b042-20091013145336'/><apps:login userName='b042-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b043-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b043-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b043-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b043-20091013145336'/><apps:nickname name='b043-20091013145336'/><apps:login userName='b043-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b044-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b044-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b044-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b044-20091013145336'/><apps:nickname name='b044-20091013145336'/><apps:login userName='b044-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b045-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b045-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b045-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b045-20091013145336'/><apps:nickname name='b045-20091013145336'/><apps:login userName='b045-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b046-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b046-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b046-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b046-20091013145336'/><apps:nickname name='b046-20091013145336'/><apps:login userName='b046-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b047-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b047-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b047-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b047-20091013145336'/><apps:nickname name='b047-20091013145336'/><apps:login userName='b047-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b048-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b048-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b048-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b048-20091013145336'/><apps:nickname name='b048-20091013145336'/><apps:login userName='b048-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b049-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b049-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b049-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b049-20091013145336'/><apps:nickname name='b049-20091013145336'/><apps:login userName='b049-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b050-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b050-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b050-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b050-20091013145336'/><apps:nickname name='b050-20091013145336'/><apps:login userName='b050-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b051-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b051-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b051-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b051-20091013145336'/><apps:nickname name='b051-20091013145336'/><apps:login userName='b051-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b052-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b052-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b052-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b052-20091013145336'/><apps:nickname name='b052-20091013145336'/><apps:login userName='b052-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b053-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b053-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b053-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b053-20091013145336'/><apps:nickname name='b053-20091013145336'/><apps:login userName='b053-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b054-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b054-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b054-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b054-20091013145336'/><apps:nickname name='b054-20091013145336'/><apps:login userName='b054-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b055-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b055-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b055-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b055-20091013145336'/><apps:nickname name='b055-20091013145336'/><apps:login userName='b055-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b056-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b056-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b056-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b056-20091013145336'/><apps:nickname name='b056-20091013145336'/><apps:login userName='b056-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b057-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b057-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b057-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b057-20091013145336'/><apps:nickname name='b057-20091013145336'/><apps:login userName='b057-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b058-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b058-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b058-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b058-20091013145336'/><apps:nickname name='b058-20091013145336'/><apps:login userName='b058-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b059-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b059-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b059-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b059-20091013145336'/><apps:nickname name='b059-20091013145336'/><apps:login userName='b059-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b060-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b060-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b060-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b060-20091013145336'/><apps:nickname name='b060-20091013145336'/><apps:login userName='b060-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b061-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b061-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b061-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b061-20091013145336'/><apps:nickname name='b061-20091013145336'/><apps:login userName='b061-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b062-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b062-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b062-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b062-20091013145336'/><apps:nickname name='b062-20091013145336'/><apps:login userName='b062-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b063-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b063-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b063-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b063-20091013145336'/><apps:nickname name='b063-20091013145336'/><apps:login userName='b063-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b064-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b064-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b064-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b064-20091013145336'/><apps:nickname name='b064-20091013145336'/><apps:login userName='b064-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b065-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b065-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b065-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b065-20091013145336'/><apps:nickname name='b065-20091013145336'/><apps:login userName='b065-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b066-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b066-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b066-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b066-20091013145336'/><apps:nickname name='b066-20091013145336'/><apps:login userName='b066-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b067-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b067-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b067-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b067-20091013145336'/><apps:nickname name='b067-20091013145336'/><apps:login userName='b067-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b068-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b068-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b068-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b068-20091013145336'/><apps:nickname name='b068-20091013145336'/><apps:login userName='b068-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b069-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b069-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b069-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b069-20091013145336'/><apps:nickname name='b069-20091013145336'/><apps:login userName='b069-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b070-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b070-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b070-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b070-20091013145336'/><apps:nickname name='b070-20091013145336'/><apps:login userName='b070-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b071-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b071-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b071-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b071-20091013145336'/><apps:nickname name='b071-20091013145336'/><apps:login userName='b071-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b072-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b072-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b072-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b072-20091013145336'/><apps:nickname name='b072-20091013145336'/><apps:login userName='b072-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b073-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b073-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b073-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b073-20091013145336'/><apps:nickname name='b073-20091013145336'/><apps:login userName='b073-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b074-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b074-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b074-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b074-20091013145336'/><apps:nickname name='b074-20091013145336'/><apps:login userName='b074-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b075-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b075-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b075-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b075-20091013145336'/><apps:nickname name='b075-20091013145336'/><apps:login userName='b075-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b076-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b076-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b076-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b076-20091013145336'/><apps:nickname name='b076-20091013145336'/><apps:login userName='b076-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b077-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b077-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b077-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b077-20091013145336'/><apps:nickname name='b077-20091013145336'/><apps:login userName='b077-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b078-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b078-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b078-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b078-20091013145336'/><apps:nickname name='b078-20091013145336'/><apps:login userName='b078-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b079-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b079-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b079-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b079-20091013145336'/><apps:nickname name='b079-20091013145336'/><apps:login userName='b079-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b080-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b080-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b080-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b080-20091013145336'/><apps:nickname name='b080-20091013145336'/><apps:login userName='b080-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b081-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b081-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b081-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b081-20091013145336'/><apps:nickname name='b081-20091013145336'/><apps:login userName='b081-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b082-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b082-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b082-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b082-20091013145336'/><apps:nickname name='b082-20091013145336'/><apps:login userName='b082-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b083-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b083-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b083-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b083-20091013145336'/><apps:nickname name='b083-20091013145336'/><apps:login userName='b083-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b084-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b084-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b084-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b084-20091013145336'/><apps:nickname name='b084-20091013145336'/><apps:login userName='b084-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b085-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b085-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b085-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b085-20091013145336'/><apps:nickname name='b085-20091013145336'/><apps:login userName='b085-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b086-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b086-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b086-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b086-20091013145336'/><apps:nickname name='b086-20091013145336'/><apps:login userName='b086-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b087-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b087-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b087-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b087-20091013145336'/><apps:nickname name='b087-20091013145336'/><apps:login userName='b087-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b088-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b088-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b088-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b088-20091013145336'/><apps:nickname name='b088-20091013145336'/><apps:login userName='b088-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b089-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b089-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b089-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b089-20091013145336'/><apps:nickname name='b089-20091013145336'/><apps:login userName='b089-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b090-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b090-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b090-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b090-20091013145336'/><apps:nickname name='b090-20091013145336'/><apps:login userName='b090-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b091-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b091-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b091-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b091-20091013145336'/><apps:nickname name='b091-20091013145336'/><apps:login userName='b091-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b092-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b092-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b092-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b092-20091013145336'/><apps:nickname name='b092-20091013145336'/><apps:login userName='b092-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b093-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b093-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b093-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b093-20091013145336'/><apps:nickname name='b093-20091013145336'/><apps:login userName='b093-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b094-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b094-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b094-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b094-20091013145336'/><apps:nickname name='b094-20091013145336'/><apps:login userName='b094-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b095-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b095-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b095-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b095-20091013145336'/><apps:nickname name='b095-20091013145336'/><apps:login userName='b095-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b096-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b096-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b096-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b096-20091013145336'/><apps:nickname name='b096-20091013145336'/><apps:login userName='b096-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b097-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b097-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b097-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b097-20091013145336'/><apps:nickname name='b097-20091013145336'/><apps:login userName='b097-20091001132401'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b098-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b098-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b098-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b098-20091013145336'/><apps:nickname name='b098-20091013145336'/><apps:login userName='john.amin'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b099-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b099-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b099-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b099-20091013145336'/><apps:nickname name='b099-20091013145336'/><apps:login userName='john.doe'/></entry></feed>"
+p60
+sg35
+I200
+sg36
+S'OK'
+p61
+sg38
+(dp62
+sbtp63
+a(g1
+(g2
+g3
+Ntp64
+Rp65
+(dp66
+g7
+g1
+(g8
+g3
+Ntp67
+Rp68
+(dp69
+g12
+S'/a/feeds/test.shehas.net/nickname/2.0'
+p70
+sg14
+S'apps-apis.google.com'
+p71
+sg16
+S'https'
+p72
+sg18
+Nsg19
+(dp73
+S'startNickname'
+p74
+S'b100-20091013145336'
+p75
+ssbsg21
+(dp76
+g52
+g53
+sg54
+g55
+ssg25
+g56
+sg27
+Nsbg1
+(g29
+g3
+Ntp77
+Rp78
+(dp79
+g33
+S"<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006'><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>Nicknames</title><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0'/><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?startNickname=b100-20091013145336'/><openSearch:startIndex>1</openSearch:startIndex><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b100-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b100-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b100-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b100-20091013145336'/><apps:nickname name='b100-20091013145336'/><apps:login userName='john'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b101-20091013145336</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#nickname'/><title type='text'>b101-20091013145336</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b101-20091013145336'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0/b101-20091013145336'/><apps:nickname name='b101-20091013145336'/><apps:login userName='zzz'/></entry></feed>"
+p80
+sg35
+I200
+sg36
+S'OK'
+p81
+sg38
+(dp82
+sbtp83
+a.
\ No newline at end of file
diff --git a/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllRecipients.pickle b/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllRecipients.pickle
new file mode 100644
index 0000000..3144459
--- /dev/null
+++ b/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllRecipients.pickle
@@ -0,0 +1,190 @@
+(lp0
+(ccopy_reg
+_reconstructor
+p1
+(catom.mock_http
+MockRequest
+p2
+c__builtin__
+object
+p3
+Ntp4
+Rp5
+(dp6
+S'url'
+p7
+g1
+(catom.url
+Url
+p8
+g3
+Ntp9
+Rp10
+(dp11
+S'path'
+p12
+S'/accounts/ClientLogin'
+p13
+sS'host'
+p14
+S'www.google.com'
+p15
+sS'protocol'
+p16
+S'https'
+p17
+sS'port'
+p18
+NsS'params'
+p19
+(dp20
+sbsS'headers'
+p21
+(dp22
+S'Content-Type'
+p23
+S'application/x-www-form-urlencoded'
+p24
+ssS'operation'
+p25
+S'POST'
+p26
+sS'data'
+p27
+S'Passwd=hogehoge&source=AppsClient+%22Unit%22+Tests&service=apps&Email=zzz%40test.shehas.net&accountType=HOSTED_OR_GOOGLE'
+p28
+sbg1
+(catom.mock_http
+MockResponse
+p29
+g3
+Ntp30
+Rp31
+(dp32
+S'body'
+p33
+S'SID=hogehoge\nLSID=hogehoge\nAuth=hogehoge\n'
+p34
+sS'status'
+p35
+I200
+sS'reason'
+p36
+S'OK'
+p37
+sS'_headers'
+p38
+(dp39
+sbtp40
+a(g1
+(g2
+g3
+Ntp41
+Rp42
+(dp43
+g7
+g1
+(g8
+g3
+Ntp44
+Rp45
+(dp46
+g12
+S'/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient'
+p47
+sg14
+S'apps-apis.google.com'
+p48
+sg16
+S'https'
+p49
+sg18
+Nsg19
+(dp50
+sbsg21
+(dp51
+S'Authorization'
+p52
+S'hogehoge'
+p53
+sS'User-Agent'
+p54
+S'AppsClient "Unit" Tests GData-Python/2.0.2'
+p55
+ssg25
+S'GET'
+p56
+sg27
+Nsbg1
+(g29
+g3
+Ntp57
+Rp58
+(dp59
+g33
+S"<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006' xmlns:gd='http://schemas.google.com/g/2005'><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>Recipients for email list b101-20091013151051</title><link rel='next' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient?startRecipient=john%40test.shehas.net'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient'/><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient'/><openSearch:startIndex>1</openSearch:startIndex><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b000-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b000-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b000-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b000-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b000-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b001-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b001-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b001-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b001-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b001-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b002-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b002-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b002-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b002-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b002-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b003-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b003-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b003-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b003-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b003-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b004-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b004-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b004-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b004-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b004-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b005-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b005-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b005-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b005-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b005-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b006-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b006-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b006-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b006-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b006-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b007-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b007-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b007-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b007-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b007-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b008-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b008-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b008-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b008-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b008-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b009-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b009-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b009-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b009-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b009-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b010-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b010-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b010-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b010-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b010-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b011-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b011-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b011-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b011-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b011-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b012-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b012-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b012-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b012-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b012-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b013-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b013-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b013-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b013-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b013-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b014-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b014-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b014-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b014-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b014-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b015-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b015-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b015-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b015-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b015-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b016-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b016-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b016-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b016-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b016-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b017-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b017-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b017-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b017-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b017-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b018-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b018-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b018-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b018-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b018-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b019-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b019-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b019-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b019-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b019-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b020-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b020-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b020-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b020-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b020-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b021-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b021-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b021-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b021-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b021-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b022-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b022-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b022-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b022-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b022-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b023-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b023-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b023-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b023-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b023-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b024-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b024-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b024-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b024-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b024-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b025-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b025-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b025-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b025-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b025-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b026-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b026-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b026-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b026-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b026-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b027-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b027-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b027-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b027-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b027-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b028-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b028-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b028-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b028-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b028-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b029-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b029-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b029-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b029-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b029-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b030-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b030-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b030-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b030-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b030-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b031-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b031-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b031-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b031-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b031-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b032-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b032-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b032-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b032-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b032-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b033-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b033-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b033-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b033-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b033-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b034-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b034-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b034-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b034-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b034-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b035-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b035-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b035-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b035-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b035-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b036-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b036-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b036-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b036-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b036-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b037-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b037-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b037-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b037-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b037-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b038-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b038-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b038-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b038-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b038-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b039-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b039-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b039-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b039-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b039-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b040-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b040-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b040-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b040-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b040-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b041-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b041-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b041-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b041-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b041-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b042-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b042-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b042-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b042-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b042-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b043-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b043-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b043-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b043-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b043-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b044-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b044-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b044-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b044-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b044-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b045-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b045-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b045-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b045-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b045-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b046-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b046-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b046-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b046-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b046-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b047-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b047-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b047-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b047-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b047-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b048-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b048-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b048-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b048-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b048-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b049-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b049-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b049-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b049-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b049-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b050-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b050-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b050-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b050-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b050-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b051-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b051-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b051-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b051-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b051-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b052-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b052-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b052-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b052-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b052-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b053-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b053-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b053-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b053-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b053-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b054-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b054-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b054-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b054-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b054-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b055-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b055-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b055-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b055-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b055-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b056-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b056-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b056-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b056-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b056-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b057-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b057-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b057-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b057-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b057-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b058-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b058-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b058-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b058-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b058-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b059-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b059-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b059-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b059-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b059-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b060-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b060-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b060-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b060-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b060-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b061-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b061-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b061-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b061-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b061-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b062-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b062-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b062-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b062-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b062-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b063-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b063-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b063-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b063-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b063-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b064-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b064-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b064-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b064-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b064-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b065-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b065-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b065-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b065-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b065-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b066-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b066-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b066-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b066-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b066-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b067-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b067-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b067-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b067-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b067-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b068-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b068-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b068-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b068-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b068-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b069-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b069-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b069-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b069-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b069-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b070-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b070-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b070-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b070-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b070-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b071-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b071-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b071-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b071-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b071-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b072-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b072-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b072-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b072-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b072-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b073-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b073-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b073-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b073-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b073-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b074-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b074-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b074-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b074-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b074-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b075-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b075-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b075-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b075-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b075-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b076-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b076-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b076-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b076-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b076-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b077-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b077-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b077-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b077-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b077-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b078-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b078-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b078-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b078-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b078-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b079-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b079-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b079-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b079-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b079-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b080-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b080-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b080-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b080-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b080-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b081-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b081-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b081-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b081-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b081-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b082-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b082-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b082-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b082-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b082-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b083-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b083-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b083-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b083-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b083-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b084-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b084-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b084-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b084-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b084-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b085-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b085-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b085-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b085-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b085-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b086-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b086-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b086-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b086-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b086-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b087-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b087-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b087-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b087-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b087-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b088-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b088-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b088-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b088-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b088-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b089-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b089-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b089-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b089-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b089-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b090-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b090-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b090-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b090-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b090-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b091-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b091-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b091-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b091-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b091-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b092-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b092-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b092-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b092-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b092-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b093-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b093-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b093-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b093-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b093-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b094-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b094-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b094-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b094-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b094-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b095-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b095-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b095-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b095-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b095-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b096-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b096-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b096-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b096-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b096-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b097-20091001132401%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>b097-20091001132401@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b097-20091001132401%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/b097-20091001132401%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='b097-20091001132401@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/john.amin%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>john.amin@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/john.amin%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/john.amin%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='john.amin@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/john.doe%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>john.doe@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/john.doe%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/john.doe%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='john.doe@test.shehas.net'/></entry></feed>"
+p60
+sg35
+I200
+sg36
+S'OK'
+p61
+sg38
+(dp62
+sbtp63
+a(g1
+(g2
+g3
+Ntp64
+Rp65
+(dp66
+g7
+g1
+(g8
+g3
+Ntp67
+Rp68
+(dp69
+g12
+S'/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient'
+p70
+sg14
+S'apps-apis.google.com'
+p71
+sg16
+S'https'
+p72
+sg18
+Nsg19
+(dp73
+S'startRecipient'
+p74
+S'john@test.shehas.net'
+p75
+ssbsg21
+(dp76
+g52
+g53
+sg54
+g55
+ssg25
+g56
+sg27
+Nsbg1
+(g29
+g3
+Ntp77
+Rp78
+(dp79
+g33
+S"<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006' xmlns:gd='http://schemas.google.com/g/2005'><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>Recipients for email list b101-20091013151051</title><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient'/><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient?startRecipient=john%40test.shehas.net'/><openSearch:startIndex>1</openSearch:startIndex><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/john%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>john@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/john%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/john%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='john@test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/zzz%40test.shehas.net</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#emailList.recipient'/><title type='text'>zzz@test.shehas.net</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/zzz%40test.shehas.net'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0/b101-20091013151051/recipient/zzz%40test.shehas.net'/><gd:who rel='http://schemas.google.com/apps/2006#emailList.recipient' email='zzz@test.shehas.net'/></entry></feed>"
+p80
+sg35
+I200
+sg36
+S'OK'
+p81
+sg38
+(dp82
+sbtp83
+a.
\ No newline at end of file
diff --git a/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllUsers.pickle b/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllUsers.pickle
new file mode 100644
index 0000000..19aa366
--- /dev/null
+++ b/tests/gdata_tests/apps/AppsServiceTestForGetGeneratorForAllUsers.pickle
@@ -0,0 +1,190 @@
+(lp0
+(ccopy_reg
+_reconstructor
+p1
+(catom.mock_http
+MockRequest
+p2
+c__builtin__
+object
+p3
+Ntp4
+Rp5
+(dp6
+S'url'
+p7
+g1
+(catom.url
+Url
+p8
+g3
+Ntp9
+Rp10
+(dp11
+S'path'
+p12
+S'/accounts/ClientLogin'
+p13
+sS'host'
+p14
+S'www.google.com'
+p15
+sS'protocol'
+p16
+S'https'
+p17
+sS'port'
+p18
+NsS'params'
+p19
+(dp20
+sbsS'headers'
+p21
+(dp22
+S'Content-Type'
+p23
+S'application/x-www-form-urlencoded'
+p24
+ssS'operation'
+p25
+S'POST'
+p26
+sS'data'
+p27
+S'Passwd=hogehoge&source=AppsClient+%22Unit%22+Tests&service=apps&Email=zzz%40test.shehas.net&accountType=HOSTED_OR_GOOGLE'
+p28
+sbg1
+(catom.mock_http
+MockResponse
+p29
+g3
+Ntp30
+Rp31
+(dp32
+S'body'
+p33
+S'SID=hogehoge\nLSID=hogehoge\nAuth=hogehoge\n'
+p34
+sS'status'
+p35
+I200
+sS'reason'
+p36
+S'OK'
+p37
+sS'_headers'
+p38
+(dp39
+sbtp40
+a(g1
+(g2
+g3
+Ntp41
+Rp42
+(dp43
+g7
+g1
+(g8
+g3
+Ntp44
+Rp45
+(dp46
+g12
+S'/a/feeds/test.shehas.net/user/2.0'
+p47
+sg14
+S'apps-apis.google.com'
+p48
+sg16
+S'https'
+p49
+sg18
+Nsg19
+(dp50
+sbsg21
+(dp51
+S'Authorization'
+p52
+S'hogehoge'
+p53
+sS'User-Agent'
+p54
+S'AppsClient "Unit" Tests GData-Python/2.0.2'
+p55
+ssg25
+S'GET'
+p56
+sg27
+Nsbg1
+(g29
+g3
+Ntp57
+Rp58
+(dp59
+g33
+S"<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006' xmlns:gd='http://schemas.google.com/g/2005'><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>Users</title><link rel='next' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0?startUsername=john'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0'/><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0'/><openSearch:startIndex>1</openSearch:startIndex><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b000-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b000-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b000-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b000-20091001132401'/><apps:login userName='b000-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b000-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b000-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b001-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b001-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b001-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b001-20091001132401'/><apps:login userName='b001-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b001-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b001-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b002-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b002-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b002-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b002-20091001132401'/><apps:login userName='b002-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b002-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b002-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b003-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b003-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b003-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b003-20091001132401'/><apps:login userName='b003-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b003-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b003-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b004-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b004-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b004-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b004-20091001132401'/><apps:login userName='b004-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b004-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b004-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b005-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b005-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b005-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b005-20091001132401'/><apps:login userName='b005-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b005-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b005-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b006-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b006-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b006-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b006-20091001132401'/><apps:login userName='b006-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b006-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b006-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b007-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b007-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b007-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b007-20091001132401'/><apps:login userName='b007-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b007-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b007-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b008-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b008-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b008-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b008-20091001132401'/><apps:login userName='b008-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b008-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b008-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b009-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b009-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b009-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b009-20091001132401'/><apps:login userName='b009-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b009-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b009-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b010-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b010-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b010-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b010-20091001132401'/><apps:login userName='b010-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b010-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b010-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b011-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b011-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b011-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b011-20091001132401'/><apps:login userName='b011-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b011-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b011-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b012-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b012-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b012-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b012-20091001132401'/><apps:login userName='b012-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b012-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b012-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b013-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b013-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b013-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b013-20091001132401'/><apps:login userName='b013-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b013-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b013-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b014-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b014-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b014-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b014-20091001132401'/><apps:login userName='b014-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b014-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b014-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b015-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b015-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b015-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b015-20091001132401'/><apps:login userName='b015-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b015-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b015-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b016-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b016-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b016-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b016-20091001132401'/><apps:login userName='b016-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b016-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b016-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b017-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b017-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b017-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b017-20091001132401'/><apps:login userName='b017-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b017-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b017-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b018-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b018-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b018-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b018-20091001132401'/><apps:login userName='b018-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b018-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b018-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b019-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b019-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b019-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b019-20091001132401'/><apps:login userName='b019-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b019-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b019-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b020-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b020-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b020-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b020-20091001132401'/><apps:login userName='b020-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b020-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b020-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b021-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b021-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b021-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b021-20091001132401'/><apps:login userName='b021-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b021-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b021-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b022-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b022-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b022-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b022-20091001132401'/><apps:login userName='b022-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b022-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b022-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b023-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b023-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b023-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b023-20091001132401'/><apps:login userName='b023-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b023-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b023-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b024-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b024-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b024-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b024-20091001132401'/><apps:login userName='b024-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b024-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b024-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b025-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b025-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b025-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b025-20091001132401'/><apps:login userName='b025-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b025-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b025-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b026-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b026-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b026-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b026-20091001132401'/><apps:login userName='b026-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b026-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b026-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b027-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b027-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b027-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b027-20091001132401'/><apps:login userName='b027-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b027-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b027-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b028-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b028-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b028-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b028-20091001132401'/><apps:login userName='b028-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b028-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b028-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b029-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b029-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b029-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b029-20091001132401'/><apps:login userName='b029-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b029-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b029-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b030-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b030-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b030-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b030-20091001132401'/><apps:login userName='b030-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b030-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b030-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b031-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b031-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b031-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b031-20091001132401'/><apps:login userName='b031-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b031-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b031-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b032-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b032-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b032-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b032-20091001132401'/><apps:login userName='b032-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b032-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b032-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b033-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b033-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b033-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b033-20091001132401'/><apps:login userName='b033-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b033-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b033-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b034-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b034-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b034-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b034-20091001132401'/><apps:login userName='b034-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b034-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b034-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b035-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b035-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b035-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b035-20091001132401'/><apps:login userName='b035-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b035-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b035-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b036-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b036-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b036-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b036-20091001132401'/><apps:login userName='b036-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b036-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b036-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b037-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b037-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b037-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b037-20091001132401'/><apps:login userName='b037-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b037-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b037-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b038-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b038-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b038-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b038-20091001132401'/><apps:login userName='b038-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b038-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b038-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b039-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b039-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b039-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b039-20091001132401'/><apps:login userName='b039-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b039-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b039-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b040-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b040-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b040-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b040-20091001132401'/><apps:login userName='b040-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b040-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b040-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b041-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b041-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b041-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b041-20091001132401'/><apps:login userName='b041-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b041-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b041-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b042-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b042-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b042-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b042-20091001132401'/><apps:login userName='b042-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b042-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b042-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b043-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b043-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b043-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b043-20091001132401'/><apps:login userName='b043-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b043-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b043-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b044-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b044-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b044-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b044-20091001132401'/><apps:login userName='b044-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b044-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b044-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b045-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b045-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b045-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b045-20091001132401'/><apps:login userName='b045-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b045-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b045-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b046-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b046-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b046-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b046-20091001132401'/><apps:login userName='b046-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b046-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b046-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b047-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b047-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b047-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b047-20091001132401'/><apps:login userName='b047-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b047-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b047-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b048-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b048-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b048-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b048-20091001132401'/><apps:login userName='b048-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b048-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b048-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b049-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b049-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b049-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b049-20091001132401'/><apps:login userName='b049-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b049-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b049-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b050-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b050-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b050-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b050-20091001132401'/><apps:login userName='b050-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b050-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b050-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b051-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b051-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b051-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b051-20091001132401'/><apps:login userName='b051-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b051-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b051-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b052-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b052-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b052-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b052-20091001132401'/><apps:login userName='b052-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b052-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b052-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b053-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b053-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b053-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b053-20091001132401'/><apps:login userName='b053-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b053-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b053-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b054-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b054-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b054-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b054-20091001132401'/><apps:login userName='b054-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b054-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b054-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b055-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b055-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b055-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b055-20091001132401'/><apps:login userName='b055-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b055-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b055-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b056-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b056-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b056-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b056-20091001132401'/><apps:login userName='b056-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b056-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b056-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b057-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b057-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b057-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b057-20091001132401'/><apps:login userName='b057-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b057-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b057-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b058-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b058-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b058-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b058-20091001132401'/><apps:login userName='b058-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b058-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b058-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b059-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b059-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b059-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b059-20091001132401'/><apps:login userName='b059-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b059-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b059-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b060-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b060-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b060-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b060-20091001132401'/><apps:login userName='b060-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b060-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b060-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b061-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b061-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b061-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b061-20091001132401'/><apps:login userName='b061-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b061-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b061-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b062-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b062-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b062-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b062-20091001132401'/><apps:login userName='b062-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b062-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b062-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b063-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b063-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b063-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b063-20091001132401'/><apps:login userName='b063-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b063-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b063-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b064-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b064-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b064-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b064-20091001132401'/><apps:login userName='b064-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b064-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b064-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b065-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b065-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b065-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b065-20091001132401'/><apps:login userName='b065-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b065-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b065-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b066-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b066-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b066-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b066-20091001132401'/><apps:login userName='b066-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b066-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b066-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b067-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b067-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b067-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b067-20091001132401'/><apps:login userName='b067-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b067-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b067-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b068-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b068-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b068-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b068-20091001132401'/><apps:login userName='b068-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b068-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b068-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b069-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b069-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b069-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b069-20091001132401'/><apps:login userName='b069-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b069-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b069-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b070-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b070-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b070-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b070-20091001132401'/><apps:login userName='b070-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b070-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b070-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b071-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b071-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b071-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b071-20091001132401'/><apps:login userName='b071-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b071-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b071-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b072-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b072-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b072-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b072-20091001132401'/><apps:login userName='b072-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b072-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b072-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b073-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b073-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b073-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b073-20091001132401'/><apps:login userName='b073-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b073-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b073-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b074-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b074-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b074-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b074-20091001132401'/><apps:login userName='b074-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b074-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b074-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b075-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b075-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b075-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b075-20091001132401'/><apps:login userName='b075-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b075-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b075-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b076-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b076-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b076-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b076-20091001132401'/><apps:login userName='b076-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b076-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b076-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b077-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b077-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b077-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b077-20091001132401'/><apps:login userName='b077-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b077-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b077-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b078-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b078-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b078-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b078-20091001132401'/><apps:login userName='b078-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b078-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b078-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b079-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b079-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b079-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b079-20091001132401'/><apps:login userName='b079-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b079-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b079-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b080-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b080-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b080-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b080-20091001132401'/><apps:login userName='b080-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b080-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b080-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b081-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b081-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b081-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b081-20091001132401'/><apps:login userName='b081-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b081-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b081-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b082-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b082-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b082-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b082-20091001132401'/><apps:login userName='b082-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b082-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b082-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b083-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b083-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b083-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b083-20091001132401'/><apps:login userName='b083-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b083-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b083-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b084-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b084-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b084-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b084-20091001132401'/><apps:login userName='b084-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b084-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b084-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b085-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b085-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b085-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b085-20091001132401'/><apps:login userName='b085-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b085-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b085-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b086-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b086-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b086-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b086-20091001132401'/><apps:login userName='b086-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b086-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b086-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b087-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b087-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b087-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b087-20091001132401'/><apps:login userName='b087-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b087-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b087-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b088-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b088-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b088-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b088-20091001132401'/><apps:login userName='b088-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b088-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b088-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b089-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b089-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b089-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b089-20091001132401'/><apps:login userName='b089-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b089-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b089-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b090-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b090-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b090-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b090-20091001132401'/><apps:login userName='b090-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b090-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b090-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b091-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b091-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b091-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b091-20091001132401'/><apps:login userName='b091-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b091-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b091-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b092-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b092-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b092-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b092-20091001132401'/><apps:login userName='b092-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b092-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b092-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b093-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b093-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b093-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b093-20091001132401'/><apps:login userName='b093-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b093-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b093-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b094-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b094-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b094-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b094-20091001132401'/><apps:login userName='b094-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b094-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b094-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b095-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b095-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b095-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b095-20091001132401'/><apps:login userName='b095-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b095-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b095-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b096-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b096-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b096-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b096-20091001132401'/><apps:login userName='b096-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b096-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b096-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b097-20091001132401</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>b097-20091001132401</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b097-20091001132401'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/b097-20091001132401'/><apps:login userName='b097-20091001132401' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=b097-20091001132401'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=b097-20091001132401%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/john.amin</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>john.amin</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/john.amin'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/john.amin'/><apps:login userName='john.amin' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=john.amin'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=john.amin%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/john.doe</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>john.doe</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/john.doe'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/john.doe'/><apps:login userName='john.doe' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=john.doe'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=john.doe%40test.shehas.net'/></entry></feed>"
+p60
+sg35
+I200
+sg36
+S'OK'
+p61
+sg38
+(dp62
+sbtp63
+a(g1
+(g2
+g3
+Ntp64
+Rp65
+(dp66
+g7
+g1
+(g8
+g3
+Ntp67
+Rp68
+(dp69
+g12
+S'/a/feeds/test.shehas.net/user/2.0'
+p70
+sg14
+S'apps-apis.google.com'
+p71
+sg16
+S'https'
+p72
+sg18
+Nsg19
+(dp73
+S'startUsername'
+p74
+S'john'
+p75
+ssbsg21
+(dp76
+g52
+g53
+sg54
+g55
+ssg25
+g56
+sg27
+Nsbg1
+(g29
+g3
+Ntp77
+Rp78
+(dp79
+g33
+S"<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006' xmlns:gd='http://schemas.google.com/g/2005'><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>Users</title><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0'/><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0?startUsername=john'/><openSearch:startIndex>1</openSearch:startIndex><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/john</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>john</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/john'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/john'/><apps:login userName='john' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='7168'/><apps:name familyName='Tester' givenName='Apps'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=john'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=john%40test.shehas.net'/></entry><entry><id>https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/zzz</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>zzz</title><link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/zzz'/><link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/test.shehas.net/user/2.0/zzz'/><apps:login userName='zzz' suspended='false' ipWhitelisted='false' admin='true' changePasswordAtNextLogin='false' agreedToTerms='true'/><apps:quota limit='7168'/><apps:name familyName='zzz' givenName='zzz'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://apps-apis.google.com/a/feeds/test.shehas.net/nickname/2.0?username=zzz'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://apps-apis.google.com/a/feeds/test.shehas.net/emailList/2.0?recipient=zzz%40test.shehas.net'/></entry></feed>"
+p80
+sg35
+I200
+sg36
+S'OK'
+p81
+sg38
+(dp82
+sbtp83
+a.
\ No newline at end of file
diff --git a/tests/gdata_tests/apps/TestDataForGeneratorTest.p b/tests/gdata_tests/apps/TestDataForGeneratorTest.p
new file mode 100644
index 0000000..7c38e67
--- /dev/null
+++ b/tests/gdata_tests/apps/TestDataForGeneratorTest.p
@@ -0,0 +1,105 @@
+(lp0
+(ccopy_reg
+_reconstructor
+p1
+(catom.mock_service
+MockRequest
+p2
+c__builtin__
+object
+p3
+Ntp4
+Rp5
+(dp6
+S'url_params'
+p7
+(dp8
+sS'extra_headers'
+p9
+(dp10
+S'Content-Type'
+p11
+S'application/atom+xml'
+p12
+sS'Authorization'
+p13
+NssS'escape_params'
+p14
+I01
+sS'uri'
+p15
+S'https://www.google.com/a/feeds/test.shehas.net/user/2.0'
+p16
+sS'content_type'
+p17
+g12
+sS'operation'
+p18
+S'GET'
+p19
+sS'data'
+p20
+Nsbg1
+(catom.mock_service
+MockHttpResponse
+p21
+g3
+Ntp22
+Rp23
+(dp24
+S'body'
+p25
+S"<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006' xmlns:gd='http://schemas.google.com/g/2005'><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>Users</title><link rel='next' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0?startUsername=tmatsuo'/><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0'/><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0'/><openSearch:startIndex>1</openSearch:startIndex><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-000</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-000</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-000'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-000'/><apps:login userName='testuser-20080307140302-000' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='true'/><apps:quota limit='6144'/><apps:name familyName='fname-000' givenName='gname-000'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-000'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-000%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-001</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-001</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-001'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-001'/><apps:login userName='testuser-20080307140302-001' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-001' givenName='gname-001'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-001'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-001%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-002</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-002</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-002'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-002'/><apps:login userName='testuser-20080307140302-002' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-002' givenName='gname-002'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-002'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-002%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-003</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-003</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-003'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-003'/><apps:login userName='testuser-20080307140302-003' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-003' givenName='gname-003'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-003'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-003%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-004</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-004</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-004'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-004'/><apps:login userName='testuser-20080307140302-004' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-004' givenName='gname-004'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-004'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-004%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-005</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-005</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-005'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-005'/><apps:login userName='testuser-20080307140302-005' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-005' givenName='gname-005'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-005'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-005%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-006</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-006</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-006'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-006'/><apps:login userName='testuser-20080307140302-006' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-006' givenName='gname-006'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-006'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-006%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-007</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-007</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-007'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-007'/><apps:login userName='testuser-20080307140302-007' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-007' givenName='gname-007'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-007'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-007%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-008</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-008</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-008'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-008'/><apps:login userName='testuser-20080307140302-008' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-008' givenName='gname-008'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-008'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-008%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-009</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-009</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-009'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-009'/><apps:login userName='testuser-20080307140302-009' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-009' givenName='gname-009'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-009'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-009%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-010</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-010</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-010'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-010'/><apps:login userName='testuser-20080307140302-010' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-010' givenName='gname-010'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-010'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-010%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-011</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-011</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-011'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-011'/><apps:login userName='testuser-20080307140302-011' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-011' givenName='gname-011'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-011'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-011%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-012</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-012</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-012'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-012'/><apps:login userName='testuser-20080307140302-012' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-012' givenName='gname-012'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-012'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-012%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-013</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-013</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-013'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-013'/><apps:login userName='testuser-20080307140302-013' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-013' givenName='gname-013'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-013'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-013%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-014</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-014</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-014'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-014'/><apps:login userName='testuser-20080307140302-014' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-014' givenName='gname-014'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-014'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-014%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-015</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-015</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-015'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-015'/><apps:login userName='testuser-20080307140302-015' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-015' givenName='gname-015'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-015'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-015%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-016</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-016</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-016'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-016'/><apps:login userName='testuser-20080307140302-016' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-016' givenName='gname-016'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-016'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-016%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-017</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-017</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-017'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-017'/><apps:login userName='testuser-20080307140302-017' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-017' givenName='gname-017'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-017'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-017%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-018</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-018</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-018'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-018'/><apps:login userName='testuser-20080307140302-018' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-018' givenName='gname-018'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-018'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-018%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-019</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-019</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-019'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-019'/><apps:login userName='testuser-20080307140302-019' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-019' givenName='gname-019'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-019'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-019%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-020</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-020</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-020'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-020'/><apps:login userName='testuser-20080307140302-020' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-020' givenName='gname-020'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-020'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-020%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-021</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-021</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-021'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-021'/><apps:login userName='testuser-20080307140302-021' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-021' givenName='gname-021'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-021'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-021%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-022</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-022</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-022'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-022'/><apps:login userName='testuser-20080307140302-022' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-022' givenName='gname-022'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-022'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-022%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-023</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-023</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-023'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-023'/><apps:login userName='testuser-20080307140302-023' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-023' givenName='gname-023'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-023'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-023%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-024</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-024</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-024'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-024'/><apps:login userName='testuser-20080307140302-024' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-024' givenName='gname-024'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-024'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-024%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-025</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-025</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-025'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-025'/><apps:login userName='testuser-20080307140302-025' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-025' givenName='gname-025'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-025'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-025%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-026</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-026</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-026'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-026'/><apps:login userName='testuser-20080307140302-026' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-026' givenName='gname-026'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-026'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-026%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-027</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-027</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-027'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-027'/><apps:login userName='testuser-20080307140302-027' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-027' givenName='gname-027'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-027'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-027%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-028</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-028</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-028'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-028'/><apps:login userName='testuser-20080307140302-028' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-028' givenName='gname-028'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-028'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-028%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-029</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-029</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-029'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-029'/><apps:login userName='testuser-20080307140302-029' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-029' givenName='gname-029'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-029'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-029%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-030</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-030</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-030'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-030'/><apps:login userName='testuser-20080307140302-030' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-030' givenName='gname-030'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-030'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-030%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-031</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-031</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-031'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-031'/><apps:login userName='testuser-20080307140302-031' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-031' givenName='gname-031'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-031'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-031%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-032</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-032</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-032'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-032'/><apps:login userName='testuser-20080307140302-032' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-032' givenName='gname-032'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-032'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-032%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-033</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-033</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-033'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-033'/><apps:login userName='testuser-20080307140302-033' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-033' givenName='gname-033'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-033'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-033%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-034</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-034</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-034'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-034'/><apps:login userName='testuser-20080307140302-034' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-034' givenName='gname-034'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-034'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-034%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-035</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-035</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-035'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-035'/><apps:login userName='testuser-20080307140302-035' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-035' givenName='gname-035'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-035'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-035%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-036</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-036</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-036'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-036'/><apps:login userName='testuser-20080307140302-036' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-036' givenName='gname-036'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-036'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-036%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-037</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-037</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-037'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-037'/><apps:login userName='testuser-20080307140302-037' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-037' givenName='gname-037'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-037'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-037%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-038</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-038</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-038'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-038'/><apps:login userName='testuser-20080307140302-038' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-038' givenName='gname-038'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-038'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-038%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-039</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-039</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-039'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-039'/><apps:login userName='testuser-20080307140302-039' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-039' givenName='gname-039'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-039'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-039%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-040</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-040</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-040'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-040'/><apps:login userName='testuser-20080307140302-040' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-040' givenName='gname-040'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-040'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-040%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-041</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-041</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-041'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-041'/><apps:login userName='testuser-20080307140302-041' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-041' givenName='gname-041'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-041'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-041%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-042</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-042</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-042'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-042'/><apps:login userName='testuser-20080307140302-042' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-042' givenName='gname-042'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-042'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-042%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-043</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-043</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-043'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-043'/><apps:login userName='testuser-20080307140302-043' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-043' givenName='gname-043'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-043'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-043%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-044</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-044</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-044'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-044'/><apps:login userName='testuser-20080307140302-044' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-044' givenName='gname-044'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-044'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-044%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-045</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-045</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-045'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-045'/><apps:login userName='testuser-20080307140302-045' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-045' givenName='gname-045'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-045'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-045%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-046</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-046</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-046'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-046'/><apps:login userName='testuser-20080307140302-046' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-046' givenName='gname-046'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-046'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-046%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-047</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-047</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-047'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-047'/><apps:login userName='testuser-20080307140302-047' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-047' givenName='gname-047'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-047'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-047%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-048</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-048</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-048'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-048'/><apps:login userName='testuser-20080307140302-048' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-048' givenName='gname-048'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-048'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-048%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-049</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-049</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-049'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-049'/><apps:login userName='testuser-20080307140302-049' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-049' givenName='gname-049'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-049'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-049%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-050</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-050</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-050'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-050'/><apps:login userName='testuser-20080307140302-050' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-050' givenName='gname-050'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-050'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-050%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-051</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-051</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-051'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-051'/><apps:login userName='testuser-20080307140302-051' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-051' givenName='gname-051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-051'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-051%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-052</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-052</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-052'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-052'/><apps:login userName='testuser-20080307140302-052' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-052' givenName='gname-052'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-052'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-052%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-053</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-053</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-053'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-053'/><apps:login userName='testuser-20080307140302-053' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-053' givenName='gname-053'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-053'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-053%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-054</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-054</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-054'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-054'/><apps:login userName='testuser-20080307140302-054' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-054' givenName='gname-054'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-054'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-054%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-055</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-055</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-055'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-055'/><apps:login userName='testuser-20080307140302-055' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-055' givenName='gname-055'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-055'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-055%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-056</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-056</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-056'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-056'/><apps:login userName='testuser-20080307140302-056' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-056' givenName='gname-056'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-056'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-056%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-057</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-057</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-057'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-057'/><apps:login userName='testuser-20080307140302-057' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-057' givenName='gname-057'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-057'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-057%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-058</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-058</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-058'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-058'/><apps:login userName='testuser-20080307140302-058' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-058' givenName='gname-058'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-058'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-058%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-059</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-059</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-059'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-059'/><apps:login userName='testuser-20080307140302-059' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-059' givenName='gname-059'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-059'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-059%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-060</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-060</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-060'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-060'/><apps:login userName='testuser-20080307140302-060' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-060' givenName='gname-060'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-060'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-060%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-061</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-061</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-061'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-061'/><apps:login userName='testuser-20080307140302-061' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-061' givenName='gname-061'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-061'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-061%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-062</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-062</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-062'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-062'/><apps:login userName='testuser-20080307140302-062' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-062' givenName='gname-062'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-062'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-062%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-063</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-063</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-063'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-063'/><apps:login userName='testuser-20080307140302-063' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-063' givenName='gname-063'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-063'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-063%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-064</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-064</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-064'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-064'/><apps:login userName='testuser-20080307140302-064' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-064' givenName='gname-064'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-064'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-064%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-065</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-065</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-065'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-065'/><apps:login userName='testuser-20080307140302-065' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-065' givenName='gname-065'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-065'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-065%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-066</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-066</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-066'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-066'/><apps:login userName='testuser-20080307140302-066' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-066' givenName='gname-066'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-066'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-066%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-067</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-067</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-067'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-067'/><apps:login userName='testuser-20080307140302-067' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-067' givenName='gname-067'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-067'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-067%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-068</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-068</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-068'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-068'/><apps:login userName='testuser-20080307140302-068' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-068' givenName='gname-068'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-068'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-068%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-069</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-069</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-069'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-069'/><apps:login userName='testuser-20080307140302-069' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-069' givenName='gname-069'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-069'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-069%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-070</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-070</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-070'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-070'/><apps:login userName='testuser-20080307140302-070' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-070' givenName='gname-070'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-070'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-070%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-071</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-071</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-071'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-071'/><apps:login userName='testuser-20080307140302-071' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-071' givenName='gname-071'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-071'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-071%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-072</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-072</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-072'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-072'/><apps:login userName='testuser-20080307140302-072' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-072' givenName='gname-072'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-072'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-072%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-073</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-073</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-073'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-073'/><apps:login userName='testuser-20080307140302-073' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-073' givenName='gname-073'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-073'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-073%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-074</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-074</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-074'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-074'/><apps:login userName='testuser-20080307140302-074' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-074' givenName='gname-074'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-074'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-074%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-075</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-075</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-075'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-075'/><apps:login userName='testuser-20080307140302-075' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-075' givenName='gname-075'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-075'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-075%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-076</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-076</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-076'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-076'/><apps:login userName='testuser-20080307140302-076' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-076' givenName='gname-076'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-076'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-076%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-077</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-077</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-077'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-077'/><apps:login userName='testuser-20080307140302-077' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-077' givenName='gname-077'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-077'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-077%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-078</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-078</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-078'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-078'/><apps:login userName='testuser-20080307140302-078' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-078' givenName='gname-078'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-078'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-078%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-079</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-079</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-079'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-079'/><apps:login userName='testuser-20080307140302-079' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-079' givenName='gname-079'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-079'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-079%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-080</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-080</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-080'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-080'/><apps:login userName='testuser-20080307140302-080' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-080' givenName='gname-080'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-080'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-080%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-081</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-081</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-081'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-081'/><apps:login userName='testuser-20080307140302-081' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-081' givenName='gname-081'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-081'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-081%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-082</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-082</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-082'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-082'/><apps:login userName='testuser-20080307140302-082' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-082' givenName='gname-082'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-082'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-082%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-083</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-083</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-083'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-083'/><apps:login userName='testuser-20080307140302-083' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-083' givenName='gname-083'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-083'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-083%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-084</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-084</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-084'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-084'/><apps:login userName='testuser-20080307140302-084' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-084' givenName='gname-084'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-084'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-084%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-085</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-085</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-085'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-085'/><apps:login userName='testuser-20080307140302-085' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-085' givenName='gname-085'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-085'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-085%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-086</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-086</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-086'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-086'/><apps:login userName='testuser-20080307140302-086' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-086' givenName='gname-086'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-086'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-086%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-087</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-087</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-087'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-087'/><apps:login userName='testuser-20080307140302-087' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-087' givenName='gname-087'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-087'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-087%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-088</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-088</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-088'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-088'/><apps:login userName='testuser-20080307140302-088' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-088' givenName='gname-088'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-088'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-088%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-089</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-089</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-089'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-089'/><apps:login userName='testuser-20080307140302-089' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-089' givenName='gname-089'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-089'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-089%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-090</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-090</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-090'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-090'/><apps:login userName='testuser-20080307140302-090' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-090' givenName='gname-090'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-090'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-090%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-091</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-091</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-091'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-091'/><apps:login userName='testuser-20080307140302-091' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-091' givenName='gname-091'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-091'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-091%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-092</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-092</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-092'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-092'/><apps:login userName='testuser-20080307140302-092' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-092' givenName='gname-092'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-092'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-092%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-093</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-093</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-093'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-093'/><apps:login userName='testuser-20080307140302-093' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-093' givenName='gname-093'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-093'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-093%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-094</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-094</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-094'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-094'/><apps:login userName='testuser-20080307140302-094' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-094' givenName='gname-094'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-094'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-094%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-095</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-095</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-095'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-095'/><apps:login userName='testuser-20080307140302-095' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-095' givenName='gname-095'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-095'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-095%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-096</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-096</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-096'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-096'/><apps:login userName='testuser-20080307140302-096' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-096' givenName='gname-096'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-096'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-096%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-097</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-097</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-097'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-097'/><apps:login userName='testuser-20080307140302-097' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-097' givenName='gname-097'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-097'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-097%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-098</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-098</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-098'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-098'/><apps:login userName='testuser-20080307140302-098' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-098' givenName='gname-098'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-098'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-098%40test.shehas.net'/></entry><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-099</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>testuser-20080307140302-099</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-099'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/testuser-20080307140302-099'/><apps:login userName='testuser-20080307140302-099' suspended='false' ipWhitelisted='false' admin='false' changePasswordAtNextLogin='false' agreedToTerms='false'/><apps:quota limit='6144'/><apps:name familyName='fname-099' givenName='gname-099'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=testuser-20080307140302-099'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=testuser-20080307140302-099%40test.shehas.net'/></entry></feed>"
+p26
+sS'status'
+p27
+I200
+sS'reason'
+p28
+S'OK'
+p29
+sS'headers'
+p30
+(dp31
+sbtp32
+a(g1
+(g2
+g3
+Ntp33
+Rp34
+(dp35
+g7
+(dp36
+sg9
+(dp37
+g11
+g12
+sg13
+Nssg14
+I01
+sg15
+S'https://www.google.com:443/a/feeds/test.shehas.net/user/2.0?startUsername=tmatsuo'
+p38
+sg17
+g12
+sg18
+g19
+sg20
+Nsbg1
+(g21
+g3
+Ntp39
+Rp40
+(dp41
+g25
+S"<?xml version='1.0' encoding='UTF-8'?><feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/' xmlns:apps='http://schemas.google.com/apps/2006' xmlns:gd='http://schemas.google.com/g/2005'><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>Users</title><link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0'/><link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0'/><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0?startUsername=tmatsuo'/><openSearch:startIndex>1</openSearch:startIndex><entry><id>https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/tmatsuo</id><updated>1970-01-01T00:00:00.000Z</updated><category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/><title type='text'>tmatsuo</title><link rel='self' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/tmatsuo'/><link rel='edit' type='application/atom+xml' href='https://www.google.com:443/a/feeds/test.shehas.net/user/2.0/tmatsuo'/><apps:login userName='tmatsuo' suspended='false' ipWhitelisted='false' admin='true' changePasswordAtNextLogin='false' agreedToTerms='true'/><apps:quota limit='6144'/><apps:name familyName='\xe6\x9d\xbe\xe5\xb0\xbe' givenName='\xe8\xb2\xb4\xe5\x8f\xb2'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames' href='https://www.google.com:443/a/feeds/test.shehas.net/nickname/2.0?username=tmatsuo'/><gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists' href='https://www.google.com:443/a/feeds/test.shehas.net/emailList/2.0?recipient=tmatsuo%40test.shehas.net'/></entry></feed>"
+p42
+sg27
+I200
+sg28
+S'OK'
+p43
+sg30
+(dp44
+sbtp45
+a.
\ No newline at end of file
diff --git a/tests/gdata_tests/apps/__init__.py b/tests/gdata_tests/apps/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/apps/__init__.py
diff --git a/tests/gdata_tests/apps/data_test.py b/tests/gdata_tests/apps/data_test.py
new file mode 100644
index 0000000..562396f
--- /dev/null
+++ b/tests/gdata_tests/apps/data_test.py
@@ -0,0 +1,117 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model tests for the Provisioning API."""
+
+
+__author__ = 'Shraddha Gupta <shraddhag@google.com>'
+
+
+import unittest
+import atom.core
+from gdata import test_data
+import gdata.apps.data
+import gdata.test_config as conf
+
+
+class UserEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.USER_ENTRY1,
+ gdata.apps.data.UserEntry)
+ self.feed = atom.core.parse(test_data.USER_FEED1,
+ gdata.apps.data.UserFeed)
+
+ def testUserEntryFromString(self):
+ self.assert_(isinstance(self.entry,
+ gdata.apps.data.UserEntry))
+ self.assertEquals(self.entry.name.given_name, 'abcd33')
+ self.assertEquals(self.entry.name.family_name, 'efgh3')
+ self.assertEquals(self.entry.login.user_name, 'abcd12310')
+ self.assertEquals(self.entry.login.suspended, 'false')
+ self.assertEquals(self.entry.login.admin, 'false')
+ self.assertEquals(self.entry.quota.limit, '25600')
+
+ def testUserFeedFromString(self):
+ self.assertEquals(len(self.feed.entry), 2)
+ self.assert_(isinstance(self.feed, gdata.apps.data.UserFeed))
+ self.assert_(isinstance(self.feed.entry[0], gdata.apps.data.UserEntry))
+ self.assert_(isinstance(self.feed.entry[1], gdata.apps.data.UserEntry))
+ self.assertEquals(self.feed.entry[0].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8306'))
+ self.assertEquals(self.feed.entry[0].name.given_name, 'FirstName8306')
+ self.assertEquals(self.feed.entry[0].name.family_name, 'LastName8306')
+ self.assertEquals(self.feed.entry[0].login.user_name, 'user8306')
+ self.assertEquals(self.feed.entry[0].login.admin, 'false')
+ self.assertEquals(self.feed.entry[0].login.suspended, 'false')
+ self.assertEquals(self.feed.entry[0].login.change_password, 'false')
+ self.assertEquals(self.feed.entry[0].login.ip_whitelisted, 'false')
+ self.assertEquals(self.feed.entry[0].quota.limit, '25600')
+ self.assertEquals(
+ self.feed.entry[1].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/srkapps.com/user/2.0/user8307'))
+ self.assertEquals(self.feed.entry[1].name.given_name, 'FirstName8307')
+ self.assertEquals(self.feed.entry[1].name.family_name, 'LastName8307')
+ self.assertEquals(self.feed.entry[1].login.user_name, 'user8307')
+ self.assertEquals(self.feed.entry[1].login.admin, 'false')
+ self.assertEquals(self.feed.entry[1].login.suspended, 'false')
+ self.assertEquals(self.feed.entry[1].login.change_password, 'false')
+ self.assertEquals(self.feed.entry[1].login.ip_whitelisted, 'false')
+ self.assertEquals(self.feed.entry[1].quota.limit, '25600')
+
+
+class NicknameEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.NICKNAME_ENTRY,
+ gdata.apps.data.NicknameEntry)
+ self.feed = atom.core.parse(test_data.NICKNAME_FEED,
+ gdata.apps.data.NicknameFeed)
+
+ def testNicknameEntryFromString(self):
+ self.assert_(isinstance(self.entry,
+ gdata.apps.data.NicknameEntry))
+ self.assertEquals(self.entry.nickname.name, 'nehag')
+ self.assertEquals(self.entry.login.user_name, 'neha')
+
+ def testNicknameFeedFromString(self):
+ self.assertEquals(len(self.feed.entry), 2)
+ self.assert_(isinstance(self.feed,
+ gdata.apps.data.NicknameFeed))
+ self.assert_(isinstance(self.feed.entry[0],
+ gdata.apps.data.NicknameEntry))
+ self.assert_(isinstance(self.feed.entry[1],
+ gdata.apps.data.NicknameEntry))
+ self.assertEquals(
+ self.feed.entry[0].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/srkapps.net/'
+ 'nickname/2.0/nehag'))
+ self.assertEquals(self.feed.entry[0].nickname.name, 'nehag')
+ self.assertEquals(self.feed.entry[0].login.user_name, 'neha')
+ self.assertEquals(
+ self.feed.entry[1].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/srkapps.net/'
+ 'nickname/2.0/richag'))
+ self.assertEquals(self.feed.entry[1].nickname.name, 'richag')
+ self.assertEquals(self.feed.entry[1].login.user_name, 'richa')
+
+
+def suite():
+ return conf.build_suite([UserEntryTest, NicknameEntryTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/apps/emailsettings/__init__.py b/tests/gdata_tests/apps/emailsettings/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/apps/emailsettings/__init__.py
diff --git a/tests/gdata_tests/apps/emailsettings/data_test.py b/tests/gdata_tests/apps/emailsettings/data_test.py
new file mode 100644
index 0000000..8de0bd0
--- /dev/null
+++ b/tests/gdata_tests/apps/emailsettings/data_test.py
@@ -0,0 +1,250 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2010 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import unittest
+import gdata.apps.emailsettings.data
+import gdata.test_config as conf
+
+
+class EmailSettingsLabelTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.apps.emailsettings.data.EmailSettingsLabel()
+
+ def testName(self):
+ self.entry.name = 'test label'
+ self.assertEquals(self.entry.name, 'test label')
+
+
+class EmailSettingsFilterTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.apps.emailsettings.data.EmailSettingsFilter()
+
+ def testFrom(self):
+ self.entry.from_address = 'abc@example.com'
+ self.assertEquals(self.entry.from_address, 'abc@example.com')
+
+ def testTo(self):
+ self.entry.to_address = 'to@example.com'
+ self.assertEquals(self.entry.to_address, 'to@example.com')
+
+ def testFrom(self):
+ self.entry.from_address = 'abc@example.com'
+ self.assertEquals(self.entry.from_address, 'abc@example.com')
+
+ def testSubject(self):
+ self.entry.subject = 'Read me'
+ self.assertEquals(self.entry.subject, 'Read me')
+
+ def testHasTheWord(self):
+ self.entry.has_the_word = 'important'
+ self.assertEquals(self.entry.has_the_word, 'important')
+
+ def testDoesNotHaveTheWord(self):
+ self.entry.does_not_have_the_word = 'spam'
+ self.assertEquals(self.entry.does_not_have_the_word, 'spam')
+
+ def testHasAttachments(self):
+ self.entry.has_attachments = True
+ self.assertEquals(self.entry.has_attachments, True)
+
+ def testLabel(self):
+ self.entry.label = 'Trip reports'
+ self.assertEquals(self.entry.label, 'Trip reports')
+
+ def testMarkHasRead(self):
+ self.entry.mark_has_read = True
+ self.assertEquals(self.entry.mark_has_read, True)
+
+ def testArchive(self):
+ self.entry.archive = True
+ self.assertEquals(self.entry.archive, True)
+
+
+class EmailSettingsSendAsAliasTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.apps.emailsettings.data.EmailSettingsSendAsAlias()
+
+ def testName(self):
+ self.entry.name = 'Sales'
+ self.assertEquals(self.entry.name, 'Sales')
+
+ def testAddress(self):
+ self.entry.address = 'sales@example.com'
+ self.assertEquals(self.entry.address, 'sales@example.com')
+
+ def testReplyTo(self):
+ self.entry.reply_to = 'support@example.com'
+ self.assertEquals(self.entry.reply_to, 'support@example.com')
+
+ def testMakeDefault(self):
+ self.entry.make_default = True
+ self.assertEquals(self.entry.make_default, True)
+
+
+class EmailSettingsWebClipTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.apps.emailsettings.data.EmailSettingsWebClip()
+
+ def testEnable(self):
+ self.entry.enable = True
+ self.assertEquals(self.entry.enable, True)
+
+
+class EmailSettingsForwardingTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.apps.emailsettings.data.EmailSettingsForwarding()
+
+ def testEnable(self):
+ self.entry.enable = True
+ self.assertEquals(self.entry.enable, True)
+
+ def testForwardTo(self):
+ self.entry.forward_to = 'fred@example.com'
+ self.assertEquals(self.entry.forward_to, 'fred@example.com')
+
+ def testAction(self):
+ self.entry.action = 'KEEP'
+ self.assertEquals(self.entry.action, 'KEEP')
+
+
+class EmailSettingsPopTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.apps.emailsettings.data.EmailSettingsPop()
+
+ def testEnable(self):
+ self.entry.enable = True
+ self.assertEquals(self.entry.enable, True)
+
+ def testForwardTo(self):
+ self.entry.enable_for = 'ALL_MAIL'
+ self.assertEquals(self.entry.enable_for, 'ALL_MAIL')
+
+ def testAction(self):
+ self.entry.action = 'KEEP'
+ self.assertEquals(self.entry.action, 'KEEP')
+
+
+class EmailSettingsImapTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.apps.emailsettings.data.EmailSettingsImap()
+
+ def testEnable(self):
+ self.entry.enable = True
+ self.assertEquals(self.entry.enable, True)
+
+
+class EmailSettingsVacationResponderTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.apps.emailsettings.data.EmailSettingsVacationResponder()
+
+ def testEnable(self):
+ self.entry.enable = True
+ self.assertEquals(self.entry.enable, True)
+
+ def testSubject(self):
+ self.entry.subject = 'On vacation!'
+ self.assertEquals(self.entry.subject, 'On vacation!')
+
+ def testMessage(self):
+ self.entry.message = 'See you on September 1st'
+ self.assertEquals(self.entry.message, 'See you on September 1st')
+
+ def testStartDate(self):
+ self.entry.start_date = '2011-12-05'
+ self.assertEquals(self.entry.start_date, '2011-12-05')
+
+ def testEndDate(self):
+ self.entry.end_date = '2011-12-06'
+ self.assertEquals(self.entry.end_date, '2011-12-06')
+
+ def testContactsOnly(self):
+ self.entry.contacts_only = True
+ self.assertEquals(self.entry.contacts_only, True)
+
+ def testDomainOnly(self):
+ self.entry.domain_only = True
+ self.assertEquals(self.entry.domain_only, True)
+
+
+class EmailSettingsSignatureTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.apps.emailsettings.data.EmailSettingsSignature()
+
+ def testValue(self):
+ self.entry.signature_value = 'Regards, Joe'
+ self.assertEquals(self.entry.signature_value, 'Regards, Joe')
+
+
+class EmailSettingsLanguageTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.apps.emailsettings.data.EmailSettingsLanguage()
+
+ def testLanguage(self):
+ self.entry.language_tag = 'es'
+ self.assertEquals(self.entry.language_tag, 'es')
+
+
+class EmailSettingsGeneralTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.apps.emailsettings.data.EmailSettingsGeneral()
+
+ def testPageSize(self):
+ self.entry.page_size = 25
+ self.assertEquals(self.entry.page_size, 25)
+
+ def testShortcuts(self):
+ self.entry.shortcuts = True
+ self.assertEquals(self.entry.shortcuts, True)
+
+ def testArrows(self):
+ self.entry.arrows = True
+ self.assertEquals(self.entry.arrows, True)
+
+ def testSnippets(self):
+ self.entry.snippets = True
+ self.assertEquals(self.entry.snippets, True)
+
+ def testUnicode(self):
+ self.entry.use_unicode = True
+ self.assertEquals(self.entry.use_unicode, True)
+
+
+def suite():
+ return conf.build_suite([EmailSettingsLabelTest, EmailSettingsFilterTest,
+ EmailSettingsSendAsAliasTest, EmailSettingsWebClipTest,
+ EmailSettingsForwardingTest, EmailSettingsPopTest,
+ EmailSettingsImapTest, EmailSettingsVacationResponderTest,
+ EmailSettingsSignatureTest, EmailSettingsLanguageTest,
+ EmailSettingsGeneralTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/apps/emailsettings/live_client_test.py b/tests/gdata_tests/apps/emailsettings/live_client_test.py
new file mode 100644
index 0000000..ef53349
--- /dev/null
+++ b/tests/gdata_tests/apps/emailsettings/live_client_test.py
@@ -0,0 +1,351 @@
+#!/usr/bin/python
+#
+# Copyright 2010 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import unittest
+import gdata.apps.emailsettings.client
+import gdata.apps.emailsettings.data
+import gdata.client
+import gdata.data
+import gdata.gauth
+import gdata.test_config as conf
+
+
+conf.options.register_option(conf.APPS_DOMAIN_OPTION)
+conf.options.register_option(conf.TARGET_USERNAME_OPTION)
+
+
+class EmailSettingsClientTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.apps.emailsettings.client.EmailSettingsClient(
+ domain='example.com')
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.apps.emailsettings.client.EmailSettingsClient(
+ domain=conf.options.get_value('appsdomain'))
+ if conf.options.get_value('ssl') == 'true':
+ self.client.ssl = True
+ conf.configure_client(self.client, 'EmailSettingsClientTest',
+ self.client.auth_service, True)
+ self.username = conf.options.get_value('appsusername').split('@')[0]
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def testClientConfiguration(self):
+ self.assertEqual('apps-apis.google.com', self.client.host)
+ self.assertEqual('2.0', self.client.api_version)
+ self.assertEqual('apps', self.client.auth_service)
+ if conf.options.get_value('runlive') == 'true':
+ self.assertEqual(self.client.domain, conf.options.get_value('appsdomain'))
+ else:
+ self.assertEqual(self.client.domain, 'example.com')
+
+ def testMakeEmailSettingsUri(self):
+ self.assertEqual('/a/feeds/emailsettings/2.0/%s/%s/%s' % (self.client.domain,
+ 'abc', 'label'),
+ self.client.MakeEmailSettingsUri('abc', 'label'))
+
+ def testCreateDeleteLabel(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testCreateLabel')
+
+ new_label = self.client.CreateLabel(
+ username=conf.options.get_value('targetusername'),
+ name='status updates')
+
+ self.assert_(isinstance(new_label,
+ gdata.apps.emailsettings.data.EmailSettingsLabel))
+ self.assertEqual(new_label.name, 'status updates')
+
+ self.client.DeleteLabel(
+ username=conf.options.get_value('targetusername'),
+ label='status updates')
+
+ def testCreateFilter(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testCreateFilter')
+
+ new_filter = self.client.CreateFilter(
+ username=conf.options.get_value('targetusername'),
+ from_address='alice@gmail.com',
+ has_the_word='project proposal', mark_as_read=True)
+
+ self.assert_(isinstance(new_filter,
+ gdata.apps.emailsettings.data.EmailSettingsFilter))
+ self.assertEqual(new_filter.from_address, 'alice@gmail.com')
+ self.assertEqual(new_filter.has_the_word, 'project proposal')
+ self.assertEqual(new_filter.mark_as_read, 'True')
+
+ new_filter = self.client.CreateFilter(
+ username=conf.options.get_value('targetusername'),
+ to_address='announcements@example.com',
+ label="announcements")
+
+ self.assert_(isinstance(new_filter,
+ gdata.apps.emailsettings.data.EmailSettingsFilter))
+ self.assertEqual(new_filter.to_address, 'announcements@example.com')
+ self.assertEqual(new_filter.label, 'announcements')
+
+ new_filter = self.client.CreateFilter(
+ username=conf.options.get_value('targetusername'),
+ subject='urgent',
+ does_not_have_the_word='spam',
+ has_attachments=True,
+ archive=True)
+
+ self.assert_(isinstance(new_filter,
+ gdata.apps.emailsettings.data.EmailSettingsFilter))
+ self.assertEqual(new_filter.subject, 'urgent')
+ self.assertEqual(new_filter.does_not_have_the_word, 'spam')
+ self.assertEqual(new_filter.has_attachments, 'True')
+ self.assertEqual(new_filter.archive, 'True')
+
+ def testCreateSendAs(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testCreateSendAs')
+
+ new_sendas = self.client.CreateSendAs(
+ username=conf.options.get_value('targetusername'),
+ name='Sales', address=conf.options.get_value('appsusername'),
+ reply_to='abc@gmail.com',
+ make_default=True)
+
+ self.assert_(isinstance(new_sendas,
+ gdata.apps.emailsettings.data.EmailSettingsSendAsAlias))
+ self.assertEqual(new_sendas.name, 'Sales')
+ self.assertEqual(new_sendas.address,
+ conf.options.get_value('appsusername'))
+ self.assertEqual(new_sendas.reply_to, 'abc@gmail.com')
+ self.assertEqual(new_sendas.make_default, 'True')
+
+ def testUpdateWebclip(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testUpdateWebclip')
+
+ new_webclip = self.client.UpdateWebclip(
+ username=conf.options.get_value('targetusername'),
+ enable=True)
+
+ self.assert_(isinstance(new_webclip,
+ gdata.apps.emailsettings.data.EmailSettingsWebClip))
+ self.assertEqual(new_webclip.enable, 'True')
+
+ new_webclip = self.client.UpdateWebclip(
+ username=conf.options.get_value('targetusername'),
+ enable=False)
+
+ self.assert_(isinstance(new_webclip,
+ gdata.apps.emailsettings.data.EmailSettingsWebClip))
+ self.assertEqual(new_webclip.enable, 'False')
+
+ def testUpdateForwarding(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testUpdateForwarding')
+
+ new_forwarding = self.client.UpdateForwarding(
+ username=conf.options.get_value('targetusername'),
+ enable=True,
+ forward_to=conf.options.get_value('appsusername'),
+ action='KEEP')
+
+ self.assert_(isinstance(new_forwarding,
+ gdata.apps.emailsettings.data.EmailSettingsForwarding))
+ self.assertEqual(new_forwarding.enable, 'True')
+ self.assertEqual(new_forwarding.forward_to,
+ conf.options.get_value('appsusername'))
+ self.assertEqual(new_forwarding.action, 'KEEP')
+
+ new_forwarding = self.client.UpdateForwarding(
+ username=conf.options.get_value('targetusername'),
+ enable=False)
+
+ self.assert_(isinstance(new_forwarding,
+ gdata.apps.emailsettings.data.EmailSettingsForwarding))
+ self.assertEqual(new_forwarding.enable, 'False')
+
+ def testUpdatePop(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testUpdatePop')
+
+ new_pop = self.client.UpdatePop(
+ username=conf.options.get_value('targetusername'),
+ enable=True, enable_for='MAIL_FROM_NOW_ON', action='KEEP')
+
+ self.assert_(isinstance(new_pop,
+ gdata.apps.emailsettings.data.EmailSettingsPop))
+ self.assertEqual(new_pop.enable, 'True')
+ self.assertEqual(new_pop.enable_for, 'MAIL_FROM_NOW_ON')
+ self.assertEqual(new_pop.action, 'KEEP')
+
+ new_pop = self.client.UpdatePop(
+ username=conf.options.get_value('targetusername'),
+ enable=False)
+
+ self.assert_(isinstance(new_pop,
+ gdata.apps.emailsettings.data.EmailSettingsPop))
+ self.assertEqual(new_pop.enable, 'False')
+
+ def testUpdateImap(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testUpdateImap')
+
+ new_imap = self.client.UpdateImap(
+ username=conf.options.get_value('targetusername'),
+ enable=True)
+
+ self.assert_(isinstance(new_imap,
+ gdata.apps.emailsettings.data.EmailSettingsImap))
+ self.assertEqual(new_imap.enable, 'True')
+
+ new_imap = self.client.UpdateImap(
+ username=conf.options.get_value('targetusername'),
+ enable=False)
+
+ self.assert_(isinstance(new_imap,
+ gdata.apps.emailsettings.data.EmailSettingsImap))
+ self.assertEqual(new_imap.enable, 'False')
+
+ def testUpdateVacation(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testUpdateVacation')
+
+ new_vacation = self.client.UpdateVacation(
+ username=conf.options.get_value('targetusername'),
+ enable=True, subject='Out of office',
+ message='If urgent call me at 555-5555.',
+ start_date='2011-12-05', end_date='2011-12-06',
+ contacts_only=True, domain_only=False)
+
+ self.assert_(isinstance(new_vacation,
+ gdata.apps.emailsettings.data.EmailSettingsVacationResponder))
+ self.assertEqual(new_vacation.enable, 'True')
+ self.assertEqual(new_vacation.subject, 'Out of office')
+ self.assertEqual(new_vacation.message, 'If urgent call me at 555-5555.')
+ self.assertEqual(new_vacation.start_date, '2011-12-05')
+ self.assertEqual(new_vacation.end_date, '2011-12-06')
+ self.assertEqual(new_vacation.contacts_only, 'True')
+ self.assertEqual(new_vacation.domain_only, 'False')
+
+ new_vacation = self.client.UpdateVacation(
+ username=conf.options.get_value('targetusername'),
+ enable=False)
+
+ self.assert_(isinstance(new_vacation,
+ gdata.apps.emailsettings.data.EmailSettingsVacationResponder))
+ self.assertEqual(new_vacation.enable, 'False')
+
+ def testUpdateSignature(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testUpdateSignature')
+
+ new_signature = self.client.UpdateSignature(
+ username=conf.options.get_value('targetusername'),
+ signature='Regards, Joe')
+
+ self.assert_(isinstance(new_signature,
+ gdata.apps.emailsettings.data.EmailSettingsSignature))
+ self.assertEqual(new_signature.signature_value, 'Regards, Joe')
+
+ new_signature = self.client.UpdateSignature(
+ username=conf.options.get_value('targetusername'),
+ signature='')
+
+ self.assert_(isinstance(new_signature,
+ gdata.apps.emailsettings.data.EmailSettingsSignature))
+ self.assertEqual(new_signature.signature_value, '')
+
+ def testUpdateLanguage(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testUpdateLanguage')
+
+ new_language = self.client.UpdateLanguage(
+ username=conf.options.get_value('targetusername'),
+ language='es')
+
+ self.assert_(isinstance(new_language,
+ gdata.apps.emailsettings.data.EmailSettingsLanguage))
+ self.assertEqual(new_language.language_tag, 'es')
+
+ def testUpdateGeneral(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testUpdateGeneral')
+
+ new_general = self.client.UpdateGeneralSettings(
+ username=conf.options.get_value('targetusername'),
+ page_size=25, arrows=True)
+
+ self.assert_(isinstance(new_general,
+ gdata.apps.emailsettings.data.EmailSettingsGeneral))
+ self.assertEqual(new_general.page_size, '25')
+ self.assertEqual(new_general.arrows, 'True')
+
+ new_general = self.client.UpdateGeneralSettings(
+ username=conf.options.get_value('targetusername'),
+ shortcuts=False, snippets=True, use_unicode=False)
+
+ self.assert_(isinstance(new_general,
+ gdata.apps.emailsettings.data.EmailSettingsGeneral))
+ self.assertEqual(new_general.shortcuts, 'False')
+ self.assertEqual(new_general.snippets, 'True')
+ self.assertEqual(new_general.use_unicode, 'False')
+
+
+def suite():
+ return conf.build_suite([EmailSettingsClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/apps/emailsettings/service_test.py b/tests/gdata_tests/apps/emailsettings/service_test.py
new file mode 100644
index 0000000..0f3afbe
--- /dev/null
+++ b/tests/gdata_tests/apps/emailsettings/service_test.py
@@ -0,0 +1,126 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Test for Email Settings service."""
+
+
+__author__ = 'google-apps-apis@googlegroups.com'
+
+
+import getpass
+import gdata.apps.emailsettings.service
+import unittest
+
+
+domain = ''
+admin_email = ''
+admin_password = ''
+username = ''
+
+
+class EmailSettingsTest(unittest.TestCase):
+ """Test for the EmailSettingsService."""
+
+ def setUp(self):
+ self.es = gdata.apps.emailsettings.service.EmailSettingsService(
+ email=admin_email, password=admin_password, domain=domain)
+ self.es.ProgrammaticLogin()
+
+ def testCreateLabel(self):
+ result = self.es.CreateLabel(username, label='New label!!!')
+ self.assertEquals(result['label'], 'New label!!!')
+
+ def testCreateFilter(self):
+ result = self.es.CreateFilter(username,
+ from_='from_foo',
+ to='to_foo',
+ subject='subject_foo',
+ has_the_word='has_the_words_foo',
+ does_not_have_the_word='doesnt_have_foo',
+ has_attachment=True,
+ label='label_foo',
+ should_mark_as_read=True,
+ should_archive=True)
+ self.assertEquals(result['from'], 'from_foo')
+ self.assertEquals(result['to'], 'to_foo')
+ self.assertEquals(result['subject'], 'subject_foo')
+
+ def testCreateSendAsAlias(self):
+ result = self.es.CreateSendAsAlias(username,
+ name='Send-as Alias',
+ address='user2@sizzles.org',
+ reply_to='user3@sizzles.org',
+ make_default=True)
+ self.assertEquals(result['name'], 'Send-as Alias')
+
+ def testUpdateWebClipSettings(self):
+ result = self.es.UpdateWebClipSettings(username, enable=True)
+ self.assertEquals(result['enable'], 'true')
+
+ def testUpdateForwarding(self):
+ result = self.es.UpdateForwarding(username,
+ enable=True,
+ forward_to='user4@sizzles.org',
+ action=gdata.apps.emailsettings.service.KEEP)
+ self.assertEquals(result['enable'], 'true')
+
+ def testUpdatePop(self):
+ result = self.es.UpdatePop(username,
+ enable=True,
+ enable_for=gdata.apps.emailsettings.service.ALL_MAIL,
+ action=gdata.apps.emailsettings.service.ARCHIVE)
+ self.assertEquals(result['enable'], 'true')
+
+ def testUpdateImap(self):
+ result = self.es.UpdateImap(username, enable=True)
+ self.assertEquals(result['enable'], 'true')
+
+ def testUpdateVacation(self):
+ result = self.es.UpdateVacation(username,
+ enable=True,
+ subject='Hawaii',
+ message='Wish you were here!',
+ contacts_only=True)
+ self.assertEquals(result['subject'], 'Hawaii')
+
+ def testUpdateSignature(self):
+ result = self.es.UpdateSignature(username, signature='Signature')
+ self.assertEquals(result['signature'], 'Signature')
+
+ def testUpdateLanguage(self):
+ result = self.es.UpdateLanguage(username, language='fr')
+ self.assertEquals(result['language'], 'fr')
+
+ def testUpdateGeneral(self):
+ result = self.es.UpdateGeneral(username,
+ page_size=100,
+ shortcuts=True,
+ arrows=True,
+ snippets=True,
+ unicode=True)
+ self.assertEquals(result['pageSize'], '100')
+
+
+if __name__ == '__main__':
+ print("""Google Apps Email Settings Service Tests
+
+NOTE: Please run these tests only with a test user account.
+""")
+ domain = raw_input('Google Apps domain: ')
+ admin_email = '%s@%s' % (raw_input('Administrator username: '), domain)
+ admin_password = getpass.getpass('Administrator password: ')
+ username = raw_input('Test username: ')
+ unittest.main()
diff --git a/tests/gdata_tests/apps/groups/__init__.py b/tests/gdata_tests/apps/groups/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/apps/groups/__init__.py
diff --git a/tests/gdata_tests/apps/groups/data_test.py b/tests/gdata_tests/apps/groups/data_test.py
new file mode 100644
index 0000000..5b42e57
--- /dev/null
+++ b/tests/gdata_tests/apps/groups/data_test.py
@@ -0,0 +1,117 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model tests for the Groups Provisioning API."""
+
+
+__author__ = 'Shraddha gupta <shraddhag@google.com>'
+
+
+import unittest
+import atom.core
+from gdata import test_data
+import gdata.apps.groups.data
+import gdata.test_config as conf
+
+
+class GroupEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.GROUP_ENTRY,
+ gdata.apps.groups.data.GroupEntry, 2)
+ self.feed = atom.core.parse(test_data.GROUP_FEED,
+ gdata.apps.groups.data.GroupFeed, 2)
+
+ def testGroupEntryFromString(self):
+ self.assert_(isinstance(self.entry,
+ gdata.apps.groups.data.GroupEntry))
+ self.assertEquals(self.entry.group_id, 'trial@srkapps.com')
+ self.assertEquals(self.entry.group_name, 'Trial')
+ self.assertEquals(self.entry.email_permission, 'Domain')
+ self.assertEquals(self.entry.description, 'For try')
+
+ def testGroupFeedFromString(self):
+ self.assertEquals(len(self.feed.entry), 2)
+ self.assert_(isinstance(self.feed,
+ gdata.apps.groups.data.GroupFeed))
+ self.assert_(isinstance(self.feed.entry[0],
+ gdata.apps.groups.data.GroupEntry))
+ self.assert_(isinstance(self.feed.entry[1],
+ gdata.apps.groups.data.GroupEntry))
+ self.assertEquals(
+ self.feed.entry[0].find_edit_link(),
+ ('http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/'
+ 'firstgroup%40srkapps.com'))
+ self.assertEquals(self.feed.entry[0].group_id, 'firstgroup@srkapps.com')
+ self.assertEquals(self.feed.entry[0].group_name, 'FirstGroup')
+ self.assertEquals(self.feed.entry[0].email_permission, 'Domain')
+ self.assertEquals(self.feed.entry[0].description, 'First group')
+ self.assertEquals(
+ self.feed.entry[1].find_edit_link(),
+ ('http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/'
+ 'trial%40srkapps.com'))
+ self.assertEquals(self.feed.entry[1].group_id, 'trial@srkapps.com')
+ self.assertEquals(self.feed.entry[1].group_name, 'Trial')
+ self.assertEquals(self.feed.entry[1].email_permission, 'Domain')
+ self.assertEquals(self.feed.entry[1].description, 'For try')
+
+
+class GroupMemberEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.GROUP_MEMBER_ENTRY,
+ gdata.apps.groups.data.GroupMemberEntry)
+ self.feed = atom.core.parse(test_data.GROUP_MEMBER_FEED,
+ gdata.apps.groups.data.GroupMemberFeed)
+
+ def testGroupMemberEntryFromString(self):
+ self.assert_(isinstance(self.entry,
+ gdata.apps.groups.data.GroupMemberEntry))
+ self.assertEquals(self.entry.member_id, 'abcd12310@srkapps.com')
+ self.assertEquals(self.entry.member_type, 'User')
+ self.assertEquals(self.entry.direct_member, 'true')
+
+ def testGroupMemberFeedFromString(self):
+ self.assertEquals(len(self.feed.entry), 2)
+ self.assert_(isinstance(self.feed,
+ gdata.apps.groups.data.GroupMemberFeed))
+ self.assert_(isinstance(self.feed.entry[0],
+ gdata.apps.groups.data.GroupMemberEntry))
+ self.assert_(isinstance(self.feed.entry[1],
+ gdata.apps.groups.data.GroupMemberEntry))
+ self.assertEquals(
+ self.feed.entry[0].find_edit_link(),
+ ('http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/'
+ 'member/abcd12310%40srkapps.com'))
+ self.assertEquals(self.feed.entry[0].member_id, 'abcd12310@srkapps.com')
+ self.assertEquals(self.feed.entry[0].member_type, 'User')
+ self.assertEquals(self.feed.entry[0].direct_member, 'true')
+ self.assertEquals(
+ self.feed.entry[1].find_edit_link(),
+ ('http://apps-apis.google.com/a/feeds/group/2.0/srkapps.com/trial/'
+ 'member/neha.technocrat%40srkapps.com'))
+ self.assertEquals(self.feed.entry[1].member_id,
+ 'neha.technocrat@srkapps.com')
+ self.assertEquals(self.feed.entry[1].member_type, 'User')
+ self.assertEquals(self.feed.entry[1].direct_member, 'true')
+
+
+def suite():
+ return conf.build_suite([GroupEntryTest, GroupMemberEntryTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/apps/groups/live_client_test.py b/tests/gdata_tests/apps/groups/live_client_test.py
new file mode 100644
index 0000000..22b81a2
--- /dev/null
+++ b/tests/gdata_tests/apps/groups/live_client_test.py
@@ -0,0 +1,147 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Live client tests for the Groups Provisioning API."""
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'Shraddha gupta <shraddhag@google.com>'
+
+
+import random
+import unittest
+import gdata.apps.groups.client
+import gdata.apps.groups.data
+import gdata.client
+import gdata.data
+import gdata.gauth
+import gdata.test_config as conf
+
+conf.options.register_option(conf.APPS_DOMAIN_OPTION)
+
+
+class GroupsProvisioningClientTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.apps.groups.client.GroupsProvisioningClient(
+ domain='example.com')
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.apps.groups.client.GroupsProvisioningClient(
+ domain=conf.options.get_value('appsdomain'))
+ if conf.options.get_value('ssl') == 'true':
+ self.client.ssl = True
+ conf.configure_client(self.client, 'GroupsProvisioningClientTest',
+ self.client.auth_service, True)
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def testClientConfiguration(self):
+ self.assertEqual('apps-apis.google.com', self.client.host)
+ self.assertEqual('2.0', self.client.api_version)
+ self.assertEqual('apps', self.client.auth_service)
+ self.assertEqual(
+ ('https://apps-apis.google.com/a/feeds/user/',
+ 'https://apps-apis.google.com/a/feeds/policies/',
+ 'https://apps-apis.google.com/a/feeds/alias/',
+ 'https://apps-apis.google.com/a/feeds/groups/'),
+ self.client.auth_scopes)
+ if conf.options.get_value('runlive') == 'true':
+ self.assertEqual(self.client.domain, conf.options.get_value('appsdomain'))
+ else:
+ self.assertEqual(self.client.domain, 'example.com')
+
+ def testMakeGroupProvisioningUri(self):
+ self.assertEqual('/a/feeds/group/2.0/%s' % self.client.domain,
+ self.client.MakeGroupProvisioningUri())
+ self.assertEqual('/a/feeds/group/2.0/%s/firstgroup@example.com'
+ % self.client.domain,
+ self.client.MakeGroupProvisioningUri(group_id='firstgroup@example.com'))
+ self.assertEqual(
+ '/a/feeds/group/2.0/%s?member=member1' % self.client.domain,
+ self.client.MakeGroupProvisioningUri(params={'member':'member1'}))
+
+ def testMakeGroupMembersUri(self):
+ self.assertEqual('/a/feeds/group/2.0/%s/firstgroup@example.com/member'
+ % self.client.domain,
+ self.client.MakeGroupMembersUri(group_id='firstgroup@example.com'))
+ self.assertEqual(
+ '/a/feeds/group/2.0/%s/firstgroup@example.com/member/liz@example.com'
+ % self.client.domain,
+ self.client.MakeGroupMembersUri(
+ group_id='firstgroup@example.com', member_id='liz@example.com'))
+
+ def testCreateRetrieveUpdateDelete(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testCreateUpdateDelete')
+
+ rnd_number = random.randrange(0, 100)
+ group_id = 'test_groupid%s@%s' % (rnd_number, self.client.domain)
+ group_name = 'test_groupname%s' % (rnd_number)
+ member_id = 'test_member%s@%s' % (rnd_number, self.client.domain)
+
+ new_group = self.client.CreateGroup(
+ group_id=group_id, group_name=group_name, description='Test Group',
+ email_permission='Domain')
+
+ self.assert_(isinstance(new_group,
+ gdata.apps.groups.data.GroupEntry))
+ self.assertEquals(new_group.group_id, group_id)
+ self.assertEquals(new_group.group_name, group_name)
+ self.assertEquals(new_group.description, 'Test Group')
+ self.assertEquals(new_group.email_permission, 'Domain')
+
+ fetched_entry = self.client.RetrieveGroup(group_id=group_id)
+ self.assert_(isinstance(fetched_entry,
+ gdata.apps.groups.data.GroupEntry))
+ self.assertEquals(new_group.group_id, group_id)
+ self.assertEquals(new_group.group_name, group_name)
+ self.assertEquals(new_group.description, 'Test Group')
+ self.assertEquals(new_group.email_permission, 'Domain')
+
+ new_group.group_name = 'updated name'
+ updated_group = self.client.UpdateGroup(
+ group_id=group_id, group_entry=new_group)
+ self.assert_(isinstance(updated_group,
+ gdata.apps.groups.data.GroupEntry))
+ self.assertEqual(updated_group.group_name, 'updated name')
+
+ new_member = self.client.AddMemberToGroup(group_id=group_id,
+ member_id=member_id)
+ self.assert_(isinstance(new_member,
+ gdata.apps.groups.data.GroupMemberEntry))
+ self.assertEquals(new_member.member_id, member_id)
+
+ fetched_member = self.client.RetrieveGroupMember(group_id=group_id,
+ member_id=member_id)
+ self.assertEquals(fetched_member.member_id, member_id)
+
+ self.client.RemoveMemberFromGroup(group_id=group_id,
+ member_id=member_id)
+ self.client.DeleteGroup(group_id=group_id)
+
+
+def suite():
+ return conf.build_suite([GroupsProvisioningClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/apps/groups/service_test.py b/tests/gdata_tests/apps/groups/service_test.py
new file mode 100644
index 0000000..82b63c4
--- /dev/null
+++ b/tests/gdata_tests/apps/groups/service_test.py
@@ -0,0 +1,270 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Test for Groups service."""
+
+
+__author__ = 'google-apps-apis@googlegroups.com'
+
+
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom
+import gdata.apps
+import gdata.apps.service
+import gdata.apps.groups.service
+import getpass
+import time
+
+
+domain = ''
+admin_email = ''
+admin_password = ''
+username = ''
+
+
+class GroupsTest(unittest.TestCase):
+ """Test for the GroupsService."""
+
+ def setUp(self):
+ self.postfix = time.strftime("%Y%m%d%H%M%S")
+ self.apps_client = gdata.apps.service.AppsService(
+ email=admin_email, domain=domain, password=admin_password,
+ source='GroupsClient "Unit" Tests')
+ self.apps_client.ProgrammaticLogin()
+ self.groups_client = gdata.apps.groups.service.GroupsService(
+ email=admin_email, domain=domain, password=admin_password,
+ source='GroupsClient "Unit" Tests')
+ self.groups_client.ProgrammaticLogin()
+ self.created_users = []
+ self.created_groups = []
+ self.createUsers();
+
+ def createUsers(self):
+ user_name = 'yujimatsuo-' + self.postfix
+ family_name = 'Matsuo'
+ given_name = 'Yuji'
+ password = '123$$abc'
+ suspended = 'false'
+
+ try:
+ self.user_yuji = self.apps_client.CreateUser(
+ user_name=user_name, family_name=family_name, given_name=given_name,
+ password=password, suspended=suspended)
+ print 'User ' + user_name + ' created'
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.created_users.append(self.user_yuji)
+
+ user_name = 'taromatsuo-' + self.postfix
+ family_name = 'Matsuo'
+ given_name = 'Taro'
+ password = '123$$abc'
+ suspended = 'false'
+
+ try:
+ self.user_taro = self.apps_client.CreateUser(
+ user_name=user_name, family_name=family_name, given_name=given_name,
+ password=password, suspended=suspended)
+ print 'User ' + user_name + ' created'
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.created_users.append(self.user_taro)
+
+ def tearDown(self):
+ print '\n'
+ for user in self.created_users:
+ try:
+ self.apps_client.DeleteUser(user.login.user_name)
+ print 'User ' + user.login.user_name + ' deleted'
+ except Exception, e:
+ print e
+ for group in self.created_groups:
+ try:
+ self.groups_client.DeleteGroup(group)
+ print 'Group ' + group + ' deleted'
+ except Exception, e:
+ print e
+
+ def test001GroupsMethods(self):
+ # tests CreateGroup method
+ group01_id = 'group01-' + self.postfix
+ group02_id = 'group02-' + self.postfix
+ try:
+ created_group01 = self.groups_client.CreateGroup(group01_id, 'US Sales 1',
+ 'Testing', gdata.apps.groups.service.PERMISSION_OWNER)
+ created_group02 = self.groups_client.CreateGroup(group02_id, 'US Sales 2',
+ 'Testing', gdata.apps.groups.service.PERMISSION_OWNER)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(created_group01['groupId'], group01_id)
+ self.assertEquals(created_group02['groupId'], group02_id)
+ self.created_groups.append(group01_id)
+ self.created_groups.append(group02_id)
+
+ # tests UpdateGroup method
+ try:
+ updated_group = self.groups_client.UpdateGroup(group01_id, 'Updated!',
+ 'Testing', gdata.apps.groups.service.PERMISSION_OWNER)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(updated_group['groupName'], 'Updated!')
+
+ # tests RetrieveGroup method
+ try:
+ retrieved_group = self.groups_client.RetrieveGroup(group01_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(retrieved_group['groupId'], group01_id + '@' + domain)
+
+ # tests RetrieveAllGroups method
+ try:
+ retrieved_groups = self.groups_client.RetrieveAllGroups()
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(len(retrieved_groups),
+ len(self.apps_client.RetrieveAllEmailLists().entry))
+
+ # tests AddMemberToGroup
+ try:
+ added_member = self.groups_client.AddMemberToGroup(
+ self.user_yuji.login.user_name, group01_id)
+ self.groups_client.AddMemberToGroup(
+ self.user_taro.login.user_name, group02_id)
+ self.groups_client.AddMemberToGroup(
+ group01_id, group02_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(added_member['memberId'],
+ self.user_yuji.login.user_name)
+
+ # tests RetrieveGroups method
+ try:
+ retrieved_direct_groups = self.groups_client.RetrieveGroups(
+ self.user_yuji.login.user_name, True)
+ retrieved_groups = self.groups_client.RetrieveGroups(
+ self.user_yuji.login.user_name, False)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(len(retrieved_direct_groups), 1)
+ # TODO: Enable this test after a directOnly bug is fixed
+ #self.assertEquals(len(retrieved_groups), 2)
+
+ # tests IsMember method
+ try:
+ result = self.groups_client.IsMember(
+ self.user_yuji.login.user_name, group01_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(result, True)
+
+ # tests RetrieveMember method
+ try:
+ retrieved_member = self.groups_client.RetrieveMember(
+ self.user_yuji.login.user_name, group01_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(retrieved_member['memberId'],
+ self.user_yuji.login.user_name + '@' + domain)
+
+ # tests RetrieveAllMembers method
+ try:
+ retrieved_members = self.groups_client.RetrieveAllMembers(group01_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(len(retrieved_members), 1)
+
+ # tests RemoveMemberFromGroup method
+ try:
+ self.groups_client.RemoveMemberFromGroup(self.user_yuji.login.user_name,
+ group01_id)
+ retrieved_members = self.groups_client.RetrieveAllMembers(group01_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(len(retrieved_members), 0)
+
+ # tests AddOwnerToGroup
+ try:
+ added_owner = self.groups_client.AddOwnerToGroup(
+ self.user_yuji.login.user_name, group01_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(added_owner['email'],
+ self.user_yuji.login.user_name)
+
+ # tests IsOwner method
+ try:
+ result = self.groups_client.IsOwner(
+ self.user_yuji.login.user_name, group01_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(result, True)
+
+ # tests RetrieveOwner method
+ try:
+ retrieved_owner = self.groups_client.RetrieveOwner(
+ self.user_yuji.login.user_name, group01_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(retrieved_owner['email'],
+ self.user_yuji.login.user_name + '@' + domain)
+
+ # tests RetrieveAllOwners method
+ try:
+ retrieved_owners = self.groups_client.RetrieveAllOwners(group01_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(len(retrieved_owners), 1)
+
+ # tests RemoveOwnerFromGroup method
+ try:
+ self.groups_client.RemoveOwnerFromGroup(self.user_yuji.login.user_name,
+ group01_id)
+ retrieved_owners = self.groups_client.RetrieveAllOwners(group01_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(len(retrieved_owners), 0)
+
+
+if __name__ == '__main__':
+ print("""Google Apps Groups Service Tests
+
+NOTE: Please run these tests only with a test user account.
+""")
+ domain = raw_input('Google Apps domain: ')
+ admin_email = '%s@%s' % (raw_input('Administrator username: '), domain)
+ admin_password = getpass.getpass('Administrator password: ')
+ unittest.main()
diff --git a/tests/gdata_tests/apps/live_client_test.py b/tests/gdata_tests/apps/live_client_test.py
new file mode 100644
index 0000000..942336a
--- /dev/null
+++ b/tests/gdata_tests/apps/live_client_test.py
@@ -0,0 +1,135 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Live client tests for the Provisioning API."""
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'Shraddha Gupta <shraddhag@google.com>'
+
+
+import random
+import unittest
+import gdata.apps.client
+import gdata.apps.data
+import gdata.client
+import gdata.data
+import gdata.gauth
+import gdata.test_config as conf
+
+conf.options.register_option(conf.APPS_DOMAIN_OPTION)
+
+
+class AppsClientTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.apps.client.AppsClient(
+ domain='example.com')
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.apps.client.AppsClient(
+ domain=conf.options.get_value('appsdomain'))
+ if conf.options.get_value('ssl') == 'true':
+ self.client.ssl = True
+ conf.configure_client(self.client, 'AppsClientTest',
+ self.client.auth_service, True)
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def testClientConfiguration(self):
+ self.assertEqual('apps-apis.google.com', self.client.host)
+ self.assertEqual('2.0', self.client.api_version)
+ self.assertEqual('apps', self.client.auth_service)
+ self.assertEqual(
+ ('https://apps-apis.google.com/a/feeds/user/',
+ 'https://apps-apis.google.com/a/feeds/policies/',
+ 'https://apps-apis.google.com/a/feeds/alias/',
+ 'https://apps-apis.google.com/a/feeds/groups/'),
+ self.client.auth_scopes)
+ if conf.options.get_value('runlive') == 'true':
+ self.assertEqual(self.client.domain,
+ conf.options.get_value('appsdomain'))
+ else:
+ self.assertEqual(self.client.domain, 'example.com')
+
+ def testMakeUserProvisioningUri(self):
+ self.assertEqual('/a/feeds/%s/user/2.0' % self.client.domain,
+ self.client._userURL())
+
+ def testMakeNicknameProvisioningUri(self):
+ self.assertEqual('/a/feeds/%s/nickname/2.0' % self.client.domain,
+ self.client._nicknameURL())
+
+ def testCreateRetrieveUpdateDelete(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testCreateUpdateDelete')
+
+ rnd_number = random.randrange(0, 100001)
+ username = 'test_user%s' % (rnd_number)
+ nickname = 'test_alias%s' % (rnd_number)
+
+ new_entry = self.client.CreateUser(
+ user_name=username, given_name='Elizabeth', family_name='Smith',
+ password='password', admin='true')
+
+ self.assert_(isinstance(new_entry,
+ gdata.apps.data.UserEntry))
+ self.assertEquals(new_entry.name.given_name, 'Elizabeth')
+ self.assertEquals(new_entry.name.family_name, 'Smith')
+ self.assertEquals(new_entry.login.user_name, username)
+ self.assertEquals(new_entry.login.admin, 'true')
+
+ fetched_entry = self.client.RetrieveUser(user_name=username)
+ self.assertEquals(fetched_entry.name.given_name, 'Elizabeth')
+ self.assertEquals(fetched_entry.name.family_name, 'Smith')
+ self.assertEquals(fetched_entry.login.user_name, username)
+ self.assertEquals(fetched_entry.login.admin, 'true')
+
+ new_entry.name.given_name = 'Joe'
+ new_entry.name.family_name = 'Brown'
+ updated_entry = self.client.UpdateUser(
+ user_name=username, user_entry=new_entry)
+ self.assert_(isinstance(updated_entry,
+ gdata.apps.data.UserEntry))
+ self.assertEqual(updated_entry.name.given_name, 'Joe')
+ self.assertEqual(updated_entry.name.family_name, 'Brown')
+
+ new_nickname = self.client.CreateNickname(user_name=username,
+ nickname=nickname)
+ self.assert_(isinstance(new_nickname,
+ gdata.apps.data.NicknameEntry))
+ self.assertEquals(new_nickname.login.user_name, username)
+ self.assertEquals(new_nickname.nickname.name, nickname)
+
+ fetched_alias = self.client.RetrieveNickname(nickname)
+ self.assertEquals(fetched_alias.login.user_name, username)
+ self.assertEquals(fetched_alias.nickname.name, nickname)
+
+ self.client.DeleteNickname(nickname)
+ self.client.DeleteUser(username)
+
+
+def suite():
+ return conf.build_suite([AppsClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/apps/migration/__init__.py b/tests/gdata_tests/apps/migration/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/apps/migration/__init__.py
diff --git a/tests/gdata_tests/apps/migration/service_test.py b/tests/gdata_tests/apps/migration/service_test.py
new file mode 100755
index 0000000..4ba02fd
--- /dev/null
+++ b/tests/gdata_tests/apps/migration/service_test.py
@@ -0,0 +1,71 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2008 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Test for Email Migration service."""
+
+
+__author__ = 'google-apps-apis@googlegroups.com'
+
+
+import getpass
+import unittest
+import gdata.apps.migration.service
+
+
+domain = ''
+admin_email = ''
+admin_password = ''
+username = ''
+MESSAGE = """From: joe@blow.com
+To: jane@doe.com
+Date: Mon, 29 Sep 2008 20:00:34 -0500 (CDT)
+Subject: %s
+
+%s"""
+
+
+class MigrationTest(unittest.TestCase):
+ """Test for the MigrationService."""
+
+ def setUp(self):
+ self.ms = gdata.apps.migration.service.MigrationService(
+ email=admin_email, password=admin_password, domain=domain)
+ self.ms.ProgrammaticLogin()
+
+ def testImportMail(self):
+ self.ms.ImportMail(user_name=username,
+ mail_message=MESSAGE % ('Test subject', 'Test body'),
+ mail_item_properties=['IS_STARRED'],
+ mail_labels=['Test'])
+
+ def testImportMultipleMails(self):
+ for i in xrange(1, 10):
+ self.ms.AddMailEntry(mail_message=MESSAGE % ('Test thread %d' % i,
+ 'Test thread'),
+ mail_item_properties=['IS_UNREAD'],
+ mail_labels=['Test', 'Thread'],
+ identifier=str(i))
+ self.ms.ImportMultipleMails(user_name=username)
+
+
+if __name__ == '__main__':
+ print("Google Apps Email Migration Service Tests\n\n"
+ "NOTE: Please run these tests only with a test user account.\n")
+ domain = raw_input('Google Apps domain: ')
+ admin_email = '%s@%s' % (raw_input('Administrator username: '), domain)
+ admin_password = getpass.getpass('Administrator password: ')
+ username = raw_input('Test username: ')
+ unittest.main()
diff --git a/tests/gdata_tests/apps/multidomain/__init__.py b/tests/gdata_tests/apps/multidomain/__init__.py
new file mode 100755
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/apps/multidomain/__init__.py
diff --git a/tests/gdata_tests/apps/multidomain/data_test.py b/tests/gdata_tests/apps/multidomain/data_test.py
new file mode 100755
index 0000000..729a919
--- /dev/null
+++ b/tests/gdata_tests/apps/multidomain/data_test.py
@@ -0,0 +1,135 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model tests for the Multidomain Provisioning API."""
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import unittest
+import atom.core
+from gdata import test_data
+import gdata.apps.multidomain.data
+import gdata.test_config as conf
+
+
+class UserEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.MULTIDOMAIN_USER_ENTRY,
+ gdata.apps.multidomain.data.UserEntry)
+ self.feed = atom.core.parse(test_data.MULTIDOMAIN_USER_FEED,
+ gdata.apps.multidomain.data.UserFeed)
+
+ def testUserEntryFromString(self):
+ self.assert_(isinstance(self.entry,
+ gdata.apps.multidomain.data.UserEntry))
+ self.assertEquals(self.entry.first_name, 'Liz')
+ self.assertEquals(self.entry.last_name, 'Smith')
+ self.assertEquals(self.entry.email, 'liz@example.com')
+ self.assertEquals(self.entry.password,
+ '51eea05d46317fadd5cad6787a8f562be90b4446')
+ self.assertEquals(self.entry.is_admin, 'true')
+
+ def testUserFeedFromString(self):
+ self.assertEquals(len(self.feed.entry), 2)
+ self.assert_(isinstance(self.feed,
+ gdata.apps.multidomain.data.UserFeed))
+ self.assert_(isinstance(self.feed.entry[0],
+ gdata.apps.multidomain.data.UserEntry))
+ self.assert_(isinstance(self.feed.entry[1],
+ gdata.apps.multidomain.data.UserEntry))
+ self.assertEquals(
+ self.feed.entry[0].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/user/2.0/example.com/'
+ 'admin%40example.com'))
+ self.assertEquals(self.feed.entry[0].first_name, 'Joe')
+ self.assertEquals(self.feed.entry[0].last_name, 'Brown')
+ self.assertEquals(self.feed.entry[0].email, 'admin@example.com')
+ self.assertEquals(self.feed.entry[0].is_admin, 'true')
+ self.assertEquals(self.feed.entry[0].suspended, 'false')
+ self.assertEquals(self.feed.entry[0].change_password_at_next_login, 'false')
+ self.assertEquals(self.feed.entry[0].ip_whitelisted, 'false')
+ self.assertEquals(
+ self.feed.entry[1].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/user/2.0/example.com/'
+ 'liz%40example.com'))
+ self.assertEquals(self.feed.entry[1].first_name, 'Elizabeth')
+ self.assertEquals(self.feed.entry[1].last_name, 'Smith')
+ self.assertEquals(self.feed.entry[1].email, 'liz@example.com')
+ self.assertEquals(self.feed.entry[1].is_admin, 'true')
+ self.assertEquals(self.feed.entry[1].suspended, 'false')
+ self.assertEquals(self.feed.entry[1].change_password_at_next_login, 'false')
+ self.assertEquals(self.feed.entry[1].ip_whitelisted, 'false')
+
+
+class UserRenameRequestTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.MULTIDOMAIN_USER_RENAME_REQUEST,
+ gdata.apps.multidomain.data.UserRenameRequest)
+
+ def testUserRenameRequestFromString(self):
+ self.assert_(isinstance(self.entry,
+ gdata.apps.multidomain.data.UserRenameRequest))
+ self.assertEquals(self.entry.new_email, 'liz@newexample4liz.com')
+
+
+class AliasEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.MULTIDOMAIN_ALIAS_ENTRY,
+ gdata.apps.multidomain.data.AliasEntry)
+ self.feed = atom.core.parse(test_data.MULTIDOMAIN_ALIAS_FEED,
+ gdata.apps.multidomain.data.AliasFeed)
+
+ def testAliasEntryFromString(self):
+ self.assert_(isinstance(self.entry,
+ gdata.apps.multidomain.data.AliasEntry))
+ self.assertEquals(self.entry.user_email, 'liz@example.com')
+ self.assertEquals(self.entry.alias_email, 'helpdesk@gethelp_example.com')
+
+ def testAliasFeedFromString(self):
+ self.assertEquals(len(self.feed.entry), 2)
+ self.assert_(isinstance(self.feed,
+ gdata.apps.multidomain.data.AliasFeed))
+ self.assert_(isinstance(self.feed.entry[0],
+ gdata.apps.multidomain.data.AliasEntry))
+ self.assert_(isinstance(self.feed.entry[1],
+ gdata.apps.multidomain.data.AliasEntry))
+ self.assertEquals(
+ self.feed.entry[0].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/'
+ 'helpdesk%40gethelp_example.com'))
+ self.assertEquals(self.feed.entry[0].user_email, 'liz@example.com')
+ self.assertEquals(self.feed.entry[0].alias_email,
+ 'helpdesk@gethelp_example.com')
+ self.assertEquals(
+ self.feed.entry[1].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/alias/2.0/gethelp_example.com/'
+ 'support%40gethelp_example.com'))
+ self.assertEquals(self.feed.entry[1].user_email, 'joe@example.com')
+ self.assertEquals(self.feed.entry[1].alias_email,
+ 'support@gethelp_example.com')
+
+
+def suite():
+ return conf.build_suite([UserEntryTest, AliasEntryTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/apps/multidomain/live_client_test.py b/tests/gdata_tests/apps/multidomain/live_client_test.py
new file mode 100755
index 0000000..1f91c41
--- /dev/null
+++ b/tests/gdata_tests/apps/multidomain/live_client_test.py
@@ -0,0 +1,160 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Live client tests for the Multidomain Provisioning API."""
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'Claudio Cherubino <ccherubino@google.com>'
+
+
+import random
+import unittest
+import gdata.apps.multidomain.client
+import gdata.apps.multidomain.data
+import gdata.client
+import gdata.data
+import gdata.gauth
+import gdata.test_config as conf
+
+conf.options.register_option(conf.APPS_DOMAIN_OPTION)
+
+
+class MultidomainProvisioningClientTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.apps.multidomain.client.MultiDomainProvisioningClient(
+ domain='example.com')
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.apps.multidomain.client.MultiDomainProvisioningClient(
+ domain=conf.options.get_value('appsdomain'))
+ if conf.options.get_value('ssl') == 'true':
+ self.client.ssl = True
+ conf.configure_client(self.client, 'MultidomainProvisioningClientTest',
+ self.client.auth_service, True)
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def testClientConfiguration(self):
+ self.assertEqual('apps-apis.google.com', self.client.host)
+ self.assertEqual('2.0', self.client.api_version)
+ self.assertEqual('apps', self.client.auth_service)
+ self.assertEqual(gdata.gauth.AUTH_SCOPES['apps'], self.client.auth_scopes)
+ if conf.options.get_value('runlive') == 'true':
+ self.assertEqual(self.client.domain, conf.options.get_value('appsdomain'))
+ else:
+ self.assertEqual(self.client.domain, 'example.com')
+
+ def testMakeMultidomainUserProvisioningUri(self):
+ self.assertEqual('/a/feeds/user/2.0/%s' % self.client.domain,
+ self.client.MakeMultidomainUserProvisioningUri())
+ self.assertEqual('/a/feeds/user/2.0/%s/liz@example.com'
+ % self.client.domain,
+ self.client.MakeMultidomainUserProvisioningUri(
+ email='liz@example.com'))
+ self.assertEqual('/a/feeds/user/2.0/%s?start=%s'
+ % (self.client.domain, 'liz%40example.com'),
+ self.client.MakeMultidomainUserProvisioningUri(
+ params={'start': 'liz@example.com'}))
+
+ def testMakeMultidomainAliasProvisioningUri(self):
+ self.assertEqual('/a/feeds/alias/2.0/%s' % self.client.domain,
+ self.client.MakeMultidomainAliasProvisioningUri())
+ self.assertEqual('/a/feeds/alias/2.0/%s/liz@example.com'
+ % self.client.domain,
+ self.client.MakeMultidomainAliasProvisioningUri(
+ email='liz@example.com'))
+ self.assertEqual('/a/feeds/alias/2.0/%s?start=%s'
+ % (self.client.domain, 'liz%40example.com'),
+ self.client.MakeMultidomainAliasProvisioningUri(
+ params={'start': 'liz@example.com'}))
+
+ def testCreateRetrieveUpdateDelete(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testCreateUpdateDelete')
+
+ rnd_number = random.randrange(0, 100001)
+ email = 'test_user%s@%s' % (rnd_number, self.client.domain)
+ alias = 'test_alias%s@%s' % (rnd_number, self.client.domain)
+
+ new_entry = self.client.CreateUser(
+ email, 'Elizabeth', 'Smith',
+ '51eea05d46317fadd5cad6787a8f562be90b4446', 'true',
+ hash_function='SHA-1')
+
+ self.assert_(isinstance(new_entry,
+ gdata.apps.multidomain.data.UserEntry))
+ self.assertEquals(new_entry.first_name, 'Elizabeth')
+ self.assertEquals(new_entry.last_name, 'Smith')
+ self.assertEquals(new_entry.email, email)
+ self.assertEquals(new_entry.password,
+ '51eea05d46317fadd5cad6787a8f562be90b4446')
+ self.assertEquals(new_entry.is_admin, 'true')
+
+ fetched_entry = self.client.RetrieveUser(email=email)
+ self.assertEquals(fetched_entry.first_name, 'Elizabeth')
+ self.assertEquals(fetched_entry.last_name, 'Smith')
+ self.assertEquals(fetched_entry.email, email)
+ self.assertEquals(fetched_entry.is_admin, 'true')
+
+ new_entry.first_name = 'Joe'
+ new_entry.last_name = 'Brown'
+ updated_entry = self.client.UpdateUser(
+ email=email, user_entry=new_entry)
+ self.assert_(isinstance(updated_entry,
+ gdata.apps.multidomain.data.UserEntry))
+ self.assertEqual(updated_entry.first_name, 'Joe')
+ self.assertEqual(updated_entry.last_name, 'Brown')
+
+ new_email = 'renamed_user%s@%s' % (rnd_number, self.client.domain)
+ renamed_entry = self.client.RenameUser(
+ old_email=email, new_email=new_email)
+ self.assert_(isinstance(renamed_entry,
+ gdata.apps.multidomain.data.UserRenameRequest))
+ self.assertEqual(renamed_entry.new_email, new_email)
+
+ new_alias = self.client.CreateAlias(new_email, alias)
+ self.assert_(isinstance(new_alias,
+ gdata.apps.multidomain.data.AliasEntry))
+ self.assertEquals(new_alias.user_email, new_email)
+ self.assertEquals(new_alias.alias_email, alias)
+
+ fetched_alias = self.client.RetrieveAlias(alias)
+ self.assertEquals(fetched_alias.user_email, new_email)
+ self.assertEquals(fetched_alias.alias_email, alias)
+
+ fetched_aliases = self.client.RetrieveAllUserAliases(new_email)
+ self.assertEquals(fetched_aliases.entry[0].user_email, new_email)
+ self.assertEquals(fetched_aliases.entry[0].alias_email, email)
+ self.assertEquals(fetched_aliases.entry[1].user_email, new_email)
+ self.assertEquals(fetched_aliases.entry[1].alias_email, alias)
+
+ self.client.DeleteAlias(alias)
+ self.client.DeleteUser(new_email)
+
+
+def suite():
+ return conf.build_suite([MultidomainProvisioningClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/apps/organization/__init__.py b/tests/gdata_tests/apps/organization/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/apps/organization/__init__.py
diff --git a/tests/gdata_tests/apps/organization/data_test.py b/tests/gdata_tests/apps/organization/data_test.py
new file mode 100644
index 0000000..1bc698c
--- /dev/null
+++ b/tests/gdata_tests/apps/organization/data_test.py
@@ -0,0 +1,132 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Data model tests for the Organization Unit Provisioning API."""
+
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+
+import unittest
+import atom.core
+from gdata import test_data
+import gdata.apps.organization.data
+import gdata.test_config as conf
+
+
+class CustomerIdEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.ORGANIZATION_UNIT_CUSTOMER_ID_ENTRY,
+ gdata.apps.organization.data.CustomerIdEntry)
+
+ def testCustomerIdEntryFromString(self):
+ self.assert_(isinstance(self.entry,
+ gdata.apps.organization.data.CustomerIdEntry))
+ self.assertEquals(self.entry.customer_id, 'C123A456B')
+ self.assertEquals(self.entry.customer_org_unit_name, 'example.com')
+ self.assertEquals(self.entry.customer_org_unit_description, 'example.com')
+ self.assertEquals(self.entry.org_unit_name, 'example.com')
+ self.assertEquals(self.entry.org_unit_description, 'tempdescription')
+
+
+class OrgUnitEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.ORGANIZATION_UNIT_ORGUNIT_ENTRY,
+ gdata.apps.organization.data.OrgUnitEntry)
+ self.feed = atom.core.parse(test_data.ORGANIZATION_UNIT_ORGUNIT_FEED,
+ gdata.apps.organization.data.OrgUnitFeed)
+
+ def testOrgUnitEntryFromString(self):
+ self.assert_(isinstance(self.entry,
+ gdata.apps.organization.data.OrgUnitEntry))
+ self.assertEquals(self.entry.org_unit_description, 'New Test Org')
+ self.assertEquals(self.entry.org_unit_name, 'Test Organization')
+ self.assertEquals(self.entry.org_unit_path, 'Test/Test+Organization')
+ self.assertEquals(self.entry.parent_org_unit_path, 'Test')
+ self.assertEquals(self.entry.org_unit_block_inheritance, 'false')
+
+ def testOrgUnitFeedFromString(self):
+ self.assertEquals(len(self.feed.entry), 2)
+ self.assert_(isinstance(self.feed,
+ gdata.apps.organization.data.OrgUnitFeed))
+ self.assert_(isinstance(self.feed.entry[0],
+ gdata.apps.organization.data.OrgUnitEntry))
+ self.assert_(isinstance(self.feed.entry[1],
+ gdata.apps.organization.data.OrgUnitEntry))
+ self.assertEquals(
+ self.feed.entry[0].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/orgunit/2.0/'
+ 'C123A456B/testOrgUnit92'))
+ self.assertEquals(self.feed.entry[0].org_unit_description, 'test92')
+ self.assertEquals(self.feed.entry[0].org_unit_name, 'testOrgUnit92')
+ self.assertEquals(self.feed.entry[0].org_unit_path, 'Test/testOrgUnit92')
+ self.assertEquals(self.feed.entry[0].parent_org_unit_path, 'Test')
+ self.assertEquals(self.feed.entry[0].org_unit_block_inheritance, 'false')
+ self.assertEquals(
+ self.feed.entry[1].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/orgunit/2.0/'
+ 'C123A456B/testOrgUnit93'))
+ self.assertEquals(self.feed.entry[1].org_unit_description, 'test93')
+ self.assertEquals(self.feed.entry[1].org_unit_name, 'testOrgUnit93')
+ self.assertEquals(self.feed.entry[1].org_unit_path, 'Test/testOrgUnit93')
+ self.assertEquals(self.feed.entry[1].parent_org_unit_path, 'Test')
+ self.assertEquals(self.feed.entry[1].org_unit_block_inheritance, 'false')
+
+
+class OrgUserEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.ORGANIZATION_UNIT_ORGUSER_ENTRY,
+ gdata.apps.organization.data.OrgUserEntry)
+ self.feed = atom.core.parse(test_data.ORGANIZATION_UNIT_ORGUSER_FEED,
+ gdata.apps.organization.data.OrgUserFeed)
+
+ def testOrgUserEntryFromString(self):
+ self.assert_(isinstance(self.entry,
+ gdata.apps.organization.data.OrgUserEntry))
+ self.assertEquals(self.entry.user_email, 'admin@example.com')
+ self.assertEquals(self.entry.org_unit_path, 'Test')
+
+ def testOrgUserFeedFromString(self):
+ self.assertEquals(len(self.feed.entry), 2)
+ self.assert_(isinstance(self.feed,
+ gdata.apps.organization.data.OrgUserFeed))
+ self.assert_(isinstance(self.feed.entry[0],
+ gdata.apps.organization.data.OrgUserEntry))
+ self.assert_(isinstance(self.feed.entry[1],
+ gdata.apps.organization.data.OrgUserEntry))
+ self.assertEquals(
+ self.feed.entry[0].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/orguser/2.0/'
+ 'C123A456B/user720430%40example.com'))
+ self.assertEquals(self.feed.entry[0].user_email, 'user720430@example.com')
+ self.assertEquals(self.feed.entry[0].org_unit_path, 'Test')
+ self.assertEquals(
+ self.feed.entry[1].find_edit_link(),
+ ('https://apps-apis.google.com/a/feeds/orguser/2.0/'
+ 'C123A456B/user832648%40example.com'))
+ self.assertEquals(self.feed.entry[1].user_email, 'user832648@example.com')
+ self.assertEquals(self.feed.entry[1].org_unit_path, 'Test')
+
+
+def suite():
+ return conf.build_suite([OrgUnitEntryTest, OrgUserEntryTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/apps/organization/live_client_test.py b/tests/gdata_tests/apps/organization/live_client_test.py
new file mode 100644
index 0000000..ca69661
--- /dev/null
+++ b/tests/gdata_tests/apps/organization/live_client_test.py
@@ -0,0 +1,141 @@
+#!/usr/bin/python2.4
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Live client tests for the Organization Unit Provisioning API."""
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'Gunjan Sharma <gunjansharma@google.com>'
+
+
+import random
+import unittest
+import gdata.apps.organization.client
+import gdata.apps.organization.data
+import gdata.client
+import gdata.data
+import gdata.gauth
+import gdata.test_config as conf
+
+conf.options.register_option(conf.APPS_DOMAIN_OPTION)
+
+
+class OrganizationUnitProvisioningClientTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.apps.organization.client.OrganizationUnitProvisioningClient(
+ domain='example.com')
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.apps.organization.client.OrganizationUnitProvisioningClient(
+ domain=conf.options.get_value('appsdomain'))
+ if conf.options.get_value('ssl') == 'true':
+ self.client.ssl = True
+ conf.configure_client(self.client,
+ 'OrganizationUnitProvisioningClientTest',
+ self.client.auth_service, True)
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def testClientConfiguration(self):
+ self.assertEqual('apps-apis.google.com', self.client.host)
+ self.assertEqual('2.0', self.client.api_version)
+ self.assertEqual('apps', self.client.auth_service)
+ self.assertEqual(
+ ('https://apps-apis.google.com/a/feeds/user/',
+ 'https://apps-apis.google.com/a/feeds/policies/',
+ 'https://apps-apis.google.com/a/feeds/alias/',
+ 'https://apps-apis.google.com/a/feeds/groups/'),
+ self.client.auth_scopes)
+ if conf.options.get_value('runlive') == 'true':
+ self.assertEqual(self.client.domain,
+ conf.options.get_value('appsdomain'))
+ else:
+ self.assertEqual(self.client.domain, 'example.com')
+
+ def testMakeCustomerIdFeedUri(self):
+ self.assertEqual('/a/feeds/customer/2.0/customerId',
+ self.client.MakeCustomerIdFeedUri())
+
+ def testMakeOrganizationUnitOrgunitProvisioningUri(self):
+ self.customer_id = 'tempo'
+ self.assertEqual('/a/feeds/orgunit/2.0/%s' % self.customer_id,
+ self.client.MakeOrganizationUnitOrgunitProvisioningUri(
+ self.customer_id))
+ self.assertEqual(
+ '/a/feeds/orgunit/2.0/%s/testing/Test+Test' % self.customer_id,
+ self.client.MakeOrganizationUnitOrgunitProvisioningUri(
+ self.customer_id, org_unit_path='testing/Test+Test'))
+ self.assertEqual(
+ '/a/feeds/orgunit/2.0/%s?get=all' % (self.customer_id),
+ self.client.MakeOrganizationUnitOrgunitProvisioningUri(
+ self.customer_id, params={'get': 'all'}))
+
+ def testMakeOrganizationUnitOrguserProvisioningUri(self):
+ self.customer_id = 'tempo'
+ self.assertEqual('/a/feeds/orguser/2.0/%s' % self.customer_id,
+ self.client.MakeOrganizationUnitOrguserProvisioningUri(
+ self.customer_id))
+ self.assertEqual(
+ '/a/feeds/orguser/2.0/%s/admin@example.com' % self.customer_id,
+ self.client.MakeOrganizationUnitOrguserProvisioningUri(
+ self.customer_id, org_user_email='admin@example.com'))
+ self.assertEqual(
+ '/a/feeds/orguser/2.0/%s?get=all' % (self.customer_id),
+ self.client.MakeOrganizationUnitOrguserProvisioningUri(
+ self.customer_id, params={'get': 'all'}))
+
+ def testCreateRetrieveUpdateDelete(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testCreateRetrieveUpdateDelete')
+
+ customer_id = self.client.RetrieveCustomerId().GetCustomerId()
+ rnd_number = random.randrange(0, 100001)
+ org_unit_name = 'test_org_unit_name%s' % (rnd_number)
+ org_unit_description = 'test_org_unit_description%s' % (rnd_number)
+ org_unit_path = org_unit_name
+
+ new_entry = self.client.CreateOrgUnit(customer_id, org_unit_name,
+ parent_org_unit_path='/',
+ description=org_unit_description,
+ block_inheritance=False)
+ self.assert_(isinstance(new_entry,
+ gdata.apps.organization.data.OrgUnitEntry))
+ self.assertEquals(new_entry.org_unit_path, org_unit_path)
+
+ entry = self.client.RetrieveOrgUnit(customer_id, org_unit_path)
+ self.assert_(isinstance(entry,
+ gdata.apps.organization.data.OrgUnitEntry))
+ self.assertEquals(entry.org_unit_name, org_unit_name)
+ self.assertEquals(entry.org_unit_description, org_unit_description)
+ self.assertEquals(entry.parent_org_unit_path, '')
+ self.assertEquals(entry.org_unit_path, org_unit_path)
+ self.assertEquals(entry.org_unit_block_inheritance, 'false')
+
+ self.client.DeleteOrgUnit(customer_id, org_unit_name)
+
+
+def suite():
+ return conf.build_suite([OrganizationUnitProvisioningClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/apps/organization/service_test.py b/tests/gdata_tests/apps/organization/service_test.py
new file mode 100644
index 0000000..9db426f
--- /dev/null
+++ b/tests/gdata_tests/apps/organization/service_test.py
@@ -0,0 +1,330 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Test for Organization service."""
+
+
+__author__ = 'Alexandre Vivien (alex@simplecode.fr)'
+
+
+import urllib
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom
+import gdata.apps
+import gdata.apps.service
+import gdata.apps.organization.service
+import getpass
+import time
+
+
+domain = ''
+admin_email = ''
+admin_password = ''
+username = ''
+
+
+class OrganizationTest(unittest.TestCase):
+ """Test for the OrganizationService."""
+
+ def setUp(self):
+ self.postfix = time.strftime("%Y%m%d%H%M%S")
+ self.apps_client = gdata.apps.service.AppsService(
+ email=admin_email, domain=domain, password=admin_password,
+ source='OrganizationClient "Unit" Tests')
+ self.apps_client.ProgrammaticLogin()
+ self.organization_client = gdata.apps.organization.service.OrganizationService(
+ email=admin_email, domain=domain, password=admin_password,
+ source='GroupsClient "Unit" Tests')
+ self.organization_client.ProgrammaticLogin()
+ self.created_users = []
+ self.created_org_units = []
+ self.cutomer_id = None
+ self.createUsers();
+
+ def createUsers(self):
+ user_name = 'yujimatsuo-' + self.postfix
+ family_name = 'Matsuo'
+ given_name = 'Yuji'
+ password = '123$$abc'
+ suspended = 'false'
+
+ try:
+ self.user_yuji = self.apps_client.CreateUser(user_name=user_name,
+ family_name=family_name,
+ given_name=given_name,
+ password=password,
+ suspended=suspended)
+ print 'User ' + user_name + ' created'
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.created_users.append(self.user_yuji)
+
+ user_name = 'taromatsuo-' + self.postfix
+ family_name = 'Matsuo'
+ given_name = 'Taro'
+ password = '123$$abc'
+ suspended = 'false'
+
+ try:
+ self.user_taro = self.apps_client.CreateUser(user_name=user_name,
+ family_name=family_name,
+ given_name=given_name,
+ password=password,
+ suspended=suspended)
+ print 'User ' + user_name + ' created'
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.created_users.append(self.user_taro)
+
+ user_name = 'alexandrevivien-' + self.postfix
+ family_name = 'Vivien'
+ given_name = 'Alexandre'
+ password = '123$$abc'
+ suspended = 'false'
+
+ try:
+ self.user_alex = self.apps_client.CreateUser(user_name=user_name,
+ family_name=family_name,
+ given_name=given_name,
+ password=password,
+ suspended=suspended)
+ print 'User ' + user_name + ' created'
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.created_users.append(self.user_alex)
+
+ def tearDown(self):
+ print '\n'
+ for user in self.created_users:
+ try:
+ self.apps_client.DeleteUser(user.login.user_name)
+ print 'User ' + user.login.user_name + ' deleted'
+ except Exception, e:
+ print e
+ # We reverse to delete sub OrgUnit first
+ self.created_org_units.reverse()
+ for org_unit_path in self.created_org_units:
+ try:
+ self.organization_client.DeleteOrgUnit(self.customer_id, org_unit_path)
+ print 'OrgUnit ' + org_unit_path + ' deleted'
+ except Exception, e:
+ print e
+
+ def testOrganizationService(self):
+
+ # tests RetrieveCustomerId method
+ try:
+ customer = self.organization_client.RetrieveCustomerId()
+ self.customer_id = customer['customerId']
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+ print 'tests RetrieveCustomerId successful'
+
+ # tests CreateOrgUnit method
+ orgUnit01_name = 'OrgUnit01-' + self.postfix
+ orgUnit02_name = 'OrgUnit02-' + self.postfix
+ sub0rgUnit01_name = 'SubOrgUnit01-' + self.postfix
+ orgUnit03_name = 'OrgUnit03-' + self.postfix
+ try:
+ orgUnit01 = self.organization_client.CreateOrgUnit(self.customer_id,
+ name=orgUnit01_name,
+ parent_org_unit_path='/',
+ description='OrgUnit Test 01',
+ block_inheritance=False)
+ orgUnit02 = self.organization_client.CreateOrgUnit(self.customer_id,
+ name=orgUnit02_name,
+ parent_org_unit_path='/',
+ description='OrgUnit Test 02',
+ block_inheritance=False)
+ sub0rgUnit01 = self.organization_client.CreateOrgUnit(self.customer_id,
+ name=sub0rgUnit01_name,
+ parent_org_unit_path=orgUnit02['orgUnitPath'],
+ description='SubOrgUnit Test 01',
+ block_inheritance=False)
+ orgUnit03 = self.organization_client.CreateOrgUnit(self.customer_id,
+ name=orgUnit03_name,
+ parent_org_unit_path='/',
+ description='OrgUnit Test 03',
+ block_inheritance=False)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(orgUnit01['orgUnitPath'], urllib.quote_plus(orgUnit01_name))
+ self.assertEquals(orgUnit02['orgUnitPath'], urllib.quote_plus(orgUnit02_name))
+ self.assertEquals(sub0rgUnit01['orgUnitPath'], urllib.quote_plus(orgUnit02_name) + '/' + urllib.quote_plus(sub0rgUnit01_name))
+ self.assertEquals(orgUnit03['orgUnitPath'], urllib.quote_plus(orgUnit03_name))
+ self.created_org_units.append(orgUnit01['orgUnitPath'])
+ self.created_org_units.append(orgUnit02['orgUnitPath'])
+ self.created_org_units.append(sub0rgUnit01['orgUnitPath'])
+ self.created_org_units.append(orgUnit03['orgUnitPath'])
+ print 'tests CreateOrgUnit successful'
+
+ # tests UpdateOrgUnit method
+ try:
+ updated_orgunit = self.organization_client.UpdateOrgUnit(self.customer_id,
+ org_unit_path=self.created_org_units[3],
+ description='OrgUnit Test 03 Updated description')
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(updated_orgunit['orgUnitPath'], self.created_org_units[3])
+ print 'tests UpdateOrgUnit successful'
+
+ # tests RetrieveOrgUnit method
+ try:
+ retrieved_orgunit = self.organization_client.RetrieveOrgUnit(self.customer_id,
+ org_unit_path=self.created_org_units[1])
+ retrieved_suborgunit = self.organization_client.RetrieveOrgUnit(self.customer_id,
+ org_unit_path=self.created_org_units[2])
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(retrieved_orgunit['orgUnitPath'], self.created_org_units[1])
+ self.assertEquals(retrieved_suborgunit['orgUnitPath'], self.created_org_units[2])
+ print 'tests RetrieveOrgUnit successful'
+
+ # tests RetrieveAllOrgUnits method
+ try:
+ retrieved_orgunits = self.organization_client.RetrieveAllOrgUnits(self.customer_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertTrue(len(retrieved_orgunits) >= len(self.created_org_units))
+ print 'tests RetrieveAllOrgUnits successful'
+
+ # tests MoveUserToOrgUnit method
+ try:
+ updated_orgunit01 = self.organization_client.MoveUserToOrgUnit(self.customer_id,
+ org_unit_path=self.created_org_units[0],
+ users_to_move=[self.user_yuji.login.user_name + '@' + domain])
+ updated_orgunit02 = self.organization_client.MoveUserToOrgUnit(self.customer_id,
+ org_unit_path=self.created_org_units[1],
+ users_to_move=[self.user_taro.login.user_name + '@' + domain,
+ self.user_alex.login.user_name + '@' + domain])
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(updated_orgunit01['usersMoved'], self.user_yuji.login.user_name + '@' + domain)
+ self.assertEquals(updated_orgunit02['usersMoved'], self.user_taro.login.user_name + '@' + domain + ',' + \
+ self.user_alex.login.user_name + '@' + domain)
+ print 'tests MoveUserToOrgUnit successful'
+
+ # tests RetrieveSubOrgUnits method
+ try:
+ retrieved_suborgunits = self.organization_client.RetrieveSubOrgUnits(self.customer_id,
+ org_unit_path=self.created_org_units[1])
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(len(retrieved_suborgunits), 1)
+ self.assertEquals(retrieved_suborgunits[0]['orgUnitPath'], self.created_org_units[2])
+ print 'tests RetrieveSubOrgUnits successful'
+
+ # tests RetrieveOrgUser method
+ try:
+ retrieved_orguser = self.organization_client.RetrieveOrgUser(self.customer_id,
+ user_email=self.user_yuji.login.user_name + '@' + domain)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(retrieved_orguser['orgUserEmail'], self.user_yuji.login.user_name + '@' + domain)
+ self.assertEquals(retrieved_orguser['orgUnitPath'], self.created_org_units[0])
+ print 'tests RetrieveOrgUser successful'
+
+ # tests UpdateOrgUser method
+ try:
+ updated_orguser = self.organization_client.UpdateOrgUser(self.customer_id,
+ org_unit_path=self.created_org_units[0],
+ user_email=self.user_alex.login.user_name + '@' + domain)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(updated_orguser['orgUserEmail'], self.user_alex.login.user_name + '@' + domain)
+ self.assertEquals(updated_orguser['orgUnitPath'], self.created_org_units[0])
+ print 'tests UpdateOrgUser successful'
+
+ # tests RetrieveAllOrgUsers method
+ try:
+ retrieved_orgusers = self.organization_client.RetrieveAllOrgUsers(self.customer_id)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertTrue(len(retrieved_orgusers) >= len(self.created_users))
+ print 'tests RetrieveAllOrgUsers successful'
+
+ """ This test needs to create more than 100 test users
+ # tests RetrievePageOfOrgUsers method
+ try:
+ retrieved_orgusers01_feed = self.organization_client.RetrievePageOfOrgUsers(self.customer_id)
+ next = retrieved_orgusers01_feed.GetNextLink()
+ self.assertNotEquals(next, None)
+ startKey = next.href.split("startKey=")[1]
+ retrieved_orgusers02_feed = self.organization_client.RetrievePageOfOrgUsers(self.customer_id, startKey=startKey)
+ retrieved_orgusers01_entry = self.organization_client._PropertyEntry2Dict(retrieved_orgusers01_feed.entry[0])
+ retrieved_orgusers02_entry = self.organization_client._PropertyEntry2Dict(retrieved_orgusers02_feed.entry[0])
+ self.assertNotEquals(retrieved_orgusers01_entry['orgUserEmail'], retrieved_orgusers02_entry['orgUserEmail'])
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ print 'tests RetrievePageOfOrgUsers successful'
+ """
+
+ # tests RetrieveOrgUnitUsers method
+ try:
+ retrieved_orgusers = self.organization_client.RetrieveOrgUnitUsers(self.customer_id,
+ org_unit_path=self.created_org_units[0])
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assertEquals(len(retrieved_orgusers), 2)
+ print 'tests RetrieveOrgUnitUsers successful'
+
+ """ This test needs to create more than 100 test users
+ # tests RetrieveOrgUnitPageOfUsers method
+ try:
+ retrieved_orgusers01_feed = self.organization_client.RetrieveOrgUnitPageOfUsers(self.customer_id,
+ org_unit_path='/')
+ next = retrieved_orgusers01_feed.GetNextLink()
+ self.assertNotEquals(next, None)
+ startKey = next.href.split("startKey=")[1]
+ retrieved_orgusers02_feed = self.organization_client.RetrieveOrgUnitPageOfUsers(self.customer_id,
+ org_unit_path='/',
+ startKey=startKey)
+ retrieved_orgusers01_entry = self.organization_client._PropertyEntry2Dict(retrieved_orgusers01_feed.entry[0])
+ retrieved_orgusers02_entry = self.organization_client._PropertyEntry2Dict(retrieved_orgusers02_feed.entry[0])
+ self.assertNotEquals(retrieved_orgusers01_entry['orgUserEmail'], retrieved_orgusers02_entry['orgUserEmail'])
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ print 'tests RetrieveOrgUnitPageOfUsers successful'
+ """
+
+if __name__ == '__main__':
+ print("""Google Apps Groups Service Tests
+
+NOTE: Please run these tests only with a test user account.
+""")
+ domain = raw_input('Google Apps domain: ')
+ admin_email = '%s@%s' % (raw_input('Administrator username: '), domain)
+ admin_password = getpass.getpass('Administrator password: ')
+ unittest.main()
diff --git a/tests/gdata_tests/apps/service_test.py b/tests/gdata_tests/apps/service_test.py
new file mode 100755
index 0000000..df8b9c0
--- /dev/null
+++ b/tests/gdata_tests/apps/service_test.py
@@ -0,0 +1,502 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 SIOS Technology, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'tmatsuo@sios.com (Takashi Matsuo)'
+
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom
+import gdata.apps
+import gdata.apps.service
+import getpass
+import time
+
+
+apps_domain = ''
+apps_username = ''
+apps_password = ''
+
+
+class AppsServiceUnitTest01(unittest.TestCase):
+
+ def setUp(self):
+ self.postfix = time.strftime("%Y%m%d%H%M%S")
+ email = apps_username + '@' + apps_domain
+ self.apps_client = gdata.apps.service.AppsService(
+ email=email, domain=apps_domain, password=apps_password,
+ source='AppsClient "Unit" Tests')
+ self.apps_client.ProgrammaticLogin()
+ self.created_user = None
+
+ def tearDown(self):
+ if self.created_user is not None:
+ try:
+ self.apps_client.DeleteUser(self.created_user.login.user_name)
+ except Exception, e:
+ pass
+
+ def test001RetrieveUser(self):
+ """Tests RetrieveUser method"""
+
+ try:
+ self_user_entry = self.apps_client.RetrieveUser(apps_username)
+ except:
+ self.fail('Unexpected exception occurred')
+ self.assert_(isinstance(self_user_entry, gdata.apps.UserEntry),
+ "The return value of RetrieveUser() must be an instance of " +
+ "apps.UserEntry: %s" % self_user_entry)
+ self.assertEquals(self_user_entry.login.user_name, apps_username)
+
+ def test002RetrieveUserRaisesException(self):
+ """Tests if RetrieveUser() raises AppsForYourDomainException with
+ appropriate error code"""
+
+ try:
+ non_existance = self.apps_client.RetrieveUser('nobody-' + self.postfix)
+ except gdata.apps.service.AppsForYourDomainException, e:
+ self.assertEquals(e.error_code, gdata.apps.service.ENTITY_DOES_NOT_EXIST)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+ else:
+ self.fail('No exception occurred')
+
+ def testSuspendAndRestoreUser(self):
+ # Create a test user
+ user_name = 'an-apps-service-test-account-' + self.postfix
+ family_name = 'Tester'
+ given_name = 'Apps'
+ password = '123$$abc'
+ suspended = 'false'
+
+ created_user = self.apps_client.CreateUser(
+ user_name=user_name, family_name=family_name, given_name=given_name,
+ password=password, suspended=suspended)
+
+ # Suspend then restore the new user.
+ entry = self.apps_client.SuspendUser(created_user.login.user_name)
+ self.assertEquals(entry.login.suspended, 'true')
+ entry = self.apps_client.RestoreUser(created_user.login.user_name)
+ self.assertEquals(entry.login.suspended, 'false')
+
+ # Clean up, delete the test user.
+ self.apps_client.DeleteUser(user_name)
+
+ def test003MethodsForUser(self):
+ """Tests methods for user"""
+
+ user_name = 'TakashiMatsuo-' + self.postfix
+ family_name = 'Matsuo'
+ given_name = 'Takashi'
+ password = '123$$abc'
+ suspended = 'false'
+
+ try:
+ created_user = self.apps_client.CreateUser(
+ user_name=user_name, family_name=family_name, given_name=given_name,
+ password=password, suspended=suspended)
+ except Exception, e:
+ self.assert_(False, 'Unexpected exception occurred: %s' % e)
+
+ self.created_user = created_user
+ self.assertEquals(created_user.login.user_name, user_name)
+ self.assertEquals(created_user.login.suspended, suspended)
+ self.assertEquals(created_user.name.family_name, family_name)
+ self.assertEquals(created_user.name.given_name, given_name)
+
+ # self.assertEquals(created_user.quota.limit,
+ # gdata.apps.service.DEFAULT_QUOTA_LIMIT)
+
+ """Tests RetrieveAllUsers method"""
+
+ try:
+ user_feed = self.apps_client.RetrieveAllUsers()
+ except Exception, e:
+ self.assert_(False, 'Unexpected exception occurred: %s' % e)
+
+ succeed = False
+ for a_entry in user_feed.entry:
+ if a_entry.login.user_name == user_name:
+ succeed = True
+ self.assert_(succeed, 'There must be a user: %s' % user_name)
+
+ """Tests UpdateUser method"""
+
+ new_family_name = 'NewFamilyName'
+ new_given_name = 'NewGivenName'
+ new_quota = '4096'
+
+ created_user.name.family_name = new_family_name
+ created_user.name.given_name = new_given_name
+ created_user.quota.limit = new_quota
+ created_user.login.suspended = 'true'
+
+ try:
+ new_user_entry = self.apps_client.UpdateUser(user_name, created_user)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assert_(isinstance(new_user_entry, gdata.apps.UserEntry),
+ "new user entry must be an instance of gdata.apps.UserEntry: %s"
+ % new_user_entry)
+ self.assertEquals(new_user_entry.name.family_name, new_family_name)
+ self.assertEquals(new_user_entry.name.given_name, new_given_name)
+ self.assertEquals(new_user_entry.login.suspended, 'true')
+
+ # quota limit update does not always success.
+ # self.assertEquals(new_user_entry.quota.limit, new_quota)
+
+ nobody = gdata.apps.UserEntry()
+ nobody.login = gdata.apps.Login(user_name='nobody-' + self.postfix)
+ nobody.name = gdata.apps.Name(family_name='nobody', given_name='nobody')
+
+ # make sure that there is no account with nobody- + self.postfix
+ try:
+ tmp_entry = self.apps_client.RetrieveUser('nobody-' + self.postfix)
+ except gdata.apps.service.AppsForYourDomainException, e:
+ self.assertEquals(e.error_code, gdata.apps.service.ENTITY_DOES_NOT_EXIST)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+ else:
+ self.fail('No exception occurred')
+
+ # make sure that UpdateUser fails with AppsForYourDomainException.
+ try:
+ new_user_entry = self.apps_client.UpdateUser('nobody-' + self.postfix,
+ nobody)
+ except gdata.apps.service.AppsForYourDomainException, e:
+ self.assertEquals(e.error_code, gdata.apps.service.ENTITY_DOES_NOT_EXIST)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+ else:
+ self.fail('No exception occurred')
+
+ """Tests DeleteUser method"""
+
+ try:
+ self.apps_client.DeleteUser(user_name)
+ except Exception, e:
+ self.assert_(False, 'Unexpected exception occurred: %s' % e)
+
+ # make sure that the account deleted
+ try:
+ self.apps_client.RetrieveUser(user_name)
+ except gdata.apps.service.AppsForYourDomainException, e:
+ self.assertEquals(e.error_code, gdata.apps.service.ENTITY_DOES_NOT_EXIST)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+ else:
+ self.fail('No exception occurred')
+ self.created_user = None
+
+ # make sure that DeleteUser fails with AppsForYourDomainException.
+ try:
+ self.apps_client.DeleteUser(user_name)
+ except gdata.apps.service.AppsForYourDomainException, e:
+ self.assertEquals(e.error_code, gdata.apps.service.ENTITY_DOES_NOT_EXIST)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+ else:
+ self.fail('No exception occurred')
+
+ def test004MethodsForNickname(self):
+ """Tests methods for nickname"""
+
+ # first create a user account
+ user_name = 'EmmyMatsuo-' + self.postfix
+ family_name = 'Matsuo'
+ given_name = 'Emmy'
+ password = '123$$abc'
+ suspended = 'false'
+
+ try:
+ created_user = self.apps_client.CreateUser(
+ user_name=user_name, family_name=family_name, given_name=given_name,
+ password=password, suspended=suspended)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.created_user = created_user
+ # tests CreateNickname method
+ nickname = 'emmy-' + self.postfix
+ try:
+ created_nickname = self.apps_client.CreateNickname(user_name, nickname)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assert_(isinstance(created_nickname, gdata.apps.NicknameEntry),
+ "Return value of CreateNickname method must be an instance of " +
+ "gdata.apps.NicknameEntry: %s" % created_nickname)
+ self.assertEquals(created_nickname.login.user_name, user_name)
+ self.assertEquals(created_nickname.nickname.name, nickname)
+
+ # tests RetrieveNickname method
+ retrieved_nickname = self.apps_client.RetrieveNickname(nickname)
+ self.assert_(isinstance(retrieved_nickname, gdata.apps.NicknameEntry),
+ "Return value of RetrieveNickname method must be an instance of " +
+ "gdata.apps.NicknameEntry: %s" % retrieved_nickname)
+ self.assertEquals(retrieved_nickname.login.user_name, user_name)
+ self.assertEquals(retrieved_nickname.nickname.name, nickname)
+
+ # tests RetrieveNicknames method
+ nickname_feed = self.apps_client.RetrieveNicknames(user_name)
+ self.assert_(isinstance(nickname_feed, gdata.apps.NicknameFeed),
+ "Return value of RetrieveNicknames method must be an instance of " +
+ "gdata.apps.NicknameFeed: %s" % nickname_feed)
+ self.assertEquals(nickname_feed.entry[0].login.user_name, user_name)
+ self.assertEquals(nickname_feed.entry[0].nickname.name, nickname)
+
+ # tests RetrieveAllNicknames method
+ nickname_feed = self.apps_client.RetrieveAllNicknames()
+ self.assert_(isinstance(nickname_feed, gdata.apps.NicknameFeed),
+ "Return value of RetrieveAllNicknames method must be an instance of " +
+ "gdata.apps.NicknameFeed: %s" % nickname_feed)
+ succeed = False
+ for a_entry in nickname_feed.entry:
+ if a_entry.login.user_name == user_name and \
+ a_entry.nickname.name == nickname:
+ succeed = True
+ self.assert_(succeed,
+ "There must be a nickname entry named %s." % nickname)
+
+ # tests DeleteNickname method
+ self.apps_client.DeleteNickname(nickname)
+ try:
+ non_existence = self.apps_client.RetrieveNickname(nickname)
+ except gdata.apps.service.AppsForYourDomainException, e:
+ self.assertEquals(e.error_code, gdata.apps.service.ENTITY_DOES_NOT_EXIST)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+ else:
+ self.fail('No exception occurred')
+
+class AppsServiceUnitTest02(unittest.TestCase):
+
+ def setUp(self):
+ self.postfix = time.strftime("%Y%m%d%H%M%S")
+ email = apps_username + '@' + apps_domain
+ self.apps_client = gdata.apps.service.AppsService(
+ email=email, domain=apps_domain, password=apps_password,
+ source='AppsClient "Unit" Tests')
+ self.apps_client.ProgrammaticLogin()
+ self.created_users = []
+ self.created_email_lists = []
+
+ def tearDown(self):
+ for user in self.created_users:
+ try:
+ self.apps_client.DeleteUser(user.login.user_name)
+ except Exception, e:
+ print e
+ for email_list in self.created_email_lists:
+ try:
+ self.apps_client.DeleteEmailList(email_list.email_list.name)
+ except Exception, e:
+ print e
+
+ def test001MethodsForEmaillist(self):
+ """Tests methods for emaillist """
+
+ user_name = 'YujiMatsuo-' + self.postfix
+ family_name = 'Matsuo'
+ given_name = 'Yuji'
+ password = '123$$abc'
+ suspended = 'false'
+
+ try:
+ user_yuji = self.apps_client.CreateUser(
+ user_name=user_name, family_name=family_name, given_name=given_name,
+ password=password, suspended=suspended)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.created_users.append(user_yuji)
+
+ user_name = 'TaroMatsuo-' + self.postfix
+ family_name = 'Matsuo'
+ given_name = 'Taro'
+ password = '123$$abc'
+ suspended = 'false'
+
+ try:
+ user_taro = self.apps_client.CreateUser(
+ user_name=user_name, family_name=family_name, given_name=given_name,
+ password=password, suspended=suspended)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.created_users.append(user_taro)
+
+ # tests CreateEmailList method
+ list_name = 'list01-' + self.postfix
+ try:
+ created_email_list = self.apps_client.CreateEmailList(list_name)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assert_(isinstance(created_email_list, gdata.apps.EmailListEntry),
+ "Return value of CreateEmailList method must be an instance of " +
+ "EmailListEntry: %s" % created_email_list)
+ self.assertEquals(created_email_list.email_list.name, list_name)
+ self.created_email_lists.append(created_email_list)
+
+ # tests AddRecipientToEmailList method
+ try:
+ recipient = self.apps_client.AddRecipientToEmailList(
+ user_yuji.login.user_name + '@' + apps_domain,
+ list_name)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assert_(isinstance(recipient, gdata.apps.EmailListRecipientEntry),
+ "Return value of AddRecipientToEmailList method must be an instance " +
+ "of EmailListRecipientEntry: %s" % recipient)
+ self.assertEquals(recipient.who.email,
+ user_yuji.login.user_name + '@' + apps_domain)
+
+ try:
+ recipient = self.apps_client.AddRecipientToEmailList(
+ user_taro.login.user_name + '@' + apps_domain,
+ list_name)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ # tests RetrieveAllRecipients method
+ try:
+ recipient_feed = self.apps_client.RetrieveAllRecipients(list_name)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assert_(isinstance(recipient_feed, gdata.apps.EmailListRecipientFeed),
+ "Return value of RetrieveAllRecipients method must be an instance " +
+ "of EmailListRecipientFeed: %s" % recipient_feed)
+ self.assertEquals(len(recipient_feed.entry), 2)
+
+ # tests RemoveRecipientFromEmailList method
+ try:
+ self.apps_client.RemoveRecipientFromEmailList(
+ user_taro.login.user_name + '@' + apps_domain, list_name)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ # make sure that removal succeeded.
+ try:
+ recipient_feed = self.apps_client.RetrieveAllRecipients(list_name)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+
+ self.assert_(isinstance(recipient_feed, gdata.apps.EmailListRecipientFeed),
+ "Return value of RetrieveAllRecipients method must be an instance " +
+ "of EmailListRecipientFeed: %s" % recipient_feed)
+ self.assertEquals(len(recipient_feed.entry), 1)
+
+ # tests RetrieveAllEmailLists
+ try:
+ list_feed = self.apps_client.RetrieveAllEmailLists()
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+ self.assert_(isinstance(list_feed, gdata.apps.EmailListFeed),
+ "Return value of RetrieveAllEmailLists method must be an instance" +
+ "of EmailListFeed: %s" % list_feed)
+ succeed = False
+ for email_list in list_feed.entry:
+ if email_list.email_list.name == list_name:
+ succeed = True
+ self.assert_(succeed, "There must be an email list named %s" % list_name)
+
+ # tests RetrieveEmailLists method.
+ try:
+ list_feed = self.apps_client.RetrieveEmailLists(
+ user_yuji.login.user_name + '@' + apps_domain)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+ self.assert_(isinstance(list_feed, gdata.apps.EmailListFeed),
+ "Return value of RetrieveEmailLists method must be an instance" +
+ "of EmailListFeed: %s" % list_feed)
+ succeed = False
+ for email_list in list_feed.entry:
+ if email_list.email_list.name == list_name:
+ succeed = True
+ self.assert_(succeed, "There must be an email list named %s" % list_name)
+
+ def testRetrieveEmailList(self):
+ new_list = self.apps_client.CreateEmailList('my_testing_email_list')
+ retrieved_list = self.apps_client.RetrieveEmailList('my_testing_email_list')
+ self.assertEquals(new_list.title.text, retrieved_list.title.text)
+ self.assertEquals(new_list.id.text, retrieved_list.id.text)
+ self.assertEquals(new_list.email_list.name, retrieved_list.email_list.name)
+
+ self.apps_client.DeleteEmailList('my_testing_email_list')
+
+ # Should not be able to retrieve the deleted list.
+ try:
+ removed_list = self.apps_client.RetrieveEmailList('my_testing_email_list')
+ self.fail()
+ except gdata.apps.service.AppsForYourDomainException:
+ pass
+
+
+class AppsServiceUnitTest03(unittest.TestCase):
+
+ def setUp(self):
+ self.postfix = time.strftime("%Y%m%d%H%M%S")
+ email = apps_username + '@' + apps_domain
+ self.apps_client = gdata.apps.service.AppsService(
+ email=email, domain=apps_domain, password=apps_password,
+ source='AppsClient "Unit" Tests')
+ self.apps_client.ProgrammaticLogin()
+ self.created_users = []
+ self.created_email_lists = []
+
+ def tearDown(self):
+ for user in self.created_users:
+ try:
+ self.apps_client.DeleteUser(user.login.user_name)
+ except Exception, e:
+ print e
+ for email_list in self.created_email_lists:
+ try:
+ self.apps_client.DeleteEmailList(email_list.email_list.name)
+ except Exception, e:
+ print e
+
+ def test001Pagenation(self):
+ """Tests for pagination. It takes toooo long."""
+
+ list_feed = self.apps_client.RetrieveAllEmailLists()
+ quantity = len(list_feed.entry)
+ list_nums = 101
+ for i in range(list_nums):
+ list_name = 'list%03d-' % i + self.postfix
+ try:
+ created_email_list = self.apps_client.CreateEmailList(list_name)
+ except Exception, e:
+ self.fail('Unexpected exception occurred: %s' % e)
+ self.created_email_lists.append(created_email_list)
+
+ list_feed = self.apps_client.RetrieveAllEmailLists()
+ self.assertEquals(len(list_feed.entry), list_nums + quantity)
+
+if __name__ == '__main__':
+ print ('Google Apps Service Tests\nNOTE: Please run these tests only with '
+ 'a test domain. The tests may delete or update your domain\'s '
+ 'account data.')
+ apps_domain = raw_input('Please enter your domain: ')
+ apps_username = raw_input('Please enter your username of admin account: ')
+ apps_password = getpass.getpass()
+ unittest.main()
diff --git a/tests/gdata_tests/apps/service_test_using_mock.py b/tests/gdata_tests/apps/service_test_using_mock.py
new file mode 100755
index 0000000..2598cb8
--- /dev/null
+++ b/tests/gdata_tests/apps/service_test_using_mock.py
@@ -0,0 +1,140 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 SIOS Technology, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'tmatsuo@sios.com (Takashi Matsuo)'
+
+import unittest
+import time, os
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import re
+import pickle
+
+import atom
+import atom.http
+import atom.service
+from atom import mock_http
+import gdata.apps
+import gdata.apps.service
+import getpass
+
+apps_domain = 'test.shehas.net'
+apps_username = ''
+apps_password = ''
+
+
+def conceal_secrets(recordings):
+ ret = []
+ for rec in recordings:
+ req, res = rec
+ if req.data:
+ req.data = re.sub(r'Passwd=[^&]+', 'Passwd=hogehoge', req.data)
+ if res.body:
+ res.body = re.sub(r'SID=[^\n]+', 'SID=hogehoge', res.body)
+ res.body = re.sub(r'LSID=[^\n]+', 'LSID=hogehoge', res.body)
+ res.body = re.sub(r'Auth=[^\n]+', 'Auth=hogehoge', res.body)
+ if req.headers.has_key('Authorization'):
+ req.headers['Authorization'] = 'hogehoge'
+ ret.append((req, res))
+ return ret
+
+class AppsServiceBaseTest(object):
+
+ def setUp(self):
+ self.datafile = os.path.join(os.path.dirname(os.path.abspath(__file__)),
+ "%s.pickle" % self.name)
+ if os.path.isfile(self.datafile):
+ f = open(self.datafile, "rb")
+ data = pickle.load(f)
+ f.close()
+ http_client = mock_http.MockHttpClient(recordings=data)
+ else:
+ real_client = atom.http.ProxiedHttpClient()
+ http_client = mock_http.MockHttpClient(real_client=real_client)
+
+ email = apps_username + '@' + apps_domain
+ self.apps_client = gdata.apps.service.AppsService(
+ email=email, domain=apps_domain, password=apps_password,
+ source='AppsClient "Unit" Tests')
+ self.apps_client.http_client = http_client
+ self.apps_client.ProgrammaticLogin()
+
+ def tearDown(self):
+ if self.apps_client.http_client.real_client:
+ # create pickle file
+ f = open(self.datafile, "wb")
+ data = conceal_secrets(self.apps_client.http_client.recordings)
+ pickle.dump(data, f)
+ f.close()
+
+class AppsServiceTestForGetGeneratorForAllRecipients(AppsServiceBaseTest,
+ unittest.TestCase):
+ name = "AppsServiceTestForGetGeneratorForAllRecipients"
+ def testGetGeneratorForAllRecipients(self):
+ """Tests GetGeneratorForAllRecipientss method"""
+ generator = self.apps_client.GetGeneratorForAllRecipients(
+ "b101-20091013151051")
+ i = 0
+ for recipient_feed in generator:
+ for a_recipient in recipient_feed.entry:
+ i = i + 1
+ self.assert_(i == 102)
+
+class AppsServiceTestForGetGeneratorForAllEmailLists(AppsServiceBaseTest,
+ unittest.TestCase):
+ name = "AppsServiceTestForGetGeneratorForAllEmailLists"
+ def testGetGeneratorForAllEmailLists(self):
+ """Tests GetGeneratorForAllEmailLists method"""
+ generator = self.apps_client.GetGeneratorForAllEmailLists()
+ i = 0
+ for emaillist_feed in generator:
+ for a_emaillist in emaillist_feed.entry:
+ i = i + 1
+ self.assert_(i == 105)
+
+class AppsServiceTestForGetGeneratorForAllNicknames(AppsServiceBaseTest,
+ unittest.TestCase):
+ name = "AppsServiceTestForGetGeneratorForAllNicknames"
+ def testGetGeneratorForAllNicknames(self):
+ """Tests GetGeneratorForAllNicknames method"""
+ generator = self.apps_client.GetGeneratorForAllNicknames()
+ i = 0
+ for nickname_feed in generator:
+ for a_nickname in nickname_feed.entry:
+ i = i + 1
+ self.assert_(i == 102)
+
+
+class AppsServiceTestForGetGeneratorForAllUsers(AppsServiceBaseTest,
+ unittest.TestCase):
+ name = "AppsServiceTestForGetGeneratorForAllUsers"
+
+ def testGetGeneratorForAllUsers(self):
+ """Tests GetGeneratorForAllUsers method"""
+ generator = self.apps_client.GetGeneratorForAllUsers()
+ i = 0
+ for user_feed in generator:
+ for a_user in user_feed.entry:
+ i = i + 1
+ self.assert_(i == 102)
+
+if __name__ == '__main__':
+ print ('The tests may delete or update your data.')
+ apps_username = raw_input('Please enter your username: ')
+ apps_password = getpass.getpass()
+ unittest.main()
diff --git a/tests/gdata_tests/apps_test.py b/tests/gdata_tests/apps_test.py
new file mode 100755
index 0000000..0299232
--- /dev/null
+++ b/tests/gdata_tests/apps_test.py
@@ -0,0 +1,583 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 SIOS Technology, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'tmatsuo@sios.com (Takashi MATSUO)'
+
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom
+import gdata
+from gdata import test_data
+import gdata.apps
+
+class AppsEmailListRecipientFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.rcpt_feed = gdata.apps.EmailListRecipientFeedFromString(
+ test_data.EMAIL_LIST_RECIPIENT_FEED)
+
+ def testEmailListRecipientEntryCount(self):
+ """Count EmailListRecipient entries in EmailListRecipientFeed"""
+
+ self.assertEquals(len(self.rcpt_feed.entry), 2)
+
+ def testLinkFinderFindsHtmlLink(self):
+ """Tests the return value of GetXXXLink() methods"""
+
+ self.assert_(self.rcpt_feed.GetSelfLink() is not None)
+ self.assert_(self.rcpt_feed.GetNextLink() is not None)
+ self.assert_(self.rcpt_feed.GetEditLink() is None)
+ self.assert_(self.rcpt_feed.GetHtmlLink() is None)
+
+ def testStartItem(self):
+ """Tests the existence of <openSearch:startIndex> in
+ EmailListRecipientFeed and verifies the value"""
+
+ self.assert_(isinstance(self.rcpt_feed.start_index, gdata.StartIndex),
+ "EmailListRecipient feed <openSearch:startIndex> element must be " +
+ "an instance of gdata.OpenSearch: %s" % self.rcpt_feed.start_index)
+ self.assertEquals(self.rcpt_feed.start_index.text, "1")
+
+ def testEmailListRecipientEntries(self):
+ """Tests the existence of <atom:entry> in EmailListRecipientFeed
+ and simply verifies the value"""
+
+ for a_entry in self.rcpt_feed.entry:
+ self.assert_(isinstance(a_entry, gdata.apps.EmailListRecipientEntry),
+ "EmailListRecipient Feed <atom:entry> must be an instance of " +
+ "apps.EmailListRecipientEntry: %s" % a_entry)
+
+ self.assertEquals(self.rcpt_feed.entry[0].who.email, "joe@example.com")
+ self.assertEquals(self.rcpt_feed.entry[1].who.email, "susan@example.com")
+
+class AppsEmailListFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.list_feed = gdata.apps.EmailListFeedFromString(
+ test_data.EMAIL_LIST_FEED)
+
+ def testEmailListEntryCount(self):
+ """Count EmailList entries in EmailListFeed"""
+
+ self.assertEquals(len(self.list_feed.entry), 2)
+
+ def testLinkFinderFindsHtmlLink(self):
+ """Tests the return value of GetXXXLink() methods"""
+
+ self.assert_(self.list_feed.GetSelfLink() is not None)
+ self.assert_(self.list_feed.GetNextLink() is not None)
+ self.assert_(self.list_feed.GetEditLink() is None)
+ self.assert_(self.list_feed.GetHtmlLink() is None)
+
+ def testStartItem(self):
+ """Tests the existence of <openSearch:startIndex> in EmailListFeed
+ and verifies the value"""
+
+ self.assert_(isinstance(self.list_feed.start_index, gdata.StartIndex),
+ "EmailList feed <openSearch:startIndex> element must be an instance " +
+ "of gdata.OpenSearch: %s" % self.list_feed.start_index)
+ self.assertEquals(self.list_feed.start_index.text, "1")
+
+ def testUserEntries(self):
+ """Tests the existence of <atom:entry> in EmailListFeed and simply
+ verifies the value"""
+
+ for a_entry in self.list_feed.entry:
+ self.assert_(isinstance(a_entry, gdata.apps.EmailListEntry),
+ "EmailList Feed <atom:entry> must be an instance of " +
+ "apps.EmailListEntry: %s" % a_entry)
+
+ self.assertEquals(self.list_feed.entry[0].email_list.name, "us-sales")
+ self.assertEquals(self.list_feed.entry[1].email_list.name, "us-eng")
+
+class AppsUserFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.user_feed = gdata.apps.UserFeedFromString(test_data.USER_FEED)
+
+ def testUserEntryCount(self):
+ """Count User entries in UserFeed"""
+
+ self.assertEquals(len(self.user_feed.entry), 2)
+
+ def testLinkFinderFindsHtmlLink(self):
+ """Tests the return value of GetXXXLink() methods"""
+
+ self.assert_(self.user_feed.GetSelfLink() is not None)
+ self.assert_(self.user_feed.GetNextLink() is not None)
+ self.assert_(self.user_feed.GetEditLink() is None)
+ self.assert_(self.user_feed.GetHtmlLink() is None)
+
+ def testStartItem(self):
+ """Tests the existence of <openSearch:startIndex> in UserFeed and
+ verifies the value"""
+
+ self.assert_(isinstance(self.user_feed.start_index, gdata.StartIndex),
+ "User feed <openSearch:startIndex> element must be an instance " +
+ "of gdata.OpenSearch: %s" % self.user_feed.start_index)
+ self.assertEquals(self.user_feed.start_index.text, "1")
+
+ def testUserEntries(self):
+ """Tests the existence of <atom:entry> in UserFeed and simply
+ verifies the value"""
+
+ for a_entry in self.user_feed.entry:
+ self.assert_(isinstance(a_entry, gdata.apps.UserEntry),
+ "User Feed <atom:entry> must be an instance of " +
+ "apps.UserEntry: %s" % a_entry)
+
+ self.assertEquals(self.user_feed.entry[0].login.user_name, "TestUser")
+ self.assertEquals(self.user_feed.entry[0].who.email,
+ "TestUser@example.com")
+ self.assertEquals(self.user_feed.entry[1].login.user_name, "JohnSmith")
+ self.assertEquals(self.user_feed.entry[1].who.email,
+ "JohnSmith@example.com")
+
+class AppsNicknameFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.nick_feed = gdata.apps.NicknameFeedFromString(test_data.NICK_FEED)
+
+ def testNicknameEntryCount(self):
+ """Count Nickname entries in NicknameFeed"""
+
+ self.assertEquals(len(self.nick_feed.entry), 2)
+
+ def testId(self):
+ """Tests the existence of <atom:id> in NicknameFeed and verifies
+ the value"""
+
+ self.assert_(isinstance(self.nick_feed.id, atom.Id),
+ "Nickname feed <atom:id> element must be an instance of " +
+ "atom.Id: %s" % self.nick_feed.id)
+
+ self.assertEquals(self.nick_feed.id.text,
+ "http://apps-apis.google.com/a/feeds/example.com/nickname/2.0")
+
+ def testStartItem(self):
+ """Tests the existence of <openSearch:startIndex> in NicknameFeed
+ and verifies the value"""
+
+ self.assert_(isinstance(self.nick_feed.start_index, gdata.StartIndex),
+ "Nickname feed <openSearch:startIndex> element must be an instance " +
+ "of gdata.OpenSearch: %s" % self.nick_feed.start_index)
+ self.assertEquals(self.nick_feed.start_index.text, "1")
+
+ def testItemsPerPage(self):
+ """Tests the existence of <openSearch:itemsPerPage> in
+ NicknameFeed and verifies the value"""
+
+ self.assert_(isinstance(self.nick_feed.items_per_page, gdata.ItemsPerPage),
+ "Nickname feed <openSearch:itemsPerPage> element must be an " +
+ "instance of gdata.ItemsPerPage: %s" % self.nick_feed.items_per_page)
+
+ self.assertEquals(self.nick_feed.items_per_page.text, "2")
+
+ def testLinkFinderFindsHtmlLink(self):
+ """Tests the return value of GetXXXLink() methods"""
+
+ self.assert_(self.nick_feed.GetSelfLink() is not None)
+ self.assert_(self.nick_feed.GetEditLink() is None)
+ self.assert_(self.nick_feed.GetHtmlLink() is None)
+
+ def testNicknameEntries(self):
+ """Tests the existence of <atom:entry> in NicknameFeed and simply
+ verifies the value"""
+
+ for a_entry in self.nick_feed.entry:
+ self.assert_(isinstance(a_entry, gdata.apps.NicknameEntry),
+ "Nickname Feed <atom:entry> must be an instance of " +
+ "apps.NicknameEntry: %s" % a_entry)
+
+ self.assertEquals(self.nick_feed.entry[0].nickname.name, "Foo")
+ self.assertEquals(self.nick_feed.entry[1].nickname.name, "Bar")
+
+class AppsEmailListRecipientEntryTest(unittest.TestCase):
+
+ def setUp(self):
+
+ self.rcpt_entry = gdata.apps.EmailListRecipientEntryFromString(
+ test_data.EMAIL_LIST_RECIPIENT_ENTRY)
+
+ def testId(self):
+ """Tests the existence of <atom:id> in EmailListRecipientEntry and
+ verifies the value"""
+
+ self.assert_(
+ isinstance(self.rcpt_entry.id, atom.Id),
+ "EmailListRecipient entry <atom:id> element must be an instance of " +
+ "atom.Id: %s" %
+ self.rcpt_entry.id)
+
+ self.assertEquals(
+ self.rcpt_entry.id.text,
+ 'https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/us-sales/' +
+ 'recipient/TestUser%40example.com')
+
+ def testUpdated(self):
+ """Tests the existence of <atom:updated> in
+ EmailListRecipientEntry and verifies the value"""
+
+ self.assert_(
+ isinstance(self.rcpt_entry.updated, atom.Updated),
+ "EmailListRecipient entry <atom:updated> element must be an instance " +
+ "of atom.Updated: %s" % self.rcpt_entry.updated)
+
+ self.assertEquals(self.rcpt_entry.updated.text,
+ '1970-01-01T00:00:00.000Z')
+
+ def testCategory(self):
+ """Tests the existence of <atom:category> in
+ EmailListRecipientEntry and verifies the value"""
+
+ for a_category in self.rcpt_entry.category:
+ self.assert_(
+ isinstance(a_category, atom.Category),
+ "EmailListRecipient entry <atom:category> element must be an " +
+ "instance of atom.Category: %s" % a_category)
+
+ self.assertEquals(a_category.scheme,
+ "http://schemas.google.com/g/2005#kind")
+
+ self.assertEquals(a_category.term,
+ "http://schemas.google.com/apps/2006#" +
+ "emailList.recipient")
+
+ def testTitle(self):
+ """Tests the existence of <atom:title> in EmailListRecipientEntry
+ and verifies the value"""
+
+ self.assert_(
+ isinstance(self.rcpt_entry.title, atom.Title),
+ "EmailListRecipient entry <atom:title> element must be an instance of " +
+ "atom.Title: %s" % self.rcpt_entry.title)
+
+ self.assertEquals(self.rcpt_entry.title.text, 'TestUser')
+
+ def testLinkFinderFindsHtmlLink(self):
+ """Tests the return value of GetXXXLink() methods"""
+
+ self.assert_(self.rcpt_entry.GetSelfLink() is not None)
+ self.assert_(self.rcpt_entry.GetEditLink() is not None)
+ self.assert_(self.rcpt_entry.GetHtmlLink() is None)
+
+ def testWho(self):
+ """Tests the existence of a <gdata:who> in EmailListRecipientEntry
+ and verifies the value"""
+
+ self.assert_(isinstance(self.rcpt_entry.who, gdata.apps.Who),
+ "EmailListRecipient entry <gdata:who> must be an instance of " +
+ "apps.Who: %s" % self.rcpt_entry.who)
+ self.assertEquals(self.rcpt_entry.who.email, 'TestUser@example.com')
+
+class AppsEmailListEntryTest(unittest.TestCase):
+
+ def setUp(self):
+
+ self.list_entry = gdata.apps.EmailListEntryFromString(
+ test_data.EMAIL_LIST_ENTRY)
+
+ def testId(self):
+ """Tests the existence of <atom:id> in EmailListEntry and verifies
+ the value"""
+
+ self.assert_(
+ isinstance(self.list_entry.id, atom.Id),
+ "EmailList entry <atom:id> element must be an instance of atom.Id: %s" %
+ self.list_entry.id)
+
+ self.assertEquals(
+ self.list_entry.id.text,
+ 'https://apps-apis.google.com/a/feeds/example.com/emailList/2.0/testlist')
+
+ def testUpdated(self):
+ """Tests the existence of <atom:updated> in EmailListEntry and
+ verifies the value"""
+
+ self.assert_(
+ isinstance(self.list_entry.updated, atom.Updated),
+ "EmailList entry <atom:updated> element must be an instance of " +
+ "atom.Updated: %s" % self.list_entry.updated)
+
+ self.assertEquals(self.list_entry.updated.text,
+ '1970-01-01T00:00:00.000Z')
+
+ def testCategory(self):
+ """Tests the existence of <atom:category> in EmailListEntry and
+ verifies the value"""
+
+ for a_category in self.list_entry.category:
+ self.assert_(
+ isinstance(a_category, atom.Category),
+ "EmailList entry <atom:category> element must be an instance " +
+ "of atom.Category: %s" % a_category)
+
+ self.assertEquals(a_category.scheme,
+ "http://schemas.google.com/g/2005#kind")
+
+ self.assertEquals(a_category.term,
+ "http://schemas.google.com/apps/2006#emailList")
+
+ def testTitle(self):
+ """Tests the existence of <atom:title> in EmailListEntry and verifies
+ the value"""
+
+ self.assert_(
+ isinstance(self.list_entry.title, atom.Title),
+ "EmailList entry <atom:title> element must be an instance of " +
+ "atom.Title: %s" % self.list_entry.title)
+
+ self.assertEquals(self.list_entry.title.text, 'testlist')
+
+ def testLinkFinderFindsHtmlLink(self):
+ """Tests the return value of GetXXXLink() methods"""
+
+ self.assert_(self.list_entry.GetSelfLink() is not None)
+ self.assert_(self.list_entry.GetEditLink() is not None)
+ self.assert_(self.list_entry.GetHtmlLink() is None)
+
+ def testEmailList(self):
+ """Tests the existence of a <apps:emailList> in EmailListEntry and
+ verifies the value"""
+
+ self.assert_(isinstance(self.list_entry.email_list, gdata.apps.EmailList),
+ "EmailList entry <apps:emailList> must be an instance of " +
+ "apps.EmailList: %s" % self.list_entry.email_list)
+ self.assertEquals(self.list_entry.email_list.name, 'testlist')
+
+ def testFeedLink(self):
+ """Test the existence of a <gdata:feedLink> in EmailListEntry and
+ verifies the value"""
+
+ for an_feed_link in self.list_entry.feed_link:
+ self.assert_(isinstance(an_feed_link, gdata.FeedLink),
+ "EmailList entry <gdata:feedLink> must be an instance of " +
+ "gdata.FeedLink: %s" % an_feed_link)
+ self.assertEquals(self.list_entry.feed_link[0].rel,
+ 'http://schemas.google.com/apps/2006#' +
+ 'emailList.recipients')
+ self.assertEquals(self.list_entry.feed_link[0].href,
+ 'http://apps-apis.google.com/a/feeds/example.com/emailList/' +
+ '2.0/testlist/recipient/')
+
+class AppsNicknameEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.nick_entry = gdata.apps.NicknameEntryFromString(test_data.NICK_ENTRY)
+
+ def testId(self):
+ """Tests the existence of <atom:id> in NicknameEntry and verifies
+ the value"""
+
+ self.assert_(
+ isinstance(self.nick_entry.id, atom.Id),
+ "Nickname entry <atom:id> element must be an instance of atom.Id: %s" %
+ self.nick_entry.id)
+
+ self.assertEquals(
+ self.nick_entry.id.text,
+ 'https://apps-apis.google.com/a/feeds/example.com/nickname/2.0/Foo')
+
+ def testCategory(self):
+ """Tests the existence of <atom:category> in NicknameEntry and
+ verifies the value"""
+
+ for a_category in self.nick_entry.category:
+ self.assert_(
+ isinstance(a_category, atom.Category),
+ "Nickname entry <atom:category> element must be an instance " +
+ "of atom.Category: %s" % a_category)
+
+ self.assertEquals(a_category.scheme,
+ "http://schemas.google.com/g/2005#kind")
+
+ self.assertEquals(a_category.term,
+ "http://schemas.google.com/apps/2006#nickname")
+
+ def testTitle(self):
+ """Tests the existence of <atom:title> in NicknameEntry and
+ verifies the value"""
+
+ self.assert_(isinstance(self.nick_entry.title, atom.Title),
+ "Nickname entry <atom:title> element must be an instance " +
+ "of atom.Title: %s" % self.nick_entry.title)
+
+ self.assertEquals(self.nick_entry.title.text, "Foo")
+
+ def testLogin(self):
+ """Tests the existence of <apps:login> in NicknameEntry and
+ verifies the value"""
+
+ self.assert_(isinstance(self.nick_entry.login, gdata.apps.Login),
+ "Nickname entry <apps:login> element must be an instance " +
+ "of apps.Login: %s" % self.nick_entry.login)
+ self.assertEquals(self.nick_entry.login.user_name, "TestUser")
+
+ def testNickname(self):
+ """Tests the existence of <apps:nickname> in NicknameEntry and
+ verifies the value"""
+
+ self.assert_(isinstance(self.nick_entry.nickname, gdata.apps.Nickname),
+ "Nickname entry <apps:nickname> element must be an instance " +
+ "of apps.Nickname: %s" % self.nick_entry.nickname)
+ self.assertEquals(self.nick_entry.nickname.name, "Foo")
+
+ def testLinkFinderFindsHtmlLink(self):
+ """Tests the return value of GetXXXLink() methods"""
+
+ self.assert_(self.nick_entry.GetSelfLink() is not None)
+ self.assert_(self.nick_entry.GetEditLink() is not None)
+ self.assert_(self.nick_entry.GetHtmlLink() is None)
+
+class AppsUserEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.user_entry = gdata.apps.UserEntryFromString(test_data.USER_ENTRY)
+
+ def testId(self):
+ """Tests the existence of <atom:id> in UserEntry and verifies the
+ value"""
+
+ self.assert_(
+ isinstance(self.user_entry.id, atom.Id),
+ "User entry <atom:id> element must be an instance of atom.Id: %s" %
+ self.user_entry.id)
+
+ self.assertEquals(
+ self.user_entry.id.text,
+ 'https://apps-apis.google.com/a/feeds/example.com/user/2.0/TestUser')
+
+ def testUpdated(self):
+ """Tests the existence of <atom:updated> in UserEntry and verifies
+ the value"""
+
+ self.assert_(
+ isinstance(self.user_entry.updated, atom.Updated),
+ "User entry <atom:updated> element must be an instance of " +
+ "atom.Updated: %s" % self.user_entry.updated)
+
+ self.assertEquals(self.user_entry.updated.text,
+ '1970-01-01T00:00:00.000Z')
+
+ def testCategory(self):
+ """Tests the existence of <atom:category> in UserEntry and
+ verifies the value"""
+
+ for a_category in self.user_entry.category:
+ self.assert_(
+ isinstance(a_category, atom.Category),
+ "User entry <atom:category> element must be an instance " +
+ "of atom.Category: %s" % a_category)
+
+ self.assertEquals(a_category.scheme,
+ "http://schemas.google.com/g/2005#kind")
+
+ self.assertEquals(a_category.term,
+ "http://schemas.google.com/apps/2006#user")
+
+ def testTitle(self):
+ """Tests the existence of <atom:title> in UserEntry and verifies
+ the value"""
+
+ self.assert_(
+ isinstance(self.user_entry.title, atom.Title),
+ "User entry <atom:title> element must be an instance of atom.Title: %s" %
+ self.user_entry.title)
+
+ self.assertEquals(self.user_entry.title.text, 'TestUser')
+
+ def testLinkFinderFindsHtmlLink(self):
+ """Tests the return value of GetXXXLink() methods"""
+
+ self.assert_(self.user_entry.GetSelfLink() is not None)
+ self.assert_(self.user_entry.GetEditLink() is not None)
+ self.assert_(self.user_entry.GetHtmlLink() is None)
+
+ def testLogin(self):
+ """Tests the existence of <apps:login> in UserEntry and verifies
+ the value"""
+
+ self.assert_(isinstance(self.user_entry.login, gdata.apps.Login),
+ "User entry <apps:login> element must be an instance of apps.Login: %s"
+ % self.user_entry.login)
+
+ self.assertEquals(self.user_entry.login.user_name, 'TestUser')
+ self.assertEquals(self.user_entry.login.password, 'password')
+ self.assertEquals(self.user_entry.login.suspended, 'false')
+ self.assertEquals(self.user_entry.login.ip_whitelisted, 'false')
+ self.assertEquals(self.user_entry.login.hash_function_name, 'SHA-1')
+
+ def testName(self):
+ """Tests the existence of <apps:name> in UserEntry and verifies
+ the value"""
+
+ self.assert_(isinstance(self.user_entry.name, gdata.apps.Name),
+ "User entry <apps:name> element must be an instance of apps.Name: %s"
+ % self.user_entry.name)
+ self.assertEquals(self.user_entry.name.family_name, 'Test')
+ self.assertEquals(self.user_entry.name.given_name, 'User')
+
+ def testQuota(self):
+ """Tests the existence of <apps:quota> in UserEntry and verifies
+ the value"""
+
+ self.assert_(isinstance(self.user_entry.quota, gdata.apps.Quota),
+ "User entry <apps:quota> element must be an instance of apps.Quota: %s"
+ % self.user_entry.quota)
+ self.assertEquals(self.user_entry.quota.limit, '1024')
+
+ def testFeedLink(self):
+ """Test the existence of a <gdata:feedLink> in UserEntry and
+ verifies the value"""
+
+ for an_feed_link in self.user_entry.feed_link:
+ self.assert_(isinstance(an_feed_link, gdata.FeedLink),
+ "User entry <gdata:feedLink> must be an instance of gdata.FeedLink" +
+ ": %s" % an_feed_link)
+ self.assertEquals(self.user_entry.feed_link[0].rel,
+ 'http://schemas.google.com/apps/2006#user.nicknames')
+ self.assertEquals(self.user_entry.feed_link[0].href,
+ 'https://apps-apis.google.com/a/feeds/example.com/nickname/' +
+ '2.0?username=Test-3121')
+ self.assertEquals(self.user_entry.feed_link[1].rel,
+ 'http://schemas.google.com/apps/2006#user.emailLists')
+ self.assertEquals(self.user_entry.feed_link[1].href,
+ 'https://apps-apis.google.com/a/feeds/example.com/emailList/' +
+ '2.0?recipient=testlist@example.com')
+
+ def testUpdate(self):
+ """Tests for modifing attributes of UserEntry"""
+
+ self.user_entry.name.family_name = 'ModifiedFamilyName'
+ self.user_entry.name.given_name = 'ModifiedGivenName'
+ self.user_entry.quota.limit = '2048'
+ self.user_entry.login.password = 'ModifiedPassword'
+ self.user_entry.login.suspended = 'true'
+ modified = gdata.apps.UserEntryFromString(self.user_entry.ToString())
+
+ self.assertEquals(modified.name.family_name, 'ModifiedFamilyName')
+ self.assertEquals(modified.name.given_name, 'ModifiedGivenName')
+ self.assertEquals(modified.quota.limit, '2048')
+ self.assertEquals(modified.login.password, 'ModifiedPassword')
+ self.assertEquals(modified.login.suspended, 'true')
+
+if __name__ == '__main__':
+ unittest.main()
+
diff --git a/tests/gdata_tests/auth_test.py b/tests/gdata_tests/auth_test.py
new file mode 100755
index 0000000..b2a9025
--- /dev/null
+++ b/tests/gdata_tests/auth_test.py
@@ -0,0 +1,569 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2007, 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import re
+import unittest
+import urllib
+import gdata.auth
+
+
+CONSUMER_KEY = 'www.yourwebapp.com'
+CONSUMER_SECRET = 'qB1P2kCFDpRjF+/Iww4'
+
+RSA_KEY = """-----BEGIN RSA PRIVATE KEY-----
+MIICXAIBAAKBgQDVbOaFW+KXecfFJn1PIzYHnNXFxhaQ36QM0K5uSb0Y8NeQUlD2
+6t8aKgnm6mcb4vaopHjjdIGWgAzM5Dt0oPIiDXo+jSQbvCIXRduuAt+0cFGb2d+L
+hALk4AwB8IVIkDJWwgo5Z2OLsP2r/wQlUYKm/tnvQaevK24jNYMLWVJl2QIDAQAB
+AoGAU93ERBlUVEPFjaJPUX67p4gotNvfWDSZiXOjZ7FQPnG9s3e1WyH2Y5irZXMs
+61dnp+NhobfRiGtvHEB/YJgyLRk/CJDnMKslo95e7o65IE9VkcyY6Yvt7YTslsRX
+Eu7T0xLEA7ON46ypCwNLeWxpJ9SWisEKu2yZJnWauCXEsgUCQQD7b2ZuhGx3msoP
+YEnwvucp0UxneCvb68otfERZ1J6NfNP47QJw6OwD3r1sWCJ27QZmpvtQH1f8sCk9
+t22anGG7AkEA2UzXdtQ8H1uLAN/XXX2qoLuvJK5jRswHS4GeOg4pnnDSiHg3Vbva
+AxmMIL93ufvIy/xdoENwDPfcI4CbYlrDewJAGWy7W+OSIEoLsqBW+bwkHetnIXNa
+ZAOkzxKoyrigS8hamupEe+xhqUaFuwXyfjobkpfCA+kXeZrKoM4CjEbR7wJAHMbf
+Vd4/ZAu0edYq6DenLAgO5rWtcge9A5PTx25utovMZcQ917273mM4unGAwoGEkvcF
+0x57LUx5u73hVgIdFwJBAKWGuHRwGPgTWYvhpHM0qveH+8KdU9BUt/kV4ONxIVDB
+ftetEmJirqOGLECbImoLcUwQrgfMW4ZCxOioJMz/gY0=
+-----END RSA PRIVATE KEY-----
+"""
+
+
+class AuthModuleUtilitiesTest(unittest.TestCase):
+
+ def testGenerateClientLoginRequestBody(self):
+ body = gdata.auth.GenerateClientLoginRequestBody('jo@gmail.com',
+ 'password', 'test service', 'gdata.auth test')
+ expected_parameters = {'Email':r'jo%40gmail.com', 'Passwd':'password',
+ 'service':'test+service', 'source':'gdata.auth+test',
+ 'accountType':'HOSTED_OR_GOOGLE'}
+ self.__matchBody(body, expected_parameters)
+
+ body = gdata.auth.GenerateClientLoginRequestBody('jo@gmail.com',
+ 'password', 'test service', 'gdata.auth test', account_type='A TEST',
+ captcha_token='12345', captcha_response='test')
+ expected_parameters['accountType'] = 'A+TEST'
+ expected_parameters['logintoken'] = '12345'
+ expected_parameters['logincaptcha'] = 'test'
+ self.__matchBody(body, expected_parameters)
+
+ def __matchBody(self, body, expected_name_value_pairs):
+ parameters = body.split('&')
+ for param in parameters:
+ (name, value) = param.split('=')
+ self.assert_(expected_name_value_pairs[name] == value)
+
+ def testGenerateClientLoginAuthToken(self):
+ http_body = ('SID=DQAAAGgA7Zg8CTN\r\n'
+ 'LSID=DQAAAGsAlk8BBbG\r\n'
+ 'Auth=DQAAAGgAdk3fA5N')
+ self.assert_(gdata.auth.GenerateClientLoginAuthToken(http_body) ==
+ 'GoogleLogin auth=DQAAAGgAdk3fA5N')
+
+
+class GenerateClientLoginRequestBodyTest(unittest.TestCase):
+
+ def testPostBodyShouldMatchShortExample(self):
+ auth_body = gdata.auth.GenerateClientLoginRequestBody('johndoe@gmail.com',
+ 'north23AZ', 'cl', 'Gulp-CalGulp-1.05')
+ self.assert_(-1 < auth_body.find('Email=johndoe%40gmail.com'))
+ self.assert_(-1 < auth_body.find('Passwd=north23AZ'))
+ self.assert_(-1 < auth_body.find('service=cl'))
+ self.assert_(-1 < auth_body.find('source=Gulp-CalGulp-1.05'))
+
+ def testPostBodyShouldMatchLongExample(self):
+ auth_body = gdata.auth.GenerateClientLoginRequestBody('johndoe@gmail.com',
+ 'north23AZ', 'cl', 'Gulp-CalGulp-1.05',
+ captcha_token='DQAAAGgA...dkI1', captcha_response='brinmar')
+ self.assert_(-1 < auth_body.find('logintoken=DQAAAGgA...dkI1'))
+ self.assert_(-1 < auth_body.find('logincaptcha=brinmar'))
+
+ def testEquivalenceWithOldLogic(self):
+ email = 'jo@gmail.com'
+ password = 'password'
+ account_type = 'HOSTED'
+ service = 'test'
+ source = 'auth test'
+ old_request_body = urllib.urlencode({'Email': email,
+ 'Passwd': password,
+ 'accountType': account_type,
+ 'service': service,
+ 'source': source})
+ new_request_body = gdata.auth.GenerateClientLoginRequestBody(email,
+ password, service, source, account_type=account_type)
+ for parameter in old_request_body.split('&'):
+ self.assert_(-1 < new_request_body.find(parameter))
+
+
+class GenerateAuthSubUrlTest(unittest.TestCase):
+
+ def testDefaultParameters(self):
+ url = gdata.auth.GenerateAuthSubUrl('http://example.com/xyz?x=5',
+ 'http://www.google.com/test/feeds')
+ self.assert_(-1 < url.find(
+ r'scope=http%3A%2F%2Fwww.google.com%2Ftest%2Ffeeds'))
+ self.assert_(-1 < url.find(
+ r'next=http%3A%2F%2Fexample.com%2Fxyz%3Fx%3D5'))
+ self.assert_(-1 < url.find('secure=0'))
+ self.assert_(-1 < url.find('session=1'))
+
+ def testAllParameters(self):
+ url = gdata.auth.GenerateAuthSubUrl('http://example.com/xyz?x=5',
+ 'http://www.google.com/test/feeds', secure=True, session=False,
+ request_url='https://example.com/auth')
+ self.assert_(-1 < url.find(
+ r'scope=http%3A%2F%2Fwww.google.com%2Ftest%2Ffeeds'))
+ self.assert_(-1 < url.find(
+ r'next=http%3A%2F%2Fexample.com%2Fxyz%3Fx%3D5'))
+ self.assert_(-1 < url.find('secure=1'))
+ self.assert_(-1 < url.find('session=0'))
+ self.assert_(url.startswith('https://example.com/auth'))
+
+
+class GenerateOAuthRequestTokenUrlTest(unittest.TestCase):
+
+ def testDefaultParameters(self):
+ oauth_input_params = gdata.auth.OAuthInputParams(
+ gdata.auth.OAuthSignatureMethod.RSA_SHA1, CONSUMER_KEY,
+ rsa_key=RSA_KEY)
+ scopes = [
+ 'http://abcd.example.com/feeds',
+ 'http://www.example.com/abcd/feeds'
+ ]
+ url = gdata.auth.GenerateOAuthRequestTokenUrl(
+ oauth_input_params, scopes=scopes)
+ self.assertEquals('https', url.protocol)
+ self.assertEquals('www.google.com', url.host)
+ self.assertEquals('/accounts/OAuthGetRequestToken', url.path)
+ self.assertEquals('1.0', url.params['oauth_version'])
+ self.assertEquals('RSA-SHA1', url.params['oauth_signature_method'])
+ self.assert_(url.params['oauth_nonce'])
+ self.assert_(url.params['oauth_timestamp'])
+ actual_scopes = url.params['scope'].split(' ')
+ self.assertEquals(2, len(actual_scopes))
+ for scope in actual_scopes:
+ self.assert_(scope in scopes)
+ self.assertEquals(CONSUMER_KEY, url.params['oauth_consumer_key'])
+ self.assert_(url.params['oauth_signature'])
+
+ def testAllParameters(self):
+ oauth_input_params = gdata.auth.OAuthInputParams(
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1, CONSUMER_KEY,
+ consumer_secret=CONSUMER_SECRET)
+ scopes = ['http://abcd.example.com/feeds']
+ url = gdata.auth.GenerateOAuthRequestTokenUrl(
+ oauth_input_params, scopes=scopes,
+ request_token_url='https://www.example.com/accounts/OAuthRequestToken',
+ extra_parameters={'oauth_version': '2.0', 'my_param': 'my_value'})
+ self.assertEquals('https', url.protocol)
+ self.assertEquals('www.example.com', url.host)
+ self.assertEquals('/accounts/OAuthRequestToken', url.path)
+ self.assertEquals('2.0', url.params['oauth_version'])
+ self.assertEquals('HMAC-SHA1', url.params['oauth_signature_method'])
+ self.assert_(url.params['oauth_nonce'])
+ self.assert_(url.params['oauth_timestamp'])
+ actual_scopes = url.params['scope'].split(' ')
+ self.assertEquals(1, len(actual_scopes))
+ for scope in actual_scopes:
+ self.assert_(scope in scopes)
+ self.assertEquals(CONSUMER_KEY, url.params['oauth_consumer_key'])
+ self.assert_(url.params['oauth_signature'])
+ self.assertEquals('my_value', url.params['my_param'])
+
+
+class GenerateOAuthAuthorizationUrlTest(unittest.TestCase):
+
+ def testDefaultParameters(self):
+ token_key = 'ABCDDSFFDSG'
+ token_secret = 'SDFDSGSDADADSAF'
+ request_token = gdata.auth.OAuthToken(key=token_key, secret=token_secret)
+ url = gdata.auth.GenerateOAuthAuthorizationUrl(request_token)
+ self.assertEquals('https', url.protocol)
+ self.assertEquals('www.google.com', url.host)
+ self.assertEquals('/accounts/OAuthAuthorizeToken', url.path)
+ self.assertEquals(token_key, url.params['oauth_token'])
+
+ def testAllParameters(self):
+ token_key = 'ABCDDSFFDSG'
+ token_secret = 'SDFDSGSDADADSAF'
+ scopes = [
+ 'http://abcd.example.com/feeds',
+ 'http://www.example.com/abcd/feeds'
+ ]
+ request_token = gdata.auth.OAuthToken(key=token_key, secret=token_secret,
+ scopes=scopes)
+ url = gdata.auth.GenerateOAuthAuthorizationUrl(
+ request_token,
+ authorization_url='https://www.example.com/accounts/OAuthAuthToken',
+ callback_url='http://www.yourwebapp.com/print',
+ extra_params={'permission': '1'},
+ include_scopes_in_callback=True, scopes_param_prefix='token_scope')
+ self.assertEquals('https', url.protocol)
+ self.assertEquals('www.example.com', url.host)
+ self.assertEquals('/accounts/OAuthAuthToken', url.path)
+ self.assertEquals(token_key, url.params['oauth_token'])
+ expected_callback_url = ('http://www.yourwebapp.com/print?'
+ 'token_scope=http%3A%2F%2Fabcd.example.com%2Ffeeds'
+ '+http%3A%2F%2Fwww.example.com%2Fabcd%2Ffeeds')
+ self.assertEquals(expected_callback_url, url.params['oauth_callback'])
+
+
+class GenerateOAuthAccessTokenUrlTest(unittest.TestCase):
+
+ def testDefaultParameters(self):
+ token_key = 'ABCDDSFFDSG'
+ token_secret = 'SDFDSGSDADADSAF'
+ authorized_request_token = gdata.auth.OAuthToken(key=token_key,
+ secret=token_secret)
+ oauth_input_params = gdata.auth.OAuthInputParams(
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1, CONSUMER_KEY,
+ consumer_secret=CONSUMER_SECRET)
+ url = gdata.auth.GenerateOAuthAccessTokenUrl(authorized_request_token,
+ oauth_input_params)
+ self.assertEquals('https', url.protocol)
+ self.assertEquals('www.google.com', url.host)
+ self.assertEquals('/accounts/OAuthGetAccessToken', url.path)
+ self.assertEquals(token_key, url.params['oauth_token'])
+ self.assertEquals('1.0', url.params['oauth_version'])
+ self.assertEquals('HMAC-SHA1', url.params['oauth_signature_method'])
+ self.assert_(url.params['oauth_nonce'])
+ self.assert_(url.params['oauth_timestamp'])
+ self.assertEquals(CONSUMER_KEY, url.params['oauth_consumer_key'])
+ self.assert_(url.params['oauth_signature'])
+
+ def testAllParameters(self):
+ token_key = 'ABCDDSFFDSG'
+ authorized_request_token = gdata.auth.OAuthToken(key=token_key)
+ oauth_input_params = gdata.auth.OAuthInputParams(
+ gdata.auth.OAuthSignatureMethod.RSA_SHA1, CONSUMER_KEY,
+ rsa_key=RSA_KEY)
+ url = gdata.auth.GenerateOAuthAccessTokenUrl(
+ authorized_request_token, oauth_input_params,
+ access_token_url='https://www.example.com/accounts/OAuthGetAccessToken',
+ oauth_version= '2.0')
+ self.assertEquals('https', url.protocol)
+ self.assertEquals('www.example.com', url.host)
+ self.assertEquals('/accounts/OAuthGetAccessToken', url.path)
+ self.assertEquals(token_key, url.params['oauth_token'])
+ self.assertEquals('2.0', url.params['oauth_version'])
+ self.assertEquals('RSA-SHA1', url.params['oauth_signature_method'])
+ self.assert_(url.params['oauth_nonce'])
+ self.assert_(url.params['oauth_timestamp'])
+ self.assertEquals(CONSUMER_KEY, url.params['oauth_consumer_key'])
+ self.assert_(url.params['oauth_signature'])
+
+
+class ExtractAuthSubTokensTest(unittest.TestCase):
+
+ def testGetTokenFromUrl(self):
+ url = 'http://www.yourwebapp.com/showcalendar.html?token=CKF50YzIH'
+ self.assert_(gdata.auth.AuthSubTokenFromUrl(url) ==
+ 'AuthSub token=CKF50YzIH')
+ self.assert_(gdata.auth.TokenFromUrl(url) == 'CKF50YzIH')
+ url = 'http://www.yourwebapp.com/showcalendar.html?token==tokenCKF50YzIH='
+ self.assert_(gdata.auth.AuthSubTokenFromUrl(url) ==
+ 'AuthSub token==tokenCKF50YzIH=')
+ self.assert_(gdata.auth.TokenFromUrl(url) == '=tokenCKF50YzIH=')
+
+ def testGetTokenFromHttpResponse(self):
+ response_body = ('Token=DQAA...7DCTN\r\n'
+ 'Expiration=20061004T123456Z')
+ self.assert_(gdata.auth.AuthSubTokenFromHttpBody(response_body) ==
+ 'AuthSub token=DQAA...7DCTN')
+
+class CreateAuthSubTokenFlowTest(unittest.TestCase):
+
+ def testGenerateRequest(self):
+ request_url = gdata.auth.generate_auth_sub_url(next='http://example.com',
+ scopes=['http://www.blogger.com/feeds/',
+ 'http://www.google.com/base/feeds/'])
+ self.assertEquals(request_url.protocol, 'https')
+ self.assertEquals(request_url.host, 'www.google.com')
+ self.assertEquals(request_url.params['scope'],
+ 'http://www.blogger.com/feeds/ http://www.google.com/base/feeds/')
+ self.assertEquals(request_url.params['hd'], 'default')
+ self.assert_(request_url.params['next'].find('auth_sub_scopes') > -1)
+ self.assert_(request_url.params['next'].startswith('http://example.com'))
+
+ # Use a more complicated 'next' URL.
+ request_url = gdata.auth.generate_auth_sub_url(
+ next='http://example.com/?token_scope=http://www.blogger.com/feeds/',
+ scopes=['http://www.blogger.com/feeds/',
+ 'http://www.google.com/base/feeds/'])
+ self.assert_(request_url.params['next'].find('auth_sub_scopes') > -1)
+ self.assert_(request_url.params['next'].find('token_scope') > -1)
+ self.assert_(request_url.params['next'].startswith('http://example.com/'))
+
+ def testParseNextUrl(self):
+ url = ('http://example.com/?auth_sub_scopes=http%3A%2F%2Fwww.blogger.com'
+ '%2Ffeeds%2F+http%3A%2F%2Fwww.google.com%2Fbase%2Ffeeds%2F&'
+ 'token=my_nifty_token')
+ token = gdata.auth.extract_auth_sub_token_from_url(url)
+ self.assertEquals(token.get_token_string(), 'my_nifty_token')
+ self.assert_(isinstance(token, gdata.auth.AuthSubToken))
+ self.assert_(token.valid_for_scope('http://www.blogger.com/feeds/'))
+ self.assert_(token.valid_for_scope('http://www.google.com/base/feeds/'))
+ self.assert_(
+ not token.valid_for_scope('http://www.google.com/calendar/feeds/'))
+
+ # Parse a more complicated response.
+ url = ('http://example.com/?auth_sub_scopes=http%3A%2F%2Fwww.blogger.com'
+ '%2Ffeeds%2F+http%3A%2F%2Fwww.google.com%2Fbase%2Ffeeds%2F&'
+ 'token_scope=http%3A%2F%2Fwww.blogger.com%2Ffeeds%2F&'
+ 'token=second_token')
+ token = gdata.auth.extract_auth_sub_token_from_url(url)
+ self.assertEquals(token.get_token_string(), 'second_token')
+ self.assert_(isinstance(token, gdata.auth.AuthSubToken))
+ self.assert_(token.valid_for_scope('http://www.blogger.com/feeds/'))
+ self.assert_(token.valid_for_scope('http://www.google.com/base/feeds/'))
+ self.assert_(
+ not token.valid_for_scope('http://www.google.com/calendar/feeds/'))
+
+ def testParseNextWithNoToken(self):
+ token = gdata.auth.extract_auth_sub_token_from_url('http://example.com/')
+ self.assert_(token is None)
+ token = gdata.auth.extract_auth_sub_token_from_url(
+ 'http://example.com/?no_token=foo&other=1')
+ self.assert_(token is None)
+
+
+class ExtractClientLoginTokenTest(unittest.TestCase):
+
+ def testExtractFromBodyWithScopes(self):
+ http_body_string = ('SID=DQAAAGgA7Zg8CTN\r\n'
+ 'LSID=DQAAAGsAlk8BBbG\r\n'
+ 'Auth=DQAAAGgAdk3fA5N')
+ token = gdata.auth.extract_client_login_token(http_body_string,
+ ['http://docs.google.com/feeds/'])
+ self.assertEquals(token.get_token_string(), 'DQAAAGgAdk3fA5N')
+ self.assert_(isinstance(token, gdata.auth.ClientLoginToken))
+ self.assert_(token.valid_for_scope('http://docs.google.com/feeds/'))
+ self.assert_(not token.valid_for_scope('http://www.blogger.com/feeds'))
+
+
+class ExtractOAuthTokensTest(unittest.TestCase):
+
+ def testOAuthTokenFromUrl(self):
+ scope_1 = 'http://docs.google.com/feeds/'
+ scope_2 = 'http://www.blogger.com/feeds/'
+ # Case 1: token and scopes both are present.
+ url = ('http://dummy.com/?oauth_token_scope=http%3A%2F%2Fwww.blogger.com'
+ '%2Ffeeds%2F+http%3A%2F%2Fdocs.google.com%2Ffeeds%2F&'
+ 'oauth_token=CMns6t7MCxDz__8B')
+ token = gdata.auth.OAuthTokenFromUrl(url)
+ self.assertEquals('CMns6t7MCxDz__8B', token.key)
+ self.assertEquals(2, len(token.scopes))
+ self.assert_(scope_1 in token.scopes)
+ self.assert_(scope_2 in token.scopes)
+ # Case 2: token and scopes both are present but scope_param_prefix
+ # passed does not match the one present in the URL.
+ url = ('http://dummy.com/?oauth_token_scope=http%3A%2F%2Fwww.blogger.com'
+ '%2Ffeeds%2F+http%3A%2F%2Fdocs.google.com%2Ffeeds%2F&'
+ 'oauth_token=CMns6t7MCxDz__8B')
+ token = gdata.auth.OAuthTokenFromUrl(url,
+ scopes_param_prefix='token_scope')
+ self.assertEquals('CMns6t7MCxDz__8B', token.key)
+ self.assert_(not token.scopes)
+ # Case 3: None present.
+ url = ('http://dummy.com/?no_oauth_token_scope=http%3A%2F%2Fwww.blogger.com'
+ '%2Ffeeds%2F+http%3A%2F%2Fdocs.google.com%2Ffeeds%2F&'
+ 'no_oauth_token=CMns6t7MCxDz__8B')
+ token = gdata.auth.OAuthTokenFromUrl(url)
+ self.assert_(token is None)
+
+ def testOAuthTokenFromHttpBody(self):
+ token_key = 'ABCD'
+ token_secret = 'XYZ'
+ # Case 1: token key and secret both present single time.
+ http_body = 'oauth_token=%s&oauth_token_secret=%s' % (token_key,
+ token_secret)
+ token = gdata.auth.OAuthTokenFromHttpBody(http_body)
+ self.assertEquals(token_key, token.key)
+ self.assertEquals(token_secret, token.secret)
+
+
+class OAuthInputParametersTest(unittest.TestCase):
+
+ def setUp(self):
+ self.oauth_input_parameters_hmac = gdata.auth.OAuthInputParams(
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1, CONSUMER_KEY,
+ consumer_secret=CONSUMER_SECRET)
+ self.oauth_input_parameters_rsa = gdata.auth.OAuthInputParams(
+ gdata.auth.OAuthSignatureMethod.RSA_SHA1, CONSUMER_KEY,
+ rsa_key=RSA_KEY)
+
+ def testGetSignatureMethod(self):
+ self.assertEquals(
+ 'HMAC-SHA1',
+ self.oauth_input_parameters_hmac.GetSignatureMethod().get_name())
+ rsa_signature_method = self.oauth_input_parameters_rsa.GetSignatureMethod()
+ self.assertEquals('RSA-SHA1', rsa_signature_method.get_name())
+ self.assertEquals(RSA_KEY, rsa_signature_method._fetch_private_cert(None))
+
+ def testGetConsumer(self):
+ self.assertEquals(CONSUMER_KEY,
+ self.oauth_input_parameters_hmac.GetConsumer().key)
+ self.assertEquals(CONSUMER_KEY,
+ self.oauth_input_parameters_rsa.GetConsumer().key)
+ self.assertEquals(CONSUMER_SECRET,
+ self.oauth_input_parameters_hmac.GetConsumer().secret)
+ self.assert_(self.oauth_input_parameters_rsa.GetConsumer().secret is None)
+
+
+class TokenClassesTest(unittest.TestCase):
+
+ def testClientLoginToAndFromString(self):
+ token = gdata.auth.ClientLoginToken()
+ token.set_token_string('foo')
+ self.assertEquals(token.get_token_string(), 'foo')
+ self.assertEquals(token.auth_header, '%s%s' % (
+ gdata.auth.PROGRAMMATIC_AUTH_LABEL, 'foo'))
+ token.set_token_string(token.get_token_string())
+ self.assertEquals(token.get_token_string(), 'foo')
+
+ def testAuthSubToAndFromString(self):
+ token = gdata.auth.AuthSubToken()
+ token.set_token_string('foo')
+ self.assertEquals(token.get_token_string(), 'foo')
+ self.assertEquals(token.auth_header, '%s%s' % (
+ gdata.auth.AUTHSUB_AUTH_LABEL, 'foo'))
+ token.set_token_string(token.get_token_string())
+ self.assertEquals(token.get_token_string(), 'foo')
+
+ def testSecureAuthSubToAndFromString(self):
+ # Case 1: no token.
+ token = gdata.auth.SecureAuthSubToken(RSA_KEY)
+ token.set_token_string('foo')
+ self.assertEquals(token.get_token_string(), 'foo')
+ token.set_token_string(token.get_token_string())
+ self.assertEquals(token.get_token_string(), 'foo')
+ self.assertEquals(str(token), 'foo')
+ # Case 2: token is a string
+ token = gdata.auth.SecureAuthSubToken(RSA_KEY, token_string='foo')
+ self.assertEquals(token.get_token_string(), 'foo')
+ token.set_token_string(token.get_token_string())
+ self.assertEquals(token.get_token_string(), 'foo')
+ self.assertEquals(str(token), 'foo')
+
+ def testOAuthToAndFromString(self):
+ token_key = 'ABCD'
+ token_secret = 'XYZ'
+ # Case 1: token key and secret both present single time.
+ token_string = 'oauth_token=%s&oauth_token_secret=%s' % (token_key,
+ token_secret)
+ token = gdata.auth.OAuthToken()
+ token.set_token_string(token_string)
+ self.assert_(-1 < token.get_token_string().find(token_string.split('&')[0]))
+ self.assert_(-1 < token.get_token_string().find(token_string.split('&')[1]))
+ self.assertEquals(token_key, token.key)
+ self.assertEquals(token_secret, token.secret)
+ # Case 2: token key and secret both present multiple times with unwanted
+ # parameters.
+ token_string = ('oauth_token=%s&oauth_token_secret=%s&'
+ 'oauth_token=%s&ExtraParams=GarbageString' % (token_key,
+ token_secret,
+ 'LMNO'))
+ token = gdata.auth.OAuthToken()
+ token.set_token_string(token_string)
+ self.assert_(-1 < token.get_token_string().find(token_string.split('&')[0]))
+ self.assert_(-1 < token.get_token_string().find(token_string.split('&')[1]))
+ self.assertEquals(token_key, token.key)
+ self.assertEquals(token_secret, token.secret)
+ # Case 3: Only token key present.
+ token_string = 'oauth_token=%s' % (token_key,)
+ token = gdata.auth.OAuthToken()
+ token.set_token_string(token_string)
+ self.assertEquals(token_string, token.get_token_string())
+ self.assertEquals(token_key, token.key)
+ self.assert_(not token.secret)
+ # Case 4: Only token key present.
+ token_string = 'oauth_token_secret=%s' % (token_secret,)
+ token = gdata.auth.OAuthToken()
+ token.set_token_string(token_string)
+ self.assertEquals(token_string, token.get_token_string())
+ self.assertEquals(token_secret, token.secret)
+ self.assert_(not token.key)
+ # Case 5: None present.
+ token_string = ''
+ token = gdata.auth.OAuthToken()
+ token.set_token_string(token_string)
+ self.assert_(token.get_token_string() is None)
+ self.assert_(not token.key)
+ self.assert_(not token.secret)
+
+ def testSecureAuthSubGetAuthHeader(self):
+ # Case 1: Presence of OAuth token (in case of 3-legged OAuth)
+ url = 'http://dummy.com/?q=notebook&s=true'
+ token = gdata.auth.SecureAuthSubToken(RSA_KEY, token_string='foo')
+ auth_header = token.GetAuthHeader('GET', url)
+ self.assert_('Authorization' in auth_header)
+ header_value = auth_header['Authorization']
+ self.assert_(header_value.startswith(r'AuthSub token="foo"'))
+ self.assert_(-1 < header_value.find(r'sigalg="rsa-sha1"'))
+ self.assert_(-1 < header_value.find(r'data="'))
+ self.assert_(-1 < header_value.find(r'sig="'))
+ m = re.search(r'data="(.*?)"', header_value)
+ self.assert_(m is not None)
+ data = m.group(1)
+ self.assert_(data.startswith('GET'))
+ self.assert_(-1 < data.find(url))
+
+ def testOAuthGetAuthHeader(self):
+ # Case 1: Presence of OAuth token (in case of 3-legged OAuth)
+ oauth_input_params = gdata.auth.OAuthInputParams(
+ gdata.auth.OAuthSignatureMethod.RSA_SHA1, CONSUMER_KEY,
+ rsa_key=RSA_KEY)
+ token = gdata.auth.OAuthToken(key='ABCDDSFFDSG',
+ oauth_input_params=oauth_input_params)
+ auth_header = token.GetAuthHeader('GET',
+ 'http://dummy.com/?q=notebook&s=true',
+ realm='http://dummy.com')
+ self.assert_('Authorization' in auth_header)
+ header_value = auth_header['Authorization']
+ self.assert_(-1 < header_value.find(r'OAuth realm="http://dummy.com"'))
+ self.assert_(-1 < header_value.find(r'oauth_version="1.0"'))
+ self.assert_(-1 < header_value.find(r'oauth_token="ABCDDSFFDSG"'))
+ self.assert_(-1 < header_value.find(r'oauth_nonce="'))
+ self.assert_(-1 < header_value.find(r'oauth_timestamp="'))
+ self.assert_(-1 < header_value.find(r'oauth_signature="'))
+ self.assert_(-1 < header_value.find(
+ r'oauth_consumer_key="%s"' % CONSUMER_KEY))
+ self.assert_(-1 < header_value.find(r'oauth_signature_method="RSA-SHA1"'))
+ # Case 2: Absence of OAuth token (in case of 2-legged OAuth)
+ oauth_input_params = gdata.auth.OAuthInputParams(
+ gdata.auth.OAuthSignatureMethod.HMAC_SHA1, CONSUMER_KEY,
+ consumer_secret=CONSUMER_SECRET)
+ token = gdata.auth.OAuthToken(oauth_input_params=oauth_input_params)
+ auth_header = token.GetAuthHeader(
+ 'GET', 'http://dummy.com/?xoauth_requestor_id=user@gmail.com&q=book')
+ self.assert_('Authorization' in auth_header)
+ header_value = auth_header['Authorization']
+ self.assert_(-1 < header_value.find(r'OAuth realm=""'))
+ self.assert_(-1 < header_value.find(r'oauth_version="1.0"'))
+ self.assertEquals(-1, header_value.find(r'oauth_token='))
+ self.assert_(-1 < header_value.find(r'oauth_nonce="'))
+ self.assert_(-1 < header_value.find(r'oauth_timestamp="'))
+ self.assert_(-1 < header_value.find(r'oauth_signature="'))
+ self.assert_(-1 < header_value.find(
+ r'oauth_consumer_key="%s"' % CONSUMER_KEY))
+ self.assert_(-1 < header_value.find(r'oauth_signature_method="HMAC-SHA1"'))
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/blogger/__init__.py b/tests/gdata_tests/blogger/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/blogger/__init__.py
diff --git a/tests/gdata_tests/blogger/data_test.py b/tests/gdata_tests/blogger/data_test.py
new file mode 100755
index 0000000..08b6404
--- /dev/null
+++ b/tests/gdata_tests/blogger/data_test.py
@@ -0,0 +1,104 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+from gdata import test_data
+import gdata.blogger.data
+import atom.core
+import gdata.test_config as conf
+
+
+class BlogEntryTest(unittest.TestCase):
+
+ def testBlogEntryFromString(self):
+ entry = atom.core.parse(test_data.BLOG_ENTRY, gdata.blogger.data.Blog)
+ self.assertEquals(entry.GetBlogName(), 'blogName')
+ self.assertEquals(entry.GetBlogId(), 'blogID')
+ self.assertEquals(entry.title.text, 'Lizzy\'s Diary')
+
+ def testBlogPostFeedFromString(self):
+ feed = atom.core.parse(test_data.BLOG_POSTS_FEED,
+ gdata.blogger.data.BlogPostFeed)
+ self.assertEquals(len(feed.entry), 1)
+ self.assert_(isinstance(feed, gdata.blogger.data.BlogPostFeed))
+ self.assert_(isinstance(feed.entry[0], gdata.blogger.data.BlogPost))
+ self.assertEquals(feed.entry[0].GetPostId(), 'postID')
+ self.assertEquals(feed.entry[0].GetBlogId(), 'blogID')
+ self.assertEquals(feed.entry[0].title.text, 'Quite disagreeable')
+
+ def testCommentFeedFromString(self):
+ feed = atom.core.parse(test_data.BLOG_COMMENTS_FEED,
+ gdata.blogger.data.CommentFeed)
+ self.assertEquals(len(feed.entry), 1)
+ self.assert_(isinstance(feed, gdata.blogger.data.CommentFeed))
+ self.assert_(isinstance(feed.entry[0], gdata.blogger.data.Comment))
+ self.assertEquals(feed.entry[0].get_blog_id(), 'blogID')
+ self.assertEquals(feed.entry[0].get_blog_name(), 'a-blogName')
+ self.assertEquals(feed.entry[0].get_comment_id(), 'commentID')
+ self.assertEquals(feed.entry[0].title.text, 'This is my first comment')
+ self.assertEquals(feed.entry[0].in_reply_to.source,
+ 'http://blogName.blogspot.com/feeds/posts/default/postID')
+ self.assertEquals(feed.entry[0].in_reply_to.ref,
+ 'tag:blogger.com,1999:blog-blogID.post-postID')
+ self.assertEquals(feed.entry[0].in_reply_to.href,
+ 'http://blogName.blogspot.com/2007/04/first-post.html')
+ self.assertEquals(feed.entry[0].in_reply_to.type, 'text/html')
+
+ def testIdParsing(self):
+ entry = gdata.blogger.data.Blog()
+ entry.id = atom.data.Id(
+ text='tag:blogger.com,1999:user-146606542.blog-4023408167658848')
+ self.assertEquals(entry.GetBlogId(), '4023408167658848')
+ entry.id = atom.data.Id(text='tag:blogger.com,1999:blog-4023408167658848')
+ self.assertEquals(entry.GetBlogId(), '4023408167658848')
+
+
+class InReplyToTest(unittest.TestCase):
+
+ def testToAndFromString(self):
+ in_reply_to = gdata.blogger.data.InReplyTo(
+ href='http://example.com/href', ref='http://example.com/ref',
+ source='http://example.com/my_post', type='text/html')
+ xml_string = str(in_reply_to)
+ parsed = atom.core.parse(xml_string, gdata.blogger.data.InReplyTo)
+ self.assertEquals(parsed.source, in_reply_to.source)
+ self.assertEquals(parsed.href, in_reply_to.href)
+ self.assertEquals(parsed.ref, in_reply_to.ref)
+ self.assertEquals(parsed.type, in_reply_to.type)
+
+
+class CommentTest(unittest.TestCase):
+
+ def testToAndFromString(self):
+ comment = gdata.blogger.data.Comment(
+ content=atom.data.Content(text='Nifty!'),
+ in_reply_to=gdata.blogger.data.InReplyTo(
+ source='http://example.com/my_post'))
+ parsed = atom.core.parse(str(comment), gdata.blogger.data.Comment)
+ self.assertEquals(parsed.in_reply_to.source, comment.in_reply_to.source)
+ self.assertEquals(parsed.content.text, comment.content.text)
+
+
+def suite():
+ return conf.build_suite([BlogEntryTest, InReplyToTest, CommentTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/blogger/live_client_test.py b/tests/gdata_tests/blogger/live_client_test.py
new file mode 100755
index 0000000..9245116
--- /dev/null
+++ b/tests/gdata_tests/blogger/live_client_test.py
@@ -0,0 +1,160 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import gdata.blogger.client
+import gdata.blogger.data
+import gdata.gauth
+import gdata.client
+import atom.http_core
+import atom.mock_http_core
+import atom.core
+import gdata.data
+import gdata.test_config as conf
+
+
+conf.options.register_option(conf.BLOG_ID_OPTION)
+
+
+class BloggerClientTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = None
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.blogger.client.BloggerClient()
+ conf.configure_client(self.client, 'BloggerTest', 'blogger')
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def test_create_update_delete(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_create_update_delete')
+
+ # Add a blog post.
+ created = self.client.add_post(conf.options.get_value('blogid'),
+ 'test post from BloggerClientTest',
+ 'Hey look, another test!',
+ labels=['test', 'python'])
+
+ self.assertEqual(created.title.text, 'test post from BloggerClientTest')
+ self.assertEqual(created.content.text, 'Hey look, another test!')
+ self.assertEqual(len(created.category), 2)
+ self.assert_(created.control is None)
+
+ # Change the title of the blog post we just added.
+ created.title.text = 'Edited'
+ updated = self.client.update(created)
+
+ self.assertEqual(updated.title.text, 'Edited')
+ self.assert_(isinstance(updated, gdata.blogger.data.BlogPost))
+ self.assertEqual(updated.content.text, created.content.text)
+
+ # Delete the test entry from the blog.
+ self.client.delete(updated)
+
+ def test_create_draft_post(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_cache(self.client, 'test_create_draft_post')
+
+ # Add a draft blog post.
+ created = self.client.add_post(conf.options.get_value('blogid'),
+ 'draft test post from BloggerClientTest',
+ 'This should only be a draft.',
+ labels=['test2', 'python'], draft=True)
+
+ self.assertEqual(created.title.text,
+ 'draft test post from BloggerClientTest')
+ self.assertEqual(created.content.text, 'This should only be a draft.')
+ self.assertEqual(len(created.category), 2)
+ self.assert_(created.control is not None)
+ self.assert_(created.control.draft is not None)
+ self.assertEqual(created.control.draft.text, 'yes')
+
+ # Publish the blog post.
+ created.control.draft.text = 'no'
+ updated = self.client.update(created)
+
+ if updated.control is not None and updated.control.draft is not None:
+ self.assertNotEqual(updated.control.draft.text, 'yes')
+
+ # Delete the test entry from the blog using the URL instead of the entry.
+ self.client.delete(updated.find_edit_link())
+
+
+ def test_create_draft_page(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_cache(self.client, 'test_create_draft_page')
+
+ # List all pages on the blog.
+ pages_before = self.client.get_pages(conf.options.get_value('blogid'))
+
+ # Add a draft page to blog.
+ created = self.client.add_page(conf.options.get_value('blogid'),
+ 'draft page from BloggerClientTest',
+ 'draft content',
+ draft=True)
+
+ self.assertEqual(created.title.text, 'draft page from BloggerClientTest')
+ self.assertEqual(created.content.text, 'draft content')
+ self.assert_(created.control is not None)
+ self.assert_(created.control.draft is not None)
+ self.assertEqual(created.control.draft.text, 'yes')
+ self.assertEqual(str(int(created.get_page_id())), created.get_page_id())
+
+ # List all pages after adding one.
+ pages_after = self.client.get_pages(conf.options.get_value('blogid'))
+ self.assertEqual(len(pages_before.entry) + 1, len(pages_after.entry))
+
+ # Publish page.
+ created.control.draft.text = 'no'
+ updated = self.client.update(created)
+
+ if updated.control is not None and updated.control.draft is not None:
+ self.assertNotEqual(updated.control.draft.text, 'yes')
+
+ # Delete test page.
+ self.client.delete(updated.find_edit_link())
+ pages_after = self.client.get_pages(conf.options.get_value('blogid'))
+
+ self.assertEqual(len(pages_before.entry), len(pages_after.entry))
+
+
+ def test_retrieve_post_with_categories(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_cache(self.client, 'test_retrieve_post_with_categories')
+ query = gdata.blogger.client.Query(categories=["news"], strict=True)
+ posts = self.client.get_posts(conf.options.get_value('blogid'), query=query)
+
+def suite():
+ return conf.build_suite([BloggerClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/blogger/service_test.py b/tests/gdata_tests/blogger/service_test.py
new file mode 100644
index 0000000..f32f0aa
--- /dev/null
+++ b/tests/gdata_tests/blogger/service_test.py
@@ -0,0 +1,107 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Unit tests to exercise server interactions for blogger."""
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+import unittest
+import getpass
+import atom
+from gdata import test_data
+import gdata.blogger
+import gdata.blogger.service
+
+username = ''
+password = ''
+test_blog_id = ''
+
+class BloggerCrudTests(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.blogger.service.BloggerService(email=username,
+ password=password, source='GoogleInc-PythonBloggerUnitTests-1')
+ # TODO: if the test_blog_id is not set, get the list of the user's blogs
+ # and prompt for which blog to add the test posts to.
+ self.client.ProgrammaticLogin()
+
+ def testPostDraftUpdateAndDelete(self):
+ new_entry = gdata.blogger.BlogPostEntry(title=atom.Title(
+ text='Unit Test Post'))
+ new_entry.content = atom.Content('text', None, 'Hello World')
+ # Make this post a draft so it will not appear publicly on the blog.
+ new_entry.control = atom.Control(draft=atom.Draft(text='yes'))
+ new_entry.AddLabel('test')
+
+ posted = self.client.AddPost(new_entry, blog_id=test_blog_id)
+
+ self.assertEquals(posted.title.text, new_entry.title.text)
+ # Should be one category in the posted entry for the 'test' label.
+ self.assertEquals(len(posted.category), 1)
+ self.assert_(isinstance(posted, gdata.blogger.BlogPostEntry))
+
+ # Change the title and add more labels.
+ posted.title.text = 'Updated'
+ posted.AddLabel('second')
+ updated = self.client.UpdatePost(entry=posted)
+
+ self.assertEquals(updated.title.text, 'Updated')
+ self.assertEquals(len(updated.category), 2)
+
+ # Cleanup and delete the draft blog post.
+ self.client.DeletePost(entry=posted)
+
+ def testAddComment(self):
+ # Create a test post to add comments to.
+ new_entry = gdata.blogger.BlogPostEntry(title=atom.Title(
+ text='Comments Test Post'))
+ new_entry.content = atom.Content('text', None, 'Hello Comments')
+ target_post = self.client.AddPost(new_entry, blog_id=test_blog_id)
+
+ blog_id = target_post.GetBlogId()
+ post_id = target_post.GetPostId()
+
+ new_comment = gdata.blogger.CommentEntry()
+ new_comment.content = atom.Content(text='Test comment')
+ posted = self.client.AddComment(new_comment, blog_id=blog_id,
+ post_id=post_id)
+ self.assertEquals(posted.content.text, new_comment.content.text)
+
+ # Cleanup and delete the comment test blog post.
+ self.client.DeletePost(entry=target_post)
+
+
+class BloggerQueryTests(unittest.TestCase):
+
+ def testConstructBlogQuery(self):
+ pass
+
+ def testConstructBlogQuery(self):
+ pass
+
+ def testConstructBlogQuery(self):
+ pass
+
+
+if __name__ == '__main__':
+ print ('NOTE: Please run these tests only with a test account. ' +
+ 'The tests may delete or update your data.')
+ username = raw_input('Please enter your username: ')
+ password = getpass.getpass()
+ test_blog_id = raw_input('Please enter the blog id for the test blog: ')
+ unittest.main()
+
diff --git a/tests/gdata_tests/blogger_test.py b/tests/gdata_tests/blogger_test.py
new file mode 100755
index 0000000..7e6a772
--- /dev/null
+++ b/tests/gdata_tests/blogger_test.py
@@ -0,0 +1,95 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+
+import unittest
+from gdata import test_data
+import gdata.blogger
+import atom
+
+
+class BlogEntryTest(unittest.TestCase):
+
+ def testBlogEntryFromString(self):
+ entry = gdata.blogger.BlogEntryFromString(test_data.BLOG_ENTRY)
+ self.assertEquals(entry.GetBlogName(), 'blogName')
+ self.assertEquals(entry.GetBlogId(), 'blogID')
+ self.assertEquals(entry.title.text, 'Lizzy\'s Diary')
+
+ def testBlogPostFeedFromString(self):
+ feed = gdata.blogger.BlogPostFeedFromString(test_data.BLOG_POSTS_FEED)
+ self.assertEquals(len(feed.entry), 1)
+ self.assert_(isinstance(feed, gdata.blogger.BlogPostFeed))
+ self.assert_(isinstance(feed.entry[0], gdata.blogger.BlogPostEntry))
+ self.assertEquals(feed.entry[0].GetPostId(), 'postID')
+ self.assertEquals(feed.entry[0].GetBlogId(), 'blogID')
+ self.assertEquals(feed.entry[0].title.text, 'Quite disagreeable')
+
+ def testCommentFeedFromString(self):
+ feed = gdata.blogger.CommentFeedFromString(test_data.BLOG_COMMENTS_FEED)
+ self.assertEquals(len(feed.entry), 1)
+ self.assert_(isinstance(feed, gdata.blogger.CommentFeed))
+ self.assert_(isinstance(feed.entry[0], gdata.blogger.CommentEntry))
+ self.assertEquals(feed.entry[0].GetBlogId(), 'blogID')
+ self.assertEquals(feed.entry[0].GetCommentId(), 'commentID')
+ self.assertEquals(feed.entry[0].title.text, 'This is my first comment')
+ self.assertEquals(feed.entry[0].in_reply_to.source,
+ 'http://blogName.blogspot.com/feeds/posts/default/postID')
+ self.assertEquals(feed.entry[0].in_reply_to.ref,
+ 'tag:blogger.com,1999:blog-blogID.post-postID')
+ self.assertEquals(feed.entry[0].in_reply_to.href,
+ 'http://blogName.blogspot.com/2007/04/first-post.html')
+ self.assertEquals(feed.entry[0].in_reply_to.type, 'text/html')
+
+ def testIdParsing(self):
+ entry = gdata.blogger.BlogEntry()
+ entry.id = atom.Id(
+ text='tag:blogger.com,1999:user-146606542.blog-4023408167658848')
+ self.assertEquals(entry.GetBlogId(), '4023408167658848')
+ entry.id = atom.Id(text='tag:blogger.com,1999:blog-4023408167658848')
+ self.assertEquals(entry.GetBlogId(), '4023408167658848')
+
+
+class InReplyToTest(unittest.TestCase):
+
+ def testToAndFromString(self):
+ in_reply_to = gdata.blogger.InReplyTo(href='http://example.com/href',
+ ref='http://example.com/ref', source='http://example.com/my_post',
+ type='text/html')
+ xml_string = str(in_reply_to)
+ parsed = gdata.blogger.InReplyToFromString(xml_string)
+ self.assertEquals(parsed.source, in_reply_to.source)
+ self.assertEquals(parsed.href, in_reply_to.href)
+ self.assertEquals(parsed.ref, in_reply_to.ref)
+ self.assertEquals(parsed.type, in_reply_to.type)
+
+
+class CommentEntryTest(unittest.TestCase):
+
+ def testToAndFromString(self):
+ comment = gdata.blogger.CommentEntry(content=atom.Content(text='Nifty!'),
+ in_reply_to=gdata.blogger.InReplyTo(
+ source='http://example.com/my_post'))
+ parsed = gdata.blogger.CommentEntryFromString(str(comment))
+ self.assertEquals(parsed.in_reply_to.source, comment.in_reply_to.source)
+ self.assertEquals(parsed.content.text, comment.content.text)
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/books/__init__.py b/tests/gdata_tests/books/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/books/__init__.py
diff --git a/tests/gdata_tests/books/service_test.py b/tests/gdata_tests/books/service_test.py
new file mode 100755
index 0000000..49e1827
--- /dev/null
+++ b/tests/gdata_tests/books/service_test.py
@@ -0,0 +1,64 @@
+#!/usr/bin/python
+
+__author__ = "James Sams <sams.james@gmail.com>"
+
+import unittest
+import getpass
+
+import atom
+import gdata.books
+import gdata.books.service
+
+from gdata import test_data
+
+username = ""
+password = ""
+
+class BookCRUDTests(unittest.TestCase):
+
+ def setUp(self):
+ self.service = gdata.books.service.BookService(email=username,
+ password=password, source="Google-PythonGdataTest-1")
+ if username and password:
+ self.authenticated = True
+ self.service.ProgrammaticLogin()
+ else:
+ self.authenticated = False
+
+ def testPublicSearch(self):
+ entry = self.service.get_by_google_id("b7GZr5Btp30C")
+ self.assertEquals((entry.creator[0].text, entry.dc_title[0].text),
+ ('John Rawls', 'A theory of justice'))
+ feed = self.service.search_by_keyword(isbn="9780198250548")
+ feed1 = self.service.search("9780198250548")
+ self.assertEquals(len(feed.entry), 1)
+ self.assertEquals(len(feed1.entry), 1)
+
+ def testLibraryCrd(self):
+ """
+ the success of the create operations assumes the book was not already
+ in the library. if it was, there will not be a failure, but a successful
+ add will not actually be tested.
+ """
+ if not self.authenticated:
+ return
+ entry = self.service.get_by_google_id("b7GZr5Btp30C")
+ entry = self.service.add_item_to_library(entry)
+ lib = list(self.service.get_library())
+ self.assert_(entry.to_dict()['title'] in
+ [x.to_dict()['title'] for x in lib])
+ self.service.remove_item_from_library(entry)
+ lib = list(self.service.get_library())
+ self.assert_(entry.to_dict()['title'] not in
+ [x.to_dict()['title'] for x in lib])
+
+ def testAnnotations(self):
+ "annotations do not behave as expected"
+ pass
+
+
+if __name__ == "__main__":
+ print "Please use a test account. May cause data loss."
+ username = raw_input("Google Username: ").strip()
+ password = getpass.getpass()
+ unittest.main()
diff --git a/tests/gdata_tests/books_test.py b/tests/gdata_tests/books_test.py
new file mode 100755
index 0000000..c1162ed
--- /dev/null
+++ b/tests/gdata_tests/books_test.py
@@ -0,0 +1,58 @@
+#!/usr/bin/python
+
+
+__author__ = "James Sams <sams.james@gmail.com>"
+
+
+import unittest
+from gdata import test_data
+import gdata.books
+import atom
+
+
+class BookEntryTest(unittest.TestCase):
+
+ def testBookEntryFromString(self):
+ entry = gdata.books.Book.FromString(test_data.BOOK_ENTRY)
+ self.assert_(isinstance(entry, gdata.books.Book))
+ self.assertEquals([x.text for x in entry.creator], ['John Rawls'])
+ self.assertEquals(entry.date.text, '1999')
+ self.assertEquals(entry.format.text, '538 pages')
+ self.assertEquals([x.text for x in entry.identifier],
+ ['b7GZr5Btp30C', 'ISBN:0198250541', 'ISBN:9780198250548'])
+ self.assertEquals([x.text for x in entry.publisher],
+ ['Oxford University Press'])
+ self.assertEquals(entry.subject, None)
+ self.assertEquals([x.text for x in entry.dc_title],
+ ['A theory of justice'])
+ self.assertEquals(entry.viewability.value,
+ 'http://schemas.google.com/books/2008#view_partial')
+ self.assertEquals(entry.embeddability.value,
+ 'http://schemas.google.com/books/2008#embeddable')
+ self.assertEquals(entry.review, None)
+ self.assertEquals([getattr(entry.rating, x) for x in
+ ("min", "max", "average", "value")], ['1', '5', '4.00', None])
+ self.assertEquals(entry.GetThumbnailLink().href,
+ 'http://bks0.books.google.com/books?id=b7GZr5Btp30C&printsec=frontcover&img=1&zoom=5&sig=ACfU3U121bWZsbjBfVwVRSK2o982jJTd1w&source=gbs_gdata')
+ self.assertEquals(entry.GetInfoLink().href,
+ 'http://books.google.com/books?id=b7GZr5Btp30C&ie=ISO-8859-1&source=gbs_gdata')
+ self.assertEquals(entry.GetPreviewLink(), None)
+ self.assertEquals(entry.GetAnnotationLink().href,
+ 'http://www.google.com/books/feeds/users/me/volumes')
+ self.assertEquals(entry.get_google_id(), 'b7GZr5Btp30C')
+
+ def testBookFeedFromString(self):
+ feed = gdata.books.BookFeed.FromString(test_data.BOOK_FEED)
+ self.assert_(isinstance(feed, gdata.books.BookFeed))
+ self.assertEquals( len(feed.entry), 1)
+ self.assert_(isinstance(feed.entry[0], gdata.books.Book))
+
+ def testBookEntryToDict(self):
+ book = gdata.books.Book()
+ book.dc_title.append(gdata.books.Title(text='a'))
+ book.dc_title.append(gdata.books.Title(text='b'))
+ book.dc_title.append(gdata.books.Title(text='c'))
+ self.assertEqual(book.to_dict()['title'], 'a b c')
+
+if __name__ == "__main__":
+ unittest.main()
diff --git a/tests/gdata_tests/calendar/__init__.py b/tests/gdata_tests/calendar/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/calendar/__init__.py
diff --git a/tests/gdata_tests/calendar/calendar_acl_test.py b/tests/gdata_tests/calendar/calendar_acl_test.py
new file mode 100644
index 0000000..4e7c3c6
--- /dev/null
+++ b/tests/gdata_tests/calendar/calendar_acl_test.py
@@ -0,0 +1,201 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'api.lliabraa@google.com (Lane LiaBraaten)'
+
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom
+import gdata.calendar
+import gdata.calendar.service
+import gdata.service
+import random
+import getpass
+from gdata import test_data
+
+username = ''
+password = ''
+
+class CalendarServiceAclUnitTest(unittest.TestCase):
+ _aclFeedUri = "/calendar/feeds/default/acl/full"
+ _aclEntryUri = "%s/user:%s" % (_aclFeedUri, "user@gmail.com",)
+
+ def setUp(self):
+ self.cal_client = gdata.calendar.service.CalendarService()
+ self.cal_client.email = username
+ self.cal_client.password = password
+ self.cal_client.source = 'GCalendarClient ACL "Unit" Tests'
+
+ def tearDown(self):
+ # No teardown needed
+ pass
+
+ def _getRandomNumber(self):
+ """Return a random number as a string for testing"""
+ r = random.Random()
+ r.seed()
+ return str(r.randint(100000,1000000))
+
+ def _generateAclEntry(self, role="owner", scope_type="user", scope_value=None):
+ """Generates a ACL rule from parameters or makes a random user an owner by default"""
+ if (scope_type=="user" and scope_value is None):
+ scope_value = "user%s@gmail.com" % (self._getRandomNumber())
+ rule = gdata.calendar.CalendarAclEntry()
+ rule.title = atom.Title(text=role)
+ rule.scope = gdata.calendar.Scope(value=scope_value, type="user")
+ rule.role = gdata.calendar.Role(value="http://schemas.google.com/gCal/2005#%s" % (role))
+ return rule
+
+ def assertEqualAclEntry(self, expected, actual):
+ """Compares the values of two ACL entries"""
+ self.assertEqual(expected.role.value, actual.role.value)
+ self.assertEqual(expected.scope.value, actual.scope.value)
+ self.assertEqual(expected.scope.type, actual.scope.type)
+
+ def testGetAclFeedUnauthenticated(self):
+ """Fiendishly try to get an ACL feed without authenticating"""
+ try:
+ self.cal_client.GetCalendarAclFeed(self._aclFeedUri)
+ self.fail("Unauthenticated request should fail")
+ except gdata.service.RequestError, error:
+ self.assertEqual(error[0]['status'], 401)
+ self.assertEqual(error[0]['reason'], "Authorization required")
+
+ def testGetAclFeed(self):
+ """Get an ACL feed"""
+ self.cal_client.ProgrammaticLogin()
+ feed = self.cal_client.GetCalendarAclFeed(self._aclFeedUri)
+ self.assertNotEqual(0,len(feed.entry))
+
+ def testGetAclEntryUnauthenticated(self):
+ """Fiendishly try to get an ACL entry without authenticating"""
+ try:
+ self.cal_client.GetCalendarAclEntry(self._aclEntryUri)
+ self.fail("Unauthenticated request should fail");
+ except gdata.service.RequestError, error:
+ self.assertEqual(error[0]['status'], 401)
+ self.assertEqual(error[0]['reason'], "Authorization required")
+
+ def testGetAclEntry(self):
+ """Get an ACL entry"""
+ self.cal_client.ProgrammaticLogin()
+ self.cal_client.GetCalendarAclEntry(self._aclEntryUri)
+
+ def testCalendarAclFeedFromString(self):
+ """Create an ACL feed from a hard-coded string"""
+ aclFeed = gdata.calendar.CalendarAclFeedFromString(test_data.ACL_FEED)
+ self.assertEqual("Elizabeth Bennet's access control list", aclFeed.title.text)
+ self.assertEqual(2,len(aclFeed.entry))
+
+ def testCalendarAclEntryFromString(self):
+ """Create an ACL entry from a hard-coded string"""
+ aclEntry = gdata.calendar.CalendarAclEntryFromString(test_data.ACL_ENTRY)
+ self.assertEqual("owner", aclEntry.title.text)
+ self.assertEqual("user", aclEntry.scope.type)
+ self.assertEqual("liz@gmail.com", aclEntry.scope.value)
+ self.assertEqual("http://schemas.google.com/gCal/2005#owner", aclEntry.role.value)
+
+ def testCreateAndDeleteAclEntry(self):
+ """Add an ACL rule and verify that is it returned in the ACL feed. Then delete the rule and
+ verify that the rule is no longer included in the ACL feed."""
+ # Get the current number of ACL rules
+ self.cal_client.ProgrammaticLogin()
+ aclFeed = self.cal_client.GetCalendarAclFeed(self._aclFeedUri)
+ original_rule_count = len(aclFeed.entry)
+
+ # Insert entry
+ rule = self._generateAclEntry()
+ returned_rule = self.cal_client.InsertAclEntry(rule, self._aclFeedUri)
+
+ # Verify rule was added with correct ACL values
+ aclFeed = self.cal_client.GetCalendarAclFeed(self._aclFeedUri)
+ self.assertEqual(original_rule_count+1, len(aclFeed.entry))
+ self.assertEqualAclEntry(rule, returned_rule)
+
+ # Delete the event
+ self.cal_client.DeleteAclEntry(returned_rule.GetEditLink().href)
+ aclFeed = self.cal_client.GetCalendarAclFeed(self._aclFeedUri)
+ self.assertEquals(original_rule_count, len(aclFeed.entry))
+
+ def testUpdateAclChangeScopeValue(self):
+ """Fiendishly try to insert a test ACL rule and attempt to change the scope value (i.e. username).
+ Verify that an exception is thrown, then delete the test rule."""
+ # Insert a user-scoped owner role ot random user
+ aclEntry = self._generateAclEntry("owner","user");
+ self.cal_client.ProgrammaticLogin()
+ rule = self._generateAclEntry()
+ returned_rule = self.cal_client.InsertAclEntry(rule, self._aclFeedUri)
+
+ # Change the scope value (i.e. what user is the owner) and update the entry
+ updated_rule = returned_rule
+ updated_rule.scope.value = "user_%s@gmail.com" % (self._getRandomNumber())
+ try:
+ returned_rule = self.cal_client.UpdateAclEntry(returned_rule.GetEditLink().href, updated_rule)
+ except gdata.service.RequestError, error:
+ self.assertEqual(error[0]['status'], 403)
+ self.assertEqual(error[0]['reason'], "Forbidden")
+
+ self.cal_client.DeleteAclEntry(updated_rule.GetEditLink().href)
+
+
+ def testUpdateAclChangeScopeType(self):
+ """Fiendishly try to insert a test ACL rule and attempt to change the scope type (i.e. from 'user' to 'domain').
+ Verify that an exception is thrown, then delete the test rule."""
+ # Insert a user-scoped owner role ot random user
+ aclEntry = self._generateAclEntry("owner","user");
+ self.cal_client.ProgrammaticLogin()
+ rule = self._generateAclEntry()
+ returned_rule = self.cal_client.InsertAclEntry(rule, self._aclFeedUri)
+
+ # Change the scope value (i.e. what user is the owner) and update the entry
+ updated_rule = returned_rule
+ updated_rule.scope.type = "domain"
+ try:
+ returned_rule = self.cal_client.UpdateAclEntry(returned_rule.GetEditLink().href, updated_rule)
+ except gdata.service.RequestError, error:
+ self.assertEqual(error[0]['status'], 403)
+ self.assertEqual(error[0]['reason'], "Forbidden")
+
+ self.cal_client.DeleteAclEntry(updated_rule.GetEditLink().href)
+
+
+ def testUpdateAclChangeRoleValue(self):
+ """Insert a test ACL rule and attempt to change the scope type (i.e. from 'owner' to 'editor').
+ Verify that an exception is thrown, then delete the test rule."""
+ # Insert a user-scoped owner role ot random user
+ aclEntry = self._generateAclEntry("owner","user");
+ self.cal_client.ProgrammaticLogin()
+ rule = self._generateAclEntry()
+ returned_rule = self.cal_client.InsertAclEntry(rule, self._aclFeedUri)
+
+ # Change the scope value (i.e. what user is the owner) and update the entry
+ updated_rule = returned_rule
+ updated_rule.role.value = "http://schemas.google.com/gCal/2005#editor"
+ returned_rule = self.cal_client.UpdateAclEntry(returned_rule.GetEditLink().href, updated_rule)
+ self.assertEqualAclEntry(updated_rule, returned_rule)
+
+ self.cal_client.DeleteAclEntry(updated_rule.GetEditLink().href)
+
+if __name__ == '__main__':
+ print ('NOTE: Please run these tests only with a test account. ' +
+ 'The tests may delete or update your data.')
+ username = raw_input('Please enter your username: ')
+ password = getpass.getpass()
+ unittest.main()
+
diff --git a/tests/gdata_tests/calendar/service_test.py b/tests/gdata_tests/calendar/service_test.py
new file mode 100755
index 0000000..b525958
--- /dev/null
+++ b/tests/gdata_tests/calendar/service_test.py
@@ -0,0 +1,461 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'api.rboyd@google.com (Ryan Boyd)'
+
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom
+import atom.mock_http
+import gdata.calendar
+import gdata.calendar.service
+import random
+import getpass
+
+
+username = ''
+password = ''
+
+
+class CalendarServiceUnitTest(unittest.TestCase):
+
+ def setUp(self):
+ self.cal_client = gdata.calendar.service.CalendarService()
+ self.cal_client.email = username
+ self.cal_client.password = password
+ self.cal_client.source = 'GCalendarClient "Unit" Tests'
+
+ def tearDown(self):
+ # No teardown needed
+ pass
+
+ def testUrlScrubbing(self):
+ self.assertEquals(self.cal_client._RemoveStandardUrlPrefix(
+ '/test'), '/test')
+ self.assertEquals(self.cal_client._RemoveStandardUrlPrefix(
+ 'http://www.google.com/calendar/test'), '/calendar/test')
+ self.assertEquals(self.cal_client._RemoveStandardUrlPrefix(
+ 'https://www.google.com/calendar/test'),
+ 'https://www.google.com/calendar/test')
+
+ def testPostUpdateAndDeleteSubscription(self):
+ """Test posting a new subscription, updating it, deleting it"""
+ self.cal_client.ProgrammaticLogin()
+
+ subscription_id = 'c4o4i7m2lbamc4k26sc2vokh5g%40group.calendar.google.com'
+ subscription_url = '%s%s' % (
+ 'http://www.google.com/calendar/feeds/default/allcalendars/full/',
+ subscription_id)
+
+ # Subscribe to Google Doodles calendar
+ calendar = gdata.calendar.CalendarListEntry()
+ calendar.id = atom.Id(text=subscription_id)
+ returned_calendar = self.cal_client.InsertCalendarSubscription(calendar)
+ self.assertEquals(subscription_url, returned_calendar.id.text)
+ self.assertEquals('Google Doodles', returned_calendar.title.text)
+
+ # Update subscription
+ calendar_to_update = self.cal_client.GetCalendarListEntry(subscription_url)
+ self.assertEquals('Google Doodles', calendar_to_update.title.text)
+ self.assertEquals('true', calendar_to_update.selected.value)
+ calendar_to_update.selected.value = 'false'
+ self.assertEquals('false', calendar_to_update.selected.value)
+ updated_calendar = self.cal_client.UpdateCalendar(calendar_to_update)
+ self.assertEquals('false', updated_calendar.selected.value)
+
+ # Delete subscription
+ response = self.cal_client.DeleteCalendarEntry(
+ returned_calendar.GetEditLink().href)
+ self.assertEquals(True, response)
+
+ def testPostUpdateAndDeleteCalendar(self):
+ """Test posting a new calendar, updating it, deleting it"""
+ self.cal_client.ProgrammaticLogin()
+
+ # New calendar to create
+ title='Little League Schedule'
+ description='This calendar contains practice and game times'
+ time_zone='America/Los_Angeles'
+ hidden=False
+ location='Oakland'
+ color='#2952A3'
+
+ # Calendar object
+ calendar = gdata.calendar.CalendarListEntry()
+ calendar.title = atom.Title(text=title)
+ calendar.summary = atom.Summary(text=description)
+ calendar.where = gdata.calendar.Where(value_string=location)
+ calendar.color = gdata.calendar.Color(value=color)
+ calendar.timezone = gdata.calendar.Timezone(value=time_zone)
+ if hidden:
+ calendar.hidden = gdata.calendar.Hidden(value='true')
+ else:
+ calendar.hidden = gdata.calendar.Hidden(value='false')
+
+ # Create calendar
+ new_calendar = self.cal_client.InsertCalendar(new_calendar=calendar)
+ self.assertEquals(title, new_calendar.title.text)
+ self.assertEquals(description, new_calendar.summary.text)
+ self.assertEquals(location, new_calendar.where.value_string)
+ self.assertEquals(color, new_calendar.color.value)
+ self.assertEquals(time_zone, new_calendar.timezone.value)
+ if hidden:
+ self.assertEquals('true', new_calendar.hidden.value)
+ else:
+ self.assertEquals('false', new_calendar.hidden.value)
+
+ # Update calendar
+ calendar_to_update = self.cal_client.GetCalendarListEntry(
+ new_calendar.id.text)
+ updated_title = 'This is the updated title'
+ calendar_to_update.title.text = updated_title
+ updated_calendar = self.cal_client.UpdateCalendar(calendar_to_update)
+ self.assertEquals(updated_title, updated_calendar.title.text)
+
+ # Delete calendar
+ calendar_to_delete = self.cal_client.GetCalendarListEntry(
+ new_calendar.id.text)
+ self.cal_client.Delete(calendar_to_delete.GetEditLink().href)
+
+ return new_calendar
+
+ def testPostAndDeleteExtendedPropertyEvent(self):
+ """Test posting a new entry with an extended property, deleting it"""
+ # Get random data for creating event
+ r = random.Random()
+ r.seed()
+ random_event_number = str(r.randint(100000,1000000))
+ random_event_title = 'My Random Extended Property Test Event %s' % (
+ random_event_number)
+
+ # Set event data
+ event = gdata.calendar.CalendarEventEntry()
+ event.author.append(atom.Author(name=atom.Name(text='GData Test user')))
+ event.title = atom.Title(text=random_event_title)
+ event.content = atom.Content(text='Picnic with some lunch')
+ event.extended_property.append(gdata.calendar.ExtendedProperty(
+ name='prop test name', value='prop test value'))
+
+ # Insert event
+ self.cal_client.ProgrammaticLogin()
+ new_event = self.cal_client.InsertEvent(event,
+ '/calendar/feeds/default/private/full')
+
+ self.assertEquals(event.extended_property[0].value,
+ new_event.extended_property[0].value)
+
+ # Delete the event
+ self.cal_client.DeleteEvent(new_event.GetEditLink().href)
+
+ # WARNING: Due to server-side issues, this test takes a while (~60seconds)
+ def testPostEntryWithCommentAndDelete(self):
+ """Test posting a new entry with an extended property, deleting it"""
+ # Get random data for creating event
+ r = random.Random()
+ r.seed()
+ random_event_number = str(r.randint(100000,1000000))
+ random_event_title = 'My Random Comments Test Event %s' % (
+ random_event_number)
+
+ # Set event data
+ event = gdata.calendar.CalendarEventEntry()
+ event.author.append(atom.Author(name=atom.Name(text='GData Test user')))
+ event.title = atom.Title(text=random_event_title)
+ event.content = atom.Content(text='Picnic with some lunch')
+
+ # Insert event
+ self.cal_client.ProgrammaticLogin()
+ new_event = self.cal_client.InsertEvent(event,
+ '/calendar/feeds/default/private/full')
+
+ # Get comments feed
+ comments_url = new_event.comments.feed_link.href
+ comments_query = gdata.calendar.service.CalendarEventCommentQuery(comments_url)
+ comments_feed = self.cal_client.CalendarQuery(comments_query)
+
+ # Add comment
+ comments_entry = gdata.calendar.CalendarEventCommentEntry()
+ comments_entry.content = atom.Content(text='Comments content')
+ comments_entry.author.append(
+ atom.Author(name=atom.Name(text='GData Test user'),
+ email=atom.Email(text=username)))
+ new_comments_entry = self.cal_client.InsertEventComment(comments_entry,
+ comments_feed.GetPostLink().href)
+
+ # Delete the event
+ event_to_delete = self.cal_client.GetCalendarEventEntry(new_event.id.text)
+ self.cal_client.DeleteEvent(event_to_delete.GetEditLink().href)
+
+ def testPostQueryUpdateAndDeleteEvents(self):
+ """Test posting a new entry, updating it, deleting it, querying for it"""
+
+ # Get random data for creating event
+ r = random.Random()
+ r.seed()
+ random_event_number = str(r.randint(100000,1000000))
+ random_event_title = 'My Random Test Event %s' % random_event_number
+
+ random_start_hour = (r.randint(1,1000000) % 23)
+ random_end_hour = random_start_hour + 1
+ non_random_start_minute = 0
+ non_random_end_minute = 0
+ random_month = (r.randint(1,1000000) % 12 + 1)
+ random_day_of_month = (r.randint(1,1000000) % 28 + 1)
+ non_random_year = 2008
+ start_time = '%04d-%02d-%02dT%02d:%02d:00.000-05:00' % (
+ non_random_year, random_month, random_day_of_month,
+ random_start_hour, non_random_start_minute,)
+ end_time = '%04d-%02d-%02dT%02d:%02d:00.000-05:00' % (
+ non_random_year, random_month, random_day_of_month,
+ random_end_hour, non_random_end_minute,)
+
+ # Set event data
+ event = gdata.calendar.CalendarEventEntry()
+ event.author.append(atom.Author(name=atom.Name(text='GData Test user')))
+ event.title = atom.Title(text=random_event_title)
+ event.content = atom.Content(text='Picnic with some lunch')
+ event.where.append(gdata.calendar.Where(value_string='Down by the river'))
+ event.when.append(gdata.calendar.When(start_time=start_time,end_time=end_time))
+
+ # Insert event
+ self.cal_client.ProgrammaticLogin()
+ new_event = self.cal_client.InsertEvent(event,
+ '/calendar/feeds/default/private/full')
+
+ # Ensure that atom data returned from calendar server equals atom data sent
+ self.assertEquals(event.title.text, new_event.title.text)
+ self.assertEquals(event.content.text, new_event.content.text)
+
+ # Ensure that gd:where data returned from calendar equals value sent
+ self.assertEquals(event.where[0].value_string,
+ new_event.where[0].value_string)
+
+ # Commented out as dateutil is not in this repository
+ # Ensure that dates returned from calendar server equals dates sent
+ #start_time_py = parse(event.when[0].start_time)
+ #start_time_py_new = parse(new_event.when[0].start_time)
+ #self.assertEquals(start_time_py, start_time_py_new)
+
+ #end_time_py = parse(event.when[0].end_time)
+ #end_time_py_new = parse(new_event.when[0].end_time)
+ #self.assertEquals(end_time_py, end_time_py_new)
+
+ # Update event
+ event_to_update = new_event
+ updated_title_text = event_to_update.title.text + ' - UPDATED'
+ event_to_update.title = atom.Title(text=updated_title_text)
+
+ updated_event = self.cal_client.UpdateEvent(
+ event_to_update.GetEditLink().href, event_to_update)
+
+ # Ensure that updated title was set in the updated event
+ self.assertEquals(event_to_update.title.text, updated_event.title.text)
+
+ # Delete the event
+ self.cal_client.DeleteEvent(updated_event.GetEditLink().href)
+
+ # Ensure deleted event is marked as canceled in the feed
+ after_delete_query = gdata.calendar.service.CalendarEventQuery()
+ after_delete_query.updated_min = '2007-01-01'
+ after_delete_query.text_query = str(random_event_number)
+ after_delete_query.max_results = '1'
+ after_delete_query_result = self.cal_client.CalendarQuery(
+ after_delete_query)
+
+ # Ensure feed returned at max after_delete_query.max_results events
+ self.assert_(
+ len(after_delete_query_result.entry) <= after_delete_query.max_results)
+
+ # Ensure status of returned event is canceled
+ self.assertEquals(after_delete_query_result.entry[0].event_status.value,
+ 'CANCELED')
+
+ def testEventWithSyncEventAndUID(self):
+ """Test posting a new entry (with syncEvent and a UID) and deleting it."""
+
+ # Get random data for creating event
+ r = random.Random()
+ r.seed()
+ random_event_number = str(r.randint(100000,1000000))
+ random_event_title = 'My Random Test Event %s' % random_event_number
+
+ random_start_hour = (r.randint(1,1000000) % 23)
+ random_end_hour = random_start_hour + 1
+ non_random_start_minute = 0
+ non_random_end_minute = 0
+ random_month = (r.randint(1,1000000) % 12 + 1)
+ random_day_of_month = (r.randint(1,1000000) % 28 + 1)
+ non_random_year = 2008
+ start_time = '%04d-%02d-%02dT%02d:%02d:00.000-05:00' % (
+ non_random_year, random_month, random_day_of_month,
+ random_start_hour, non_random_start_minute,)
+ end_time = '%04d-%02d-%02dT%02d:%02d:00.000-05:00' % (
+ non_random_year, random_month, random_day_of_month,
+ random_end_hour, non_random_end_minute,)
+
+ # create a random event ID. I'm mimicing an example from outlook here,
+ # the format doesn't seem to be important per the RFC except for being
+ # globally unique.
+ uid_string = ''
+ for i in xrange(121):
+ uid_string += "%X" % r.randint(0, 0xf)
+
+ # Set event data
+ event = gdata.calendar.CalendarEventEntry()
+ event.author.append(atom.Author(name=atom.Name(text='GData Test user')))
+ event.title = atom.Title(text=random_event_title)
+ event.content = atom.Content(text='Picnic with some lunch')
+ event.where.append(gdata.calendar.Where(value_string='Down by the river'))
+ event.when.append(gdata.calendar.When(
+ start_time=start_time,end_time=end_time))
+ event.sync_event = gdata.calendar.SyncEvent('true')
+ event.uid = gdata.calendar.UID(value=uid_string)
+
+ # Insert event
+ self.cal_client.ProgrammaticLogin()
+ new_event = self.cal_client.InsertEvent(event,
+ '/calendar/feeds/default/private/full')
+
+ # Inserting it a second time should fail, as it'll have the same UID
+ try:
+ bad_event = self.cal_client.InsertEvent(event,
+ '/calendar/feeds/default/private/full')
+ self.fail('Was able to insert an event with a duplicate UID')
+ except gdata.service.RequestError, error:
+ # for the current problem with redirects, just re-raise so the
+ # failure doesn't seem to be because of the duplicate UIDs.
+ status = error[0]['status']
+ if status == 302:
+ raise
+
+ # otherwise, make sure it was the right error
+ self.assertEquals(error[0]['status'], 409)
+ self.assertEquals(error[0]['reason'], 'Conflict')
+
+ # Ensure that atom data returned from calendar server equals atom data
+ # sent
+ self.assertEquals(event.title.text, new_event.title.text)
+ self.assertEquals(event.content.text, new_event.content.text)
+
+ # Ensure that gd:where data returned from calendar equals value sent
+ self.assertEquals(event.where[0].value_string,
+ new_event.where[0].value_string)
+
+ # Delete the event
+ self.cal_client.DeleteEvent(new_event.GetEditLink().href)
+
+
+ def testCreateAndDeleteEventUsingBatch(self):
+ # Get random data for creating event
+ r = random.Random()
+ r.seed()
+ random_event_number = str(r.randint(100000,1000000))
+ random_event_title = 'My Random Comments Test Event %s' % (
+ random_event_number)
+
+ # Set event data
+ event = gdata.calendar.CalendarEventEntry()
+ event.author.append(atom.Author(name=atom.Name(text='GData Test user')))
+ event.title = atom.Title(text=random_event_title)
+ event.content = atom.Content(text='Picnic with some lunch')
+
+ # Form a batch request
+ batch_request = gdata.calendar.CalendarEventFeed()
+ batch_request.AddInsert(entry=event)
+
+ # Execute the batch request to insert the event.
+ self.cal_client.ProgrammaticLogin()
+ batch_result = self.cal_client.ExecuteBatch(batch_request,
+ gdata.calendar.service.DEFAULT_BATCH_URL)
+
+ self.assertEquals(len(batch_result.entry), 1)
+ self.assertEquals(batch_result.entry[0].title.text, random_event_title)
+ self.assertEquals(batch_result.entry[0].batch_operation.type,
+ gdata.BATCH_INSERT)
+ self.assertEquals(batch_result.GetBatchLink().href,
+ gdata.calendar.service.DEFAULT_BATCH_URL)
+
+ # Create a batch request to delete the newly created entry.
+ batch_delete_request = gdata.calendar.CalendarEventFeed()
+ batch_delete_request.AddDelete(entry=batch_result.entry[0])
+
+ batch_delete_result = self.cal_client.ExecuteBatch(batch_delete_request,
+ batch_result.GetBatchLink().href)
+ self.assertEquals(len(batch_delete_result.entry), 1)
+ self.assertEquals(batch_delete_result.entry[0].batch_operation.type,
+ gdata.BATCH_DELETE)
+
+ def testCorrectReturnTypesForGetMethods(self):
+ self.cal_client.ProgrammaticLogin()
+
+ result = self.cal_client.GetCalendarEventFeed()
+ self.assertEquals(isinstance(result, gdata.calendar.CalendarEventFeed),
+ True)
+
+ def testValidHostName(self):
+ mock_http = atom.mock_http.MockHttpClient()
+ response = atom.mock_http.MockResponse(body='<entry/>', status=200,
+ reason='OK')
+ mock_http.add_response(response, 'GET',
+ 'https://www.google.com/calendar/feeds/default/allcalendars/full')
+ self.cal_client.ssl = True
+ self.cal_client.http_client = mock_http
+ self.cal_client.SetAuthSubToken('foo')
+ self.assertEquals(str(self.cal_client.token_store.find_token(
+ 'https://www.google.com/calendar/feeds/default/allcalendars/full')),
+ 'AuthSub token=foo')
+ resp = self.cal_client.Get('/calendar/feeds/default/allcalendars/full')
+ self.assert_(resp is not None)
+
+
+class CalendarEventQueryUnitTest(unittest.TestCase):
+
+ def setUp(self):
+ self.query = gdata.calendar.service.CalendarEventQuery()
+
+ def testOrderByValidatesValues(self):
+ self.query.orderby = 'lastmodified'
+ self.assertEquals(self.query.orderby, 'lastmodified')
+ try:
+ self.query.orderby = 'illegal input'
+ self.fail()
+ except gdata.calendar.service.Error:
+ self.assertEquals(self.query.orderby, 'lastmodified')
+
+ def testSortOrderValidatesValues(self):
+ self.query.sortorder = 'a'
+ self.assertEquals(self.query.sortorder, 'a')
+ try:
+ self.query.sortorder = 'illegal input'
+ self.fail()
+ except gdata.calendar.service.Error:
+ self.assertEquals(self.query.sortorder, 'a')
+
+ def testTimezoneParameter(self):
+ self.query.ctz = 'America/Los_Angeles'
+ self.assertEquals(self.query['ctz'], 'America/Los_Angeles')
+ self.assert_(self.query.ToUri().find('America%2FLos_Angeles') > -1)
+
+
+if __name__ == '__main__':
+ print ('Google Calendar Test\nNOTE: Please run these tests only with a '
+ 'test account. The tests may delete or update your data.')
+ username = raw_input('Please enter your username: ')
+ password = getpass.getpass()
+ unittest.main()
diff --git a/tests/gdata_tests/calendar_resource/__init__.py b/tests/gdata_tests/calendar_resource/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/calendar_resource/__init__.py
diff --git a/tests/gdata_tests/calendar_resource/data_test.py b/tests/gdata_tests/calendar_resource/data_test.py
new file mode 100755
index 0000000..0b3a9b8
--- /dev/null
+++ b/tests/gdata_tests/calendar_resource/data_test.py
@@ -0,0 +1,79 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'Vic Fryzel <vf@google.com>'
+
+
+import unittest
+import atom.core
+from gdata import test_data
+import gdata.calendar_resource.data
+import gdata.test_config as conf
+
+
+class CalendarResourceEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.CALENDAR_RESOURCE_ENTRY,
+ gdata.calendar_resource.data.CalendarResourceEntry)
+ self.feed = atom.core.parse(test_data.CALENDAR_RESOURCES_FEED,
+ gdata.calendar_resource.data.CalendarResourceFeed)
+
+ def testCalendarResourceEntryFromString(self):
+ self.assert_(isinstance(self.entry,
+ gdata.calendar_resource.data.CalendarResourceEntry))
+ self.assertEquals(self.entry.resource_id, 'CR-NYC-14-12-BR')
+ self.assertEquals(self.entry.resource_common_name, 'Boardroom')
+ self.assertEquals(self.entry.resource_description,
+ ('This conference room is in New York City, building 14, floor 12, '
+ 'Boardroom'))
+ self.assertEquals(self.entry.resource_type, 'CR')
+
+ def testCalendarResourceFeedFromString(self):
+ self.assertEquals(len(self.feed.entry), 2)
+ self.assert_(isinstance(self.feed,
+ gdata.calendar_resource.data.CalendarResourceFeed))
+ self.assert_(isinstance(self.feed.entry[0],
+ gdata.calendar_resource.data.CalendarResourceEntry))
+ self.assert_(isinstance(self.feed.entry[1],
+ gdata.calendar_resource.data.CalendarResourceEntry))
+ self.assertEquals(
+ self.feed.entry[0].find_edit_link(),
+ 'https://apps-apis.google.com/feeds/calendar/resource/2.0/yourdomain.com/CR-NYC-14-12-BR')
+ self.assertEquals(self.feed.entry[0].resource_id, 'CR-NYC-14-12-BR')
+ self.assertEquals(self.feed.entry[0].resource_common_name, 'Boardroom')
+ self.assertEquals(self.feed.entry[0].resource_description,
+ ('This conference room is in New York City, building 14, floor 12, '
+ 'Boardroom'))
+ self.assertEquals(self.feed.entry[0].resource_type, 'CR')
+ self.assertEquals(self.feed.entry[1].resource_id,
+ '(Bike)-London-43-Lobby-Bike-1')
+ self.assertEquals(self.feed.entry[1].resource_common_name, 'London bike-1')
+ self.assertEquals(self.feed.entry[1].resource_description,
+ 'Bike is in London at building 43\'s lobby.')
+ self.assertEquals(self.feed.entry[1].resource_type, '(Bike)')
+ self.assertEquals(
+ self.feed.entry[1].find_edit_link(),
+ 'https://apps-apis.google.com/a/feeds/calendar/resource/2.0/yourdomain.com/(Bike)-London-43-Lobby-Bike-1')
+
+
+def suite():
+ return conf.build_suite([CalendarResourceEntryTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/calendar_resource/live_client_test.py b/tests/gdata_tests/calendar_resource/live_client_test.py
new file mode 100755
index 0000000..6fd9f8e
--- /dev/null
+++ b/tests/gdata_tests/calendar_resource/live_client_test.py
@@ -0,0 +1,138 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'Vic Fryzel <vf@google.com>'
+
+
+import unittest
+import gdata.client
+import gdata.data
+import gdata.gauth
+import gdata.calendar_resource.client
+import gdata.calendar_resource.data
+import gdata.test_config as conf
+
+
+conf.options.register_option(conf.APPS_DOMAIN_OPTION)
+
+
+class CalendarResourceClientTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.calendar_resource.client.CalendarResourceClient(
+ domain='example.com')
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.calendar_resource.client.CalendarResourceClient(
+ domain=conf.options.get_value('appsdomain'))
+ if conf.options.get_value('ssl') == 'true':
+ self.client.ssl = True
+ conf.configure_client(self.client, 'CalendarResourceClientTest',
+ self.client.auth_service, True)
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def testClientConfiguration(self):
+ self.assertEqual('apps-apis.google.com', self.client.host)
+ self.assertEqual('2.0', self.client.api_version)
+ self.assertEqual('apps', self.client.auth_service)
+ self.assertEqual(gdata.gauth.AUTH_SCOPES['apps'], self.client.auth_scopes)
+ if conf.options.get_value('runlive') == 'true':
+ self.assertEqual(self.client.domain, conf.options.get_value('appsdomain'))
+ else:
+ self.assertEqual(self.client.domain, 'example.com')
+
+ def testMakeResourceFeedUri(self):
+ self.assertEqual('/a/feeds/calendar/resource/2.0/%s/' % self.client.domain,
+ self.client.MakeResourceFeedUri())
+ self.assertEqual('/a/feeds/calendar/resource/2.0/%s/CR-NYC-14-12-BR'
+ % self.client.domain,
+ self.client.MakeResourceFeedUri(resource_id='CR-NYC-14-12-BR'))
+ self.assertEqual('/a/feeds/calendar/resource/2.0/%s/?test=1'
+ % self.client.domain,
+ self.client.MakeResourceFeedUri(params={'test': 1}))
+ self.assertEqual('/a/feeds/calendar/resource/2.0/%s/CR-NYC-14-12-BR?test=1'
+ % self.client.domain,
+ self.client.MakeResourceFeedUri(resource_id='CR-NYC-14-12-BR',
+ params={'test': 1}))
+
+ def testCreateRetrieveUpdateDelete(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testCreateUpdateDelete')
+
+ try:
+ new_entry = self.client.CreateResource(
+ 'CR-NYC-14-12-BR', 'Boardroom',
+ ('This conference room is in New York City, building 14, floor 12, '
+ 'Boardroom'), 'CR')
+ except Exception, e:
+ print e
+ self.client.delete_resource('CR-NYC-14-12-BR')
+ # If the test failed to run to completion
+ # the resource may already exist
+ new_entry = self.client.CreateResource(
+ 'CR-NYC-14-12-BR', 'Boardroom',
+ ('This conference room is in New York City, building 14, floor 12, '
+ 'Boardroom'), 'CR')
+
+ self.assert_(isinstance(new_entry,
+ gdata.calendar_resource.data.CalendarResourceEntry))
+ self.assertEqual(new_entry.resource_id, 'CR-NYC-14-12-BR')
+ self.assertEqual(new_entry.resource_common_name, 'Boardroom')
+ self.assertEqual(new_entry.resource_description,
+ ('This conference room is in New York City, building 14, floor 12, '
+ 'Boardroom'))
+ self.assertEqual(new_entry.resource_type, 'CR')
+
+ fetched_entry = self.client.get_resource(resource_id='CR-NYC-14-12-BR')
+ self.assert_(isinstance(fetched_entry,
+ gdata.calendar_resource.data.CalendarResourceEntry))
+ self.assertEqual(fetched_entry.resource_id, 'CR-NYC-14-12-BR')
+ self.assertEqual(fetched_entry.resource_common_name, 'Boardroom')
+ self.assertEqual(fetched_entry.resource_description,
+ ('This conference room is in New York City, building 14, floor 12, '
+ 'Boardroom'))
+ self.assertEqual(fetched_entry.resource_type, 'CR')
+
+ new_entry.resource_id = 'CR-MTV-14-12-BR'
+ new_entry.resource_common_name = 'Executive Boardroom'
+ new_entry.resource_description = 'This conference room is in Mountain View'
+ new_entry.resource_type = 'BR'
+ updated_entry = self.client.update(new_entry)
+ self.assert_(isinstance(updated_entry,
+ gdata.calendar_resource.data.CalendarResourceEntry))
+ self.assertEqual(updated_entry.resource_id, 'CR-MTV-14-12-BR')
+ self.assertEqual(updated_entry.resource_common_name, 'Executive Boardroom')
+ self.assertEqual(updated_entry.resource_description,
+ 'This conference room is in Mountain View')
+ self.assertEqual(updated_entry.resource_type, 'BR')
+
+ self.client.delete_resource('CR-NYC-14-12-BR')
+
+
+def suite():
+ return conf.build_suite([CalendarResourceClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/calendar_test.py b/tests/gdata_tests/calendar_test.py
new file mode 100755
index 0000000..acb0f34
--- /dev/null
+++ b/tests/gdata_tests/calendar_test.py
@@ -0,0 +1,906 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder@gmail.com (Jeff Scudder)'
+
+
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import atom
+import gdata
+from gdata import test_data
+import gdata.calendar
+
+
+class CalendarFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.calendar_feed = gdata.calendar.CalendarListFeedFromString(
+ test_data.CALENDAR_FEED)
+
+ def testEntryCount(self):
+ # Assert the number of items in the feed of calendars
+ self.assertEquals(len(self.calendar_feed.entry),2)
+
+
+
+ def testToAndFromString(self):
+ # Assert the appropriate type for each entry
+ for an_entry in self.calendar_feed.entry:
+ self.assert_(isinstance(an_entry, gdata.calendar.CalendarListEntry),
+ 'Entry must be an instance of CalendarListEntry')
+
+ # Regenerate feed from xml text
+ new_calendar_feed = (
+ gdata.calendar.CalendarListFeedFromString(str(self.calendar_feed)))
+ for an_entry in new_calendar_feed.entry:
+ self.assert_(isinstance(an_entry, gdata.calendar.CalendarListEntry),
+ 'Entry in regenerated feed must be an instance of CalendarListEntry')
+
+ def testAuthor(self):
+ """Tests the existence of a <atom:author> and verifies the name and email"""
+
+ # Assert that each element in the feed author list is an atom.Author
+ for an_author in self.calendar_feed.author:
+ self.assert_(isinstance(an_author, atom.Author),
+ "Calendar feed <atom:author> element must be an instance of " +
+ "atom.Author: %s" % an_author)
+
+ # Assert the feed author name is as expected
+ self.assertEquals(self.calendar_feed.author[0].name.text, 'GData Ops Demo')
+
+ # Assert the feed author name is as expected
+ self.assertEquals(self.calendar_feed.author[0].email.text,
+ 'gdata.ops.demo@gmail.com')
+
+ # Assert one of the values for an entry author
+ self.assertEquals(self.calendar_feed.entry[0].author[0].name.text,
+ 'GData Ops Demo')
+ self.assertEquals(self.calendar_feed.entry[0].author[0].email.text,
+ 'gdata.ops.demo@gmail.com')
+
+ def testId(self):
+ """Tests the existence of a <atom:id> in the feed and entries
+ and verifies the value"""
+
+ # Assert the feed id exists and is an atom.Id
+ self.assert_(isinstance(self.calendar_feed.id, atom.Id),
+ "Calendar feed <atom:id> element must be an instance of atom.Id: %s" % (
+ self.calendar_feed.id))
+
+ # Assert the feed id value is as expected
+ self.assertEquals(self.calendar_feed.id.text,
+ 'http://www.google.com/calendar/feeds/default')
+
+ # Assert that each entry has an id which is an atom.Id
+ for an_entry in self.calendar_feed.entry:
+ self.assert_(isinstance(an_entry.id, atom.Id),
+ "Calendar entry <atom:id> element must be an instance of " +
+ "atom.Id: %s" % an_entry.id)
+
+ # Assert one of the values for an id
+ self.assertEquals(self.calendar_feed.entry[1].id.text,
+ 'http://www.google.com/calendar/feeds/default/' +
+ 'jnh21ovnjgfph21h32gvms2758%40group.calendar.google.com')
+
+ def testPublished(self):
+ """Tests the existence of a <atom:published> in the entries
+ and verifies the value"""
+
+ # Assert that each entry has a published value which is an atom.Published
+ for an_entry in self.calendar_feed.entry:
+ self.assert_(isinstance(an_entry.published, atom.Published),
+ "Calendar entry <atom:published> element must be an instance of " +
+ "atom.Published: %s" % an_entry.published)
+
+ # Assert one of the values for published is as expected
+ self.assertEquals(self.calendar_feed.entry[1].published.text,
+ '2007-03-20T22:48:57.837Z')
+
+ def testUpdated(self):
+ """Tests the existence of a <atom:updated> in the feed and the entries
+ and verifies the value"""
+
+ # Assert that the feed updated element exists and is an atom.Updated
+ self.assert_(isinstance(self.calendar_feed.updated, atom.Updated),
+ "Calendar feed <atom:updated> element must be an instance of " +
+ "atom.Updated: %s" % self.calendar_feed.updated)
+
+ # Assert that each entry has a updated value which is an atom.Updated
+ for an_entry in self.calendar_feed.entry:
+ self.assert_(isinstance(an_entry.updated, atom.Updated),
+ "Calendar entry <atom:updated> element must be an instance of" +
+ "atom.Updated: %s" % an_entry.updated)
+
+ # Assert the feed updated value is as expected
+ self.assertEquals(self.calendar_feed.updated.text,
+ '2007-03-20T22:48:57.833Z')
+
+ # Assert one of the values for updated
+ self.assertEquals(self.calendar_feed.entry[0].updated.text,
+ '2007-03-20T22:48:52.000Z')
+
+ def testTitle(self):
+ """Tests the existence of a <atom:title> in the feed and the entries and
+ verifies the value"""
+
+ # Assert that the feed title element exists and is an atom.Title
+ self.assert_(isinstance(self.calendar_feed.title, atom.Title),
+ "Calendar feed <atom:title> element must be an instance of " +
+ "atom.Title: %s" % self.calendar_feed.title)
+
+ # Assert that each entry has a title value which is an atom.Title
+ for an_entry in self.calendar_feed.entry:
+ self.assert_(isinstance(an_entry.title, atom.Title),
+ "Calendar entry <atom:title> element must be an instance of " +
+ "atom.Title: %s" % an_entry.title)
+
+ # Assert the feed title value is as expected
+ self.assertEquals(self.calendar_feed.title.text,
+ 'GData Ops Demo\'s Calendar List')
+
+ # Assert one of the values for title
+ self.assertEquals(self.calendar_feed.entry[0].title.text, 'GData Ops Demo')
+
+ def testColor(self):
+ """Tests the existence of a <gCal:color> and verifies the value"""
+
+ # Assert the color is present and is a gdata.calendar.Color
+ for an_entry in self.calendar_feed.entry:
+ self.assert_(isinstance(an_entry.color, gdata.calendar.Color),
+ "Calendar feed <gCal:color> element must be an instance of " +
+ "gdata.calendar.Color: %s" % an_entry.color)
+
+ # Assert the color value is as expected
+ self.assertEquals(self.calendar_feed.entry[0].color.value, '#2952A3')
+
+ def testAccessLevel(self):
+ """Tests the existence of a <gCal:accesslevel> element and verifies the
+ value"""
+
+ # Assert the access_level is present and is a gdata.calendar.AccessLevel
+ for an_entry in self.calendar_feed.entry:
+ self.assert_(isinstance(an_entry.access_level, gdata.calendar.AccessLevel),
+ "Calendar feed <gCal:accesslevel> element must be an instance of " +
+ "gdata.calendar.AccessLevel: %s" % an_entry.access_level)
+
+ # Assert the access_level value is as expected
+ self.assertEquals(self.calendar_feed.entry[0].access_level.value, 'owner')
+
+ def testTimezone(self):
+ """Tests the existence of a <gCal:timezone> element and verifies the
+ value"""
+
+ # Assert the timezone is present and is a gdata.calendar.Timezone
+ for an_entry in self.calendar_feed.entry:
+ self.assert_(isinstance(an_entry.timezone, gdata.calendar.Timezone),
+ "Calendar feed <gCal:timezone> element must be an instance of " +
+ "gdata.calendar.Timezone: %s" % an_entry.timezone)
+
+ # Assert the timezone value is as expected
+ self.assertEquals(self.calendar_feed.entry[0].timezone.value,
+ 'America/Los_Angeles')
+
+ def testHidden(self):
+ """Tests the existence of a <gCal:hidden> element and verifies the
+ value"""
+
+ # Assert the hidden is present and is a gdata.calendar.Hidden
+ for an_entry in self.calendar_feed.entry:
+ self.assert_(isinstance(an_entry.hidden, gdata.calendar.Hidden),
+ "Calendar feed <gCal:hidden> element must be an instance of " +
+ "gdata.calendar.Hidden: %s" % an_entry.hidden)
+
+ # Assert the hidden value is as expected
+ self.assertEquals(self.calendar_feed.entry[0].hidden.value, 'false')
+
+ def testOpenSearch(self):
+ """Tests the existence of <openSearch:startIndex>"""
+ # Assert that the elements exist and are the appropriate type
+ self.assert_(isinstance(self.calendar_feed.start_index, gdata.StartIndex),
+ "Calendar feed <openSearch:startIndex> element must be an " +
+ "instance of gdata.StartIndex: %s" % self.calendar_feed.start_index)
+
+ # Assert the values for each openSearch element are as expected
+ self.assertEquals(self.calendar_feed.start_index.text, '1')
+
+ def testGenerator(self):
+ """Tests the existence of <atom:generator> and verifies the value"""
+
+ # Assert that the element exists and is of the appropriate type
+ self.assert_(isinstance(self.calendar_feed.generator, atom.Generator),
+ "Calendar feed <atom:generator> element must be an instance of " +
+ "atom.Generator: %s" % self.calendar_feed.generator)
+
+ # Assert the generator version, uri and text are as expected
+ self.assertEquals(self.calendar_feed.generator.text, 'Google Calendar')
+ self.assertEquals(self.calendar_feed.generator.version, '1.0')
+ self.assertEquals(self.calendar_feed.generator.uri,
+ 'http://www.google.com/calendar')
+
+ def testEntryLink(self):
+ """Makes sure entry links in the private composite feed are parsed."""
+
+ entry = gdata.calendar.CalendarEventEntryFromString(
+ test_data.RECURRENCE_EXCEPTION_ENTRY)
+
+ self.assert_(isinstance(entry.recurrence_exception, list))
+ self.assert_(isinstance(entry.recurrence_exception[0].entry_link,
+ gdata.EntryLink))
+ self.assert_(isinstance(entry.recurrence_exception[0].entry_link.entry,
+ gdata.calendar.CalendarEventEntry))
+ self.assertEquals(
+ entry.recurrence_exception[0].entry_link.entry.author[0].name.text,
+ 'gdata ops')
+
+ def testSequence(self):
+ entry = gdata.calendar.CalendarEventEntry(
+ sequence=gdata.calendar.Sequence(value='1'))
+ entry2 = gdata.calendar.CalendarEventEntryFromString(str(entry))
+ self.assertEqual(entry.sequence.value, entry2.sequence.value)
+ entry = gdata.calendar.CalendarEventEntryFromString(
+ '<entry xmlns="%s"><sequence xmlns="%s" value="7" /></entry>' % (
+ atom.ATOM_NAMESPACE, gdata.calendar.GCAL_NAMESPACE))
+ self.assertEqual(entry.sequence.value, '7')
+
+ def testOriginalEntry(self):
+ """Make sure original entry in the private composite feed are parsed."""
+
+ entry = gdata.calendar.CalendarEventEntryFromString(
+ test_data.RECURRENCE_EXCEPTION_ENTRY)
+
+ self.assertEquals(
+ entry.recurrence_exception[0].entry_link.entry.original_event.id,
+ 'i7lgfj69mjqjgnodklif3vbm7g')
+
+
+class CalendarFeedTestRegenerated(CalendarFeedTest):
+ def setUp(self):
+ old_calendar_feed = (
+ gdata.calendar.CalendarListFeedFromString(test_data.CALENDAR_FEED))
+ self.calendar_feed = (
+ gdata.calendar.CalendarListFeedFromString(str(old_calendar_feed)))
+ tree = ElementTree.fromstring(str(old_calendar_feed))
+
+
+class CalendarEventFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.calendar_event_feed = (
+ gdata.calendar.CalendarEventFeedFromString(
+ test_data.CALENDAR_FULL_EVENT_FEED))
+
+ def testEntryCount(self):
+ # Assert the number of items in the feed of events
+ self.assertEquals(len(self.calendar_event_feed.entry),11)
+
+ def testToAndFromString(self):
+ # Assert the appropriate type for each entry
+ for an_entry in self.calendar_event_feed.entry:
+ self.assert_(isinstance(an_entry, gdata.calendar.CalendarEventEntry),
+ "Entry must be an instance of a CalendarEventEntry")
+
+ # Regenerate feed from xml text
+ new_calendar_event_feed = gdata.calendar.CalendarEventFeedFromString(
+ str(self.calendar_event_feed))
+ for an_entry in new_calendar_event_feed.entry:
+ self.assert_(isinstance(an_entry, gdata.calendar.CalendarEventEntry),
+ "Entry in regenerated feed must be an instance of CalendarEventEntry")
+
+ def testAuthor(self):
+ """Tests the existence of a <atom:author> and verifies the name and email"""
+
+ # Assert that each element in the feed author list is an atom.Author
+ for an_author in self.calendar_event_feed.author:
+ self.assert_(isinstance(an_author, atom.Author),
+ "Calendar event feed <atom:author> element must be an instance of " +
+ "atom.Author: %s" % an_author)
+
+ # Assert the feed author name is as expected
+ self.assertEquals(self.calendar_event_feed.author[0].name.text,
+ 'GData Ops Demo')
+
+ # Assert the feed author name is as expected
+ self.assertEquals(self.calendar_event_feed.author[0].email.text,
+ 'gdata.ops.demo@gmail.com')
+
+ # Assert one of the values for an entry author
+ self.assertEquals(self.calendar_event_feed.entry[0].author[0].name.text,
+ 'GData Ops Demo')
+ self.assertEquals(self.calendar_event_feed.entry[0].author[0].email.text,
+ 'gdata.ops.demo@gmail.com')
+
+ def testId(self):
+ """Tests the existence of a <atom:id> in the feed and entries and
+ verifies the value"""
+
+ # Assert the feed id exists and is an atom.Id
+ self.assert_(isinstance(self.calendar_event_feed.id, atom.Id),
+ "Calendar event feed <atom:id> element must be an instance of " +
+ "atom.Id: %s" % self.calendar_event_feed.id)
+
+ # Assert the feed id value is as expected
+ self.assertEquals(self.calendar_event_feed.id.text,
+ 'http://www.google.com/calendar/feeds/default/private/full')
+
+ # Assert that each entry has an id which is an atom.Id
+ for an_entry in self.calendar_event_feed.entry:
+ self.assert_(isinstance(an_entry.id, atom.Id),
+ "Calendar event entry <atom:id> element must be an " +
+ "instance of atom.Id: %s" % an_entry.id)
+
+ # Assert one of the values for an id
+ self.assertEquals(self.calendar_event_feed.entry[1].id.text,
+ 'http://www.google.com/calendar/feeds/default/private/full/' +
+ '2qt3ao5hbaq7m9igr5ak9esjo0')
+
+ def testPublished(self):
+ """Tests the existence of a <atom:published> in the entries and
+ verifies the value"""
+
+ # Assert that each entry has a published value which is an atom.Published
+ for an_entry in self.calendar_event_feed.entry:
+ self.assert_(isinstance(an_entry.published, atom.Published),
+ "Calendar event entry <atom:published> element must be an instance " +
+ "of atom.Published: %s" % an_entry.published)
+
+ # Assert one of the values for published is as expected
+ self.assertEquals(self.calendar_event_feed.entry[1].published.text,
+ '2007-03-20T21:26:04.000Z')
+
+ def testUpdated(self):
+ """Tests the existence of a <atom:updated> in the feed and the entries and
+ verifies the value"""
+
+ # Assert that the feed updated element exists and is an atom.Updated
+ self.assert_(isinstance(self.calendar_event_feed.updated, atom.Updated),
+ "Calendar feed <atom:updated> element must be an instance of " +
+ "atom.Updated: %s" % self.calendar_event_feed.updated)
+
+ # Assert that each entry has a updated value which is an atom.Updated
+ for an_entry in self.calendar_event_feed.entry:
+ self.assert_(isinstance(an_entry.updated, atom.Updated),
+ "Calendar event entry <atom:updated> element must be an instance " +
+ "of atom.Updated: %s" % an_entry.updated)
+
+ # Assert the feed updated value is as expected
+ self.assertEquals(self.calendar_event_feed.updated.text,
+ '2007-03-20T21:29:57.000Z')
+
+ # Assert one of the values for updated
+ self.assertEquals(self.calendar_event_feed.entry[3].updated.text,
+ '2007-03-20T21:25:46.000Z')
+
+ def testTitle(self):
+ """Tests the existence of a <atom:title> in the feed and the entries
+ and verifies the value"""
+
+ # Assert that the feed title element exists and is an atom.Title
+ self.assert_(isinstance(self.calendar_event_feed.title, atom.Title),
+ "Calendar feed <atom:title> element must be an instance of " +
+ "atom.Title: %s" % self.calendar_event_feed.title)
+
+ # Assert that each entry has a title value which is an atom.Title
+ for an_entry in self.calendar_event_feed.entry:
+ self.assert_(isinstance(an_entry.title, atom.Title),
+ "Calendar event entry <atom:title> element must be an instance of " +
+ "atom.Title: %s" % an_entry.title)
+
+ # Assert the feed title value is as expected
+ self.assertEquals(self.calendar_event_feed.title.text, 'GData Ops Demo')
+
+ # Assert one of the values for title
+ self.assertEquals(self.calendar_event_feed.entry[0].title.text,
+ 'test deleted')
+
+ def testPostLink(self):
+ """Tests the existence of a <atom:link> with a rel='...#post'
+ and verifies the value"""
+
+ # Assert that each link in the feed is an atom.Link
+ for a_link in self.calendar_event_feed.link:
+ self.assert_(isinstance(a_link, atom.Link),
+ "Calendar event entry <atom:link> element must be an instance of " +
+ "atom.Link: %s" % a_link)
+
+ # Assert post link exists
+ self.assert_(self.calendar_event_feed.GetPostLink() is not None)
+
+ # Assert the post link value is as expected
+ self.assertEquals(self.calendar_event_feed.GetPostLink().href,
+ 'http://www.google.com/calendar/feeds/default/private/full')
+
+ def testEditLink(self):
+ """Tests the existence of a <atom:link> with a rel='edit' in each entry
+ and verifies the value"""
+
+ # Assert that each link in the feed is an atom.Link
+ for a_link in self.calendar_event_feed.link:
+ self.assert_(isinstance(a_link, atom.Link),
+ "Calendar event entry <atom:link> element must be an instance of " +
+ "atom.Link: %s" % a_link)
+
+ # Assert edit link exists
+ for a_entry in self.calendar_event_feed.entry:
+ self.assert_(a_entry.GetEditLink() is not None)
+
+ # Assert the edit link value is as expected
+ self.assertEquals(self.calendar_event_feed.entry[0].GetEditLink().href,
+ 'http://www.google.com/calendar/feeds/default/private/full/o99flmgm' +
+ 'kfkfrr8u745ghr3100/63310109397')
+ self.assertEquals(self.calendar_event_feed.entry[0].GetEditLink().type,
+ 'application/atom+xml')
+
+ def testOpenSearch(self):
+ """Tests the existence of <openSearch:totalResults>,
+ <openSearch:startIndex>, <openSearch:itemsPerPage>"""
+
+ # Assert that the elements exist and are the appropriate type
+ self.assert_(isinstance(self.calendar_event_feed.total_results,
+ gdata.TotalResults),
+ "Calendar event feed <openSearch:totalResults> element must be an " +
+ "instance of gdata.TotalResults: %s" % (
+ self.calendar_event_feed.total_results))
+ self.assert_(
+ isinstance(self.calendar_event_feed.start_index, gdata.StartIndex),
+ "Calendar event feed <openSearch:startIndex> element must be an " +
+ "instance of gdata.StartIndex: %s" % (
+ self.calendar_event_feed.start_index))
+ self.assert_(
+ isinstance(self.calendar_event_feed.items_per_page, gdata.ItemsPerPage),
+ "Calendar event feed <openSearch:itemsPerPage> element must be an " +
+ "instance of gdata.ItemsPerPage: %s" % (
+ self.calendar_event_feed.items_per_page))
+
+ # Assert the values for each openSearch element are as expected
+ self.assertEquals(self.calendar_event_feed.total_results.text, '10')
+ self.assertEquals(self.calendar_event_feed.start_index.text, '1')
+ self.assertEquals(self.calendar_event_feed.items_per_page.text, '25')
+
+ def testGenerator(self):
+ """Tests the existence of <atom:generator> and verifies the value"""
+
+ # Assert that the element exists and is of the appropriate type
+ self.assert_(isinstance(self.calendar_event_feed.generator, atom.Generator),
+ "Calendar event feed <atom:generator> element must be an instance " +
+ "of atom.Generator: %s" % self.calendar_event_feed.generator)
+
+ # Assert the generator version, uri and text are as expected
+ self.assertEquals(self.calendar_event_feed.generator.text,
+ 'Google Calendar')
+ self.assertEquals(self.calendar_event_feed.generator.version, '1.0')
+ self.assertEquals(self.calendar_event_feed.generator.uri,
+ 'http://www.google.com/calendar')
+
+ def testCategory(self):
+ """Tests the existence of <atom:category> and verifies the value"""
+
+ # Assert that the element exists and is of the appropriate type and value
+ for a_category in self.calendar_event_feed.category:
+ self.assert_(isinstance(a_category, atom.Category),
+ "Calendar event feed <atom:category> element must be an instance " +
+ "of atom.Category: %s" % a_category)
+ self.assertEquals(a_category.scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(a_category.term,
+ 'http://schemas.google.com/g/2005#event')
+
+ for an_event in self.calendar_event_feed.entry:
+ for a_category in an_event.category:
+ self.assert_(isinstance(a_category, atom.Category),
+ "Calendar event feed entry <atom:category> element must be an " +
+ "instance of atom.Category: %s" % a_category)
+ self.assertEquals(a_category.scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(a_category.term,
+ 'http://schemas.google.com/g/2005#event')
+
+
+ def testSendEventNotifications(self):
+ """Test the existence of <gCal:sendEventNotifications>
+ and verifies the value"""
+
+ # Assert that the element exists and is of the appropriate type and value
+ for an_event in self.calendar_event_feed.entry:
+ self.assert_(isinstance(an_event.send_event_notifications,
+ gdata.calendar.SendEventNotifications),
+ ("Calendar event feed entry <gCal:sendEventNotifications> element " +
+ "must be an instance of gdata.calendar.SendEventNotifications: %s") % (
+ an_event.send_event_notifications,))
+
+ # Assert the <gCal:sendEventNotifications> are as expected
+ self.assertEquals(
+ self.calendar_event_feed.entry[0].send_event_notifications.value,
+ 'false')
+
+ self.assertEquals(
+ self.calendar_event_feed.entry[2].send_event_notifications.value,
+ 'true')
+
+ def testQuickAdd(self):
+ """Test the existence of <gCal:quickadd>
+ and verifies the value"""
+
+ entry = gdata.calendar.CalendarEventEntry()
+ entry.quick_add = gdata.calendar.QuickAdd(value='true')
+ unmarshalled_entry = entry.ToString()
+ tag = '{%s}quickadd' % (gdata.calendar.GCAL_NAMESPACE)
+ marshalled_entry = ElementTree.fromstring(unmarshalled_entry).find(tag)
+ self.assert_(marshalled_entry.attrib['value'],'true')
+ self.assert_(marshalled_entry.tag,tag)
+
+ def testEventStatus(self):
+ """Test the existence of <gd:eventStatus>
+ and verifies the value"""
+
+ # Assert that the element exists and is of the appropriate type and value
+ for an_event in self.calendar_event_feed.entry:
+ self.assert_(isinstance(an_event.event_status,
+ gdata.calendar.EventStatus),
+ ("Calendar event feed entry <gd:eventStatus> element " +
+ "must be an instance of gdata.calendar.EventStatus: %s") % (
+ an_event.event_status,))
+
+ # Assert the <gd:eventStatus> are as expected
+ self.assertEquals(
+ self.calendar_event_feed.entry[0].event_status.value,
+ 'CANCELED')
+
+ self.assertEquals(
+ self.calendar_event_feed.entry[1].event_status.value,
+ 'CONFIRMED')
+
+ def testComments(self):
+ """Tests the existence of <atom:comments> and verifies the value"""
+
+ # Assert that the element exists and is of the appropriate type and value
+ for an_event in self.calendar_event_feed.entry:
+ self.assert_(an_event.comments is None or isinstance(an_event.comments,
+ gdata.calendar.Comments),
+ ("Calendar event feed entry <gd:comments> element " +
+ "must be an instance of gdata.calendar.Comments: %s") % (
+ an_event.comments,))
+
+ def testVisibility(self):
+ """Test the existence of <gd:visibility> and verifies the value"""
+
+ # Assert that the element exists and is of the appropriate type and value
+ for an_event in self.calendar_event_feed.entry:
+ self.assert_(isinstance(an_event.visibility,
+ gdata.calendar.Visibility),
+ ("Calendar event feed entry <gd:visibility> element " +
+ "must be an instance of gdata.calendar.Visibility: %s") % (
+ an_event.visibility,))
+
+ # Assert the <gd:visibility> are as expected
+ self.assertEquals(
+ self.calendar_event_feed.entry[0].visibility.value,
+ 'DEFAULT')
+
+ self.assertEquals(
+ self.calendar_event_feed.entry[1].visibility.value,
+ 'PRIVATE')
+
+ self.assertEquals(
+ self.calendar_event_feed.entry[2].visibility.value,
+ 'PUBLIC')
+
+ def testTransparency(self):
+ """Test the existence of <gd:transparency> and verifies the value"""
+
+ # Assert that the element exists and is of the appropriate type and value
+ for an_event in self.calendar_event_feed.entry:
+ self.assert_(isinstance(an_event.transparency,
+ gdata.calendar.Transparency),
+ ("Calendar event feed entry <gd:transparency> element " +
+ "must be an instance of gdata.calendar.Transparency: %s") % (
+ an_event.transparency,))
+
+ # Assert the <gd:transparency> are as expected
+ self.assertEquals(
+ self.calendar_event_feed.entry[0].transparency.value,
+ 'OPAQUE')
+
+ self.assertEquals(
+ self.calendar_event_feed.entry[1].transparency.value,
+ 'OPAQUE')
+
+ self.assertEquals(
+ self.calendar_event_feed.entry[2].transparency.value,
+ 'OPAQUE')
+
+ # TODO: TEST VALUES OF VISIBILITY OTHER THAN OPAQUE
+
+ def testWhere(self):
+ """Tests the existence of a <gd:where> in the entries
+ and verifies the value"""
+
+ # Assert that each entry has a where value which is an gdata.calendar.Where
+ for an_entry in self.calendar_event_feed.entry:
+ for a_where in an_entry.where:
+ self.assert_(isinstance(a_where, gdata.calendar.Where),
+ "Calendar event entry <gd:where> element must be an instance of " +
+ "gdata.calendar.Where: %s" % a_where)
+
+ # Assert one of the values for where is as expected
+ self.assertEquals(self.calendar_event_feed.entry[1].where[0].value_string,
+ 'Dolores Park with Kim')
+
+ def testWhenAndReminder(self):
+ """Tests the existence of a <gd:when> and <gd:reminder> in the entries
+ and verifies the values"""
+
+ # Assert that each entry's when value is a gdata.calendar.When
+ # Assert that each reminder is a gdata.calendar.Reminder
+ for an_entry in self.calendar_event_feed.entry:
+ for a_when in an_entry.when:
+ self.assert_(isinstance(a_when, gdata.calendar.When),
+ "Calendar event entry <gd:when> element must be an instance " +
+ "of gdata.calendar.When: %s" % a_when)
+ for a_reminder in a_when.reminder:
+ self.assert_(isinstance(a_reminder, gdata.calendar.Reminder),
+ "Calendar event entry <gd:reminder> element must be an " +
+ "instance of gdata.calendar.Reminder: %s" % a_reminder)
+
+ # Assert one of the values for when is as expected
+ self.assertEquals(self.calendar_event_feed.entry[0].when[0].start_time,
+ '2007-03-23T12:00:00.000-07:00')
+ self.assertEquals(self.calendar_event_feed.entry[0].when[0].end_time,
+ '2007-03-23T13:00:00.000-07:00')
+
+ # Assert the reminder child of when is as expected
+ self.assertEquals(
+ self.calendar_event_feed.entry[0].when[0].reminder[0].minutes, '10')
+ self.assertEquals(
+ self.calendar_event_feed.entry[1].when[0].reminder[0].minutes, '20')
+
+ def testBatchRequestParsing(self):
+ batch_request = gdata.calendar.CalendarEventFeedFromString(
+ test_data.CALENDAR_BATCH_REQUEST)
+ self.assertEquals(len(batch_request.entry), 4)
+ # Iterate over the batch request entries and match the operation with
+ # the batch id. These values are hard coded to match the test data.
+ for entry in batch_request.entry:
+ if entry.batch_id.text == '1':
+ self.assertEquals(entry.batch_operation.type, 'insert')
+ if entry.batch_id.text == '2':
+ self.assertEquals(entry.batch_operation.type, 'query')
+ if entry.batch_id.text == '3':
+ self.assertEquals(entry.batch_operation.type, 'update')
+ self.assertEquals(entry.title.text, 'Event updated via batch')
+ if entry.batch_id.text == '4':
+ self.assertEquals(entry.batch_operation.type, 'delete')
+ self.assertEquals(entry.id.text,
+ 'http://www.google.com/calendar/feeds/default/'
+ 'private/full/d8qbg9egk1n6lhsgq1sjbqffqc')
+ self.assertEquals(entry.GetEditLink().href,
+ 'http://www.google.com/calendar/feeds/default/'
+ 'private/full/d8qbg9egk1n6lhsgq1sjbqffqc/'
+ '63326018324')
+
+ def testBatchResponseParsing(self):
+ batch_response = gdata.calendar.CalendarEventFeedFromString(
+ test_data.CALENDAR_BATCH_RESPONSE)
+ self.assertEquals(len(batch_response.entry), 4)
+ for entry in batch_response.entry:
+ if entry.batch_id.text == '1':
+ self.assertEquals(entry.batch_operation.type, 'insert')
+ self.assertEquals(entry.batch_status.code, '201')
+ self.assertEquals(entry.batch_status.reason, 'Created')
+ self.assertEquals(entry.id.text, 'http://www.google.com/calendar/'
+ 'feeds/default/private/full/'
+ 'n9ug78gd9tv53ppn4hdjvk68ek')
+ if entry.batch_id.text == '2':
+ self.assertEquals(entry.batch_operation.type, 'query')
+ if entry.batch_id.text == '3':
+ self.assertEquals(entry.batch_operation.type, 'update')
+ if entry.batch_id.text == '4':
+ self.assertEquals(entry.batch_operation.type, 'delete')
+ self.assertEquals(entry.id.text, 'http://www.google.com/calendar/'
+ 'feeds/default/private/full/'
+ 'd8qbg9egk1n6lhsgq1sjbqffqc')
+
+ # TODO add reminder tests for absolute_time and hours/seconds (if possible)
+ # TODO test recurrence and recurrenceexception
+ # TODO test originalEvent
+
+class CalendarWebContentTest(unittest.TestCase):
+ def setUp(self):
+ self.calendar_event_feed = (
+ gdata.calendar.CalendarEventFeedFromString(
+ test_data.CALENDAR_FULL_EVENT_FEED))
+
+ def testAddSimpleWebContentEventEntry(self):
+ """Verifies that we can add a web content link to an event entry."""
+
+ title = "Al Einstein's Birthday!"
+ href = 'http://gdata.ops.demo.googlepages.com/birthdayicon.gif'
+ type = 'image/jpeg'
+ url = 'http://gdata.ops.demo.googlepages.com/einstein.jpg'
+ width = '300'
+ height = '225'
+
+ # Create a web content event
+ event = gdata.calendar.CalendarEventEntry()
+ web_content = gdata.calendar.WebContent(url=url, width=width, height=height)
+ web_content_link = gdata.calendar.WebContentLink(title=title,
+ href=href, link_type=type, web_content=web_content)
+ event.link.append(web_content_link)
+
+ # Verify the web content link exists and contains the expected data
+ web_content_link = event.GetWebContentLink()
+ self.assertValidWebContentLink(title, href, type, web_content_link)
+
+ # Verify the web content element exists and contains the expected data
+ web_content_element = web_content_link.web_content
+ self.assertValidSimpleWebContent(url, width, height, web_content_element)
+
+ def testAddWebContentGadgetEventEntry(self):
+ """Verifies that we can add a web content gadget link to an event entry."""
+
+ title = "Date and Time Gadget"
+ href = 'http://gdata.ops.demo.googlepages.com/birthdayicon.gif'
+ url = 'http://google.com/ig/modules/datetime.xml'
+ type = 'application/x-google-gadgets+xml'
+ width = '300'
+ height = '200'
+ pref_name = 'color'
+ pref_value = 'green'
+
+ # Create a web content event
+ event = gdata.calendar.CalendarEventEntry()
+ web_content = gdata.calendar.WebContent(url=url, width=width, height=height)
+ web_content.gadget_pref.append(
+ gdata.calendar.WebContentGadgetPref(name=pref_name, value=pref_value))
+ web_content_link = gdata.calendar.WebContentLink(title=title,
+ href=href, web_content=web_content, link_type=type)
+ event.link.append(web_content_link)
+
+ # Verify the web content link exists and contains the expected data
+ web_content_link = event.GetWebContentLink()
+ self.assertValidWebContentLink(title, href, type, web_content_link)
+
+ # Verify the web content element exists and contains the expected data
+ web_content_element = web_content_link.web_content
+ self.assertValidWebContentGadget(url, width, height,
+ pref_name, pref_value, web_content_element)
+
+ def testFromXmlToSimpleWebContent(self):
+ """Verifies that we can read a web content link from an event entry."""
+
+ # Expected values (from test_data.py file)
+ title = 'World Cup'
+ href = 'http://www.google.com/calendar/images/google-holiday.gif'
+ type = 'image/gif'
+ url = 'http://www.google.com/logos/worldcup06.gif'
+ width = '276'
+ height = '120'
+
+ # Note: The tenth event entry contains web content
+ web_content_event = self.calendar_event_feed.entry[9]
+
+ # Verify the web content link exists and contains the expected data
+ web_content_link = web_content_event.GetWebContentLink()
+ self.assertValidWebContentLink(title, href, type, web_content_link)
+
+ # Verify the web content element exists and contains the expected data
+ web_content_element = web_content_link.web_content
+ self.assertValidSimpleWebContent(url, width, height, web_content_element)
+
+ def testFromXmlToWebContentGadget(self):
+ """Verifies that we can read a web content link from an event entry."""
+
+ # Expected values (from test_data.py file)
+ title = 'Date and Time Gadget'
+ href = 'http://gdata.ops.demo.googlepages.com/birthdayicon.gif'
+ url = 'http://google.com/ig/modules/datetime.xml'
+ type = 'application/x-google-gadgets+xml'
+ width = '300'
+ height = '136'
+ pref_name = 'color'
+ pref_value = 'green'
+
+ # Note: The eleventh event entry contains web content
+ web_content_event = self.calendar_event_feed.entry[10]
+
+ # Verify the web content link exists and contains the expected data
+ web_content_link = web_content_event.GetWebContentLink()
+ self.assertValidWebContentLink(title, href, type, web_content_link)
+
+ # Verify the web content element exists and contains the expected data
+ web_content_element = web_content_link.web_content
+ self.assertValidWebContentGadget(url, width, height, pref_name,
+ pref_value, web_content_element)
+
+ def assertValidWebContentLink(self, expected_title=None, expected_href=None,
+ expected_type=None, web_content_link=None):
+ """Asserts that the web content link is the correct type and contains the
+ expected values"""
+
+ self.assert_(isinstance(web_content_link, gdata.calendar.WebContentLink),
+ "Web content link element must be an " +
+ "instance of gdata.calendar.WebContentLink: %s" % web_content_link)
+ expected_rel = '%s/%s' % (gdata.calendar.GCAL_NAMESPACE, 'webContent')
+ self.assertEquals(expected_rel, web_content_link.rel)
+ self.assertEqual(expected_title, web_content_link.title)
+ self.assertEqual(expected_href, web_content_link.href)
+ self.assertEqual(expected_type, web_content_link.type)
+
+ def assertValidSimpleWebContent(self, expected_url=None, expected_width=None,
+ expected_height=None, web_content_element=None):
+ """Asserts that the web content element is the correct type and contains
+ the expected values"""
+
+ self.assert_(isinstance(web_content_element, gdata.calendar.WebContent),
+ "Calendar event entry <gCal:webContent> element must be an " +
+ "instance of gdata.calendar.WebContent: %s" % web_content_element)
+ self.assertEquals(expected_width, web_content_element.width)
+ self.assertEquals(expected_height, web_content_element.height)
+ self.assertEquals(expected_url, web_content_element.url)
+
+ def assertValidWebContentGadget(self, expected_url=None, expected_width=None,
+ expected_height=None, expected_pref_name=None, expected_pref_value=None,
+ web_content_element=None):
+ """Asserts that the web content element is the correct type and contains
+ the expected values"""
+
+ self.assert_(isinstance(web_content_element, gdata.calendar.WebContent),
+ "Calendar event entry <gCal:webContent> element must be an " +
+ "instance of gdata.calendar.WebContent: %s" % web_content_element)
+ self.assertEquals(expected_width, web_content_element.width)
+ self.assertEquals(expected_height, web_content_element.height)
+ self.assertEquals(expected_url, web_content_element.url)
+ self.assertEquals(expected_pref_name,
+ web_content_element.gadget_pref[0].name)
+ self.assertEquals(expected_pref_value,
+ web_content_element.gadget_pref[0].value)
+
+ def testSampleCode(self):
+ # From http://code.google.com/apis/calendar/gadgets/event/
+ wc = gdata.calendar.WebContent()
+ wc.url = 'http://www.thefreedictionary.com/_/WoD/wod-module.xml'
+ wc.width = '300'
+ wc.height = '136'
+ wc.gadget_pref.append(gdata.calendar.WebContentGadgetPref(name='Days', value='1'))
+ wc.gadget_pref.append(gdata.calendar.WebContentGadgetPref(name='Format', value='0'))
+ wcl = gdata.calendar.WebContentLink()
+ wcl.title = 'Word of the Day'
+ wcl.href = 'http://www.thefreedictionary.com/favicon.ico'
+ wcl.type = 'application/x-google-gadgets+xml'
+ wcl.web_content = wc
+ self.assertEqual(wcl.web_content.url,
+ 'http://www.thefreedictionary.com/_/WoD/wod-module.xml')
+ self.assertEqual(wcl.type, 'application/x-google-gadgets+xml')
+ self.assertEqual(wcl.web_content.height, '136')
+
+
+class ExtendedPropertyTest(unittest.TestCase):
+
+ def testExtendedPropertyToAndFromXml(self):
+ ep = gdata.calendar.ExtendedProperty(name='test')
+ ep.value = 'val'
+ xml_string = ep.ToString()
+ ep2 = gdata.ExtendedPropertyFromString(xml_string)
+ self.assertEquals(ep.name, ep2.name)
+ self.assertEquals(ep.value, ep2.value)
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/client_smoke_test.py b/tests/gdata_tests/client_smoke_test.py
new file mode 100755
index 0000000..31a7e83
--- /dev/null
+++ b/tests/gdata_tests/client_smoke_test.py
@@ -0,0 +1,58 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2010 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import gdata.test_config as conf
+import gdata.analytics.client
+import gdata.apps.emailsettings.client
+import gdata.blogger.client
+import gdata.spreadsheets.client
+import gdata.calendar_resource.client
+import gdata.contacts.client
+import gdata.docs.client
+import gdata.projecthosting.client
+import gdata.sites.client
+
+
+class ClientSmokeTest(unittest.TestCase):
+
+ def test_check_auth_client_classes(self):
+ conf.check_clients_with_auth(self, (
+ gdata.analytics.client.AnalyticsClient,
+ gdata.apps.emailsettings.client.EmailSettingsClient,
+ gdata.blogger.client.BloggerClient,
+ gdata.spreadsheets.client.SpreadsheetsClient,
+ gdata.calendar_resource.client.CalendarResourceClient,
+ gdata.contacts.client.ContactsClient,
+ gdata.docs.client.DocsClient,
+ gdata.projecthosting.client.ProjectHostingClient,
+ gdata.sites.client.SitesClient
+ ))
+
+
+def suite():
+ return conf.build_suite([ClientSmokeTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/client_test.py b/tests/gdata_tests/client_test.py
new file mode 100755
index 0000000..ab63d24
--- /dev/null
+++ b/tests/gdata_tests/client_test.py
@@ -0,0 +1,384 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2008, 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import gdata.client
+import gdata.gauth
+import gdata.data
+import atom.mock_http_core
+import StringIO
+
+
+class ClientLoginTest(unittest.TestCase):
+
+ def test_token_request(self):
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.SettableHttpClient(200, 'OK',
+ 'SID=DQAAAGgA...7Zg8CTN\n'
+ 'LSID=DQAAAGsA...lk8BBbG\n'
+ 'Auth=DQAAAGgA...dk3fA5N', {'Content-Type': 'text/plain'})
+ token = client.request_client_login_token('email', 'pw', 'cp', 'test')
+ self.assert_(isinstance(token, gdata.gauth.ClientLoginToken))
+ self.assertEqual(token.token_string, 'DQAAAGgA...dk3fA5N')
+
+ # Test a server response without a ClientLogin token.`
+ client.http_client.set_response(200, 'OK', 'SID=12345\nLSID=34567', {})
+ self.assertRaises(gdata.client.ClientLoginTokenMissing,
+ client.request_client_login_token, 'email', 'pw', '', '')
+
+ # Test a 302 redirect from the server on a login request.
+ client.http_client.set_response(302, 'ignored', '', {})
+ # TODO: change the exception class to one in gdata.client.
+ self.assertRaises(gdata.client.BadAuthenticationServiceURL,
+ client.request_client_login_token, 'email', 'pw', '', '')
+
+ # Test a CAPTCHA challenge from the server
+ client.http_client.set_response(403, 'Access Forbidden',
+ 'Url=http://www.google.com/login/captcha\n'
+ 'Error=CaptchaRequired\n'
+ 'CaptchaToken=DQAAAGgA...dkI1LK9\n'
+ # TODO: verify this sample CAPTCHA URL matches an
+ # actual challenge from the server.
+ 'CaptchaUrl=Captcha?ctoken=HiteT4bVoP6-yFkHPibe7O9EqxeiI7lUSN', {})
+ try:
+ token = client.request_client_login_token('email', 'pw', '', '')
+ self.fail('should raise a CaptchaChallenge on a 403 with a '
+ 'CaptchRequired error.')
+ except gdata.client.CaptchaChallenge, challenge:
+ self.assertEquals(challenge.captcha_url,
+ 'http://www.google.com/accounts/'
+ 'Captcha?ctoken=HiteT4bVoP6-yFkHPibe7O9EqxeiI7lUSN')
+ self.assertEquals(challenge.captcha_token, 'DQAAAGgA...dkI1LK9')
+
+ # Test an unexpected response, a 404 for example.
+ client.http_client.set_response(404, 'ignored', '', {})
+ self.assertRaises(gdata.client.ClientLoginFailed,
+ client.request_client_login_token, 'email', 'pw', '', '')
+
+ def test_client_login(self):
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.SettableHttpClient(200, 'OK',
+ 'SID=DQAAAGgA...7Zg8CTN\n'
+ 'LSID=DQAAAGsA...lk8BBbG\n'
+ 'Auth=DQAAAGgA...dk3fA5N', {'Content-Type': 'text/plain'})
+ client.client_login('me@example.com', 'password', 'wise', 'unit test')
+ self.assert_(isinstance(client.auth_token, gdata.gauth.ClientLoginToken))
+ self.assertEqual(client.auth_token.token_string, 'DQAAAGgA...dk3fA5N')
+
+
+class AuthSubTest(unittest.TestCase):
+
+ def test_get_and_upgrade_token(self):
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.SettableHttpClient(200, 'OK',
+ 'Token=UpgradedTokenVal\n'
+ 'Extra data', {'Content-Type': 'text/plain'})
+
+ page_url = 'http://example.com/showcalendar.html?token=CKF50YzIHxCTKMAg'
+
+ client.auth_token = gdata.gauth.AuthSubToken.from_url(page_url)
+
+ self.assert_(isinstance(client.auth_token, gdata.gauth.AuthSubToken))
+ self.assertEqual(client.auth_token.token_string, 'CKF50YzIHxCTKMAg')
+
+ upgraded = client.upgrade_token()
+
+ self.assert_(isinstance(client.auth_token, gdata.gauth.AuthSubToken))
+ self.assertEqual(client.auth_token.token_string, 'UpgradedTokenVal')
+ self.assertEqual(client.auth_token, upgraded)
+
+ # Ensure passing in a token returns without modifying client's auth_token.
+ client.http_client.set_response(200, 'OK', 'Token=4567', {})
+ upgraded = client.upgrade_token(
+ gdata.gauth.AuthSubToken.from_url('?token=1234'))
+ self.assertEqual(upgraded.token_string, '4567')
+ self.assertEqual(client.auth_token.token_string, 'UpgradedTokenVal')
+ self.assertNotEqual(client.auth_token, upgraded)
+
+ # Test exception cases
+ client.auth_token = None
+ self.assertRaises(gdata.client.UnableToUpgradeToken, client.upgrade_token,
+ None)
+ self.assertRaises(gdata.client.UnableToUpgradeToken, client.upgrade_token)
+
+ def test_revoke_token(self):
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.SettableHttpClient(
+ 200, 'OK', '', {})
+ page_url = 'http://example.com/showcalendar.html?token=CKF50YzIHxCTKMAg'
+ client.auth_token = gdata.gauth.AuthSubToken.from_url(page_url)
+ deleted = client.revoke_token()
+ self.assert_(deleted)
+ self.assertEqual(
+ client.http_client.last_request.headers['Authorization'],
+ 'AuthSub token=CKF50YzIHxCTKMAg')
+
+
+class OAuthTest(unittest.TestCase):
+
+ def test_hmac_flow(self):
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.SettableHttpClient(
+ 200, 'OK', 'oauth_token=ab3cd9j4ks7&oauth_token_secret=ZXhhbXBsZS',
+ {})
+ request_token = client.get_oauth_token(
+ ['http://example.com/service'], 'http://example.net/myapp',
+ 'consumer', consumer_secret='secret')
+ # Check that the response was correctly parsed.
+ self.assertEqual(request_token.token, 'ab3cd9j4ks7')
+ self.assertEqual(request_token.token_secret, 'ZXhhbXBsZS')
+ self.assertEqual(request_token.auth_state, gdata.gauth.REQUEST_TOKEN)
+
+ # Also check the Authorization header which was sent in the request.
+ auth_header = client.http_client.last_request.headers['Authorization']
+ self.assert_('OAuth' in auth_header)
+ self.assert_(
+ 'oauth_callback="http%3A%2F%2Fexample.net%2Fmyapp"' in auth_header)
+ self.assert_('oauth_version="1.0"' in auth_header)
+ self.assert_('oauth_signature_method="HMAC-SHA1"' in auth_header)
+ self.assert_('oauth_consumer_key="consumer"' in auth_header)
+
+ # Check generation of the authorization URL.
+ authorize_url = request_token.generate_authorization_url()
+ self.assert_(str(authorize_url).startswith(
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'))
+ self.assert_('oauth_token=ab3cd9j4ks7' in str(authorize_url))
+
+ # Check that the token information from the browser's URL is parsed.
+ redirected_url = (
+ 'http://example.net/myapp?oauth_token=CKF5zz&oauth_verifier=Xhhbas')
+ gdata.gauth.authorize_request_token(request_token, redirected_url)
+ self.assertEqual(request_token.token, 'CKF5zz')
+ self.assertEqual(request_token.verifier, 'Xhhbas')
+ self.assertEqual(request_token.auth_state,
+ gdata.gauth.AUTHORIZED_REQUEST_TOKEN)
+
+ # Check that the token upgrade response was correctly parsed.
+ client.http_client.set_response(
+ 200, 'OK', 'oauth_token=3cd9Fj417&oauth_token_secret=Xhrh6bXBs', {})
+ access_token = client.get_access_token(request_token)
+ self.assertEqual(request_token.token, '3cd9Fj417')
+ self.assertEqual(request_token.token_secret, 'Xhrh6bXBs')
+ self.assert_(request_token.verifier is None)
+ self.assertEqual(request_token.auth_state, gdata.gauth.ACCESS_TOKEN)
+ self.assertEqual(request_token.token, access_token.token)
+ self.assertEqual(request_token.token_secret, access_token.token_secret)
+ self.assert_(access_token.verifier is None)
+ self.assertEqual(request_token.auth_state, access_token.auth_state)
+
+ # Also check the Authorization header which was sent in the request.
+ auth_header = client.http_client.last_request.headers['Authorization']
+ self.assert_('OAuth' in auth_header)
+ self.assert_('oauth_callback="' not in auth_header)
+ self.assert_('oauth_version="1.0"' in auth_header)
+ self.assert_('oauth_verifier="Xhhbas"' in auth_header)
+ self.assert_('oauth_signature_method="HMAC-SHA1"' in auth_header)
+ self.assert_('oauth_consumer_key="consumer"' in auth_header)
+
+
+class RequestTest(unittest.TestCase):
+
+ def test_simple_request(self):
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.EchoHttpClient()
+ response = client.request('GET', 'https://example.com/test')
+ self.assertEqual(response.getheader('Echo-Host'), 'example.com:None')
+ self.assertEqual(response.getheader('Echo-Uri'), '/test')
+ self.assertEqual(response.getheader('Echo-Scheme'), 'https')
+ self.assertEqual(response.getheader('Echo-Method'), 'GET')
+
+ http_request = atom.http_core.HttpRequest(
+ uri=atom.http_core.Uri(scheme='http', host='example.net', port=8080),
+ method='POST', headers={'X': 1})
+ http_request.add_body_part('test', 'text/plain')
+ response = client.request(http_request=http_request)
+ self.assertEqual(response.getheader('Echo-Host'), 'example.net:8080')
+ # A Uri with path set to None should default to /.
+ self.assertEqual(response.getheader('Echo-Uri'), '/')
+ self.assertEqual(response.getheader('Echo-Scheme'), 'http')
+ self.assertEqual(response.getheader('Echo-Method'), 'POST')
+ self.assertEqual(response.getheader('Content-Type'), 'text/plain')
+ self.assertEqual(response.getheader('X'), '1')
+ self.assertEqual(response.read(), 'test')
+
+ # Use the same request object from above, but overwrite the request path
+ # by passing in a URI.
+ response = client.request(uri='/new/path?p=1', http_request=http_request)
+ self.assertEqual(response.getheader('Echo-Host'), 'example.net:8080')
+ self.assertEqual(response.getheader('Echo-Uri'), '/new/path?p=1')
+ self.assertEqual(response.getheader('Echo-Scheme'), 'http')
+ self.assertEqual(response.read(), 'test')
+
+ def test_gdata_version_header(self):
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.EchoHttpClient()
+
+ response = client.request('GET', 'http://example.com')
+ self.assertEqual(response.getheader('GData-Version'), None)
+
+ client.api_version = '2'
+ response = client.request('GET', 'http://example.com')
+ self.assertEqual(response.getheader('GData-Version'), '2')
+
+ def test_redirects(self):
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.MockHttpClient()
+ # Add the redirect response for the initial request.
+ first_request = atom.http_core.HttpRequest('http://example.com/1',
+ 'POST')
+ client.http_client.add_response(first_request, 302, None,
+ {'Location': 'http://example.com/1?gsessionid=12'})
+ second_request = atom.http_core.HttpRequest(
+ 'http://example.com/1?gsessionid=12', 'POST')
+ client.http_client.AddResponse(second_request, 200, 'OK', body='Done')
+
+ response = client.Request('POST', 'http://example.com/1')
+ self.assertEqual(response.status, 200)
+ self.assertEqual(response.reason, 'OK')
+ self.assertEqual(response.read(), 'Done')
+
+ redirect_loop_request = atom.http_core.HttpRequest(
+ 'http://example.com/2?gsessionid=loop', 'PUT')
+ client.http_client.add_response(redirect_loop_request, 302, None,
+ {'Location': 'http://example.com/2?gsessionid=loop'})
+ try:
+ response = client.request(method='PUT', uri='http://example.com/2?gsessionid=loop')
+ self.fail('Loop URL should have redirected forever.')
+ except gdata.client.RedirectError, err:
+ self.assert_(str(err).startswith('Too many redirects from server'))
+
+ def test_lowercase_location(self):
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.MockHttpClient()
+ # Add the redirect response for the initial request.
+ first_request = atom.http_core.HttpRequest('http://example.com/1',
+ 'POST')
+ # In some environments, notably App Engine, the HTTP headers which come
+ # back from a server will be normalized to all lowercase.
+ client.http_client.add_response(first_request, 302, None,
+ {'location': 'http://example.com/1?gsessionid=12'})
+ second_request = atom.http_core.HttpRequest(
+ 'http://example.com/1?gsessionid=12', 'POST')
+ client.http_client.AddResponse(second_request, 200, 'OK', body='Done')
+
+ response = client.Request('POST', 'http://example.com/1')
+ self.assertEqual(response.status, 200)
+ self.assertEqual(response.reason, 'OK')
+ self.assertEqual(response.read(), 'Done')
+
+ def test_exercise_exceptions(self):
+ # TODO
+ pass
+
+ def test_converter_vs_desired_class(self):
+
+ def bad_converter(string):
+ return 1
+
+ class TestClass(atom.core.XmlElement):
+ _qname = '{http://www.w3.org/2005/Atom}entry'
+
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.EchoHttpClient()
+ test_entry = gdata.data.GDEntry()
+ result = client.post(test_entry, 'http://example.com')
+ self.assert_(isinstance(result, gdata.data.GDEntry))
+ result = client.post(test_entry, 'http://example.com', converter=bad_converter)
+ self.assertEquals(result, 1)
+ result = client.post(test_entry, 'http://example.com', desired_class=TestClass)
+ self.assert_(isinstance(result, TestClass))
+
+
+class QueryTest(unittest.TestCase):
+
+ def test_query_modifies_request(self):
+ request = atom.http_core.HttpRequest()
+ gdata.client.Query(
+ text_query='foo', categories=['a', 'b']).modify_request(request)
+ # categories param from above is named category in URL
+ self.assertEqual(request.uri.query, {'q': 'foo', 'category': 'a,b'})
+
+ def test_client_uses_query_modification(self):
+ """If the Query is passed as an unexpected param it should apply"""
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.EchoHttpClient()
+ query = gdata.client.Query(max_results=7)
+
+ client.http_client = atom.mock_http_core.SettableHttpClient(
+ 201, 'CREATED', gdata.data.GDEntry().ToString(), {})
+ response = client.get('https://example.com/foo', a_random_param=query)
+ self.assertEqual(
+ client.http_client.last_request.uri.query['max-results'], '7')
+
+
+class VersionConversionTest(unittest.TestCase):
+
+ def test_use_default_version(self):
+ self.assertEquals(gdata.client.get_xml_version(None), 1)
+
+ def test_str_to_int_version(self):
+ self.assertEquals(gdata.client.get_xml_version('1'), 1)
+ self.assertEquals(gdata.client.get_xml_version('2'), 2)
+ self.assertEquals(gdata.client.get_xml_version('2.1.2'), 2)
+ self.assertEquals(gdata.client.get_xml_version('10.4'), 10)
+
+
+class UpdateTest(unittest.TestCase):
+ """Test Update/PUT"""
+
+ def test_update_uri_editlink(self):
+ """Test that the PUT uri is grabbed from the entry's edit link"""
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.SettableHttpClient(
+ 200, 'OK', gdata.data.GDEntry().ToString(), {})
+ entry = gdata.data.GDEntry()
+ entry.link.append(atom.data.Link(rel='edit', href='https://example.com/edit'))
+ response = client.update(entry)
+ request = client.http_client.last_request
+ self.assertEqual(str(client.http_client.last_request.uri),
+ 'https://example.com/edit')
+
+ def test_update_uri(self):
+ """Test that when passed, a uri overrides the entry's edit link"""
+ client = gdata.client.GDClient()
+ client.http_client = atom.mock_http_core.SettableHttpClient(
+ 200, 'OK', gdata.data.GDEntry().ToString(), {})
+ entry = gdata.data.GDEntry()
+ entry.link.append(atom.data.Link(rel='edit', href='https://example.com/edit'))
+ response = client.update(entry, uri='https://example.com/test')
+ self.assertEqual(str(client.http_client.last_request.uri),
+ 'https://example.com/test')
+
+
+def suite():
+ return unittest.TestSuite((unittest.makeSuite(ClientLoginTest, 'test'),
+ unittest.makeSuite(AuthSubTest, 'test'),
+ unittest.makeSuite(OAuthTest, 'test'),
+ unittest.makeSuite(RequestTest, 'test'),
+ unittest.makeSuite(VersionConversionTest, 'test'),
+ unittest.makeSuite(QueryTest, 'test'),
+ unittest.makeSuite(UpdateTest, 'test')))
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/codesearch_test.py b/tests/gdata_tests/codesearch_test.py
new file mode 100755
index 0000000..d881c22
--- /dev/null
+++ b/tests/gdata_tests/codesearch_test.py
@@ -0,0 +1,52 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+
+import unittest
+import gdata.codesearch
+import gdata.test_data
+
+class CodeSearchDataTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.codesearch.CodesearchFeedFromString(
+ gdata.test_data.CODE_SEARCH_FEED)
+
+ def testCorrectXmlConversion(self):
+ self.assert_(self.feed.id.text ==
+ 'http://www.google.com/codesearch/feeds/search?q=malloc')
+ self.assert_(len(self.feed.entry) == 10)
+ for entry in self.feed.entry:
+ if entry.id.text == ('http://www.google.com/codesearch?hl=en&q=+ma'
+ 'lloc+show:LDjwp-Iqc7U:84hEYaYsZk8:xDGReDhvNi0&sa=N&ct=rx&cd=1'
+ '&cs_p=http://www.gnu.org&cs_f=software/autoconf/manual/autoco'
+ 'nf-2.60/autoconf.html-002&cs_p=http://www.gnu.org&cs_f=softwa'
+ 're/autoconf/manual/autoconf-2.60/autoconf.html-002#first'):
+ self.assert_(len(entry.match) == 4)
+ for match in entry.match:
+ if match.line_number == '4':
+ self.assert_(match.type == 'text/html')
+ self.assert_(entry.file.name ==
+ 'software/autoconf/manual/autoconf-2.60/autoconf.html-002')
+ self.assert_(entry.package.name == 'http://www.gnu.org')
+ self.assert_(entry.package.uri == 'http://www.gnu.org')
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/contacts/__init__.py b/tests/gdata_tests/contacts/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/contacts/__init__.py
diff --git a/tests/gdata_tests/contacts/live_client_test.py b/tests/gdata_tests/contacts/live_client_test.py
new file mode 100755
index 0000000..204c345
--- /dev/null
+++ b/tests/gdata_tests/contacts/live_client_test.py
@@ -0,0 +1,122 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import gdata.test_config as conf
+import gdata.contacts.client
+import atom.core
+import atom.data
+import gdata.data
+
+
+class ContactsTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = None
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.contacts.client.ContactsClient()
+ conf.configure_client(self.client, 'ContactsTest', 'cp')
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def test_create_update_delete_contact(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_create_update_delete_contact')
+
+ new_contact = gdata.contacts.data.ContactEntry(
+ nickname=gdata.contacts.data.NickName(text='Joe'),
+ name=gdata.data.Name(
+ given_name=gdata.data.GivenName(text='Joseph'),
+ family_name=gdata.data.FamilyName(text='Testerson')))
+ new_contact.birthday = gdata.contacts.data.Birthday(when='2009-11-11')
+ new_contact.language.append(gdata.contacts.data.Language(
+ label='German'))
+ created = self.client.create_contact(new_contact)
+
+ # Add another language.
+ created.language.append(gdata.contacts.data.Language(
+ label='French'))
+
+ # Create a new membership group for our test contact.
+ new_group = gdata.contacts.data.GroupEntry(
+ title=atom.data.Title(text='a test group'))
+ created_group = self.client.create_group(new_group)
+
+ self.assert_(created_group.id.text)
+
+ # Add the contact to the new group.
+ created.group_membership_info.append(
+ gdata.contacts.data.GroupMembershipInfo(href=created_group.id.text))
+
+ # Upload the changes to the language and group membership.
+ edited = self.client.update(created)
+
+ # Delete the group and the test contact.
+ self.client.delete(created_group)
+ self.client.delete(edited)
+
+ def test_low_level_create_update_delete(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_low_level_create_update_delete')
+ entry = atom.data.Entry()
+ entry.title = atom.data.Title(text='Jeff')
+ entry._other_elements.append(
+ gdata.data.Email(rel=gdata.data.WORK_REL, address='j.s@google.com'))
+
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(entry.to_string(), 'application/atom+xml')
+ posted = self.client.request('POST',
+ 'http://www.google.com/m8/feeds/contacts/default/full',
+ desired_class=atom.data.Entry, http_request=http_request)
+
+ self_link = None
+ edit_link = None
+ for link in posted.get_elements('link', 'http://www.w3.org/2005/Atom'):
+ if link.get_attributes('rel')[0].value == 'self':
+ self_link = link.get_attributes('href')[0].value
+ elif link.get_attributes('rel')[0].value == 'edit':
+ edit_link = link.get_attributes('href')[0].value
+ self.assert_(self_link is not None)
+ self.assert_(edit_link is not None)
+
+ etag = posted.get_attributes('etag')[0].value
+ self.assert_(etag is not None)
+ self.assert_(len(etag) > 0)
+
+ # Delete the test contact.
+ http_request = atom.http_core.HttpRequest()
+ http_request.headers['If-Match'] = etag
+ self.client.request('DELETE', edit_link, http_request=http_request)
+
+def suite():
+ return conf.build_suite([ContactsTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/contacts/profiles/__init__.py b/tests/gdata_tests/contacts/profiles/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/contacts/profiles/__init__.py
diff --git a/tests/gdata_tests/contacts/profiles/live_client_test.py b/tests/gdata_tests/contacts/profiles/live_client_test.py
new file mode 100644
index 0000000..b314b9b
--- /dev/null
+++ b/tests/gdata_tests/contacts/profiles/live_client_test.py
@@ -0,0 +1,95 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'jcgregorio@google.com (Joe Gregorio)'
+
+
+import atom.core
+import atom.data
+import atom.http_core
+import gdata.contacts.client
+import gdata.data
+import gdata.test_config as conf
+import unittest
+
+conf.options.register_option(conf.APPS_DOMAIN_OPTION)
+conf.options.register_option(conf.TARGET_USERNAME_OPTION)
+
+class ProfileTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.contacts.client.ContactsClient(domain='example.com')
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.contacts.client.ContactsClient(
+ domain=conf.options.get_value('appsdomain'))
+ if conf.options.get_value('ssl') == 'true':
+ self.client.ssl = True
+ conf.configure_client(self.client, 'ProfileTest',
+ self.client.auth_service, True)
+ self.client.username = conf.options.get_value('appsusername').split('@')[0]
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def test_profiles_feed(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_profiles_feed')
+
+ feed = self.client.get_profiles_feed()
+ self.assert_(isinstance(feed, gdata.contacts.data.ProfilesFeed))
+
+ def test_profiles_query(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_profiles_feed')
+
+ query = gdata.contacts.client.ProfilesQuery(max_results=1)
+ feed = self.client.get_profiles_feed(q=query)
+ self.assert_(isinstance(feed, gdata.contacts.data.ProfilesFeed))
+ self.assert_(len(feed.entry) == 1)
+
+ # Needs at least 2 profiles in the feed to test the start-key
+ # query param.
+ next = feed.GetNextLink()
+ feed = None
+ if next:
+ # Retrieve the start-key query param from the next link.
+ uri = atom.http_core.Uri.parse_uri(next.href)
+ if 'start-key' in uri.query:
+ query.start_key = uri.query['start-key']
+ feed = self.client.get_profiles_feed(q=query)
+ self.assert_(isinstance(feed, gdata.contacts.data.ProfilesFeed))
+ self.assert_(len(feed.entry) == 1)
+ self.assert_(feed.GetSelfLink().href == next.href)
+ # Compare with a feed retrieved with the next link.
+ next_feed = self.client.get_profiles_feed(uri=next.href)
+ self.assert_(len(next_feed.entry) == 1)
+ self.assert_(next_feed.entry[0].id.text == feed.entry[0].id.text)
+
+def suite():
+ return conf.build_suite([ProfileTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/contacts/profiles/service_test.py b/tests/gdata_tests/contacts/profiles/service_test.py
new file mode 100755
index 0000000..8bbc3d1
--- /dev/null
+++ b/tests/gdata_tests/contacts/profiles/service_test.py
@@ -0,0 +1,130 @@
+#!/usr/bin/env python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Contains Unit Tests for Google Profiles API.
+
+ ProfilesServiceTest: Provides methods to test feeds and manipulate items.
+
+ ProfilesQueryTest: Constructs a query object for the profiles feed.
+ Extends Query.
+"""
+
+__author__ = 'jtoledo (Julian Toledo)'
+
+
+import getopt
+import getpass
+import sys
+import unittest
+import gdata.contacts
+import gdata.contacts.service
+
+
+email = ''
+password = ''
+domain = ''
+server = 'www.google.com'
+
+GDATA_VER_HEADER = 'GData-Version'
+
+class ProfilesServiceTest(unittest.TestCase):
+
+ def setUp(self):
+ additional_headers = {GDATA_VER_HEADER: 3}
+ self.gd_client = gdata.contacts.service.ContactsService(
+ contact_list=domain, additional_headers=additional_headers )
+ self.gd_client.email = email
+ self.gd_client.password = password
+ self.gd_client.source = 'GoogleInc-ProfilesPythonTest-1'
+ self.gd_client.ProgrammaticLogin()
+
+ def testGetFeedUriCustom(self):
+ uri = self.gd_client.GetFeedUri(kind='profiles', scheme='https')
+ self.assertEquals(
+ 'https://%s/m8/feeds/profiles/domain/%s/full' % (server, domain), uri)
+
+ def testGetProfileFeedUriDefault(self):
+ self.gd_client.contact_list = 'domain.com'
+ self.assertEquals('/m8/feeds/profiles/domain/domain.com/full',
+ self.gd_client.GetFeedUri('profiles'))
+
+ def testCleanUriNeedsCleaning(self):
+ self.assertEquals('/relative/uri', self.gd_client._CleanUri(
+ 'http://www.google.com/relative/uri'))
+
+ def testCleanUriDoesNotNeedCleaning(self):
+ self.assertEquals('/relative/uri', self.gd_client._CleanUri(
+ '/relative/uri'))
+
+ def testGetProfilesFeed(self):
+ feed = self.gd_client.GetProfilesFeed()
+ self.assert_(isinstance(feed, gdata.contacts.ProfilesFeed))
+
+ def testGetProfile(self):
+ # Gets an existing entry
+ feed = self.gd_client.GetProfilesFeed()
+ entry = feed.entry[0]
+ self.assert_(isinstance(entry, gdata.contacts.ProfileEntry))
+ self.assertEquals(entry.title.text,
+ self.gd_client.GetProfile(entry.id.text).title.text)
+ self.assertEquals(entry._children,
+ self.gd_client.GetProfile(entry.id.text)._children)
+
+ def testUpdateProfile(self):
+ feed = self.gd_client.GetProfilesFeed()
+ entry = feed.entry[1]
+ original_occupation = entry.occupation
+ entry.occupation = gdata.contacts.Occupation(text='TEST')
+ updated = self.gd_client.UpdateProfile(entry.GetEditLink().href, entry)
+ self.assertEquals('TEST', updated.occupation.text)
+ updated.occupation = original_occupation
+ self.gd_client.UpdateProfile(updated.GetEditLink().href, updated)
+
+
+if __name__ == '__main__':
+
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['user=', 'pw=', 'domain='])
+ except getopt.error, msg:
+ print ('Profiles Tests\nNOTE: Please run these tests only with a test '
+ 'account. The tests may delete or update your data.\n'
+ '\nUsage: service_test.py --email=EMAIL '
+ '--password=PASSWORD --domain=DOMAIN\n')
+ sys.exit(2)
+
+ # Process options
+ for option, arg in opts:
+ if option == '--email':
+ email = arg
+ elif option == '--pw':
+ password = arg
+ elif option == '--domain':
+ domain = arg
+
+ while not email:
+ print 'NOTE: Please run these tests only with a test account.'
+ email = raw_input('Please enter your email: ')
+ while not password:
+ password = getpass.getpass('Please enter password: ')
+ if not password:
+ print 'Password cannot be blank.'
+ while not domain:
+ print 'NOTE: Please run these tests only with a test account.'
+ domain = raw_input('Please enter your Apps domain: ')
+
+ suite = unittest.makeSuite(ProfilesServiceTest)
+ unittest.TextTestRunner().run(suite)
+
diff --git a/tests/gdata_tests/contacts/service_test.py b/tests/gdata_tests/contacts/service_test.py
new file mode 100755
index 0000000..faf617c
--- /dev/null
+++ b/tests/gdata_tests/contacts/service_test.py
@@ -0,0 +1,272 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+import getpass
+import re
+import unittest
+import urllib
+import atom
+import gdata.contacts.service
+import gdata.test_config as conf
+
+
+conf.options.register_option(conf.TEST_IMAGE_LOCATION_OPTION)
+
+
+class ContactsServiceTest(unittest.TestCase):
+
+ def setUp(self):
+ self.gd_client = gdata.contacts.service.ContactsService()
+ conf.configure_service(self.gd_client, 'ContactsServiceTest', 'cp')
+ self.gd_client.email = conf.options.get_value('username')
+
+ def tearDown(self):
+ conf.close_service(self.gd_client)
+
+ def testGetContactsFeed(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_service_cache(self.gd_client, 'testGetContactsFeed')
+ feed = self.gd_client.GetContactsFeed()
+ self.assert_(isinstance(feed, gdata.contacts.ContactsFeed))
+
+ def testDefaultContactList(self):
+ self.assertEquals('default', self.gd_client.contact_list)
+
+ def testCustomContactList(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_service_cache(self.gd_client, 'testCustomContactList')
+
+ self.gd_client.contact_list = conf.options.get_value('username')
+ feed = self.gd_client.GetContactsFeed()
+ self.assert_(isinstance(feed, gdata.contacts.ContactsFeed))
+
+ def testGetFeedUriDefault(self):
+ self.gd_client.contact_list = 'domain.com'
+ self.assertEquals('/m8/feeds/contacts/domain.com/full',
+ self.gd_client.GetFeedUri())
+
+ def testGetFeedUriCustom(self):
+ uri = self.gd_client.GetFeedUri(kind='groups',
+ contact_list='example.com',
+ projection='base/batch',
+ scheme='https')
+ self.assertEquals(
+ 'https://www.google.com/m8/feeds/groups/example.com/base/batch', uri)
+
+ def testCreateUpdateDeleteContactAndUpdatePhoto(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_service_cache(self.gd_client, 'testCreateUpdateDeleteContactAndUpdatePhoto')
+
+ DeleteTestContact(self.gd_client)
+
+ # Create a new entry
+ new_entry = gdata.contacts.ContactEntry()
+ new_entry.title = atom.Title(text='Elizabeth Bennet')
+ new_entry.content = atom.Content(text='Test Notes')
+ new_entry.email.append(gdata.contacts.Email(
+ rel='http://schemas.google.com/g/2005#work',
+ primary='true',
+ address='liz@gmail.com'))
+ new_entry.phone_number.append(gdata.contacts.PhoneNumber(
+ rel='http://schemas.google.com/g/2005#work', text='(206)555-1212'))
+ new_entry.organization = gdata.contacts.Organization(
+ org_name=gdata.contacts.OrgName(text='TestCo.'),
+ rel='http://schemas.google.com/g/2005#work')
+
+ entry = self.gd_client.CreateContact(new_entry)
+
+ # Generate and parse the XML for the new entry.
+ self.assertEquals(entry.title.text, new_entry.title.text)
+ self.assertEquals(entry.content.text, 'Test Notes')
+ self.assertEquals(len(entry.email), 1)
+ self.assertEquals(entry.email[0].rel, new_entry.email[0].rel)
+ self.assertEquals(entry.email[0].address, 'liz@gmail.com')
+ self.assertEquals(len(entry.phone_number), 1)
+ self.assertEquals(entry.phone_number[0].rel,
+ new_entry.phone_number[0].rel)
+ self.assertEquals(entry.phone_number[0].text, '(206)555-1212')
+ self.assertEquals(entry.organization.org_name.text, 'TestCo.')
+
+ # Edit the entry.
+ entry.phone_number[0].text = '(555)555-1212'
+ updated = self.gd_client.UpdateContact(entry.GetEditLink().href, entry)
+ self.assertEquals(updated.content.text, 'Test Notes')
+ self.assertEquals(len(updated.phone_number), 1)
+ self.assertEquals(updated.phone_number[0].rel,
+ entry.phone_number[0].rel)
+ self.assertEquals(updated.phone_number[0].text, '(555)555-1212')
+
+ # Change the contact's photo.
+ updated_photo = self.gd_client.ChangePhoto(
+ conf.options.get_value('imgpath'), updated,
+ content_type='image/jpeg')
+
+ # Refetch the contact so that it has the new photo link
+ updated = self.gd_client.GetContact(updated.GetSelfLink().href)
+ self.assert_(updated.GetPhotoLink() is not None)
+
+ # Fetch the photo data.
+ hosted_image = self.gd_client.GetPhoto(updated)
+ self.assert_(hosted_image is not None)
+
+ # Delete the entry.
+ self.gd_client.DeleteContact(updated.GetEditLink().href)
+
+ def testCreateAndDeleteContactUsingBatch(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_service_cache(self.gd_client, 'testCreateAndDeleteContactUsingBatch')
+
+ # Get random data for creating contact
+ random_contact_number = 'notRandom12'
+ random_contact_title = 'Random Contact %s' % (
+ random_contact_number)
+
+ # Set contact data
+ contact = gdata.contacts.ContactEntry()
+ contact.title = atom.Title(text=random_contact_title)
+ contact.email = gdata.contacts.Email(
+ address='user%s@example.com' % random_contact_number,
+ primary='true',
+ rel=gdata.contacts.REL_WORK)
+ contact.content = atom.Content(text='Contact created by '
+ 'gdata-python-client automated test '
+ 'suite.')
+
+ # Form a batch request
+ batch_request = gdata.contacts.ContactsFeed()
+ batch_request.AddInsert(entry=contact)
+
+ # Execute the batch request to insert the contact.
+ default_batch_url = gdata.contacts.service.DEFAULT_BATCH_URL
+ batch_result = self.gd_client.ExecuteBatch(batch_request,
+ default_batch_url)
+
+ self.assertEquals(len(batch_result.entry), 1)
+ self.assertEquals(batch_result.entry[0].title.text,
+ random_contact_title)
+ self.assertEquals(batch_result.entry[0].batch_operation.type,
+ gdata.BATCH_INSERT)
+ self.assertEquals(batch_result.entry[0].batch_status.code,
+ '201')
+ expected_batch_url = re.compile('default').sub(
+ urllib.quote(self.gd_client.email),
+ gdata.contacts.service.DEFAULT_BATCH_URL)
+ self.failUnless(batch_result.GetBatchLink().href,
+ expected_batch_url)
+
+ # Create a batch request to delete the newly created entry.
+ batch_delete_request = gdata.contacts.ContactsFeed()
+ batch_delete_request.AddDelete(entry=batch_result.entry[0])
+
+ batch_delete_result = self.gd_client.ExecuteBatch(
+ batch_delete_request,
+ batch_result.GetBatchLink().href)
+ self.assertEquals(len(batch_delete_result.entry), 1)
+ self.assertEquals(batch_delete_result.entry[0].batch_operation.type,
+ gdata.BATCH_DELETE)
+ self.assertEquals(batch_result.entry[0].batch_status.code,
+ '201')
+
+ def testCleanUriNeedsCleaning(self):
+ self.assertEquals('/relative/uri', self.gd_client._CleanUri(
+ 'http://www.google.com/relative/uri'))
+
+ def testCleanUriDoesNotNeedCleaning(self):
+ self.assertEquals('/relative/uri', self.gd_client._CleanUri(
+ '/relative/uri'))
+
+
+class ContactsQueryTest(unittest.TestCase):
+
+ def testConvertToStringDefaultFeed(self):
+ query = gdata.contacts.service.ContactsQuery()
+ self.assertEquals(str(query), '/m8/feeds/contacts/default/full')
+ query.max_results = 10
+ self.assertEquals(query.ToUri(),
+ '/m8/feeds/contacts/default/full?max-results=10')
+
+ def testConvertToStringCustomFeed(self):
+ query = gdata.contacts.service.ContactsQuery('/custom/feed/uri')
+ self.assertEquals(str(query), '/custom/feed/uri')
+ query.max_results = '10'
+ self.assertEquals(query.ToUri(), '/custom/feed/uri?max-results=10')
+
+ def testGroupQueryParameter(self):
+ query = gdata.contacts.service.ContactsQuery()
+ query.group = 'http://google.com/m8/feeds/groups/liz%40gmail.com/full/270f'
+ self.assertEquals(query.ToUri(), '/m8/feeds/contacts/default/full'
+ '?group=http%3A%2F%2Fgoogle.com%2Fm8%2Ffeeds%2Fgroups'
+ '%2Fliz%2540gmail.com%2Ffull%2F270f')
+
+
+class ContactsGroupsTest(unittest.TestCase):
+
+ def setUp(self):
+ self.gd_client = gdata.contacts.service.ContactsService()
+ conf.configure_service(self.gd_client, 'ContactsServiceTest', 'cp')
+
+ def tearDown(self):
+ conf.close_service(self.gd_client)
+
+ def testCreateUpdateDeleteGroup(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_service_cache(self.gd_client,
+ 'testCreateUpdateDeleteGroup')
+
+ test_group = gdata.contacts.GroupEntry(title=atom.Title(
+ text='test group py'))
+ new_group = self.gd_client.CreateGroup(test_group)
+ self.assert_(isinstance(new_group, gdata.contacts.GroupEntry))
+ self.assertEquals(new_group.title.text, 'test group py')
+
+ # Change the group's title
+ new_group.title.text = 'new group name py'
+ updated_group = self.gd_client.UpdateGroup(new_group.GetEditLink().href,
+ new_group)
+ self.assertEquals(updated_group.title.text, new_group.title.text)
+
+ # Remove the group
+ self.gd_client.DeleteGroup(updated_group.GetEditLink().href)
+
+
+# Utility methods.
+def DeleteTestContact(client):
+ # Get test contact
+ feed = client.GetContactsFeed()
+ for entry in feed.entry:
+ if (entry.title.text == 'Elizabeth Bennet' and
+ entry.content.text == 'Test Notes' and
+ entry.email[0].address == 'liz@gmail.com'):
+ client.DeleteContact(entry.GetEditLink().href)
+
+
+def suite():
+ return unittest.TestSuite((unittest.makeSuite(ContactsServiceTest, 'test'),
+ unittest.makeSuite(ContactsQueryTest, 'test'),
+ unittest.makeSuite(ContactsGroupsTest, 'test'),))
+
+
+if __name__ == '__main__':
+ print ('Contacts Tests\nNOTE: Please run these tests only with a test '
+ 'account. The tests may delete or update your data.')
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/contacts_test.py b/tests/gdata_tests/contacts_test.py
new file mode 100755
index 0000000..6861178
--- /dev/null
+++ b/tests/gdata_tests/contacts_test.py
@@ -0,0 +1,185 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+
+import unittest
+from gdata import test_data
+import atom
+import gdata.contacts
+
+class ContactEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.contacts.ContactEntryFromString(test_data.NEW_CONTACT)
+
+ def testParsingTestEntry(self):
+ self.assertEquals(self.entry.title.text, 'Fitzgerald')
+ self.assertEquals(len(self.entry.email), 2)
+ for email in self.entry.email:
+ if email.rel == 'http://schemas.google.com/g/2005#work':
+ self.assertEquals(email.address, 'liz@gmail.com')
+ elif email.rel == 'http://schemas.google.com/g/2005#home':
+ self.assertEquals(email.address, 'liz@example.org')
+ self.assertEquals(len(self.entry.phone_number), 3)
+ self.assertEquals(len(self.entry.postal_address), 1)
+ self.assertEquals(self.entry.postal_address[0].primary, 'true')
+ self.assertEquals(self.entry.postal_address[0].text,
+ '1600 Amphitheatre Pkwy Mountain View')
+ self.assertEquals(len(self.entry.im), 1)
+ self.assertEquals(len(self.entry.group_membership_info), 1)
+ self.assertEquals(self.entry.group_membership_info[0].href,
+ 'http://google.com/m8/feeds/groups/liz%40gmail.com/base/270f')
+ self.assertEquals(self.entry.group_membership_info[0].deleted, 'false')
+ self.assertEquals(len(self.entry.extended_property), 2)
+ self.assertEquals(self.entry.extended_property[0].name, 'pet')
+ self.assertEquals(self.entry.extended_property[0].value, 'hamster')
+ self.assertEquals(self.entry.extended_property[1].name, 'cousine')
+ self.assertEquals(
+ self.entry.extended_property[1].GetXmlBlobExtensionElement().tag,
+ 'italian')
+
+ def testToAndFromString(self):
+ copied_entry = gdata.contacts.ContactEntryFromString(str(self.entry))
+ self.assertEquals(copied_entry.title.text, 'Fitzgerald')
+ self.assertEquals(len(copied_entry.email), 2)
+ for email in copied_entry.email:
+ if email.rel == 'http://schemas.google.com/g/2005#work':
+ self.assertEquals(email.address, 'liz@gmail.com')
+ elif email.rel == 'http://schemas.google.com/g/2005#home':
+ self.assertEquals(email.address, 'liz@example.org')
+ self.assertEquals(len(copied_entry.phone_number), 3)
+ self.assertEquals(len(copied_entry.postal_address), 1)
+ self.assertEquals(copied_entry.postal_address[0].primary, 'true')
+ self.assertEquals(copied_entry.postal_address[0].text,
+ '1600 Amphitheatre Pkwy Mountain View')
+ self.assertEquals(len(copied_entry.im), 1)
+ self.assertEquals(len(copied_entry.group_membership_info), 1)
+ self.assertEquals(copied_entry.group_membership_info[0].href,
+ 'http://google.com/m8/feeds/groups/liz%40gmail.com/base/270f')
+ self.assertEquals(copied_entry.group_membership_info[0].deleted, 'false')
+ self.assertEquals(len(copied_entry.extended_property), 2)
+ self.assertEquals(copied_entry.extended_property[0].name, 'pet')
+ self.assertEquals(copied_entry.extended_property[0].value, 'hamster')
+ self.assertEquals(copied_entry.extended_property[1].name, 'cousine')
+ self.assertEquals(
+ copied_entry.extended_property[1].GetXmlBlobExtensionElement().tag,
+ 'italian')
+
+ def testCreateContactFromScratch(self):
+ # Create a new entry
+ new_entry = gdata.contacts.ContactEntry()
+ new_entry.title = atom.Title(text='Elizabeth Bennet')
+ new_entry.content = atom.Content(text='Test Notes')
+ new_entry.email.append(gdata.contacts.Email(
+ rel='http://schemas.google.com/g/2005#work',
+ address='liz@gmail.com'))
+ new_entry.phone_number.append(gdata.contacts.PhoneNumber(
+ rel='http://schemas.google.com/g/2005#work', text='(206)555-1212'))
+ new_entry.organization = gdata.contacts.Organization(
+ org_name=gdata.contacts.OrgName(text='TestCo.'))
+ new_entry.extended_property.append(gdata.ExtendedProperty(name='test',
+ value='1234'))
+ new_entry.birthday = gdata.contacts.Birthday(when='2009-7-23')
+ sports_property = gdata.ExtendedProperty(name='sports')
+ sports_property.SetXmlBlob('<dance><salsa/><ballroom_dancing/></dance>')
+ new_entry.extended_property.append(sports_property)
+
+ # Generate and parse the XML for the new entry.
+ entry_copy = gdata.contacts.ContactEntryFromString(str(new_entry))
+ self.assertEquals(entry_copy.title.text, new_entry.title.text)
+ self.assertEquals(entry_copy.content.text, 'Test Notes')
+ self.assertEquals(len(entry_copy.email), 1)
+ self.assertEquals(entry_copy.email[0].rel, new_entry.email[0].rel)
+ self.assertEquals(entry_copy.email[0].address, 'liz@gmail.com')
+ self.assertEquals(len(entry_copy.phone_number), 1)
+ self.assertEquals(entry_copy.phone_number[0].rel,
+ new_entry.phone_number[0].rel)
+ self.assertEquals(entry_copy.birthday.when, '2009-7-23')
+ self.assertEquals(entry_copy.phone_number[0].text, '(206)555-1212')
+ self.assertEquals(entry_copy.organization.org_name.text, 'TestCo.')
+ self.assertEquals(len(entry_copy.extended_property), 2)
+ self.assertEquals(entry_copy.extended_property[0].name, 'test')
+ self.assertEquals(entry_copy.extended_property[0].value, '1234')
+
+
+class ContactsFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.contacts.ContactsFeedFromString(test_data.CONTACTS_FEED)
+
+ def testParsingTestFeed(self):
+ self.assertEquals(self.feed.id.text,
+ 'http://www.google.com/m8/feeds/contacts/liz%40gmail.com/base')
+ self.assertEquals(self.feed.title.text, 'Contacts')
+ self.assertEquals(self.feed.total_results.text, '1')
+ self.assertEquals(len(self.feed.entry), 1)
+ self.assert_(isinstance(self.feed.entry[0], gdata.contacts.ContactEntry))
+ self.assertEquals(self.feed.entry[0].GetPhotoLink().href,
+ 'http://google.com/m8/feeds/photos/media/liz%40gmail.com/c9012de')
+ self.assertEquals(self.feed.entry[0].GetPhotoEditLink().href,
+ 'http://www.google.com/m8/feeds/photos/media/liz%40gmail.com/'
+ 'c9012de/photo4524')
+
+ def testToAndFromString(self):
+ copied_feed = gdata.contacts.ContactsFeedFromString(str(self.feed))
+ self.assertEquals(copied_feed.id.text,
+ 'http://www.google.com/m8/feeds/contacts/liz%40gmail.com/base')
+ self.assertEquals(copied_feed.title.text, 'Contacts')
+ self.assertEquals(copied_feed.total_results.text, '1')
+ self.assertEquals(len(copied_feed.entry), 1)
+ self.assert_(isinstance(copied_feed.entry[0], gdata.contacts.ContactEntry))
+
+
+class GroupsFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.contacts.GroupsFeedFromString(
+ test_data.CONTACT_GROUPS_FEED)
+
+ def testParsingGroupsFeed(self):
+ self.assertEquals(self.feed.id.text, 'jo@gmail.com')
+ self.assertEquals(self.feed.title.text, 'Jo\'s Contact Groups')
+ self.assertEquals(self.feed.total_results.text, '3')
+ self.assertEquals(len(self.feed.entry), 1)
+ self.assert_(isinstance(self.feed.entry[0], gdata.contacts.GroupEntry))
+
+
+class GroupEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.contacts.GroupEntryFromString(
+ test_data.CONTACT_GROUP_ENTRY)
+
+ def testParsingTestEntry(self):
+ self.assertEquals(self.entry.title.text, 'Salsa group')
+ self.assertEquals(len(self.entry.extended_property), 1)
+ self.assertEquals(self.entry.extended_property[0].name,
+ 'more info about the group')
+ self.assertEquals(
+ self.entry.extended_property[0].GetXmlBlobExtensionElement().namespace,
+ atom.ATOM_NAMESPACE)
+ self.assertEquals(
+ self.entry.extended_property[0].GetXmlBlobExtensionElement().tag,
+ 'info')
+ self.assertEquals(
+ self.entry.extended_property[0].GetXmlBlobExtensionElement().text,
+ 'Very nice people.')
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/contentforshopping_test.py b/tests/gdata_tests/contentforshopping_test.py
new file mode 100644
index 0000000..ceedc33
--- /dev/null
+++ b/tests/gdata_tests/contentforshopping_test.py
@@ -0,0 +1,97 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+"""Content API for Shopping tests"""
+
+
+__author__ = 'afshar (Ali Afshar)'
+
+
+import unittest
+
+
+from gdata.contentforshopping import client, data
+
+
+class CFSClientTest(unittest.TestCase):
+
+ def test_uri_missing_account_id(self):
+ c = client.ContentForShoppingClient()
+ self.assertRaises(ValueError, c._create_uri,
+ account_id=None, projection=None, resource='a/b')
+
+ def test_uri_bad_projection(self):
+ c = client.ContentForShoppingClient()
+ self.assertRaises(ValueError, c._create_uri,
+ account_id='123', projection='banana', resource='a/b')
+
+ def test_good_default_account_id(self):
+ c = client.ContentForShoppingClient(account_id='123')
+ uri = c._create_uri(account_id=None, projection=None, resource='a/b')
+ self.assertEqual(uri,
+ 'https://content.googleapis.com/content/v1/123/a/b/generic')
+
+ def test_override_request_account_id(self):
+ c = client.ContentForShoppingClient(account_id='123')
+ uri = c._create_uri(account_id='321', projection=None, resource='a/b')
+ self.assertEqual(uri,
+ 'https://content.googleapis.com/content/v1/321/a/b/generic')
+
+ def test_default_projection(self):
+ c = client.ContentForShoppingClient(account_id='123')
+ uri = c._create_uri(account_id=None, projection=None, resource='a/b')
+ self.assertEqual(c.cfs_projection, 'generic')
+ self.assertEqual(uri,
+ 'https://content.googleapis.com/content/v1/123/a/b/generic')
+
+ def test_default_projection_change(self):
+ c = client.ContentForShoppingClient(account_id='123', projection='schema')
+ uri = c._create_uri(account_id=None, projection=None, resource='a/b')
+ self.assertEqual(c.cfs_projection, 'schema')
+ self.assertEqual(uri,
+ 'https://content.googleapis.com/content/v1/123/a/b/schema')
+
+ def test_request_projection(self):
+ c = client.ContentForShoppingClient(account_id='123')
+ uri = c._create_uri(account_id=None, projection='schema', resource='a/b')
+ self.assertEqual(c.cfs_projection, 'generic')
+ self.assertEqual(uri,
+ 'https://content.googleapis.com/content/v1/123/a/b/schema')
+
+ def test_request_resource(self):
+ c = client.ContentForShoppingClient(account_id='123')
+ uri = c._create_uri(account_id=None, projection=None, resource='x/y/z')
+ self.assertEqual(uri,
+ 'https://content.googleapis.com/content/v1/123/x/y/z/generic')
+
+ def test_path_single(self):
+ c = client.ContentForShoppingClient(account_id='123')
+ uri = c._create_uri(account_id=None, projection=None, resource='r',
+ path=['1'])
+ self.assertEqual(uri,
+ 'https://content.googleapis.com/content/v1/123/r/generic/1')
+
+ def test_path_multiple(self):
+ c = client.ContentForShoppingClient(account_id='123')
+ uri = c._create_uri(account_id=None, projection=None, resource='r',
+ path=['1', '2'])
+ self.assertEqual(uri,
+ 'https://content.googleapis.com/content/v1/123/r/generic/1/2')
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/core_test.py b/tests/gdata_tests/core_test.py
new file mode 100755
index 0000000..fe02803
--- /dev/null
+++ b/tests/gdata_tests/core_test.py
@@ -0,0 +1,372 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2010 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import gdata.core
+import gdata.test_config as conf
+
+
+
+PLAYLIST_EXAMPLE = (
+ '{"apiVersion": "2.0","data": {"totalResults": 347,"startIndex": 1,"it'
+ 'emsPerPage": 2,"items": [{"id": "4DAEFAF23BB3CDD0","created": "2008-1'
+ '2-09T20:23:06.000Z","updated": "2010-01-04T02:56:19.000Z","author": "'
+ 'GoogleDevelopers","title": "Google Web Toolkit Developers","descripti'
+ 'on": "Developers talk about using Google Web Toolkit ...","tags": ["g'
+ 'oogle","web","toolkit","developers","gwt"],"size": 12},{"id": "586D32'
+ '2B5E2764CF","created": "2007-11-13T19:41:21.000Z","updated": "2010-01'
+ '-04T17:41:16.000Z","author": "GoogleDevelopers","title": "Android","d'
+ 'escription": "Demos and tutorials about the new Android platform.","t'
+ 'ags": ["android","google","developers","mobile"],"size": 32}]}}')
+
+
+VIDEO_EXAMPLE = (
+ '{"apiVersion": "2.0","data": {"updated": "2010-01-07T19:58:42.949Z","'
+ 'totalItems": 800,"startIndex": 1,"itemsPerPage": 1, "items": [{"id": '
+ '"hYB0mn5zh2c","uploaded": "2007-06-05T22:07:03.000Z","updated": "2010'
+ '-01-07T13:26:50.000Z","uploader": "GoogleDeveloperDay","category": "N'
+ 'ews","title": "Google Developers Day US - Maps API Introduction","des'
+ 'cription": "Google Maps API Introduction ...","tags": ["GDD07","GDD07'
+ 'US","Maps"],"thumbnail": {"default": "http://i.ytimg.com/vi/hYB0mn5zh'
+ '2c/default.jpg","hqDefault": "http://i.ytimg.com/vi/hYB0mn5zh2c/hqdef'
+ 'ault.jpg"},"player": {"default": "http://www.youtube.com/watch?v'
+ '\u003dhYB0mn5zh2c"},"content": {"1": "rtsp://v5.cache3.c.youtube.com/'
+ 'CiILENy.../0/0/0/video.3gp","5": "http://www.youtube.com/v/hYB0mn5zh2'
+ 'c?f...","6": "rtsp://v1.cache1.c.youtube.com/CiILENy.../0/0/0/video.3'
+ 'gp"},"duration": 2840,"rating": 4.63,"ratingCount": 68,"viewCount": 2'
+ '20101,"favoriteCount": 201,"commentCount": 22}]}}')
+
+
+class JsoncConversionTest(unittest.TestCase):
+
+ # See http://code.google.com/apis/youtube/2.0/developers_guide_jsonc.html
+ def test_from_and_to_old_json(self):
+ json = ('{"media$group":{"media$credit":[{"$t":"GoogleDevelopers", '
+ '"role":"uploader", "scheme":"urn:youtube"}]}}')
+ jsonc_obj = gdata.core.parse_json(json)
+ self.assert_(isinstance(jsonc_obj, gdata.core.Jsonc))
+ raw = gdata.core._convert_to_object(jsonc_obj)
+ self.assertEqual(raw['media$group']['media$credit'][0]['$t'],
+ 'GoogleDevelopers')
+
+ def test_to_and_from_jsonc(self):
+ x = {'a': 1}
+ jsonc_obj = gdata.core._convert_to_jsonc(x)
+ self.assertEqual(jsonc_obj.a, 1)
+ # Convert the json_obj back to a dict and compare.
+ self.assertEqual(x, gdata.core._convert_to_object(jsonc_obj))
+
+ def test_from_and_to_new_json(self):
+ x = gdata.core.parse_json(PLAYLIST_EXAMPLE)
+ self.assertEqual(x._dict['apiVersion'], '2.0')
+ self.assertEqual(x._dict['data']._dict['items'][0]._dict['id'],
+ '4DAEFAF23BB3CDD0')
+ self.assertEqual(x._dict['data']._dict['items'][1]._dict['id'],
+ '586D322B5E2764CF')
+ x = gdata.core.parse_json(VIDEO_EXAMPLE)
+ self.assertEqual(x._dict['apiVersion'], '2.0')
+ self.assertEqual(x.data._dict['totalItems'], 800)
+ self.assertEqual(x.data.items[0]._dict['viewCount'], 220101)
+
+ def test_pretty_print(self):
+ x = gdata.core.Jsonc(x=1, y=2, z=3)
+ pretty = gdata.core.prettify_jsonc(x)
+ self.assert_(isinstance(pretty, (str, unicode)))
+
+ pretty = gdata.core.prettify_jsonc(x, 4)
+ self.assert_(isinstance(pretty, (str, unicode)))
+
+
+class MemberNameConversionTest(unittest.TestCase):
+
+ def test_member_to_jsonc(self):
+ self.assertEqual(gdata.core._to_jsonc_name(''), '')
+ self.assertEqual(gdata.core._to_jsonc_name('foo'), 'foo')
+ self.assertEqual(gdata.core._to_jsonc_name('Foo'), 'Foo')
+ self.assertEqual(gdata.core._to_jsonc_name('test_x'), 'testX')
+ self.assertEqual(gdata.core._to_jsonc_name('test_x_y_zabc'), 'testXYZabc')
+
+
+def build_test_object():
+ return gdata.core.Jsonc(
+ api_version='2.0',
+ data=gdata.core.Jsonc(
+ total_items=800,
+ items=[
+ gdata.core.Jsonc(
+ view_count=220101,
+ comment_count=22,
+ favorite_count=201,
+ content={
+ '1': ('rtsp://v5.cache3.c.youtube.com'
+ '/CiILENy.../0/0/0/video.3gp')})]))
+
+
+class JsoncObjectTest(unittest.TestCase):
+
+ def check_video_json(self, x):
+ """Validates a JsoncObject similar to VIDEO_EXAMPLE."""
+ self.assert_(isinstance(x._dict, dict))
+ self.assert_(isinstance(x.data, gdata.core.Jsonc))
+ self.assert_(isinstance(x._dict['data'], gdata.core.Jsonc))
+ self.assert_(isinstance(x.data._dict, dict))
+ self.assert_(isinstance(x._dict['data']._dict, dict))
+ self.assert_(isinstance(x._dict['apiVersion'], (str, unicode)))
+ self.assert_(isinstance(x.api_version, (str, unicode)))
+ self.assert_(isinstance(x.data._dict['items'], list))
+ self.assert_(isinstance(x.data.items[0]._dict['commentCount'],
+ (int, long)))
+ self.assert_(isinstance(x.data.items[0].favorite_count, (int, long)))
+ self.assertEqual(x.data.total_items, 800)
+ self.assertEqual(x._dict['data']._dict['totalItems'], 800)
+ self.assertEqual(x.data.items[0].view_count, 220101)
+ self.assertEqual(x._dict['data']._dict['items'][0]._dict['viewCount'],
+ 220101)
+ self.assertEqual(x.data.items[0].comment_count, 22)
+ self.assertEqual(x.data.items[0]._dict['commentCount'], 22)
+ self.assertEqual(x.data.items[0].favorite_count, 201)
+ self.assertEqual(x.data.items[0]._dict['favoriteCount'], 201)
+ self.assertEqual(
+ x.data.items[0].content._dict['1'],
+ 'rtsp://v5.cache3.c.youtube.com/CiILENy.../0/0/0/video.3gp')
+ self.assertEqual(x.api_version, '2.0')
+ self.assertEqual(x.api_version, x._dict['apiVersion'])
+
+ def test_convert_to_jsonc(self):
+ x = gdata.core._convert_to_jsonc(1)
+ self.assert_(isinstance(x, (int, long)))
+ self.assertEqual(x, 1)
+
+ x = gdata.core._convert_to_jsonc([1, 'a'])
+ self.assert_(isinstance(x, list))
+ self.assertEqual(len(x), 2)
+ self.assert_(isinstance(x[0], (int, long)))
+ self.assertEqual(x[0], 1)
+ self.assert_(isinstance(x[1], (str, unicode)))
+ self.assertEqual(x[1], 'a')
+
+ x = gdata.core._convert_to_jsonc([{'b': 1}, 'a'])
+ self.assert_(isinstance(x, list))
+ self.assertEqual(len(x), 2)
+ self.assert_(isinstance(x[0], gdata.core.Jsonc))
+ self.assertEqual(x[0].b, 1)
+
+ def test_non_json_members(self):
+ x = gdata.core.Jsonc(alpha=1, _beta=2, deep={'_bbb': 3, 'aaa': 2})
+ x.test = 'a'
+ x._bar = 'bacon'
+ # Should be able to access the _beta member.
+ self.assertEqual(x._beta, 2)
+ self.assertEqual(getattr(x, '_beta'), 2)
+ try:
+ self.assertEqual(getattr(x.deep, '_bbb'), 3)
+ except AttributeError:
+ pass
+ # There should not be a letter 'B' anywhere in the generated JSON.
+ self.assertEqual(gdata.core.jsonc_to_string(x).find('B'), -1)
+ # We should find a 'b' becuse we don't consider names of dict keys in
+ # the constructor as aliases to camelCase names.
+ self.assert_(not gdata.core.jsonc_to_string(x).find('b') == -1)
+
+ def test_constructor(self):
+ x = gdata.core.Jsonc(a=[{'x': 'y'}, 2])
+ self.assert_(isinstance(x, gdata.core.Jsonc))
+ self.assert_(isinstance(x.a, list))
+ self.assert_(isinstance(x.a[0], gdata.core.Jsonc))
+ self.assertEqual(x.a[0].x, 'y')
+ self.assertEqual(x.a[1], 2)
+
+ def test_read_json(self):
+ x = gdata.core.parse_json(PLAYLIST_EXAMPLE)
+ self.assert_(isinstance(x._dict, dict))
+ self.assertEqual(x._dict['apiVersion'], '2.0')
+ self.assertEqual(x.api_version, '2.0')
+
+ x = gdata.core.parse_json(VIDEO_EXAMPLE)
+ self.assert_(isinstance(x._dict, dict))
+ self.assertEqual(x._dict['apiVersion'], '2.0')
+ self.assertEqual(x.api_version, '2.0')
+
+ x = gdata.core.parse_json(VIDEO_EXAMPLE)
+ self.check_video_json(x)
+
+ def test_write_json(self):
+ x = gdata.core.Jsonc()
+ x._dict['apiVersion'] = '2.0'
+ x.data = {'totalItems': 800}
+ x.data.items = []
+ x.data.items.append(gdata.core.Jsonc(view_count=220101))
+ x.data.items[0]._dict['favoriteCount'] = 201
+ x.data.items[0].comment_count = 22
+ x.data.items[0].content = {
+ '1': 'rtsp://v5.cache3.c.youtube.com/CiILENy.../0/0/0/video.3gp'}
+ self.check_video_json(x)
+
+ def test_build_using_contructor(self):
+ x = build_test_object()
+ self.check_video_json(x)
+
+ def test_to_dict(self):
+ x = build_test_object()
+ self.assertEqual(
+ gdata.core._convert_to_object(x),
+ {'data': {'totalItems': 800, 'items': [
+ {'content': {
+ '1': 'rtsp://v5.cache3.c.youtube.com/CiILENy.../0/0/0/video.3gp'},
+ 'viewCount': 220101, 'commentCount': 22, 'favoriteCount': 201}]},
+ 'apiVersion': '2.0'})
+
+ def test_try_json_syntax(self):
+ x = build_test_object()
+ self.assertEqual(x.data.items[0].commentCount, 22)
+
+ x.data.items[0].commentCount = 33
+ self.assertEqual(x.data.items[0].commentCount, 33)
+ self.assertEqual(x.data.items[0].comment_count, 33)
+ self.assertEqual(x.data.items[0]._dict['commentCount'], 33)
+
+ def test_to_string(self):
+ self.check_video_json(
+ gdata.core.parse_json(
+ gdata.core.jsonc_to_string(
+ gdata.core._convert_to_object(
+ build_test_object()))))
+
+ def test_del_attr(self):
+ x = build_test_object()
+ self.assertEqual(x.data.items[0].commentCount, 22)
+ del x.data.items[0].comment_count
+ try:
+ x.data.items[0].commentCount
+ self.fail('Should not be able to access commentCount after deletion')
+ except AttributeError:
+ pass
+
+ self.assertEqual(x.data.items[0].favorite_count, 201)
+ del x.data.items[0].favorite_count
+ try:
+ x.data.items[0].favorite_count
+ self.fail('Should not be able to access favorite_count after deletion')
+ except AttributeError:
+ pass
+ try:
+ x.data.items[0]._dict['favoriteCount']
+ self.fail('Should not see [\'favoriteCount\'] after deletion')
+ except KeyError:
+ pass
+
+ self.assertEqual(x.data.items[0].view_count, 220101)
+ del x.data.items[0]._dict['viewCount']
+ try:
+ x.data.items[0].view_count
+ self.fail('Should not be able to access view_count after deletion')
+ except AttributeError:
+ pass
+
+ try:
+ del x.data.missing
+ self.fail('Should not delete a missing attribute')
+ except AttributeError:
+ pass
+
+ def test_del_protected_attribute(self):
+ x = gdata.core.Jsonc(public='x', _private='y')
+ self.assertEqual(x.public, 'x')
+ self.assertEqual(x._private, 'y')
+ self.assertEqual(x['public'], 'x')
+ try:
+ x['_private']
+ self.fail('Should not be able to getitem with _name')
+ except KeyError:
+ pass
+
+ del x._private
+ try:
+ x._private
+ self.fail('Should not be able to access deleted member')
+ except AttributeError:
+ pass
+
+ def test_get_set_del_item(self):
+ x = build_test_object()
+
+ # Check for expected members using different access patterns.
+ self.assert_(isinstance(x._dict, dict))
+ self.assert_(isinstance(x['data'], gdata.core.Jsonc))
+ self.assert_(isinstance(x._dict['data'], gdata.core.Jsonc))
+ self.assert_(isinstance(x['data']._dict, dict))
+ self.assert_(isinstance(x._dict['data']._dict, dict))
+ self.assert_(isinstance(x['apiVersion'], (str, unicode)))
+ try:
+ x['api_version']
+ self.fail('Should not find using Python style name')
+ except KeyError:
+ pass
+ self.assert_(isinstance(x.data['items'], list))
+ self.assert_(isinstance(x.data['items'][0]._dict['commentCount'],
+ (int, long)))
+ self.assert_(isinstance(x['data'].items[0]['favoriteCount'], (int, long)))
+ self.assertEqual(x['data'].total_items, 800)
+ self.assertEqual(x['data']['totalItems'], 800)
+ self.assertEqual(x.data['items'][0]['viewCount'], 220101)
+ self.assertEqual(x._dict['data'].items[0]._dict['viewCount'],
+ 220101)
+ self.assertEqual(x['data'].items[0].comment_count, 22)
+ self.assertEqual(x.data.items[0]['commentCount'], 22)
+ self.assertEqual(x.data.items[0]['favoriteCount'], 201)
+ self.assertEqual(x.data.items[0]._dict['favoriteCount'], 201)
+ self.assertEqual(
+ x.data.items[0].content['1'],
+ 'rtsp://v5.cache3.c.youtube.com/CiILENy.../0/0/0/video.3gp')
+ self.assertEqual(
+ x.data.items[0]['content']['1'],
+ 'rtsp://v5.cache3.c.youtube.com/CiILENy.../0/0/0/video.3gp')
+ self.assertEqual(x.api_version, '2.0')
+ self.assertEqual(x['apiVersion'], x._dict['apiVersion'])
+
+ # Set properties using setitem
+ x['apiVersion'] = '3.2'
+ self.assertEqual(x.api_version, '3.2')
+ x.data['totalItems'] = 500
+ self.assertEqual(x['data'].total_items, 500)
+ self.assertEqual(x['data'].items[0].favoriteCount, 201)
+ try:
+ del x['data']['favoriteCount']
+ self.fail('Should not be able to delete missing item')
+ except KeyError:
+ pass
+ del x.data['items'][0]['favoriteCount']
+ try:
+ x['data'].items[0].favoriteCount
+ self.fail('Should not find favoriteCount removed using del item')
+ except AttributeError:
+ pass
+
+
+def suite():
+ return conf.build_suite([JsoncConversionTest, MemberNameConversionTest,
+ JsoncObjectTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/data_smoke_test.py b/tests/gdata_tests/data_smoke_test.py
new file mode 100755
index 0000000..a3fb4be
--- /dev/null
+++ b/tests/gdata_tests/data_smoke_test.py
@@ -0,0 +1,338 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import gdata.test_config as conf
+import gdata.data
+import gdata.acl.data
+import gdata.analytics.data
+import gdata.dublincore.data
+import gdata.books.data
+import gdata.calendar.data
+import gdata.geo.data
+import gdata.finance.data
+import gdata.notebook.data
+import gdata.media.data
+import gdata.youtube.data
+import gdata.webmastertools.data
+import gdata.contacts.data
+import gdata.opensearch.data
+
+
+class DataSmokeTest(unittest.TestCase):
+
+ def test_check_all_data_classes(self):
+ conf.check_data_classes(self, (
+ gdata.data.TotalResults, gdata.data.StartIndex,
+ gdata.data.ItemsPerPage, gdata.data.ExtendedProperty,
+ gdata.data.GDEntry, gdata.data.GDFeed, gdata.data.BatchId,
+ gdata.data.BatchOperation, gdata.data.BatchStatus,
+ gdata.data.BatchEntry, gdata.data.BatchInterrupted,
+ gdata.data.BatchFeed, gdata.data.EntryLink, gdata.data.FeedLink,
+ gdata.data.AdditionalName, gdata.data.Comments, gdata.data.Country,
+ gdata.data.Email, gdata.data.FamilyName, gdata.data.Im,
+ gdata.data.GivenName, gdata.data.NamePrefix, gdata.data.NameSuffix,
+ gdata.data.FullName, gdata.data.Name, gdata.data.OrgDepartment,
+ gdata.data.OrgName, gdata.data.OrgSymbol, gdata.data.OrgTitle,
+ gdata.data.Organization, gdata.data.When, gdata.data.Who,
+ gdata.data.OriginalEvent, gdata.data.PhoneNumber,
+ gdata.data.PostalAddress, gdata.data.Rating, gdata.data.Recurrence,
+ gdata.data.RecurrenceException, gdata.data.Reminder,
+ gdata.data.Agent, gdata.data.HouseName, gdata.data.Street,
+ gdata.data.PoBox, gdata.data.Neighborhood, gdata.data.City,
+ gdata.data.Subregion, gdata.data.Region, gdata.data.Postcode,
+ gdata.data.Country, gdata.data.FormattedAddress,
+ gdata.data.StructuredPostalAddress, gdata.data.Where,
+ gdata.data.AttendeeType, gdata.data.AttendeeStatus,
+ gdata.data.Deleted, gdata.data.Money,
+ gdata.acl.data.AclRole, gdata.acl.data.AclScope,
+ gdata.acl.data.AclWithKey,
+ gdata.acl.data.AclEntry, gdata.acl.data.AclFeed,
+ gdata.analytics.data.Dimension,
+ gdata.analytics.data.EndDate,
+ gdata.analytics.data.Metric,
+ gdata.analytics.data.Aggregates,
+ gdata.analytics.data.DataEntry,
+ gdata.analytics.data.Property,
+ gdata.analytics.data.StartDate,
+ gdata.analytics.data.TableId,
+ gdata.analytics.data.AccountEntry,
+ gdata.analytics.data.TableName,
+ gdata.analytics.data.DataSource,
+ gdata.analytics.data.AccountFeed,
+ gdata.analytics.data.DataFeed,
+ gdata.dublincore.data.Creator,
+ gdata.dublincore.data.Date,
+ gdata.dublincore.data.Description,
+ gdata.dublincore.data.Format,
+ gdata.dublincore.data.Identifier,
+ gdata.dublincore.data.Language,
+ gdata.dublincore.data.Publisher,
+ gdata.dublincore.data.Rights,
+ gdata.dublincore.data.Subject,
+ gdata.dublincore.data.Title,
+ gdata.books.data.CollectionEntry,
+ gdata.books.data.CollectionFeed,
+ gdata.books.data.Embeddability,
+ gdata.books.data.OpenAccess,
+ gdata.books.data.Review,
+ gdata.books.data.Viewability,
+ gdata.books.data.VolumeEntry,
+ gdata.books.data.VolumeFeed,
+ gdata.calendar.data.AccessLevelProperty,
+ gdata.calendar.data.AllowGSync2Property,
+ gdata.calendar.data.AllowGSyncProperty,
+ gdata.calendar.data.AnyoneCanAddSelfProperty,
+ gdata.calendar.data.CalendarAclRole,
+ gdata.calendar.data.CalendarCommentEntry,
+ gdata.calendar.data.CalendarCommentFeed,
+ gdata.calendar.data.CalendarComments,
+ gdata.calendar.data.CalendarExtendedProperty,
+ gdata.calendar.data.CalendarWhere,
+ gdata.calendar.data.ColorProperty,
+ gdata.calendar.data.GuestsCanInviteOthersProperty,
+ gdata.calendar.data.GuestsCanModifyProperty,
+ gdata.calendar.data.GuestsCanSeeGuestsProperty,
+ gdata.calendar.data.HiddenProperty,
+ gdata.calendar.data.IcalUIDProperty,
+ gdata.calendar.data.OverrideNameProperty,
+ gdata.calendar.data.PrivateCopyProperty,
+ gdata.calendar.data.QuickAddProperty,
+ gdata.calendar.data.ResourceProperty,
+ gdata.calendar.data.EventWho,
+ gdata.calendar.data.SelectedProperty,
+ gdata.calendar.data.SendAclNotificationsProperty,
+ gdata.calendar.data.CalendarAclEntry,
+ gdata.calendar.data.CalendarAclFeed,
+ gdata.calendar.data.SendEventNotificationsProperty,
+ gdata.calendar.data.SequenceNumberProperty,
+ gdata.calendar.data.CalendarRecurrenceExceptionEntry,
+ gdata.calendar.data.CalendarRecurrenceException,
+ gdata.calendar.data.SettingsProperty,
+ gdata.calendar.data.SettingsEntry,
+ gdata.calendar.data.CalendarSettingsFeed,
+ gdata.calendar.data.SuppressReplyNotificationsProperty,
+ gdata.calendar.data.SyncEventProperty,
+ gdata.calendar.data.CalendarEventEntry,
+ gdata.calendar.data.TimeZoneProperty,
+ gdata.calendar.data.TimesCleanedProperty,
+ gdata.calendar.data.CalendarEntry,
+ gdata.calendar.data.CalendarEventFeed,
+ gdata.calendar.data.CalendarFeed,
+ gdata.calendar.data.WebContentGadgetPref,
+ gdata.calendar.data.WebContent,
+ gdata.finance.data.Commission,
+ gdata.finance.data.CostBasis,
+ gdata.finance.data.DaysGain,
+ gdata.finance.data.Gain,
+ gdata.finance.data.MarketValue,
+ gdata.finance.data.PortfolioData,
+ gdata.finance.data.PortfolioEntry,
+ gdata.finance.data.PortfolioFeed,
+ gdata.finance.data.PositionData,
+ gdata.finance.data.Price,
+ gdata.finance.data.Symbol,
+ gdata.finance.data.PositionEntry,
+ gdata.finance.data.PositionFeed,
+ gdata.finance.data.TransactionData,
+ gdata.finance.data.TransactionEntry,
+ gdata.finance.data.TransactionFeed,
+ gdata.notebook.data.ComesAfter,
+ gdata.notebook.data.NoteEntry,
+ gdata.notebook.data.NotebookFeed,
+ gdata.notebook.data.NotebookListEntry,
+ gdata.notebook.data.NotebookListFeed,
+ gdata.youtube.data.ComplaintEntry,
+ gdata.youtube.data.ComplaintFeed,
+ gdata.youtube.data.RatingEntry,
+ gdata.youtube.data.RatingFeed,
+ gdata.youtube.data.YouTubeMediaContent,
+ gdata.youtube.data.YtAge,
+ gdata.youtube.data.YtBooks,
+ gdata.youtube.data.YtCompany,
+ gdata.youtube.data.YtDescription,
+ gdata.youtube.data.YtDuration,
+ gdata.youtube.data.YtFirstName,
+ gdata.youtube.data.YtGender,
+ gdata.youtube.data.YtHobbies,
+ gdata.youtube.data.YtHometown,
+ gdata.youtube.data.YtLastName,
+ gdata.youtube.data.YtLocation,
+ gdata.youtube.data.YtMovies,
+ gdata.youtube.data.YtMusic,
+ gdata.youtube.data.YtNoEmbed,
+ gdata.youtube.data.YtOccupation,
+ gdata.youtube.data.YtPlaylistId,
+ gdata.youtube.data.YtPosition,
+ gdata.youtube.data.YtPrivate,
+ gdata.youtube.data.YtQueryString,
+ gdata.youtube.data.YtRacy,
+ gdata.youtube.data.YtRecorded,
+ gdata.youtube.data.YtRelationship,
+ gdata.youtube.data.YtSchool,
+ gdata.youtube.data.YtStatistics,
+ gdata.youtube.data.YtStatus,
+ gdata.youtube.data.YtUserProfileStatistics,
+ gdata.youtube.data.YtUsername,
+ gdata.youtube.data.FriendEntry,
+ gdata.youtube.data.FriendFeed,
+ gdata.youtube.data.YtVideoStatistics,
+ gdata.youtube.data.ChannelEntry,
+ gdata.youtube.data.ChannelFeed,
+ gdata.youtube.data.FavoriteEntry,
+ gdata.youtube.data.FavoriteFeed,
+ gdata.youtube.data.YouTubeMediaCredit,
+ gdata.youtube.data.YouTubeMediaRating,
+ gdata.youtube.data.YtAboutMe,
+ gdata.youtube.data.UserProfileEntry,
+ gdata.youtube.data.UserProfileFeed,
+ gdata.youtube.data.YtAspectRatio,
+ gdata.youtube.data.YtBasePublicationState,
+ gdata.youtube.data.YtPublicationState,
+ gdata.youtube.data.YouTubeAppControl,
+ gdata.youtube.data.YtCaptionPublicationState,
+ gdata.youtube.data.YouTubeCaptionAppControl,
+ gdata.youtube.data.CaptionTrackEntry,
+ gdata.youtube.data.CaptionTrackFeed,
+ gdata.youtube.data.YtCountHint,
+ gdata.youtube.data.PlaylistLinkEntry,
+ gdata.youtube.data.PlaylistLinkFeed,
+ gdata.youtube.data.YtModerationStatus,
+ gdata.youtube.data.YtPlaylistTitle,
+ gdata.youtube.data.SubscriptionEntry,
+ gdata.youtube.data.SubscriptionFeed,
+ gdata.youtube.data.YtSpam,
+ gdata.youtube.data.CommentEntry,
+ gdata.youtube.data.CommentFeed,
+ gdata.youtube.data.YtUploaded,
+ gdata.youtube.data.YtVideoId,
+ gdata.youtube.data.YouTubeMediaGroup,
+ gdata.youtube.data.VideoEntryBase,
+ gdata.youtube.data.PlaylistEntry,
+ gdata.youtube.data.PlaylistFeed,
+ gdata.youtube.data.VideoEntry,
+ gdata.youtube.data.VideoFeed,
+ gdata.youtube.data.VideoMessageEntry,
+ gdata.youtube.data.VideoMessageFeed,
+ gdata.youtube.data.UserEventEntry,
+ gdata.youtube.data.UserEventFeed,
+ gdata.youtube.data.VideoModerationEntry,
+ gdata.youtube.data.VideoModerationFeed,
+ gdata.media.data.MediaCategory,
+ gdata.media.data.MediaCopyright,
+ gdata.media.data.MediaCredit,
+ gdata.media.data.MediaDescription,
+ gdata.media.data.MediaHash,
+ gdata.media.data.MediaKeywords,
+ gdata.media.data.MediaPlayer,
+ gdata.media.data.MediaRating,
+ gdata.media.data.MediaRestriction,
+ gdata.media.data.MediaText,
+ gdata.media.data.MediaThumbnail,
+ gdata.media.data.MediaTitle,
+ gdata.media.data.MediaContent,
+ gdata.media.data.MediaGroup,
+ gdata.webmastertools.data.CrawlIssueCrawlType,
+ gdata.webmastertools.data.CrawlIssueDateDetected,
+ gdata.webmastertools.data.CrawlIssueDetail,
+ gdata.webmastertools.data.CrawlIssueIssueType,
+ gdata.webmastertools.data.CrawlIssueLinkedFromUrl,
+ gdata.webmastertools.data.CrawlIssueUrl,
+ gdata.webmastertools.data.CrawlIssueEntry,
+ gdata.webmastertools.data.CrawlIssuesFeed,
+ gdata.webmastertools.data.Indexed,
+ gdata.webmastertools.data.Keyword,
+ gdata.webmastertools.data.KeywordEntry,
+ gdata.webmastertools.data.KeywordsFeed,
+ gdata.webmastertools.data.LastCrawled,
+ gdata.webmastertools.data.MessageBody,
+ gdata.webmastertools.data.MessageDate,
+ gdata.webmastertools.data.MessageLanguage,
+ gdata.webmastertools.data.MessageRead,
+ gdata.webmastertools.data.MessageSubject,
+ gdata.webmastertools.data.SiteId,
+ gdata.webmastertools.data.MessageEntry,
+ gdata.webmastertools.data.MessagesFeed,
+ gdata.webmastertools.data.SitemapEntry,
+ gdata.webmastertools.data.SitemapMobileMarkupLanguage,
+ gdata.webmastertools.data.SitemapMobile,
+ gdata.webmastertools.data.SitemapNewsPublicationLabel,
+ gdata.webmastertools.data.SitemapNews,
+ gdata.webmastertools.data.SitemapType,
+ gdata.webmastertools.data.SitemapUrlCount,
+ gdata.webmastertools.data.SitemapsFeed,
+ gdata.webmastertools.data.VerificationMethod,
+ gdata.webmastertools.data.Verified,
+ gdata.webmastertools.data.SiteEntry,
+ gdata.webmastertools.data.SitesFeed,
+ gdata.contacts.data.BillingInformation,
+ gdata.contacts.data.Birthday,
+ gdata.contacts.data.CalendarLink,
+ gdata.contacts.data.DirectoryServer,
+ gdata.contacts.data.Event,
+ gdata.contacts.data.ExternalId,
+ gdata.contacts.data.Gender,
+ gdata.contacts.data.Hobby,
+ gdata.contacts.data.Initials,
+ gdata.contacts.data.Jot,
+ gdata.contacts.data.Language,
+ gdata.contacts.data.MaidenName,
+ gdata.contacts.data.Mileage,
+ gdata.contacts.data.NickName,
+ gdata.contacts.data.Occupation,
+ gdata.contacts.data.Priority,
+ gdata.contacts.data.Relation,
+ gdata.contacts.data.Sensitivity,
+ gdata.contacts.data.UserDefinedField,
+ gdata.contacts.data.Website,
+ gdata.contacts.data.HouseName,
+ gdata.contacts.data.Street,
+ gdata.contacts.data.POBox,
+ gdata.contacts.data.Neighborhood,
+ gdata.contacts.data.City,
+ gdata.contacts.data.SubRegion,
+ gdata.contacts.data.Region,
+ gdata.contacts.data.PostalCode,
+ gdata.contacts.data.Country,
+ gdata.contacts.data.PersonEntry,
+ gdata.contacts.data.Deleted,
+ gdata.contacts.data.GroupMembershipInfo,
+ gdata.contacts.data.ContactEntry,
+ gdata.contacts.data.ContactsFeed,
+ gdata.contacts.data.SystemGroup,
+ gdata.contacts.data.GroupEntry,
+ gdata.contacts.data.GroupsFeed,
+ gdata.contacts.data.ProfileEntry,
+ gdata.contacts.data.ProfilesFeed,
+ gdata.opensearch.data.ItemsPerPage,
+ gdata.opensearch.data.StartIndex,
+ gdata.opensearch.data.TotalResults,
+ ))
+
+
+def suite():
+ return conf.build_suite([DataSmokeTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/data_test.py b/tests/gdata_tests/data_test.py
new file mode 100755
index 0000000..e1a275e
--- /dev/null
+++ b/tests/gdata_tests/data_test.py
@@ -0,0 +1,523 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import gdata.data
+from gdata import test_data
+import gdata.test_config as conf
+import atom.core
+import atom.data
+
+
+SIMPLE_V2_FEED_TEST_DATA = """<feed xmlns='http://www.w3.org/2005/Atom'
+ xmlns:gd='http://schemas.google.com/g/2005'
+ gd:etag='W/"CUMBRHo_fip7ImA9WxRbGU0."'>
+ <title>Elizabeth Bennet's Contacts</title>
+ <link rel='next' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/.../more' />
+ <entry gd:etag='"Qn04eTVSLyp7ImA9WxRbGEUORAQ."'>
+ <id>http://www.google.com/m8/feeds/contacts/liz%40gmail.com/base/c9e</id>
+ <title>Fitzwilliam</title>
+ <link rel='http://schemas.google.com/contacts/2008/rel#photo'
+ type='image/*'
+ href='http://www.google.com/m8/feeds/photos/media/liz%40gmail.com/c9e'
+ gd:etag='"KTlcZWs1bCp7ImBBPV43VUV4LXEZCXERZAc."' />
+ <link rel='self' type='application/atom+xml'
+ href='Changed to ensure we are really getting the edit URL.'/>
+ <link rel='edit' type='application/atom+xml'
+ href='http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/c9e'/>
+ </entry>
+ <entry gd:etag='"123456"'>
+ <link rel='edit' href='http://example.com/1' />
+ </entry>
+</feed>"""
+
+
+XML_ENTRY_1 = """<?xml version='1.0'?>
+ <entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:g='http://base.google.com/ns/1.0'>
+ <category scheme="http://base.google.com/categories/itemtypes"
+ term="products"/>
+ <id> http://www.google.com/test/id/url </id>
+ <title type='text'>Testing 2000 series laptop</title>
+ <content type='xhtml'>
+ <div xmlns='http://www.w3.org/1999/xhtml'>A Testing Laptop</div>
+ </content>
+ <link rel='alternate' type='text/html'
+ href='http://www.provider-host.com/123456789'/>
+ <link rel='license'
+ href='http://creativecommons.org/licenses/by-nc/2.5/rdf'/>
+ <g:label>Computer</g:label>
+ <g:label>Laptop</g:label>
+ <g:label>testing laptop</g:label>
+ <g:item_type>products</g:item_type>
+ </entry>"""
+
+
+def parse(xml_string, target_class):
+ """Convenience wrapper for converting an XML string to an XmlElement."""
+ return atom.core.xml_element_from_string(xml_string, target_class)
+
+
+class StartIndexTest(unittest.TestCase):
+
+ def setUp(self):
+ self.start_index = gdata.data.StartIndex()
+
+ def testToAndFromString(self):
+ self.start_index.text = '1'
+ self.assert_(self.start_index.text == '1')
+ new_start_index = parse(self.start_index.ToString(),
+ gdata.data.StartIndex)
+ self.assert_(self.start_index.text == new_start_index.text)
+
+
+class ItemsPerPageTest(unittest.TestCase):
+
+ def setUp(self):
+ self.items_per_page = gdata.data.ItemsPerPage()
+
+ def testToAndFromString(self):
+ self.items_per_page.text = '10'
+ self.assert_(self.items_per_page.text == '10')
+ new_items_per_page = parse(self.items_per_page.ToString(),
+ gdata.data.ItemsPerPage)
+ self.assert_(self.items_per_page.text == new_items_per_page.text)
+
+
+class GDataEntryTest(unittest.TestCase):
+
+ def testIdShouldBeCleaned(self):
+ entry = parse(XML_ENTRY_1, gdata.data.GDEntry)
+ tree = parse(XML_ENTRY_1, atom.core.XmlElement)
+ self.assert_(tree.get_elements('id',
+ 'http://www.w3.org/2005/Atom')[0].text != entry.get_id())
+ self.assertEqual(entry.get_id(), 'http://www.google.com/test/id/url')
+
+ def testGeneratorShouldBeCleaned(self):
+ feed = parse(test_data.GBASE_FEED, gdata.data.GDFeed)
+ tree = parse(test_data.GBASE_FEED, atom.core.XmlElement)
+ self.assert_(tree.get_elements('generator',
+ 'http://www.w3.org/2005/Atom')[0].text != feed.get_generator())
+ self.assertEqual(feed.get_generator(), 'GoogleBase')
+
+ def testAllowsEmptyId(self):
+ entry = gdata.data.GDEntry()
+ try:
+ entry.id = atom.data.Id()
+ except AttributeError:
+ self.fail('Empty id should not raise an attribute error.')
+
+class LinkFinderTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = parse(XML_ENTRY_1, gdata.data.GDEntry)
+
+ def testLinkFinderGetsLicenseLink(self):
+ self.assertEquals(isinstance(self.entry.FindLicenseLink(), str),
+ True)
+ self.assertEquals(self.entry.FindLicenseLink(),
+ 'http://creativecommons.org/licenses/by-nc/2.5/rdf')
+
+ def testLinkFinderGetsAlternateLink(self):
+ self.assert_(isinstance(self.entry.FindAlternateLink(), str))
+ self.assertEquals(self.entry.FindAlternateLink(),
+ 'http://www.provider-host.com/123456789')
+
+ def testFindAclLink(self):
+ entry = gdata.data.GDEntry()
+ self.assert_(entry.get_acl_link() is None)
+ self.assert_(entry.find_acl_link() is None)
+
+ entry.link.append(atom.data.Link(
+ rel=gdata.data.ACL_REL, href='http://example.com/acl'))
+ self.assertEqual(entry.get_acl_link().href, 'http://example.com/acl')
+ self.assertEqual(entry.find_acl_link(), 'http://example.com/acl')
+
+ del entry.link[0]
+ self.assert_(entry.get_acl_link() is None)
+ self.assert_(entry.find_acl_link() is None)
+
+ # We should also find an ACL link which is a feed_link.
+ entry.feed_link = [gdata.data.FeedLink(
+ rel=gdata.data.ACL_REL, href='http://example.com/acl2')]
+ self.assertEqual(entry.get_acl_link().href, 'http://example.com/acl2')
+ self.assertEqual(entry.find_acl_link(), 'http://example.com/acl2')
+
+
+class GDataFeedTest(unittest.TestCase):
+
+ def testCorrectConversionToElementTree(self):
+ test_feed = parse(test_data.GBASE_FEED, gdata.data.GDFeed)
+ self.assert_(test_feed.total_results is not None)
+ self.assert_(test_feed.get_elements('totalResults',
+ 'http://a9.com/-/spec/opensearchrss/1.0/') is not None)
+ self.assert_(len(test_feed.get_elements('totalResults',
+ 'http://a9.com/-/spec/opensearchrss/1.0/')) > 0)
+
+ def testAllowsEmptyId(self):
+ feed = gdata.data.GDFeed()
+ try:
+ feed.id = atom.data.Id()
+ except AttributeError:
+ self.fail('Empty id should not raise an attribute error.')
+
+
+class BatchEntryTest(unittest.TestCase):
+
+ def testCorrectConversionFromAndToString(self):
+ batch_entry = parse(test_data.BATCH_ENTRY, gdata.data.BatchEntry)
+
+ self.assertEquals(batch_entry.batch_id.text, 'itemB')
+ self.assertEquals(batch_entry.id.text,
+ 'http://www.google.com/base/feeds/items/'
+ '2173859253842813008')
+ self.assertEquals(batch_entry.batch_operation.type, 'insert')
+ self.assertEquals(batch_entry.batch_status.code, '201')
+ self.assertEquals(batch_entry.batch_status.reason, 'Created')
+
+ new_entry = parse(str(batch_entry), gdata.data.BatchEntry)
+
+ self.assertEquals(batch_entry.batch_id.text, new_entry.batch_id.text)
+ self.assertEquals(batch_entry.id.text, new_entry.id.text)
+ self.assertEquals(batch_entry.batch_operation.type,
+ new_entry.batch_operation.type)
+ self.assertEquals(batch_entry.batch_status.code,
+ new_entry.batch_status.code)
+ self.assertEquals(batch_entry.batch_status.reason,
+ new_entry.batch_status.reason)
+
+
+class BatchFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.batch_feed = gdata.data.BatchFeed()
+ self.example_entry = gdata.data.BatchEntry(
+ id=atom.data.Id(text='http://example.com/1'), text='This is a test')
+
+ def testConvertRequestFeed(self):
+ batch_feed = parse(test_data.BATCH_FEED_REQUEST, gdata.data.BatchFeed)
+
+ self.assertEquals(len(batch_feed.entry), 4)
+ for entry in batch_feed.entry:
+ self.assert_(isinstance(entry, gdata.data.BatchEntry))
+ self.assertEquals(batch_feed.title.text, 'My Batch Feed')
+
+ new_feed = parse(batch_feed.to_string(), gdata.data.BatchFeed)
+
+ self.assertEquals(len(new_feed.entry), 4)
+ for entry in new_feed.entry:
+ self.assert_(isinstance(entry, gdata.data.BatchEntry))
+ self.assertEquals(new_feed.title.text, 'My Batch Feed')
+
+ def testConvertResultFeed(self):
+ batch_feed = parse(test_data.BATCH_FEED_RESULT, gdata.data.BatchFeed)
+
+ self.assertEquals(len(batch_feed.entry), 4)
+ for entry in batch_feed.entry:
+ self.assert_(isinstance(entry, gdata.data.BatchEntry))
+ if entry.id.text == ('http://www.google.com/base/feeds/items/'
+ '2173859253842813008'):
+ self.assertEquals(entry.batch_operation.type, 'insert')
+ self.assertEquals(entry.batch_id.text, 'itemB')
+ self.assertEquals(entry.batch_status.code, '201')
+ self.assertEquals(entry.batch_status.reason, 'Created')
+ self.assertEquals(batch_feed.title.text, 'My Batch')
+
+ new_feed = parse(str(batch_feed), gdata.data.BatchFeed)
+
+ self.assertEquals(len(new_feed.entry), 4)
+ for entry in new_feed.entry:
+ self.assert_(isinstance(entry, gdata.data.BatchEntry))
+ if entry.id.text == ('http://www.google.com/base/feeds/items/'
+ '2173859253842813008'):
+ self.assertEquals(entry.batch_operation.type, 'insert')
+ self.assertEquals(entry.batch_id.text, 'itemB')
+ self.assertEquals(entry.batch_status.code, '201')
+ self.assertEquals(entry.batch_status.reason, 'Created')
+ self.assertEquals(new_feed.title.text, 'My Batch')
+
+ def testAddBatchEntry(self):
+ try:
+ self.batch_feed.AddBatchEntry(batch_id_string='a')
+ self.fail('AddBatchEntry with neither entry or URL should raise Error')
+ except gdata.data.MissingRequiredParameters:
+ pass
+
+ new_entry = self.batch_feed.AddBatchEntry(
+ id_url_string='http://example.com/1')
+ self.assertEquals(len(self.batch_feed.entry), 1)
+ self.assertEquals(self.batch_feed.entry[0].get_id(),
+ 'http://example.com/1')
+ self.assertEquals(self.batch_feed.entry[0].batch_id.text, '0')
+ self.assertEquals(new_entry.id.text, 'http://example.com/1')
+ self.assertEquals(new_entry.batch_id.text, '0')
+
+ to_add = gdata.data.BatchEntry(id=atom.data.Id(text='originalId'))
+ new_entry = self.batch_feed.AddBatchEntry(entry=to_add,
+ batch_id_string='foo')
+ self.assertEquals(new_entry.batch_id.text, 'foo')
+ self.assertEquals(new_entry.id.text, 'originalId')
+
+ to_add = gdata.data.BatchEntry(id=atom.data.Id(text='originalId'),
+ batch_id=gdata.data.BatchId(text='bar'))
+ new_entry = self.batch_feed.AddBatchEntry(entry=to_add,
+ id_url_string='newId',
+ batch_id_string='foo')
+ self.assertEquals(new_entry.batch_id.text, 'foo')
+ self.assertEquals(new_entry.id.text, 'originalId')
+
+ to_add = gdata.data.BatchEntry(id=atom.data.Id(text='originalId'),
+ batch_id=gdata.data.BatchId(text='bar'))
+ new_entry = self.batch_feed.AddBatchEntry(entry=to_add,
+ id_url_string='newId')
+ self.assertEquals(new_entry.batch_id.text, 'bar')
+ self.assertEquals(new_entry.id.text, 'originalId')
+
+ to_add = gdata.data.BatchEntry(id=atom.data.Id(text='originalId'),
+ batch_id=gdata.data.BatchId(text='bar'),
+ batch_operation=gdata.data.BatchOperation(
+ type=gdata.data.BATCH_INSERT))
+ self.assertEquals(to_add.batch_operation.type, gdata.data.BATCH_INSERT)
+ new_entry = self.batch_feed.AddBatchEntry(entry=to_add,
+ id_url_string='newId', batch_id_string='foo',
+ operation_string=gdata.data.BATCH_UPDATE)
+ self.assertEquals(new_entry.batch_operation.type, gdata.data.BATCH_UPDATE)
+
+ def testAddInsert(self):
+
+ first_entry = gdata.data.BatchEntry(
+ id=atom.data.Id(text='http://example.com/1'), text='This is a test1')
+ self.batch_feed.AddInsert(first_entry)
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.data.BATCH_INSERT)
+ self.assertEquals(self.batch_feed.entry[0].batch_id.text, '0')
+
+ second_entry = gdata.data.BatchEntry(
+ id=atom.data.Id(text='http://example.com/2'), text='This is a test2')
+ self.batch_feed.AddInsert(second_entry, batch_id_string='foo')
+ self.assertEquals(self.batch_feed.entry[1].batch_operation.type,
+ gdata.data.BATCH_INSERT)
+ self.assertEquals(self.batch_feed.entry[1].batch_id.text, 'foo')
+
+ third_entry = gdata.data.BatchEntry(
+ id=atom.data.Id(text='http://example.com/3'), text='This is a test3')
+ third_entry.batch_operation = gdata.data.BatchOperation(
+ type=gdata.data.BATCH_DELETE)
+ # Add an entry with a delete operation already assigned.
+ self.batch_feed.AddInsert(third_entry)
+ # The batch entry should not have the original operation, it should
+ # have been changed to an insert.
+ self.assertEquals(self.batch_feed.entry[2].batch_operation.type,
+ gdata.data.BATCH_INSERT)
+ self.assertEquals(self.batch_feed.entry[2].batch_id.text, '2')
+
+ def testAddDelete(self):
+ # Try deleting an entry
+ delete_entry = gdata.data.BatchEntry(
+ id=atom.data.Id(text='http://example.com/1'), text='This is a test')
+ self.batch_feed.AddDelete(entry=delete_entry)
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.data.BATCH_DELETE)
+ self.assertEquals(self.batch_feed.entry[0].get_id(),
+ 'http://example.com/1')
+ self.assertEquals(self.batch_feed.entry[0].text, 'This is a test')
+
+ # Try deleting a URL
+ self.batch_feed.AddDelete(url_string='http://example.com/2')
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.data.BATCH_DELETE)
+ self.assertEquals(self.batch_feed.entry[1].id.text,
+ 'http://example.com/2')
+ self.assert_(self.batch_feed.entry[1].text is None)
+
+ def testAddQuery(self):
+ # Try querying with an existing batch entry
+ delete_entry = gdata.data.BatchEntry(
+ id=atom.data.Id(text='http://example.com/1'))
+ self.batch_feed.AddQuery(entry=delete_entry)
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.data.BATCH_QUERY)
+ self.assertEquals(self.batch_feed.entry[0].get_id(),
+ 'http://example.com/1')
+
+ # Try querying a URL
+ self.batch_feed.AddQuery(url_string='http://example.com/2')
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.data.BATCH_QUERY)
+ self.assertEquals(self.batch_feed.entry[1].id.text,
+ 'http://example.com/2')
+
+ def testAddUpdate(self):
+ # Try updating an entry
+ delete_entry = gdata.data.BatchEntry(
+ id=atom.data.Id(text='http://example.com/1'), text='This is a test')
+ self.batch_feed.AddUpdate(entry=delete_entry)
+ self.assertEquals(self.batch_feed.entry[0].batch_operation.type,
+ gdata.data.BATCH_UPDATE)
+ self.assertEquals(self.batch_feed.entry[0].get_id(),
+ 'http://example.com/1')
+ self.assertEquals(self.batch_feed.entry[0].text, 'This is a test')
+
+
+class ExtendedPropertyTest(unittest.TestCase):
+
+ def testXmlBlobRoundTrip(self):
+ ep = gdata.data.ExtendedProperty(name='blobby')
+ ep.SetXmlBlob('<some_xml attr="test"/>')
+ extension = ep.GetXmlBlob()
+ self.assertEquals(extension.tag, 'some_xml')
+ self.assert_(extension.namespace is None)
+ self.assertEquals(extension.attributes['attr'], 'test')
+
+ ep2 = parse(ep.ToString(), gdata.data.ExtendedProperty)
+
+ extension = ep2.GetXmlBlob()
+ self.assertEquals(extension.tag, 'some_xml')
+ self.assert_(extension.namespace is None)
+ self.assertEquals(extension.attributes['attr'], 'test')
+
+ def testGettersShouldReturnNoneWithNoBlob(self):
+ ep = gdata.data.ExtendedProperty(name='no blob')
+ self.assert_(ep.GetXmlBlob() is None)
+
+ def testGettersReturnCorrectTypes(self):
+ ep = gdata.data.ExtendedProperty(name='has blob')
+ ep.SetXmlBlob('<some_xml attr="test"/>')
+ self.assert_(isinstance(ep.GetXmlBlob(),
+ atom.core.XmlElement))
+ self.assert_(isinstance(ep.GetXmlBlob().to_string(), str))
+
+
+class FeedLinkTest(unittest.TestCase):
+
+ def testCorrectFromStringType(self):
+ link = parse(
+ '<feedLink xmlns="http://schemas.google.com/g/2005" countHint="5"/>',
+ gdata.data.FeedLink)
+ self.assert_(isinstance(link, gdata.data.FeedLink))
+ self.assertEqual(link.count_hint, '5')
+
+
+class SimpleV2FeedTest(unittest.TestCase):
+
+ def test_parsing_etags_and_edit_url(self):
+ feed = atom.core.parse(SIMPLE_V2_FEED_TEST_DATA, gdata.data.GDFeed)
+
+ # General parsing assertions.
+ self.assertEqual(feed.get_elements('title')[0].text,
+ 'Elizabeth Bennet\'s Contacts')
+ self.assertEqual(len(feed.entry), 2)
+ for entry in feed.entry:
+ self.assert_(isinstance(entry, gdata.data.GDEntry))
+ self.assertEqual(feed.entry[0].GetElements('title')[0].text,
+ 'Fitzwilliam')
+ self.assertEqual(feed.entry[0].get_elements('id')[0].text,
+ 'http://www.google.com/m8/feeds/contacts/liz%40gmail.com/base/c9e')
+
+ # ETags checks.
+ self.assertEqual(feed.etag, 'W/"CUMBRHo_fip7ImA9WxRbGU0."')
+ self.assertEqual(feed.entry[0].etag, '"Qn04eTVSLyp7ImA9WxRbGEUORAQ."')
+ self.assertEqual(feed.entry[1].etag, '"123456"')
+
+ # Look for Edit URLs.
+ self.assertEqual(feed.entry[0].find_edit_link(),
+ 'http://www.google.com/m8/feeds/contacts/liz%40gmail.com/full/c9e')
+ self.assertEqual(feed.entry[1].FindEditLink(), 'http://example.com/1')
+
+ # Look for Next URLs.
+ self.assertEqual(feed.find_next_link(),
+ 'http://www.google.com/m8/feeds/contacts/.../more')
+
+ def test_constructor_defauls(self):
+ feed = gdata.data.GDFeed()
+ self.assert_(feed.etag is None)
+ self.assertEqual(feed.link, [])
+ self.assertEqual(feed.entry, [])
+ entry = gdata.data.GDEntry()
+ self.assert_(entry.etag is None)
+ self.assertEqual(entry.link, [])
+ link = atom.data.Link()
+ self.assert_(link.href is None)
+ self.assert_(link.rel is None)
+ link1 = atom.data.Link(href='http://example.com', rel='test')
+ self.assertEqual(link1.href, 'http://example.com')
+ self.assertEqual(link1.rel, 'test')
+ link2 = atom.data.Link(href='http://example.org/', rel='alternate')
+ entry = gdata.data.GDEntry(etag='foo', link=[link1, link2])
+ feed = gdata.data.GDFeed(etag='12345', entry=[entry])
+ self.assertEqual(feed.etag, '12345')
+ self.assertEqual(len(feed.entry), 1)
+ self.assertEqual(feed.entry[0].etag, 'foo')
+ self.assertEqual(len(feed.entry[0].link), 2)
+
+
+class DataClassSanityTest(unittest.TestCase):
+
+ def test_basic_element_structure(self):
+ conf.check_data_classes(self, [
+ gdata.data.TotalResults, gdata.data.StartIndex,
+ gdata.data.ItemsPerPage, gdata.data.ExtendedProperty,
+ gdata.data.GDEntry, gdata.data.GDFeed, gdata.data.BatchId,
+ gdata.data.BatchOperation, gdata.data.BatchStatus,
+ gdata.data.BatchEntry, gdata.data.BatchInterrupted,
+ gdata.data.BatchFeed, gdata.data.EntryLink, gdata.data.FeedLink,
+ gdata.data.AdditionalName, gdata.data.Comments, gdata.data.Country,
+ gdata.data.Email, gdata.data.FamilyName, gdata.data.Im,
+ gdata.data.GivenName, gdata.data.NamePrefix, gdata.data.NameSuffix,
+ gdata.data.FullName, gdata.data.Name, gdata.data.OrgDepartment,
+ gdata.data.OrgName, gdata.data.OrgSymbol, gdata.data.OrgTitle,
+ gdata.data.Organization, gdata.data.When, gdata.data.Who,
+ gdata.data.OriginalEvent, gdata.data.PhoneNumber,
+ gdata.data.PostalAddress, gdata.data.Rating, gdata.data.Recurrence,
+ gdata.data.RecurrenceException, gdata.data.Reminder,
+ gdata.data.Agent, gdata.data.HouseName, gdata.data.Street,
+ gdata.data.PoBox, gdata.data.Neighborhood, gdata.data.City,
+ gdata.data.Subregion, gdata.data.Region, gdata.data.Postcode,
+ gdata.data.Country, gdata.data.FormattedAddress,
+ gdata.data.StructuredPostalAddress, gdata.data.Where,
+ gdata.data.AttendeeType, gdata.data.AttendeeStatus])
+
+ def test_member_values(self):
+ self.assertEqual(
+ gdata.data.TotalResults._qname,
+ ('{http://a9.com/-/spec/opensearchrss/1.0/}totalResults',
+ '{http://a9.com/-/spec/opensearch/1.1/}totalResults'))
+ self.assertEqual(
+ gdata.data.RecurrenceException._qname,
+ '{http://schemas.google.com/g/2005}recurrenceException')
+ self.assertEqual(gdata.data.RecurrenceException.specialized,
+ 'specialized')
+
+
+def suite():
+ return conf.build_suite([StartIndexTest, StartIndexTest, GDataEntryTest,
+ LinkFinderTest, GDataFeedTest, BatchEntryTest, BatchFeedTest,
+ ExtendedPropertyTest, FeedLinkTest, SimpleV2FeedTest,
+ DataClassSanityTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
+
+
diff --git a/tests/gdata_tests/docs/__init__.py b/tests/gdata_tests/docs/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/docs/__init__.py
diff --git a/tests/gdata_tests/docs/data/test.0.bin b/tests/gdata_tests/docs/data/test.0.bin
new file mode 100644
index 0000000..81c545e
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.0.bin
@@ -0,0 +1 @@
+1234
diff --git a/tests/gdata_tests/docs/data/test.0.csv b/tests/gdata_tests/docs/data/test.0.csv
new file mode 100755
index 0000000..1b2a2fd
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.0.csv
@@ -0,0 +1,205 @@
+Invoice,Job/Memo,Date,DueWk,Stat,Amount,"HB/Pay/
+Adjs",Amount Due
+1,1,1,1,1,1,1,1
+2,2,2,2,2,2,2,2
+3,3,3,3,3,3,3,3
+4,4,4,4,4,4,4,4
+5,5,5,5,5,5,5,5
+6,6,6,6,6,6,6,6
+7,7,7,7,7,7,7,7
+8,8,8,8,8,8,8,8
+9,9,9,9,9,9,9,9
+10,10,10,10,10,10,10,10
+11,11,11,11,11,11,11,11
+12,12,12,12,12,12,12,12
+13,13,13,13,13,13,13,13
+14,14,14,14,14,14,14,14
+15,15,15,15,15,15,15,15
+16,16,16,16,16,16,16,16
+17,17,17,17,17,17,17,17
+18,18,18,18,18,18,18,18
+19,19,19,19,19,19,19,19
+20,20,20,20,20,20,20,20
+21,21,21,21,21,21,21,21
+22,22,22,22,22,22,22,22
+23,23,23,23,23,23,23,23
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
diff --git a/tests/gdata_tests/docs/data/test.0.doc b/tests/gdata_tests/docs/data/test.0.doc
new file mode 100755
index 0000000..3da59a2
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.0.doc
Binary files differ
diff --git a/tests/gdata_tests/docs/data/test.0.pdf b/tests/gdata_tests/docs/data/test.0.pdf
new file mode 100755
index 0000000..c3868b7
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.0.pdf
Binary files differ
diff --git a/tests/gdata_tests/docs/data/test.0.ppt b/tests/gdata_tests/docs/data/test.0.ppt
new file mode 100755
index 0000000..20ce214
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.0.ppt
Binary files differ
diff --git a/tests/gdata_tests/docs/data/test.0.wmf b/tests/gdata_tests/docs/data/test.0.wmf
new file mode 100644
index 0000000..d3b1226
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.0.wmf
Binary files differ
diff --git a/tests/gdata_tests/docs/data/test.1.bin b/tests/gdata_tests/docs/data/test.1.bin
new file mode 100644
index 0000000..0f4a73c
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.1.bin
@@ -0,0 +1 @@
+lorem ipsum dolar
diff --git a/tests/gdata_tests/docs/data/test.1.csv b/tests/gdata_tests/docs/data/test.1.csv
new file mode 100755
index 0000000..70f064a
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.1.csv
@@ -0,0 +1,205 @@
+UPDATED Invoice,Job/Memo,Date,DueWk,Stat,Amount,"HB/Pay/
+Adjs",UPDATED Amount Due
+2,2,2,2,2,2,2,2
+2,2,2,2,2,2,2,2
+3,3,3,3,3,3,3,3
+4,4,4,4,4,4,4,4
+5,5,5,5,5,5,5,5
+6,6,6,6,6,6,6,6
+7,7,7,7,7,7,7,7
+8,8,8,8,8,8,8,8
+9,9,9,9,9,9,9,9
+20,20,20,20,20,20,20,20
+22,22,22,22,22,22,22,22
+22,22,22,22,22,22,22,22
+23,23,23,23,23,23,23,23
+24,24,24,24,24,24,24,24
+25,25,25,25,25,25,25,25
+26,26,26,26,26,26,26,26
+27,27,27,27,27,27,27,27
+28,28,28,28,28,28,28,28
+29,29,29,29,29,29,29,29
+20,20,20,20,20,20,20,20
+22,22,22,22,22,22,22,22
+22,22,22,22,22,22,22,22
+23,23,23,23,23,23,23,23
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,,,,,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
+,,
diff --git a/tests/gdata_tests/docs/data/test.1.doc b/tests/gdata_tests/docs/data/test.1.doc
new file mode 100644
index 0000000..3436834
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.1.doc
Binary files differ
diff --git a/tests/gdata_tests/docs/data/test.1.pdf b/tests/gdata_tests/docs/data/test.1.pdf
new file mode 100644
index 0000000..7a9be46
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.1.pdf
Binary files differ
diff --git a/tests/gdata_tests/docs/data/test.1.ppt b/tests/gdata_tests/docs/data/test.1.ppt
new file mode 100644
index 0000000..52873e0
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.1.ppt
Binary files differ
diff --git a/tests/gdata_tests/docs/data/test.1.wmf b/tests/gdata_tests/docs/data/test.1.wmf
new file mode 100644
index 0000000..f59cc42
--- /dev/null
+++ b/tests/gdata_tests/docs/data/test.1.wmf
Binary files differ
diff --git a/tests/gdata_tests/docs/data_test.py b/tests/gdata_tests/docs/data_test.py
new file mode 100755
index 0000000..c4b7d21
--- /dev/null
+++ b/tests/gdata_tests/docs/data_test.py
@@ -0,0 +1,377 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'e.bidelman (Eric Bidelman)'
+
+import unittest
+import atom
+from gdata import test_data
+import gdata.acl.data
+import gdata.data
+import gdata.docs.data
+import gdata.test_config as conf
+
+
+class DocsEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.DOCUMENT_LIST_ENTRY_V3,
+ gdata.docs.data.Resource)
+
+ def testToAndFromStringDocsEntry(self):
+ self.assert_(isinstance(self.entry, gdata.docs.data.Resource))
+ self.assertEqual(self.entry.GetResourceType(), 'spreadsheet')
+ self.assert_(isinstance(self.entry.last_viewed, gdata.docs.data.LastViewed))
+ self.assertEqual(self.entry.last_viewed.text, '2009-03-05T07:48:21.493Z')
+ self.assert_(
+ isinstance(self.entry.last_modified_by, gdata.docs.data.LastModifiedBy))
+ self.assertEqual(
+ self.entry.last_modified_by.email.text, 'test.user@gmail.com')
+ self.assertEqual(self.entry.last_modified_by.name.text, 'test.user')
+ self.assert_(isinstance(self.entry.resource_id, gdata.docs.data.ResourceId))
+ self.assertEqual(self.entry.resource_id.text,
+ 'spreadsheet:supercalifragilisticexpealidocious')
+ self.assert_(isinstance(self.entry.writers_can_invite,
+ gdata.docs.data.WritersCanInvite))
+ self.assertEqual(self.entry.writers_can_invite.value, 'true')
+ self.assert_(isinstance(self.entry.quota_bytes_used,
+ gdata.docs.data.QuotaBytesUsed))
+ self.assertEqual(self.entry.quota_bytes_used.text, '1000')
+ self.assertEqual(len(self.entry.feed_link), 2)
+ self.assert_(isinstance(self.entry.feed_link[0], gdata.data.FeedLink))
+
+ self.assertEqual(
+ self.entry.GetAclFeedLink().href,
+ ('https://docs.google.com/feeds/default/private/full/'
+ 'spreadsheet%3Asupercalifragilisticexpealidocious/acl'))
+ self.assertEqual(
+ self.entry.GetRevisionsFeedLink().href,
+ ('https://docs.google.com/feeds/default/private/full/'
+ 'spreadsheet%3Asupercalifragilisticexpealidocious/revisions'))
+
+ self.assertEqual(len(self.entry.InCollections()), 1)
+ self.assertEqual(self.entry.InCollections()[0].title, 'AFolderName')
+
+
+class AclTest(unittest.TestCase):
+
+ def setUp(self):
+ self.acl_entry = atom.core.parse(test_data.DOCUMENT_LIST_ACL_ENTRY,
+ gdata.docs.data.AclEntry)
+ self.acl_entry_withkey = atom.core.parse(
+ test_data.DOCUMENT_LIST_ACL_WITHKEY_ENTRY, gdata.docs.data.AclEntry)
+ self.acl_entry_additional_role = atom.core.parse(
+ test_data.DOCUMENT_LIST_ACL_ADDITIONAL_ROLE_ENTRY,
+ gdata.docs.data.AclEntry)
+
+ def testToAndFromString(self):
+ self.assert_(isinstance(self.acl_entry, gdata.docs.data.AclEntry))
+ self.assert_(isinstance(self.acl_entry.role, gdata.acl.data.AclRole))
+ self.assert_(isinstance(self.acl_entry.scope, gdata.acl.data.AclScope))
+ self.assertEqual(self.acl_entry.scope.value, 'user@gmail.com')
+ self.assertEqual(self.acl_entry.scope.type, 'user')
+ self.assertEqual(self.acl_entry.role.value, 'writer')
+
+ acl_entry_str = str(self.acl_entry)
+ new_acl_entry = atom.core.parse(acl_entry_str, gdata.docs.data.AclEntry)
+ self.assert_(isinstance(new_acl_entry, gdata.docs.data.AclEntry))
+ self.assert_(isinstance(new_acl_entry.role, gdata.acl.data.AclRole))
+ self.assert_(isinstance(new_acl_entry.scope, gdata.acl.data.AclScope))
+ self.assertEqual(new_acl_entry.scope.value, self.acl_entry.scope.value)
+ self.assertEqual(new_acl_entry.scope.type, self.acl_entry.scope.type)
+ self.assertEqual(new_acl_entry.role.value, self.acl_entry.role.value)
+
+ def testToAndFromStringWithKey(self):
+ self.assert_(isinstance(self.acl_entry_withkey, gdata.docs.data.AclEntry))
+ self.assert_(self.acl_entry_withkey.role is None)
+ self.assert_(isinstance(self.acl_entry_withkey.with_key,
+ gdata.acl.data.AclWithKey))
+ self.assert_(isinstance(self.acl_entry_withkey.with_key.role,
+ gdata.acl.data.AclRole))
+ self.assert_(isinstance(self.acl_entry_withkey.scope,
+ gdata.acl.data.AclScope))
+ self.assertEqual(self.acl_entry_withkey.with_key.key, 'somekey')
+ self.assertEqual(self.acl_entry_withkey.with_key.role.value, 'writer')
+ self.assertEqual(self.acl_entry_withkey.scope.value, 'example.com')
+ self.assertEqual(self.acl_entry_withkey.scope.type, 'domain')
+
+ acl_entry_withkey_str = str(self.acl_entry_withkey)
+ new_acl_entry_withkey = atom.core.parse(acl_entry_withkey_str,
+ gdata.docs.data.AclEntry)
+ self.assert_(isinstance(new_acl_entry_withkey, gdata.docs.data.AclEntry))
+ self.assert_(new_acl_entry_withkey.role is None)
+ self.assert_(isinstance(new_acl_entry_withkey.with_key,
+ gdata.acl.data.AclWithKey))
+ self.assert_(isinstance(new_acl_entry_withkey.with_key.role,
+ gdata.acl.data.AclRole))
+ self.assert_(isinstance(new_acl_entry_withkey.scope,
+ gdata.acl.data.AclScope))
+ self.assertEqual(new_acl_entry_withkey.with_key.key,
+ self.acl_entry_withkey.with_key.key)
+ self.assertEqual(new_acl_entry_withkey.with_key.role.value,
+ self.acl_entry_withkey.with_key.role.value)
+ self.assertEqual(new_acl_entry_withkey.scope.value,
+ self.acl_entry_withkey.scope.value)
+ self.assertEqual(new_acl_entry_withkey.scope.type,
+ self.acl_entry_withkey.scope.type)
+
+ def testCreateNewAclEntry(self):
+ cat = gdata.atom.Category(
+ term='http://schemas.google.com/acl/2007#accessRule',
+ scheme='http://schemas.google.com/g/2005#kind')
+ acl_entry = gdata.docs.DocumentListAclEntry(category=[cat])
+ acl_entry.scope = gdata.docs.Scope(value='user@gmail.com', type='user')
+ acl_entry.role = gdata.docs.Role(value='writer')
+ self.assert_(isinstance(acl_entry, gdata.docs.DocumentListAclEntry))
+ self.assert_(isinstance(acl_entry.role, gdata.docs.Role))
+ self.assert_(isinstance(acl_entry.scope, gdata.docs.Scope))
+ self.assertEqual(acl_entry.scope.value, 'user@gmail.com')
+ self.assertEqual(acl_entry.scope.type, 'user')
+ self.assertEqual(acl_entry.role.value, 'writer')
+
+ def testAdditionalRole(self):
+ self.assertEqual(
+ self.acl_entry_additional_role.additional_role.value,
+ 'commenter')
+ self.assertEqual(
+ self.acl_entry_additional_role.with_key.additional_role.value,
+ 'commenter')
+
+
+class AclFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = atom.core.parse(test_data.DOCUMENT_LIST_ACL_FEED,
+ gdata.docs.data.AclFeed)
+
+ def testToAndFromString(self):
+ for entry in self.feed.entry:
+ self.assert_(isinstance(entry, gdata.docs.data.AclEntry))
+
+ feed = atom.core.parse(str(self.feed), gdata.docs.data.AclFeed)
+ for entry in feed.entry:
+ self.assert_(isinstance(entry, gdata.docs.data.AclEntry))
+
+ def testConvertActualData(self):
+ entries = self.feed.entry
+ self.assert_(len(entries) == 2)
+ self.assertEqual(entries[0].title.text,
+ 'Document Permission - user@gmail.com')
+ self.assertEqual(entries[0].role.value, 'owner')
+ self.assertEqual(entries[0].scope.type, 'user')
+ self.assertEqual(entries[0].scope.value, 'user@gmail.com')
+ self.assert_(entries[0].GetSelfLink() is not None)
+ self.assert_(entries[0].GetEditLink() is not None)
+ self.assertEqual(entries[1].title.text,
+ 'Document Permission - user2@google.com')
+ self.assertEqual(entries[1].role.value, 'writer')
+ self.assertEqual(entries[1].scope.type, 'domain')
+ self.assertEqual(entries[1].scope.value, 'google.com')
+ self.assert_(entries[1].GetSelfLink() is not None)
+ self.assert_(entries[1].GetEditLink() is not None)
+
+
+class RevisionFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = atom.core.parse(test_data.DOCUMENT_LIST_REVISION_FEED,
+ gdata.docs.data.RevisionFeed)
+
+ def testToAndFromString(self):
+ for entry in self.feed.entry:
+ self.assert_(isinstance(entry, gdata.docs.data.Revision))
+
+ feed = atom.core.parse(str(self.feed), gdata.docs.data.RevisionFeed)
+ for entry in feed.entry:
+ self.assert_(isinstance(entry, gdata.docs.data.Revision))
+
+ def testConvertActualData(self):
+ entries = self.feed.entry
+ self.assert_(len(entries) == 1)
+ self.assertEqual(entries[0].title.text, 'Revision 2')
+ self.assertEqual(entries[0].publish.value, 'true')
+ self.assertEqual(entries[0].publish_auto.value, 'true')
+ self.assertEqual(entries[0].publish_outside_domain.value, 'false')
+ self.assertEqual(
+ entries[0].GetPublishLink().href,
+ 'https://docs.google.com/View?docid=dfr4&pageview=1&hgd=1')
+ self.assertEqual(
+ entries[0].FindPublishLink(),
+ 'https://docs.google.com/View?docid=dfr4&pageview=1&hgd=1')
+
+
+class DataClassSanityTest(unittest.TestCase):
+
+ def test_basic_element_structure(self):
+ conf.check_data_classes(self, [
+ gdata.docs.data.ResourceId, gdata.docs.data.LastModifiedBy,
+ gdata.docs.data.LastViewed, gdata.docs.data.WritersCanInvite,
+ gdata.docs.data.QuotaBytesUsed, gdata.docs.data.Publish,
+ gdata.docs.data.PublishAuto, gdata.docs.data.PublishOutsideDomain,
+ gdata.docs.data.Resource, gdata.docs.data.AclEntry, gdata.docs.data.AclFeed,
+ gdata.docs.data.ResourceFeed, gdata.docs.data.Revision,
+ gdata.docs.data.RevisionFeed])
+
+
+class CategoryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.DOCUMENT_LIST_ENTRY_V3,
+ gdata.docs.data.Resource)
+
+ def testAddCategory(self):
+ entry = gdata.docs.data.Resource()
+ entry.AddCategory('test_scheme', 'test_term', 'test_label')
+ self.assertEqual(entry.GetFirstCategory('test_scheme').scheme,
+ 'test_scheme')
+ self.assertEqual(entry.GetFirstCategory('test_scheme').term, 'test_term')
+ self.assertEqual(entry.GetFirstCategory('test_scheme').label, 'test_label')
+
+ def testGetFirstCategory(self):
+ entry = gdata.docs.data.Resource()
+ cat1 = entry.AddCategory('test_scheme', 'test_term1', 'test_label1')
+ cat2 = entry.AddCategory('test_scheme', 'test_term2', 'test_label2')
+ self.assertEqual(entry.GetFirstCategory('test_scheme'), cat1)
+
+ def testGetCategories(self):
+ cat1 = self.entry.AddCategory('test_scheme', 'test_term1', 'test_label1')
+ cat2 = self.entry.AddCategory('test_scheme', 'test_term2', 'test_label2')
+ cats = list(self.entry.GetCategories('test_scheme'))
+ self.assertTrue(cat1 in cats)
+ self.assertTrue(cat2 in cats)
+
+ def testRemoveCategories(self):
+ self.entry.RemoveCategories(gdata.docs.data.LABELS_SCHEME)
+ self.assertEqual(self.entry.GetLabels(), set())
+
+ def testResourceType(self):
+ entry = gdata.docs.data.Resource('spreadsheet')
+ self.assertEqual(self.entry.GetResourceType(), 'spreadsheet')
+
+ def testGetResourceType(self):
+ self.assertEqual(self.entry.GetResourceType(), 'spreadsheet')
+
+ def testSetResourceType(self):
+ self.assertEqual(self.entry.GetResourceType(), 'spreadsheet')
+ self.entry.SetResourceType('drawing')
+ self.assertEqual(self.entry.GetResourceType(), 'drawing')
+
+ def testGetLabels(self):
+ self.assertEqual(self.entry.GetLabels(),
+ set(['mine', 'private', 'restricted-download',
+ 'shared-with-domain', 'viewed', 'starred', 'hidden',
+ 'trashed']))
+
+ def testAddLabel(self):
+ entry = gdata.docs.data.Resource()
+ entry.AddLabel('banana')
+ self.assertTrue('banana' in entry.GetLabels())
+
+ def testRemoveLabel(self):
+ entry = gdata.docs.data.Resource()
+ entry.AddLabel('banana')
+ entry.AddLabel('orange')
+ self.assertTrue('banana' in entry.GetLabels())
+ self.assertTrue('orange' in entry.GetLabels())
+ entry.RemoveLabel('orange')
+ self.assertFalse('orange' in entry.GetLabels())
+
+ def testIsHidden(self):
+ self.assertTrue(self.entry.IsHidden())
+
+ def testIsNotHidden(self):
+ self.entry.remove_categories(gdata.docs.data.LABELS_SCHEME)
+ self.assertFalse(self.entry.IsHidden())
+
+ def testIsViewed(self):
+ self.assertTrue(self.entry.IsViewed())
+
+ def testIsNotViewed(self):
+ self.entry.remove_categories(gdata.docs.data.LABELS_SCHEME)
+ self.assertFalse(self.entry.IsViewed())
+
+ def testIsStarred(self):
+ self.assertTrue(self.entry.IsStarred())
+
+ def testIsNotStarred(self):
+ self.entry.remove_categories(gdata.docs.data.LABELS_SCHEME)
+ self.assertFalse(self.entry.IsStarred())
+
+ def testIsTrashed(self):
+ self.assertTrue(self.entry.IsTrashed())
+
+ def testIsNotTrashed(self):
+ self.entry.remove_categories(gdata.docs.data.LABELS_SCHEME)
+ self.assertFalse(self.entry.IsTrashed())
+
+ def testIsPrivate(self):
+ self.assertTrue(self.entry.IsPrivate())
+
+ def testIsNotPrivate(self):
+ self.entry.remove_categories(gdata.docs.data.LABELS_SCHEME)
+ self.assertFalse(self.entry.IsPrivate())
+
+ def testIsMine(self):
+ self.assertTrue(self.entry.IsMine())
+
+ def testIsNotMine(self):
+ self.entry.remove_categories(gdata.docs.data.LABELS_SCHEME)
+ self.assertFalse(self.entry.IsMine())
+
+ def testIsSharedWithDomain(self):
+ self.assertTrue(self.entry.IsSharedWithDomain())
+
+ def testIsNotSharedWithDomain(self):
+ self.entry.remove_categories(gdata.docs.data.LABELS_SCHEME)
+ self.assertFalse(self.entry.IsSharedWithDomain())
+
+ def testIsRestrictedDownload(self):
+ self.assertTrue(self.entry.IsRestrictedDownload())
+
+ def testIsNotRestrictedDownload(self):
+ self.entry.remove_categories(gdata.docs.data.LABELS_SCHEME)
+ self.assertFalse(self.entry.IsRestrictedDownload())
+
+
+class MetadataTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = atom.core.parse(test_data.DOCUMENT_LIST_METADATA,
+ gdata.docs.data.Metadata)
+
+ def testAdditionalRoleInfo(self):
+ self.assertEqual(self.entry.additional_role_info[0].kind, 'document')
+
+ def testAdditionalRoleSet(self):
+ self.assertEqual(
+ self.entry.additional_role_info[0].additional_role_set[0].primaryRole,
+ 'reader')
+
+ def testAdditionalRole(self):
+ self.assertEqual(
+ self.entry.additional_role_info[0].additional_role_set[0].\
+ additional_role[0].value, 'commenter')
+
+
+def suite():
+ return conf.build_suite(
+ [DataClassSanityTest, CategoryTest, DocsHelperTest, DocsEntryTest,
+ AclTest, AclFeed, MetadataTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/docs/live_client_test.py b/tests/gdata_tests/docs/live_client_test.py
new file mode 100755
index 0000000..495c0d0
--- /dev/null
+++ b/tests/gdata_tests/docs/live_client_test.py
@@ -0,0 +1,568 @@
+#!/usr/bin/python
+#
+# Copyright 2011 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+"""Live integration tests of the Google Documents List API.
+
+ RESOURCES: Dict of test resource data, keyed on resource type.
+"""
+
+__author__ = 'vicfryzel@google.com (Vic Fryzel)'
+
+import os
+import os.path
+import tempfile
+import time
+import unittest
+import gdata.client
+import gdata.data
+import gdata.gauth
+import gdata.docs.client
+import gdata.docs.data
+import gdata.test_config as conf
+
+
+RESOURCES = {
+ 'document': (gdata.docs.data.DOCUMENT_LABEL,
+ 'Text Document',
+ 'data/test.0.doc',
+ 'data/test.1.doc',
+ 'application/msword',
+ 'doc'),
+ 'empty_document': (gdata.docs.data.DOCUMENT_LABEL,
+ 'Empty Text Document',
+ None,
+ 'data/test.1.doc',
+ 'application/msword',
+ 'txt'),
+ 'spreadsheet': (gdata.docs.data.SPREADSHEET_LABEL,
+ 'Spreadsheet',
+ 'data/test.0.csv',
+ 'data/test.1.csv',
+ 'text/csv',
+ 'csv'),
+ 'presentation': (gdata.docs.data.PRESENTATION_LABEL,
+ 'Presentation',
+ 'data/test.0.ppt',
+ 'data/test.1.ppt',
+ 'application/vnd.ms-powerpoint',
+ 'ppt'),
+ 'drawing': (gdata.docs.data.DRAWING_LABEL,
+ 'Drawing',
+ 'data/test.0.wmf',
+ 'data/test.1.wmf',
+ 'application/x-msmetafile',
+ 'png'),
+ 'pdf': (gdata.docs.data.PDF_LABEL,
+ 'PDF',
+ 'data/test.0.pdf',
+ 'data/test.1.pdf',
+ 'application/pdf',
+ None),
+ 'file': (gdata.docs.data.FILE_LABEL,
+ 'File',
+ 'data/test.0.bin',
+ 'data/test.1.bin',
+ 'application/octet-stream',
+ None),
+ 'collection': (gdata.docs.data.COLLECTION_LABEL,
+ 'Collection A',
+ None,
+ None,
+ None,
+ None)
+}
+
+
+class DocsTestCase(unittest.TestCase):
+ def shortDescription(self):
+ if hasattr(self, 'resource_type'):
+ return '%s for %s' % (self.__class__.__name__, self.resource_type)
+ else:
+ return self.__class__.__name__
+
+ def _delete(self, resource):
+ try:
+ self.client.DeleteResource(resource, permanent=True, force=True)
+ except:
+ pass
+
+ def _delete_all(self):
+ resources = self.client.GetAllResources(
+ '/feeds/default/private/full?showfolders=true&showdeleted=true')
+ for resource in resources:
+ self._delete(resource)
+
+ def _create(self):
+ ms = None
+ if self.resource_path is not None and self.resource_mime is not None:
+ ms = gdata.data.MediaSource(
+ file_path=os.path.join(os.path.dirname(__file__), self.resource_path),
+ content_type=self.resource_mime)
+ entry = gdata.docs.data.Resource(type=self.resource_label,
+ title=self.resource_title)
+ self.resource = self.client.CreateResource(entry, media=ms)
+
+ def _update(self):
+ ms = None
+ if self.resource_alt_path is not None and self.resource_mime is not None:
+ ms = gdata.data.MediaSource(
+ file_path=os.path.join(os.path.dirname(__file__),
+ self.resource_alt_path),
+ content_type=self.resource_mime)
+ self.resource.title.text = '%s Updated' % self.resource_title
+ return self.client.UpdateResource(self.resource, media=ms, force=True,
+ new_revision=True)
+
+ def setUp(self):
+ if conf.options.get_value('runlive') != 'true':
+ raise RuntimeError('Live tests require --runlive true')
+
+ self.client = gdata.docs.client.DocsClient()
+ if conf.options.get_value('ssl') == 'false':
+ self.client.ssl = False
+ conf.configure_client(self.client, 'DocsTest', self.client.auth_service)
+ conf.configure_cache(self.client, str(self.__class__))
+ if conf.options.get_value('clean') == 'true':
+ self._delete_all()
+
+ tries = 0
+ while tries < 3:
+ try:
+ tries += 1
+ self._create()
+ break
+ except gdata.client.RequestError:
+ if tries >= 2:
+ self.tearDown()
+ raise
+
+ def tearDown(self):
+ if conf.options.get_value('runlive') == 'true':
+ if conf.options.get_value('clean') == 'true':
+ self._delete_all()
+ else:
+ try:
+ self._delete(self.resource)
+ except:
+ pass
+ conf.close_client(self.client)
+
+
+class ResourcesTest(DocsTestCase):
+ def testGetAllResources(self):
+ results = self.client.GetAllResources(
+ '/feeds/default/private/full?showfolders=true')
+ self.assert_(all(isinstance(item, gdata.docs.data.Resource) \
+ for item in results))
+ self.assertEqual(len(results), 1)
+
+ def testGetResources(self):
+ feed = self.client.GetResources(
+ '/feeds/default/private/full?showfolders=true', limit=1)
+ self.assert_(isinstance(feed, gdata.docs.data.ResourceFeed))
+ self.assertEqual(len(feed.entry), 1)
+
+ def testGetResource(self):
+ entry = self.client.GetResource(self.resource)
+ self.assert_(isinstance(entry, gdata.docs.data.Resource))
+ self.assert_(entry.id.text is not None)
+ self.assert_(entry.title.text is not None)
+ self.assert_(entry.resource_id.text is not None)
+ self.assert_(entry.title.text is not None)
+ entry = self.client.GetResourceById(self.resource.resource_id.text)
+ self.assert_(isinstance(entry, gdata.docs.data.Resource))
+ self.assert_(entry.id.text is not None)
+ self.assert_(entry.title.text is not None)
+ self.assert_(entry.resource_id.text is not None)
+ self.assert_(entry.title.text is not None)
+ entry = self.client.GetResourceById(
+ self.resource.resource_id.text.split(':')[1])
+ self.assert_(isinstance(entry, gdata.docs.data.Resource))
+ self.assert_(entry.id.text is not None)
+ self.assert_(entry.title.text is not None)
+ self.assert_(entry.resource_id.text is not None)
+ self.assert_(entry.title.text is not None)
+ entry = self.client.GetResourceBySelfLink(
+ self.resource.GetSelfLink().href)
+ self.assert_(isinstance(entry, gdata.docs.data.Resource))
+ self.assert_(entry.id.text is not None)
+ self.assert_(entry.title.text is not None)
+ self.assert_(entry.resource_id.text is not None)
+ self.assert_(entry.title.text is not None)
+
+ def testMoveResource(self):
+ entry = gdata.docs.data.Resource(
+ type=gdata.docs.data.COLLECTION_LABEL,
+ title='Collection B')
+ collection = self.client.CreateResource(entry)
+
+ # Start off in 0 collections
+ self.assertEqual(len(self.resource.InCollections()), 0)
+
+ # Move resource into collection
+ entry = self.client.MoveResource(self.resource, collection)
+ self.assertEqual(len(entry.InCollections()), 1)
+ self.assertEqual(entry.InCollections()[0].title, collection.title.text)
+ self.client.DeleteResource(collection, permanent=True, force=True)
+
+ def testCopyResource(self):
+ copy_title = '%s Copy' % self.resource_title
+ # Copy only supported for document, spreadsheet, presentation types
+ if self.resource_type in ['document', 'empty_document', 'spreadsheet',
+ 'presentation']:
+ copy = self.client.CopyResource(self.resource, copy_title)
+ self.assertEqual(copy.title.text, copy_title)
+ self.client.DeleteResource(copy, permanent=True, force=True)
+
+ # TODO(vicfryzel): Expect appropriate error for drawings.
+ elif self.resource_type != 'drawing':
+ self.assertRaises(gdata.client.NotImplemented, self.client.CopyResource,
+ self.resource, copy_title)
+
+ def testDownloadResource(self):
+ tmp = tempfile.mkstemp()
+ if self.resource_type != 'collection':
+ if self.resource_export is not None:
+ extra_params = {'exportFormat': self.resource_export,
+ 'format': self.resource_export}
+ self.client.DownloadResource(self.resource, tmp[1],
+ extra_params=extra_params)
+ else:
+ self.client.DownloadResource(self.resource, tmp[1])
+ else:
+ # Cannot download collections
+ self.assertRaises(ValueError, self.client.DownloadResource,
+ self.resource, tmp[1])
+
+ # Should get a 404
+ entry = gdata.docs.data.Resource(type=gdata.docs.data.DOCUMENT_LABEL,
+ title='Does Not Exist')
+ self.assertRaises(AttributeError, self.client.DownloadResource, entry,
+ tmp[1])
+ os.close(tmp[0])
+ os.remove(tmp[1])
+
+ def testDownloadResourceToMemory(self):
+ if self.resource_type != 'collection':
+ data = None
+ if self.resource_export is not None:
+ extra_params = {'exportFormat': self.resource_export,
+ 'format': self.resource_export}
+ data = self.client.DownloadResourceToMemory(
+ self.resource, extra_params=extra_params)
+ else:
+ data = self.client.DownloadResourceToMemory(self.resource)
+ if self.resource_type == 'empty_document':
+ self.assertEqual(len(data), 3)
+ else:
+ self.assertNotEqual(len(data), 0)
+ else:
+ # Cannot download collections
+ self.assertRaises(ValueError, self.client.DownloadResourceToMemory,
+ self.resource)
+
+ def testDelete(self):
+ self.assertEqual(self.resource.deleted, None)
+ self.client.DeleteResource(self.resource, force=True)
+ self.resource = self.client.GetResource(self.resource)
+ self.assertNotEqual(self.resource.deleted, None)
+ self.client.DeleteResource(self.resource, permanent=True, force=True)
+ self.assertRaises(gdata.client.RequestError, self.client.GetResource,
+ self.resource)
+
+
+class AclTest(DocsTestCase):
+ def testGetAcl(self):
+ acl_feed = self.client.GetResourceAcl(self.resource)
+ self.assert_(isinstance(acl_feed, gdata.docs.data.AclFeed))
+ self.assertEqual(len(acl_feed.entry), 1)
+ self.assert_(isinstance(acl_feed.entry[0], gdata.docs.data.AclEntry))
+ self.assert_(acl_feed.entry[0].scope is not None)
+ self.assert_(acl_feed.entry[0].role is not None)
+
+ def testGetAclEntry(self):
+ acl_feed = self.client.GetResourceAcl(self.resource)
+ acl_entry = acl_feed.entry[0]
+ same_acl_entry = self.client.GetAclEntry(acl_entry)
+ self.assert_(isinstance(same_acl_entry, gdata.docs.data.AclEntry))
+ self.assertEqual(acl_entry.GetSelfLink().href,
+ same_acl_entry.GetSelfLink().href)
+ self.assertEqual(acl_entry.title.text, same_acl_entry.title.text)
+
+ def testAddAclEntry(self):
+ acl_entry_to_add = gdata.docs.data.AclEntry.GetInstance(
+ role='writer', scope_type='default', key=True)
+
+ new_acl_entry = self.client.AddAclEntry(self.resource, acl_entry_to_add)
+ self.assertEqual(acl_entry_to_add.scope.type, new_acl_entry.scope.type)
+ self.assertEqual(new_acl_entry.scope.value, None)
+ # Key will always be overridden on add
+ self.assertEqual(acl_entry_to_add.with_key.role.value,
+ new_acl_entry.with_key.role.value)
+ acl_feed = self.client.GetResourceAcl(self.resource)
+ self.assert_(isinstance(acl_feed, gdata.docs.data.AclFeed))
+ self.assert_(isinstance(acl_feed.entry[0], gdata.docs.data.AclEntry))
+ self.assert_(isinstance(acl_feed.entry[1], gdata.docs.data.AclEntry))
+
+ def testUpdateAclEntry(self):
+ acl_entry_to_add = gdata.docs.data.AclEntry.GetInstance(
+ role='reader', scope_type='user', scope_value='jeff@example.com',
+ key=True)
+ other_acl_entry = gdata.docs.data.AclEntry.GetInstance(
+ role='writer', scope_type='user', scope_value='jeff@example.com')
+
+ new_acl_entry = self.client.AddAclEntry(self.resource, acl_entry_to_add)
+ new_acl_entry.with_key = None
+ new_acl_entry.scope = other_acl_entry.scope
+ new_acl_entry.role = other_acl_entry.role
+ updated_acl_entry = self.client.UpdateAclEntry(new_acl_entry)
+
+ self.assertEqual(updated_acl_entry.GetSelfLink().href,
+ new_acl_entry.GetSelfLink().href)
+ self.assertEqual(updated_acl_entry.title.text, new_acl_entry.title.text)
+ self.assertEqual(updated_acl_entry.scope.type, other_acl_entry.scope.type)
+ self.assertEqual(updated_acl_entry.scope.value, other_acl_entry.scope.value)
+ self.assertEqual(updated_acl_entry.role.value, other_acl_entry.role.value)
+ self.assertEqual(updated_acl_entry.with_key, None)
+
+ def testDeleteAclEntry(self):
+ acl_entry_to_add = gdata.docs.data.AclEntry.GetInstance(
+ role='writer', scope_type='user', scope_value='joe@example.com',
+ key=True)
+ acl_feed = self.client.GetResourceAcl(self.resource)
+ new_acl_entry = self.client.AddAclEntry(self.resource, acl_entry_to_add)
+ acl_feed = self.client.GetResourceAcl(self.resource)
+
+ self.assert_(isinstance(acl_feed, gdata.docs.data.AclFeed))
+ self.assertEqual(len(acl_feed.entry), 2)
+ self.assert_(isinstance(acl_feed.entry[0], gdata.docs.data.AclEntry))
+ self.assert_(isinstance(acl_feed.entry[1], gdata.docs.data.AclEntry))
+
+ self.client.DeleteAclEntry(new_acl_entry)
+
+ acl_feed = self.client.GetResourceAcl(self.resource)
+ self.assert_(isinstance(acl_feed, gdata.docs.data.AclFeed))
+ self.assertEqual(len(acl_feed.entry), 1)
+ self.assert_(isinstance(acl_feed.entry[0], gdata.docs.data.AclEntry))
+
+
+class RevisionsTest(DocsTestCase):
+ def testGetRevisions(self):
+ # There are no revisions of collections
+ if self.resource_type != 'collection':
+ revisions = self.client.GetRevisions(self.resource)
+ self.assert_(isinstance(revisions, gdata.docs.data.RevisionFeed))
+ self.assert_(isinstance(revisions.entry[0], gdata.docs.data.Revision))
+ # Currently, there is a bug where new presentations have 2 revisions.
+ if self.resource_type != 'presentation':
+ self.assertEqual(len(revisions.entry), 1)
+
+ def testGetRevision(self):
+ # There are no revisions of collections
+ if self.resource_type != 'collection':
+ revisions = self.client.GetRevisions(self.resource)
+ entry = revisions.entry[0]
+ new_entry = self.client.GetRevision(entry)
+ self.assertEqual(entry.GetSelfLink().href, new_entry.GetSelfLink().href)
+ self.assertEqual(entry.title.text, new_entry.title.text)
+
+ def testGetRevisionBySelfLink(self):
+ # There are no revisions of collections
+ if self.resource_type != 'collection':
+ revisions = self.client.GetRevisions(self.resource)
+ entry = revisions.entry[0]
+ new_entry = self.client.GetRevisionBySelfLink(entry.GetSelfLink().href)
+ self.assertEqual(entry.GetSelfLink().href, new_entry.GetSelfLink().href)
+ self.assertEqual(entry.title.text, new_entry.title.text)
+
+ def testMultipleRevisionsAndUpdateResource(self):
+ if self.resource_type not in ['collection', 'presentation']:
+ revisions = self.client.GetRevisions(self.resource)
+ self.assertEqual(len(revisions.entry), 1)
+ # Currently, there is a bug where uploaded presentations have 2 revisions.
+ elif self.resource_type == 'presentation':
+ revisions = self.client.GetRevisions(self.resource)
+ self.assertEqual(len(revisions.entry), 2)
+
+ # Drawings do not currently support update, thus the rest of these
+ # tests do not yet work as expected.
+ if self.resource_type == 'drawing':
+ return
+
+ entry = self._update()
+ self.assertEqual(entry.title.text, '%s Updated' % self.resource_title)
+
+ if self.resource_type != 'collection':
+ revisions = self.client.GetRevisions(entry)
+ self.assert_(isinstance(revisions, gdata.docs.data.RevisionFeed))
+ if self.resource_type == 'presentation':
+ self.assertEqual(len(revisions.entry), 3)
+ self.assert_(isinstance(revisions.entry[2], gdata.docs.data.Revision))
+ else:
+ self.assertEqual(len(revisions.entry), 2)
+ self.assert_(isinstance(revisions.entry[0], gdata.docs.data.Revision))
+ self.assert_(isinstance(revisions.entry[1], gdata.docs.data.Revision))
+
+ def testPublishRevision(self):
+ if self.resource_type in ['file', 'pdf', 'collection']:
+ return
+
+ # Drawings do not currently support update, thus this test would fail.
+ if self.resource_type == 'drawing':
+ return
+
+ entry = self._update()
+ revisions = self.client.GetRevisions(entry)
+ revision = self.client.PublishRevision(revisions.entry[1])
+ # Currently, there is a bug where uploaded presentations have 2 revisions.
+ if self.resource_type == 'presentation':
+ revisions = self.client.GetRevisions(entry)
+ revision = revisions.entry[2]
+ self.assert_(isinstance(revision, gdata.docs.data.Revision))
+ self.assertEqual(revision.publish.value, 'true')
+ self.assertEqual(revision.publish_auto.value, 'false')
+
+ # The rest of the tests require an Apps domain
+ if 'gmail' in conf.options.get_value('username'):
+ return
+
+ self.assertEqual(revision.publish_outside_domain.value, 'false')
+
+ # Empty documents won't have further revisions b/c content didn't change
+ if self.resource_type == 'empty_document':
+ return
+
+ revisions = self.client.GetRevisions(entry)
+ if self.resource_type == 'presentation':
+ revision = self.client.PublishRevision(
+ revisions.entry[2], publish_auto=True, publish_outside_domain=True)
+ else:
+ revision = self.client.PublishRevision(
+ revisions.entry[1], publish_auto=True, publish_outside_domain=True)
+ if self.resource_type == 'spreadsheet':
+ revision = client.GetRevisions(entry).entry[1]
+ self.assert_(isinstance(revision, gdata.docs.data.Revision))
+ self.assertEqual(revision.publish.value, 'true')
+ self.assertEqual(revision.publish_auto.value, 'true')
+ self.assertEqual(revision.publish_outside_domain.value, 'true')
+
+ revision = self.client.GetRevision(revisions.entry[0])
+ self.assertEqual(revision.publish, None)
+ self.assertEqual(revision.publish_auto, None)
+ self.assertEqual(revision.publish_outside_domain, None)
+
+ def testDownloadRevision(self):
+ if self.resource_type == 'collection':
+ return
+
+ revisions = self.client.GetRevisions(self.resource)
+ tmp = tempfile.mkstemp()
+ self.client.DownloadRevision(revisions.entry[0], tmp[1])
+ os.close(tmp[0])
+ os.remove(tmp[1])
+
+ def testDeleteRevision(self):
+ # API can only delete file revisions
+ if self.resource_type != 'file':
+ return
+
+ entry = self._update()
+ revisions = self.client.GetRevisions(entry)
+ self.assertEqual(len(revisions.entry), 2)
+ self.client.DeleteRevision(revisions.entry[1])
+ self.assert_(isinstance(revisions, gdata.docs.data.RevisionFeed))
+ self.assert_(isinstance(revisions.entry[0], gdata.docs.data.Revision))
+ revisions = self.client.GetRevisions(entry)
+ self.assertEqual(len(revisions.entry), 1)
+
+
+class ChangesTest(DocsTestCase):
+ def testGetChanges(self):
+ # This test assumes that by the time this test is run, the account
+ # being used already has a number of changes
+
+ changes = self.client.GetChanges(max_results=5)
+ self.assert_(isinstance(changes, gdata.docs.data.ChangeFeed))
+ self.assert_(len(changes.entry) <= 5)
+ self.assert_(isinstance(changes.entry[0], gdata.docs.data.Change))
+ self._update()
+ changes = self.client.GetChanges(changes.entry[0].changestamp.value, 5)
+ self.assert_(isinstance(changes, gdata.docs.data.ChangeFeed))
+ self.assert_(len(changes.entry) <= 5)
+ self.assert_(isinstance(changes.entry[0], gdata.docs.data.Change))
+
+ def testDeleteResourceCreatesNewChange(self):
+ """Ensure that deleting a resource causes a new change entry."""
+ self._update()
+ changes = self.client.GetChanges(max_results=1)
+ latest = changes.entry[0].changestamp.value
+ self._delete(self.resource)
+ time.sleep(10)
+ changes = self.client.GetChanges(max_results=1)
+ self.assert_(latest < changes.entry[0].changestamp.value)
+
+
+class MetadataTest(DocsTestCase):
+ def setUp(self):
+ if conf.options.get_value('runlive') != 'true':
+ raise RuntimeError('Live tests require --runlive true')
+ else:
+ self.client = gdata.docs.client.DocsClient()
+ if conf.options.get_value('ssl') == 'true':
+ self.client.ssl = True
+ conf.configure_client(self.client, 'DocsTest', self.client.auth_service)
+ conf.configure_cache(self.client, str(self.__class__))
+ if conf.options.get_value('clean') == 'true':
+ self._delete_all()
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def testMetadata(self):
+ metadata = self.client.GetMetadata()
+ self.assert_(isinstance(metadata, gdata.docs.data.Metadata))
+ self.assertNotEqual(int(metadata.quota_bytes_total.text), 0)
+ self.assertEqual(int(metadata.quota_bytes_used.text), 0)
+ self.assertEqual(int(metadata.quota_bytes_used_in_trash.text), 0)
+ self.assertNotEqual(len(metadata.import_formats), 0)
+ self.assertNotEqual(len(metadata.export_formats), 0)
+ self.assertNotEqual(len(metadata.features), 0)
+ self.assertNotEqual(len(metadata.max_upload_sizes), 0)
+
+
+def suite():
+ suite = unittest.TestSuite()
+ for key, value in RESOURCES.iteritems():
+ for case in [ResourcesTest, AclTest, RevisionsTest, ChangesTest]:
+ tests = unittest.TestLoader().loadTestsFromTestCase(case)
+ for test in tests:
+ test.resource_type = key
+ test.resource_label = value[0]
+ test.resource_title = value[1]
+ test.resource_path = value[2]
+ test.resource_alt_path = value[3]
+ test.resource_mime = value[4]
+ test.resource_export = value[5]
+ suite.addTest(test)
+ suite.addTests(unittest.TestLoader().loadTestsFromTestCase(MetadataTest))
+ return suite
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/docs/service_test.py b/tests/gdata_tests/docs/service_test.py
new file mode 100755
index 0000000..2dc4e03
--- /dev/null
+++ b/tests/gdata_tests/docs/service_test.py
@@ -0,0 +1,417 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = ('api.jfisher (Jeff Fisher), '
+ 'api.eric@google.com (Eric Bidelman)')
+
+import getpass
+import os
+import re
+import StringIO
+import time
+import unittest
+
+import gdata.docs.service
+import gdata.spreadsheet.service
+
+
+username = ''
+password = ''
+
+client = gdata.docs.service.DocsService()
+editClient = gdata.docs.service.DocsService()
+spreadsheets = gdata.spreadsheet.service.SpreadsheetsService()
+
+
+class DocumentsListServiceTest(unittest.TestCase):
+ def setUp(self):
+ self.client = client
+ self.editClient = editClient
+ self.editClient.SetClientLoginToken(client.GetClientLoginToken())
+ self.editClient.additional_headers = {'If-Match': '*'}
+ self.spreadsheets = spreadsheets
+ self.DOCUMENT_CATEGORY = client._MakeKindCategory(gdata.docs.service.DOCUMENT_LABEL)
+ self.SPREADSHEET_CATEGORY = client._MakeKindCategory(gdata.docs.service.SPREADSHEET_LABEL)
+ self.PRESENTATION_CATEGORY = client._MakeKindCategory(gdata.docs.service.PRESENTATION_LABEL)
+
+
+class DocumentListQueryTest(DocumentsListServiceTest):
+
+ def setUp(self):
+ DocumentsListServiceTest.setUp(self)
+ self.feed = self.client.GetDocumentListFeed()
+
+ def testGetDocumentsListFeed(self):
+ self.assert_(isinstance(self.feed, gdata.docs.DocumentListFeed))
+ uri = 'http://docs.google.com/feeds/documents/private/full/?max-results=1'
+
+ # Query using GetDocumentListFeed()
+ feed = self.client.GetDocumentListFeed(uri)
+ self.assert_(isinstance(feed, gdata.docs.DocumentListFeed))
+ self.assertEqual(len(feed.entry), 1)
+ self.assertEqual(self.feed.entry[0].id.text, feed.entry[0].id.text)
+ self.assertEqual(self.feed.entry[0].title.text, feed.entry[0].title.text)
+
+ # Query using QueryDocumentListFeed()
+ feed2 = self.client.QueryDocumentListFeed(uri)
+ self.assertEqual(len(feed2.entry), 1)
+ self.assertEqual(self.feed.entry[0].id.text, feed2.entry[0].id.text)
+ self.assertEqual(self.feed.entry[0].title.text, feed2.entry[0].title.text)
+
+ def testGetDocumentsListEntry(self):
+ self_link = self.feed.entry[0].GetSelfLink().href
+ entry = self.client.GetDocumentListEntry(self_link)
+ self.assert_(isinstance(entry, gdata.docs.DocumentListEntry))
+ self.assertEqual(self.feed.entry[0].id.text, entry.id.text)
+ self.assertEqual(self.feed.entry[0].title.text, entry.title.text)
+
+ self.assert_(self.feed.entry[0].resourceId.text is not None)
+ self.assert_(self.feed.entry[0].lastModifiedBy is not None)
+ self.assert_(self.feed.entry[0].lastViewed is not None)
+
+ def testGetDocumentsListAclFeed(self):
+ uri = ('http://docs.google.com/feeds/documents/private/full/'
+ '-/mine?max-results=1')
+ feed = self.client.GetDocumentListFeed(uri)
+ feed_link = feed.entry[0].GetAclLink().href
+ acl_feed = self.client.GetDocumentListAclFeed(feed_link)
+ self.assert_(isinstance(acl_feed, gdata.docs.DocumentListAclFeed))
+ self.assert_(isinstance(acl_feed.entry[0], gdata.docs.DocumentListAclEntry))
+ self.assert_(acl_feed.entry[0].scope is not None)
+ self.assert_(acl_feed.entry[0].role is not None)
+
+
+class DocumentListAclTest(DocumentsListServiceTest):
+
+ def setUp(self):
+ DocumentsListServiceTest.setUp(self)
+ uri = ('http://docs.google.com/feeds/documents/private/full'
+ '/-/mine?max-results=1')
+ self.feed = self.client.GetDocumentListFeed(uri)
+
+ self.EMAIL = 'x@example.com'
+ self.SCOPE_TYPE = 'user'
+ self.ROLE_VALUE = 'reader'
+
+ def testCreateAndUpdateAndDeleteAcl(self):
+ # Add new ACL
+ scope = gdata.docs.Scope(value=self.EMAIL, type=self.SCOPE_TYPE)
+ role = gdata.docs.Role(value=self.ROLE_VALUE)
+
+ acl_entry = self.client.Post(
+ gdata.docs.DocumentListAclEntry(scope=scope, role=role),
+ self.feed.entry[0].GetAclLink().href,
+ converter=gdata.docs.DocumentListAclEntryFromString)
+ self.assert_(isinstance(acl_entry, gdata.docs.DocumentListAclEntry))
+ self.assertEqual(acl_entry.scope.value, self.EMAIL)
+ self.assertEqual(acl_entry.scope.type, self.SCOPE_TYPE)
+ self.assertEqual(acl_entry.role.value, self.ROLE_VALUE)
+
+ # Update the user's role
+ ROLE_VALUE = 'writer'
+ acl_entry.role.value = ROLE_VALUE
+
+ updated_acl_entry = self.editClient.Put(
+ acl_entry, acl_entry.GetEditLink().href,
+ converter=gdata.docs.DocumentListAclEntryFromString)
+
+ self.assertEqual(updated_acl_entry.scope.value, self.EMAIL)
+ self.assertEqual(updated_acl_entry.scope.type, self.SCOPE_TYPE)
+ self.assertEqual(updated_acl_entry.role.value, ROLE_VALUE)
+
+ # Delete the ACL
+ self.editClient.Delete(updated_acl_entry.GetEditLink().href)
+
+ # Make sure entry was actually deleted
+ acl_feed = self.client.GetDocumentListAclFeed(
+ self.feed.entry[0].GetAclLink().href)
+ for acl_entry in acl_feed.entry:
+ self.assert_(acl_entry.scope.value != self.EMAIL)
+
+
+class DocumentListCreateAndDeleteTest(DocumentsListServiceTest):
+ def setUp(self):
+ DocumentsListServiceTest.setUp(self)
+ self.BLANK_TITLE = "blank.txt"
+ self.TITLE = 'Test title'
+ self.new_entry = gdata.docs.DocumentListEntry()
+ self.new_entry.category.append(self.DOCUMENT_CATEGORY)
+
+ def testCreateAndDeleteEmptyDocumentSlugHeaderTitle(self):
+ created_entry = self.client.Post(self.new_entry,
+ '/feeds/documents/private/full',
+ extra_headers={'Slug': self.BLANK_TITLE})
+ self.editClient.Delete(created_entry.GetEditLink().href)
+ self.assertEqual(created_entry.title.text, self.BLANK_TITLE)
+ self.assertEqual(created_entry.category[0].label, 'document')
+
+ def testCreateAndDeleteEmptyDocumentAtomTitle(self):
+ self.new_entry.title = gdata.atom.Title(text=self.TITLE)
+ created_entry = self.client.Post(self.new_entry,
+ '/feeds/documents/private/full')
+ self.editClient.Delete(created_entry.GetEditLink().href)
+ self.assertEqual(created_entry.title.text, self.TITLE)
+ self.assertEqual(created_entry.category[0].label, 'document')
+
+ def testCreateAndDeleteEmptySpreadsheet(self):
+ self.new_entry.title = gdata.atom.Title(text=self.TITLE)
+ self.new_entry.category[0] = self.SPREADSHEET_CATEGORY
+ created_entry = self.client.Post(self.new_entry,
+ '/feeds/documents/private/full')
+ self.editClient.Delete(created_entry.GetEditLink().href)
+ self.assertEqual(created_entry.title.text, self.TITLE)
+ self.assertEqual(created_entry.category[0].label, 'viewed')
+ self.assertEqual(created_entry.category[1].label, 'spreadsheet')
+
+ def testCreateAndDeleteEmptyPresentation(self):
+ self.new_entry.title = gdata.atom.Title(text=self.TITLE)
+ self.new_entry.category[0] = self.PRESENTATION_CATEGORY
+ created_entry = self.client.Post(self.new_entry,
+ '/feeds/documents/private/full')
+ self.editClient.Delete(created_entry.GetEditLink().href)
+ self.assertEqual(created_entry.title.text, self.TITLE)
+ self.assertEqual(created_entry.category[0].label, 'viewed')
+ self.assertEqual(created_entry.category[1].label, 'presentation')
+
+ def testCreateAndDeleteFolder(self):
+ folder_name = 'TestFolder'
+ folder = self.client.CreateFolder(folder_name)
+ self.assertEqual(folder.title.text, folder_name)
+ self.editClient.Delete(folder.GetEditLink().href)
+
+ def testCreateAndDeleteFolderInFolder(self):
+ DEST_FOLDER_NAME = 'TestFolder'
+ dest_folder = self.client.CreateFolder(DEST_FOLDER_NAME)
+
+ CREATED_FOLDER_NAME = 'TestFolder2'
+ new_folder = self.client.CreateFolder(CREATED_FOLDER_NAME, dest_folder)
+
+ for category in new_folder.category:
+ if category.scheme.startswith(gdata.docs.service.FOLDERS_SCHEME_PREFIX):
+ self.assertEqual(new_folder.category[0].label, DEST_FOLDER_NAME)
+ break
+
+ # delete the folders we created, this will also delete the child folder
+ dest_folder = self.client.Get(dest_folder.GetSelfLink().href)
+ self.editClient.Delete(dest_folder.GetEditLink().href)
+
+
+class DocumentListMoveInAndOutOfFolderTest(DocumentsListServiceTest):
+ def setUp(self):
+ DocumentsListServiceTest.setUp(self)
+ self.folder_name = 'TestFolder'
+ self.folder = self.client.CreateFolder(self.folder_name)
+
+ self.doc_title = 'TestDoc'
+ self.ms = gdata.MediaSource(file_path='test.doc',
+ content_type='application/msword')
+
+ def tearDown(self):
+ folder = self.client.Get(self.folder.GetSelfLink().href)
+ self.editClient.Delete(folder.GetEditLink().href)
+
+ def testUploadDocumentToFolder(self):
+ created_entry = self.client.Upload(self.ms, self.doc_title,
+ self.folder)
+ for category in created_entry.category:
+ if category.scheme.startswith(gdata.docs.service.FOLDERS_SCHEME_PREFIX):
+ self.assertEqual(category.label, self.folder_name)
+ break
+
+ # delete the doc we created
+ created_entry = self.client.Get(created_entry.GetSelfLink().href)
+ match = re.search('\/(document%3A[^\/]*)\/?.*?\/(.*)$',
+ created_entry.GetEditLink().href)
+ edit_uri = 'http://docs.google.com/feeds/documents/private/full/'
+ edit_uri += '%s/%s' % (match.group(1), match.group(2))
+ self.editClient.Delete(edit_uri)
+
+ def testMoveDocumentInAndOutOfFolder(self):
+ created_entry = self.client.Upload(self.ms, self.doc_title)
+ moved_entry = self.client.MoveIntoFolder(created_entry,
+ self.folder)
+ for category in moved_entry.category:
+ if category.scheme.startswith(gdata.docs.service.FOLDERS_SCHEME_PREFIX):
+ self.assertEqual(category.label, self.folder_name)
+ break
+
+ self.editClient.MoveOutOfFolder(moved_entry)
+ moved_entry = self.client.Get(moved_entry.GetSelfLink().href)
+ for category in moved_entry.category:
+ starts_with_folder__prefix = category.scheme.startswith(
+ gdata.docs.service.FOLDERS_SCHEME_PREFIX)
+ self.assert_(not starts_with_folder__prefix)
+
+ created_entry = self.client.Get(created_entry.GetSelfLink().href)
+ self.editClient.Delete(created_entry.GetEditLink().href)
+
+ def testMoveFolderIntoFolder(self):
+ dest_folder_name = 'DestFolderName'
+ dest_folder = self.client.CreateFolder(dest_folder_name)
+ self.client.MoveIntoFolder(self.folder, dest_folder)
+
+ self.folder = self.client.Get(self.folder.GetSelfLink().href)
+ folder_was_moved = False
+ for category in self.folder.category:
+ if category.term == dest_folder_name:
+ folder_was_moved = True
+ break
+ self.assert_(folder_was_moved)
+
+ #cleanup
+ dest_folder = self.client.Get(dest_folder.GetSelfLink().href)
+ self.editClient.Delete(dest_folder.GetEditLink().href)
+
+
+class DocumentListUploadTest(DocumentsListServiceTest):
+
+ def testUploadAndDeleteDocument(self):
+ ms = gdata.MediaSource(file_path='test.doc',
+ content_type='application/msword')
+ entry = self.client.Upload(ms, 'test doc')
+ self.assertEqual(entry.title.text, 'test doc')
+ self.assertEqual(entry.category[0].label, 'document')
+ self.assert_(isinstance(entry, gdata.docs.DocumentListEntry))
+ self.editClient.Delete(entry.GetEditLink().href)
+
+ def testUploadAndDeletePresentation(self):
+ ms = gdata.MediaSource(file_path='test.ppt',
+ content_type='application/vnd.ms-powerpoint')
+ entry = self.client.Upload(ms, 'test preso')
+ self.assertEqual(entry.title.text, 'test preso')
+ self.assertEqual(entry.category[0].label, 'viewed')
+ self.assertEqual(entry.category[1].label, 'presentation')
+ self.assert_(isinstance(entry, gdata.docs.DocumentListEntry))
+ self.editClient.Delete(entry.GetEditLink().href)
+
+ def testUploadAndDeleteSpreadsheet(self):
+ ms = gdata.MediaSource(file_path='test.csv',
+ content_type='text/csv')
+ entry = self.client.Upload(ms, 'test spreadsheet')
+ self.assert_(entry.title.text == 'test spreadsheet')
+ self.assertEqual(entry.category[0].label, 'viewed')
+ self.assertEqual(entry.category[1].label, 'spreadsheet')
+ self.assert_(isinstance(entry, gdata.docs.DocumentListEntry))
+ self.editClient.Delete(entry.GetEditLink().href)
+
+
+class DocumentListUpdateTest(DocumentsListServiceTest):
+ def setUp(self):
+ DocumentsListServiceTest.setUp(self)
+ self.TITLE = 'CreatedTestDoc'
+ new_entry = gdata.docs.DocumentListEntry()
+ new_entry.title = gdata.atom.Title(text=self.TITLE)
+ new_entry.category.append(self.DOCUMENT_CATEGORY)
+ self.created_entry = self.client.Post(new_entry,
+ '/feeds/documents/private/full')
+
+ def tearDown(self):
+ # Delete the test doc we created
+ self_link = self.created_entry.GetSelfLink().href
+ entry = self.client.GetDocumentListEntry(self_link)
+ self.editClient.Delete(entry.GetEditLink().href)
+
+ def testUpdateDocumentMetadataAndContent(self):
+ title = 'UpdatedTestDoc'
+ # Update metadata
+ self.created_entry.title.text = title
+ updated_entry = self.editClient.Put(self.created_entry,
+ self.created_entry.GetEditLink().href)
+ self.assertEqual(updated_entry.title.text, title)
+
+ # Update document's content
+ ms = gdata.MediaSource(file_path='test.doc',
+ content_type='application/msword')
+ uri = updated_entry.GetEditMediaLink().href
+ updated_entry = self.editClient.Put(ms, uri)
+ self.assertEqual(updated_entry.title.text, title)
+
+ # Append content to document
+ data = 'data to append'
+ ms = gdata.MediaSource(file_handle=StringIO.StringIO(data),
+ content_type='text/plain',
+ content_length=len(data))
+ uri = updated_entry.GetEditMediaLink().href + '?append=true'
+ updated_entry = self.editClient.Put(ms, uri)
+
+
+class DocumentListExportTest(DocumentsListServiceTest):
+
+ def testExportDocument(self):
+ query = ('https://docs.google.com/feeds/documents/private/full'
+ '/-/document?max-results=1')
+ feed = self.client.QueryDocumentListFeed(query)
+ file_paths = ['./downloadedTest.doc', './downloadedTest.html',
+ './downloadedTest.odt', './downloadedTest.pdf',
+ './downloadedTest.png', './downloadedTest.rtf',
+ './downloadedTest.txt', './downloadedTest.zip']
+ for path in file_paths:
+ self.client.Export(feed.entry[0], path)
+ self.assert_(os.path.exists(path))
+ self.assert_(os.path.getsize(path))
+ os.remove(path)
+
+ def testExportPresentation(self):
+ query = ('https://docs.google.com/feeds/documents/private/full'
+ '/-/presentation?max-results=1')
+ feed = self.client.QueryDocumentListFeed(query)
+ file_paths = ['./downloadedTest.pdf', './downloadedTest.ppt',
+ './downloadedTest.swf', './downloadedTest.txt']
+ for path in file_paths:
+ self.client.Export(feed.entry[0].resourceId.text, path)
+ self.assert_(os.path.exists(path))
+ self.assert_(os.path.getsize(path))
+ os.remove(path)
+
+ def testExportSpreadsheet(self):
+ query = ('https://docs.google.com/feeds/documents/private/full'
+ '/-/spreadsheet?max-results=1')
+ feed = self.client.QueryDocumentListFeed(query)
+ file_paths = ['./downloadedTest.xls', './downloadedTest.csv',
+ './downloadedTest.pdf', './downloadedTest.ods',
+ './downloadedTest.tsv', './downloadedTest.html']
+ docs_token = self.client.GetClientLoginToken()
+ self.client.SetClientLoginToken(self.spreadsheets.GetClientLoginToken())
+ for path in file_paths:
+ self.client.Export(feed.entry[0], path)
+ self.assert_(os.path.exists(path))
+ self.assert_(os.path.getsize(path) > 0)
+ os.remove(path)
+ self.client.SetClientLoginToken(docs_token)
+
+ def testExportNonExistentDocument(self):
+ path = './ned.txt'
+ exception_raised = False
+ try:
+ self.client.Export('non_existent_doc', path)
+ except Exception, e: # expected
+ exception_raised = True
+ self.assert_(exception_raised)
+ self.assert_(not os.path.exists(path))
+
+if __name__ == '__main__':
+ print ('DocList API Tests\nNOTE: Please run these tests only with a test '
+ 'account. The tests may delete or update your data.')
+ username = raw_input('Please enter your username: ')
+ password = getpass.getpass()
+ if client.GetClientLoginToken() is None:
+ client.ClientLogin(username, password,
+ source='Document List Client Unit Tests')
+ if spreadsheets.GetClientLoginToken() is None:
+ spreadsheets.ClientLogin(username, password,
+ source='Document List Client Unit Tests')
+
+ unittest.main()
diff --git a/tests/gdata_tests/docs_test.py b/tests/gdata_tests/docs_test.py
new file mode 100755
index 0000000..ed13ce3
--- /dev/null
+++ b/tests/gdata_tests/docs_test.py
@@ -0,0 +1,158 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = ('api.jfisher (Jeff Fisher), '
+ 'api.eric@google.com (Eric Bidelman)')
+
+import unittest
+from gdata import test_data
+import gdata.docs
+
+class DocumentListEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.dl_entry = gdata.docs.DocumentListEntryFromString(
+ test_data.DOCUMENT_LIST_ENTRY)
+
+ def testToAndFromStringWithData(self):
+ entry = gdata.docs.DocumentListEntryFromString(str(self.dl_entry))
+
+ self.assertEqual(entry.author[0].name.text, 'test.user')
+ self.assertEqual(entry.author[0].email.text, 'test.user@gmail.com')
+ self.assertEqual(entry.GetDocumentType(), 'spreadsheet')
+ self.assertEqual(entry.id.text,
+ 'https://docs.google.com/feeds/documents/private/full/' +\
+ 'spreadsheet%3Asupercalifragilisticexpealidocious')
+ self.assertEqual(entry.title.text,'Test Spreadsheet')
+ self.assertEqual(entry.resourceId.text,
+ 'spreadsheet:supercalifragilisticexpealidocious')
+ self.assertEqual(entry.lastModifiedBy.name.text,'test.user')
+ self.assertEqual(entry.lastModifiedBy.email.text,'test.user@gmail.com')
+ self.assertEqual(entry.lastViewed.text,'2009-03-05T07:48:21.493Z')
+ self.assertEqual(entry.writersCanInvite.value, 'true')
+
+
+class DocumentListFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.dl_feed = gdata.docs.DocumentListFeedFromString(
+ test_data.DOCUMENT_LIST_FEED)
+
+ def testToAndFromString(self):
+ self.assert_(len(self.dl_feed.entry) == 2)
+ for an_entry in self.dl_feed.entry:
+ self.assert_(isinstance(an_entry, gdata.docs.DocumentListEntry))
+ new_dl_feed = gdata.docs.DocumentListFeedFromString(str(self.dl_feed))
+ for an_entry in new_dl_feed.entry:
+ self.assert_(isinstance(an_entry, gdata.docs.DocumentListEntry))
+
+ def testConvertActualData(self):
+ for an_entry in self.dl_feed.entry:
+ self.assertEqual(an_entry.author[0].name.text, 'test.user')
+ self.assertEqual(an_entry.author[0].email.text, 'test.user@gmail.com')
+ self.assertEqual(an_entry.lastModifiedBy.name.text, 'test.user')
+ self.assertEqual(an_entry.lastModifiedBy.email.text,
+ 'test.user@gmail.com')
+ self.assertEqual(an_entry.lastViewed.text,'2009-03-05T07:48:21.493Z')
+ if(an_entry.GetDocumentType() == 'spreadsheet'):
+ self.assertEqual(an_entry.title.text, 'Test Spreadsheet')
+ self.assertEqual(an_entry.writersCanInvite.value, 'true')
+ elif(an_entry.GetDocumentType() == 'document'):
+ self.assertEqual(an_entry.title.text, 'Test Document')
+ self.assertEqual(an_entry.writersCanInvite.value, 'false')
+
+ def testLinkFinderFindsLinks(self):
+ for entry in self.dl_feed.entry:
+ # All Document List entries should have a self link
+ self.assert_(entry.GetSelfLink() is not None)
+ # All Document List entries should have an HTML link
+ self.assert_(entry.GetHtmlLink() is not None)
+ self.assert_(entry.feedLink.href is not None)
+
+
+class DocumentListAclEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.acl_entry = gdata.docs.DocumentListAclEntryFromString(
+ test_data.DOCUMENT_LIST_ACL_ENTRY)
+
+
+ def testToAndFromString(self):
+ self.assert_(isinstance(self.acl_entry, gdata.docs.DocumentListAclEntry))
+ self.assert_(isinstance(self.acl_entry.role, gdata.docs.Role))
+ self.assert_(isinstance(self.acl_entry.scope, gdata.docs.Scope))
+ self.assertEqual(self.acl_entry.scope.value, 'user@gmail.com')
+ self.assertEqual(self.acl_entry.scope.type, 'user')
+ self.assertEqual(self.acl_entry.role.value, 'writer')
+
+ acl_entry_str = str(self.acl_entry)
+ new_acl_entry = gdata.docs.DocumentListAclEntryFromString(acl_entry_str)
+ self.assert_(isinstance(new_acl_entry, gdata.docs.DocumentListAclEntry))
+ self.assert_(isinstance(new_acl_entry.role, gdata.docs.Role))
+ self.assert_(isinstance(new_acl_entry.scope, gdata.docs.Scope))
+ self.assertEqual(new_acl_entry.scope.value, self.acl_entry.scope.value)
+ self.assertEqual(new_acl_entry.scope.type, self.acl_entry.scope.type)
+ self.assertEqual(new_acl_entry.role.value, self.acl_entry.role.value)
+
+ def testCreateNewAclEntry(self):
+ cat = gdata.atom.Category(
+ term='http://schemas.google.com/acl/2007#accessRule',
+ scheme='http://schemas.google.com/g/2005#kind')
+ acl_entry = gdata.docs.DocumentListAclEntry(category=[cat])
+ acl_entry.scope = gdata.docs.Scope(value='user@gmail.com', type='user')
+ acl_entry.role = gdata.docs.Role(value='writer')
+ self.assert_(isinstance(acl_entry, gdata.docs.DocumentListAclEntry))
+ self.assert_(isinstance(acl_entry.role, gdata.docs.Role))
+ self.assert_(isinstance(acl_entry.scope, gdata.docs.Scope))
+ self.assertEqual(acl_entry.scope.value, 'user@gmail.com')
+ self.assertEqual(acl_entry.scope.type, 'user')
+ self.assertEqual(acl_entry.role.value, 'writer')
+
+class DocumentListAclFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.docs.DocumentListAclFeedFromString(
+ test_data.DOCUMENT_LIST_ACL_FEED)
+
+ def testToAndFromString(self):
+ for entry in self.feed.entry:
+ self.assert_(isinstance(entry, gdata.docs.DocumentListAclEntry))
+
+ feed = gdata.docs.DocumentListAclFeedFromString(str(self.feed))
+ for entry in feed.entry:
+ self.assert_(isinstance(entry, gdata.docs.DocumentListAclEntry))
+
+ def testConvertActualData(self):
+ entries = self.feed.entry
+ self.assert_(len(entries) == 2)
+ self.assertEqual(entries[0].title.text,
+ 'Document Permission - user@gmail.com')
+ self.assertEqual(entries[0].role.value, 'owner')
+ self.assertEqual(entries[0].scope.type, 'user')
+ self.assertEqual(entries[0].scope.value, 'user@gmail.com')
+ self.assert_(entries[0].GetSelfLink() is not None)
+ self.assert_(entries[0].GetEditLink() is not None)
+ self.assertEqual(entries[1].title.text,
+ 'Document Permission - user2@google.com')
+ self.assertEqual(entries[1].role.value, 'writer')
+ self.assertEqual(entries[1].scope.type, 'domain')
+ self.assertEqual(entries[1].scope.value, 'google.com')
+ self.assert_(entries[1].GetSelfLink() is not None)
+ self.assert_(entries[1].GetEditLink() is not None)
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/gauth_test.py b/tests/gdata_tests/gauth_test.py
new file mode 100755
index 0000000..e0323d2
--- /dev/null
+++ b/tests/gdata_tests/gauth_test.py
@@ -0,0 +1,796 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import sys
+import types
+import unittest
+
+import gdata.gauth
+import atom.http_core
+import gdata.test_config as conf
+
+
+PRIVATE_TEST_KEY = """
+ -----BEGIN PRIVATE KEY-----
+ MIICdgIBADANBgkqhkiG9w0BAQEFAASCAmAwggJcAgEAAoGBALRiMLAh9iimur8V
+ A7qVvdqxevEuUkW4K+2KdMXmnQbG9Aa7k7eBjK1S+0LYmVjPKlJGNXHDGuy5Fw/d
+ 7rjVJ0BLB+ubPK8iA/Tw3hLQgXMRRGRXXCn8ikfuQfjUS1uZSatdLB81mydBETlJ
+ hI6GH4twrbDJCR2Bwy/XWXgqgGRzAgMBAAECgYBYWVtleUzavkbrPjy0T5FMou8H
+ X9u2AC2ry8vD/l7cqedtwMPp9k7TubgNFo+NGvKsl2ynyprOZR1xjQ7WgrgVB+mm
+ uScOM/5HVceFuGRDhYTCObE+y1kxRloNYXnx3ei1zbeYLPCHdhxRYW7T0qcynNmw
+ rn05/KO2RLjgQNalsQJBANeA3Q4Nugqy4QBUCEC09SqylT2K9FrrItqL2QKc9v0Z
+ zO2uwllCbg0dwpVuYPYXYvikNHHg+aCWF+VXsb9rpPsCQQDWR9TT4ORdzoj+Nccn
+ qkMsDmzt0EfNaAOwHOmVJ2RVBspPcxt5iN4HI7HNeG6U5YsFBb+/GZbgfBT3kpNG
+ WPTpAkBI+gFhjfJvRw38n3g/+UeAkwMI2TJQS4n8+hid0uus3/zOjDySH3XHCUno
+ cn1xOJAyZODBo47E+67R4jV1/gzbAkEAklJaspRPXP877NssM5nAZMU0/O/NGCZ+
+ 3jPgDUno6WbJn5cqm8MqWhW1xGkImgRk+fkDBquiq4gPiT898jusgQJAd5Zrr6Q8
+ AO/0isr/3aa6O6NLQxISLKcPDk2NOccAfS/xOtfOz4sJYM3+Bs4Io9+dZGSDCA54
+ Lw03eHTNQghS0A==
+ -----END PRIVATE KEY-----"""
+
+
+class AuthSubTest(unittest.TestCase):
+
+ def test_generate_request_url(self):
+ url = gdata.gauth.generate_auth_sub_url('http://example.com',
+ ['http://example.net/scope1'])
+ self.assert_(isinstance(url, atom.http_core.Uri))
+ self.assertEqual(url.query['secure'], '0')
+ self.assertEqual(url.query['session'], '1')
+ self.assertEqual(url.query['scope'], 'http://example.net/scope1')
+ self.assertEqual(atom.http_core.Uri.parse_uri(
+ url.query['next']).query['auth_sub_scopes'],
+ 'http://example.net/scope1')
+ self.assertEqual(atom.http_core.Uri.parse_uri(url.query['next']).path,
+ '/')
+ self.assertEqual(atom.http_core.Uri.parse_uri(url.query['next']).host,
+ 'example.com')
+
+ def test_from_url(self):
+ token_str = gdata.gauth.auth_sub_string_from_url(
+ 'http://example.com/?token=123abc')[0]
+ self.assertEqual(token_str, '123abc')
+
+ def test_from_http_body(self):
+ token_str = gdata.gauth.auth_sub_string_from_body('Something\n'
+ 'Token=DQAA...7DCTN\n'
+ 'Expiration=20061004T123456Z\n')
+ self.assertEqual(token_str, 'DQAA...7DCTN')
+
+ def test_modify_request(self):
+ token = gdata.gauth.AuthSubToken('tval')
+ request = atom.http_core.HttpRequest()
+ token.modify_request(request)
+ self.assertEqual(request.headers['Authorization'], 'AuthSub token=tval')
+
+ def test_create_and_upgrade_tokens(self):
+ token = gdata.gauth.AuthSubToken.from_url(
+ 'http://example.com/?token=123abc')
+ self.assert_(isinstance(token, gdata.gauth.AuthSubToken))
+ self.assertEqual(token.token_string, '123abc')
+ self.assertEqual(token.scopes, [])
+ token._upgrade_token('Token=456def')
+ self.assertEqual(token.token_string, '456def')
+ self.assertEqual(token.scopes, [])
+
+
+class SecureAuthSubTest(unittest.TestCase):
+
+ def test_build_data(self):
+ request = atom.http_core.HttpRequest(method='PUT')
+ request.uri = atom.http_core.Uri.parse_uri('http://example.com/foo?a=1')
+ data = gdata.gauth.build_auth_sub_data(request, 1234567890, 'mynonce')
+ self.assertEqual(data,
+ 'PUT http://example.com/foo?a=1 1234567890 mynonce')
+
+ def test_generate_signature(self):
+ request = atom.http_core.HttpRequest(
+ method='GET', uri=atom.http_core.Uri(host='example.com', path='/foo',
+ query={'a': '1'}))
+ data = gdata.gauth.build_auth_sub_data(request, 1134567890, 'p234908')
+ self.assertEqual(data,
+ 'GET http://example.com/foo?a=1 1134567890 p234908')
+ self.assertEqual(
+ gdata.gauth.generate_signature(data, PRIVATE_TEST_KEY),
+ 'GeBfeIDnT41dvLquPgDB4U5D4hfxqaHk/5LX1kccNBnL4BjsHWU1djbEp7xp3BL9ab'
+ 'QtLrK7oa/aHEHtGRUZGg87O+ND8iDPR76WFXAruuN8O8GCMqCDdPduNPY++LYO4MdJ'
+ 'BZNY974Nn0m6Hc0/T4M1ElqvPhl61fkXMm+ElSM=')
+
+
+class TokensToAndFromBlobsTest(unittest.TestCase):
+
+ def test_client_login_conversion(self):
+ token = gdata.gauth.ClientLoginToken('test|key')
+ copy = gdata.gauth.token_from_blob(gdata.gauth.token_to_blob(token))
+ self.assertEqual(token.token_string, copy.token_string)
+ self.assert_(isinstance(copy, gdata.gauth.ClientLoginToken))
+
+ def test_authsub_conversion(self):
+ token = gdata.gauth.AuthSubToken('test|key')
+ copy = gdata.gauth.token_from_blob(gdata.gauth.token_to_blob(token))
+ self.assertEqual(token.token_string, copy.token_string)
+ self.assert_(isinstance(copy, gdata.gauth.AuthSubToken))
+
+ scopes = ['http://example.com', 'http://other||test', 'thir|d']
+ token = gdata.gauth.AuthSubToken('key-=', scopes)
+ copy = gdata.gauth.token_from_blob(gdata.gauth.token_to_blob(token))
+ self.assertEqual(token.token_string, copy.token_string)
+ self.assert_(isinstance(copy, gdata.gauth.AuthSubToken))
+ self.assertEqual(token.scopes, scopes)
+
+ def test_join_and_split(self):
+ token_string = gdata.gauth._join_token_parts('1x', 'test|string', '%x%',
+ '', None)
+ self.assertEqual(token_string, '1x|test%7Cstring|%25x%25||')
+ token_type, a, b, c, d = gdata.gauth._split_token_parts(token_string)
+ self.assertEqual(token_type, '1x')
+ self.assertEqual(a, 'test|string')
+ self.assertEqual(b, '%x%')
+ self.assert_(c is None)
+ self.assert_(d is None)
+
+ def test_secure_authsub_conversion(self):
+ token = gdata.gauth.SecureAuthSubToken(
+ '%^%', 'myRsaKey', ['http://example.com', 'http://example.org'])
+ copy = gdata.gauth.token_from_blob(gdata.gauth.token_to_blob(token))
+ self.assertEqual(copy.token_string, '%^%')
+ self.assertEqual(copy.rsa_private_key, 'myRsaKey')
+ self.assertEqual(copy.scopes,
+ ['http://example.com', 'http://example.org'])
+
+ token = gdata.gauth.SecureAuthSubToken(rsa_private_key='f',
+ token_string='b')
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(blob, '1s|b|f')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assertEqual(copy.token_string, 'b')
+ self.assertEqual(copy.rsa_private_key, 'f')
+ self.assertEqual(copy.scopes, [])
+
+ token = gdata.gauth.SecureAuthSubToken(None, '')
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(blob, '1s||')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assertEqual(copy.token_string, None)
+ self.assertEqual(copy.rsa_private_key, None)
+ self.assertEqual(copy.scopes, [])
+
+ token = gdata.gauth.SecureAuthSubToken('', None)
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(blob, '1s||')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assertEqual(copy.token_string, None)
+ self.assertEqual(copy.rsa_private_key, None)
+ self.assertEqual(copy.scopes, [])
+
+ token = gdata.gauth.SecureAuthSubToken(
+ None, None, ['http://example.net', 'http://google.com'])
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(
+ blob, '1s|||http%3A%2F%2Fexample.net|http%3A%2F%2Fgoogle.com')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assert_(copy.token_string is None)
+ self.assert_(copy.rsa_private_key is None)
+ self.assertEqual(copy.scopes, ['http://example.net', 'http://google.com'])
+
+ def test_oauth_rsa_conversion(self):
+ token = gdata.gauth.OAuthRsaToken(
+ 'consumerKey', 'myRsa', 't', 'secret',
+ gdata.gauth.AUTHORIZED_REQUEST_TOKEN, 'http://example.com/next',
+ 'verifier')
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(
+ blob, '1r|consumerKey|myRsa|t|secret|2|http%3A%2F%2Fexample.com'
+ '%2Fnext|verifier')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assert_(isinstance(copy, gdata.gauth.OAuthRsaToken))
+ self.assertEqual(copy.consumer_key, token.consumer_key)
+ self.assertEqual(copy.rsa_private_key, token.rsa_private_key)
+ self.assertEqual(copy.token, token.token)
+ self.assertEqual(copy.token_secret, token.token_secret)
+ self.assertEqual(copy.auth_state, token.auth_state)
+ self.assertEqual(copy.next, token.next)
+ self.assertEqual(copy.verifier, token.verifier)
+
+ token = gdata.gauth.OAuthRsaToken(
+ '', 'myRsa', 't', 'secret', 0)
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(blob, '1r||myRsa|t|secret|0||')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assert_(isinstance(copy, gdata.gauth.OAuthRsaToken))
+ self.assert_(copy.consumer_key != token.consumer_key)
+ self.assert_(copy.consumer_key is None)
+ self.assertEqual(copy.rsa_private_key, token.rsa_private_key)
+ self.assertEqual(copy.token, token.token)
+ self.assertEqual(copy.token_secret, token.token_secret)
+ self.assertEqual(copy.auth_state, token.auth_state)
+ self.assertEqual(copy.next, token.next)
+ self.assert_(copy.next is None)
+ self.assertEqual(copy.verifier, token.verifier)
+ self.assert_(copy.verifier is None)
+
+ token = gdata.gauth.OAuthRsaToken(
+ rsa_private_key='myRsa', token='t', token_secret='secret',
+ auth_state=gdata.gauth.ACCESS_TOKEN, verifier='v', consumer_key=None)
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(blob, '1r||myRsa|t|secret|3||v')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assertEqual(copy.consumer_key, token.consumer_key)
+ self.assert_(copy.consumer_key is None)
+ self.assertEqual(copy.rsa_private_key, token.rsa_private_key)
+ self.assertEqual(copy.token, token.token)
+ self.assertEqual(copy.token_secret, token.token_secret)
+ self.assertEqual(copy.auth_state, token.auth_state)
+ self.assertEqual(copy.next, token.next)
+ self.assert_(copy.next is None)
+ self.assertEqual(copy.verifier, token.verifier)
+
+ def test_oauth_hmac_conversion(self):
+ token = gdata.gauth.OAuthHmacToken(
+ 'consumerKey', 'consumerSecret', 't', 'secret',
+ gdata.gauth.REQUEST_TOKEN, 'http://example.com/next', 'verifier')
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(
+ blob, '1h|consumerKey|consumerSecret|t|secret|1|http%3A%2F%2F'
+ 'example.com%2Fnext|verifier')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assert_(isinstance(copy, gdata.gauth.OAuthHmacToken))
+ self.assertEqual(copy.consumer_key, token.consumer_key)
+ self.assertEqual(copy.consumer_secret, token.consumer_secret)
+ self.assertEqual(copy.token, token.token)
+ self.assertEqual(copy.token_secret, token.token_secret)
+ self.assertEqual(copy.auth_state, token.auth_state)
+ self.assertEqual(copy.next, token.next)
+ self.assertEqual(copy.verifier, token.verifier)
+
+ token = gdata.gauth.OAuthHmacToken(
+ consumer_secret='c,s', token='t', token_secret='secret',
+ auth_state=7, verifier='v', consumer_key=None)
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(blob, '1h||c%2Cs|t|secret|7||v')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assert_(isinstance(copy, gdata.gauth.OAuthHmacToken))
+ self.assertEqual(copy.consumer_key, token.consumer_key)
+ self.assert_(copy.consumer_key is None)
+ self.assertEqual(copy.consumer_secret, token.consumer_secret)
+ self.assertEqual(copy.token, token.token)
+ self.assertEqual(copy.token_secret, token.token_secret)
+ self.assertEqual(copy.auth_state, token.auth_state)
+ self.assertEqual(copy.next, token.next)
+ self.assert_(copy.next is None)
+ self.assertEqual(copy.verifier, token.verifier)
+
+ def test_oauth2_conversion(self):
+ token = gdata.gauth.OAuth2Token(
+ 'clientId', 'clientSecret', 'https://www.google.com/calendar/feeds',
+ 'userAgent', 'https://accounts.google.com/o/oauth2/auth',
+ 'https://accounts.google.com/o/oauth2/token',
+ 'accessToken', 'refreshToken')
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(
+ blob, '2o|clientId|clientSecret|https%3A%2F%2Fwww.google.com%2F'
+ 'calendar%2Ffeeds|userAgent|https%3A%2F%2Faccounts.google.com%2F'
+ 'o%2Foauth2%2Fauth|https%3A%2F%2Faccounts.google.com%2Fo%2Foauth2'
+ '%2Ftoken|accessToken|refreshToken')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assert_(isinstance(copy, gdata.gauth.OAuth2Token))
+
+ self.assertEqual(copy.client_id, token.client_id)
+ self.assertEqual(copy.client_secret, token.client_secret)
+ self.assertEqual(copy.scope, token.scope)
+ self.assertEqual(copy.user_agent, token.user_agent)
+ self.assertEqual(copy.auth_uri, token.auth_uri)
+ self.assertEqual(copy.token_uri, token.token_uri)
+ self.assertEqual(copy.access_token, token.access_token)
+ self.assertEqual(copy.refresh_token, token.refresh_token)
+
+ token = gdata.gauth.OAuth2Token(
+ 'clientId', 'clientSecret', 'https://www.google.com/calendar/feeds',
+ '', 'https://accounts.google.com/o/oauth2/auth',
+ 'https://accounts.google.com/o/oauth2/token',
+ '', '')
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(
+ blob, '2o|clientId|clientSecret|https%3A%2F%2Fwww.google.com%2F'
+ 'calendar%2Ffeeds||https%3A%2F%2Faccounts.google.com%2F'
+ 'o%2Foauth2%2Fauth|https%3A%2F%2Faccounts.google.com%2Fo%2Foauth2'
+ '%2Ftoken||')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assert_(isinstance(copy, gdata.gauth.OAuth2Token))
+
+ self.assertEqual(copy.client_id, token.client_id)
+ self.assertEqual(copy.client_secret, token.client_secret)
+ self.assertEqual(copy.scope, token.scope)
+ self.assert_(copy.user_agent is None)
+ self.assertEqual(copy.auth_uri, token.auth_uri)
+ self.assertEqual(copy.token_uri, token.token_uri)
+ self.assert_(copy.access_token is None)
+ self.assert_(copy.refresh_token is None)
+
+ token = gdata.gauth.OAuth2Token(
+ 'clientId', 'clientSecret', 'https://www.google.com/calendar/feeds',
+ None, 'https://accounts.google.com/o/oauth2/auth',
+ 'https://accounts.google.com/o/oauth2/token')
+ blob = gdata.gauth.token_to_blob(token)
+ self.assertEqual(
+ blob, '2o|clientId|clientSecret|https%3A%2F%2Fwww.google.com%2F'
+ 'calendar%2Ffeeds||https%3A%2F%2Faccounts.google.com%2F'
+ 'o%2Foauth2%2Fauth|https%3A%2F%2Faccounts.google.com%2Fo%2Foauth2'
+ '%2Ftoken||')
+ copy = gdata.gauth.token_from_blob(blob)
+ self.assert_(isinstance(copy, gdata.gauth.OAuth2Token))
+
+ self.assertEqual(copy.client_id, token.client_id)
+ self.assertEqual(copy.client_secret, token.client_secret)
+ self.assertEqual(copy.scope, token.scope)
+ self.assert_(copy.user_agent is None)
+ self.assertEqual(copy.auth_uri, token.auth_uri)
+ self.assertEqual(copy.token_uri, token.token_uri)
+ self.assert_(copy.access_token is None)
+ self.assert_(copy.refresh_token is None)
+
+ def test_illegal_token_types(self):
+ class MyToken(object):
+ pass
+
+ token = MyToken()
+ self.assertRaises(gdata.gauth.UnsupportedTokenType,
+ gdata.gauth.token_to_blob, token)
+
+ blob = '~~z'
+ self.assertRaises(gdata.gauth.UnsupportedTokenType,
+ gdata.gauth.token_from_blob, blob)
+
+
+
+class OAuthHmacTokenTests(unittest.TestCase):
+
+ def test_build_base_string(self):
+ request = atom.http_core.HttpRequest('http://example.com/', 'GET')
+ base_string = gdata.gauth.build_oauth_base_string(
+ request, 'example.org', '12345', gdata.gauth.HMAC_SHA1, 1246301653,
+ '1.0')
+ self.assertEqual(
+ base_string, 'GET&http%3A%2F%2Fexample.com%2F&oauth_callback%3Doob%2'
+ '6oauth_consumer_key%3Dexample.org%26oauth_nonce%3D12345%26oauth_sig'
+ 'nature_method%3DHMAC-SHA1%26oauth_timestamp%3D1246301653%26oauth_ve'
+ 'rsion%3D1.0')
+
+ # Test using example from documentation.
+ request = atom.http_core.HttpRequest(
+ 'http://www.google.com/calendar/feeds/default/allcalendars/full'
+ '?orderby=starttime', 'GET')
+ base_string = gdata.gauth.build_oauth_base_string(
+ request, 'example.com', '4572616e48616d6d65724c61686176',
+ gdata.gauth.RSA_SHA1, 137131200, '1.0', token='1%2Fab3cd9j4ks73hf7g',
+ next='http://googlecodesamples.com/oauth_playground/index.php')
+ self.assertEqual(
+ base_string, 'GET&http%3A%2F%2Fwww.google.com%2Fcalendar%2Ffeeds%2Fd'
+ 'efault%2Fallcalendars%2Ffull&oauth_callback%3Dhttp%253A%252F%252Fgo'
+ 'oglecodesamples.com%252Foauth_playground%252Findex.php%26oauth_cons'
+ 'umer_key%3Dexample.com%26oauth_nonce%3D4572616e48616d6d65724c616861'
+ '76%26oauth_signature_method%3DRSA-SHA1%26oauth_timestamp%3D13713120'
+ '0%26oauth_token%3D1%25252Fab3cd9j4ks73hf7g%26oauth_version%3D1.0%26'
+ 'orderby%3Dstarttime')
+
+ # Test various defaults.
+ request = atom.http_core.HttpRequest('http://eXample.COM', 'get')
+ base_string = gdata.gauth.build_oauth_base_string(
+ request, 'example.org', '12345', gdata.gauth.HMAC_SHA1, 1246301653,
+ '1.0')
+ self.assertEqual(
+ base_string, 'GET&http%3A%2F%2Fexample.com%2F&oauth_callback%3Doob%2'
+ '6oauth_consumer_key%3Dexample.org%26oauth_nonce%3D12345%26oauth_sig'
+ 'nature_method%3DHMAC-SHA1%26oauth_timestamp%3D1246301653%26oauth_ve'
+ 'rsion%3D1.0')
+
+ request = atom.http_core.HttpRequest('https://eXample.COM:443', 'get')
+ base_string = gdata.gauth.build_oauth_base_string(
+ request, 'example.org', '12345', gdata.gauth.HMAC_SHA1, 1246301653,
+ '1.0', 'http://googlecodesamples.com/oauth_playground/index.php')
+ self.assertEqual(
+ base_string, 'GET&https%3A%2F%2Fexample.com%2F&oauth_callback%3Dhttp'
+ '%253A%252F%252Fgooglecodesamples.com%252Foauth_playground%252Findex'
+ '.php%26oauth_consumer_key%3Dexample.org%26oauth_nonce%3D12345%26oau'
+ 'th_signature_method%3DHMAC-SHA1%26oauth_timestamp%3D1246301653%26oa'
+ 'uth_version%3D1.0')
+
+ request = atom.http_core.HttpRequest('http://eXample.COM:443', 'get')
+ base_string = gdata.gauth.build_oauth_base_string(
+ request, 'example.org', '12345', gdata.gauth.HMAC_SHA1, 1246301653,
+ '1.0')
+ self.assertEqual(
+ base_string, 'GET&http%3A%2F%2Fexample.com%3A443%2F&oauth_callback%3'
+ 'Doob%26oauth_consumer_key%3De'
+ 'xample.org%26oauth_nonce%3D12345%26oauth_signature_method%3DHMAC-SH'
+ 'A1%26oauth_timestamp%3D1246301653%26oauth_version%3D1.0')
+
+ request = atom.http_core.HttpRequest(
+ atom.http_core.Uri(host='eXample.COM'), 'GET')
+ base_string = gdata.gauth.build_oauth_base_string(
+ request, 'example.org', '12345', gdata.gauth.HMAC_SHA1, 1246301653,
+ '1.0', next='oob')
+ self.assertEqual(
+ base_string, 'GET&http%3A%2F%2Fexample.com%2F&oauth_callback%3Doob%2'
+ '6oauth_consumer_key%3Dexample.org%26oauth_nonce%3D12345%26oauth_sig'
+ 'nature_method%3DHMAC-SHA1%26oauth_timestamp%3D1246301653%26oauth_ve'
+ 'rsion%3D1.0')
+
+ request = atom.http_core.HttpRequest(
+ 'https://www.google.com/accounts/OAuthGetRequestToken', 'GET')
+ request.uri.query['scope'] = ('https://docs.google.com/feeds/'
+ ' http://docs.google.com/feeds/')
+ base_string = gdata.gauth.build_oauth_base_string(
+ request, 'anonymous', '48522759', gdata.gauth.HMAC_SHA1, 1246489532,
+ '1.0', 'http://googlecodesamples.com/oauth_playground/index.php')
+ self.assertEqual(
+ base_string, 'GET&https%3A%2F%2Fwww.google.com%2Faccounts%2FOAuthGet'
+ 'RequestToken&oauth_callback%3Dhttp%253A%252F%252Fgooglecodesamples.'
+ 'com%252Foauth_playground%252Findex.php%26oauth_consumer_key%3Danony'
+ 'mous%26oauth_nonce%3D4852275'
+ '9%26oauth_signature_method%3DHMAC-SHA1%26oauth_timestamp%3D12464895'
+ '32%26oauth_version%3D1.0%26scope%3Dhttps%253A%252F%252Fdocs.google.'
+ 'com%252Ffeeds%252F%2520http%253A%252F%252Fdocs.google.com%252Ffeeds'
+ '%252F')
+
+ def test_generate_hmac_signature(self):
+ # Use the example from the OAuth playground:
+ # http://googlecodesamples.com/oauth_playground/
+ request = atom.http_core.HttpRequest(
+ 'https://www.google.com/accounts/OAuthGetRequestToken?'
+ 'scope=http%3A%2F%2Fwww.blogger.com%2Ffeeds%2F', 'GET')
+ signature = gdata.gauth.generate_hmac_signature(
+ request, 'anonymous', 'anonymous', '1246491360',
+ 'c0155b3f28697c029e7a62efff44bd46', '1.0',
+ next='http://googlecodesamples.com/oauth_playground/index.php')
+ self.assertEqual(signature, '5a2GPdtAY3LWYv8IdiT3wp1Coeg=')
+
+ # Try the same request but with a non escaped Uri object.
+ request = atom.http_core.HttpRequest(
+ 'https://www.google.com/accounts/OAuthGetRequestToken', 'GET')
+ request.uri.query['scope'] = 'http://www.blogger.com/feeds/'
+ signature = gdata.gauth.generate_hmac_signature(
+ request, 'anonymous', 'anonymous', '1246491360',
+ 'c0155b3f28697c029e7a62efff44bd46', '1.0',
+ 'http://googlecodesamples.com/oauth_playground/index.php')
+ self.assertEqual(signature, '5a2GPdtAY3LWYv8IdiT3wp1Coeg=')
+
+ # A different request also checked against the OAuth playground.
+ request = atom.http_core.HttpRequest(
+ 'https://www.google.com/accounts/OAuthGetRequestToken', 'GET')
+ request.uri.query['scope'] = ('https://www.google.com/analytics/feeds/ '
+ 'http://www.google.com/base/feeds/ '
+ 'http://www.google.com/calendar/feeds/')
+ signature = gdata.gauth.generate_hmac_signature(
+ request, 'anonymous', 'anonymous', 1246491797,
+ '33209c4d7a09be4eb1d6ff18e00f8548', '1.0',
+ next='http://googlecodesamples.com/oauth_playground/index.php')
+ self.assertEqual(signature, 'kFAgTTFDIWz4/xAabIlrcZZMTq8=')
+
+
+class OAuthRsaTokenTests(unittest.TestCase):
+
+ def test_generate_rsa_signature(self):
+ request = atom.http_core.HttpRequest(
+ 'https://www.google.com/accounts/OAuthGetRequestToken?'
+ 'scope=http%3A%2F%2Fwww.blogger.com%2Ffeeds%2F', 'GET')
+ signature = gdata.gauth.generate_rsa_signature(
+ request, 'anonymous', PRIVATE_TEST_KEY, '1246491360',
+ 'c0155b3f28697c029e7a62efff44bd46', '1.0',
+ next='http://googlecodesamples.com/oauth_playground/index.php')
+ self.assertEqual(
+ signature,
+ 'bfMantdttKaTrwoxU87JiXmMeXhAiXPiq79a5XmLlOYwwlX06Pu7CafMp7hW1fPeZtL'
+ '4o9Sz3NvPI8GECCaZk7n5vi1EJ5/wfIQbddrC8j45joBG6gFSf4tRJct82dSyn6bd71'
+ 'knwPZH1sKK46Y0ePJvEIDI3JDd7pRZuMM2sN8=')
+
+
+class OAuth2TokenTests(unittest.TestCase):
+
+ def test_generate_authorize_url(self):
+ token = gdata.gauth.OAuth2Token('clientId', 'clientSecret',
+ 'https://www.google.com/calendar/feeds',
+ 'userAgent')
+ url = token.generate_authorize_url()
+ self.assertEqual(
+ url,
+ 'https://accounts.google.com/o/oauth2/auth?access_type=offline&'
+ 'redirect_uri=urn%3Aietf%3Awg%3Aoauth%3A2.0%3Aoob&response_type=code&'
+ 'client_id=clientId&approval_prompt=auto&'
+ 'scope=https%3A%2F%2Fwww.google.com%2Fcalendar%2Ffeeds')
+ url = token.generate_authorize_url('https://www.example.com/redirect',
+ 'token')
+ self.assertEqual(
+ url,
+ 'https://accounts.google.com/o/oauth2/auth?access_type=offline&'
+ 'redirect_uri=https%3A%2F%2Fwww.example.com%2Fredirect&'
+ 'response_type=token&client_id=clientId&approval_prompt=auto&'
+ 'scope=https%3A%2F%2Fwww.google.com%2Fcalendar%2Ffeeds')
+ url = token.generate_authorize_url(access_type='online')
+ self.assertEqual(
+ url,
+ 'https://accounts.google.com/o/oauth2/auth?access_type=online&'
+ 'redirect_uri=urn%3Aietf%3Awg%3Aoauth%3A2.0%3Aoob&response_type=code&'
+ 'client_id=clientId&approval_prompt=auto&'
+ 'scope=https%3A%2F%2Fwww.google.com%2Fcalendar%2Ffeeds')
+
+ def test_modify_request(self):
+ token = gdata.gauth.OAuth2Token('clientId', 'clientSecret',
+ 'https://www.google.com/calendar/feeds',
+ 'userAgent', access_token='accessToken')
+ request = atom.http_core.HttpRequest()
+ token.modify_request(request)
+ self.assertEqual(request.headers['Authorization'], 'Bearer accessToken')
+
+
+class OAuth2TokenFromCredentialsTest(unittest.TestCase):
+ class DummyCredentials(object):
+ def __init__(self, *args, **kwargs):
+ self.client_id = 'client_id'
+ self.client_secret = 'client_secret'
+ self.user_agent = 'user_agent'
+ self.token_uri = 'token_uri'
+ self.access_token = 'access_token'
+ self.refresh_token = 'refresh_token'
+ self.token_expiry = 'token_expiry'
+ self.invalid = 'invalid'
+
+ self._refresh_called = False
+
+ def _refresh(self, unused_http_request):
+ self._refresh_called = True
+
+ def setUp(self):
+ # Don't want to force the test to have a dependency on httplib2,
+ # which is a dependency of google-api-python-client
+ self._httplib2 = sys.modules.get('httplib2')
+
+ dummy_httplib2 = types.ModuleType('httplib2')
+
+ class DummyHttp(object):
+ def request(self, *args, **kwargs):
+ pass
+
+ dummy_httplib2.Http = DummyHttp
+ sys.modules['httplib2'] = dummy_httplib2
+
+ self.credentials = self.DummyCredentials()
+ self.token = gdata.gauth.OAuth2TokenFromCredentials(self.credentials)
+
+ def tearDown(self):
+ del sys.modules['httplib2']
+ if self._httplib2 is not None:
+ sys.modules['httplib2'] = self._httplib2
+ del self._httplib2
+
+ def _check_all_values(self):
+ self.assertEqual(self.token.client_id, self.credentials.client_id)
+ self.assertEqual(self.token.client_secret, self.credentials.client_secret)
+ self.assertEqual(self.token.user_agent, self.credentials.user_agent)
+ self.assertEqual(self.token.token_uri, self.credentials.token_uri)
+ self.assertEqual(self.token.access_token, self.credentials.access_token)
+ self.assertEqual(self.token.refresh_token, self.credentials.refresh_token)
+ self.assertEqual(self.token.token_expiry, self.credentials.token_expiry)
+ self.assertEqual(self.token._invalid, self.credentials.invalid)
+
+ def test_get_proxied_attributes(self):
+ self._check_all_values()
+
+ def test_get_proxied_values_notset(self):
+ proxy_keys = ['client_id', 'client_secret', 'user_agent', 'token_uri',
+ 'access_token', 'refresh_token', 'token_expiry', '_invalid']
+ for key in proxy_keys:
+ self.assertFalse(self.token.__dict__.has_key(key))
+
+ def test_get_proxied_values_change_credentials(self):
+ new_value = 'NEW_VALUE'
+ self.credentials.access_token = new_value
+ self.assertEqual(self.token.access_token, new_value)
+
+ self.credentials.invalid = new_value
+ self.assertEqual(self.token._invalid, new_value)
+
+ def test_get_proxied_values_change_credentials(self):
+ # Make sure scope is not a valid attribute (ignored in this subclass)
+ self.assertFalse(self.token.__dict__.has_key('scope'))
+ self.assertFalse(self.token.__class__.__dict__.has_key('scope'))
+ # Make sure attribute lookup fails as it should
+ self.assertRaises(AttributeError, getattr, self.token, 'scope')
+ self.assertRaises(AttributeError, lambda: self.token.scope)
+
+ def test_set_proxied_values(self):
+ # Check all values after each setattr to make sure no side affects
+ self.token.client_id = 'value1'
+ self._check_all_values()
+ self.token.client_secret = 'value2'
+ self._check_all_values()
+ self.token.user_agent = 'value3'
+ self._check_all_values()
+ self.token.token_uri = 'value4'
+ self._check_all_values()
+ self.token.access_token = 'value5'
+ self._check_all_values()
+ self.token.refresh_token = 'value6'
+ self._check_all_values()
+ self.token.token_expiry = 'value7'
+ self._check_all_values()
+ self.token._invalid = 'value8'
+ self._check_all_values()
+
+ def test_set_proxied_values_nonprotected_attribute(self):
+ self.assertFalse(self.token.__dict__.has_key('scope'))
+ self.assertFalse(self.token.__class__.__dict__.has_key('scope'))
+ self.token.scope = 'value'
+ self.assertEqual(self.token.scope, 'value')
+ self.assertFalse(hasattr(self.credentials, 'scope'))
+ self._check_all_values()
+
+ def test_disallowed(self):
+ self.assertRaises(NotImplementedError, self.token.generate_authorize_url)
+ self.assertRaises(NotImplementedError, self.token.get_access_token)
+ self.assertRaises(NotImplementedError, self.token.revoke)
+ self.assertRaises(NotImplementedError, self.token._extract_tokens)
+
+ def test_refresh(self):
+ dummy_gdata_request_object = object()
+ self.assertFalse(self.credentials._refresh_called)
+ self.token._refresh(dummy_gdata_request_object)
+ self.assertTrue(self.credentials._refresh_called)
+
+
+class OAuthHeaderTest(unittest.TestCase):
+
+ def test_generate_auth_header(self):
+ header = gdata.gauth.generate_auth_header(
+ 'consumerkey', 1234567890, 'mynonce', 'unknown_sig_type', 'sig')
+ self.assert_(header.startswith('OAuth'))
+ self.assert_(header.find('oauth_nonce="mynonce"') > -1)
+ self.assert_(header.find('oauth_timestamp="1234567890"') > -1)
+ self.assert_(header.find('oauth_consumer_key="consumerkey"') > -1)
+ self.assert_(
+ header.find('oauth_signature_method="unknown_sig_type"') > -1)
+ self.assert_(header.find('oauth_version="1.0"') > -1)
+ self.assert_(header.find('oauth_signature="sig"') > -1)
+
+ header = gdata.gauth.generate_auth_header(
+ 'consumer/key', 1234567890, 'ab%&33', '', 'ab/+-_=')
+ self.assert_(header.find('oauth_nonce="ab%25%2633"') > -1)
+ self.assert_(header.find('oauth_consumer_key="consumer%2Fkey"') > -1)
+ self.assert_(header.find('oauth_signature_method=""') > -1)
+ self.assert_(header.find('oauth_signature="ab%2F%2B-_%3D"') > -1)
+
+
+class OAuthGetRequestToken(unittest.TestCase):
+
+ def test_request_hmac_request_token(self):
+ request = gdata.gauth.generate_request_for_request_token(
+ 'anonymous', gdata.gauth.HMAC_SHA1,
+ ['http://www.blogger.com/feeds/',
+ 'http://www.google.com/calendar/feeds/'],
+ consumer_secret='anonymous')
+ request_uri = str(request.uri)
+ self.assert_('http%3A%2F%2Fwww.blogger.com%2Ffeeds%2F' in request_uri)
+ self.assert_(
+ 'http%3A%2F%2Fwww.google.com%2Fcalendar%2Ffeeds%2F' in request_uri)
+ auth_header = request.headers['Authorization']
+ self.assert_('oauth_consumer_key="anonymous"' in auth_header)
+ self.assert_('oauth_signature_method="HMAC-SHA1"' in auth_header)
+ self.assert_('oauth_version="1.0"' in auth_header)
+ self.assert_('oauth_signature="' in auth_header)
+ self.assert_('oauth_nonce="' in auth_header)
+ self.assert_('oauth_timestamp="' in auth_header)
+
+ def test_request_rsa_request_token(self):
+ request = gdata.gauth.generate_request_for_request_token(
+ 'anonymous', gdata.gauth.RSA_SHA1,
+ ['http://www.blogger.com/feeds/',
+ 'http://www.google.com/calendar/feeds/'],
+ rsa_key=PRIVATE_TEST_KEY)
+ request_uri = str(request.uri)
+ self.assert_('http%3A%2F%2Fwww.blogger.com%2Ffeeds%2F' in request_uri)
+ self.assert_(
+ 'http%3A%2F%2Fwww.google.com%2Fcalendar%2Ffeeds%2F' in request_uri)
+ auth_header = request.headers['Authorization']
+ self.assert_('oauth_consumer_key="anonymous"' in auth_header)
+ self.assert_('oauth_signature_method="RSA-SHA1"' in auth_header)
+ self.assert_('oauth_version="1.0"' in auth_header)
+ self.assert_('oauth_signature="' in auth_header)
+ self.assert_('oauth_nonce="' in auth_header)
+ self.assert_('oauth_timestamp="' in auth_header)
+
+ def test_extract_token_from_body(self):
+ body = ('oauth_token=4%2F5bNFM_efIu3yN-E9RrF1KfZzOAZG&oauth_token_secret='
+ '%2B4O49V9WUOkjXgpOobAtgYzy&oauth_callback_confirmed=true')
+ token, secret = gdata.gauth.oauth_token_info_from_body(body)
+ self.assertEqual(token, '4/5bNFM_efIu3yN-E9RrF1KfZzOAZG')
+ self.assertEqual(secret, '+4O49V9WUOkjXgpOobAtgYzy')
+
+ def test_hmac_request_token_from_body(self):
+ body = ('oauth_token=4%2F5bNFM_efIu3yN-E9RrF1KfZzOAZG&oauth_token_secret='
+ '%2B4O49V9WUOkjXgpOobAtgYzy&oauth_callback_confirmed=true')
+ request_token = gdata.gauth.hmac_token_from_body(body, 'myKey',
+ 'mySecret', True)
+ self.assertEqual(request_token.consumer_key, 'myKey')
+ self.assertEqual(request_token.consumer_secret, 'mySecret')
+ self.assertEqual(request_token.token, '4/5bNFM_efIu3yN-E9RrF1KfZzOAZG')
+ self.assertEqual(request_token.token_secret, '+4O49V9WUOkjXgpOobAtgYzy')
+ self.assertEqual(request_token.auth_state, gdata.gauth.REQUEST_TOKEN)
+
+ def test_rsa_request_token_from_body(self):
+ body = ('oauth_token=4%2F5bNFM_efIu3yN-E9RrF1KfZzOAZG&oauth_token_secret='
+ '%2B4O49V9WUOkjXgpOobAtgYzy&oauth_callback_confirmed=true')
+ request_token = gdata.gauth.rsa_token_from_body(body, 'myKey',
+ 'rsaKey', True)
+ self.assertEqual(request_token.consumer_key, 'myKey')
+ self.assertEqual(request_token.rsa_private_key, 'rsaKey')
+ self.assertEqual(request_token.token, '4/5bNFM_efIu3yN-E9RrF1KfZzOAZG')
+ self.assertEqual(request_token.token_secret, '+4O49V9WUOkjXgpOobAtgYzy')
+ self.assertEqual(request_token.auth_state, gdata.gauth.REQUEST_TOKEN)
+
+
+class OAuthAuthorizeToken(unittest.TestCase):
+
+ def test_generate_authorization_url(self):
+ url = gdata.gauth.generate_oauth_authorization_url('/+=aosdpikk')
+ self.assert_(str(url).startswith(
+ 'https://www.google.com/accounts/OAuthAuthorizeToken'))
+ self.assert_('oauth_token=%2F%2B%3Daosdpikk' in str(url))
+
+ def test_extract_auth_token(self):
+ url = ('http://www.example.com/test?oauth_token='
+ 'CKF50YzIHxCT85KMAg&oauth_verifier=123zzz')
+ token = gdata.gauth.oauth_token_info_from_url(url)
+ self.assertEqual(token[0], 'CKF50YzIHxCT85KMAg')
+ self.assertEqual(token[1], '123zzz')
+
+
+class FindScopesForService(unittest.TestCase):
+
+ def test_find_all_scopes(self):
+ count = 0
+ for key, scopes in gdata.gauth.AUTH_SCOPES.iteritems():
+ count += len(scopes)
+ self.assertEqual(count, len(gdata.gauth.find_scopes_for_services()))
+
+ def test_single_service(self):
+ self.assertEqual(
+ gdata.gauth.FindScopesForServices(('codesearch',)),
+ ['http://www.google.com/codesearch/feeds/'])
+
+ def test_multiple_services(self):
+ self.assertEqual(
+ set(gdata.gauth.find_scopes_for_services(('jotspot', 'wise'))),
+ set(['http://sites.google.com/feeds/',
+ 'https://sites.google.com/feeds/',
+ 'https://spreadsheets.google.com/feeds/']))
+
+
+def suite():
+ return conf.build_suite([AuthSubTest, TokensToAndFromBlobsTest,
+ OAuthHmacTokenTests, OAuthRsaTokenTests,
+ OAuthHeaderTest, OAuthGetRequestToken,
+ OAuthAuthorizeToken, FindScopesForService])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/health/__init__.py b/tests/gdata_tests/health/__init__.py
new file mode 100755
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/health/__init__.py
diff --git a/tests/gdata_tests/health/service_test.py b/tests/gdata_tests/health/service_test.py
new file mode 100755
index 0000000..8ef36e1
--- /dev/null
+++ b/tests/gdata_tests/health/service_test.py
@@ -0,0 +1,195 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'api.eric@google.com (Eric Bidelman)'
+
+import getpass
+import unittest
+from gdata import test_data
+import gdata.health
+import gdata.health.service
+
+username = ''
+password = ''
+
+class HealthQueryProfileListTest(unittest.TestCase):
+
+ def setUp(self):
+ self.health = gdata.health.service.HealthService()
+ self.health.ClientLogin(username, password, source='Health Client Unit Tests')
+ self.profile_list_feed = self.health.GetProfileListFeed()
+
+ def testGetProfileListFeed(self):
+ self.assert_(isinstance(self.profile_list_feed,
+ gdata.health.ProfileListFeed))
+ self.assertEqual(self.profile_list_feed.id.text,
+ 'https://www.google.com/health/feeds/profile/list')
+ first_entry = self.profile_list_feed.entry[0]
+ self.assert_(isinstance(first_entry, gdata.health.ProfileListEntry))
+ self.assert_(first_entry.GetProfileId() is not None)
+ self.assert_(first_entry.GetProfileName() is not None)
+
+ query = gdata.health.service.HealthProfileListQuery()
+ profile_list = self.health.GetProfileListFeed(query)
+ self.assertEqual(first_entry.GetProfileId(),
+ profile_list.entry[0].GetProfileId())
+ self.assertEqual(profile_list.id.text,
+ 'https://www.google.com/health/feeds/profile/list')
+
+
+class H9QueryProfileListTest(unittest.TestCase):
+
+ def setUp(self):
+ self.h9 = gdata.health.service.HealthService(use_h9_sandbox=True)
+ self.h9.ClientLogin(username, password, source='H9 Client Unit Tests')
+ self.profile_list_feed = self.h9.GetProfileListFeed()
+
+ def testGetProfileListFeed(self):
+ self.assert_(isinstance(self.profile_list_feed,
+ gdata.health.ProfileListFeed))
+ self.assertEqual(self.profile_list_feed.id.text,
+ 'https://www.google.com/h9/feeds/profile/list')
+ first_entry = self.profile_list_feed.entry[0]
+ self.assert_(isinstance(first_entry, gdata.health.ProfileListEntry))
+ self.assert_(first_entry.GetProfileId() is not None)
+ self.assert_(first_entry.GetProfileName() is not None)
+
+ query = gdata.health.service.HealthProfileListQuery()
+ profile_list = self.h9.GetProfileListFeed(query)
+ self.assertEqual(first_entry.GetProfileId(),
+ profile_list.entry[0].GetProfileId())
+ self.assertEqual(profile_list.id.text,
+ 'https://www.google.com/h9/feeds/profile/list')
+
+
+class HealthQueryProfileTest(unittest.TestCase):
+
+ def setUp(self):
+ self.health = gdata.health.service.HealthService()
+ self.health.ClientLogin(username, password, source='Health Client Unit Tests')
+ self.profile_list_feed = self.health.GetProfileListFeed()
+ self.profile_id = self.profile_list_feed.entry[0].GetProfileId()
+
+ def testGetProfileFeed(self):
+ feed = self.health.GetProfileFeed(profile_id=self.profile_id)
+ self.assert_(isinstance(feed, gdata.health.ProfileFeed))
+ self.assert_(isinstance(feed.entry[0].ccr, gdata.health.Ccr))
+
+ def testGetProfileFeedByQuery(self):
+ query = gdata.health.service.HealthProfileQuery(
+ projection='ui', profile_id=self.profile_id)
+ feed = self.health.GetProfileFeed(query=query)
+ self.assert_(isinstance(feed, gdata.health.ProfileFeed))
+ self.assert_(feed.entry[0].ccr is not None)
+
+ def testGetProfileDigestFeed(self):
+ query = gdata.health.service.HealthProfileQuery(
+ projection='ui', profile_id=self.profile_id,
+ params={'digest': 'true'})
+ feed = self.health.GetProfileFeed(query=query)
+ self.assertEqual(len(feed.entry), 1)
+
+ def testGetMedicationsAndConditions(self):
+ query = gdata.health.service.HealthProfileQuery(
+ projection='ui', profile_id=self.profile_id,
+ params={'digest': 'true'}, categories=['medication|condition'])
+ feed = self.health.GetProfileFeed(query=query)
+ self.assertEqual(len(feed.entry), 1)
+ if feed.entry[0].ccr.GetMedications() is not None:
+ self.assert_(feed.entry[0].ccr.GetMedications()[0] is not None)
+ self.assert_(feed.entry[0].ccr.GetConditions()[0] is not None)
+ self.assert_(feed.entry[0].ccr.GetAllergies() is None)
+ self.assert_(feed.entry[0].ccr.GetAlerts() is None)
+ self.assert_(feed.entry[0].ccr.GetResults() is None)
+
+
+class H9QueryProfileTest(unittest.TestCase):
+
+ def setUp(self):
+ self.h9 = gdata.health.service.HealthService(use_h9_sandbox=True)
+ self.h9.ClientLogin(username, password, source='H9 Client Unit Tests')
+ self.profile_list_feed = self.h9.GetProfileListFeed()
+ self.profile_id = self.profile_list_feed.entry[0].GetProfileId()
+
+ def testGetProfileFeed(self):
+ feed = self.h9.GetProfileFeed(profile_id=self.profile_id)
+ self.assert_(isinstance(feed, gdata.health.ProfileFeed))
+ self.assert_(feed.entry[0].ccr is not None)
+
+ def testGetProfileFeedByQuery(self):
+ query = gdata.health.service.HealthProfileQuery(
+ service='h9', projection='ui', profile_id=self.profile_id)
+ feed = self.h9.GetProfileFeed(query=query)
+ self.assert_(isinstance(feed, gdata.health.ProfileFeed))
+ self.assert_(feed.entry[0].ccr is not None)
+
+
+class HealthNoticeTest(unittest.TestCase):
+
+ def setUp(self):
+ self.health = gdata.health.service.HealthService()
+ self.health.ClientLogin(username, password, source='Health Client Unit Tests')
+ self.profile_list_feed = self.health.GetProfileListFeed()
+ self.profile_id = self.profile_list_feed.entry[0].GetProfileId()
+
+ def testSendNotice(self):
+ subject_line = 'subject line'
+ body = 'Notice <b>body</b>.'
+ ccr_xml = test_data.HEALTH_CCR_NOTICE_PAYLOAD
+ created_entry = self.health.SendNotice(subject_line,
+ body,
+ ccr=ccr_xml,
+ profile_id=self.profile_id)
+ self.assertEqual(created_entry.title.text, subject_line)
+ self.assertEqual(created_entry.content.text, body)
+ self.assertEqual(created_entry.content.type, 'html')
+
+ problem = created_entry.ccr.GetProblems()[0]
+ problem_desc = problem.FindChildren('Description')[0]
+ name = problem_desc.FindChildren('Text')[0]
+ self.assertEqual(name.text, 'Aortic valve disorders')
+
+
+class H9NoticeTest(unittest.TestCase):
+
+ def setUp(self):
+ self.h9 = gdata.health.service.HealthService(use_h9_sandbox=True)
+ self.h9.ClientLogin(username, password, source='H9 Client Unit Tests')
+ self.profile_list_feed = self.h9.GetProfileListFeed()
+ self.profile_id = self.profile_list_feed.entry[0].GetProfileId()
+
+ def testSendNotice(self):
+ subject_line = 'subject line'
+ body = 'Notice <b>body</b>.'
+ ccr_xml = test_data.HEALTH_CCR_NOTICE_PAYLOAD
+ created_entry = self.h9.SendNotice(subject_line, body, ccr=ccr_xml,
+ profile_id=self.profile_id)
+ self.assertEqual(created_entry.title.text, subject_line)
+ self.assertEqual(created_entry.content.text, body)
+ self.assertEqual(created_entry.content.type, 'html')
+
+ problem = created_entry.ccr.GetProblems()[0]
+ problem_desc = problem.FindChildren('Description')[0]
+ name = problem_desc.FindChildren('Text')[0]
+ self.assertEqual(name.text, 'Aortic valve disorders')
+
+
+if __name__ == '__main__':
+ print ('Health API Tests\nNOTE: Please run these tests only with a test '
+ 'account. The tests may delete or update your data.')
+ username = raw_input('Please enter your username: ')
+ password = getpass.getpass()
+ unittest.main()
diff --git a/tests/gdata_tests/health_test.py b/tests/gdata_tests/health_test.py
new file mode 100755
index 0000000..882c293
--- /dev/null
+++ b/tests/gdata_tests/health_test.py
@@ -0,0 +1,179 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.eric@google.com (Eric Bidelman)'
+
+
+import unittest
+from gdata import test_data
+import gdata.health
+import gdata.health.service
+
+
+class ProfileEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.profile_entry = gdata.health.ProfileEntryFromString(
+ test_data.HEALTH_PROFILE_ENTRY_DIGEST)
+
+ def testToAndFromStringWithData(self):
+ entry = gdata.health.ProfileEntryFromString(str(self.profile_entry))
+
+ self.assert_(isinstance(entry, gdata.health.ProfileEntry))
+ self.assert_(isinstance(entry.ccr, gdata.health.Ccr))
+ self.assertEqual(len(entry.ccr.GetMedications()), 3)
+ self.assertEqual(len(entry.ccr.GetImmunizations()), 1)
+ self.assertEqual(len(entry.ccr.GetAlerts()), 2)
+ self.assertEqual(len(entry.ccr.GetResults()), 1)
+ self.assertEqual(len(entry.ccr.GetProblems()), 2)
+ self.assertEqual(len(entry.ccr.GetProcedures()), 2)
+
+ def testGetResultsTextFromCcr(self):
+ entry = gdata.health.ProfileEntryFromString(str(self.profile_entry))
+ result = entry.ccr.GetResults()[0].FindChildren('Test')[0]
+ test_desc = result.FindChildren('Description')[0].FindChildren('Text')[0]
+ self.assertEqual(test_desc.text, 'Acetaldehyde - Blood')
+
+ def testGetMedicationNameFromCcr(self):
+ entry = gdata.health.ProfileEntryFromString(str(self.profile_entry))
+ product = entry.ccr.GetMedications()[1].FindChildren('Product')[0]
+ prod_name = product.FindChildren('ProductName')[0].FindChildren('Text')[0]
+ self.assertEqual(prod_name.text, 'A-Fil')
+
+ def testGetProblemCodeValueFromCcr(self):
+ entry = gdata.health.ProfileEntryFromString(str(self.profile_entry))
+ problem_desc = entry.ccr.GetProblems()[1].FindChildren('Description')[0]
+ code = problem_desc.FindChildren('Code')[0].FindChildren('Value')[0]
+ self.assertEqual(code.text, '136.9')
+
+ def testGetGetImmunizationActorIdFromCcr(self):
+ entry = gdata.health.ProfileEntryFromString(str(self.profile_entry))
+ immun_source = entry.ccr.GetImmunizations()[0].FindChildren('Source')[0]
+ actor_id = immun_source.FindChildren('Actor')[0].FindChildren('ActorID')[0]
+ self.assertEqual(actor_id.text, 'user@gmail.com')
+
+ def testGetGetProceduresNameFromCcr(self):
+ entry = gdata.health.ProfileEntryFromString(str(self.profile_entry))
+ proc_desc = entry.ccr.GetProcedures()[1].FindChildren('Description')[0]
+ proc_name = proc_desc.FindChildren('Text')[0]
+ self.assertEqual(proc_name.text, 'Abdominoplasty')
+
+ def testGetAlertsFromCcr(self):
+ entry = gdata.health.ProfileEntryFromString(str(self.profile_entry))
+ alert_type = entry.ccr.GetAlerts()[0].FindChildren('Type')[0]
+ self.assertEqual(alert_type.FindChildren('Text')[0].text, 'Allergy')
+
+
+class ProfileListEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.health.ProfileListEntryFromString(
+ test_data.HEALTH_PROFILE_LIST_ENTRY)
+
+ def testToAndFromString(self):
+ self.assert_(isinstance(self.entry, gdata.health.ProfileListEntry))
+ self.assertEqual(self.entry.GetProfileId(), 'vndCn5sdfwdEIY')
+ self.assertEqual(self.entry.GetProfileName(), 'profile name')
+
+
+class ProfileFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.health.ProfileFeedFromString(
+ test_data.HEALTH_PROFILE_FEED)
+
+ def testToAndFromString(self):
+ self.assert_(len(self.feed.entry) == 15)
+ for an_entry in self.feed.entry:
+ self.assert_(isinstance(an_entry, gdata.health.ProfileEntry))
+ new_profile_feed = gdata.health.ProfileFeedFromString(str(self.feed))
+ for an_entry in new_profile_feed.entry:
+ self.assert_(isinstance(an_entry, gdata.health.ProfileEntry))
+
+ def testConvertActualData(self):
+ for an_entry in self.feed.entry:
+ self.assert_(an_entry.ccr is not None)
+
+
+class HealthProfileQueryTest(unittest.TestCase):
+
+ def testHealthQueryToString(self):
+ query = gdata.health.service.HealthProfileQuery()
+ self.assertEqual(query.ToUri(), '/health/feeds/profile/default')
+
+ query = gdata.health.service.HealthProfileQuery(feed='feeds/profile')
+ self.assertEqual(query.ToUri(), '/health/feeds/profile/default')
+
+ query = gdata.health.service.HealthProfileQuery(categories=['medication'])
+ self.assertEqual(query.ToUri(),
+ '/health/feeds/profile/default/-/medication')
+
+ query = gdata.health.service.HealthProfileQuery(projection='ui',
+ profile_id='12345')
+ self.assertEqual(query.ToUri(), '/health/feeds/profile/ui/12345')
+
+ query = gdata.health.service.HealthProfileQuery()
+ query.categories.append('medication|condition')
+ self.assertEqual(query.ToUri(),
+ '/health/feeds/profile/default/-/medication%7Ccondition')
+
+ def testH9QueryToString(self):
+ query = gdata.health.service.HealthProfileQuery(service='h9')
+ self.assertEqual(query.ToUri(), '/h9/feeds/profile/default')
+
+ query = gdata.health.service.HealthProfileQuery(
+ service='h9', feed='feeds/profile',
+ projection='ui', profile_id='12345')
+ self.assertEqual(query.ToUri(), '/h9/feeds/profile/ui/12345')
+
+ def testDigestParam(self):
+ query = gdata.health.service.HealthProfileQuery(params={'digest': 'true'})
+ self.assertEqual(query.ToUri(), '/health/feeds/profile/default?digest=true')
+
+ query.profile_id = '12345'
+ query.projection = 'ui'
+ self.assertEqual(
+ query.ToUri(), '/health/feeds/profile/ui/12345?digest=true')
+
+
+class HealthProfileListQueryTest(unittest.TestCase):
+
+ def testHealthProfileListQueryToString(self):
+ query = gdata.health.service.HealthProfileListQuery()
+ self.assertEqual(query.ToUri(), '/health/feeds/profile/list')
+
+ query = gdata.health.service.HealthProfileListQuery(service='health')
+ self.assertEqual(query.ToUri(), '/health/feeds/profile/list')
+
+ query = gdata.health.service.HealthProfileListQuery(
+ feed='feeds/profile/list')
+ self.assertEqual(query.ToUri(), '/health/feeds/profile/list')
+
+ query = gdata.health.service.HealthProfileListQuery(
+ service='health', feed='feeds/profile/list')
+ self.assertEqual(query.ToUri(), '/health/feeds/profile/list')
+
+ def testH9ProfileListQueryToString(self):
+ query = gdata.health.service.HealthProfileListQuery(service='h9')
+ self.assertEqual(query.ToUri(), '/h9/feeds/profile/list')
+
+ query = gdata.health.service.HealthProfileListQuery(
+ service='h9', feed='feeds/profile/list')
+ self.assertEqual(query.ToUri(), '/h9/feeds/profile/list')
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/live_client_test.py b/tests/gdata_tests/live_client_test.py
new file mode 100755
index 0000000..d882e56
--- /dev/null
+++ b/tests/gdata_tests/live_client_test.py
@@ -0,0 +1,325 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import os
+import unittest
+import gdata.client
+import atom.http_core
+import atom.mock_http_core
+import atom.core
+import gdata.data
+import gdata.core
+# TODO: switch to using v2 atom data once it is available.
+import atom
+import gdata.test_config as conf
+
+
+conf.options.register_option(conf.BLOG_ID_OPTION)
+
+
+class BloggerTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = None
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.client.GDClient()
+ conf.configure_client(self.client, 'BloggerTest', 'blogger')
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def test_create_update_delete(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_create_update_delete')
+
+ blog_post = atom.Entry(
+ title=atom.Title(text='test from python BloggerTest'),
+ content=atom.Content(text='This is only a test.'))
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(str(blog_post), 'application/atom+xml')
+
+ def entry_from_string_wrapper(response):
+ self.assert_(response.getheader('content-type') is not None)
+ self.assert_(response.getheader('gdata-version') is not None)
+ return atom.EntryFromString(response.read())
+
+ entry = self.client.request('POST',
+ 'http://www.blogger.com/feeds/%s/posts/default' % (
+ conf.options.get_value('blogid')),
+ converter=entry_from_string_wrapper, http_request=http_request)
+ self.assertEqual(entry.title.text, 'test from python BloggerTest')
+ self.assertEqual(entry.content.text, 'This is only a test.')
+
+ # Edit the test entry.
+ edit_link = None
+ for link in entry.link:
+ # Find the edit link for this entry.
+ if link.rel == 'edit':
+ edit_link = link.href
+ entry.title.text = 'Edited'
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(str(entry), 'application/atom+xml')
+ edited_entry = self.client.request('PUT', edit_link,
+ converter=entry_from_string_wrapper, http_request=http_request)
+ self.assertEqual(edited_entry.title.text, 'Edited')
+ self.assertEqual(edited_entry.content.text, entry.content.text)
+
+ # Delete the test entry from the blog.
+ edit_link = None
+ for link in edited_entry.link:
+ if link.rel == 'edit':
+ edit_link = link.href
+ response = self.client.request('DELETE', edit_link)
+ self.assertEqual(response.status, 200)
+
+ def test_use_version_two(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_cache(self.client, 'test_use_version_two')
+
+ # Use version 2 of the Blogger API.
+ self.client.api_version = '2'
+
+ # Create a v2 blog post entry to post on the blog.
+ entry = create_element('entry')
+ entry._other_elements.append(
+ create_element('title', text='Marriage!',
+ attributes={'type': 'text'}))
+ entry._other_elements.append(
+ create_element('content', attributes={'type': 'text'},
+ text='Mr. Darcy has proposed marriage to me!'))
+ entry._other_elements.append(
+ create_element('category',
+ attributes={'scheme': TAG, 'term': 'marriage'}))
+ entry._other_elements.append(
+ create_element('category',
+ attributes={'scheme': TAG, 'term': 'Mr. Darcy'}))
+
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(entry.to_string(), 'application/atom+xml')
+ posted = self.client.request('POST',
+ 'http://www.blogger.com/feeds/%s/posts/default' % (
+ conf.options.get_value('blogid')),
+ converter=element_from_string, http_request=http_request)
+ # Verify that the blog post content is correct.
+ self.assertEqual(posted.get_elements('title', ATOM)[0].text, 'Marriage!')
+ # TODO: uncomment once server bug is fixed.
+ #self.assertEqual(posted.get_elements('content', ATOM)[0].text,
+ # 'Mr. Darcy has proposed marriage to me!')
+ found_tags = [False, False]
+ categories = posted.get_elements('category', ATOM)
+ self.assertEqual(len(categories), 2)
+ for category in categories:
+ if category.get_attributes('term')[0].value == 'marriage':
+ found_tags[0] = True
+ elif category.get_attributes('term')[0].value == 'Mr. Darcy':
+ found_tags[1] = True
+ self.assert_(found_tags[0])
+ self.assert_(found_tags[1])
+
+ # Find the blog post on the blog.
+ self_link = None
+ edit_link = None
+ for link in posted.get_elements('link', ATOM):
+ if link.get_attributes('rel')[0].value == 'self':
+ self_link = link.get_attributes('href')[0].value
+ elif link.get_attributes('rel')[0].value == 'edit':
+ edit_link = link.get_attributes('href')[0].value
+ self.assert_(self_link is not None)
+ self.assert_(edit_link is not None)
+
+ queried = self.client.request('GET', self_link,
+ converter=element_from_string)
+ # TODO: add additional asserts to check content and etags.
+
+ # Test queries using ETags.
+ entry = self.client.get_entry(self_link)
+ self.assert_(entry.etag is not None)
+ self.assertRaises(gdata.client.NotModified, self.client.get_entry,
+ self_link, etag=entry.etag)
+
+ # Delete the test blog post.
+ self.client.request('DELETE', edit_link)
+
+
+class ContactsTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = None
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.client.GDClient()
+ conf.configure_client(self.client, 'ContactsTest', 'cp')
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ # Run this test and profiles fails
+ def test_crud_version_two(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ conf.configure_cache(self.client, 'test_crud_version_two')
+
+ self.client.api_version = '2'
+
+ entry = create_element('entry')
+ entry._other_elements.append(
+ create_element('title', ATOM, 'Jeff', {'type': 'text'}))
+ entry._other_elements.append(
+ create_element('email', GD,
+ attributes={'address': 'j.s@google.com', 'rel': WORK_REL}))
+
+ http_request = atom.http_core.HttpRequest()
+ http_request.add_body_part(entry.to_string(), 'application/atom+xml')
+ posted = self.client.request('POST',
+ 'http://www.google.com/m8/feeds/contacts/default/full',
+ converter=element_from_string, http_request=http_request)
+
+ self_link = None
+ edit_link = None
+ for link in posted.get_elements('link', ATOM):
+ if link.get_attributes('rel')[0].value == 'self':
+ self_link = link.get_attributes('href')[0].value
+ elif link.get_attributes('rel')[0].value == 'edit':
+ edit_link = link.get_attributes('href')[0].value
+ self.assert_(self_link is not None)
+ self.assert_(edit_link is not None)
+
+ etag = posted.get_attributes('etag')[0].value
+ self.assert_(etag is not None)
+ self.assert_(len(etag) > 0)
+
+ # Delete the test contact.
+ http_request = atom.http_core.HttpRequest()
+ http_request.headers['If-Match'] = etag
+ self.client.request('DELETE', edit_link, http_request=http_request)
+
+
+class VersionTwoClientContactsTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = None
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.client.GDClient()
+ self.client.api_version = '2'
+ conf.configure_client(self.client, 'VersionTwoClientContactsTest', 'cp')
+ self.old_proxy = os.environ.get('https_proxy')
+
+ def tearDown(self):
+ if self.old_proxy:
+ os.environ['https_proxy'] = self.old_proxy
+ elif 'https_proxy' in os.environ:
+ del os.environ['https_proxy']
+ conf.close_client(self.client)
+
+ def test_version_two_client(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ conf.configure_cache(self.client, 'test_version_two_client')
+
+ entry = gdata.data.GDEntry()
+ entry._other_elements.append(
+ create_element('title', ATOM, 'Test', {'type': 'text'}))
+ entry._other_elements.append(
+ create_element('email', GD,
+ attributes={'address': 'test@example.com', 'rel': WORK_REL}))
+
+ # Create the test contact.
+ posted = self.client.post(entry,
+ 'https://www.google.com/m8/feeds/contacts/default/full')
+ self.assert_(isinstance(posted, gdata.data.GDEntry))
+ self.assertEqual(posted.get_elements('title')[0].text, 'Test')
+ self.assertEqual(posted.get_elements('email')[0].get_attributes(
+ 'address')[0].value, 'test@example.com')
+
+ posted.get_elements('title')[0].text = 'Doug'
+ edited = self.client.update(posted)
+ self.assert_(isinstance(edited, gdata.data.GDEntry))
+ self.assertEqual(edited.get_elements('title')[0].text, 'Doug')
+ self.assertEqual(edited.get_elements('email')[0].get_attributes(
+ 'address')[0].value, 'test@example.com')
+
+ # Delete the test contact.
+ self.client.delete(edited)
+
+ def notest_crud_over_https_proxy(self):
+ import urllib
+ PROXY_ADDR = '98.192.125.23'
+ try:
+ response = urllib.urlopen('http://' + PROXY_ADDR)
+ except IOError:
+ return
+ # Only bother running the test if the proxy is up
+ if response.getcode() == 200:
+ os.environ['https_proxy'] = PROXY_ADDR
+ # Perform the CRUD test above, this time over a proxy.
+ self.test_version_two_client()
+
+class JsoncRequestTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.client.GDClient()
+
+ def test_get_jsonc(self):
+ jsonc = self.client.get_feed(
+ 'http://gdata.youtube.com/feeds/api/videos?q=surfing&v=2&alt=jsonc',
+ converter=gdata.core.parse_json_file)
+ self.assertTrue(len(jsonc.data.items) > 0)
+
+
+# Utility methods.
+# The Atom XML namespace.
+ATOM = 'http://www.w3.org/2005/Atom'
+# URL used as the scheme for a blog post tag.
+TAG = 'http://www.blogger.com/atom/ns#'
+# Namespace for Google Data API elements.
+GD = 'http://schemas.google.com/g/2005'
+WORK_REL = 'http://schemas.google.com/g/2005#work'
+
+
+def create_element(tag, namespace=ATOM, text=None, attributes=None):
+ element = atom.core.XmlElement()
+ element._qname = '{%s}%s' % (namespace, tag)
+ if text is not None:
+ element.text = text
+ if attributes is not None:
+ element._other_attributes = attributes.copy()
+ return element
+
+
+def element_from_string(response):
+ return atom.core.xml_element_from_string(response.read(),
+ atom.core.XmlElement)
+
+
+def suite():
+ return conf.build_suite([BloggerTest, ContactsTest,
+ VersionTwoClientContactsTest,
+ JsoncRequestTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/marketplace/__init__.py b/tests/gdata_tests/marketplace/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/marketplace/__init__.py
diff --git a/tests/gdata_tests/marketplace/live_client_test.py b/tests/gdata_tests/marketplace/live_client_test.py
new file mode 100644
index 0000000..2365a64
--- /dev/null
+++ b/tests/gdata_tests/marketplace/live_client_test.py
@@ -0,0 +1,126 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'Alexandre Vivien <alex@simplecode.fr>'
+
+
+import unittest
+import gdata.client
+import gdata.data
+import gdata.gauth
+import gdata.marketplace.client
+import gdata.marketplace.data
+import gdata.test_config as conf
+
+
+conf.options.register_option(conf.APPS_DOMAIN_OPTION)
+
+
+class LicensingClientTest(unittest.TestCase):
+
+ def __init__(self, *args, **kwargs):
+ unittest.TestCase.__init__(self, *args, **kwargs)
+ gdata.test_config.options.register(
+ 'appsid',
+ 'Enter the Application ID of your Marketplace application',
+ description='The Application ID of your Marketplace application')
+ gdata.test_config.options.register(
+ 'appsconsumerkey',
+ 'Enter the Consumer Key of your Marketplace application',
+ description='The Consumer Key of your Marketplace application')
+ gdata.test_config.options.register(
+ 'appsconsumersecret',
+ 'Enter the Consumer Secret of your Marketplace application',
+ description='The Consumer Secret of your Marketplace application')
+
+ def setUp(self):
+ self.client = gdata.marketplace.client.LicensingClient(domain='example.com')
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.marketplace.client.LicensingClient(domain=conf.options.get_value('appsdomain'))
+ conf.configure_client(self.client, 'LicensingClientTest', self.client.auth_service, True)
+ self.client.auth_token = gdata.gauth.TwoLeggedOAuthHmacToken(conf.options.get_value('appsconsumerkey'), conf.options.get_value('appsconsumersecret'), '')
+ self.client.source = 'GData-Python-Client-Test'
+ self.client.account_type='HOSTED'
+ self.client.http_client.debug = True
+ self.app_id = conf.options.get_value('appsid')
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def testGetLicense(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testGetLicense')
+
+ fetched_feed = self.client.GetLicense(app_id=self.app_id)
+ self.assertTrue(isinstance(fetched_feed, gdata.marketplace.data.LicenseFeed))
+ self.assertTrue(isinstance(fetched_feed.entry[0], gdata.marketplace.data.LicenseEntry))
+ entity = fetched_feed.entry[0].content.entity
+ self.assertTrue(entity is not None)
+ self.assertNotEqual(entity.id, '')
+ self.assertNotEqual(entity.enabled, '')
+ self.assertNotEqual(entity.customer_id, '')
+ self.assertNotEqual(entity.state, '')
+
+ def testGetLicenseNotifications(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testGetLicenseNotifications')
+
+ fetched_feed = self.client.GetLicenseNotifications(app_id=self.app_id, max_results=2)
+ self.assertTrue(isinstance(fetched_feed, gdata.marketplace.data.LicenseFeed))
+ self.assertEqual(len(fetched_feed.entry), 2)
+ for entry in fetched_feed.entry:
+ entity = entry.content.entity
+ self.assertTrue(entity is not None)
+ self.assertNotEqual(entity.id, '')
+ self.assertNotEqual(entity.domain_name, '')
+ self.assertNotEqual(entity.installer_email, '')
+ self.assertNotEqual(entity.tos_acceptance_time, '')
+ self.assertNotEqual(entity.last_change_time, '')
+ self.assertNotEqual(entity.product_config_id, '')
+ self.assertNotEqual(entity.state, '')
+
+ next_uri = fetched_feed.find_next_link()
+ fetched_feed_next = self.client.GetLicenseNotifications(uri=next_uri)
+ self.assertTrue(isinstance(fetched_feed_next, gdata.marketplace.data.LicenseFeed))
+ self.assertTrue(len(fetched_feed_next.entry) <= 2)
+ for entry in fetched_feed_next.entry:
+ entity = entry.content.entity
+ self.assertTrue(entity is not None)
+ self.assertNotEqual(entity.id, '')
+ self.assertNotEqual(entity.domain_name, '')
+ self.assertNotEqual(entity.installer_email, '')
+ self.assertNotEqual(entity.tos_acceptance_time, '')
+ self.assertNotEqual(entity.last_change_time, '')
+ self.assertNotEqual(entity.product_config_id, '')
+ self.assertNotEqual(entity.state, '')
+
+
+def suite():
+ return conf.build_suite([LicensingClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/oauth/__init__.py b/tests/gdata_tests/oauth/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/oauth/__init__.py
diff --git a/tests/gdata_tests/oauth/data_test.py b/tests/gdata_tests/oauth/data_test.py
new file mode 100644
index 0000000..683b39f
--- /dev/null
+++ b/tests/gdata_tests/oauth/data_test.py
@@ -0,0 +1,536 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+
+__author__ = 'samuel.cyprian@gmail.com (Samuel Cyprian)'
+
+import unittest
+from gdata import oauth, test_config
+
+HTTP_METHOD_POST = 'POST'
+VERSION = '1.0'
+
+
+class OauthUtilsTest(unittest.TestCase):
+ def test_build_authenticate_header(self):
+ self.assertEqual(oauth.build_authenticate_header(),
+ {'WWW-Authenticate' :'OAuth realm=""'})
+ self.assertEqual(oauth.build_authenticate_header('foo'),
+ {'WWW-Authenticate': 'OAuth realm="foo"'})
+
+ def test_escape(self):
+ #Special cases
+ self.assertEqual(oauth.escape('~'), '~')
+ self.assertEqual(oauth.escape('/'), '%2F')
+ self.assertEqual(oauth.escape('+'), '%2B')
+ self.assertEqual(oauth.escape(' '), '%20')
+ self.assertEqual(oauth.escape('Peter Strömberg'),
+ 'Peter%20Str%C3%B6mberg')
+
+ def test_generate_timestamp(self):
+ self.assertTrue(oauth.generate_timestamp()>0)
+ self.assertTrue(type(oauth.generate_timestamp()) is type(0))
+
+ def test_generate_nonce(self):
+ DEFAULT_NONCE_LENGTH = 8
+ self.assertTrue(len(oauth.generate_nonce()) is DEFAULT_NONCE_LENGTH)
+ self.assertTrue(type(oauth.generate_nonce()) is type(''))
+
+class OAuthConsumerTest(unittest.TestCase):
+ def setUp(self):
+ self.key = 'key'
+ self.secret = 'secret'
+ self.consumer = oauth.OAuthConsumer(self.key, self.secret)
+
+ def test_OAuthConsumer_attr_key(self):
+ self.assertEqual(self.consumer.key, self.key)
+
+ def test_OAuthConsumer_attr_secret(self):
+ self.assertEqual(self.consumer.secret, self.secret)
+
+class OAuthTokenTest(unittest.TestCase):
+ def setUp(self):
+ self.key = 'key'
+ self.secret = 'secret'
+ self.token = oauth.OAuthToken(self.key, self.secret)
+
+ def test_OAuthToken_attr_key(self):
+ self.assertEqual(self.token.key, self.key)
+
+ def test_OAuthToken_attr_secret(self):
+ self.assertEqual(self.token.secret, self.secret)
+
+ def test_to_string(self):
+ self.assertEqual(self.token.to_string(),
+ 'oauth_token_secret=secret&oauth_token=key')
+ t = oauth.OAuthToken('+', '%')
+ self.assertEqual(t.to_string(),
+ 'oauth_token_secret=%25&oauth_token=%2B')
+
+ def test_from_string(self):
+ s = 'oauth_token_secret=secret&oauth_token=key'
+ t = oauth.OAuthToken.from_string(s)
+ self.assertEqual(t.key, 'key')
+ self.assertEqual(t.secret, 'secret')
+ t = oauth.OAuthToken.from_string('oauth_token_secret=%25&oauth_token=%2B')
+ self.assertEqual(t.key, '+')
+ self.assertEqual(t.secret, '%')
+
+ def test___str__(self):
+ self.assertEqual(str(self.token),
+ 'oauth_token_secret=secret&oauth_token=key')
+ t = oauth.OAuthToken('+', '%')
+ self.assertEqual(str(t), 'oauth_token_secret=%25&oauth_token=%2B')
+
+class OAuthParameters(object):
+ CONSUMER_KEY = 'oauth_consumer_key'
+ TOKEN = 'oauth_token'
+ SIGNATURE_METHOD = 'oauth_signature_method'
+ SIGNATURE = 'oauth_signature'
+ TIMESTAMP = 'oauth_timestamp'
+ NONCE = 'oauth_nonce'
+ VERSION = 'oauth_version'
+ CALLBACK = 'oauth_callback'
+
+ ALL_PARAMETERS = (CONSUMER_KEY,
+ TOKEN,
+ SIGNATURE_METHOD,
+ SIGNATURE,
+ TIMESTAMP,
+ NONCE,
+ VERSION)
+
+class OAuthTest(unittest.TestCase):
+ def setUp(self):
+ self.consumer = oauth.OAuthConsumer('a56b5ff0a637ab283d1d8e32ced37a9c',
+ '9a3248210c84b264b56b98c0b872bc8a')
+ self.token = oauth.OAuthToken('5b2cafbf20b11bace53b29e37d8a673d',
+ '3f71254637df2002d8819458ae4f6c51')
+ self.http_url = 'http://dev.alicehub.com/server/api/newsfeed/update/'
+
+ self.http_method = HTTP_METHOD_POST
+
+class OAuthRequestTest(OAuthTest):
+ def setUp(self):
+ super(OAuthRequestTest, self).setUp()
+ self.signature_method = oauth.OAuthSignatureMethod_HMAC_SHA1()
+
+ self.non_oauth_param_message = 'message'
+ self.non_oauth_param_context_id = 'context_id'
+ self.parameters = {OAuthParameters.CONSUMER_KEY:self.consumer.key,
+ OAuthParameters.TOKEN: self.token.key,
+ OAuthParameters.SIGNATURE_METHOD: 'HMAC-SHA1',
+ OAuthParameters.SIGNATURE:
+ '947ysBZiMn6FGZ11AW06Ioco4mo=',
+ OAuthParameters.TIMESTAMP: '1278573584',
+ OAuthParameters.NONCE: '1770704051',
+ OAuthParameters.VERSION: VERSION,
+ self.non_oauth_param_message:'hey',
+ self.non_oauth_param_context_id:'',}
+ oauth_params_string = """
+ oauth_nonce="1770704051",
+ oauth_timestamp="1278573584",
+ oauth_consumer_key="a56b5ff0a637ab283d1d8e32ced37a9c",
+ oauth_signature_method="HMAC-SHA1",
+ oauth_version="1.0",
+ oauth_token="5b2cafbf20b11bace53b29e37d8a673d",
+ oauth_signature="947ysBZiMn6FGZ11AW06Ioco4mo%3D"
+ """
+ self.oauth_header_with_realm = {'Authorization': """OAuth
+ realm="http://example.com", %s """ % oauth_params_string}
+ self.oauth_header_without_realm = {'Authorization': 'OAuth %s'
+ % oauth_params_string}
+
+
+ self.additional_param = 'foo'
+ self.additional_value = 'bar'
+
+ self.oauth_request = oauth.OAuthRequest(self.http_method,
+ self.http_url,
+ self.parameters)
+
+ def test_set_parameter(self):
+ self.oauth_request.set_parameter(self.additional_param,
+ self.additional_value)
+ self.assertEqual(self.oauth_request.get_parameter(self.additional_param),
+ self.additional_value)
+
+ def test_get_parameter(self):
+ self.assertRaises(oauth.OAuthError,
+ self.oauth_request.get_parameter,
+ self.additional_param)
+ self.oauth_request.set_parameter(self.additional_param,
+ self.additional_value)
+ self.assertEqual(self.oauth_request.get_parameter(self.additional_param),
+ self.additional_value)
+
+ def test__get_timestamp_nonce(self):
+ self.assertEqual(self.oauth_request._get_timestamp_nonce(),
+ (self.parameters[OAuthParameters.TIMESTAMP],
+ self.parameters[OAuthParameters.NONCE]))
+
+ def test_get_nonoauth_parameters(self):
+ non_oauth_params = self.oauth_request.get_nonoauth_parameters()
+ self.assertTrue(non_oauth_params.has_key(self.non_oauth_param_message))
+ self.assertFalse(non_oauth_params.has_key(OAuthParameters.CONSUMER_KEY))
+
+ def test_to_header(self):
+ realm = 'google'
+ header_without_realm = self.oauth_request.to_header()\
+ .get('Authorization')
+ header_with_realm = self.oauth_request.to_header(realm)\
+ .get('Authorization')
+ self.assertTrue(header_with_realm.find(realm))
+ for k in OAuthParameters.ALL_PARAMETERS:
+ self.assertTrue(header_without_realm.find(k) > -1)
+ self.assertTrue(header_with_realm.find(k) > -1)
+
+ def check_for_params_in_string(self, params, s):
+ for k, v in params.iteritems():
+ self.assertTrue(s.find(oauth.escape(k)) > -1)
+ self.assertTrue(s.find(oauth.escape(v)) > -1)
+
+ def test_to_postdata(self):
+ post_data = self.oauth_request.to_postdata()
+ self.check_for_params_in_string(self.parameters, post_data)
+
+ def test_to_url(self):
+ GET_url = self.oauth_request.to_url()
+ self.assertTrue(GET_url\
+ .find(self.oauth_request.get_normalized_http_url()) > -1)
+ self.assertTrue(GET_url.find('?') > -1)
+ self.check_for_params_in_string(self.parameters, GET_url)
+
+ def test_get_normalized_parameters(self):
+ _params = self.parameters.copy()
+ normalized_params = self.oauth_request.get_normalized_parameters()
+ self.assertFalse(normalized_params\
+ .find(OAuthParameters.SIGNATURE + '=') > -1)
+ self.assertTrue(self.parameters.get(OAuthParameters.SIGNATURE) is None)
+
+ key_values = [tuple(kv.split('=')) for kv in normalized_params.split('&')]
+ del _params[OAuthParameters.SIGNATURE]
+ expected_key_values = _params.items()
+ expected_key_values.sort()
+
+ for k, v in expected_key_values:
+ self.assertTrue(expected_key_values.index((k,v))\
+ is key_values.index((oauth.escape(k), oauth.escape(v))))
+
+ def test_get_normalized_http_method(self):
+ lower_case_http_method = HTTP_METHOD_POST.lower()
+ self.oauth_request.http_method = lower_case_http_method
+ self.assertEqual(self.oauth_request.get_normalized_http_method(),
+ lower_case_http_method.upper())
+
+ def test_get_normalized_http_url(self):
+ url1 = 'HTTP://Example.com:80/resource?id=123'
+ expected_url1 = "http://example.com/resource"
+ self.oauth_request.http_url = url1
+ self.assertEqual(self.oauth_request.get_normalized_http_url(),
+ expected_url1)
+
+ url2 = 'HTTPS://Example.com:443/resource?id=123'
+ expected_url2 = "https://example.com/resource"
+ self.oauth_request.http_url = url2
+ self.assertEqual(self.oauth_request.get_normalized_http_url(),
+ expected_url2)
+
+ url3 = 'HTTP://Example.com:8080/resource?id=123'
+ expected_url3 = "http://example.com:8080/resource"
+ self.oauth_request.http_url = url3
+ self.assertEqual(self.oauth_request.get_normalized_http_url(),
+ expected_url3)
+
+ def test_sign_request(self):
+ expected_signature = self.oauth_request.parameters\
+ .get(OAuthParameters.SIGNATURE)
+ del self.oauth_request.parameters[OAuthParameters.SIGNATURE]
+ self.oauth_request.sign_request(self.signature_method,
+ self.consumer,
+ self.token)
+ self.assertEqual(self.oauth_request.parameters\
+ .get(OAuthParameters.SIGNATURE), expected_signature)
+
+ def test_build_signature(self):
+ expected_signature = self.oauth_request.parameters\
+ .get(OAuthParameters.SIGNATURE)
+ self.assertEqual(self.oauth_request.build_signature(self.signature_method,
+ self.consumer,
+ self.token),
+ expected_signature)
+
+ def test_from_request(self):
+ request = oauth.OAuthRequest.from_request(self.http_method, self.http_url,
+ self.oauth_header_with_realm,
+ {},
+ "message=hey&context_id=")
+ self.assertEqual(request.__dict__, self.oauth_request.__dict__)
+ self.assertTrue(isinstance(request, oauth.OAuthRequest))
+
+ def test_from_consumer_and_token(self):
+ request = oauth.OAuthRequest.from_consumer_and_token(self.consumer,
+ self.token,
+ self.http_method,
+ self.http_url)
+ self.assertTrue(isinstance(request, oauth.OAuthRequest))
+
+ def test_from_token_and_callback(self):
+ callback = 'http://example.com'
+ request = oauth.OAuthRequest.from_token_and_callback(self.token,
+ callback,
+ self.http_method,
+ self.http_url)
+ self.assertTrue(isinstance(request, oauth.OAuthRequest))
+ self.assertEqual(request.get_parameter(OAuthParameters.CALLBACK), callback)
+
+ def test__split_header(self):
+ del self.parameters[self.non_oauth_param_message]
+ del self.parameters[self.non_oauth_param_context_id]
+ self.assertEqual(oauth.OAuthRequest._split_header(self\
+ .oauth_header_with_realm['Authorization']), self.parameters)
+ self.assertEqual(oauth.OAuthRequest._split_header(self\
+ .oauth_header_without_realm['Authorization']), self.parameters)
+
+ def test_split_url_string(self):
+ qs = "a=1&c=hi%20there&empty="
+ expected_result = {'a': '1',
+ 'c': 'hi there',
+ 'empty': ''}
+ self.assertEqual(oauth.OAuthRequest._split_url_string(qs), expected_result)
+
+class OAuthServerTest(OAuthTest):
+ def setUp(self):
+ super(OAuthServerTest, self).setUp()
+ self.signature_method = oauth.OAuthSignatureMethod_HMAC_SHA1()
+ self.data_store = MockOAuthDataStore()
+ self.user = MockUser('Foo Bar')
+
+ self.request_token_url = "http://example.com/oauth/request_token"
+ self.access_token_url = "http://example.com/oauth/access_token"
+
+ self.oauth_server = oauth.OAuthServer(self.data_store,
+ {self.signature_method.get_name():self.signature_method})
+
+ def _prepare_request(self, request, token = None):
+ request.set_parameter(OAuthParameters.SIGNATURE_METHOD,
+ self.signature_method.get_name())
+ request.set_parameter(OAuthParameters.NONCE, oauth.generate_nonce())
+ request.set_parameter(OAuthParameters.TIMESTAMP,
+ oauth.generate_timestamp())
+ request.sign_request(self.signature_method, self.consumer, token)
+
+ def _get_token(self, request):
+ self._prepare_request(request)
+ return self.oauth_server.fetch_request_token(request)
+
+ def _get_authorized_token(self, request):
+ req_token = self._get_token(request)
+ return self.oauth_server.authorize_token(req_token, self.user)
+
+ def test_set_data_store(self):
+ self.oauth_server.data_store = None
+ self.assertTrue(self.oauth_server.data_store is None)
+ self.oauth_server.set_data_store(self.data_store)
+ self.assertTrue(self.oauth_server.data_store is not None)
+ self.assertTrue(isinstance(self.oauth_server.data_store,
+ oauth.OAuthDataStore))
+
+ def test_get_data_store(self):
+ self.assertEqual(self.oauth_server.data_store, self.data_store)
+
+ def test_add_signature_method(self):
+ signature_method = oauth.OAuthSignatureMethod_PLAINTEXT()
+ self.oauth_server.add_signature_method(signature_method)
+ self.assertTrue(isinstance(self.oauth_server.signature_methods\
+ .get(signature_method.get_name()),
+ oauth.OAuthSignatureMethod_PLAINTEXT))
+
+ def test_fetch_request_token(self):
+ initial_request = oauth.OAuthRequest.from_consumer_and_token(
+ self.consumer,
+ http_method=self.http_method,
+ http_url=self.request_token_url
+ )
+ req_token_1 = self._get_token(initial_request)
+ authorization_request = oauth.OAuthRequest.from_consumer_and_token(
+ self.consumer,
+ req_token_1,
+ http_method=self.http_method,
+ http_url=self.http_url
+ )
+ req_token_2 = self._get_token(authorization_request)
+ self.assertEqual(req_token_1.key, req_token_2.key)
+ self.assertEqual(req_token_1.secret, req_token_2.secret)
+
+ def _get_token_for_authorization(self):
+ request = oauth.OAuthRequest.from_consumer_and_token(
+ self.consumer,
+ http_method=self.http_method,
+ http_url=self.request_token_url
+ )
+ request_token = self._get_token(request)
+ authorization_request = oauth.OAuthRequest.from_consumer_and_token(
+ self.consumer,
+ request_token,
+ http_method=self.http_method,
+ http_url=self.http_url
+ )
+ return self._get_authorized_token(authorization_request)
+
+ def test_authorize_token(self):
+ authorized_token = self._get_token_for_authorization()
+ self.assertTrue(authorized_token is not None)
+
+ def _get_access_token_request(self, authorized_token):
+ access_token_request = oauth.OAuthRequest.from_consumer_and_token(
+ self.consumer,
+ authorized_token,
+ http_method=self.http_method,
+ http_url=self.access_token_url
+ )
+ self._prepare_request(access_token_request, authorized_token)
+ return access_token_request
+
+ def test_fetch_access_token(self):
+ authorized_token = self._get_token_for_authorization()
+ access_token_request = self._get_access_token_request(authorized_token)
+ access_token = self.oauth_server.fetch_access_token(access_token_request)
+ self.assertTrue(access_token is not None)
+ self.assertNotEqual(str(authorized_token), str(access_token))
+ # Try to fetch access_token with used request token
+ self.assertRaises(oauth.OAuthError, self.oauth_server.fetch_access_token,
+ access_token_request)
+
+ def test_verify_request(self):
+ authorized_token = self._get_token_for_authorization()
+ access_token_request = self._get_access_token_request(authorized_token)
+ access_token = self.oauth_server.fetch_access_token(access_token_request)
+ param1 = 'p1'
+ value1 = 'v1'
+ api_request = oauth.OAuthRequest.from_consumer_and_token(
+ self.consumer,
+ access_token,
+ http_method=self.http_method,
+ http_url=self.http_url,
+ parameters={param1:value1}
+ )
+ self._prepare_request(api_request, access_token)
+ result = self.oauth_server.verify_request(api_request)
+ self.assertTrue(result is not None)
+ consumer, token, parameters = result
+ self.assertEqual(parameters.get(param1), value1)
+
+ def test_get_callback(self):
+ request = oauth.OAuthRequest.from_consumer_and_token(
+ self.consumer,
+ None,
+ http_method=self.http_method,
+ http_url=self.http_url
+ )
+ self._prepare_request(request)
+ cb_url = 'http://example.com/cb'
+ request.set_parameter(OAuthParameters.CALLBACK, cb_url)
+ self.assertEqual(self.oauth_server.get_callback(request), cb_url)
+
+ def test_build_authenticate_header(self):
+ self.assertEqual(oauth.build_authenticate_header(), {'WWW-Authenticate':
+ 'OAuth realm=""'})
+ self.assertEqual(oauth.build_authenticate_header('foo'),
+ {'WWW-Authenticate': 'OAuth realm="foo"'})
+
+class OAuthClientTest(OAuthTest):
+ def setUp(self):
+ super(OAuthClientTest, self).setUp()
+ self.oauth_client = oauth.OAuthClient(self.consumer, self.token)
+
+ def test_get_consumer(self):
+ consumer = self.oauth_client.get_consumer()
+ self.assertTrue(isinstance(consumer, oauth.OAuthConsumer))
+ self.assertEqual(consumer.__dict__, self.consumer.__dict__)
+
+ def test_get_token(self):
+ token = self.oauth_client.get_token()
+ self.assertTrue(isinstance(token, oauth.OAuthToken))
+ self.assertEqual(token.__dict__, self.token.__dict__)
+
+#Mockup OAuthDataStore
+TOKEN_TYPE_REQUEST = 'request'
+TOKEN_TYPE_ACCESS = 'access'
+class MockOAuthDataStore(oauth.OAuthDataStore):
+ def __init__(self):
+ self.consumer = oauth.OAuthConsumer('a56b5ff0a637ab283d1d8e32ced37a9c',
+ '9a3248210c84b264b56b98c0b872bc8a')
+
+ self.consumer_db = {self.consumer.key: self.consumer}
+ self.request_token_db = {}
+ self.access_token_db = {}
+ self.nonce = None
+
+ def lookup_consumer(self, key):
+ return self.consumer_db.get(key)
+
+ def lookup_token(self, oauth_consumer, token_type, token_field):
+ data = None
+ if token_type == TOKEN_TYPE_REQUEST:
+ data = self.request_token_db.get(token_field)
+ elif token_type == TOKEN_TYPE_ACCESS:
+ data = self.access_token_db.get(token_field)
+
+ if data:
+ token, consumer, authenticated_user = data
+ if consumer.key == oauth_consumer.key:
+ return token
+ return None
+
+ def lookup_nonce(self, oauth_consumer, oauth_token, nonce):
+ is_used = self.nonce == nonce
+ self.nonce = nonce
+ return is_used
+
+ def fetch_request_token(self, oauth_consumer):
+ token = oauth.OAuthToken("5b2cafbf20b11bace53b29e37d8a673dRT",
+ "3f71254637df2002d8819458ae4f6c51RT")
+ self.request_token_db[token.key] = (token, oauth_consumer, None)
+ return token
+
+ def fetch_access_token(self, oauth_consumer, oauth_token):
+ data = self.request_token_db.get(oauth_token.key)
+ if data:
+ del self.request_token_db[oauth_token.key]
+ request_token, consumer, authenticated_user = data
+ access_token = oauth.OAuthToken("5b2cafbf20b11bace53b29e37d8a673dAT",
+ "3f71254637df2002d8819458ae4f6c51AT")
+ self.access_token_db[access_token.key] = (access_token,
+ consumer,
+ authenticated_user)
+ return access_token
+ else:
+ return None
+
+ def authorize_request_token(self, oauth_token, user):
+ data = self.request_token_db.get(oauth_token.key)
+ if data and data[2] == None:
+ request_token, consumer, authenticated_user = data
+ authenticated_user = user
+ self.request_token_db[request_token.key] = (request_token,
+ consumer,
+ authenticated_user)
+ return request_token
+ else:
+ return None
+
+#Mock user
+class MockUser(object):
+ def __init__(self, name):
+ self.name = name
+
+def suite():
+ return test_config.build_suite([OauthUtilsTest,
+ OAuthConsumerTest,
+ OAuthTokenTest,
+ OAuthRequestTest,
+ OAuthServerTest,
+ OAuthClientTest])
+
+if __name__ == '__main__':
+ unittest.main()
\ No newline at end of file
diff --git a/tests/gdata_tests/photos/__init__.py b/tests/gdata_tests/photos/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/photos/__init__.py
diff --git a/tests/gdata_tests/photos/service_test.py b/tests/gdata_tests/photos/service_test.py
new file mode 100755
index 0000000..5da3ff4
--- /dev/null
+++ b/tests/gdata_tests/photos/service_test.py
@@ -0,0 +1,82 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+import getpass
+import time
+import unittest
+import StringIO
+import gdata.photos.service
+import gdata.photos
+import atom
+
+
+username = ''
+password = ''
+test_image_location = '../../testimage.jpg'
+test_image_name = 'testimage.jpg'
+
+
+class PhotosServiceTest(unittest.TestCase):
+
+ def setUp(self):
+ # Initialize the client and create a new album for testing.
+ self.client = gdata.photos.service.PhotosService()
+ self.client.email = username
+ self.client.password = password
+ self.client.source = 'Photos Client Unit Tests'
+ self.client.ProgrammaticLogin()
+
+ # Give the album a unique title by appending the current time.
+ self.test_album = self.client.InsertAlbum(
+ 'Python library test' + str(time.time()),
+ 'A temporary test album.')
+
+ def testUploadGetAndDeletePhoto(self):
+ image_entry = self.client.InsertPhotoSimple(self.test_album,
+ 'test', 'a pretty testing picture', test_image_location)
+ self.assert_(image_entry.title.text == 'test')
+ results_feed = self.client.SearchUserPhotos('test')
+ self.assert_(len(results_feed.entry) > 0)
+ self.client.Delete(image_entry)
+
+ def testInsertPhotoUpdateBlobAndDelete(self):
+ new_entry = gdata.photos.PhotoEntry()
+ new_entry.title = atom.Title(text='a_test_image')
+ new_entry.summary = atom.Summary(text='Just a test.')
+ new_entry.category.append(atom.Category(
+ scheme='http://schemas.google.com/g/2005#kind',
+ term='http://schemas.google.com/photos/2007#photo'))
+ entry = self.client.InsertPhoto(self.test_album, new_entry,
+ test_image_location, content_type='image/jpeg')
+ self.assert_(entry.id.text)
+ updated_entry = self.client.UpdatePhotoBlob(entry, test_image_location)
+ self.assert_(entry.GetEditLink().href != updated_entry.GetEditLink().href)
+ self.client.Delete(updated_entry)
+
+ def tearDown(self):
+ # Delete the test album.
+ test_album = self.client.GetEntry(self.test_album.GetSelfLink().href)
+ self.client.Delete(test_album)
+
+
+if __name__ == '__main__':
+ print ('Google Photos test\nNOTE: Please run these tests only with a test '
+ 'account. The tests may delete or update your data.')
+ username = raw_input('Please enter your username: ')
+ password = getpass.getpass()
+ unittest.main()
diff --git a/tests/gdata_tests/photos_test.py b/tests/gdata_tests/photos_test.py
new file mode 100755
index 0000000..f18f3f0
--- /dev/null
+++ b/tests/gdata_tests/photos_test.py
@@ -0,0 +1,69 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+
+import unittest
+from gdata import test_data
+import gdata.photos
+
+
+class AlbumFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.album_feed = gdata.photos.AlbumFeedFromString(test_data.ALBUM_FEED)
+
+ def testCorrectXmlParsing(self):
+ self.assert_(self.album_feed.id.text == 'http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/1')
+ self.assert_(self.album_feed.gphoto_id.text == '1')
+ self.assert_(len(self.album_feed.entry) == 4)
+ for entry in self.album_feed.entry:
+ if entry.id.text == 'http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/photoid/2':
+ self.assert_(entry.summary.text == 'Blue')
+
+
+class PhotoFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.photos.PhotoFeedFromString(test_data.ALBUM_FEED)
+
+ def testCorrectXmlParsing(self):
+ for entry in self.feed.entry:
+ if entry.id.text == 'http://picasaweb.google.com/data/entry/api/user/sample.user/albumid/1/photoid/2':
+ self.assert_(entry.gphoto_id.text == '2')
+ self.assert_(entry.albumid.text == '1')
+ self.assert_(entry.exif.flash.text == 'true')
+ self.assert_(entry.media.title.type == 'plain')
+ self.assert_(entry.media.title.text == 'Aqua Blue.jpg')
+ self.assert_(len(entry.media.thumbnail) == 3)
+
+
+
+class AnyFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.photos.AnyFeedFromString(test_data.ALBUM_FEED)
+
+ def testEntryTypeConversion(self):
+ for entry in self.feed.entry:
+ if entry.id.text == 'http://picasaweb.google.com/data/feed/api/user/sample.user/albumid/':
+ self.assert_(isinstance(entry, gdata.photos.PhotoEntry))
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/projecthosting/__init__.py b/tests/gdata_tests/projecthosting/__init__.py
new file mode 100755
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/projecthosting/__init__.py
diff --git a/tests/gdata_tests/projecthosting/data_test.py b/tests/gdata_tests/projecthosting/data_test.py
new file mode 100755
index 0000000..c1ddeb6
--- /dev/null
+++ b/tests/gdata_tests/projecthosting/data_test.py
@@ -0,0 +1,180 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This module is used for version 2 of the Google Data APIs.
+
+__author__ = 'jlapenna@google.com (Joe LaPenna)'
+
+
+import unittest
+
+from gdata import test_data
+
+import gdata.projecthosting.data
+import atom.core
+import gdata.test_config as conf
+
+
+ISSUE_ENTRY = """\
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:issues='http://schemas.google.com/projecthosting/issues/2009'>
+ <id>http://code.google.com/feeds/issues/p/PROJECT_NAME/issues/full/1</id>
+ <updated>2009-09-09T20:34:35.365Z</updated>
+ <title>This is updated issue summary</title>
+ <content type='html'>This is issue description</content>
+ <link rel='self' type='application/atom+xml'
+ href='http://code.google.com/feeds/issues/p/PROJECT_NAME/issues/full/3'/>
+ <link rel='edit' type='application/atom+xml'
+ href='http://code.google.com/feeds/issues/p/PROJECT_NAME/issues/full/3'/>
+ <author>
+ <name>elizabeth.bennet</name>
+ <uri>/u/elizabeth.bennet/</uri>
+ </author>
+ <issues:cc>
+ <issues:uri>/u/@UBhTQl1UARRAVga7/</issues:uri>
+ <issues:username>mar...@domain.com</issues:username>
+ </issues:cc>
+ <issues:cc>
+ <issues:uri>/u/fitzwilliam.darcy/</issues:uri>
+ <issues:username>fitzwilliam.darcy</issues:username>
+ </issues:cc>
+ <issues:label>Type-Enhancement</issues:label>
+ <issues:label>Priority-Low</issues:label>
+ <issues:owner>
+ <issues:uri>/u/charlotte.lucas/</issues:uri>
+ <issues:username>charlotte.lucas</issues:username>
+ </issues:owner>
+ <issues:stars>0</issues:stars>
+ <issues:state>open</issues:state>
+ <issues:status>Started</issues:status>
+</entry>
+"""
+
+ISSUES_FEED = """\
+<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom'>
+ <id>http://code.google.com/feeds/issues/p/android-test2/issues/full</id>
+ <link href="http://code.google.com/feeds/issues/p/android-test2/issues/full"
+ rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml" />
+ <link href="http://code.google.com/feeds/issues/p/android-test2/issues/full"
+ rel="http://schemas.google.com/g/2005#post" type="application/atom+xml" />
+ <link href="http://code.google.com/feeds/issues/p/android-test2/issues/full"
+ rel="self" type="application/atom+xml" />
+ <updated>2009-09-22T04:06:32.794Z</updated>
+ %s
+</feed>
+""" % ISSUE_ENTRY
+
+
+COMMENT_ENTRY = """\
+<?xml version='1.0' encoding='UTF-8'?>
+<entry xmlns='http://www.w3.org/2005/Atom'
+ xmlns:issues='http://schemas.google.com/projecthosting/issues/2009'>
+ <content type='html'>This is comment - update issue</content>
+ <author>
+ <name>elizabeth.bennet</name>
+ </author>
+ <issues:updates>
+ <issues:summary>This is updated issue summary</issues:summary>
+ <issues:status>Started</issues:status>
+ <issues:ownerUpdate>charlotte.lucas</issues:ownerUpdate>
+ <issues:label>-Type-Defect</issues:label>
+ <issues:label>Type-Enhancement</issues:label>
+ <issues:label>-Milestone-2009</issues:label>
+ <issues:label>-Priority-Medium</issues:label>
+ <issues:label>Priority-Low</issues:label>
+ <issues:ccUpdate>-fitzwilliam.darcy</issues:ccUpdate>
+ <issues:ccUpdate>marialucas@domain.com</issues:ccUpdate>
+ </issues:updates>
+</entry>
+"""
+
+
+class CommentEntryTest(unittest.TestCase):
+
+ def testParsing(self):
+ entry = atom.core.parse(COMMENT_ENTRY,
+ gdata.projecthosting.data.CommentEntry)
+
+ updates = entry.updates
+
+ self.assertEquals(updates.summary.text, 'This is updated issue summary')
+ self.assertEquals(updates.status.text, 'Started')
+ self.assertEquals(updates.ownerUpdate.text, 'charlotte.lucas')
+
+ self.assertEquals(len(updates.label), 5)
+ self.assertEquals(updates.label[0].text, '-Type-Defect')
+ self.assertEquals(updates.label[1].text, 'Type-Enhancement')
+ self.assertEquals(updates.label[2].text, '-Milestone-2009')
+ self.assertEquals(updates.label[3].text, '-Priority-Medium')
+ self.assertEquals(updates.label[4].text, 'Priority-Low')
+
+ self.assertEquals(len(updates.ccUpdate), 2)
+ self.assertEquals(updates.ccUpdate[0].text, '-fitzwilliam.darcy')
+ self.assertEquals(updates.ccUpdate[1].text, 'marialucas@domain.com')
+
+
+class IssueEntryTest(unittest.TestCase):
+
+ def testParsing(self):
+ entry = atom.core.parse(ISSUE_ENTRY, gdata.projecthosting.data.IssueEntry)
+
+ self.assertEquals(entry.owner.uri.text, '/u/charlotte.lucas/')
+ self.assertEqual(entry.owner.username.text, 'charlotte.lucas')
+
+ self.assertEquals(len(entry.cc), 2)
+ cc_0 = entry.cc[0]
+ self.assertEquals(cc_0.uri.text, '/u/@UBhTQl1UARRAVga7/')
+ self.assertEquals(cc_0.username.text, 'mar...@domain.com')
+ cc_1 = entry.cc[1]
+ self.assertEquals(cc_1.uri.text, '/u/fitzwilliam.darcy/')
+ self.assertEquals(cc_1.username.text, 'fitzwilliam.darcy')
+
+ self.assertEquals(len(entry.label), 2)
+ self.assertEquals(entry.label[0].text, 'Type-Enhancement')
+ self.assertEquals(entry.label[1].text, 'Priority-Low')
+
+ self.assertEquals(entry.stars.text, '0')
+ self.assertEquals(entry.state.text, 'open')
+ self.assertEquals(entry.status.text, 'Started')
+
+
+class DataClassSanityTest(unittest.TestCase):
+
+ def test_basic_element_structure(self):
+ conf.check_data_classes(self, [
+ gdata.projecthosting.data.Uri,
+ gdata.projecthosting.data.Username,
+ gdata.projecthosting.data.Cc,
+ gdata.projecthosting.data.Label,
+ gdata.projecthosting.data.Owner,
+ gdata.projecthosting.data.Stars,
+ gdata.projecthosting.data.State,
+ gdata.projecthosting.data.Status,
+ gdata.projecthosting.data.Summary,
+ gdata.projecthosting.data.Updates,
+ gdata.projecthosting.data.IssueEntry,
+ gdata.projecthosting.data.IssuesFeed,
+ gdata.projecthosting.data.CommentEntry,
+ gdata.projecthosting.data.CommentsFeed])
+
+
+def suite():
+ return conf.build_suite([IssueEntryTest, DataClassSanityTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/projecthosting/live_client_test.py b/tests/gdata_tests/projecthosting/live_client_test.py
new file mode 100755
index 0000000..ca46f15
--- /dev/null
+++ b/tests/gdata_tests/projecthosting/live_client_test.py
@@ -0,0 +1,254 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'jlapenna@google.com (Joe LaPenna)'
+
+
+import unittest
+import gdata.projecthosting.client
+import gdata.projecthosting.data
+import gdata.gauth
+import gdata.client
+import atom.http_core
+import atom.mock_http_core
+import atom.core
+import gdata.data
+import gdata.test_config as conf
+
+
+conf.options.register_option(conf.PROJECT_NAME_OPTION)
+conf.options.register_option(conf.ISSUE_ASSIGNEE_OPTION)
+
+
+class ProjectHostingClientTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = None
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.projecthosting.client.ProjectHostingClient()
+ conf.configure_client(self.client, 'ProjectHostingClientTest', 'code')
+
+ self.project_name = conf.options.get_value('project_name')
+ self.assignee = conf.options.get_value('issue_assignee')
+ self.owner = conf.options.get_value('username')
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def create_issue(self):
+ # Add an issue
+ created = self.client.add_issue(
+ self.project_name,
+ 'my title',
+ 'my summary',
+ self.owner,
+ labels=['label0'])
+
+ self.assertEqual(created.title.text, 'my title')
+ self.assertEqual(created.content.text, 'my summary')
+
+ self.assertEqual(len(created.label), 1)
+ self.assertEqual(created.label[0].text, 'label0')
+
+ return created
+
+ def test_create_update_close(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_create_update_delete')
+
+ # Create the issue:
+ created = self.create_issue()
+
+ # Change the issue we just added.
+ issue_id = created.id.text.split('/')[-1]
+ update_response = self.client.update_issue(
+ self.project_name,
+ issue_id,
+ self.owner,
+ comment='My comment here.',
+ summary='New Summary',
+ status='Accepted',
+ owner=self.assignee,
+ labels=['-label0', 'label1'],
+ ccs=[self.owner])
+
+ updates = update_response.updates
+ # Make sure it changed our status, summary, and added the comment.
+ self.assertEqual(update_response.content.text, 'My comment here.')
+ self.assertEqual(updates.summary.text, 'New Summary')
+ self.assertEqual(updates.status.text, 'Accepted')
+
+ # Make sure it got all our label change requests.
+ self.assertEquals(len(updates.label), 2)
+ self.assertEquals(updates.label[0].text, '-label0')
+ self.assertEquals(updates.label[1].text, 'label1')
+
+ # Be sure it saw our CC change. We can't check the specific values (yet)
+ # because ccUpdate and ownerUpdate responses are mungled.
+ self.assertEquals(len(updates.ccUpdate), 1)
+ self.assert_(updates.ownerUpdate.text)
+
+ def test_get_issues(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_create_update_delete')
+
+ # Create an issue so we have something to look up.
+ created = self.create_issue()
+
+ # The fully qualified id is a url, we just want the number.
+ issue_id = created.id.text.split('/')[-1]
+
+ # Get the specific issue in our issues feed. You could use label,
+ # canned_query and others just the same.
+ query = gdata.projecthosting.client.Query(label='label0')
+ feed = self.client.get_issues(self.project_name, query=query)
+
+ # Make sure we at least find the entry we created with that label.
+ self.assert_(len(feed.entry) > 0)
+
+ for issue in feed.entry:
+ label_texts = [label.text for label in issue.label]
+ self.assert_('label0' in label_texts, 'Issue does not have label label0')
+
+ def test_get_comments(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_create_update_delete')
+
+ # Create an issue so we have something to look up.
+ created = self.create_issue()
+
+ # The fully qualified id is a url, we just want the number.
+ issue_id = created.id.text.split('/')[-1]
+
+ # Now lets add two comments to that issue.
+ for i in range(2):
+ update_response = self.client.update_issue(
+ self.project_name,
+ issue_id,
+ self.owner,
+ comment='My comment here %s' % i)
+
+ # We have an issue that has several comments. Lets get them.
+ comments_feed = self.client.get_comments(self.project_name, issue_id)
+
+ # It has 2 comments.
+ self.assertEqual(2, len(comments_feed.entry))
+
+
+class ProjectHostingDocExamplesTest(unittest.TestCase):
+
+ def setUp(self):
+ self.project_name = conf.options.get_value('project_name')
+ self.assignee = conf.options.get_value('issue_assignee')
+ self.owner = conf.options.get_value('username')
+ self.password = conf.options.get_value('password')
+
+ def test_doc_examples(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ issues_client = gdata.projecthosting.client.ProjectHostingClient()
+
+ self.authenticating_client(issues_client, self.owner, self.password)
+
+ issue = self.creating_issues(issues_client, self.project_name, self.owner)
+ issue_id = issue.id.text.split('/')[-1]
+
+ self.retrieving_all_issues(issues_client, self.project_name)
+ self.retrieving_issues_using_query_parameters(
+ issues_client,
+ self.project_name)
+ self.modifying_an_issue_or_creating_issue_comments(
+ issues_client,
+ self.project_name,
+ issue_id,
+ self.owner,
+ self.assignee)
+ self.retrieving_issues_comments_for_an_issue(
+ issues_client,
+ self.project_name,
+ issue_id)
+
+ def authenticating_client(self, client, username, password):
+ return client.client_login(
+ username,
+ password,
+ source='your-client-name',
+ service='code')
+
+ def creating_issues(self, client, project_name, owner):
+ """Create an issue."""
+ return client.add_issue(
+ project_name,
+ 'my title',
+ 'my summary',
+ owner,
+ labels=['label0'])
+
+ def retrieving_all_issues(self, client, project_name):
+ """Retrieve all the issues in a project."""
+ feed = client.get_issues(project_name)
+ for issue in feed.entry:
+ self.assert_(issue.title.text is not None)
+
+ def retrieving_issues_using_query_parameters(self, client, project_name):
+ """Retrieve a set of issues in a project."""
+ query = gdata.projecthosting.client.Query(label='label0', max_results=1000)
+ feed = client.get_issues(project_name, query=query)
+ for issue in feed.entry:
+ self.assert_(issue.title.text is not None)
+ return feed
+
+ def retrieving_issues_comments_for_an_issue(self, client, project_name,
+ issue_id):
+ """Retrieve all issue comments for an issue."""
+ comments_feed = client.get_comments(project_name, issue_id)
+ for comment in comments_feed.entry:
+ self.assert_(comment.content is not None)
+ return comments_feed
+
+ def modifying_an_issue_or_creating_issue_comments(self, client, project_name,
+ issue_id, owner, assignee):
+ """Add a comment and update metadata in an issue."""
+ return client.update_issue(
+ project_name,
+ issue_id,
+ owner,
+ comment='My comment here.',
+ summary='New Summary',
+ status='Accepted',
+ owner=assignee,
+ labels=['-label0', 'label1'],
+ ccs=[owner])
+
+
+def suite():
+ return conf.build_suite([ProjectHostingClientTest,
+ ProjectHostingDocExamplesTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/resumable_upload_test.py b/tests/gdata_tests/resumable_upload_test.py
new file mode 100755
index 0000000..dd295ba
--- /dev/null
+++ b/tests/gdata_tests/resumable_upload_test.py
@@ -0,0 +1,136 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2008, 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'e.bidelman@google.com (Eric Bidelman)'
+
+
+import os
+import unittest
+import atom.data
+import gdata.client
+import gdata.data
+import gdata.gauth
+import gdata.docs.client
+import gdata.docs.data
+import gdata.test_config as conf
+
+
+TEST_FILE_LOCATION_OPTION = conf.Option(
+ 'file',
+ 'Please enter the full path to a test file to upload',
+ description=('This test file will be uploaded to DocList which. An example '
+ 'file can be found in tests/gdata_tests/docs/test.doc'))
+
+CONTENT_TYPE_OPTION = conf.Option(
+ 'contenttype',
+ 'Please enter the mimetype of the file',
+ description='The content type should match that of the upload file.')
+
+conf.options.register_option(TEST_FILE_LOCATION_OPTION)
+conf.options.register_option(CONTENT_TYPE_OPTION)
+
+
+class ResumableUploadTestCase(unittest.TestCase):
+
+ def setUp(self):
+ self.client = None
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.docs.client.DocsClient(source='ResumableUploadTest')
+ if conf.options.get_value('ssl') == 'true':
+ self.client.ssl = True
+ self.f = open(conf.options.get_value('file'))
+ self.content_type = conf.options.get_value('contenttype')
+ conf.configure_client(
+ self.client, 'ResumableUploadTest', self.client.auth_service)
+
+ def tearDown(self):
+ conf.close_client(self.client)
+ self.f.close()
+
+ def testUploadEntireDocumentAndUpdate(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testUploadDocument')
+
+ uploader = gdata.client.ResumableUploader(
+ self.client, self.f, self.content_type, os.path.getsize(self.f.name),
+ chunk_size=20000, # 20000 bytes.
+ desired_class=gdata.docs.data.DocsEntry)
+
+ e = gdata.docs.data.DocsEntry(
+ title=atom.data.Title(text='MyResumableTitleEntireFile'))
+ e.category.append(gdata.docs.data.make_kind_category('document'))
+ e.writers_can_invite = gdata.docs.data.WritersCanInvite(value='false')
+
+ entry = uploader.UploadFile(
+ '/feeds/upload/create-session/default/private/full', entry=e)
+
+ # Verify upload has really completed.
+ self.assertEqual(uploader.QueryUploadStatus(), True)
+
+ self.assert_(isinstance(entry, gdata.docs.data.DocsEntry))
+ self.assertEqual(entry.title.text, 'MyResumableTitleEntireFile')
+ self.assertEqual(entry.GetDocumentType(), 'document')
+ self.assertEqual(entry.writers_can_invite.value, 'false')
+ self.assertEqual(int(entry.quota_bytes_used.text), 0)
+ self.client.Delete(entry, force=True)
+
+ def testUploadDocumentInChunks(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testUploadDocumentInChunks')
+
+ uploader = gdata.client.ResumableUploader(
+ self.client, self.f, self.content_type, os.path.getsize(self.f.name),
+ desired_class=gdata.docs.data.DocsEntry)
+
+ uploader._InitSession(
+ '/feeds/upload/create-session/default/private/full',
+ headers={'Slug': 'MyManualChunksNoAtomTitle'})
+
+ start_byte = 0
+ entry = None
+
+ while not entry:
+ entry = uploader.UploadChunk(
+ start_byte, uploader.file_handle.read(uploader.chunk_size))
+ start_byte += uploader.chunk_size
+
+ # Verify upload has really completed.
+ self.assertEqual(uploader.QueryUploadStatus(), True)
+
+ self.assert_(isinstance(entry, gdata.docs.data.DocsEntry))
+ self.assertEqual(entry.title.text, 'MyManualChunksNoAtomTitle')
+ self.assertEqual(entry.GetDocumentType(), 'document')
+ self.client.Delete(entry, force=True)
+
+
+def suite():
+ return conf.build_suite([ResumableUploadTestCase])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
+
+
diff --git a/tests/gdata_tests/sample_util_test.py b/tests/gdata_tests/sample_util_test.py
new file mode 100755
index 0000000..7b367e8
--- /dev/null
+++ b/tests/gdata_tests/sample_util_test.py
@@ -0,0 +1,58 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import sys
+import gdata.sample_util
+
+
+class SettingsUtilTest(unittest.TestCase):
+
+ def setUp(self):
+ self.settings = gdata.sample_util.SettingsUtil()
+
+ def test_get_param(self):
+ self.assert_(self.settings.get_param('missing', ask=False) is None)
+ self.settings.prefs['x'] = 'something'
+ self.assertEqual(self.settings.get_param('x'), 'something')
+
+ def test_get_param_from_command_line_arg(self):
+ self.assert_('x' not in self.settings.prefs)
+ self.assert_(self.settings.get_param('x', ask=False) is None)
+ sys.argv.append('--x=something')
+ self.assertEqual(self.settings.get_param('x'), 'something')
+ self.assert_('x' not in self.settings.prefs)
+ self.assert_('y' not in self.settings.prefs)
+ self.assert_(self.settings.get_param('y', ask=False) is None)
+ sys.argv.append('--y')
+ sys.argv.append('other')
+ self.assertEqual(self.settings.get_param('y', reuse=True), 'other')
+ self.assertEqual(self.settings.prefs['y'], 'other')
+
+
+def suite():
+ return conf.build_suite([SettingsUtilTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/service_test.py b/tests/gdata_tests/service_test.py
new file mode 100755
index 0000000..6bd5d46
--- /dev/null
+++ b/tests/gdata_tests/service_test.py
@@ -0,0 +1,577 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'api.jscudder (Jeff Scudder)'
+
+import unittest
+import getpass
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import gdata.service
+import gdata
+import gdata.auth
+import atom
+import atom.service
+import atom.token_store
+import os.path
+from gdata import test_data
+import atom.mock_http
+import atom.mock_http_core
+
+
+username = ''
+password = ''
+test_image_location = '../testimage.jpg'
+test_image_name = 'testimage.jpg'
+
+
+class GDataServiceMediaUnitTest(unittest.TestCase):
+
+ def setUp(self):
+ self.gd_client = gdata.service.GDataService()
+ self.gd_client.email = username
+ self.gd_client.password = password
+ self.gd_client.service = 'lh2'
+ self.gd_client.source = 'GDataService Media "Unit" Tests'
+ try:
+ self.gd_client.ProgrammaticLogin()
+ except gdata.service.CaptchaRequired:
+ self.fail('Required Captcha')
+ except gdata.service.BadAuthentication:
+ self.fail('Bad Authentication')
+ except gdata.service.Error:
+ self.fail('Login Error')
+
+ # create a test album
+ gd_entry = gdata.GDataEntry()
+ gd_entry.title = atom.Title(text='GData Test Album')
+ gd_entry.category.append(atom.Category(
+ scheme='http://schemas.google.com/g/2005#kind',
+ term='http://schemas.google.com/photos/2007#album'))
+
+ self.album_entry = self.gd_client.Post(gd_entry,
+ 'http://picasaweb.google.com/data/feed/api/user/' + username)
+
+ def tearDown(self):
+ album_entry = self.gd_client.Get(self.album_entry.id.text)
+ self.gd_client.Delete(album_entry.GetEditLink().href)
+
+ def testSourceGeneratesUserAgentHeader(self):
+ self.gd_client.source = 'GoogleInc-ServiceUnitTest-1'
+ self.assert_(self.gd_client.additional_headers['User-Agent'].startswith(
+ 'GoogleInc-ServiceUnitTest-1 GData-Python'))
+
+ def testMedia1(self):
+ # Create media-only
+ ms = gdata.MediaSource()
+ ms.setFile(test_image_location, 'image/jpeg')
+ media_entry = self.gd_client.Post(None,
+ self.album_entry.GetFeedLink().href, media_source = ms)
+ self.assert_(media_entry is not None)
+ self.assert_(isinstance(media_entry, gdata.GDataEntry))
+ self.assert_(media_entry.IsMedia())
+
+ # Update media & metadata
+ ms = gdata.MediaSource()
+ ms.setFile(test_image_location, 'image/jpeg')
+ media_entry.summary = atom.Summary(text='Test Image')
+ media_entry2 = self.gd_client.Put(media_entry,
+ media_entry.GetEditLink().href, media_source = ms)
+ self.assert_(media_entry2 is not None)
+ self.assert_(isinstance(media_entry2, gdata.GDataEntry))
+ self.assert_(media_entry2.IsMedia())
+ self.assert_(media_entry2.summary.text == 'Test Image')
+
+ # Read media binary
+ imageSource = self.gd_client.GetMedia(media_entry2.GetMediaURL())
+ self.assert_(isinstance(imageSource, gdata.MediaSource))
+ self.assert_(imageSource.content_type == 'image/jpeg')
+ self.assert_(imageSource.content_length)
+
+ imageData = imageSource.file_handle.read()
+ self.assert_(imageData)
+
+ # Delete entry
+ response = self.gd_client.Delete(media_entry2.GetEditLink().href)
+ self.assert_(response)
+
+ def testMedia2(self):
+ # Create media & metadata
+ ms = gdata.MediaSource()
+ ms.setFile(test_image_location, 'image/jpeg')
+ new_media_entry = gdata.GDataEntry()
+ new_media_entry.title = atom.Title(text='testimage1.jpg')
+ new_media_entry.summary = atom.Summary(text='Test Image')
+ new_media_entry.category.append(atom.Category(scheme =
+ 'http://schemas.google.com/g/2005#kind', term =
+ 'http://schemas.google.com/photos/2007#photo'))
+ media_entry = self.gd_client.Post(new_media_entry,
+ self.album_entry.GetFeedLink().href, media_source = ms)
+ self.assert_(media_entry is not None)
+ self.assert_(isinstance(media_entry, gdata.GDataEntry))
+ self.assert_(media_entry.IsMedia())
+ self.assert_(media_entry.summary.text == 'Test Image')
+
+ # Update media only
+ ms = gdata.MediaSource()
+ ms.setFile(test_image_location, 'image/jpeg')
+ media_entry = self.gd_client.Put(None, media_entry.GetEditMediaLink().href,
+ media_source = ms)
+ self.assert_(media_entry is not None)
+ self.assert_(isinstance(media_entry, gdata.GDataEntry))
+ self.assert_(media_entry.IsMedia())
+
+ # Delete entry
+ response = self.gd_client.Delete(media_entry.GetEditLink().href)
+ self.assert_(response)
+
+ def testMediaConstructorDefaults(self):
+
+ ms = gdata.MediaSource()
+ ms.setFile(test_image_location, 'image/jpeg')
+
+ self.assert_(ms is not None)
+ self.assert_(isinstance(ms, gdata.MediaSource))
+ self.assertEquals(ms.file_name, test_image_name)
+ self.assertEquals(ms.content_type, 'image/jpeg')
+
+ def testMediaConstructorWithFilePath(self):
+
+ ms = gdata.MediaSource(file_path=test_image_location,
+ content_type='image/jpeg')
+
+ self.assert_(ms is not None)
+ self.assert_(isinstance(ms, gdata.MediaSource))
+ self.assertEquals(ms.file_name, test_image_name)
+ self.assertEquals(ms.content_type, 'image/jpeg')
+
+ def testMediaConstructorWithFileHandle(self):
+
+ fh = open(test_image_location, 'r')
+ len = os.path.getsize(test_image_location)
+ ms = gdata.MediaSource(fh, 'image/jpeg', len, file_name=test_image_location)
+
+ self.assert_(ms is not None)
+ self.assert_(isinstance(ms, gdata.MediaSource))
+ self.assertEquals(ms.file_name, test_image_location)
+ self.assertEquals(ms.content_type, 'image/jpeg')
+
+
+class GDataServiceUnitTest(unittest.TestCase):
+
+ def setUp(self):
+ self.gd_client = gdata.service.GDataService()
+ self.gd_client.email = username
+ self.gd_client.password = password
+ self.gd_client.service = 'gbase'
+ self.gd_client.source = 'GDataClient "Unit" Tests'
+
+ def testProperties(self):
+ email_string = 'Test Email'
+ password_string = 'Passwd'
+
+ self.gd_client.email = email_string
+ self.assertEquals(self.gd_client.email, email_string)
+ self.gd_client.password = password_string
+ self.assertEquals(self.gd_client.password, password_string)
+
+ def testCorrectLogin(self):
+ try:
+ self.gd_client.ProgrammaticLogin()
+ self.assert_(isinstance(
+ self.gd_client.token_store.find_token(
+ 'http://base.google.com/base/feeds/'),
+ gdata.auth.ClientLoginToken))
+ self.assert_(self.gd_client.captcha_token is None)
+ self.assert_(self.gd_client.captcha_url is None)
+ except gdata.service.CaptchaRequired:
+ self.fail('Required Captcha')
+
+ def testDefaultHttpClient(self):
+ self.assert_(isinstance(self.gd_client.http_client,
+ atom.http.HttpClient))
+
+
+ def testGet(self):
+ try:
+ self.gd_client.ProgrammaticLogin()
+ except gdata.service.CaptchaRequired:
+ self.fail('Required Captcha')
+ except gdata.service.BadAuthentication:
+ self.fail('Bad Authentication')
+ except gdata.service.Error:
+ self.fail('Login Error')
+ self.gd_client.additional_headers = {'X-Google-Key':
+ 'ABQIAAAAoLioN3buSs9KqIIq9V' +
+ 'mkFxT2yXp_ZAY8_ufC3CFXhHIE' +
+ '1NvwkxRK8C1Q8OWhsWA2AIKv-c' +
+ 'VKlVrNhQ'}
+ self.gd_client.server = 'base.google.com'
+ result = self.gd_client.Get('/base/feeds/snippets?bq=digital+camera')
+ self.assert_(result is not None)
+ self.assert_(isinstance(result, atom.Feed))
+
+ def testGetWithAuthentication(self):
+ try:
+ self.gd_client.ProgrammaticLogin()
+ except gdata.service.CaptchaRequired:
+ self.fail('Required Captcha')
+ except gdata.service.BadAuthentication:
+ self.fail('Bad Authentication')
+ except gdata.service.Error:
+ self.fail('Login Error')
+ self.gd_client.additional_headers = {'X-Google-Key':
+ 'ABQIAAAAoLioN3buSs9KqIIq9V' +
+ 'mkFxT2yXp_ZAY8_ufC3CFXhHIE' +
+ '1NvwkxRK8C1Q8OWhsWA2AIKv-c' +
+ 'VKlVrNhQ'}
+ self.gd_client.server = 'base.google.com'
+ result = self.gd_client.Get('/base/feeds/items?bq=digital+camera')
+ self.assert_(result is not None)
+ self.assert_(isinstance(result, atom.Feed))
+
+ def testGetEntry(self):
+ try:
+ self.gd_client.ProgrammaticLogin()
+ except gdata.service.CaptchaRequired:
+ self.fail('Required Captcha')
+ except gdata.service.BadAuthentication:
+ self.fail('Bad Authentication')
+ except gdata.service.Error:
+ self.fail('Login Error')
+ self.gd_client.server = 'base.google.com'
+ try:
+ result = self.gd_client.GetEntry('/base/feeds/items?bq=digital+camera')
+ self.fail(
+ 'Result from server in GetEntry should have raised an exception')
+ except gdata.service.UnexpectedReturnType:
+ pass
+
+ def testGetFeed(self):
+ try:
+ self.gd_client.ProgrammaticLogin()
+ except gdata.service.CaptchaRequired:
+ self.fail('Required Captcha')
+ except gdata.service.BadAuthentication:
+ self.fail('Bad Authentication')
+ except gdata.service.Error:
+ self.fail('Login Error')
+ self.gd_client.server = 'base.google.com'
+ result = self.gd_client.GetFeed('/base/feeds/items?bq=digital+camera')
+ self.assert_(result is not None)
+ self.assert_(isinstance(result, atom.Feed))
+
+ def testGetWithResponseTransformer(self):
+ # Query Google Base and interpret the results as a GBaseSnippetFeed.
+ feed = self.gd_client.Get(
+ 'http://www.google.com/base/feeds/snippets?bq=digital+camera',
+ converter=gdata.base.GBaseSnippetFeedFromString)
+ self.assertEquals(isinstance(feed, gdata.base.GBaseSnippetFeed), True)
+
+ def testPostPutAndDelete(self):
+ try:
+ self.gd_client.ProgrammaticLogin()
+ except gdata.service.CaptchaRequired:
+ self.fail('Required Captcha')
+ except gdata.service.BadAuthentication:
+ self.fail('Bad Authentication')
+ except gdata.service.Error:
+ self.fail('Login Error')
+ self.gd_client.additional_headers = {'X-Google-Key':
+ 'ABQIAAAAoLioN3buSs9KqIIq9V' +
+ 'mkFxT2yXp_ZAY8_ufC3CFXhHIE' +
+ '1NvwkxRK8C1Q8OWhsWA2AIKv-c' +
+ 'VKlVrNhQ'}
+ self.gd_client.server = 'base.google.com'
+
+ # Insert a new item
+ response = self.gd_client.Post(test_data.TEST_BASE_ENTRY,
+ '/base/feeds/items')
+ self.assert_(response is not None)
+ self.assert_(isinstance(response, atom.Entry))
+ self.assert_(response.category[0].term == 'products')
+
+ # Find the item id of the created item
+ item_id = response.id.text.lstrip(
+ 'http://www.google.com/base/feeds/items/')
+ self.assert_(item_id is not None)
+
+ updated_xml = gdata.base.GBaseItemFromString(test_data.TEST_BASE_ENTRY)
+ # Change one of the labels in the item
+ updated_xml.label[2].text = 'beach ball'
+ # Update the item
+ response = self.gd_client.Put(updated_xml,
+ '/base/feeds/items/%s' % item_id)
+ self.assert_(response is not None)
+ new_base_item = gdata.base.GBaseItemFromString(str(response))
+ self.assert_(isinstance(new_base_item, atom.Entry))
+
+ # Delete the item the test just created.
+ response = self.gd_client.Delete('/base/feeds/items/%s' % item_id)
+ self.assert_(response)
+
+ def testPostPutAndDeleteWithConverters(self):
+ try:
+ self.gd_client.ProgrammaticLogin()
+ except gdata.service.CaptchaRequired:
+ self.fail('Required Captcha')
+ except gdata.service.BadAuthentication:
+ self.fail('Bad Authentication')
+ except gdata.service.Error:
+ self.fail('Login Error')
+ self.gd_client.additional_headers = {'X-Google-Key':
+ 'ABQIAAAAoLioN3buSs9KqIIq9V' +
+ 'mkFxT2yXp_ZAY8_ufC3CFXhHIE' +
+ '1NvwkxRK8C1Q8OWhsWA2AIKv-c' +
+ 'VKlVrNhQ'}
+ self.gd_client.server = 'base.google.com'
+
+ # Insert a new item
+ response = self.gd_client.Post(test_data.TEST_BASE_ENTRY,
+ '/base/feeds/items', converter=gdata.base.GBaseItemFromString)
+ self.assert_(response is not None)
+ self.assert_(isinstance(response, atom.Entry))
+ self.assert_(isinstance(response, gdata.base.GBaseItem))
+ self.assert_(response.category[0].term == 'products')
+
+ updated_xml = gdata.base.GBaseItemFromString(test_data.TEST_BASE_ENTRY)
+ # Change one of the labels in the item
+ updated_xml.label[2].text = 'beach ball'
+ # Update the item
+ response = self.gd_client.Put(updated_xml,
+ response.id.text,
+ converter=gdata.base.GBaseItemFromString)
+ self.assertEquals(response is not None, True)
+ self.assertEquals(isinstance(response, gdata.base.GBaseItem), True)
+
+ # Delete the item the test just created.
+ response = self.gd_client.Delete(response.id.text)
+ self.assert_(response)
+
+ def testCaptchaUrlGeneration(self):
+ # Populate the mock server with a pairing for a ClientLogin request to a
+ # CAPTCHA challenge.
+ mock_client = atom.mock_http.MockHttpClient()
+ captcha_response = atom.mock_http.MockResponse(
+ body="""Url=http://www.google.com/login/captcha
+Error=CaptchaRequired
+CaptchaToken=DQAAAGgAdkI1LK9
+CaptchaUrl=Captcha?ctoken=HiteT4b0Bk5Xg18_AcVoP6-yFkHPibe7O9EqxeiI7lUSN
+""", status=403, reason='Access Forbidden')
+ mock_client.add_response(captcha_response, 'POST',
+ 'https://www.google.com/accounts/ClientLogin')
+
+ # Set the exising client's handler so that it will make requests to the
+ # mock service instead of the real server.
+ self.gd_client.http_client = mock_client
+
+ try:
+ self.gd_client.ProgrammaticLogin()
+ self.fail('Login attempt should have caused a CAPTCHA challenge.')
+ except gdata.service.CaptchaRequired, error:
+ self.assertEquals(self.gd_client.captcha_url,
+ ('https://www.google.com/accounts/Captcha?ctoken=HiteT4b0Bk5Xg18_'
+ 'AcVoP6-yFkHPibe7O9EqxeiI7lUSN'))
+
+
+class DeleteWithUrlParamsTest(unittest.TestCase):
+
+ def setUp(self):
+ self.gd_client = gdata.service.GDataService()
+ # Set the client to echo the request back in the response.
+ self.gd_client.http_client.v2_http_client = (
+ atom.mock_http_core.SettableHttpClient(200, 'OK', '', {}))
+
+ def testDeleteWithUrlParams(self):
+ self.assert_(self.gd_client.Delete('http://example.com/test',
+ {'TestHeader': '123'}, {'urlParam1': 'a', 'urlParam2': 'test'}))
+ request = self.gd_client.http_client.v2_http_client.last_request
+ self.assertEqual(request.uri.host, 'example.com')
+ self.assertEqual(request.uri.path, '/test')
+ self.assertEqual(request.uri.query,
+ {'urlParam1': 'a', 'urlParam2': 'test'})
+
+ def testDeleteWithSessionId(self):
+ self.gd_client._SetSessionId('test_session_id')
+ self.assert_(self.gd_client.Delete('http://example.com/test',
+ {'TestHeader': '123'}, {'urlParam1': 'a', 'urlParam2': 'test'}))
+ request = self.gd_client.http_client.v2_http_client.last_request
+ self.assertEqual(request.uri.host, 'example.com')
+ self.assertEqual(request.uri.path, '/test')
+ self.assertEqual(request.uri.query, {'urlParam1': 'a',
+ 'urlParam2': 'test', 'gsessionid': 'test_session_id'})
+
+
+class QueryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.query = gdata.service.Query()
+
+ def testQueryShouldBehaveLikeDict(self):
+ try:
+ self.query['zap']
+ self.fail()
+ except KeyError:
+ pass
+ self.query['zap'] = 'x'
+ self.assert_(self.query['zap'] == 'x')
+
+ def testContructorShouldRejectBadInputs(self):
+ test_q = gdata.service.Query(params=[1,2,3,4])
+ self.assert_(len(test_q.keys()) == 0)
+
+ def testTextQueryProperty(self):
+ self.assert_(self.query.text_query is None)
+ self.query['q'] = 'test1'
+ self.assert_(self.query.text_query == 'test1')
+ self.query.text_query = 'test2'
+ self.assert_(self.query.text_query == 'test2')
+
+ def testOrderByQueryProperty(self):
+ self.assert_(self.query.orderby is None)
+ self.query['orderby'] = 'updated'
+ self.assert_(self.query.orderby == 'updated')
+ self.query.orderby = 'starttime'
+ self.assert_(self.query.orderby == 'starttime')
+
+ def testQueryShouldProduceExampleUris(self):
+ self.query.feed = '/base/feeds/snippets'
+ self.query.text_query = 'This is a test'
+ self.assert_(self.query.ToUri() == '/base/feeds/snippets?q=This+is+a+test')
+
+ def testCategoriesFormattedCorrectly(self):
+ self.query.feed = '/x'
+ self.query.categories.append('Fritz')
+ self.query.categories.append('Laurie')
+ self.assert_(self.query.ToUri() == '/x/-/Fritz/Laurie')
+ # The query's feed should not have been changed
+ self.assert_(self.query.feed == '/x')
+ self.assert_(self.query.ToUri() == '/x/-/Fritz/Laurie')
+
+ def testCategoryQueriesShouldEscapeOrSymbols(self):
+ self.query.feed = '/x'
+ self.query.categories.append('Fritz|Laurie')
+ self.assert_(self.query.ToUri() == '/x/-/Fritz%7CLaurie')
+
+ def testTypeCoercionOnIntParams(self):
+ self.query.feed = '/x'
+ self.query.max_results = 10
+ self.query.start_index = 5
+ self.assert_(isinstance(self.query.max_results, str))
+ self.assert_(isinstance(self.query.start_index, str))
+ self.assertEquals(self.query['max-results'], '10')
+ self.assertEquals(self.query['start-index'], '5')
+
+ def testPassInCategoryListToConstructor(self):
+ query = gdata.service.Query(feed='/feed/sample', categories=['foo', 'bar',
+ 'eggs|spam'])
+ url = query.ToUri()
+ self.assert_(url.find('/foo') > -1)
+ self.assert_(url.find('/bar') > -1)
+ self.assert_(url.find('/eggs%7Cspam') > -1)
+
+
+class GetNextPageInFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.gd_client = gdata.service.GDataService()
+
+ def testGetNextPage(self):
+ feed = self.gd_client.Get(
+ 'http://www.google.com/base/feeds/snippets?max-results=2',
+ converter=gdata.base.GBaseSnippetFeedFromString)
+ self.assert_(len(feed.entry) > 0)
+ first_id = feed.entry[0].id.text
+ feed2 = self.gd_client.GetNext(feed)
+ self.assert_(len(feed2.entry) > 0)
+ next_id = feed2.entry[0].id.text
+ self.assert_(first_id != next_id)
+ self.assert_(feed2.__class__ == feed.__class__)
+
+
+class ScopeLookupTest(unittest.TestCase):
+
+ def testLookupScopes(self):
+ scopes = gdata.service.lookup_scopes('cl')
+ self.assertEquals(scopes, gdata.service.CLIENT_LOGIN_SCOPES['cl'])
+ scopes = gdata.service.lookup_scopes(None)
+ self.assert_(scopes is None)
+ scopes = gdata.service.lookup_scopes('UNKNOWN_SERVICE')
+ self.assert_(scopes is None)
+
+
+class TokenLookupTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.service.GDataService()
+
+ def testSetAndGetClientLoginTokenWithNoService(self):
+ self.assert_(self.client.auth_token is None)
+ self.client.SetClientLoginToken('foo')
+ self.assert_(self.client.auth_token is None)
+ self.assert_(self.client.token_store.find_token(
+ atom.token_store.SCOPE_ALL) is not None)
+ self.assertEquals(self.client.GetClientLoginToken(), 'foo')
+ self.client.SetClientLoginToken('foo2')
+ self.assertEquals(self.client.GetClientLoginToken(), 'foo2')
+
+ def testSetAndGetClientLoginTokenWithService(self):
+ self.client.service = 'cp'
+ self.client.SetClientLoginToken('bar')
+ self.assertEquals(self.client.GetClientLoginToken(), 'bar')
+ # Changing the service should cause the token to no longer be found.
+ self.client.service = 'gbase'
+ self.client.current_token = None
+ self.assert_(self.client.GetClientLoginToken() is None)
+
+ def testSetAndGetClientLoginTokenWithScopes(self):
+ scopes = gdata.service.CLIENT_LOGIN_SCOPES['cl'][:]
+ scopes.extend(gdata.service.CLIENT_LOGIN_SCOPES['gbase'])
+ self.client.SetClientLoginToken('baz', scopes=scopes)
+ self.client.current_token = None
+ self.assert_(self.client.GetClientLoginToken() is None)
+ self.client.service = 'cl'
+ self.assertEquals(self.client.GetClientLoginToken(), 'baz')
+ self.client.service = 'gbase'
+ self.assertEquals(self.client.GetClientLoginToken(), 'baz')
+ self.client.service = 'wise'
+ self.assert_(self.client.GetClientLoginToken() is None)
+
+ def testLookupUsingTokenStore(self):
+ scopes = gdata.service.CLIENT_LOGIN_SCOPES['cl'][:]
+ scopes.extend(gdata.service.CLIENT_LOGIN_SCOPES['gbase'])
+ self.client.SetClientLoginToken('baz', scopes=scopes)
+ token = self.client.token_store.find_token(
+ 'http://www.google.com/calendar/feeds/foo')
+ self.assertEquals(token.get_token_string(), 'baz')
+ self.assertEquals(token.auth_header, '%s%s' % (
+ gdata.auth.PROGRAMMATIC_AUTH_LABEL, 'baz'))
+ token = self.client.token_store.find_token(
+ 'http://www.google.com/calendar/')
+ self.assert_(isinstance(token, gdata.auth.ClientLoginToken) == False)
+ token = self.client.token_store.find_token(
+ 'http://www.google.com/base/feeds/snippets')
+ self.assertEquals(token.get_token_string(), 'baz')
+
+
+if __name__ == '__main__':
+ print ('GData Service Media Unit Tests\nNOTE: Please run these tests only '
+ 'with a test account. The tests may delete or update your data.')
+ username = raw_input('Please enter your username: ')
+ password = getpass.getpass()
+ unittest.main()
diff --git a/tests/gdata_tests/sites/__init__.py b/tests/gdata_tests/sites/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/sites/__init__.py
diff --git a/tests/gdata_tests/sites/data_test.py b/tests/gdata_tests/sites/data_test.py
new file mode 100755
index 0000000..01352bc
--- /dev/null
+++ b/tests/gdata_tests/sites/data_test.py
@@ -0,0 +1,296 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'e.bidelman (Eric Bidelman)'
+
+import unittest
+import atom
+from gdata import test_data
+import gdata.acl.data
+import gdata.data
+import gdata.sites.data
+import gdata.test_config as conf
+
+
+def parse(xml_string, target_class):
+ """Convenience wrapper for converting an XML string to an XmlElement."""
+ return atom.core.xml_element_from_string(xml_string, target_class)
+
+
+class CommentEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = parse(test_data.SITES_COMMENT_ENTRY,
+ gdata.sites.data.ContentEntry)
+
+ def testToAndFromStringCommentEntry(self):
+ self.assertEqual(self.entry.Kind(), 'comment')
+ self.assert_(isinstance(self.entry.in_reply_to, gdata.sites.data.InReplyTo))
+ self.assertEqual(self.entry.in_reply_to.type, 'text/html')
+ self.assertEqual(
+ self.entry.FindParentLink(),
+ 'http://sites.google.com/feeds/content/site/gdatatestsite/abc123parent')
+ self.assertEqual(
+ self.entry.in_reply_to.href,
+ 'http://sites.google.com/site/gdatatestsite/annoucment/testpost')
+ self.assertEqual(
+ self.entry.in_reply_to.ref,
+ 'http://sites.google.com/feeds/content/site/gdatatestsite/abc123')
+ self.assertEqual(
+ self.entry.in_reply_to.source,
+ 'http://sites.google.com/feeds/content/site/gdatatestsite')
+
+
+class ListPageEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = parse(test_data.SITES_LISTPAGE_ENTRY,
+ gdata.sites.data.ContentEntry)
+
+ def testToAndFromStringWithData(self):
+ self.assert_(isinstance(self.entry, gdata.sites.data.ContentEntry))
+ self.assertEqual(self.entry.title.text, 'ListPagesTitle')
+ self.assertEqual(len(self.entry.author), 1)
+ self.assertEqual(self.entry.author[0].name.text, 'Test User')
+ self.assertEqual(self.entry.author[0].email.text, 'test@gmail.com')
+ self.assertEqual(self.entry.worksheet.name, 'listpage')
+ self.assertEqual(self.entry.header.row, '1')
+ self.assertEqual(self.entry.data.startRow, '2')
+ self.assertEqual(len(self.entry.data.column), 5)
+ self.assert_(isinstance(self.entry.data.column[0], gdata.sites.data.Column))
+ self.assertEqual(self.entry.data.column[0].index, 'A')
+ self.assertEqual(self.entry.data.column[0].name, 'Owner')
+ self.assert_(isinstance(self.entry.feed_link, gdata.data.FeedLink))
+ self.assertEqual(
+ self.entry.feed_link.href,
+ 'http:///sites.google.com/feeds/content/site/gdatatestsite?parent=abc')
+ self.assert_(isinstance(self.entry.content, gdata.sites.data.Content))
+ self.assert_(isinstance(self.entry.content.html, atom.core.XmlElement))
+ self.assertEqual(self.entry.content.type, 'xhtml')
+
+
+class ListItemEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = parse(test_data.SITES_LISTITEM_ENTRY,
+ gdata.sites.data.ContentEntry)
+
+ def testToAndFromStringWithData(self):
+ self.assert_(isinstance(self.entry, gdata.sites.data.ContentEntry))
+ self.assertEqual(len(self.entry.field), 5)
+ self.assert_(isinstance(self.entry.field[0], gdata.sites.data.Field))
+ self.assertEqual(self.entry.field[0].index, 'A')
+ self.assertEqual(self.entry.field[0].name, 'Owner')
+ self.assertEqual(self.entry.field[0].text, 'test value')
+ self.assertEqual(
+ self.entry.FindParentLink(),
+ 'http://sites.google.com/feeds/content/site/gdatatestsite/abc123def')
+
+
+class BaseSiteEntryTest(unittest.TestCase):
+
+ def testCreateBaseSiteEntry(self):
+ entry = gdata.sites.data.BaseSiteEntry()
+ parent_link = atom.data.Link(
+ rel=gdata.sites.data.SITES_PARENT_LINK_REL, href='abc')
+ entry.link.append(parent_link)
+ entry.category.append(
+ atom.data.Category(
+ scheme=gdata.sites.data.SITES_KIND_SCHEME,
+ term='%s#%s' % (gdata.sites.data.SITES_NAMESPACE, 'webpage'),
+ label='webpage'))
+ self.assertEqual(entry.Kind(), 'webpage')
+ self.assertEqual(entry.category[0].label, 'webpage')
+ self.assertEqual(
+ entry.category[0].term,
+ '%s#%s' % ('http://schemas.google.com/sites/2008', 'webpage'))
+ self.assertEqual(entry.link[0].href, 'abc')
+ self.assertEqual(entry.link[0].rel,
+ 'http://schemas.google.com/sites/2008#parent')
+
+ entry2 = gdata.sites.data.BaseSiteEntry(kind='webpage')
+ self.assertEqual(
+ entry2.category[0].term,
+ '%s#%s' % ('http://schemas.google.com/sites/2008', 'webpage'))
+
+
+class ContentFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = parse(test_data.SITES_CONTENT_FEED,
+ gdata.sites.data.ContentFeed)
+
+ def testToAndFromStringContentFeed(self):
+ self.assert_(isinstance(self.feed, gdata.sites.data.ContentFeed))
+ self.assertEqual(len(self.feed.entry), 8)
+ self.assert_(isinstance(self.feed.entry[0].revision,
+ gdata.sites.data.Revision))
+ self.assertEqual(int(self.feed.entry[0].revision.text), 2)
+ self.assertEqual(self.feed.entry[0].GetNodeId(), '1712987567114738703')
+ self.assert_(isinstance(self.feed.entry[0].page_name,
+ gdata.sites.data.PageName))
+ self.assertEqual(self.feed.entry[0].page_name.text, 'home')
+ self.assertEqual(self.feed.entry[0].FindRevisionLink(),
+ 'http:///sites.google.com/feeds/content/site/gdatatestsite/12345')
+ for entry in self.feed.entry:
+ self.assert_(isinstance(entry, gdata.sites.data.ContentEntry))
+ if entry.deleted is not None:
+ self.assert_(isinstance(entry.deleted, gdata.sites.data.Deleted))
+ self.assertEqual(entry.IsDeleted(), True)
+ else:
+ self.assertEqual(entry.IsDeleted(), False)
+
+ def testCreateContentEntry(self):
+ new_entry = gdata.sites.data.ContentEntry()
+ new_entry.content = gdata.sites.data.Content()
+ new_entry.content.html = '<div><p>here is html</p></div>'
+ self.assert_(isinstance(new_entry, gdata.sites.data.ContentEntry))
+ self.assert_(isinstance(new_entry.content, gdata.sites.data.Content))
+ self.assert_(isinstance(new_entry.content.html, atom.core.XmlElement))
+
+ new_entry2 = gdata.sites.data.ContentEntry()
+ new_entry2.content = gdata.sites.data.Content(
+ html='<div><p>here is html</p></div>')
+ self.assert_(isinstance(new_entry2, gdata.sites.data.ContentEntry))
+ self.assert_(isinstance(new_entry2.content, gdata.sites.data.Content))
+ self.assert_(isinstance(new_entry2.content.html, atom.core.XmlElement))
+
+ def testGetHelpers(self):
+ kinds = {'announcement': self.feed.GetAnnouncements,
+ 'announcementspage': self.feed.GetAnnouncementPages,
+ 'attachment': self.feed.GetAttachments,
+ 'comment': self.feed.GetComments,
+ 'filecabinet': self.feed.GetFileCabinets,
+ 'listitem': self.feed.GetListItems,
+ 'listpage': self.feed.GetListPages,
+ 'webpage': self.feed.GetWebpages}
+
+ for k, v in kinds.iteritems():
+ entries = v()
+ self.assertEqual(len(entries), 1)
+ for entry in entries:
+ self.assertEqual(entry.Kind(), k)
+ if k == 'attachment':
+ self.assertEqual(entry.GetAlternateLink().href,
+ 'http://sites.google.com/feeds/SOMELONGURL')
+
+
+class ActivityFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = parse(test_data.SITES_ACTIVITY_FEED,
+ gdata.sites.data.ActivityFeed)
+
+ def testToAndFromStringActivityFeed(self):
+ self.assert_(isinstance(self.feed, gdata.sites.data.ActivityFeed))
+ self.assertEqual(len(self.feed.entry), 2)
+ for entry in self.feed.entry:
+ self.assert_(isinstance(entry.summary, gdata.sites.data.Summary))
+ self.assertEqual(entry.summary.type, 'xhtml')
+ self.assert_(isinstance(entry.summary.html, atom.core.XmlElement))
+
+
+class RevisionFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = parse(test_data.SITES_REVISION_FEED,
+ gdata.sites.data.RevisionFeed)
+
+ def testToAndFromStringRevisionFeed(self):
+ self.assert_(isinstance(self.feed, gdata.sites.data.RevisionFeed))
+ self.assertEqual(len(self.feed.entry), 1)
+ entry = self.feed.entry[0]
+ self.assert_(isinstance(entry.content, gdata.sites.data.Content))
+ self.assert_(isinstance(entry.content.html, atom.core.XmlElement))
+ self.assertEqual(entry.content.type, 'xhtml')
+ self.assertEqual(
+ entry.FindParentLink(),
+ 'http://sites.google.com/feeds/content/site/siteName/54395424125706119')
+
+
+class SiteFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = parse(test_data.SITES_SITE_FEED,
+ gdata.sites.data.SiteFeed)
+
+ def testToAndFromStringSiteFeed(self):
+ self.assert_(isinstance(self.feed, gdata.sites.data.SiteFeed))
+ self.assertEqual(len(self.feed.entry), 2)
+ entry = self.feed.entry[0]
+ self.assert_(isinstance(entry.site_name, gdata.sites.data.SiteName))
+ self.assertEqual(entry.title.text, 'New Test Site')
+ self.assertEqual(entry.site_name.text, 'new-test-site')
+ self.assertEqual(
+ entry.FindAclLink(),
+ 'http://sites.google.com/feeds/acl/site/example.com/new-test-site')
+ self.assertEqual(
+ entry.FindSourceLink(),
+ 'http://sites.google.com/feeds/site/example.com/source-site')
+ self.assertEqual(entry.theme.text, 'iceberg')
+
+
+class AclFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = parse(test_data.SITES_ACL_FEED,
+ gdata.sites.data.AclFeed)
+
+ def testToAndFromStringAclFeed(self):
+ self.assert_(isinstance(self.feed, gdata.sites.data.AclFeed))
+ self.assertEqual(len(self.feed.entry), 1)
+ entry = self.feed.entry[0]
+ self.assert_(isinstance(entry, gdata.sites.data.AclEntry))
+ self.assert_(isinstance(entry.scope, gdata.acl.data.AclScope))
+ self.assertEqual(entry.scope.type, 'user')
+ self.assertEqual(entry.scope.value, 'user@example.com')
+ self.assert_(isinstance(entry.role, gdata.acl.data.AclRole))
+ self.assertEqual(entry.role.value, 'owner')
+ self.assertEqual(
+ entry.GetSelfLink().href,
+ ('https://sites.google.com/feeds/acl/site/example.com/'
+ 'new-test-site/user%3Auser%40example.com'))
+
+
+class DataClassSanityTest(unittest.TestCase):
+
+ def test_basic_element_structure(self):
+ conf.check_data_classes(self, [
+ gdata.sites.data.Revision, gdata.sites.data.PageName,
+ gdata.sites.data.Deleted, gdata.sites.data.Publisher,
+ gdata.sites.data.Worksheet, gdata.sites.data.Header,
+ gdata.sites.data.Column, gdata.sites.data.Data,
+ gdata.sites.data.Field, gdata.sites.data.InReplyTo,
+ gdata.sites.data.BaseSiteEntry, gdata.sites.data.ContentEntry,
+ gdata.sites.data.ContentFeed, gdata.sites.data.ActivityEntry,
+ gdata.sites.data.ActivityFeed, gdata.sites.data.RevisionEntry,
+ gdata.sites.data.RevisionFeed, gdata.sites.data.Content,
+ gdata.sites.data.Summary, gdata.sites.data.SiteName,
+ gdata.sites.data.SiteEntry, gdata.sites.data.SiteFeed,
+ gdata.sites.data.AclEntry, gdata.sites.data.AclFeed,
+ gdata.sites.data.Theme])
+
+
+def suite():
+ return conf.build_suite([
+ CommentEntryTest, ListPageEntryTest, ListItemEntryTest, BaseSiteEntryTest,
+ ContentFeedTest, ActivityFeedTest, RevisionFeedTest, SiteFeedTest,
+ AclFeedTest, DataClassSanityTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/sites/live_client_test.py b/tests/gdata_tests/sites/live_client_test.py
new file mode 100755
index 0000000..eec413e
--- /dev/null
+++ b/tests/gdata_tests/sites/live_client_test.py
@@ -0,0 +1,114 @@
+#!/usr/bin/python
+#
+# Copyright 2009 Google Inc. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'e.bidelman (Eric Bidelman)'
+
+import unittest
+import gdata.client
+import gdata.data
+import gdata.gauth
+import gdata.sites.client
+import gdata.sites.data
+import gdata.test_config as conf
+
+conf.options.register_option(conf.TEST_IMAGE_LOCATION_OPTION)
+conf.options.register_option(conf.APPS_DOMAIN_OPTION)
+conf.options.register_option(conf.SITES_NAME_OPTION)
+
+
+class SitesClientTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = None
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.sites.client.SitesClient(
+ site=conf.options.get_value('sitename'),
+ domain=conf.options.get_value('appsdomain'))
+ if conf.options.get_value('ssl') == 'true':
+ self.client.ssl = True
+ conf.configure_client(self.client, 'SitesTest', self.client.auth_service,
+ True)
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def testCreateUpdateDelete(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testCreateUpdateDelete')
+
+ new_entry = self.client.CreatePage(
+ 'webpage', 'Title Of Page', '<b>Your html content</b>')
+
+ self.assertEqual(new_entry.title.text, 'Title Of Page')
+ self.assertEqual(new_entry.page_name.text, 'title-of-page')
+ self.assert_(new_entry.GetAlternateLink().href is not None)
+ self.assertEqual(new_entry.Kind(), 'webpage')
+
+ # Change the title of the webpage we just added.
+ new_entry.title.text = 'Edited'
+ updated_entry = self.client.update(new_entry)
+
+ self.assertEqual(updated_entry.title.text, 'Edited')
+ self.assertEqual(updated_entry.page_name.text, 'title-of-page')
+ self.assert_(isinstance(updated_entry, gdata.sites.data.ContentEntry))
+
+ # Delete the test webpage from the Site.
+ self.client.delete(updated_entry)
+
+ def testCreateAndUploadToFilecabinet(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'testCreateAndUploadToFilecabinet')
+
+ filecabinet = self.client.CreatePage(
+ 'filecabinet', 'FilesGoHere', '<b>Your html content</b>',
+ page_name='diff-pagename-than-title')
+
+ self.assertEqual(filecabinet.title.text, 'FilesGoHere')
+ self.assertEqual(filecabinet.page_name.text, 'diff-pagename-than-title')
+ self.assert_(filecabinet.GetAlternateLink().href is not None)
+ self.assertEqual(filecabinet.Kind(), 'filecabinet')
+
+ # Upload a file to the filecabinet
+ filepath = conf.options.get_value('imgpath')
+ attachment = self.client.UploadAttachment(
+ filepath, filecabinet, content_type='image/jpeg', title='TestImageFile',
+ description='description here')
+
+ self.assertEqual(attachment.title.text, 'TestImageFile')
+ self.assertEqual(attachment.FindParentLink(),
+ filecabinet.GetSelfLink().href)
+
+ # Delete the test filecabinet and attachment from the Site.
+ self.client.delete(attachment)
+ self.client.delete(filecabinet)
+
+
+def suite():
+ return conf.build_suite([SitesClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/spreadsheet/__init__.py b/tests/gdata_tests/spreadsheet/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/spreadsheet/__init__.py
diff --git a/tests/gdata_tests/spreadsheet/service_test.py b/tests/gdata_tests/spreadsheet/service_test.py
new file mode 100755
index 0000000..427b9ef
--- /dev/null
+++ b/tests/gdata_tests/spreadsheet/service_test.py
@@ -0,0 +1,214 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'api.laurabeth@gmail.com (Laura Beth Lincoln)'
+
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import gdata.spreadsheet.service
+import gdata.service
+import atom.service
+import gdata.spreadsheet
+import atom
+import getpass
+
+
+username = ''
+password = ''
+ss_key = ''
+ws_key = ''
+
+
+class DocumentQueryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.query = gdata.spreadsheet.service.DocumentQuery()
+
+ def testTitle(self):
+ self.query['title'] = 'my title'
+ self.assert_(self.query['title'] == 'my title')
+ self.assert_(self.query.ToUri() == '?title=my+title')
+
+ def testTitleExact(self):
+ self.query['title-exact'] = 'true'
+ self.assert_(self.query['title-exact'] == 'true')
+ self.assert_(self.query.ToUri() == '?title-exact=true')
+
+
+class CellQueryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.query = gdata.spreadsheet.service.CellQuery()
+
+ def testMinRow(self):
+ self.query['min-row'] = '1'
+ self.assert_(self.query['min-row'] == '1')
+ self.assert_(self.query.ToUri() == '?min-row=1')
+
+ def testMaxRow(self):
+ self.query['max-row'] = '100'
+ self.assert_(self.query['max-row'] == '100')
+ self.assert_(self.query.ToUri() == '?max-row=100')
+
+ def testMinCol(self):
+ self.query['min-col'] = '2'
+ self.assert_(self.query['min-col'] == '2')
+ self.assert_(self.query.ToUri() == '?min-col=2')
+
+ def testMaxCol(self):
+ self.query['max-col'] = '20'
+ self.assert_(self.query['max-col'] == '20')
+ self.assert_(self.query.ToUri() == '?max-col=20')
+
+ def testRange(self):
+ self.query['range'] = 'A1:B4'
+ self.assert_(self.query['range'] == 'A1:B4')
+ self.assert_(self.query.ToUri() == '?range=A1%3AB4')
+
+ def testReturnEmpty(self):
+ self.query['return-empty'] = 'false'
+ self.assert_(self.query['return-empty'] == 'false')
+ self.assert_(self.query.ToUri() == '?return-empty=false')
+
+
+class ListQueryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.query = gdata.spreadsheet.service.ListQuery()
+
+ def testSpreadsheetQuery(self):
+ self.query['sq'] = 'first=john&last=smith'
+ self.assert_(self.query['sq'] == 'first=john&last=smith')
+ self.assert_(self.query.ToUri() == '?sq=first%3Djohn%26last%3Dsmith')
+
+ def testOrderByQuery(self):
+ self.query['orderby'] = 'column:first'
+ self.assert_(self.query['orderby'] == 'column:first')
+ self.assert_(self.query.ToUri() == '?orderby=column%3Afirst')
+
+ def testReverseQuery(self):
+ self.query['reverse'] = 'true'
+ self.assert_(self.query['reverse'] == 'true')
+ self.assert_(self.query.ToUri() == '?reverse=true')
+
+
+class SpreadsheetsServiceTest(unittest.TestCase):
+
+ def setUp(self):
+ self.key = ss_key
+ self.worksheet = ws_key
+ self.gd_client = gdata.spreadsheet.service.SpreadsheetsService()
+ self.gd_client.email = username
+ self.gd_client.password = password
+ self.gd_client.source = 'SpreadsheetsClient "Unit" Tests'
+ self.gd_client.ProgrammaticLogin()
+
+ def testGetSpreadsheetsFeed(self):
+ entry = self.gd_client.GetSpreadsheetsFeed(self.key)
+ self.assert_(isinstance(entry, gdata.spreadsheet.SpreadsheetsSpreadsheet))
+
+ def testGetWorksheetsFeed(self):
+ feed = self.gd_client.GetWorksheetsFeed(self.key)
+ self.assert_(isinstance(feed, gdata.spreadsheet.SpreadsheetsWorksheetsFeed))
+ entry = self.gd_client.GetWorksheetsFeed(self.key, self.worksheet)
+ self.assert_(isinstance(entry, gdata.spreadsheet.SpreadsheetsWorksheet))
+
+ def testGetCellsFeed(self):
+ feed = self.gd_client.GetCellsFeed(self.key)
+ self.assert_(isinstance(feed, gdata.spreadsheet.SpreadsheetsCellsFeed))
+ entry = self.gd_client.GetCellsFeed(self.key, cell='R5C1')
+ self.assert_(isinstance(entry, gdata.spreadsheet.SpreadsheetsCell))
+
+ def testGetListFeed(self):
+ feed = self.gd_client.GetListFeed(self.key)
+ self.assert_(isinstance(feed, gdata.spreadsheet.SpreadsheetsListFeed))
+ entry = self.gd_client.GetListFeed(self.key, row_id='cpzh4')
+ self.assert_(isinstance(entry, gdata.spreadsheet.SpreadsheetsList))
+
+ def testUpdateCell(self):
+ self.gd_client.UpdateCell(row='5', col='1', inputValue='', key=self.key)
+ self.gd_client.UpdateCell(row='5', col='1', inputValue='newer data',
+ key=self.key)
+
+ def testBatchUpdateCell(self):
+ cell_feed = self.gd_client.GetCellsFeed(key=self.key)
+ edit_cell = cell_feed.entry[0]
+ old_cell_value = 'a1'
+
+ # Create a batch request to change the contents of a cell.
+ batch_feed = gdata.spreadsheet.SpreadsheetsCellsFeed()
+ edit_cell.cell.inputValue = 'New Value'
+ batch_feed.AddUpdate(edit_cell)
+ result = self.gd_client.ExecuteBatch(batch_feed,
+ url=cell_feed.GetBatchLink().href)
+ self.assertEquals(len(result.entry), 1)
+ self.assertEquals(result.entry[0].cell.inputValue, 'New Value')
+
+ # Make a second batch request to change the cell's value back.
+ edit_cell = result.entry[0]
+ edit_cell.cell.inputValue = old_cell_value
+ batch_feed = gdata.spreadsheet.SpreadsheetsCellsFeed()
+ batch_feed.AddUpdate(edit_cell)
+ restored = self.gd_client.ExecuteBatch(batch_feed,
+ url=cell_feed.GetBatchLink().href)
+ self.assertEquals(len(restored.entry), 1)
+ self.assertEquals(restored.entry[0].cell.inputValue, old_cell_value)
+
+ def testInsertUpdateRow(self):
+ entry = self.gd_client.InsertRow({'a1':'new', 'b1':'row', 'c1':'was',
+ 'd1':'here'}, self.key)
+ entry = self.gd_client.UpdateRow(entry, {'a1':'newer',
+ 'b1':entry.custom['b1'].text, 'c1':entry.custom['c1'].text,
+ 'd1':entry.custom['d1'].text})
+ self.gd_client.DeleteRow(entry)
+
+ def testWorksheetCRUD(self):
+ # Add a new worksheet.
+ new_worksheet = self.gd_client.AddWorksheet('worksheet_title_test_12', '2',
+ 3, self.key)
+ self.assertEquals(new_worksheet.col_count.text, '3')
+ self.assertEquals(new_worksheet.row_count.text, '2')
+ self.assertEquals(new_worksheet.title.text, 'worksheet_title_test_12')
+
+ # Change the dimensions and title of the new worksheet.
+ new_worksheet.col_count.text = '1'
+ new_worksheet.title.text = 'edited worksheet test12'
+ edited_worksheet = self.gd_client.UpdateWorksheet(new_worksheet)
+ self.assertEquals(edited_worksheet.col_count.text, '1')
+ self.assertEquals(edited_worksheet.row_count.text, '2')
+ self.assertEquals(edited_worksheet.title.text, 'edited worksheet test12')
+
+ # Delete the new worksheet.
+ result = self.gd_client.DeleteWorksheet(edited_worksheet)
+ self.assertEquals(result, True)
+
+
+
+
+if __name__ == '__main__':
+ print ('Spreadsheet Tests\nNOTE: Please run these tests only with a test '
+ 'account. The tests may delete or update your data.')
+ print ('These tests must be run on a sheet with this data:\n'
+ 'a1,b1,c1,d1\n'
+ '1,2,3,4')
+ username = raw_input('Please enter your username: ')
+ password = getpass.getpass()
+ ss_key = raw_input('Please enter your spreadsheet key: ')
+ ws_key = raw_input('Please enter your worksheet key (usually od6): ')
+ unittest.main()
diff --git a/tests/gdata_tests/spreadsheet/text_db_test.py b/tests/gdata_tests/spreadsheet/text_db_test.py
new file mode 100755
index 0000000..7b321fd
--- /dev/null
+++ b/tests/gdata_tests/spreadsheet/text_db_test.py
@@ -0,0 +1,209 @@
+#!/usr/bin/python
+#
+# Copyright Google 2007-2008, all rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import time
+import unittest
+import getpass
+import gdata.spreadsheet.text_db
+import gdata.spreadsheet.service
+
+
+__author__ = 'api.jscudder (Jeffrey Scudder)'
+
+
+username = ''
+password = ''
+
+
+class FactoryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.spreadsheet.text_db.DatabaseClient()
+
+ def testBadCredentials(self):
+ try:
+ self.client.SetCredentials('foo', 'bar')
+ self.fail()
+ except gdata.spreadsheet.text_db.Error, e:
+ pass
+
+ def testCreateGetAndDeleteDatabase(self):
+ db_title = 'google_spreadsheets_db unit test 1'
+ self.client.SetCredentials(username, password)
+ db = self.client.CreateDatabase(db_title)
+ # Test finding the database using the name
+ time.sleep(5)
+ db_list = self.client.GetDatabases(name=db_title)
+ self.assert_(len(db_list) >= 1)
+ if len(db_list) >= 1:
+ self.assert_(db_list[0].entry.title.text == db_title)
+ # Test finding the database using the spreadsheet key
+ db_list = self.client.GetDatabases(spreadsheet_key=db.spreadsheet_key)
+ self.assert_(len(db_list) == 1)
+ self.assert_(db_list[0].entry.title.text == db_title)
+ # Delete the test spreadsheet
+ time.sleep(10)
+ db.Delete()
+
+
+class DatabaseTest(unittest.TestCase):
+
+ def setUp(self):
+ client = gdata.spreadsheet.text_db.DatabaseClient(username, password)
+ self.db = client.CreateDatabase('google_spreadsheets_db unit test 2')
+
+ def tearDown(self):
+ time.sleep(10)
+ self.db.Delete()
+
+ def testCreateGetAndDeleteTable(self):
+ table = self.db.CreateTable('test1', ['1','2','3'])
+ # Try to get the new table using the worksheet id.
+ table_list = self.db.GetTables(worksheet_id=table.worksheet_id)
+ self.assert_(len(table_list) == 1)
+ self.assert_(table_list[0].entry.title.text, 'test1')
+ # Try to get the table using the name
+ table_list = self.db.GetTables(name='test1')
+ self.assert_(len(table_list) == 1)
+ self.assert_(table_list[0].entry.title.text, 'test1')
+ # Delete the table
+ table.Delete()
+
+
+class TableTest(unittest.TestCase):
+
+ def setUp(self):
+ client = gdata.spreadsheet.text_db.DatabaseClient(username, password)
+ self.db = client.CreateDatabase('google_spreadsheets_db unit test 3')
+ self.table = self.db.CreateTable('test1', ['a','b','c_d','a', 'd:e'])
+
+ def tearDown(self):
+ time.sleep(10)
+ self.db.Delete()
+
+ def testCreateGetAndDeleteRecord(self):
+ new_record = self.table.AddRecord({'a':'test1', 'b':'test2', 'cd':'test3', 'a_2':'test4', 'de':'test5'})
+ # Test getting record by line number.
+ record = self.table.GetRecord(row_number=1)
+ self.assert_(record is not None)
+ self.assert_(record.content['a'] == 'test1')
+ self.assert_(record.content['b'] == 'test2')
+ self.assert_(record.content['cd'] == 'test3')
+ self.assert_(record.content['a_2'] == 'test4')
+ # Test getting record using the id.
+ record_list = self.table.GetRecord(row_id=new_record.row_id)
+ self.assert_(record is not None)
+ # Delete the record.
+ time.sleep(10)
+ new_record.Delete()
+
+ def testPushPullSyncing(self):
+ # Get two copies of the same row.
+ first_copy = self.table.AddRecord({'a':'1', 'b':'2', 'cd':'3', 'a_2':'4', 'de':'5'})
+ second_copy = self.table.GetRecord(first_copy.row_id)
+
+ # Make changes in the first copy
+ first_copy.content['a'] = '7'
+ first_copy.content['b'] = '9'
+
+ # Try to get the changes before they've been committed
+ second_copy.Pull()
+ self.assert_(second_copy.content['a'] == '1')
+ self.assert_(second_copy.content['b'] == '2')
+
+ # Commit the changes, the content should now be different
+ first_copy.Push()
+ second_copy.Pull()
+ self.assert_(second_copy.content['a'] == '7')
+ self.assert_(second_copy.content['b'] == '9')
+
+ # Make changes to the second copy, push, then try to push changes from
+ # the first copy.
+ first_copy.content['a'] = '10'
+ second_copy.content['a'] = '15'
+ first_copy.Push()
+ try:
+ second_copy.Push()
+ # The second update should raise and exception due to a 409 conflict.
+ self.fail()
+ except gdata.spreadsheet.service.RequestError:
+ pass
+ except Exception, error:
+ #TODO: Why won't the except RequestError catch this?
+ pass
+
+ def testFindRecords(self):
+ # Add lots of test records:
+ self.table.AddRecord({'a':'1', 'b':'2', 'cd':'3', 'a_2':'4', 'de':'5'})
+ self.table.AddRecord({'a':'hi', 'b':'2', 'cd':'20', 'a_2':'4', 'de':'5'})
+ self.table.AddRecord({'a':'2', 'b':'2', 'cd':'3'})
+ self.table.AddRecord({'a':'2', 'b':'2', 'cd':'15', 'de':'7'})
+ self.table.AddRecord({'a':'hi hi hi', 'b':'2', 'cd':'15', 'de':'7'})
+ self.table.AddRecord({'a':'"5"', 'b':'5', 'cd':'15', 'de':'7'})
+ self.table.AddRecord({'a':'5', 'b':'5', 'cd':'15', 'de':'7'})
+
+ time.sleep(10)
+ matches = self.table.FindRecords('a == 1')
+ self.assert_(len(matches) == 1)
+ self.assert_(matches[0].content['a'] == '1')
+ self.assert_(matches[0].content['b'] == '2')
+
+ matches = self.table.FindRecords('a > 1 && cd < 20')
+ self.assert_(len(matches) == 4)
+ matches = self.table.FindRecords('cd < de')
+ self.assert_(len(matches) == 7)
+ matches = self.table.FindRecords('a == b')
+ self.assert_(len(matches) == 0)
+ matches = self.table.FindRecords('a == 5')
+ self.assert_(len(matches) == 1)
+
+ def testIterateResultSet(self):
+ # Populate the table with test data.
+ self.table.AddRecord({'a':'1', 'b':'2', 'cd':'3', 'a_2':'4', 'de':'5'})
+ self.table.AddRecord({'a':'hi', 'b':'2', 'cd':'20', 'a_2':'4', 'de':'5'})
+ self.table.AddRecord({'a':'2', 'b':'2', 'cd':'3'})
+ self.table.AddRecord({'a':'2', 'b':'2', 'cd':'15', 'de':'7'})
+ self.table.AddRecord({'a':'hi hi hi', 'b':'2', 'cd':'15', 'de':'7'})
+ self.table.AddRecord({'a':'"5"', 'b':'5', 'cd':'15', 'de':'7'})
+ self.table.AddRecord({'a':'5', 'b':'5', 'cd':'15', 'de':'7'})
+
+ # Get the first two rows.
+ records = self.table.GetRecords(1, 2)
+ self.assert_(len(records) == 2)
+ self.assert_(records[0].content['a'] == '1')
+ self.assert_(records[1].content['a'] == 'hi')
+
+ # Then get the next two rows.
+ next_records = records.GetNext()
+ self.assert_(len(next_records) == 2)
+ self.assert_(next_records[0].content['a'] == '2')
+ self.assert_(next_records[0].content['cd'] == '3')
+ self.assert_(next_records[1].content['cd'] == '15')
+ self.assert_(next_records[1].content['de'] == '7')
+
+ def testLookupFieldsOnPreexistingTable(self):
+ existing_table = self.db.GetTables(name='test1')[0]
+ existing_table.LookupFields()
+ self.assertEquals(existing_table.fields, ['a', 'b', 'cd', 'a_2', 'de'])
+
+
+if __name__ == '__main__':
+ if not username:
+ username = raw_input('Spreadsheets API | Text DB Tests\n'
+ 'Please enter your username: ')
+ if not password:
+ password = getpass.getpass()
+ unittest.main()
diff --git a/tests/gdata_tests/spreadsheet_test.py b/tests/gdata_tests/spreadsheet_test.py
new file mode 100755
index 0000000..5112f64
--- /dev/null
+++ b/tests/gdata_tests/spreadsheet_test.py
@@ -0,0 +1,407 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.laurabeth@gmail.com (Laura Beth Lincoln)'
+
+
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import gdata
+import gdata.spreadsheet
+
+SPREADSHEETS_FEED = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gs="http://schemas.google.com/spreadsheets/2006">
+ <id>http://spreadsheets.google.com/feeds/spreadsheets/private/full</id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <title type="text">Available Spreadsheets</title>
+ <link rel="alternate" type="text/html"
+ href="http://spreadsheets.google.com/ccc?key=key"/>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/key/private/full"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/key/private/full"/>
+ <author>
+ <name>Fitzwilliam Darcy</name>
+ <email>fitz@gmail.com</email>
+ </author>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1</openSearch:itemsPerPage>
+ <entry>
+ <id>http://spreadsheets.google.com/feeds/spreadsheets/private/full/key</id>
+ <updated>2006-11-17T18:24:18.231Z</updated>
+ <title type="text">Groceries R Us</title>
+ <content type="text">Groceries R Us</content>
+ <link rel="http://schemas.google.com/spreadsheets/2006#worksheetsfeed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/key/private/full"/>
+ <link rel="alternate" type="text/html"
+ href="http://spreadsheets.google.com/ccc?key=key"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/spreadsheets/private/full/key"/>
+ <author>
+ <name>Fitzwilliam Darcy</name>
+ <email>fitz@gmail.com</email>
+ </author>
+ </entry>
+</feed>
+"""
+
+WORKSHEETS_FEED = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gs="http://schemas.google.com/spreadsheets/2006">
+ <id>http://spreadsheets.google.com/feeds/worksheets/key/private/full</id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <title type="text">Groceries R Us</title>
+ <link rel="alternate" type="text/html"
+ href="http://spreadsheets.google.com/ccc?key=key"/>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/key/private/full"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/key/private/full"/>
+ <author>
+ <name>Fitzwilliam Darcy</name>
+ <email>fitz@gmail.com</email>
+ </author>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1</openSearch:itemsPerPage>
+ <entry>
+ <id>http://spreadsheets.google.com/feeds/worksheets/key/private/full/od6</id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <title type="text">Sheet1</title>
+ <content type="text">Sheet1</content>
+ <link rel="http://schemas.google.com/spreadsheets/2006#listfeed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/key/od6/private/full"/>
+ <link rel="http://schemas.google.com/spreadsheets/2006#cellsfeed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/key/od6/private/full"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/key/private/full/od6"/>
+ <gs:rowCount>100</gs:rowCount>
+ <gs:colCount>20</gs:colCount>
+ </entry>
+</feed>
+"""
+
+CELLS_FEED = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gs="http://schemas.google.com/spreadsheets/2006">
+ <id>http://spreadsheets.google.com/feeds/cells/key/od6/private/full</id>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <title type="text">Sheet1</title>
+ <link rel="alternate" type="text/html"
+ href="http://spreadsheets.google.com/ccc?key=key"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/key/od6/private/full"/>
+ <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/key/od6/private/full"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/key/od6/private/full"/>
+ <author>
+ <name>Fitzwilliam Darcy</name>
+ <email>fitz@gmail.com</email>
+ </author>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1</openSearch:itemsPerPage>
+ <gs:rowCount>100</gs:rowCount>
+ <gs:colCount>20</gs:colCount>
+ <entry>
+ <id>http://spreadsheets.google.com/feeds/cells/key/od6/private/full/R1C1</id>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <category scheme="http://schemas.google.com/spreadsheets/2006"
+ term="http://schemas.google.com/spreadsheets/2006#cell"/>
+ <title type="text">A1</title>
+ <content type="text">Name</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/key/od6/private/full/R1C1"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/key/od6/private/full/R1C1/bgvjf"/>
+ <gs:cell row="1" col="1" inputValue="Name">Name</gs:cell>
+ </entry>
+ <entry>
+ <id>http://spreadsheets.google.com/feeds/cells/key/od6/private/full/R1C2</id>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <category scheme="http://schemas.google.com/spreadsheets/2006"
+ term="http://schemas.google.com/spreadsheets/2006#cell"/>
+ <title type="text">B1</title>
+ <content type="text">Hours</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/key/od6/private/full/R1C2"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/key/od6/private/full/R1C2/1pn567"/>
+ <gs:cell row="1" col="2" inputValue="Hours">Hours</gs:cell>
+ </entry>
+</feed>
+"""
+
+LIST_FEED = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/"
+ xmlns:gsx="http://schemas.google.com/spreadsheets/2006/extended">
+ <id>http://spreadsheets.google.com/feeds/list/key/od6/private/full</id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <title type="text">Sheet1</title>
+ <link rel="alternate" type="text/html"
+ href="http://spreadsheets.google.com/ccc?key=key"/>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/key/od6/private/full"/>
+ <link rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/key/od6/private/full"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/key/od6/private/full"/>
+ <author>
+ <name>Fitzwilliam Darcy</name>
+ <email>fitz@gmail.com</email>
+ </author>
+ <openSearch:totalResults>2</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>2</openSearch:itemsPerPage>
+ <entry>
+ <id>http://spreadsheets.google.com/feeds/list/key/od6/private/full/cokwr</id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <category scheme="http://schemas.google.com/spreadsheets/2006"
+ term="http://schemas.google.com/spreadsheets/2006#list"/>
+ <title type="text">Bingley</title>
+ <content type="text">Hours: 10, Items: 2, IPM: 0.0033</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/key/od6/private/full/cokwr"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/key/od6/private/full/cokwr/2ehkc2oh7d"/>
+ <gsx:name>Bingley</gsx:name>
+ <gsx:hours>10</gsx:hours>
+ <gsx:items>2</gsx:items>
+ <gsx:ipm>0.0033</gsx:ipm>
+ </entry>
+ <entry>
+ <id>http://spreadsheets.google.com/feeds/list/key/od6/private/full/cyevm</id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <category scheme="http://schemas.google.com/spreadsheets/2006"
+ term="http://schemas.google.com/spreadsheets/2006#list"/>
+ <title type="text">Charlotte</title>
+ <content type="text">Hours: 60, Items: 18000, IPM: 5</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/key/od6/private/full/cyevm"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/key/od6/private/full/cyevm/64rl27px3zyn"/>
+ <gsx:name>Charlotte</gsx:name>
+ <gsx:hours>60</gsx:hours>
+ <gsx:items>18000</gsx:items>
+ <gsx:ipm>5</gsx:ipm>
+ </entry>
+</feed>
+
+"""
+class ColCountTest(unittest.TestCase):
+
+ def setUp(self):
+ self.col_count = gdata.spreadsheet.ColCount()
+
+ def testToAndFromString(self):
+ self.col_count.text = '20'
+ self.assert_(self.col_count.text == '20')
+ new_col_count = gdata.spreadsheet.ColCountFromString(self.col_count.ToString())
+ self.assert_(self.col_count.text == new_col_count.text)
+
+
+class RowCountTest(unittest.TestCase):
+
+ def setUp(self):
+ self.row_count = gdata.spreadsheet.RowCount()
+
+ def testToAndFromString(self):
+ self.row_count.text = '100'
+ self.assert_(self.row_count.text == '100')
+ new_row_count = gdata.spreadsheet.RowCountFromString(self.row_count.ToString())
+ self.assert_(self.row_count.text == new_row_count.text)
+
+
+class CellTest(unittest.TestCase):
+
+ def setUp(self):
+ self.cell = gdata.spreadsheet.Cell()
+
+ def testToAndFromString(self):
+ self.cell.text = 'test cell'
+ self.assert_(self.cell.text == 'test cell')
+ self.cell.row = '1'
+ self.assert_(self.cell.row == '1')
+ self.cell.col = '2'
+ self.assert_(self.cell.col == '2')
+ self.cell.inputValue = 'test input value'
+ self.assert_(self.cell.inputValue == 'test input value')
+ self.cell.numericValue = 'test numeric value'
+ self.assert_(self.cell.numericValue == 'test numeric value')
+ new_cell = gdata.spreadsheet.CellFromString(self.cell.ToString())
+ self.assert_(self.cell.text == new_cell.text)
+ self.assert_(self.cell.row == new_cell.row)
+ self.assert_(self.cell.col == new_cell.col)
+ self.assert_(self.cell.inputValue == new_cell.inputValue)
+ self.assert_(self.cell.numericValue == new_cell.numericValue)
+
+
+class CustomTest(unittest.TestCase):
+
+ def setUp(self):
+ self.custom = gdata.spreadsheet.Custom()
+
+ def testToAndFromString(self):
+ self.custom.text = 'value'
+ self.custom.column = 'column_name'
+ self.assert_(self.custom.text == 'value')
+ self.assert_(self.custom.column == 'column_name')
+ new_custom = gdata.spreadsheet.CustomFromString(self.custom.ToString())
+ self.assert_(self.custom.text == new_custom.text)
+ self.assert_(self.custom.column == new_custom.column)
+
+
+class SpreadsheetsWorksheetTest(unittest.TestCase):
+
+ def setUp(self):
+ self.worksheet = gdata.spreadsheet.SpreadsheetsWorksheet()
+
+ def testToAndFromString(self):
+ self.worksheet.row_count = gdata.spreadsheet.RowCount(text='100')
+ self.assert_(self.worksheet.row_count.text == '100')
+ self.worksheet.col_count = gdata.spreadsheet.ColCount(text='20')
+ self.assert_(self.worksheet.col_count.text == '20')
+ new_worksheet = gdata.spreadsheet.SpreadsheetsWorksheetFromString(
+ self.worksheet.ToString())
+ self.assert_(self.worksheet.row_count.text == new_worksheet.row_count.text)
+ self.assert_(self.worksheet.col_count.text == new_worksheet.col_count.text)
+
+
+class SpreadsheetsCellTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.spreadsheet.SpreadsheetsCell()
+
+ def testToAndFromString(self):
+ self.entry.cell = gdata.spreadsheet.Cell(text='my cell', row='1', col='2',
+ inputValue='my input value', numericValue='my numeric value')
+ self.assert_(self.entry.cell.text == 'my cell')
+ self.assert_(self.entry.cell.row == '1')
+ self.assert_(self.entry.cell.col == '2')
+ self.assert_(self.entry.cell.inputValue == 'my input value')
+ self.assert_(self.entry.cell.numericValue == 'my numeric value')
+ new_cell = gdata.spreadsheet.SpreadsheetsCellFromString(self.entry.ToString())
+ self.assert_(self.entry.cell.text == new_cell.cell.text)
+ self.assert_(self.entry.cell.row == new_cell.cell.row)
+ self.assert_(self.entry.cell.col == new_cell.cell.col)
+ self.assert_(self.entry.cell.inputValue == new_cell.cell.inputValue)
+ self.assert_(self.entry.cell.numericValue == new_cell.cell.numericValue)
+
+
+class SpreadsheetsListTest(unittest.TestCase):
+
+ def setUp(self):
+ self.row = gdata.spreadsheet.SpreadsheetsList()
+
+ def testToAndFromString(self):
+ self.row.custom['column_1'] = gdata.spreadsheet.Custom(column='column_1',
+ text='my first column')
+ self.row.custom['column_2'] = gdata.spreadsheet.Custom(column='column_2',
+ text='my second column')
+ self.assert_(self.row.custom['column_1'].column == 'column_1')
+ self.assert_(self.row.custom['column_1'].text == 'my first column')
+ self.assert_(self.row.custom['column_2'].column == 'column_2')
+ self.assert_(self.row.custom['column_2'].text == 'my second column')
+ new_row = gdata.spreadsheet.SpreadsheetsListFromString(self.row.ToString())
+ self.assert_(self.row.custom['column_1'].column == new_row.custom['column_1'].column)
+ self.assert_(self.row.custom['column_1'].text == new_row.custom['column_1'].text)
+ self.assert_(self.row.custom['column_2'].column == new_row.custom['column_2'].column)
+ self.assert_(self.row.custom['column_2'].text == new_row.custom['column_2'].text)
+
+
+class SpreadsheetsSpreadsheetsFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ #self.item_feed = gdata.spreadsheet.SpreadsheetSpreadsheetsFeed()
+ self.feed = gdata.spreadsheet.SpreadsheetsSpreadsheetsFeedFromString(
+ SPREADSHEETS_FEED)
+
+ def testToAndFromString(self):
+ self.assert_(len(self.feed.entry) == 1)
+ for an_entry in self.feed.entry:
+ self.assert_(isinstance(an_entry, gdata.spreadsheet.SpreadsheetsSpreadsheet))
+ new_feed = gdata.spreadsheet.SpreadsheetsSpreadsheetsFeedFromString(
+ str(self.feed))
+ for an_entry in new_feed.entry:
+ self.assert_(isinstance(an_entry, gdata.spreadsheet.SpreadsheetsSpreadsheet))
+
+class SpreadsheetsWorksheetsFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ #self.item_feed = gdata.spreadsheet.SpreadsheetWorksheetsFeed()
+ self.feed = gdata.spreadsheet.SpreadsheetsWorksheetsFeedFromString(
+ WORKSHEETS_FEED)
+
+ def testToAndFromString(self):
+ self.assert_(len(self.feed.entry) == 1)
+ for an_entry in self.feed.entry:
+ self.assert_(isinstance(an_entry, gdata.spreadsheet.SpreadsheetsWorksheet))
+ new_feed = gdata.spreadsheet.SpreadsheetsWorksheetsFeedFromString(
+ str(self.feed))
+ for an_entry in new_feed.entry:
+ self.assert_(isinstance(an_entry, gdata.spreadsheet.SpreadsheetsWorksheet))
+
+class SpreadsheetsCellsFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ #self.item_feed = gdata.spreadsheet.SpreadsheetCellsFeed()
+ self.feed = gdata.spreadsheet.SpreadsheetsCellsFeedFromString(
+ CELLS_FEED)
+
+ def testToAndFromString(self):
+ self.assert_(len(self.feed.entry) == 2)
+ for an_entry in self.feed.entry:
+ self.assert_(isinstance(an_entry, gdata.spreadsheet.SpreadsheetsCell))
+ new_feed = gdata.spreadsheet.SpreadsheetsCellsFeedFromString(str(self.feed))
+ self.assert_(isinstance(new_feed.row_count,
+ gdata.spreadsheet.RowCount))
+ self.assert_(new_feed.row_count.text == '100')
+ self.assert_(isinstance(new_feed.col_count,
+ gdata.spreadsheet.ColCount))
+ self.assert_(new_feed.col_count.text == '20')
+ for an_entry in new_feed.entry:
+ self.assert_(isinstance(an_entry, gdata.spreadsheet.SpreadsheetsCell))
+
+class SpreadsheetsListFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ #self.item_feed = gdata.spreadsheet.SpreadsheetListFeed()
+ self.feed = gdata.spreadsheet.SpreadsheetsListFeedFromString(
+ LIST_FEED)
+
+ def testToAndFromString(self):
+ self.assert_(len(self.feed.entry) == 2)
+ for an_entry in self.feed.entry:
+ self.assert_(isinstance(an_entry, gdata.spreadsheet.SpreadsheetsList))
+ new_feed = gdata.spreadsheet.SpreadsheetsListFeedFromString(str(self.feed))
+ for an_entry in new_feed.entry:
+ self.assert_(isinstance(an_entry, gdata.spreadsheet.SpreadsheetsList))
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/spreadsheets/__init__.py b/tests/gdata_tests/spreadsheets/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/spreadsheets/__init__.py
diff --git a/tests/gdata_tests/spreadsheets/data_test.py b/tests/gdata_tests/spreadsheets/data_test.py
new file mode 100755
index 0000000..1e79a2d
--- /dev/null
+++ b/tests/gdata_tests/spreadsheets/data_test.py
@@ -0,0 +1,696 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import gdata.spreadsheets.data
+import gdata.test_config as conf
+import atom.core
+
+
+SPREADSHEET = """<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gd="http://schemas.google.com/g/2005"
+ gd:etag='"BxAUSQUJRCp7ImBq"'>
+ <id>http://spreadsheets.google.com/feeds/spreadsheets/private/full/key</id>
+ <updated>2006-11-17T18:24:18.231Z</updated>
+ <title type="text">Groceries R Us</title>
+ <content type="text">Groceries R Us</content>
+ <link rel="http://schemas.google.com/spreadsheets/2006#worksheetsfeed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/key/private/full"/>
+ <link rel="alternate" type="text/html"
+ href="http://spreadsheets.google.com/ccc?key=key"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/spreadsheets/private/full/key"/>
+ <author>
+ <name>Fitzwilliam Darcy</name>
+ <email>fitz@gmail.com</email>
+ </author>
+</entry>"""
+
+
+WORKSHEETS_FEED = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
+ xmlns:gs="http://schemas.google.com/spreadsheets/2006"
+ xmlns:gd="http://schemas.google.com/g/2005"
+ gd:etag='W/"D0cERnk-eip7ImA9WBBXGEg."'>
+ <id>http://spreadsheets.google.com/feeds/worksheets/key/private/full</id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <title type="text">Groceries R Us</title>
+ <link rel="alternate" type="text/html"
+ href="http://spreadsheets.google.com/ccc?key=key"/>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/key/private/full"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/key/private/full"/>
+ <link
+ rel="http://schemas.google.com/g/2005#post" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/key/private/full"/>
+ <author>
+ <name>Fitzwilliam Darcy</name>
+ <email>fitz@gmail.com</email>
+ </author>
+ <openSearch:totalResults>1</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>1</openSearch:itemsPerPage>
+ <entry gd:etag='"YDwqeyI."'>
+ <id>http://spreadsheets.google.com/feeds/worksheets/0/private/full/1</id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <title type="text">Sheet1</title>
+ <content type="text">Sheet1</content>
+ <link rel="http://schemas.google.com/spreadsheets/2006#listfeed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/0/1/private/full"/>
+ <link rel="http://schemas.google.com/spreadsheets/2006#cellsfeed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/0/1/private/full"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/0/private/full/1"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/.../0/.../1/version"/>
+ <gs:rowCount>100</gs:rowCount>
+ <gs:colCount>20</gs:colCount>
+ </entry>
+</feed>"""
+
+
+NEW_WORKSHEET = """<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gs="http://schemas.google.com/spreadsheets/2006">
+ <title>Expenses</title>
+ <gs:rowCount>50</gs:rowCount>
+ <gs:colCount>10</gs:colCount>
+</entry>"""
+
+
+EDIT_WORKSHEET = """<entry>
+ <id>
+ http://spreadsheets.google.com/feeds/worksheets/k/private/full/w
+ </id>
+ <updated>2007-07-30T18:51:30.666Z</updated>
+ <category scheme="http://schemas.google.com/spreadsheets/2006"
+ term="http://schemas.google.com/spreadsheets/2006#worksheet"/>
+ <title type="text">Income</title>
+ <content type="text">Expenses</content>
+ <link rel="http://schemas.google.com/spreadsheets/2006#listfeed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/k/w/private/full"/>
+ <link rel="http://schemas.google.com/spreadsheets/2006#cellsfeed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/k/w/private/full"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/worksheets/k/private/full/w"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/.../k/private/full/w/v"/>
+ <gs:rowCount>45</gs:rowCount>
+ <gs:colCount>15</gs:colCount>
+</entry>"""
+
+
+NEW_TABLE = """<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gs="http://schemas.google.com/spreadsheets/2006">
+ <title type='text'>Table 1</title>
+ <summary type='text'>This is a list of all who have registered to vote and
+ whether or not they qualify to vote.</summary>
+ <gs:worksheet name='Sheet1' />
+ <gs:header row='1' />
+ <gs:data numRows='0' startRow='2'>
+ <gs:column index='B' name='Birthday' />
+ <gs:column index='C' name='Age' />
+ <gs:column index='A' name='Name' />
+ <gs:column index='D' name='CanVote' />
+ </gs:data>
+</entry>"""
+
+
+TABLES_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
+ xmlns:gs="http://schemas.google.com/spreadsheets/2006"
+ xmlns:gd="http://schemas.google.com/g/2005"
+ gd:etag='W/"DEQHQn84fCt7ImA9WxJTGEU."'>
+ <id>
+ http://spreadsheets.google.com/feeds/key/tables</id>
+ <updated>2009-04-28T02:38:53.134Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/spreadsheets/2006#table' />
+ <title>Sample table and record feed</title>
+ <link rel='alternate' type='text/html'
+ href='http://spreadsheets.google.com/ccc?key=key' />
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/tables' />
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/tables' />
+ <link rel='self' type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/tables' />
+ <author>
+ <name>Liz</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <openSearch:totalResults>2</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry gd:etag='"HBcUVgtWASt7ImBq"'>
+ <id>
+ http://spreadsheets.google.com/feeds/key/tables/0</id>
+ <updated>2009-04-28T01:20:32.707Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">
+ 2009-04-28T01:20:32.707Z</app:edited>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/spreadsheets/2006#table' />
+ <title>Table 1</title>
+ <summary>This is a list of all who have registered to vote and
+ whether or not they qualify to vote.</summary>
+ <content type='application/atom+xml;type=feed'
+ src='http://spreadsheets.google.com/feeds/key/records/0' />
+ <link rel='self' type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/tables/0' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/tables/0' />
+ <gs:worksheet name='Sheet1' />
+ <gs:header row='1' />
+ <gs:data insertionMode='overwrite' numRows='2' startRow='2'>
+ <gs:column index='B' name='Birthday' />
+ <gs:column index='C' name='Age' />
+ <gs:column index='A' name='Name' />
+ <gs:column index='D' name='CanVote' />
+ </gs:data>
+ </entry>
+ <entry gd:etag='"HBcUVgdCGyt7ImBq"'>
+ <id>
+ http://spreadsheets.google.com/feeds/key/tables/1</id>
+ <updated>2009-04-28T01:20:38.313Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">
+ 2009-04-28T01:20:38.313Z</app:edited>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/spreadsheets/2006#table' />
+ <title>Table 2</title>
+ <summary>List of detailed information about each voter.</summary>
+ <content type='application/atom+xml;type=feed'
+ src='http://spreadsheets.google.com/feeds/key/records/1' />
+ <link rel='self' type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/tables/1' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/tables/1' />
+ <gs:worksheet name='Sheet1' />
+ <gs:header row='30' />
+ <gs:data insertionMode='overwrite' numRows='10' startRow='34'>
+ <gs:column index='C' name='Last' />
+ <gs:column index='B' name='First' />
+ <gs:column index='D' name='DOB' />
+ <gs:column index='E' name='Driver License?' />
+ </gs:data>
+ </entry>
+</feed>"""
+
+
+NEW_RECORD = """<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gs="http://schemas.google.com/spreadsheets/2006">
+ <title>Darcy</title>
+ <gs:field name='Birthday'>2/10/1785</gs:field>
+ <gs:field name='Age'>28</gs:field>
+ <gs:field name='Name'>Darcy</gs:field>
+ <gs:field name='CanVote'>No</gs:field>
+</entry>"""
+
+
+RECORDS_FEED = """<?xml version='1.0' encoding='utf-8'?>
+<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
+ xmlns:gs="http://schemas.google.com/spreadsheets/2006"
+ xmlns:gd="http://schemas.google.com/g/2005"
+ gd:etag='W/"DEQHQn84fCt7ImA9WxJTGEU."'>
+ <id>http://spreadsheets.google.com/feeds/key/records/0</id>
+ <updated>2009-04-28T02:38:53.134Z</updated>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/spreadsheets/2006#record' />
+ <title>Table 1</title>
+ <link rel='alternate' type='text/html'
+ href='http://spreadsheets.google.com/pub?key=key' />
+ <link rel='http://schemas.google.com/g/2005#feed'
+ type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/records/0' />
+ <link rel='http://schemas.google.com/g/2005#post'
+ type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/records/0' />
+ <link rel='self' type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/records/0' />
+ <author>
+ <name>Liz</name>
+ <email>liz@gmail.com</email>
+ </author>
+ <openSearch:totalResults>2</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <entry gd:etag='"UB8DTlJAKSt7ImA-WkUT"'>
+ <id>
+ http://spreadsheets.google.com/feeds/key/records/0/cn6ca</id>
+ <updated>2009-04-28T02:38:53.134Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">
+ 2009-04-28T02:38:53.134Z</app:edited>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/spreadsheets/2006#record' />
+ <title>Darcy</title>
+ <content>Birthday: 2/10/1785, Age: 28, Name: Darcy,
+ CanVote: No</content>
+ <link rel='self' type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/records/0/cn6ca' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/records/0/cn6ca' />
+ <gs:field index='B' name='Birthday'>2/10/1785</gs:field>
+ <gs:field index='C' name='Age'>28</gs:field>
+ <gs:field index='A' name='Name'>Darcy</gs:field>
+ <gs:field index='D' name='CanVote'>No</gs:field>
+ </entry>
+ <entry gd:etag='"UVBFUEcNRCt7ImA9DU8."'>
+ <id>
+ http://spreadsheets.google.com/feeds/key/records/0/cokwr</id>
+ <updated>2009-04-28T02:38:53.134Z</updated>
+ <app:edited xmlns:app="http://www.w3.org/2007/app">
+ 2009-04-28T02:38:53.134Z</app:edited>
+ <category scheme='http://schemas.google.com/g/2005#kind'
+ term='http://schemas.google.com/spreadsheets/2006#record' />
+ <title>Jane</title>
+ <content>Birthday: 1/6/1791, Age: 22, Name: Jane,
+ CanVote: Yes</content>
+ <link rel='self' type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/records/0/cokwr' />
+ <link rel='edit' type='application/atom+xml'
+ href='http://spreadsheets.google.com/feeds/key/records/0/cokwr' />
+ <gs:field index='B' name='Birthday'>1/6/1791</gs:field>
+ <gs:field index='C' name='Age'>22</gs:field>
+ <gs:field index='A' name='Name'>Jane</gs:field>
+ <gs:field index='D' name='CanVote'>Yes</gs:field>
+ </entry>
+</feed>"""
+
+
+LIST_FEED = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
+ xmlns:gsx="http://schemas.google.com/spreadsheets/2006/extended"
+ xmlns:gd="http://schemas.google.com/g/2005"
+ gd:etag='W/"D0cERnk-eip7ImA9WBBXGEg."'>
+ <id>
+ http://spreadsheets.google.com/feeds/list/key/worksheetId/private/full
+ </id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <title type="text">Sheet1</title>
+ <link rel="alternate" type="text/html"
+ href="http://spreadsheets.google.com/ccc?key=key"/>
+ <link rel="http://schemas.google.com/g/2005#feed"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/k/w/private/full"/>
+ <link rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/k/w/private/full"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/k/w/private/full"/>
+ <author>
+ <name>Fitzwilliam Darcy</name>
+ <email>fitz@gmail.com</email>
+ </author>
+ <openSearch:totalResults>8</openSearch:totalResults>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>8</openSearch:itemsPerPage>
+ <entry gd:etag='"S0wCTlpIIip7ImA0X0QI"'>
+ <id>http://spreadsheets.google.com/feeds/list/k/w/private/full/r</id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <category scheme="http://schemas.google.com/spreadsheets/2006"
+ term="http://schemas.google.com/spreadsheets/2006#list"/>
+ <title type="text">Bingley</title>
+ <content type="text">Hours: 10, Items: 2, IPM: 0.0033</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/k/w/private/full/r"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/k/w/private/full/r/v"/>
+ <gsx:name>Bingley</gsx:name>
+ <gsx:hours>10</gsx:hours>
+ <gsx:items>2</gsx:items>
+ <gsx:ipm>0.0033</gsx:ipm>
+ </entry>
+ <entry gd:etag='"AxQDSXxjfyp7ImA0ChJVSBI."'>
+ <id>
+ http://spreadsheets.google.com/feeds/list/k/w/private/full/rowId
+ </id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <category scheme="http://schemas.google.com/spreadsheets/2006"
+ term="http://schemas.google.com/spreadsheets/2006#list"/>
+ <title type="text">Charlotte</title>
+ <content type="text">Hours: 60, Items: 18000, IPM: 5</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/k/w/private/full/r"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/k/w/private/full/r/v"/>
+ <gsx:name>Charlotte</gsx:name>
+ <gsx:hours>60</gsx:hours>
+ <gsx:items>18000</gsx:items>
+ <gsx:ipm>5</gsx:ipm>
+ </entry>
+</feed>"""
+
+
+NEW_ROW = """<entry xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gsx="http://schemas.google.com/spreadsheets/2006/extended">
+ <gsx:hours>1</gsx:hours>
+ <gsx:ipm>1</gsx:ipm>
+ <gsx:items>60</gsx:items>
+ <gsx:name>Elizabeth Bennet</gsx:name>
+</entry>"""
+
+
+UPDATED_ROW = """<entry gd:etag='"S0wCTlpIIip7ImA0X0QI"'
+ xmlns="http://www.w3.org/2005/Atom"
+ xmlns:gd="http://schemas.google.com/g/2005"
+ xmlns:gsx="http://schemas.google.com/spreadsheets/2006/extended">
+ <id>http://spreadsheets.google.com/feeds/list/k/w/private/full/rowId</id>
+ <updated>2006-11-17T18:23:45.173Z</updated>
+ <category scheme="http://schemas.google.com/spreadsheets/2006"
+ term="http://schemas.google.com/spreadsheets/2006#list"/>
+ <title type="text">Bingley</title>
+ <content type="text">Hours: 10, Items: 2, IPM: 0.0033</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/k/w/private/full/r"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/list/k/w/private/full/r/v"/>
+ <gsx:name>Bingley</gsx:name>
+ <gsx:hours>20</gsx:hours>
+ <gsx:items>4</gsx:items>
+ <gsx:ipm>0.0033</gsx:ipm>
+</entry>"""
+
+
+CELLS_FEED = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
+ xmlns:gs="http://schemas.google.com/spreadsheets/2006"
+ xmlns:gd="http://schemas.google.com/g/2005"
+ gd:etag='W/"D0cERnk-eip7ImA9WBBXGEg."'>
+ <id>
+ http://spreadsheets.google.com/feeds/cells/key/worksheetId/private/full
+ </id>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <title type="text">Sheet1</title>
+ <link rel="alternate" type="text/html"
+ href="http://spreadsheets.google.com/ccc?key=key"/>
+ <link rel="http://schemas.google.com/g/2005#feed" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/k/w/private/full"/>
+ <link rel="http://schemas.google.com/g/2005#post"
+ type="application/atom+xml"
+ <link rel="http://schemas.google.com/g/2005#batch"
+ type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/k/w/private/full/batch"/>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/k/w/private/full"/>
+ <author>
+ <name>Fitzwilliam Darcy</name>
+ <email>fitz@gmail.com</email>
+ </author>
+ <openSearch:startIndex>1</openSearch:startIndex>
+ <openSearch:itemsPerPage>36</openSearch:itemsPerPage>
+ <gs:rowCount>100</gs:rowCount>
+ <gs:colCount>20</gs:colCount>
+ <entry gd:etag='"ImA9D1APFyp7"'>
+ <id>
+ http://spreadsheets.google.com/feeds/cells/k/w/private/full/R1C1
+ </id>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <category scheme="http://schemas.google.com/spreadsheets/2006"
+ term="http://schemas.google.com/spreadsheets/2006#cell"/>
+ <title type="text">A1</title>
+ <content type="text">Name</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/k/w/pr/full/R1C1"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/./cells/k/w/pr/full/R1C1/bgvjf"/>
+ <gs:cell row="1" col="1" inputValue="Name">Name</gs:cell>
+ </entry>
+ <entry gd:etag='"YD0PS1YXByp7Ig.."'>
+ <id>
+ http://spreadsheets.google.com/feeds/cells/k/w/private/full/R1C2
+ </id>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <category scheme="http://schemas.google.com/spreadsheets/2006"
+ term="http://schemas.google.com/spreadsheets/2006#cell"/>
+ <title type="text">B1</title>
+ <content type="text">Hours</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/k/w/pr/full/R1C2"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/./cells/k/w/pr/full/R1C2/1pn567"/>
+ <gs:cell row="1" col="2" inputValue="Hours">Hours</gs:cell>
+ </entry>
+ <entry gd:etag='"ImB5CBYSRCp7"'>
+ <id>
+ http://spreadsheets.google.com/feeds/cells/k/w/private/full/R9C4
+ </id>
+ <updated>2006-11-17T18:27:32.543Z</updated>
+ <category scheme="http://schemas.google.com/spreadsheets/2006"
+ term="http://schemas.google.com/spreadsheets/2006#cell"/>
+ <title type="text">D9</title>
+ <content type="text">5</content>
+ <link rel="self" type="application/atom+xml"
+ href="http://spreadsheets.google.com/feeds/cells/k/w/pr/full/R9C4"/>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets.google.com/./cells/k/w/pr/full/R9C4/srevc"/>
+ <gs:cell row="9" col="4"
+ inputValue="=FLOOR(R[0]C[-1]/(R[0]C[-2]*60),.0001)"
+ numericValue="5.0">5</gs:cell>
+ </entry>
+</feed>"""
+
+
+BATCH_CELLS = """<feed xmlns="http://www.w3.org/2005/Atom"
+ xmlns:batch="http://schemas.google.com/gdata/batch"
+ xmlns:gs="http://schemas.google.com/spreadsheets/2006">
+ <id>
+ http://spreadsheets.google.com/feeds/cells/key/worksheetId/private/full
+ </id>
+ <entry>
+ <batch:id">A1</batch:id">
+ <batch:operation type="update"/>
+ <id>
+ http://spreadsheets.google.com/feeds/cells/k/w/private/full/cellId
+ </id>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets/google.com/./cells/k/w/pr/full/R2C4/v"/>
+ <gs:cell row="2" col="4" inputValue="newData"/>
+ </entry>
+ <entry>
+ <batch:id">A2</batch:id">
+ <batch:operation type="update"/>
+ <title type="text">A2</title>
+ <id>
+ http://spreadsheets.google.com/feeds/cells/k/w/private/full/cellId
+ </id>
+ <link rel="edit" type="application/atom+xml"
+ href="http://spreadsheets/google.com/feeds/cells/k/w/pr/full/R2C5/v"/>
+ <gs:cell row="2" col="5" inputValue="moreInfo"/>
+ </entry>
+</feed>"""
+
+
+class SpreadsheetEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.spreadsheet = atom.core.parse(
+ SPREADSHEET, gdata.spreadsheets.data.Spreadsheet)
+
+ def test_check_parsing(self):
+ self.assertEqual(self.spreadsheet.etag, '"BxAUSQUJRCp7ImBq"')
+ self.assertEqual(self.spreadsheet.id.text,
+ 'http://spreadsheets.google.com/feeds/spreadsheets'
+ '/private/full/key')
+ self.assertEqual(self.spreadsheet.updated.text,
+ '2006-11-17T18:24:18.231Z')
+ self.assertEqual(self.spreadsheet.find_worksheets_feed(),
+ 'http://spreadsheets.google.com/feeds/worksheets'
+ '/key/private/full')
+ self.assertEqual(self.spreadsheet.find_self_link(),
+ 'http://spreadsheets.google.com/feeds/spreadsheets'
+ '/private/full/key')
+
+ def test_get_spreadsheet_key(self):
+ self.assertEqual(self.spreadsheet.get_spreadsheet_key(), 'key')
+ # Change the value of the self link.
+ self.spreadsheet.id.text = '42'
+ self.assertEqual(self.spreadsheet.GetSpreadsheetKey(), '42')
+
+
+class WorksheetEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.worksheets = atom.core.parse(
+ WORKSHEETS_FEED, gdata.spreadsheets.data.WorksheetsFeed)
+
+ def test_check_parsing(self):
+ self.assertEqual(len(self.worksheets.entry), 1)
+ self.assertEqual(self.worksheets.entry[0].get_id(),
+ 'http://spreadsheets.google.com/feeds/worksheets/0/private/full/1')
+
+ def test_get_worksheet_id(self):
+ self.assertEqual(self.worksheets.entry[0].get_worksheet_id(), '1')
+ self.worksheets.entry[0].id.text = '////spam'
+ self.assertEqual(self.worksheets.entry[0].GetWorksheetId(), 'spam')
+
+
+
+class ListEntryTest(unittest.TestCase):
+
+ def test_get_and_set_column_value(self):
+ row = atom.core.parse(NEW_ROW, gdata.spreadsheets.data.ListEntry)
+ row.set_value('hours', '3')
+ row.set_value('name', 'Lizzy')
+ self.assertEqual(row.get_value('hours'), '3')
+ self.assertEqual(row.get_value('ipm'), '1')
+ self.assertEqual(row.get_value('items'), '60')
+ self.assertEqual(row.get_value('name'), 'Lizzy')
+ self.assertEqual(row.get_value('x'), None)
+ row.set_value('x', 'Test')
+ self.assertEqual(row.get_value('x'), 'Test')
+ row_xml = str(row)
+ self.assert_(row_xml.find(':x') > -1)
+ self.assert_(row_xml.find('>Test</') > -1)
+ self.assert_(row_xml.find(':hours') > -1)
+ self.assert_(row_xml.find('>3</') > -1)
+ self.assert_(row_xml.find(':ipm') > -1)
+ self.assert_(row_xml.find('>1</') > -1)
+ self.assert_(row_xml.find(':items') > -1)
+ self.assert_(row_xml.find('>60</') > -1)
+ self.assert_(row_xml.find(':name') > -1)
+ self.assert_(row_xml.find('>Lizzy</') > -1)
+ self.assertEqual(row_xml.find(':zzz'), -1)
+ self.assertEqual(row_xml.find('>foo</'), -1)
+
+ def test_check_parsing(self):
+ row = atom.core.parse(NEW_ROW, gdata.spreadsheets.data.ListEntry)
+ self.assertEqual(row.get_value('hours'), '1')
+ self.assertEqual(row.get_value('ipm'), '1')
+ self.assertEqual(row.get_value('items'), '60')
+ self.assertEqual(row.get_value('name'), 'Elizabeth Bennet')
+ self.assertEqual(row.get_value('none'), None)
+
+ row = atom.core.parse(UPDATED_ROW, gdata.spreadsheets.data.ListEntry)
+ self.assertEqual(row.get_value('hours'), '20')
+ self.assertEqual(row.get_value('ipm'), '0.0033')
+ self.assertEqual(row.get_value('items'), '4')
+ self.assertEqual(row.get_value('name'), 'Bingley')
+ self.assertEqual(row.get_value('x'), None)
+ self.assertEqual(
+ row.id.text, 'http://spreadsheets.google.com/feeds/list'
+ '/k/w/private/full/rowId')
+ self.assertEqual(row.updated.text, '2006-11-17T18:23:45.173Z')
+ self.assertEqual(row.content.text, 'Hours: 10, Items: 2, IPM: 0.0033')
+
+
+class RecordEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.records = atom.core.parse(
+ RECORDS_FEED, gdata.spreadsheets.data.RecordsFeed)
+
+ def test_get_by_index(self):
+ self.assertEqual(self.records.entry[0].field[0].index, 'B')
+ self.assertEqual(self.records.entry[0].field[0].name, 'Birthday')
+ self.assertEqual(self.records.entry[0].field[0].text, '2/10/1785')
+ self.assertEqual(self.records.entry[0].value_for_index('B'), '2/10/1785')
+ self.assertRaises(gdata.spreadsheets.data.FieldMissing,
+ self.records.entry[0].ValueForIndex, 'E')
+ self.assertEqual(self.records.entry[1].value_for_index('D'), 'Yes')
+
+ def test_get_by_name(self):
+ self.assertEqual(self.records.entry[0].ValueForName('Birthday'),
+ '2/10/1785')
+ self.assertRaises(gdata.spreadsheets.data.FieldMissing,
+ self.records.entry[0].value_for_name, 'Foo')
+ self.assertEqual(self.records.entry[1].value_for_name('Age'), '22')
+
+
+class BatchRequestTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.spreadsheets.data.build_batch_cells_update('skey', 'wid')
+
+ def test_builder(self):
+ self.assertEqual(len(self.feed.link), 1)
+ self.assertEqual(self.feed.link[0].rel, 'edit')
+ self.assertEqual(self.feed.link[0].href,
+ 'https://spreadsheets.google.com/feeds/cells/skey/wid/'
+ 'private/full/batch')
+ self.assertEqual(self.feed.id.text,
+ 'https://spreadsheets.google.com/feeds/cells/skey/wid/'
+ 'private/full')
+ self.assertEqual(len(self.feed.entry), 0)
+
+ def test_set_cell(self):
+ self.feed.add_set_cell(1, 2, 'value')
+ self.assertEqual(len(self.feed.entry), 1)
+ self.assertEqual(self.feed.entry[0].id.text,
+ 'https://spreadsheets.google.com/feeds/cells/skey/wid/private/'
+ 'full/R1C2')
+ self.assertEqual(self.feed.entry[0].cell.row, '1')
+ self.assertEqual(self.feed.entry[0].cell.col, '2')
+ self.assertEqual(self.feed.entry[0].cell.input_value, 'value')
+ self.assertEqual(self.feed.entry[0].batch_operation.type, 'update')
+ self.assertEqual(self.feed.entry[0].batch_id.text, '0')
+ self.feed.add_set_cell(3, 1, 'spam')
+ self.assertEqual(len(self.feed.entry), 2)
+ self.assertEqual(self.feed.entry[1].id.text,
+ 'https://spreadsheets.google.com/feeds/cells/skey/wid/private/'
+ 'full/R3C1')
+ self.assertEqual(self.feed.entry[1].cell.row, '3')
+ self.assertEqual(self.feed.entry[1].cell.col, '1')
+ self.assertEqual(self.feed.entry[1].cell.input_value, 'spam')
+ self.assertEqual(self.feed.entry[1].batch_operation.type, 'update')
+ self.assertEqual(self.feed.entry[1].batch_id.text, '1')
+
+
+class DataClassSanityTest(unittest.TestCase):
+
+ def test_basic_element_structure(self):
+ conf.check_data_classes(self, [
+ gdata.spreadsheets.data.Cell, gdata.spreadsheets.data.ColCount,
+ gdata.spreadsheets.data.Field, gdata.spreadsheets.data.Column,
+ gdata.spreadsheets.data.Data, gdata.spreadsheets.data.Header,
+ gdata.spreadsheets.data.RowCount, gdata.spreadsheets.data.Worksheet,
+ gdata.spreadsheets.data.Spreadsheet,
+ gdata.spreadsheets.data.SpreadsheetsFeed,
+ gdata.spreadsheets.data.WorksheetEntry,
+ gdata.spreadsheets.data.WorksheetsFeed,
+ gdata.spreadsheets.data.Table,
+ gdata.spreadsheets.data.TablesFeed,
+ gdata.spreadsheets.data.Record,
+ gdata.spreadsheets.data.RecordsFeed,
+ gdata.spreadsheets.data.ListRow,
+ gdata.spreadsheets.data.ListEntry,
+ gdata.spreadsheets.data.ListsFeed,
+ gdata.spreadsheets.data.CellEntry,
+ gdata.spreadsheets.data.CellsFeed])
+
+
+def suite():
+ return conf.build_suite([SpreadsheetEntryTest, DataClassSanityTest,
+ ListEntryTest, RecordEntryTest])
+
+
+if __name__ == '__main__':
+ unittest.main()
+
+
diff --git a/tests/gdata_tests/spreadsheets/live_client_test.py b/tests/gdata_tests/spreadsheets/live_client_test.py
new file mode 100755
index 0000000..f470e1e
--- /dev/null
+++ b/tests/gdata_tests/spreadsheets/live_client_test.py
@@ -0,0 +1,259 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 'j.s@google.com (Jeff Scudder)'
+
+
+import unittest
+import gdata.spreadsheets.client
+import gdata.gauth
+import gdata.client
+import atom.http_core
+import atom.mock_http_core
+import atom.core
+import gdata.data
+import gdata.test_config as conf
+
+
+conf.options.register_option(conf.SPREADSHEET_ID_OPTION)
+
+
+class SpreadsheetsClientTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = None
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.spreadsheets.client.SpreadsheetsClient()
+ conf.configure_client(self.client, 'SpreadsheetsClientTest', 'wise')
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def test_create_update_delete_worksheet(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_create_update_delete_worksheet')
+
+ spreadsheet_id = conf.options.get_value('spreadsheetid')
+ original_worksheets = self.client.get_worksheets(spreadsheet_id)
+ self.assert_(isinstance(original_worksheets,
+ gdata.spreadsheets.data.WorksheetsFeed))
+ worksheet_count = int(original_worksheets.total_results.text)
+
+ # Add a new worksheet to the spreadsheet.
+ created = self.client.add_worksheet(
+ spreadsheet_id, 'a test worksheet', 4, 8)
+ self.assert_(isinstance(created,
+ gdata.spreadsheets.data.WorksheetEntry))
+ self.assertEqual(created.title.text, 'a test worksheet')
+ self.assertEqual(created.row_count.text, '4')
+ self.assertEqual(created.col_count.text, '8')
+
+ # There should now be one more worksheet in this spreadsheet.
+ updated_worksheets = self.client.get_worksheets(spreadsheet_id)
+ new_worksheet_count = int(updated_worksheets.total_results.text)
+ self.assertEqual(worksheet_count + 1, new_worksheet_count)
+
+ # Delete our test worksheet.
+ self.client.delete(created)
+ # We should be back to the original number of worksheets.
+ updated_worksheets = self.client.get_worksheets(spreadsheet_id)
+ new_worksheet_count = int(updated_worksheets.total_results.text)
+ self.assertEqual(worksheet_count, new_worksheet_count)
+
+ def test_create_update_delete_table_and_records(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(
+ self.client, 'test_create_update_delete_table_and_records')
+
+ spreadsheet_id = conf.options.get_value('spreadsheetid')
+ tables = self.client.get_tables(spreadsheet_id)
+
+ test_worksheet = self.client.add_worksheet(
+ spreadsheet_id, 'worksheet x', rows=30, cols=3)
+
+ self.assert_(isinstance(tables, gdata.spreadsheets.data.TablesFeed))
+ initial_count = tables.total_results.text
+
+ created_table = self.client.add_table(
+ spreadsheet_id, 'Test Table', 'This table is for testing',
+ 'worksheet x', header_row=5, num_rows=10, start_row=8,
+ insertion_mode=None,
+ column_headers={'B': 'Food', 'C': 'Drink', 'A': 'Price'})
+
+ # Re-get the list of tables and make sure there are more now.
+ updated_tables = self.client.get_tables(spreadsheet_id)
+ self.assertEqual(int(initial_count) + 1,
+ int(updated_tables.total_results.text))
+
+ # Get the records in our new table to make sure it has the correct
+ # number of records.
+ table_num = int(created_table.get_table_id())
+ starting_records = self.client.get_records(spreadsheet_id, table_num)
+ self.assertEqual(starting_records.total_results.text, '10')
+ self.assert_(starting_records.entry[0].field[0].text is None)
+ self.assert_(starting_records.entry[0].field[1].text is None)
+ self.assert_(starting_records.entry[1].field[0].text is None)
+ self.assert_(starting_records.entry[1].field[1].text is None)
+
+ record1 = self.client.add_record(
+ spreadsheet_id, table_num,
+ {'Food': 'Cheese', 'Drink': 'Soda', 'Price': '2.99'}, 'icky')
+ self.client.add_record(spreadsheet_id, table_num,
+ {'Food': 'Eggs', 'Drink': 'Milk'})
+ self.client.add_record(spreadsheet_id, table_num,
+ {'Food': 'Spinach', 'Drink': 'Water'})
+
+ updated_records = self.client.get_records(spreadsheet_id, table_num)
+ self.assertEqual(updated_records.entry[10].value_for_name('Price'), '2.99')
+ self.assertEqual(updated_records.entry[10].value_for_index('A'), '2.99')
+ self.assertEqual(updated_records.entry[10].value_for_name('Drink'),
+ 'Soda')
+ self.assert_(updated_records.entry[11].value_for_name('Price') is None)
+ self.assertEqual(updated_records.entry[11].value_for_name('Drink'),
+ 'Milk')
+ self.assertEqual(updated_records.entry[12].value_for_name('Drink'),
+ 'Water')
+ self.assert_(updated_records.entry[1].value_for_index('A') is None)
+ self.assert_(updated_records.entry[2].value_for_index('B') is None)
+ self.assert_(updated_records.entry[3].value_for_index('C') is None)
+
+ # Cleanup the table.
+ self.client.delete(created_table)
+ # Delete the test worksheet in which the table was placed.
+ self.client.delete(test_worksheet)
+
+ # Make sure we are back to the original count.
+ updated_tables = self.client.get_tables(spreadsheet_id)
+ self.assertEqual(int(initial_count),
+ int(updated_tables.total_results.text))
+
+ def test_get_and_update_cell(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_get_and_update_cell')
+
+ spreadsheet_id = conf.options.get_value('spreadsheetid')
+
+ test_worksheet = self.client.add_worksheet(
+ spreadsheet_id, 'worksheet x', rows=30, cols=3)
+
+ # Get a cell and set its value.
+ cell_entry = self.client.get_cell(
+ spreadsheet_id, test_worksheet.get_worksheet_id(), 1, 1)
+ cell_entry.cell.input_value = 'a test'
+ result = self.client.update(cell_entry)
+ self.assertEquals(cell_entry.cell.input_value, result.cell.input_value)
+
+ # Verify that the value was set.
+ cells = self.client.get_cells(
+ spreadsheet_id, test_worksheet.get_worksheet_id())
+ self.assertEquals(len(cells.entry), 1)
+ self.assertEquals(cells.entry[0].cell.input_value, 'a test')
+
+ # Delete the test worksheet.
+ self.client.delete(test_worksheet, force=True)
+
+ def set_cell(self, spreadsheet_id, worksheet_id, row, column, value):
+ cell_entry = self.client.get_cell(
+ spreadsheet_id, worksheet_id, row, column)
+ self.assert_(cell_entry is not None)
+ cell_entry.cell.input_value = value
+ self.assert_(self.client.update(cell_entry) is not None)
+
+ def test_batch_set_cells(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_get_and_update_cell')
+
+ spreadsheet_id = conf.options.get_value('spreadsheetid')
+
+ test_worksheet = self.client.add_worksheet(
+ spreadsheet_id, 'worksheet x', rows=30, cols=3)
+
+ # Set a couple of cells in a batch request.
+ feed = gdata.spreadsheets.data.build_batch_cells_update(
+ spreadsheet_id, test_worksheet.get_worksheet_id())
+ feed.add_set_cell(1, 1, '5')
+ feed.add_set_cell(1, 2, '=A1+2')
+ result = self.client.batch(feed, force=True)
+ self.assertEqual(result.entry[0].cell.text, '5')
+ self.assertEqual(result.entry[1].cell.text, '7')
+
+ # Delete the test worksheet.
+ self.client.delete(test_worksheet, force=True)
+
+ def test_crud_on_list_feed(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_crud_on_list_feed')
+
+ spreadsheet_id = conf.options.get_value('spreadsheetid')
+
+ test_worksheet = self.client.add_worksheet(
+ spreadsheet_id, 'worksheet x', rows=30, cols=3)
+ worksheet_id = test_worksheet.get_worksheet_id()
+
+ # Create the first column to provide row headings.
+ self.set_cell(spreadsheet_id, worksheet_id, 1, 1, 'cola')
+ self.set_cell(spreadsheet_id, worksheet_id, 1, 2, 'colb')
+ self.set_cell(spreadsheet_id, worksheet_id, 1, 3, 'colc')
+
+ # Add a row to the spreadsheet.
+ entry = gdata.spreadsheets.data.ListEntry()
+ entry.from_dict({'cola': 'alpha', 'colb': 'beta', 'colc': 'gamma'})
+ added = self.client.add_list_entry(entry, spreadsheet_id, worksheet_id)
+ self.assert_(isinstance(added, gdata.spreadsheets.data.ListEntry))
+ self.assertEquals(added.get_value('cola'), 'alpha')
+
+ # Update the row.
+ added.from_dict({'cola': '1', 'colb': '2', 'colc': '3'})
+ updated = self.client.update(added)
+ self.assert_(isinstance(updated, gdata.spreadsheets.data.ListEntry))
+ self.assertEquals(updated.get_value('cola'), '1')
+
+ # Check the number of rows.
+ rows = self.client.get_list_feed(spreadsheet_id, worksheet_id)
+ self.assertEquals(len(rows.entry), 1)
+
+ # Remove the row.
+ self.client.delete(updated)
+
+ # Check that it was removed.
+ rows = self.client.get_list_feed(spreadsheet_id, worksheet_id)
+ self.assertEquals(len(rows.entry), 0)
+
+ # Delete the test worksheet.
+ self.client.delete(test_worksheet, force=True)
+
+
+def suite():
+ return conf.build_suite([SpreadsheetsClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/webmastertools_test.py b/tests/gdata_tests/webmastertools_test.py
new file mode 100644
index 0000000..a09eb81
--- /dev/null
+++ b/tests/gdata_tests/webmastertools_test.py
@@ -0,0 +1,510 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Yu-Jie Lin
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'livibetter (Yu-Jie Lin)'
+
+
+import unittest
+try:
+ from xml.etree import ElementTree
+except ImportError:
+ from elementtree import ElementTree
+import gdata
+from gdata import test_data
+import gdata.webmastertools as webmastertools
+
+
+class IndexedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.indexed = webmastertools.Indexed()
+
+ def testToAndFromString(self):
+ self.indexed.text = 'true'
+ self.assert_(self.indexed.text == 'true')
+ new_indexed = webmastertools.IndexedFromString(self.indexed.ToString())
+ self.assert_(self.indexed.text == new_indexed.text)
+
+
+class CrawledTest(unittest.TestCase):
+
+ def setUp(self):
+ self.crawled = webmastertools.Crawled()
+
+ def testToAndFromString(self):
+ self.crawled.text = 'true'
+ self.assert_(self.crawled.text == 'true')
+ new_crawled = webmastertools.CrawledFromString(self.crawled.ToString())
+ self.assert_(self.crawled.text == new_crawled.text)
+
+
+class GeoLocationTest(unittest.TestCase):
+
+ def setUp(self):
+ self.geolocation = webmastertools.GeoLocation()
+
+ def testToAndFromString(self):
+ self.geolocation.text = 'US'
+ self.assert_(self.geolocation.text == 'US')
+ new_geolocation = webmastertools.GeoLocationFromString(
+ self.geolocation.ToString())
+ self.assert_(self.geolocation.text == new_geolocation.text)
+
+
+class PreferredDomainTest(unittest.TestCase):
+
+ def setUp(self):
+ self.preferred_domain = webmastertools.PreferredDomain()
+
+ def testToAndFromString(self):
+ self.preferred_domain.text = 'none'
+ self.assert_(self.preferred_domain.text == 'none')
+ new_preferred_domain = webmastertools.PreferredDomainFromString(
+ self.preferred_domain.ToString())
+ self.assert_(self.preferred_domain.text == new_preferred_domain.text)
+
+
+class CrawlRateTest(unittest.TestCase):
+
+ def setUp(self):
+ self.crawl_rate = webmastertools.CrawlRate()
+
+ def testToAndFromString(self):
+ self.crawl_rate.text = 'normal'
+ self.assert_(self.crawl_rate.text == 'normal')
+ new_crawl_rate = webmastertools.CrawlRateFromString(
+ self.crawl_rate.ToString())
+ self.assert_(self.crawl_rate.text == new_crawl_rate.text)
+
+
+class EnhancedImageSearchTest(unittest.TestCase):
+
+ def setUp(self):
+ self.enhanced_image_search = webmastertools.EnhancedImageSearch()
+
+ def testToAndFromString(self):
+ self.enhanced_image_search.text = 'true'
+ self.assert_(self.enhanced_image_search.text == 'true')
+ new_enhanced_image_search = webmastertools.EnhancedImageSearchFromString(
+ self.enhanced_image_search.ToString())
+ self.assert_(self.enhanced_image_search.text ==
+ new_enhanced_image_search.text)
+
+
+class VerifiedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.verified = webmastertools.Verified()
+
+ def testToAndFromString(self):
+ self.verified.text = 'true'
+ self.assert_(self.verified.text == 'true')
+ new_verified = webmastertools.VerifiedFromString(self.verified.ToString())
+ self.assert_(self.verified.text == new_verified.text)
+
+
+class VerificationMethodMetaTest(unittest.TestCase):
+
+ def setUp(self):
+ self.meta = webmastertools.VerificationMethodMeta()
+
+ def testToAndFromString(self):
+ self.meta.name = 'verify-vf1'
+ self.meta.content = 'a2Ai'
+ self.assert_(self.meta.name == 'verify-vf1')
+ self.assert_(self.meta.content == 'a2Ai')
+ new_meta = webmastertools.VerificationMethodMetaFromString(
+ self.meta.ToString())
+ self.assert_(self.meta.name == new_meta.name)
+ self.assert_(self.meta.content == new_meta.content)
+
+
+class VerificationMethodTest(unittest.TestCase):
+
+ def setUp(self):
+ pass
+
+ def testMetaTagToAndFromString(self):
+ self.method = webmastertools.VerificationMethod()
+ self.method.type = 'metatag'
+ self.method.in_use = 'false'
+ self.assert_(self.method.type == 'metatag')
+ self.assert_(self.method.in_use == 'false')
+ self.method.meta = webmastertools.VerificationMethodMeta(name='verify-vf1',
+ content='a2Ai')
+ self.assert_(self.method.meta.name == 'verify-vf1')
+ self.assert_(self.method.meta.content == 'a2Ai')
+ new_method = webmastertools.VerificationMethodFromString(
+ self.method.ToString())
+ self.assert_(self.method.type == new_method.type)
+ self.assert_(self.method.in_use == new_method.in_use)
+ self.assert_(self.method.meta.name == new_method.meta.name)
+ self.assert_(self.method.meta.content == new_method.meta.content)
+
+ method = webmastertools.VerificationMethod(type='xyz')
+ self.assertEqual(method.type, 'xyz')
+ method = webmastertools.VerificationMethod()
+ self.assert_(method.type is None)
+
+ def testHtmlPageToAndFromString(self):
+ self.method = webmastertools.VerificationMethod()
+ self.method.type = 'htmlpage'
+ self.method.in_use = 'false'
+ self.method.text = '456456-google.html'
+ self.assert_(self.method.type == 'htmlpage')
+ self.assert_(self.method.in_use == 'false')
+ self.assert_(self.method.text == '456456-google.html')
+ self.assert_(self.method.meta is None)
+ new_method = webmastertools.VerificationMethodFromString(
+ self.method.ToString())
+ self.assert_(self.method.type == new_method.type)
+ self.assert_(self.method.in_use == new_method.in_use)
+ self.assert_(self.method.text == new_method.text)
+ self.assert_(self.method.meta is None)
+
+ def testConvertActualData(self):
+ feed = webmastertools.SitesFeedFromString(test_data.SITES_FEED)
+ self.assert_(len(feed.entry[0].verification_method) == 2)
+ check = 0
+ for method in feed.entry[0].verification_method:
+ self.assert_(isinstance(method, webmastertools.VerificationMethod))
+ if method.type == 'metatag':
+ self.assert_(method.in_use == 'false')
+ self.assert_(method.text is None)
+ self.assert_(method.meta.name == 'verify-v1')
+ self.assert_(method.meta.content == 'a2Ai')
+ check = check | 1
+ elif method.type == 'htmlpage':
+ self.assert_(method.in_use == 'false')
+ self.assert_(method.text == '456456-google.html')
+ check = check | 2
+ else:
+ self.fail('Wrong Verification Method: %s' % method.type)
+ self.assert_(check == 2 ** 2 - 1,
+ 'Should only have two Verification Methods, metatag and htmlpage')
+
+
+class MarkupLanguageTest(unittest.TestCase):
+
+ def setUp(self):
+ self.markup_language = webmastertools.MarkupLanguage()
+
+ def testToAndFromString(self):
+ self.markup_language.text = 'HTML'
+ self.assert_(self.markup_language.text == 'HTML')
+ new_markup_language = webmastertools.MarkupLanguageFromString(
+ self.markup_language.ToString())
+ self.assert_(self.markup_language.text == new_markup_language.text)
+
+
+class SitemapMobileTest(unittest.TestCase):
+
+ def setUp(self):
+ self.sitemap_mobile = webmastertools.SitemapMobile()
+
+ def testToAndFromString(self):
+ self.sitemap_mobile.markup_language.append(webmastertools.MarkupLanguage(
+ text = 'HTML'))
+ self.assert_(self.sitemap_mobile.text is None)
+ self.assert_(self.sitemap_mobile.markup_language[0].text == 'HTML')
+ new_sitemap_mobile = webmastertools.SitemapMobileFromString(
+ self.sitemap_mobile.ToString())
+ self.assert_(new_sitemap_mobile.text is None)
+ self.assert_(self.sitemap_mobile.markup_language[0].text ==
+ new_sitemap_mobile.markup_language[0].text)
+
+ def testConvertActualData(self):
+ feed = webmastertools.SitemapsFeedFromString(test_data.SITEMAPS_FEED)
+ self.assert_(feed.sitemap_mobile.text.strip() == '')
+ self.assert_(len(feed.sitemap_mobile.markup_language) == 2)
+ check = 0
+ for markup_language in feed.sitemap_mobile.markup_language:
+ self.assert_(isinstance(markup_language, webmastertools.MarkupLanguage))
+ if markup_language.text == "HTML":
+ check = check | 1
+ elif markup_language.text == "WAP":
+ check = check | 2
+ else:
+ self.fail('Unexpected markup language: %s' % markup_language.text)
+ self.assert_(check == 2 ** 2 - 1, "Something is wrong with markup language")
+
+
+class SitemapMobileMarkupLanguageTest(unittest.TestCase):
+
+ def setUp(self):
+ self.sitemap_mobile_markup_language =\
+ webmastertools.SitemapMobileMarkupLanguage()
+
+ def testToAndFromString(self):
+ self.sitemap_mobile_markup_language.text = 'HTML'
+ self.assert_(self.sitemap_mobile_markup_language.text == 'HTML')
+ new_sitemap_mobile_markup_language =\
+ webmastertools.SitemapMobileMarkupLanguageFromString(
+ self.sitemap_mobile_markup_language.ToString())
+ self.assert_(self.sitemap_mobile_markup_language.text ==\
+ new_sitemap_mobile_markup_language.text)
+
+
+class PublicationLabelTest(unittest.TestCase):
+
+ def setUp(self):
+ self.publication_label = webmastertools.PublicationLabel()
+
+ def testToAndFromString(self):
+ self.publication_label.text = 'Value1'
+ self.assert_(self.publication_label.text == 'Value1')
+ new_publication_label = webmastertools.PublicationLabelFromString(
+ self.publication_label.ToString())
+ self.assert_(self.publication_label.text == new_publication_label.text)
+
+
+class SitemapNewsTest(unittest.TestCase):
+
+ def setUp(self):
+ self.sitemap_news = webmastertools.SitemapNews()
+
+ def testToAndFromString(self):
+ self.sitemap_news.publication_label.append(webmastertools.PublicationLabel(
+ text = 'Value1'))
+ self.assert_(self.sitemap_news.text is None)
+ self.assert_(self.sitemap_news.publication_label[0].text == 'Value1')
+ new_sitemap_news = webmastertools.SitemapNewsFromString(
+ self.sitemap_news.ToString())
+ self.assert_(new_sitemap_news.text is None)
+ self.assert_(self.sitemap_news.publication_label[0].text ==
+ new_sitemap_news.publication_label[0].text)
+
+ def testConvertActualData(self):
+ feed = webmastertools.SitemapsFeedFromString(test_data.SITEMAPS_FEED)
+ self.assert_(len(feed.sitemap_news.publication_label) == 3)
+ check = 0
+ for publication_label in feed.sitemap_news.publication_label:
+ if publication_label.text == "Value1":
+ check = check | 1
+ elif publication_label.text == "Value2":
+ check = check | 2
+ elif publication_label.text == "Value3":
+ check = check | 4
+ else:
+ self.fail('Unexpected publication label: %s' % markup_language.text)
+ self.assert_(check == 2 ** 3 - 1,
+ 'Something is wrong with publication label')
+
+
+class SitemapNewsPublicationLabelTest(unittest.TestCase):
+
+ def setUp(self):
+ self.sitemap_news_publication_label =\
+ webmastertools.SitemapNewsPublicationLabel()
+
+ def testToAndFromString(self):
+ self.sitemap_news_publication_label.text = 'LabelValue'
+ self.assert_(self.sitemap_news_publication_label.text == 'LabelValue')
+ new_sitemap_news_publication_label =\
+ webmastertools.SitemapNewsPublicationLabelFromString(
+ self.sitemap_news_publication_label.ToString())
+ self.assert_(self.sitemap_news_publication_label.text ==\
+ new_sitemap_news_publication_label.text)
+
+
+class SitemapLastDownloadedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.sitemap_last_downloaded = webmastertools.SitemapLastDownloaded()
+
+ def testToAndFromString(self):
+ self.sitemap_last_downloaded.text = '2006-11-18T19:27:32.543Z'
+ self.assert_(self.sitemap_last_downloaded.text ==\
+ '2006-11-18T19:27:32.543Z')
+ new_sitemap_last_downloaded =\
+ webmastertools.SitemapLastDownloadedFromString(
+ self.sitemap_last_downloaded.ToString())
+ self.assert_(self.sitemap_last_downloaded.text ==\
+ new_sitemap_last_downloaded.text)
+
+
+class SitemapTypeTest(unittest.TestCase):
+
+ def setUp(self):
+ self.sitemap_type = webmastertools.SitemapType()
+
+ def testToAndFromString(self):
+ self.sitemap_type.text = 'WEB'
+ self.assert_(self.sitemap_type.text == 'WEB')
+ new_sitemap_type = webmastertools.SitemapTypeFromString(
+ self.sitemap_type.ToString())
+ self.assert_(self.sitemap_type.text == new_sitemap_type.text)
+
+
+class SitemapStatusTest(unittest.TestCase):
+
+ def setUp(self):
+ self.sitemap_status = webmastertools.SitemapStatus()
+
+ def testToAndFromString(self):
+ self.sitemap_status.text = 'Pending'
+ self.assert_(self.sitemap_status.text == 'Pending')
+ new_sitemap_status = webmastertools.SitemapStatusFromString(
+ self.sitemap_status.ToString())
+ self.assert_(self.sitemap_status.text == new_sitemap_status.text)
+
+
+class SitemapUrlCountTest(unittest.TestCase):
+
+ def setUp(self):
+ self.sitemap_url_count = webmastertools.SitemapUrlCount()
+
+ def testToAndFromString(self):
+ self.sitemap_url_count.text = '0'
+ self.assert_(self.sitemap_url_count.text == '0')
+ new_sitemap_url_count = webmastertools.SitemapUrlCountFromString(
+ self.sitemap_url_count.ToString())
+ self.assert_(self.sitemap_url_count.text == new_sitemap_url_count.text)
+
+
+class SitesEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ pass
+
+ def testToAndFromString(self):
+ entry = webmastertools.SitesEntry(
+ indexed=webmastertools.Indexed(text='true'),
+ crawled=webmastertools.Crawled(text='2008-09-14T08:59:28.000'),
+ geolocation=webmastertools.GeoLocation(text='US'),
+ preferred_domain=webmastertools.PreferredDomain(text='none'),
+ crawl_rate=webmastertools.CrawlRate(text='normal'),
+ enhanced_image_search=webmastertools.EnhancedImageSearch(text='true'),
+ verified=webmastertools.Verified(text='false'),
+ )
+ self.assert_(entry.indexed.text == 'true')
+ self.assert_(entry.crawled.text == '2008-09-14T08:59:28.000')
+ self.assert_(entry.geolocation.text == 'US')
+ self.assert_(entry.preferred_domain.text == 'none')
+ self.assert_(entry.crawl_rate.text == 'normal')
+ self.assert_(entry.enhanced_image_search.text == 'true')
+ self.assert_(entry.verified.text == 'false')
+ new_entry = webmastertools.SitesEntryFromString(entry.ToString())
+ self.assert_(new_entry.indexed.text == 'true')
+ self.assert_(new_entry.crawled.text == '2008-09-14T08:59:28.000')
+ self.assert_(new_entry.geolocation.text == 'US')
+ self.assert_(new_entry.preferred_domain.text == 'none')
+ self.assert_(new_entry.crawl_rate.text == 'normal')
+ self.assert_(new_entry.enhanced_image_search.text == 'true')
+ self.assert_(new_entry.verified.text == 'false')
+
+ def testConvertActualData(self):
+ feed = webmastertools.SitesFeedFromString(test_data.SITES_FEED)
+ self.assert_(len(feed.entry) == 1)
+ entry = feed.entry[0]
+ self.assert_(isinstance(entry, webmastertools.SitesEntry))
+ self.assert_(entry.indexed.text == 'true')
+ self.assert_(entry.crawled.text == '2008-09-14T08:59:28.000')
+ self.assert_(entry.geolocation.text == 'US')
+ self.assert_(entry.preferred_domain.text == 'none')
+ self.assert_(entry.crawl_rate.text == 'normal')
+ self.assert_(entry.enhanced_image_search.text == 'true')
+ self.assert_(entry.verified.text == 'false')
+
+
+class SitesFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.webmastertools.SitesFeedFromString(test_data.SITES_FEED)
+
+ def testToAndFromString(self):
+ self.assert_(len(self.feed.entry) == 1)
+ for entry in self.feed.entry:
+ self.assert_(isinstance(entry, webmastertools.SitesEntry))
+ new_feed = webmastertools.SitesFeedFromString(self.feed.ToString())
+ self.assert_(len(new_feed.entry) == 1)
+ for entry in new_feed.entry:
+ self.assert_(isinstance(entry, webmastertools.SitesEntry))
+
+
+class SitemapsEntryTest(unittest.TestCase):
+
+ def testRegularToAndFromString(self):
+ entry = webmastertools.SitemapsEntry(
+ sitemap_type=webmastertools.SitemapType(text='WEB'),
+ sitemap_status=webmastertools.SitemapStatus(text='Pending'),
+ sitemap_last_downloaded=webmastertools.SitemapLastDownloaded(
+ text='2006-11-18T19:27:32.543Z'),
+ sitemap_url_count=webmastertools.SitemapUrlCount(text='102'),
+ )
+ self.assert_(entry.sitemap_type.text == 'WEB')
+ self.assert_(entry.sitemap_status.text == 'Pending')
+ self.assert_(entry.sitemap_last_downloaded.text ==\
+ '2006-11-18T19:27:32.543Z')
+ self.assert_(entry.sitemap_url_count.text == '102')
+ new_entry = webmastertools.SitemapsEntryFromString(entry.ToString())
+ self.assert_(new_entry.sitemap_type.text == 'WEB')
+ self.assert_(new_entry.sitemap_status.text == 'Pending')
+ self.assert_(new_entry.sitemap_last_downloaded.text ==\
+ '2006-11-18T19:27:32.543Z')
+ self.assert_(new_entry.sitemap_url_count.text == '102')
+
+ def testConvertActualData(self):
+ feed = gdata.webmastertools.SitemapsFeedFromString(test_data.SITEMAPS_FEED)
+ self.assert_(len(feed.entry) == 3)
+ for entry in feed.entry:
+ self.assert_(entry, webmastertools.SitemapsEntry)
+ self.assert_(entry.sitemap_status, webmastertools.SitemapStatus)
+ self.assert_(entry.sitemap_last_downloaded,
+ webmastertools.SitemapLastDownloaded)
+ self.assert_(entry.sitemap_url_count, webmastertools.SitemapUrlCount)
+ self.assert_(entry.sitemap_status.text == 'StatusValue')
+ self.assert_(entry.sitemap_last_downloaded.text ==\
+ '2006-11-18T19:27:32.543Z')
+ self.assert_(entry.sitemap_url_count.text == '102')
+ if entry.id.text == 'http://www.example.com/sitemap-index.xml':
+ self.assert_(entry.sitemap_type, webmastertools.SitemapType)
+ self.assert_(entry.sitemap_type.text == 'WEB')
+ self.assert_(entry.sitemap_mobile_markup_language is None)
+ self.assert_(entry.sitemap_news_publication_label is None)
+ elif entry.id.text == 'http://www.example.com/mobile/sitemap-index.xml':
+ self.assert_(entry.sitemap_mobile_markup_language,
+ webmastertools.SitemapMobileMarkupLanguage)
+ self.assert_(entry.sitemap_mobile_markup_language.text == 'HTML')
+ self.assert_(entry.sitemap_type is None)
+ self.assert_(entry.sitemap_news_publication_label is None)
+ elif entry.id.text == 'http://www.example.com/news/sitemap-index.xml':
+ self.assert_(entry.sitemap_news_publication_label,
+ webmastertools.SitemapNewsPublicationLabel)
+ self.assert_(entry.sitemap_news_publication_label.text == 'LabelValue')
+ self.assert_(entry.sitemap_type is None)
+ self.assert_(entry.sitemap_mobile_markup_language is None)
+
+
+class SitemapsFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.webmastertools.SitemapsFeedFromString(
+ test_data.SITEMAPS_FEED)
+
+ def testToAndFromString(self):
+ self.assert_(len(self.feed.entry) == 3)
+ for entry in self.feed.entry:
+ self.assert_(isinstance(entry, webmastertools.SitemapsEntry))
+ new_feed = webmastertools.SitemapsFeedFromString(self.feed.ToString())
+ self.assert_(len(new_feed.entry) == 3)
+ for entry in new_feed.entry:
+ self.assert_(isinstance(entry, webmastertools.SitemapsEntry))
+
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/gdata_tests/youtube/__init__.py b/tests/gdata_tests/youtube/__init__.py
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/tests/gdata_tests/youtube/__init__.py
diff --git a/tests/gdata_tests/youtube/live_client_test.py b/tests/gdata_tests/youtube/live_client_test.py
new file mode 100644
index 0000000..73f7c2a
--- /dev/null
+++ b/tests/gdata_tests/youtube/live_client_test.py
@@ -0,0 +1,141 @@
+#!/usr/bin/env python
+#
+# Copyright (C) 2009 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# This module is used for version 2 of the Google Data APIs.
+# These tests attempt to connect to Google servers.
+
+
+__author__ = 's@google.com (John Skidgel)'
+
+# Python imports.
+import unittest
+import urllib
+import urllib2
+
+# Google Data APIs imports.
+import gdata.youtube.client
+import gdata.youtube.data
+import gdata.gauth
+import gdata.client
+import atom.http_core
+import atom.mock_http_core
+import atom.core
+import gdata.data
+import gdata.test_config as conf
+
+
+# Constants
+#DEVELOPER_KEY = 'AI39si4DTx4tY1ZCnIiZJrxtaxzfYuomY20SKDSfIAYrehKForeoHVgAgJZdNcYhmugD103wciae6TRI6M96nSymS8TV1kNP7g'
+#CLIENT_ID = 'ytapi-Google-CaptionTube-2rj5q0oh-0'
+
+conf.options.register_option(conf.YT_DEVELOPER_KEY_OPTION)
+conf.options.register_option(conf.YT_CLIENT_ID_OPTION)
+conf.options.register_option(conf.YT_VIDEO_ID_OPTION)
+
+TRACK_BODY_SRT = """1
+
+00:00:04,0 --> 00:00:05,75
+My other computer is a data center
+"""
+
+class YouTubeClientTest(unittest.TestCase):
+ def setUp(self):
+ self.client = None
+ if conf.options.get_value('runlive') == 'true':
+ self.client = gdata.youtube.client.YouTubeClient()
+
+ conf.configure_client(self.client,
+ 'YouTubeTest',
+ 'youtube')
+
+ def tearDown(self):
+ conf.close_client(self.client)
+
+ def test_retrieve_video_entry(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_retrieve_video_entry')
+ entry = self.client.get_video_entry(video_id=conf.options.get_value('videoid'))
+ self.assertTrue(entry.etag)
+
+ def test_retrieve_video_feed(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_retrieve_video_has_entries')
+
+ entries = self.client.get_videos()
+ self.assertTrue(len(entries.entry) > 0)
+
+ def test_retrieve_user_feed(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_retrieve_video_has_entries')
+
+ entries = self.client.get_user_feed(username='joegregoriotest')
+ self.assertTrue(len(entries.entry) > 0)
+
+ def test_create_update_delete_captions(self):
+ if not conf.options.get_value('runlive') == 'true':
+ return
+ # Either load the recording or prepare to make a live request.
+ conf.configure_cache(self.client, 'test_create_update_delete_captions')
+
+ # Add a track.
+ created = self.client.create_track(conf.options.get_value('videoid'), 'Test', 'en',
+ TRACK_BODY_SRT, conf.options.get_value('clientid'),
+ conf.options.get_value('developerkey'))
+
+ self.assertEqual(created.__class__, gdata.youtube.data.TrackEntry)
+
+ # Update the contents of a track. Language and title cannot be
+ # updated due to limitations. A workaround is to delete the original
+ # track and replace it with captions that have the desired contents,
+ # title, and name.
+ # @see 'Updating a caption track' in the protocol guide for captions:
+ # http://code.google.com/intl/en/apis/youtube/2.0/
+ # developers_guide_protocol_captions.html
+ updated = self.client.update_track(conf.options.get_value('videoid'), created,
+ TRACK_BODY_SRT, conf.options.get_value('clientid'),
+ conf.options.get_value('developerkey'))
+
+ self.assertEqual(updated.__class__, gdata.youtube.data.TrackEntry)
+
+ # Retrieve the captions for the track for comparision testing.
+ track_url = updated.content.src
+ track = self.client.get_caption_track(
+ track_url, conf.options.get_value('clientid'),
+ conf.options.get_value('developerkey'))
+ track_contents = track.read()
+
+ self.assertEqual(track_contents, TRACK_BODY_SRT)
+
+ # Delete a track.
+ resp = self.client.delete_track(conf.options.get_value('videoid'),
+ created,
+ conf.options.get_value('clientid'),
+ conf.options.get_value('developerkey'))
+ self.assertEqual(200, resp.status)
+
+
+def suite():
+ return conf.build_suite([YouTubeClientTest])
+
+
+if __name__ == '__main__':
+ unittest.TextTestRunner().run(suite())
diff --git a/tests/gdata_tests/youtube/service_test.py b/tests/gdata_tests/youtube/service_test.py
new file mode 100644
index 0000000..0d9f528
--- /dev/null
+++ b/tests/gdata_tests/youtube/service_test.py
@@ -0,0 +1,576 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+__author__ = 'api.jhartmann@gmail.com (Jochen Hartmann)'
+
+import getpass
+import time
+import StringIO
+import random
+import unittest
+import atom
+import gdata.youtube
+import gdata.youtube.service
+
+YOUTUBE_TEST_CLIENT_ID = 'ytapi-pythonclientlibrary_servicetest'
+
+
+class YouTubeServiceTest(unittest.TestCase):
+
+ def setUp(self):
+ self.client = gdata.youtube.service.YouTubeService()
+ self.client.email = username
+ self.client.password = password
+ self.client.source = YOUTUBE_TEST_CLIENT_ID
+ self.client.developer_key = developer_key
+ self.client.client_id = YOUTUBE_TEST_CLIENT_ID
+ self.client.ProgrammaticLogin()
+
+ def testRetrieveVideoFeed(self):
+ feed = self.client.GetYouTubeVideoFeed(
+ 'https://gdata.youtube.com/feeds/api/standardfeeds/recently_featured');
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 0)
+ for entry in feed.entry:
+ self.assert_(entry.title.text != '')
+
+ def testRetrieveTopRatedVideoFeed(self):
+ feed = self.client.GetTopRatedVideoFeed()
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 10)
+
+ def testRetrieveMostViewedVideoFeed(self):
+ feed = self.client.GetMostViewedVideoFeed()
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 10)
+
+ def testRetrieveRecentlyFeaturedVideoFeed(self):
+ feed = self.client.GetRecentlyFeaturedVideoFeed()
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 10)
+
+ def testRetrieveWatchOnMobileVideoFeed(self):
+ feed = self.client.GetWatchOnMobileVideoFeed()
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 10)
+
+ def testRetrieveTopFavoritesVideoFeed(self):
+ feed = self.client.GetTopFavoritesVideoFeed()
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 10)
+
+ def testRetrieveMostRecentVideoFeed(self):
+ feed = self.client.GetMostRecentVideoFeed()
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 10)
+
+ def testRetrieveMostDiscussedVideoFeed(self):
+ feed = self.client.GetMostDiscussedVideoFeed()
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 10)
+
+ def testRetrieveMostLinkedVideoFeed(self):
+ feed = self.client.GetMostLinkedVideoFeed()
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 10)
+
+ def testRetrieveMostRespondedVideoFeed(self):
+ feed = self.client.GetMostRespondedVideoFeed()
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 10)
+
+ def testRetrieveVideoEntryByUri(self):
+ entry = self.client.GetYouTubeVideoEntry(
+ 'https://gdata.youtube.com/feeds/videos/Ncakifd_16k')
+ self.assert_(isinstance(entry, gdata.youtube.YouTubeVideoEntry))
+ self.assert_(entry.title.text != '')
+
+ def testRetrieveVideoEntryByVideoId(self):
+ entry = self.client.GetYouTubeVideoEntry(video_id='Ncakifd_16k')
+ self.assert_(isinstance(entry, gdata.youtube.YouTubeVideoEntry))
+ self.assert_(entry.title.text != '')
+
+ def testRetrieveUserVideosbyUri(self):
+ feed = self.client.GetYouTubeUserFeed(
+ 'https://gdata.youtube.com/feeds/users/gdpython/uploads')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testRetrieveUserVideosbyUsername(self):
+ feed = self.client.GetYouTubeUserFeed(username='gdpython')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testSearchWithVideoQuery(self):
+ query = gdata.youtube.service.YouTubeVideoQuery()
+ query.vq = 'google'
+ query.max_results = 8
+ feed = self.client.YouTubeQuery(query)
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assertEquals(len(feed.entry), 8)
+
+ def testDirectVideoUploadStatusUpdateAndDeletion(self):
+ self.assertEquals(self.client.developer_key, developer_key)
+ self.assertEquals(self.client.client_id, YOUTUBE_TEST_CLIENT_ID)
+ self.assertEquals(self.client.additional_headers['X-GData-Key'],
+ 'key=' + developer_key)
+ self.assertEquals(self.client.additional_headers['X-Gdata-Client'],
+ YOUTUBE_TEST_CLIENT_ID)
+
+ test_video_title = 'my cool video ' + str(random.randint(1000,5000))
+ test_video_description = 'description ' + str(random.randint(1000,5000))
+
+ my_media_group = gdata.media.Group(
+ title = gdata.media.Title(text=test_video_title),
+ description = gdata.media.Description(description_type='plain',
+ text=test_video_description),
+ keywords = gdata.media.Keywords(text='video, foo'),
+ category = gdata.media.Category(
+ text='Autos',
+ scheme='http://gdata.youtube.com/schemas/2007/categories.cat',
+ label='Autos'),
+ player=None
+ )
+ self.assert_(isinstance(my_media_group, gdata.media.Group))
+
+ # Set Geo location to 37,-122 lat, long
+ where = gdata.geo.Where()
+ where.set_location((37.0,-122.0))
+
+ video_entry = gdata.youtube.YouTubeVideoEntry(media=my_media_group,
+ geo=where)
+
+ self.assert_(isinstance(video_entry, gdata.youtube.YouTubeVideoEntry))
+
+ new_entry = self.client.InsertVideoEntry(video_entry, video_file_location)
+ self.assert_(isinstance(new_entry, gdata.youtube.YouTubeVideoEntry))
+ self.assertEquals(new_entry.title.text, test_video_title)
+ self.assertEquals(new_entry.media.description.text, test_video_description)
+ self.assert_(new_entry.id.text)
+
+ # check upload status also
+ upload_status = self.client.CheckUploadStatus(new_entry)
+ self.assert_(upload_status[0] != '')
+
+ # test updating entry meta-data
+ new_video_description = 'description ' + str(random.randint(1000,5000))
+ new_entry.media.description.text = new_video_description
+
+ updated_entry = self.client.UpdateVideoEntry(new_entry)
+
+ self.assert_(isinstance(updated_entry, gdata.youtube.YouTubeVideoEntry))
+ self.assertEquals(updated_entry.media.description.text,
+ new_video_description)
+
+ # sleep for 10 seconds
+ time.sleep(10)
+
+ # test to delete the entry
+ value = self.client.DeleteVideoEntry(updated_entry)
+
+ if not value:
+ # sleep more and try again
+ time.sleep(20)
+ # test to delete the entry
+ value = self.client.DeleteVideoEntry(updated_entry)
+
+ self.assert_(value == True)
+
+ def testDirectVideoUploadWithDeveloperTags(self):
+ self.assertEquals(self.client.developer_key, developer_key)
+ self.assertEquals(self.client.client_id, YOUTUBE_TEST_CLIENT_ID)
+ self.assertEquals(self.client.additional_headers['X-GData-Key'],
+ 'key=' + developer_key)
+ self.assertEquals(self.client.additional_headers['X-Gdata-Client'],
+ YOUTUBE_TEST_CLIENT_ID)
+
+ test_video_title = 'my cool video ' + str(random.randint(1000,5000))
+ test_video_description = 'description ' + str(random.randint(1000,5000))
+
+ test_developer_tag_01 = 'tag' + str(random.randint(1000,5000))
+ test_developer_tag_02 = 'tag' + str(random.randint(1000,5000))
+ test_developer_tag_03 = 'tag' + str(random.randint(1000,5000))
+
+ my_media_group = gdata.media.Group(
+ title = gdata.media.Title(text=test_video_title),
+ description = gdata.media.Description(description_type='plain',
+ text=test_video_description),
+ keywords = gdata.media.Keywords(text='video, foo'),
+ category = [gdata.media.Category(
+ text='Autos',
+ scheme='http://gdata.youtube.com/schemas/2007/categories.cat',
+ label='Autos')],
+ player=None
+ )
+
+ self.assert_(isinstance(my_media_group, gdata.media.Group))
+
+ video_entry = gdata.youtube.YouTubeVideoEntry(media=my_media_group)
+ original_developer_tags = [test_developer_tag_01, test_developer_tag_02,
+ test_developer_tag_03]
+
+ dev_tags = video_entry.AddDeveloperTags(original_developer_tags)
+
+ for dev_tag in dev_tags:
+ self.assert_(dev_tag.text in original_developer_tags)
+
+ self.assert_(isinstance(video_entry, gdata.youtube.YouTubeVideoEntry))
+
+ new_entry = self.client.InsertVideoEntry(video_entry, video_file_location)
+
+ self.assert_(isinstance(new_entry, gdata.youtube.YouTubeVideoEntry))
+ self.assertEquals(new_entry.title.text, test_video_title)
+ self.assertEquals(new_entry.media.description.text, test_video_description)
+ self.assert_(new_entry.id.text)
+
+ developer_tags_from_new_entry = new_entry.GetDeveloperTags()
+ for dev_tag in developer_tags_from_new_entry:
+ self.assert_(dev_tag.text in original_developer_tags)
+
+ self.assertEquals(len(developer_tags_from_new_entry),
+ len(original_developer_tags))
+
+ # sleep for 10 seconds
+ time.sleep(10)
+
+ # test to delete the entry
+ value = self.client.DeleteVideoEntry(new_entry)
+
+ if not value:
+ # sleep more and try again
+ time.sleep(20)
+ # test to delete the entry
+ value = self.client.DeleteVideoEntry(new_entry)
+
+ self.assert_(value == True)
+
+ def testBrowserBasedVideoUpload(self):
+ self.assertEquals(self.client.developer_key, developer_key)
+ self.assertEquals(self.client.client_id, YOUTUBE_TEST_CLIENT_ID)
+ self.assertEquals(self.client.additional_headers['X-GData-Key'],
+ 'key=' + developer_key)
+ self.assertEquals(self.client.additional_headers['X-Gdata-Client'],
+ YOUTUBE_TEST_CLIENT_ID)
+ test_video_title = 'my cool video ' + str(random.randint(1000,5000))
+ test_video_description = 'description ' + str(random.randint(1000,5000))
+
+ my_media_group = gdata.media.Group(
+ title = gdata.media.Title(text=test_video_title),
+ description = gdata.media.Description(description_type='plain',
+ text=test_video_description),
+ keywords = gdata.media.Keywords(text='video, foo'),
+ category = gdata.media.Category(
+ text='Autos',
+ scheme='http://gdata.youtube.com/schemas/2007/categories.cat',
+ label='Autos'),
+ player=None
+ )
+ self.assert_(isinstance(my_media_group, gdata.media.Group))
+
+ video_entry = gdata.youtube.YouTubeVideoEntry(media=my_media_group)
+ self.assert_(isinstance(video_entry, gdata.youtube.YouTubeVideoEntry))
+
+ response = self.client.GetFormUploadToken(video_entry)
+ self.assert_(response[0].startswith(
+ 'https://uploads.gdata.youtube.com/action/FormDataUpload/'))
+ self.assert_(len(response[0]) > 55)
+ self.assert_(len(response[1]) > 100)
+
+ def testRetrieveRelatedVideoFeedByUri(self):
+ feed = self.client.GetYouTubeRelatedVideoFeed(
+ 'https://gdata.youtube.com/feeds/videos/Ncakifd_16k/related')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testRetrieveRelatedVideoFeedById(self):
+ feed = self.client.GetYouTubeRelatedVideoFeed(video_id = 'Ncakifd_16k')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testRetrieveResponseVideoFeedByUri(self):
+ feed = self.client.GetYouTubeVideoResponseFeed(
+ 'https://gdata.youtube.com/feeds/videos/Ncakifd_16k/responses')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoResponseFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testRetrieveResponseVideoFeedById(self):
+ feed = self.client.GetYouTubeVideoResponseFeed(video_id='Ncakifd_16k')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoResponseFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testRetrieveVideoCommentFeedByUri(self):
+ feed = self.client.GetYouTubeVideoCommentFeed(
+ 'https://gdata.youtube.com/feeds/api/videos/Ncakifd_16k/comments')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoCommentFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testRetrieveVideoCommentFeedByVideoId(self):
+ feed = self.client.GetYouTubeVideoCommentFeed(video_id='Ncakifd_16k')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoCommentFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testAddComment(self):
+ video_id = '9g6buYJTt_g'
+ video_entry = self.client.GetYouTubeVideoEntry(video_id=video_id)
+ random_comment_text = 'test_comment_' + str(random.randint(1000,50000))
+ self.client.AddComment(comment_text=random_comment_text,
+ video_entry=video_entry)
+ comment_feed = self.client.GetYouTubeVideoCommentFeed(video_id=video_id)
+ comment_found = False
+ for item in comment_feed.entry:
+ if (item.content.text == random_comment_text):
+ comment_found = True
+ self.assertEquals(comment_found, True)
+
+ def testAddRating(self):
+ video_id_to_rate = 'Ncakifd_16k'
+ video_entry = self.client.GetYouTubeVideoEntry(video_id=video_id_to_rate)
+ response = self.client.AddRating(3, video_entry)
+ self.assert_(isinstance(response, gdata.GDataEntry))
+
+ def testRetrievePlaylistFeedByUri(self):
+ feed = self.client.GetYouTubePlaylistFeed(
+ 'https://gdata.youtube.com/feeds/users/gdpython/playlists')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubePlaylistFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testRetrievePlaylistListFeedByUsername(self):
+ feed = self.client.GetYouTubePlaylistFeed(username='gdpython')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubePlaylistFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testRetrievePlaylistVideoFeed(self):
+ feed = self.client.GetYouTubePlaylistVideoFeed(
+ 'https://gdata.youtube.com/feeds/api/playlists/BCB3BB96DF51B505')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubePlaylistVideoFeed))
+ self.assert_(len(feed.entry) > 0)
+ self.assert_(isinstance(feed.entry[0],
+ gdata.youtube.YouTubePlaylistVideoEntry))
+
+ def testAddUpdateAndDeletePlaylist(self):
+ test_playlist_title = 'my test playlist ' + str(random.randint(1000,3000))
+ test_playlist_description = 'test playlist '
+ response = self.client.AddPlaylist(test_playlist_title,
+ test_playlist_description)
+ self.assert_(isinstance(response, gdata.youtube.YouTubePlaylistEntry))
+
+ new_playlist_title = 'my updated playlist ' + str(random.randint(1000,4000))
+ new_playlist_description = 'my updated playlist '
+ playlist_entry_id = response.id.text.split('/')[-1]
+
+ updated_playlist = self.client.UpdatePlaylist(playlist_entry_id,
+ new_playlist_title,
+ new_playlist_description)
+
+ playlist_feed = self.client.GetYouTubePlaylistFeed()
+
+ update_successful = False
+
+ for playlist_entry in playlist_feed.entry:
+ if playlist_entry.title.text == new_playlist_title:
+ update_successful = True
+ break
+
+ self.assertEquals(update_successful, True)
+
+ # wait
+ time.sleep(10)
+ # delete it
+ playlist_uri = updated_playlist.id.text
+ response = self.client.DeletePlaylist(playlist_uri)
+ self.assertEquals(response, True)
+
+ def testAddUpdateAndDeletePrivatePlaylist(self):
+ test_playlist_title = 'my test playlist ' + str(random.randint(1000,3000))
+ test_playlist_description = 'test playlist '
+ response = self.client.AddPlaylist(test_playlist_title,
+ test_playlist_description,
+ playlist_private=True)
+ self.assert_(isinstance(response, gdata.youtube.YouTubePlaylistEntry))
+
+ new_playlist_title = 'my updated playlist ' + str(random.randint(1000,4000))
+ new_playlist_description = 'my updated playlist '
+ playlist_entry_id = response.id.text.split('/')[-1]
+
+ updated_playlist = self.client.UpdatePlaylist(playlist_entry_id,
+ new_playlist_title,
+ new_playlist_description,
+ playlist_private=True)
+
+ playlist_feed = self.client.GetYouTubePlaylistFeed()
+
+ update_successful = False
+ playlist_still_private = False
+ for playlist_entry in playlist_feed.entry:
+ if playlist_entry.title.text == new_playlist_title:
+ update_successful = True
+ if playlist_entry.private is not None:
+ playlist_still_private = True
+
+ self.assertEquals(update_successful, True)
+ self.assertEquals(playlist_still_private, True)
+
+ # wait
+ time.sleep(10)
+ # delete it
+ playlist_uri = updated_playlist.id.text
+ response = self.client.DeletePlaylist(playlist_uri)
+ self.assertEquals(response, True)
+
+ def testAddEditAndDeleteVideoFromPlaylist(self):
+ test_playlist_title = 'my test playlist ' + str(random.randint(1000,3000))
+ test_playlist_description = 'test playlist '
+ response = self.client.AddPlaylist(test_playlist_title,
+ test_playlist_description)
+ self.assert_(isinstance(response, gdata.youtube.YouTubePlaylistEntry))
+
+ custom_video_title = 'my test video on my test playlist'
+ custom_video_description = 'this is a test video on my test playlist'
+ video_id = 'Ncakifd_16k'
+ playlist_uri = response.feed_link[0].href
+ time.sleep(10)
+ response = self.client.AddPlaylistVideoEntryToPlaylist(
+ playlist_uri, video_id, custom_video_title, custom_video_description)
+
+ self.assert_(isinstance(response, gdata.youtube.YouTubePlaylistVideoEntry))
+
+ playlist_entry_id = response.id.text.split('/')[-1]
+ playlist_uri = response.id.text.split(playlist_entry_id)[0][:-1]
+ new_video_title = 'video number ' + str(random.randint(1000,3000))
+ new_video_description = 'test video'
+ time.sleep(10)
+ response = self.client.UpdatePlaylistVideoEntryMetaData(
+ playlist_uri,
+ playlist_entry_id,
+ new_video_title,
+ new_video_description,
+ 1)
+ self.assert_(isinstance(response, gdata.youtube.YouTubePlaylistVideoEntry))
+ time.sleep(10)
+
+ playlist_entry_id = response.id.text.split('/')[-1]
+ # remove video from playlist
+ response = self.client.DeletePlaylistVideoEntry(playlist_uri,
+ playlist_entry_id)
+ self.assertEquals(response, True)
+
+ time.sleep(10)
+ # delete the playlist
+ response = self.client.DeletePlaylist(playlist_uri)
+ self.assertEquals(response, True)
+
+ def testRetrieveSubscriptionFeedByUri(self):
+ feed = self.client.GetYouTubeSubscriptionFeed(
+ 'https://gdata.youtube.com/feeds/users/gdpython/subscriptions')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeSubscriptionFeed))
+ self.assert_(len(feed.entry) == 3)
+
+ subscription_to_channel_found = False
+ subscription_to_favorites_found = False
+ subscription_to_query_found = False
+ all_types_found = False
+
+ for entry in feed.entry:
+ self.assert_(isinstance(entry, gdata.youtube.YouTubeSubscriptionEntry))
+ subscription_type = entry.GetSubscriptionType()
+ if subscription_type == 'channel':
+ subscription_to_channel_found = True
+ elif subscription_type == 'favorites':
+ subscription_to_favorites_found = True
+ elif subscription_type == 'query':
+ subscription_to_query_found = True
+
+ if (subscription_to_channel_found and subscription_to_favorites_found and
+ subscription_to_query_found):
+ all_types_found = True
+
+ self.assertEquals(all_types_found, True)
+
+ def testRetrieveSubscriptionFeedByUsername(self):
+ feed = self.client.GetYouTubeSubscriptionFeed(username='gdpython')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeSubscriptionFeed))
+ self.assert_(len(feed.entry) == 3)
+
+ subscription_to_channel_found = False
+ subscription_to_favorites_found = False
+ subscription_to_query_found = False
+ all_types_found = False
+
+ for entry in feed.entry:
+ self.assert_(isinstance(entry, gdata.youtube.YouTubeSubscriptionEntry))
+ subscription_type = entry.GetSubscriptionType()
+ if subscription_type == 'channel':
+ subscription_to_channel_found = True
+ elif subscription_type == 'favorites':
+ subscription_to_favorites_found = True
+ elif subscription_type == 'query':
+ subscription_to_query_found = True
+
+ if (subscription_to_channel_found and subscription_to_favorites_found and
+ subscription_to_query_found):
+ all_types_found = True
+ self.assertEquals(all_types_found, True)
+
+ def testRetrieveUserProfileByUri(self):
+ user = self.client.GetYouTubeUserEntry(
+ 'https://gdata.youtube.com/feeds/users/gdpython')
+ self.assert_(isinstance(user, gdata.youtube.YouTubeUserEntry))
+ self.assertEquals(user.location.text, 'US')
+
+ def testRetrieveUserProfileByUsername(self):
+ user = self.client.GetYouTubeUserEntry(username='gdpython')
+ self.assert_(isinstance(user, gdata.youtube.YouTubeUserEntry))
+ self.assertEquals(user.location.text, 'US')
+
+ def testRetrieveUserFavoritesFeed(self):
+ feed = self.client.GetUserFavoritesFeed(username='gdpython')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testRetrieveDefaultUserFavoritesFeed(self):
+ feed = self.client.GetUserFavoritesFeed()
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeVideoFeed))
+ self.assert_(len(feed.entry) > 0)
+
+ def testAddAndDeleteVideoFromFavorites(self):
+ video_id = 'Ncakifd_16k'
+ video_entry = self.client.GetYouTubeVideoEntry(video_id=video_id)
+ response = self.client.AddVideoEntryToFavorites(video_entry)
+ self.assert_(isinstance(response, gdata.GDataEntry))
+ time.sleep(10)
+ response = self.client.DeleteVideoEntryFromFavorites(video_id)
+ self.assertEquals(response, True)
+
+ def testRetrieveContactFeedByUri(self):
+ feed = self.client.GetYouTubeContactFeed(
+ 'https://gdata.youtube.com/feeds/users/gdpython/contacts')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeContactFeed))
+ self.assertEquals(len(feed.entry), 1)
+
+ def testRetrieveContactFeedByUsername(self):
+ feed = self.client.GetYouTubeContactFeed(username='gdpython')
+ self.assert_(isinstance(feed, gdata.youtube.YouTubeContactFeed))
+ self.assertEquals(len(feed.entry), 1)
+
+if __name__ == '__main__':
+ print ('NOTE: Please run these tests only with a test account. '
+ 'The tests may delete or update your data.')
+ username = raw_input('Please enter your username: ')
+ password = getpass.getpass()
+ developer_key = raw_input('Please enter your developer key: ')
+ video_file_location = raw_input(
+ 'Please enter the absolute path to a video file: ')
+ unittest.main()
diff --git a/tests/gdata_tests/youtube_test.py b/tests/gdata_tests/youtube_test.py
new file mode 100755
index 0000000..09e654b
--- /dev/null
+++ b/tests/gdata_tests/youtube_test.py
@@ -0,0 +1,561 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jhartmann@gmail.com (Jochen Hartmann)'
+
+import unittest
+from gdata import test_data
+import gdata.youtube
+import gdata.youtube.service
+import atom
+
+YOUTUBE_TEMPLATE = '{http://gdata.youtube.com/schemas/2007}%s'
+YT_FORMAT = YOUTUBE_TEMPLATE % ('format')
+
+
+class VideoEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.video_feed = gdata.youtube.YouTubeVideoFeedFromString(
+ test_data.YOUTUBE_VIDEO_FEED)
+
+ def testCorrectXmlParsing(self):
+ self.assertEquals(self.video_feed.id.text,
+ 'http://gdata.youtube.com/feeds/api/standardfeeds/top_rated')
+ self.assertEquals(len(self.video_feed.entry), 2)
+ for entry in self.video_feed.entry:
+ if (entry.id.text ==
+ 'http://gdata.youtube.com/feeds/api/videos/C71ypXYGho8'):
+
+ self.assertEquals(entry.published.text, '2008-03-20T10:17:27.000-07:00')
+ self.assertEquals(entry.updated.text, '2008-05-14T04:26:37.000-07:00')
+ self.assertEquals(entry.category[0].scheme,
+ 'http://gdata.youtube.com/schemas/2007/keywords.cat')
+ self.assertEquals(entry.category[0].term, 'karyn')
+ self.assertEquals(entry.category[1].scheme,
+ 'http://gdata.youtube.com/schemas/2007/keywords.cat')
+ self.assertEquals(entry.category[1].term, 'garcia')
+ self.assertEquals(entry.category[2].scheme,
+ 'http://gdata.youtube.com/schemas/2007/keywords.cat')
+ self.assertEquals(entry.category[2].term, 'me')
+ self.assertEquals(entry.category[3].scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(entry.category[3].term,
+ 'http://gdata.youtube.com/schemas/2007#video')
+ self.assertEquals(entry.title.text,
+ 'Me odeio por te amar - KARYN GARCIA')
+ self.assertEquals(entry.content.text, 'http://www.karyngarcia.com.br')
+ self.assertEquals(entry.link[0].rel, 'alternate')
+ self.assertEquals(entry.link[0].href,
+ 'http://www.youtube.com/watch?v=C71ypXYGho8')
+ self.assertEquals(entry.link[1].rel,
+ 'http://gdata.youtube.com/schemas/2007#video.related')
+ self.assertEquals(entry.link[1].href,
+ 'http://gdata.youtube.com/feeds/api/videos/C71ypXYGho8/related')
+ self.assertEquals(entry.link[2].rel, 'self')
+ self.assertEquals(entry.link[2].href,
+ ('http://gdata.youtube.com/feeds/api/standardfeeds'
+ '/top_rated/C71ypXYGho8'))
+ self.assertEquals(entry.author[0].name.text, 'TvKarynGarcia')
+ self.assertEquals(entry.author[0].uri.text,
+ 'http://gdata.youtube.com/feeds/api/users/tvkaryngarcia')
+
+ self.assertEquals(entry.media.title.text,
+ 'Me odeio por te amar - KARYN GARCIA')
+ self.assertEquals(entry.media.description.text,
+ 'http://www.karyngarcia.com.br')
+ self.assertEquals(entry.media.keywords.text,
+ 'amar, boyfriend, garcia, karyn, me, odeio, por, te')
+ self.assertEquals(entry.media.duration.seconds, '203')
+ self.assertEquals(entry.media.category[0].label, 'Music')
+ self.assertEquals(entry.media.category[0].scheme,
+ 'http://gdata.youtube.com/schemas/2007/categories.cat')
+ self.assertEquals(entry.media.category[0].text, 'Music')
+ self.assertEquals(entry.media.category[1].label, 'test111')
+ self.assertEquals(entry.media.category[1].scheme,
+ 'http://gdata.youtube.com/schemas/2007/developertags.cat')
+ self.assertEquals(entry.media.category[1].text, 'test111')
+ self.assertEquals(entry.media.category[2].label, 'test222')
+ self.assertEquals(entry.media.category[2].scheme,
+ 'http://gdata.youtube.com/schemas/2007/developertags.cat')
+ self.assertEquals(entry.media.category[2].text, 'test222')
+ self.assertEquals(entry.media.content[0].url,
+ 'http://www.youtube.com/v/C71ypXYGho8')
+ self.assertEquals(entry.media.content[0].type,
+ 'application/x-shockwave-flash')
+ self.assertEquals(entry.media.content[0].medium, 'video')
+ self.assertEquals(
+ entry.media.content[0].extension_attributes['isDefault'], 'true')
+ self.assertEquals(
+ entry.media.content[0].extension_attributes['expression'], 'full')
+ self.assertEquals(
+ entry.media.content[0].extension_attributes['duration'], '203')
+ self.assertEquals(
+ entry.media.content[0].extension_attributes[YT_FORMAT], '5')
+ self.assertEquals(entry.media.content[1].url,
+ ('rtsp://rtsp2.youtube.com/ChoLENy73wIaEQmPhgZ2pXK9CxMYDSANFEgGDA'
+ '==/0/0/0/video.3gp'))
+ self.assertEquals(entry.media.content[1].type, 'video/3gpp')
+ self.assertEquals(entry.media.content[1].medium, 'video')
+ self.assertEquals(
+ entry.media.content[1].extension_attributes['expression'], 'full')
+ self.assertEquals(
+ entry.media.content[1].extension_attributes['duration'], '203')
+ self.assertEquals(
+ entry.media.content[1].extension_attributes[YT_FORMAT], '1')
+ self.assertEquals(entry.media.content[2].url,
+ ('rtsp://rtsp2.youtube.com/ChoLENy73wIaEQmPhgZ2pXK9CxMYESARFEgGDA=='
+ '/0/0/0/video.3gp'))
+ self.assertEquals(entry.media.content[2].type, 'video/3gpp')
+ self.assertEquals(entry.media.content[2].medium, 'video')
+ self.assertEquals(
+ entry.media.content[2].extension_attributes['expression'], 'full')
+ self.assertEquals(
+ entry.media.content[2].extension_attributes['duration'], '203')
+ self.assertEquals(
+ entry.media.content[2].extension_attributes[YT_FORMAT], '6')
+ self.assertEquals(entry.media.player.url,
+ 'http://www.youtube.com/watch?v=C71ypXYGho8')
+ self.assertEquals(entry.media.thumbnail[0].url,
+ 'http://img.youtube.com/vi/C71ypXYGho8/2.jpg')
+ self.assertEquals(entry.media.thumbnail[0].height, '97')
+ self.assertEquals(entry.media.thumbnail[0].width, '130')
+ self.assertEquals(entry.media.thumbnail[0].extension_attributes['time'],
+ '00:01:41.500')
+ self.assertEquals(entry.media.thumbnail[1].url,
+ 'http://img.youtube.com/vi/C71ypXYGho8/1.jpg')
+ self.assertEquals(entry.media.thumbnail[1].height, '97')
+ self.assertEquals(entry.media.thumbnail[1].width, '130')
+ self.assertEquals(entry.media.thumbnail[1].extension_attributes['time'],
+ '00:00:50.750')
+ self.assertEquals(entry.media.thumbnail[2].url,
+ 'http://img.youtube.com/vi/C71ypXYGho8/3.jpg')
+ self.assertEquals(entry.media.thumbnail[2].height, '97')
+ self.assertEquals(entry.media.thumbnail[2].width, '130')
+ self.assertEquals(entry.media.thumbnail[2].extension_attributes['time'],
+ '00:02:32.250')
+ self.assertEquals(entry.media.thumbnail[3].url,
+ 'http://img.youtube.com/vi/C71ypXYGho8/0.jpg')
+ self.assertEquals(entry.media.thumbnail[3].height, '240')
+ self.assertEquals(entry.media.thumbnail[3].width, '320')
+ self.assertEquals(entry.media.thumbnail[3].extension_attributes['time'],
+ '00:01:41.500')
+
+ self.assertEquals(entry.statistics.view_count, '138864')
+ self.assertEquals(entry.statistics.favorite_count, '2474')
+ self.assertEquals(entry.rating.min, '1')
+ self.assertEquals(entry.rating.max, '5')
+ self.assertEquals(entry.rating.num_raters, '4626')
+ self.assertEquals(entry.rating.average, '4.95')
+ self.assertEquals(entry.comments.feed_link[0].href,
+ ('http://gdata.youtube.com/feeds/api/videos/'
+ 'C71ypXYGho8/comments'))
+ self.assertEquals(entry.comments.feed_link[0].count_hint, '27')
+
+ self.assertEquals(entry.GetSwfUrl(),
+ 'http://www.youtube.com/v/C71ypXYGho8')
+ self.assertEquals(entry.GetYouTubeCategoryAsString(), 'Music')
+
+
+class VideoEntryPrivateTest(unittest.TestCase):
+
+ def setUp(self):
+ self.entry = gdata.youtube.YouTubeVideoEntryFromString(
+ test_data.YOUTUBE_ENTRY_PRIVATE)
+
+ def testCorrectXmlParsing(self):
+ self.assert_(isinstance(self.entry,
+ gdata.youtube.YouTubeVideoEntry))
+ self.assert_(self.entry.media.private)
+
+
+class VideoFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubeVideoFeedFromString(
+ test_data.YOUTUBE_VIDEO_FEED)
+
+ def testCorrectXmlParsing(self):
+ self.assertEquals(self.feed.id.text,
+ 'http://gdata.youtube.com/feeds/api/standardfeeds/top_rated')
+ self.assertEquals(self.feed.generator.text, 'YouTube data API')
+ self.assertEquals(self.feed.generator.uri, 'http://gdata.youtube.com/')
+ self.assertEquals(len(self.feed.author), 1)
+ self.assertEquals(self.feed.author[0].name.text, 'YouTube')
+ self.assertEquals(len(self.feed.category), 1)
+ self.assertEquals(self.feed.category[0].scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(self.feed.category[0].term,
+ 'http://gdata.youtube.com/schemas/2007#video')
+ self.assertEquals(self.feed.items_per_page.text, '25')
+ self.assertEquals(len(self.feed.link), 4)
+ self.assertEquals(self.feed.link[0].href,
+ 'http://www.youtube.com/browse?s=tr')
+ self.assertEquals(self.feed.link[0].rel, 'alternate')
+ self.assertEquals(self.feed.link[1].href,
+ 'http://gdata.youtube.com/feeds/api/standardfeeds/top_rated')
+ self.assertEquals(self.feed.link[1].rel,
+ 'http://schemas.google.com/g/2005#feed')
+ self.assertEquals(self.feed.link[2].href,
+ ('http://gdata.youtube.com/feeds/api/standardfeeds/top_rated?'
+ 'start-index=1&max-results=25'))
+ self.assertEquals(self.feed.link[2].rel, 'self')
+ self.assertEquals(self.feed.link[3].href,
+ ('http://gdata.youtube.com/feeds/api/standardfeeds/top_rated?'
+ 'start-index=26&max-results=25'))
+ self.assertEquals(self.feed.link[3].rel, 'next')
+ self.assertEquals(self.feed.start_index.text, '1')
+ self.assertEquals(self.feed.title.text, 'Top Rated')
+ self.assertEquals(self.feed.total_results.text, '100')
+ self.assertEquals(self.feed.updated.text, '2008-05-14T02:24:07.000-07:00')
+ self.assertEquals(len(self.feed.entry), 2)
+
+
+class YouTubePlaylistFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubePlaylistFeedFromString(
+ test_data.YOUTUBE_PLAYLIST_FEED)
+
+ def testCorrectXmlParsing(self):
+ self.assertEquals(len(self.feed.entry), 1)
+ self.assertEquals(
+ self.feed.category[0].scheme, 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(self.feed.category[0].term,
+ 'http://gdata.youtube.com/schemas/2007#playlistLink')
+
+
+class YouTubePlaylistEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubePlaylistFeedFromString(
+ test_data.YOUTUBE_PLAYLIST_FEED)
+
+ def testCorrectXmlParsing(self):
+ for entry in self.feed.entry:
+ self.assertEquals(entry.category[0].scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(entry.category[0].term,
+ 'http://gdata.youtube.com/schemas/2007#playlistLink')
+ self.assertEquals(entry.description.text,
+ 'My new playlist Description')
+ self.assertEquals(entry.feed_link[0].href,
+ 'http://gdata.youtube.com/feeds/playlists/8BCDD04DE8F771B2')
+ self.assertEquals(entry.feed_link[0].rel,
+ 'http://gdata.youtube.com/schemas/2007#playlist')
+
+
+class YouTubePlaylistVideoFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubePlaylistVideoFeedFromString(
+ test_data.YOUTUBE_PLAYLIST_VIDEO_FEED)
+
+ def testCorrectXmlParsing(self):
+ self.assertEquals(len(self.feed.entry), 1)
+ self.assertEquals(self.feed.category[0].scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(self.feed.category[0].term,
+ 'http://gdata.youtube.com/schemas/2007#playlist')
+ self.assertEquals(self.feed.category[1].scheme,
+ 'http://gdata.youtube.com/schemas/2007/tags.cat')
+ self.assertEquals(self.feed.category[1].term, 'videos')
+ self.assertEquals(self.feed.category[2].scheme,
+ 'http://gdata.youtube.com/schemas/2007/tags.cat')
+ self.assertEquals(self.feed.category[2].term, 'python')
+
+
+class YouTubePlaylistVideoEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubePlaylistVideoFeedFromString(
+ test_data.YOUTUBE_PLAYLIST_VIDEO_FEED)
+
+ def testCorrectXmlParsing(self):
+ self.assertEquals(len(self.feed.entry), 1)
+ for entry in self.feed.entry:
+ self.assertEquals(entry.position.text, '1')
+
+
+class YouTubeVideoCommentFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubeVideoCommentFeedFromString(
+ test_data.YOUTUBE_COMMENT_FEED)
+
+ def testCorrectXmlParsing(self):
+ self.assertEquals(len(self.feed.category), 1)
+ self.assertEquals(self.feed.category[0].scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(self.feed.category[0].term,
+ 'http://gdata.youtube.com/schemas/2007#comment')
+ self.assertEquals(len(self.feed.link), 4)
+ self.assertEquals(self.feed.link[0].rel, 'related')
+ self.assertEquals(self.feed.link[0].href,
+ 'http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU')
+ self.assertEquals(self.feed.link[1].rel, 'alternate')
+ self.assertEquals(self.feed.link[1].href,
+ 'http://www.youtube.com/watch?v=2Idhz9ef5oU')
+ self.assertEquals(self.feed.link[2].rel,
+ 'http://schemas.google.com/g/2005#feed')
+ self.assertEquals(self.feed.link[2].href,
+ 'http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments')
+ self.assertEquals(self.feed.link[3].rel, 'self')
+ self.assertEquals(self.feed.link[3].href,
+ ('http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU/comments?'
+ 'start-index=1&max-results=25'))
+ self.assertEquals(len(self.feed.entry), 3)
+
+
+class YouTubeVideoCommentEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubeVideoCommentFeedFromString(
+ test_data.YOUTUBE_COMMENT_FEED)
+
+ def testCorrectXmlParsing(self):
+ self.assertEquals(len(self.feed.entry), 3)
+ self.assert_(isinstance(self.feed.entry[0],
+ gdata.youtube.YouTubeVideoCommentEntry))
+
+ for entry in self.feed.entry:
+ if (entry.id.text ==
+ ('http://gdata.youtube.com/feeds/videos/'
+ '2Idhz9ef5oU/comments/91F809A3DE2EB81B')):
+ self.assertEquals(entry.category[0].scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(entry.category[0].term,
+ 'http://gdata.youtube.com/schemas/2007#comment')
+ self.assertEquals(entry.link[0].href,
+ 'http://gdata.youtube.com/feeds/videos/2Idhz9ef5oU')
+ self.assertEquals(entry.link[0].rel, 'related')
+ self.assertEquals(entry.content.text, 'test66')
+
+
+class YouTubeVideoSubscriptionFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubeSubscriptionFeedFromString(
+ test_data.YOUTUBE_SUBSCRIPTION_FEED)
+
+ def testCorrectXmlParsing(self):
+
+ self.assertEquals(len(self.feed.category), 1)
+ self.assertEquals(self.feed.category[0].scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(self.feed.category[0].term,
+ 'http://gdata.youtube.com/schemas/2007#subscription')
+ self.assertEquals(len(self.feed.link), 4)
+ self.assertEquals(self.feed.link[0].rel, 'related')
+ self.assertEquals(self.feed.link[0].href,
+ 'http://gdata.youtube.com/feeds/users/andyland74')
+ self.assertEquals(self.feed.link[1].rel, 'alternate')
+ self.assertEquals(self.feed.link[1].href,
+ 'http://www.youtube.com/profile_subscriptions?user=andyland74')
+ self.assertEquals(self.feed.link[2].rel,
+ 'http://schemas.google.com/g/2005#feed')
+ self.assertEquals(self.feed.link[2].href,
+ 'http://gdata.youtube.com/feeds/users/andyland74/subscriptions')
+ self.assertEquals(self.feed.link[3].rel, 'self')
+ self.assertEquals(self.feed.link[3].href,
+ ('http://gdata.youtube.com/feeds/users/andyland74/subscriptions?'
+ 'start-index=1&max-results=25'))
+ self.assertEquals(len(self.feed.entry), 1)
+
+
+class YouTubeVideoSubscriptionEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubeSubscriptionFeedFromString(
+ test_data.YOUTUBE_SUBSCRIPTION_FEED)
+
+ def testCorrectXmlParsing(self):
+ for entry in self.feed.entry:
+ self.assertEquals(len(entry.category), 2)
+ self.assertEquals(entry.category[0].scheme,
+ 'http://gdata.youtube.com/schemas/2007/subscriptiontypes.cat')
+ self.assertEquals(entry.category[0].term, 'channel')
+ self.assertEquals(entry.category[1].scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(entry.category[1].term,
+ 'http://gdata.youtube.com/schemas/2007#subscription')
+ self.assertEquals(len(entry.link), 3)
+ self.assertEquals(entry.link[0].href,
+ 'http://gdata.youtube.com/feeds/users/andyland74')
+ self.assertEquals(entry.link[0].rel, 'related')
+ self.assertEquals(entry.link[1].href,
+ 'http://www.youtube.com/profile_videos?user=NBC')
+ self.assertEquals(entry.link[1].rel, 'alternate')
+ self.assertEquals(entry.link[2].href,
+ ('http://gdata.youtube.com/feeds/users/andyland74/subscriptions/'
+ 'd411759045e2ad8c'))
+ self.assertEquals(entry.link[2].rel, 'self')
+ self.assertEquals(len(entry.feed_link), 1)
+ self.assertEquals(entry.feed_link[0].href,
+ 'http://gdata.youtube.com/feeds/api/users/nbc/uploads')
+ self.assertEquals(entry.feed_link[0].rel,
+ 'http://gdata.youtube.com/schemas/2007#user.uploads')
+ self.assertEquals(entry.username.text, 'NBC')
+
+
+class YouTubeVideoResponseFeedTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubeVideoFeedFromString(
+ test_data.YOUTUBE_VIDEO_RESPONSE_FEED)
+
+ def testCorrectXmlParsing(self):
+ self.assertEquals(len(self.feed.category), 1)
+ self.assertEquals(self.feed.category[0].scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(self.feed.category[0].term,
+ 'http://gdata.youtube.com/schemas/2007#video')
+ self.assertEquals(len(self.feed.link), 4)
+ self.assertEquals(self.feed.link[0].href,
+ 'http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY')
+ self.assertEquals(self.feed.link[0].rel, 'related')
+ self.assertEquals(self.feed.link[1].href,
+ 'http://www.youtube.com/video_response_view_all?v=2c3q9K4cHzY')
+ self.assertEquals(self.feed.link[1].rel, 'alternate')
+ self.assertEquals(self.feed.link[2].href,
+ 'http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY/responses')
+ self.assertEquals(self.feed.link[2].rel,
+ 'http://schemas.google.com/g/2005#feed')
+ self.assertEquals(self.feed.link[3].href,
+ ('http://gdata.youtube.com/feeds/videos/2c3q9K4cHzY/responses?'
+ 'start-index=1&max-results=25'))
+ self.assertEquals(self.feed.link[3].rel, 'self')
+ self.assertEquals(len(self.feed.entry), 1)
+
+
+class YouTubeVideoResponseEntryTest(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubeVideoFeedFromString(
+ test_data.YOUTUBE_VIDEO_RESPONSE_FEED)
+
+ def testCorrectXmlParsing(self):
+ for entry in self.feed.entry:
+ self.assert_(isinstance(entry, gdata.youtube.YouTubeVideoEntry))
+
+
+class YouTubeContactFeed(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubeContactFeedFromString(
+ test_data.YOUTUBE_CONTACTS_FEED)
+
+ def testCorrectXmlParsing(self):
+ self.assertEquals(len(self.feed.entry), 2)
+ self.assertEquals(self.feed.category[0].scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(self.feed.category[0].term,
+ 'http://gdata.youtube.com/schemas/2007#friend')
+
+
+class YouTubeContactEntry(unittest.TestCase):
+
+ def setUp(self):
+ self.feed= gdata.youtube.YouTubeContactFeedFromString(
+ test_data.YOUTUBE_CONTACTS_FEED)
+
+ def testCorrectXmlParsing(self):
+ for entry in self.feed.entry:
+ if (entry.id.text == ('http://gdata.youtube.com/feeds/users/'
+ 'apitestjhartmann/contacts/testjfisher')):
+ self.assertEquals(entry.username.text, 'testjfisher')
+ self.assertEquals(entry.status.text, 'pending')
+
+
+class YouTubeUserEntry(unittest.TestCase):
+
+ def setUp(self):
+ self.feed = gdata.youtube.YouTubeUserEntryFromString(
+ test_data.YOUTUBE_PROFILE)
+
+ def testCorrectXmlParsing(self):
+ self.assertEquals(self.feed.author[0].name.text, 'andyland74')
+ self.assertEquals(self.feed.books.text, 'Catch-22')
+ self.assertEquals(self.feed.category[0].scheme,
+ 'http://gdata.youtube.com/schemas/2007/channeltypes.cat')
+ self.assertEquals(self.feed.category[0].term, 'Standard')
+ self.assertEquals(self.feed.category[1].scheme,
+ 'http://schemas.google.com/g/2005#kind')
+ self.assertEquals(self.feed.category[1].term,
+ 'http://gdata.youtube.com/schemas/2007#userProfile')
+ self.assertEquals(self.feed.company.text, 'Google')
+ self.assertEquals(self.feed.gender.text, 'm')
+ self.assertEquals(self.feed.hobbies.text, 'Testing YouTube APIs')
+ self.assertEquals(self.feed.hometown.text, 'Somewhere')
+ self.assertEquals(len(self.feed.feed_link), 6)
+ self.assertEquals(self.feed.feed_link[0].count_hint, '4')
+ self.assertEquals(self.feed.feed_link[0].href,
+ 'http://gdata.youtube.com/feeds/users/andyland74/favorites')
+ self.assertEquals(self.feed.feed_link[0].rel,
+ 'http://gdata.youtube.com/schemas/2007#user.favorites')
+ self.assertEquals(self.feed.feed_link[1].count_hint, '1')
+ self.assertEquals(self.feed.feed_link[1].href,
+ 'http://gdata.youtube.com/feeds/users/andyland74/contacts')
+ self.assertEquals(self.feed.feed_link[1].rel,
+ 'http://gdata.youtube.com/schemas/2007#user.contacts')
+ self.assertEquals(self.feed.feed_link[2].count_hint, '0')
+ self.assertEquals(self.feed.feed_link[2].href,
+ 'http://gdata.youtube.com/feeds/users/andyland74/inbox')
+ self.assertEquals(self.feed.feed_link[2].rel,
+ 'http://gdata.youtube.com/schemas/2007#user.inbox')
+ self.assertEquals(self.feed.feed_link[3].count_hint, None)
+ self.assertEquals(self.feed.feed_link[3].href,
+ 'http://gdata.youtube.com/feeds/users/andyland74/playlists')
+ self.assertEquals(self.feed.feed_link[3].rel,
+ 'http://gdata.youtube.com/schemas/2007#user.playlists')
+ self.assertEquals(self.feed.feed_link[4].count_hint, '4')
+ self.assertEquals(self.feed.feed_link[4].href,
+ 'http://gdata.youtube.com/feeds/users/andyland74/subscriptions')
+ self.assertEquals(self.feed.feed_link[4].rel,
+ 'http://gdata.youtube.com/schemas/2007#user.subscriptions')
+ self.assertEquals(self.feed.feed_link[5].count_hint, '1')
+ self.assertEquals(self.feed.feed_link[5].href,
+ 'http://gdata.youtube.com/feeds/users/andyland74/uploads')
+ self.assertEquals(self.feed.feed_link[5].rel,
+ 'http://gdata.youtube.com/schemas/2007#user.uploads')
+ self.assertEquals(self.feed.first_name.text, 'andy')
+ self.assertEquals(self.feed.last_name.text, 'example')
+ self.assertEquals(self.feed.link[0].href,
+ 'http://www.youtube.com/profile?user=andyland74')
+ self.assertEquals(self.feed.link[0].rel, 'alternate')
+ self.assertEquals(self.feed.link[1].href,
+ 'http://gdata.youtube.com/feeds/users/andyland74')
+ self.assertEquals(self.feed.link[1].rel, 'self')
+ self.assertEquals(self.feed.location.text, 'US')
+ self.assertEquals(self.feed.movies.text, 'Aqua Teen Hungerforce')
+ self.assertEquals(self.feed.music.text, 'Elliott Smith')
+ self.assertEquals(self.feed.occupation.text, 'Technical Writer')
+ self.assertEquals(self.feed.published.text, '2006-10-16T00:09:45.000-07:00')
+ self.assertEquals(self.feed.school.text, 'University of North Carolina')
+ self.assertEquals(self.feed.statistics.last_web_access,
+ '2008-02-25T16:03:38.000-08:00')
+ self.assertEquals(self.feed.statistics.subscriber_count, '1')
+ self.assertEquals(self.feed.statistics.video_watch_count, '21')
+ self.assertEquals(self.feed.statistics.view_count, '9')
+ self.assertEquals(self.feed.thumbnail.url,
+ 'http://i.ytimg.com/vi/YFbSxcdOL-w/default.jpg')
+ self.assertEquals(self.feed.title.text, 'andyland74 Channel')
+ self.assertEquals(self.feed.updated.text, '2008-02-26T11:48:21.000-08:00')
+ self.assertEquals(self.feed.username.text, 'andyland74')
+
+if __name__ == '__main__':
+ unittest.main()
diff --git a/tests/module_test_runner.py b/tests/module_test_runner.py
new file mode 100755
index 0000000..881a70d
--- /dev/null
+++ b/tests/module_test_runner.py
@@ -0,0 +1,57 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder@gmail.com (Jeff Scudder)'
+
+
+import unittest
+
+class ModuleTestRunner(object):
+
+ def __init__(self, module_list=None, module_settings=None):
+ """Constructor for a runner to run tests in the modules listed.
+
+ Args:
+ module_list: list (optional) The modules whose test cases will be run.
+ module_settings: dict (optional) A dictionary of module level varables
+ which should be set in the modules if they are present. An
+ example is the username and password which is a module variable
+ in most service_test modules.
+ """
+ self.modules = module_list or []
+ self.settings = module_settings or {}
+
+ def RunAllTests(self):
+ """Executes all tests in this objects modules list.
+
+ It also sets any module variables which match the settings keys to the
+ corresponding values in the settings member.
+ """
+ runner = unittest.TextTestRunner()
+ for module in self.modules:
+ # Set any module variables according to the contents in the settings
+ for setting, value in self.settings.iteritems():
+ try:
+ setattr(module, setting, value)
+ except AttributeError:
+ # This module did not have a variable for the current setting, so
+ # we skip it and try the next setting.
+ pass
+ # We have set all of the applicable settings for the module, now
+ # run the tests.
+ print '\nRunning all tests in module', module.__name__
+ runner.run(unittest.defaultTestLoader.loadTestsFromModule(module))
diff --git a/tests/run_all_tests.py b/tests/run_all_tests.py
new file mode 100755
index 0000000..c6c3f62
--- /dev/null
+++ b/tests/run_all_tests.py
@@ -0,0 +1,32 @@
+#!/usr/bin/python
+#
+# Copyright (C) 2006 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+__author__ = 'api.jscudder@gmail.com (Jeff Scudder)'
+
+
+import sys
+import unittest
+import getopt
+import getpass
+import module_test_runner
+import run_data_tests
+import run_service_tests
+
+
+if __name__ == '__main__':
+ run_data_tests.RunAllTests()
+ run_service_tests.GetValuesForTestSettingsAndRunAllTests()
diff --git a/tests/run_data_tests.py b/tests/run_data_tests.py
new file mode 100755
index 0000000..54072b9
--- /dev/null
+++ b/tests/run_data_tests.py
@@ -0,0 +1,60 @@
+#!/usr/bin/python
+
+import sys
+import unittest
+import module_test_runner
+import getopt
+import getpass
+# Modules whose tests we will run.
+import gdata_test
+import atom_test
+import atom_tests.http_interface_test
+import atom_tests.mock_http_test
+import atom_tests.token_store_test
+import atom_tests.url_test
+import atom_tests.core_test
+import gdata_tests.apps.emailsettings.data_test
+import gdata_tests.apps.multidomain.data_test
+import gdata_tests.apps_test
+import gdata_tests.auth_test
+import gdata_tests.books_test
+import gdata_tests.blogger_test
+import gdata_tests.calendar_test
+import gdata_tests.calendar_resource.data_test
+import gdata_tests.client_test
+import gdata_tests.codesearch_test
+import gdata_tests.contacts_test
+import gdata_tests.docs_test
+import gdata_tests.health_test
+import gdata_tests.photos_test
+import gdata_tests.spreadsheet_test
+import gdata_tests.youtube_test
+import gdata_tests.webmastertools_test
+import gdata_tests.oauth.data_test
+
+
+def RunAllTests():
+ test_runner = module_test_runner.ModuleTestRunner()
+ test_runner.modules = [gdata_test, atom_test, atom_tests.url_test,
+ atom_tests.http_interface_test,
+ atom_tests.mock_http_test,
+ atom_tests.core_test,
+ atom_tests.token_store_test,
+ gdata_tests.client_test,
+ gdata_tests.apps_test,
+ gdata_tests.apps.emailsettings.data_test,
+ gdata_tests.apps.multidomain.data_test,
+ gdata_tests.auth_test,
+ gdata_tests.books_test,
+ gdata_tests.calendar_test, gdata_tests.docs_test,
+ gdata_tests.health_test, gdata_tests.spreadsheet_test,
+ gdata_tests.photos_test, gdata_tests.codesearch_test,
+ gdata_tests.contacts_test,
+ gdata_tests.youtube_test, gdata_tests.blogger_test,
+ gdata_tests.webmastertools_test,
+ gdata_tests.calendar_resource.data_test,
+ gdata_tests.oauth.data_test]
+ test_runner.RunAllTests()
+
+if __name__ == '__main__':
+ RunAllTests()
diff --git a/tests/run_service_tests.py b/tests/run_service_tests.py
new file mode 100755
index 0000000..460f9cc
--- /dev/null
+++ b/tests/run_service_tests.py
@@ -0,0 +1,111 @@
+#!/usr/bin/python
+
+import sys
+import unittest
+import module_test_runner
+import getopt
+import getpass
+
+# Modules whose tests we will run.
+import atom_tests.service_test
+import gdata_tests.service_test
+import gdata_tests.apps.service_test
+import gdata_tests.books.service_test
+import gdata_tests.calendar.service_test
+import gdata_tests.docs.service_test
+import gdata_tests.health.service_test
+import gdata_tests.spreadsheet.service_test
+import gdata_tests.spreadsheet.text_db_test
+import gdata_tests.photos.service_test
+import gdata_tests.contacts.service_test
+import gdata_tests.blogger.service_test
+import gdata_tests.youtube.service_test
+import gdata_tests.health.service_test
+import gdata_tests.contacts.profiles.service_test
+
+
+def RunAllTests(username, password, spreadsheet_key, worksheet_key,
+ apps_username, apps_password, apps_domain):
+ test_runner = module_test_runner.ModuleTestRunner()
+ test_runner.modules = [atom_tests.service_test,
+ gdata_tests.service_test,
+ gdata_tests.apps.service_test,
+ gdata_tests.base.service_test,
+ gdata_tests.books.service_test,
+ gdata_tests.calendar.service_test,
+ gdata_tests.docs.service_test,
+ gdata_tests.health.service_test,
+ gdata_tests.spreadsheet.service_test,
+ gdata_tests.spreadsheet.text_db_test,
+ gdata_tests.contacts.service_test,
+ gdata_tests.youtube.service_test,
+ gdata_tests.photos.service_test,
+ gdata_tests.contacts.profiles.service_test,]
+ test_runner.settings = {'username':username, 'password':password,
+ 'test_image_location':'testimage.jpg',
+ 'ss_key':spreadsheet_key,
+ 'ws_key':worksheet_key,
+ 'apps_username':apps_username,
+ 'apps_password':apps_password,
+ 'apps_domain':apps_domain}
+ test_runner.RunAllTests()
+
+def GetValuesForTestSettingsAndRunAllTests():
+ username = ''
+ password = ''
+ spreadsheet_key = ''
+ worksheet_key = ''
+ apps_domain = ''
+ apps_username = ''
+ apps_password = ''
+
+ print ('NOTE: Please run these tests only with a test account. '
+ 'The tests may delete or update your data.')
+ try:
+ opts, args = getopt.getopt(sys.argv[1:], '', ['username=', 'password=',
+ 'ss_key=', 'ws_key=',
+ 'apps_username=',
+ 'apps_password=',
+ 'apps_domain='])
+ for o, a in opts:
+ if o == '--username':
+ username = a
+ elif o == '--password':
+ password = a
+ elif o == '--ss_key':
+ spreadsheet_key = a
+ elif o == '--ws_key':
+ worksheet_key = a
+ elif o == '--apps_username':
+ apps_username = a
+ elif o == '--apps_password':
+ apps_password = a
+ elif o == '--apps_domain':
+ apps_domain = a
+ except getopt.GetoptError:
+ pass
+
+ if username == '' and password == '':
+ print ('Missing --user and --pw command line arguments, '
+ 'prompting for credentials.')
+ if username == '':
+ username = raw_input('Please enter your username: ')
+ if password == '':
+ password = getpass.getpass()
+ if spreadsheet_key == '':
+ spreadsheet_key = raw_input(
+ 'Please enter the key for the test spreadsheet: ')
+ if worksheet_key == '':
+ worksheet_key = raw_input(
+ 'Please enter the id for the worksheet to be edited: ')
+ if apps_username == '':
+ apps_username = raw_input('Please enter your Google Apps admin username: ')
+ if apps_password == '':
+ apps_password = getpass.getpass()
+ if apps_domain == '':
+ apps_domain = raw_input('Please enter your Google Apps domain: ')
+ RunAllTests(username, password, spreadsheet_key, worksheet_key,
+ apps_username, apps_password, apps_domain)
+
+if __name__ == '__main__':
+ GetValuesForTestSettingsAndRunAllTests()
diff --git a/tests/testimage.jpg b/tests/testimage.jpg
new file mode 100755
index 0000000..165db62
--- /dev/null
+++ b/tests/testimage.jpg
Binary files differ
diff --git a/upload-diffs.py b/upload-diffs.py
new file mode 100644
index 0000000..4dce920
--- /dev/null
+++ b/upload-diffs.py
@@ -0,0 +1,1693 @@
+#!/usr/bin/env python
+#
+# Copyright 2007 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Tool for uploading diffs from a version control system to the codereview app.
+
+Usage summary: upload.py [options] [-- diff_options]
+
+Diff options are passed to the diff command of the underlying system.
+
+Supported version control systems:
+ Git
+ Mercurial
+ Subversion
+
+It is important for Git/Mercurial users to specify a tree/node/branch to diff
+against by using the '--rev' option.
+"""
+# This code is derived from appcfg.py in the App Engine SDK (open source),
+# and from ASPN recipe #146306.
+
+import ConfigParser
+import cookielib
+import fnmatch
+import getpass
+import logging
+import mimetypes
+import optparse
+import os
+import re
+import socket
+import subprocess
+import sys
+import urllib
+import urllib2
+import urlparse
+
+# The md5 module was deprecated in Python 2.5.
+try:
+ from hashlib import md5
+except ImportError:
+ from md5 import md5
+
+try:
+ import readline
+except ImportError:
+ pass
+
+# The logging verbosity:
+# 0: Errors only.
+# 1: Status messages.
+# 2: Info logs.
+# 3: Debug logs.
+verbosity = 1
+
+# Max size of patch or base file.
+MAX_UPLOAD_SIZE = 900 * 1024
+
+# Constants for version control names. Used by GuessVCSName.
+VCS_GIT = "Git"
+VCS_MERCURIAL = "Mercurial"
+VCS_SUBVERSION = "Subversion"
+VCS_UNKNOWN = "Unknown"
+
+# whitelist for non-binary filetypes which do not start with "text/"
+# .mm (Objective-C) shows up as application/x-freemind on my Linux box.
+TEXT_MIMETYPES = ['application/javascript', 'application/x-javascript',
+ 'application/x-freemind']
+
+VCS_ABBREVIATIONS = {
+ VCS_MERCURIAL.lower(): VCS_MERCURIAL,
+ "hg": VCS_MERCURIAL,
+ VCS_SUBVERSION.lower(): VCS_SUBVERSION,
+ "svn": VCS_SUBVERSION,
+ VCS_GIT.lower(): VCS_GIT,
+}
+
+# The result of parsing Subversion's [auto-props] setting.
+svn_auto_props_map = None
+
+def GetEmail(prompt):
+ """Prompts the user for their email address and returns it.
+
+ The last used email address is saved to a file and offered up as a suggestion
+ to the user. If the user presses enter without typing in anything the last
+ used email address is used. If the user enters a new address, it is saved
+ for next time we prompt.
+
+ """
+ last_email_file_name = os.path.expanduser("~/.last_codereview_email_address")
+ last_email = ""
+ if os.path.exists(last_email_file_name):
+ try:
+ last_email_file = open(last_email_file_name, "r")
+ last_email = last_email_file.readline().strip("\n")
+ last_email_file.close()
+ prompt += " [%s]" % last_email
+ except IOError, e:
+ pass
+ email = raw_input(prompt + ": ").strip()
+ if email:
+ try:
+ last_email_file = open(last_email_file_name, "w")
+ last_email_file.write(email)
+ last_email_file.close()
+ except IOError, e:
+ pass
+ else:
+ email = last_email
+ return email
+
+
+def StatusUpdate(msg):
+ """Print a status message to stdout.
+
+ If 'verbosity' is greater than 0, print the message.
+
+ Args:
+ msg: The string to print.
+ """
+ if verbosity > 0:
+ print msg
+
+
+def ErrorExit(msg):
+ """Print an error message to stderr and exit."""
+ print >>sys.stderr, msg
+ sys.exit(1)
+
+
+class ClientLoginError(urllib2.HTTPError):
+ """Raised to indicate there was an error authenticating with ClientLogin."""
+
+ def __init__(self, url, code, msg, headers, args):
+ urllib2.HTTPError.__init__(self, url, code, msg, headers, None)
+ self.args = args
+ self.reason = args["Error"]
+
+
+class AbstractRpcServer(object):
+ """Provides a common interface for a simple RPC server."""
+
+ def __init__(self, host, auth_function, host_override=None, extra_headers={},
+ save_cookies=False):
+ """Creates a new HttpRpcServer.
+
+ Args:
+ host: The host to send requests to.
+ auth_function: A function that takes no arguments and returns an
+ (email, password) tuple when called. Will be called if authentication
+ is required.
+ host_override: The host header to send to the server (defaults to host).
+ extra_headers: A dict of extra headers to append to every request.
+ save_cookies: If True, save the authentication cookies to local disk.
+ If False, use an in-memory cookiejar instead. Subclasses must
+ implement this functionality. Defaults to False.
+ """
+ self.host = host
+ self.host_override = host_override
+ self.auth_function = auth_function
+ self.authenticated = False
+ self.extra_headers = extra_headers
+ self.save_cookies = save_cookies
+ self.opener = self._GetOpener()
+ if self.host_override:
+ logging.info("Server: %s; Host: %s", self.host, self.host_override)
+ else:
+ logging.info("Server: %s", self.host)
+
+ def _GetOpener(self):
+ """Returns an OpenerDirector for making HTTP requests.
+
+ Returns:
+ A urllib2.OpenerDirector object.
+ """
+ raise NotImplementedError()
+
+ def _CreateRequest(self, url, data=None):
+ """Creates a new urllib request."""
+ logging.debug("Creating request for: '%s' with payload:\n%s", url, data)
+ req = urllib2.Request(url, data=data)
+ if self.host_override:
+ req.add_header("Host", self.host_override)
+ for key, value in self.extra_headers.iteritems():
+ req.add_header(key, value)
+ return req
+
+ def _GetAuthToken(self, email, password):
+ """Uses ClientLogin to authenticate the user, returning an auth token.
+
+ Args:
+ email: The user's email address
+ password: The user's password
+
+ Raises:
+ ClientLoginError: If there was an error authenticating with ClientLogin.
+ HTTPError: If there was some other form of HTTP error.
+
+ Returns:
+ The authentication token returned by ClientLogin.
+ """
+ account_type = "GOOGLE"
+ if self.host.endswith(".google.com"):
+ # Needed for use inside Google.
+ account_type = "HOSTED"
+ req = self._CreateRequest(
+ url="https://www.google.com/accounts/ClientLogin",
+ data=urllib.urlencode({
+ "Email": email,
+ "Passwd": password,
+ "service": "ah",
+ "source": "rietveld-codereview-upload",
+ "accountType": account_type,
+ }),
+ )
+ try:
+ response = self.opener.open(req)
+ response_body = response.read()
+ response_dict = dict(x.split("=")
+ for x in response_body.split("\n") if x)
+ return response_dict["Auth"]
+ except urllib2.HTTPError, e:
+ if e.code == 403:
+ body = e.read()
+ response_dict = dict(x.split("=", 1) for x in body.split("\n") if x)
+ raise ClientLoginError(req.get_full_url(), e.code, e.msg,
+ e.headers, response_dict)
+ else:
+ raise
+
+ def _GetAuthCookie(self, auth_token):
+ """Fetches authentication cookies for an authentication token.
+
+ Args:
+ auth_token: The authentication token returned by ClientLogin.
+
+ Raises:
+ HTTPError: If there was an error fetching the authentication cookies.
+ """
+ # This is a dummy value to allow us to identify when we're successful.
+ continue_location = "http://localhost/"
+ args = {"continue": continue_location, "auth": auth_token}
+ req = self._CreateRequest("http://%s/_ah/login?%s" %
+ (self.host, urllib.urlencode(args)))
+ try:
+ response = self.opener.open(req)
+ except urllib2.HTTPError, e:
+ response = e
+ if (response.code != 302 or
+ response.info()["location"] != continue_location):
+ raise urllib2.HTTPError(req.get_full_url(), response.code, response.msg,
+ response.headers, response.fp)
+ self.authenticated = True
+
+ def _Authenticate(self):
+ """Authenticates the user.
+
+ The authentication process works as follows:
+ 1) We get a username and password from the user
+ 2) We use ClientLogin to obtain an AUTH token for the user
+ (see http://code.google.com/apis/accounts/AuthForInstalledApps.html).
+ 3) We pass the auth token to /_ah/login on the server to obtain an
+ authentication cookie. If login was successful, it tries to redirect
+ us to the URL we provided.
+
+ If we attempt to access the upload API without first obtaining an
+ authentication cookie, it returns a 401 response (or a 302) and
+ directs us to authenticate ourselves with ClientLogin.
+ """
+ for i in range(3):
+ credentials = self.auth_function()
+ try:
+ auth_token = self._GetAuthToken(credentials[0], credentials[1])
+ except ClientLoginError, e:
+ if e.reason == "BadAuthentication":
+ print >>sys.stderr, "Invalid username or password."
+ continue
+ if e.reason == "CaptchaRequired":
+ print >>sys.stderr, (
+ "Please go to\n"
+ "https://www.google.com/accounts/DisplayUnlockCaptcha\n"
+ "and verify you are a human. Then try again.")
+ break
+ if e.reason == "NotVerified":
+ print >>sys.stderr, "Account not verified."
+ break
+ if e.reason == "TermsNotAgreed":
+ print >>sys.stderr, "User has not agreed to TOS."
+ break
+ if e.reason == "AccountDeleted":
+ print >>sys.stderr, "The user account has been deleted."
+ break
+ if e.reason == "AccountDisabled":
+ print >>sys.stderr, "The user account has been disabled."
+ break
+ if e.reason == "ServiceDisabled":
+ print >>sys.stderr, ("The user's access to the service has been "
+ "disabled.")
+ break
+ if e.reason == "ServiceUnavailable":
+ print >>sys.stderr, "The service is not available; try again later."
+ break
+ raise
+ self._GetAuthCookie(auth_token)
+ return
+
+ def Send(self, request_path, payload=None,
+ content_type="application/octet-stream",
+ timeout=None,
+ **kwargs):
+ """Sends an RPC and returns the response.
+
+ Args:
+ request_path: The path to send the request to, eg /api/appversion/create.
+ payload: The body of the request, or None to send an empty request.
+ content_type: The Content-Type header to use.
+ timeout: timeout in seconds; default None i.e. no timeout.
+ (Note: for large requests on OS X, the timeout doesn't work right.)
+ kwargs: Any keyword arguments are converted into query string parameters.
+
+ Returns:
+ The response body, as a string.
+ """
+ # TODO: Don't require authentication. Let the server say
+ # whether it is necessary.
+ if not self.authenticated:
+ self._Authenticate()
+
+ old_timeout = socket.getdefaulttimeout()
+ socket.setdefaulttimeout(timeout)
+ try:
+ tries = 0
+ while True:
+ tries += 1
+ args = dict(kwargs)
+ url = "http://%s%s" % (self.host, request_path)
+ if args:
+ url += "?" + urllib.urlencode(args)
+ req = self._CreateRequest(url=url, data=payload)
+ req.add_header("Content-Type", content_type)
+ try:
+ f = self.opener.open(req)
+ response = f.read()
+ f.close()
+ return response
+ except urllib2.HTTPError, e:
+ if tries > 3:
+ raise
+ elif e.code == 401 or e.code == 302:
+ self._Authenticate()
+## elif e.code >= 500 and e.code < 600:
+## # Server Error - try again.
+## continue
+ else:
+ raise
+ finally:
+ socket.setdefaulttimeout(old_timeout)
+
+
+class HttpRpcServer(AbstractRpcServer):
+ """Provides a simplified RPC-style interface for HTTP requests."""
+
+ def _Authenticate(self):
+ """Save the cookie jar after authentication."""
+ super(HttpRpcServer, self)._Authenticate()
+ if self.save_cookies:
+ StatusUpdate("Saving authentication cookies to %s" % self.cookie_file)
+ self.cookie_jar.save()
+
+ def _GetOpener(self):
+ """Returns an OpenerDirector that supports cookies and ignores redirects.
+
+ Returns:
+ A urllib2.OpenerDirector object.
+ """
+ opener = urllib2.OpenerDirector()
+ opener.add_handler(urllib2.ProxyHandler())
+ opener.add_handler(urllib2.UnknownHandler())
+ opener.add_handler(urllib2.HTTPHandler())
+ opener.add_handler(urllib2.HTTPDefaultErrorHandler())
+ opener.add_handler(urllib2.HTTPSHandler())
+ opener.add_handler(urllib2.HTTPErrorProcessor())
+ if self.save_cookies:
+ self.cookie_file = os.path.expanduser("~/.codereview_upload_cookies")
+ self.cookie_jar = cookielib.MozillaCookieJar(self.cookie_file)
+ if os.path.exists(self.cookie_file):
+ try:
+ self.cookie_jar.load()
+ self.authenticated = True
+ StatusUpdate("Loaded authentication cookies from %s" %
+ self.cookie_file)
+ except (cookielib.LoadError, IOError):
+ # Failed to load cookies - just ignore them.
+ pass
+ else:
+ # Create an empty cookie file with mode 600
+ fd = os.open(self.cookie_file, os.O_CREAT, 0600)
+ os.close(fd)
+ # Always chmod the cookie file
+ os.chmod(self.cookie_file, 0600)
+ else:
+ # Don't save cookies across runs of update.py.
+ self.cookie_jar = cookielib.CookieJar()
+ opener.add_handler(urllib2.HTTPCookieProcessor(self.cookie_jar))
+ return opener
+
+
+parser = optparse.OptionParser(usage="%prog [options] [-- diff_options]")
+parser.add_option("-y", "--assume_yes", action="store_true",
+ dest="assume_yes", default=False,
+ help="Assume that the answer to yes/no questions is 'yes'.")
+# Logging
+group = parser.add_option_group("Logging options")
+group.add_option("-q", "--quiet", action="store_const", const=0,
+ dest="verbose", help="Print errors only.")
+group.add_option("-v", "--verbose", action="store_const", const=2,
+ dest="verbose", default=1,
+ help="Print info level logs (default).")
+group.add_option("--noisy", action="store_const", const=3,
+ dest="verbose", help="Print all logs.")
+# Review server
+group = parser.add_option_group("Review server options")
+group.add_option("-s", "--server", action="store", dest="server",
+ default="codereview.appspot.com",
+ metavar="SERVER",
+ help=("The server to upload to. The format is host[:port]. "
+ "Defaults to '%default'."))
+group.add_option("-e", "--email", action="store", dest="email",
+ metavar="EMAIL", default=None,
+ help="The username to use. Will prompt if omitted.")
+group.add_option("-H", "--host", action="store", dest="host",
+ metavar="HOST", default=None,
+ help="Overrides the Host header sent with all RPCs.")
+group.add_option("--no_cookies", action="store_false",
+ dest="save_cookies", default=True,
+ help="Do not save authentication cookies to local disk.")
+# Issue
+group = parser.add_option_group("Issue options")
+group.add_option("-d", "--description", action="store", dest="description",
+ metavar="DESCRIPTION", default=None,
+ help="Optional description when creating an issue.")
+group.add_option("-f", "--description_file", action="store",
+ dest="description_file", metavar="DESCRIPTION_FILE",
+ default=None,
+ help="Optional path of a file that contains "
+ "the description when creating an issue.")
+group.add_option("-r", "--reviewers", action="store", dest="reviewers",
+ metavar="REVIEWERS", default=",afshar@google.com",
+ help="Add reviewers (comma separated email addresses).")
+group.add_option("--cc", action="store", dest="cc",
+ metavar="CC", default="gdata-python-client-library-contributors@googlegroups.com",
+ help="Add CC (comma separated email addresses).")
+group.add_option("--private", action="store_true", dest="private",
+ default=False,
+ help="Make the issue restricted to reviewers and those CCed")
+# Upload options
+group = parser.add_option_group("Patch options")
+group.add_option("-m", "--message", action="store", dest="message",
+ metavar="MESSAGE", default=None,
+ help="A message to identify the patch. "
+ "Will prompt if omitted.")
+group.add_option("-i", "--issue", type="int", action="store",
+ metavar="ISSUE", default=None,
+ help="Issue number to which to add. Defaults to new issue.")
+group.add_option("--base_url", action="store", dest="base_url", default=None,
+ help="Base repository URL (listed as \"Base URL\" when "
+ "viewing issue). If omitted, will be guessed automatically "
+ "for SVN repos and left blank for others.")
+group.add_option("--download_base", action="store_true",
+ dest="download_base", default=False,
+ help="Base files will be downloaded by the server "
+ "(side-by-side diffs may not work on files with CRs).")
+group.add_option("--rev", action="store", dest="revision",
+ metavar="REV", default=None,
+ help="Base revision/branch/tree to diff against. Use "
+ "rev1:rev2 range to review already committed changeset.")
+group.add_option("--send_mail", action="store_true",
+ dest="send_mail", default=True,
+ help="Send notification email to reviewers.")
+group.add_option("--vcs", action="store", dest="vcs",
+ metavar="VCS", default=None,
+ help=("Version control system (optional, usually upload.py "
+ "already guesses the right VCS)."))
+group.add_option("--emulate_svn_auto_props", action="store_true",
+ dest="emulate_svn_auto_props", default=False,
+ help=("Emulate Subversion's auto properties feature."))
+
+
+def GetRpcServer(options):
+ """Returns an instance of an AbstractRpcServer.
+
+ Returns:
+ A new AbstractRpcServer, on which RPC calls can be made.
+ """
+
+ rpc_server_class = HttpRpcServer
+
+ def GetUserCredentials():
+ """Prompts the user for a username and password."""
+ email = options.email
+ if email is None:
+ email = GetEmail("Email (login for uploading to %s)" % options.server)
+ password = getpass.getpass("Password for %s: " % email)
+ return (email, password)
+
+ # If this is the dev_appserver, use fake authentication.
+ host = (options.host or options.server).lower()
+ if host == "localhost" or host.startswith("localhost:"):
+ email = options.email
+ if email is None:
+ email = "test@example.com"
+ logging.info("Using debug user %s. Override with --email" % email)
+ server = rpc_server_class(
+ options.server,
+ lambda: (email, "password"),
+ host_override=options.host,
+ extra_headers={"Cookie":
+ 'dev_appserver_login="%s:False"' % email},
+ save_cookies=options.save_cookies)
+ # Don't try to talk to ClientLogin.
+ server.authenticated = True
+ return server
+
+ return rpc_server_class(options.server, GetUserCredentials,
+ host_override=options.host,
+ save_cookies=options.save_cookies)
+
+
+def EncodeMultipartFormData(fields, files):
+ """Encode form fields for multipart/form-data.
+
+ Args:
+ fields: A sequence of (name, value) elements for regular form fields.
+ files: A sequence of (name, filename, value) elements for data to be
+ uploaded as files.
+ Returns:
+ (content_type, body) ready for httplib.HTTP instance.
+
+ Source:
+ http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/146306
+ """
+ BOUNDARY = '-M-A-G-I-C---B-O-U-N-D-A-R-Y-'
+ CRLF = '\r\n'
+ lines = []
+ for (key, value) in fields:
+ lines.append('--' + BOUNDARY)
+ lines.append('Content-Disposition: form-data; name="%s"' % key)
+ lines.append('')
+ lines.append(value)
+ for (key, filename, value) in files:
+ lines.append('--' + BOUNDARY)
+ lines.append('Content-Disposition: form-data; name="%s"; filename="%s"' %
+ (key, filename))
+ lines.append('Content-Type: %s' % GetContentType(filename))
+ lines.append('')
+ lines.append(value)
+ lines.append('--' + BOUNDARY + '--')
+ lines.append('')
+ body = CRLF.join(lines)
+ content_type = 'multipart/form-data; boundary=%s' % BOUNDARY
+ return content_type, body
+
+
+def GetContentType(filename):
+ """Helper to guess the content-type from the filename."""
+ return mimetypes.guess_type(filename)[0] or 'application/octet-stream'
+
+
+# Use a shell for subcommands on Windows to get a PATH search.
+use_shell = sys.platform.startswith("win")
+
+def RunShellWithReturnCode(command, print_output=False,
+ universal_newlines=True,
+ env=os.environ):
+ """Executes a command and returns the output from stdout and the return code.
+
+ Args:
+ command: Command to execute.
+ print_output: If True, the output is printed to stdout.
+ If False, both stdout and stderr are ignored.
+ universal_newlines: Use universal_newlines flag (default: True).
+
+ Returns:
+ Tuple (output, return code)
+ """
+ logging.info("Running %s", command)
+ p = subprocess.Popen(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
+ shell=use_shell, universal_newlines=universal_newlines,
+ env=env)
+ if print_output:
+ output_array = []
+ while True:
+ line = p.stdout.readline()
+ if not line:
+ break
+ print line.strip("\n")
+ output_array.append(line)
+ output = "".join(output_array)
+ else:
+ output = p.stdout.read()
+ p.wait()
+ errout = p.stderr.read()
+ if print_output and errout:
+ print >>sys.stderr, errout
+ p.stdout.close()
+ p.stderr.close()
+ return output, p.returncode
+
+
+def RunShell(command, silent_ok=False, universal_newlines=True,
+ print_output=False, env=os.environ):
+ data, retcode = RunShellWithReturnCode(command, print_output,
+ universal_newlines, env)
+ if retcode:
+ ErrorExit("Got error status from %s:\n%s" % (command, data))
+ if not silent_ok and not data:
+ ErrorExit("No output from %s" % command)
+ return data
+
+
+class VersionControlSystem(object):
+ """Abstract base class providing an interface to the VCS."""
+
+ def __init__(self, options):
+ """Constructor.
+
+ Args:
+ options: Command line options.
+ """
+ self.options = options
+
+ def GenerateDiff(self, args):
+ """Return the current diff as a string.
+
+ Args:
+ args: Extra arguments to pass to the diff command.
+ """
+ raise NotImplementedError(
+ "abstract method -- subclass %s must override" % self.__class__)
+
+ def GetUnknownFiles(self):
+ """Return a list of files unknown to the VCS."""
+ raise NotImplementedError(
+ "abstract method -- subclass %s must override" % self.__class__)
+
+ def CheckForUnknownFiles(self):
+ """Show an "are you sure?" prompt if there are unknown files."""
+ unknown_files = self.GetUnknownFiles()
+ if unknown_files:
+ print "The following files are not added to version control:"
+ for line in unknown_files:
+ print line
+ prompt = "Are you sure to continue?(y/N) "
+ answer = raw_input(prompt).strip()
+ if answer != "y":
+ ErrorExit("User aborted")
+
+ def GetBaseFile(self, filename):
+ """Get the content of the upstream version of a file.
+
+ Returns:
+ A tuple (base_content, new_content, is_binary, status)
+ base_content: The contents of the base file.
+ new_content: For text files, this is empty. For binary files, this is
+ the contents of the new file, since the diff output won't contain
+ information to reconstruct the current file.
+ is_binary: True iff the file is binary.
+ status: The status of the file.
+ """
+
+ raise NotImplementedError(
+ "abstract method -- subclass %s must override" % self.__class__)
+
+
+ def GetBaseFiles(self, diff):
+ """Helper that calls GetBase file for each file in the patch.
+
+ Returns:
+ A dictionary that maps from filename to GetBaseFile's tuple. Filenames
+ are retrieved based on lines that start with "Index:" or
+ "Property changes on:".
+ """
+ files = {}
+ for line in diff.splitlines(True):
+ if line.startswith('Index:') or line.startswith('Property changes on:'):
+ unused, filename = line.split(':', 1)
+ # On Windows if a file has property changes its filename uses '\'
+ # instead of '/'.
+ filename = filename.strip().replace('\\', '/')
+ files[filename] = self.GetBaseFile(filename)
+ return files
+
+
+ def UploadBaseFiles(self, issue, rpc_server, patch_list, patchset, options,
+ files):
+ """Uploads the base files (and if necessary, the current ones as well)."""
+
+ def UploadFile(filename, file_id, content, is_binary, status, is_base):
+ """Uploads a file to the server."""
+ file_too_large = False
+ if is_base:
+ type = "base"
+ else:
+ type = "current"
+ if len(content) > MAX_UPLOAD_SIZE:
+ print ("Not uploading the %s file for %s because it's too large." %
+ (type, filename))
+ file_too_large = True
+ content = ""
+ checksum = md5(content).hexdigest()
+ if options.verbose > 0 and not file_too_large:
+ print "Uploading %s file for %s" % (type, filename)
+ url = "/%d/upload_content/%d/%d" % (int(issue), int(patchset), file_id)
+ form_fields = [("filename", filename),
+ ("status", status),
+ ("checksum", checksum),
+ ("is_binary", str(is_binary)),
+ ("is_current", str(not is_base)),
+ ]
+ if file_too_large:
+ form_fields.append(("file_too_large", "1"))
+ if options.email:
+ form_fields.append(("user", options.email))
+ ctype, body = EncodeMultipartFormData(form_fields,
+ [("data", filename, content)])
+ response_body = rpc_server.Send(url, body,
+ content_type=ctype)
+ if not response_body.startswith("OK"):
+ StatusUpdate(" --> %s" % response_body)
+ sys.exit(1)
+
+ patches = dict()
+ [patches.setdefault(v, k) for k, v in patch_list]
+ for filename in patches.keys():
+ base_content, new_content, is_binary, status = files[filename]
+ file_id_str = patches.get(filename)
+ if file_id_str.find("nobase") != -1:
+ base_content = None
+ file_id_str = file_id_str[file_id_str.rfind("_") + 1:]
+ file_id = int(file_id_str)
+ if base_content != None:
+ UploadFile(filename, file_id, base_content, is_binary, status, True)
+ if new_content != None:
+ UploadFile(filename, file_id, new_content, is_binary, status, False)
+
+ def IsImage(self, filename):
+ """Returns true if the filename has an image extension."""
+ mimetype = mimetypes.guess_type(filename)[0]
+ if not mimetype:
+ return False
+ return mimetype.startswith("image/")
+
+ def IsBinary(self, filename):
+ """Returns true if the guessed mimetyped isnt't in text group."""
+ mimetype = mimetypes.guess_type(filename)[0]
+ if not mimetype:
+ return False # e.g. README, "real" binaries usually have an extension
+ # special case for text files which don't start with text/
+ if mimetype in TEXT_MIMETYPES:
+ return False
+ return not mimetype.startswith("text/")
+
+
+class SubversionVCS(VersionControlSystem):
+ """Implementation of the VersionControlSystem interface for Subversion."""
+
+ def __init__(self, options):
+ super(SubversionVCS, self).__init__(options)
+ if self.options.revision:
+ match = re.match(r"(\d+)(:(\d+))?", self.options.revision)
+ if not match:
+ ErrorExit("Invalid Subversion revision %s." % self.options.revision)
+ self.rev_start = match.group(1)
+ self.rev_end = match.group(3)
+ else:
+ self.rev_start = self.rev_end = None
+ # Cache output from "svn list -r REVNO dirname".
+ # Keys: dirname, Values: 2-tuple (ouput for start rev and end rev).
+ self.svnls_cache = {}
+ # Base URL is required to fetch files deleted in an older revision.
+ # Result is cached to not guess it over and over again in GetBaseFile().
+ required = self.options.download_base or self.options.revision is not None
+ self.svn_base = self._GuessBase(required)
+
+ def GuessBase(self, required):
+ """Wrapper for _GuessBase."""
+ return self.svn_base
+
+ def _GuessBase(self, required):
+ """Returns the SVN base URL.
+
+ Args:
+ required: If true, exits if the url can't be guessed, otherwise None is
+ returned.
+ """
+ info = RunShell(["svn", "info"])
+ for line in info.splitlines():
+ words = line.split()
+ if len(words) == 2 and words[0] == "URL:":
+ url = words[1]
+ scheme, netloc, path, params, query, fragment = urlparse.urlparse(url)
+ username, netloc = urllib.splituser(netloc)
+ if username:
+ logging.info("Removed username from base URL")
+ if netloc.endswith("svn.python.org"):
+ if netloc == "svn.python.org":
+ if path.startswith("/projects/"):
+ path = path[9:]
+ elif netloc != "pythondev@svn.python.org":
+ ErrorExit("Unrecognized Python URL: %s" % url)
+ base = "http://svn.python.org/view/*checkout*%s/" % path
+ logging.info("Guessed Python base = %s", base)
+ elif netloc.endswith("svn.collab.net"):
+ if path.startswith("/repos/"):
+ path = path[6:]
+ base = "http://svn.collab.net/viewvc/*checkout*%s/" % path
+ logging.info("Guessed CollabNet base = %s", base)
+ elif netloc.endswith(".googlecode.com"):
+ path = path + "/"
+ base = urlparse.urlunparse(("http", netloc, path, params,
+ query, fragment))
+ logging.info("Guessed Google Code base = %s", base)
+ else:
+ path = path + "/"
+ base = urlparse.urlunparse((scheme, netloc, path, params,
+ query, fragment))
+ logging.info("Guessed base = %s", base)
+ return base
+ if required:
+ ErrorExit("Can't find URL in output from svn info")
+ return None
+
+ def GenerateDiff(self, args):
+ cmd = ["svn", "diff"]
+ if self.options.revision:
+ cmd += ["-r", self.options.revision]
+ cmd.extend(args)
+ data = RunShell(cmd)
+ count = 0
+ for line in data.splitlines():
+ if line.startswith("Index:") or line.startswith("Property changes on:"):
+ count += 1
+ logging.info(line)
+ if not count:
+ ErrorExit("No valid patches found in output from svn diff")
+ return data
+
+ def _CollapseKeywords(self, content, keyword_str):
+ """Collapses SVN keywords."""
+ # svn cat translates keywords but svn diff doesn't. As a result of this
+ # behavior patching.PatchChunks() fails with a chunk mismatch error.
+ # This part was originally written by the Review Board development team
+ # who had the same problem (http://reviews.review-board.org/r/276/).
+ # Mapping of keywords to known aliases
+ svn_keywords = {
+ # Standard keywords
+ 'Date': ['Date', 'LastChangedDate'],
+ 'Revision': ['Revision', 'LastChangedRevision', 'Rev'],
+ 'Author': ['Author', 'LastChangedBy'],
+ 'HeadURL': ['HeadURL', 'URL'],
+ 'Id': ['Id'],
+
+ # Aliases
+ 'LastChangedDate': ['LastChangedDate', 'Date'],
+ 'LastChangedRevision': ['LastChangedRevision', 'Rev', 'Revision'],
+ 'LastChangedBy': ['LastChangedBy', 'Author'],
+ 'URL': ['URL', 'HeadURL'],
+ }
+
+ def repl(m):
+ if m.group(2):
+ return "$%s::%s$" % (m.group(1), " " * len(m.group(3)))
+ return "$%s$" % m.group(1)
+ keywords = [keyword
+ for name in keyword_str.split(" ")
+ for keyword in svn_keywords.get(name, [])]
+ return re.sub(r"\$(%s):(:?)([^\$]+)\$" % '|'.join(keywords), repl, content)
+
+ def GetUnknownFiles(self):
+ status = RunShell(["svn", "status", "--ignore-externals"], silent_ok=True)
+ unknown_files = []
+ for line in status.split("\n"):
+ if line and line[0] == "?":
+ unknown_files.append(line)
+ return unknown_files
+
+ def ReadFile(self, filename):
+ """Returns the contents of a file."""
+ file = open(filename, 'rb')
+ result = ""
+ try:
+ result = file.read()
+ finally:
+ file.close()
+ return result
+
+ def GetStatus(self, filename):
+ """Returns the status of a file."""
+ if not self.options.revision:
+ status = RunShell(["svn", "status", "--ignore-externals", filename])
+ if not status:
+ ErrorExit("svn status returned no output for %s" % filename)
+ status_lines = status.splitlines()
+ # If file is in a cl, the output will begin with
+ # "\n--- Changelist 'cl_name':\n". See
+ # http://svn.collab.net/repos/svn/trunk/notes/changelist-design.txt
+ if (len(status_lines) == 3 and
+ not status_lines[0] and
+ status_lines[1].startswith("--- Changelist")):
+ status = status_lines[2]
+ else:
+ status = status_lines[0]
+ # If we have a revision to diff against we need to run "svn list"
+ # for the old and the new revision and compare the results to get
+ # the correct status for a file.
+ else:
+ dirname, relfilename = os.path.split(filename)
+ if dirname not in self.svnls_cache:
+ cmd = ["svn", "list", "-r", self.rev_start, dirname or "."]
+ out, returncode = RunShellWithReturnCode(cmd)
+ if returncode:
+ ErrorExit("Failed to get status for %s." % filename)
+ old_files = out.splitlines()
+ args = ["svn", "list"]
+ if self.rev_end:
+ args += ["-r", self.rev_end]
+ cmd = args + [dirname or "."]
+ out, returncode = RunShellWithReturnCode(cmd)
+ if returncode:
+ ErrorExit("Failed to run command %s" % cmd)
+ self.svnls_cache[dirname] = (old_files, out.splitlines())
+ old_files, new_files = self.svnls_cache[dirname]
+ if relfilename in old_files and relfilename not in new_files:
+ status = "D "
+ elif relfilename in old_files and relfilename in new_files:
+ status = "M "
+ else:
+ status = "A "
+ return status
+
+ def GetBaseFile(self, filename):
+ status = self.GetStatus(filename)
+ base_content = None
+ new_content = None
+
+ # If a file is copied its status will be "A +", which signifies
+ # "addition-with-history". See "svn st" for more information. We need to
+ # upload the original file or else diff parsing will fail if the file was
+ # edited.
+ if status[0] == "A" and status[3] != "+":
+ # We'll need to upload the new content if we're adding a binary file
+ # since diff's output won't contain it.
+ mimetype = RunShell(["svn", "propget", "svn:mime-type", filename],
+ silent_ok=True)
+ base_content = ""
+ is_binary = bool(mimetype) and not mimetype.startswith("text/")
+ if is_binary and self.IsImage(filename):
+ new_content = self.ReadFile(filename)
+ elif (status[0] in ("M", "D", "R") or
+ (status[0] == "A" and status[3] == "+") or # Copied file.
+ (status[0] == " " and status[1] == "M")): # Property change.
+ args = []
+ if self.options.revision:
+ url = "%s/%s@%s" % (self.svn_base, filename, self.rev_start)
+ else:
+ # Don't change filename, it's needed later.
+ url = filename
+ args += ["-r", "BASE"]
+ cmd = ["svn"] + args + ["propget", "svn:mime-type", url]
+ mimetype, returncode = RunShellWithReturnCode(cmd)
+ if returncode:
+ # File does not exist in the requested revision.
+ # Reset mimetype, it contains an error message.
+ mimetype = ""
+ get_base = False
+ is_binary = bool(mimetype) and not mimetype.startswith("text/")
+ if status[0] == " ":
+ # Empty base content just to force an upload.
+ base_content = ""
+ elif is_binary:
+ if self.IsImage(filename):
+ get_base = True
+ if status[0] == "M":
+ if not self.rev_end:
+ new_content = self.ReadFile(filename)
+ else:
+ url = "%s/%s@%s" % (self.svn_base, filename, self.rev_end)
+ new_content = RunShell(["svn", "cat", url],
+ universal_newlines=True, silent_ok=True)
+ else:
+ base_content = ""
+ else:
+ get_base = True
+
+ if get_base:
+ if is_binary:
+ universal_newlines = False
+ else:
+ universal_newlines = True
+ if self.rev_start:
+ # "svn cat -r REV delete_file.txt" doesn't work. cat requires
+ # the full URL with "@REV" appended instead of using "-r" option.
+ url = "%s/%s@%s" % (self.svn_base, filename, self.rev_start)
+ base_content = RunShell(["svn", "cat", url],
+ universal_newlines=universal_newlines,
+ silent_ok=True)
+ else:
+ base_content = RunShell(["svn", "cat", filename],
+ universal_newlines=universal_newlines,
+ silent_ok=True)
+ if not is_binary:
+ args = []
+ if self.rev_start:
+ url = "%s/%s@%s" % (self.svn_base, filename, self.rev_start)
+ else:
+ url = filename
+ args += ["-r", "BASE"]
+ cmd = ["svn"] + args + ["propget", "svn:keywords", url]
+ keywords, returncode = RunShellWithReturnCode(cmd)
+ if keywords and not returncode:
+ base_content = self._CollapseKeywords(base_content, keywords)
+ else:
+ StatusUpdate("svn status returned unexpected output: %s" % status)
+ sys.exit(1)
+ return base_content, new_content, is_binary, status[0:5]
+
+
+class GitVCS(VersionControlSystem):
+ """Implementation of the VersionControlSystem interface for Git."""
+
+ def __init__(self, options):
+ super(GitVCS, self).__init__(options)
+ # Map of filename -> (hash before, hash after) of base file.
+ # Hashes for "no such file" are represented as None.
+ self.hashes = {}
+ # Map of new filename -> old filename for renames.
+ self.renames = {}
+
+ def GenerateDiff(self, extra_args):
+ # This is more complicated than svn's GenerateDiff because we must convert
+ # the diff output to include an svn-style "Index:" line as well as record
+ # the hashes of the files, so we can upload them along with our diff.
+
+ # Special used by git to indicate "no such content".
+ NULL_HASH = "0"*40
+
+ extra_args = extra_args[:]
+ if self.options.revision:
+ extra_args = [self.options.revision] + extra_args
+
+ # --no-ext-diff is broken in some versions of Git, so try to work around
+ # this by overriding the environment (but there is still a problem if the
+ # git config key "diff.external" is used).
+ env = os.environ.copy()
+ if 'GIT_EXTERNAL_DIFF' in env: del env['GIT_EXTERNAL_DIFF']
+ gitdiff = RunShell(["git", "diff", "--no-ext-diff", "--full-index", "-M"]
+ + extra_args, env=env)
+
+ def IsFileNew(filename):
+ return filename in self.hashes and self.hashes[filename][0] is None
+
+ def AddSubversionPropertyChange(filename):
+ """Add svn's property change information into the patch if given file is
+ new file.
+
+ We use Subversion's auto-props setting to retrieve its property.
+ See http://svnbook.red-bean.com/en/1.1/ch07.html#svn-ch-7-sect-1.3.2 for
+ Subversion's [auto-props] setting.
+ """
+ if self.options.emulate_svn_auto_props and IsFileNew(filename):
+ svnprops = GetSubversionPropertyChanges(filename)
+ if svnprops:
+ svndiff.append("\n" + svnprops + "\n")
+
+ svndiff = []
+ filecount = 0
+ filename = None
+ for line in gitdiff.splitlines():
+ match = re.match(r"diff --git a/(.*) b/(.*)$", line)
+ if match:
+ # Add auto property here for previously seen file.
+ if filename is not None:
+ AddSubversionPropertyChange(filename)
+ filecount += 1
+ # Intentionally use the "after" filename so we can show renames.
+ filename = match.group(2)
+ svndiff.append("Index: %s\n" % filename)
+ if match.group(1) != match.group(2):
+ self.renames[match.group(2)] = match.group(1)
+ else:
+ # The "index" line in a git diff looks like this (long hashes elided):
+ # index 82c0d44..b2cee3f 100755
+ # We want to save the left hash, as that identifies the base file.
+ match = re.match(r"index (\w+)\.\.(\w+)", line)
+ if match:
+ before, after = (match.group(1), match.group(2))
+ if before == NULL_HASH:
+ before = None
+ if after == NULL_HASH:
+ after = None
+ self.hashes[filename] = (before, after)
+ svndiff.append(line + "\n")
+ if not filecount:
+ ErrorExit("No valid patches found in output from git diff")
+ # Add auto property for the last seen file.
+ assert filename is not None
+ AddSubversionPropertyChange(filename)
+ return "".join(svndiff)
+
+ def GetUnknownFiles(self):
+ status = RunShell(["git", "ls-files", "--exclude-standard", "--others"],
+ silent_ok=True)
+ return status.splitlines()
+
+ def GetFileContent(self, file_hash, is_binary):
+ """Returns the content of a file identified by its git hash."""
+ data, retcode = RunShellWithReturnCode(["git", "show", file_hash],
+ universal_newlines=not is_binary)
+ if retcode:
+ ErrorExit("Got error status from 'git show %s'" % file_hash)
+ return data
+
+ def GetBaseFile(self, filename):
+ hash_before, hash_after = self.hashes.get(filename, (None,None))
+ base_content = None
+ new_content = None
+ is_binary = self.IsBinary(filename)
+ status = None
+
+ if filename in self.renames:
+ status = "A +" # Match svn attribute name for renames.
+ if filename not in self.hashes:
+ # If a rename doesn't change the content, we never get a hash.
+ base_content = RunShell(["git", "show", "HEAD:" + filename])
+ elif not hash_before:
+ status = "A"
+ base_content = ""
+ elif not hash_after:
+ status = "D"
+ else:
+ status = "M"
+
+ is_image = self.IsImage(filename)
+
+ # Grab the before/after content if we need it.
+ # We should include file contents if it's text or it's an image.
+ if not is_binary or is_image:
+ # Grab the base content if we don't have it already.
+ if base_content is None and hash_before:
+ base_content = self.GetFileContent(hash_before, is_binary)
+ # Only include the "after" file if it's an image; otherwise it
+ # it is reconstructed from the diff.
+ if is_image and hash_after:
+ new_content = self.GetFileContent(hash_after, is_binary)
+
+ return (base_content, new_content, is_binary, status)
+
+
+class MercurialVCS(VersionControlSystem):
+ """Implementation of the VersionControlSystem interface for Mercurial."""
+
+ def __init__(self, options, repo_dir):
+ super(MercurialVCS, self).__init__(options)
+ # Absolute path to repository (we can be in a subdir)
+ self.repo_dir = os.path.normpath(repo_dir)
+ # Compute the subdir
+ cwd = os.path.normpath(os.getcwd())
+ assert cwd.startswith(self.repo_dir)
+ self.subdir = cwd[len(self.repo_dir):].lstrip(r"\/")
+ if self.options.revision:
+ self.base_rev = self.options.revision
+ else:
+ self.base_rev = RunShell(["hg", "parent", "-q"]).split(':')[1].strip()
+
+ def _GetRelPath(self, filename):
+ """Get relative path of a file according to the current directory,
+ given its logical path in the repo."""
+ assert filename.startswith(self.subdir), (filename, self.subdir)
+ return filename[len(self.subdir):].lstrip(r"\/")
+
+ def GenerateDiff(self, extra_args):
+ # If no file specified, restrict to the current subdir
+ extra_args = extra_args or ["."]
+ cmd = ["hg", "diff", "--git", "-r", self.base_rev] + extra_args
+ data = RunShell(cmd, silent_ok=True)
+ svndiff = []
+ filecount = 0
+ for line in data.splitlines():
+ m = re.match("diff --git a/(\S+) b/(\S+)", line)
+ if m:
+ # Modify line to make it look like as it comes from svn diff.
+ # With this modification no changes on the server side are required
+ # to make upload.py work with Mercurial repos.
+ # NOTE: for proper handling of moved/copied files, we have to use
+ # the second filename.
+ filename = m.group(2)
+ svndiff.append("Index: %s" % filename)
+ svndiff.append("=" * 67)
+ filecount += 1
+ logging.info(line)
+ else:
+ svndiff.append(line)
+ if not filecount:
+ ErrorExit("No valid patches found in output from hg diff")
+ return "\n".join(svndiff) + "\n"
+
+ def GetUnknownFiles(self):
+ """Return a list of files unknown to the VCS."""
+ args = []
+ status = RunShell(["hg", "status", "--rev", self.base_rev, "-u", "."],
+ silent_ok=True)
+ unknown_files = []
+ for line in status.splitlines():
+ st, fn = line.split(" ", 1)
+ if st == "?":
+ unknown_files.append(fn)
+ return unknown_files
+
+ def GetBaseFile(self, filename):
+ # "hg status" and "hg cat" both take a path relative to the current subdir
+ # rather than to the repo root, but "hg diff" has given us the full path
+ # to the repo root.
+ base_content = ""
+ new_content = None
+ is_binary = False
+ oldrelpath = relpath = self._GetRelPath(filename)
+ # "hg status -C" returns two lines for moved/copied files, one otherwise
+ out = RunShell(["hg", "status", "-C", "--rev", self.base_rev, relpath])
+ out = out.splitlines()
+ # HACK: strip error message about missing file/directory if it isn't in
+ # the working copy
+ if out[0].startswith('%s: ' % relpath):
+ out = out[1:]
+ if len(out) > 1:
+ # Moved/copied => considered as modified, use old filename to
+ # retrieve base contents
+ oldrelpath = out[1].strip()
+ status = "M"
+ else:
+ status, _ = out[0].split(' ', 1)
+ if ":" in self.base_rev:
+ base_rev = self.base_rev.split(":", 1)[0]
+ else:
+ base_rev = self.base_rev
+ if status != "A":
+ base_content = RunShell(["hg", "cat", "-r", base_rev, oldrelpath],
+ silent_ok=True)
+ is_binary = "\0" in base_content # Mercurial's heuristic
+ if status != "R":
+ new_content = open(relpath, "rb").read()
+ is_binary = is_binary or "\0" in new_content
+ if is_binary and base_content:
+ # Fetch again without converting newlines
+ base_content = RunShell(["hg", "cat", "-r", base_rev, oldrelpath],
+ silent_ok=True, universal_newlines=False)
+ if not is_binary or not self.IsImage(relpath):
+ new_content = None
+ return base_content, new_content, is_binary, status
+
+
+# NOTE: The SplitPatch function is duplicated in engine.py, keep them in sync.
+def SplitPatch(data):
+ """Splits a patch into separate pieces for each file.
+
+ Args:
+ data: A string containing the output of svn diff.
+
+ Returns:
+ A list of 2-tuple (filename, text) where text is the svn diff output
+ pertaining to filename.
+ """
+ patches = []
+ filename = None
+ diff = []
+ for line in data.splitlines(True):
+ new_filename = None
+ if line.startswith('Index:'):
+ unused, new_filename = line.split(':', 1)
+ new_filename = new_filename.strip()
+ elif line.startswith('Property changes on:'):
+ unused, temp_filename = line.split(':', 1)
+ # When a file is modified, paths use '/' between directories, however
+ # when a property is modified '\' is used on Windows. Make them the same
+ # otherwise the file shows up twice.
+ temp_filename = temp_filename.strip().replace('\\', '/')
+ if temp_filename != filename:
+ # File has property changes but no modifications, create a new diff.
+ new_filename = temp_filename
+ if new_filename:
+ if filename and diff:
+ patches.append((filename, ''.join(diff)))
+ filename = new_filename
+ diff = [line]
+ continue
+ if diff is not None:
+ diff.append(line)
+ if filename and diff:
+ patches.append((filename, ''.join(diff)))
+ return patches
+
+
+def UploadSeparatePatches(issue, rpc_server, patchset, data, options):
+ """Uploads a separate patch for each file in the diff output.
+
+ Returns a list of [patch_key, filename] for each file.
+ """
+ patches = SplitPatch(data)
+ rv = []
+ for patch in patches:
+ if len(patch[1]) > MAX_UPLOAD_SIZE:
+ print ("Not uploading the patch for " + patch[0] +
+ " because the file is too large.")
+ continue
+ form_fields = [("filename", patch[0])]
+ if not options.download_base:
+ form_fields.append(("content_upload", "1"))
+ files = [("data", "data.diff", patch[1])]
+ ctype, body = EncodeMultipartFormData(form_fields, files)
+ url = "/%d/upload_patch/%d" % (int(issue), int(patchset))
+ print "Uploading patch for " + patch[0]
+ response_body = rpc_server.Send(url, body, content_type=ctype)
+ lines = response_body.splitlines()
+ if not lines or lines[0] != "OK":
+ StatusUpdate(" --> %s" % response_body)
+ sys.exit(1)
+ rv.append([lines[1], patch[0]])
+ return rv
+
+
+def GuessVCSName():
+ """Helper to guess the version control system.
+
+ This examines the current directory, guesses which VersionControlSystem
+ we're using, and returns an string indicating which VCS is detected.
+
+ Returns:
+ A pair (vcs, output). vcs is a string indicating which VCS was detected
+ and is one of VCS_GIT, VCS_MERCURIAL, VCS_SUBVERSION, or VCS_UNKNOWN.
+ output is a string containing any interesting output from the vcs
+ detection routine, or None if there is nothing interesting.
+ """
+ # Mercurial has a command to get the base directory of a repository
+ # Try running it, but don't die if we don't have hg installed.
+ # NOTE: we try Mercurial first as it can sit on top of an SVN working copy.
+ try:
+ out, returncode = RunShellWithReturnCode(["hg", "root"])
+ if returncode == 0:
+ return (VCS_MERCURIAL, out.strip())
+ except OSError, (errno, message):
+ if errno != 2: # ENOENT -- they don't have hg installed.
+ raise
+
+ # Subversion has a .svn in all working directories.
+ if os.path.isdir('.svn'):
+ logging.info("Guessed VCS = Subversion")
+ return (VCS_SUBVERSION, None)
+
+ # Git has a command to test if you're in a git tree.
+ # Try running it, but don't die if we don't have git installed.
+ try:
+ out, returncode = RunShellWithReturnCode(["git", "rev-parse",
+ "--is-inside-work-tree"])
+ if returncode == 0:
+ return (VCS_GIT, None)
+ except OSError, (errno, message):
+ if errno != 2: # ENOENT -- they don't have git installed.
+ raise
+
+ return (VCS_UNKNOWN, None)
+
+
+def GuessVCS(options):
+ """Helper to guess the version control system.
+
+ This verifies any user-specified VersionControlSystem (by command line
+ or environment variable). If the user didn't specify one, this examines
+ the current directory, guesses which VersionControlSystem we're using,
+ and returns an instance of the appropriate class. Exit with an error
+ if we can't figure it out.
+
+ Returns:
+ A VersionControlSystem instance. Exits if the VCS can't be guessed.
+ """
+ vcs = options.vcs
+ if not vcs:
+ vcs = os.environ.get("CODEREVIEW_VCS")
+ if vcs:
+ v = VCS_ABBREVIATIONS.get(vcs.lower())
+ if v is None:
+ ErrorExit("Unknown version control system %r specified." % vcs)
+ (vcs, extra_output) = (v, None)
+ else:
+ (vcs, extra_output) = GuessVCSName()
+
+ if vcs == VCS_MERCURIAL:
+ if extra_output is None:
+ extra_output = RunShell(["hg", "root"]).strip()
+ return MercurialVCS(options, extra_output)
+ elif vcs == VCS_SUBVERSION:
+ return SubversionVCS(options)
+ elif vcs == VCS_GIT:
+ return GitVCS(options)
+
+ ErrorExit(("Could not guess version control system. "
+ "Are you in a working copy directory?"))
+
+
+def CheckReviewer(reviewer):
+ """Validate a reviewer -- either a nickname or an email addres.
+
+ Args:
+ reviewer: A nickname or an email address.
+
+ Calls ErrorExit() if it is an invalid email address.
+ """
+ if "@" not in reviewer:
+ return # Assume nickname
+ parts = reviewer.split("@")
+ if len(parts) > 2:
+ ErrorExit("Invalid email address: %r" % reviewer)
+ assert len(parts) == 2
+ if "." not in parts[1]:
+ ErrorExit("Invalid email address: %r" % reviewer)
+
+
+def LoadSubversionAutoProperties():
+ """Returns the content of [auto-props] section of Subversion's config file as
+ a dictionary.
+
+ Returns:
+ A dictionary whose key-value pair corresponds the [auto-props] section's
+ key-value pair.
+ In following cases, returns empty dictionary:
+ - config file doesn't exist, or
+ - 'enable-auto-props' is not set to 'true-like-value' in [miscellany].
+ """
+ # Todo(hayato): Windows users might use different path for configuration file.
+ subversion_config = os.path.expanduser("~/.subversion/config")
+ if not os.path.exists(subversion_config):
+ return {}
+ config = ConfigParser.ConfigParser()
+ config.read(subversion_config)
+ if (config.has_section("miscellany") and
+ config.has_option("miscellany", "enable-auto-props") and
+ config.getboolean("miscellany", "enable-auto-props") and
+ config.has_section("auto-props")):
+ props = {}
+ for file_pattern in config.options("auto-props"):
+ props[file_pattern] = ParseSubversionPropertyValues(
+ config.get("auto-props", file_pattern))
+ return props
+ else:
+ return {}
+
+def ParseSubversionPropertyValues(props):
+ """Parse the given property value which comes from [auto-props] section and
+ returns a list whose element is a (svn_prop_key, svn_prop_value) pair.
+
+ See the following doctest for example.
+
+ >>> ParseSubversionPropertyValues('svn:eol-style=LF')
+ [('svn:eol-style', 'LF')]
+ >>> ParseSubversionPropertyValues('svn:mime-type=image/jpeg')
+ [('svn:mime-type', 'image/jpeg')]
+ >>> ParseSubversionPropertyValues('svn:eol-style=LF;svn:executable')
+ [('svn:eol-style', 'LF'), ('svn:executable', '*')]
+ """
+ key_value_pairs = []
+ for prop in props.split(";"):
+ key_value = prop.split("=")
+ assert len(key_value) <= 2
+ if len(key_value) == 1:
+ # If value is not given, use '*' as a Subversion's convention.
+ key_value_pairs.append((key_value[0], "*"))
+ else:
+ key_value_pairs.append((key_value[0], key_value[1]))
+ return key_value_pairs
+
+
+def GetSubversionPropertyChanges(filename):
+ """Return a Subversion's 'Property changes on ...' string, which is used in
+ the patch file.
+
+ Args:
+ filename: filename whose property might be set by [auto-props] config.
+
+ Returns:
+ A string like 'Property changes on |filename| ...' if given |filename|
+ matches any entries in [auto-props] section. None, otherwise.
+ """
+ global svn_auto_props_map
+ if svn_auto_props_map is None:
+ svn_auto_props_map = LoadSubversionAutoProperties()
+
+ all_props = []
+ for file_pattern, props in svn_auto_props_map.items():
+ if fnmatch.fnmatch(filename, file_pattern):
+ all_props.extend(props)
+ if all_props:
+ return FormatSubversionPropertyChanges(filename, all_props)
+ return None
+
+
+def FormatSubversionPropertyChanges(filename, props):
+ """Returns Subversion's 'Property changes on ...' strings using given filename
+ and properties.
+
+ Args:
+ filename: filename
+ props: A list whose element is a (svn_prop_key, svn_prop_value) pair.
+
+ Returns:
+ A string which can be used in the patch file for Subversion.
+
+ See the following doctest for example.
+
+ >>> print FormatSubversionPropertyChanges('foo.cc', [('svn:eol-style', 'LF')])
+ Property changes on: foo.cc
+ ___________________________________________________________________
+ Added: svn:eol-style
+ + LF
+ <BLANKLINE>
+ """
+ prop_changes_lines = [
+ "Property changes on: %s" % filename,
+ "___________________________________________________________________"]
+ for key, value in props:
+ prop_changes_lines.append("Added: " + key)
+ prop_changes_lines.append(" + " + value)
+ return "\n".join(prop_changes_lines) + "\n"
+
+
+def RealMain(argv, data=None):
+ """The real main function.
+
+ Args:
+ argv: Command line arguments.
+ data: Diff contents. If None (default) the diff is generated by
+ the VersionControlSystem implementation returned by GuessVCS().
+
+ Returns:
+ A 2-tuple (issue id, patchset id).
+ The patchset id is None if the base files are not uploaded by this
+ script (applies only to SVN checkouts).
+ """
+ logging.basicConfig(format=("%(asctime).19s %(levelname)s %(filename)s:"
+ "%(lineno)s %(message)s "))
+ os.environ['LC_ALL'] = 'C'
+ options, args = parser.parse_args(argv[1:])
+ global verbosity
+ verbosity = options.verbose
+ if verbosity >= 3:
+ logging.getLogger().setLevel(logging.DEBUG)
+ elif verbosity >= 2:
+ logging.getLogger().setLevel(logging.INFO)
+
+ vcs = GuessVCS(options)
+
+ base = options.base_url
+ if isinstance(vcs, SubversionVCS):
+ # Guessing the base field is only supported for Subversion.
+ # Note: Fetching base files may become deprecated in future releases.
+ guessed_base = vcs.GuessBase(options.download_base)
+ if base:
+ if guessed_base and base != guessed_base:
+ print "Using base URL \"%s\" from --base_url instead of \"%s\"" % \
+ (base, guessed_base)
+ else:
+ base = guessed_base
+
+ if not base and options.download_base:
+ options.download_base = True
+ logging.info("Enabled upload of base file")
+ if not options.assume_yes:
+ vcs.CheckForUnknownFiles()
+ if data is None:
+ data = vcs.GenerateDiff(args)
+ files = vcs.GetBaseFiles(data)
+ if verbosity >= 1:
+ print "Upload server:", options.server, "(change with -s/--server)"
+ if options.issue:
+ prompt = "Message describing this patch set: "
+ else:
+ prompt = "New issue subject: "
+ message = options.message or raw_input(prompt).strip()
+ if not message:
+ ErrorExit("A non-empty message is required")
+ rpc_server = GetRpcServer(options)
+ form_fields = [("subject", message)]
+ if base:
+ form_fields.append(("base", base))
+ if options.issue:
+ form_fields.append(("issue", str(options.issue)))
+ if options.email:
+ form_fields.append(("user", options.email))
+ if options.reviewers:
+ for reviewer in options.reviewers.split(','):
+ CheckReviewer(reviewer)
+ form_fields.append(("reviewers", options.reviewers))
+ if options.cc:
+ for cc in options.cc.split(','):
+ CheckReviewer(cc)
+ form_fields.append(("cc", options.cc))
+ description = options.description
+ if options.description_file:
+ if options.description:
+ ErrorExit("Can't specify description and description_file")
+ file = open(options.description_file, 'r')
+ description = file.read()
+ file.close()
+ if description:
+ form_fields.append(("description", description))
+ # Send a hash of all the base file so the server can determine if a copy
+ # already exists in an earlier patchset.
+ base_hashes = ""
+ for file, info in files.iteritems():
+ if not info[0] is None:
+ checksum = md5(info[0]).hexdigest()
+ if base_hashes:
+ base_hashes += "|"
+ base_hashes += checksum + ":" + file
+ form_fields.append(("base_hashes", base_hashes))
+ if options.private:
+ if options.issue:
+ print "Warning: Private flag ignored when updating an existing issue."
+ else:
+ form_fields.append(("private", "1"))
+ # If we're uploading base files, don't send the email before the uploads, so
+ # that it contains the file status.
+ if options.send_mail and options.download_base:
+ form_fields.append(("send_mail", "1"))
+ if not options.download_base:
+ form_fields.append(("content_upload", "1"))
+ if len(data) > MAX_UPLOAD_SIZE:
+ print "Patch is large, so uploading file patches separately."
+ uploaded_diff_file = []
+ form_fields.append(("separate_patches", "1"))
+ else:
+ uploaded_diff_file = [("data", "data.diff", data)]
+ ctype, body = EncodeMultipartFormData(form_fields, uploaded_diff_file)
+ response_body = rpc_server.Send("/upload", body, content_type=ctype)
+ patchset = None
+ if not options.download_base or not uploaded_diff_file:
+ lines = response_body.splitlines()
+ if len(lines) >= 2:
+ msg = lines[0]
+ patchset = lines[1].strip()
+ patches = [x.split(" ", 1) for x in lines[2:]]
+ else:
+ msg = response_body
+ else:
+ msg = response_body
+ StatusUpdate(msg)
+ if not response_body.startswith("Issue created.") and \
+ not response_body.startswith("Issue updated."):
+ sys.exit(0)
+ issue = msg[msg.rfind("/")+1:]
+
+ if not uploaded_diff_file:
+ result = UploadSeparatePatches(issue, rpc_server, patchset, data, options)
+ if not options.download_base:
+ patches = result
+
+ if not options.download_base:
+ vcs.UploadBaseFiles(issue, rpc_server, patches, patchset, options, files)
+ if options.send_mail:
+ rpc_server.Send("/" + issue + "/mail", payload="")
+ return issue, patchset
+
+
+def main():
+ try:
+ RealMain(sys.argv)
+ except KeyboardInterrupt:
+ print
+ StatusUpdate("Interrupted.")
+ sys.exit(1)
+
+
+if __name__ == "__main__":
+ main()
